@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/product/product.docblocks.js

@@ -0,0 +1,80 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/components/docs/product/product.docblocks.ts
+const productDocs = [
+	{
+		id: "docs.product.lifecycle-stages.goal",
+		title: "Lifecycle stages goal",
+		summary: "Why lifecycle staging exists for ContractSpec products.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/product/lifecycle-stages/goal",
+		tags: ["product", "lifecycle"],
+		body: "Provide a clear, staged journey so teams can adopt ContractSpec incrementally with measurable milestones and ceremonies."
+	},
+	{
+		id: "docs.product.lifecycle-stages.usage",
+		title: "Lifecycle stages usage",
+		summary: "How to use lifecycle stages across products.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/product/lifecycle-stages/usage",
+		tags: ["product", "lifecycle"],
+		body: `- Map tenant or project to a lifecycle stage using assessment signals.
+- Use stage checklists to guide adoption; trigger ceremonies on stage change.
+- Keep stage definitions versioned and referenced by UI and ops docs.
+- Align product messaging to the current stage for clarity and expectation setting.`
+	},
+	{
+		id: "docs.product.lifecycle-stages.how",
+		title: "Lifecycle stages reference",
+		summary: "Reference of lifecycle stages and guidance (from markdown).",
+		kind: "how",
+		visibility: "public",
+		route: "/docs/product/lifecycle-stages/how",
+		tags: ["product", "lifecycle"],
+		body: `# Lifecycle Stages
+
+Refer to lifecycle stages definition and guidance in product docs. Keep stage names, descriptions, and ceremonies aligned with implementation and ops runbooks.`
+	},
+	{
+		id: "docs.product.lifecycle-user-guide.goal",
+		title: "Lifecycle user guide goal",
+		summary: "Why the lifecycle user guide exists.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/product/lifecycle-user-guide/goal",
+		tags: ["product", "lifecycle"],
+		body: "Help users navigate lifecycle assessments, recommendations, and ceremonies without requiring ops intervention."
+	},
+	{
+		id: "docs.product.lifecycle-user-guide.usage",
+		title: "Lifecycle user guide usage",
+		summary: "How users should follow lifecycle guidance.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/product/lifecycle-user-guide/usage",
+		tags: ["product", "lifecycle"],
+		body: `- Review recommended actions after each assessment.
+- Complete milestone checklists to progress stages.
+- Acknowledge stage regressions and follow suggested remediation.
+- Use the Studio UI to trigger reassessments when major changes occur.`
+	},
+	{
+		id: "docs.product.lifecycle-user-guide.how",
+		title: "Lifecycle user guide reference",
+		summary: "Reference content for lifecycle user guide.",
+		kind: "how",
+		visibility: "public",
+		route: "/docs/product/lifecycle-user-guide/how",
+		tags: ["product", "lifecycle"],
+		body: `# Lifecycle User Guide
+
+User-facing guide for navigating lifecycle assessments, recommendations, and ceremonies. Keep aligned with runtime logic and ops runbooks.`
+	}
+];
+registerDocBlocks(productDocs);
+
+//#endregion
+export { productDocs };
+//# sourceMappingURL=product.docblocks.js.map

