@proophboard/exploration-runtime 0.0.0-stage → 0.1.1

package/dist/playFunction/scenarioRunner.js

@@ -0,0 +1,331 @@
+/**
+ * scenarioRunner — the pure Exploration "scenarios as tests" oracle (M5).
+ *
+ * A scenario becomes a recorded test by carrying pinned `expectations`
+ * (requirements R29/R30/R34). This module replays the scenario ONCE at the final
+ * playhead via the pure `foldChapter`, then resolves each expectation by its
+ * stable `sliceId` (never a step index) and matches it against the fold result:
+ *
+ *   - events      → the events emitted by the pinned slice must match.
+ *   - information → a specific Information instance's value (stored | read view)
+ *                   at the end of replay must match.
+ *   - rejection   → the pinned slice must produce a `rejected` runtime error
+ *                   (optionally matching a message) AND emit no events.
+ *
+ * The golden-master snapshot is deliberately NOT used — expectations are the sole
+ * correctness oracle (a chapter's flow may legitimately change; only the pins
+ * must hold). Verdict:
+ *
+ *   pass    — ≥1 expectation, all matched.
+ *   broken  — ≥1 expectation, at least one failed (mismatch OR structural: a
+ *             dangling reference / handler threw / cascade exceeded at the pin).
+ *   neutral — zero expectations (nothing asserted yet).
+ *
+ * This file is PURE and framework-free (no DOM/worker), so it is fully
+ * unit-testable — the same reason the fold lives in runtimeFold.ts. "Run all" is
+ * just `scenarios.map(runScenario)`.
+ */
+import { toImplicitScenario, } from '../types/exploration.js';
+import { toClassName } from '../lib/toClassName.js';
+import { deriveRuntimeSteps } from './runtimeSteps.js';
+import { foldChapter } from './runtimeFold.js';
+/** Deep structural equality for JSON-ish values (order-sensitive for arrays). */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (a === null || b === null)
+        return a === b;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (typeof a === 'object') {
+        const ao = a;
+        const bo = b;
+        const ak = Object.keys(ao);
+        const bk = Object.keys(bo);
+        if (ak.length !== bk.length)
+            return false;
+        return ak.every((k) => Object.prototype.hasOwnProperty.call(bo, k) && deepEqual(ao[k], bo[k]));
+    }
+    return false;
+}
+/**
+ * Subset match: every key/element in `expected` must be present and (recursively)
+ * subset-match in `actual`. Arrays: each expected element must subset-match the
+ * element at the SAME index in actual (actual may be longer). Scalars: deep-equal.
+ */
+function isSubset(expected, actual) {
+    if (expected === actual)
+        return true;
+    if (expected === null || expected === undefined)
+        return deepEqual(expected, actual);
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual) || actual.length < expected.length)
+            return false;
+        return expected.every((e, i) => isSubset(e, actual[i]));
+    }
+    if (typeof expected === 'object') {
+        if (typeof actual !== 'object' || actual === null || Array.isArray(actual))
+            return false;
+        const eo = expected;
+        const ao = actual;
+        return Object.keys(eo).every((k) => Object.prototype.hasOwnProperty.call(ao, k) && isSubset(eo[k], ao[k]));
+    }
+    return deepEqual(expected, actual);
+}
+/** Apply the chosen match mode. */
+function valueMatches(expected, actual, mode) {
+    return mode === 'exact' ? deepEqual(expected, actual) : isSubset(expected, actual);
+}
+/** The className-form state key (`Ctx.El`) for an Information element. */
+function infoKey(el) {
+    return `${toClassName(el.context || 'App')}.${toClassName(el.name)}`;
+}
+/** Read a dotted `Ctx.El` key out of the (possibly nested) state tree. */
+function readStateKey(state, key) {
+    const [ctx, el] = key.split('.');
+    const bucket = state[ctx];
+    if (bucket === null || typeof bucket !== 'object')
+        return undefined;
+    return bucket[el];
+}
+/**
+ * Evaluate a single expectation against the fold result. Pure; returns the
+ * per-expectation verdict. Resolution is by stable `sliceId` / `elementId`; if
+ * either no longer resolves in the chapter, the expectation is a dangling
+ * reference (⇒ broken), which is exactly the "the model moved under the test"
+ * signal we want to surface rather than silently pass.
+ */
+function evaluateExpectation(exp, chapter, result) {
+    const base = {
+        expectationId: exp.id,
+        sliceId: exp.sliceId,
+        kind: exp.kind,
+        elementId: exp.elementId,
+        matched: false,
+    };
+    // Dangling slice? The pinned slice no longer exists in the chapter.
+    const sliceExists = chapter.slices.some((s) => s.id === exp.sliceId);
+    if (!sliceExists) {
+        return {
+            ...base,
+            failureKind: 'dangling-reference',
+            message: `Pinned slice ${exp.sliceId} no longer exists in the chapter.`,
+        };
+    }
+    // Structural error at the pinned slice (threw / cascade-exceeded) ⇒ broken,
+    // regardless of kind: the slice could not produce a trustworthy outcome.
+    const structuralAtSlice = result.errors.find((e) => e.sliceId === exp.sliceId && (e.kind === 'threw' || e.kind === 'cascade-exceeded'));
+    if (structuralAtSlice) {
+        return {
+            ...base,
+            failureKind: structuralAtSlice.kind,
+            message: `${structuralAtSlice.kind === 'threw' ? 'A handler threw' : 'Cascade budget exceeded'} at the pinned slice: ${structuralAtSlice.message}`,
+            actual: structuralAtSlice,
+        };
+    }
+    const eventsFromSlice = result.events.filter((e) => e.sliceId === exp.sliceId);
+    if (exp.kind === 'events') {
+        const expected = exp.expected.events ?? [];
+        const mode = exp.match ?? 'exact';
+        const actual = eventsFromSlice.map((e) => ({ name: e.name, context: e.context, payload: e.payload }));
+        // Compare the ordered list by name/context, and payload per the match mode.
+        let matched = actual.length === expected.length || (mode === 'subset' && actual.length >= expected.length);
+        if (matched) {
+            matched = expected.every((exp_e, i) => {
+                const act = actual[i];
+                if (!act)
+                    return false;
+                if (act.name !== exp_e.name)
+                    return false;
+                if (exp_e.context && act.context !== exp_e.context)
+                    return false;
+                if (exp_e.payload === undefined)
+                    return true; // name/context-only pin
+                return valueMatches(exp_e.payload, act.payload, mode);
+            });
+        }
+        return {
+            ...base,
+            matched,
+            failureKind: matched ? undefined : 'mismatch',
+            message: matched ? undefined : `Expected ${expected.length} event(s), the slice emitted ${actual.length}; names/payloads differ.`,
+            actual,
+            expected,
+        };
+    }
+    if (exp.kind === 'information') {
+        const expInfo = exp.expected;
+        const mode = exp.match ?? 'subset';
+        // Resolve the Information element instance (by id) to compute its state key.
+        const el = exp.elementId ? chapter.elements.find((e) => e.id === exp.elementId) : undefined;
+        if (!el || el.type !== 'information') {
+            return {
+                ...base,
+                failureKind: 'dangling-reference',
+                message: `Pinned Information element ${exp.elementId ?? '(none)'} no longer exists.`,
+            };
+        }
+        let actual;
+        if (expInfo.view === 'read') {
+            const view = result.readViews.find((v) => v.elementId === el.id);
+            actual = view?.view;
+        }
+        else {
+            actual = readStateKey(result.state, infoKey(el));
+        }
+        const matched = valueMatches(expInfo.value, actual, mode);
+        return {
+            ...base,
+            matched,
+            failureKind: matched ? undefined : 'mismatch',
+            message: matched
+                ? undefined
+                : `Information "${el.name}" (${expInfo.view}) does not match the pinned value (${mode}).`,
+            actual,
+            expected: expInfo.value,
+        };
+    }
+    // kind === 'rejection'
+    {
+        const expRej = exp.expected;
+        const rejection = result.errors.find((e) => e.sliceId === exp.sliceId && e.kind === 'rejected');
+        if (!rejection) {
+            return {
+                ...base,
+                failureKind: 'rejected-missing',
+                message: `Expected a rejection at this slice, but none occurred.`,
+                actual: eventsFromSlice.map((e) => e.name),
+                expected: expRej,
+            };
+        }
+        // A rejection must also mean NO events were emitted by the slice.
+        if (eventsFromSlice.length > 0) {
+            return {
+                ...base,
+                failureKind: 'unexpected-events',
+                message: `Rejection expected, but the slice also emitted ${eventsFromSlice.length} event(s).`,
+                actual: eventsFromSlice.map((e) => e.name),
+                expected: expRej,
+            };
+        }
+        // Optional message match (substring, case-insensitive).
+        if (expRej.message && !rejection.message.toLowerCase().includes(expRej.message.toLowerCase())) {
+            return {
+                ...base,
+                failureKind: 'mismatch',
+                message: `Rejection message "${rejection.message}" does not contain "${expRej.message}".`,
+                actual: rejection.message,
+                expected: expRej.message,
+            };
+        }
+        return { ...base, matched: true, actual: rejection.message };
+    }
+}
+/**
+ * Run one scenario as a test. Pure: `(chapter, scenario, handlers) → result`.
+ *
+ * `handlers` are pre-transpiled JS keyed by element id (same contract as the
+ * fold). Pass `{}` for the defaults-only path.
+ *
+ * Fold strategy:
+ *  - events / rejection expectations  → fold to the END (events accumulate; a
+ *    rejection is an error that happened during that slice's execution regardless
+ *    of later steps).
+ *  - information expectations → fold to the step that CONTAINS the pinned slice,
+ *    because state is cumulative: a value that was correct at step 2 may differ
+ *    at step 5 due to later mutations. We want the state AT the pinned moment.
+ *    Multiple information pins that share the same step index reuse one fold.
+ */
+export function runScenario(chapter, scenario, handlers = {}) {
+    const expectations = scenario.expectations ?? [];
+    const steps = deriveRuntimeSteps(chapter);
+    const implicitScenario = toImplicitScenario(scenario);
+    // ── Full-length fold (events + rejections) ─────────────────────────────
+    const fullPlayhead = Math.max(0, steps.length - 1);
+    const fullFold = foldChapter(chapter, implicitScenario, fullPlayhead, handlers, undefined, undefined, 'PlayWorker');
+    const fullFoldView = {
+        events: fullFold.events,
+        state: fullFold.state,
+        errors: fullFold.errors ?? [],
+        readViews: fullFold.readViews ?? [],
+    };
+    // ── Per-step folds for information expectations ─────────────────────────
+    // Build a map from stepIndex → fold result (lazy, deduplicated).
+    // stepIndex = index of the first step whose slice.id matches the pinned sliceId.
+    const stepFoldCache = new Map();
+    function foldAtStep(stepIndex) {
+        const cached = stepFoldCache.get(stepIndex);
+        if (cached)
+            return cached;
+        const fold = foldChapter(chapter, implicitScenario, stepIndex, handlers, undefined, undefined, 'PlayWorker');
+        const view = {
+            events: fold.events,
+            state: fold.state,
+            errors: fold.errors ?? [],
+            readViews: fold.readViews ?? [],
+        };
+        stepFoldCache.set(stepIndex, view);
+        return view;
+    }
+    // ── Evaluate each expectation ───────────────────────────────────────────
+    const expectationResults = expectations.map((exp) => {
+        if (exp.kind === 'information') {
+            // Find the step index at or just before the pinned slice.
+            // Read slices (pure Information, no UI/automation) don't produce steps,
+            // so we must find the last step whose slice appears at or before the pinned
+            // slice in the chapter's slice order.
+            const sliceOrder = new Map(chapter.slices.map((s, i) => [s.id, i]));
+            const pinnedSliceOrder = sliceOrder.get(exp.sliceId);
+            if (pinnedSliceOrder === undefined) {
+                // Slice gone — dangling reference, let evaluateExpectation handle it.
+                return evaluateExpectation(exp, chapter, fullFoldView);
+            }
+            // Find the last step whose slice is at or before the pinned slice's position.
+            let stepIndex = -1;
+            for (let i = steps.length - 1; i >= 0; i--) {
+                const stepSliceOrder = sliceOrder.get(steps[i].slice.id) ?? Infinity;
+                if (stepSliceOrder <= pinnedSliceOrder) {
+                    stepIndex = i;
+                    break;
+                }
+            }
+            if (stepIndex === -1) {
+                // No steps at or before the pinned slice — fold to the start (step 0).
+                stepIndex = 0;
+            }
+            return evaluateExpectation(exp, chapter, foldAtStep(stepIndex));
+        }
+        // events + rejection: use the full-length fold.
+        return evaluateExpectation(exp, chapter, fullFoldView);
+    });
+    // Structural errors not already surfaced by an expectation (for repair context).
+    const pinnedSlices = new Set(expectations.map((e) => e.sliceId));
+    const structuralErrors = fullFoldView.errors.filter((e) => (e.kind === 'threw' || e.kind === 'cascade-exceeded') && !pinnedSlices.has(e.sliceId ?? ''));
+    let status;
+    if (expectations.length === 0) {
+        status = 'neutral';
+    }
+    else if (expectationResults.every((r) => r.matched)) {
+        status = 'pass';
+    }
+    else {
+        status = 'broken';
+    }
+    return {
+        scenarioId: scenario.id,
+        scenarioName: scenario.name,
+        status,
+        expectationResults,
+        structuralErrors,
+    };
+}
+/** Run every scenario in a chapter (the chapter-level "Run all"). */
+export function runAllScenarios(chapter, scenarios, handlers = {}) {
+    return scenarios.map((s) => runScenario(chapter, s, handlers));
+}
+//# sourceMappingURL=scenarioRunner.js.map

