palistor 0.0.24 → 0.0.26

package/dist/store/flow/flowNavigation.js

@@ -0,0 +1,384 @@
+import { computeFieldState } from "../compute";
+import { walkFull } from "../traversal";
+import { resetResolveState } from "../resolvePipeline";
+// ─── Derived state ────────────────────────────────────────────────────────────
+/** Step status — derived from navigation state (not stored). */
+export function getStepStatus(flowState, stepNode) {
+    const idx = flowState.stepNodes.indexOf(stepNode);
+    if (idx === -1)
+        return null;
+    if (idx === flowState.currentIndex)
+        return "active";
+    return flowState.visitedKeys.has(flowState.stepKeys[idx]) ? "completed" : null;
+}
+/** Step visibility — from the group's computed FieldState (isVisible is reactive). */
+export function isStepVisible(kernel, stepNode) {
+    return kernel.nodes.nodeState.get(stepNode)?.isVisible !== false;
+}
+/** Composite flow loading: true when at least one step is resolving. */
+export function flowLoading(kernel, flowState) {
+    for (const stepNode of flowState.stepNodes) {
+        if (kernel.nodes.nodeState.get(stepNode)?.loading === true)
+            return true;
+    }
+    return false;
+}
+// ─── Validation ───────────────────────────────────────────────────────────────
+/**
+ * Collect leaf errors of a step's subtree. Validation is computed "live" via
+ * computeFieldState(revalidate=true) — independent of the group's revalidate
+ * flag (which only the submit pipeline sets). Hidden leaves are skipped.
+ * Lists inside a step are skipped (parity with collectLeafStates).
+ *
+ * `basePath` — prefix for error paths. The flow passes the step KEY: paths
+ * come out relative to the flow node ("welcome.name") — the same base the
+ * submit pipeline uses for errors on flow.submit() (collectLeafStates builds
+ * paths from the submitted node).
+ */
+export function collectStepErrors(kernel, stepNode, basePath = "") {
+    const errors = [];
+    const { nodeState } = kernel.nodes;
+    const translate = kernel.services.translate;
+    walkFull(stepNode, {
+        onLeaf(leaf, _key, path) {
+            const state = nodeState.get(leaf);
+            if (!state || state.isVisible === false)
+                return;
+            const groupValues = kernel.values.nodeSlot.get(leaf)?.parent ?? kernel.values.values;
+            const computed = computeFieldState(leaf, state.value, groupValues, true, translate);
+            if (computed.isInvalid && computed.errorMessage) {
+                errors.push({ path, message: computed.errorMessage });
+            }
+        },
+    }, basePath);
+    return errors;
+}
+/** Live aggregate of step validity (flow.steps.x.isInvalid). */
+export function stepIsInvalid(kernel, stepNode) {
+    return collectStepErrors(kernel, stepNode).length > 0;
+}
+/**
+ * Flow errors over visited visible steps (the scope of flow.validate()).
+ * Hidden steps are always excluded — an untaken branch must not block.
+ * Error paths are relative to the flow node ("stepKey.field") — same as
+ * SubmitResult on flow.submit().
+ */
+export function collectFlowErrors(kernel, flowState) {
+    const errors = [];
+    for (let i = 0; i < flowState.stepNodes.length; i++) {
+        const stepNode = flowState.stepNodes[i];
+        if (!flowState.visitedKeys.has(flowState.stepKeys[i]))
+            continue;
+        if (!isStepVisible(kernel, stepNode))
+            continue;
+        errors.push(...collectStepErrors(kernel, stepNode, flowState.stepKeys[i]));
+    }
+    return errors;
+}
+/** Aggregate flow.isInvalid: any errors in visited visible steps. */
+export function flowIsInvalid(kernel, flowState) {
+    return collectFlowErrors(kernel, flowState).length > 0;
+}
+/**
+ * flow.validate(): collect errors of the visited steps, write them into the
+ * reactive flow.errors and return them. Empty array = all valid.
+ */
+export function flowValidate(kernel, flowState) {
+    const errors = collectFlowErrors(kernel, flowState);
+    flowState.errors = errors;
+    kernel.notifyChanged(new Set([flowState, flowState.flowNode]));
+    return errors;
+}
+/**
+ * Filter out submit-pipeline errors from leaves under HIDDEN steps of any
+ * flow: the base pipeline validates all leaves regardless of visibility, and
+ * without this filter an untaken branch with isRequired fields would block
+ * finalization forever.
+ *
+ * `submittedNode` — the node the submit ran for: pipeline error paths are
+ * RELATIVE to it (collectLeafStates builds paths from the submitted node),
+ * so the absolute paths of hidden steps are rebased to the same base.
+ */
+export function filterHiddenFlowStepErrors(kernel, errors, submittedNode) {
+    const flows = kernel.nodes.allFlowStates;
+    if (flows.length === 0 || errors.length === 0)
+        return errors;
+    const basePath = submittedNode === kernel.rootConfig
+        ? ""
+        : kernel.nodes.nodePaths.get(submittedNode) ?? "";
+    const hiddenPrefixes = [];
+    for (const flowState of flows) {
+        for (const stepNode of flowState.stepNodes) {
+            if (isStepVisible(kernel, stepNode))
+                continue;
+            const stepPath = kernel.nodes.nodePaths.get(stepNode);
+            if (!stepPath)
+                continue;
+            if (basePath === "") {
+                hiddenPrefixes.push(stepPath + ".");
+            }
+            else if (stepPath.startsWith(basePath + ".")) {
+                hiddenPrefixes.push(stepPath.slice(basePath.length + 1) + ".");
+            }
+            // stepPath outside the submitted node's subtree — its leaves never appear in errors.
+        }
+    }
+    if (hiddenPrefixes.length === 0)
+        return errors;
+    return errors.filter((e) => !hiddenPrefixes.some((prefix) => e.path.startsWith(prefix)));
+}
+// ─── Submit (finalization) ────────────────────────────────────────────────────
+/**
+ * flow.submit(): the standard group-submit pipeline over the flow node
+ * (submitting → beforeSubmit → validate → onSubmit → afterSubmit; leaves of
+ * hidden steps are filtered by the pipeline). Validation errors land in the
+ * reactive flow.errors; on success errors are cleared.
+ */
+export async function flowSubmit(kernel, flowState) {
+    const result = await kernel.submitPipeline.execute(flowState.flowNode);
+    flowState.errors = result.success ? [] : result.errors;
+    kernel.notifyChanged(new Set([flowState, flowState.flowNode]));
+    return result;
+}
+// ─── Entry lifecycle ─────────────────────────────────────────────────────────
+function fireCallback(cb, values, kernel) {
+    if (typeof cb !== "function")
+        return;
+    try {
+        void Promise.resolve(cb(values, kernel))
+            .catch(() => { });
+    }
+    catch {
+        /* synchronous throws are swallowed too */
+    }
+}
+/**
+ * Step entry lifecycle: onEnter → resolve (eager) → onReady.
+ *
+ * - `onEnter` / `onReady` receive FLOW-scoped values (all steps by key) —
+ *   the flow's live groupSlot reference; fire-and-forget.
+ * - the step's resolve is a standard group resolve; the flow triggers it ON
+ *   ENTRY (equivalent to first access). Already resolved/error (cached) — not
+ *   re-run, and onReady is NOT invoked again.
+ * - Without resolve — onReady fires right after onEnter.
+ */
+export function runEntryLifecycle(kernel, flowState, stepNode) {
+    const flowValues = kernel.values.groupSlot.get(flowState.flowNode) ?? kernel.values.values;
+    fireCallback(stepNode.onEnter, flowValues, kernel);
+    const onReady = stepNode.onReady;
+    const fireReady = () => fireCallback(onReady, flowValues, kernel);
+    const resolve = stepNode.resolve;
+    const hasResolve = !!resolve && typeof resolve.resolver === "function";
+    if (!hasResolve) {
+        fireReady();
+        return;
+    }
+    const state = kernel.resolveManager.getResolveState(stepNode);
+    if (state && state.status === "idle") {
+        kernel.resolveManager.triggerResolve(stepNode);
+        const after = kernel.resolveManager.getResolveState(stepNode);
+        if (after?.promise) {
+            void after.promise.then(fireReady).catch(() => { });
+        }
+        else {
+            fireReady();
+        }
+    }
+    // pending — the resolve was started by another entry (onReady attached there);
+    // resolved / error — cached: onReady is not re-run.
+}
+// ─── Navigation ──────────────────────────────────────────────────────────────
+function notifyNavigation(kernel, flowState, prevNode, nextNode) {
+    const changed = new Set([
+        flowState,
+        flowState.flowNode,
+        prevNode,
+        nextNode,
+    ]);
+    kernel.notifyChanged(changed);
+}
+/**
+ * Common transition to step targetIndex.
+ * `push: true`  — nextStep()/goTo() (the current key is pushed onto the stack);
+ * `push: false` — back() (the stack was already popped by the caller).
+ */
+function enterStep(kernel, flowState, targetIndex, push) {
+    const prevIndex = flowState.currentIndex;
+    const prevKey = flowState.stepKeys[prevIndex];
+    const prevNode = flowState.stepNodes[prevIndex];
+    if (push)
+        flowState.visitStack.push(prevKey);
+    flowState.currentIndex = targetIndex;
+    const nextKey = flowState.stepKeys[targetIndex];
+    const nextNode = flowState.stepNodes[targetIndex];
+    // The previous step becomes visited (status → "completed"), the new one is active.
+    flowState.visitedKeys.add(prevKey);
+    flowState.visitedKeys.add(nextKey);
+    notifyNavigation(kernel, flowState, prevNode, nextNode);
+    runEntryLifecycle(kernel, flowState, nextNode);
+}
+/**
+ * nextStep(): the next VISIBLE step in array order; hidden ones are skipped.
+ * When no visible steps remain ahead — finalize via flow.submit() (on
+ * validation errors onSubmit is not called, errors land in flow.errors, the
+ * step does not change).
+ */
+export function flowNextStep(kernel, flowState) {
+    for (let i = flowState.currentIndex + 1; i < flowState.stepNodes.length; i++) {
+        if (isStepVisible(kernel, flowState.stepNodes[i])) {
+            enterStep(kernel, flowState, i, true);
+            return;
+        }
+    }
+    void flowSubmit(kernel, flowState);
+}
+/** back(): go back along the visit stack. No-op when the stack is empty (canGoBack). */
+export function flowBack(kernel, flowState) {
+    if (flowState.visitStack.length === 0)
+        return;
+    const targetKey = flowState.visitStack.pop();
+    const targetIndex = flowState.stepKeys.indexOf(targetKey);
+    if (targetIndex === -1)
+        return; // corrupted stack (hydrated against an older config)
+    enterStep(kernel, flowState, targetIndex, false);
+}
+/**
+ * goTo(keyOrIndex): arbitrary jump by key or index.
+ * Unknown key/index — throws (catches typos during development).
+ * Jumping to the current step is a no-op.
+ */
+export function flowGoTo(kernel, flowState, keyOrIndex) {
+    let targetIndex;
+    if (typeof keyOrIndex === "number") {
+        if (!Number.isInteger(keyOrIndex) || keyOrIndex < 0 || keyOrIndex >= flowState.stepKeys.length) {
+            throw new Error(`[palistor] flow.goTo(${keyOrIndex}): step index out of range (0..${flowState.stepKeys.length - 1}).`);
+        }
+        targetIndex = keyOrIndex;
+    }
+    else {
+        targetIndex = flowState.stepKeys.indexOf(keyOrIndex);
+        if (targetIndex === -1) {
+            throw new Error(`[palistor] flow.goTo("${keyOrIndex}"): unknown step key. Steps: ${flowState.stepKeys.join(", ")}.`);
+        }
+    }
+    if (targetIndex === flowState.currentIndex)
+        return;
+    enterStep(kernel, flowState, targetIndex, true);
+}
+// ─── Reset ───────────────────────────────────────────────────────────────────
+/**
+ * Reset flow navigation: the first step is active, the stack and visited set
+ * are cleared, step resolve states go back to idle. The first step's entry
+ * lifecycle (onEnter → resolve → onReady) runs anew — mirroring initialization.
+ */
+export function resetFlowNav(kernel, flowState) {
+    flowState.currentIndex = 0;
+    flowState.visitStack = [];
+    flowState.visitedKeys = new Set([flowState.stepKeys[0]]);
+    flowState.errors = [];
+    const changed = new Set([flowState, flowState.flowNode]);
+    for (const stepNode of flowState.stepNodes) {
+        changed.add(stepNode);
+        const resolve = stepNode.resolve;
+        if (resolve && typeof resolve.resolver === "function") {
+            resetResolveState(stepNode, kernel.resolveManager.states);
+        }
+    }
+    kernel.notifyChanged(changed);
+    runEntryLifecycle(kernel, flowState, flowState.stepNodes[0]);
+}
+/**
+ * Reset navigation of all flows that fall into the reset subtree.
+ * Called from ResetPipeline (root reset → all flows; group reset → flows inside it).
+ */
+export function resetFlowNavForSubtree(kernel, groupNode) {
+    const flows = kernel.nodes.allFlowStates;
+    if (flows.length === 0)
+        return;
+    const basePath = groupNode === kernel.rootConfig
+        ? ""
+        : kernel.nodes.nodePaths.get(groupNode);
+    if (basePath === undefined)
+        return;
+    for (const flowState of flows) {
+        const within = basePath === "" ||
+            flowState.path === basePath ||
+            flowState.path.startsWith(basePath + ".");
+        if (within)
+            resetFlowNav(kernel, flowState);
+    }
+}
+// ─── Init ────────────────────────────────────────────────────────────────────
+/**
+ * Initialization lifecycle: the first step of every flow is "entered" at
+ * store creation (onEnter → resolve → onReady). Called from the Palistor
+ * constructor.
+ *
+ * Also pre-warms the proxyCache of flow nodes: a step's identity view reads
+ * parent.proxy from the cache on the first step.submit(), and the flow proxy
+ * must already exist by then — otherwise the step's onSubmit would receive
+ * undefined as its third argument.
+ */
+export function initFlows(kernel) {
+    for (const flowState of kernel.nodes.allFlowStates) {
+        kernel.proxyBuilder.build(flowState.flowNode);
+        runEntryLifecycle(kernel, flowState, flowState.stepNodes[flowState.currentIndex]);
+    }
+}
+/**
+ * Serialize navigation of all flows for persist: key — the flow node's dot-path.
+ * Step statuses are not saved — they are derived from navigation on hydrate.
+ */
+export function serializeFlowNav(kernel) {
+    const flows = kernel.nodes.allFlowStates;
+    if (flows.length === 0)
+        return null;
+    const out = {};
+    for (const flowState of flows) {
+        out[flowState.path] = {
+            currentStepKey: flowState.stepKeys[flowState.currentIndex],
+            visitStack: [...flowState.visitStack],
+            visitedKeys: [...flowState.visitedKeys],
+        };
+    }
+    return out;
+}
+/**
+ * Restore flow navigation from a persist snapshot. Unknown step keys (the
+ * config changed) are dropped; an incompatible currentStepKey leaves the flow
+ * in its current state. Returns the changed nodes for notify and the flows
+ * whose active step changed (for a repeated entry lifecycle).
+ */
+export function restoreFlowNav(kernel, snapshots) {
+    const changed = new Set();
+    const entered = [];
+    for (const flowState of kernel.nodes.allFlowStates) {
+        const snap = snapshots[flowState.path];
+        if (!snap || typeof snap !== "object" || typeof snap.currentStepKey !== "string")
+            continue;
+        const targetIndex = flowState.stepKeys.indexOf(snap.currentStepKey);
+        if (targetIndex === -1)
+            continue;
+        const isKnownKey = (k) => typeof k === "string" && flowState.stepKeys.includes(k);
+        const prevIndex = flowState.currentIndex;
+        flowState.currentIndex = targetIndex;
+        flowState.visitStack = Array.isArray(snap.visitStack)
+            ? snap.visitStack.filter(isKnownKey)
+            : [];
+        flowState.visitedKeys = new Set(Array.isArray(snap.visitedKeys) ? snap.visitedKeys.filter(isKnownKey) : []);
+        flowState.visitedKeys.add(snap.currentStepKey);
+        flowState.errors = [];
+        changed.add(flowState);
+        changed.add(flowState.flowNode);
+        for (const stepNode of flowState.stepNodes)
+            changed.add(stepNode);
+        if (prevIndex !== targetIndex)
+            entered.push(flowState);
+    }
+    return { changed, entered };
+}
+/** Entry lifecycle of the current step (used by persist after hydration). */
+export function runFlowEntryLifecycle(kernel, flowState) {
+    runEntryLifecycle(kernel, flowState, flowState.stepNodes[flowState.currentIndex]);
+}
+//# sourceMappingURL=flowNavigation.js.map

