@lssm/lib.contracts-transformers 0.0.0-canary-20251221114240 → 0.0.0-canary-20251221144710

package/dist/openapi/exporter/operations.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+
+//#region src/openapi/exporter/operations.ts
+/**
+* Convert a spec name and version to an operationId.
+*/
+function toOperationId(name, version) {
+	return `${name.replace(/\./g, "_")}_v${version}`;
+}
+/**
+* Convert a spec name and version to a schema name.
+*/
+function toSchemaName(prefix, name, version) {
+	return `${prefix}_${toOperationId(name, version)}`;
+}
+/**
+* Determine HTTP method from spec kind and override.
+*/
+function toHttpMethod(kind, override) {
+	return (override ?? (kind === "query" ? "GET" : "POST")).toLowerCase();
+}
+/**
+* Generate default REST path from spec name and version.
+*/
+function defaultRestPath(name, version) {
+	return `/${name.replace(/\./g, "/")}/v${version}`;
+}
+/**
+* Get REST path from spec, using transport override or default.
+*/
+function toRestPath(spec) {
+	const path = spec.transport?.rest?.path ?? defaultRestPath(spec.meta.name, spec.meta.version);
+	return path.startsWith("/") ? path : `/${path}`;
+}
+/**
+* Convert a SchemaModel to JSON Schema using Zod.
+*/
+function schemaModelToJsonSchema(schema) {
+	if (!schema) return null;
+	return z.toJSONSchema(schema.getZod());
+}
+/**
+* Extract JSON Schema for a spec's input and output.
+*/
+function jsonSchemaForSpec(spec) {
+	return {
+		input: schemaModelToJsonSchema(spec.io.input),
+		output: schemaModelToJsonSchema(spec.io.output),
+		meta: {
+			name: spec.meta.name,
+			version: spec.meta.version,
+			kind: spec.meta.kind,
+			description: spec.meta.description,
+			tags: spec.meta.tags ?? [],
+			stability: spec.meta.stability ?? "stable"
+		}
+	};
+}
+/**
+* Export operations from a registry to OpenAPI paths and schemas.
+*/
+function exportOperations(registry) {
+	const specs = registry.listSpecs().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
+		const byName = a.meta.name.localeCompare(b.meta.name);
+		return byName !== 0 ? byName : a.meta.version - b.meta.version;
+	});
+	const paths = {};
+	const schemas = {};
+	for (const spec of specs) {
+		const schema = jsonSchemaForSpec(spec);
+		const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);
+		const path = toRestPath(spec);
+		const operationId = toOperationId(spec.meta.name, spec.meta.version);
+		const pathItem = paths[path] ??= {};
+		const op = {
+			operationId,
+			summary: spec.meta.description ?? spec.meta.name,
+			description: spec.meta.description,
+			tags: spec.meta.tags ?? [],
+			"x-contractspec": {
+				name: spec.meta.name,
+				version: spec.meta.version,
+				kind: spec.meta.kind
+			},
+			responses: {}
+		};
+		if (schema.input) {
+			const inputName = toSchemaName("Input", spec.meta.name, spec.meta.version);
+			schemas[inputName] = schema.input;
+			op["requestBody"] = {
+				required: true,
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${inputName}` } } }
+			};
+		}
+		const responses = {};
+		if (schema.output) {
+			const outputName = toSchemaName("Output", spec.meta.name, spec.meta.version);
+			schemas[outputName] = schema.output;
+			responses["200"] = {
+				description: "OK",
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${outputName}` } } }
+			};
+		} else responses["200"] = { description: "OK" };
+		op["responses"] = responses;
+		pathItem[method] = op;
+	}
+	return {
+		paths,
+		schemas
+	};
+}
+/**
+* Generate TypeScript code for operations registry.
+*/
+function generateOperationsRegistry(registry) {
+	const specs = registry.listSpecs();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const spec of specs) {
+		const specVarName = spec.meta.name.replace(/\./g, "_") + `_v${spec.meta.version}`;
+		imports.add(`import { ${specVarName} } from './${spec.meta.name.split(".")[0]}';`);
+		registrations.push(`  .register(${specVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated operations registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { OperationSpecRegistry } from '@lssm/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const operationsRegistry = new OperationSpecRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "operations-registry.ts"
+	};
+}
+
+//#endregion
+export { defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName };
+//# sourceMappingURL=operations.js.map

package/dist/openapi/exporter/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","names":["paths: Record<string, Record<string, unknown>>","schemas: Record<string, OpenApiSchemaObject>","op: Record<string, unknown>","responses: Record<string, unknown>","registrations: string[]"],"sources":["../../../src/openapi/exporter/operations.ts"],"sourcesContent":["/**\n * Operations exporter - exports OperationSpec to OpenAPI paths.\n */\nimport type {\n  AnyOperationSpec,\n  OperationSpec,\n  OperationSpecRegistry,\n} from '@lssm/lib.contracts';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport { z } from 'zod';\nimport type { GeneratedRegistryCode } from '../types';\n\ntype OpenApiSchemaObject = Record<string, unknown>;\n\n/**\n * Convert a spec name and version to an operationId.\n */\nexport function toOperationId(name: string, version: number): string {\n  return `${name.replace(/\\./g, '_')}_v${version}`;\n}\n\n/**\n * Convert a spec name and version to a schema name.\n */\nexport function toSchemaName(\n  prefix: 'Input' | 'Output',\n  name: string,\n  version: number\n): string {\n  return `${prefix}_${toOperationId(name, version)}`;\n}\n\n/**\n * Determine HTTP method from spec kind and override.\n */\nexport function toHttpMethod(\n  kind: 'command' | 'query',\n  override?: 'GET' | 'POST'\n): string {\n  const method = override ?? (kind === 'query' ? 'GET' : 'POST');\n  return method.toLowerCase();\n}\n\n/**\n * Generate default REST path from spec name and version.\n */\nexport function defaultRestPath(name: string, version: number): string {\n  return `/${name.replace(/\\./g, '/')}/v${version}`;\n}\n\n/**\n * Get REST path from spec, using transport override or default.\n */\nexport function toRestPath(spec: AnyOperationSpec): string {\n  const path =\n    spec.transport?.rest?.path ??\n    defaultRestPath(spec.meta.name, spec.meta.version);\n  return path.startsWith('/') ? path : `/${path}`;\n}\n\n/**\n * Convert a SchemaModel to JSON Schema using Zod.\n */\nexport function schemaModelToJsonSchema(\n  schema: AnySchemaModel | null\n): OpenApiSchemaObject | null {\n  if (!schema) return null;\n  return z.toJSONSchema(schema.getZod()) as OpenApiSchemaObject;\n}\n\ninterface SpecJsonSchema {\n  input: OpenApiSchemaObject | null;\n  output: OpenApiSchemaObject | null;\n  meta: {\n    name: string;\n    version: number;\n    kind: 'command' | 'query';\n    description: string;\n    tags: string[];\n    stability: string;\n  };\n}\n\n/**\n * Extract JSON Schema for a spec's input and output.\n */\nexport function jsonSchemaForSpec(\n  spec: OperationSpec<AnySchemaModel, AnySchemaModel>\n): SpecJsonSchema {\n  return {\n    input: schemaModelToJsonSchema(spec.io.input),\n    output: schemaModelToJsonSchema(spec.io.output as AnySchemaModel | null),\n    meta: {\n      name: spec.meta.name,\n      version: spec.meta.version,\n      kind: spec.meta.kind,\n      description: spec.meta.description,\n      tags: spec.meta.tags ?? [],\n      stability: spec.meta.stability ?? 'stable',\n    },\n  };\n}\n\n/**\n * Result of exporting operations to OpenAPI format.\n */\nexport interface OperationsExportResult {\n  paths: Record<string, Record<string, unknown>>;\n  schemas: Record<string, OpenApiSchemaObject>;\n}\n\n/**\n * Export operations from a registry to OpenAPI paths and schemas.\n */\nexport function exportOperations(\n  registry: OperationSpecRegistry\n): OperationsExportResult {\n  const specs = registry\n    .listSpecs()\n    .filter(\n      (s): s is AnyOperationSpec =>\n        s.meta.kind === 'command' || s.meta.kind === 'query'\n    )\n    .slice()\n    .sort((a, b) => {\n      const byName = a.meta.name.localeCompare(b.meta.name);\n      return byName !== 0 ? byName : a.meta.version - b.meta.version;\n    });\n\n  const paths: Record<string, Record<string, unknown>> = {};\n  const schemas: Record<string, OpenApiSchemaObject> = {};\n\n  for (const spec of specs) {\n    const schema = jsonSchemaForSpec(\n      spec as unknown as OperationSpec<AnySchemaModel, AnySchemaModel>\n    );\n    const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);\n    const path = toRestPath(spec);\n\n    const operationId = toOperationId(spec.meta.name, spec.meta.version);\n\n    const pathItem = (paths[path] ??= {});\n    const op: Record<string, unknown> = {\n      operationId,\n      summary: spec.meta.description ?? spec.meta.name,\n      description: spec.meta.description,\n      tags: spec.meta.tags ?? [],\n      'x-contractspec': {\n        name: spec.meta.name,\n        version: spec.meta.version,\n        kind: spec.meta.kind,\n      },\n      responses: {},\n    };\n\n    if (schema.input) {\n      const inputName = toSchemaName('Input', spec.meta.name, spec.meta.version);\n      schemas[inputName] = schema.input;\n      op['requestBody'] = {\n        required: true,\n        content: {\n          'application/json': {\n            schema: { $ref: `#/components/schemas/${inputName}` },\n          },\n        },\n      };\n    }\n\n    const responses: Record<string, unknown> = {};\n    if (schema.output) {\n      const outputName = toSchemaName(\n        'Output',\n        spec.meta.name,\n        spec.meta.version\n      );\n      schemas[outputName] = schema.output;\n      responses['200'] = {\n        description: 'OK',\n        content: {\n          'application/json': {\n            schema: { $ref: `#/components/schemas/${outputName}` },\n          },\n        },\n      };\n    } else {\n      responses['200'] = { description: 'OK' };\n    }\n    op['responses'] = responses;\n\n    pathItem[method] = op;\n  }\n\n  return { paths, schemas };\n}\n\n/**\n * Generate TypeScript code for operations registry.\n */\nexport function generateOperationsRegistry(\n  registry: OperationSpecRegistry\n): GeneratedRegistryCode {\n  const specs = registry.listSpecs();\n\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const spec of specs) {\n    const specVarName = spec.meta.name.replace(/\\./g, '_') + `_v${spec.meta.version}`;\n    imports.add(`import { ${specVarName} } from './${spec.meta.name.split('.')[0]}';`);\n    registrations.push(`  .register(${specVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated operations registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { OperationSpecRegistry } from '@lssm/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const operationsRegistry = new OperationSpecRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'operations-registry.ts',\n  };\n}\n"],"mappings":"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"}

package/dist/openapi/exporter/presentations.d.ts

@@ -0,0 +1,48 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { PresentationDescriptorV2, PresentationRegistry } from "@lssm/lib.contracts";
+
+//#region src/openapi/exporter/presentations.d.ts
+
+/**
+ * Exported presentation structure for OpenAPI extensions.
+ */
+interface ExportedPresentation {
+  name: string;
+  version: number;
+  description?: string;
+  stability?: string;
+  kind: 'web_component' | 'markdown' | 'data';
+  tags?: string[];
+}
+/**
+ * Export presentations (V1) to OpenAPI extension format.
+ */
+declare function exportPresentationsV1(registry: PresentationRegistry): ExportedPresentation[];
+/**
+ * Exported V2 presentation structure for OpenAPI extensions.
+ */
+interface ExportedPresentationV2 {
+  name: string;
+  version: number;
+  description?: string;
+  targets: string[];
+  sourceType: string;
+}
+/**
+ * Export presentations (V2) to OpenAPI extension format.
+ */
+declare function exportPresentationsV2(descriptors: PresentationDescriptorV2[]): ExportedPresentationV2[];
+/**
+ * Combined presentations export.
+ */
+declare function exportPresentations(registry: PresentationRegistry, v2Descriptors?: PresentationDescriptorV2[]): {
+  v1: ExportedPresentation[];
+  v2: ExportedPresentationV2[];
+};
+/**
+ * Generate TypeScript code for presentations registry.
+ */
+declare function generatePresentationsRegistry(registry: PresentationRegistry): GeneratedRegistryCode;
+//#endregion
+export { ExportedPresentation, ExportedPresentationV2, exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry };
+//# sourceMappingURL=presentations.d.ts.map

package/dist/openapi/exporter/presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.d.ts","names":[],"sources":["../../../src/openapi/exporter/presentations.ts"],"sourcesContent":[],"mappings":";;;;;AAyBA;AAgBA;AAWA;AAegB,UAtDC,oBAAA,CAsDkB;EACvB,IAAA,EAAA,MAAA;EACM,OAAA,EAAA,MAAA;EAEZ,WAAA,CAAA,EAAA,MAAA;EACA,SAAA,CAAA,EAAA,MAAA;EAAsB,IAAA,EAAA,eAAA,GAAA,UAAA,GAAA,MAAA;EAWZ,IAAA,CAAA,EAAA,MAAA,EAAA;;;;;iBA1DA,qBAAA,WACJ,uBACT;;;;UAcc,sBAAA;;;;;;;;;;iBAWD,qBAAA,cACD,6BACZ;;;;iBAaa,mBAAA,WACJ,sCACM;MAEZ;MACA;;;;;iBAWU,6BAAA,WACJ,uBACT"}

package/dist/openapi/exporter/presentations.js

@@ -0,0 +1,66 @@
+//#region src/openapi/exporter/presentations.ts
+/**
+* Export presentations (V1) to OpenAPI extension format.
+*/
+function exportPresentationsV1(registry) {
+	return registry.list().map((pres) => ({
+		name: pres.meta.name,
+		version: pres.meta.version,
+		description: pres.meta.description,
+		stability: pres.meta.stability,
+		kind: pres.content.kind,
+		tags: pres.meta.tags
+	}));
+}
+/**
+* Export presentations (V2) to OpenAPI extension format.
+*/
+function exportPresentationsV2(descriptors) {
+	return descriptors.map((desc) => ({
+		name: desc.meta.name,
+		version: desc.meta.version,
+		description: desc.meta.description,
+		targets: desc.targets,
+		sourceType: desc.source.type
+	}));
+}
+/**
+* Combined presentations export.
+*/
+function exportPresentations(registry, v2Descriptors) {
+	return {
+		v1: exportPresentationsV1(registry),
+		v2: v2Descriptors ? exportPresentationsV2(v2Descriptors) : []
+	};
+}
+/**
+* Generate TypeScript code for presentations registry.
+*/
+function generatePresentationsRegistry(registry) {
+	const presentations = registry.list();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const pres of presentations) {
+		const presVarName = pres.meta.name.replace(/\./g, "_") + `_v${pres.meta.version}`;
+		imports.add(`import { ${presVarName} } from './${pres.meta.name.split(".")[0]}';`);
+		registrations.push(`  .register(${presVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated presentations registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { PresentationRegistry } from '@lssm/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const presentationsRegistry = new PresentationRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "presentations-registry.ts"
+	};
+}
+
+//#endregion
+export { exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry };
+//# sourceMappingURL=presentations.js.map

package/dist/openapi/exporter/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":["registrations: string[]"],"sources":["../../../src/openapi/exporter/presentations.ts"],"sourcesContent":["/**\n * Presentations exporter - exports PresentationSpec to OpenAPI extensions.\n */\nimport type {\n  PresentationRegistry,\n  PresentationSpec,\n  PresentationDescriptorV2,\n} from '@lssm/lib.contracts';\nimport type { GeneratedRegistryCode } from '../types';\n\n/**\n * Exported presentation structure for OpenAPI extensions.\n */\nexport interface ExportedPresentation {\n  name: string;\n  version: number;\n  description?: string;\n  stability?: string;\n  kind: 'web_component' | 'markdown' | 'data';\n  tags?: string[];\n}\n\n/**\n * Export presentations (V1) to OpenAPI extension format.\n */\nexport function exportPresentationsV1(\n  registry: PresentationRegistry\n): ExportedPresentation[] {\n  return registry.list().map((pres) => ({\n    name: pres.meta.name,\n    version: pres.meta.version,\n    description: pres.meta.description,\n    stability: pres.meta.stability,\n    kind: pres.content.kind,\n    tags: pres.meta.tags,\n  }));\n}\n\n/**\n * Exported V2 presentation structure for OpenAPI extensions.\n */\nexport interface ExportedPresentationV2 {\n  name: string;\n  version: number;\n  description?: string;\n  targets: string[];\n  sourceType: string;\n}\n\n/**\n * Export presentations (V2) to OpenAPI extension format.\n */\nexport function exportPresentationsV2(\n  descriptors: PresentationDescriptorV2[]\n): ExportedPresentationV2[] {\n  return descriptors.map((desc) => ({\n    name: desc.meta.name,\n    version: desc.meta.version,\n    description: desc.meta.description,\n    targets: desc.targets,\n    sourceType: desc.source.type,\n  }));\n}\n\n/**\n * Combined presentations export.\n */\nexport function exportPresentations(\n  registry: PresentationRegistry,\n  v2Descriptors?: PresentationDescriptorV2[]\n): {\n  v1: ExportedPresentation[];\n  v2: ExportedPresentationV2[];\n} {\n  return {\n    v1: exportPresentationsV1(registry),\n    v2: v2Descriptors ? exportPresentationsV2(v2Descriptors) : [],\n  };\n}\n\n/**\n * Generate TypeScript code for presentations registry.\n */\nexport function generatePresentationsRegistry(\n  registry: PresentationRegistry\n): GeneratedRegistryCode {\n  const presentations = registry.list();\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const pres of presentations) {\n    const presVarName =\n      pres.meta.name.replace(/\\./g, '_') + `_v${pres.meta.version}`;\n    imports.add(\n      `import { ${presVarName} } from './${pres.meta.name.split('.')[0]}';`\n    );\n    registrations.push(`  .register(${presVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated presentations registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { PresentationRegistry } from '@lssm/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const presentationsRegistry = new PresentationRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'presentations-registry.ts',\n  };\n}\n"],"mappings":";;;;AAyBA,SAAgB,sBACd,UACwB;AACxB,QAAO,SAAS,MAAM,CAAC,KAAK,UAAU;EACpC,MAAM,KAAK,KAAK;EAChB,SAAS,KAAK,KAAK;EACnB,aAAa,KAAK,KAAK;EACvB,WAAW,KAAK,KAAK;EACrB,MAAM,KAAK,QAAQ;EACnB,MAAM,KAAK,KAAK;EACjB,EAAE;;;;;AAiBL,SAAgB,sBACd,aAC0B;AAC1B,QAAO,YAAY,KAAK,UAAU;EAChC,MAAM,KAAK,KAAK;EAChB,SAAS,KAAK,KAAK;EACnB,aAAa,KAAK,KAAK;EACvB,SAAS,KAAK;EACd,YAAY,KAAK,OAAO;EACzB,EAAE;;;;;AAML,SAAgB,oBACd,UACA,eAIA;AACA,QAAO;EACL,IAAI,sBAAsB,SAAS;EACnC,IAAI,gBAAgB,sBAAsB,cAAc,GAAG,EAAE;EAC9D;;;;;AAMH,SAAgB,8BACd,UACuB;CACvB,MAAM,gBAAgB,SAAS,MAAM;CACrC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAMA,gBAA0B,EAAE;AAElC,MAAK,MAAM,QAAQ,eAAe;EAChC,MAAM,cACJ,KAAK,KAAK,KAAK,QAAQ,OAAO,IAAI,GAAG,KAAK,KAAK,KAAK;AACtD,UAAQ,IACN,YAAY,YAAY,aAAa,KAAK,KAAK,KAAK,MAAM,IAAI,CAAC,GAAG,IACnE;AACD,gBAAc,KAAK,eAAe,YAAY,GAAG;;AAenD,QAAO;EACL,MAbW;;;;;;EAMb,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAAC;;;EAG/B,cAAc,KAAK,KAAK,CAAC;;EAKvB,UAAU;EACX"}

package/dist/openapi/exporter/registries.d.ts

@@ -0,0 +1,23 @@
+import { GeneratedRegistryCode } from "../types.js";
+
+//#region src/openapi/exporter/registries.d.ts
+
+/**
+ * Registry generation options.
+ */
+interface RegistryGenerationOptions {
+  operations?: boolean;
+  events?: boolean;
+  features?: boolean;
+  presentations?: boolean;
+  forms?: boolean;
+  dataViews?: boolean;
+  workflows?: boolean;
+}
+/**
+ * Generate unified index file that exports all registries.
+ */
+declare function generateRegistryIndex(options?: RegistryGenerationOptions): GeneratedRegistryCode;
+//#endregion
+export { RegistryGenerationOptions, generateRegistryIndex };
+//# sourceMappingURL=registries.d.ts.map

package/dist/openapi/exporter/registries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.d.ts","names":[],"sources":["../../../src/openapi/exporter/registries.ts"],"sourcesContent":[],"mappings":";;;;AAqBA;;;UAbiB,yBAAA;;;;;;;;;;;;iBAaD,qBAAA,WACL,4BACR"}

package/dist/openapi/exporter/registries.js

@@ -0,0 +1,29 @@
+//#region src/openapi/exporter/registries.ts
+/**
+* Generate unified index file that exports all registries.
+*/
+function generateRegistryIndex(options = {}) {
+	const { operations = true, events = true, features = true, presentations = true, forms = true, dataViews = true, workflows = true } = options;
+	const exports = [];
+	if (operations) exports.push("export * from './operations-registry';");
+	if (events) exports.push("export * from './events-exports';");
+	if (features) exports.push("export * from './features-registry';");
+	if (presentations) exports.push("export * from './presentations-registry';");
+	if (forms) exports.push("export * from './forms-registry';");
+	if (dataViews) exports.push("export * from './dataviews-registry';");
+	if (workflows) exports.push("export * from './workflows-registry';");
+	return {
+		code: `/**
+ * Auto-generated registry index.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+
+${exports.join("\n")}
+`,
+		fileName: "index.ts"
+	};
+}
+
+//#endregion
+export { generateRegistryIndex };
+//# sourceMappingURL=registries.js.map

package/dist/openapi/exporter/registries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.js","names":["exports: string[]"],"sources":["../../../src/openapi/exporter/registries.ts"],"sourcesContent":["/**\n * Unified registries generator - combines all surface registries.\n */\nimport type { GeneratedRegistryCode } from '../types';\n\n/**\n * Registry generation options.\n */\nexport interface RegistryGenerationOptions {\n  operations?: boolean;\n  events?: boolean;\n  features?: boolean;\n  presentations?: boolean;\n  forms?: boolean;\n  dataViews?: boolean;\n  workflows?: boolean;\n}\n\n/**\n * Generate unified index file that exports all registries.\n */\nexport function generateRegistryIndex(\n  options: RegistryGenerationOptions = {}\n): GeneratedRegistryCode {\n  const {\n    operations = true,\n    events = true,\n    features = true,\n    presentations = true,\n    forms = true,\n    dataViews = true,\n    workflows = true,\n  } = options;\n\n  const exports: string[] = [];\n\n  if (operations) {\n    exports.push(\"export * from './operations-registry';\");\n  }\n  if (events) {\n    exports.push(\"export * from './events-exports';\");\n  }\n  if (features) {\n    exports.push(\"export * from './features-registry';\");\n  }\n  if (presentations) {\n    exports.push(\"export * from './presentations-registry';\");\n  }\n  if (forms) {\n    exports.push(\"export * from './forms-registry';\");\n  }\n  if (dataViews) {\n    exports.push(\"export * from './dataviews-registry';\");\n  }\n  if (workflows) {\n    exports.push(\"export * from './workflows-registry';\");\n  }\n\n  const code = `/**\n * Auto-generated registry index.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\n\n${exports.join('\\n')}\n`;\n\n  return {\n    code,\n    fileName: 'index.ts',\n  };\n}\n"],"mappings":";;;;AAqBA,SAAgB,sBACd,UAAqC,EAAE,EAChB;CACvB,MAAM,EACJ,aAAa,MACb,SAAS,MACT,WAAW,MACX,gBAAgB,MAChB,QAAQ,MACR,YAAY,MACZ,YAAY,SACV;CAEJ,MAAMA,UAAoB,EAAE;AAE5B,KAAI,WACF,SAAQ,KAAK,yCAAyC;AAExD,KAAI,OACF,SAAQ,KAAK,oCAAoC;AAEnD,KAAI,SACF,SAAQ,KAAK,uCAAuC;AAEtD,KAAI,cACF,SAAQ,KAAK,4CAA4C;AAE3D,KAAI,MACF,SAAQ,KAAK,oCAAoC;AAEnD,KAAI,UACF,SAAQ,KAAK,wCAAwC;AAEvD,KAAI,UACF,SAAQ,KAAK,wCAAwC;AAWvD,QAAO;EACL,MATW;;;;;EAKb,QAAQ,KAAK,KAAK,CAAC;;EAKjB,UAAU;EACX"}

package/dist/openapi/exporter/workflows.d.ts

@@ -0,0 +1,36 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { WorkflowRegistry } from "@lssm/lib.contracts";
+
+//#region src/openapi/exporter/workflows.d.ts
+
+/**
+ * Exported workflow structure for OpenAPI extensions.
+ */
+interface ExportedWorkflow {
+  name: string;
+  version: number;
+  description?: string;
+  stability?: string;
+  owners?: string[];
+  steps: {
+    id: string;
+    type: 'human' | 'automation' | 'decision';
+    label: string;
+  }[];
+  transitions: {
+    from: string;
+    to: string;
+    label?: string;
+  }[];
+}
+/**
+ * Export workflows to OpenAPI extension format.
+ */
+declare function exportWorkflows(registry: WorkflowRegistry): ExportedWorkflow[];
+/**
+ * Generate TypeScript code for workflows registry.
+ */
+declare function generateWorkflowsRegistry(registry: WorkflowRegistry): GeneratedRegistryCode;
+//#endregion
+export { ExportedWorkflow, exportWorkflows, generateWorkflowsRegistry };
+//# sourceMappingURL=workflows.d.ts.map

package/dist/openapi/exporter/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","names":[],"sources":["../../../src/openapi/exporter/workflows.ts"],"sourcesContent":[],"mappings":";;;;;AA8BA;AAyBA;;UA9CiB,gBAAA;;;;;;;;;;;;;;;;;;;;iBAqBD,eAAA,WACJ,mBACT;;;;iBAuBa,yBAAA,WACJ,mBACT"}

package/dist/openapi/exporter/workflows.js

@@ -0,0 +1,54 @@
+//#region src/openapi/exporter/workflows.ts
+/**
+* Export workflows to OpenAPI extension format.
+*/
+function exportWorkflows(registry) {
+	return registry.list().map((wf) => ({
+		name: wf.meta.name,
+		version: wf.meta.version,
+		description: wf.meta.description,
+		stability: wf.meta.stability,
+		owners: wf.meta.owners,
+		steps: wf.definition.steps.map((s) => ({
+			id: s.id,
+			type: s.type,
+			label: s.label
+		})),
+		transitions: wf.definition.transitions.map((t) => ({
+			from: t.from,
+			to: t.to,
+			label: t.label
+		}))
+	}));
+}
+/**
+* Generate TypeScript code for workflows registry.
+*/
+function generateWorkflowsRegistry(registry) {
+	const workflows = registry.list();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const wf of workflows) {
+		const wfVarName = wf.meta.name.replace(/\./g, "_") + `_v${wf.meta.version}`;
+		imports.add(`import { ${wfVarName} } from './${wf.meta.name.split(".")[0]}';`);
+		registrations.push(`  .register(${wfVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated workflows registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { WorkflowRegistry } from '@lssm/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const workflowsRegistry = new WorkflowRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "workflows-registry.ts"
+	};
+}
+
+//#endregion
+export { exportWorkflows, generateWorkflowsRegistry };
+//# sourceMappingURL=workflows.js.map

package/dist/openapi/exporter/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","names":["registrations: string[]"],"sources":["../../../src/openapi/exporter/workflows.ts"],"sourcesContent":["/**\n * Workflows exporter - exports WorkflowSpec to OpenAPI extensions.\n */\nimport type { WorkflowRegistry, WorkflowSpec } from '@lssm/lib.contracts';\nimport type { GeneratedRegistryCode } from '../types';\n\n/**\n * Exported workflow structure for OpenAPI extensions.\n */\nexport interface ExportedWorkflow {\n  name: string;\n  version: number;\n  description?: string;\n  stability?: string;\n  owners?: string[];\n  steps: {\n    id: string;\n    type: 'human' | 'automation' | 'decision';\n    label: string;\n  }[];\n  transitions: {\n    from: string;\n    to: string;\n    label?: string;\n  }[];\n}\n\n/**\n * Export workflows to OpenAPI extension format.\n */\nexport function exportWorkflows(\n  registry: WorkflowRegistry\n): ExportedWorkflow[] {\n  return registry.list().map((wf) => ({\n    name: wf.meta.name,\n    version: wf.meta.version,\n    description: wf.meta.description,\n    stability: wf.meta.stability,\n    owners: wf.meta.owners,\n    steps: wf.definition.steps.map((s) => ({\n      id: s.id,\n      type: s.type,\n      label: s.label,\n    })),\n    transitions: wf.definition.transitions.map((t) => ({\n      from: t.from,\n      to: t.to,\n      label: t.label,\n    })),\n  }));\n}\n\n/**\n * Generate TypeScript code for workflows registry.\n */\nexport function generateWorkflowsRegistry(\n  registry: WorkflowRegistry\n): GeneratedRegistryCode {\n  const workflows = registry.list();\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const wf of workflows) {\n    const wfVarName = wf.meta.name.replace(/\\./g, '_') + `_v${wf.meta.version}`;\n    imports.add(\n      `import { ${wfVarName} } from './${wf.meta.name.split('.')[0]}';`\n    );\n    registrations.push(`  .register(${wfVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated workflows registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { WorkflowRegistry } from '@lssm/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const workflowsRegistry = new WorkflowRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'workflows-registry.ts',\n  };\n}\n"],"mappings":";;;;AA8BA,SAAgB,gBACd,UACoB;AACpB,QAAO,SAAS,MAAM,CAAC,KAAK,QAAQ;EAClC,MAAM,GAAG,KAAK;EACd,SAAS,GAAG,KAAK;EACjB,aAAa,GAAG,KAAK;EACrB,WAAW,GAAG,KAAK;EACnB,QAAQ,GAAG,KAAK;EAChB,OAAO,GAAG,WAAW,MAAM,KAAK,OAAO;GACrC,IAAI,EAAE;GACN,MAAM,EAAE;GACR,OAAO,EAAE;GACV,EAAE;EACH,aAAa,GAAG,WAAW,YAAY,KAAK,OAAO;GACjD,MAAM,EAAE;GACR,IAAI,EAAE;GACN,OAAO,EAAE;GACV,EAAE;EACJ,EAAE;;;;;AAML,SAAgB,0BACd,UACuB;CACvB,MAAM,YAAY,SAAS,MAAM;CACjC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAMA,gBAA0B,EAAE;AAElC,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,YAAY,GAAG,KAAK,KAAK,QAAQ,OAAO,IAAI,GAAG,KAAK,GAAG,KAAK;AAClE,UAAQ,IACN,YAAY,UAAU,aAAa,GAAG,KAAK,KAAK,MAAM,IAAI,CAAC,GAAG,IAC/D;AACD,gBAAc,KAAK,eAAe,UAAU,GAAG;;AAejD,QAAO;EACL,MAbW;;;;;;EAMb,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAAC;;;EAG/B,cAAc,KAAK,KAAK,CAAC;;EAKvB,UAAU;EACX"}

package/dist/openapi/exporter.d.ts

@@ -1,20 +1,32 @@
-import { ContractSpecOpenApiDocument, OpenApiExportOptions, OpenApiServer } from "./types.js";
-import { OperationSpecRegistry } from "@lssm/lib.contracts";
+import { ContractSpecExportOptions, ContractSpecExportResult, ContractSpecOpenApiDocument, OpenApiExportOptions, OpenApiServer } from "./types.js";
+import { defaultRestPath } from "./exporter/operations.js";
+import { DataViewRegistry, EventSpec, FeatureRegistry, FormRegistry, OperationSpecRegistry, PresentationDescriptorV2, PresentationRegistry, WorkflowRegistry } from "@lssm/lib.contracts";
+import { AnySchemaModel } from "@lssm/lib.schema";
 
 //#region src/openapi/exporter.d.ts
 
 /**
- * Generate default REST path from spec name and version.
+ * Input registries for unified export.
  */
-declare function defaultRestPath(name: string, version: number): string;
+interface ContractSpecRegistries {
+  operations?: OperationSpecRegistry;
+  events?: EventSpec<AnySchemaModel>[];
+  features?: FeatureRegistry;
+  presentations?: PresentationRegistry;
+  presentationsV2?: PresentationDescriptorV2[];
+  forms?: FormRegistry;
+  dataViews?: DataViewRegistry;
+  workflows?: WorkflowRegistry;
+}
 /**
  * Export a OperationSpecRegistry to an OpenAPI 3.1 document.
- *
- * @param registry - The OperationSpecRegistry containing specs to export
- * @param options - Export options (title, version, description, servers)
- * @returns OpenAPI 3.1 document
+ * @deprecated Use exportContractSpec for full surface support.
  */
 declare function openApiForRegistry(registry: OperationSpecRegistry, options?: OpenApiExportOptions): ContractSpecOpenApiDocument;
+/**
+ * Export all ContractSpec surfaces to OpenAPI document with extensions.
+ */
+declare function exportContractSpec(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): ContractSpecExportResult;
 /**
  * Export a OperationSpecRegistry to OpenAPI JSON string.
  */
@@ -23,6 +35,14 @@ declare function openApiToJson(registry: OperationSpecRegistry, options?: OpenAp
  * Export a OperationSpecRegistry to OpenAPI YAML string.
  */
 declare function openApiToYaml(registry: OperationSpecRegistry, options?: OpenApiExportOptions): string;
+/**
+ * Export ContractSpec to JSON string (all surfaces).
+ */
+declare function contractSpecToJson(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): string;
+/**
+ * Export ContractSpec to YAML string (all surfaces).
+ */
+declare function contractSpecToYaml(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): string;
 //#endregion
-export { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml };
+export { ContractSpecRegistries, contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml };
 //# sourceMappingURL=exporter.d.ts.map

package/dist/openapi/exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","names":[],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAqH8B,iBAjEd,eAAA,CAiEc,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA+F9B;AAWA;;;;;;iBA7GgB,kBAAA,WACJ,iCACD,uBACR;;;;iBA+Fa,aAAA,WACJ,iCACD;;;;iBASK,aAAA,WACJ,iCACD"}
+{"version":3,"file":"exporter.d.ts","names":[],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAmDkB,UAJD,sBAAA,CAIC;EACE,UAAA,CAAA,EAJL,qBAIK;EACV,MAAA,CAAA,EAJC,SAID,CAJW,cAIX,CAAA,EAAA;EACI,QAAA,CAAA,EAJD,eAIC;EACA,aAAA,CAAA,EAJI,oBAIJ;EAAgB,eAAA,CAAA,EAHV,wBAGU,EAAA;EAUd,KAAA,CAAA,EAZN,YAYM;EACJ,SAAA,CAAA,EAZE,gBAYF;EACD,SAAA,CAAA,EAZG,gBAYH;;AAoBX;;;;AAG2B,iBAzBX,kBAAA,CAyBW,QAAA,EAxBf,qBAwBe,EAAA,OAAA,CAAA,EAvBhB,oBAuBgB,CAAA,EAtBxB,2BAsBwB;AAiI3B;AAWA;AAWA;AAWgB,iBArKA,kBAAA,CAsKF,UAAA,EArKA,sBAsKH,EAAA,OAA8B,CAAA,EArK9B,yBAqK8B,CAAA,EApKtC,wBAoKsC;;;;iBAnCzB,aAAA,WACJ,iCACD;;;;iBASK,aAAA,WACJ,iCACD;;;;iBASK,kBAAA,aACF,kCACH;;;;iBASK,kBAAA,aACF,kCACH"}