palistor 0.0.24 → 0.0.25

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

@@ -0,0 +1,90 @@
+import type { ExtractValues, ProxyStore } from "../store/types";
+/**
+ * Статус шага флоу — вычисляемое свойство step-proxy, производное от
+ * навигационного состояния (currentStepKey + visited set). Не является
+ * leaf-нодой: не попадает в values, submit-payload и persisted-значения.
+ *
+ * - `null`        — шаг ещё не посещался
+ * - `"active"`    — текущий шаг
+ * - `"completed"` — был активен, затем ушли (вперёд или назад)
+ */
+export type StepStatus = "active" | "completed" | null;
+/** Ошибка валидации флоу — та же форма, что в SubmitResult. */
+export interface FlowError {
+    path: string;
+    message: string;
+}
+/**
+ * Результат defineStep: группа-конфиг шага + его ключ во флоу.
+ * defineFlow разворачивает шаги в обычные дочерние группы flow-ноды.
+ */
+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>>;
+/** Значения флоу — все шаги по ключам (аккумулированное состояние). */
+export type FlowValues<S extends readonly AnyFlowStep[]> = {
+    [Step in S[number] as Step["key"]]: ExtractValues<Step["config"]>;
+};
+declare const __flowBrand: unique symbol;
+/**
+ * Узел флоу в дереве конфига: обычная группа (шаги — дочерние группы по ключам),
+ * помеченная брендом с кортежем шагов для вывода типов proxy.
+ */
+export type FlowNode<S extends readonly AnyFlowStep[]> = {
+    readonly [__flowBrand]: S;
+} & {
+    [Step in S[number] as Step["key"]]: Step["config"];
+};
+/** Извлечь кортеж шагов из FlowNode (never — если узел не флоу). */
+export type InferFlowSteps<T> = T extends {
+    readonly [__flowBrand]: infer S extends readonly AnyFlowStep[];
+} ? S : never;
+/**
+ * Обернуть конфиг группы в шаг флоу.
+ *
+ * Конфиг шага — обычная group-нода Palistor (поля, isVisible, validate,
+ * resolve, onSubmit, …) плюс flow-lifecycle колбэки `onEnter` / `onReady`.
+ *
+ * @example
+ * defineStep("welcome", {
+ *   name: { value: "", isRequired: true },
+ *   onSubmit: async (values, store, { nextStep }) => { nextStep(); },
+ * })
+ */
+export declare function defineStep<const K extends string, const C extends Record<string, any>>(key: K, config: C & {
+    status?: never;
+}): FlowStep<K, C>;
+export interface DefineFlowOptions<S extends readonly AnyFlowStep[]> {
+    /** Упорядоченный массив шагов (defineStep). Порядок определяет nextStep(). */
+    steps: S;
+    /** Flow-level submit: вызывается стандартным submit-пайплайном над всеми шагами. */
+    onSubmit?: (values: FlowValues<S>, store: ProxyStore<any>, parent?: any) => Promise<unknown> | unknown;
+    /** Group-level трансформация значений перед submit. */
+    beforeSubmit?: (values: FlowValues<S>) => FlowValues<S> | Promise<FlowValues<S>>;
+    /** Пост-обработка после успешного onSubmit. */
+    afterSubmit?: (result: unknown, actions: {
+        reset: () => void;
+    }) => void | Promise<void>;
+}
+/**
+ * Собрать flow-ноду из упорядоченного массива шагов.
+ *
+ * Возвращаемый узел — обычная группа в дереве конфига (шаги — дочерние группы
+ * по своим ключам), помеченная маркером {@link FLOW_STEPS_PROP} с порядком
+ * шагов. Участвует в values / persist / dirty как любая группа; NodeRegistry
+ * по маркеру создаёт FlowState (навигация, статусы, история).
+ *
+ * @example
+ * const onboarding = defineFlow({
+ *   steps: [
+ *     defineStep("welcome", { name: { value: "", isRequired: true } }),
+ *     defineStep("summary", {}),
+ *   ],
+ *   onSubmit: async (allValues, store) => api.completeOnboarding(allValues),
+ * });
+ */
+export declare function defineFlow<const S extends readonly AnyFlowStep[]>(options: DefineFlowOptions<S>): FlowNode<S>;
+export {};
+//# sourceMappingURL=defineFlow.d.ts.map

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

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

package/dist/store/flow/defineFlow.js

