@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/libs/contracts-transformers/dist/openapi/parser.js

@@ -1 +1,231 @@
-import{parse as e}from"yaml";const t=[`get`,`post`,`put`,`delete`,`patch`,`head`,`options`,`trace`];function n(t,n=`json`){return n===`yaml`?e(t):JSON.parse(t)}function r(e){let t=e.trim();return t.startsWith(`{`)||t.startsWith(`[`)?`json`:`yaml`}function i(e){return e.openapi.startsWith(`3.1`)?`3.1`:`3.0`}function a(e){return typeof e==`object`&&!!e&&`$ref`in e}function o(e,t){if(!t.startsWith(`#/`))return;let n=t.slice(2).split(`/`),r=e;for(let e of n){if(typeof r!=`object`||!r)return;r=r[e]}return r}function s(e,t){if(t)return a(t)?o(e,t.$ref)??t:t}function c(e,t){let n={path:[],query:[],header:[],cookie:[]};if(!t)return n;for(let r of t){let t;if(a(r)){let n=o(e,r.$ref);if(!n)continue;t=n}else t=r;let i={name:t.name,in:t.in,required:t.required??t.in===`path`,description:t.description,schema:t.schema,deprecated:t.deprecated??!1};n[t.in]?.push(i)}return n}function l(e,t){return e+t.split(`/`).filter(Boolean).map(e=>e.startsWith(`{`)&&e.endsWith(`}`)?`By`+e.slice(1,-1).charAt(0).toUpperCase()+e.slice(2,-1):e.charAt(0).toUpperCase()+e.slice(1)).join(``)}function u(e,t,n,r,i){let u=c(e,[...i??[],...r.parameters??[]]),d;if(r.requestBody){let t=a(r.requestBody)?o(e,r.requestBody.$ref):r.requestBody;if(t){let n=Object.keys(t.content??{})[0]??`application/json`,r=t.content?.[n];r?.schema&&(d={required:t.required??!1,schema:s(e,r.schema),contentType:n})}}let f={};for(let[t,n]of Object.entries(r.responses??{})){let r=a(n)?o(e,n.$ref):n;if(r){let n=Object.keys(r.content??{})[0],i=n?r.content?.[n]:void 0;f[t]={description:r.description,schema:i?.schema?s(e,i.schema):void 0,contentType:n}}}let p=r?.[`x-contractspec`];return{operationId:r.operationId??l(t,n),method:t,path:n,summary:r.summary,description:r.description,tags:r.tags??[],pathParams:u.path,queryParams:u.query,headerParams:u.header,cookieParams:u.cookie,requestBody:d,responses:f,deprecated:r.deprecated??!1,security:r.security,contractSpecMeta:p}}function d(e,n={}){let r=i(e),a=[],o=[];for(let[n,r]of Object.entries(e.paths??{})){if(!r)continue;let i=r.parameters;for(let s of t){let t=r[s];if(t)try{o.push(u(e,s,n,t,i))}catch(e){a.push(`Failed to parse ${s.toUpperCase()} ${n}: ${e}`)}}}let s={},c=e.components;if(c?.schemas)for(let[e,t]of Object.entries(c.schemas))s[e]=t;let l=(e.servers??[]).map(e=>({url:e.url,description:e.description,variables:e.variables}));return{document:e,version:r,info:{title:e.info.title,version:e.info.version,description:e.info.description},operations:o,schemas:s,servers:l,warnings:a}}async function f(e,t={}){let{fetch:i=globalThis.fetch,readFile:a,timeout:o=3e4}=t,s,c;if(e.startsWith(`http://`)||e.startsWith(`https://`)){let t=new AbortController,n=setTimeout(()=>t.abort(),o);try{let n=await i(e,{signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);s=await n.text()}finally{clearTimeout(n)}c=e.endsWith(`.yaml`)||e.endsWith(`.yml`)?`yaml`:e.endsWith(`.json`)?`json`:r(s)}else{if(!a)throw Error(`readFile adapter required for file paths`);s=await a(e),c=e.endsWith(`.yaml`)||e.endsWith(`.yml`)?`yaml`:e.endsWith(`.json`)?`json`:r(s)}return d(n(s,c),t)}export{d,f,i,n,r};
+import { parse } from "yaml";
+
+//#region ../../libs/contracts-transformers/dist/openapi/parser.js
+/**
+* OpenAPI document parser.
+* Parses OpenAPI 3.x documents from JSON/YAML files or URLs.
+*/
+const HTTP_METHODS = [
+	"get",
+	"post",
+	"put",
+	"delete",
+	"patch",
+	"head",
+	"options",
+	"trace"
+];
+/**
+* Parse an OpenAPI document from a string (JSON or YAML).
+*/
+function parseOpenApiString(content, format = "json") {
+	if (format === "yaml") return parse(content);
+	return JSON.parse(content);
+}
+/**
+* Detect the format of content (JSON or YAML).
+*/
+function detectFormat(content) {
+	const trimmed = content.trim();
+	if (trimmed.startsWith("{") || trimmed.startsWith("[")) return "json";
+	return "yaml";
+}
+/**
+* Detect OpenAPI version from document.
+*/
+function detectVersion(doc) {
+	if (doc.openapi.startsWith("3.1")) return "3.1";
+	return "3.0";
+}
+/**
+* Check if a value is a reference object.
+*/
+function isReference(obj) {
+	return typeof obj === "object" && obj !== null && "$ref" in obj;
+}
+/**
+* Resolve a $ref reference in the document.
+*/
+function resolveRef(doc, ref) {
+	if (!ref.startsWith("#/")) return;
+	const path = ref.slice(2).split("/");
+	let current = doc;
+	for (const part of path) {
+		if (current === null || current === void 0) return void 0;
+		if (typeof current !== "object") return void 0;
+		current = current[part];
+	}
+	return current;
+}
+/**
+* Resolve a schema, following $ref if needed.
+*/
+function resolveSchema(doc, schema) {
+	if (!schema) return void 0;
+	if (isReference(schema)) return resolveRef(doc, schema.$ref) ?? schema;
+	return schema;
+}
+/**
+* Parse parameters from an operation.
+*/
+function parseParameters(doc, params) {
+	const result = {
+		path: [],
+		query: [],
+		header: [],
+		cookie: []
+	};
+	if (!params) return result;
+	for (const param of params) {
+		let resolved;
+		if (isReference(param)) {
+			const ref = resolveRef(doc, param.$ref);
+			if (!ref) continue;
+			resolved = ref;
+		} else resolved = param;
+		const parsed = {
+			name: resolved.name,
+			in: resolved.in,
+			required: resolved.required ?? resolved.in === "path",
+			description: resolved.description,
+			schema: resolved.schema,
+			deprecated: resolved.deprecated ?? false
+		};
+		result[resolved.in]?.push(parsed);
+	}
+	return result;
+}
+/**
+* Generate an operationId if not present.
+*/
+function generateOperationId(method, path) {
+	return method + path.split("/").filter(Boolean).map((part) => {
+		if (part.startsWith("{") && part.endsWith("}")) return "By" + part.slice(1, -1).charAt(0).toUpperCase() + part.slice(2, -1);
+		return part.charAt(0).toUpperCase() + part.slice(1);
+	}).join("");
+}
+/**
+* Parse a single operation.
+*/
+function parseOperation(doc, method, path, operation, pathParams) {
+	const params = parseParameters(doc, [...pathParams ?? [], ...operation.parameters ?? []]);
+	let requestBody;
+	if (operation.requestBody) {
+		const body = isReference(operation.requestBody) ? resolveRef(doc, operation.requestBody.$ref) : operation.requestBody;
+		if (body) {
+			const contentType = Object.keys(body.content ?? {})[0] ?? "application/json";
+			const content = body.content?.[contentType];
+			if (content?.schema) requestBody = {
+				required: body.required ?? false,
+				schema: resolveSchema(doc, content.schema),
+				contentType
+			};
+		}
+	}
+	const responses = {};
+	for (const [status, response] of Object.entries(operation.responses ?? {})) {
+		const resolved = isReference(response) ? resolveRef(doc, response.$ref) : response;
+		if (resolved) {
+			const contentType = Object.keys(resolved.content ?? {})[0];
+			const content = contentType ? resolved.content?.[contentType] : void 0;
+			responses[status] = {
+				description: resolved.description,
+				schema: content?.schema ? resolveSchema(doc, content.schema) : void 0,
+				contentType
+			};
+		}
+	}
+	const contractSpecMeta = operation?.["x-contractspec"];
+	return {
+		operationId: operation.operationId ?? generateOperationId(method, path),
+		method,
+		path,
+		summary: operation.summary,
+		description: operation.description,
+		tags: operation.tags ?? [],
+		pathParams: params.path,
+		queryParams: params.query,
+		headerParams: params.header,
+		cookieParams: params.cookie,
+		requestBody,
+		responses,
+		deprecated: operation.deprecated ?? false,
+		security: operation.security,
+		contractSpecMeta
+	};
+}
+/**
+* Parse an OpenAPI document into a structured result.
+*/
+function parseOpenApiDocument(doc, _options = {}) {
+	const version = detectVersion(doc);
+	const warnings = [];
+	const operations = [];
+	for (const [path, pathItem] of Object.entries(doc.paths ?? {})) {
+		if (!pathItem) continue;
+		const pathParams = pathItem.parameters;
+		for (const method of HTTP_METHODS) {
+			const operation = pathItem[method];
+			if (operation) try {
+				operations.push(parseOperation(doc, method, path, operation, pathParams));
+			} catch (error) {
+				warnings.push(`Failed to parse ${method.toUpperCase()} ${path}: ${error}`);
+			}
+		}
+	}
+	const schemas = {};
+	const components = doc.components;
+	if (components?.schemas) for (const [name, schema] of Object.entries(components.schemas)) schemas[name] = schema;
+	const servers = (doc.servers ?? []).map((s) => ({
+		url: s.url,
+		description: s.description,
+		variables: s.variables
+	}));
+	return {
+		document: doc,
+		version,
+		info: {
+			title: doc.info.title,
+			version: doc.info.version,
+			description: doc.info.description
+		},
+		operations,
+		schemas,
+		servers,
+		warnings
+	};
+}
+/**
+* Parse OpenAPI from a file path or URL.
+* Note: This is an async function that requires I/O adapters.
+* For pure parsing, use parseOpenApiString or parseOpenApiDocument.
+*/
+async function parseOpenApi(source, options = {}) {
+	const { fetch: fetchFn = globalThis.fetch, readFile, timeout = 3e4 } = options;
+	let content;
+	let format;
+	if (source.startsWith("http://") || source.startsWith("https://")) {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const response = await fetchFn(source, { signal: controller.signal });
+			if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+			content = await response.text();
+		} finally {
+			clearTimeout(timeoutId);
+		}
+		if (source.endsWith(".yaml") || source.endsWith(".yml")) format = "yaml";
+		else if (source.endsWith(".json")) format = "json";
+		else format = detectFormat(content);
+	} else {
+		if (!readFile) throw new Error("readFile adapter required for file paths");
+		content = await readFile(source);
+		if (source.endsWith(".yaml") || source.endsWith(".yml")) format = "yaml";
+		else if (source.endsWith(".json")) format = "json";
+		else format = detectFormat(content);
+	}
+	return parseOpenApiDocument(parseOpenApiString(content, format), options);
+}
+
+//#endregion
+export { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString };

package/dist/libs/contracts-transformers/dist/openapi/schema-converter.js

@@ -1,4 +1,201 @@
-import{e,i as t,t as n}from"../common/utils.js";const r={string:`ScalarTypeEnum.STRING`,integer:`ScalarTypeEnum.INT`,number:`ScalarTypeEnum.FLOAT`,boolean:`ScalarTypeEnum.BOOLEAN`,"string:date":`ScalarTypeEnum.DATE`,"string:date-time":`ScalarTypeEnum.DATE_TIME`,"string:email":`ScalarTypeEnum.EMAIL`,"string:uri":`ScalarTypeEnum.URL`,"string:uuid":`ScalarTypeEnum.ID`};function i(e){return`$ref`in e}function a(e){let t=e.split(`/`);return t[t.length-1]??`Unknown`}function o(t,n){if(i(t))return{type:e(a(t.$ref)),optional:!1,array:!1,primitive:!1};let r=t,s=r.type,c=r.format,l=r.nullable;if(s===`array`){let e=r.items;return e?{...o(e,n),array:!0,optional:l??!1}:{type:`unknown`,optional:l??!1,array:!0,primitive:!1}}return s===`object`||r.properties?{type:n?e(n):`Record<string, unknown>`,optional:l??!1,array:!1,primitive:!1}:r.enum?{type:n?e(n):`string`,optional:l??!1,array:!1,primitive:!1}:(c&&`${s}${c}`,s===`string`?{type:`string`,optional:l??!1,array:!1,primitive:!0}:s===`integer`||s===`number`?{type:`number`,optional:l??!1,array:!1,primitive:!0}:s===`boolean`?{type:`boolean`,optional:l??!1,array:!1,primitive:!0}:{type:`unknown`,optional:l??!1,array:!1,primitive:!1})}function s(e){if(i(e))return;let t=e,n=t.type,a=t.format;if(n)return r[a?`${n}:${a}`:n]??r[n]}function c(e,r,a){let c=o(e,r),l=s(e),u;if(!i(e)){let t=e.enum;t&&(u=t.map(String))}return{name:t(n(r)),type:{...c,optional:!a||c.optional,description:i(e)?void 0:e.description},scalarType:l,enumValues:u}}function l(n,r,o=0){let s=`  `.repeat(o),l=[],d;if(i(n))return{name:e(a(n.$ref)),fields:[],code:`// Reference to ${n.$ref}`};let f=n;d=f.description;let p=f.properties,m=f.required??[];if(!p)return{name:e(r),description:d,fields:[],code:`${s}// Empty schema for ${r}`};for(let[e,t]of Object.entries(p)){let n=m.includes(e);l.push(c(t,e,n))}let h=[],g=e(t(r));h.push(`${s}export const ${g} = defineSchemaModel({`),h.push(`${s}  name: '${g}',`),d&&h.push(`${s}  description: ${JSON.stringify(d)},`),h.push(`${s}  fields: {`);for(let e of l){let t=u(e,o+2);h.push(t)}return h.push(`${s}  },`),h.push(`${s}});`),{name:g,description:d,fields:l,code:h.join(`
-`)}}function u(e,t){let n=`  `.repeat(t),r=[];return r.push(`${n}${e.name}: {`),e.enumValues?r.push(`${n}  type: new EnumType([${e.enumValues.map(e=>`'${e}'`).join(`, `)}]),`):e.scalarType?r.push(`${n}  type: ${e.scalarType},`):r.push(`${n}  type: ${e.type.type}, // TODO: Define or import this type`),e.type.optional&&r.push(`${n}  isOptional: true,`),e.type.array&&r.push(`${n}  isArray: true,`),r.push(`${n}},`),r.join(`
-`)}function d(e){let t=new Set;t.add(`import { defineSchemaModel, ScalarTypeEnum, EnumType } from '@lssm/lib.schema';`);for(let t of e)!t.type.primitive&&!t.enumValues&&t.scalarType;return Array.from(t).join(`
-`)}export{c,d,l,o,s};
+import { toCamelCase, toPascalCase, toValidIdentifier } from "../common/utils.js";
+
+//#region ../../libs/contracts-transformers/dist/openapi/schema-converter.js
+/**
+* Map JSON Schema types to ContractSpec ScalarTypeEnum values.
+*/
+const JSON_SCHEMA_TO_SCALAR = {
+	string: "ScalarTypeEnum.STRING",
+	integer: "ScalarTypeEnum.INT",
+	number: "ScalarTypeEnum.FLOAT",
+	boolean: "ScalarTypeEnum.BOOLEAN",
+	"string:date": "ScalarTypeEnum.DATE",
+	"string:date-time": "ScalarTypeEnum.DATE_TIME",
+	"string:email": "ScalarTypeEnum.EMAIL",
+	"string:uri": "ScalarTypeEnum.URL",
+	"string:uuid": "ScalarTypeEnum.ID"
+};
+/**
+* Check if a schema is a reference object.
+*/
+function isReference(schema) {
+	return "$ref" in schema;
+}
+/**
+* Extract type name from a $ref.
+*/
+function typeNameFromRef(ref) {
+	const parts = ref.split("/");
+	return parts[parts.length - 1] ?? "Unknown";
+}
+/**
+* Convert a JSON Schema to a TypeScript type representation.
+*/
+function jsonSchemaToType(schema, name) {
+	if (isReference(schema)) return {
+		type: toPascalCase(typeNameFromRef(schema.$ref)),
+		optional: false,
+		array: false,
+		primitive: false
+	};
+	const schemaObj = schema;
+	const type = schemaObj["type"];
+	const format = schemaObj["format"];
+	const nullable = schemaObj["nullable"];
+	if (type === "array") {
+		const items = schemaObj["items"];
+		if (items) return {
+			...jsonSchemaToType(items, name),
+			array: true,
+			optional: nullable ?? false
+		};
+		return {
+			type: "unknown",
+			optional: nullable ?? false,
+			array: true,
+			primitive: false
+		};
+	}
+	if (type === "object" || schemaObj["properties"]) return {
+		type: name ? toPascalCase(name) : "Record<string, unknown>",
+		optional: nullable ?? false,
+		array: false,
+		primitive: false
+	};
+	if (schemaObj["enum"]) return {
+		type: name ? toPascalCase(name) : "string",
+		optional: nullable ?? false,
+		array: false,
+		primitive: false
+	};
+	format && `${type}${format}`;
+	if (type === "string") return {
+		type: "string",
+		optional: nullable ?? false,
+		array: false,
+		primitive: true
+	};
+	if (type === "integer" || type === "number") return {
+		type: "number",
+		optional: nullable ?? false,
+		array: false,
+		primitive: true
+	};
+	if (type === "boolean") return {
+		type: "boolean",
+		optional: nullable ?? false,
+		array: false,
+		primitive: true
+	};
+	return {
+		type: "unknown",
+		optional: nullable ?? false,
+		array: false,
+		primitive: false
+	};
+}
+/**
+* Get the ScalarTypeEnum value for a JSON Schema type.
+*/
+function getScalarType(schema) {
+	if (isReference(schema)) return;
+	const schemaObj = schema;
+	const type = schemaObj["type"];
+	const format = schemaObj["format"];
+	if (!type) return void 0;
+	return JSON_SCHEMA_TO_SCALAR[format ? `${type}:${format}` : type] ?? JSON_SCHEMA_TO_SCALAR[type];
+}
+/**
+* Convert a JSON Schema to a SchemaModel field definition.
+*/
+function jsonSchemaToField(schema, fieldName, required) {
+	const type = jsonSchemaToType(schema, fieldName);
+	const scalarType = getScalarType(schema);
+	let enumValues;
+	if (!isReference(schema)) {
+		const enumArr = schema["enum"];
+		if (enumArr) enumValues = enumArr.map(String);
+	}
+	return {
+		name: toValidIdentifier(toCamelCase(fieldName)),
+		type: {
+			...type,
+			optional: !required || type.optional,
+			description: !isReference(schema) ? schema["description"] : void 0
+		},
+		scalarType,
+		enumValues
+	};
+}
+/**
+* Generate SchemaModel TypeScript code for a JSON Schema object.
+*/
+function generateSchemaModelCode(schema, modelName, indent = 0) {
+	const spaces = "  ".repeat(indent);
+	const fields = [];
+	let description;
+	if (isReference(schema)) return {
+		name: toPascalCase(typeNameFromRef(schema.$ref)),
+		fields: [],
+		code: `// Reference to ${schema.$ref}`
+	};
+	const schemaObj = schema;
+	description = schemaObj["description"];
+	const properties = schemaObj["properties"];
+	const required = schemaObj["required"] ?? [];
+	if (!properties) return {
+		name: toPascalCase(modelName),
+		description,
+		fields: [],
+		code: `${spaces}// Empty schema for ${modelName}`
+	};
+	for (const [propName, propSchema] of Object.entries(properties)) {
+		const isRequired = required.includes(propName);
+		fields.push(jsonSchemaToField(propSchema, propName, isRequired));
+	}
+	const lines = [];
+	const safeModelName = toPascalCase(toValidIdentifier(modelName));
+	lines.push(`${spaces}export const ${safeModelName} = defineSchemaModel({`);
+	lines.push(`${spaces}  name: '${safeModelName}',`);
+	if (description) lines.push(`${spaces}  description: ${JSON.stringify(description)},`);
+	lines.push(`${spaces}  fields: {`);
+	for (const field of fields) {
+		const fieldLines = generateFieldCode(field, indent + 2);
+		lines.push(fieldLines);
+	}
+	lines.push(`${spaces}  },`);
+	lines.push(`${spaces}});`);
+	return {
+		name: safeModelName,
+		description,
+		fields,
+		code: lines.join("\n")
+	};
+}
+/**
+* Generate TypeScript code for a single field.
+*/
+function generateFieldCode(field, indent) {
+	const spaces = "  ".repeat(indent);
+	const lines = [];
+	lines.push(`${spaces}${field.name}: {`);
+	if (field.enumValues) lines.push(`${spaces}  type: new EnumType([${field.enumValues.map((v) => `'${v}'`).join(", ")}]),`);
+	else if (field.scalarType) lines.push(`${spaces}  type: ${field.scalarType},`);
+	else lines.push(`${spaces}  type: ${field.type.type}, // TODO: Define or import this type`);
+	if (field.type.optional) lines.push(`${spaces}  isOptional: true,`);
+	if (field.type.array) lines.push(`${spaces}  isArray: true,`);
+	lines.push(`${spaces}},`);
+	return lines.join("\n");
+}
+/**
+* Generate import statements for a SchemaModel.
+*/
+function generateImports(fields) {
+	const imports = /* @__PURE__ */ new Set();
+	imports.add("import { defineSchemaModel, ScalarTypeEnum, EnumType } from '@lssm/lib.schema';");
+	for (const field of fields) if (!field.type.primitive && !field.enumValues && !field.scalarType) {}
+	return Array.from(imports).join("\n");
+}
+
+//#endregion
+export { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType };

package/dist/modules/contractspec-workspace/dist/ai/code-generation.js

@@ -1,9 +1,18 @@
-function e(e){return`You are a senior TypeScript developer implementing a handler for a contract specification.
+//#region ../../modules/contractspec-workspace/dist/ai/code-generation.js
+/**
+* AI prompts for code generation.
+* Extracted from cli-contracts/src/ai/prompts/code-generation.ts
+*/
+/**
+* Build prompt for generating handler implementation.
+*/
+function buildHandlerPrompt(specCode) {
+	return `You are a senior TypeScript developer implementing a handler for a contract specification.
 
 Here is the contract spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete handler implementation that:
@@ -17,12 +26,18 @@ Generate a complete handler implementation that:
 
 The handler should be production-ready with proper error handling, logging points, and clear structure.
 
-Return only the TypeScript code for the handler function.`}function t(e){return`You are a senior React developer creating a component for a presentation specification.
+Return only the TypeScript code for the handler function.`;
+}
+/**
+* Build prompt for generating React component from presentation spec.
+*/
+function buildComponentPrompt(specCode) {
+	return `You are a senior React developer creating a component for a presentation specification.
 
 Here is the presentation spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete React component that:
@@ -36,12 +51,18 @@ Generate a complete React component that:
 
 The component should follow Atomic Design principles and be reusable.
 
-Return only the TypeScript/TSX code for the component.`}function n(e){return`You are a senior React developer creating a form component from a form specification.
+Return only the TypeScript/TSX code for the component.`;
+}
+/**
+* Build prompt for generating form component.
+*/
+function buildFormPrompt(specCode) {
+	return `You are a senior React developer creating a form component from a form specification.
 
 Here is the form spec:
 
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Generate a complete form component using react-hook-form that:
@@ -56,25 +77,31 @@ Generate a complete form component using react-hook-form that:
 
 The form should provide excellent UX with real-time validation and helpful feedback.
 
-Return only the TypeScript/TSX code for the form component.`}function r(e,t,n){return`You are a senior developer writing comprehensive tests.
+Return only the TypeScript/TSX code for the form component.`;
+}
+/**
+* Build prompt for generating tests.
+*/
+function buildTestPrompt(specCode, implementationCode, testType) {
+	return `You are a senior developer writing comprehensive tests.
 
 Spec:
 \`\`\`typescript
-${e}
+${specCode}
 \`\`\`
 
 Implementation:
 \`\`\`typescript
-${t}
+${implementationCode}
 \`\`\`
 
 Generate complete test suite using Vitest that:
-${n===`handler`?`
+${testType === "handler" ? `
   - Test all acceptance scenarios from the spec
   - Test error cases defined in spec.io.errors
   - Verify events are emitted correctly
   - Test input validation
-  - Test happy path and edge cases`:`
+  - Test happy path and edge cases` : `
   - Test rendering with various props
   - Test user interactions
   - Test accessibility (a11y)
@@ -83,7 +110,13 @@ ${n===`handler`?`
 
 Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
 
-Return only the TypeScript test code.`}function i(){return`You are an expert TypeScript developer with deep knowledge of:
+Return only the TypeScript test code.`;
+}
+/**
+* System prompt for code generation.
+*/
+function getCodeGenSystemPrompt() {
+	return `You are an expert TypeScript developer with deep knowledge of:
 - Type-safe API design
 - React and modern hooks
 - Test-driven development
@@ -97,4 +130,8 @@ Generate production-ready code that is:
 - Defensive and error-safe
 - Easy to maintain and extend
 
-Always prioritize code quality, safety, and user experience.`}export{e,i,n,r,t};
+Always prioritize code quality, safety, and user experience.`;
+}
+
+//#endregion
+export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt };

