@contractspec/module.examples 1.44.1 → 1.45.0

package/dist/builtins.d.ts

@@ -1,7 +0,0 @@
-import { ExampleDefinition } from "./types.js";
-
-//#region src/builtins.d.ts
-declare const EXAMPLE_REGISTRY: readonly ExampleDefinition[];
-//#endregion
-export { EXAMPLE_REGISTRY };
-//# sourceMappingURL=builtins.d.ts.map

package/dist/builtins.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtins.d.ts","names":[],"sources":["../src/builtins.ts"],"sourcesContent":[],"mappings":";;;cAsCa,2BAA2B"}

package/dist/types.d.ts

@@ -1,53 +0,0 @@
-//#region src/types.d.ts
-type ExampleId = string;
-type ExampleKind = 'template' | 'workflow' | 'integration' | 'knowledge' | 'blueprint' | 'ui' | 'script' | 'library';
-type ExampleVisibility = 'public' | 'internal' | 'mixed';
-type ExampleSandboxMode = 'playground' | 'specs' | 'builder' | 'markdown' | 'evolution';
-interface ExampleDocRefs {
-  /** Canonical doc route id(s) in DocBlocks registry */
-  rootDocId?: string;
-  goalDocId?: string;
-  usageDocId?: string;
-  referenceDocId?: string;
-  constraintsDocId?: string;
-}
-interface ExampleSurfacesSupport {
-  templates: boolean;
-  sandbox: {
-    enabled: boolean;
-    modes: readonly ExampleSandboxMode[];
-  };
-  studio: {
-    enabled: boolean;
-    /** If true, Studio can create a real project from this example via API. */
-    installable: boolean;
-  };
-  mcp: {
-    enabled: boolean;
-  };
-}
-interface ExampleEntrypoints {
-  /** Package name in the monorepo (workspace) */
-  packageName: string;
-  /** Optional exports from the example package (strings are subpath exports). */
-  feature?: string;
-  presentations?: string;
-  contracts?: string;
-  handlers?: string;
-  ui?: string;
-  docs?: string;
-}
-interface ExampleDefinition {
-  id: ExampleId;
-  title: string;
-  summary: string;
-  tags: readonly string[];
-  kind: ExampleKind;
-  visibility: ExampleVisibility;
-  docs?: ExampleDocRefs;
-  entrypoints: ExampleEntrypoints;
-  surfaces: ExampleSurfacesSupport;
-}
-//#endregion
-export { ExampleDefinition, ExampleDocRefs, ExampleEntrypoints, ExampleId, ExampleKind, ExampleSandboxMode, ExampleSurfacesSupport, ExampleVisibility };
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,SAAA;AAAA,KAEA,WAAA,GAFS,UAAA,GAAA,UAAA,GAAA,aAAA,GAAA,WAAA,GAAA,WAAA,GAAA,IAAA,GAAA,QAAA,GAAA,SAAA;AAET,KAUA,iBAAA,GAVW,QAAA,GAAA,UAAA,GAAA,OAAA;AAUX,KAEA,kBAAA,GAFiB,YAAA,GAAA,OAAA,GAAA,SAAA,GAAA,UAAA,GAAA,WAAA;AAEjB,UAOK,cAAA,CAPa;EAOb;EASA,SAAA,CAAA,EAAA,MAAA;EAgBA,SAAA,CAAA,EAAA,MAAA;EAYA,UAAA,CAAA,EAAA,MAAA;EACX,cAAA,CAAA,EAAA,MAAA;EAIE,gBAAA,CAAA,EAAA,MAAA;;AAEC,UAnCQ,sBAAA,CAmCR;EACM,SAAA,EAAA,OAAA;EACH,OAAA,EAAA;IAAsB,OAAA,EAAA,OAAA;oBAjCd;;;;;;;;;;;UAYH,kBAAA;;;;;;;;;;;UAYA,iBAAA;MACX;;;;QAIE;cACM;SACL;eACM;YACH"}

package/dist/validate.d.ts