package/dist/playFunction/scenarioRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarioRunner.js","sourceRoot":"","sources":["../../src/playFunction/scenarioRunner.ts"],"names":[],"mappings":"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"}

package/dist/playFunction/transpile.d.ts

@@ -0,0 +1,33 @@
+/**
+ * transpile — lazy TS → JS type-erasure for Play Functions (Exploration R18).
+ *
+ * Handlers are authored and stored as TypeScript (verbatim). Browsers can't run
+ * TS, so before execution the type annotations are stripped to plain JS. We use
+ * `sucrase` with the `typescript` transform only (no bundling, no type-checking —
+ * pure syntactic erasure), which is the smallest/fastest option for this job.
+ *
+ * `sucrase` is loaded LAZILY (dynamic import) so it only enters the bundle with
+ * the Play Function runtime chunk, keeping M1–M3 (defaults-only) unaffected.
+ *
+ * Results are cached per source string: the same handler text transpiles once per
+ * session. The fold may transpile many handlers across replays/scrubs, so the
+ * cache matters.
+ */
+/**
+ * Transpile a Play Function's TypeScript source to JavaScript (type-erasure).
+ * Cached per exact source string. Throws if sucrase fails to parse (surfaced to
+ * the caller as a handler error).
+ */
+export declare function transpilePlayFunction(source: string): Promise<string>;
+/**
+ * Synchronous cache read — returns the transpiled JS if this source has already
+ * been transpiled this session, else null. Lets the fold stay synchronous once
+ * all handlers in play have been pre-transpiled (the worker pre-warms the cache
+ * before folding).
+ */
+export declare function getTranspiledSync(source: string): string | null;
+/** Pre-transpile a batch of sources (used to pre-warm before a synchronous fold). */
+export declare function pretranspile(sources: Iterable<string>): Promise<void>;
+/** Test seam: clear the cache. */
+export declare function __clearTranspileCache(): void;
+//# sourceMappingURL=transpile.d.ts.map

