@contractspec/lib.personalization 1.56.1 → 1.58.0

package/dist/docs/behavior-tracking.docblock.d.ts

@@ -1,7 +1,3 @@
-import { DocBlock } from "@contractspec/lib.contracts/docs";
-
-//#region src/docs/behavior-tracking.docblock.d.ts
-declare const personalization_behavior_tracking_DocBlocks: DocBlock[];
-//#endregion
-export { personalization_behavior_tracking_DocBlocks };
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+export declare const personalization_behavior_tracking_DocBlocks: DocBlock[];
 //# sourceMappingURL=behavior-tracking.docblock.d.ts.map

package/dist/docs/behavior-tracking.docblock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behavior-tracking.docblock.d.ts","names":[],"sources":["../../src/docs/behavior-tracking.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,6CAA6C"}
+{"version":3,"file":"behavior-tracking.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/behavior-tracking.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,2CAA2C,EAAE,QAAQ,EAYjE,CAAC"}

package/dist/docs/behavior-tracking.docblock.js

@@ -1,18 +1,98 @@
+// @bun
+// src/docs/behavior-tracking.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var personalization_behavior_tracking_DocBlocks = [
+  {
+    id: "docs.personalization.behavior-tracking",
+    title: "Behavior Tracking",
+    summary: "`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/behavior-tracking",
+    tags: ["personalization", "behavior-tracking"],
+    body: `# Behavior Tracking
+
+\`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
+
+## Tracker
+
+\`\`\`ts
+import { createBehaviorTracker } from '@contractspec/lib.personalization';
+import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
+
+const tracker = createBehaviorTracker({
+  store: new InMemoryBehaviorStore(),
+  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },
+  autoFlushIntervalMs: 5000,
+});
+
+tracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });
+tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
+tracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });
+\`\`\`
+
+All events are buffered and flushed either when the buffer hits 25 entries or when \`autoFlushIntervalMs\` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.
+
+## Analyzer
+
+\`\`\`ts
+import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
+
+const analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });
+const insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });
+
+/*
+{
+  unusedFields: ['internalNotes'],
+  suggestedHiddenFields: ['internalNotes'],
+  frequentlyUsedFields: ['customerReference', 'items'],
+  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],
+  layoutPreference: 'table'
+}
+*/
+\`\`\`
+
+Use the analyzer output with the overlay adapter to generate suggestions automatically.
+
+## Adapter
+
+\`\`\`ts
+import { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';
+
+const overlay = insightsToOverlaySuggestion(insights, {
+  overlayId: 'acme-order-form',
+  tenantId: 'acme',
+  capability: 'billing.createOrder',
+});
+\`\`\`
+
+When the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.
+
+
+
 
-//#region src/docs/behavior-tracking.docblock.ts
-const personalization_behavior_tracking_DocBlocks = [{
-	id: "docs.personalization.behavior-tracking",
-	title: "Behavior Tracking",
-	summary: "`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/personalization/behavior-tracking",
-	tags: ["personalization", "behavior-tracking"],
-	body: "# Behavior Tracking\n\n`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.\n\n## Tracker\n\n```ts\nimport { createBehaviorTracker } from '@contractspec/lib.personalization';\nimport { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';\n\nconst tracker = createBehaviorTracker({\n  store: new InMemoryBehaviorStore(),\n  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },\n  autoFlushIntervalMs: 5000,\n});\n\ntracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });\ntracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\ntracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });\n```\n\nAll events are buffered and flushed either when the buffer hits 25 entries or when `autoFlushIntervalMs` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.\n\n## Analyzer\n\n```ts\nimport { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';\n\nconst analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });\nconst insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });\n\n/*\n{\n  unusedFields: ['internalNotes'],\n  suggestedHiddenFields: ['internalNotes'],\n  frequentlyUsedFields: ['customerReference', 'items'],\n  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],\n  layoutPreference: 'table'\n}\n*/\n```\n\nUse the analyzer output with the overlay adapter to generate suggestions automatically.\n\n## Adapter\n\n```ts\nimport { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';\n\nconst overlay = insightsToOverlaySuggestion(insights, {\n  overlayId: 'acme-order-form',\n  tenantId: 'acme',\n  capability: 'billing.createOrder',\n});\n```\n\nWhen the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
-}];
-registerDocBlocks(personalization_behavior_tracking_DocBlocks);
 
