@lssm/lib.contracts 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

package/dist/data-views.d.ts

@@ -0,0 +1,131 @@
+import { OwnerShipMeta } from "./ownership.js";
+import { ExperimentRef } from "./experiments/spec.js";
+import { EventRef, OpRef, PresentationRef } from "./features.js";
+
+//#region src/data-views.d.ts
+type DataViewKind = 'list' | 'detail' | 'table' | 'grid';
+interface DataViewMeta extends OwnerShipMeta {
+  /** Fully-qualified data view name (e.g., "sigil.spaces.admin_list"). */
+  name: string;
+  /** Version of this data view. Increment on breaking changes. */
+  version: number;
+  /** Canonical entity slug (e.g., "space", "resident"). */
+  entity: string;
+}
+interface DataViewSource {
+  /** Primary query used to fetch items for this view. */
+  primary: OpRef;
+  /** Optional operation used to fetch a single item (detail views). */
+  item?: OpRef;
+  /** Optional record mutation operations (used for inline editing or actions). */
+  mutations?: {
+    create?: OpRef;
+    update?: OpRef;
+    delete?: OpRef;
+  };
+  /** Events that should trigger refresh when emitted. */
+  refreshEvents?: EventRef[];
+}
+type DataViewFieldFormat = 'text' | 'number' | 'currency' | 'percentage' | 'date' | 'dateTime' | 'boolean' | 'badge';
+interface DataViewField {
+  /** Unique identifier for the field within the view. */
+  key: string;
+  /** Human-friendly label for headers/tooltips. */
+  label: string;
+  /** Dot-path into the data item (e.g., "address.city"). */
+  dataPath: string;
+  /** Optional description surfaced in tooltips or docs. */
+  description?: string;
+  /** Optional formatting hint for renderers. */
+  format?: DataViewFieldFormat;
+  /** When true, the field can be used for sorting. */
+  sortable?: boolean;
+  /** When true, the field can be used for filtering. */
+  filterable?: boolean;
+  /** Optional width hint for table layouts. */
+  width?: 'auto' | 'xs' | 'sm' | 'md' | 'lg';
+  /** Optional presentation override (e.g., card component). */
+  presentation?: PresentationRef;
+}
+interface DataViewFilter {
+  key: string;
+  label: string;
+  field: string;
+  type: 'search' | 'enum' | 'number' | 'date' | 'boolean';
+  options?: {
+    value: string;
+    label: string;
+  }[];
+}
+interface DataViewAction {
+  key: string;
+  label: string;
+  kind: 'navigation' | 'operation';
+  /** Operation invoked when kind === 'operation'. */
+  operation?: OpRef;
+  /** Optional feature flag gating the action. */
+  requiresFlag?: string;
+}
+interface DataViewSections {
+  title?: string;
+  description?: string;
+  fields: string[];
+}
+interface DataViewBaseConfig {
+  kind: DataViewKind;
+  fields: DataViewField[];
+  primaryField?: string;
+  secondaryFields?: string[];
+  filters?: DataViewFilter[];
+  actions?: DataViewAction[];
+}
+interface DataViewListConfig extends DataViewBaseConfig {
+  kind: 'list';
+  layout?: 'card' | 'compact';
+}
+interface DataViewDetailConfig extends DataViewBaseConfig {
+  kind: 'detail';
+  sections?: DataViewSections[];
+}
+interface DataViewTableColumn {
+  field: string;
+  label?: string;
+  width?: 'auto' | 'xs' | 'sm' | 'md' | 'lg';
+  align?: 'left' | 'center' | 'right';
+}
+interface DataViewTableConfig extends DataViewBaseConfig {
+  kind: 'table';
+  columns?: DataViewTableColumn[];
+  rowSelectable?: boolean;
+  density?: 'comfortable' | 'compact';
+}
+interface DataViewGridConfig extends DataViewBaseConfig {
+  kind: 'grid';
+  columns?: number;
+}
+type DataViewConfig = DataViewListConfig | DataViewDetailConfig | DataViewTableConfig | DataViewGridConfig;
+interface DataViewStates {
+  empty?: PresentationRef;
+  error?: PresentationRef;
+  loading?: PresentationRef;
+}
+interface DataViewSpec {
+  meta: DataViewMeta;
+  source: DataViewSource;
+  view: DataViewConfig;
+  states?: DataViewStates;
+  policy?: {
+    flags?: string[];
+    pii?: string[];
+  };
+  experiments?: ExperimentRef[];
+}
+declare class DataViewRegistry {
+  private readonly items;
+  register(spec: DataViewSpec): this;
+  list(): DataViewSpec[];
+  get(name: string, version?: number): DataViewSpec | undefined;
+}
+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 };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/PUBLISHING.docblock.d.ts
+declare const PUBLISHING_DocBlocks: DocBlock[];
+//#endregion
+export { PUBLISHING_DocBlocks };

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