package/dist/store/flow/flowNavigation.js.map

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

package/dist/store/flow/flowState.d.ts

@@ -0,0 +1,41 @@
+import type { AnyConfigNode } from "../store/types";
+import type { FlowError } from "./defineFlow";
+/**
+ * Navigation state of a single flow — the SINGLE "flow" building block.
+ *
+ * Node identity for tracking is the `FlowState` object itself (hub key, like
+ * `ListState` for lists): navigation bumps its version via notifyChanged.
+ * Step statuses are NOT stored — derived from (currentIndex + visitedKeys).
+ */
+export interface FlowState {
+    /** The flow's config node — key in flowStates. */
+    flowNode: AnyConfigNode;
+    /** Absolute dot-path of the flow node (for the persist snapshot and reset scope). */
+    path: string;
+    /** Ordered step keys (copy of FLOW_STEPS_PROP). */
+    stepKeys: string[];
+    /** Step config nodes in the same order. */
+    stepNodes: AnyConfigNode[];
+    /** Index of the active step. */
+    currentIndex: number;
+    /** Visit stack — popped by back(). */
+    visitStack: string[];
+    /** All steps ever visited (the stack is lossy — back() removes entries). */
+    visitedKeys: Set<string>;
+    /** Errors of the last validate()/finalize — reactive (flow.errors). */
+    errors: FlowError[];
+}
+/** Minimal registry interface for flow registration (NodeRegistry). */
+export interface FlowRegistrySlice {
+    readonly flowStates: WeakMap<object, FlowState>;
+    readonly allFlowStates: FlowState[];
+    readonly stepToFlow: WeakMap<object, FlowState>;
+    readonly nodePaths: WeakMap<object, string>;
+}
+/**
+ * Walk the config tree and create a FlowState for every node carrying the
+ * {@link FLOW_STEPS_PROP} marker (stamped by defineFlow). Called from the
+ * NodeRegistry constructor AFTER buildNodeMaps — paths are already known.
+ */
+export declare function collectFlowStates(root: AnyConfigNode, registry: FlowRegistrySlice): void;
+//# sourceMappingURL=flowState.d.ts.map

