- {!playground && !frontpage && (
+
+ {!playground && !frontpage && !standalone && (
)}
-
+
diff --git a/site/decodal-site/src/lib/agent-content.js b/site/decodal-site/src/lib/agent-content.js
new file mode 100644
index 0000000..a344117
--- /dev/null
+++ b/site/decodal-site/src/lib/agent-content.js
@@ -0,0 +1,134 @@
+import { docTitle, orderedDocSlugs, sourceMarkdown } from './docs.js';
+
+export const SITE_URL = 'https://decodal.hareworks.net';
+
+const homePages = {
+ en: `# Decodal
+
+Decodal is the Deferred Constraint Data Language: a small deterministic language for describing, composing, validating, and materializing structured data.
+
+Configuration values, constraints, defaults, and derived values share one expression system. The host owns filesystems and external I/O; Decodal owns deterministic evaluation.
+
+\`\`\`dcdl
+let
+ Port = Int & >= 1 & <= 65535;
+ Service = {
+ host = String;
+ port = Port default 8080;
+ };
+in
+{
+ host = "127.0.0.1";
+} as Service;
+\`\`\`
+
+## Documentation
+
+- [English manual](/docs/en.md)
+- [Embedding guide](/docs/en/embedding.md)
+- [Packages and integrations](/docs/en/components.md)
+- [Japanese site](/ja.md)
+
+## Resources
+
+- [Browser playground](/playground/)
+- [Source repository](https://gitea.hareworks.net/Hare/Decodal)
+`,
+ ja: `# Decodal
+
+Decodalは、構造化データの記述、合成、検証、具体化のための小さく決定的な言語、Deferred Constraint Data Languageである。
+
+設定値、制約、デフォルト、派生値をひとつの式体系で扱う。filesystemや外部I/Oはホストが担い、Decodalは決定的な評価を担う。
+
+\`\`\`dcdl
+let
+ Port = Int & >= 1 & <= 65535;
+ Service = {
+ host = String;
+ port = Port default 8080;
+ };
+in
+{
+ host = "127.0.0.1";
+} as Service;
+\`\`\`
+
+## ドキュメント
+
+- [日本語マニュアル](/docs/ja.md)
+- [組み込みガイド](/docs/ja/embedding.md)
+- [パッケージと統合](/docs/ja/components.md)
+- [English site](/index.md)
+
+## リソース
+
+- [ブラウザPlayground](/playground/)
+- [ソースリポジトリ](https://gitea.hareworks.net/Hare/Decodal)
+`,
+};
+
+export function homeMarkdown(locale = 'en') {
+ return homePages[locale] ?? homePages.en;
+}
+
+function markdownUrl(slug, locale) {
+ return slug === 'index'
+ ? `${SITE_URL}/docs/${locale}.md`
+ : `${SITE_URL}/docs/${locale}/${slug}.md`;
+}
+
+function manualLinks(locale) {
+ return orderedDocSlugs(locale, { includeIndex: true })
+ .map((slug) => `- [${docTitle(slug, locale)}](${markdownUrl(slug, locale)})`)
+ .join('\n');
+}
+
+export function llmsText() {
+ return `# Decodal
+
+> Decodal is a deterministic data language for configuration, constraints, defaults, validation, and materialization.
+
+Use the English manual as the default reference. Japanese translations cover the same document structure. Markdown endpoints are generated directly from the manual sources rather than converted from HTML.
+
+## English documentation
+
+${manualLinks('en')}
+
+## 日本語ドキュメント
+
+${manualLinks('ja')}
+
+## Complete manuals
+
+- [Complete English manual](${SITE_URL}/llms-full.txt): All English manual pages in one text resource.
+- [日本語マニュアル全文](${SITE_URL}/ja/llms-full.txt): 日本語マニュアルの全ページをまとめたテキスト。
+
+## Resources
+
+- [Project overview](${SITE_URL}/index.md): Concise English overview.
+- [プロジェクト概要](${SITE_URL}/ja.md): 日本語の概要。
+- [Browser playground](${SITE_URL}/playground/): Interactive Decodal runtime and editor.
+- [Source repository](https://gitea.hareworks.net/Hare/Decodal): Rust, JavaScript, language service, and website source.
+`;
+}
+
+export function fullManual(locale = 'en') {
+ const heading = locale === 'ja' ? 'Decodalマニュアル全文' : 'Complete Decodal Manual';
+ const note = locale === 'ja'
+ ? 'このファイルは日本語マニュアルの原本から生成されている。各章の個別Markdownは /llms.txt を参照。'
+ : 'This file is generated from the English manual sources. See /llms.txt for links to individual Markdown pages.';
+ const pages = orderedDocSlugs(locale, { includeIndex: true })
+ .map((slug) => sourceMarkdown(slug, locale).trim())
+ .join('\n\n---\n\n');
+ return `# ${heading}\n\n${note}\n\n${pages}\n`;
+}
+
+export function textResponse(content, language = 'en', contentType = 'text/markdown') {
+ return new Response(content, {
+ headers: {
+ 'Content-Type': `${contentType}; charset=utf-8`,
+ 'Content-Language': language,
+ 'Content-Signal': 'search=yes, ai-input=yes, ai-train=no',
+ },
+ });
+}
diff --git a/site/decodal-site/src/lib/docs.js b/site/decodal-site/src/lib/docs.js
index b6e910b..dd17961 100644
--- a/site/decodal-site/src/lib/docs.js
+++ b/site/decodal-site/src/lib/docs.js
@@ -173,6 +173,16 @@ export function allDocSlugs(locale = 'en') {
return Object.keys(docsByLocale[locale] ?? {}).filter((slug) => slug !== 'index');
}
+function flattenNav(items) {
+ return items.flatMap((item) => [item.slug, ...(item.children ? flattenNav(item.children) : [])]);
+}
+
+export function orderedDocSlugs(locale = 'en', { includeIndex = false } = {}) {
+ const localizedDocs = docsByLocale[locale] ?? docsByLocale.en;
+ const slugs = flattenNav(getNav(locale)).filter((slug) => localizedDocs[slug]);
+ return includeIndex ? ['index', ...slugs] : slugs;
+}
+
function findDocTitle(slug, items) {
for (const item of items) {
if (item.slug === slug) return item.title;
@@ -185,13 +195,51 @@ function findDocTitle(slug, items) {
}
export function docTitle(slug, locale = 'en') {
+ if (slug === 'index') return locale === 'ja' ? 'Decodalマニュアル' : 'Decodal Manual';
return findDocTitle(slug, getNav(locale)) ?? slug;
}
-export function renderMarkdown(slug, locale = 'en') {
+function getSource(slug, locale) {
const localizedDocs = docsByLocale[locale] ?? docsByLocale.en;
- const source = localizedDocs[slug] ?? localizedDocs.index;
- const html = marked.parse(source ?? '# Not found\n');
+ return localizedDocs[slug] ?? localizedDocs.index ?? '# Not found\n';
+}
+
+function stripInlineMarkdown(value) {
+ return value
+ .replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1')
+ .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1')
+ .replace(/[`*_~]/g, '')
+ .replace(/<[^>]+>/g, '')
+ .replace(/\s+/g, ' ')
+ .trim();
+}
+
+export function docDescription(slug, locale = 'en') {
+ const blocks = getSource(slug, locale)
+ .replace(/```[\s\S]*?```/g, '')
+ .split(/\n\s*\n/)
+ .map((block) => block.trim())
+ .filter((block) => block && !block.startsWith('#') && !/^[-*]\s/.test(block));
+ const description = stripInlineMarkdown(blocks[0] ?? '');
+ if (description.length <= 180) return description;
+ const shortened = description.slice(0, 177).replace(/\s+\S*$/, '').trimEnd();
+ return `${shortened || description.slice(0, 177)}…`;
+}
+
+export function sourceMarkdown(slug, locale = 'en') {
+ return getSource(slug, locale).replace(/\]\(([^)\s]+)\)/g, (all, destination) => {
+ const [href, hash = ''] = destination.split('#', 2);
+ if (!href.endsWith('.md')) return all;
+ const target = normalizeDocLink(locale, slug, href.slice(0, -3));
+ const pathname = target === 'index'
+ ? `/docs/${locale}.md`
+ : `/docs/${locale}/${target}.md`;
+ return `](${pathname}${hash ? `#${hash}` : ''})`;
+ });
+}
+
+export function renderMarkdown(slug, locale = 'en') {
+ const html = marked.parse(getSource(slug, locale));
return html.replace(/href="([^"#][^"]*)\.md(#[^"]*)?"/g, (_all, href, hash = '') => {
const target = normalizeDocLink(locale, slug, href);
const pathname = target === 'index' ? `/docs/${locale}/` : `/docs/${locale}/${target}/`;
diff --git a/site/decodal-site/src/pages/404.astro b/site/decodal-site/src/pages/404.astro
new file mode 100644
index 0000000..4133e6e
--- /dev/null
+++ b/site/decodal-site/src/pages/404.astro
@@ -0,0 +1,15 @@
+---
+import ManualLayout from '../layouts/ManualLayout.astro';
+---
+
+
+ Page not found
+ The requested page does not exist or has moved.
+ Return home or open the manual.
+
+
diff --git a/site/decodal-site/src/pages/docs/en/[...slug].astro b/site/decodal-site/src/pages/docs/en/[...slug].astro
index 9e8fd76..14d3f94 100644
--- a/site/decodal-site/src/pages/docs/en/[...slug].astro
+++ b/site/decodal-site/src/pages/docs/en/[...slug].astro
@@ -1,6 +1,6 @@
---
import ManualLayout from '../../../layouts/ManualLayout.astro';
-import { allDocSlugs, docTitle, renderMarkdown } from '../../../lib/docs.js';
+import { allDocSlugs, docDescription, docTitle, renderMarkdown } from '../../../lib/docs.js';
import '@fontsource/ibm-plex-sans-jp/latin-400.css';
import '@fontsource/ibm-plex-sans-jp/latin-600.css';
@@ -14,7 +14,8 @@ export function getStaticPaths() {
const { slug } = Astro.props;
const html = renderMarkdown(slug, 'en');
const title = docTitle(slug, 'en');
+const description = docDescription(slug, 'en');
---
-
+
diff --git a/site/decodal-site/src/pages/docs/en/[...slug]/index.md.ts b/site/decodal-site/src/pages/docs/en/[...slug]/index.md.ts
new file mode 100644
index 0000000..5c67256
--- /dev/null
+++ b/site/decodal-site/src/pages/docs/en/[...slug]/index.md.ts
@@ -0,0 +1,10 @@
+import { textResponse } from '../../../../lib/agent-content.js';
+import { allDocSlugs, sourceMarkdown } from '../../../../lib/docs.js';
+
+export function getStaticPaths() {
+ return allDocSlugs('en').map((slug) => ({ params: { slug }, props: { slug } }));
+}
+
+export function GET({ props }) {
+ return textResponse(sourceMarkdown(props.slug, 'en'), 'en');
+}
diff --git a/site/decodal-site/src/pages/docs/en/index.md.ts b/site/decodal-site/src/pages/docs/en/index.md.ts
new file mode 100644
index 0000000..b9c21e0
--- /dev/null
+++ b/site/decodal-site/src/pages/docs/en/index.md.ts
@@ -0,0 +1,6 @@
+import { textResponse } from '../../../lib/agent-content.js';
+import { sourceMarkdown } from '../../../lib/docs.js';
+
+export function GET() {
+ return textResponse(sourceMarkdown('index', 'en'), 'en');
+}
diff --git a/site/decodal-site/src/pages/docs/ja/[...slug].astro b/site/decodal-site/src/pages/docs/ja/[...slug].astro
index 6b36ac3..0638927 100644
--- a/site/decodal-site/src/pages/docs/ja/[...slug].astro
+++ b/site/decodal-site/src/pages/docs/ja/[...slug].astro
@@ -1,6 +1,6 @@
---
import ManualLayout from '../../../layouts/ManualLayout.astro';
-import { allDocSlugs, docTitle, renderMarkdown } from '../../../lib/docs.js';
+import { allDocSlugs, docDescription, docTitle, renderMarkdown } from '../../../lib/docs.js';
import '@fontsource/ibm-plex-sans-jp/400.css';
import '@fontsource/ibm-plex-sans-jp/600.css';
@@ -14,7 +14,8 @@ export function getStaticPaths() {
const { slug } = Astro.props;
const html = renderMarkdown(slug, 'ja');
const title = docTitle(slug, 'ja');
+const description = docDescription(slug, 'ja');
---
-
+
diff --git a/site/decodal-site/src/pages/docs/ja/[...slug]/index.md.ts b/site/decodal-site/src/pages/docs/ja/[...slug]/index.md.ts
new file mode 100644
index 0000000..98879b6
--- /dev/null
+++ b/site/decodal-site/src/pages/docs/ja/[...slug]/index.md.ts
@@ -0,0 +1,10 @@
+import { textResponse } from '../../../../lib/agent-content.js';
+import { allDocSlugs, sourceMarkdown } from '../../../../lib/docs.js';
+
+export function getStaticPaths() {
+ return allDocSlugs('ja').map((slug) => ({ params: { slug }, props: { slug } }));
+}
+
+export function GET({ props }) {
+ return textResponse(sourceMarkdown(props.slug, 'ja'), 'ja');
+}
diff --git a/site/decodal-site/src/pages/docs/ja/index.md.ts b/site/decodal-site/src/pages/docs/ja/index.md.ts
new file mode 100644
index 0000000..647eb53
--- /dev/null
+++ b/site/decodal-site/src/pages/docs/ja/index.md.ts
@@ -0,0 +1,6 @@
+import { textResponse } from '../../../lib/agent-content.js';
+import { sourceMarkdown } from '../../../lib/docs.js';
+
+export function GET() {
+ return textResponse(sourceMarkdown('index', 'ja'), 'ja');
+}
diff --git a/site/decodal-site/src/pages/index.md.ts b/site/decodal-site/src/pages/index.md.ts
new file mode 100644
index 0000000..b59f01d
--- /dev/null
+++ b/site/decodal-site/src/pages/index.md.ts
@@ -0,0 +1,5 @@
+import { homeMarkdown, textResponse } from '../lib/agent-content.js';
+
+export function GET() {
+ return textResponse(homeMarkdown('en'), 'en');
+}
diff --git a/site/decodal-site/src/pages/ja/index.md.ts b/site/decodal-site/src/pages/ja/index.md.ts
new file mode 100644
index 0000000..0c3a575
--- /dev/null
+++ b/site/decodal-site/src/pages/ja/index.md.ts
@@ -0,0 +1,5 @@
+import { homeMarkdown, textResponse } from '../../lib/agent-content.js';
+
+export function GET() {
+ return textResponse(homeMarkdown('ja'), 'ja');
+}
diff --git a/site/decodal-site/src/pages/ja/llms-full.txt.ts b/site/decodal-site/src/pages/ja/llms-full.txt.ts
new file mode 100644
index 0000000..1f8dd27
--- /dev/null
+++ b/site/decodal-site/src/pages/ja/llms-full.txt.ts
@@ -0,0 +1,5 @@
+import { fullManual, textResponse } from '../../lib/agent-content.js';
+
+export function GET() {
+ return textResponse(fullManual('ja'), 'ja', 'text/plain');
+}
diff --git a/site/decodal-site/src/pages/llms-full.txt.ts b/site/decodal-site/src/pages/llms-full.txt.ts
new file mode 100644
index 0000000..4669256
--- /dev/null
+++ b/site/decodal-site/src/pages/llms-full.txt.ts
@@ -0,0 +1,5 @@
+import { fullManual, textResponse } from '../lib/agent-content.js';
+
+export function GET() {
+ return textResponse(fullManual('en'), 'en', 'text/plain');
+}
diff --git a/site/decodal-site/src/pages/llms.txt.ts b/site/decodal-site/src/pages/llms.txt.ts
new file mode 100644
index 0000000..9c252f1
--- /dev/null
+++ b/site/decodal-site/src/pages/llms.txt.ts
@@ -0,0 +1,5 @@
+import { llmsText, textResponse } from '../lib/agent-content.js';
+
+export function GET() {
+ return textResponse(llmsText(), 'en', 'text/plain');
+}
diff --git a/site/decodal-site/src/pages/robots.txt.ts b/site/decodal-site/src/pages/robots.txt.ts
new file mode 100644
index 0000000..6265750
--- /dev/null
+++ b/site/decodal-site/src/pages/robots.txt.ts
@@ -0,0 +1,12 @@
+import { SITE_URL, textResponse } from '../lib/agent-content.js';
+
+const robots = `User-agent: *
+Content-Signal: search=yes, ai-input=yes, ai-train=no
+Allow: /
+
+Sitemap: ${SITE_URL}/sitemap-index.xml
+`;
+
+export function GET() {
+ return textResponse(robots, 'en', 'text/plain');
+}