@@ -1,19 +0,0 @@
-import { ExampleDefinition } from "./types.js";
-
-//#region src/validate.d.ts
-interface ExampleValidationError {
-  exampleId?: string;
-  message: string;
-  path?: string;
-}
-type ValidateExamplesResult = {
-  ok: true;
-  examples: ExampleDefinition[];
-} | {
-  ok: false;
-  errors: ExampleValidationError[];
-};
-declare function validateExamples(examples: ExampleDefinition[]): ValidateExamplesResult;
-//#endregion
-export { ExampleValidationError, ValidateExamplesResult, validateExamples };
-//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.d.ts","names":[],"sources":["../src/validate.ts"],"sourcesContent":[],"mappings":";;;UAuDiB,sBAAA;;EAAA,OAAA,EAAA,MAAA;EAML,IAAA,CAAA,EAAA,MAAA;AAIZ;KAJY,sBAAA;;YACc;;;UACD;;iBAET,gBAAA,WACJ,sBACT"}

package/dist/validate.js

@@ -1,90 +0,0 @@
-import { z } from "zod";
-
-//#region src/validate.ts
-const ExampleDefinitionSchema = z.object({
-	id: z.string().min(1),
-	title: z.string().min(1),
-	summary: z.string().min(1),
-	tags: z.array(z.string()).default([]),
-	kind: z.enum([
-		"template",
-		"workflow",
-		"integration",
-		"knowledge",
-		"blueprint",
-		"ui",
-		"script",
-		"library"
-	]),
-	visibility: z.enum([
-		"public",
-		"internal",
-		"mixed"
-	]),
-	docs: z.object({
-		rootDocId: z.string().optional(),
-		goalDocId: z.string().optional(),
-		usageDocId: z.string().optional(),
-		referenceDocId: z.string().optional(),
-		constraintsDocId: z.string().optional()
-	}).optional(),
-	entrypoints: z.object({
-		packageName: z.string().min(1),
-		feature: z.string().optional(),
-		presentations: z.string().optional(),
-		contracts: z.string().optional(),
-		handlers: z.string().optional(),
-		ui: z.string().optional(),
-		docs: z.string().optional()
-	}),
-	surfaces: z.object({
-		templates: z.boolean(),
-		sandbox: z.object({
-			enabled: z.boolean(),
-			modes: z.array(z.enum([
-				"playground",
-				"specs",
-				"builder",
-				"markdown",
-				"evolution"
-			]))
-		}),
-		studio: z.object({
-			enabled: z.boolean(),
-			installable: z.boolean()
-		}),
-		mcp: z.object({ enabled: z.boolean() })
-	})
-});
-function validateExamples(examples) {
-	const errors = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const example of examples) {
-		if (seen.has(example.id)) {
-			errors.push({
-				exampleId: example.id,
-				message: `Duplicate example id: ${example.id}`
-			});
-			continue;
-		}
-		seen.add(example.id);
-		const parsed = ExampleDefinitionSchema.safeParse(example);
-		if (!parsed.success) for (const issue of parsed.error.issues) errors.push({
-			exampleId: example.id,
-			message: issue.message,
-			path: issue.path.join(".")
-		});
-	}
-	if (errors.length) return {
-		ok: false,
-		errors
-	};
-	return {
-		ok: true,
-		examples
-	};
-}
-
-//#endregion
-export { validateExamples };
-//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","names":["errors: ExampleValidationError[]"],"sources":["../src/validate.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { ExampleDefinition } from './types';\n\nconst ExampleDefinitionSchema = z.object({\n  id: z.string().min(1),\n  title: z.string().min(1),\n  summary: z.string().min(1),\n  tags: z.array(z.string()).default([]),\n  kind: z.enum([\n    'template',\n    'workflow',\n    'integration',\n    'knowledge',\n    'blueprint',\n    'ui',\n    'script',\n    'library',\n  ]),\n  visibility: z.enum(['public', 'internal', 'mixed']),\n  docs: z\n    .object({\n      rootDocId: z.string().optional(),\n      goalDocId: z.string().optional(),\n      usageDocId: z.string().optional(),\n      referenceDocId: z.string().optional(),\n      constraintsDocId: z.string().optional(),\n    })\n    .optional(),\n  entrypoints: z.object({\n    packageName: z.string().min(1),\n    feature: z.string().optional(),\n    presentations: z.string().optional(),\n    contracts: z.string().optional(),\n    handlers: z.string().optional(),\n    ui: z.string().optional(),\n    docs: z.string().optional(),\n  }),\n  surfaces: z.object({\n    templates: z.boolean(),\n    sandbox: z.object({\n      enabled: z.boolean(),\n      modes: z.array(\n        z.enum(['playground', 'specs', 'builder', 'markdown', 'evolution'])\n      ),\n    }),\n    studio: z.object({\n      enabled: z.boolean(),\n      installable: z.boolean(),\n    }),\n    mcp: z.object({\n      enabled: z.boolean(),\n    }),\n  }),\n});\n\nexport interface ExampleValidationError {\n  exampleId?: string;\n  message: string;\n  path?: string;\n}\n\nexport type ValidateExamplesResult =\n  | { ok: true; examples: ExampleDefinition[] }\n  | { ok: false; errors: ExampleValidationError[] };\n\nexport function validateExamples(\n  examples: ExampleDefinition[]\n): ValidateExamplesResult {\n  const errors: ExampleValidationError[] = [];\n\n  const seen = new Set<string>();\n  for (const example of examples) {\n    if (seen.has(example.id)) {\n      errors.push({\n        exampleId: example.id,\n        message: `Duplicate example id: ${example.id}`,\n      });\n      continue;\n    }\n    seen.add(example.id);\n\n    const parsed = ExampleDefinitionSchema.safeParse(example);\n    if (!parsed.success) {\n      for (const issue of parsed.error.issues) {\n        errors.push({\n          exampleId: example.id,\n          message: issue.message,\n          path: issue.path.join('.'),\n        });\n      }\n    }\n  }\n\n  if (errors.length) return { ok: false, errors };\n  return { ok: true, examples };\n}\n"],"mappings":";;;AAGA,MAAM,0BAA0B,EAAE,OAAO;CACvC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;CACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC1B,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CACrC,MAAM,EAAE,KAAK;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CACF,YAAY,EAAE,KAAK;EAAC;EAAU;EAAY;EAAQ,CAAC;CACnD,MAAM,EACH,OAAO;EACN,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,YAAY,EAAE,QAAQ,CAAC,UAAU;EACjC,gBAAgB,EAAE,QAAQ,CAAC,UAAU;EACrC,kBAAkB,EAAE,QAAQ,CAAC,UAAU;EACxC,CAAC,CACD,UAAU;CACb,aAAa,EAAE,OAAO;EACpB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;EAC9B,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,eAAe,EAAE,QAAQ,CAAC,UAAU;EACpC,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,UAAU,EAAE,QAAQ,CAAC,UAAU;EAC/B,IAAI,EAAE,QAAQ,CAAC,UAAU;EACzB,MAAM,EAAE,QAAQ,CAAC,UAAU;EAC5B,CAAC;CACF,UAAU,EAAE,OAAO;EACjB,WAAW,EAAE,SAAS;EACtB,SAAS,EAAE,OAAO;GAChB,SAAS,EAAE,SAAS;GACpB,OAAO,EAAE,MACP,EAAE,KAAK;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY,CAAC,CACpE;GACF,CAAC;EACF,QAAQ,EAAE,OAAO;GACf,SAAS,EAAE,SAAS;GACpB,aAAa,EAAE,SAAS;GACzB,CAAC;EACF,KAAK,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,EACrB,CAAC;EACH,CAAC;CACH,CAAC;AAYF,SAAgB,iBACd,UACwB;CACxB,MAAMA,SAAmC,EAAE;CAE3C,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,KAAK,IAAI,QAAQ,GAAG,EAAE;AACxB,UAAO,KAAK;IACV,WAAW,QAAQ;IACnB,SAAS,yBAAyB,QAAQ;IAC3C,CAAC;AACF;;AAEF,OAAK,IAAI,QAAQ,GAAG;EAEpB,MAAM,SAAS,wBAAwB,UAAU,QAAQ;AACzD,MAAI,CAAC,OAAO,QACV,MAAK,MAAM,SAAS,OAAO,MAAM,OAC/B,QAAO,KAAK;GACV,WAAW,QAAQ;GACnB,SAAS,MAAM;GACf,MAAM,MAAM,KAAK,KAAK,IAAI;GAC3B,CAAC;;AAKR,KAAI,OAAO,OAAQ,QAAO;EAAE,IAAI;EAAO;EAAQ;AAC/C,QAAO;EAAE,IAAI;EAAM;EAAU"}