@@ -0,0 +1,6 @@
+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 };

package/dist/docs/index.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock, DocBlockLink, DocKind, DocVisibility } from "./types.js";
+import { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./presentations.js";
+import { DocId, DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./registry.js";
+import { techContractsDocs } from "./tech-contracts.docs.js";
+import { metaDocs } from "./meta.docs.js";
+export { DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocVisibility, defaultDocRegistry, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, listRegisteredDocBlocks, mapDocRoutes, metaDocs, registerDocBlocks, techContractsDocs };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "./types.js";
+
+//#region src/docs/meta.docs.d.ts
+declare const metaDocs: DocBlock[];
+//#endregion
+export { metaDocs };

package/dist/docs/presentations.d.ts

@@ -0,0 +1,33 @@
+import { Stability } from "../ownership.js";
+import { PresentationDescriptorV2, PresentationTarget } from "../presentations.v2.js";
+import { PresentationSpec } from "../presentations.js";
+import { DocBlock } from "./types.js";
+
+//#region src/docs/presentations.d.ts
+interface DocPresentationOptions {
+  /**
+   * Namespace for presentation meta.name (e.g., web-landing.docs.ops).
+   * Defaults to the DocBlock id.
+   */
+  namespace?: string;
+  /** Route prefix when no explicit route is provided on the block. Defaults to /docs. */
+  routePrefix?: string;
+  /** Default presentation targets. */
+  defaultTargets?: PresentationTarget[];
+  /** Default version when block.version is not set. */
+  defaultVersion?: number;
+  /** Default stability if not provided on the DocBlock. */
+  defaultStability?: Stability;
+}
+interface DocPresentationRoute {
+  route: string;
+  descriptor: PresentationDescriptorV2;
+  block: DocBlock;
+}
+declare function docBlockToPresentationV2(block: DocBlock, options?: DocPresentationOptions): PresentationDescriptorV2;
+declare function docBlockToPresentationSpec(block: DocBlock, options?: DocPresentationOptions): PresentationSpec;
+declare function docBlocksToPresentationRoutes(blocks: DocBlock[], options?: DocPresentationOptions): DocPresentationRoute[];
+declare function docBlocksToPresentationSpecs(blocks: DocBlock[], options?: DocPresentationOptions): PresentationSpec[];
+declare function mapDocRoutes(routes: DocPresentationRoute[]): [string, PresentationDescriptorV2][];
+//#endregion
+export { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };

package/dist/docs/registry.d.ts

@@ -0,0 +1,24 @@
+import { PresentationDescriptorV2 } from "../presentations.v2.js";
+import { PresentationSpec } from "../presentations.js";
+import { DocBlock } from "./types.js";
+import { DocPresentationOptions, DocPresentationRoute } from "./presentations.js";
+
+//#region src/docs/registry.d.ts
+type DocId = string & {
+  __docId: true;
+};
+declare class DocRegistry {
+  private readonly routes;
+  constructor(blocks?: DocBlock[], options?: DocPresentationOptions);
+  register(block: DocBlock, options?: DocPresentationOptions): this;
+  list(): DocPresentationRoute[];
+  get(id: string): DocPresentationRoute | undefined;
+  toRouteTuples(): [string, PresentationDescriptorV2][];
+  toPresentationSpecs(options?: DocPresentationOptions): PresentationSpec[];
+}
+declare const defaultDocRegistry: DocRegistry;
+declare function registerDocBlocks(blocks: DocBlock[]): void;
+declare function listRegisteredDocBlocks(): DocBlock[];
+declare function docId(id: string): DocId;
+//#endregion
+export { DocId, DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };

package/dist/docs/tech/PHASE_1_QUICKSTART.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/PHASE_1_QUICKSTART.docblock.d.ts
+declare const tech_PHASE_1_QUICKSTART_DocBlocks: DocBlock[];
+//#endregion
+export { tech_PHASE_1_QUICKSTART_DocBlocks };

package/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.d.ts
+declare const tech_PHASE_2_AI_NATIVE_OPERATIONS_DocBlocks: DocBlock[];
+//#endregion
+export { tech_PHASE_2_AI_NATIVE_OPERATIONS_DocBlocks };

package/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.d.ts
+declare const tech_PHASE_3_AUTO_EVOLUTION_DocBlocks: DocBlock[];
+//#endregion
+export { tech_PHASE_3_AUTO_EVOLUTION_DocBlocks };

package/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.d.ts
+declare const tech_PHASE_4_PERSONALIZATION_ENGINE_DocBlocks: DocBlock[];
+//#endregion
+export { tech_PHASE_4_PERSONALIZATION_ENGINE_DocBlocks };

package/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.d.ts
+declare const tech_PHASE_5_ZERO_TOUCH_OPERATIONS_DocBlocks: DocBlock[];
+//#endregion
+export { tech_PHASE_5_ZERO_TOUCH_OPERATIONS_DocBlocks };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+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 };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/contracts/overlays.docblock.d.ts
+declare const tech_contracts_overlays_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_overlays_DocBlocks };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/contracts/tests.docblock.d.ts
+declare const tech_contracts_tests_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_tests_DocBlocks };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/contracts/themes.docblock.d.ts
+declare const tech_contracts_themes_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_themes_DocBlocks };