-//#endregion
-export { personalization_behavior_tracking_DocBlocks };
-//# sourceMappingURL=behavior-tracking.docblock.js.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks(personalization_behavior_tracking_DocBlocks);
+export {
+  personalization_behavior_tracking_DocBlocks
+};

package/dist/docs/index.d.ts

@@ -1,3 +1,4 @@
-import "./behavior-tracking.docblock.js";
-import "./overlay-engine.docblock.js";
-import "./workflow-composition.docblock.js";
+import './behavior-tracking.docblock';
+import './overlay-engine.docblock';
+import './workflow-composition.docblock';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,8BAA8B,CAAC;AACtC,OAAO,2BAA2B,CAAC;AACnC,OAAO,iCAAiC,CAAC"}

package/dist/docs/index.js

@@ -1,3 +1,272 @@
-import "./behavior-tracking.docblock.js";
-import "./overlay-engine.docblock.js";
-import "./workflow-composition.docblock.js";
+// @bun
+// src/docs/behavior-tracking.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var personalization_behavior_tracking_DocBlocks = [
+  {
+    id: "docs.personalization.behavior-tracking",
+    title: "Behavior Tracking",
+    summary: "`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/behavior-tracking",
+    tags: ["personalization", "behavior-tracking"],
+    body: `# Behavior Tracking
+
+\`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
+
+## Tracker
+
+\`\`\`ts
+import { createBehaviorTracker } from '@contractspec/lib.personalization';
+import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
+
+const tracker = createBehaviorTracker({
+  store: new InMemoryBehaviorStore(),
+  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },
+  autoFlushIntervalMs: 5000,
+});
+
+tracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });
+tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
+tracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });
+\`\`\`
+
+All events are buffered and flushed either when the buffer hits 25 entries or when \`autoFlushIntervalMs\` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.
+
+## Analyzer
+
+\`\`\`ts
+import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
+
+const analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });
+const insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });
+
+/*
+{
+  unusedFields: ['internalNotes'],
+  suggestedHiddenFields: ['internalNotes'],
+  frequentlyUsedFields: ['customerReference', 'items'],
+  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],
+  layoutPreference: 'table'
+}
+*/
+\`\`\`
+
+Use the analyzer output with the overlay adapter to generate suggestions automatically.
+
+## Adapter
+
+\`\`\`ts
+import { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';
+
+const overlay = insightsToOverlaySuggestion(insights, {
+  overlayId: 'acme-order-form',
+  tenantId: 'acme',
+  capability: 'billing.createOrder',
+});
+\`\`\`
+
+When the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks(personalization_behavior_tracking_DocBlocks);
+
+// src/docs/overlay-engine.docblock.ts
+import { registerDocBlocks as registerDocBlocks2 } from "@contractspec/lib.contracts/docs";
+var personalization_overlay_engine_DocBlocks = [
+  {
+    id: "docs.personalization.overlay-engine",
+    title: "Overlay Engine",
+    summary: "`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/overlay-engine",
+    tags: ["personalization", "overlay-engine"],
+    body: `# Overlay Engine
+
+\`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
+
+## Key APIs
+
+- \`defineOverlay(spec)\` \u2013 helper to keep specs typed.
+- \`OverlayRegistry\` \u2013 register signed overlays and retrieve them per context.
+- \`OverlayEngine\` \u2013 apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
+- \`signOverlay(spec, privateKey)\` \u2013 Ed25519/RSA-PSS signer.
+- \`verifyOverlaySignature(overlay)\` \u2013 verify public key signatures.
+- \`useOverlay(engine, params)\` \u2013 client hook that returns \`{ target, overlaysApplied }\`.
+
+## Scope Precedence
+
+Registrations are sorted by specificity:
+
+1. Tenant overlays
+2. Role overlays
+3. User overlays
+4. Device overlays
+
+Less specific overlays run first; more specific overlays override later.
+
+## Example
+
+\`\`\`ts
+const registry = new OverlayRegistry();
+const engine = new OverlayEngine({
+  registry,
+  audit: (event) => auditLogService.record(event),
+});
+
+const overlay = defineOverlay({
+  overlayId: 'acme-order-form',
+  version: '1.0.0',
+  appliesTo: {
+    capability: 'billing.createOrder',
+    tenantId: 'acme',
+  },
+  modifications: [
+    { type: 'hideField', field: 'internalNotes' },
+    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },
+  ],
+});
+
+const signedOverlay = await signOverlay(overlay, privateKeyPem);
+registry.register(signedOverlay);
+
+const result = engine.apply({
+  target: { fields: baseFields },
+  capability: 'billing.createOrder',
+  tenantId: 'acme',
+  userId: 'manager-7',
+});
+\`\`\`
+
+\`result.target.fields\` now carries the hidden and renamed outputs ready for rendering.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks2(personalization_overlay_engine_DocBlocks);
+
+// src/docs/workflow-composition.docblock.ts
+import { registerDocBlocks as registerDocBlocks3 } from "@contractspec/lib.contracts/docs";
+var personalization_workflow_composition_DocBlocks = [
+  {
+    id: "docs.personalization.workflow-composition",
+    title: "Workflow Composition",
+    summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/workflow-composition",
+    tags: ["personalization", "workflow-composition"],
+    body: `# Workflow Composition
+
+\`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
+
+## Extensions
+
+\`\`\`ts
+import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
+import { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';
+
+const composer = new WorkflowComposer();
+
+composer.register({
+  workflow: 'billing.invoiceApproval',
+  tenantId: 'acme',
+  priority: 10,
+  customSteps: [
+    {
+      after: 'validate-invoice',
+      inject: approvalStepTemplate({
+        id: 'acme-legal-review',
+        label: 'Legal Review (ACME)',
+        description: 'Tenant-specific compliance step.',
+      }),
+      transitionTo: 'final-approval',
+    },
+  ],
+  hiddenSteps: ['internal-audit'],
+});
+\`\`\`
+
+## Compose
+
+\`\`\`ts
+const runtimeSpec = composer.compose({
+  base: BaseInvoiceWorkflow,
+  tenantId: 'acme',
+});
+
+workflowRunner.execute(runtimeSpec, ctx);
+\`\`\`
+
+The composer uses anchor references (\`after\`/\`before\`) to place injected steps and cleans up transitions when steps are hidden.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks3(personalization_workflow_composition_DocBlocks);

package/dist/docs/overlay-engine.docblock.d.ts

@@ -1,7 +1,3 @@
-import { DocBlock } from "@contractspec/lib.contracts/docs";
-
-//#region src/docs/overlay-engine.docblock.d.ts
-declare const personalization_overlay_engine_DocBlocks: DocBlock[];
-//#endregion
-export { personalization_overlay_engine_DocBlocks };
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+export declare const personalization_overlay_engine_DocBlocks: DocBlock[];
 //# sourceMappingURL=overlay-engine.docblock.d.ts.map

package/dist/docs/overlay-engine.docblock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-engine.docblock.d.ts","names":[],"sources":["../../src/docs/overlay-engine.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,0CAA0C"}
+{"version":3,"file":"overlay-engine.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/overlay-engine.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,wCAAwC,EAAE,QAAQ,EAY9D,CAAC"}

package/dist/docs/overlay-engine.docblock.js

@@ -1,18 +1,99 @@
+// @bun
+// src/docs/overlay-engine.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var personalization_overlay_engine_DocBlocks = [
+  {
+    id: "docs.personalization.overlay-engine",
+    title: "Overlay Engine",
+    summary: "`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/overlay-engine",
+    tags: ["personalization", "overlay-engine"],
+    body: `# Overlay Engine
+
+\`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
+
+## Key APIs
+
+- \`defineOverlay(spec)\` \u2013 helper to keep specs typed.
+- \`OverlayRegistry\` \u2013 register signed overlays and retrieve them per context.
+- \`OverlayEngine\` \u2013 apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
+- \`signOverlay(spec, privateKey)\` \u2013 Ed25519/RSA-PSS signer.
+- \`verifyOverlaySignature(overlay)\` \u2013 verify public key signatures.
+- \`useOverlay(engine, params)\` \u2013 client hook that returns \`{ target, overlaysApplied }\`.
+
+## Scope Precedence
+
+Registrations are sorted by specificity:
+
+1. Tenant overlays
+2. Role overlays
+3. User overlays
+4. Device overlays
+
+Less specific overlays run first; more specific overlays override later.
+
+## Example
+
+\`\`\`ts
+const registry = new OverlayRegistry();
+const engine = new OverlayEngine({
+  registry,
+  audit: (event) => auditLogService.record(event),
+});
+
+const overlay = defineOverlay({
+  overlayId: 'acme-order-form',
+  version: '1.0.0',
+  appliesTo: {
+    capability: 'billing.createOrder',
+    tenantId: 'acme',
+  },
+  modifications: [
+    { type: 'hideField', field: 'internalNotes' },
+    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },
+  ],
+});
+
+const signedOverlay = await signOverlay(overlay, privateKeyPem);
+registry.register(signedOverlay);
+
+const result = engine.apply({
+  target: { fields: baseFields },
+  capability: 'billing.createOrder',
+  tenantId: 'acme',
+  userId: 'manager-7',
+});
+\`\`\`
+
+\`result.target.fields\` now carries the hidden and renamed outputs ready for rendering.
+
+
+
+
 
-//#region src/docs/overlay-engine.docblock.ts
-const personalization_overlay_engine_DocBlocks = [{
-	id: "docs.personalization.overlay-engine",
-	title: "Overlay Engine",
-	summary: "`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/personalization/overlay-engine",
-	tags: ["personalization", "overlay-engine"],
-	body: "# Overlay Engine\n\n`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.\n\n## Key APIs\n\n- `defineOverlay(spec)` – helper to keep specs typed.\n- `OverlayRegistry` – register signed overlays and retrieve them per context.\n- `OverlayEngine` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.\n- `signOverlay(spec, privateKey)` – Ed25519/RSA-PSS signer.\n- `verifyOverlaySignature(overlay)` – verify public key signatures.\n- `useOverlay(engine, params)` – client hook that returns `{ target, overlaysApplied }`.\n\n## Scope Precedence\n\nRegistrations are sorted by specificity:\n\n1. Tenant overlays\n2. Role overlays\n3. User overlays\n4. Device overlays\n\nLess specific overlays run first; more specific overlays override later.\n\n## Example\n\n```ts\nconst registry = new OverlayRegistry();\nconst engine = new OverlayEngine({\n  registry,\n  audit: (event) => auditLogService.record(event),\n});\n\nconst overlay = defineOverlay({\n  overlayId: 'acme-order-form',\n  version: '1.0.0',\n  appliesTo: {\n    capability: 'billing.createOrder',\n    tenantId: 'acme',\n  },\n  modifications: [\n    { type: 'hideField', field: 'internalNotes' },\n    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },\n  ],\n});\n\nconst signedOverlay = await signOverlay(overlay, privateKeyPem);\nregistry.register(signedOverlay);\n\nconst result = engine.apply({\n  target: { fields: baseFields },\n  capability: 'billing.createOrder',\n  tenantId: 'acme',\n  userId: 'manager-7',\n});\n```\n\n`result.target.fields` now carries the hidden and renamed outputs ready for rendering.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
-}];
-registerDocBlocks(personalization_overlay_engine_DocBlocks);
 
