@raphy-js/raph 1.0.0-dev.18

package/dist/runtime/reactivity/RuntimeReactivity.d.ts

@@ -0,0 +1,45 @@
+import { OwnedSourceHooks, ReactivityOptions, ReadonlySignal, Signal } from '../../reactivity/types';
+import { RaphScope } from '../ownership/RaphScope';
+import { RuntimeEffectBinding, RuntimeSignalLifecycle } from './runtime-reactivity.types';
+import { RaphReactivity } from '../../reactivity/engine';
+/**
+ * Внутренний policy adapter, наследующий реактивные алгоритмы без дублирования.
+ */
+export declare class RuntimeReactivity extends RaphReactivity {
+    private readonly _lifecycle;
+    private readonly _bindings;
+    /**
+     * Создаёт policy adapter реактивного графа для одного runtime.
+     */
+    constructor(_lifecycle: RuntimeSignalLifecycle, options?: Pick<ReactivityOptions, 'adaptiveDependencyIndex'>);
+    /**
+     * Создаёт временную registration boundary для runtime effect.
+     */
+    withEffectBinding<T>(binding: RuntimeEffectBinding | undefined, operation: () => T): T;
+    /**
+     * Выполняет untracked-операцию, сохраняя runtime owner context.
+     */
+    untrackedWithOwner<T>(operation: () => T): T;
+    /**
+     * Возвращает owner текущего синхронного реактивного контекста.
+     */
+    getActiveOwner(): object | undefined;
+    /** Returns the Runtime resource owner whose implicit dependencies are being collected. */
+    getActiveConsumerOwner(): RaphScope | undefined;
+    /**
+     * Сообщает, должен ли untracked work очищать graph consumer или Runtime owner context.
+     */
+    hasActiveContext(): boolean;
+    /**
+     * Выполняет операцию с указанным active owner.
+     */
+    runWithOwner<T>(lifecycle: RuntimeSignalLifecycle | undefined, consumerOwner: RaphScope | undefined, operation: () => T): T;
+    /**
+     * Создаёт owned signal с runtime lifecycle policy.
+     */
+    signalForOwner<T>(initialValue: T, owner: RaphScope, sourceHooks?: OwnedSourceHooks, captureWriteInBoundary?: (write: (value: T) => void) => void): Signal<T>;
+    /**
+     * Создаёт owned computed с runtime lifecycle policy.
+     */
+    computedForOwner<T>(getter: () => T, owner: RaphScope, sourceHooks?: OwnedSourceHooks): ReadonlySignal<T>;
+}

package/dist/runtime/reactivity/RuntimeWatch.d.ts

@@ -0,0 +1,34 @@
+import { Disposer } from '../../reactivity/types';
+/**
+ * Хранит общий callback/cleanup lifecycle Runtime-watch без знания источника
+ * событий. Регистрация в Kernel и фазовая доставка остаются у Runtime.
+ */
+export declare class RuntimeWatch {
+    private readonly _runUntracked;
+    private readonly _callback;
+    private _cleanup;
+    private _stopped;
+    /**
+     * Создаёт runtime-owned watch с явным lifecycle остановки.
+     */
+    constructor(_runUntracked: <T>(operation: () => T) => T, _callback: () => void | Disposer);
+    /**
+     * Показывает, остановлен ли watch.
+     */
+    get stopped(): boolean;
+    /**
+     * Освобождает предыдущий результат callback и выполняет новую доставку.
+     * Ошибка cleanup не лишает живой watcher текущего события.
+     */
+    readonly deliver: () => void;
+    /**
+     * Preserves cleanup/callback error aggregation and reentrant stop semantics
+     * for the less common resource-returning callback path.
+     */
+    private _deliverWithCleanup;
+    /**
+     * Останавливает внешнюю регистрацию и cleanup callback, сохраняя обе ошибки.
+     */
+    stop(stopSource?: Disposer): void;
+    private _attempt;
+}

package/dist/runtime/reactivity/runtime-reactivity.types.d.ts

@@ -0,0 +1,11 @@
+import { EffectTask } from '../../reactivity/types';
+import { RaphScope } from '../ownership/RaphScope';
+export interface RuntimeSignalLifecycle {
+    owner: object | undefined;
+    assertWriteAllowed?: () => void;
+    runWrite?: <T>(operation: () => T) => T;
+    assertDependencyAllowed: (sourceOwner: RaphScope, consumerOwner: RaphScope) => void;
+    throwDisposed: () => never;
+    throwCrossRuntime: (owner: object) => never;
+}
+export type RuntimeEffectBinding = (run: () => void) => EffectTask;