package/dist/modules/contractspec-workspace/dist/ai/spec-creation.js

@@ -1,8 +1,13 @@
-function e(e,t){return`You are a senior software architect creating a contract specification for an operation.
+//#region ../../modules/contractspec-workspace/dist/ai/spec-creation.js
+/**
+* Build prompt for creating operation spec from description.
+*/
+function buildOperationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a contract specification for an operation.
 
-The operation is a ${t} (${t===`command`?`changes state, has side effects`:`read-only, idempotent`}).
+The operation is a ${kind} (${kind === "command" ? "changes state, has side effects" : "read-only, idempotent"}).
 
-User description: ${e}
+User description: ${description}
 
 Create a complete contract specification following these guidelines:
 
@@ -16,9 +21,15 @@ Create a complete contract specification following these guidelines:
 8. **Feature Flags**: Any flags that gate this operation
 9. **Side Effects**: What events might be emitted, analytics to track
 
-Respond with a structured spec.`}function t(e){return`You are a senior software architect creating an event specification.
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating event spec from description.
+*/
+function buildEventSpecPrompt(description) {
+	return `You are a senior software architect creating an event specification.
 
-User description: ${e}
+User description: ${description}
 
 Create a complete event specification following these guidelines:
 
@@ -30,11 +41,21 @@ Create a complete event specification following these guidelines:
 
 Events represent things that have already happened and should use past tense.
 
-Respond with a structured spec.`}function n(e,t){return`You are a senior software architect creating a presentation specification.
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating presentation spec from description.
+*/
+function buildPresentationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a presentation specification.
 
-This is a ${t} presentation - ${{web_component:`a React component with props schema`,markdown:`markdown/MDX documentation or guide`,data:`structured data export (JSON/XML)`}[t]}.
+This is a ${kind} presentation - ${{
+		web_component: "a React component with props schema",
+		markdown: "markdown/MDX documentation or guide",
+		data: "structured data export (JSON/XML)"
+	}[kind]}.
 
-User description: ${e}
+User description: ${description}
 
 Create a complete presentation specification following these guidelines:
 
@@ -42,13 +63,15 @@ Create a complete presentation specification following these guidelines:
 2. **Version**: Start at 1
 3. **Description**: What this presentation shows/provides
 4. **Kind-specific details**:
-   ${t===`web_component`?`- Component key (symbolic, resolved by host app)
-   - Props structure
-   - Analytics events to track`:t===`markdown`?`- Content or resource URI
-   - Target audience`:`- MIME type (e.g., application/json)
-   - Data structure description`}
+   ${kind === "web_component" ? "- Component key (symbolic, resolved by host app)\n   - Props structure\n   - Analytics events to track" : kind === "markdown" ? "- Content or resource URI\n   - Target audience" : "- MIME type (e.g., application/json)\n   - Data structure description"}
 
-Respond with a structured spec.`}function r(){return`You are an expert software architect specializing in API design and contract-driven development.
+Respond with a structured spec.`;
+}
+/**
+* Build system prompt for all spec generation.
+*/
+function getSystemPrompt() {
+	return `You are an expert software architect specializing in API design and contract-driven development.
 
 You create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.
 
@@ -58,12 +81,21 @@ Your specs are:
 - Business-oriented (capturing the "why" not just "what")
 - Designed for both humans and AI agents to understand
 
-Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`}function i(e,t){return t.length===0?e:`${e}
+Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`;
+}
+/**
+* Create example-based prompt for better results.
+*/
+function addExampleContext(basePrompt, examples) {
+	if (examples.length === 0) return basePrompt;
+	return `${basePrompt}
 
 Here are some good examples for reference:
 
-${t.join(`
+${examples.join("\n\n")}
 
-`)}
+Follow this structure and quality level.`;
+}
 
-Follow this structure and quality level.`}export{e,i,n,r,t};
+//#endregion
+export { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt };