@raphy-js/raph 1.0.0-dev.18

package/dist/path/meta/RaphMeta.d.ts

@@ -0,0 +1,45 @@
+import { DataPathDef } from '../path.types';
+import { RaphKernel } from '../RaphKernel';
+import { RaphMetaApi, RaphMetaReadOptions, RaphMetaWatchCallback, RaphMetaWatchOptions, RaphMetaWriteOptions } from './meta.types';
+export interface RaphMetaBinding {
+    readonly assertReadable?: () => void;
+    readonly assertWritable?: () => void;
+    readonly runWrite?: <Result>(operation: () => Result, invalidate: boolean) => Result;
+    readonly watch?: (masks: DataPathDef | readonly DataPathDef[], callback: RaphMetaWatchCallback, options: RaphMetaWatchOptions) => () => void;
+}
+/**
+ * Тонкий фасад отдельного Kernel-owned Meta-plane.
+ */
+export declare class RaphMeta implements RaphMetaApi {
+    private readonly _kernel;
+    private readonly _binding;
+    /**
+     * Создаёт metadata facade поверх указанного Kernel.
+     */
+    constructor(_kernel: RaphKernel, _binding?: RaphMetaBinding);
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get(path: DataPathDef, namespace?: string, options?: RaphMetaReadOptions): unknown;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPathDef, namespace?: string, options?: RaphMetaReadOptions): boolean;
+    /**
+     * Записывает значение и публикует соответствующее изменение.
+     */
+    set(path: DataPathDef, namespace: string, value: unknown, options?: RaphMetaWriteOptions): void;
+    /**
+     * Объединяет значение по пути и публикует соответствующее изменение.
+     */
+    merge(path: DataPathDef, namespace: string, value: unknown, options?: RaphMetaWriteOptions): void;
+    /**
+     * Удаляет значение по пути и публикует изменение при наличии данных.
+     */
+    delete(path: DataPathDef, namespace?: string, options?: RaphMetaWriteOptions): void;
+    /**
+     * Подписывает callback на metadata-изменения и возвращает disposer.
+     */
+    watch(masks: DataPathDef | readonly DataPathDef[], callback: RaphMetaWatchCallback, options?: RaphMetaWatchOptions): () => void;
+    private _write;
+}

package/dist/path/meta/RaphMetaStore.d.ts

@@ -0,0 +1,45 @@
+import { DataPath } from '../DataPath';
+/**
+ * Kernel-owned дерево metadata, адресованное каноническими DataPath.
+ */
+export declare class RaphMetaStore {
+    private readonly _root;
+    size: number;
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get(path: DataPath, namespace?: string): unknown;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPath, namespace?: string): boolean;
+    /**
+     * Записывает значение namespace в metadata tree.
+     */
+    set(path: DataPath, namespace: string, value: unknown): void;
+    /**
+     * Объединяет object metadata либо заменяет значение namespace.
+     */
+    merge(path: DataPath, namespace: string, value: unknown): void;
+    /**
+     * Удаляет namespace либо все metadata указанного owner.
+     */
+    delete(path: DataPath, namespace?: string): boolean;
+    /**
+     * Удаляет metadata всего поддерева указанного data-owner.
+     */
+    deleteSubtree(path: DataPath): DataPath[];
+    /**
+     * Удаляет metadata, владельцы которой отсутствуют в data tree.
+     */
+    pruneMissing(path: DataPath, ownerExists: (candidate: DataPath) => boolean): DataPath[];
+    /**
+     * Полностью очищает metadata storage.
+     */
+    clear(): DataPath[];
+    private _find;
+    private _ensure;
+    private _findStack;
+    private _pruneEmpty;
+    private _pruneMissingNode;
+}

package/dist/path/meta/meta.types.d.ts