package/dist/store/flow/flowState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowState.d.ts","sourceRoot":"","sources":["../../../store/flow/flowState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,QAAQ,EAAE,aAAa,CAAC;IACxB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4EAA4E;IAC5E,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,uEAAuE;IACvE,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAwCxF"}

package/dist/store/flow/flowState.js

@@ -0,0 +1,51 @@
+import { CONFIG_PROPS, FLOW_STEPS_PROP } from "../constants";
+import { isGroupNode } from "../traversal";
+/**
+ * Walk the config tree and create a FlowState for every node carrying the
+ * {@link FLOW_STEPS_PROP} marker (stamped by defineFlow). Called from the
+ * NodeRegistry constructor AFTER buildNodeMaps — paths are already known.
+ */
+export function collectFlowStates(root, registry) {
+    walk(root);
+    function walk(node) {
+        const marker = node[FLOW_STEPS_PROP];
+        if (Array.isArray(marker)) {
+            const stepKeys = marker;
+            const stepNodes = [];
+            for (const key of stepKeys) {
+                const child = node[key];
+                if (!child || typeof child !== "object" || Array.isArray(child) || "value" in child) {
+                    throw new Error(`[palistor] defineFlow: step "${key}" is not a group node in the flow config.`);
+                }
+                // An empty step ({} — read-only summary) would be marked "leaf" by the
+                // hasChildren heuristic in registerNodes; a step is by definition a group.
+                child.__kind = "group";
+                stepNodes.push(child);
+            }
+            const flowState = {
+                flowNode: node,
+                path: registry.nodePaths.get(node) ?? "",
+                stepKeys: [...stepKeys],
+                stepNodes,
+                currentIndex: 0,
+                visitStack: [],
+                visitedKeys: new Set([stepKeys[0]]),
+                errors: [],
+            };
+            registry.flowStates.set(node, flowState);
+            registry.allFlowStates.push(flowState);
+            for (const stepNode of stepNodes)
+                registry.stepToFlow.set(stepNode, flowState);
+        }
+        for (const key of Object.keys(node)) {
+            if (CONFIG_PROPS.has(key))
+                continue;
+            const child = node[key];
+            if (!child || typeof child !== "object" || Array.isArray(child))
+                continue;
+            if (isGroupNode(child))
+                walk(child);
+        }
+    }
+}
+//# sourceMappingURL=flowState.js.map

