@contractspec/module.examples 1.44.0 → 1.45.0

package/dist/libs/contracts/dist/workspace-config/workspace-config.docblock.js

@@ -0,0 +1,45 @@
+import { registerDocBlocks } from "../docs/registry.js";
+
+//#region ../../libs/contracts/dist/workspace-config/workspace-config.docblock.js
+const tech_workspace_config_DocBlocks = [{
+	id: "docs.tech.contracts.workspace-config",
+	title: "Workspace Configuration (.contractsrc)",
+	summary: "Configuration-as-code conventions for ContractSpec workspaces (`.contractsrc.json`).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/workspace-config",
+	tags: [
+		"tech",
+		"contracts",
+		"config"
+	],
+	body: `## Workspace Configuration (.contractsrc)
+
+ContractSpec uses a hierarchical configuration system anchored by \`.contractsrc.json\` files. Configuration loader supports standard rc-file discovery (cosmiconfig).
+
+### Schema Formats
+
+The \`schemaFormat\` option controls the output format of schema generation commands (like \`contractspec openapi import\`).
+
+Supported formats:
+- \`contractspec\` (default): Generates standard \`defineSchemaModel\` code.
+- \`zod\`: Generates raw Zod schemas using \`z.object({...})\`.
+- \`json-schema\`: Generates JSON Schema definitions.
+- \`graphql\`: Generates GraphQL SDL type definitions.
+
+### Config Interface
+
+\`\`\`ts
+export interface ContractsrcConfig {
+  // ... existing fields ...
+  schemaFormat?: 'contractspec' | 'zod' | 'json-schema' | 'graphql';
+}
+\`\`\`
+
+Defined in \`@contractspec/lib.contracts/workspace-config\`.
+`
+}];
+registerDocBlocks(tech_workspace_config_DocBlocks);
+
+//#endregion
+//# sourceMappingURL=workspace-config.docblock.js.map

package/dist/libs/contracts/dist/workspace-config/workspace-config.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-config.docblock.js","names":[],"sources":["../../../../../../../libs/contracts/dist/workspace-config/workspace-config.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../docs/registry.js\";\n\n//#region src/workspace-config/workspace-config.docblock.ts\nconst tech_workspace_config_DocBlocks = [{\n\tid: \"docs.tech.contracts.workspace-config\",\n\ttitle: \"Workspace Configuration (.contractsrc)\",\n\tsummary: \"Configuration-as-code conventions for ContractSpec workspaces (`.contractsrc.json`).\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/workspace-config\",\n\ttags: [\n\t\t\"tech\",\n\t\t\"contracts\",\n\t\t\"config\"\n\t],\n\tbody: `## Workspace Configuration (.contractsrc)\n\nContractSpec uses a hierarchical configuration system anchored by \\`.contractsrc.json\\` files. Configuration loader supports standard rc-file discovery (cosmiconfig).\n\n### Schema Formats\n\nThe \\`schemaFormat\\` option controls the output format of schema generation commands (like \\`contractspec openapi import\\`).\n\nSupported formats:\n- \\`contractspec\\` (default): Generates standard \\`defineSchemaModel\\` code.\n- \\`zod\\`: Generates raw Zod schemas using \\`z.object({...})\\`.\n- \\`json-schema\\`: Generates JSON Schema definitions.\n- \\`graphql\\`: Generates GraphQL SDL type definitions.\n\n### Config Interface\n\n\\`\\`\\`ts\nexport interface ContractsrcConfig {\n  // ... existing fields ...\n  schemaFormat?: 'contractspec' | 'zod' | 'json-schema' | 'graphql';\n}\n\\`\\`\\`\n\nDefined in \\`@contractspec/lib.contracts/workspace-config\\`.\n`\n}];\nregisterDocBlocks(tech_workspace_config_DocBlocks);\n\n//#endregion\nexport { tech_workspace_config_DocBlocks };"],"mappings":";;;AAGA,MAAM,kCAAkC,CAAC;CACxC,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;CAyBN,CAAC;AACF,kBAAkB,gCAAgC"}

package/dist/libs/schema/dist/EnumType.js

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/libs/schema/dist/FieldType.js

@@ -0,0 +1,50 @@
+import "zod";
+import { GraphQLScalarType } from "graphql";
+
+//#region ../../libs/schema/dist/FieldType.js
+/**
+* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
+*
+* TInternal is the runtime representation; TExternal is the GraphQL output.
+*/
+var FieldType = class extends GraphQLScalarType {
+	zodSchema;
+	jsonSchemaDef;
+	constructor(config) {
+		super(config);
+		this.zodSchema = config.zod;
+		this.jsonSchemaDef = config.jsonSchema;
+	}
+	/** Return the attached zod schema for validation. */
+	getZod() {
+		return this.zodSchema;
+	}
+	/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
+	getPothos() {
+		return this;
+	}
+	/** Return the JSON Schema (evaluates factory if provided). */
+	getJson() {
+		return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
+	}
+	getJsonSchemaDef() {
+		return this.jsonSchemaDef;
+	}
+	getJsonSchema() {
+		const deepResolve = (v) => {
+			const value = typeof v === "function" ? v() : v;
+			if (Array.isArray(value)) return value.map((item) => deepResolve(item));
+			if (value && typeof value === "object") {
+				const obj = {};
+				for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
+				return obj;
+			}
+			return value;
+		};
+		return deepResolve(this.getJson());
+	}
+};
+
+//#endregion
+export { FieldType };
+//# sourceMappingURL=FieldType.js.map

