@lssm/lib.personalization 0.0.0-canary-20251209233744 → 0.0.0-canary-20251210081515

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

@@ -0,0 +1,81 @@
+import{registerDocBlocks as e}from"../contracts/src/docs/registry.js";import"../contracts/src/docs/index.js";e([{id:`docs.personalization.overlay-engine`,title:`Overlay Engine`,summary:"`@lssm/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
+
+\`@lssm/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)\` – helper to keep specs typed.
+- \`OverlayRegistry\` – register signed overlays and retrieve them per context.
+- \`OverlayEngine\` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
+- \`signOverlay(spec, privateKey)\` – Ed25519/RSA-PSS signer.
+- \`verifyOverlaySignature(overlay)\` – verify public key signatures.
+- \`useOverlay(engine, params)\` – 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.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`}]);

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

@@ -0,0 +1,66 @@
+import{registerDocBlocks as e}from"../contracts/src/docs/registry.js";import"../contracts/src/docs/index.js";e([{id:`docs.personalization.workflow-composition`,title:`Workflow Composition`,summary:"`@lssm/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
+
+\`@lssm/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
+
+## Extensions
+
+\`\`\`ts
+import { WorkflowComposer } from '@lssm/lib.workflow-composer';
+import { approvalStepTemplate } from '@lssm/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.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`}]);

package/dist/index.js

@@ -1 +1 @@
-import{InMemoryBehaviorStore as e}from"./store.js";import{BehaviorTracker as t,createBehaviorTracker as n}from"./tracker.js";import{BehaviorAnalyzer as r}from"./analyzer.js";import{insightsToOverlaySuggestion as i,insightsToWorkflowAdaptations as a}from"./adapter.js";export{r as BehaviorAnalyzer,t as BehaviorTracker,e as InMemoryBehaviorStore,n as createBehaviorTracker,i as insightsToOverlaySuggestion,a as insightsToWorkflowAdaptations};
+import{InMemoryBehaviorStore as e}from"./store.js";import{BehaviorTracker as t,createBehaviorTracker as n}from"./tracker.js";import{BehaviorAnalyzer as r}from"./analyzer.js";import{insightsToOverlaySuggestion as i,insightsToWorkflowAdaptations as a}from"./adapter.js";import"./docs/index.js";export{r as BehaviorAnalyzer,t as BehaviorTracker,e as InMemoryBehaviorStore,n as createBehaviorTracker,i as insightsToOverlaySuggestion,a as insightsToWorkflowAdaptations};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.personalization",
-  "version": "0.0.0-canary-20251209233744",
+  "version": "0.0.0-canary-20251210081515",
   "description": "Behavior tracking, analysis, and adaptation helpers for ContractSpec personalization.",
   "type": "module",
   "main": "./dist/index.js",