palistor 0.0.25 → 0.0.26

package/dist/store/flow/buildFlowStepsProxy.js

@@ -1,19 +1,19 @@
 import { CONFIG_NODE, FLOW_STATE } from "../constants";
-/** Стабильный кэш steps-proxy — один на FlowState (как listProxyCache). */
+/** Stable steps-proxy cache — one per FlowState (like listProxyCache). */
 const stepsProxyCache = new WeakMap();
 const NUMERIC_KEY = /^\d+$/;
 /**
- * Proxy коллекции шагов флоу (flow.steps).
+ * Proxy over the flow's step collection (flow.steps).
  *
- * Доступ:
- *   steps[0]        — по индексу (порядок массива шагов)
- *   steps.welcome   — по ключу
- *   steps.current   — живая ссылка на прокси активного шага
- *   steps.length    — число шагов
- *   [...steps]      — итерация по step-прокси
+ * Access:
+ *   steps[0]        — by index (step array order)
+ *   steps.welcome   — by key
+ *   steps.current   — live reference to the active step's proxy
+ *   steps.length    — number of steps
+ *   [...steps]      — iteration over step proxies
  *
- * Step-прокси — обычные group-прокси step-нод (кэшируются в proxyCache),
- * обогащённые `status` в group GET-трапе (через stepToFlow).
+ * Step proxies are regular group proxies of the step nodes (cached in
+ * proxyCache), enriched with `status` in the group GET trap (via stepToFlow).
  */
 export function buildFlowStepsProxy(flowState, kernel) {
     const cached = stepsProxyCache.get(flowState);
@@ -23,10 +23,10 @@ export function buildFlowStepsProxy(flowState, kernel) {
     const spreadKeys = () => [...flowState.stepKeys, "current", "length"];
     const proxy = new Proxy({}, {
         get(_target, key) {
-            // Бренд трекинга: навигация бампает версию FlowState.
+            // Tracking brand: navigation bumps the FlowState version.
             if (key === FLOW_STATE)
                 return flowState;
-            // steps — не config-узел; для tracking proxy прозрачен.
+            // steps is not a config node; transparent to the tracking proxy.
             if (key === CONFIG_NODE)
                 return undefined;
             if (typeof key === "symbol") {
@@ -52,7 +52,7 @@ export function buildFlowStepsProxy(flowState, kernel) {
             return undefined;
         },
         set() {
-            // Состав шагов статичен — запись запрещена.
+            // The step set is static — writes are forbidden.
             return false;
         },
         ownKeys() {

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

@@ -1 +1 @@
-{"version":3,"file":"buildFlowStepsProxy.js","sourceRoot":"","sources":["../../../store/flow/buildFlowStepsProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAIvD,2EAA2E;AAC3E,MAAM,eAAe,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEtD,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB,EAAE,MAA0B;IAClF,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,SAA8B,CAAC,CAAC;IACnE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAC1C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAW,CAAC;IAElE,MAAM,UAAU,GAAG,GAAa,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAA6B,EAAE;QACrD,GAAG,CAAC,OAAO,EAAE,GAAoB;YAC/B,sDAAsD;YACtD,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YACzC,wDAAwD;YACxD,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,SAAS,CAAC;YAE1C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,GAAG,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC5B,OAAO,QAAQ,CAAC;wBACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE;4BAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC1E,CAAC,CAAC;gBACJ,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAEhE,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,OAAO,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;YAE1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,GAAG;YACD,4CAA4C;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QAED,wBAAwB,CAAC,OAAO,EAAE,GAAoB;YACpD,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC9C,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YAClD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CAAC;IAEH,eAAe,CAAC,GAAG,CAAC,SAA8B,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"buildFlowStepsProxy.js","sourceRoot":"","sources":["../../../store/flow/buildFlowStepsProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAIvD,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEtD,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB,EAAE,MAA0B;IAClF,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,SAA8B,CAAC,CAAC;IACnE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAC1C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAW,CAAC;IAElE,MAAM,UAAU,GAAG,GAAa,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAA6B,EAAE;QACrD,GAAG,CAAC,OAAO,EAAE,GAAoB;YAC/B,0DAA0D;YAC1D,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YACzC,iEAAiE;YACjE,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,SAAS,CAAC;YAE1C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,GAAG,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC5B,OAAO,QAAQ,CAAC;wBACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE;4BAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC1E,CAAC,CAAC;gBACJ,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAEhE,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,OAAO,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;YAE1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,GAAG;YACD,iDAAiD;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QAED,wBAAwB,CAAC,OAAO,EAAE,GAAoB;YACpD,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC9C,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YAClD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CAAC;IAEH,eAAe,CAAC,GAAG,CAAC,SAA8B,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -1,51 +1,52 @@
 import type { ExtractValues, ProxyStore } from "../store/types";
 /**
- * Статус шага флоу — вычисляемое свойство step-proxy, производное от
- * навигационного состояния (currentStepKey + visited set). Не является
- * leaf-нодой: не попадает в values, submit-payload и persisted-значения.
+ * Flow step status — a computed step-proxy property derived from navigation
+ * state (currentStepKey + visited set). Not a leaf node: never appears in
+ * values, submit payloads or persisted state.
  *
- * - `null`        — шаг ещё не посещался
- * - `"active"`    — текущий шаг
- * - `"completed"` — был активен, затем ушли (вперёд или назад)
+ * - `null`        — the step has not been visited yet
+ * - `"active"`    — the current step
+ * - `"completed"` — was active, then left (forward or back)
  */
 export type StepStatus = "active" | "completed" | null;
-/** Ошибка валидации флоу — та же форма, что в SubmitResult. */
+/** Flow validation error — same shape as in SubmitResult. */
 export interface FlowError {
     path: string;
     message: string;
 }
 /**
- * Результат defineStep: группа-конфиг шага + его ключ во флоу.
- * defineFlow разворачивает шаги в обычные дочерние группы flow-ноды.
+ * Result of defineStep: the step's group config + its key within the flow.
+ * defineFlow expands steps into regular child groups of the flow node.
  */
 export interface FlowStep<K extends string = string, C extends Record<string, any> = Record<string, any>> {
     readonly key: K;
     readonly config: C;
 }
 export type AnyFlowStep = FlowStep<string, Record<string, any>>;
-/** Значения флоу — все шаги по ключам (аккумулированное состояние). */
+/** Flow values — all steps by key (accumulated state). */
 export type FlowValues<S extends readonly AnyFlowStep[]> = {
     [Step in S[number] as Step["key"]]: ExtractValues<Step["config"]>;
 };
 declare const __flowBrand: unique symbol;
 /**
- * Узел флоу в дереве конфига: обычная группа (шаги — дочерние группы по ключам),
- * помеченная брендом с кортежем шагов для вывода типов proxy.
+ * A flow node in the config tree: a regular group (steps are child groups by
+ * key), branded with the step tuple for proxy type inference.
  */
 export type FlowNode<S extends readonly AnyFlowStep[]> = {
     readonly [__flowBrand]: S;
 } & {
     [Step in S[number] as Step["key"]]: Step["config"];
 };
-/** Извлечь кортеж шагов из FlowNode (never — если узел не флоу). */
+/** Extract the step tuple from a FlowNode (never when the node is not a flow). */
 export type InferFlowSteps<T> = T extends {
     readonly [__flowBrand]: infer S extends readonly AnyFlowStep[];
 } ? S : never;
 /**
- * Обернуть конфиг группы в шаг флоу.
+ * Wrap a group config into a flow step.
  *
- * Конфиг шага — обычная group-нода Palistor (поля, isVisible, validate,
- * resolve, onSubmit, …) плюс flow-lifecycle колбэки `onEnter` / `onReady`.
+ * A step config is a regular Palistor group node (fields, isVisible,
+ * validate, resolve, onSubmit, …) plus the flow lifecycle callbacks
+ * `onEnter` / `onReady`.
  *
  * @example
  * defineStep("welcome", {
@@ -57,24 +58,25 @@ export declare function defineStep<const K extends string, const C extends Recor
     status?: never;
 }): FlowStep<K, C>;
 export interface DefineFlowOptions<S extends readonly AnyFlowStep[]> {
-    /** Упорядоченный массив шагов (defineStep). Порядок определяет nextStep(). */
+    /** Ordered array of steps (defineStep). The order drives nextStep(). */
     steps: S;
-    /** Flow-level submit: вызывается стандартным submit-пайплайном над всеми шагами. */
+    /** Flow-level submit: invoked by the standard submit pipeline over all steps. */
     onSubmit?: (values: FlowValues<S>, store: ProxyStore<any>, parent?: any) => Promise<unknown> | unknown;
-    /** Group-level трансформация значений перед submit. */
+    /** Group-level value transformation before submit. */
     beforeSubmit?: (values: FlowValues<S>) => FlowValues<S> | Promise<FlowValues<S>>;
-    /** Пост-обработка после успешного onSubmit. */
+    /** Post-processing after a successful onSubmit. */
     afterSubmit?: (result: unknown, actions: {
         reset: () => void;
     }) => void | Promise<void>;
 }
 /**
- * Собрать flow-ноду из упорядоченного массива шагов.
+ * Build a flow node from an ordered array of steps.
  *
- * Возвращаемый узел — обычная группа в дереве конфига (шаги — дочерние группы
- * по своим ключам), помеченная маркером {@link FLOW_STEPS_PROP} с порядком
- * шагов. Участвует в values / persist / dirty как любая группа; NodeRegistry
- * по маркеру создаёт FlowState (навигация, статусы, история).
+ * The returned node is a regular group in the config tree (steps become child
+ * groups under their keys), stamped with the {@link FLOW_STEPS_PROP} marker
+ * holding the step order. It participates in values / persist / dirty like
+ * any group; NodeRegistry creates a FlowState (navigation, statuses, history)
+ * based on the marker.
  *
  * @example
  * const onboarding = defineFlow({

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

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

package/dist/store/flow/defineFlow.js

@@ -1,15 +1,16 @@
 import { CONFIG_PROPS, FLOW_SPREAD_KEYS, FLOW_STEPS_PROP, GROUP_SPREAD_KEYS, } from "../constants";
 // ─── defineStep ───────────────────────────────────────────────────────────────
 /**
- * Имя `status` зарезервировано на step-proxy под вычисляемый статус шага —
- * поле с таким именем в конфиге шага запрещено (по аналогии с dirty/loading).
+ * The name `status` is reserved on the step proxy for the computed step
+ * status — a config field with that name is forbidden (like dirty/loading).
  */
 const RESERVED_STEP_CONFIG_KEYS = new Set(["status"]);
 /**
- * Обернуть конфиг группы в шаг флоу.
+ * Wrap a group config into a flow step.
  *
- * Конфиг шага — обычная group-нода Palistor (поля, isVisible, validate,
- * resolve, onSubmit, …) плюс flow-lifecycle колбэки `onEnter` / `onReady`.
+ * A step config is a regular Palistor group node (fields, isVisible,
+ * validate, resolve, onSubmit, …) plus the flow lifecycle callbacks
+ * `onEnter` / `onReady`.
  *
  * @example
  * defineStep("welcome", {
@@ -36,8 +37,8 @@ export function defineStep(key, config) {
 }
 // ─── defineFlow ───────────────────────────────────────────────────────────────
 /**
- * Ключи шагов, конфликтующие со свойствами flow-proxy / steps-proxy /
- * служебными ключами конфига — запрещены как имена шагов.
+ * Step keys that conflict with flow-proxy / steps-proxy properties or service
+ * config keys — forbidden as step names.
  */
 const RESERVED_STEP_KEYS = new Set([
     ...CONFIG_PROPS,
@@ -48,12 +49,13 @@ const RESERVED_STEP_KEYS = new Set([
     "length",
 ]);
 /**
- * Собрать flow-ноду из упорядоченного массива шагов.
+ * Build a flow node from an ordered array of steps.
  *
- * Возвращаемый узел — обычная группа в дереве конфига (шаги — дочерние группы
- * по своим ключам), помеченная маркером {@link FLOW_STEPS_PROP} с порядком
- * шагов. Участвует в values / persist / dirty как любая группа; NodeRegistry
- * по маркеру создаёт FlowState (навигация, статусы, история).
+ * The returned node is a regular group in the config tree (steps become child
+ * groups under their keys), stamped with the {@link FLOW_STEPS_PROP} marker
+ * holding the step order. It participates in values / persist / dirty like
+ * any group; NodeRegistry creates a FlowState (navigation, statuses, history)
+ * based on the marker.
  *
  * @example
  * const onboarding = defineFlow({
@@ -90,7 +92,7 @@ export function defineFlow(options) {
         node.beforeSubmit = beforeSubmit;
     if (afterSubmit)
         node.afterSubmit = afterSubmit;
-    // Маркер флоу: входит в CONFIG_PROPS → все обходы дерева его пропускают.
+    // Flow marker: part of CONFIG_PROPS → all tree walks skip it.
     node[FLOW_STEPS_PROP] = stepKeys;
     return node;
 }

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

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

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

@@ -3,8 +3,9 @@ import type { SubmitResult } from "../submitPipeline/types";
 import type { FlowError } from "./defineFlow";
 import type { FlowState } from "./flowState";
 /**
- * Навигационные методы flow-proxy. Все — bound-замыкания над (kernel, flowState),
- * поэтому деструктуризация в onSubmit работает: `(values, store, { nextStep }) => …`.
+ * Navigation methods of the flow proxy. All are closures bound over
+ * (kernel, flowState), so destructuring in onSubmit works:
+ * `(values, store, { nextStep }) => …`.
  */
 export interface FlowApi {
     nextStep: () => void;

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

@@ -1 +1 @@
-{"version":3,"file":"flowApi.d.ts","sourceRoot":"","sources":["../../../store/flow/flowApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACrC;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAcpF"}
+{"version":3,"file":"flowApi.d.ts","sourceRoot":"","sources":["../../../store/flow/flowApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACrC;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAcpF"}

package/dist/store/flow/flowApi.js

@@ -1,5 +1,5 @@
 import { flowBack, flowGoTo, flowNextStep, flowSubmit, flowValidate, } from "./flowNavigation";
-/** Стабильные ссылки на методы — один FlowApi на FlowState (для React). */
+/** Stable method references — one FlowApi per FlowState (for React). */
 const flowApiCache = new WeakMap();
 export function getFlowApi(kernel, flowState) {
     const cached = flowApiCache.get(flowState);

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

@@ -1 +1 @@
-{"version":3,"file":"flowApi.js","sourceRoot":"","sources":["../../../store/flow/flowApi.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAc1B,2EAA2E;AAC3E,MAAM,YAAY,GAAG,IAAI,OAAO,EAAmB,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAC,MAA0B,EAAE,SAAoB;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,SAA8B,CAAC,CAAC;IAChE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAY;QACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/C,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QACvC,IAAI,EAAE,CAAC,UAA2B,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC;QAC9E,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;KAC5C,CAAC;IAEF,YAAY,CAAC,GAAG,CAAC,SAA8B,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"flowApi.js","sourceRoot":"","sources":["../../../store/flow/flowApi.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAe1B,wEAAwE;AACxE,MAAM,YAAY,GAAG,IAAI,OAAO,EAAmB,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAC,MAA0B,EAAE,SAAoB;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,SAA8B,CAAC,CAAC;IAChE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAY;QACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/C,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QACvC,IAAI,EAAE,CAAC,UAA2B,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC;QAC9E,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;KAC5C,CAAC;IAEF,YAAY,CAAC,GAAG,CAAC,SAA8B,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -4,49 +4,49 @@ import type { SubmitResult } from "../submitPipeline/types";
 import type { FlowError, StepStatus } from "./defineFlow";
 import type { FlowState } from "./flowState";
 type Kernel = Palistor<any, any>;
-/** Статус шага — производная от навигационного состояния (не хранится). */
+/** Step status — derived from navigation state (not stored). */
 export declare function getStepStatus(flowState: FlowState, stepNode: object): StepStatus;
-/** Видимость шага — из вычисленного FieldState группы (isVisible реактивен). */
+/** Step visibility — from the group's computed FieldState (isVisible is reactive). */
 export declare function isStepVisible(kernel: Kernel, stepNode: object): boolean;
-/** Композитный loading флоу: true, если резолвится хотя бы один шаг. */
+/** Composite flow loading: true when at least one step is resolving. */
 export declare function flowLoading(kernel: Kernel, flowState: FlowState): boolean;
 /**
- * Собрать ошибки листьев поддерева шага. Валидация считается «вживую» через
- * computeFieldState(revalidate=true) — не зависит от флага revalidate группы
- * (тот выставляется только submit-пайплайном). Скрытые листья пропускаются.
- * Списки внутри шага пропускаются (паритет с collectLeafStates).
+ * 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` — префикс путей ошибок. Флоу передаёт КЛЮЧ шага: пути получаются
- * относительными flow-ноды ("welcome.name") — та же база, что у ошибок
- * submit-пайплайна при flow.submit() (collectLeafStates строит пути от
- * submitted-ноды).
+ * `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 declare function collectStepErrors(kernel: Kernel, stepNode: AnyConfigNode, basePath?: string): FlowError[];
-/** Live-агрегат валидности шага (flow.steps.x.isInvalid). */
+/** Live aggregate of step validity (flow.steps.x.isInvalid). */
 export declare function stepIsInvalid(kernel: Kernel, stepNode: AnyConfigNode): boolean;
 /**
- * Ошибки флоу по посещённым видимым шагам (скоуп flow.validate()).
- * Скрытые шаги исключаются всегда — невзятая ветка не должна блокировать.
- * Пути ошибок относительны flow-ноды ("stepKey.field") — как у SubmitResult
- * при flow.submit().
+ * 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 declare function collectFlowErrors(kernel: Kernel, flowState: FlowState): FlowError[];
-/** Агрегат flow.isInvalid: есть ли ошибки в посещённых видимых шагах. */
+/** Aggregate flow.isInvalid: any errors in visited visible steps. */
 export declare function flowIsInvalid(kernel: Kernel, flowState: FlowState): boolean;
 /**
- * flow.validate(): собрать ошибки посещённых шагов, записать в реактивный
- * flow.errors и вернуть. Пустой массив = всё валидно.
+ * flow.validate(): collect errors of the visited steps, write them into the
+ * reactive flow.errors and return them. Empty array = all valid.
  */
 export declare function flowValidate(kernel: Kernel, flowState: FlowState): FlowError[];
 /**
- * Отфильтровать из ошибок submit-пайплайна листья, лежащие под СКРЫТЫМИ
- * шагами любого флоу (Resolved Decision 14): базовый пайплайн валидирует все
- * листья независимо от видимости, и без фильтра невзятая ветка с isRequired
- * навсегда блокировала бы финализацию.
+ * 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` — узел, для которого выполнялся submit: пути ошибок пайплайна
- * ОТНОСИТЕЛЬНЫ ему (collectLeafStates строит пути от submitted-ноды), поэтому
- * абсолютные пути скрытых шагов приводятся к той же базе.
+ * `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 declare function filterHiddenFlowStepErrors(kernel: Kernel, errors: Array<{
     path: string;
@@ -56,80 +56,82 @@ export declare function filterHiddenFlowStepErrors(kernel: Kernel, errors: Array
     message: string;
 }>;
 /**
- * flow.submit(): стандартный group-submit пайплайн над flow-нодой
- * (submitting → beforeSubmit → validate → onSubmit → afterSubmit; листья
- * скрытых шагов отфильтровываются пайплайном). Ошибки валидации ложатся в
- * реактивный flow.errors; при успехе errors очищаются.
+ * 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 declare function flowSubmit(kernel: Kernel, flowState: FlowState): Promise<SubmitResult>;
 /**
- * Lifecycle входа в шаг: onEnter → resolve (eager) → onReady.
+ * Step entry lifecycle: onEnter → resolve (eager) → onReady.
  *
- * - `onEnter` / `onReady` получают FLOW-scoped values (все шаги по ключам) —
- *   живую ссылку groupSlot флоу; fire-and-forget.
- * - resolve шага — стандартный group resolve; флоу триггерит его НА ВХОДЕ
- *   (эквивалент первого доступа). Уже resolved/error (кэш) — не перезапускается,
- *   и onReady НЕ вызывается повторно (Resolved Decision 10).
- * - Без resolve — onReady сразу после onEnter.
+ * - `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 declare function runEntryLifecycle(kernel: Kernel, flowState: FlowState, stepNode: AnyConfigNode): void;
 /**
- * nextStep(): следующий ВИДИМЫЙ шаг по порядку массива; скрытые пропускаются.
- * Если видимых впереди нет — финализация через flow.submit() (при ошибках
- * валидации onSubmit не вызывается, ошибки в flow.errors, шаг не меняется).
+ * 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 declare function flowNextStep(kernel: Kernel, flowState: FlowState): void;
-/** back(): вернуться по стеку посещений. No-op при пустом стеке (canGoBack). */
+/** back(): go back along the visit stack. No-op when the stack is empty (canGoBack). */
 export declare function flowBack(kernel: Kernel, flowState: FlowState): void;
 /**
- * goTo(keyOrIndex): произвольный переход по ключу или индексу.
- * Несуществующий ключ/индекс — throw (ловит опечатки на этапе разработки).
- * Переход в текущий шаг — no-op.
+ * 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 declare function flowGoTo(kernel: Kernel, flowState: FlowState, keyOrIndex: string | number): void;
 /**
- * Сброс навигации флоу: первый шаг активен, стек и visited очищены,
- * resolve-состояния шагов сброшены в idle. Lifecycle входа первого шага
- * (onEnter → resolve → onReady) выполняется заново — зеркально инициализации.
+ * 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 declare function resetFlowNav(kernel: Kernel, flowState: FlowState): void;
 /**
- * Сбросить навигацию всех флоу, попавших в поддерево сброса.
- * Вызывается из ResetPipeline (root reset → все флоу; reset группы → флоу внутри неё).
+ * Reset navigation of all flows that fall into the reset subtree.
+ * Called from ResetPipeline (root reset → all flows; group reset → flows inside it).
  */
 export declare function resetFlowNavForSubtree(kernel: Kernel, groupNode: AnyConfigNode): void;
 /**
- * Инициализационный lifecycle: первый шаг каждого флоу «входится» при создании
- * store (onEnter → resolve → onReady). Вызывается из конструктора Palistor.
+ * Initialization lifecycle: the first step of every flow is "entered" at
+ * store creation (onEnter → resolve → onReady). Called from the Palistor
+ * constructor.
  *
- * Дополнительно прогревает proxyCache flow-нод: identity-view шага снимает
- * parent.proxy из кэша при первом step.submit(), и flow-proxy к этому моменту
- * уже должен существовать — иначе onSubmit шага получил бы undefined
- * третьим аргументом.
+ * 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 declare function initFlows(kernel: Kernel): void;
-/** Снимок навигации флоу в persist-снапшоте (значения полей хранятся отдельно). */
+/** Flow navigation snapshot in the persist payload (field values are stored separately). */
 export interface FlowNavSnapshot {
     currentStepKey: string;
     visitStack: string[];
     visitedKeys: string[];
 }
 /**
- * Сериализовать навигацию всех флоу для persist: ключ — dot-путь flow-ноды.
- * Статусы шагов не сохраняются — выводятся из навигации при гидратации.
+ * 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 declare function serializeFlowNav(kernel: Kernel): Record<string, FlowNavSnapshot> | null;
 /**
- * Восстановить навигацию флоу из persist-снимка. Неизвестные ключи шагов
- * (конфиг изменился) отбрасываются; несовместимый currentStepKey — флоу
- * остаётся в текущем состоянии. Возвращает изменённые узлы для notify и
- * список флоу, чей активный шаг изменился (для повторного entry lifecycle).
+ * 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 declare function restoreFlowNav(kernel: Kernel, snapshots: Record<string, FlowNavSnapshot>): {
     changed: Set<object>;
     entered: FlowState[];
 };
-/** Entry lifecycle текущего шага (используется persist после гидратации). */
+/** Entry lifecycle of the current step (used by persist after hydration). */
 export declare function runFlowEntryLifecycle(kernel: Kernel, flowState: FlowState): void;
 export {};
 //# sourceMappingURL=flowNavigation.d.ts.map

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

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