package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/contracts/vertical-pocket-family-office.docblock.d.ts
+declare const tech_contracts_vertical_pocket_family_office_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_vertical_pocket_family_office_DocBlocks };

package/dist/docs/tech/lifecycle-stage-system.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/lifecycle-stage-system.docblock.d.ts
+declare const tech_lifecycle_stage_system_DocBlocks: DocBlock[];
+//#endregion
+export { tech_lifecycle_stage_system_DocBlocks };

package/dist/docs/tech/llm/llm-integration.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/llm/llm-integration.docblock.d.ts
+
+declare const tech_llm_integration_DocBlocks: DocBlock[];
+//#endregion
+export { tech_llm_integration_DocBlocks };

package/dist/docs/tech/mcp-endpoints.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/mcp-endpoints.docblock.d.ts
+declare const tech_mcp_endpoints_DocBlocks: DocBlock[];
+//#endregion
+export { tech_mcp_endpoints_DocBlocks };

package/dist/docs/tech/presentation-runtime.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/presentation-runtime.docblock.d.ts
+declare const tech_presentation_runtime_DocBlocks: DocBlock[];
+//#endregion
+export { tech_presentation_runtime_DocBlocks };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/schema/README.docblock.d.ts
+declare const tech_schema_README_DocBlocks: DocBlock[];
+//#endregion
+export { tech_schema_README_DocBlocks };

package/dist/docs/tech/studio/learning-events.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/learning-events.docblock.d.ts
+declare const tech_studio_learning_events_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_learning_events_DocBlocks };

package/dist/docs/tech/studio/learning-journeys.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/learning-journeys.docblock.d.ts
+declare const tech_studio_learning_journeys_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_learning_journeys_DocBlocks };