-//#endregion
-export { personalization_overlay_engine_DocBlocks };
-//# sourceMappingURL=overlay-engine.docblock.js.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks(personalization_overlay_engine_DocBlocks);
+export {
+  personalization_overlay_engine_DocBlocks
+};

package/dist/docs/workflow-composition.docblock.d.ts

@@ -1,7 +1,3 @@
-import { DocBlock } from "@contractspec/lib.contracts/docs";
-
-//#region src/docs/workflow-composition.docblock.d.ts
-declare const personalization_workflow_composition_DocBlocks: DocBlock[];
-//#endregion
-export { personalization_workflow_composition_DocBlocks };
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+export declare const personalization_workflow_composition_DocBlocks: DocBlock[];
 //# sourceMappingURL=workflow-composition.docblock.d.ts.map

package/dist/docs/workflow-composition.docblock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-composition.docblock.d.ts","names":[],"sources":["../../src/docs/workflow-composition.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,gDAAgD"}
+{"version":3,"file":"workflow-composition.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/workflow-composition.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,8CAA8C,EAAE,QAAQ,EAYpE,CAAC"}

package/dist/docs/workflow-composition.docblock.js

@@ -1,18 +1,84 @@
+// @bun
+// src/docs/workflow-composition.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var personalization_workflow_composition_DocBlocks = [
+  {
+    id: "docs.personalization.workflow-composition",
+    title: "Workflow Composition",
+    summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/personalization/workflow-composition",
+    tags: ["personalization", "workflow-composition"],
+    body: `# Workflow Composition
+
+\`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
+
+## Extensions
+
+\`\`\`ts
+import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
+import { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';
+
+const composer = new WorkflowComposer();
+
+composer.register({
+  workflow: 'billing.invoiceApproval',
+  tenantId: 'acme',
+  priority: 10,
+  customSteps: [
+    {
+      after: 'validate-invoice',
+      inject: approvalStepTemplate({
+        id: 'acme-legal-review',
+        label: 'Legal Review (ACME)',
+        description: 'Tenant-specific compliance step.',
+      }),
+      transitionTo: 'final-approval',
+    },
+  ],
+  hiddenSteps: ['internal-audit'],
+});
+\`\`\`
+
+## Compose
+
+\`\`\`ts
+const runtimeSpec = composer.compose({
+  base: BaseInvoiceWorkflow,
+  tenantId: 'acme',
+});
+
+workflowRunner.execute(runtimeSpec, ctx);
+\`\`\`
+
+The composer uses anchor references (\`after\`/\`before\`) to place injected steps and cleans up transitions when steps are hidden.
+
+
+
+
+
+
 
-//#region src/docs/workflow-composition.docblock.ts
-const personalization_workflow_composition_DocBlocks = [{
-	id: "docs.personalization.workflow-composition",
-	title: "Workflow Composition",
-	summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/personalization/workflow-composition",
-	tags: ["personalization", "workflow-composition"],
-	body: "# Workflow Composition\n\n`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.\n\n## Extensions\n\n```ts\nimport { WorkflowComposer } from '@contractspec/lib.workflow-composer';\nimport { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';\n\nconst composer = new WorkflowComposer();\n\ncomposer.register({\n  workflow: 'billing.invoiceApproval',\n  tenantId: 'acme',\n  priority: 10,\n  customSteps: [\n    {\n      after: 'validate-invoice',\n      inject: approvalStepTemplate({\n        id: 'acme-legal-review',\n        label: 'Legal Review (ACME)',\n        description: 'Tenant-specific compliance step.',\n      }),\n      transitionTo: 'final-approval',\n    },\n  ],\n  hiddenSteps: ['internal-audit'],\n});\n```\n\n## Compose\n\n```ts\nconst runtimeSpec = composer.compose({\n  base: BaseInvoiceWorkflow,\n  tenantId: 'acme',\n});\n\nworkflowRunner.execute(runtimeSpec, ctx);\n```\n\nThe composer uses anchor references (`after`/`before`) to place injected steps and cleans up transitions when steps are hidden.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
-}];
-registerDocBlocks(personalization_workflow_composition_DocBlocks);
 
-//#endregion
-export { personalization_workflow_composition_DocBlocks };
-//# sourceMappingURL=workflow-composition.docblock.js.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`
+  }
+];
+registerDocBlocks(personalization_workflow_composition_DocBlocks);
+export {
+  personalization_workflow_composition_DocBlocks
+};