package/dist/store/flow/flowState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowState.js","sourceRoot":"","sources":["../../../store/flow/flowState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsC3C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAmB,EAAE,QAA2B;IAChF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEX,SAAS,IAAI,CAAC,IAAmB;QAC/B,MAAM,MAAM,GAAI,IAAgC,CAAC,eAAe,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAkB,CAAC;YACpC,MAAM,SAAS,GAAoB,EAAE,CAAC;YACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;gBACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;oBACpF,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,2CAA2C,CAAC,CAAC;gBAClG,CAAC;gBACD,uEAAuE;gBACvE,2EAA2E;gBAC1E,KAAiC,CAAC,MAAM,GAAG,OAAO,CAAC;gBACpD,SAAS,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,SAAS,GAAc;gBAC3B,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,IAAc,CAAC,IAAI,EAAE;gBAClD,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;gBACvB,SAAS;gBACT,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,EAAE;gBACd,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM,EAAE,EAAE;aACX,CAAC;YACF,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAc,EAAE,SAAS,CAAC,CAAC;YACnD,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,QAAkB,EAAE,SAAS,CAAC,CAAC;QAC3F,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,MAAM,KAAK,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC1E,IAAI,WAAW,CAAC,KAAe,CAAC;gBAAE,IAAI,CAAC,KAAsB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/store/flow/index.d.ts