package/dist/components/docs/product/product.docblocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.docblocks.js","names":[],"sources":["../../../../src/components/docs/product/product.docblocks.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nexport const productDocs: DocBlock[] = [\n  {\n    id: 'docs.product.lifecycle-stages.goal',\n    title: 'Lifecycle stages goal',\n    summary: 'Why lifecycle staging exists for ContractSpec products.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-stages/goal',\n    tags: ['product', 'lifecycle'],\n    body: 'Provide a clear, staged journey so teams can adopt ContractSpec incrementally with measurable milestones and ceremonies.',\n  },\n  {\n    id: 'docs.product.lifecycle-stages.usage',\n    title: 'Lifecycle stages usage',\n    summary: 'How to use lifecycle stages across products.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-stages/usage',\n    tags: ['product', 'lifecycle'],\n    body: `- Map tenant or project to a lifecycle stage using assessment signals.\n- Use stage checklists to guide adoption; trigger ceremonies on stage change.\n- Keep stage definitions versioned and referenced by UI and ops docs.\n- Align product messaging to the current stage for clarity and expectation setting.`,\n  },\n  {\n    id: 'docs.product.lifecycle-stages.how',\n    title: 'Lifecycle stages reference',\n    summary: 'Reference of lifecycle stages and guidance (from markdown).',\n    kind: 'how',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-stages/how',\n    tags: ['product', 'lifecycle'],\n    body: `# Lifecycle Stages\n\nRefer to lifecycle stages definition and guidance in product docs. Keep stage names, descriptions, and ceremonies aligned with implementation and ops runbooks.`,\n  },\n  {\n    id: 'docs.product.lifecycle-user-guide.goal',\n    title: 'Lifecycle user guide goal',\n    summary: 'Why the lifecycle user guide exists.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-user-guide/goal',\n    tags: ['product', 'lifecycle'],\n    body: 'Help users navigate lifecycle assessments, recommendations, and ceremonies without requiring ops intervention.',\n  },\n  {\n    id: 'docs.product.lifecycle-user-guide.usage',\n    title: 'Lifecycle user guide usage',\n    summary: 'How users should follow lifecycle guidance.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-user-guide/usage',\n    tags: ['product', 'lifecycle'],\n    body: `- Review recommended actions after each assessment.\n- Complete milestone checklists to progress stages.\n- Acknowledge stage regressions and follow suggested remediation.\n- Use the Studio UI to trigger reassessments when major changes occur.`,\n  },\n  {\n    id: 'docs.product.lifecycle-user-guide.how',\n    title: 'Lifecycle user guide reference',\n    summary: 'Reference content for lifecycle user guide.',\n    kind: 'how',\n    visibility: 'public',\n    route: '/docs/product/lifecycle-user-guide/how',\n    tags: ['product', 'lifecycle'],\n    body: `# Lifecycle User Guide\n\nUser-facing guide for navigating lifecycle assessments, recommendations, and ceremonies. Keep aligned with runtime logic and ops runbooks.`,\n  },\n];\nregisterDocBlocks(productDocs);\n"],"mappings":";;;AAGA,MAAa,cAA0B;CACrC;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;EACP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;;;;EAIP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;;;EAGP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;EACP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;;;;EAIP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,YAAY;EAC9B,MAAM;;;EAGP;CACF;AACD,kBAAkB,YAAY"}

package/dist/components/docs/reference/DocsMarkdownContent.d.ts

@@ -0,0 +1,11 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsMarkdownContent.d.ts
+declare function DocsMarkdownContent({
+  content
+}: {
+  content: string;
+}): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsMarkdownContent };
+//# sourceMappingURL=DocsMarkdownContent.d.ts.map

package/dist/components/docs/reference/DocsMarkdownContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsMarkdownContent.d.ts","names":[],"sources":["../../../../src/components/docs/reference/DocsMarkdownContent.tsx"],"mappings":";;;iBA+CgB,mBAAA,CAAA;EAAsB;AAAA;EAAa,OAAA;AAAA,IAAiB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/reference/DocsMarkdownContent.js

@@ -0,0 +1,73 @@
+'use client';
+
+import { parseDocsMarkdown } from "./docsMarkdownParser.js";
+import { CodeBlock } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { BlockQuote, H2, H3, H4, Muted, P } from "@contractspec/lib.ui-kit-web/ui/typography";
+
+//#region src/components/docs/reference/DocsMarkdownContent.tsx
+const CODE_LANGUAGES = new Set([
+	"typescript",
+	"tsx",
+	"javascript",
+	"jsx",
+	"bash",
+	"shell",
+	"json",
+	"yaml",
+	"graphql",
+	"sql",
+	"python",
+	"go",
+	"rust",
+	"css",
+	"scss",
+	"html",
+	"markdown",
+	"text"
+]);
+function toCodeLanguage(language) {
+	if (!language) return "text";
+	const normalized = language.toLowerCase();
+	return CODE_LANGUAGES.has(normalized) ? normalized : "text";
+}
+function renderHeading(level, text) {
+	if (level <= 2) return /* @__PURE__ */ jsx(H2, { children: text });
+	if (level === 3) return /* @__PURE__ */ jsx(H3, { children: text });
+	return /* @__PURE__ */ jsx(H4, { children: text });
+}
+function DocsMarkdownContent({ content }) {
+	const blocks = parseDocsMarkdown(content);
+	if (!blocks.length) return /* @__PURE__ */ jsx(Muted, { children: "No reference content available." });
+	return /* @__PURE__ */ jsx(VStack, {
+		gap: "md",
+		children: blocks.map((block, index) => {
+			switch (block.type) {
+				case "heading": return /* @__PURE__ */ jsx(VStack, { children: renderHeading(block.level, block.text) }, index);
+				case "paragraph": return /* @__PURE__ */ jsx(P, { children: block.text }, index);
+				case "quote": return /* @__PURE__ */ jsx(BlockQuote, { children: block.text }, index);
+				case "code": return /* @__PURE__ */ jsx(CodeBlock, {
+					language: toCodeLanguage(block.language),
+					code: block.code
+				}, index);
+				case "list": return /* @__PURE__ */ jsx(VStack, {
+					gap: "xs",
+					children: block.items.map((item, itemIndex) => /* @__PURE__ */ jsxs(HStack, {
+						gap: "sm",
+						align: "start",
+						children: [/* @__PURE__ */ jsx(Muted, { children: block.ordered ? `${itemIndex + 1}.` : "•" }), /* @__PURE__ */ jsx(P, {
+							className: "leading-relaxed",
+							children: item
+						})]
+					}, itemIndex))
+				}, index);
+				default: return null;
+			}
+		})
+	});
+}
+
+//#endregion
+export { DocsMarkdownContent };
+//# sourceMappingURL=DocsMarkdownContent.js.map

package/dist/components/docs/reference/DocsMarkdownContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsMarkdownContent.js","names":[],"sources":["../../../../src/components/docs/reference/DocsMarkdownContent.tsx"],"sourcesContent":["'use client';\n\nimport { CodeBlock, type CodeLanguage } from '@contractspec/lib.design-system';\nimport { VStack, HStack } from '@contractspec/lib.ui-kit-web/ui/stack';\nimport {\n  BlockQuote,\n  H2,\n  H3,\n  H4,\n  Muted,\n  P,\n} from '@contractspec/lib.ui-kit-web/ui/typography';\nimport { parseDocsMarkdown } from './docsMarkdownParser';\n\nconst CODE_LANGUAGES = new Set<CodeLanguage>([\n  'typescript',\n  'tsx',\n  'javascript',\n  'jsx',\n  'bash',\n  'shell',\n  'json',\n  'yaml',\n  'graphql',\n  'sql',\n  'python',\n  'go',\n  'rust',\n  'css',\n  'scss',\n  'html',\n  'markdown',\n  'text',\n]);\n\nfunction toCodeLanguage(language?: string): CodeLanguage {\n  if (!language) return 'text';\n  const normalized = language.toLowerCase() as CodeLanguage;\n  return CODE_LANGUAGES.has(normalized) ? normalized : 'text';\n}\n\nfunction renderHeading(level: number, text: string) {\n  if (level <= 2) return <H2>{text}</H2>;\n  if (level === 3) return <H3>{text}</H3>;\n  return <H4>{text}</H4>;\n}\n\nexport function DocsMarkdownContent({ content }: { content: string }) {\n  const blocks = parseDocsMarkdown(content);\n\n  if (!blocks.length) {\n    return <Muted>No reference content available.</Muted>;\n  }\n\n  return (\n    <VStack gap=\"md\">\n      {blocks.map((block, index) => {\n        switch (block.type) {\n          case 'heading':\n            return (\n              <VStack key={index}>\n                {renderHeading(block.level, block.text)}\n              </VStack>\n            );\n          case 'paragraph':\n            return <P key={index}>{block.text}</P>;\n          case 'quote':\n            return <BlockQuote key={index}>{block.text}</BlockQuote>;\n          case 'code':\n            return (\n              <CodeBlock\n                key={index}\n                language={toCodeLanguage(block.language)}\n                code={block.code}\n              />\n            );\n          case 'list':\n            return (\n              <VStack key={index} gap=\"xs\">\n                {block.items.map((item, itemIndex) => (\n                  <HStack key={itemIndex} gap=\"sm\" align=\"start\">\n                    <Muted>{block.ordered ? `${itemIndex + 1}.` : '•'}</Muted>\n                    <P className=\"leading-relaxed\">{item}</P>\n                  </HStack>\n                ))}\n              </VStack>\n            );\n          default:\n            return null;\n        }\n      })}\n    </VStack>\n  );\n}\n"],"mappings":";;;;;;;;;AAcA,MAAM,iBAAiB,IAAI,IAAkB;CAC3C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,eAAe,UAAiC;AACvD,KAAI,CAAC,SAAU,QAAO;CACtB,MAAM,aAAa,SAAS,aAAa;AACzC,QAAO,eAAe,IAAI,WAAW,GAAG,aAAa;;AAGvD,SAAS,cAAc,OAAe,MAAc;AAClD,KAAI,SAAS,EAAG,QAAO,oBAAC,gBAAI,OAAU;AACtC,KAAI,UAAU,EAAG,QAAO,oBAAC,gBAAI,OAAU;AACvC,QAAO,oBAAC,gBAAI,OAAU;;AAGxB,SAAgB,oBAAoB,EAAE,WAAgC;CACpE,MAAM,SAAS,kBAAkB,QAAQ;AAEzC,KAAI,CAAC,OAAO,OACV,QAAO,oBAAC,mBAAM,oCAAuC;AAGvD,QACE,oBAAC;EAAO,KAAI;YACT,OAAO,KAAK,OAAO,UAAU;AAC5B,WAAQ,MAAM,MAAd;IACE,KAAK,UACH,QACE,oBAAC,oBACE,cAAc,MAAM,OAAO,MAAM,KAAK,IAD5B,MAEJ;IAEb,KAAK,YACH,QAAO,oBAAC,eAAe,MAAM,QAAd,MAAuB;IACxC,KAAK,QACH,QAAO,oBAAC,wBAAwB,MAAM,QAAd,MAAgC;IAC1D,KAAK,OACH,QACE,oBAAC;KAEC,UAAU,eAAe,MAAM,SAAS;KACxC,MAAM,MAAM;OAFP,MAGL;IAEN,KAAK,OACH,QACE,oBAAC;KAAmB,KAAI;eACrB,MAAM,MAAM,KAAK,MAAM,cACtB,qBAAC;MAAuB,KAAI;MAAK,OAAM;iBACrC,oBAAC,mBAAO,MAAM,UAAU,GAAG,YAAY,EAAE,KAAK,MAAY,EAC1D,oBAAC;OAAE,WAAU;iBAAmB;QAAS;QAF9B,UAGJ,CACT;OANS,MAOJ;IAEb,QACE,QAAO;;IAEX;GACK"}

package/dist/components/docs/reference/DocsReferenceContent.d.ts

@@ -0,0 +1,15 @@
+import { DocsIndexEntry } from "../generated/docs-index.generated.js";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferenceContent.d.ts
+interface DocsReferenceContentProps {
+  entry: DocsIndexEntry;
+  content: string;
+}
+declare function DocsReferenceContent({
+  entry,
+  content
+}: DocsReferenceContentProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsReferenceContent };
+//# sourceMappingURL=DocsReferenceContent.d.ts.map

package/dist/components/docs/reference/DocsReferenceContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceContent.d.ts","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceContent.tsx"],"mappings":";;;;UAQU,yBAAA;EACR,KAAA,EAAO,cAAA;EACP,OAAA;AAAA;AAAA,iBAiBc,oBAAA,CAAA;EACd,KAAA;EACA;AAAA,GACC,yBAAA,GAAyB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/reference/DocsReferenceContent.js

@@ -0,0 +1,52 @@
+'use client';
+
+import { DocsMarkdownContent } from "./DocsMarkdownContent.js";
+import { DataViewRenderer } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ContractReferenceDataView } from "@contractspec/lib.contracts/docs";
+import { VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+
+//#region src/components/docs/reference/DocsReferenceContent.tsx
+function extractMeta(content, label) {
+	return content.match(new RegExp(`- \\*\\*${label}\\*\\*: (.+)`, "i"))?.[1]?.trim();
+}
+function cleanSummary(summary) {
+	if (!summary) return void 0;
+	return summary.replace(/<!--.*?-->/g, "").replace(/[ \t]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+}
+function DocsReferenceContent({ entry, content }) {
+	const summary = cleanSummary(entry.summary);
+	const type = extractMeta(content, "Type");
+	const version = extractMeta(content, "Version") ?? entry.version;
+	const tags = extractMeta(content, "Tags")?.split(",").map((tag) => tag.trim()).filter(Boolean);
+	const owners = extractMeta(content, "Owners")?.split(",").map((owner) => owner.trim()).filter(Boolean);
+	const stability = extractMeta(content, "Stability") ?? entry.visibility;
+	const referenceItem = { reference: {
+		key: entry.title ?? entry.id,
+		version,
+		type,
+		title: entry.title ?? entry.id,
+		description: summary,
+		tags: tags ?? entry.tags,
+		owners: owners ?? entry.owners,
+		stability
+	} };
+	return /* @__PURE__ */ jsxs(VStack, {
+		gap: "xl",
+		children: [/* @__PURE__ */ jsx(DataViewRenderer, {
+			spec: {
+				...ContractReferenceDataView,
+				meta: {
+					...ContractReferenceDataView.meta,
+					title: entry.title ?? ContractReferenceDataView.meta.title,
+					description: summary ?? ContractReferenceDataView.meta.description
+				}
+			},
+			item: referenceItem
+		}), /* @__PURE__ */ jsx(DocsMarkdownContent, { content })]
+	});
+}
+
+//#endregion
+export { DocsReferenceContent };
+//# sourceMappingURL=DocsReferenceContent.js.map

package/dist/components/docs/reference/DocsReferenceContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceContent.js","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceContent.tsx"],"sourcesContent":["'use client';\n\nimport { DataViewRenderer } from '@contractspec/lib.design-system';\nimport { VStack } from '@contractspec/lib.ui-kit-web/ui/stack';\nimport { ContractReferenceDataView } from '@contractspec/lib.contracts/docs';\nimport type { DocsIndexEntry } from '../generated/docs-index.generated';\nimport { DocsMarkdownContent } from './DocsMarkdownContent';\n\ninterface DocsReferenceContentProps {\n  entry: DocsIndexEntry;\n  content: string;\n}\n\nfunction extractMeta(content: string, label: string) {\n  const match = content.match(new RegExp(`- \\\\*\\\\*${label}\\\\*\\\\*: (.+)`, 'i'));\n  return match?.[1]?.trim();\n}\n\nfunction cleanSummary(summary?: string) {\n  if (!summary) return undefined;\n  return summary\n    .replace(/<!--.*?-->/g, '')\n    .replace(/[ \\t]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\nexport function DocsReferenceContent({\n  entry,\n  content,\n}: DocsReferenceContentProps) {\n  const summary = cleanSummary(entry.summary);\n  const type = extractMeta(content, 'Type');\n  const version = extractMeta(content, 'Version') ?? entry.version;\n  const tags = extractMeta(content, 'Tags')\n    ?.split(',')\n    .map((tag) => tag.trim())\n    .filter(Boolean);\n  const owners = extractMeta(content, 'Owners')\n    ?.split(',')\n    .map((owner) => owner.trim())\n    .filter(Boolean);\n  const stability = extractMeta(content, 'Stability') ?? entry.visibility;\n\n  const referenceItem = {\n    reference: {\n      key: entry.title ?? entry.id,\n      version,\n      type,\n      title: entry.title ?? entry.id,\n      description: summary,\n      tags: tags ?? entry.tags,\n      owners: owners ?? entry.owners,\n      stability,\n    },\n  };\n\n  const detailSpec = {\n    ...ContractReferenceDataView,\n    meta: {\n      ...ContractReferenceDataView.meta,\n      title: entry.title ?? ContractReferenceDataView.meta.title,\n      description: summary ?? ContractReferenceDataView.meta.description,\n    },\n  };\n\n  return (\n    <VStack gap=\"xl\">\n      <DataViewRenderer spec={detailSpec} item={referenceItem} />\n      <DocsMarkdownContent content={content} />\n    </VStack>\n  );\n}\n"],"mappings":";;;;;;;;;AAaA,SAAS,YAAY,SAAiB,OAAe;AAEnD,QADc,QAAQ,MAAM,IAAI,OAAO,WAAW,MAAM,eAAe,IAAI,CAAC,GAC7D,IAAI,MAAM;;AAG3B,SAAS,aAAa,SAAkB;AACtC,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,QACJ,QAAQ,eAAe,GAAG,CAC1B,QAAQ,WAAW,IAAI,CACvB,QAAQ,WAAW,OAAO,CAC1B,MAAM;;AAGX,SAAgB,qBAAqB,EACnC,OACA,WAC4B;CAC5B,MAAM,UAAU,aAAa,MAAM,QAAQ;CAC3C,MAAM,OAAO,YAAY,SAAS,OAAO;CACzC,MAAM,UAAU,YAAY,SAAS,UAAU,IAAI,MAAM;CACzD,MAAM,OAAO,YAAY,SAAS,OAAO,EACrC,MAAM,IAAI,CACX,KAAK,QAAQ,IAAI,MAAM,CAAC,CACxB,OAAO,QAAQ;CAClB,MAAM,SAAS,YAAY,SAAS,SAAS,EACzC,MAAM,IAAI,CACX,KAAK,UAAU,MAAM,MAAM,CAAC,CAC5B,OAAO,QAAQ;CAClB,MAAM,YAAY,YAAY,SAAS,YAAY,IAAI,MAAM;CAE7D,MAAM,gBAAgB,EACpB,WAAW;EACT,KAAK,MAAM,SAAS,MAAM;EAC1B;EACA;EACA,OAAO,MAAM,SAAS,MAAM;EAC5B,aAAa;EACb,MAAM,QAAQ,MAAM;EACpB,QAAQ,UAAU,MAAM;EACxB;EACD,EACF;AAWD,QACE,qBAAC;EAAO,KAAI;aACV,oBAAC;GAAiB,MAXH;IACjB,GAAG;IACH,MAAM;KACJ,GAAG,0BAA0B;KAC7B,OAAO,MAAM,SAAS,0BAA0B,KAAK;KACrD,aAAa,WAAW,0BAA0B,KAAK;KACxD;IACF;GAIuC,MAAM;IAAiB,EAC3D,oBAAC,uBAA6B,UAAW;GAClC"}

package/dist/components/docs/reference/DocsReferenceIndexClient.d.ts

@@ -0,0 +1,13 @@
+import { DocsIndexEntry } from "../generated/docs-index.generated.js";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferenceIndexClient.d.ts
+interface DocsReferenceIndexClientProps {
+  entries: readonly DocsIndexEntry[];
+}
+declare function DocsReferenceIndexClient({
+  entries
+}: DocsReferenceIndexClientProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsReferenceIndexClient };
+//# sourceMappingURL=DocsReferenceIndexClient.d.ts.map

package/dist/components/docs/reference/DocsReferenceIndexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceIndexClient.d.ts","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceIndexClient.tsx"],"mappings":";;;;UAsBU,6BAAA;EACR,OAAA,WAAkB,cAAA;AAAA;AAAA,iBAoCJ,wBAAA,CAAA;EACd;AAAA,GACC,6BAAA,GAA6B,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/reference/DocsReferenceIndexClient.js

@@ -0,0 +1,107 @@
+'use client';
+
+import { useMemo, useState } from "react";
+import { DataViewList, StatusChip, formRenderer } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { DocsIndexDataView, DocsSearchForm } from "@contractspec/lib.contracts/docs";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { H1, Muted } from "@contractspec/lib.ui-kit-web/ui/typography";
+
+//#region src/components/docs/reference/DocsReferenceIndexClient.tsx
+function cleanSummary(summary) {
+	if (!summary) return void 0;
+	return summary.replace(/<!--.*?-->/g, "").replace(/[ \t]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+}
+function normalizeEntry(entry) {
+	const summary = cleanSummary(entry.summary);
+	const kind = entry.kind ?? (entry.source === "generated" ? "reference" : void 0);
+	const visibility = entry.visibility ?? (entry.source === "generated" ? "public" : void 0);
+	return {
+		...entry,
+		summary,
+		kind,
+		visibility
+	};
+}
+function matchesQuery(entry, query) {
+	if (!query) return true;
+	return [
+		entry.title,
+		entry.summary,
+		entry.id,
+		...entry.tags ?? []
+	].filter(Boolean).join(" ").toLowerCase().includes(query.toLowerCase());
+}
+function DocsReferenceIndexClient({ entries }) {
+	const [filters, setFilters] = useState({});
+	const normalizedEntries = useMemo(() => entries.map(normalizeEntry), [entries]);
+	const filteredEntries = useMemo(() => {
+		const query = filters.query?.trim() ?? "";
+		return normalizedEntries.filter((entry) => {
+			if (filters.kind && entry.kind !== filters.kind) return false;
+			if (filters.visibility && entry.visibility !== filters.visibility) return false;
+			return matchesQuery(entry, query);
+		});
+	}, [filters, normalizedEntries]);
+	const searchForm = formRenderer.render(DocsSearchForm, {
+		defaultValues: {
+			query: filters.query ?? "",
+			visibility: filters.visibility ?? "",
+			kind: filters.kind ?? ""
+		},
+		overrides: { onSubmitOverride: (values) => {
+			const submitted = values;
+			setFilters({
+				query: submitted.query ?? "",
+				visibility: submitted.visibility ?? "",
+				kind: submitted.kind ?? ""
+			});
+		} }
+	});
+	return /* @__PURE__ */ jsxs(VStack, {
+		gap: "xl",
+		children: [
+			/* @__PURE__ */ jsxs(VStack, {
+				gap: "sm",
+				children: [/* @__PURE__ */ jsx(H1, { children: "Contract Reference" }), /* @__PURE__ */ jsx(Muted, { children: "Auto-generated reference docs for operations, events, forms, data views, and presentations." })]
+			}),
+			/* @__PURE__ */ jsx(VStack, {
+				gap: "sm",
+				className: "max-w-2xl",
+				children: searchForm
+			}),
+			/* @__PURE__ */ jsx(DataViewList, {
+				spec: DocsIndexDataView,
+				items: filteredEntries,
+				emptyState: /* @__PURE__ */ jsx(Muted, { children: "No reference docs match your filters." }),
+				onSelect: (entry) => {
+					if (entry.route) window.location.assign(entry.route);
+				},
+				renderActions: (entry) => {
+					return /* @__PURE__ */ jsxs(HStack, {
+						gap: "xs",
+						justify: "end",
+						children: [
+							entry.kind ? /* @__PURE__ */ jsx(StatusChip, {
+								size: "sm",
+								label: entry.kind
+							}) : null,
+							entry.visibility ? /* @__PURE__ */ jsx(StatusChip, {
+								size: "sm",
+								label: entry.visibility
+							}) : null,
+							entry.version ? /* @__PURE__ */ jsx(StatusChip, {
+								size: "sm",
+								label: `v${entry.version}`
+							}) : null
+						]
+					});
+				}
+			})
+		]
+	});
+}
+
+//#endregion
+export { DocsReferenceIndexClient };
+//# sourceMappingURL=DocsReferenceIndexClient.js.map

package/dist/components/docs/reference/DocsReferenceIndexClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceIndexClient.js","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceIndexClient.tsx"],"sourcesContent":["'use client';\n\nimport { useMemo, useState } from 'react';\nimport {\n  DataViewList,\n  formRenderer,\n  StatusChip,\n} from '@contractspec/lib.design-system';\nimport { VStack, HStack } from '@contractspec/lib.ui-kit-web/ui/stack';\nimport { H1, Muted } from '@contractspec/lib.ui-kit-web/ui/typography';\nimport {\n  DocsIndexDataView,\n  DocsSearchForm,\n} from '@contractspec/lib.contracts/docs';\nimport type { DocsIndexEntry } from '../generated/docs-index.generated';\n\ninterface Filters {\n  query?: string;\n  visibility?: string;\n  kind?: string;\n}\n\ninterface DocsReferenceIndexClientProps {\n  entries: readonly DocsIndexEntry[];\n}\n\nfunction cleanSummary(summary?: string) {\n  if (!summary) return undefined;\n  return summary\n    .replace(/<!--.*?-->/g, '')\n    .replace(/[ \\t]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\nfunction normalizeEntry(entry: DocsIndexEntry): DocsIndexEntry {\n  const summary = cleanSummary(entry.summary);\n  const kind =\n    entry.kind ?? (entry.source === 'generated' ? 'reference' : undefined);\n  const visibility =\n    entry.visibility ?? (entry.source === 'generated' ? 'public' : undefined);\n\n  return {\n    ...entry,\n    summary,\n    kind,\n    visibility,\n  };\n}\n\nfunction matchesQuery(entry: DocsIndexEntry, query: string) {\n  if (!query) return true;\n  const haystack = [entry.title, entry.summary, entry.id, ...(entry.tags ?? [])]\n    .filter(Boolean)\n    .join(' ')\n    .toLowerCase();\n  return haystack.includes(query.toLowerCase());\n}\n\nexport function DocsReferenceIndexClient({\n  entries,\n}: DocsReferenceIndexClientProps) {\n  const [filters, setFilters] = useState<Filters>({});\n\n  const normalizedEntries = useMemo(\n    () => entries.map(normalizeEntry),\n    [entries]\n  );\n\n  const filteredEntries = useMemo(() => {\n    const query = filters.query?.trim() ?? '';\n    return normalizedEntries.filter((entry) => {\n      if (filters.kind && entry.kind !== filters.kind) return false;\n      if (filters.visibility && entry.visibility !== filters.visibility)\n        return false;\n      return matchesQuery(entry, query);\n    });\n  }, [filters, normalizedEntries]);\n\n  const searchForm = formRenderer.render(DocsSearchForm, {\n    defaultValues: {\n      query: filters.query ?? '',\n      visibility: filters.visibility ?? '',\n      kind: filters.kind ?? '',\n    },\n    overrides: {\n      onSubmitOverride: (values: unknown) => {\n        const submitted = values as Filters;\n        setFilters({\n          query: submitted.query ?? '',\n          visibility: submitted.visibility ?? '',\n          kind: submitted.kind ?? '',\n        });\n      },\n    },\n  });\n\n  return (\n    <VStack gap=\"xl\">\n      <VStack gap=\"sm\">\n        <H1>Contract Reference</H1>\n        <Muted>\n          Auto-generated reference docs for operations, events, forms, data\n          views, and presentations.\n        </Muted>\n      </VStack>\n\n      <VStack gap=\"sm\" className=\"max-w-2xl\">\n        {searchForm}\n      </VStack>\n\n      <DataViewList\n        spec={DocsIndexDataView}\n        items={filteredEntries}\n        emptyState={<Muted>No reference docs match your filters.</Muted>}\n        onSelect={(entry) => {\n          if (entry.route) {\n            window.location.assign(entry.route);\n          }\n        }}\n        renderActions={(entry) => {\n          return (\n            <HStack gap=\"xs\" justify=\"end\">\n              {entry.kind ? <StatusChip size=\"sm\" label={entry.kind} /> : null}\n              {entry.visibility ? (\n                <StatusChip size=\"sm\" label={entry.visibility} />\n              ) : null}\n              {entry.version ? (\n                <StatusChip size=\"sm\" label={`v${entry.version}`} />\n              ) : null}\n            </HStack>\n          );\n        }}\n      />\n    </VStack>\n  );\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAS,aAAa,SAAkB;AACtC,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,QACJ,QAAQ,eAAe,GAAG,CAC1B,QAAQ,WAAW,IAAI,CACvB,QAAQ,WAAW,OAAO,CAC1B,MAAM;;AAGX,SAAS,eAAe,OAAuC;CAC7D,MAAM,UAAU,aAAa,MAAM,QAAQ;CAC3C,MAAM,OACJ,MAAM,SAAS,MAAM,WAAW,cAAc,cAAc;CAC9D,MAAM,aACJ,MAAM,eAAe,MAAM,WAAW,cAAc,WAAW;AAEjE,QAAO;EACL,GAAG;EACH;EACA;EACA;EACD;;AAGH,SAAS,aAAa,OAAuB,OAAe;AAC1D,KAAI,CAAC,MAAO,QAAO;AAKnB,QAJiB;EAAC,MAAM;EAAO,MAAM;EAAS,MAAM;EAAI,GAAI,MAAM,QAAQ,EAAE;EAAE,CAC3E,OAAO,QAAQ,CACf,KAAK,IAAI,CACT,aAAa,CACA,SAAS,MAAM,aAAa,CAAC;;AAG/C,SAAgB,yBAAyB,EACvC,WACgC;CAChC,MAAM,CAAC,SAAS,cAAc,SAAkB,EAAE,CAAC;CAEnD,MAAM,oBAAoB,cAClB,QAAQ,IAAI,eAAe,EACjC,CAAC,QAAQ,CACV;CAED,MAAM,kBAAkB,cAAc;EACpC,MAAM,QAAQ,QAAQ,OAAO,MAAM,IAAI;AACvC,SAAO,kBAAkB,QAAQ,UAAU;AACzC,OAAI,QAAQ,QAAQ,MAAM,SAAS,QAAQ,KAAM,QAAO;AACxD,OAAI,QAAQ,cAAc,MAAM,eAAe,QAAQ,WACrD,QAAO;AACT,UAAO,aAAa,OAAO,MAAM;IACjC;IACD,CAAC,SAAS,kBAAkB,CAAC;CAEhC,MAAM,aAAa,aAAa,OAAO,gBAAgB;EACrD,eAAe;GACb,OAAO,QAAQ,SAAS;GACxB,YAAY,QAAQ,cAAc;GAClC,MAAM,QAAQ,QAAQ;GACvB;EACD,WAAW,EACT,mBAAmB,WAAoB;GACrC,MAAM,YAAY;AAClB,cAAW;IACT,OAAO,UAAU,SAAS;IAC1B,YAAY,UAAU,cAAc;IACpC,MAAM,UAAU,QAAQ;IACzB,CAAC;KAEL;EACF,CAAC;AAEF,QACE,qBAAC;EAAO,KAAI;;GACV,qBAAC;IAAO,KAAI;eACV,oBAAC,gBAAG,uBAAuB,EAC3B,oBAAC,mBAAM,gGAGC;KACD;GAET,oBAAC;IAAO,KAAI;IAAK,WAAU;cACxB;KACM;GAET,oBAAC;IACC,MAAM;IACN,OAAO;IACP,YAAY,oBAAC,mBAAM,0CAA6C;IAChE,WAAW,UAAU;AACnB,SAAI,MAAM,MACR,QAAO,SAAS,OAAO,MAAM,MAAM;;IAGvC,gBAAgB,UAAU;AACxB,YACE,qBAAC;MAAO,KAAI;MAAK,SAAQ;;OACtB,MAAM,OAAO,oBAAC;QAAW,MAAK;QAAK,OAAO,MAAM;SAAQ,GAAG;OAC3D,MAAM,aACL,oBAAC;QAAW,MAAK;QAAK,OAAO,MAAM;SAAc,GAC/C;OACH,MAAM,UACL,oBAAC;QAAW,MAAK;QAAK,OAAO,IAAI,MAAM;SAAa,GAClD;;OACG;;KAGb;;GACK"}

package/dist/components/docs/reference/DocsReferenceIndexPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferenceIndexPage.d.ts
+declare function DocsReferenceIndexPage(): Promise<react_jsx_runtime0.JSX.Element>;
+//#endregion
+export { DocsReferenceIndexPage };
+//# sourceMappingURL=DocsReferenceIndexPage.d.ts.map

package/dist/components/docs/reference/DocsReferenceIndexPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceIndexPage.d.ts","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceIndexPage.tsx"],"mappings":";;;iBAGsB,sBAAA,CAAA,GAAsB,OAAA,CAAA,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/reference/DocsReferenceIndexPage.js

@@ -0,0 +1,12 @@
+import { listGeneratedDocs } from "../generated/loader.js";
+import { DocsReferenceIndexClient } from "./DocsReferenceIndexClient.js";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferenceIndexPage.tsx
+async function DocsReferenceIndexPage() {
+	return /* @__PURE__ */ jsx(DocsReferenceIndexClient, { entries: await listGeneratedDocs() });
+}
+
+//#endregion
+export { DocsReferenceIndexPage };
+//# sourceMappingURL=DocsReferenceIndexPage.js.map

package/dist/components/docs/reference/DocsReferenceIndexPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferenceIndexPage.js","names":[],"sources":["../../../../src/components/docs/reference/DocsReferenceIndexPage.tsx"],"sourcesContent":["import { listGeneratedDocs } from '../generated/loader';\nimport { DocsReferenceIndexClient } from './DocsReferenceIndexClient';\n\nexport async function DocsReferenceIndexPage() {\n  const entries = await listGeneratedDocs();\n  return <DocsReferenceIndexClient entries={entries} />;\n}\n"],"mappings":";;;;;AAGA,eAAsB,yBAAyB;AAE7C,QAAO,oBAAC,4BAAyB,SADjB,MAAM,mBAAmB,GACY"}

package/dist/components/docs/reference/DocsReferencePage.d.ts

@@ -0,0 +1,15 @@
+import { DocsIndexEntry } from "../generated/docs-index.generated.js";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferencePage.d.ts
+interface DocsReferencePageProps {
+  entry: DocsIndexEntry;
+  content: string;
+}
+declare function DocsReferencePage({
+  entry,
+  content
+}: DocsReferencePageProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsReferencePage };
+//# sourceMappingURL=DocsReferencePage.d.ts.map

package/dist/components/docs/reference/DocsReferencePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferencePage.d.ts","names":[],"sources":["../../../../src/components/docs/reference/DocsReferencePage.tsx"],"mappings":";;;;UAGU,sBAAA;EACR,KAAA,EAAO,cAAA;EACP,OAAA;AAAA;AAAA,iBAGc,iBAAA,CAAA;EAAoB,KAAA;EAAO;AAAA,GAAW,sBAAA,GAAsB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/reference/DocsReferencePage.js

@@ -0,0 +1,14 @@
+import { DocsReferenceContent } from "./DocsReferenceContent.js";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/docs/reference/DocsReferencePage.tsx
+function DocsReferencePage({ entry, content }) {
+	return /* @__PURE__ */ jsx(DocsReferenceContent, {
+		entry,
+		content
+	});
+}
+
+//#endregion
+export { DocsReferencePage };
+//# sourceMappingURL=DocsReferencePage.js.map

package/dist/components/docs/reference/DocsReferencePage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsReferencePage.js","names":[],"sources":["../../../../src/components/docs/reference/DocsReferencePage.tsx"],"sourcesContent":["import type { DocsIndexEntry } from '../generated/docs-index.generated';\nimport { DocsReferenceContent } from './DocsReferenceContent';\n\ninterface DocsReferencePageProps {\n  entry: DocsIndexEntry;\n  content: string;\n}\n\nexport function DocsReferencePage({ entry, content }: DocsReferencePageProps) {\n  return <DocsReferenceContent entry={entry} content={content} />;\n}\n"],"mappings":";;;;AAQA,SAAgB,kBAAkB,EAAE,OAAO,WAAmC;AAC5E,QAAO,oBAAC;EAA4B;EAAgB;GAAW"}

package/dist/components/docs/reference/docsMarkdownParser.d.ts

@@ -0,0 +1,24 @@
+//#region src/components/docs/reference/docsMarkdownParser.d.ts
+type DocsMarkdownBlock = {
+  type: 'heading';
+  level: number;
+  text: string;
+} | {
+  type: 'paragraph';
+  text: string;
+} | {
+  type: 'list';
+  ordered: boolean;
+  items: string[];
+} | {
+  type: 'code';
+  language?: string;
+  code: string;
+} | {
+  type: 'quote';
+  text: string;
+};
+declare function parseDocsMarkdown(content: string): DocsMarkdownBlock[];
+//#endregion
+export { DocsMarkdownBlock, parseDocsMarkdown };
+//# sourceMappingURL=docsMarkdownParser.d.ts.map

package/dist/components/docs/reference/docsMarkdownParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsMarkdownParser.d.ts","names":[],"sources":["../../../../src/components/docs/reference/docsMarkdownParser.ts"],"mappings":";KAAY,iBAAA;EACN,IAAA;EAAiB,KAAA;EAAe,IAAA;AAAA;EAChC,IAAA;EAAmB,IAAA;AAAA;EACnB,IAAA;EAAc,OAAA;EAAkB,KAAA;AAAA;EAChC,IAAA;EAAc,QAAA;EAAmB,IAAA;AAAA;EACjC,IAAA;EAAe,IAAA;AAAA;AAAA,iBAeL,iBAAA,CAAkB,OAAA,WAAkB,iBAAA"}

package/dist/components/docs/reference/docsMarkdownParser.js

@@ -0,0 +1,96 @@
+//#region src/components/docs/reference/docsMarkdownParser.ts
+const METADATA_SECTION = /^##\s+Metadata[\s\S]*?(?=^##\s|^#\s|Z)/m;
+function stripMetadata(content) {
+	return content.replace(/^#\s+.*\n+/m, "").replace(METADATA_SECTION, "");
+}
+function isBlockStart(line) {
+	return /^#{1,4}\s+/.test(line) || /^```/.test(line) || /^\s*[-*]\s+/.test(line) || /^\s*\d+\.\s+/.test(line) || /^>\s+/.test(line);
+}
+function parseDocsMarkdown(content) {
+	const lines = stripMetadata(content).split(/\r?\n/);
+	const blocks = [];
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i] ?? "";
+		if (line.startsWith("<!-- @generated")) {
+			i += 1;
+			continue;
+		}
+		const trimmed = line.trim();
+		if (!trimmed) {
+			i += 1;
+			continue;
+		}
+		if (trimmed.startsWith("```")) {
+			const language = trimmed.slice(3).trim();
+			const codeLines = [];
+			i += 1;
+			while (i < lines.length && !(lines[i] ?? "").trim().startsWith("```")) {
+				codeLines.push(lines[i] ?? "");
+				i += 1;
+			}
+			i += 1;
+			blocks.push({
+				type: "code",
+				language: language || "text",
+				code: codeLines.join("\n")
+			});
+			continue;
+		}
+		if (/^#{1,4}\s+/.test(trimmed)) {
+			const level = trimmed.match(/^#{1,4}/)?.[0].length ?? 2;
+			blocks.push({
+				type: "heading",
+				level,
+				text: trimmed.replace(/^#{1,4}\s+/, "")
+			});
+			i += 1;
+			continue;
+		}
+		if (/^>\s+/.test(trimmed)) {
+			const quoteLines = [];
+			while (i < lines.length && /^>\s+/.test((lines[i] ?? "").trim())) {
+				quoteLines.push((lines[i] ?? "").trim().replace(/^>\s+/, ""));
+				i += 1;
+			}
+			blocks.push({
+				type: "quote",
+				text: quoteLines.join(" ")
+			});
+			continue;
+		}
+		if (/^[-*]\s+/.test(trimmed) || /^\d+\.\s+/.test(trimmed)) {
+			const ordered = /^\d+\.\s+/.test(trimmed);
+			const items = [];
+			while (i < lines.length && isBlockStart((lines[i] ?? "").trim())) {
+				const itemLine = (lines[i] ?? "").trim();
+				if (ordered && /^\d+\.\s+/.test(itemLine)) items.push(itemLine.replace(/^\d+\.\s+/, ""));
+				else if (!ordered && /^[-*]\s+/.test(itemLine)) items.push(itemLine.replace(/^[-*]\s+/, ""));
+				else break;
+				i += 1;
+			}
+			blocks.push({
+				type: "list",
+				ordered,
+				items
+			});
+			continue;
+		}
+		const paragraphLines = [];
+		while (i < lines.length && !isBlockStart((lines[i] ?? "").trim())) {
+			const paragraphLine = (lines[i] ?? "").trim();
+			if (!paragraphLine) break;
+			paragraphLines.push(paragraphLine);
+			i += 1;
+		}
+		blocks.push({
+			type: "paragraph",
+			text: paragraphLines.join(" ")
+		});
+	}
+	return blocks;
+}
+
+//#endregion
+export { parseDocsMarkdown };
+//# sourceMappingURL=docsMarkdownParser.js.map

package/dist/components/docs/reference/docsMarkdownParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsMarkdownParser.js","names":[],"sources":["../../../../src/components/docs/reference/docsMarkdownParser.ts"],"sourcesContent":["export type DocsMarkdownBlock =\n  | { type: 'heading'; level: number; text: string }\n  | { type: 'paragraph'; text: string }\n  | { type: 'list'; ordered: boolean; items: string[] }\n  | { type: 'code'; language?: string; code: string }\n  | { type: 'quote'; text: string };\nconst METADATA_SECTION = /^##\\s+Metadata[\\s\\S]*?(?=^##\\s|^#\\s|Z)/m;\nfunction stripMetadata(content: string) {\n  const withoutTitle = content.replace(/^#\\s+.*\\n+/m, '');\n  return withoutTitle.replace(METADATA_SECTION, '');\n}\nfunction isBlockStart(line: string) {\n  return (\n    /^#{1,4}\\s+/.test(line) ||\n    /^```/.test(line) ||\n    /^\\s*[-*]\\s+/.test(line) ||\n    /^\\s*\\d+\\.\\s+/.test(line) ||\n    /^>\\s+/.test(line)\n  );\n}\nexport function parseDocsMarkdown(content: string): DocsMarkdownBlock[] {\n  const lines = stripMetadata(content).split(/\\r?\\n/);\n  const blocks: DocsMarkdownBlock[] = [];\n  let i = 0;\n  while (i < lines.length) {\n    const line = lines[i] ?? '';\n    if (line.startsWith('<!-- @generated')) {\n      i += 1;\n      continue;\n    }\n\n    const trimmed = line.trim();\n    if (!trimmed) {\n      i += 1;\n      continue;\n    }\n    if (trimmed.startsWith('```')) {\n      const language = trimmed.slice(3).trim();\n      const codeLines: string[] = [];\n      i += 1;\n      while (i < lines.length && !(lines[i] ?? '').trim().startsWith('```')) {\n        codeLines.push(lines[i] ?? '');\n        i += 1;\n      }\n      i += 1;\n      blocks.push({\n        type: 'code',\n        language: language || 'text',\n        code: codeLines.join('\\n'),\n      });\n      continue;\n    }\n    if (/^#{1,4}\\s+/.test(trimmed)) {\n      const level = trimmed.match(/^#{1,4}/)?.[0].length ?? 2;\n      blocks.push({\n        type: 'heading',\n        level,\n        text: trimmed.replace(/^#{1,4}\\s+/, ''),\n      });\n      i += 1;\n      continue;\n    }\n    if (/^>\\s+/.test(trimmed)) {\n      const quoteLines: string[] = [];\n      while (i < lines.length && /^>\\s+/.test((lines[i] ?? '').trim())) {\n        quoteLines.push((lines[i] ?? '').trim().replace(/^>\\s+/, ''));\n        i += 1;\n      }\n      blocks.push({ type: 'quote', text: quoteLines.join(' ') });\n      continue;\n    }\n    if (/^[-*]\\s+/.test(trimmed) || /^\\d+\\.\\s+/.test(trimmed)) {\n      const ordered = /^\\d+\\.\\s+/.test(trimmed);\n      const items: string[] = [];\n      while (i < lines.length && isBlockStart((lines[i] ?? '').trim())) {\n        const itemLine = (lines[i] ?? '').trim();\n        if (ordered && /^\\d+\\.\\s+/.test(itemLine)) {\n          items.push(itemLine.replace(/^\\d+\\.\\s+/, ''));\n        } else if (!ordered && /^[-*]\\s+/.test(itemLine)) {\n          items.push(itemLine.replace(/^[-*]\\s+/, ''));\n        } else {\n          break;\n        }\n        i += 1;\n      }\n      blocks.push({ type: 'list', ordered, items });\n      continue;\n    }\n    const paragraphLines: string[] = [];\n    while (i < lines.length && !isBlockStart((lines[i] ?? '').trim())) {\n      const paragraphLine = (lines[i] ?? '').trim();\n      if (!paragraphLine) break;\n      paragraphLines.push(paragraphLine);\n      i += 1;\n    }\n    blocks.push({ type: 'paragraph', text: paragraphLines.join(' ') });\n  }\n  return blocks;\n}\n"],"mappings":";AAMA,MAAM,mBAAmB;AACzB,SAAS,cAAc,SAAiB;AAEtC,QADqB,QAAQ,QAAQ,eAAe,GAAG,CACnC,QAAQ,kBAAkB,GAAG;;AAEnD,SAAS,aAAa,MAAc;AAClC,QACE,aAAa,KAAK,KAAK,IACvB,OAAO,KAAK,KAAK,IACjB,cAAc,KAAK,KAAK,IACxB,eAAe,KAAK,KAAK,IACzB,QAAQ,KAAK,KAAK;;AAGtB,SAAgB,kBAAkB,SAAsC;CACtE,MAAM,QAAQ,cAAc,QAAQ,CAAC,MAAM,QAAQ;CACnD,MAAM,SAA8B,EAAE;CACtC,IAAI,IAAI;AACR,QAAO,IAAI,MAAM,QAAQ;EACvB,MAAM,OAAO,MAAM,MAAM;AACzB,MAAI,KAAK,WAAW,kBAAkB,EAAE;AACtC,QAAK;AACL;;EAGF,MAAM,UAAU,KAAK,MAAM;AAC3B,MAAI,CAAC,SAAS;AACZ,QAAK;AACL;;AAEF,MAAI,QAAQ,WAAW,MAAM,EAAE;GAC7B,MAAM,WAAW,QAAQ,MAAM,EAAE,CAAC,MAAM;GACxC,MAAM,YAAsB,EAAE;AAC9B,QAAK;AACL,UAAO,IAAI,MAAM,UAAU,EAAE,MAAM,MAAM,IAAI,MAAM,CAAC,WAAW,MAAM,EAAE;AACrE,cAAU,KAAK,MAAM,MAAM,GAAG;AAC9B,SAAK;;AAEP,QAAK;AACL,UAAO,KAAK;IACV,MAAM;IACN,UAAU,YAAY;IACtB,MAAM,UAAU,KAAK,KAAK;IAC3B,CAAC;AACF;;AAEF,MAAI,aAAa,KAAK,QAAQ,EAAE;GAC9B,MAAM,QAAQ,QAAQ,MAAM,UAAU,GAAG,GAAG,UAAU;AACtD,UAAO,KAAK;IACV,MAAM;IACN;IACA,MAAM,QAAQ,QAAQ,cAAc,GAAG;IACxC,CAAC;AACF,QAAK;AACL;;AAEF,MAAI,QAAQ,KAAK,QAAQ,EAAE;GACzB,MAAM,aAAuB,EAAE;AAC/B,UAAO,IAAI,MAAM,UAAU,QAAQ,MAAM,MAAM,MAAM,IAAI,MAAM,CAAC,EAAE;AAChE,eAAW,MAAM,MAAM,MAAM,IAAI,MAAM,CAAC,QAAQ,SAAS,GAAG,CAAC;AAC7D,SAAK;;AAEP,UAAO,KAAK;IAAE,MAAM;IAAS,MAAM,WAAW,KAAK,IAAI;IAAE,CAAC;AAC1D;;AAEF,MAAI,WAAW,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE;GACzD,MAAM,UAAU,YAAY,KAAK,QAAQ;GACzC,MAAM,QAAkB,EAAE;AAC1B,UAAO,IAAI,MAAM,UAAU,cAAc,MAAM,MAAM,IAAI,MAAM,CAAC,EAAE;IAChE,MAAM,YAAY,MAAM,MAAM,IAAI,MAAM;AACxC,QAAI,WAAW,YAAY,KAAK,SAAS,CACvC,OAAM,KAAK,SAAS,QAAQ,aAAa,GAAG,CAAC;aACpC,CAAC,WAAW,WAAW,KAAK,SAAS,CAC9C,OAAM,KAAK,SAAS,QAAQ,YAAY,GAAG,CAAC;QAE5C;AAEF,SAAK;;AAEP,UAAO,KAAK;IAAE,MAAM;IAAQ;IAAS;IAAO,CAAC;AAC7C;;EAEF,MAAM,iBAA2B,EAAE;AACnC,SAAO,IAAI,MAAM,UAAU,CAAC,cAAc,MAAM,MAAM,IAAI,MAAM,CAAC,EAAE;GACjE,MAAM,iBAAiB,MAAM,MAAM,IAAI,MAAM;AAC7C,OAAI,CAAC,cAAe;AACpB,kBAAe,KAAK,cAAc;AAClC,QAAK;;AAEP,SAAO,KAAK;GAAE,MAAM;GAAa,MAAM,eAAe,KAAK,IAAI;GAAE,CAAC;;AAEpE,QAAO"}

package/dist/components/docs/reference/index.d.ts

@@ -0,0 +1,3 @@
+import { DocsReferenceIndexPage } from "./DocsReferenceIndexPage.js";
+import { DocsReferencePage } from "./DocsReferencePage.js";
+export { DocsReferenceIndexPage, DocsReferencePage };

package/dist/components/docs/reference/index.js

@@ -0,0 +1,4 @@
+import { DocsReferenceIndexPage } from "./DocsReferenceIndexPage.js";
+import { DocsReferencePage } from "./DocsReferencePage.js";
+
+export { DocsReferenceIndexPage, DocsReferencePage };