package/dist/runtime.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./debug/runtime/errors.cjs"),r=require("./debug/runtime/ownership/parentGraph.cjs"),a=require("./debug/runtime/ownership/RaphEffectScope.cjs"),p=require("./debug/runtime/ownership/RaphNode.cjs"),o=require("./debug/runtime/ownership/RaphScope.cjs"),s=require("./debug/runtime/phases/orderPhaseTasks.cjs"),t=require("./debug/runtime/phases/phase.types.cjs"),h=require("./debug/runtime/RaphRuntime.cjs"),n=require("./debug/runtime/reactivity/PathHandle.cjs");exports.RaphActionError=e.RaphActionError;exports.RaphCrossRuntimeError=e.RaphCrossRuntimeError;exports.RaphDisposedError=e.RaphDisposedError;exports.RaphPhaseProcessError=e.RaphPhaseProcessError;exports.parentGraph=r.parentGraph;exports.RaphEffectScope=a.RaphEffectScope;exports.RaphNode=p.RaphNode;exports.RaphScope=o.RaphScope;exports.orderPhaseTasks=s.orderPhaseTasks;exports.RaphSchedulerType=t.RaphSchedulerType;exports.RaphRuntime=h.RaphRuntime;exports.PathHandle=n.PathHandle;

package/dist/runtime.js