package/dist/libs/schema/dist/FieldType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldType.js","names":[],"sources":["../../../../../../libs/schema/dist/FieldType.js"],"sourcesContent":["import \"zod\";\nimport { GraphQLScalarType } from \"graphql\";\n\n//#region src/FieldType.ts\n/**\n* GraphQL scalar wrapper that carries zod and JSON Schema metadata.\n*\n* TInternal is the runtime representation; TExternal is the GraphQL output.\n*/\nvar FieldType = class extends GraphQLScalarType {\n\tzodSchema;\n\tjsonSchemaDef;\n\tconstructor(config) {\n\t\tsuper(config);\n\t\tthis.zodSchema = config.zod;\n\t\tthis.jsonSchemaDef = config.jsonSchema;\n\t}\n\t/** Return the attached zod schema for validation. */\n\tgetZod() {\n\t\treturn this.zodSchema;\n\t}\n\t/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */\n\tgetPothos() {\n\t\treturn this;\n\t}\n\t/** Return the JSON Schema (evaluates factory if provided). */\n\tgetJson() {\n\t\treturn typeof this.jsonSchemaDef === \"function\" ? this.jsonSchemaDef() : this.jsonSchemaDef;\n\t}\n\tgetJsonSchemaDef() {\n\t\treturn this.jsonSchemaDef;\n\t}\n\tgetJsonSchema() {\n\t\tconst deepResolve = (v) => {\n\t\t\tconst value = typeof v === \"function\" ? v() : v;\n\t\t\tif (Array.isArray(value)) return value.map((item) => deepResolve(item));\n\t\t\tif (value && typeof value === \"object\") {\n\t\t\t\tconst obj = {};\n\t\t\t\tfor (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);\n\t\t\t\treturn obj;\n\t\t\t}\n\t\t\treturn value;\n\t\t};\n\t\treturn deepResolve(this.getJson());\n\t}\n};\n\n//#endregion\nexport { FieldType };\n//# sourceMappingURL=FieldType.js.map"],"mappings":";;;;;;;;;AASA,IAAI,YAAY,cAAc,kBAAkB;CAC/C;CACA;CACA,YAAY,QAAQ;AACnB,QAAM,OAAO;AACb,OAAK,YAAY,OAAO;AACxB,OAAK,gBAAgB,OAAO;;;CAG7B,SAAS;AACR,SAAO,KAAK;;;CAGb,YAAY;AACX,SAAO;;;CAGR,UAAU;AACT,SAAO,OAAO,KAAK,kBAAkB,aAAa,KAAK,eAAe,GAAG,KAAK;;CAE/E,mBAAmB;AAClB,SAAO,KAAK;;CAEb,gBAAgB;EACf,MAAM,eAAe,MAAM;GAC1B,MAAM,QAAQ,OAAO,MAAM,aAAa,GAAG,GAAG;AAC9C,OAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,KAAK,SAAS,YAAY,KAAK,CAAC;AACvE,OAAI,SAAS,OAAO,UAAU,UAAU;IACvC,MAAM,MAAM,EAAE;AACd,SAAK,MAAM,CAAC,GAAG,QAAQ,OAAO,QAAQ,MAAM,CAAE,KAAI,KAAK,YAAY,IAAI;AACvE,WAAO;;AAER,UAAO;;AAER,SAAO,YAAY,KAAK,SAAS,CAAC"}

package/dist/libs/schema/dist/GraphQLSchemaType.js

@@ -0,0 +1 @@
+import { z } from "zod";

package/dist/libs/schema/dist/JsonSchemaType.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/ScalarTypeEnum.js

