palistor 0.0.24

package/dist/store/compute/resolveString.js

@@ -0,0 +1,18 @@
+/**
+ * Вычисляет строковое свойство (label, placeholder, description) из конфига.
+ * Может быть строкой или функцией `(t: TranslateFn, values) => string`.
+ *
+ * Если translator зарегистрирован — реальный резолв происходит лениво
+ * в proxy GET trap (buildProxy.ts). Здесь сохраняем fallback:
+ * для функций — вызываем с identity → возвращаем ключ перевода.
+ */
+export function resolveString(configValue, values = {}) {
+    if (configValue === undefined)
+        return undefined;
+    if (typeof configValue === "function") {
+        // identity — вернёт ключ как есть (fallback до регистрации translator)
+        return configValue((v) => v, values);
+    }
+    return configValue;
+}
+//# sourceMappingURL=resolveString.js.map

package/dist/store/compute/resolveString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveString.js","sourceRoot":"","sources":["../../../store/compute/resolveString.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,WAA2F,EAC3F,SAA8B,EAAE;IAEhC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,uEAAuE;QACvE,OAAO,WAAW,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/store/compute/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Полное вычисленное состояние одного поля.
+ *
+ * Хранится в WeakMap<configNode, FieldState>. Все функции из конфига
+ * (isVisible, isRequired, validate…) уже вызваны, результат — чистые значения.
+ */
+export interface FieldState {
+    value: unknown;
+    label?: string;
+    placeholder?: string;
+    description?: string;
+    isRequired: boolean;
+    isReadOnly: boolean;
+    isDisabled: boolean;
+    isVisible: boolean;
+    isInvalid?: boolean;
+    errorMessage?: string;
+    /** true while submit pipeline is running (group nodes only). */
+    submitting?: boolean;
+    /**
+     * Per-field: value differs from initial.
+     * Per-group: at least one descendant leaf is dirty.
+     */
+    dirty?: boolean;
+    /**
+     * Group-level flag: when true, validation errors are computed and shown.
+     * Before first submit attempt: false (errors hidden).
+     * After failed submit: true (live validation on every change).
+     * Leaves inherit this from their parent group during recompute.
+     */
+    revalidate?: boolean;
+    /**
+     * true while async resolver is loading (group nodes with resolve only).
+     */
+    loading?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/store/compute/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../store/compute/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/store/compute/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/store/compute/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../store/compute/types.ts"],"names":[],"mappings":""}

package/dist/store/constants.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Символ для доступа к исходному config-узлу из Proxy.
+ * Используется tracking proxy для определения, какой узел читается.
+ */
+export declare const CONFIG_NODE: unique symbol;
+/**
+ * Символ для получения исходного source-proxy (store.proxy) из tracking proxy.
+ * Позволяет useForm принять tracking proxy поддерево и извлечь source.
+ */
+export declare const SOURCE_PROXY: unique symbol;
+/**
+ * Символ для получения ссылки на ProxyStore из tracking proxy.
+ * Позволяет useForm принять tracking proxy поддерево и подписаться на store.
+ */
+export declare const STORE_REF: unique symbol;
+/**
+ * Символ для получения entity ID из EntityProjectionProxy.
+ * Позволяет useForm(entity, templateSelector) извлечь entityId и store из proxy.
+ */
+export declare const ENTITY_ID: unique symbol;
+/**
+ * Символ для получения объекта id-листа (EntityLeafNode) из EntityProjectionProxy.
+ * Используется tracking proxy для регистрации подписки на id — чтобы rekey()
+ * корректно триггерил перерендер компонентов, читающих `entity.id`.
+ */
+export declare const ENTITY_ID_LEAF: unique symbol;
+/**
+ * Бренд-символ list proxy — возвращает объект `ListState` (единый кубик «список»).
+ * Идентичность узла для tracking/resolve: сам объект `ListState` (ключ в хабе).
+ * Root-list — `ownerEntity === null`; per-entity — изолированный `ListState` на
+ * каждую пару (owner, listConfigNode).
+ */
+export declare const LIST_STATE: unique symbol;
+/**
+ * Единственный источник имён полей состояния (canonical tuple).
+ * Из него выводятся {@link FIELD_STATE_PROPS} (Set) и {@link MAPPABLE_KEYS}.
+ */
+export declare const FIELD_STATE_KEYS: readonly ["value", "label", "placeholder", "description", "isRequired", "isReadOnly", "isDisabled", "isVisible", "isInvalid", "errorMessage", "dirty", "loading"];
+/**
+ * Свойства, относящиеся к состоянию поля. При обращении к ним прокси
+ * возвращает значение из FieldState (вычисленное), а не из конфига.
+ */
+export declare const FIELD_STATE_PROPS: Set<string>;
+/**
+ * Ключи, которые можно переименовывать через `fieldMapping`:
+ * поля состояния + функциональный сеттер `onValueChange`.
+ */
+export declare const MAPPABLE_KEYS: readonly ["value", "label", "placeholder", "description", "isRequired", "isReadOnly", "isDisabled", "isVisible", "isInvalid", "errorMessage", "dirty", "loading", "onValueChange"];
+/** Имя internal-ключа, допустимое как источник переименования в `fieldMapping`. */
+export type MappableKey = (typeof MAPPABLE_KEYS)[number];
+/**
+ * Подмножество mappable-ключей, которые являются ВХОДНЫМИ ключами конфига —
+ * т.е. их пишет автор в конфиге узла. Только эти ключи нормализуются
+ * external→internal при активном `fieldMapping` (см. {@link normalizeConfig}).
+ *
+ * Остальные mappable-ключи (`isInvalid`, `errorMessage`, `dirty`, `loading`,
+ * `onValueChange`) — вычисляемые/выходные: в конфиге не пишутся, поэтому на
+ * входе их нормализовать нечего (перевод для них происходит только на выходе
+ * proxy). Попытка написать такой ключ в конфиге — ошибка (strict).
+ */
+export declare const MAPPABLE_CONFIG_KEYS_TUPLE: readonly ["value", "label", "placeholder", "description", "isRequired", "isReadOnly", "isDisabled", "isVisible"];
+export declare const MAPPABLE_CONFIG_KEYS: Set<string>;
+/** Тип-версия {@link MAPPABLE_CONFIG_KEYS} — internal-имена config-ключей,
+ *  которые можно переименовывать через `fieldMapping` (для валидатора типов). */
+export type MappableConfigKey = (typeof MAPPABLE_CONFIG_KEYS_TUPLE)[number];
+/**
+ * Полный набор «служебных» ключей узла конфига.
+ * При обходе дерева (init, buildValuesCache) — пропускаются.
+ */
+export declare const CONFIG_PROPS: Set<string>;
+export declare const SPREADABLE_FIELD_STATE_PROPS: string[];
+/**
+ * Статический набор ключей, которые включаются при spread группового узла:
+ * состояние (submitting, dirty, revalidate, loading) и методы (submit, reset).
+ * Дочерние узлы добавляются динамически в computeProxyKeys.
+ */
+export declare const GROUP_SPREAD_KEYS: string[];
+/**
+ * Статический набор ключей для proxy списка (ListNode).
+ * Возвращается из computeProxyKeys вместо GROUP_SPREAD_KEYS, когда узел — массив.
+ */
+export declare const LIST_SPREAD_KEYS: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/store/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../store/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,MAA6B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAA8B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,MAA2B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,MAA2B,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,MAA+B,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,MAA4B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,mKAanB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAAoC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,aAAa,oLAAkD,CAAC;AAE7E,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,kHAS7B,CAAC;AAEX,eAAO,MAAM,oBAAoB,aAA8C,CAAC;AAEhF;iFACiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,YAAY,aAmBvB,CAAC;AAEH,eAAO,MAAM,4BAA4B,UAM3B,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,EASrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAWpC,CAAC"}

package/dist/store/constants.js

@@ -0,0 +1,145 @@
+/**
+ * Символ для доступа к исходному config-узлу из Proxy.
+ * Используется tracking proxy для определения, какой узел читается.
+ */
+export const CONFIG_NODE = Symbol("configNode");
+/**
+ * Символ для получения исходного source-proxy (store.proxy) из tracking proxy.
+ * Позволяет useForm принять tracking proxy поддерево и извлечь source.
+ */
+export const SOURCE_PROXY = Symbol("sourceProxy");
+/**
+ * Символ для получения ссылки на ProxyStore из tracking proxy.
+ * Позволяет useForm принять tracking proxy поддерево и подписаться на store.
+ */
+export const STORE_REF = Symbol("storeRef");
+/**
+ * Символ для получения entity ID из EntityProjectionProxy.
+ * Позволяет useForm(entity, templateSelector) извлечь entityId и store из proxy.
+ */
+export const ENTITY_ID = Symbol("entityId");
+/**
+ * Символ для получения объекта id-листа (EntityLeafNode) из EntityProjectionProxy.
+ * Используется tracking proxy для регистрации подписки на id — чтобы rekey()
+ * корректно триггерил перерендер компонентов, читающих `entity.id`.
+ */
+export const ENTITY_ID_LEAF = Symbol("entityIdLeaf");
+/**
+ * Бренд-символ list proxy — возвращает объект `ListState` (единый кубик «список»).
+ * Идентичность узла для tracking/resolve: сам объект `ListState` (ключ в хабе).
+ * Root-list — `ownerEntity === null`; per-entity — изолированный `ListState` на
+ * каждую пару (owner, listConfigNode).
+ */
+export const LIST_STATE = Symbol("listState");
+/**
+ * Единственный источник имён полей состояния (canonical tuple).
+ * Из него выводятся {@link FIELD_STATE_PROPS} (Set) и {@link MAPPABLE_KEYS}.
+ */
+export const FIELD_STATE_KEYS = [
+    "value",
+    "label",
+    "placeholder",
+    "description",
+    "isRequired",
+    "isReadOnly",
+    "isDisabled",
+    "isVisible",
+    "isInvalid",
+    "errorMessage",
+    "dirty",
+    "loading",
+];
+/**
+ * Свойства, относящиеся к состоянию поля. При обращении к ним прокси
+ * возвращает значение из FieldState (вычисленное), а не из конфига.
+ */
+export const FIELD_STATE_PROPS = new Set(FIELD_STATE_KEYS);
+/**
+ * Ключи, которые можно переименовывать через `fieldMapping`:
+ * поля состояния + функциональный сеттер `onValueChange`.
+ */
+export const MAPPABLE_KEYS = [...FIELD_STATE_KEYS, "onValueChange"];
+/**
+ * Подмножество mappable-ключей, которые являются ВХОДНЫМИ ключами конфига —
+ * т.е. их пишет автор в конфиге узла. Только эти ключи нормализуются
+ * external→internal при активном `fieldMapping` (см. {@link normalizeConfig}).
+ *
+ * Остальные mappable-ключи (`isInvalid`, `errorMessage`, `dirty`, `loading`,
+ * `onValueChange`) — вычисляемые/выходные: в конфиге не пишутся, поэтому на
+ * входе их нормализовать нечего (перевод для них происходит только на выходе
+ * proxy). Попытка написать такой ключ в конфиге — ошибка (strict).
+ */
+export const MAPPABLE_CONFIG_KEYS_TUPLE = [
+    "value",
+    "label",
+    "placeholder",
+    "description",
+    "isRequired",
+    "isReadOnly",
+    "isDisabled",
+    "isVisible",
+];
+export const MAPPABLE_CONFIG_KEYS = new Set(MAPPABLE_CONFIG_KEYS_TUPLE);
+/**
+ * Полный набор «служебных» ключей узла конфига.
+ * При обходе дерева (init, buildValuesCache) — пропускаются.
+ */
+export const CONFIG_PROPS = new Set([
+    ...FIELD_STATE_PROPS,
+    "validate",
+    "formatter",
+    "setter",
+    "componentProps",
+    "types",
+    "dependencies",
+    // Handler props (submit, reset, onChange lifecycle)
+    "onSubmit",
+    "beforeSubmit",
+    "afterSubmit",
+    "reset",
+    "onChange",
+    // Resolve props
+    "resolve",
+    "deps",
+    // Node kind marker — set by registerNodes/entity factories, invisible to user code
+    "__kind",
+]);
+export const SPREADABLE_FIELD_STATE_PROPS = [
+    ...FIELD_STATE_PROPS,
+    "onValueChange",
+].filter(k => ![
+    "dirty",
+    "loading",
+].includes(k));
+/**
+ * Статический набор ключей, которые включаются при spread группового узла:
+ * состояние (submitting, dirty, revalidate, loading) и методы (submit, reset).
+ * Дочерние узлы добавляются динамически в computeProxyKeys.
+ */
+export const GROUP_SPREAD_KEYS = [
+    "value",
+    "submitting",
+    "dirty",
+    "revalidate",
+    "loading",
+    "values",
+    "submit",
+    "reset",
+];
+/**
+ * Статический набор ключей для proxy списка (ListNode).
+ * Возвращается из computeProxyKeys вместо GROUP_SPREAD_KEYS, когда узел — массив.
+ */
+export const LIST_SPREAD_KEYS = [
+    "items",
+    "length",
+    "loading",
+    "dirty",
+    "add",
+    "remove",
+    "getById",
+    "setItems",
+    "map",
+    "getValues",
+];
+//# sourceMappingURL=constants.js.map

package/dist/store/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../store/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB,MAAM,CAAC,YAAY,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAkB,MAAM,CAAC,UAAU,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAkB,MAAM,CAAC,UAAU,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,WAAW,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;IACP,OAAO;IACP,aAAa;IACb,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,WAAW;IACX,cAAc;IACd,OAAO;IACP,SAAS;CACD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,gBAAgB,EAAE,eAAe,CAAU,CAAC;AAK7E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,OAAO;IACP,OAAO;IACP,aAAa;IACb,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,0BAA0B,CAAC,CAAC;AAMhF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS;IAC1C,GAAG,iBAAiB;IACpB,UAAU;IACV,WAAW;IACX,QAAQ;IACR,gBAAgB;IAChB,OAAO;IACP,cAAc;IACd,oDAAoD;IACpD,UAAU;IACV,cAAc;IACd,aAAa;IACb,OAAO;IACP,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,MAAM;IACN,mFAAmF;IACnF,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,iBAAiB;IACpB,eAAe;CAChB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACb,OAAO;IACP,SAAS;CACV,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAEf;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,OAAO;IACP,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;CACR,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,KAAK;IACL,QAAQ;IACR,SAAS;IACT,UAAU;IACV,KAAK;IACL,WAAW;CACZ,CAAC"}

package/dist/store/defineFieldMapping.d.ts

@@ -0,0 +1,41 @@
+import type { FieldMapping } from "./store/types";
+/**
+ * Хелпер для объявления переиспользуемой карты `fieldMapping` с сохранением
+ * литеральных значений в типе.
+ *
+ * Зачем нужен: при вынесении карты в отдельную константу литеральные значения
+ * (`"required"`, …) обычно расширяются до `string`, и статическое переименование
+ * полей перестаёт работать (рантайм при этом не страдает). Два способа этого
+ * избежать — `as const` или этот хелпер. `defineFieldMapping` предпочтительнее,
+ * так как ещё и проверяет карту на соответствие {@link FieldMapping} (ключи —
+ * только mappable-имена, значения — строки).
+ *
+ * > ⚠️ НЕ используйте `... satisfies FieldMapping` для переиспользуемой карты:
+ * > `satisfies` расширяет значения до `string`, и типизация переименования
+ * > не сработает. Для inline-литерала прямо в `new Palistor({ fieldMapping })`
+ * > хелпер не нужен — `const`-параметр класса сам захватывает литералы.
+ *
+ * `fieldMapping` задаёт ЕДИНЫЙ публичный словарь имён поля: конфиг пишется в тех
+ * же (external) именах, что и читается. Нормализатор в конструкторе Palistor
+ * приводит их к internal перед compute (см. `normalizeConfig`), поэтому ядро не
+ * меняется. Написать internal-имя ремапленного ключа в конфиге — ошибка (strict).
+ *
+ * @example
+ * const fieldMapping = defineFieldMapping({
+ *   isRequired:   "required",
+ *   isInvalid:    "error",
+ *   errorMessage: "helperText",
+ *   description:  "helpText",
+ * });
+ * const store = new Palistor({
+ *   config: {
+ *     // external-имена, не isRequired/description:
+ *     email: { value: "", required: true, helpText: "We never share it" },
+ *   },
+ *   fieldMapping,
+ * });
+ * store.proxy.email.required;    // boolean — типизировано
+ * store.proxy.email.helperText;  // string  — ошибка валидации после submit
+ */
+export declare function defineFieldMapping<const M extends FieldMapping>(mapping: M): M;
+//# sourceMappingURL=defineFieldMapping.d.ts.map

package/dist/store/defineFieldMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFieldMapping.d.ts","sourceRoot":"","sources":["../../store/defineFieldMapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAE9E"}

package/dist/store/defineFieldMapping.js

@@ -0,0 +1,42 @@
+/**
+ * Хелпер для объявления переиспользуемой карты `fieldMapping` с сохранением
+ * литеральных значений в типе.
+ *
+ * Зачем нужен: при вынесении карты в отдельную константу литеральные значения
+ * (`"required"`, …) обычно расширяются до `string`, и статическое переименование
+ * полей перестаёт работать (рантайм при этом не страдает). Два способа этого
+ * избежать — `as const` или этот хелпер. `defineFieldMapping` предпочтительнее,
+ * так как ещё и проверяет карту на соответствие {@link FieldMapping} (ключи —
+ * только mappable-имена, значения — строки).
+ *
+ * > ⚠️ НЕ используйте `... satisfies FieldMapping` для переиспользуемой карты:
+ * > `satisfies` расширяет значения до `string`, и типизация переименования
+ * > не сработает. Для inline-литерала прямо в `new Palistor({ fieldMapping })`
+ * > хелпер не нужен — `const`-параметр класса сам захватывает литералы.
+ *
+ * `fieldMapping` задаёт ЕДИНЫЙ публичный словарь имён поля: конфиг пишется в тех
+ * же (external) именах, что и читается. Нормализатор в конструкторе Palistor
+ * приводит их к internal перед compute (см. `normalizeConfig`), поэтому ядро не
+ * меняется. Написать internal-имя ремапленного ключа в конфиге — ошибка (strict).
+ *
+ * @example
+ * const fieldMapping = defineFieldMapping({
+ *   isRequired:   "required",
+ *   isInvalid:    "error",
+ *   errorMessage: "helperText",
+ *   description:  "helpText",
+ * });
+ * const store = new Palistor({
+ *   config: {
+ *     // external-имена, не isRequired/description:
+ *     email: { value: "", required: true, helpText: "We never share it" },
+ *   },
+ *   fieldMapping,
+ * });
+ * store.proxy.email.required;    // boolean — типизировано
+ * store.proxy.email.helperText;  // string  — ошибка валидации после submit
+ */
+export function defineFieldMapping(mapping) {
+    return mapping;
+}
+//# sourceMappingURL=defineFieldMapping.js.map

package/dist/store/defineFieldMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFieldMapping.js","sourceRoot":"","sources":["../../store/defineFieldMapping.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,kBAAkB,CAA+B,OAAU;IACzE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/store/defineList.d.ts

@@ -0,0 +1,14 @@
+import type { TypedListNode, TemplateConfig, ListResolver } from "./store/types";
+interface DefineListConfig<TEntity extends Record<string, any>> {
+    template: TemplateConfig<TEntity>;
+    resolve?: {
+        resolver: ListResolver<TEntity>;
+        deps?: string[];
+        onError?: (error: unknown, ctx: {
+            notify: (msg: string) => void;
+        }) => void;
+    };
+}
+export declare function defineList<TEntity extends Record<string, any>>(config: DefineListConfig<TEntity>): TypedListNode<TEntity>;
+export {};
+//# sourceMappingURL=defineList.d.ts.map

package/dist/store/defineList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineList.d.ts","sourceRoot":"","sources":["../../store/defineList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAqB,MAAM,eAAe,CAAC;AAEpG,UAAU,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE;QACR,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;YAAE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,KAAK,IAAI,CAAC;KAC5E,CAAC;CACH;AAED,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAChC,aAAa,CAAC,OAAO,CAAC,CAIxB"}

package/dist/store/defineList.js

@@ -0,0 +1,7 @@
+export function defineList(config) {
+    const node = [config.template];
+    if (config.resolve)
+        node.push({ resolve: config.resolve });
+    return node;
+}
+//# sourceMappingURL=defineList.js.map

package/dist/store/defineList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineList.js","sourceRoot":"","sources":["../../store/defineList.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU,CACxB,MAAiC;IAEjC,MAAM,IAAI,GAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAA4B,EAAE,CAAC,CAAC;IAChF,OAAO,IAAyC,CAAC;AACnD,CAAC"}

package/dist/store/dirtyTracking/captureInitialValues.d.ts

@@ -0,0 +1,8 @@
+import type { AnyConfigNode } from "../store/types";
+import type { FieldState } from "../compute/index";
+/**
+ * Captures initial values for all leaf nodes into a WeakMap.
+ * Called at store creation and after reset/hydrate.
+ */
+export declare function captureInitialValues(node: AnyConfigNode, nodeState: WeakMap<object, FieldState>, initialValueMap: WeakMap<object, unknown>): void;
+//# sourceMappingURL=captureInitialValues.d.ts.map

package/dist/store/dirtyTracking/captureInitialValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureInitialValues.d.ts","sourceRoot":"","sources":["../../../store/dirtyTracking/captureInitialValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,IAAI,CASN"}

package/dist/store/dirtyTracking/captureInitialValues.js

@@ -0,0 +1,16 @@
+import { walkFull } from "../traversal";
+/**
+ * Captures initial values for all leaf nodes into a WeakMap.
+ * Called at store creation and after reset/hydrate.
+ */
+export function captureInitialValues(node, nodeState, initialValueMap) {
+    walkFull(node, {
+        onLeaf(leaf) {
+            const state = nodeState.get(leaf);
+            if (state) {
+                initialValueMap.set(leaf, state.value);
+            }
+        },
+    });
+}
+//# sourceMappingURL=captureInitialValues.js.map

package/dist/store/dirtyTracking/captureInitialValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureInitialValues.js","sourceRoot":"","sources":["../../../store/dirtyTracking/captureInitialValues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIxC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAmB,EACnB,SAAsC,EACtC,eAAyC;IAEzC,QAAQ,CAAC,IAAI,EAAE;QACb,MAAM,CAAC,IAAI;YACT,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,KAAK,EAAE,CAAC;gBACV,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/store/dirtyTracking/collectInitialSnapshot.d.ts

@@ -0,0 +1,10 @@
+import type { AnyConfigNode } from "../store/types";
+/**
+ * Collects current initial values from the initialValueMap for a subtree.
+ * Used by reset to restore fields to their initial state.
+ *
+ * Stops at reset boundaries (child groups with their own `reset` function).
+ * Falls back to config default if a leaf has no entry in initialValueMap.
+ */
+export declare function collectInitialSnapshot(node: AnyConfigNode, initialValueMap: WeakMap<object, unknown>): Record<string, unknown>;
+//# sourceMappingURL=collectInitialSnapshot.d.ts.map

package/dist/store/dirtyTracking/collectInitialSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectInitialSnapshot.d.ts","sourceRoot":"","sources":["../../../store/dirtyTracking/collectInitialSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/store/dirtyTracking/collectInitialSnapshot.js

@@ -0,0 +1,35 @@
+import { configKeys, isLeafNode, isListNode } from "../traversal";
+/**
+ * Collects current initial values from the initialValueMap for a subtree.
+ * Used by reset to restore fields to their initial state.
+ *
+ * Stops at reset boundaries (child groups with their own `reset` function).
+ * Falls back to config default if a leaf has no entry in initialValueMap.
+ */
+export function collectInitialSnapshot(node, initialValueMap) {
+    const result = {};
+    for (const key of configKeys(node)) {
+        const child = node[key];
+        if (!child || typeof child !== "object")
+            continue;
+        if (isListNode(child))
+            continue; // ListNode — пропускаем, обрабатывается в фазе 2
+        if (isLeafNode(child)) {
+            const initial = initialValueMap.get(child);
+            if (initial !== undefined) {
+                result[key] = initial;
+            }
+            else {
+                const raw = child.value;
+                result[key] = typeof raw === "function" ? "" : raw;
+            }
+        }
+        else {
+            if (typeof child.reset === "function")
+                continue;
+            result[key] = collectInitialSnapshot(child, initialValueMap);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=collectInitialSnapshot.js.map

package/dist/store/dirtyTracking/collectInitialSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectInitialSnapshot.js","sourceRoot":"","sources":["../../../store/dirtyTracking/collectInitialSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGlE;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAmB,EACnB,eAAyC;IAEzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAkB,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,iDAAiD;QAElF,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;gBAAE,SAAS;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,7 @@
+export { captureInitialValues } from "./captureInitialValues";
+export { recomputeDirtyTargeted } from "./recomputeDirtyTargeted";
+export type { RecomputeDirtyResult } from "./recomputeDirtyTargeted";
+export { setGroupRevalidate } from "./setGroupRevalidate";
+export { mergeInitialValues } from "./mergeInitialValues";
+export { collectInitialSnapshot } from "./collectInitialSnapshot";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../store/dirtyTracking/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/store/dirtyTracking/index.js

@@ -0,0 +1,6 @@
+export { captureInitialValues } from "./captureInitialValues";
+export { recomputeDirtyTargeted } from "./recomputeDirtyTargeted";
+export { setGroupRevalidate } from "./setGroupRevalidate";
+export { mergeInitialValues } from "./mergeInitialValues";
+export { collectInitialSnapshot } from "./collectInitialSnapshot";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../store/dirtyTracking/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/store/dirtyTracking/isDirtyValue.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Compares two values for dirty checking.
+ * Primitives use strict equality. Objects/arrays use JSON.stringify.
+ * Treats null and undefined as equivalent (both "empty").
+ */
+export declare function isDirtyValue(current: unknown, initial: unknown): boolean;
+//# sourceMappingURL=isDirtyValue.d.ts.map

package/dist/store/dirtyTracking/isDirtyValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDirtyValue.d.ts","sourceRoot":"","sources":["../../../store/dirtyTracking/isDirtyValue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAaxE"}

package/dist/store/dirtyTracking/isDirtyValue.js

@@ -0,0 +1,25 @@
+/**
+ * Compares two values for dirty checking.
+ * Primitives use strict equality. Objects/arrays use JSON.stringify.
+ * Treats null and undefined as equivalent (both "empty").
+ */
+export function isDirtyValue(current, initial) {
+    if (current === initial)
+        return false;
+    if (current == null && initial == null)
+        return false;
+    if (current == null || initial == null)
+        return true;
+    if (typeof current !== typeof initial)
+        return true;
+    if (typeof current === "object") {
+        try {
+            return JSON.stringify(current) !== JSON.stringify(initial);
+        }
+        catch {
+            return true;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=isDirtyValue.js.map

package/dist/store/dirtyTracking/isDirtyValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDirtyValue.js","sourceRoot":"","sources":["../../../store/dirtyTracking/isDirtyValue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,OAAgB;IAC7D,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,OAAO,OAAO,KAAK,OAAO,OAAO;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/store/dirtyTracking/mergeInitialValues.d.ts

@@ -0,0 +1,11 @@
+import type { AnyConfigNode } from "../store/types";
+import type { FieldState } from "../compute/index";
+/**
+ * Incrementally merges initial values from a patch into the initialValueMap.
+ * Only updates leaf nodes whose keys are present in the patch.
+ *
+ * Called after resolver success to make resolver data part of the initial state.
+ * Optimistic resolver does NOT call this — only the real resolver result counts.
+ */
+export declare function mergeInitialValues(node: AnyConfigNode, nodeState: WeakMap<object, FieldState>, initialValueMap: WeakMap<object, unknown>, patch: Record<string, unknown>): void;
+//# sourceMappingURL=mergeInitialValues.d.ts.map

package/dist/store/dirtyTracking/mergeInitialValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeInitialValues.d.ts","sourceRoot":"","sources":["../../../store/dirtyTracking/mergeInitialValues.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAkBN"}