@@ -0,0 +1,97 @@
+import { CONFIG_PROPS, FLOW_SPREAD_KEYS, FLOW_STEPS_PROP, GROUP_SPREAD_KEYS, } from "../constants";
+// ─── defineStep ───────────────────────────────────────────────────────────────
+/**
+ * Имя `status` зарезервировано на step-proxy под вычисляемый статус шага —
+ * поле с таким именем в конфиге шага запрещено (по аналогии с dirty/loading).
+ */
+const RESERVED_STEP_CONFIG_KEYS = new Set(["status"]);
+/**
+ * Обернуть конфиг группы в шаг флоу.
+ *
+ * Конфиг шага — обычная group-нода Palistor (поля, isVisible, validate,
+ * resolve, onSubmit, …) плюс flow-lifecycle колбэки `onEnter` / `onReady`.
+ *
+ * @example
+ * defineStep("welcome", {
+ *   name: { value: "", isRequired: true },
+ *   onSubmit: async (values, store, { nextStep }) => { nextStep(); },
+ * })
+ */
+export function defineStep(key, config) {
+    if (typeof key !== "string" || key.length === 0) {
+        throw new Error("[palistor] defineStep: key must be a non-empty string.");
+    }
+    if (!config || typeof config !== "object" || Array.isArray(config)) {
+        throw new Error(`[palistor] defineStep("${key}"): config must be a plain object (group node).`);
+    }
+    if ("value" in config) {
+        throw new Error(`[palistor] defineStep("${key}"): step config must be a group node — a "value" key makes it a leaf.`);
+    }
+    for (const reserved of RESERVED_STEP_CONFIG_KEYS) {
+        if (reserved in config) {
+            throw new Error(`[palistor] defineStep("${key}"): "${reserved}" is reserved — the flow exposes it as a computed step property.`);
+        }
+    }
+    return { key, config: config };
+}
+// ─── defineFlow ───────────────────────────────────────────────────────────────
+/**
+ * Ключи шагов, конфликтующие со свойствами flow-proxy / steps-proxy /
+ * служебными ключами конфига — запрещены как имена шагов.
+ */
+const RESERVED_STEP_KEYS = new Set([
+    ...CONFIG_PROPS,
+    ...GROUP_SPREAD_KEYS,
+    ...FLOW_SPREAD_KEYS,
+    "setValues",
+    "current",
+    "length",
+]);
+/**
+ * Собрать flow-ноду из упорядоченного массива шагов.
+ *
+ * Возвращаемый узел — обычная группа в дереве конфига (шаги — дочерние группы
+ * по своим ключам), помеченная маркером {@link FLOW_STEPS_PROP} с порядком
+ * шагов. Участвует в values / persist / dirty как любая группа; NodeRegistry
+ * по маркеру создаёт FlowState (навигация, статусы, история).
+ *
+ * @example
+ * const onboarding = defineFlow({
+ *   steps: [
+ *     defineStep("welcome", { name: { value: "", isRequired: true } }),
+ *     defineStep("summary", {}),
+ *   ],
+ *   onSubmit: async (allValues, store) => api.completeOnboarding(allValues),
+ * });
+ */
+export function defineFlow(options) {
+    const { steps, onSubmit, beforeSubmit, afterSubmit } = options;
+    if (!Array.isArray(steps) || steps.length === 0) {
+        throw new Error("[palistor] defineFlow: `steps` must be a non-empty array of defineStep(...) results.");
+    }
+    const node = {};
+    const stepKeys = [];
+    for (const step of steps) {
+        if (!step || typeof step !== "object" || typeof step.key !== "string" || !step.config) {
+            throw new Error("[palistor] defineFlow: each entry of `steps` must be created via defineStep(key, config).");
+        }
+        if (RESERVED_STEP_KEYS.has(step.key)) {
+            throw new Error(`[palistor] defineFlow: step key "${step.key}" is reserved by the flow/group proxy API.`);
+        }
+        if (stepKeys.includes(step.key)) {
+            throw new Error(`[palistor] defineFlow: duplicate step key "${step.key}".`);
+        }
+        node[step.key] = step.config;
+        stepKeys.push(step.key);
+    }
+    if (onSubmit)
+        node.onSubmit = onSubmit;
+    if (beforeSubmit)
+        node.beforeSubmit = beforeSubmit;
+    if (afterSubmit)
+        node.afterSubmit = afterSubmit;
+    // Маркер флоу: входит в CONFIG_PROPS → все обходы дерева его пропускают.
+    node[FLOW_STEPS_PROP] = stepKeys;
+    return node;
+}
+//# sourceMappingURL=defineFlow.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { Palistor } from "../store/palistor";
+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 }) => …`.
+ */
+export interface FlowApi {
+    nextStep: () => void;
+    back: () => void;
+    goTo: (keyOrIndex: string | number) => void;
+    validate: () => FlowError[];
+    submit: () => Promise<SubmitResult>;
+}
+export declare function getFlowApi(kernel: Palistor<any, any>, flowState: FlowState): FlowApi;
+//# sourceMappingURL=flowApi.d.ts.map

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

@@ -0,0 +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"}

package/dist/store/flow/flowApi.js

@@ -0,0 +1,18 @@
+import { flowBack, flowGoTo, flowNextStep, flowSubmit, flowValidate, } from "./flowNavigation";
+/** Стабильные ссылки на методы — один FlowApi на FlowState (для React). */
+const flowApiCache = new WeakMap();
+export function getFlowApi(kernel, flowState) {
+    const cached = flowApiCache.get(flowState);
+    if (cached)
+        return cached;
+    const api = {
+        nextStep: () => flowNextStep(kernel, flowState),
+        back: () => flowBack(kernel, flowState),
+        goTo: (keyOrIndex) => flowGoTo(kernel, flowState, keyOrIndex),
+        validate: () => flowValidate(kernel, flowState),
+        submit: () => flowSubmit(kernel, flowState),
+    };
+    flowApiCache.set(flowState, api);
+    return api;
+}
+//# sourceMappingURL=flowApi.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,135 @@
+import type { AnyConfigNode } from "../store/types";
+import type { Palistor } from "../store/palistor";
+import type { SubmitResult } from "../submitPipeline/types";
+import type { FlowError, StepStatus } from "./defineFlow";
+import type { FlowState } from "./flowState";
+type Kernel = Palistor<any, any>;
+/** Статус шага — производная от навигационного состояния (не хранится). */
+export declare function getStepStatus(flowState: FlowState, stepNode: object): StepStatus;
+/** Видимость шага — из вычисленного FieldState группы (isVisible реактивен). */
+export declare function isStepVisible(kernel: Kernel, stepNode: object): boolean;
+/** Композитный loading флоу: true, если резолвится хотя бы один шаг. */
+export declare function flowLoading(kernel: Kernel, flowState: FlowState): boolean;
+/**
+ * Собрать ошибки листьев поддерева шага. Валидация считается «вживую» через
+ * computeFieldState(revalidate=true) — не зависит от флага revalidate группы
+ * (тот выставляется только submit-пайплайном). Скрытые листья пропускаются.
+ * Списки внутри шага пропускаются (паритет с collectLeafStates).
+ *
+ * `basePath` — префикс путей ошибок. Флоу передаёт КЛЮЧ шага: пути получаются
+ * относительными flow-ноды ("welcome.name") — та же база, что у ошибок
+ * submit-пайплайна при flow.submit() (collectLeafStates строит пути от
+ * submitted-ноды).
+ */
+export declare function collectStepErrors(kernel: Kernel, stepNode: AnyConfigNode, basePath?: string): FlowError[];
+/** Live-агрегат валидности шага (flow.steps.x.isInvalid). */
+export declare function stepIsInvalid(kernel: Kernel, stepNode: AnyConfigNode): boolean;
+/**
+ * Ошибки флоу по посещённым видимым шагам (скоуп flow.validate()).
+ * Скрытые шаги исключаются всегда — невзятая ветка не должна блокировать.
+ * Пути ошибок относительны flow-ноды ("stepKey.field") — как у SubmitResult
+ * при flow.submit().
+ */
+export declare function collectFlowErrors(kernel: Kernel, flowState: FlowState): FlowError[];
+/** Агрегат flow.isInvalid: есть ли ошибки в посещённых видимых шагах. */
+export declare function flowIsInvalid(kernel: Kernel, flowState: FlowState): boolean;
+/**
+ * flow.validate(): собрать ошибки посещённых шагов, записать в реактивный
+ * flow.errors и вернуть. Пустой массив = всё валидно.
+ */
+export declare function flowValidate(kernel: Kernel, flowState: FlowState): FlowError[];
+/**
+ * Отфильтровать из ошибок submit-пайплайна листья, лежащие под СКРЫТЫМИ
+ * шагами любого флоу (Resolved Decision 14): базовый пайплайн валидирует все
+ * листья независимо от видимости, и без фильтра невзятая ветка с isRequired
+ * навсегда блокировала бы финализацию.
+ *
+ * `submittedNode` — узел, для которого выполнялся submit: пути ошибок пайплайна
+ * ОТНОСИТЕЛЬНЫ ему (collectLeafStates строит пути от submitted-ноды), поэтому
+ * абсолютные пути скрытых шагов приводятся к той же базе.
+ */
+export declare function filterHiddenFlowStepErrors(kernel: Kernel, errors: Array<{
+    path: string;
+    message: string;
+}>, submittedNode: AnyConfigNode): Array<{
+    path: string;
+    message: string;
+}>;
+/**
+ * flow.submit(): стандартный group-submit пайплайн над flow-нодой
+ * (submitting → beforeSubmit → validate → onSubmit → afterSubmit; листья
+ * скрытых шагов отфильтровываются пайплайном). Ошибки валидации ложатся в
+ * реактивный flow.errors; при успехе errors очищаются.
+ */
+export declare function flowSubmit(kernel: Kernel, flowState: FlowState): Promise<SubmitResult>;
+/**
+ * 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.
+ */
+export declare function runEntryLifecycle(kernel: Kernel, flowState: FlowState, stepNode: AnyConfigNode): void;
+/**
+ * nextStep(): следующий ВИДИМЫЙ шаг по порядку массива; скрытые пропускаются.
+ * Если видимых впереди нет — финализация через flow.submit() (при ошибках
+ * валидации onSubmit не вызывается, ошибки в flow.errors, шаг не меняется).
+ */
+export declare function flowNextStep(kernel: Kernel, flowState: FlowState): void;
+/** back(): вернуться по стеку посещений. No-op при пустом стеке (canGoBack). */
+export declare function flowBack(kernel: Kernel, flowState: FlowState): void;
+/**
+ * goTo(keyOrIndex): произвольный переход по ключу или индексу.
+ * Несуществующий ключ/индекс — throw (ловит опечатки на этапе разработки).
+ * Переход в текущий шаг — no-op.
+ */
+export declare function flowGoTo(kernel: Kernel, flowState: FlowState, keyOrIndex: string | number): void;
+/**
+ * Сброс навигации флоу: первый шаг активен, стек и visited очищены,
+ * resolve-состояния шагов сброшены в idle. Lifecycle входа первого шага
+ * (onEnter → resolve → onReady) выполняется заново — зеркально инициализации.
+ */
+export declare function resetFlowNav(kernel: Kernel, flowState: FlowState): void;
+/**
+ * Сбросить навигацию всех флоу, попавших в поддерево сброса.
+ * Вызывается из ResetPipeline (root reset → все флоу; reset группы → флоу внутри неё).
+ */
+export declare function resetFlowNavForSubtree(kernel: Kernel, groupNode: AnyConfigNode): void;
+/**
+ * Инициализационный lifecycle: первый шаг каждого флоу «входится» при создании
+ * store (onEnter → resolve → onReady). Вызывается из конструктора Palistor.
+ *
+ * Дополнительно прогревает proxyCache flow-нод: identity-view шага снимает
+ * parent.proxy из кэша при первом step.submit(), и flow-proxy к этому моменту
+ * уже должен существовать — иначе onSubmit шага получил бы undefined
+ * третьим аргументом.
+ */
+export declare function initFlows(kernel: Kernel): void;
+/** Снимок навигации флоу в persist-снапшоте (значения полей хранятся отдельно). */
+export interface FlowNavSnapshot {
+    currentStepKey: string;
+    visitStack: string[];
+    visitedKeys: string[];
+}
+/**
+ * Сериализовать навигацию всех флоу для persist: ключ — dot-путь flow-ноды.
+ * Статусы шагов не сохраняются — выводятся из навигации при гидратации.
+ */
+export declare function serializeFlowNav(kernel: Kernel): Record<string, FlowNavSnapshot> | null;
+/**
+ * Восстановить навигацию флоу из persist-снимка. Неизвестные ключи шагов
+ * (конфиг изменился) отбрасываются; несовместимый currentStepKey — флоу
+ * остаётся в текущем состоянии. Возвращает изменённые узлы для notify и
+ * список флоу, чей активный шаг изменился (для повторного entry lifecycle).
+ */
+export declare function restoreFlowNav(kernel: Kernel, snapshots: Record<string, FlowNavSnapshot>): {
+    changed: Set<object>;
+    entered: FlowState[];
+};
+/** Entry lifecycle текущего шага (используется persist после гидратации). */
+export declare function runFlowEntryLifecycle(kernel: Kernel, flowState: FlowState): void;
+export {};
+//# sourceMappingURL=flowNavigation.d.ts.map

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

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