@r-a-i-t-h/viz-host 0.1.0

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * Host library: inspect + project live XState logic → Viz*, open popup bridge.
+ *
+ * Depends on `@r-a-i-t-h/viz-protocol` for the shared model/wire types.
+ * Peer: `xstate` v5.
+ */
+export { createVisualizerHost, } from './createVisualizerHost.js';
+export { machineLogicFromEvent, projectFrame, projectMachine, portableizeContext, activePaths, } from './project.js';
+export { normalizeStateNodeId } from '@r-a-i-t-h/viz-protocol';
+export { collectNextEvents } from './nextEvents.js';
+export { computeContextKeyAges } from './contextAges.js';
+export { analyzeContextDeps, } from './contextDeps.js';
+export { isVizActorRefMarker } from '@r-a-i-t-h/viz-protocol';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,GAIrB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EACL,kBAAkB,GAQnB,MAAM,kBAAkB,CAAC;AAsB1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/nextEvents.d.ts

@@ -0,0 +1,8 @@
+import type { VizNextEvent, VizNode } from '@r-a-i-t-h/viz-protocol';
+/**
+ * Events the active configuration can handle, including handlers on active
+ * ancestors (XState bubbling). Provider ids are the states that declare `on`.
+ * Candidates preserve definition order within each provider (cond cascade).
+ */
+export declare function collectNextEvents(root: VizNode, activePaths: string[]): VizNextEvent[];
+//# sourceMappingURL=nextEvents.d.ts.map

package/dist/nextEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextEvents.d.ts","sourceRoot":"","sources":["../src/nextEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,OAAO,EACR,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,MAAM,EAAE,GACpB,YAAY,EAAE,CA4DhB"}

package/dist/nextEvents.js

@@ -0,0 +1,61 @@
+/**
+ * Events the active configuration can handle, including handlers on active
+ * ancestors (XState bubbling). Provider ids are the states that declare `on`.
+ * Candidates preserve definition order within each provider (cond cascade).
+ */
+export function collectNextEvents(root, activePaths) {
+    const active = new Set(activePaths);
+    const providersByType = new Map();
+    const candidatesByType = new Map();
+    function visit(node) {
+        const path = node.details.path;
+        const isActive = path === ''
+            ? active.size > 0 || activePaths.length === 0
+            : active.has(path);
+        if (isActive) {
+            for (const event of node.events) {
+                let providers = providersByType.get(event.type);
+                if (!providers) {
+                    providers = [];
+                    providersByType.set(event.type, providers);
+                }
+                if (!providers.includes(node.id)) {
+                    providers.push(node.id);
+                }
+                let candidates = candidatesByType.get(event.type);
+                if (!candidates) {
+                    candidates = [];
+                    candidatesByType.set(event.type, candidates);
+                }
+                for (const transition of event.transitions) {
+                    candidates.push({
+                        providerId: node.id,
+                        targetIds: transition.targetIds,
+                        guard: transition.guard,
+                        actions: transition.actions,
+                        line: transition.line,
+                    });
+                }
+            }
+        }
+        for (const child of node.children)
+            visit(child);
+    }
+    visit(root);
+    return [...providersByType.entries()].map(([type, providerIds]) => {
+        const candidates = candidatesByType.get(type) ?? [];
+        const highlightIds = [
+            ...new Set([
+                ...providerIds,
+                ...candidates.flatMap((c) => c.targetIds),
+            ]),
+        ];
+        return {
+            type,
+            providerIds,
+            candidates,
+            highlightIds,
+        };
+    });
+}
+//# sourceMappingURL=nextEvents.js.map

package/dist/nextEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextEvents.js","sourceRoot":"","sources":["../src/nextEvents.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAa,EACb,WAAqB;IAErB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEpE,SAAS,KAAK,CAAC,IAAa;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/B,MAAM,QAAQ,GACZ,IAAI,KAAK,EAAE;YACT,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEvB,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,EAAE,CAAC;oBACf,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAC7C,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBACjC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC1B,CAAC;gBAED,IAAI,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,UAAU,GAAG,EAAE,CAAC;oBAChB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC/C,CAAC;gBACD,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC3C,UAAU,CAAC,IAAI,CAAC;wBACd,UAAU,EAAE,IAAI,CAAC,EAAE;wBACnB,SAAS,EAAE,UAAU,CAAC,SAAS;wBAC/B,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC;IAEZ,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE;QAChE,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG;YACnB,GAAG,IAAI,GAAG,CAAC;gBACT,GAAG,WAAW;gBACd,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aAC1C,CAAC;SACH,CAAC;QACF,OAAO;YACL,IAAI;YACJ,WAAW;YACX,UAAU;YACV,YAAY;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Host-side projection: walk live XState machine logic (official types) into
+ * the shared Viz* model. This is the only module that should import XState
+ * structural types (`StateNodeDefinition`, transition shapes, etc.).
+ */
+import type { AnyStateMachine, InspectionEvent, StateValue } from 'xstate';
+import type { VizFrame, VizMachine } from '@r-a-i-t-h/viz-protocol';
+export interface ResolvedMachineActor {
+    sessionId: string;
+    logic: AnyStateMachine;
+    parentSessionId?: string;
+    input?: unknown;
+}
+/** Resolve machine logic from an `@xstate.actor` inspection event. */
+export declare function machineLogicFromEvent(event: InspectionEvent): ResolvedMachineActor | null;
+export declare function projectMachine(logic: AnyStateMachine, sessionId: string, options?: {
+    parentSessionId?: string;
+    input?: unknown;
+}): VizMachine;
+export declare function projectFrame(sessionId: string, snapshot: {
+    value?: unknown;
+    context?: unknown;
+    status?: string;
+    output?: unknown;
+    children?: Record<string, unknown>;
+}, options?: {
+    eventType?: string;
+    previousContext?: unknown;
+    previousAges?: Record<string, number>;
+    machine?: VizMachine;
+    /**
+     * Optional scrub after actor-ref enrichment (host sanitizeContext).
+     * Receives already-portable context.
+     */
+    sanitizeContext?: (context: unknown) => unknown;
+}): VizFrame;
+/**
+ * Replace live ActorRefs with {@link VizActorRefMarker} so sessionId survives
+ * JSON / postMessage. Uses live sessionId when present; falls back to
+ * snapshot.children lookup via `id` / toJSON shape.
+ */
+export declare function portableizeContext(context: unknown, childSessionById?: Map<string, string>): unknown;
+/**
+ * Flatten a StateValue into dot-delimited active state paths.
+ * Host-only; popup receives the result on VizFrame.activePaths.
+ */
+export declare function activePaths(value: StateValue, prefix?: string): string[];
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,UAAU,EACX,MAAM,QAAQ,CAAC;AAGhB,OAAO,KAAK,EAIV,QAAQ,EAER,UAAU,EAOX,MAAM,yBAAyB,CAAC;AA+BjC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,GACrB,oBAAoB,GAAG,IAAI,CAgB7B;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,UAAU,CAkBZ;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,EACD,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD,GACA,QAAQ,CA+BV;AAiBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,gBAAgB,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,GAChD,OAAO,CAET;AAuDD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAcpE"}