@@ -0,0 +1,23 @@
+import { RaphActionError as e, RaphCrossRuntimeError as p, RaphDisposedError as a, RaphPhaseProcessError as t } from "./debug/runtime/errors.js";
+import { parentGraph as f } from "./debug/runtime/ownership/parentGraph.js";
+import { RaphEffectScope as R } from "./debug/runtime/ownership/RaphEffectScope.js";
+import { RaphNode as x } from "./debug/runtime/ownership/RaphNode.js";
+import { RaphScope as d } from "./debug/runtime/ownership/RaphScope.js";
+import { orderPhaseTasks as E } from "./debug/runtime/phases/orderPhaseTasks.js";
+import { RaphSchedulerType as P } from "./debug/runtime/phases/phase.types.js";
+import { RaphRuntime as S } from "./debug/runtime/RaphRuntime.js";
+import { PathHandle as T } from "./debug/runtime/reactivity/PathHandle.js";
+export {
+  T as PathHandle,
+  e as RaphActionError,
+  p as RaphCrossRuntimeError,
+  a as RaphDisposedError,
+  R as RaphEffectScope,
+  x as RaphNode,
+  t as RaphPhaseProcessError,
+  S as RaphRuntime,
+  P as RaphSchedulerType,
+  d as RaphScope,
+  E as orderPhaseTasks,
+  f as parentGraph
+};

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@raphy-js/raph",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/raphyjs/raphy-js-raph.git"
+  },
+  "type": "module",
+  "version": "1.0.0-dev.18",
+  "private": false,
+  "description": "Reactive signals, paths and application runtime",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./path": {
+      "types": "./dist/entrypoints/path.d.ts",
+      "import": "./dist/path.js",
+      "require": "./dist/path.cjs"
+    },
+    "./raph": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/raph.js",
+      "require": "./dist/raph.cjs"
+    },
+    "./signals": {
+      "types": "./dist/entrypoints/reactivity.d.ts",
+      "import": "./dist/reactivity.js",
+      "require": "./dist/reactivity.cjs"
+    },
+    "./debug/*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/debug/*.js",
+      "require": "./dist/debug/*.cjs"
+    },
+    "./reactivity": {
+      "types": "./dist/entrypoints/reactivity.d.ts",
+      "import": "./dist/reactivity.js",
+      "require": "./dist/reactivity.cjs"
+    },
+    "./runtime": {
+      "types": "./dist/entrypoints/runtime.d.ts",
+      "import": "./dist/runtime.js",
+      "require": "./dist/runtime.cjs"
+    },
+    "./machine": {
+      "types": "./dist/entrypoints/machine.d.ts",
+      "import": "./dist/machine.js",
+      "require": "./dist/machine.cjs"
+    },
+    "./machine/testing": {
+      "types": "./dist/entrypoints/machine-testing.d.ts",
+      "import": "./dist/machine-testing.js",
+      "require": "./dist/machine-testing.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/main.d.ts",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "dev": "vite build --watch",
+    "build": "pnpm --ignore-workspace run typecheck && vite build",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit",
+    "test": "vitest run",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "test:coverage": "vitest run --coverage",
+    "test:memory": "node --expose-gc ./node_modules/vitest/vitest.mjs run --config vitest.memory.config.ts",
+    "test:distribution": "node --test src/test/distribution.node.mjs",
+    "test:benchmark:reactivity": "pnpm --ignore-workspace run bench:reactivity:correctness",
+    "bench:install": "pnpm --ignore-workspace run bench:reactivity:install",
+    "bench": "pnpm --ignore-workspace run bench:reactivity:performance",
+    "bench:path": "node src/test/benchmarks/path/run.mjs",
+    "bench:reactivity:install": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run install:lab",
+    "bench:reactivity:correctness": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run correctness",
+    "bench:reactivity:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run performance",
+    "bench:reactivity:memory": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run memory",
+    "bench:reactivity:balanced:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run performance -- --balanced",
+    "bench:reactivity:api-tax": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run api-tax",
+    "bench:reactivity:report": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run report",
+    "bench:reactivity": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run lab",
+    "bench:reactivity:raph-only": "pnpm --ignore-workspace run bench:reactivity --raph-only",
+    "bench:reactivity:balanced": "pnpm --ignore-workspace run bench:reactivity --balanced",
+    "bench:reactivity:light:correctness": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run correctness -- --light",
+    "bench:reactivity:light:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run performance -- --light",
+    "bench:reactivity:light:balanced:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run performance -- --light --balanced",
+    "bench:reactivity:light:api-tax": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run api-tax -- --light",
+    "bench:reactivity:light:report": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactivity run report -- --light",
+    "bench:reactivity:light": "pnpm --ignore-workspace run bench:reactivity --light",
+    "bench:reactivity:light:balanced": "pnpm --ignore-workspace run bench:reactivity --light --balanced",
+    "bench:reactive-object:install": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run install:lab",
+    "bench:reactive-object:correctness": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run correctness",
+    "bench:reactive-object:gc": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run gc",
+    "bench:reactive-object:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run performance",
+    "bench:reactive-object:memory": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run memory",
+    "bench:reactive-object:browsers": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run browsers",
+    "bench:reactive-object:report": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run report",
+    "bench:reactive-object:quick": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run quick",
+    "bench:reactive-object": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/reactive-object run lab",
+    "bench:machine:install": "node src/test/benchmarks/labs/machine/scripts/install.mjs",
+    "bench:machine:correctness": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run correctness",
+    "bench:machine:performance": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run performance",
+    "bench:machine:browsers": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run browsers",
+    "bench:machine:memory": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run memory",
+    "bench:machine:report": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run report",
+    "bench:machine:light": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run light",
+    "bench:machine": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/machine run lab",
+    "bench:native:machine": "node src/test/benchmarks/machine/run.mjs",
+    "bench:ecosystem:install": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run install:lab",
+    "bench:ecosystem:typecheck": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run typecheck",
+    "bench:ecosystem:build": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run build",
+    "bench:ecosystem:test-cli": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run test:cli",
+    "bench:ecosystem:list": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run list",
+    "bench:ecosystem:light": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run light",
+    "bench:ecosystem:balanced": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run balanced",
+    "bench:ecosystem:full": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run full",
+    "bench:ecosystem:curves": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run curves",
+    "bench:ecosystem": "pnpm --ignore-workspace --dir src/test/benchmarks/labs/ecosystem run lab",
+    "lint-check": "eslint src vite.config.ts vitest.config.ts vitest.memory.config.ts --cache",
+    "lint-fix": "eslint src vite.config.ts vitest.config.ts vitest.memory.config.ts --fix --cache",
+    "build:portable": "node scripts/build-portable.mjs"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "9.3.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "10.9.1",
+    "rimraf": "^6.0.1",
+    "typescript": "~6.0.3",
+    "unplugin-dts": "^1.0.3",
+    "vite": "^6.1.0",
+    "vitest": "^3.2.4",
+    "vue-tsc": "^3.3.11"
+  }
+}