package/dist/docs/tech/studio/platform-admin-panel.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/platform-admin-panel.docblock.d.ts
+declare const tech_studio_platform_admin_panel_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_platform_admin_panel_DocBlocks };

package/dist/docs/tech/studio/project-access-teams.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/project-access-teams.docblock.d.ts
+declare const tech_studio_project_access_teams_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_project_access_teams_DocBlocks };

package/dist/docs/tech/studio/project-routing.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/project-routing.docblock.d.ts
+declare const tech_studio_project_routing_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_project_routing_DocBlocks };

package/dist/docs/tech/studio/sandbox-unlogged.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/sandbox-unlogged.docblock.d.ts
+declare const tech_studio_sandbox_unlogged_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_sandbox_unlogged_DocBlocks };

package/dist/docs/tech/studio/team-invitations.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/team-invitations.docblock.d.ts
+declare const tech_studio_team_invitations_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_team_invitations_DocBlocks };

package/dist/docs/tech/studio/workspace-ops.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/workspace-ops.docblock.d.ts
+declare const tech_studio_workspace_ops_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_workspace_ops_DocBlocks };

package/dist/docs/tech/studio/workspaces.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/studio/workspaces.docblock.d.ts
+declare const tech_studio_workspaces_DocBlocks: DocBlock[];
+//#endregion
+export { tech_studio_workspaces_DocBlocks };

package/dist/docs/tech/telemetry-ingest.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/telemetry-ingest.docblock.d.ts
+declare const tech_telemetry_ingest_DocBlocks: DocBlock[];
+//#endregion
+export { tech_telemetry_ingest_DocBlocks };

package/dist/docs/tech/templates/runtime.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/templates/runtime.docblock.d.ts
+declare const tech_templates_runtime_DocBlocks: DocBlock[];
+//#endregion
+export { tech_templates_runtime_DocBlocks };

package/dist/docs/tech/vscode-extension.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/vscode-extension.docblock.d.ts
+declare const tech_vscode_extension_DocBlocks: DocBlock[];
+//#endregion
+export { tech_vscode_extension_DocBlocks };

package/dist/docs/tech/workflows/overview.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/tech/workflows/overview.docblock.d.ts
+declare const tech_workflows_overview_DocBlocks: DocBlock[];
+//#endregion
+export { tech_workflows_overview_DocBlocks };

package/dist/docs/tech-contracts.docs.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "./types.js";
+
+//#region src/docs/tech-contracts.docs.d.ts
+declare const techContractsDocs: DocBlock[];
+//#endregion
+export { techContractsDocs };

package/dist/docs/types.d.ts

@@ -0,0 +1,41 @@
+import { Stability } from "../ownership.js";
+
+//#region src/docs/types.d.ts
+type DocVisibility = 'public' | 'internal' | 'mixed';
+interface DocBlockLink {
+  label: string;
+  href: string;
+}
+type DocKind = 'goal' | 'how' | 'usage' | 'reference' | 'faq';
+interface DocBlock {
+  /** Globally unique identifier (prefer dotted paths like docs.ops.runbook). */
+  id: string;
+  /** Short, human-readable title. */
+  title: string;
+  /** Markdown body (LLM- and human-readable). */
+  body: string;
+  /** Optional one-line summary used for meta.description. */
+  summary?: string;
+  /** Explicit route (e.g., /docs/ops/anomaly-detection). Falls back to id-derived route. */
+  route?: string;
+  /** Optional semantic grouping for filtering. */
+  kind?: DocKind;
+  /** Visibility gate. Defaults to public. */
+  visibility?: DocVisibility;
+  /** Optional version to allow evolutions without breaking links. Defaults to 1. */
+  version?: number;
+  /** Tags to aid discovery and filtering. */
+  tags?: string[];
+  /** Owning teams or individuals. */
+  owners?: string[];
+  /** Related contract/presentation identifiers. */
+  relatedSpecs?: string[];
+  /** External references or supporting links. */
+  links?: DocBlockLink[];
+  /** Domain or bounded context marker. */
+  domain?: string;
+  /** Stability marker to mirror presentation ownership semantics. */
+  stability?: Stability;
+}
+//#endregion
+export { DocBlock, DocBlockLink, DocKind, DocVisibility };

