@lssm/lib.contracts 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/dist/contracts-adapter-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-adapter-input.js","names":["acc: Record<string, unknown>","typeName"],"sources":["../src/contracts-adapter-input.ts"],"sourcesContent":["import type {\n  AnyEnumType,\n  AnyFieldType,\n  AnySchemaModel,\n} from '@lssm/lib.schema';\nimport type { SchemaTypes } from '@pothos/core';\n\nexport function isSchemaModel(x: unknown): x is AnySchemaModel {\n  return (\n    typeof (x as AnySchemaModel | undefined)?.getPothosInput === 'function' &&\n    typeof (x as AnySchemaModel | undefined)?.getZod === 'function'\n  );\n}\n\ninterface PothosNamed {\n  getPothos: () => { name: string };\n}\nfunction isFieldType(\n  x: unknown\n): x is AnyFieldType | AnyEnumType | PothosNamed {\n  return typeof (x as { getPothos?: unknown })?.getPothos === 'function';\n}\n\nfunction isEnumType(x: unknown): x is AnyEnumType {\n  return (\n    typeof (x as { getEnumValues?: unknown })?.getEnumValues === 'function' &&\n    typeof (x as { getPothos?: unknown })?.getPothos === 'function'\n  );\n}\n\nfunction mapScalarName(name: string): string {\n  if (name === 'Boolean_unsecure') return 'Boolean';\n  if (name === 'ID_unsecure') return 'ID';\n  if (name === 'String_unsecure') return 'String';\n  if (name === 'Int_unsecure') return 'Int';\n  if (name === 'Float_unsecure') return 'Float';\n  return name;\n}\n\nexport function createInputTypeBuilder<T extends SchemaTypes>(\n  builder: PothosSchemaTypes.SchemaBuilder<T>\n) {\n  const inputTypeCache = new Map<string, unknown>();\n  const enumTypeCache = new Set<string>();\n\n  function registerEnumsForModel(model: AnySchemaModel) {\n    const entries = Object.entries(model.config.fields) as [\n      string,\n      {\n        type:\n          | AnySchemaModel['config']['fields'][string]['type']\n          | AnySchemaModel;\n        isOptional: boolean;\n        isArray?: boolean;\n      },\n    ][];\n    for (const [, field] of entries) {\n      if (isSchemaModel(field.type as unknown)) {\n        registerEnumsForModel(field.type as unknown as AnySchemaModel);\n      } else if (isEnumType((field as { type: unknown }).type)) {\n        const enumObj = field.type as unknown as AnyEnumType;\n        const name =\n          (enumObj as { getName?: () => string }).getName?.() ??\n          enumObj.getPothos().name;\n        if (!enumTypeCache.has(name)) {\n          builder.enumType(name as any, {\n            values: enumObj.getEnumValues() as any,\n          });\n          enumTypeCache.add(name);\n        }\n      }\n    }\n  }\n\n  function ensureInputTypeForModel(model: AnySchemaModel) {\n    const typeName = String(model.config?.name ?? 'Input');\n    const cached = inputTypeCache.get(typeName) as unknown;\n    if (cached) return cached;\n    // Pre-register any enum types used within this model (including nested models)\n    registerEnumsForModel(model);\n    const created = builder.inputType(model.getPothosInput(), {\n      fields: (t) => {\n        const entries = Object.entries(model.config.fields) as [\n          string,\n          {\n            type:\n              | AnySchemaModel['config']['fields'][string]['type']\n              | AnySchemaModel;\n            isOptional: boolean;\n            isArray?: boolean;\n          },\n        ][];\n        const acc: Record<string, unknown> = {};\n        for (const [key, field] of entries) {\n          if (isSchemaModel(field.type as unknown)) {\n            const nested = ensureInputTypeForModel(\n              field.type as unknown as AnySchemaModel\n            );\n            const typeRef = field.isArray\n              ? ([nested] as never)\n              : (nested as never);\n            acc[key] = t.field({\n              type: typeRef,\n              required: !field.isOptional,\n            });\n          } else if (isFieldType((field as { type: unknown }).type)) {\n            const typeName = mapScalarName(\n              String((field.type as PothosNamed).getPothos().name)\n            );\n            const typeRef = field.isArray\n              ? ([typeName] as never)\n              : (typeName as never);\n            acc[key] = t.field({\n              type: typeRef,\n              required: !field.isOptional,\n            });\n          } else {\n            const typeRef = field.isArray\n              ? (['JSON'] as never)\n              : ('JSON' as never);\n            acc[key] = t.field({\n              type: typeRef,\n              required: !field.isOptional,\n            });\n          }\n        }\n        return acc as never;\n      },\n    });\n    inputTypeCache.set(typeName, created);\n    return created;\n  }\n\n  function buildInputFieldArgs(model: AnySchemaModel | null) {\n    if (!model) return null;\n    if (\n      !model.config?.fields ||\n      Object.keys(model.config.fields).length === 0\n    ) {\n      return null;\n    }\n    const ref = ensureInputTypeForModel(model);\n    return ref as never;\n  }\n\n  return { buildInputFieldArgs };\n}\n"],"mappings":";AAOA,SAAgB,cAAc,GAAiC;AAC7D,QACE,OAAQ,GAAkC,mBAAmB,cAC7D,OAAQ,GAAkC,WAAW;;AAOzD,SAAS,YACP,GAC+C;AAC/C,QAAO,OAAQ,GAA+B,cAAc;;AAG9D,SAAS,WAAW,GAA8B;AAChD,QACE,OAAQ,GAAmC,kBAAkB,cAC7D,OAAQ,GAA+B,cAAc;;AAIzD,SAAS,cAAc,MAAsB;AAC3C,KAAI,SAAS,mBAAoB,QAAO;AACxC,KAAI,SAAS,cAAe,QAAO;AACnC,KAAI,SAAS,kBAAmB,QAAO;AACvC,KAAI,SAAS,eAAgB,QAAO;AACpC,KAAI,SAAS,iBAAkB,QAAO;AACtC,QAAO;;AAGT,SAAgB,uBACd,SACA;CACA,MAAM,iCAAiB,IAAI,KAAsB;CACjD,MAAM,gCAAgB,IAAI,KAAa;CAEvC,SAAS,sBAAsB,OAAuB;EACpD,MAAM,UAAU,OAAO,QAAQ,MAAM,OAAO,OAAO;AAUnD,OAAK,MAAM,GAAG,UAAU,QACtB,KAAI,cAAc,MAAM,KAAgB,CACtC,uBAAsB,MAAM,KAAkC;WACrD,WAAY,MAA4B,KAAK,EAAE;GACxD,MAAM,UAAU,MAAM;GACtB,MAAM,OACH,QAAuC,WAAW,IACnD,QAAQ,WAAW,CAAC;AACtB,OAAI,CAAC,cAAc,IAAI,KAAK,EAAE;AAC5B,YAAQ,SAAS,MAAa,EAC5B,QAAQ,QAAQ,eAAe,EAChC,CAAC;AACF,kBAAc,IAAI,KAAK;;;;CAM/B,SAAS,wBAAwB,OAAuB;EACtD,MAAM,WAAW,OAAO,MAAM,QAAQ,QAAQ,QAAQ;EACtD,MAAM,SAAS,eAAe,IAAI,SAAS;AAC3C,MAAI,OAAQ,QAAO;AAEnB,wBAAsB,MAAM;EAC5B,MAAM,UAAU,QAAQ,UAAU,MAAM,gBAAgB,EAAE,EACxD,SAAS,MAAM;GACb,MAAM,UAAU,OAAO,QAAQ,MAAM,OAAO,OAAO;GAUnD,MAAMA,MAA+B,EAAE;AACvC,QAAK,MAAM,CAAC,KAAK,UAAU,QACzB,KAAI,cAAc,MAAM,KAAgB,EAAE;IACxC,MAAM,SAAS,wBACb,MAAM,KACP;IACD,MAAM,UAAU,MAAM,UACjB,CAAC,OAAO,GACR;AACL,QAAI,OAAO,EAAE,MAAM;KACjB,MAAM;KACN,UAAU,CAAC,MAAM;KAClB,CAAC;cACO,YAAa,MAA4B,KAAK,EAAE;IACzD,MAAMC,aAAW,cACf,OAAQ,MAAM,KAAqB,WAAW,CAAC,KAAK,CACrD;IACD,MAAM,UAAU,MAAM,UACjB,CAACA,WAAS,GACVA;AACL,QAAI,OAAO,EAAE,MAAM;KACjB,MAAM;KACN,UAAU,CAAC,MAAM;KAClB,CAAC;UACG;IACL,MAAM,UAAU,MAAM,UACjB,CAAC,OAAO,GACR;AACL,QAAI,OAAO,EAAE,MAAM;KACjB,MAAM;KACN,UAAU,CAAC,MAAM;KAClB,CAAC;;AAGN,UAAO;KAEV,CAAC;AACF,iBAAe,IAAI,UAAU,QAAQ;AACrC,SAAO;;CAGT,SAAS,oBAAoB,OAA8B;AACzD,MAAI,CAAC,MAAO,QAAO;AACnB,MACE,CAAC,MAAM,QAAQ,UACf,OAAO,KAAK,MAAM,OAAO,OAAO,CAAC,WAAW,EAE5C,QAAO;AAGT,SADY,wBAAwB,MAAM;;AAI5C,QAAO,EAAE,qBAAqB"}

package/dist/data-views/docs/data-views.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/data-views/docs/data-views.docblock.d.ts
 declare const tech_contracts_data_views_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_data_views_DocBlocks };
+export { tech_contracts_data_views_DocBlocks };
+//# sourceMappingURL=data-views.docblock.d.ts.map

package/dist/data-views/docs/data-views.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.docblock.d.ts","names":[],"sources":["../../../src/data-views/docs/data-views.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,qCAAqC"}

package/dist/data-views/docs/data-views.docblock.js

@@ -19,4 +19,5 @@ const tech_contracts_data_views_DocBlocks = [{
 registerDocBlocks(tech_contracts_data_views_DocBlocks);
 
 //#endregion
-export { tech_contracts_data_views_DocBlocks };
+export { tech_contracts_data_views_DocBlocks };
+//# sourceMappingURL=data-views.docblock.js.map

package/dist/data-views/docs/data-views.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.docblock.js","names":["tech_contracts_data_views_DocBlocks: DocBlock[]"],"sources":["../../../src/data-views/docs/data-views.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_data_views_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.data-views',\n    title: 'DataViewSpec Overview',\n    summary:\n      '`DataViewSpec` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (`source.primary`, `source.item`) and describes how the UI should present, sort, and filter records. Host applications use the spec to render UI with shared components (`DataViewRenderer`, `DataViewList`, `DataViewTable`, `DataViewDetail`) while keeping presentation logic in a single source of truth.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/data-views',\n    tags: ['tech', 'contracts', 'data-views'],\n    body: \"# DataViewSpec Overview\\n\\n## Purpose\\n\\n`DataViewSpec` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (`source.primary`, `source.item`) and describes how the UI should present, sort, and filter records. Host applications use the spec to render UI with shared components (`DataViewRenderer`, `DataViewList`, `DataViewTable`, `DataViewDetail`) while keeping presentation logic in a single source of truth.\\n\\n## Location\\n\\n- Type definitions and registry: `packages/libs/contracts/src/data-views.ts`\\n- React renderers: `packages/libs/design-system/src/components/data-view`\\n- CLI scaffolding: `contractspec create --type data-view`\\n\\n## Schema Highlights\\n\\n```ts\\nexport interface DataViewSpec {\\n  meta: DataViewMeta;       // ownership meta + { name, version, entity }\\n  source: DataViewSource;   // contract operations and refresh events\\n  view: DataViewConfig;     // union of list/detail/table/grid definitions\\n  states?: DataViewStates;  // optional empty/error/loading presentations\\n  policy?: { flags?: string[]; pii?: string[] };\\n}\\n```\\n\\n- **DataViewMeta**: `name`, `version`, `entity`, ownership metadata (title, description, domain, owners, tags, stability).\\n- **DataViewSource**:\\n  - `primary`: required query operation (`OpRef`) for fetching collections.\\n  - `item`: optional detail query (recommended for `detail` views).\\n  - `mutations`: optional create/update/delete operation refs.\\n  - `refreshEvents`: events that should trigger refresh.\\n- **DataViewConfig** (union):\\n  - `list`: card/compact list, `primaryField`, `secondaryFields`.\\n  - `table`: column configuration (`columns`, alignments, density).\\n  - `detail`: sections of fields for record inspection.\\n  - `grid`: multi-column grid (rendered as card list today).\\n- **DataViewField**: `key`, `label`, `dataPath`, formatting hints (`format`), sort/filter toggles, optional presentation override.\\n- **DataViewFilter**: describes filter inputs (search, enum, number, date, boolean).\\n- **DataViewAction**: simple declarative actions (`navigation` or `operation`).\\n\\n## Registry Usage\\n\\n```ts\\nimport { DataViewRegistry } from '@lssm/lib.contracts/data-views';\\nimport { ResidentsDataView } from './data-views/residents.data-view';\\n\\nconst registry = new DataViewRegistry();\\nregistry.register(ResidentsDataView);\\n\\nconst listView = registry.get('residents.admin.list');\\n```\\n\\nRegistries guard against duplicate `(name, version)` pairs and make latest-version lookup trivial.\\n\\n## Rendering\\n\\n```tsx\\nimport { DataViewRenderer } from '@lssm/lib.design-system';\\nimport { ResidentsDataView } from '../contracts/data-views/residents.data-view';\\n\\nfunction ResidentsTable({ rows }: { rows: Record<string, unknown>[] }) {\\n  return (\\n    <DataViewRenderer\\n      spec={ResidentsDataView}\\n      items={rows}\\n      onRowClick={(row) => console.log('Selected', row)}\\n    />\\n  );\\n}\\n```\\n\\nFor more control, use specific components:\\n\\n- `DataViewList` \\u2013 friendly cards/rows\\n- `DataViewTable` \\u2013 tabular presentation with optional header/footers\\n- `DataViewDetail` \\u2013 two-column grouped layout for record inspection\\n\\nRenderers rely on the field definitions (`dataPath`, `format`) to extract values and render them consistently.\\n\\n## CLI Scaffolding\\n\\n```bash\\n# Interactive wizard\\ncontractspec create --type data-view\\n\\n# Generates packages/.../data-views/<name>.data-view.ts\\n\\n# Optional renderer scaffold\\ncontractspec build path/to/<name>.data-view.ts\\n# \\u2192 produces <name>.renderer.tsx that wraps DataViewRenderer with sensible props\\n```\\n\\nWizard prompts:\\n- name (dot notation), version, entity\\n- kind (`list`, `table`, `detail`, `grid`)\\n- primary query operation (required) and optional item query\\n- fields (label, data path, format, sorting/filtering)\\n\\n## Authoring Guidelines\\n\\n1. **Separation of data & presentation**: keep fetching logic inside contract operations; DataViewSpec only references them via `source`.\\n2. **Versioning**: bump `meta.version` when field membership, ordering, or semantics change.\\n3. **Consistency**: reuse common field keys across modules to enable shared renderers and filters.\\n4. **States**: reference `PresentationRef` for empty/error/loader states to ensure consistent UX.\\n5. **Actions**: prefer referencing contract operations instead of embedding business logic in the UI.\\n\\n## Roadmap\\n\\n- Derived filters from `fields.filterable` (auto-generated UI).\\n- Table density presets per platform.\\n- Bridge to PolicySpec for field-level visibility (Phase 2 policy expansion).\\n- Automated docs/LLM sync via CLI.\\n\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_data_views_DocBlocks);\n"],"mappings":";;;;AAGA,MAAaA,sCAAkD,CAC7D;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAa;CACzC,MAAM;CACP,CACF;AACD,kBAAkB,oCAAoC"}

package/dist/data-views/query-generator.d.ts

@@ -36,4 +36,5 @@ declare class DataViewQueryGenerator {
   validateParams(params: DataViewQueryParams): string[];
 }
 //#endregion
-export { DataViewQuery, DataViewQueryGenerator, DataViewQueryParams };
+export { DataViewQuery, DataViewQueryGenerator, DataViewQueryParams };
+//# sourceMappingURL=query-generator.d.ts.map

package/dist/data-views/query-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-generator.d.ts","names":[],"sources":["../../src/data-views/query-generator.ts"],"sourcesContent":[],"mappings":";;;UAEiB,mBAAA;YACL;EADK,IAAA,CAAA,EAAA;IAOA,KAAA,EAAA,MAAa;IASjB,SAAA,EAAA,KAAA,GAAA,MAAsB;EACP,CAAA;EAET,UAAA,CAAA,EAAA;IAAsB,IAAA,EAAA,MAAA;IAiChB,QAAA,EAAA,MAAA;EAAmB,CAAA;;;UA7C3B,aAAA;;SAER;;;;;;;;;;;;;;cAOI,sBAAA;;oBACe;mBAET,sBAAsB;yBAiChB"}

package/dist/data-views/query-generator.js

@@ -45,4 +45,5 @@ var DataViewQueryGenerator = class {
 };
 
 //#endregion
-export { DataViewQueryGenerator };
+export { DataViewQueryGenerator };
+//# sourceMappingURL=query-generator.js.map

package/dist/data-views/query-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-generator.js","names":["spec: DataViewSpec","input: Record<string, any>","errors: string[]"],"sources":["../../src/data-views/query-generator.ts"],"sourcesContent":["import type { DataViewSpec } from '../data-views';\n\nexport interface DataViewQueryParams {\n  filters?: Record<string, any>;\n  sort?: { field: string; direction: 'asc' | 'desc' };\n  pagination?: { page: number; pageSize: number };\n  search?: string;\n}\n\nexport interface DataViewQuery {\n  operationName: string;\n  input: Record<string, any>;\n  meta: {\n    pagination: { page: number; pageSize: number; skip: number; take: number };\n    sorting?: { field: string; direction: 'asc' | 'desc' };\n  };\n}\n\nexport class DataViewQueryGenerator {\n  constructor(private spec: DataViewSpec) {}\n\n  generate(params: DataViewQueryParams): DataViewQuery {\n    const { primary } = this.spec.source;\n    const page = params.pagination?.page ?? 1;\n    const pageSize = params.pagination?.pageSize ?? 20;\n    const skip = (page - 1) * pageSize;\n    const take = pageSize;\n\n    const input: Record<string, any> = {\n      skip,\n      take,\n      ...params.filters,\n    };\n\n    if (params.search) {\n      input.search = params.search;\n    }\n\n    if (params.sort) {\n      input.orderBy = {\n        [params.sort.field]: params.sort.direction,\n      };\n    }\n\n    return {\n      operationName: primary.name,\n      input,\n      meta: {\n        pagination: { page, pageSize, skip, take },\n        sorting: params.sort,\n      },\n    };\n  }\n\n  validateParams(params: DataViewQueryParams): string[] {\n    const errors: string[] = [];\n\n    // Validate filters against spec\n    if (params.filters && this.spec.view.filters) {\n      for (const key of Object.keys(params.filters)) {\n        const defined = this.spec.view.filters.find((f) => f.key === key);\n        if (!defined) {\n          errors.push(`Unknown filter key: ${key}`);\n        }\n      }\n    }\n\n    // Validate sort field\n    if (params.sort) {\n      const field = this.spec.view.fields.find(\n        (f) => f.key === params.sort!.field\n      );\n      if (!field) {\n        errors.push(`Unknown sort field: ${params.sort.field}`);\n      } else if (field.sortable === false) {\n        errors.push(`Field is not sortable: ${params.sort.field}`);\n      }\n    }\n\n    return errors;\n  }\n}\n"],"mappings":";AAkBA,IAAa,yBAAb,MAAoC;CAClC,YAAY,AAAQA,MAAoB;EAApB;;CAEpB,SAAS,QAA4C;EACnD,MAAM,EAAE,YAAY,KAAK,KAAK;EAC9B,MAAM,OAAO,OAAO,YAAY,QAAQ;EACxC,MAAM,WAAW,OAAO,YAAY,YAAY;EAChD,MAAM,QAAQ,OAAO,KAAK;EAC1B,MAAM,OAAO;EAEb,MAAMC,QAA6B;GACjC;GACA;GACA,GAAG,OAAO;GACX;AAED,MAAI,OAAO,OACT,OAAM,SAAS,OAAO;AAGxB,MAAI,OAAO,KACT,OAAM,UAAU,GACb,OAAO,KAAK,QAAQ,OAAO,KAAK,WAClC;AAGH,SAAO;GACL,eAAe,QAAQ;GACvB;GACA,MAAM;IACJ,YAAY;KAAE;KAAM;KAAU;KAAM;KAAM;IAC1C,SAAS,OAAO;IACjB;GACF;;CAGH,eAAe,QAAuC;EACpD,MAAMC,SAAmB,EAAE;AAG3B,MAAI,OAAO,WAAW,KAAK,KAAK,KAAK,SACnC;QAAK,MAAM,OAAO,OAAO,KAAK,OAAO,QAAQ,CAE3C,KAAI,CADY,KAAK,KAAK,KAAK,QAAQ,MAAM,MAAM,EAAE,QAAQ,IAAI,CAE/D,QAAO,KAAK,uBAAuB,MAAM;;AAM/C,MAAI,OAAO,MAAM;GACf,MAAM,QAAQ,KAAK,KAAK,KAAK,OAAO,MACjC,MAAM,EAAE,QAAQ,OAAO,KAAM,MAC/B;AACD,OAAI,CAAC,MACH,QAAO,KAAK,uBAAuB,OAAO,KAAK,QAAQ;YAC9C,MAAM,aAAa,MAC5B,QAAO,KAAK,0BAA0B,OAAO,KAAK,QAAQ;;AAI9D,SAAO"}

package/dist/data-views/runtime.d.ts

@@ -23,4 +23,5 @@ declare class DataViewRuntime {
   private notifySubscribers;
 }
 //#endregion
-export { DataViewResult, DataViewRuntime, DataViewRuntimeConfig };
+export { DataViewResult, DataViewRuntime, DataViewRuntimeConfig };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/data-views/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/data-views/runtime.ts"],"sourcesContent":[],"mappings":";;;UAEiB,qBAAA;YACL;AADZ;AAKiB,UAAA,cAAc,CAAA,IACvB,GAGE,CAAA,CAAA;EAGG,IAAA,EANL,CAMK,EAAA;EAIiB,KAAA,EAAA,MAAA;EAEb,OAAA,EAAA,OAAA;EAIuB,KAAA,CAAA,EAb9B,KAa8B;;AAMa,cAhBxC,eAAA,CAgBwC;EAAO,QAAA,MAAA;;;sBAZ9B;iBAEb;2CAIuB;+CAMa,QAAQ"}

package/dist/data-views/runtime.js

@@ -36,4 +36,5 @@ var DataViewRuntime = class {
 };
 
 //#endregion
-export { DataViewRuntime };
+export { DataViewRuntime };
+//# sourceMappingURL=runtime.js.map

package/dist/data-views/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["config: DataViewRuntimeConfig"],"sources":["../../src/data-views/runtime.ts"],"sourcesContent":["import { DataViewRegistry, type DataViewSpec } from '../data-views';\n\nexport interface DataViewRuntimeConfig {\n  registry: DataViewRegistry;\n  // eventBus?: EventBus; // To be integrated with actual bus implementation\n}\n\nexport interface DataViewResult<T = any> {\n  data: T[];\n  total: number;\n  loading: boolean;\n  error?: Error;\n}\n\nexport class DataViewRuntime {\n  private cache = new Map<string, { data: any[]; timestamp: number }>();\n  private subscriptions = new Map<string, Set<() => void>>();\n\n  constructor(private config: DataViewRuntimeConfig) {}\n\n  register(spec: DataViewSpec) {\n    this.config.registry.register(spec);\n  }\n\n  getSpec(name: string, version?: number) {\n    return this.config.registry.get(name, version);\n  }\n\n  // Simulating query execution for now as we don't have a full backend context here\n  // In a real app, this would call the backend API via an adapter\n  async executeQuery(specName: string, params: any): Promise<DataViewResult> {\n    const spec = this.getSpec(specName);\n    if (!spec) {\n      throw new Error(`DataView spec not found: ${specName}`);\n    }\n\n    // TODO: Implement actual data fetching via Operation runtime\n    // For now, return empty or cached data\n\n    return {\n      data: [],\n      total: 0,\n      loading: false,\n    };\n  }\n\n  invalidate(specName: string) {\n    this.cache.delete(specName);\n    this.notifySubscribers(specName);\n  }\n\n  subscribe(specName: string, callback: () => void) {\n    if (!this.subscriptions.has(specName)) {\n      this.subscriptions.set(specName, new Set());\n    }\n    this.subscriptions.get(specName)!.add(callback);\n    return () => {\n      this.subscriptions.get(specName)?.delete(callback);\n    };\n  }\n\n  private notifySubscribers(specName: string) {\n    this.subscriptions.get(specName)?.forEach((cb) => cb());\n  }\n}\n"],"mappings":";AAcA,IAAa,kBAAb,MAA6B;CAC3B,AAAQ,wBAAQ,IAAI,KAAiD;CACrE,AAAQ,gCAAgB,IAAI,KAA8B;CAE1D,YAAY,AAAQA,QAA+B;EAA/B;;CAEpB,SAAS,MAAoB;AAC3B,OAAK,OAAO,SAAS,SAAS,KAAK;;CAGrC,QAAQ,MAAc,SAAkB;AACtC,SAAO,KAAK,OAAO,SAAS,IAAI,MAAM,QAAQ;;CAKhD,MAAM,aAAa,UAAkB,QAAsC;AAEzE,MAAI,CADS,KAAK,QAAQ,SAAS,CAEjC,OAAM,IAAI,MAAM,4BAA4B,WAAW;AAMzD,SAAO;GACL,MAAM,EAAE;GACR,OAAO;GACP,SAAS;GACV;;CAGH,WAAW,UAAkB;AAC3B,OAAK,MAAM,OAAO,SAAS;AAC3B,OAAK,kBAAkB,SAAS;;CAGlC,UAAU,UAAkB,UAAsB;AAChD,MAAI,CAAC,KAAK,cAAc,IAAI,SAAS,CACnC,MAAK,cAAc,IAAI,0BAAU,IAAI,KAAK,CAAC;AAE7C,OAAK,cAAc,IAAI,SAAS,CAAE,IAAI,SAAS;AAC/C,eAAa;AACX,QAAK,cAAc,IAAI,SAAS,EAAE,OAAO,SAAS;;;CAItD,AAAQ,kBAAkB,UAAkB;AAC1C,OAAK,cAAc,IAAI,SAAS,EAAE,SAAS,OAAO,IAAI,CAAC"}

package/dist/data-views.d.ts

@@ -128,4 +128,5 @@ declare class DataViewRegistry {
 }
 declare function dataViewKey(spec: DataViewSpec): string;
 //#endregion
-export { DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, dataViewKey };
+export { DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, dataViewKey };
+//# sourceMappingURL=data-views.d.ts.map

package/dist/data-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.d.ts","names":[],"sources":["../src/data-views.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,YAAA;UAEK,YAAA,SAAqB;EAF1B;EAEK,IAAA,EAAA,MAAA;EASA;EAEN,OAAA,EAAA,MAAA;EAEF;EAGI,MAAA,EAAA,MAAA;;AAEA,UATI,cAAA,CASJ;EAGK;EAAQ,OAAA,EAVf,KAUe;EAGd;EAUK,IAAA,CAAA,EArBR,KAqBQ;EAqBA;EAQA,SAAA,CAAA,EAAA;IAUA,MAAA,CAAA,EAzDJ,KAyDI;IAMA,MAAA,CAAA,EA9DJ,KA8DI;IACT,MAAA,CAAA,EA9DK,KA8DL;EACE,CAAA;EAGE;EACA,aAAA,CAAA,EAhEM,QAgEN,EAAA;;AAGK,KAhEL,mBAAA,GAgEwB,MAAQ,GAAA,QAAA,GAAA,UAAkB,GAAA,YAAA,GAAA,MAAA,GAAA,UAAA,GAAA,SAAA,GAAA,OAAA;AAK7C,UA3DA,aAAA,CA2DqB;EAKrB;EAOA,GAAA,EAAA,MAAA;EAOA;EAKL,KAAA,EAAA,MAAA;EACR;EACA,QAAA,EAAA,MAAA;EACA;EACA,WAAA,CAAA,EAAA,MAAA;EAAkB;EAEL,MAAA,CAAA,EA/EN,mBA+EoB;EACrB;EACA,QAAA,CAAA,EAAA,OAAA;EACE;EAAe,UAAA,CAAA,EAAA,OAAA;EAGV;EACT,KAAA,CAAA,EAAA,MAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA;EACE;EACF,YAAA,CAAA,EAhFS,eAgFT;;AAGQ,UAhFC,cAAA,CAgFD;EAAa,GAAA,EAAA,MAAA;EAOhB,KAAA,EAAA,MAAA;EAGI,KAAA,EAAA,MAAA;EAOP,IAAA,EAAA,QAAA,GAAA,MAAA,GAAA,QAAA,GAAA,MAAA,GAAA,SAAA;EAI6B,OAAA,CAAA,EAAA;IAAY,KAAA,EAAA,MAAA;IAenC,KAAA,EAAA,MAAW;;;UA5GV,cAAA;;;;;cAKH;;;;UAKG,gBAAA;;;;;UAMA,kBAAA;QACT;UACE;;;YAGE;YACA;;UAGK,kBAAA,SAA2B;;;;UAK3B,oBAAA,SAA6B;;aAEjC;;UAGI,mBAAA;;;;;;UAOA,mBAAA,SAA4B;;YAEjC;;;;UAKK,kBAAA,SAA2B;;;;KAKhC,cAAA,GACR,qBACA,uBACA,sBACA;UAEa,cAAA;UACP;UACA;YACE;;UAGK,YAAA;QACT;UACE;QACF;WACG;;;;;gBAEK;;cAOH,gBAAA;;iBAGI;UAOP;uCAI6B;;iBAevB,WAAA,OAAkB"}

package/dist/data-views.js

@@ -32,4 +32,5 @@ function dataViewKey(spec) {
 }
 
 //#endregion
-export { DataViewRegistry, dataViewKey };
+export { DataViewRegistry, dataViewKey };
+//# sourceMappingURL=data-views.js.map

package/dist/data-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.js","names":["candidate: DataViewSpec | undefined"],"sources":["../src/data-views.ts"],"sourcesContent":["import type { OwnerShipMeta } from './ownership';\nimport type { OpRef, EventRef, PresentationRef } from './features';\nimport type { ExperimentRef } from './experiments/spec';\n\nexport type DataViewKind = 'list' | 'detail' | 'table' | 'grid';\n\nexport interface DataViewMeta extends OwnerShipMeta {\n  /** Fully-qualified data view name (e.g., \"sigil.spaces.admin_list\"). */\n  name: string;\n  /** Version of this data view. Increment on breaking changes. */\n  version: number;\n  /** Canonical entity slug (e.g., \"space\", \"resident\"). */\n  entity: string;\n}\n\nexport interface DataViewSource {\n  /** Primary query used to fetch items for this view. */\n  primary: OpRef;\n  /** Optional operation used to fetch a single item (detail views). */\n  item?: OpRef;\n  /** Optional record mutation operations (used for inline editing or actions). */\n  mutations?: {\n    create?: OpRef;\n    update?: OpRef;\n    delete?: OpRef;\n  };\n  /** Events that should trigger refresh when emitted. */\n  refreshEvents?: EventRef[];\n}\n\nexport type DataViewFieldFormat =\n  | 'text'\n  | 'number'\n  | 'currency'\n  | 'percentage'\n  | 'date'\n  | 'dateTime'\n  | 'boolean'\n  | 'badge';\n\nexport interface DataViewField {\n  /** Unique identifier for the field within the view. */\n  key: string;\n  /** Human-friendly label for headers/tooltips. */\n  label: string;\n  /** Dot-path into the data item (e.g., \"address.city\"). */\n  dataPath: string;\n  /** Optional description surfaced in tooltips or docs. */\n  description?: string;\n  /** Optional formatting hint for renderers. */\n  format?: DataViewFieldFormat;\n  /** When true, the field can be used for sorting. */\n  sortable?: boolean;\n  /** When true, the field can be used for filtering. */\n  filterable?: boolean;\n  /** Optional width hint for table layouts. */\n  width?: 'auto' | 'xs' | 'sm' | 'md' | 'lg';\n  /** Optional presentation override (e.g., card component). */\n  presentation?: PresentationRef;\n}\n\nexport interface DataViewFilter {\n  key: string;\n  label: string;\n  field: string;\n  type: 'search' | 'enum' | 'number' | 'date' | 'boolean';\n  options?: { value: string; label: string }[];\n}\n\nexport interface DataViewAction {\n  key: string;\n  label: string;\n  kind: 'navigation' | 'operation';\n  /** Operation invoked when kind === 'operation'. */\n  operation?: OpRef;\n  /** Optional feature flag gating the action. */\n  requiresFlag?: string;\n}\n\nexport interface DataViewSections {\n  title?: string;\n  description?: string;\n  fields: string[];\n}\n\nexport interface DataViewBaseConfig {\n  kind: DataViewKind;\n  fields: DataViewField[];\n  primaryField?: string;\n  secondaryFields?: string[];\n  filters?: DataViewFilter[];\n  actions?: DataViewAction[];\n}\n\nexport interface DataViewListConfig extends DataViewBaseConfig {\n  kind: 'list';\n  layout?: 'card' | 'compact';\n}\n\nexport interface DataViewDetailConfig extends DataViewBaseConfig {\n  kind: 'detail';\n  sections?: DataViewSections[];\n}\n\nexport interface DataViewTableColumn {\n  field: string;\n  label?: string;\n  width?: 'auto' | 'xs' | 'sm' | 'md' | 'lg';\n  align?: 'left' | 'center' | 'right';\n}\n\nexport interface DataViewTableConfig extends DataViewBaseConfig {\n  kind: 'table';\n  columns?: DataViewTableColumn[];\n  rowSelectable?: boolean;\n  density?: 'comfortable' | 'compact';\n}\n\nexport interface DataViewGridConfig extends DataViewBaseConfig {\n  kind: 'grid';\n  columns?: number;\n}\n\nexport type DataViewConfig =\n  | DataViewListConfig\n  | DataViewDetailConfig\n  | DataViewTableConfig\n  | DataViewGridConfig;\n\nexport interface DataViewStates {\n  empty?: PresentationRef;\n  error?: PresentationRef;\n  loading?: PresentationRef;\n}\n\nexport interface DataViewSpec {\n  meta: DataViewMeta;\n  source: DataViewSource;\n  view: DataViewConfig;\n  states?: DataViewStates;\n  policy?: { flags?: string[]; pii?: string[] };\n  experiments?: ExperimentRef[];\n}\n\nfunction keyOf(spec: DataViewSpec) {\n  return `${spec.meta.name}.v${spec.meta.version}`;\n}\n\nexport class DataViewRegistry {\n  private readonly items = new Map<string, DataViewSpec>();\n\n  register(spec: DataViewSpec): this {\n    const key = keyOf(spec);\n    if (this.items.has(key)) throw new Error(`Duplicate data view ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): DataViewSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): DataViewSpec | undefined {\n    if (version != null) return this.items.get(`${name}.v${version}`);\n    let candidate: DataViewSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n\nexport function dataViewKey(spec: DataViewSpec) {\n  return keyOf(spec);\n}\n"],"mappings":";AAgJA,SAAS,MAAM,MAAoB;AACjC,QAAO,GAAG,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK;;AAGzC,IAAa,mBAAb,MAA8B;CAC5B,AAAiB,wBAAQ,IAAI,KAA2B;CAExD,SAAS,MAA0B;EACjC,MAAM,MAAM,MAAM,KAAK;AACvB,MAAI,KAAK,MAAM,IAAI,IAAI,CAAE,OAAM,IAAI,MAAM,uBAAuB,MAAM;AACtE,OAAK,MAAM,IAAI,KAAK,KAAK;AACzB,SAAO;;CAGT,OAAuB;AACrB,SAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;;CAGjC,IAAI,MAAc,SAA4C;AAC5D,MAAI,WAAW,KAAM,QAAO,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU;EACjE,IAAIA;EACJ,IAAI,MAAM;AACV,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,EAAE;AACtC,OAAI,KAAK,KAAK,SAAS,KAAM;AAC7B,OAAI,KAAK,KAAK,UAAU,KAAK;AAC3B,UAAM,KAAK,KAAK;AAChB,gBAAY;;;AAGhB,SAAO;;;AAIX,SAAgB,YAAY,MAAoB;AAC9C,QAAO,MAAM,KAAK"}

package/dist/docs/accessibility_wcag_compliance_specs.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/accessibility_wcag_compliance_specs.docblock.d.ts
 declare const accessibility_wcag_compliance_specs_DocBlocks: DocBlock[];
 //#endregion
-export { accessibility_wcag_compliance_specs_DocBlocks };
+export { accessibility_wcag_compliance_specs_DocBlocks };
+//# sourceMappingURL=accessibility_wcag_compliance_specs.docblock.d.ts.map

package/dist/docs/accessibility_wcag_compliance_specs.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility_wcag_compliance_specs.docblock.d.ts","names":[],"sources":["../../src/docs/accessibility_wcag_compliance_specs.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,+CAA+C"}

package/dist/docs/accessibility_wcag_compliance_specs.docblock.js

@@ -14,4 +14,5 @@ const accessibility_wcag_compliance_specs_DocBlocks = [{
 registerDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);
 
 //#endregion
-export { accessibility_wcag_compliance_specs_DocBlocks };
+export { accessibility_wcag_compliance_specs_DocBlocks };
+//# sourceMappingURL=accessibility_wcag_compliance_specs.docblock.js.map

package/dist/docs/accessibility_wcag_compliance_specs.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility_wcag_compliance_specs.docblock.js","names":["accessibility_wcag_compliance_specs_DocBlocks: DocBlock[]"],"sources":["../../src/docs/accessibility_wcag_compliance_specs.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from './registry';\n\nexport const accessibility_wcag_compliance_specs_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.accessibility_wcag_compliance_specs',\n    title: 'Accessibility & WCAG Compliance \\u2014 **specs.md**',\n    summary:\n      '> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non\\u2011negotiable rules, checklists, and CI gates to meet **WCAG\\u00a02.2 AA** (aim for AAA where low\\u2011cost), align with **EN\\u00a0301\\u00a0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\\u00a0Native)**.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/accessibility_wcag_compliance_specs',\n    tags: ['accessibility_wcag_compliance_specs'],\n    body: '# Accessibility & WCAG Compliance \\u2014 **specs.md**\\n\\n> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non\\u2011negotiable rules, checklists, and CI gates to meet **WCAG\\u00a02.2 AA** (aim for AAA where low\\u2011cost), align with **EN\\u00a0301\\u00a0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\\u00a0Native)**.\\n\\n---\\n\\n## 0) Scope & Principles\\n\\n- **Standards:** WCAG\\u00a02.2\\u00a0AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN\\u00a0301\\u00a0549 compliance by conformance to WCAG.\\n- **Principles:** Perceivable, Operable, Understandable, Robust (POUR).\\n- **Rule of ARIA:** \\u201cNo ARIA is better than bad ARIA.\\u201d Prefer native elements.\\n- **Definition of Done (DoD):** No Critical/Major a11y issues in CI; keyboard complete; SR (screen reader) smoke test passed; contrasts pass; acceptance criteria below satisfied.\\n- **Repo Alignment:** Web apps use **Radix Primitives + shadcn** wrappers centralized in `packages/lssm/libs/ui-kit-web`. Prefer those components over per\\u2011app duplicates (`packages/*/apps/*/src/components/ui`). When missing, add to `ui-kit-web` first, then adopt app\\u2011side.\\n\\n---\\n\\n## 1) Design Requirements (Design System & Tokens)\\n\\n**1.1 Color & Contrast**\\n\\n- Body text, icons essential to meaning: **\\u2265\\u00a04.5:1**; large text (\\u2265\\u00a018.66px regular / 14px bold): **\\u2265\\u00a03:1**.\\n- Interactive states (default/hover/active/disabled/focus) must maintain contrast **\\u2265\\u00a03:1** against adjacent colors; text within components follows text ratios.\\n- Provide light & dark themes with tokens that guarantee minimums. **Never rely solely on color** to convey meaning; pair with text, shape, or icon.\\n\\n**1.2 Focus Indicators (WCAG\\u00a02.4.11/12)**\\n\\n- Every interactive element has a **visible focus** with clear offset; indicator contrast **\\u2265\\u00a03:1** vs adjacent colors and indicator **area \\u2265\\u00a02\\u00a0CSS\\u00a0px** thick.\\n- Focus **must not be obscured** by sticky headers/footers or scroll containers.\\n\\n**1.3 Motion & Preferences**\\n\\n- Respect `prefers-reduced-motion`: suppress large parallax, auto\\u2011animations; provide instant alternatives.\\n- Avoid motion that could trigger vestibular issues; under PRM, use fade/scale under **150ms**.\\n\\n**1.4 Target Size (2.5.8)**\\n\\n- Hit areas **\\u2265\\u00a024\\u00d724\\u00a0CSS\\u00a0px** (web) and **\\u2265\\u00a044\\u00d744\\u00a0dp** (mobile) unless exempt.\\n\\n**1.5 Typography & Layout**\\n\\n- Support zoom to **400%** without loss of content/functionality; responsive reflow at **320\\u00a0CSS\\u00a0px** width.\\n- Maintain clear heading hierarchy (h1\\u2026h6), one **h1** per view.\\n\\n- Repository baseline (Web): default body text uses Tailwind `text-lg` (\\u224818px). As of 2025\\u201109\\u201120, the repository bumped all Tailwind typography scale usages by +1 step (e.g., `text-sm`\\u2192`text-base`, `text-base`\\u2192`text-lg`, \\u2026, `text-8xl`\\u2192`text-9xl`). For long\\u2011form content, default to `prose-lg`.\\n- Do not use `text-xs` for body copy. Reserve `text-sm` only for non\\u2011essential meta (timestamps, fine print) while ensuring contrast and touch targets remain compliant.\\n- When increasing font size, ensure line height supports readability. Prefer Tailwind defaults or `leading-relaxed`/`leading-7` for body text where dense blocks appear.\\n\\n**1.6 Iconography & Imagery**\\n\\n- Decorative images: `alt=\"\"` or `aria-hidden=\"true\"`.\\n- Informative images: concise, specific **alt**; complex charts require a **data table or long description**.\\n\\n---\\n\\n## 2) Content Requirements (UX Writing)\\n\\n- Links say **what happens** (avoid \\u201cclick here\\u201d).\\n- Buttons start with verbs; avoid ambiguous labels.\\n- Form labels are **visible**; placeholders are **not labels**.\\n- Error messages: human + programmatic association; avoid color\\u2011only.\\n- Authentication: allow **copy/paste**, password managers, and avoid cognitive tests alone (**3.3.7/3.3.8/3.3.9**).\\n- Avoid CAPTCHAs that block users; if unavoidable, provide **multiple alternatives** (logic-free).\\n\\n---\\n\\n## 3) Engineering Requirements (Web \\u2014 Next.js/React)\\n\\n> Use and extend `packages/lssm/libs/ui-kit-web` as the default UI surface. It wraps **Radix** primitives with sensible a11y defaults (focus rings, roles, keyboard, ARIA binding). When a gap exists, add it to `ui-kit-web` first.\\n\\n**3.1 Semantics & Landmarks**\\n\\n- Use native elements: `<button>`, `<a href>`, `<label for>`, `<fieldset>`, `<legend>`, `<table>`, etc.\\n- Landmarks per page: `header`, `nav`, `main`, `aside`, `footer`. Provide a **Skip to main content** link.\\n- Provide a **Route Announcer** (`aria-live=\"polite\"`) and move focus to page **h1** after navigation.\\n\\n**3.2 Keyboard**\\n\\n- All functionality available with keyboard alone. Tab order follows DOM/visual order; **no keyboard traps**.\\n- Common bindings:\\n  - Space/Enter \\u2192 activate button; Enter on link;\\n  - Esc closes dialogs/menus;\\n  - Arrow keys for lists/menus/tablists with **roving tabindex**.\\n\\n**3.3 Focus Management**\\n\\n- On route change (Next.js), move focus to the page `<h1>` or container and announce via a live region.\\n- Dialogs/menus: **trap focus** inside; return focus to invoking control on close.\\n- Don\\u2019t steal focus except after explicit user action.\\n\\n**3.4 Forms**\\n\\n- Each input has a `<label>` or `aria-label`. Group related inputs with `<fieldset><legend>`.\\n- Associate errors via `aria-describedby` or inline IDs; announce with `role=\"alert\"` (assertive only for critical).\\n- Provide **autocomplete** tokens for known fields; show **inline validation** and do not block on **onBlur** alone.\\n\\n**3.5 ARIA Usage**\\n\\n- Only when needed; match patterns (dialog, menu, combobox, tablist, listbox) per ARIA Authoring Practices.\\n- Ensure **name/role/value** are programmatically determinable.\\n\\n**3.6 Media**\\n\\n- Videos: **captions**; provide **transcripts** for audio; audio descriptions for essential visual info.\\n- No auto\\u2011playing audio. Auto\\u2011playing video must be muted and pausable; provide controls.\\n\\n**3.7 Tables & Data**\\n\\n- Use `<th scope>` for headers; captions via `<caption>`; announce sorting via `aria-sort`.\\n- Provide CSV/JSON export where charts are primary.\\n\\n**3.8 Performance & Robustness**\\n\\n- Avoid content shifts that move focus; reserve space or use skeletons.\\n- Maintain accessible names through hydration/SSR; avoid `dangerouslySetInnerHTML` where possible.\\n\\n**3.9 Next.js specifics**\\n\\n- Use `next/link` for navigation; ensure links are **links**, not buttons.\\n- `next/image` must include **alt** (empty if decorative).\\n- Announce route changes with a **global live region** and shift focus to the new view.\\n\\n**3.10 Accessibility library integration**\\n\\n- Import `@lssm/lib.accessibility` at app root. It auto-imports its `styles.css` via the package entry; ensure bundlers keep CSS side effects. If your app tree-shakes CSS, explicitly import the stylesheet once in your root layout:\\n\\n```tsx\\n// app/layout.tsx\\nimport \\'@lssm/lib.accessibility\\'; // includes tokens and provider exports\\n// or if needed: import \\'@lssm/lib.accessibility/src/styles.css\\';\\n```\\n\\n- Wrap the app with `AccessibilityProvider` and include an element with `id=\"main\"` for the skip link target.\\n\\n---\\n\\n## 3b) lssm/ui-kit-web \\u2014 Component Patterns & Defaults\\n\\n> Source: `packages/lssm/libs/ui-kit-web/ui/*`\\n\\n- **Button/Input/Textarea**: Built\\u2011in `focus-visible` rings; ensure visible labels via `FormLabel` or `aria-label`.\\n- **Form** (`form.tsx`): `FormControl` wires `aria-invalid` and `aria-describedby` to `FormMessage` and `FormDescription`. Prefer `FormMessage` for inline errors. Add `role=\"alert\"` only for critical.\\n- **Dialog/Sheet/Dropdown**: Use Radix wrappers for focus\\u2011trap and return\\u2011focus. Provide `DialogTitle` + `DialogDescription` for name/description.\\n- **Select/Combobox**: Prefer `SelectTrigger` with visible label; for icon\\u2011only triggers, supply `aria-label`. Document examples in each app.\\n- **Tabs**: Use `TabsList`, `TabsTrigger`, `TabsContent`; names are programmatically determinable.\\n- **Toast/Toaster**: Prefer non\\u2011blocking announcements; map critical to assertive region; include action buttons with clear labels.\\n- **Table**: Use `TableCaption`; ensure `TableHead` cells use proper `scope`. Provide `aria-sort` on sortable headers.\\n- **Utilities to add (repo action)**:\\n  - `SkipLink` component and pattern in layouts.\\n  - `RouteAnnouncer` (`aria-live=\"polite\"`) and **FocusOnRouteChange** helper.\\n  - `VisuallyHidden` wrapper (Radix visually-hidden or minimal utility).\\n  - `useReducedMotion` helper; honor in animated components.\\n  - Touch\\u2011size variants (\\u226544\\u00d744) for interactive atoms.\\n\\n---\\n\\n## 4) Engineering Requirements (Mobile \\u2014 Expo/React\\u00a0Native)\\n\\n- Set `accessibilityLabel`, `accessibilityHint`, and `accessibilityRole` on touchables.\\n- Ensure **hit slop** / min size **\\u2265\\u00a044\\u00d744\\u00a0dp**.\\n- Support Dynamic Type / font scaling; no clipped text at **200%**.\\n- Respect **Invert Colors** and **Reduce Motion**; avoid flashing.\\n- Group related items with `accessibilityElements` ordering; hide decoration with `accessible={false}` or `importantForAccessibility=\"no-hide-descendants\"` when appropriate.\\n- Test with **VoiceOver (iOS)** and **TalkBack (Android)**.\\n\\n---\\n\\n## 5) Component Patterns (Acceptance Rules)\\n\\n**Buttons & Links**\\n\\n- Use `<button>` for actions, `<a href>` for navigation. Provide disabled states that are perceivable beyond color.\\n\\n**Navigation**\\n\\n- Provide **Skip link**. One primary nav landmark. Indicate current page (`aria-current=\"page\"`).\\n\\n**Menus/Combobox/Autocomplete**\\n\\n- Follow ARIA patterns: focus moves into list; `aria-expanded`, `aria-controls`, `aria-activedescendant` when applicable; Esc closes; typing filters.\\n\\n**Modals/Dialogs**\\n\\n- `role=\"dialog\"` or `alertdialog` with **label**; focus trapped; background inert; Esc closes; return focus to trigger.\\n\\n**Tabs**\\n\\n- `role=\"tablist\"`; tabs are in the tab order; arrow keys switch focus; content is `role=\"tabpanel\"` with `aria-labelledby`.\\n\\n**Toasts/Notifications**\\n\\n- Non-critical: `aria-live=\"polite\"`; critical: `role=\"alert\"` sparingly.\\n\\n**Infinite Scroll / \\u201cLoad More\\u201d**\\n\\n- Provide **Load more** control; announce new content to SR; preserve keyboard position.\\n\\n**Drag & Drop (2.5.7)**\\n\\n- Provide **non\\u2011drag** alternative (e.g., move up/down buttons).\\n\\n**Charts & Maps**\\n\\n- Provide **table alternative** or textual summary; keyboard access to datapoints where interactive.\\n\\n---\\n\\n## 6) Testing & CI (Blocking Gates)\\n\\n**Static & Unit**\\n\\n- `eslint-plugin-jsx-a11y` \\u2014 error on violations.\\n- `jest-axe` \\u2014 unit tests for components.\\n\\n**Automated Integration**\\n\\n- `axe-core` via Playwright or Cypress on critical flows.\\n- `pa11y-ci` on key routes; threshold: **0 Critical / 0 Serious** to merge.\\n- Lighthouse CI a11y score **\\u2265\\u00a095** on target pages.\\n\\n**Manual QA (per release)**\\n\\n- **Keyboard patrol:** navigate primary flows without mouse.\\n- **Screen reader smoke:** NVDA (Windows) or VoiceOver (macOS/iOS) across login, navigation, forms, dialogs.\\n- **Zoom & Reflow:** 200\\u2013400% & 320\\u00a0px width.\\n- **Color/Contrast check:** tokens in both themes.\\n\\n**Reporting**\\n\\n- A11y issues labeled: `a11y-blocker`, `a11y-bug`, `a11y-enhancement` with WCAG ref.\\n\\n---\\n\\n## 7) Repository\\u2011Specific Adoption Plan\\n\\n- Centralize UI usage on `packages/lssm/libs/ui-kit-web` and de\\u2011duplicate per\\u2011app `components/ui` where feasible.\\n- Introduce `SkipLink`, `RouteAnnouncer`, `FocusOnRouteChange`, and `VisuallyHidden` in `ui-kit-web`. Adopt in app layouts (`app/layout.tsx`) first.\\n- Add `useReducedMotion` and wire into animated components (e.g., `drawer`, `tooltip`, `carousel`).\\n- Add touch\\u2011size variants to `Button`, `IconButton`, `TabsTrigger`, toggles.\\n- Document Select label patterns and error association in Forms.\\n\\n---\\n\\n## 8) Code Snippets\\n\\n**Skip Link**\\n\\n```html\\n<a\\n  class=\"sr-only focus:not-sr-only focus-visible:outline focus-visible:ring-4 focus-visible:ring-offset-2\"\\n  href=\"#main\"\\n  >Skip to main content</a\\n>\\n<main id=\"main\">\\u2026</main>\\n```\\n\\n**Dialog (Radix + shadcn/ui) \\u2014 essentials**\\n\\n```tsx\\n// Ensure label, description, focus trap, and return focus on close remain intact\\n<Dialog>\\n  <DialogTrigger asChild>\\n    <button aria-haspopup=\"dialog\">Open settings</button>\\n  </DialogTrigger>\\n  <DialogContent aria-describedby=\"settings-desc\">\\n    <DialogTitle>Settings</DialogTitle>\\n    <p id=\"settings-desc\">Update your preferences.</p>\\n    <DialogClose asChild>\\n      <button>Close</button>\\n    </DialogClose>\\n  </DialogContent>\\n</Dialog>\\n```\\n\\n**Form error association**\\n\\n```tsx\\n<label htmlFor=\"email\">Email</label>\\n<input id=\"email\" name=\"email\" type=\"email\" aria-describedby=\"email-err\" />\\n<p id=\"email-err\" role=\"alert\">Enter a valid email.</p>\\n```\\n\\n**Route change announcement (Next.js)**\\n\\n```tsx\\n// Add once at app root\\n<div\\n  aria-live=\"polite\"\\n  aria-atomic=\"true\"\\n  id=\"route-announcer\"\\n  className=\"sr-only\"\\n/>\\n```\\n\\n---\\n\\n## 9) Exceptions & Waivers\\n\\n- If a criterion cannot be met, file an issue with: context, attempted alternatives, WCAG reference, impact assessment, and a remediation date. **Temporary waivers only.**\\n\\n---\\n\\n## 10) Ownership\\n\\n- **Design:** maintains token contrast, component specs.\\n- **Engineering:** enforces CI gates, implements patterns.\\n- **QA:** runs manual checks per release.\\n- **PM:** blocks release if AA not met on user\\u2011visible flows.\\n\\n---\\n\\n## 11) References (internalize; no external dependency at runtime)\\n\\n- WCAG\\u00a02.2 (AA), EN\\u00a0301\\u00a0549. ARIA Authoring Practices. Platform HIG (Apple, Material).\\n- `packages/lssm/libs/ui-kit-web` as the canonical UI source for web.\\n\\n> **Bottom line:** Shipping means **accessible by default**. We don\\u2019t trade a11y for speed; we bake it into speed.\\n\\n---\\n\\n## 12) Adoption Status (2025-09-23)\\n\\n- web-artisan: AccessibilityProvider integrated; sr-only/forced-colors applied; 44x44 targets; forms announce errors; jest-axe and cypress-axe in place.\\n- web-strit: AccessibilityProvider integrated; forced-colors, sr-only; forms announce errors; 44x44 targets; contrast tokens and text-scale wired; jest-axe and cypress-axe in place.\\n- web-coliving: AccessibilityProvider integrated; forced-colors and focus visibility added; text-scale wired; landing pages converted to `Section`/stacks with text-lg defaults; CTA capture standardized; ESLint guard for text-xs in main content; jest-axe and cypress-axe in place. Next: audit icon-only controls and ensure 44x44 targets; add role=\"alert\" where critical.\\n\\n> CI gates: run eslint a11y, jest-axe on components, and cypress-axe on critical flows per app.\\n\\n---\\n\\n## 13) CI Hardening & Visual QA\\n\\n- Linting: Run eslint with jsx-a11y rules across all web apps; block on violations.\\n- Unit: Run jest-axe for ui-kit-web and app-level components.\\n- Integration: cypress-axe on key flows (auth, forms, dialogs, tables).\\n- Synthetic scans: pa11y-ci on critical pages (0 Critical/Serious policy).\\n- Performance/A11y audit: Lighthouse CI with a11y score >= 95 on target routes.\\n- Artifacts: Upload pa11y and Lighthouse reports per PR; annotate failures.\\n\\n### Recent additions (2025-09-26)\\n\\n- AutocompleteInput (groceries): Upgraded to ARIA combobox pattern with `aria-controls`, `aria-activedescendant`, `Escape`/`Tab` handling, and labelled listbox.\\n- Cypress a11y tests added for furniture and incidents modules on `/modules` and operators flows; checks run axe with critical/serious impacts.\\n\\n## 14) Accessibility Telemetry (PostHog)\\n\\n- Events (anonymized): a11y_pref_changed (text_scale, contrast_mode, reduce_motion), a11y_panel_opened.\\n- Properties: app, route, previous_value, new_value, timestamp.\\n- Dashboards: Adoption over time, per app/route; correlation with reduced bounce on forms.\\n- Privacy: No PII; aggregate only.\\n',\n  },\n];\nregisterDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,gDAA4D,CACvE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sCAAsC;CAC7C,MAAM;CACP,CACF;AACD,kBAAkB,8CAA8C"}

package/dist/docs/index.js

@@ -2,13 +2,7 @@ import { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresen
 import { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./registry.js";
 import { techContractsDocs } from "./tech-contracts.docs.js";
 import { metaDocs } from "./meta.docs.js";
-import "./PUBLISHING.docblock.js";
 import "./accessibility_wcag_compliance_specs.docblock.js";
-import "./tech/PHASE_1_QUICKSTART.docblock.js";
-import "./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";
-import "./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";
-import "./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";
-import "./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";
 import "./tech/lifecycle-stage-system.docblock.js";
 import "./tech/presentation-runtime.docblock.js";
 import "./tech/auth/better-auth-nextjs.docblock.js";

package/dist/docs/meta.docs.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "./types.js";
 //#region src/docs/meta.docs.d.ts
 declare const metaDocs: DocBlock[];
 //#endregion
-export { metaDocs };
+export { metaDocs };
+//# sourceMappingURL=meta.docs.d.ts.map

package/dist/docs/meta.docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.docs.d.ts","names":[],"sources":["../../src/docs/meta.docs.ts"],"sourcesContent":[],"mappings":";;;cAGa,UAAU"}

package/dist/docs/meta.docs.js

@@ -1,3 +1,5 @@
+import { registerDocBlocks } from "./registry.js";
+
 //#region src/docs/meta.docs.ts
 const metaDocs = [{
 	id: "docs.meta.docblocks-process",
@@ -21,6 +23,8 @@ const metaDocs = [{
 - For presentations/markdown outputs, rely on TransformEngine via DocRegistry.
 - No sourcePath; DocBlocks are canonical.`
 }];
+registerDocBlocks(metaDocs);
 
 //#endregion
-export { metaDocs };
+export { metaDocs };
+//# sourceMappingURL=meta.docs.js.map

package/dist/docs/meta.docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.docs.js","names":["metaDocs: DocBlock[]"],"sources":["../../src/docs/meta.docs.ts"],"sourcesContent":["import type { DocBlock } from './types';\nimport { registerDocBlocks } from './registry';\n\nexport const metaDocs: DocBlock[] = [\n  {\n    id: 'docs.meta.docblocks-process',\n    title: 'DocBlocks process',\n    summary: 'How to author goal/how/usage DocBlocks close to code.',\n    kind: 'reference',\n    visibility: 'mixed',\n    route: '/docs/meta/docblocks-process',\n    tags: ['docs', 'process'],\n    body: `## DocBlocks authoring rules\n\n- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n  - **goal**: why this exists (before implementation).\n  - **how**: operational/runbook steps.\n  - **usage**: quick checklist for consumers.\n- Use \\`visibility\\`: public | internal | mixed.\n- Prefer routes like \\`/docs/<domain>/<topic>/<kind>\\`; ids mirror that.\n- Keep body Markdown LLM-friendly; avoid HTML.\n- Add owners/tags/domain/stability when known.\n- For presentations/markdown outputs, rely on TransformEngine via DocRegistry.\n- No sourcePath; DocBlocks are canonical.`,\n  },\n];\nregisterDocBlocks(metaDocs);\n"],"mappings":";;;AAGA,MAAaA,WAAuB,CAClC;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,UAAU;CACzB,MAAM;;;;;;;;;;;;;CAaP,CACF;AACD,kBAAkB,SAAS"}

package/dist/docs/presentations.d.ts

@@ -30,4 +30,5 @@ declare function docBlocksToPresentationRoutes(blocks: DocBlock[], options?: Doc
 declare function docBlocksToPresentationSpecs(blocks: DocBlock[], options?: DocPresentationOptions): PresentationSpec[];
 declare function mapDocRoutes(routes: DocPresentationRoute[]): [string, PresentationDescriptorV2][];
 //#endregion
-export { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };
+export { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };
+//# sourceMappingURL=presentations.d.ts.map

package/dist/docs/presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.d.ts","names":[],"sources":["../../src/docs/presentations.ts"],"sourcesContent":[],"mappings":";;;;;;UAQiB,sBAAA;;AAAjB;AAgBA;AAkCA;EACS,SAAA,CAAA,EAAA,MAAA;EACG;EACT,WAAA,CAAA,EAAA,MAAA;EAAwB;EA2BX,cAAA,CAAA,EAvEG,kBAuEuB,EAAA;EACjC;EACG,cAAA,CAAA,EAAA,MAAA;EACT;EAAgB,gBAAA,CAAA,EAtEE,SAsEF;AAoBnB;AACU,UAxFO,oBAAA,CAwFP;EACE,KAAA,EAAA,MAAA;EACT,UAAA,EAxFW,wBAwFX;EAAoB,KAAA,EAvFd,QAuFc;AAQvB;AACU,iBAjEM,wBAAA,CAiEN,KAAA,EAhED,QAgEC,EAAA,OAAA,CAAA,EA/DE,sBA+DF,CAAA,EA9DP,wBA8DO;AACE,iBApCI,0BAAA,CAoCJ,KAAA,EAnCH,QAmCG,EAAA,OAAA,CAAA,EAlCA,sBAkCA,CAAA,EAjCT,gBAiCS;AACT,iBAda,6BAAA,CAcb,MAAA,EAbO,QAaP,EAAA,EAAA,OAAA,CAAA,EAZS,sBAYT,CAAA,EAXA,oBAWA,EAAA;AAAgB,iBAHH,4BAAA,CAGG,MAAA,EAFT,QAES,EAAA,EAAA,OAAA,CAAA,EADP,sBACO,CAAA,EAAhB,gBAAgB,EAAA;AAIH,iBAAA,YAAA,CACN,MAAA,EAAA,oBACE,EAAA,CAAA,EAAA,CAAA,MAAA,EAAA,wBAAwB,CAAA,EAAA"}

package/dist/docs/presentations.js

@@ -74,4 +74,5 @@ function mapDocRoutes(routes) {
 }
 
 //#endregion
-export { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };
+export { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };
+//# sourceMappingURL=presentations.js.map

package/dist/docs/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":["DEFAULT_TARGETS: PresentationTarget[]"],"sources":["../../src/docs/presentations.ts"],"sourcesContent":["import type { PresentationSpec } from '../presentations';\nimport type {\n  PresentationDescriptorV2,\n  PresentationTarget,\n} from '../presentations.v2';\nimport type { DocBlock } from './types';\nimport type { Stability } from '../ownership';\n\nexport interface DocPresentationOptions {\n  /**\n   * Namespace for presentation meta.name (e.g., web-landing.docs.ops).\n   * Defaults to the DocBlock id.\n   */\n  namespace?: string;\n  /** Route prefix when no explicit route is provided on the block. Defaults to /docs. */\n  routePrefix?: string;\n  /** Default presentation targets. */\n  defaultTargets?: PresentationTarget[];\n  /** Default version when block.version is not set. */\n  defaultVersion?: number;\n  /** Default stability if not provided on the DocBlock. */\n  defaultStability?: Stability;\n}\n\nexport interface DocPresentationRoute {\n  route: string;\n  descriptor: PresentationDescriptorV2;\n  block: DocBlock;\n}\n\nconst DEFAULT_TARGETS: PresentationTarget[] = [\n  'markdown',\n  'application/json',\n  'application/xml',\n  'react',\n];\n\nfunction normalizeRoute(route: string): string {\n  if (!route.length) return '/';\n  const withLeading = route.startsWith('/') ? route : `/${route}`;\n  return withLeading === '/' ? '/' : withLeading.replace(/\\/+$/, '');\n}\n\nfunction deriveRoute(block: DocBlock, routePrefix?: string): string {\n  if (block.route) return normalizeRoute(block.route);\n  const prefix = routePrefix ?? '/docs';\n  const slug = block.id\n    .replace(/^docs\\.?/, '')\n    .replace(/\\./g, '/')\n    .replace(/\\/+/g, '/');\n  const path = slug.startsWith('/') ? slug : `${prefix}/${slug}`;\n  return normalizeRoute(path);\n}\n\nfunction buildName(block: DocBlock, namespace?: string): string {\n  return namespace ? `${namespace}.${block.id}` : block.id;\n}\n\nexport function docBlockToPresentationV2(\n  block: DocBlock,\n  options?: DocPresentationOptions\n): PresentationDescriptorV2 {\n  const targets = options?.defaultTargets ?? DEFAULT_TARGETS;\n  const version = block.version ?? options?.defaultVersion ?? 1;\n  const stability = block.stability ?? options?.defaultStability ?? 'stable';\n\n  return {\n    meta: {\n      name: buildName(block, options?.namespace),\n      version,\n      description: block.summary ?? block.title,\n      tags: block.tags,\n      owners: block.owners,\n      domain: block.domain,\n      stability,\n    },\n    policy:\n      block.visibility && block.visibility !== 'public'\n        ? { flags: [block.visibility] }\n        : undefined,\n    source: {\n      type: 'blocknotejs',\n      docJson: block.body,\n    },\n    targets,\n  };\n}\n\nexport function docBlockToPresentationSpec(\n  block: DocBlock,\n  options?: DocPresentationOptions\n): PresentationSpec {\n  const version = block.version ?? options?.defaultVersion ?? 1;\n  const stability = block.stability ?? options?.defaultStability ?? 'stable';\n\n  return {\n    meta: {\n      name: buildName(block, options?.namespace),\n      version,\n      stability,\n      tags: block.tags,\n      owners: block.owners,\n      description: block.summary ?? block.title,\n    },\n    content: {\n      kind: 'markdown',\n      content: block.body,\n    },\n  };\n}\n\nexport function docBlocksToPresentationRoutes(\n  blocks: DocBlock[],\n  options?: DocPresentationOptions\n): DocPresentationRoute[] {\n  return blocks.map((block) => ({\n    block,\n    route: deriveRoute(block, options?.routePrefix),\n    descriptor: docBlockToPresentationV2(block, options),\n  }));\n}\n\nexport function docBlocksToPresentationSpecs(\n  blocks: DocBlock[],\n  options?: DocPresentationOptions\n): PresentationSpec[] {\n  return blocks.map((block) => docBlockToPresentationSpec(block, options));\n}\n\nexport function mapDocRoutes(\n  routes: DocPresentationRoute[]\n): [string, PresentationDescriptorV2][] {\n  return routes.map(({ route, descriptor }) => [route, descriptor]);\n}\n"],"mappings":";AA8BA,MAAMA,kBAAwC;CAC5C;CACA;CACA;CACA;CACD;AAED,SAAS,eAAe,OAAuB;AAC7C,KAAI,CAAC,MAAM,OAAQ,QAAO;CAC1B,MAAM,cAAc,MAAM,WAAW,IAAI,GAAG,QAAQ,IAAI;AACxD,QAAO,gBAAgB,MAAM,MAAM,YAAY,QAAQ,QAAQ,GAAG;;AAGpE,SAAS,YAAY,OAAiB,aAA8B;AAClE,KAAI,MAAM,MAAO,QAAO,eAAe,MAAM,MAAM;CACnD,MAAM,SAAS,eAAe;CAC9B,MAAM,OAAO,MAAM,GAChB,QAAQ,YAAY,GAAG,CACvB,QAAQ,OAAO,IAAI,CACnB,QAAQ,QAAQ,IAAI;AAEvB,QAAO,eADM,KAAK,WAAW,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAC7B;;AAG7B,SAAS,UAAU,OAAiB,WAA4B;AAC9D,QAAO,YAAY,GAAG,UAAU,GAAG,MAAM,OAAO,MAAM;;AAGxD,SAAgB,yBACd,OACA,SAC0B;CAC1B,MAAM,UAAU,SAAS,kBAAkB;CAC3C,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAElE,QAAO;EACL,MAAM;GACJ,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA,aAAa,MAAM,WAAW,MAAM;GACpC,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd;GACD;EACD,QACE,MAAM,cAAc,MAAM,eAAe,WACrC,EAAE,OAAO,CAAC,MAAM,WAAW,EAAE,GAC7B;EACN,QAAQ;GACN,MAAM;GACN,SAAS,MAAM;GAChB;EACD;EACD;;AAGH,SAAgB,2BACd,OACA,SACkB;CAClB,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAElE,QAAO;EACL,MAAM;GACJ,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA;GACA,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,aAAa,MAAM,WAAW,MAAM;GACrC;EACD,SAAS;GACP,MAAM;GACN,SAAS,MAAM;GAChB;EACF;;AAGH,SAAgB,8BACd,QACA,SACwB;AACxB,QAAO,OAAO,KAAK,WAAW;EAC5B;EACA,OAAO,YAAY,OAAO,SAAS,YAAY;EAC/C,YAAY,yBAAyB,OAAO,QAAQ;EACrD,EAAE;;AAGL,SAAgB,6BACd,QACA,SACoB;AACpB,QAAO,OAAO,KAAK,UAAU,2BAA2B,OAAO,QAAQ,CAAC;;AAG1E,SAAgB,aACd,QACsC;AACtC,QAAO,OAAO,KAAK,EAAE,OAAO,iBAAiB,CAAC,OAAO,WAAW,CAAC"}

package/dist/docs/registry.d.ts

@@ -21,4 +21,5 @@ declare function registerDocBlocks(blocks: DocBlock[]): void;
 declare function listRegisteredDocBlocks(): DocBlock[];
 declare function docId(id: string): DocId;
 //#endregion
-export { DocId, DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };
+export { DocId, DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };
+//# sourceMappingURL=registry.d.ts.map

package/dist/docs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/docs/registry.ts"],"sourcesContent":[],"mappings":";;;;;;KAUY,KAAA;;AAAZ,CAAA;AAEa,cAAA,WAAA,CAAW;EAGF,iBAAA,MAAA;EAA2B,WAAA,CAAA,MAAA,CAAA,EAA3B,QAA2B,EAAA,EAAA,OAAA,CAAA,EAAA,sBAAA;EAI/B,QAAA,CAAA,KAAA,EAAA,QAAA,EAAA,OAAA,CAAA,EAAoB,sBAApB,CAAA,EAAA,IAAA;EAAoB,IAAA,CAAA,CAAA,EAQ5B,oBAR4B,EAAA;EAQ5B,GAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAIS,oBAJT,GAAA,SAAA;EAIS,aAAA,CAAA,CAAA,EAAA,CAAA,MAAA,EAIS,wBAJT,CAAA,EAAA;EAIS,mBAAA,CAAA,OAAA,CAAA,EAII,sBAJJ,CAAA,EAI6B,gBAJ7B,EAAA;;AAI6B,cAgB5C,kBAhB4C,EAgB1B,WAhB0B;AAAgB,iBAkBzD,iBAAA,CAlByD,MAAA,EAkB/B,QAlB+B,EAAA,CAAA,EAAA,IAAA;AAgB5D,iBAeG,uBAAA,CAAA,CAfe,EAeY,QAfQ,EAAA;AAEnC,iBAiBA,KAAA,CAjBiB,EAAA,EAAA,MAAS,CAAA,EAiBP,KAjBe"}

package/dist/docs/registry.js

@@ -48,4 +48,5 @@ function docId(id) {
 }
 
 //#endregion
-export { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };
+export { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };
+//# sourceMappingURL=registry.js.map

package/dist/docs/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":["requiredFields: (keyof DocBlock)[]"],"sources":["../../src/docs/registry.ts"],"sourcesContent":["import type { PresentationDescriptorV2 } from '../presentations.v2';\nimport type { PresentationSpec } from '../presentations';\nimport type { DocBlock } from './types';\nimport {\n  docBlockToPresentationSpec,\n  docBlocksToPresentationRoutes,\n  type DocPresentationOptions,\n  type DocPresentationRoute,\n} from './presentations';\n\nexport type DocId = string & { __docId: true };\n\nexport class DocRegistry {\n  private readonly routes = new Map<string, DocPresentationRoute>();\n\n  constructor(blocks: DocBlock[] = [], options?: DocPresentationOptions) {\n    blocks.forEach((block) => this.register(block, options));\n  }\n\n  register(block: DocBlock, options?: DocPresentationOptions): this {\n    const [route] = docBlocksToPresentationRoutes([block], options);\n    if (route) {\n      this.routes.set(block.id, route);\n    }\n    return this;\n  }\n\n  list(): DocPresentationRoute[] {\n    return [...this.routes.values()];\n  }\n\n  get(id: string): DocPresentationRoute | undefined {\n    return this.routes.get(id);\n  }\n\n  toRouteTuples(): [string, PresentationDescriptorV2][] {\n    return this.list().map(({ route, descriptor }) => [route, descriptor]);\n  }\n\n  toPresentationSpecs(options?: DocPresentationOptions): PresentationSpec[] {\n    return this.list().map(({ block }) =>\n      docBlockToPresentationSpec(block, options)\n    );\n  }\n}\n\nconst requiredFields: (keyof DocBlock)[] = [\n  'id',\n  'title',\n  'body',\n  'kind',\n  'visibility',\n  'route',\n];\n\nexport const defaultDocRegistry = new DocRegistry();\n\nexport function registerDocBlocks(blocks: DocBlock[]): void {\n  for (const block of blocks) {\n    for (const field of requiredFields) {\n      if (!block[field]) {\n        throw new Error(\n          `DocBlock ${block.id ?? '<missing id>'} missing field ${String(field)}`\n        );\n      }\n    }\n    defaultDocRegistry.register(block);\n  }\n}\n\nexport function listRegisteredDocBlocks(): DocBlock[] {\n  return defaultDocRegistry.list().map((r) => r.block);\n}\n\nexport function docId(id: string): DocId {\n  const found = defaultDocRegistry.get(id);\n  if (!found) throw new Error(`DocBlock not registered: ${id}`);\n  return id as DocId;\n}\n"],"mappings":";;;AAYA,IAAa,cAAb,MAAyB;CACvB,AAAiB,yBAAS,IAAI,KAAmC;CAEjE,YAAY,SAAqB,EAAE,EAAE,SAAkC;AACrE,SAAO,SAAS,UAAU,KAAK,SAAS,OAAO,QAAQ,CAAC;;CAG1D,SAAS,OAAiB,SAAwC;EAChE,MAAM,CAAC,SAAS,8BAA8B,CAAC,MAAM,EAAE,QAAQ;AAC/D,MAAI,MACF,MAAK,OAAO,IAAI,MAAM,IAAI,MAAM;AAElC,SAAO;;CAGT,OAA+B;AAC7B,SAAO,CAAC,GAAG,KAAK,OAAO,QAAQ,CAAC;;CAGlC,IAAI,IAA8C;AAChD,SAAO,KAAK,OAAO,IAAI,GAAG;;CAG5B,gBAAsD;AACpD,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAC,OAAO,WAAW,CAAC;;CAGxE,oBAAoB,SAAsD;AACxE,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,YACxB,2BAA2B,OAAO,QAAQ,CAC3C;;;AAIL,MAAMA,iBAAqC;CACzC;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,qBAAqB,IAAI,aAAa;AAEnD,SAAgB,kBAAkB,QAA0B;AAC1D,MAAK,MAAM,SAAS,QAAQ;AAC1B,OAAK,MAAM,SAAS,eAClB,KAAI,CAAC,MAAM,OACT,OAAM,IAAI,MACR,YAAY,MAAM,MAAM,eAAe,iBAAiB,OAAO,MAAM,GACtE;AAGL,qBAAmB,SAAS,MAAM;;;AAItC,SAAgB,0BAAsC;AACpD,QAAO,mBAAmB,MAAM,CAAC,KAAK,MAAM,EAAE,MAAM;;AAGtD,SAAgB,MAAM,IAAmB;AAEvC,KAAI,CADU,mBAAmB,IAAI,GAAG,CAC5B,OAAM,IAAI,MAAM,4BAA4B,KAAK;AAC7D,QAAO"}

package/dist/docs/tech/auth/better-auth-nextjs.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/auth/better-auth-nextjs.docblock.d.ts
 declare const tech_auth_better_auth_nextjs_DocBlocks: DocBlock[];
 //#endregion
-export { tech_auth_better_auth_nextjs_DocBlocks };
+export { tech_auth_better_auth_nextjs_DocBlocks };
+//# sourceMappingURL=better-auth-nextjs.docblock.d.ts.map

package/dist/docs/tech/auth/better-auth-nextjs.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-auth-nextjs.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/auth/better-auth-nextjs.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,wCAAwC"}

package/dist/docs/tech/auth/better-auth-nextjs.docblock.js

@@ -78,4 +78,5 @@ These checks are intentionally optimistic and should only gate routing. Full aut
 registerDocBlocks(tech_auth_better_auth_nextjs_DocBlocks);
 
 //#endregion
-export { tech_auth_better_auth_nextjs_DocBlocks };
+export { tech_auth_better_auth_nextjs_DocBlocks };
+//# sourceMappingURL=better-auth-nextjs.docblock.js.map

package/dist/docs/tech/auth/better-auth-nextjs.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-auth-nextjs.docblock.js","names":["tech_auth_better_auth_nextjs_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/auth/better-auth-nextjs.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_auth_better_auth_nextjs_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.auth.better-auth-nextjs',\n    title: 'Better Auth + Next.js integration (ContractSpec)',\n    summary:\n      'How ContractSpec wires Better Auth into Next.js (server config, client singleton, and proxy cookie-only redirects).',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/auth/better-auth-nextjs',\n    tags: ['auth', 'better-auth', 'nextjs', 'cookies', 'proxy', 'hmr'],\n    body: `# Better Auth + Next.js integration (ContractSpec)\n\nThis repo uses Better Auth as the primary auth layer (sessions, organizations, teams, API keys, and OAuth).\n\n## Server config (Better Auth)\n\n- Source: \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Important: \\`nextCookies()\\` must be the **last** plugin in the Better Auth plugin list so \\`Set-Cookie\\` is applied correctly in Next.js environments.\n\n## Better Auth Admin plugin\n\nContractSpec Studio enables the Better Auth **Admin plugin** to support platform-admin user operations (list users, impersonation, etc.).\n\n- Server: \\`admin()\\` plugin in \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Client: \\`adminClient()\\` in \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n\n### PLATFORM_ADMIN ⇒ Better Auth admin role\n\nBetter Auth Admin endpoints authorize via \\`user.role\\`. ContractSpec enforces an org-driven rule:\n\n- If the **active organization** has \\`type = PLATFORM_ADMIN\\`, the signed-in user is ensured to have \\`User.role\\` containing \\`admin\\`.\n- This is applied in the session creation hook and re-checked in \\`assertsPlatformAdmin()\\`.\n\nThis keeps admin enablement deterministic and avoids manual role backfills.\n\n## Client config (React web + Expo)\n\nTo avoid duplicate background refresh/polling loops in dev (Fast Refresh/HMR), the Better Auth client is implemented as a singleton cached on \\`globalThis\\`.\n\n- Web client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n- Native client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.native.ts\\`\n\nImport guidance:\n\n- If you only need the context/hook, prefer importing from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth\\`.\n- If you explicitly need the Better Auth client instance (e.g. admin impersonation, direct API calls), import from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/client\\`.\n\n## Public routes (login / signup)\n\nPublic auth pages should avoid eager \\`authClient\\` initialization.\n\nPattern used:\n\n- In the submit handler, dynamically import \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/index.web\\` and call \\`authClient.signIn.*\\` / \\`authClient.signUp.*\\`.\n\nThis prevents session refresh behavior from starting just because a public page rendered.\n\n## Next.js proxy auth (web-landing)\n\nThe Next.js proxy/middleware is used for **redirect decisions only**. It must not perform DB-backed session reads on every request.\n\n- Source: \\`packages/apps/web-landing/src/proxy.ts\\`\n- Approach: cookie-only checks via Better Auth cookies helpers:\n  - \\`getSessionCookie(request)\\`\n  - \\`getCookieCache(request)\\`\n\nThese checks are intentionally optimistic and should only gate routing. Full authorization must still be enforced on server-side actions/routes and GraphQL resolvers.\n`,\n  },\n];\n\nregisterDocBlocks(tech_auth_better_auth_nextjs_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,yCAAqD,CAChE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAe;EAAU;EAAW;EAAS;EAAM;CAClE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DP,CACF;AAED,kBAAkB,uCAAuC"}

package/dist/docs/tech/contracts/README.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/README.docblock.d.ts
 declare const tech_contracts_README_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_README_DocBlocks };
+export { tech_contracts_README_DocBlocks };
+//# sourceMappingURL=README.docblock.d.ts.map

package/dist/docs/tech/contracts/README.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"README.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/README.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,iCAAiC"}

package/dist/docs/tech/contracts/README.docblock.js

@@ -18,4 +18,5 @@ const tech_contracts_README_DocBlocks = [{
 registerDocBlocks(tech_contracts_README_DocBlocks);
 
 //#endregion
-export { tech_contracts_README_DocBlocks };
+export { tech_contracts_README_DocBlocks };
+//# sourceMappingURL=README.docblock.js.map

package/dist/docs/tech/contracts/README.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"README.docblock.js","names":["tech_contracts_README_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/contracts/README.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_README_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.README',\n    title: 'Contracts: Specs, Registry, Handlers, Adapters',\n    summary:\n      '- `packages/lssm/libs/contracts` defines the contracts core (SpecRegistry, ContractSpec, install helpers, REST/MCP adapters).',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/README',\n    tags: ['tech', 'contracts', 'README'],\n    body: \"## Contracts: Specs, Registry, Handlers, Adapters\\n\\n### What lives where\\n\\n- `packages/lssm/libs/contracts` defines the contracts core (SpecRegistry, ContractSpec, install helpers, REST/MCP adapters).\\n- `packages/lssm/libs/schema` defines the schema dictionary (`SchemaModel`, `FieldType`) used to describe I/O once and map to multiple targets (zod, GraphQL, JSON Schema).\\n- App adapters (e.g. GraphQL) live close to the app. Example: `packages/hcircle/apps/api-coliving/src/graphql/contracts-adapter.ts`.\\n\\n### npm distribution\\n\\n- `@lssm/lib.contracts` (root) keeps the legacy \\\\\\\"everything\\\\\\\" surface for backward compatibility.\\n- `@lssm/lib.contracts/client` exposes only browser-safe helpers (React renderers, client SDK, drivers). Import from this entry when bundling for the web or React Native to avoid dragging server adapters.\\n- `@lssm/lib.contracts/server` covers HTTP/MCP adapters, registries, integrations, and other Node-only helpers.\\n- `@lssm/lib.contracts/types` exports the runtime handler context utilities, while `@lssm/lib.contracts/types/all` re-exports every type alias/interface across the package via `export type` so consumers can import a single module for typings without shipping runtime code.\\n- `@lssm/lib.schema`, `@lssm/lib.design-system`, `@lssm/lib.ui-kit`, `@lssm/lib.ui-kit-web`, `@lssm/lib.accessibility`, and the presentation runtime packages are published to npm alongside contracts; prefer the scoped packages to keep tree-shaking intact.\\n- Bundlers with conditional exports should resolve subpaths first; keep root imports for server-only code paths.\\n\\n### Core concepts\\n\\n- **ContractSpec**: immutable description of an operation.\\n  - `meta`: `{ name, version, kind: 'query' | 'command' }`\\n  - `io`: `{ input: SchemaModel | zod schema, output: SchemaModel | zod schema }`\\n  - `policy`: `{ auth?: {...}, rateLimit?: {...}, flags?: string[] }`\\n  - `transport.gql.field?`: explicit GraphQL field name (otherwise derived via `defaultGqlField`).\\n- **SpecRegistry**: registry of specs + handlers. Use `installOp(reg, spec, handler)` to attach a handler.\\n- **Handler**: `(ctx, input) => Promise<output>` implementing the operation.\\n- **CapabilitySpec**: canonical capability declaration stored in `src/capabilities.ts`. Tracks `meta` (`{ key, version, kind, title, description, domain, owners, tags, stability }`), `provides` surfaces (`operation`, `event`, `workflow`, `presentation`, `resource`), and `requires` which other capabilities must be present. Enforced during `installFeature`.\\n- **PolicySpec**: declarative policy rules (`src/policy/spec.ts`) covering ABAC/ReBAC, consent + rate limit requirements, field-level controls, and PII guidance. `PolicyEngine` evaluates refs, while `OPAPolicyAdapter` lets OPA override/augment runtime decisions.\\n- **TelemetrySpec**: analytics definitions (`src/telemetry/spec.ts`) describing event semantics, privacy level, retention, sampling, and anomaly detection. `TelemetryTracker` handles redaction/sampling, `TelemetryAnomalyMonitor` raises alerts, and specs integrate with contracts/workflows via `ctx.telemetry`.\\n- **TestSpec**: declarative scenario definitions in `src/tests/spec.ts`. `TestRunner` executes fixtures/actions/assertions against a `SpecRegistry`, and the CLI (`contractspec test`) wraps the runner for automation.\\n- **ExperimentSpec**: experiment definitions (`src/experiments/spec.ts`) describing variants, allocation strategies, and success metrics. `ExperimentEvaluator` assigns variants (random/sticky/targeted) and integrates with Policy/Telemetry for safe experimentation.\\n- **AppBlueprintSpec / TenantAppConfig**: global blueprints and per-tenant overrides (`src/app-config/spec.ts`). `resolveAppConfig()` merges the two into a `ResolvedAppConfig`, while `composeAppConfig()` hydrates the merged view against registries and reports missing references for safe rollout.\\n- **RegeneratorService**: background daemon (`src/regenerator/service.ts`) that consumes telemetry/error/behavior signals, evaluates regeneration rules, and produces `SpecChangeProposal`s for Studio review.\\n- **DataViewSpec**: declarative data presentation layer in `src/data-views.ts`. Describes entity projections (`fields`, `filters`, `actions`) with `view.kind` (`list`, `table`, `detail`, `grid`), ties to query operations via `source.primary`, and exposes optional presentation-based empty/error states.\\n- **ThemeSpec**: design token + component variant definitions in `src/themes.ts`. Supports inheritance (`extends`), tenant/user overrides, and component-specific variant metadata for the design system.\\n- **MigrationSpec**: schema/data migration descriptors (`src/migrations.ts`) with ordered step plans, dependency tracking, and pre/post checks to support automated database/content migrations.\\n- **WorkflowSpec**: typed definition of multi-step workflows living in `src/workflow/spec.ts`. `WorkflowRegistry` stores versioned specs, and `validateWorkflowSpec()` (in `src/workflow/validation.ts`) checks graph integrity, step references, and reachability.\\n\\n### Lifecycle\\n\\n1. Define the spec (I/O via `SchemaModel` or zod) in a vertical lib (e.g. `contracts-coliving`).\\n2. Register it: `installOp(registry, spec, handler)` within the app/service.\\n3. Expose it via an adapter (REST, GraphQL, MCP). Each adapter maps the I/O to its transport and enforces policy.\\n4. Validate at runtime: parse `input` before executing, parse `output` before returning.\\n\\n### Adapters\\n\\n- **REST**: see `packages/lssm/libs/contracts/src/server/rest-*`. Binds routes, validates request/response, maps errors/policies.\\n- **MCP**: see `packages/lssm/libs/contracts/src/server/provider-mcp.ts` (standalone MCP server) and `packages/lssm/libs/contracts/src/server/rest-next-mcp.ts` (MCP over Next.js route). Provides tools/resources/prompts.\\n  - Tools + resources are registered from Zod schemas.\\n  - Resource templates are keyed by full `ResourceMeta.uriTemplate` (e.g. `docs://list`, `docs://doc/{id}`), so multiple templates can share a scheme (`docs://*`) without collisions.\\n- **GraphQL (Pothos)**: see `packages/lssm/libs/contracts/src/server/graphql-pothos.ts`. Adds Query/Mutation fields by transforming contract I/O to GraphQL types.\\n\\n### GraphQL adapter behaviour (summary)\\n\\n- Field naming: `spec.transport.gql.field` or `<name_with_dots>_v<version>`.\\n- Input/Output types from `SchemaModel` (preferred) or fallback zod introspection.\\n- Scalars: String/Int/Float/Boolean/Date/JSON; Objects/Arrays/Enums; unions for outputs; input unions => JSON.\\n- Policy: auth gate checks GraphQL context; optional feature flag gating.\\n- Complexity & tracing: attaches hints and records timings; log includes `{ specName, version }`.\\n\\n#### Returns mapping and hydration\\n\\n- `spec.transport.gql.returns` can declare the GraphQL return wrapper: e.g. `\\\"Spot\\\"` or `[Spot]`. If omitted, the adapter infers from `io.output` (SchemaModel) or `resourceRef.graphQLType`.\\n- Resource outputs: when `io.output` is a `resourceRef(...)` or `transport.gql.resource` is set, the adapter will optionally hydrate via a `ResourceRegistry` using `contracts-adapter-hydration.ts`:\\n  - Grammar is parsed with `parseReturns()`.\\n  - Entities are resolved via `hydrateResourceIfNeeded(resources, result, { template, varName, returns })` after handler execution.\\n\\n### Resource outputs\\n\\n- Declare resource outputs using `resourceRef(uriTemplate, opts)`.\\n- `opts.varName` (default `id`) selects the identifier field returned by the handler for URI substitution.\\n- `opts.graphQLType` is the GraphQL return type name (e.g., `Spot`) or list form (e.g., `[Spot]`).\\n- `opts.many: true` indicates the handler returns an array of resources. The handler type becomes an array of items that include the identifier field.\\n\\nExample:\\n\\n```ts\\nio: {\\n  input: ListThingsInput,\\n  output: resourceRef('myapp://thing/{id}', { graphQLType: '[Thing]', many: true }),\\n}\\n```\\n\\nHandler return (simplified): `{ id: string | number }[]`.\\n\\n### Errors\\n\\n- Validation errors \\u2192 transport 400/GraphQL UserInputError.\\n- Policy/auth errors \\u2192 401/403 or GraphQL ForbiddenError.\\n- Handler errors \\u2192 mapped to transport error with safe message.\\n\\n### Versioning & naming\\n\\n- Keep `meta.version` monotonic. Clients should pin to a versioned field/key.\\n- Avoid renaming existing fields; add new fields with new versions.\\n\\n### Ownership metadata (OwnerShipMeta)\\n\\nAll contracts, events, features, and presentations reference a shared ownership schema (source of truth in `packages/lssm/libs/contracts/src/ownership.ts`).\\n\\n- Required fields: `title`, `description`, `domain`, `owners[]`, `tags[]`, `stability`.\\n- Curated enums: the library exports suggested constants for owners and tags; free-form strings are still allowed for forward-compatibility.\\n- Operations (`spec.ts`): `meta` requires `stability`, `owners`, and `tags` alongside `name`, `version`, `kind`, `description`, `goal`, and `context`.\\n- Presentations V2: `meta` is a partial of ownership plus `description`.\\n- Events: may specify `ownership` (recommended) for discoverability and docs.\\n\\n### Quick start\\n\\n```ts\\n// app bootstrap\\nconst reg = new SpecRegistry();\\ninstallOp(reg, BeginSignupSpec, beginSignupHandler);\\nregisterContractsOnBuilder(gqlSchemaBuilder, reg); // GraphQL\\n// or: createRestRouter(reg) // REST\\n```\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_README_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,kCAA8C,CACzD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAS;CACrC,MAAM;CACP,CACF;AACD,kBAAkB,gCAAgC"}

package/dist/docs/tech/contracts/create-subscription.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/create-subscription.docblock.d.ts
 declare const tech_contracts_create_subscription_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_create_subscription_DocBlocks };
+export { tech_contracts_create_subscription_DocBlocks };
+//# sourceMappingURL=create-subscription.docblock.d.ts.map

package/dist/docs/tech/contracts/create-subscription.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-subscription.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/create-subscription.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,8CAA8C"}

package/dist/docs/tech/contracts/create-subscription.docblock.js

@@ -18,4 +18,5 @@ const tech_contracts_create_subscription_DocBlocks = [{
 registerDocBlocks(tech_contracts_create_subscription_DocBlocks);
 
 //#endregion
-export { tech_contracts_create_subscription_DocBlocks };
+export { tech_contracts_create_subscription_DocBlocks };
+//# sourceMappingURL=create-subscription.docblock.js.map

package/dist/docs/tech/contracts/create-subscription.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-subscription.docblock.js","names":["tech_contracts_create_subscription_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/contracts/create-subscription.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_create_subscription_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.create-subscription',\n    title: 'Subscriptions via Better Auth Stripe',\n    summary:\n      \"This app uses Better Auth's Stripe plugin for subscription management.\",\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/create-subscription',\n    tags: ['tech', 'contracts', 'create-subscription'],\n    body: \"### Subscriptions via Better Auth Stripe\\n\\nThis app uses Better Auth's Stripe plugin for subscription management.\\n\\nKey endpoints:\\n\\n- `/api/auth/[...all]` \\u2013 Better Auth server\\n- `/api/auth/stripe/webhook` \\u2013 Stripe webhook handled by Better Auth\\n\\nClient usage (org mode):\\n\\n```ts\\nimport { subscription } from '@/lib/auth-client';\\n\\nawait subscription.upgrade({\\n  plan: 'core',\\n  annual: true,\\n  referenceId: activeOrganization?.id,\\n  successUrl: '/dashboard',\\n  cancelUrl: '/pricing',\\n});\\n```\\n\\nPlans are configured in `src/lib/auth.ts` referencing env-provided price IDs. See Better Auth Stripe docs: [plugins: Stripe](`https://better-auth.com/docs/plugins/stripe.mdx`) and [Using with organizations](`https://www.better-auth.com/docs/plugins/stripe#using-with-organizations`).\\n\\nLanding pricing UX\\n\\n- Components: `SectionEyebrow`, `PriceBadge`, `FeatureList`, `PriceCard`\\n- Sections: `PricingSection`, `StoryPricingBenefits`\\n- Canonical pricing source: `src/lib/pricing/config.ts`\\n\\nTrial period\\n\\n- Le plan \\u00ab Essentiel \\u00bb inclut une p\\u00e9riode d\\u2019essai gratuite de 30 jours.\\n- Config c\\u00f4t\\u00e9 auth: `freeTrial: { days: 30 }` dans `src/lib/auth.ts` (Better Auth Stripe plugin).\\n- Config c\\u00f4t\\u00e9 pricing: `trial: { days: 30 }` dans `src/lib/pricing/config.ts`.\\n\\nDashboard badges\\n\\n- Le `Tableau de bord` affiche des badges d\\u2019\\u00e9tat d\\u2019abonnement:\\n  - \\u00ab Essai \\u00b7 se termine le JJ/MM/AAAA \\u00bb lorsque l\\u2019essai est en cours\\n  - \\u00ab Abonnement actif \\u00bb lorsque l\\u2019abonnement est actif\\n  - \\u00ab Annul\\u00e9 \\u00b7 fin au terme de la p\\u00e9riode \\u00bb lorsque la r\\u00e9siliation est planifi\\u00e9e\\n- Composant: `components/dashboard/DashboardPage/molecules/Header.tsx`\\n- Source des \\u00e9tats: hook `useProfileBillingPage()` (`components/profile/ProfileBillingPage/hooks/useProfileBillingPage.tsx`)\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_create_subscription_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,+CAA2D,CACtE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAsB;CAClD,MAAM;CACP,CACF;AACD,kBAAkB,6CAA6C"}

package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts
 declare const tech_contracts_graphql_typed_outputs_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_graphql_typed_outputs_DocBlocks };
+export { tech_contracts_graphql_typed_outputs_DocBlocks };
+//# sourceMappingURL=graphql-typed-outputs.docblock.d.ts.map

package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-typed-outputs.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/graphql-typed-outputs.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,gDAAgD"}

package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.js

@@ -18,4 +18,5 @@ const tech_contracts_graphql_typed_outputs_DocBlocks = [{
 registerDocBlocks(tech_contracts_graphql_typed_outputs_DocBlocks);
 
 //#endregion
-export { tech_contracts_graphql_typed_outputs_DocBlocks };
+export { tech_contracts_graphql_typed_outputs_DocBlocks };
+//# sourceMappingURL=graphql-typed-outputs.docblock.js.map

package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-typed-outputs.docblock.js","names":["tech_contracts_graphql_typed_outputs_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/contracts/graphql-typed-outputs.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_graphql_typed_outputs_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.graphql-typed-outputs',\n    title: 'GraphQL Typed Outputs for Contracts',\n    summary:\n      'Improved `@lssm/lib.contracts` to automatically generate proper GraphQL object types from `SchemaModel` outputs instead of defaulting to `JSON` scalar types.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/graphql-typed-outputs',\n    tags: ['tech', 'contracts', 'graphql-typed-outputs'],\n    body: \"# GraphQL Typed Outputs for Contracts\\n\\n## Overview\\n\\nImproved `@lssm/lib.contracts` to automatically generate proper GraphQL object types from `SchemaModel` outputs instead of defaulting to `JSON` scalar types.\\n\\n## Problem\\n\\nPreviously, when GraphQL operations were defined using contracts with `SchemaModel` outputs, the GraphQL schema would default to returning `JSON` scalar types. This meant:\\n\\n- GraphQL clients couldn't query specific fields\\n- No type safety for operation outputs\\n- Codegen would fail with \\\"must have a selection of subfields\\\" errors\\n\\n## Solution\\n\\n### 1. Auto-Type Registration in `graphql-pothos.ts`\\n\\n**File**: `packages/lssm/libs/contracts/src/server/graphql-pothos.ts`\\n\\n**Changes**:\\n\\n- Scan all contract specs and collect their `SchemaModel` outputs\\n- Automatically register GraphQL object types for each `SchemaModel`\\n- Map field types from SchemaModel to proper GraphQL scalar types\\n- Update `resolveGraphQLTypeName` to check for `SchemaModel` names before defaulting to `JSON`\\n\\n**Key Code**:\\n\\n```typescript\\n// Build a map of output types we need to register\\nconst outputTypeCache = new Map<string, AnySchemaModel>();\\nfor (const spec of reg.listSpecs()) {\\n  const out = spec.io.output as AnySchemaModel | ResourceRefDescriptor<boolean>;\\n  if (out && 'getZod' in out && typeof out.getZod === 'function') {\\n    const model = out as AnySchemaModel;\\n    const typeName = model.config?.name ?? 'UnknownOutput';\\n    if (!outputTypeCache.has(typeName)) {\\n      outputTypeCache.set(typeName, model);\\n    }\\n  }\\n}\\n\\n// Register all output types as GraphQL object types\\nfor (const [typeName, model] of outputTypeCache.entries()) {\\n  builder.objectType(typeName, {\\n    fields: (t) => {\\n      // Map each field from SchemaModel to GraphQL field\\n      // ...\\n    },\\n  });\\n}\\n```\\n\\n### 2. Fix Contract Definitions\\n\\n**File**: `packages/hcircle/libs/contracts-coliving/src/interactions/onboarding/org/contracts.ts`\\n\\n**Changes**:\\n\\n- Changed `GetOrgOnboardingDraftSpec` from `defineCommand` to `defineQuery` (read-only operation)\\n- Added `defineQuery` import\\n\\n**Before**:\\n\\n```typescript\\nexport const GetOrgOnboardingDraftSpec = defineCommand({\\n  // ...\\n});\\n```\\n\\n**After**:\\n\\n```typescript\\nexport const GetOrgOnboardingDraftSpec = defineQuery({\\n  // ...\\n});\\n```\\n\\n### 3. Update All GraphQL Queries\\n\\nUpdated all GraphQL operation calls to select proper subfields based on the output type:\\n\\n#### Output Types and Their Fields\\n\\n1. **`CreateOrgOutput`**:\\n   - `organizationId: ID!`\\n   - `orgType: String!`\\n\\n2. **`CompleteUserOnboardingOutput`**:\\n   - `success: Boolean!`\\n   - `userId: ID!`\\n\\n3. **`CompleteOrgOnboardingOutput`**:\\n   - `success: Boolean!`\\n   - `organizationId: ID!`\\n   - `orgType: String!`\\n\\n4. **`OnboardingDraft`** (from resource_ref):\\n   - `id: ID!`\\n   - `organizationId: ID!`\\n   - `data: JSON!`\\n   - `createdAt: DateTime!`\\n   - `updatedAt: DateTime!`\\n\\n5. **`GetOnboardingDraftOutput`**:\\n   - `id: ID`\\n   - `organizationId: ID`\\n   - `data: JSON`\\n   - `createdAt: DateTime`\\n   - `updatedAt: DateTime`\\n\\n6. **`DeleteOnboardingDraftOutput`**:\\n   - `ok: Boolean!` _(note: not `success`)_\\n\\n#### Files Updated\\n\\n1. `/packages/hcircle/apps/mobile-coliving/src/app/onboarding-org-select.tsx`\\n2. `/packages/hcircle/apps/mobile-coliving/src/app/onboarding-org.tsx`\\n3. `/packages/hcircle/apps/mobile-coliving/src/app/onboarding-user.tsx`\\n4. `/packages/hcircle/apps/web-coliving/src/app/onboarding/user/page.tsx`\\n5. `/packages/hcircle/apps/web-coliving/src/components/onboarding/OnboardingFlow.tsx`\\n6. `/packages/hcircle/apps/web-coliving/src/components/onboarding/OrgSelectionFlow.tsx`\\n\\n**Example Before**:\\n\\n```graphql\\nmutation CreateOrg($orgType: String!, $name: String!, $slug: String!) {\\n  createOrganization(input: { orgType: $orgType, name: $name, slug: $slug })\\n}\\n```\\n\\n**Example After**:\\n\\n```graphql\\nmutation CreateOrg($orgType: String!, $name: String!, $slug: String!) {\\n  createOrganization(input: { orgType: $orgType, name: $name, slug: $slug }) {\\n    organizationId\\n    orgType\\n  }\\n}\\n```\\n\\n## Benefits\\n\\n1. **Type Safety**: Full type safety for GraphQL operation outputs\\n2. **Auto-Generated Types**: No need to manually specify `returns` in contract transport config\\n3. **Better DX**: GraphQL clients can now query specific fields and benefit from autocomplete\\n4. **Consistency**: All `SchemaModel` outputs are automatically typed in GraphQL\\n5. **Backward Compatible**: Operations with explicit `returns` config still work as before\\n\\n## Testing\\n\\nAll GraphQL codegen now passes:\\n\\n```bash\\ncd packages/hcircle/libs/gql-client-coliving\\nbun graphql-codegen --config codegen.ts  # \\u2705 Success\\n```\\n\\n## Migration Guide for Other Verticals\\n\\nTo apply this to other verticals (e.g., Artisanos, Strit):\\n\\n1. **No code changes needed** - the improved `graphql-pothos.ts` automatically handles all `SchemaModel` outputs\\n2. **Update GraphQL queries** - Add field selections to queries that previously returned `JSON`\\n3. **Fix query/command mismatches** - Ensure read-only operations use `defineQuery` instead of `defineCommand`\\n\\n## Future Improvements\\n\\n1. Add support for nested `SchemaModel` references (currently only supports scalar fields)\\n2. Add support for array fields of SchemaModels\\n3. Consider auto-generating field selections based on the output type to reduce boilerplate\\n\\n## Related Documentation\\n\\n- [Contracts README](../../packages/lssm/libs/contracts/README.md)\\n- [Onboarding System](./hcircle/IMPLEMENTATION_COMPLETE.md)\\n- [GraphQL Architecture](./graphql/architecture.md)\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_graphql_typed_outputs_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,iDAA6D,CACxE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAwB;CACpD,MAAM;CACP,CACF;AACD,kBAAkB,+CAA+C"}

package/dist/docs/tech/contracts/migrations.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/migrations.docblock.d.ts
 declare const tech_contracts_migrations_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_migrations_DocBlocks };
+export { tech_contracts_migrations_DocBlocks };
+//# sourceMappingURL=migrations.docblock.d.ts.map

package/dist/docs/tech/contracts/migrations.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/migrations.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,qCAAqC"}

package/dist/docs/tech/contracts/migrations.docblock.js

@@ -18,4 +18,5 @@ const tech_contracts_migrations_DocBlocks = [{
 registerDocBlocks(tech_contracts_migrations_DocBlocks);
 
 //#endregion
-export { tech_contracts_migrations_DocBlocks };
+export { tech_contracts_migrations_DocBlocks };
+//# sourceMappingURL=migrations.docblock.js.map

package/dist/docs/tech/contracts/migrations.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.docblock.js","names":["tech_contracts_migrations_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/contracts/migrations.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_migrations_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.migrations',\n    title: 'MigrationSpec Overview',\n    summary:\n      '`MigrationSpec` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/migrations',\n    tags: ['tech', 'contracts', 'migrations'],\n    body: \"# MigrationSpec Overview\\n\\n## Purpose\\n\\n`MigrationSpec` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.\\n\\n## Location\\n\\n- Spec + registry: `packages/libs/contracts/src/migrations.ts`\\n- Tests: `packages/.../migrations.test.ts`\\n\\n## Schema\\n\\n```ts\\nexport interface MigrationSpec {\\n  meta: MigrationMeta;   // ownership metadata + { name, version }\\n  plan: {\\n    up: MigrationStep[];   // required forward plan\\n    down?: MigrationStep[];// optional rollback steps\\n  };\\n  dependencies?: string[]; // optional list of migration keys this depends on\\n}\\n```\\n\\n- **MigrationStep**\\n  - `kind`: `'schema' | 'data' | 'validation'`\\n  - Shared fields: `description?`, `timeoutMs?`, `retries?`, `preChecks?`, `postChecks?`\\n  - `schema`: `sql` string executed in transactional context\\n  - `data`: arbitrary `script` (e.g., JS/TS snippet, path to file, instructions)\\n  - `validation`: `assertion` expression verifying state (e.g., SQL returning boolean)\\n- **MigrationCheck** (`preChecks`/`postChecks`)\\n  - `description`: human context\\n  - `expression`: expression or SQL snippet to evaluate before/after the step\\n- **Dependencies**\\n  - Array of migration keys (`\\\"boundedContext.namespace.timestamp_slug\\\"`) used to ensure the registry executes prerequisites first\\n\\n## Registry Usage\\n\\n```ts\\nimport { MigrationRegistry } from '@lssm/lib.contracts/migrations';\\nimport { AddUsersMigration } from './migrations/core.db.2025_01_add_users';\\n\\nconst registry = new MigrationRegistry();\\nregistry.register(AddUsersMigration);\\n\\nconst migration = registry.get('core.db.2025_01_add_users');\\nconst all = registry.list(); // sorted by name/version\\n```\\n\\n## Authoring Guidelines\\n\\n1. Name migrations with timestamped slugs (`domain.db.YYYY_MM_description`) for clarity.\\n2. Capture ownership metadata (`owners`, `tags`, `stability`) so tooling can route approvals.\\n3. Prefer small, reversible steps. Use `plan.down` when safe; otherwise document fallback.\\n4. Use `preChecks`/`postChecks` for critical invariants (row counts, schema existence).\\n5. Specify dependencies explicitly to avoid parallel execution hazards.\\n6. For large data scripts, use `script` as a pointer (URL, file path) rather than embedding code directly.\\n\\n## Tooling Roadmap\\n\\nUpcoming CLI support (Phase 4 plan):\\n\\n- `contractspec create --type migration` (scaffolds spec skeleton)\\n- `contractspec build <migration>` (generate executor harness)\\n- `contractspec migrate create/up/down/status` orchestration commands\\n\\nThe current implementation focuses on the spec/registry foundation so downstream tooling can be layered iteratively.\\n\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_migrations_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,sCAAkD,CAC7D;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAa;CACzC,MAAM;CACP,CACF;AACD,kBAAkB,oCAAoC"}

package/dist/docs/tech/contracts/openapi-export.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/openapi-export.docblock.d.ts
 declare const tech_contracts_openapi_export_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_openapi_export_DocBlocks };
+export { tech_contracts_openapi_export_DocBlocks };
+//# sourceMappingURL=openapi-export.docblock.d.ts.map

package/dist/docs/tech/contracts/openapi-export.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-export.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/openapi-export.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,yCAAyC"}

package/dist/docs/tech/contracts/openapi-export.docblock.js

@@ -55,4 +55,5 @@ The registry module must export one of:
 registerDocBlocks(tech_contracts_openapi_export_DocBlocks);
 
 //#endregion
-export { tech_contracts_openapi_export_DocBlocks };
+export { tech_contracts_openapi_export_DocBlocks };
+//# sourceMappingURL=openapi-export.docblock.js.map

package/dist/docs/tech/contracts/openapi-export.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-export.docblock.js","names":["tech_contracts_openapi_export_DocBlocks: DocBlock[]"],"sources":["../../../../src/docs/tech/contracts/openapi-export.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_openapi_export_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.openapi-export',\n    title: 'OpenAPI export (OpenAPI 3.1) from SpecRegistry',\n    summary:\n      'Generate a deterministic OpenAPI document from a SpecRegistry using jsonSchemaForSpec + REST transport metadata.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/openapi-export',\n    tags: ['contracts', 'openapi', 'rest'],\n    body: `## OpenAPI export (OpenAPI 3.1) from SpecRegistry\n\n### Purpose\n\nContractSpec specs can be exported into an **OpenAPI 3.1** document for tooling (SDK generation, docs, gateways).\n\nThe export is **spec-first**:\n\n- Uses \\`jsonSchemaForSpec(spec)\\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)\n- Uses \\`spec.transport.rest.method/path\\` when present\n- Falls back to deterministic defaults:\n  - Method: \\`POST\\` for commands, \\`GET\\` for queries\n  - Path: \\`defaultRestPath(name, version)\\` → \\`/<dot/name>/v<version>\\`\n\n### Library API\n\n- Function: \\`openApiForRegistry(registry, options?)\\`\n- Location: \\`@lssm/lib.contracts/openapi\\`\n\n### CLI\n\nExport OpenAPI from a registry module:\n\n\\`\\`\\`bash\ncontractspec openapi --registry ./src/registry.ts --out ./openapi.json\n\\`\\`\\`\n\nThe registry module must export one of:\n\n- \\`registry: SpecRegistry\\`\n- \\`default(): SpecRegistry | Promise<SpecRegistry>\\`\n- \\`createRegistry(): SpecRegistry | Promise<SpecRegistry>\\`\n\n### Notes / limitations (current)\n\n- Responses are generated as a basic \\`200\\` response (plus schemas when available).\n- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.\n- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`,\n  },\n];\n\nregisterDocBlocks(tech_contracts_openapi_export_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,0CAAsD,CACjE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAW;EAAO;CACtC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCP,CACF;AAED,kBAAkB,wCAAwC"}

package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/docs/tech/contracts/ops-to-presentation-linking.docblock.d.ts
 declare const tech_contracts_ops_to_presentation_linking_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_ops_to_presentation_linking_DocBlocks };
+export { tech_contracts_ops_to_presentation_linking_DocBlocks };
+//# sourceMappingURL=ops-to-presentation-linking.docblock.d.ts.map

package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-to-presentation-linking.docblock.d.ts","names":[],"sources":["../../../../src/docs/tech/contracts/ops-to-presentation-linking.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,sDAAsD"}