@@ -0,0 +1,237 @@
+import { FieldType } from "./FieldType.js";
+import * as z$1$1 from "zod";
+import { Kind } from "graphql";
+
+//#region ../../libs/schema/dist/ScalarTypeEnum.js
+const localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;
+const timezoneRegex = /^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/;
+const phoneRegex = /^[+]?\d[\d\s().-]{3,}$/;
+const currencyRegex = /^[A-Z]{3}$/;
+const countryRegex = /^[A-Z]{2}$/;
+const latMin = -90;
+const latMax = 90;
+const lonMin = -180;
+const lonMax = 180;
+/**
+* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.
+*/
+const ScalarTypeEnum = {
+	String_unsecure: () => new FieldType({
+		name: "String_unsecure",
+		description: "Unvalidated string scalar",
+		zod: z$1$1.string(),
+		parseValue: (v) => z$1$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	Int_unsecure: () => new FieldType({
+		name: "Int_unsecure",
+		description: "Unvalidated integer scalar",
+		zod: z$1$1.number().int(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1$1.number().int().parse(num);
+		},
+		serialize: (v) => Math.trunc(typeof v === "number" ? v : Number(v)),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "integer" }
+	}),
+	Float_unsecure: () => new FieldType({
+		name: "Float_unsecure",
+		description: "Unvalidated float scalar",
+		zod: z$1$1.number(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1$1.number().parse(num);
+		},
+		serialize: (v) => Number(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "number" }
+	}),
+	Boolean: () => new FieldType({
+		name: "Boolean",
+		description: "Unvalidated boolean scalar",
+		zod: z$1$1.boolean(),
+		parseValue: (v) => z$1$1.coerce.boolean().parse(v),
+		serialize: (v) => Boolean(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.BOOLEAN) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "boolean" }
+	}),
+	ID: () => new FieldType({
+		name: "ID",
+		description: "Unvalidated id scalar",
+		zod: z$1$1.string(),
+		parseValue: (v) => z$1$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	JSON: () => new FieldType({
+		name: "JSON",
+		zod: z$1$1.any(),
+		parseValue: (v) => v,
+		serialize: (v) => v,
+		jsonSchema: {}
+	}),
+	JSONObject: () => new FieldType({
+		name: "JSONObject",
+		zod: z$1$1.record(z$1$1.string(), z$1$1.any()),
+		parseValue: (v) => z$1$1.record(z$1$1.string(), z$1$1.any()).parse(v),
+		serialize: (v) => v ?? {},
+		jsonSchema: { type: "object" }
+	}),
+	Date: () => new FieldType({
+		name: "Date",
+		zod: z$1$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => v instanceof Date ? v.toISOString().split("T")[0] : String(v),
+		jsonSchema: {
+			type: "string",
+			format: "date"
+		}
+	}),
+	DateTime: () => new FieldType({
+		name: "DateTime",
+		zod: z$1$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => {
+			return v instanceof Date ? v.toISOString() : String(v);
+		},
+		jsonSchema: {
+			type: "string",
+			format: "date-time"
+		}
+	}),
+	Time: () => new FieldType({
+		name: "Time",
+		zod: z$1$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),
+		parseValue: (v) => z$1$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: "^\\d{2}:\\d{2}(:\\d{2})?$"
+		}
+	}),
+	EmailAddress: () => new FieldType({
+		name: "EmailAddress",
+		zod: z$1$1.string().email(),
+		parseValue: (v) => z$1$1.string().email().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "email"
+		}
+	}),
+	URL: () => new FieldType({
+		name: "URL",
+		zod: z$1$1.string().url(),
+		parseValue: (v) => z$1$1.string().url().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "uri"
+		}
+	}),
+	PhoneNumber: () => new FieldType({
+		name: "PhoneNumber",
+		zod: z$1$1.string().regex(phoneRegex),
+		parseValue: (v) => z$1$1.string().regex(phoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: phoneRegex.source
+		}
+	}),
+	NonEmptyString: () => new FieldType({
+		name: "NonEmptyString",
+		zod: z$1$1.string().min(1),
+		parseValue: (v) => z$1$1.string().min(1).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			minLength: 1
+		}
+	}),
+	Locale: () => new FieldType({
+		name: "Locale",
+		zod: z$1$1.string().regex(localeRegex),
+		parseValue: (v) => z$1$1.string().regex(localeRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: localeRegex.source
+		}
+	}),
+	TimeZone: () => new FieldType({
+		name: "TimeZone",
+		zod: z$1$1.string().regex(timezoneRegex),
+		parseValue: (v) => z$1$1.string().regex(timezoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: timezoneRegex.source
+		}
+	}),
+	Latitude: () => new FieldType({
+		name: "Latitude",
+		zod: z$1$1.number().min(latMin).max(latMax),
+		parseValue: (v) => z$1$1.coerce.number().min(latMin).max(latMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: latMin,
+			maximum: latMax
+		}
+	}),
+	Longitude: () => new FieldType({
+		name: "Longitude",
+		zod: z$1$1.number().min(lonMin).max(lonMax),
+		parseValue: (v) => z$1$1.coerce.number().min(lonMin).max(lonMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: lonMin,
+			maximum: lonMax
+		}
+	}),
+	Currency: () => new FieldType({
+		name: "Currency",
+		zod: z$1$1.string().regex(currencyRegex),
+		parseValue: (v) => z$1$1.string().regex(currencyRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: currencyRegex.source
+		}
+	}),
+	CountryCode: () => new FieldType({
+		name: "CountryCode",
+		zod: z$1$1.string().regex(countryRegex),
+		parseValue: (v) => z$1$1.string().regex(countryRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: countryRegex.source
+		}
+	})
+};
+
+//#endregion
+export { ScalarTypeEnum };
+//# sourceMappingURL=ScalarTypeEnum.js.map

