palistor 0.0.24

package/dist/store/buildProxy/buildEntityProjectionProxy.js

@@ -0,0 +1,321 @@
+import { CONFIG_NODE, CONFIG_PROPS, ENTITY_ID, ENTITY_ID_LEAF, STORE_REF } from "../constants";
+import { isLeafNode, isGroupNode } from "../traversal";
+import { buildListProxy } from "./buildListProxy";
+/** Поэлементное сравнение двух массивов строк (для dirty по составу списка). */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Build a flat values object from an entity node for use in computed
+ * template rules (formatter, validate, isRequired, etc.).
+ *
+ * Exported for per-entity list resolve (variant C): the child-list resolver
+ * receives the owner's flat snapshot built here (see triggerEntityListResolve).
+ * NB: `lists`/`owner` on EntityNode are non-enumerable → excluded automatically.
+ */
+export function buildEntityValues(entityNode, nodeState) {
+    const values = {};
+    for (const key of Object.keys(entityNode)) {
+        const field = entityNode[key];
+        if (field && typeof field === "object") {
+            if (isLeafNode(field)) {
+                values[key] = nodeState.get(field)?.value
+                    ?? field.value;
+            }
+            else {
+                values[key] = buildEntityValues(field, nodeState);
+            }
+        }
+    }
+    return values;
+}
+/**
+ * Build a flat values object for an entity INCLUDING its per-entity nested lists
+ * (variant C, phase C3). Scalars/groups come from {@link buildEntityValues};
+ * for every list field in the template, the child entities' deep values are
+ * appended under the list's field key. Recurses into nested-of-nested lists.
+ *
+ * Used by the entity projection proxy's `values` getter and the per-entity list
+ * proxy's `getValues()`. NB: plain {@link buildEntityValues} stays list-free —
+ * it feeds resolvers/validators that must see scalar values only.
+ */
+export function buildEntityValuesWithLists(entityNode, templateNode, kernel) {
+    const nodeState = kernel.nodes.nodeState;
+    const values = buildEntityValues(entityNode, nodeState);
+    const lists = entityNode.lists;
+    if (!lists)
+        return values;
+    // Walk the template (incl. nested groups) and materialize every per-entity
+    // list into its matching value subtree. `lists` is keyed by listConfigNode
+    // and stored flat on the entity, so a list nested inside a group is looked up
+    // the same way — only the value subtree we write into differs (C4).
+    materializeListsInto(values, templateNode, lists, kernel);
+    return values;
+}
+/**
+ * Recursively materialize per-entity lists from `lists` into `valuesSubtree`,
+ * walking `templateSubtree` in parallel. List fields become arrays of child
+ * deep-values; nested groups recurse into the corresponding value subtree.
+ */
+function materializeListsInto(valuesSubtree, templateSubtree, lists, kernel) {
+    for (const key of Object.keys(templateSubtree)) {
+        if (CONFIG_PROPS.has(key))
+            continue;
+        const templateField = templateSubtree[key];
+        if (Array.isArray(templateField)) {
+            // Включаем list-поле только если у entity есть его состояние (список
+            // загружался/менялся). Untouched-список ключ не добавляет — симметрично
+            // с материализацией в projectionObj (store.getValues()).
+            const els = lists.get(templateField);
+            if (!els)
+                continue;
+            const childTemplate = templateField[0];
+            valuesSubtree[key] = els.itemIds
+                .map((id) => {
+                const child = kernel.entityRegistry.get(id);
+                return child ? buildEntityValuesWithLists(child, childTemplate, kernel) : undefined;
+            })
+                .filter((v) => v !== undefined);
+            continue;
+        }
+        if (templateField && typeof templateField === "object" && isGroupNode(templateField)) {
+            const sub = valuesSubtree[key];
+            if (sub && typeof sub === "object" && !Array.isArray(sub)) {
+                materializeListsInto(sub, templateField, lists, kernel);
+            }
+        }
+    }
+}
+/**
+ * Whether an entity is dirty (variant C, phase C3): any of its leaf fields
+ * differs from its captured initial value, OR any per-entity list's composition
+ * differs from its initial snapshot.
+ */
+export function isEntityDirty(entityNode, kernel) {
+    const nodeState = kernel.nodes.nodeState;
+    const anyLeafDirty = (node) => {
+        for (const key of Object.keys(node)) {
+            const field = node[key];
+            if (!field || typeof field !== "object")
+                continue;
+            if (isLeafNode(field)) {
+                if (nodeState.get(field)?.dirty)
+                    return true;
+            }
+            else if (anyLeafDirty(field)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    if (anyLeafDirty(entityNode))
+        return true;
+    const lists = entityNode.lists;
+    if (lists) {
+        for (const els of lists.values()) {
+            if (!arraysEqual(els.itemIds, els.initialItemIds))
+                return true;
+        }
+    }
+    return false;
+}
+// ─── Entity leaf proxy ───────────────────────────────────────────────────────
+// buildEntityLeafProxy removed — entity leaf proxies are now built by
+// ProxyBuilder._buildEntityLeafProxy(storage, rules) via proxyBuilder.build(node, { via }).
+// ─── Entity projection proxy ─────────────────────────────────────────────────
+/**
+ * Build an EntityProjectionProxy: a proxy for an entity through a template node.
+ *
+ * Provides entity leaf values accessed through template structure.
+ * Template rules (formatter, setter, validate, isRequired, label, etc.) are applied.
+ *
+ * Accessing `proxy.name` → entity-leaf proxy (built by ProxyBuilder) with template rules.
+ * Writing `proxy.name.value = 'X'` → updates entity leaf via template formatter.
+ *
+ * @param entityNode       EntityNode from entityRegistry
+ * @param templateNode     Template config node (the `array[0]` of a ListNode)
+ * @param kernel           Palistor instance
+ * @param entityProxyCache Per-list cache (keyed by entityNode) for stable references
+ * @param ownerEntityNode  Real owner entity for per-entity lists (C4). Threaded
+ *   through nested-group recursion so a list declared inside a structural group
+ *   is owned by the nearest ancestor entity (the one with an `id`), not by the
+ *   group node — which `entityNode`/`rootEntityNode` reset to on recursion.
+ *   Omitted on the top-level call → defaults to `entityNode` itself.
+ */
+export function buildEntityProjectionProxy(entityNode, templateNode, kernel, entityProxyCache, ownerEntityNode) {
+    const cacheKey = entityNode;
+    const cached = entityProxyCache?.get(cacheKey);
+    if (cached)
+        return cached;
+    const templateKeys = Object.keys(templateNode).filter((k) => !CONFIG_PROPS.has(k));
+    // The top-level entityNode for building entity values in leaf proxies.
+    // For nested groups, we still need the root entity node context.
+    const rootEntityNode = entityNode;
+    // Owner entity for per-entity nested lists. On the top-level call it's the
+    // entity itself; preserved across nested-group recursion so list ownership
+    // stays anchored to the real entity (C4 blocker fix).
+    const listOwnerEntity = ownerEntityNode ?? entityNode;
+    // Stable submit function reference (created lazily)
+    let submitFnRef = null;
+    const nodeState = kernel.nodes.nodeState;
+    // Helper: get current entity id from nodeState or entity leaf
+    const getEntityId = () => {
+        if ("id" in entityNode) {
+            const idLeaf = entityNode.id;
+            return (nodeState.get(idLeaf)?.value ??
+                idLeaf.value);
+        }
+        return "";
+    };
+    const proxy = new Proxy(entityNode, {
+        get(_target, key) {
+            // Transparent for tracking proxy
+            if (key === CONFIG_NODE)
+                return entityNode;
+            // Expose entity ID and store for useForm(entity, templateSelector) overload
+            if (key === ENTITY_ID) {
+                if ("id" in entityNode) {
+                    const idLeaf = entityNode.id;
+                    return (nodeState.get(idLeaf)
+                        ?.value ?? idLeaf.value);
+                }
+                return undefined;
+            }
+            // Expose the id leaf node for tracking proxy — lets it subscribe to rekey() changes
+            if (key === ENTITY_ID_LEAF && "id" in entityNode) {
+                return entityNode.id;
+            }
+            if (key === STORE_REF)
+                return kernel;
+            if (typeof key === "symbol")
+                return undefined;
+            // Обратный маппинг на входе: external → internal. Влияет на `loading`/`dirty`
+            // (mappable-ключи). Навигация к template-полям остаётся по оригинальному `key`.
+            const ikey = kernel.externalToInternal[key] ?? key;
+            // id is always exposed directly as value (not as a leaf proxy)
+            if (key === "id" && "id" in entityNode) {
+                const idLeaf = entityNode.id;
+                return (nodeState.get(idLeaf)
+                    ?.value ?? idLeaf.value);
+            }
+            // ─── loading / submitting / submit ────────────────────────────────────
+            // Only exposed on root entity proxy (the one that has an "id" field).
+            if ("id" in entityNode) {
+                if (ikey === "loading") {
+                    const eid = getEntityId();
+                    return kernel.resolveManager.entityStates.get(eid, templateNode)?.status === "pending";
+                }
+                if (ikey === "submitting") {
+                    const eid = getEntityId();
+                    return kernel.resolveManager.entityStates.get(eid, templateNode)?.submitting === true;
+                }
+                if (ikey === "submit") {
+                    if (!submitFnRef) {
+                        submitFnRef = () => {
+                            const eid = getEntityId();
+                            return kernel.executeEntityTemplateSubmit(eid, templateNode, proxy);
+                        };
+                    }
+                    return submitFnRef;
+                }
+                if (ikey === "values") {
+                    return buildEntityValuesWithLists(rootEntityNode, templateNode, kernel);
+                }
+                if (ikey === "dirty") {
+                    return isEntityDirty(rootEntityNode, kernel);
+                }
+            }
+            // ─────────────────────────────────────────────────────────────────────
+            const templateField = templateNode[key];
+            // Per-entity nested list (variant C): a list declared inside an entity
+            // template. Build an isolated per-(owner,list) proxy. `listOwnerEntity` is
+            // the owning EntityNode — for a list directly under the root template it's
+            // the entity itself; for a list inside a nested group it's the threaded
+            // ancestor entity (C4), not the structural group node.
+            if (Array.isArray(templateField)) {
+                if (!("id" in listOwnerEntity))
+                    return undefined;
+                const listState = kernel.entityRegistry.getOrCreateEntityListState(listOwnerEntity, templateField);
+                return buildListProxy(listState, kernel);
+            }
+            if (!templateField || typeof templateField !== "object") {
+                return undefined;
+            }
+            const entityField = entityNode[key];
+            if (entityField && typeof entityField === "object") {
+                if (isLeafNode(entityField)) {
+                    // ── Lazily register NodeView for entity-leaf → template-field binding ──
+                    // Provides entity values, parent proxy, and onReset to the pipelines.
+                    // Skips phantom leaves (not in nodeState) and already-registered pairs.
+                    if (nodeState.has(entityField)) {
+                        const existingSlot = kernel.nodes.nodeViews.get(entityField);
+                        if (!existingSlot?.has(templateField)) {
+                            const view = {
+                                storage: entityField,
+                                rules: templateField,
+                                parent: {
+                                    proxy, // entity projection proxy (stable closure reference)
+                                    getValues: () => buildEntityValues(rootEntityNode, nodeState),
+                                },
+                                onReset: () => {
+                                    const initialValue = kernel.dirty.initialValueMap.get(entityField);
+                                    const prev = nodeState.get(entityField)?.value;
+                                    const result = kernel.writePipeline.execute(entityField, initialValue, prev, { via: templateField });
+                                    if (result && !result.skipped)
+                                        kernel.notifyChanged(result.changed);
+                                },
+                            };
+                            const slot = existingSlot ?? new Map();
+                            slot.set(templateField, view);
+                            kernel.nodes.nodeViews.set(entityField, slot);
+                        }
+                    }
+                    return kernel.proxyBuilder.build(entityField, { via: templateField });
+                }
+                // Nested group — recurse. Thread the real owner entity so a list
+                // declared inside this group is owned by the entity, not the group (C4).
+                return buildEntityProjectionProxy(entityField, templateField, kernel, undefined, listOwnerEntity);
+            }
+            // Phantom leaf: entity doesn't have this field yet, show template defaults.
+            if (isLeafNode(templateField)) {
+                const phantom = {
+                    value: templateField.value,
+                };
+                return kernel.proxyBuilder.build(phantom, { via: templateField, parentEntityProxy: proxy });
+            }
+            return undefined;
+        },
+        ownKeys() {
+            const fwd = kernel.fieldMapping;
+            const map = (keys) => keys.map((k) => fwd[k] ?? k);
+            const hasId = "id" in entityNode;
+            if (hasId) {
+                const keysWithoutId = templateKeys.filter((k) => k !== "id");
+                return map(["id", ...keysWithoutId, "loading", "submitting", "submit", "values", "dirty"]);
+            }
+            return map(templateKeys);
+        },
+        getOwnPropertyDescriptor(_target, key) {
+            if (typeof key === "symbol")
+                return undefined;
+            const fwd = kernel.fieldMapping;
+            const hasId = "id" in entityNode;
+            const extraKeys = hasId ? ["loading", "submitting", "submit", "values", "dirty"] : [];
+            const keysWithoutId = hasId ? templateKeys.filter((k) => k !== "id") : templateKeys;
+            const keys = (hasId ? ["id", ...keysWithoutId, ...extraKeys] : keysWithoutId).map((k) => fwd[k] ?? k);
+            if (!keys.includes(key))
+                return undefined;
+            return { configurable: true, enumerable: true, writable: false };
+        },
+    });
+    entityProxyCache?.set(cacheKey, proxy);
+    return proxy;
+}
+//# sourceMappingURL=buildEntityProjectionProxy.js.map

package/dist/store/buildProxy/buildEntityProjectionProxy.js.map

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

package/dist/store/buildProxy/buildListProxy.d.ts

@@ -0,0 +1,33 @@
+import type { ListState } from "../store/types";
+import type { Palistor } from "../store/palistor";
+/**
+ * Build a ListProxyNode for a list — ЕДИНЫЙ builder (root + per-entity).
+ *
+ * Список идентифицируется объектом {@link ListState}. `listState.ownerEntity`
+ * различает два случая:
+ *   - `null`  → root-list (состояние в `kernel.nodes.listStates`);
+ *   - entity  → per-entity nested list (вариант C; состояние в `owner.lists`).
+ *
+ * Скелет, мутации, proxy и кэш — общие. Точки, где root и entity ещё расходятся
+ * (sync valuesCache, resolve/loading, семантика add/setItems), временно
+ * диспетчеризуются по `owner`; их слияние — фазы U3 (sync) и U5 (resolve).
+ *
+ * The proxy exposes:
+ *   items       — ReadonlyArray<EntityProjectionProxy>, one per itemId
+ *   length      — number of items
+ *   loading     — async resolver in progress
+ *   dirty       — itemIds differ from the initial snapshot
+ *   add(id)     — add existing entity by ID
+ *   add(values) — upsert entity + add to list
+ *   remove(id)  — remove entity from list (entity stays in registry)
+ *   getById(id) — find proxy by ID
+ *   setItems(ids) — bulk-replace itemIds
+ *   map(fn)     — map for React rendering
+ *   getValues() — plain values snapshot of all items
+ *   [Symbol.iterator] — iteration
+ *
+ * Entity proxies are cached per list instance (stable references for React);
+ * the list proxy itself is cached per `ListState` in `kernel.nodes.listProxyCache`.
+ */
+export declare function buildListProxy(listState: ListState, kernel: Palistor<any, any>): object;
+//# sourceMappingURL=buildListProxy.d.ts.map

package/dist/store/buildProxy/buildListProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildListProxy.d.ts","sourceRoot":"","sources":["../../../store/buildProxy/buildListProxy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAqClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CA+QvF"}