package/dist/playFunction/transpile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.d.ts","sourceRoot":"","sources":["../../src/playFunction/transpile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0BH;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/D;AAED,qFAAqF;AACrF,wBAAsB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3E;AAED,kCAAkC;AAClC,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/playFunction/transpile.js

@@ -0,0 +1,71 @@
+/**
+ * transpile — lazy TS → JS type-erasure for Play Functions (Exploration R18).
+ *
+ * Handlers are authored and stored as TypeScript (verbatim). Browsers can't run
+ * TS, so before execution the type annotations are stripped to plain JS. We use
+ * `sucrase` with the `typescript` transform only (no bundling, no type-checking —
+ * pure syntactic erasure), which is the smallest/fastest option for this job.
+ *
+ * `sucrase` is loaded LAZILY (dynamic import) so it only enters the bundle with
+ * the Play Function runtime chunk, keeping M1–M3 (defaults-only) unaffected.
+ *
+ * Results are cached per source string: the same handler text transpiles once per
+ * session. The fold may transpile many handlers across replays/scrubs, so the
+ * cache matters.
+ */
+let transformerPromise = null;
+/** Lazily load sucrase and return a bound TS→JS transform fn. */
+async function getTransformer() {
+    if (!transformerPromise) {
+        transformerPromise = import('sucrase').then(({ transform }) => {
+            return (code) => transform(code, {
+                transforms: ['typescript'],
+                // Keep output ES-module-free: handlers are wrapped as function bodies,
+                // not modules, so we don't want import/export handling here.
+                disableESTransforms: true,
+                production: true,
+            }).code;
+        });
+    }
+    return transformerPromise;
+}
+/** Per-source transpile cache (source string → JS). */
+const cache = new Map();
+/**
+ * Transpile a Play Function's TypeScript source to JavaScript (type-erasure).
+ * Cached per exact source string. Throws if sucrase fails to parse (surfaced to
+ * the caller as a handler error).
+ */
+export async function transpilePlayFunction(source) {
+    const trimmed = source ?? '';
+    const cached = cache.get(trimmed);
+    if (cached !== undefined)
+        return cached;
+    const transform = await getTransformer();
+    const js = transform(trimmed);
+    cache.set(trimmed, js);
+    return js;
+}
+/**
+ * Synchronous cache read — returns the transpiled JS if this source has already
+ * been transpiled this session, else null. Lets the fold stay synchronous once
+ * all handlers in play have been pre-transpiled (the worker pre-warms the cache
+ * before folding).
+ */
+export function getTranspiledSync(source) {
+    return cache.get(source ?? '') ?? null;
+}
+/** Pre-transpile a batch of sources (used to pre-warm before a synchronous fold). */
+export async function pretranspile(sources) {
+    const unique = new Set();
+    for (const s of sources) {
+        if (s && s.trim().length > 0)
+            unique.add(s);
+    }
+    await Promise.all([...unique].map((s) => transpilePlayFunction(s)));
+}
+/** Test seam: clear the cache. */
+export function __clearTranspileCache() {
+    cache.clear();
+}
+//# sourceMappingURL=transpile.js.map