package/dist/libs/schema/dist/ScalarTypeEnum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScalarTypeEnum.js","names":["z$1"],"sources":["../../../../../../libs/schema/dist/ScalarTypeEnum.js"],"sourcesContent":["import { FieldType } from \"./FieldType.js\";\nimport * as z$1 from \"zod\";\nimport { Kind } from \"graphql\";\n\n//#region src/ScalarTypeEnum.ts\nconst localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;\nconst timezoneRegex = /^(?:UTC|[A-Za-z_]+\\/[A-Za-z_]+)$/;\nconst phoneRegex = /^[+]?\\d[\\d\\s().-]{3,}$/;\nconst currencyRegex = /^[A-Z]{3}$/;\nconst countryRegex = /^[A-Z]{2}$/;\nconst latMin = -90;\nconst latMax = 90;\nconst lonMin = -180;\nconst lonMax = 180;\n/**\n* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.\n*/\nconst ScalarTypeEnum = {\n\tString_unsecure: () => new FieldType({\n\t\tname: \"String_unsecure\",\n\t\tdescription: \"Unvalidated string scalar\",\n\t\tzod: z$1.string(),\n\t\tparseValue: (v) => z$1.string().parse(v),\n\t\tserialize: (v) => String(v),\n\t\tparseLiteral: (ast) => {\n\t\t\tif (ast.kind !== Kind.STRING) throw new TypeError(\"Invalid literal\");\n\t\t\treturn ast.value;\n\t\t},\n\t\tjsonSchema: { type: \"string\" }\n\t}),\n\tInt_unsecure: () => new FieldType({\n\t\tname: \"Int_unsecure\",\n\t\tdescription: \"Unvalidated integer scalar\",\n\t\tzod: z$1.number().int(),\n\t\tparseValue: (v) => {\n\t\t\tconst num = typeof v === \"number\" ? v : Number(v);\n\t\t\treturn z$1.number().int().parse(num);\n\t\t},\n\t\tserialize: (v) => Math.trunc(typeof v === \"number\" ? v : Number(v)),\n\t\tparseLiteral: (ast) => {\n\t\t\tif (ast.kind !== Kind.INT) throw new TypeError(\"Invalid literal\");\n\t\t\treturn Number(ast.value);\n\t\t},\n\t\tjsonSchema: { type: \"integer\" }\n\t}),\n\tFloat_unsecure: () => new FieldType({\n\t\tname: \"Float_unsecure\",\n\t\tdescription: \"Unvalidated float scalar\",\n\t\tzod: z$1.number(),\n\t\tparseValue: (v) => {\n\t\t\tconst num = typeof v === \"number\" ? v : Number(v);\n\t\t\treturn z$1.number().parse(num);\n\t\t},\n\t\tserialize: (v) => Number(v),\n\t\tparseLiteral: (ast) => {\n\t\t\tif (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError(\"Invalid literal\");\n\t\t\treturn Number(ast.value);\n\t\t},\n\t\tjsonSchema: { type: \"number\" }\n\t}),\n\tBoolean: () => new FieldType({\n\t\tname: \"Boolean\",\n\t\tdescription: \"Unvalidated boolean scalar\",\n\t\tzod: z$1.boolean(),\n\t\tparseValue: (v) => z$1.coerce.boolean().parse(v),\n\t\tserialize: (v) => Boolean(v),\n\t\tparseLiteral: (ast) => {\n\t\t\tif (ast.kind !== Kind.BOOLEAN) throw new TypeError(\"Invalid literal\");\n\t\t\treturn ast.value;\n\t\t},\n\t\tjsonSchema: { type: \"boolean\" }\n\t}),\n\tID: () => new FieldType({\n\t\tname: \"ID\",\n\t\tdescription: \"Unvalidated id scalar\",\n\t\tzod: z$1.string(),\n\t\tparseValue: (v) => z$1.string().parse(v),\n\t\tserialize: (v) => String(v),\n\t\tparseLiteral: (ast) => {\n\t\t\tif (ast.kind !== Kind.STRING) throw new TypeError(\"Invalid literal\");\n\t\t\treturn ast.value;\n\t\t},\n\t\tjsonSchema: { type: \"string\" }\n\t}),\n\tJSON: () => new FieldType({\n\t\tname: \"JSON\",\n\t\tzod: z$1.any(),\n\t\tparseValue: (v) => v,\n\t\tserialize: (v) => v,\n\t\tjsonSchema: {}\n\t}),\n\tJSONObject: () => new FieldType({\n\t\tname: \"JSONObject\",\n\t\tzod: z$1.record(z$1.string(), z$1.any()),\n\t\tparseValue: (v) => z$1.record(z$1.string(), z$1.any()).parse(v),\n\t\tserialize: (v) => v ?? {},\n\t\tjsonSchema: { type: \"object\" }\n\t}),\n\tDate: () => new FieldType({\n\t\tname: \"Date\",\n\t\tzod: z$1.date(),\n\t\tparseValue: (v) => v instanceof Date ? v : new Date(String(v)),\n\t\tserialize: (v) => v instanceof Date ? v.toISOString().split(\"T\")[0] : String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tformat: \"date\"\n\t\t}\n\t}),\n\tDateTime: () => new FieldType({\n\t\tname: \"DateTime\",\n\t\tzod: z$1.date(),\n\t\tparseValue: (v) => v instanceof Date ? v : new Date(String(v)),\n\t\tserialize: (v) => {\n\t\t\treturn v instanceof Date ? v.toISOString() : String(v);\n\t\t},\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tformat: \"date-time\"\n\t\t}\n\t}),\n\tTime: () => new FieldType({\n\t\tname: \"Time\",\n\t\tzod: z$1.string().regex(/^\\d{2}:\\d{2}(:\\d{2})?$/),\n\t\tparseValue: (v) => z$1.string().regex(/^\\d{2}:\\d{2}(:\\d{2})?$/).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: \"^\\\\d{2}:\\\\d{2}(:\\\\d{2})?$\"\n\t\t}\n\t}),\n\tEmailAddress: () => new FieldType({\n\t\tname: \"EmailAddress\",\n\t\tzod: z$1.string().email(),\n\t\tparseValue: (v) => z$1.string().email().parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tformat: \"email\"\n\t\t}\n\t}),\n\tURL: () => new FieldType({\n\t\tname: \"URL\",\n\t\tzod: z$1.string().url(),\n\t\tparseValue: (v) => z$1.string().url().parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tformat: \"uri\"\n\t\t}\n\t}),\n\tPhoneNumber: () => new FieldType({\n\t\tname: \"PhoneNumber\",\n\t\tzod: z$1.string().regex(phoneRegex),\n\t\tparseValue: (v) => z$1.string().regex(phoneRegex).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: phoneRegex.source\n\t\t}\n\t}),\n\tNonEmptyString: () => new FieldType({\n\t\tname: \"NonEmptyString\",\n\t\tzod: z$1.string().min(1),\n\t\tparseValue: (v) => z$1.string().min(1).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tminLength: 1\n\t\t}\n\t}),\n\tLocale: () => new FieldType({\n\t\tname: \"Locale\",\n\t\tzod: z$1.string().regex(localeRegex),\n\t\tparseValue: (v) => z$1.string().regex(localeRegex).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: localeRegex.source\n\t\t}\n\t}),\n\tTimeZone: () => new FieldType({\n\t\tname: \"TimeZone\",\n\t\tzod: z$1.string().regex(timezoneRegex),\n\t\tparseValue: (v) => z$1.string().regex(timezoneRegex).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: timezoneRegex.source\n\t\t}\n\t}),\n\tLatitude: () => new FieldType({\n\t\tname: \"Latitude\",\n\t\tzod: z$1.number().min(latMin).max(latMax),\n\t\tparseValue: (v) => z$1.coerce.number().min(latMin).max(latMax).parse(v),\n\t\tserialize: (v) => Number(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"number\",\n\t\t\tminimum: latMin,\n\t\t\tmaximum: latMax\n\t\t}\n\t}),\n\tLongitude: () => new FieldType({\n\t\tname: \"Longitude\",\n\t\tzod: z$1.number().min(lonMin).max(lonMax),\n\t\tparseValue: (v) => z$1.coerce.number().min(lonMin).max(lonMax).parse(v),\n\t\tserialize: (v) => Number(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"number\",\n\t\t\tminimum: lonMin,\n\t\t\tmaximum: lonMax\n\t\t}\n\t}),\n\tCurrency: () => new FieldType({\n\t\tname: \"Currency\",\n\t\tzod: z$1.string().regex(currencyRegex),\n\t\tparseValue: (v) => z$1.string().regex(currencyRegex).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: currencyRegex.source\n\t\t}\n\t}),\n\tCountryCode: () => new FieldType({\n\t\tname: \"CountryCode\",\n\t\tzod: z$1.string().regex(countryRegex),\n\t\tparseValue: (v) => z$1.string().regex(countryRegex).parse(v),\n\t\tserialize: (v) => String(v),\n\t\tjsonSchema: {\n\t\t\ttype: \"string\",\n\t\t\tpattern: countryRegex.source\n\t\t}\n\t})\n};\n\n//#endregion\nexport { ScalarTypeEnum };\n//# sourceMappingURL=ScalarTypeEnum.js.map"],"mappings":"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"}