@@ -0,0 +1,31 @@
+import { DataPath } from '../DataPath';
+import { DataPathDef, PathOptions } from '../path.types';
+export type RaphMetaMutationKind = 'set' | 'merge' | 'delete';
+export type RaphMetaMutationCause = 'explicit' | 'owner-delete' | 'owner-replaced';
+export interface RaphMetaMutationEvent {
+    readonly kind: RaphMetaMutationKind;
+    readonly path: DataPath;
+    readonly namespace: string | null;
+    readonly cause: RaphMetaMutationCause;
+}
+export interface RaphMetaEvents {
+    readonly events: readonly RaphMetaMutationEvent[];
+}
+export interface RaphMetaReadOptions extends PathOptions {
+}
+export interface RaphMetaWriteOptions extends RaphMetaReadOptions {
+    readonly invalidate?: boolean;
+}
+export interface RaphMetaWatchOptions extends RaphMetaReadOptions {
+    readonly namespace?: string;
+    readonly wildcardDynamic?: boolean;
+}
+export type RaphMetaWatchCallback = (payload: RaphMetaEvents) => void | (() => void);
+export interface RaphMetaApi {
+    get: (path: DataPathDef, namespace?: string, options?: RaphMetaReadOptions) => unknown;
+    has: (path: DataPathDef, namespace?: string, options?: RaphMetaReadOptions) => boolean;
+    set: (path: DataPathDef, namespace: string, value: unknown, options?: RaphMetaWriteOptions) => void;
+    merge: (path: DataPathDef, namespace: string, value: unknown, options?: RaphMetaWriteOptions) => void;
+    delete: (path: DataPathDef, namespace?: string, options?: RaphMetaWriteOptions) => void;
+    watch: (masks: DataPathDef | readonly DataPathDef[], callback: RaphMetaWatchCallback, options?: RaphMetaWatchOptions) => () => void;
+}

package/dist/path/path.types.d.ts

@@ -0,0 +1,27 @@
+import { PlainDataPath } from './data-path.types';
+import { DataPath } from './DataPath';
+export type DataPathDef = string | DataPath | PlainDataPath;
+export interface PathOptions {
+    readonly vars?: Readonly<Record<string, unknown>>;
+}
+export type PathMutationKind = 'set' | 'merge' | 'delete';
+export interface PathEvent {
+    readonly kind: PathMutationKind;
+    readonly path: string;
+    readonly previous: unknown;
+    readonly value: unknown;
+}
+export interface PathEvents {
+    readonly events: readonly PathEvent[];
+}
+export type PathWatchCallback = (payload: PathEvents) => void;
+export interface PathApi {
+    get: <T = unknown>(path: DataPathDef, options?: PathOptions) => T | undefined;
+    peek: <T = unknown>(path: DataPathDef, options?: PathOptions) => T | undefined;
+    has: (path: DataPathDef, options?: PathOptions) => boolean;
+    set: <T>(path: DataPathDef, value: T, options?: PathOptions) => void;
+    merge: (path: DataPathDef, value: unknown, options?: PathOptions) => void;
+    delete: (path: DataPathDef, options?: PathOptions) => void;
+    batch: <T>(operation: () => T) => T;
+    watch: (masks: DataPathDef | readonly DataPathDef[], callback: PathWatchCallback) => () => void;
+}

package/dist/path/pathSegmentKey.d.ts

@@ -0,0 +1,2 @@
+import { PathSegment } from './data-path.types';
+export declare function pathSegmentKey(segment: PathSegment): string;

package/dist/path/storage/AdapterPathStore.d.ts

@@ -0,0 +1,45 @@
+import { DataPathDef, PathOptions, PathWatchCallback } from '../path.types';
+import { DataAdapter } from './data-adapter.types';
+/**
+ * Связывает events и watchers только для Kernel поверх внешнего DataAdapter.
+ */
+export declare class AdapterPathStore {
+    private readonly _adapter;
+    private readonly _eventHub;
+    /**
+     * Связывает внешний DataAdapter с path events и watchers Kernel.
+     */
+    constructor(_adapter: DataAdapter);
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Читает значение по пути без регистрации реактивной зависимости.
+     */
+    peek<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPathDef, options?: PathOptions): boolean;
+    /**
+     * Записывает значение и публикует соответствующее изменение.
+     */
+    set<T>(path: DataPathDef, value: T, options?: PathOptions): void;
+    /**
+     * Объединяет значение по пути и публикует соответствующее изменение.
+     */
+    merge(path: DataPathDef, value: unknown, options?: PathOptions): void;
+    /**
+     * Удаляет значение по пути и публикует изменение при наличии данных.
+     */
+    delete(path: DataPathDef, options?: PathOptions): void;
+    /**
+     * Выполняет операцию в общей синхронной batch boundary.
+     */
+    batch<T>(operation: () => T): T;
+    /**
+     * Подписывает callback на подходящие изменения и возвращает disposer.
+     */
+    watch(maskOrMasks: DataPathDef | readonly DataPathDef[], callback: PathWatchCallback): () => void;
+}

package/dist/path/storage/DefaultDataAdapter.d.ts