package/dist/events.d.ts

@@ -0,0 +1,47 @@
+import { OwnerShipMeta } from "./ownership.js";
+import { DocId } from "./docs/registry.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+
+//#region src/events.d.ts
+
+/**
+ * Typed event specification. Declare once, validate payloads at publish time,
+ * and guard emissions via the contracts runtime.
+ */
+interface EventSpec<T extends AnySchemaModel> {
+  /** Fully-qualified event name, e.g. "sigil.magic_link.created". */
+  name: string;
+  /** Event payload version. Bump on any breaking payload change. */
+  version: number;
+  /** Short human-friendly summary. */
+  description?: string;
+  /** JSON-like paths to redact from logs/exports. */
+  pii?: string[];
+  /** Event payload schema from @lssm/lib.schema. */
+  payload: T;
+  /** Optional ownership metadata for governance and docs. */
+  ownership?: OwnerShipMeta;
+  /** Optional doc block id for this event. */
+  docId?: DocId;
+}
+/** Identity function to keep type inference when declaring events. */
+declare function defineEvent<T extends AnySchemaModel>(e: EventSpec<T>): EventSpec<T>;
+interface EventEnvelope<T> {
+  /** Unique identifier for the published event (UUID recommended). */
+  id: string;
+  /** ISO timestamp when the event occurred. */
+  occurredAt: string;
+  /** Optional trace identifier for correlating across services. */
+  traceId?: string;
+  /** Event name as published (should match spec.name). */
+  name: string;
+  /** Event version as published (should match spec.version). */
+  version: number;
+  /** Validated payload. */
+  payload: T;
+}
+type EventKey = `${string}.v${number}`;
+/** Build a stable string key for an event name/version pair. */
+declare const eventKey: (name: string, version: number) => EventKey;
+//#endregion
+export { EventEnvelope, EventKey, EventSpec, defineEvent, eventKey };

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

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/experiments/docs/experiments.docblock.d.ts
+declare const tech_contracts_experiments_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_experiments_DocBlocks };

package/dist/experiments/evaluator.d.ts

@@ -0,0 +1,37 @@
+import { PolicyRef } from "../policy/spec.js";
+import { ExperimentRegistry, ExperimentVariant } from "./spec.js";
+
+//#region src/experiments/evaluator.d.ts
+interface ExperimentContext {
+  experiment: string;
+  version?: number;
+  userId?: string | null;
+  organizationId?: string | null;
+  sessionId?: string | null;
+  attributes?: Record<string, unknown>;
+  flags?: string[];
+}
+interface ExperimentEvaluation {
+  variant: ExperimentVariant;
+  reason: 'control' | 'random' | 'sticky' | 'targeted';
+}
+interface ExperimentEvaluatorConfig {
+  registry: ExperimentRegistry;
+  policyChecker?: (policy: PolicyRef, context: ExperimentContext) => Promise<boolean> | boolean;
+  expressionEvaluator?: (expression: string, context: ExperimentContext) => boolean;
+}
+declare class ExperimentEvaluator {
+  private readonly registry;
+  private readonly policyChecker?;
+  private readonly expressionEvaluator?;
+  constructor(config: ExperimentEvaluatorConfig);
+  chooseVariant(context: ExperimentContext): Promise<ExperimentEvaluation | null>;
+  private pickByWeight;
+  private randomSeed;
+  private stickySeed;
+  private hashToUnitInterval;
+  private evaluateTargeting;
+  private matchesRule;
+}
+//#endregion
+export { ExperimentContext, ExperimentEvaluation, ExperimentEvaluator, ExperimentEvaluatorConfig };