package/dist/libs/schema/dist/SchemaModel.js

@@ -0,0 +1,35 @@
+import "./EnumType.js";
+import "./FieldType.js";
+import * as z$1$1 from "zod";
+
+//#region ../../libs/schema/dist/SchemaModel.js
+/**
+* Named object model built from FieldType/EnumType/SchemaModel fields.
+* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+*/
+var SchemaModel = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Build a typed ZodObject from the model fields, preserving each field's
+	* Zod schema and optionality at the type level when possible.
+	*/
+	getZod() {
+		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
+			const base = def.type.getZod();
+			const withArray = def.isArray ? z$1$1.array(base) : base;
+			acc[key] = def.isOptional ? withArray.optional() : withArray;
+			return acc;
+		}, {});
+		return z$1$1.object(shape);
+	}
+	/** Input object name for GraphQL builder adapters. */
+	getPothosInput() {
+		return this.config.name;
+	}
+};
+
+//#endregion
+export { SchemaModel };
+//# sourceMappingURL=SchemaModel.js.map

package/dist/libs/schema/dist/SchemaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModel.js","names":["z$1"],"sources":["../../../../../../libs/schema/dist/SchemaModel.js"],"sourcesContent":["import \"./EnumType.js\";\nimport \"./FieldType.js\";\nimport * as z$1 from \"zod\";\n\n//#region src/SchemaModel.ts\n/**\n* Named object model built from FieldType/EnumType/SchemaModel fields.\n* Provides zod and GraphQL input helpers, and supports arrays/optional fields.\n*/\nvar SchemaModel = class {\n\tconstructor(config) {\n\t\tthis.config = config;\n\t}\n\t/**\n\t* Build a typed ZodObject from the model fields, preserving each field's\n\t* Zod schema and optionality at the type level when possible.\n\t*/\n\tgetZod() {\n\t\tconst shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {\n\t\t\tconst base = def.type.getZod();\n\t\t\tconst withArray = def.isArray ? z$1.array(base) : base;\n\t\t\tacc[key] = def.isOptional ? withArray.optional() : withArray;\n\t\t\treturn acc;\n\t\t}, {});\n\t\treturn z$1.object(shape);\n\t}\n\t/** Input object name for GraphQL builder adapters. */\n\tgetPothosInput() {\n\t\treturn this.config.name;\n\t}\n};\n/**\n* Type guard to check if a value is a SchemaModel (not just any SchemaType).\n* Use this when you need to access SchemaModel-specific properties like `config`.\n*\n* @param model - The model to check\n* @returns True if the model is a SchemaModel instance\n*\n* @example\n* ```typescript\n* if (isSchemaModel(model)) {\n*   // TypeScript knows model.config is available\n*   console.log(model.config.name);\n* }\n* ```\n*/\nfunction isSchemaModel(model) {\n\treturn model !== null && model !== void 0 && \"config\" in model && typeof model.config === \"object\" && \"name\" in model.config;\n}\n/**\n* Helper to define a SchemaModel with type inference.\n* Equivalent to `new SchemaModel(config)` but with better ergonomics.\n*/\nconst defineSchemaModel = (config) => new SchemaModel(config);\n\n//#endregion\nexport { SchemaModel, defineSchemaModel, isSchemaModel };\n//# sourceMappingURL=SchemaModel.js.map"],"mappings":";;;;;;;;;AASA,IAAI,cAAc,MAAM;CACvB,YAAY,QAAQ;AACnB,OAAK,SAAS;;;;;;CAMf,SAAS;EACR,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,OAAO,CAAC,QAAQ,KAAK,CAAC,KAAK,SAAS;GAC5E,MAAM,OAAO,IAAI,KAAK,QAAQ;GAC9B,MAAM,YAAY,IAAI,UAAUA,MAAI,MAAM,KAAK,GAAG;AAClD,OAAI,OAAO,IAAI,aAAa,UAAU,UAAU,GAAG;AACnD,UAAO;KACL,EAAE,CAAC;AACN,SAAOA,MAAI,OAAO,MAAM;;;CAGzB,iBAAiB;AAChB,SAAO,KAAK,OAAO"}