@@ -0,0 +1,10 @@
+export { defineFlow, defineStep } from "./defineFlow";
+export type { AnyFlowStep, DefineFlowOptions, FlowError, FlowNode, FlowStep, FlowValues, InferFlowSteps, StepStatus, } from "./defineFlow";
+export type { FlowState } from "./flowState";
+export { collectFlowStates } from "./flowState";
+export { collectFlowErrors, collectStepErrors, filterHiddenFlowStepErrors, flowBack, flowGoTo, flowIsInvalid, flowLoading, flowNextStep, flowSubmit, flowValidate, getStepStatus, initFlows, isStepVisible, resetFlowNav, resetFlowNavForSubtree, restoreFlowNav, runFlowEntryLifecycle, serializeFlowNav, stepIsInvalid, } from "./flowNavigation";
+export type { FlowNavSnapshot } from "./flowNavigation";
+export { buildFlowStepsProxy } from "./buildFlowStepsProxy";
+export { getFlowApi } from "./flowApi";
+export type { FlowApi } from "./flowApi";
+//# sourceMappingURL=index.d.ts.map

package/dist/store/flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../store/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/store/flow/index.js

@@ -0,0 +1,6 @@
+export { defineFlow, defineStep } from "./defineFlow";
+export { collectFlowStates } from "./flowState";
+export { collectFlowErrors, collectStepErrors, filterHiddenFlowStepErrors, flowBack, flowGoTo, flowIsInvalid, flowLoading, flowNextStep, flowSubmit, flowValidate, getStepStatus, initFlows, isStepVisible, resetFlowNav, resetFlowNavForSubtree, restoreFlowNav, runFlowEntryLifecycle, serializeFlowNav, stepIsInvalid, } from "./flowNavigation";
+export { buildFlowStepsProxy } from "./buildFlowStepsProxy";
+export { getFlowApi } from "./flowApi";
+//# sourceMappingURL=index.js.map

