@lssm/lib.contracts 1.41.0 → 1.42.1

package/dist/client/react/form-render.js

@@ -1 +1,298 @@
-import{buildZodWithRelations as e,evalPredicate as t}from"../../forms.js";import n,{useEffect as r,useMemo as i,useState as a}from"react";import{Controller as o,useFieldArray as s,useForm as c}from"react-hook-form";import{zodResolver as l}from"@hookform/resolvers/zod";import{Fragment as u,jsx as d,jsxs as f}from"react/jsx-runtime";function p(e){if(e)return Array.isArray(e)?{kind:`static`,options:e}:e}function m(e,t){if(!t)return;let n=t.replace(/\[(\d+)\]/g,`.$1`).split(`.`).filter(Boolean),r=e;for(let e of n){if(r==null)return;r=r[e]}return r}function h(e,t){if(!t||t.length===0)return`[]`;try{return JSON.stringify(t.map(t=>m(e,t)))}catch{return`[]`}}function g(e,t,n){let[o,s]=a([]);return r(()=>{let r=!0;return(async()=>{if(!t)return s([]);if(t.kind===`static`)return s([...t.options??[]]);let i=n?.[t.resolverKey];if(!i)return s([]);let a=await i(e,t.args);r&&s([...a??[]])})(),()=>{r=!1}},[i(()=>t?t.kind===`static`?JSON.stringify(t.options??[]):h(e,t.deps):`nil`,[t,e]),t&&t.resolverKey]),o}function _(e,t,n){if(!t)return e??``;let r=typeof n==`number`?`${t.replace(/^\$index$/,String(n))}`:t;return e?`${e}${typeof n==`number`?`.${n}`:``}.${r}`.replace(/\.+/g,`.`):r}function v(r){let a=r,{driver:m}=a;function h(r){let{spec:a,options:h,merged:v}=r,y=i(()=>e(a),[a]),b=c({...v.formOptions,resolver:l(y),defaultValues:h?.defaultValues}),x=b.watch(),S=(e,r,i)=>{let a=m.Field,s=m.FieldLabel,c=m.FieldDescription,l=m.FieldError,h=_(r,e.name,i),y=t(x,e.visibleWhen),w=t(x,e.enabledWhen),T=!!b.getFieldState(h)?.invalid;if(!y)return null;let E=h?.replace(/\./g,`-`),D={"data-invalid":T,hidden:!y,disabled:!w},O=e.labelI18n?d(s,{htmlFor:E,children:e.labelI18n}):null,k=e.descriptionI18n?d(c,{children:e.descriptionI18n}):null;if(e.kind===`group`){let t=e.fields.map((e,t)=>d(n.Fragment,{children:S(e,h,i)},`${h}-${t}`));return f(a,{...D,children:[O,t,k]})}return e.kind===`array`?C(e,r):d(o,{name:h,control:b.control,render:({field:t,fieldState:n})=>{let r=n.error?[n.error]:[],i=n.invalid||void 0;if(e.kind===`text`){let o=m.Input;return f(a,{...D,children:[O,d(o,{id:E,"aria-invalid":i,placeholder:e.placeholderI18n,autoComplete:e.autoComplete,inputMode:e.inputMode,maxLength:e.maxLength,minLength:e.minLength,disabled:!w,...t,...e.uiProps,keyboard:e.keyboard,autoComplete:e.keyboard?.autoComplete??e.autoComplete}),k,n.invalid?d(l,{errors:r}):null]})}if(e.kind===`textarea`){let o=m.Textarea;return f(a,{...D,children:[O,d(o,{id:E,"aria-invalid":i,placeholder:e.placeholderI18n,rows:e.rows,maxLength:e.maxLength,disabled:!w,...t,...e.uiProps,keyboard:e.keyboard,autoComplete:e.keyboard?.autoComplete??e.autoComplete}),k,n.invalid?d(l,{errors:r}):null]})}if(e.kind===`select`){let o=m.Select,s=g(x,p(e.options),v.resolvers);return f(a,{...D,children:[O,d(o,{id:E,name:h,"aria-invalid":i,disabled:!w,value:t.value,onChange:e=>t.onChange(e),options:s,...e.uiProps}),k,n.invalid?d(l,{errors:r}):null]})}if(e.kind===`checkbox`){let i=m.Checkbox;return f(a,{...D,children:[O,d(i,{id:E,name:h,disabled:!w,checked:!!t.value,onCheckedChange:e=>t.onChange(e),...e.uiProps}),k,n.invalid?d(l,{errors:r}):null]})}if(e.kind===`radio`){let i=m.RadioGroup,o=g(x,p(e.options),v.resolvers);return f(a,{...D,children:[O,d(i,{id:E,name:h,disabled:!w,value:t.value,onValueChange:e=>t.onChange(e),options:o,...e.uiProps}),k,n.invalid?d(l,{errors:r}):null]})}if(e.kind===`switch`){let i=m.Switch;return f(a,{...D,children:[O,d(i,{id:E,name:h,disabled:!w,checked:!!t.value,onCheckedChange:e=>t.onChange(e),...e.uiProps}),k,n.invalid?d(l,{errors:r}):null]})}return d(u,{})}},h)},C=(e,t)=>{let n=_(t,e.name),{fields:r,append:i,remove:a}=s({control:b.control,name:n}),o=e.max==null||r.length<e.max,c=t=>(e.min==null?r.length>0:r.length>e.min)&&t>=0,l=m.Button,u=m.FieldLabel;return f(`div`,{children:[e.labelI18n?d(u,{children:e.labelI18n}):null,r.map((t,r)=>f(`div`,{children:[S(e.of,n,r),c(r)?d(l,{type:`button`,variant:`ghost`,size:`sm`,onClick:()=>a(r),children:`Remove`}):null]},t.id??r)),o?d(l,{type:`button`,variant:`outline`,size:`sm`,onClick:()=>i({}),children:`Add`}):null]},n)},w=async e=>{let t=a.actions?.[0]?.key??`submit`;if(v.onSubmitOverride)return v.onSubmitOverride(e,t)},T=m.Button;return f(`form`,{onSubmit:b.handleSubmit(w),children:[(a.fields||[]).map((e,t)=>d(n.Fragment,{children:S(e)},t)),a.actions&&a.actions.length?d(`div`,{children:a.actions.map(e=>d(T,{type:`submit`,children:e.labelI18n},e.key))}):null]})}return{render:(e,t)=>d(h,{spec:e,options:t,merged:{...a,...t?.overrides??{}}})}}export{v as createFormRenderer};
+import { buildZodWithRelations, evalPredicate } from "../../forms/forms.js";
+import React, { useEffect, useMemo, useState } from "react";
+import { Controller, useFieldArray, useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/client/react/form-render.tsx
+function toOptionsArray(src) {
+	if (!src) return void 0;
+	if (Array.isArray(src)) return {
+		kind: "static",
+		options: src
+	};
+	return src;
+}
+function getAtPath(values, path) {
+	if (!path) return void 0;
+	const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let cur = values;
+	for (const s of segs) {
+		if (cur == null) return void 0;
+		cur = cur[s];
+	}
+	return cur;
+}
+function makeDepsKey(values, deps) {
+	if (!deps || deps.length === 0) return "[]";
+	try {
+		return JSON.stringify(deps.map((d) => getAtPath(values, d)));
+	} catch {
+		return "[]";
+	}
+}
+function useResolvedOptions(values, source, resolvers) {
+	const [opts, setOpts] = useState([]);
+	useEffect(() => {
+		let mounted = true;
+		const run = async () => {
+			if (!source) return setOpts([]);
+			if (source.kind === "static") return setOpts([...source.options ?? []]);
+			const fn = resolvers?.[source.resolverKey];
+			if (!fn) return setOpts([]);
+			const res = await fn(values, source.args);
+			if (mounted) setOpts([...res ?? []]);
+		};
+		run();
+		return () => {
+			mounted = false;
+		};
+	}, [useMemo(() => {
+		if (!source) return "nil";
+		if (source.kind === "static") return JSON.stringify(source.options ?? []);
+		return makeDepsKey(values, source.deps);
+	}, [source, values]), source && source.kind === "resolver" ? source.resolverKey : void 0]);
+	return opts;
+}
+function fieldPath(parent, name, arrayIndex) {
+	if (!name) return parent ?? "";
+	const child = typeof arrayIndex === "number" ? `${name.replace(/^\$index$/, String(arrayIndex))}` : name;
+	return parent ? `${parent}${typeof arrayIndex === "number" ? `.${arrayIndex}` : ""}.${child}`.replace(/\.+/g, ".") : child;
+}
+function createFormRenderer(base) {
+	const conf = base;
+	const { driver } = conf;
+	function InternalForm(props) {
+		const { spec, options, merged } = props;
+		const baseZod = useMemo(() => buildZodWithRelations(spec), [spec]);
+		const form = useForm({
+			...merged.formOptions,
+			resolver: zodResolver(baseZod),
+			defaultValues: options?.defaultValues
+		});
+		const values = form.watch();
+		const renderOne = (f, parent, arrayIndex) => {
+			const DriverField = driver.Field;
+			const DriverLabel = driver.FieldLabel;
+			const DriverDesc = driver.FieldDescription;
+			const DriverError = driver.FieldError;
+			const name = fieldPath(parent, f.name, arrayIndex);
+			const visible = evalPredicate(values, f.visibleWhen);
+			const enabled = evalPredicate(values, f.enabledWhen);
+			const invalid = Boolean(form.getFieldState(name)?.invalid);
+			if (!visible) return null;
+			const id = name?.replace(/\./g, "-");
+			const commonWrapProps = {
+				"data-invalid": invalid,
+				hidden: !visible,
+				disabled: !enabled
+			};
+			const labelNode = f.labelI18n ? /* @__PURE__ */ jsx(DriverLabel, {
+				htmlFor: id,
+				children: f.labelI18n
+			}) : null;
+			const descNode = f.descriptionI18n ? /* @__PURE__ */ jsx(DriverDesc, { children: f.descriptionI18n }) : null;
+			if (f.kind === "group") {
+				const children = f.fields.map((c, i) => /* @__PURE__ */ jsx(React.Fragment, { children: renderOne(c, name, arrayIndex) }, `${name}-${i}`));
+				return /* @__PURE__ */ jsxs(DriverField, {
+					...commonWrapProps,
+					children: [
+						labelNode,
+						children,
+						descNode
+					]
+				});
+			}
+			if (f.kind === "array") return renderArray(f, parent);
+			return /* @__PURE__ */ jsx(Controller, {
+				name,
+				control: form.control,
+				render: ({ field, fieldState }) => {
+					const err = fieldState.error ? [fieldState.error] : [];
+					const ariaInvalid = fieldState.invalid || void 0;
+					if (f.kind === "text") {
+						const textField = f;
+						const Input = driver.Input;
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(Input, {
+									id,
+									"aria-invalid": ariaInvalid,
+									placeholder: f.placeholderI18n,
+									autoComplete: textField.autoComplete,
+									inputMode: textField.inputMode,
+									maxLength: textField.maxLength,
+									minLength: textField.minLength,
+									disabled: !enabled,
+									...field,
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					if (f.kind === "textarea") {
+						const textareaField = f;
+						const Textarea = driver.Textarea;
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(Textarea, {
+									id,
+									"aria-invalid": ariaInvalid,
+									placeholder: f.placeholderI18n,
+									rows: textareaField.rows,
+									maxLength: textareaField.maxLength,
+									disabled: !enabled,
+									...field,
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					if (f.kind === "select") {
+						const selectField = f;
+						const Select = driver.Select;
+						const opts = useResolvedOptions(values, toOptionsArray(selectField.options), merged.resolvers);
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(Select, {
+									id,
+									name,
+									"aria-invalid": ariaInvalid,
+									disabled: !enabled,
+									value: field.value,
+									onChange: (v) => field.onChange(v),
+									options: opts,
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					if (f.kind === "checkbox") {
+						const Checkbox = driver.Checkbox;
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(Checkbox, {
+									id,
+									name,
+									disabled: !enabled,
+									checked: !!field.value,
+									onCheckedChange: (v) => field.onChange(v),
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					if (f.kind === "radio") {
+						const radioField = f;
+						const RadioGroup = driver.RadioGroup;
+						const opts = useResolvedOptions(values, toOptionsArray(radioField.options), merged.resolvers);
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(RadioGroup, {
+									id,
+									name,
+									disabled: !enabled,
+									value: field.value,
+									onValueChange: (v) => field.onChange(v),
+									options: opts,
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					if (f.kind === "switch") {
+						const Switch = driver.Switch;
+						return /* @__PURE__ */ jsxs(DriverField, {
+							...commonWrapProps,
+							children: [
+								labelNode,
+								/* @__PURE__ */ jsx(Switch, {
+									id,
+									name,
+									disabled: !enabled,
+									checked: !!field.value,
+									onCheckedChange: (v) => field.onChange(v),
+									...f.uiProps
+								}),
+								descNode,
+								fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
+							]
+						});
+					}
+					return /* @__PURE__ */ jsx(Fragment, {});
+				}
+			}, name);
+		};
+		const renderArray = (f, parent) => {
+			const name = fieldPath(parent, f.name);
+			const { fields, append, remove } = useFieldArray({
+				control: form.control,
+				name
+			});
+			const canAdd = f.max == null || fields.length < f.max;
+			const canRemove = (idx) => (f.min == null ? fields.length > 0 : fields.length > f.min) && idx >= 0;
+			const Button$1 = driver.Button;
+			const Label = driver.FieldLabel;
+			return /* @__PURE__ */ jsxs("div", { children: [
+				f.labelI18n ? /* @__PURE__ */ jsx(Label, { children: f.labelI18n }) : null,
+				fields.map((row, idx) => /* @__PURE__ */ jsxs("div", { children: [renderOne(f.of, name, idx), canRemove(idx) ? /* @__PURE__ */ jsx(Button$1, {
+					type: "button",
+					variant: "ghost",
+					size: "sm",
+					onClick: () => remove(idx),
+					children: "Remove"
+				}) : null] }, row.id ?? idx)),
+				canAdd ? /* @__PURE__ */ jsx(Button$1, {
+					type: "button",
+					variant: "outline",
+					size: "sm",
+					onClick: () => append({}),
+					children: "Add"
+				}) : null
+			] }, name);
+		};
+		const onSubmit = async (data) => {
+			const actionKey = spec.actions?.[0]?.key ?? "submit";
+			if (merged.onSubmitOverride) return merged.onSubmitOverride(data, actionKey);
+		};
+		const Button = driver.Button;
+		return /* @__PURE__ */ jsxs("form", {
+			onSubmit: form.handleSubmit(onSubmit),
+			children: [(spec.fields || []).map((f, i) => /* @__PURE__ */ jsx(React.Fragment, { children: renderOne(f) }, i)), spec.actions && spec.actions.length ? /* @__PURE__ */ jsx("div", { children: spec.actions.map((a) => /* @__PURE__ */ jsx(Button, {
+				type: "submit",
+				children: a.labelI18n
+			}, a.key)) }) : null]
+		});
+	}
+	return { render: (spec, options) => /* @__PURE__ */ jsx(InternalForm, {
+		spec,
+		options,
+		merged: {
+			...conf,
+			...options?.overrides ?? {}
+		}
+	}) };
+}
+
+//#endregion
+export { createFormRenderer };

package/dist/client/react/index.d.ts

@@ -0,0 +1,5 @@
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./feature-render.js";
+import { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer } from "./form-render.js";
+import { ShadcnDriver, shadcnDriver } from "./drivers/shadcn.js";
+import { RnReusablesDriver, rnReusablesDriver } from "./drivers/rn-reusables.js";
+export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, RnReusablesDriver, ShadcnDriver, createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };

package/dist/client/react/index.js

@@ -1 +1,8 @@
-"use client";import{createEngineWithDefaults as e,createFeatureModule as t,registerFeature as n,renderFeaturePresentation as r}from"./feature-render.js";import{createFormRenderer as i}from"./form-render.js";import{shadcnDriver as a}from"./drivers/shadcn.js";import{rnReusablesDriver as o}from"./drivers/rn-reusables.js";export{e as createEngineWithDefaults,t as createFeatureModule,i as createFormRenderer,n as registerFeature,r as renderFeaturePresentation,o as rnReusablesDriver,a as shadcnDriver};
+'use client';
+
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./feature-render.js";
+import { createFormRenderer } from "./form-render.js";
+import { shadcnDriver } from "./drivers/shadcn.js";
+import { rnReusablesDriver } from "./drivers/rn-reusables.js";
+
+export { createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };

package/dist/contract-registry/index.d.ts

@@ -0,0 +1,3 @@
+import { ContractRegistryFile, ContractRegistryItem, ContractRegistryItemType, ContractRegistryManifest, JsonSchema } from "./types.js";
+import { ContractRegistryFileSchema, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestParsed, ContractRegistryManifestSchema } from "./schemas.js";
+export { type ContractRegistryFile, ContractRegistryFileSchema, type ContractRegistryItem, type ContractRegistryItemParsed, ContractRegistryItemSchema, type ContractRegistryItemType, ContractRegistryItemTypeSchema, type ContractRegistryManifest, type ContractRegistryManifestParsed, ContractRegistryManifestSchema, type JsonSchema };

package/dist/contract-registry/index.js

@@ -1 +1,3 @@
-import{ContractRegistryFileSchema as e,ContractRegistryItemSchema as t,ContractRegistryItemTypeSchema as n,ContractRegistryManifestSchema as r}from"./schemas.js";export{e as ContractRegistryFileSchema,t as ContractRegistryItemSchema,n as ContractRegistryItemTypeSchema,r as ContractRegistryManifestSchema};
+import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema } from "./schemas.js";
+
+export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema };

package/dist/contract-registry/schemas.d.ts

@@ -0,0 +1,124 @@
+import { ContractRegistryItem, ContractRegistryManifest } from "./types.js";
+import z from "zod";
+
+//#region src/contract-registry/schemas.d.ts
+declare const ContractRegistryItemTypeSchema: z.ZodEnum<{
+  "contractspec:operation": "contractspec:operation";
+  "contractspec:event": "contractspec:event";
+  "contractspec:presentation": "contractspec:presentation";
+  "contractspec:form": "contractspec:form";
+  "contractspec:feature": "contractspec:feature";
+  "contractspec:workflow": "contractspec:workflow";
+  "contractspec:template": "contractspec:template";
+  "contractspec:integration": "contractspec:integration";
+  "contractspec:data-view": "contractspec:data-view";
+  "contractspec:migration": "contractspec:migration";
+  "contractspec:telemetry": "contractspec:telemetry";
+  "contractspec:experiment": "contractspec:experiment";
+  "contractspec:app-config": "contractspec:app-config";
+  "contractspec:knowledge": "contractspec:knowledge";
+}>;
+declare const ContractRegistryFileSchema: z.ZodObject<{
+  path: z.ZodString;
+  type: z.ZodString;
+  content: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ContractRegistryItemSchema: z.ZodObject<{
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    "contractspec:operation": "contractspec:operation";
+    "contractspec:event": "contractspec:event";
+    "contractspec:presentation": "contractspec:presentation";
+    "contractspec:form": "contractspec:form";
+    "contractspec:feature": "contractspec:feature";
+    "contractspec:workflow": "contractspec:workflow";
+    "contractspec:template": "contractspec:template";
+    "contractspec:integration": "contractspec:integration";
+    "contractspec:data-view": "contractspec:data-view";
+    "contractspec:migration": "contractspec:migration";
+    "contractspec:telemetry": "contractspec:telemetry";
+    "contractspec:experiment": "contractspec:experiment";
+    "contractspec:app-config": "contractspec:app-config";
+    "contractspec:knowledge": "contractspec:knowledge";
+  }>;
+  version: z.ZodNumber;
+  title: z.ZodString;
+  description: z.ZodString;
+  meta: z.ZodObject<{
+    stability: z.ZodEnum<{
+      idea: "idea";
+      in_creation: "in_creation";
+      experimental: "experimental";
+      beta: "beta";
+      stable: "stable";
+      deprecated: "deprecated";
+    }>;
+    owners: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>;
+  dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  schema: z.ZodOptional<z.ZodObject<{
+    input: z.ZodOptional<z.ZodUnknown>;
+    output: z.ZodOptional<z.ZodUnknown>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ContractRegistryManifestSchema: z.ZodObject<{
+  $schema: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  homepage: z.ZodOptional<z.ZodString>;
+  items: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodEnum<{
+      "contractspec:operation": "contractspec:operation";
+      "contractspec:event": "contractspec:event";
+      "contractspec:presentation": "contractspec:presentation";
+      "contractspec:form": "contractspec:form";
+      "contractspec:feature": "contractspec:feature";
+      "contractspec:workflow": "contractspec:workflow";
+      "contractspec:template": "contractspec:template";
+      "contractspec:integration": "contractspec:integration";
+      "contractspec:data-view": "contractspec:data-view";
+      "contractspec:migration": "contractspec:migration";
+      "contractspec:telemetry": "contractspec:telemetry";
+      "contractspec:experiment": "contractspec:experiment";
+      "contractspec:app-config": "contractspec:app-config";
+      "contractspec:knowledge": "contractspec:knowledge";
+    }>;
+    version: z.ZodNumber;
+    title: z.ZodString;
+    description: z.ZodString;
+    meta: z.ZodObject<{
+      stability: z.ZodEnum<{
+        idea: "idea";
+        in_creation: "in_creation";
+        experimental: "experimental";
+        beta: "beta";
+        stable: "stable";
+        deprecated: "deprecated";
+      }>;
+      owners: z.ZodDefault<z.ZodArray<z.ZodString>>;
+      tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      type: z.ZodString;
+      content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    schema: z.ZodOptional<z.ZodObject<{
+      input: z.ZodOptional<z.ZodUnknown>;
+      output: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ContractRegistryItemParsed = z.infer<typeof ContractRegistryItemSchema> & ContractRegistryItem;
+type ContractRegistryManifestParsed = z.infer<typeof ContractRegistryManifestSchema> & ContractRegistryManifest;
+//#endregion
+export { ContractRegistryFileSchema, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestParsed, ContractRegistryManifestSchema };

package/dist/contract-registry/schemas.js

@@ -1 +1,61 @@
-import{StabilityEnum as e}from"../ownership.js";import t from"zod";const n=t.enum([`contractspec:operation`,`contractspec:event`,`contractspec:presentation`,`contractspec:form`,`contractspec:feature`,`contractspec:workflow`,`contractspec:template`,`contractspec:integration`,`contractspec:data-view`,`contractspec:migration`,`contractspec:telemetry`,`contractspec:experiment`,`contractspec:app-config`,`contractspec:knowledge`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()}),a=t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});export{r as ContractRegistryFileSchema,i as ContractRegistryItemSchema,n as ContractRegistryItemTypeSchema,a as ContractRegistryManifestSchema};
+import { StabilityEnum } from "../ownership.js";
+import z from "zod";
+
+//#region src/contract-registry/schemas.ts
+const ContractRegistryItemTypeValues = [
+	"contractspec:operation",
+	"contractspec:event",
+	"contractspec:presentation",
+	"contractspec:form",
+	"contractspec:feature",
+	"contractspec:workflow",
+	"contractspec:template",
+	"contractspec:integration",
+	"contractspec:data-view",
+	"contractspec:migration",
+	"contractspec:telemetry",
+	"contractspec:experiment",
+	"contractspec:app-config",
+	"contractspec:knowledge"
+];
+const ContractRegistryItemTypeSchema = z.enum(ContractRegistryItemTypeValues);
+const ContractRegistryFileSchema = z.object({
+	path: z.string().min(1),
+	type: z.string().min(1),
+	content: z.string().optional()
+});
+const ContractRegistryItemSchema = z.object({
+	key: z.string().min(1),
+	type: ContractRegistryItemTypeSchema,
+	version: z.number().int().nonnegative(),
+	title: z.string().min(1),
+	description: z.string().min(1),
+	meta: z.object({
+		stability: z.enum([
+			StabilityEnum.Idea,
+			StabilityEnum.InCreation,
+			StabilityEnum.Experimental,
+			StabilityEnum.Beta,
+			StabilityEnum.Stable,
+			StabilityEnum.Deprecated
+		]),
+		owners: z.array(z.string().min(1)).default([]),
+		tags: z.array(z.string().min(1)).default([])
+	}),
+	dependencies: z.array(z.string().min(1)).optional(),
+	registryDependencies: z.array(z.string().min(1)).optional(),
+	files: z.array(ContractRegistryFileSchema).min(1),
+	schema: z.object({
+		input: z.unknown().optional(),
+		output: z.unknown().optional()
+	}).optional()
+});
+const ContractRegistryManifestSchema = z.object({
+	$schema: z.string().min(1).optional(),
+	name: z.string().min(1),
+	homepage: z.string().min(1).optional(),
+	items: z.array(ContractRegistryItemSchema)
+});
+
+//#endregion
+export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema };

package/dist/contract-registry/types.d.ts

@@ -0,0 +1,46 @@
+import { Owner, Stability, Tag } from "../ownership.js";
+
+//#region src/contract-registry/types.d.ts
+type ContractRegistryItemType = 'contractspec:operation' | 'contractspec:event' | 'contractspec:presentation' | 'contractspec:form' | 'contractspec:feature' | 'contractspec:workflow' | 'contractspec:template' | 'contractspec:integration' | 'contractspec:data-view' | 'contractspec:migration' | 'contractspec:telemetry' | 'contractspec:experiment' | 'contractspec:app-config' | 'contractspec:knowledge';
+type JsonSchema = unknown;
+interface ContractRegistryFile {
+  /** Path relative to the registry project root */
+  path: string;
+  /**
+   * File classification (kept open-ended to remain ejectable and compatible
+   * with multiple consumers).
+   *
+   * Examples: 'registry:component', 'contractspec:spec', 'registry:lib'
+   */
+  type: string;
+  /** Optional inline content (if serving without file hosting) */
+  content?: string;
+}
+interface ContractRegistryItem {
+  key: string;
+  type: ContractRegistryItemType;
+  version: number;
+  title: string;
+  description: string;
+  meta: {
+    stability: Stability;
+    owners: Owner[];
+    tags: Tag[];
+  };
+  dependencies?: string[];
+  registryDependencies?: string[];
+  files: ContractRegistryFile[];
+  schema?: {
+    input?: JsonSchema;
+    output?: JsonSchema;
+  };
+}
+interface ContractRegistryManifest {
+  /** Optional JSON-schema reference for tooling */
+  $schema?: string;
+  name: string;
+  homepage?: string;
+  items: ContractRegistryItem[];
+}
+//#endregion
+export { ContractRegistryFile, ContractRegistryItem, ContractRegistryItemType, ContractRegistryManifest, JsonSchema };