@@ -0,0 +1,63 @@
+import { DataPathDef, PathOptions } from '../path.types';
+import { DataAdapter, DataObject, DefaultAdapterOptions } from './data-adapter.types';
+/**
+ * Настраиваемый in-memory adapter, включаемый явно.
+ * Kernel без опций продолжает работать напрямую через PathStore без дополнительной ветки.
+ */
+export declare class DefaultDataAdapter implements DataAdapter {
+    private _root;
+    private readonly _options;
+    private _indexes;
+    /**
+     * Создаёт in-memory adapter с заданным начальным root и опциями.
+     */
+    constructor(initial?: DataObject, options?: DefaultAdapterOptions);
+    /**
+     * Возвращает текущий корневой объект adapter.
+     */
+    root(): DataObject;
+    /**
+     * Создаёт изолированную copy-on-write проекцию для синхронной проверки mutation.
+     */
+    fork(): DefaultDataAdapter;
+    /**
+     * Заменяет корневой объект без path-level публикации.
+     */
+    replaceRoot(root: DataObject): void;
+    /**
+     * Обновляет изменяемые опции adapter и сбрасывает построенные indexes.
+     */
+    options(options: DefaultAdapterOptions): void;
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get(path: DataPathDef, options?: PathOptions): unknown;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPathDef, options?: PathOptions): boolean;
+    /**
+     * Записывает значение по пути и обновляет затронутые selector indexes.
+     */
+    set(path: DataPathDef, value: unknown, options?: PathOptions): void;
+    /**
+     * Объединяет object value либо заменяет значение по пути.
+     */
+    merge(path: DataPathDef, value: unknown, options?: PathOptions): void;
+    /**
+     * Удаляет значение согласно arrayDelete policy adapter.
+     */
+    delete(path: DataPathDef, options?: PathOptions): void;
+    /**
+     * Находит индекс элемента массива по selector-сегменту.
+     */
+    indexOf(path: DataPathDef, options?: PathOptions): number;
+    private _read;
+    private _readSegment;
+    private _readOrCreateChild;
+    private _writeSegment;
+    private _invalidateArray;
+    private _invalidateIndexKey;
+    private _findSelector;
+    private _createIndex;
+}

package/dist/path/storage/PathEventHub.d.ts

@@ -0,0 +1,48 @@
+import { DataPathDef, PathEvent, PathWatchCallback } from '../path.types';
+/**
+ * Общий dormant event/watch lifecycle для встроенного и adapter path-store.
+ */
+export declare class PathEventHub {
+    private readonly _batchErrorMessage;
+    private _router;
+    private _events;
+    private _batchDepth;
+    private _watcherCount;
+    private _publishing;
+    /**
+     * Создаёт общий batch и publication boundary для path store.
+     */
+    constructor(_batchErrorMessage: string);
+    /**
+     * Показывает, есть ли watchers, ради которых нужно сохранять значения событий.
+     */
+    get hasWatchers(): boolean;
+    /**
+     * Возвращает накопленные события текущей batch.
+     * @internal
+     */
+    get events(): readonly PathEvent[] | undefined;
+    /**
+     * Возвращает внутренний path router для диагностики store.
+     * @internal
+     */
+    get router(): unknown;
+    /**
+     * Возвращает число активных watchers.
+     * @internal
+     */
+    get watcherCount(): number;
+    /**
+     * Добавляет событие в текущую batch либо публикует его сразу.
+     */
+    record(event: PathEvent): void;
+    /**
+     * Выполняет операцию в общей синхронной batch boundary.
+     */
+    batch<T>(operation: () => T): T;
+    /**
+     * Подписывает callback на подходящие изменения и возвращает disposer.
+     */
+    watch(maskOrMasks: DataPathDef | readonly DataPathDef[], callback: PathWatchCallback): () => void;
+    private _publish;
+}

package/dist/path/storage/PathStore.d.ts

@@ -0,0 +1,51 @@
+import { DataPathDef, PathApi, PathOptions, PathWatchCallback } from '../path.types';
+/**
+ * Владеет одним независимым path-root, mutation log и watch-router.
+ */
+export declare class PathStore implements PathApi {
+    private _root;
+    private readonly _eventHub;
+    /**
+     * Возвращает внутренний router для диагностического контракта Kernel.
+     * @internal
+     */
+    private get _router();
+    private get _events();
+    private get _watcherCount();
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Читает значение по пути без регистрации реактивной зависимости.
+     */
+    peek<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPathDef, options?: PathOptions): boolean;
+    /**
+     * Записывает значение и публикует соответствующее изменение.
+     */
+    set<T>(path: DataPathDef, value: T, options?: PathOptions): void;
+    /**
+     * Объединяет значение по пути и публикует соответствующее изменение.
+     */
+    merge(path: DataPathDef, value: unknown, options?: PathOptions): void;
+    /**
+     * Удаляет значение по пути и публикует изменение при наличии данных.
+     */
+    delete(path: DataPathDef, options?: PathOptions): void;
+    /**
+     * Выполняет операцию в общей синхронной batch boundary.
+     */
+    batch<T>(operation: () => T): T;
+    /**
+     * Подписывает callback на подходящие изменения и возвращает disposer.
+     */
+    watch(maskOrMasks: DataPathDef | readonly DataPathDef[], callback: PathWatchCallback): () => void;
+    private _setRoot;
+    private _mergeRoot;
+    private _deleteRoot;
+    private _recordRootEvent;
+}