package/dist/store/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../store/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAatD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/store/groupDeps/createGroupDeps.d.ts

@@ -1,9 +1,9 @@
 import { type AnyConfigNode } from "../store/types";
 /**
- * Создать карту зависимостей с self-зависимостью для каждой группы.
+ * Create the dependency map with a self-dependency for every group.
  *
- * Группа — любой узел конфига без "value".
- * Root-группа обозначается пустой строкой "".
+ * A group is any config node without "value".
+ * The root group is denoted by the empty string "".
  */
 export declare function createGroupDeps(rootConfig: AnyConfigNode, nodePaths: WeakMap<object, string>): Set<string>;
 //# sourceMappingURL=createGroupDeps.d.ts.map

package/dist/store/groupDeps/createGroupDeps.js

@@ -1,23 +1,23 @@
 import { configKeys, isLeafNode } from "../traversal";
 import { pairKey } from "./pairKey";
 /**
- * Создать карту зависимостей с self-зависимостью для каждой группы.
+ * Create the dependency map with a self-dependency for every group.
  *
- * Группа — любой узел конфига без "value".
- * Root-группа обозначается пустой строкой "".
+ * A group is any config node without "value".
+ * The root group is denoted by the empty string "".
  */
 export function createGroupDeps(rootConfig, nodePaths) {
     const deps = new Set();
-    // Self-зависимость корня
+    // Root self-dependency
     deps.add(pairKey("", ""));
-    // Self-зависимости вложенных групп
+    // Self-dependencies of nested groups
     function walk(node) {
         for (const key of configKeys(node)) {
             const child = node[key];
             if (!child || typeof child !== "object")
                 continue;
             if (isLeafNode(child))
-                continue; // лист — не группа
+                continue; // a leaf is not a group
             const path = nodePaths.get(child) ?? "";
             deps.add(pairKey(path, path));
             walk(child);

package/dist/store/groupDeps/createGroupDeps.js.map

@@ -1 +1 @@
-{"version":3,"file":"createGroupDeps.js","sourceRoot":"","sources":["../../../store/groupDeps/createGroupDeps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAyB,EACzB,SAAkC;IAElC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,yBAAyB;IACzB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE1B,mCAAmC;IACnC,SAAS,IAAI,CAAC,IAAmB;QAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAkB,CAAC;YACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAClD,IAAI,UAAU,CAAC,KAAK,CAAC;gBAAE,SAAS,CAAC,mBAAmB;YACpD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"createGroupDeps.js","sourceRoot":"","sources":["../../../store/groupDeps/createGroupDeps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAyB,EACzB,SAAkC;IAElC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,uBAAuB;IACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE1B,qCAAqC;IACrC,SAAS,IAAI,CAAC,IAAmB;QAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAkB,CAAC;YACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAClD,IAAI,UAAU,CAAC,KAAK,CAAC;gBAAE,SAAS,CAAC,wBAAwB;YACzD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/store/groupDeps/createTrackingValues.d.ts

@@ -1,15 +1,15 @@
 /**
- * Обёртка для valuesCache.values, которая перехватывает READ-доступы
- * и записывает кросс-групповые зависимости в Set.
+ * Wrapper for valuesCache.values that intercepts READ accesses
+ * and records cross-group dependencies into a Set.
  *
- * При чтении leaf-значения определяется группа-донор (по текущему уровню вложенности).
- * Если донор ≠ реципиент → записываем пару donor→recipient.
+ * When a leaf value is read, the donor group is determined by the current
+ * nesting level. If donor ≠ recipient → the donor→recipient pair is recorded.
  *
- * @param values             — плоский объект значений из valuesCache.values
- * @param recipientGroupPath — путь группы, для которой сейчас идёт вычисление
- * @param deps               — Set для записи обнаруженных зависимостей
- * @param currentGroupPath   — текущий уровень вложенности в дереве значений (начинается с "")
- * @param subProxyCache      — WeakMap для мемоизации суб-прокси в рамках одного вызова
+ * @param values             — flat values object from valuesCache.values
+ * @param recipientGroupPath — path of the group currently being computed
+ * @param deps               — Set that collects discovered dependencies
+ * @param currentGroupPath   — current nesting level in the values tree (starts as "")
+ * @param subProxyCache      — WeakMap memoizing sub-proxies within one call
  */
 export declare function createTrackingValues(values: Record<string, unknown>, recipientGroupPath: string, deps: Set<string>, currentGroupPath?: string, subProxyCache?: WeakMap<object, Record<string, unknown>>): Record<string, unknown>;
 //# sourceMappingURL=createTrackingValues.d.ts.map