package/dist/libs/schema/dist/ZodSchemaType.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/entity/defineEntity.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/entity/index.js

@@ -0,0 +1,2 @@
+import "./defineEntity.js";
+import "./types.js";

package/dist/libs/schema/dist/entity/types.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/index.js

@@ -0,0 +1,9 @@
+import "./EnumType.js";
+import { FieldType } from "./FieldType.js";
+import "./GraphQLSchemaType.js";
+import "./JsonSchemaType.js";
+import { ScalarTypeEnum } from "./ScalarTypeEnum.js";
+import { SchemaModel } from "./SchemaModel.js";
+import "./ZodSchemaType.js";
+import "./entity/defineEntity.js";
+import "./entity/index.js";

package/dist/registry.d.ts

@@ -1,10 +1,24 @@
-import { ExampleDefinition, ExampleId } from "./types.js";
-import { EXAMPLE_REGISTRY } from "./builtins.js";
+import { ExampleRegistry, ExampleSpec } from "@contractspec/lib.contracts";
 
 //#region src/registry.d.ts
-declare function listExamples(): readonly ExampleDefinition[];
-declare function getExample(id: ExampleId): ExampleDefinition | undefined;
-declare function searchExamples(query: string): ExampleDefinition[];
+
+/**
+ * Global registry containing all builtin ContractSpec examples.
+ * @deprecated Prefer using ExampleRegistry directly for custom registrations.
+ */
+declare const EXAMPLE_REGISTRY: readonly ExampleSpec[];
+/**
+ * List all registered examples.
+ */
+declare function listExamples(): readonly ExampleSpec[];
+/**
+ * Get an example by its key.
+ */
+declare function getExample(key: string): ExampleSpec | undefined;
+/**
+ * Search examples by query (matches key, title, description, tags).
+ */
+declare function searchExamples(query: string): ExampleSpec[];
 //#endregion
-export { getExample, listExamples, searchExamples };
+export { EXAMPLE_REGISTRY, ExampleRegistry, getExample, listExamples, searchExamples };
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","names":[],"sources":["../src/registry.ts"],"sourcesContent":[],"mappings":";;;;iBAKgB,YAAA,CAAA,YAAyB;AAAzB,iBAIA,UAAA,CAJyB,EAAA,EAIV,SAJU,CAAiB,EAIf,iBAJe,GAAA,SAAA;AAI1C,iBAIA,cAAA,CAJe,KAAY,EAAA,MAAA,CAAA,EAII,iBAJa,EAAA"}
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../src/registry.ts"],"sourcesContent":[],"mappings":";;;;;AAmBA;AAKA;AAOA;AAOgB,cAnBH,gBAmBkC,EAAA,SAnBP,WAmBkB,EAAA;;;;iBAd1C,YAAA,CAAA,YAAyB;;;;iBAOzB,UAAA,eAAyB;;;;iBAOzB,cAAA,iBAA+B"}

package/dist/registry.js

@@ -1,20 +1,34 @@
-import { EXAMPLE_REGISTRY } from "./builtins.js";
+import { ExampleRegistry } from "./libs/contracts/dist/examples/registry.js";
+import "./libs/contracts/dist/index.js";
+import { EXAMPLE_REGISTRY as EXAMPLE_REGISTRY$1 } from "./builtins.js";
 
 //#region src/registry.ts