package/dist/playFunction/transpile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.js","sourceRoot":"","sources":["../../src/playFunction/transpile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,IAAI,kBAAkB,GAAgC,IAAI,CAAC;AAE3D,iEAAiE;AACjE,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;YAC5D,OAAO,CAAC,IAAY,EAAE,EAAE,CACtB,SAAS,CAAC,IAAI,EAAE;gBACd,UAAU,EAAE,CAAC,YAAY,CAAC;gBAC1B,uEAAuE;gBACvE,6DAA6D;gBAC7D,mBAAmB,EAAE,IAAI;gBACzB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC,IAAI,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,uDAAuD;AACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc;IACxD,MAAM,OAAO,GAAG,MAAM,IAAI,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,qBAAqB;IACnC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/types/eventModel.d.ts

@@ -0,0 +1,79 @@
+/**
+ * eventModel — the MINIMAL subset of prooph board's Event Model domain types the
+ * Exploration runtime depends on. Mirrors the fields the fold, connection rules,
+ * and dts builders read; it is intentionally not the full editor model.
+ *
+ * Keep this in sync with eventflow-designer's `src/types/eventModel.ts` for the
+ * fields used here (type, name, context, laneId, sliceId, index, noArrow*,
+ * playFunction, playType; lane label/type/index; slice index/status; chapter
+ * slices/lanes/elements/mode/context). The parity test guards against drift.
+ */
+export type ElementType = 'command' | 'event' | 'information' | 'automation' | 'hotspot' | 'ui' | 'slice';
+export type LaneType = 'user-lane' | 'information-flow' | 'system';
+export interface Comment {
+    id: string;
+    text: string;
+    createdAt: number;
+    author: string;
+    userId: string;
+}
+export interface Element {
+    id: string;
+    type: ElementType;
+    name: string;
+    description?: string;
+    details?: string;
+    context: string;
+    icon?: string;
+    laneId: string;
+    sliceId: string;
+    index: number;
+    comments?: Comment[];
+    noArrowSource?: boolean;
+    noArrowTarget?: boolean;
+    hasSimilarElement?: boolean;
+    /** Exploration play function (handler) authored on this element, TS source. */
+    playFunction?: string;
+    /** Exploration payload type (bare TS type expression) authored on this element. */
+    playType?: string;
+}
+export interface Lane {
+    id: string;
+    label: string;
+    type: LaneType;
+    height: number;
+    icon?: string;
+    details?: string;
+    index: number;
+}
+export type SliceStatus = 'draft' | 'planned' | 'in-progress' | 'blocked' | 'reviewed' | 'ready' | 'deployed';
+export interface Slice {
+    id: string;
+    label: string;
+    width: number;
+    index: number;
+    icon?: string;
+    details?: string;
+    status?: SliceStatus;
+    assigneeId?: string | null;
+    data?: {
+        estimate?: string | null;
+        timeSpent?: string | null;
+        comments?: unknown[];
+        milestoneIds?: string[];
+        currentMilestone?: string | null;
+        [key: string]: unknown;
+    };
+}
+export type ChapterMode = 'event-modeling' | 'freestyle';
+export interface Chapter {
+    id: string;
+    name: string;
+    lanes: Lane[];
+    slices: Slice[];
+    elements: Element[];
+    index: number;
+    context: string;
+    mode: ChapterMode;
+}
+//# sourceMappingURL=eventModel.d.ts.map

package/dist/types/eventModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventModel.d.ts","sourceRoot":"","sources":["../../src/types/eventModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,OAAO,GACP,aAAa,GACb,YAAY,GACZ,SAAS,GACT,IAAI,GACJ,OAAO,CAAC;AAEZ,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,SAAS,GACT,aAAa,GACb,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;CACnB"}

package/dist/types/eventModel.js

@@ -0,0 +1,12 @@
+/**
+ * eventModel — the MINIMAL subset of prooph board's Event Model domain types the
+ * Exploration runtime depends on. Mirrors the fields the fold, connection rules,
+ * and dts builders read; it is intentionally not the full editor model.
+ *
+ * Keep this in sync with eventflow-designer's `src/types/eventModel.ts` for the
+ * fields used here (type, name, context, laneId, sliceId, index, noArrow*,
+ * playFunction, playType; lane label/type/index; slice index/status; chapter
+ * slices/lanes/elements/mode/context). The parity test guards against drift.
+ */
+export {};
+//# sourceMappingURL=eventModel.js.map

package/dist/types/eventModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventModel.js","sourceRoot":"","sources":["../../src/types/eventModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}