package/dist/path/storage/createDataDraft.d.ts

@@ -0,0 +1,4 @@
+export declare function createDataDraft<T extends object>(root: T, onArrayChange: (array: any[]) => void): {
+    root: T;
+    unchangedArray(array: any[], key: string): any[] | null;
+};

package/dist/path/storage/data-adapter.types.d.ts

@@ -0,0 +1,17 @@
+import { DataPathDef, PathOptions } from '../path.types';
+export type DataObject = Record<string, unknown> | unknown[];
+export interface DataAdapter {
+    root: () => DataObject;
+    has?: (path: DataPathDef, options?: PathOptions) => boolean;
+    get: (path: DataPathDef, options?: PathOptions) => unknown;
+    set: (path: DataPathDef, value: unknown, options?: PathOptions) => void;
+    delete: (path: DataPathDef, options?: PathOptions) => void;
+    merge: (path: DataPathDef, value: unknown, options?: PathOptions) => void;
+    indexOf?: (path: DataPathDef, options?: PathOptions) => number;
+}
+export interface DefaultAdapterOptions {
+    readonly arrayDelete?: 'splice' | 'unset';
+    readonly autoCreate?: boolean;
+    readonly indexEnabled?: boolean;
+    readonly indexStrategy?: 'lazy-key' | 'eager-all-keys';
+}

package/dist/path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./debug/path/DataPath.cjs"),e=require("./debug/path/derived/derived-strategy.utils.cjs"),a=require("./debug/path/derived/RaphDerivedHandle.cjs"),r=require("./debug/path/meta/RaphMeta.cjs"),d=require("./debug/path/RaphKernel.cjs"),l=require("./debug/path/storage/DefaultDataAdapter.cjs"),u=require("./debug/path/storage/PathStore.cjs");exports.DataPath=t.DataPath;exports.collectionByKey=e.collectionByKey;exports.filterByKey=e.filterByKey;exports.full=e.full;exports.RaphDerivedHandle=a.RaphDerivedHandle;exports.RaphMeta=r.RaphMeta;exports.RaphKernel=d.RaphKernel;exports.DefaultDataAdapter=l.DefaultDataAdapter;exports.PathStore=u.PathStore;

package/dist/path.js

@@ -0,0 +1,18 @@
+import { DataPath as o } from "./debug/path/DataPath.js";
+import { collectionByKey as a, filterByKey as p, full as f } from "./debug/path/derived/derived-strategy.utils.js";
+import { RaphDerivedHandle as m } from "./debug/path/derived/RaphDerivedHandle.js";
+import { RaphMeta as h } from "./debug/path/meta/RaphMeta.js";
+import { RaphKernel as D } from "./debug/path/RaphKernel.js";
+import { DefaultDataAdapter as i } from "./debug/path/storage/DefaultDataAdapter.js";
+import { PathStore as K } from "./debug/path/storage/PathStore.js";
+export {
+  o as DataPath,
+  i as DefaultDataAdapter,
+  K as PathStore,
+  m as RaphDerivedHandle,
+  D as RaphKernel,
+  h as RaphMeta,
+  a as collectionByKey,
+  p as filterByKey,
+  f as full
+};

