@lssm/lib.contracts 0.0.0-canary-20251221114240 → 0.0.0-canary-20251221144710

package/dist/markdown.js

@@ -1,13 +1,14 @@
-import { isEmitDeclRef } from "./operation.js";
+import { isEmitDeclRef } from "./operations/operation.js";
+import "./operations/index.js";
 
 //#region src/markdown.ts
 /**
 * Render simple Markdown docs for each spec.
 * Useful for dev portals and repo docs generation.
 */
-function specsToMarkdown(reg, _extras) {
+function operationsToMarkdown(registry, _extras) {
 	const lines = [];
-	for (const spec of reg.listSpecs()) {
+	for (const spec of registry.listSpecs()) {
 		const m = spec.meta;
 		lines.push(`# ${m.name}.v${m.version}`);
 		lines.push("");
@@ -72,7 +73,7 @@ function specsToMarkdown(reg, _extras) {
 /** Render presentations and features as additional sections. */
 function docsToMarkdown(reg, extras) {
 	const parts = [];
-	parts.push(specsToMarkdown(reg, extras));
+	parts.push(operationsToMarkdown(reg, extras));
 	if (extras.presentations) {
 		parts.push("# Presentations");
 		parts.push("");
@@ -113,4 +114,4 @@ function docsToMarkdown(reg, extras) {
 }
 
 //#endregion
-export { docsToMarkdown, specsToMarkdown };
+export { docsToMarkdown, operationsToMarkdown };

package/dist/onboarding-base.d.ts

@@ -1,135 +1,136 @@
-import { OperationSpec } from "./operation.js";
-import * as _lssm_lib_schema61 from "@lssm/lib.schema";
+import { OperationSpec } from "./operations/operation.js";
+import "./index.js";
+import * as _lssm_lib_schema7 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/onboarding-base.d.ts
 /** Save/update onboarding draft (auto-save during flow) */
 declare const SaveOnboardingDraftInput: SchemaModel<{
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftBaseSpec: OperationSpec<SchemaModel<{
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: false;
   };
 }>, undefined>;
 /** Get current onboarding draft (on mount/restore) */
 declare const GetOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema61.FieldType<Date, string>;
+    type: _lssm_lib_schema7.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema61.FieldType<Date, string>;
+    type: _lssm_lib_schema7.FieldType<Date, string>;
     isOptional: true;
   };
 }>;
-declare const GetOnboardingDraftBaseSpec: OperationSpec<_lssm_lib_schema61.AnySchemaModel, SchemaModel<{
+declare const GetOnboardingDraftBaseSpec: OperationSpec<_lssm_lib_schema7.AnySchemaModel, SchemaModel<{
   id: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema61.FieldType<Date, string>;
+    type: _lssm_lib_schema7.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema61.FieldType<Date, string>;
+    type: _lssm_lib_schema7.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 /** Delete onboarding draft (cleanup after completion or cancel) */
 declare const DeleteOnboardingDraftOutput: SchemaModel<{
   ok: {
-    type: _lssm_lib_schema61.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema7.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>;
-declare const DeleteOnboardingDraftBaseSpec: OperationSpec<_lssm_lib_schema61.AnySchemaModel, SchemaModel<{
+declare const DeleteOnboardingDraftBaseSpec: OperationSpec<_lssm_lib_schema7.AnySchemaModel, SchemaModel<{
   ok: {
-    type: _lssm_lib_schema61.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema7.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 /** Complete onboarding (final submit, creates entities) */
 declare const CompleteOnboardingBaseInput: SchemaModel<{
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const CompleteOnboardingBaseOutput: SchemaModel<{
   success: {
-    type: _lssm_lib_schema61.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema7.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
 }>;
 declare const CompleteOnboardingBaseSpec: OperationSpec<SchemaModel<{
   data: {
-    type: _lssm_lib_schema61.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema7.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema61.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema7.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _lssm_lib_schema61.FieldType<string, string>;
+    type: _lssm_lib_schema7.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/onboarding-base.js

@@ -1,6 +1,7 @@
 import { E5, x8 } from "./schema/dist/index.js";
-import { defineCommand, defineQuery } from "./operation.js";
 import { OwnersEnum, StabilityEnum } from "./ownership.js";
+import { defineCommand, defineQuery } from "./operations/operation.js";
+import "./operations/index.js";
 
 //#region src/onboarding-base.ts
 /**

package/dist/openapi.d.ts

@@ -1,4 +1,4 @@
-import { OperationSpecRegistry } from "./registry.js";
+import { OperationSpecRegistry } from "./operations/registry.js";
 
 //#region src/openapi.d.ts
 

package/dist/operations/index.d.ts

@@ -0,0 +1,3 @@
+import { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "./operation.js";
+import { OperationKey, OperationSpecRegistry, opKey } from "./registry.js";
+export { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationKey, OperationSpec, OperationSpecRegistry, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef, opKey };

package/dist/operations/index.js

@@ -0,0 +1,4 @@
+import { defineCommand, defineQuery, isEmitDeclRef } from "./operation.js";
+import { OperationSpecRegistry, opKey } from "./registry.js";
+
+export { OperationSpecRegistry, defineCommand, defineQuery, isEmitDeclRef, opKey };

package/dist/{operation.d.ts → operations/operation.d.ts}

@@ -1,12 +1,12 @@
-import { Owner, Stability, Tag } from "./ownership.js";
-import { DocId } from "./docs/registry.js";
-import { EventSpec } from "./events.js";
-import { ResourceRefDescriptor } from "./resources.js";
-import { PolicyRef } from "./policy/spec.js";
-import { TestSpecRef } from "./tests/spec.js";
+import { Owner, Stability, Tag } from "../ownership.js";
+import { DocId } from "../docs/registry.js";
+import { EventSpec } from "../events.js";
+import { ResourceRefDescriptor } from "../resources.js";
+import { PolicyRef } from "../policy/spec.js";
+import { TestSpecRef } from "../tests/spec.js";
 import { AnySchemaModel } from "@lssm/lib.schema";
 
-//#region src/operation.d.ts
+//#region src/operations/operation.d.ts
 
 /**
  * Distinguishes between state-changing operations (command) and read-only operations (query).

package/dist/{operation.js → operations/operation.js}

@@ -1,4 +1,4 @@
-//#region src/operation.ts
+//#region src/operations/operation.ts
 const isEmitDeclRef = (e) => "ref" in e;
 /**
 * Helper to define a Command (write operation).

package/dist/{registry.d.ts → operations/registry.d.ts}

@@ -1,11 +1,11 @@
-import { defaultDocRegistry, docId, registerDocBlocks } from "./docs/registry.js";
-import { ResourceRefDescriptor } from "./resources.js";
+import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
+import { ResourceRefDescriptor } from "../resources.js";
 import { AnyOperationSpec, OperationSpec } from "./operation.js";
-import { HandlerCtx } from "./types.js";
-import { HandlerForOperationSpec } from "./install.js";
+import { HandlerCtx } from "../types.js";
+import { HandlerForOperationSpec } from "../install.js";
 import { AnySchemaModel } from "@lssm/lib.schema";
 
-//#region src/registry.d.ts
+//#region src/operations/registry.d.ts
 
 type OperationKey = `${string}.v${number}`;
 declare function opKey(name: string, version: number): OperationKey;
@@ -53,6 +53,38 @@ declare class OperationSpecRegistry {
     spec: AnyOperationSpec;
     handler: AnyOperationHandler;
   }[];
+  /**
+   * Filter specs by criteria.
+   */
+  filter(criteria: RegistryFilter): AnyOperationSpec[];
+  /**
+   * List specs with specific tag.
+   */
+  listByTag(tag: string): AnyOperationSpec[];
+  /**
+   * List specs by owner.
+   */
+  listByOwner(owner: string): AnyOperationSpec[];
+  /**
+   * Group specs by key function.
+   */
+  groupBy(keyFn: GroupKeyFn<AnyOperationSpec>): Map<string, AnyOperationSpec[]>;
+  /**
+   * Group by domain (first segment of name).
+   */
+  groupByDomain(): Map<string, AnyOperationSpec[]>;
+  /**
+   * Group by tag.
+   */
+  groupByTag(): Map<string, AnyOperationSpec[]>;
+  /**
+   * Get unique tags from all specs.
+   */
+  getUniqueTags(): string[];
+  /**
+   * Get unique owners from all specs.
+   */
+  getUniqueOwners(): string[];
   /**
    * Execute an operation by name/version with full runtime protections:
    * 1. Validates input against Zod schema.
@@ -69,4 +101,4 @@ declare class OperationSpecRegistry {
   execute(name: string, version: number | undefined, rawInput: unknown, ctx: HandlerCtx): Promise<unknown>;
 }
 //#endregion
-export { OperationKey, OperationSpecRegistry, defaultDocRegistry, docId, opKey, registerDocBlocks };
+export { OperationKey, OperationSpecRegistry, opKey };

package/dist/{registry.js → operations/registry.js}

@@ -1,8 +1,9 @@
-import { eventKey } from "./events.js";
+import { __toCommonJS } from "../_virtual/rolldown_runtime.js";
+import { eventKey } from "../events.js";
+import { init_registry_utils, registry_utils_exports } from "../registry-utils.js";
 import { isEmitDeclRef } from "./operation.js";
-import { defaultDocRegistry, docId, registerDocBlocks } from "./docs/registry.js";
 
-//#region src/registry.ts
+//#region src/operations/registry.ts
 /**
 * OperationSpecRegistry:
 * - Registers ContractSpecs (unique by name+version)
@@ -94,6 +95,60 @@ var OperationSpecRegistry = class {
 		return out;
 	}
 	/**
+	* Filter specs by criteria.
+	*/
+	filter(criteria) {
+		const { filterBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return filterBy(this.listSpecs(), criteria);
+	}
+	/**
+	* List specs with specific tag.
+	*/
+	listByTag(tag) {
+		return this.listSpecs().filter((s) => s.meta.tags?.includes(tag));
+	}
+	/**
+	* List specs by owner.
+	*/
+	listByOwner(owner) {
+		return this.listSpecs().filter((s) => s.meta.owners?.includes(owner));
+	}
+	/**
+	* Group specs by key function.
+	*/
+	groupBy(keyFn) {
+		const { groupBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return groupBy(this.listSpecs(), keyFn);
+	}
+	/**
+	* Group by domain (first segment of name).
+	*/
+	groupByDomain() {
+		const { GroupingStrategies } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return this.groupBy(GroupingStrategies.byDomain);
+	}
+	/**
+	* Group by tag.
+	*/
+	groupByTag() {
+		const { GroupingStrategies } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return this.groupBy(GroupingStrategies.byTag);
+	}
+	/**
+	* Get unique tags from all specs.
+	*/
+	getUniqueTags() {
+		const { getUniqueTags } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return getUniqueTags(this.listSpecs());
+	}
+	/**
+	* Get unique owners from all specs.
+	*/
+	getUniqueOwners() {
+		const { getUniqueOwners } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return getUniqueOwners(this.listSpecs());
+	}
+	/**
 	* Execute an operation by name/version with full runtime protections:
 	* 1. Validates input against Zod schema.
 	* 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.
@@ -206,4 +261,4 @@ var OperationSpecRegistry = class {
 };
 
 //#endregion
-export { OperationSpecRegistry, defaultDocRegistry, docId, opKey, registerDocBlocks };
+export { OperationSpecRegistry, opKey };

package/dist/policy/docs/policy.docblock.js

@@ -1,5 +1,4 @@
 import { registerDocBlocks } from "../../docs/registry.js";
-import "../../registry.js";
 
 //#region src/policy/docs/policy.docblock.ts
 const tech_contracts_policy_DocBlocks = [{

package/dist/presentations/docs/presentations-conventions.docblock.js

@@ -1,5 +1,4 @@
 import { registerDocBlocks } from "../../docs/registry.js";
-import "../../registry.js";
 
 //#region src/presentations/docs/presentations-conventions.docblock.ts
 const tech_contracts_presentations_conventions_DocBlocks = [{

package/dist/presentations/index.d.ts

@@ -0,0 +1,4 @@
+import { PresentationDescriptorV2, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta } from "./presentations.v2.js";
+import { ComponentMap, PresentationRenderer, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./transform-engine.js";
+import { DataPresentation, MarkdownPresentation, PresentationContent, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationSpec, WebComponentPresentation, jsonSchemaForPresentation } from "./presentations.js";
+export { ComponentMap, DataPresentation, MarkdownPresentation, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, WebComponentPresentation, createDefaultTransformEngine, jsonSchemaForPresentation, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer };

package/dist/presentations/index.js

@@ -0,0 +1,4 @@
+import { TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./transform-engine.js";
+import { PresentationRegistry, jsonSchemaForPresentation } from "./presentations.js";
+
+export { PresentationRegistry, TransformEngine, createDefaultTransformEngine, jsonSchemaForPresentation, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer };

package/dist/{presentations.d.ts → presentations/presentations.d.ts}

@@ -1,9 +1,10 @@
-import { Stability } from "./ownership.js";
+import { Stability } from "../ownership.js";
+import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
 import z from "zod";
-import * as _lssm_lib_schema234 from "@lssm/lib.schema";
+import * as _lssm_lib_schema154 from "@lssm/lib.schema";
 import { AnySchemaModel } from "@lssm/lib.schema";
 
-//#region src/presentations.d.ts
+//#region src/presentations/presentations.d.ts
 /** V1 presentation kinds (back-compat). Prefer V2 descriptors for new work. */
 type PresentationKind = 'web_component' | 'markdown' | 'data';
 /** Minimal metadata for presentations (V1). */
@@ -58,11 +59,21 @@ declare class PresentationRegistry {
   register(p: PresentationSpec): this;
   list(): PresentationSpec[];
   get(name: string, version?: number): PresentationSpec | undefined;
+  /** Filter presentations by criteria. */
+  filter(criteria: RegistryFilter): PresentationSpec[];
+  /** List presentations with specific tag. */
+  listByTag(tag: string): PresentationSpec[];
+  /** List presentations by owner. */
+  listByOwner(owner: string): PresentationSpec[];
+  /** Group presentations by key function. */
+  groupBy(keyFn: GroupKeyFn<PresentationSpec>): Map<string, PresentationSpec[]>;
+  /** Get unique tags from all presentations. */
+  getUniqueTags(): string[];
 }
 declare function jsonSchemaForPresentation(p: PresentationSpec): {
   framework: "react";
   componentKey: string;
-  props: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema234.TopLevelZodFromModel<_lssm_lib_schema234.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema234.AnyFieldType | _lssm_lib_schema234.AnyEnumType>>>;
+  props: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema154.TopLevelZodFromModel<_lssm_lib_schema154.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema154.AnyFieldType | _lssm_lib_schema154.AnyEnumType>>>;
   meta: {
     readonly name: string;
     readonly version: number;
@@ -84,7 +95,7 @@ declare function jsonSchemaForPresentation(p: PresentationSpec): {
   kind: PresentationKind;
 } | {
   mimeType: string;
-  model: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema234.TopLevelZodFromModel<_lssm_lib_schema234.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema234.AnyFieldType | _lssm_lib_schema234.AnyEnumType>>>;
+  model: z.core.ZodStandardJSONSchemaPayload<_lssm_lib_schema154.TopLevelZodFromModel<_lssm_lib_schema154.SchemaModelFieldsAnyConfig<AnySchemaModel | _lssm_lib_schema154.AnyFieldType | _lssm_lib_schema154.AnyEnumType>>>;
   meta: {
     readonly name: string;
     readonly version: number;

package/dist/{presentations.js → presentations/presentations.js}

@@ -1,6 +1,8 @@
+import { __toCommonJS } from "../_virtual/rolldown_runtime.js";
+import { init_registry_utils, registry_utils_exports } from "../registry-utils.js";
 import z from "zod";
 
-//#region src/presentations.ts
+//#region src/presentations/presentations.ts
 function keyOf(p) {
 	return `${p.meta.name}.v${p.meta.version}`;
 }
@@ -32,6 +34,29 @@ var PresentationRegistry = class {
 		}
 		return candidate;
 	}
+	/** Filter presentations by criteria. */
+	filter(criteria) {
+		const { filterBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return filterBy(this.list(), criteria);
+	}
+	/** List presentations with specific tag. */
+	listByTag(tag) {
+		return this.list().filter((p) => p.meta.tags?.includes(tag));
+	}
+	/** List presentations by owner. */
+	listByOwner(owner) {
+		return this.list().filter((p) => p.meta.owners?.includes(owner));
+	}
+	/** Group presentations by key function. */
+	groupBy(keyFn) {
+		const { groupBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return groupBy(this.list(), keyFn);
+	}
+	/** Get unique tags from all presentations. */
+	getUniqueTags() {
+		const { getUniqueTags } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return getUniqueTags(this.list());
+	}
 };
 function jsonSchemaForPresentation(p) {
 	const base = {

package/dist/presentations/presentations.v2.d.ts

@@ -0,0 +1,54 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { DocId } from "../docs/registry.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+import { BlockConfig } from "@blocknote/core";
+
+//#region src/presentations/presentations.v2.d.ts
+/** Supported render targets for the transform engine and descriptors. */
+type PresentationTarget = 'react' | 'markdown' | 'application/json' | 'application/xml';
+interface PresentationV2Meta extends Partial<OwnerShipMeta> {
+  /** Fully-qualified presentation name (e.g., "sigil.auth.webauth_tabs_v2"). */
+  name: string;
+  /** Version of this descriptor. Increment on breaking changes. */
+  version: number;
+  /** Human-readable description for docs/a11y. Required by validators. */
+  description?: string;
+  /** Optional doc block id for this presentation. */
+  docId?: DocId;
+}
+/** React component presentation source. */
+interface PresentationSourceComponentReact {
+  /** Source marker for React component presentations. */
+  type: 'component';
+  /** Framework for the component source (currently only 'react'). */
+  framework: 'react';
+  /** Component key resolved by host `componentMap`. */
+  componentKey: string;
+  /** Optional props schema to validate against. */
+  props?: AnySchemaModel;
+}
+/** BlockNoteJS document presentation source. */
+interface PresentationSourceBlocknotejs {
+  /** Source marker for BlockNoteJS document presentations. */
+  type: 'blocknotejs';
+  /** BlockNoteJS JSON document. */
+  docJson: unknown;
+  /** Optional BlockNote config to guide rendering. */
+  blockConfig?: BlockConfig;
+}
+type PresentationSource = PresentationSourceComponentReact | PresentationSourceBlocknotejs;
+/**
+ * Normalized presentation descriptor decoupled from framework/adapters.
+ * Renderers and validators are provided via TransformEngine.
+ */
+interface PresentationDescriptorV2 {
+  meta: PresentationV2Meta;
+  policy?: {
+    flags?: string[];
+    pii?: string[];
+  };
+  source: PresentationSource;
+  targets: PresentationTarget[];
+}
+//#endregion
+export { PresentationDescriptorV2, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta };

package/dist/{presentations.v2.d.ts → presentations/transform-engine.d.ts}

@@ -1,56 +1,8 @@
-import { OwnerShipMeta } from "./ownership.js";
-import { DocId } from "./docs/registry.js";
+import { PresentationDescriptorV2, PresentationTarget } from "./presentations.v2.js";
 import React from "react";
-import { AnySchemaModel } from "@lssm/lib.schema";
 import { BlockConfig } from "@blocknote/core";
 
-//#region src/presentations.v2.d.ts
-/** Supported render targets for the transform engine and descriptors. */
-type PresentationTarget = 'react' | 'markdown' | 'application/json' | 'application/xml';
-interface PresentationV2Meta extends Partial<OwnerShipMeta> {
-  /** Fully-qualified presentation name (e.g., "sigil.auth.webauth_tabs_v2"). */
-  name: string;
-  /** Version of this descriptor. Increment on breaking changes. */
-  version: number;
-  /** Human-readable description for docs/a11y. Required by validators. */
-  description?: string;
-  /** Optional doc block id for this presentation. */
-  docId?: DocId;
-}
-/** React component presentation source. */
-interface PresentationSourceComponentReact {
-  /** Source marker for React component presentations. */
-  type: 'component';
-  /** Framework for the component source (currently only 'react'). */
-  framework: 'react';
-  /** Component key resolved by host `componentMap`. */
-  componentKey: string;
-  /** Optional props schema to validate against. */
-  props?: AnySchemaModel;
-}
-/** BlockNoteJS document presentation source. */
-interface PresentationSourceBlocknotejs {
-  /** Source marker for BlockNoteJS document presentations. */
-  type: 'blocknotejs';
-  /** BlockNoteJS JSON document. */
-  docJson: unknown;
-  /** Optional BlockNote config to guide rendering. */
-  blockConfig?: BlockConfig;
-}
-type PresentationSource = PresentationSourceComponentReact | PresentationSourceBlocknotejs;
-/**
- * Normalized presentation descriptor decoupled from framework/adapters.
- * Renderers and validators are provided via TransformEngine.
- */
-interface PresentationDescriptorV2 {
-  meta: PresentationV2Meta;
-  policy?: {
-    flags?: string[];
-    pii?: string[];
-  };
-  source: PresentationSource;
-  targets: PresentationTarget[];
-}
+//#region src/presentations/transform-engine.d.ts
 interface RenderContext {
   /** Optional locale hint (i18n). */
   locale?: string;
@@ -111,4 +63,4 @@ type ComponentMap = Record<string, React.ComponentType<any>>;
  */
 declare function registerReactToMarkdownRenderer(engine: TransformEngine, componentMap: ComponentMap): TransformEngine;
 //#endregion
-export { ComponentMap, PresentationDescriptorV2, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer };
+export { ComponentMap, PresentationRenderer, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer };

package/dist/{presentations.v2.js → presentations/transform-engine.js}

@@ -1,8 +1,8 @@
-import { schemaToMarkdown } from "./schema-to-markdown.js";
+import { schemaToMarkdown } from "../schema-to-markdown.js";
 import React from "react";
 import TurndownService from "turndown";
 
-//#region src/presentations.v2.ts
+//#region src/presentations/transform-engine.ts
 /**
 * Pluggable transform engine that renders descriptors to various targets
 * and runs validators (e.g., basic metadata checks, PII redaction policies).

package/dist/regenerator/docs/regenerator.docblock.js

@@ -1,5 +1,4 @@
 import { registerDocBlocks } from "../../docs/registry.js";
-import "../../registry.js";
 
 //#region src/regenerator/docs/regenerator.docblock.ts
 const tech_contracts_regenerator_DocBlocks = [{