@contractspec/lib.contracts 0.0.0-canary-20260119225944 → 0.0.0-canary-20260128200020

package/dist/docs/events/docsGenerated.event.d.ts

@@ -0,0 +1,62 @@
+import { EventSpec } from "../../events.js";
+import "../../index.js";
+import * as _contractspec_lib_schema300 from "@contractspec/lib.schema";
+import { SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/events/docsGenerated.event.d.ts
+declare const DocsGeneratedPayload: SchemaModel<{
+  buildId: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+  };
+  generatedAt: {
+    type: _contractspec_lib_schema300.FieldType<Date, string>;
+    isOptional: false;
+  };
+  outputDir: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+  };
+  artifactCount: {
+    type: _contractspec_lib_schema300.FieldType<number, number>;
+    isOptional: true;
+  };
+  warnings: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>;
+declare const DocsGeneratedEvent: EventSpec<SchemaModel<{
+  buildId: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+  };
+  generatedAt: {
+    type: _contractspec_lib_schema300.FieldType<Date, string>;
+    isOptional: false;
+  };
+  outputDir: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+  };
+  artifactCount: {
+    type: _contractspec_lib_schema300.FieldType<number, number>;
+    isOptional: true;
+  };
+  warnings: {
+    type: _contractspec_lib_schema300.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+//#endregion
+export { DocsGeneratedEvent, DocsGeneratedPayload };

package/dist/docs/events/docsGenerated.event.js

@@ -0,0 +1,53 @@
+import { defineEvent } from "../../events.js";
+import { DOCS_DOMAIN, DOCS_OWNERS, DOCS_STABILITY, DOCS_TAGS } from "../constants.js";
+import { docId } from "../registry.js";
+import "../ensure-docblocks.js";
+import { ScalarTypeEnum, SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/events/docsGenerated.event.ts
+const DocsGeneratedPayload = new SchemaModel({
+	name: "DocsGeneratedPayload",
+	fields: {
+		buildId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		generatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		outputDir: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		artifactCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		warnings: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true,
+			isArray: true
+		}
+	}
+});
+const DocsGeneratedEvent = defineEvent({
+	meta: {
+		key: "docs.generated",
+		version: "1.0.0",
+		description: "Emitted when documentation artifacts are generated.",
+		domain: DOCS_DOMAIN,
+		owners: DOCS_OWNERS,
+		tags: [...DOCS_TAGS, "generation"],
+		stability: DOCS_STABILITY,
+		docId: [docId("docs.tech.docs-generator")]
+	},
+	payload: DocsGeneratedPayload
+});
+
+//#endregion
+export { DocsGeneratedEvent, DocsGeneratedPayload };

package/dist/docs/events/docsPublished.event.d.ts

@@ -0,0 +1,70 @@
+import { EventSpec } from "../../events.js";
+import "../../index.js";
+import * as _contractspec_lib_schema312 from "@contractspec/lib.schema";
+import { SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/events/docsPublished.event.d.ts
+declare const DocsPublishedPayload: SchemaModel<{
+  publishId: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  environment: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  url: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  publishedAt: {
+    type: _contractspec_lib_schema312.FieldType<Date, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  warnings: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>;
+declare const DocsPublishedEvent: EventSpec<SchemaModel<{
+  publishId: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  environment: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  url: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  publishedAt: {
+    type: _contractspec_lib_schema312.FieldType<Date, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+  };
+  warnings: {
+    type: _contractspec_lib_schema312.FieldType<string, string>;
+    isOptional: true;
+    isArray: true;
+  };
+}>>;
+//#endregion
+export { DocsPublishedEvent, DocsPublishedPayload };

package/dist/docs/events/docsPublished.event.js

@@ -0,0 +1,57 @@
+import { defineEvent } from "../../events.js";
+import { DOCS_DOMAIN, DOCS_OWNERS, DOCS_STABILITY, DOCS_TAGS } from "../constants.js";
+import { docId } from "../registry.js";
+import "../ensure-docblocks.js";
+import { ScalarTypeEnum, SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/events/docsPublished.event.ts
+const DocsPublishedPayload = new SchemaModel({
+	name: "DocsPublishedPayload",
+	fields: {
+		publishId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		version: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		environment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		url: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		publishedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		warnings: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true,
+			isArray: true
+		}
+	}
+});
+const DocsPublishedEvent = defineEvent({
+	meta: {
+		key: "docs.published",
+		version: "1.0.0",
+		description: "Emitted when documentation is published.",
+		domain: DOCS_DOMAIN,
+		owners: DOCS_OWNERS,
+		tags: [...DOCS_TAGS, "publish"],
+		stability: DOCS_STABILITY,
+		docId: [docId("docs.tech.docs-publish")]
+	},
+	payload: DocsPublishedPayload
+});
+
+//#endregion
+export { DocsPublishedEvent, DocsPublishedPayload };

package/dist/docs/events/index.d.ts

@@ -0,0 +1,3 @@
+import { DocsGeneratedEvent, DocsGeneratedPayload } from "./docsGenerated.event.js";
+import { DocsPublishedEvent, DocsPublishedPayload } from "./docsPublished.event.js";
+export { DocsGeneratedEvent, DocsGeneratedPayload, DocsPublishedEvent, DocsPublishedPayload };

package/dist/docs/events/index.js

@@ -0,0 +1,4 @@
+import { DocsGeneratedEvent, DocsGeneratedPayload } from "./docsGenerated.event.js";
+import { DocsPublishedEvent, DocsPublishedPayload } from "./docsPublished.event.js";
+
+export { DocsGeneratedEvent, DocsGeneratedPayload, DocsPublishedEvent, DocsPublishedPayload };

package/dist/docs/forms/docsSearch.form.d.ts

@@ -0,0 +1,22 @@
+import { FormSpec } from "../../forms/forms.js";
+import "../../index.js";
+import * as _contractspec_lib_schema297 from "@contractspec/lib.schema";
+import { SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/forms/docsSearch.form.d.ts
+declare const DocsSearchForm: FormSpec<SchemaModel<{
+  query: {
+    type: _contractspec_lib_schema297.FieldType<string, string>;
+    isOptional: true;
+  };
+  visibility: {
+    type: _contractspec_lib_schema297.FieldType<string, string>;
+    isOptional: true;
+  };
+  kind: {
+    type: _contractspec_lib_schema297.FieldType<string, string>;
+    isOptional: true;
+  };
+}>>;
+//#endregion
+export { DocsSearchForm };

package/dist/docs/forms/docsSearch.form.js

@@ -0,0 +1,113 @@
+import { defineFormSpec } from "../../forms/forms.js";
+import { DOCS_DOMAIN, DOCS_OWNERS, DOCS_STABILITY, DOCS_TAGS } from "../constants.js";
+import { docId } from "../registry.js";
+import "../ensure-docblocks.js";
+import { ScalarTypeEnum, SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/docs/forms/docsSearch.form.ts
+const DocsSearchFormModel = new SchemaModel({
+	name: "DocsSearchFormModel",
+	fields: {
+		query: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		visibility: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		kind: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const DocsSearchForm = defineFormSpec({
+	meta: {
+		key: "docs.search.form",
+		title: "Docs Search",
+		version: "1.0.0",
+		description: "Search form for documentation discovery.",
+		domain: DOCS_DOMAIN,
+		owners: DOCS_OWNERS,
+		tags: [...DOCS_TAGS, "search"],
+		stability: DOCS_STABILITY,
+		docId: [docId("docs.tech.docs-search")]
+	},
+	model: DocsSearchFormModel,
+	fields: [
+		{
+			kind: "text",
+			name: "query",
+			labelI18n: "Search",
+			placeholderI18n: "Search docs"
+		},
+		{
+			kind: "select",
+			name: "visibility",
+			labelI18n: "Visibility",
+			options: {
+				kind: "static",
+				options: [
+					{
+						labelI18n: "Public",
+						value: "public"
+					},
+					{
+						labelI18n: "Internal",
+						value: "internal"
+					},
+					{
+						labelI18n: "Mixed",
+						value: "mixed"
+					}
+				]
+			}
+		},
+		{
+			kind: "select",
+			name: "kind",
+			labelI18n: "Kind",
+			options: {
+				kind: "static",
+				options: [
+					{
+						labelI18n: "Goal",
+						value: "goal"
+					},
+					{
+						labelI18n: "How",
+						value: "how"
+					},
+					{
+						labelI18n: "Usage",
+						value: "usage"
+					},
+					{
+						labelI18n: "Reference",
+						value: "reference"
+					},
+					{
+						labelI18n: "FAQ",
+						value: "faq"
+					},
+					{
+						labelI18n: "Changelog",
+						value: "changelog"
+					}
+				]
+			}
+		}
+	],
+	actions: [{
+		key: "search",
+		labelI18n: "Search"
+	}],
+	policy: {
+		flags: [],
+		pii: []
+	}
+});
+
+//#endregion
+export { DocsSearchForm };

package/dist/docs/forms/index.d.ts

@@ -0,0 +1,2 @@
+import { DocsSearchForm } from "./docsSearch.form.js";
+export { DocsSearchForm };

package/dist/docs/forms/index.js

@@ -0,0 +1,3 @@
+import { DocsSearchForm } from "./docsSearch.form.js";
+
+export { DocsSearchForm };

package/dist/docs/index.d.ts

@@ -1,7 +1,28 @@
 import { DocBlock, DocBlockLink, DocKind, DocVisibility } from "./types.js";
+import { DOCS_CAPABILITY_KEY, DOCS_CAPABILITY_REF, DOCS_CAPABILITY_VERSION, DOCS_DOMAIN, DOCS_LAYOUT_PRESENTATION_KEY, DOCS_OWNERS, DOCS_REFERENCE_PRESENTATION_KEY, DOCS_STABILITY, DOCS_TAGS } from "./constants.js";
+import { DocsGenerateCommand } from "./commands/docsGenerate.command.js";
+import { DocsPublishCommand } from "./commands/docsPublish.command.js";
+import "./commands/index.js";
+import { DocSummaryModel, DocsIndexInput, DocsIndexOutput, DocsIndexQuery } from "./queries/docsIndex.query.js";
+import { ContractReferenceInput, ContractReferenceModel, ContractReferenceOutput, ContractReferenceQuery } from "./queries/contractReference.query.js";
+import "./queries/index.js";
+import { DocsGeneratedEvent, DocsGeneratedPayload } from "./events/docsGenerated.event.js";
+import { DocsPublishedEvent, DocsPublishedPayload } from "./events/docsPublished.event.js";
+import "./events/index.js";
+import { DocumentationSystemCapability } from "./capabilities/documentationSystem.capability.js";
+import "./capabilities/index.js";
+import { docsDataViewContracts, docsEventContracts, docsFormContracts, docsOperationContracts, docsPresentationContracts, registerDocsDataViews, registerDocsEvents, registerDocsForms, registerDocsOperations, registerDocsPresentations } from "./contracts.js";
 import { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./presentations.js";
+import { DocsLayoutPresentation } from "./presentations/docsLayout.presentation.js";
+import { DocsReferencePagePresentation } from "./presentations/docsReferencePage.presentation.js";
+import "./presentations/index.js";
+import { DocsSearchForm } from "./forms/docsSearch.form.js";
+import "./forms/index.js";
+import { DocsIndexDataView } from "./views/docsIndex.dataView.js";
+import { ContractReferenceDataView } from "./views/contractReference.dataView.js";
+import { ExampleCatalogDataView } from "./views/exampleCatalog.dataView.js";
+import "./views/index.js";
 import { DocId, DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./registry.js";
 import { techContractsDocs } from "./tech-contracts.docs.js";
 import { metaDocs } from "./meta.docs.js";
-import "./tech/cli.docblock.js";
-export { DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocVisibility, defaultDocRegistry, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, techContractsDocs };
+export { ContractReferenceDataView, ContractReferenceInput, ContractReferenceModel, ContractReferenceOutput, ContractReferenceQuery, DOCS_CAPABILITY_KEY, DOCS_CAPABILITY_REF, DOCS_CAPABILITY_VERSION, DOCS_DOMAIN, DOCS_LAYOUT_PRESENTATION_KEY, DOCS_OWNERS, DOCS_REFERENCE_PRESENTATION_KEY, DOCS_STABILITY, DOCS_TAGS, DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocSummaryModel, DocVisibility, DocsGenerateCommand, DocsGeneratedEvent, DocsGeneratedPayload, DocsIndexDataView, DocsIndexInput, DocsIndexOutput, DocsIndexQuery, DocsLayoutPresentation, DocsPublishCommand, DocsPublishedEvent, DocsPublishedPayload, DocsReferencePagePresentation, DocsSearchForm, DocumentationSystemCapability, ExampleCatalogDataView, defaultDocRegistry, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, docsDataViewContracts, docsEventContracts, docsFormContracts, docsOperationContracts, docsPresentationContracts, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, registerDocsDataViews, registerDocsEvents, registerDocsForms, registerDocsOperations, registerDocsPresentations, techContractsDocs };

package/dist/docs/index.js

@@ -1,5 +1,28 @@
+import { DOCS_CAPABILITY_KEY, DOCS_CAPABILITY_REF, DOCS_CAPABILITY_VERSION, DOCS_DOMAIN, DOCS_LAYOUT_PRESENTATION_KEY, DOCS_OWNERS, DOCS_REFERENCE_PRESENTATION_KEY, DOCS_STABILITY, DOCS_TAGS } from "./constants.js";
 import { docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./presentations.js";
 import { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./registry.js";
+import "./tech/docs-system.docblock.js";
+import { DocsGeneratedEvent, DocsGeneratedPayload } from "./events/docsGenerated.event.js";
+import { DocsGenerateCommand } from "./commands/docsGenerate.command.js";
+import { DocsPublishedEvent, DocsPublishedPayload } from "./events/docsPublished.event.js";
+import { DocsPublishCommand } from "./commands/docsPublish.command.js";
+import "./commands/index.js";
+import { DocSummaryModel, DocsIndexInput, DocsIndexOutput, DocsIndexQuery } from "./queries/docsIndex.query.js";
+import { ContractReferenceInput, ContractReferenceModel, ContractReferenceOutput, ContractReferenceQuery } from "./queries/contractReference.query.js";
+import "./queries/index.js";
+import "./events/index.js";
+import { DocumentationSystemCapability } from "./capabilities/documentationSystem.capability.js";
+import "./capabilities/index.js";
+import { DocsLayoutPresentation } from "./presentations/docsLayout.presentation.js";
+import { DocsReferencePagePresentation } from "./presentations/docsReferencePage.presentation.js";
+import "./presentations/index.js";
+import { DocsSearchForm } from "./forms/docsSearch.form.js";
+import "./forms/index.js";
+import { DocsIndexDataView } from "./views/docsIndex.dataView.js";
+import { ContractReferenceDataView } from "./views/contractReference.dataView.js";
+import { ExampleCatalogDataView } from "./views/exampleCatalog.dataView.js";
+import "./views/index.js";
+import { docsDataViewContracts, docsEventContracts, docsFormContracts, docsOperationContracts, docsPresentationContracts, registerDocsDataViews, registerDocsEvents, registerDocsForms, registerDocsOperations, registerDocsPresentations } from "./contracts.js";
 import { techContractsDocs } from "./tech-contracts.docs.js";
 import { metaDocs } from "./meta.docs.js";
 import "./accessibility_wcag_compliance_specs.docblock.js";
@@ -27,4 +50,4 @@ import "./tech/studio/team-invitations.docblock.js";
 import "./tech/llm/llm-integration.docblock.js";
 import "./tech/cli.docblock.js";
 
-export { DocRegistry, defaultDocRegistry, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, techContractsDocs };
+export { ContractReferenceDataView, ContractReferenceInput, ContractReferenceModel, ContractReferenceOutput, ContractReferenceQuery, DOCS_CAPABILITY_KEY, DOCS_CAPABILITY_REF, DOCS_CAPABILITY_VERSION, DOCS_DOMAIN, DOCS_LAYOUT_PRESENTATION_KEY, DOCS_OWNERS, DOCS_REFERENCE_PRESENTATION_KEY, DOCS_STABILITY, DOCS_TAGS, DocRegistry, DocSummaryModel, DocsGenerateCommand, DocsGeneratedEvent, DocsGeneratedPayload, DocsIndexDataView, DocsIndexInput, DocsIndexOutput, DocsIndexQuery, DocsLayoutPresentation, DocsPublishCommand, DocsPublishedEvent, DocsPublishedPayload, DocsReferencePagePresentation, DocsSearchForm, DocumentationSystemCapability, ExampleCatalogDataView, defaultDocRegistry, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, docsDataViewContracts, docsEventContracts, docsFormContracts, docsOperationContracts, docsPresentationContracts, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, registerDocsDataViews, registerDocsEvents, registerDocsForms, registerDocsOperations, registerDocsPresentations, techContractsDocs };

package/dist/docs/presentations/docsLayout.presentation.d.ts

@@ -0,0 +1,7 @@
+import { PresentationSpec } from "../../presentations/presentations.js";
+import "../../index.js";
+
+//#region src/docs/presentations/docsLayout.presentation.d.ts
+declare const DocsLayoutPresentation: PresentationSpec;
+//#endregion
+export { DocsLayoutPresentation };

package/dist/docs/presentations/docsLayout.presentation.js

@@ -0,0 +1,32 @@
+import { definePresentation } from "../../presentations/presentations.js";
+import "../../presentations/index.js";
+import { DOCS_CAPABILITY_REF, DOCS_DOMAIN, DOCS_LAYOUT_PRESENTATION_KEY, DOCS_OWNERS, DOCS_STABILITY, DOCS_TAGS } from "../constants.js";
+import { docId } from "../registry.js";
+import "../ensure-docblocks.js";
+
+//#region src/docs/presentations/docsLayout.presentation.ts
+const DocsLayoutPresentation = definePresentation({
+	meta: {
+		key: DOCS_LAYOUT_PRESENTATION_KEY,
+		title: "Docs Layout",
+		version: "1.0.0",
+		description: "Shared layout shell for documentation pages.",
+		goal: "Provide consistent navigation, layout, and docs UI scaffolding.",
+		context: "Used by web docs surfaces to render DocBlock-based content.",
+		domain: DOCS_DOMAIN,
+		owners: DOCS_OWNERS,
+		tags: [...DOCS_TAGS, "layout"],
+		stability: DOCS_STABILITY,
+		docId: [docId("docs.tech.docs-system")]
+	},
+	capability: DOCS_CAPABILITY_REF,
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: DOCS_LAYOUT_PRESENTATION_KEY
+	},
+	targets: ["react"]
+});
+
+//#endregion
+export { DocsLayoutPresentation };

package/dist/docs/presentations/docsReferencePage.presentation.d.ts

@@ -0,0 +1,7 @@
+import { PresentationSpec } from "../../presentations/presentations.js";
+import "../../index.js";
+
+//#region src/docs/presentations/docsReferencePage.presentation.d.ts
+declare const DocsReferencePagePresentation: PresentationSpec;
+//#endregion
+export { DocsReferencePagePresentation };

package/dist/docs/presentations/docsReferencePage.presentation.js

@@ -0,0 +1,32 @@
+import { definePresentation } from "../../presentations/presentations.js";
+import "../../presentations/index.js";
+import { DOCS_CAPABILITY_REF, DOCS_DOMAIN, DOCS_OWNERS, DOCS_REFERENCE_PRESENTATION_KEY, DOCS_STABILITY, DOCS_TAGS } from "../constants.js";
+import { docId } from "../registry.js";
+import "../ensure-docblocks.js";
+
+//#region src/docs/presentations/docsReferencePage.presentation.ts
+const DocsReferencePagePresentation = definePresentation({
+	meta: {
+		key: DOCS_REFERENCE_PRESENTATION_KEY,
+		title: "Docs Reference Page",
+		version: "1.0.0",
+		description: "Reference page layout for contract documentation.",
+		goal: "Render contract references with consistent metadata and formatting.",
+		context: "Used by docs surfaces to present contract reference content and schemas.",
+		domain: DOCS_DOMAIN,
+		owners: DOCS_OWNERS,
+		tags: [...DOCS_TAGS, "reference"],
+		stability: DOCS_STABILITY,
+		docId: [docId("docs.tech.docs-reference")]
+	},
+	capability: DOCS_CAPABILITY_REF,
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: DOCS_REFERENCE_PRESENTATION_KEY
+	},
+	targets: ["react", "markdown"]
+});
+
+//#endregion
+export { DocsReferencePagePresentation };

package/dist/docs/presentations/index.d.ts

@@ -0,0 +1,3 @@
+import { DocsLayoutPresentation } from "./docsLayout.presentation.js";
+import { DocsReferencePagePresentation } from "./docsReferencePage.presentation.js";
+export { DocsLayoutPresentation, DocsReferencePagePresentation };

package/dist/docs/presentations/index.js

@@ -0,0 +1,4 @@
+import { DocsLayoutPresentation } from "./docsLayout.presentation.js";
+import { DocsReferencePagePresentation } from "./docsReferencePage.presentation.js";
+
+export { DocsLayoutPresentation, DocsReferencePagePresentation };