package/dist/raph.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./debug/api/errors.cjs"),p=require("./debug/api/Raph.cjs"),i=require("./debug/api/RaphReactivityInstance.cjs"),r=require("./debug/runtime/errors.cjs"),o=require("./debug/runtime/ownership/parentGraph.cjs"),h=require("./debug/runtime/ownership/RaphEffectScope.cjs"),n=require("./debug/runtime/ownership/RaphNode.cjs"),s=require("./debug/runtime/ownership/RaphScope.cjs"),u=require("./debug/runtime/phases/orderPhaseTasks.cjs"),R=require("./debug/runtime/phases/phase.types.cjs"),d=require("./debug/runtime/RaphRuntime.cjs"),c=require("./debug/runtime/reactivity/PathHandle.cjs"),_=require("./debug/path/DataPath.cjs"),a=require("./debug/path/derived/derived-strategy.utils.cjs"),t=require("./debug/path/derived/RaphDerivedHandle.cjs"),l=require("./debug/path/meta/RaphMeta.cjs"),g=require("./debug/path/RaphKernel.cjs"),E=require("./debug/path/storage/DefaultDataAdapter.cjs");exports.RaphCapabilityError=e.RaphCapabilityError;exports.RaphConfigurationError=e.RaphConfigurationError;exports.RaphDefaultInstanceError=e.RaphDefaultInstanceError;exports.RaphError=e.RaphError;exports.RaphFacadeDisposedError=e.RaphFacadeDisposedError;exports.Raph=p.Raph;exports.RaphReactivityInstance=i.RaphReactivityInstance;exports.RaphActionError=r.RaphActionError;exports.RaphCrossRuntimeError=r.RaphCrossRuntimeError;exports.RaphDisposedError=r.RaphDisposedError;exports.RaphPhaseProcessError=r.RaphPhaseProcessError;exports.parentGraph=o.parentGraph;exports.RaphEffectScope=h.RaphEffectScope;exports.RaphNode=n.RaphNode;exports.RaphScope=s.RaphScope;exports.orderPhaseTasks=u.orderPhaseTasks;exports.RaphSchedulerType=R.RaphSchedulerType;exports.RaphRuntime=d.RaphRuntime;exports.PathHandle=c.PathHandle;exports.DataPath=_.DataPath;exports.collectionByKey=a.collectionByKey;exports.filterByKey=a.filterByKey;exports.full=a.full;exports.RaphDerivedHandle=t.RaphDerivedHandle;exports.RaphDerivedTargetWriteError=t.RaphDerivedTargetWriteError;exports.RaphMeta=l.RaphMeta;exports.RaphKernel=g.RaphKernel;exports.DefaultDataAdapter=E.DefaultDataAdapter;

package/dist/raph.js

@@ -0,0 +1,48 @@
+import { RaphCapabilityError as e, RaphConfigurationError as p, RaphDefaultInstanceError as a, RaphError as t, RaphFacadeDisposedError as h } from "./debug/api/errors.js";
+import { Raph as R } from "./debug/api/Raph.js";
+import { RaphReactivityInstance as x } from "./debug/api/RaphReactivityInstance.js";
+import { RaphActionError as n, RaphCrossRuntimeError as s, RaphDisposedError as c, RaphPhaseProcessError as l } from "./debug/runtime/errors.js";
+import { parentGraph as E } from "./debug/runtime/ownership/parentGraph.js";
+import { RaphEffectScope as u } from "./debug/runtime/ownership/RaphEffectScope.js";
+import { RaphNode as P } from "./debug/runtime/ownership/RaphNode.js";
+import { RaphScope as C } from "./debug/runtime/ownership/RaphScope.js";
+import { orderPhaseTasks as S } from "./debug/runtime/phases/orderPhaseTasks.js";
+import { RaphSchedulerType as g } from "./debug/runtime/phases/phase.types.js";
+import { RaphRuntime as B } from "./debug/runtime/RaphRuntime.js";
+import { PathHandle as I } from "./debug/runtime/reactivity/PathHandle.js";
+import { DataPath as k } from "./debug/path/DataPath.js";
+import { collectionByKey as G, filterByKey as M, full as N } from "./debug/path/derived/derived-strategy.utils.js";
+import { RaphDerivedHandle as j, RaphDerivedTargetWriteError as q } from "./debug/path/derived/RaphDerivedHandle.js";
+import { RaphMeta as z } from "./debug/path/meta/RaphMeta.js";
+import { RaphKernel as L } from "./debug/path/RaphKernel.js";
+import { DefaultDataAdapter as Q } from "./debug/path/storage/DefaultDataAdapter.js";
+export {
+  k as DataPath,
+  Q as DefaultDataAdapter,
+  I as PathHandle,
+  R as Raph,
+  n as RaphActionError,
+  e as RaphCapabilityError,
+  p as RaphConfigurationError,
+  s as RaphCrossRuntimeError,
+  a as RaphDefaultInstanceError,
+  j as RaphDerivedHandle,
+  q as RaphDerivedTargetWriteError,
+  c as RaphDisposedError,
+  u as RaphEffectScope,
+  t as RaphError,
+  h as RaphFacadeDisposedError,
+  L as RaphKernel,
+  z as RaphMeta,
+  P as RaphNode,
+  l as RaphPhaseProcessError,
+  x as RaphReactivityInstance,
+  B as RaphRuntime,
+  g as RaphSchedulerType,
+  C as RaphScope,
+  G as collectionByKey,
+  M as filterByKey,
+  N as full,
+  S as orderPhaseTasks,
+  E as parentGraph
+};