palistor 0.0.24

package/dist/store/init/createResolveManager.d.ts

@@ -0,0 +1,166 @@
+import { type AnyConfigNode } from "../store/types";
+import type { ListState } from "../store/types";
+import type { FieldState } from "../compute/index";
+import type { ValuesCache } from "../valuesCache/valuesCache";
+import type { EntityData } from "../entityRegistry";
+import type { EntityRegistry } from "../entityRegistry";
+import type { EntityNode } from "../entityRegistry/types";
+import { type NotifyFn, type ResolveState, type TemplateFieldResolveEntry, EntityResolveStateMap } from "../resolvePipeline/index";
+export interface ResolveManagerDeps {
+    rootConfig: AnyConfigNode;
+    nodeState: WeakMap<object, FieldState>;
+    recompute: () => Set<object>;
+    notifyChanged: (changed: Set<object>) => void;
+    notify: NotifyFn;
+    /** Снимок начальных значений — передаётся в resolve-пайплайн для dirty-трекинга. */
+    initialValueMap: WeakMap<object, unknown>;
+    valuesCache: ValuesCache;
+    /** Экземпляр ProxyStore — передаётся вторым аргументом в resolver. */
+    store: any;
+    /** Все объекты ListState из NodeRegistry (для диспетчеризации list resolve). */
+    listStates: WeakMap<object, ListState>;
+    /**
+     * Upsert-ит сущности и регистрирует их листья без вызова notify.
+     * Вызывается из executeListResolve после успешного list resolver-а.
+     * Фаза 4: listNode передаётся для автоматического запуска entity field resolves.
+     */
+    setEntitiesRaw: (items: EntityData[], listNode?: object) => Set<object>;
+    /**
+     * Синхронизирует valuesCache с составом списка (единый метод, root + entity).
+     * Вызывается из executeListResolve после обновления itemIds.
+     */
+    syncListValuesCache: (listState: ListState) => void;
+    /**
+     * Экземпляр EntityRegistry — используется в triggerEntityFieldResolve для проверки skipIfResolved.
+     */
+    entityRegistry: EntityRegistry;
+}
+export declare class ResolveManager {
+    /** Resolve-состояния всех узлов с resolve-конфигом. */
+    readonly states: Map<object, ResolveState>;
+    /**
+     * Per-entity состояния resolve.
+     * - Per-field: (entityId, templateFieldNode) → ResolveState
+     * - Per-template binding: (entityId, templateNode) → ResolveState
+     *   где status === "pending" означает загрузку, state.submitting === true — отправку формы.
+     */
+    readonly entityStates: EntityResolveStateMap;
+    private readonly resolveEntries;
+    private readonly resolveEntryMap;
+    /** Записи template-полей (per-entity field resolves). */
+    readonly templateFieldEntries: TemplateFieldResolveEntry[];
+    /** Быстрый поиск: templateFieldNode → TemplateFieldResolveEntry. */
+    private readonly templateFieldEntryMap;
+    /** listNode → TemplateFieldResolveEntry[] (для фазы 4: запуск при создании entity). */
+    readonly listNodeToTemplateFieldEntries: Map<AnyConfigNode, TemplateFieldResolveEntry[]>;
+    private readonly resolveDeps;
+    private readonly listResolveDeps;
+    private readonly listStates;
+    private readonly entityRegistry;
+    /** Записи, ожидающие удовлетворения contextDeps перед запуском. */
+    private readonly pendingContextQueue;
+    constructor(deps: ResolveManagerDeps);
+    /**
+     * Запустить resolve для конкретного узла (если у него есть resolve-конфиг).
+     * Arrow function — сохраняет `this` при деструктуризации/передаче как callback.
+     */
+    triggerResolve: (node: AnyConfigNode) => void;
+    /**
+     * Получить текущее состояние resolve для узла.
+     * Arrow function — сохраняет `this` при деструктуризации/передаче как callback.
+     */
+    getResolveState: (node: AnyConfigNode) => ResolveState | undefined;
+    /**
+     * Запустить per-entity field resolve для конкретного entity и template-поля.
+     *
+     * Логика:
+     * 1. Найти TemplateFieldResolveEntry по templateFieldNode
+     * 2. getOrCreate ResolveState в entityStates
+     * 3. skipIfResolved: если entity leaf уже имеет значение ≠ template default → skip
+     * 4. Deduplication: если status === "pending" → return
+     * 5. Вызвать _executeEntityFieldEntry (Phase 2: stub, Phase 3: реальная execution)
+     */
+    triggerEntityFieldResolve(entityId: string, templateFieldNode: AnyConfigNode): void;
+    /**
+     * Запустить resolve для entity-template binding.
+     * Перенесено из Palistor (фаза 6 — унификация entity resolve в ResolveManager).
+     *
+     * - Проверяет наличие templateNode.resolve.resolver
+     * - Deduplication: пропускает если уже loading (status === "pending")
+     * - status "pending" → resolver(entityProxy, store) → upsert result → markResolved → status "resolved"
+     * - При ошибке: onError → status "error"
+     */
+    triggerEntityTemplateResolve(entityId: string, templateNode: AnyConfigNode, entityProxy: object): void;
+    /**
+     * Запустить resolve для per-entity вложенного списка (вариант C, фаза C1).
+     *
+     * Состояние resolve хранится в общем `entityStates`, ключ — (ownerId, listConfigNode).
+     * Состав списка — в `EntityListState` (на `ownerEntity.lists`), идентичность
+     * которого служит ключом изолированной версии в хабе.
+     *
+     * - Проверяет `listConfigNode[1].resolve.resolver`.
+     * - Дедупликация: пропускает, если уже `pending`/`resolved`.
+     * - `pending` → resolver(parentValues, store) → upsert children с owner-ссылкой →
+     *   обновление `EntityListState.itemIds` → notify (bump версии entityListState).
+     * - При ошибке: onError → status `error`.
+     */
+    triggerEntityListResolve(ownerId: string, listConfigNode: AnyConfigNode, ownerEntity: EntityNode): void;
+    /** Текущий id владельца (учитывает rekey через nodeState). */
+    private _listOwnerId;
+    /**
+     * Единая точка чтения resolve-state списка (root + per-entity).
+     *
+     * Дает builder-у/loading один источник, не зная, где физически лежит состояние:
+     *   - root  → `this.states` (ключ — listConfigNode);
+     *   - entity→ `this.entityStates` (ключ — (ownerId, listConfigNode)).
+     *
+     * Физическое слияние двух хранилищ не делается намеренно: root-list states
+     * сцеплены с общим `this.states` (deps-retrigger/reset), и их вынос дороже
+     * и рискованнее, чем выигрыш. Унификация здесь — на уровне доступа.
+     */
+    getListResolveState(listState: ListState): ResolveState | undefined;
+    /**
+     * Единая точка запуска resolve списка (root + per-entity).
+     * Диспетчеризует по `ownerEntity` на существующие тела
+     * ({@link triggerResolve} → executeListResolve / {@link triggerEntityListResolve}).
+     */
+    triggerListResolve(listState: ListState): void;
+    /**
+     * Очистить все per-entity resolve states для удалённой entity.
+     * Вызывается из Palistor.delete(entityId) — фаза 4.
+     */
+    cleanupEntityResolveStates(entityId: string): void;
+    /**
+     * Подключить retrigger resolve в notification hub.
+     * Возвращает функцию-хук `(changedPaths) => void`, которую нужно
+     * установить в `hub.setPostNotifyHook`.
+     * Возвращает `null`, если resolve-записей нет.
+     */
+    createPostNotifyHook(): ((changedPaths: Set<string>) => void) | null;
+    /**
+     * Фаза 4: парсит entity-пути из changedPaths и перезапускает entity field resolves,
+     * чьи зависимости пересекаются с изменёнными путями полей.
+     *
+     * Entity-пути имеют вид `_entity_.${entityId}.${fieldPath}`.
+     * Зависимости в entityStates хранятся относительно entity (например, "name", не "_entity_.u1.name").
+     */
+    private _retriggerEntityFieldResolves;
+    /** Запустить eager resolvers (lazy: false). */
+    launchEager(): void;
+    /**
+     * Ретриггерить резолверы, зависящие от изменённых путей.
+     * Используется из `Palistor.setContext()` для реактивного перезапуска
+     * резолверов при изменении контекста.
+     */
+    retriggerByPaths(changedPaths: Set<string>): void;
+    /** Диспетчеризует запись в нужную функцию выполнения (группа или список). */
+    private _executeEntry;
+    /**
+     * Выполняет entity field resolve для заданной entry + entityId.
+     * Делегирует вызов executeEntityFieldResolve с per-entity ResolveDeps.
+     */
+    private _executeEntityFieldEntry;
+}
+/** @deprecated Используйте `new ResolveManager(deps)`. */
+export declare function createResolveManager(deps: ResolveManagerDeps): ResolveManager;
+//# sourceMappingURL=createResolveManager.d.ts.map

package/dist/store/init/createResolveManager.d.ts.map

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