+const globalRegistry = new ExampleRegistry();
+for (const example of EXAMPLE_REGISTRY$1) globalRegistry.register(example);
+/**
+* Global registry containing all builtin ContractSpec examples.
+* @deprecated Prefer using ExampleRegistry directly for custom registrations.
+*/
+const EXAMPLE_REGISTRY = globalRegistry.list();
+/**
+* List all registered examples.
+*/
 function listExamples() {
-	return EXAMPLE_REGISTRY.slice().sort((a, b) => a.id.localeCompare(b.id));
+	return globalRegistry.list();
 }
-function getExample(id) {
-	return EXAMPLE_REGISTRY.find((ex) => ex.id === id);
+/**
+* Get an example by its key.
+*/
+function getExample(key) {
+	return globalRegistry.get(key);
 }
+/**
+* Search examples by query (matches key, title, description, tags).
+*/
 function searchExamples(query) {
-	const q = query.toLowerCase().trim();
-	if (!q) return [...listExamples()];
-	return listExamples().filter((ex) => {
-		return `${ex.id} ${ex.title} ${ex.summary} ${ex.tags.join(" ")}`.toLowerCase().includes(q);
-	});
+	return globalRegistry.search(query);
 }
 
 //#endregion
-export { getExample, listExamples, searchExamples };
+export { EXAMPLE_REGISTRY, getExample, listExamples, searchExamples };
 //# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../src/registry.ts"],"sourcesContent":["import type { ExampleDefinition, ExampleId } from './types';\nimport { EXAMPLE_REGISTRY } from './builtins';\n\nexport { EXAMPLE_REGISTRY };\n\nexport function listExamples(): readonly ExampleDefinition[] {\n  return EXAMPLE_REGISTRY.slice().sort((a, b) => a.id.localeCompare(b.id));\n}\n\nexport function getExample(id: ExampleId): ExampleDefinition | undefined {\n  return EXAMPLE_REGISTRY.find((ex) => ex.id === id);\n}\n\nexport function searchExamples(query: string): ExampleDefinition[] {\n  const q = query.toLowerCase().trim();\n  if (!q) return [...listExamples()];\n  return listExamples().filter((ex) => {\n    const hay =\n      `${ex.id} ${ex.title} ${ex.summary} ${ex.tags.join(' ')}`.toLowerCase();\n    return hay.includes(q);\n  });\n}\n"],"mappings":";;;AAKA,SAAgB,eAA6C;AAC3D,QAAO,iBAAiB,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC;;AAG1E,SAAgB,WAAW,IAA8C;AACvE,QAAO,iBAAiB,MAAM,OAAO,GAAG,OAAO,GAAG;;AAGpD,SAAgB,eAAe,OAAoC;CACjE,MAAM,IAAI,MAAM,aAAa,CAAC,MAAM;AACpC,KAAI,CAAC,EAAG,QAAO,CAAC,GAAG,cAAc,CAAC;AAClC,QAAO,cAAc,CAAC,QAAQ,OAAO;AAGnC,SADE,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,QAAQ,GAAG,GAAG,KAAK,KAAK,IAAI,GAAG,aAAa,CAC9D,SAAS,EAAE;GACtB"}
+{"version":3,"file":"registry.js","names":["BUILTIN_EXAMPLES","EXAMPLE_REGISTRY: readonly ExampleSpec[]"],"sources":["../src/registry.ts"],"sourcesContent":["import { ExampleRegistry } from '@contractspec/lib.contracts';\nimport type { ExampleSpec } from '@contractspec/lib.contracts';\nimport { EXAMPLE_REGISTRY as BUILTIN_EXAMPLES } from './builtins';\n\n// Export the ExampleRegistry class from contracts\nexport { ExampleRegistry } from '@contractspec/lib.contracts';\n\n// Create a global registry instance populated with builtins\nconst globalRegistry = new ExampleRegistry();\n\n// Register all builtin examples\nfor (const example of BUILTIN_EXAMPLES) {\n  globalRegistry.register(example);\n}\n\n/**\n * Global registry containing all builtin ContractSpec examples.\n * @deprecated Prefer using ExampleRegistry directly for custom registrations.\n */\nexport const EXAMPLE_REGISTRY: readonly ExampleSpec[] = globalRegistry.list();\n\n/**\n * List all registered examples.\n */\nexport function listExamples(): readonly ExampleSpec[] {\n  return globalRegistry.list();\n}\n\n/**\n * Get an example by its key.\n */\nexport function getExample(key: string): ExampleSpec | undefined {\n  return globalRegistry.get(key);\n}\n\n/**\n * Search examples by query (matches key, title, description, tags).\n */\nexport function searchExamples(query: string): ExampleSpec[] {\n  return globalRegistry.search(query);\n}\n"],"mappings":";;;;;AAQA,MAAM,iBAAiB,IAAI,iBAAiB;AAG5C,KAAK,MAAM,WAAWA,mBACpB,gBAAe,SAAS,QAAQ;;;;;AAOlC,MAAaC,mBAA2C,eAAe,MAAM;;;;AAK7E,SAAgB,eAAuC;AACrD,QAAO,eAAe,MAAM;;;;;AAM9B,SAAgB,WAAW,KAAsC;AAC/D,QAAO,eAAe,IAAI,IAAI;;;;;AAMhC,SAAgB,eAAe,OAA8B;AAC3D,QAAO,eAAe,OAAO,MAAM"}

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@contractspec/module.examples",
-  "version": "1.44.0",
+  "version": "1.45.0",
+  "description": "Example contract specifications collection",
+  "keywords": [
+    "contractspec",
+    "examples",
+    "starter",
+    "templates",
+    "typescript"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,45 +31,45 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@contractspec/example.agent-console": "1.44.0",
-    "@contractspec/example.ai-support-bot": "1.44.0",
-    "@contractspec/example.analytics-dashboard": "1.44.0",
-    "@contractspec/example.content-generation": "1.44.0",
-    "@contractspec/example.crm-pipeline": "1.44.0",
-    "@contractspec/example.integration-hub": "1.44.0",
-    "@contractspec/example.integration-stripe": "1.44.0",
-    "@contractspec/example.kb-update-pipeline": "1.44.0",
-    "@contractspec/example.knowledge-canon": "1.44.0",
-    "@contractspec/example.learning-patterns": "1.44.0",
-    "@contractspec/example.learning-journey-ambient-coach": "1.44.0",
-    "@contractspec/example.learning-journey-crm-onboarding": "1.44.0",
-    "@contractspec/example.learning-journey-duo-drills": "1.44.0",
-    "@contractspec/example.learning-journey-platform-tour": "1.44.0",
-    "@contractspec/example.learning-journey-quest-challenges": "1.44.0",
-    "@contractspec/example.learning-journey-registry": "1.44.0",
-    "@contractspec/example.learning-journey-studio-onboarding": "1.44.0",
-    "@contractspec/example.learning-journey-ui-coaching": "1.44.0",
-    "@contractspec/example.learning-journey-ui-gamified": "1.44.0",
-    "@contractspec/example.learning-journey-ui-onboarding": "1.44.0",
-    "@contractspec/example.learning-journey-ui-shared": "1.44.0",
-    "@contractspec/example.lifecycle-cli": "1.44.0",
-    "@contractspec/example.lifecycle-dashboard": "1.44.0",
-    "@contractspec/example.locale-jurisdiction-gate": "1.44.0",
-    "@contractspec/example.marketplace": "1.44.0",
-    "@contractspec/example.openbanking-powens": "1.44.0",
-    "@contractspec/example.personalization": "1.44.0",
-    "@contractspec/example.policy-safe-knowledge-assistant": "1.44.0",
-    "@contractspec/example.saas-boilerplate": "1.44.0",
-    "@contractspec/example.service-business-os": "1.44.0",
-    "@contractspec/example.versioned-knowledge-base": "1.44.0",
-    "@contractspec/example.team-hub": "1.44.0",
-    "@contractspec/example.wealth-snapshot": "1.44.0",
-    "@contractspec/example.workflow-system": "1.44.0",
+    "@contractspec/example.agent-console": "1.45.0",
+    "@contractspec/example.ai-support-bot": "1.45.0",
+    "@contractspec/example.analytics-dashboard": "1.45.0",
+    "@contractspec/example.content-generation": "1.45.0",
+    "@contractspec/example.crm-pipeline": "1.45.0",
+    "@contractspec/example.integration-hub": "1.45.0",
+    "@contractspec/example.integration-stripe": "1.45.0",
+    "@contractspec/example.kb-update-pipeline": "1.45.0",
+    "@contractspec/example.knowledge-canon": "1.45.0",
+    "@contractspec/example.learning-patterns": "1.45.0",
+    "@contractspec/example.learning-journey-ambient-coach": "1.45.0",
+    "@contractspec/example.learning-journey-crm-onboarding": "1.45.0",
+    "@contractspec/example.learning-journey-duo-drills": "1.45.0",
+    "@contractspec/example.learning-journey-platform-tour": "1.45.0",
+    "@contractspec/example.learning-journey-quest-challenges": "1.45.0",
+    "@contractspec/example.learning-journey-registry": "1.45.0",
+    "@contractspec/example.learning-journey-studio-onboarding": "1.45.0",
+    "@contractspec/example.learning-journey-ui-coaching": "1.45.0",
+    "@contractspec/example.learning-journey-ui-gamified": "1.45.0",
+    "@contractspec/example.learning-journey-ui-onboarding": "1.45.0",
+    "@contractspec/example.learning-journey-ui-shared": "1.45.0",
+    "@contractspec/example.lifecycle-cli": "1.45.0",
+    "@contractspec/example.lifecycle-dashboard": "1.45.0",
+    "@contractspec/example.locale-jurisdiction-gate": "1.45.0",
+    "@contractspec/example.marketplace": "1.45.0",
+    "@contractspec/example.openbanking-powens": "1.45.0",
+    "@contractspec/example.personalization": "1.45.0",
+    "@contractspec/example.policy-safe-knowledge-assistant": "1.45.0",
+    "@contractspec/example.saas-boilerplate": "1.45.0",
+    "@contractspec/example.service-business-os": "1.45.0",
+    "@contractspec/example.versioned-knowledge-base": "1.45.0",
+    "@contractspec/example.team-hub": "1.45.0",
+    "@contractspec/example.wealth-snapshot": "1.45.0",
+    "@contractspec/example.workflow-system": "1.45.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.44.0",
-    "@contractspec/tool.typescript": "1.44.0",
+    "@contractspec/tool.tsdown": "1.45.0",
+    "@contractspec/tool.typescript": "1.45.0",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },