@earendil-works/chord 1.5.0 → 1.5.1

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@earendil-works/chord",
-	"version": "1.5.0",
-	"description": "Typed host runtime for plugins, contracts, replicated state, and RPC over JSON links",
+	"version": "1.5.1",
+	"description": "Object runtime for apps across processes: contracts, documents, a store, links, plugins with hot reload, HTTP, workers, web and terminal clients",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -16,30 +16,25 @@
 			"types": "./dist/context/index.d.ts",
 			"import": "./dist/context/index.js"
 		},
-		"./output": {
-			"source": "./src/output.ts",
-			"types": "./dist/output.d.ts",
-			"import": "./dist/output.js"
-		},
 		"./delta": {
 			"source": "./src/delta/index.ts",
 			"types": "./dist/delta/index.d.ts",
 			"import": "./dist/delta/index.js"
 		},
-		"./node": {
-			"source": "./src/node.ts",
-			"types": "./dist/node.d.ts",
-			"import": "./dist/node.js"
+		"./json": {
+			"source": "./src/json.ts",
+			"types": "./dist/json.d.ts",
+			"import": "./dist/json.js"
 		},
-		"./telemetry-sqlite": {
-			"source": "./src/telemetry-sqlite/index.ts",
-			"types": "./dist/telemetry-sqlite/index.d.ts",
-			"import": "./dist/telemetry-sqlite/index.js"
+		"./watch": {
+			"source": "./src/watch.ts",
+			"types": "./dist/watch.d.ts",
+			"import": "./dist/watch.js"
 		},
-		"./next": {
-			"source": "./src/next/index.ts",
-			"types": "./dist/next/index.d.ts",
-			"import": "./dist/next/index.js"
+		"./output": {
+			"source": "./src/output.ts",
+			"types": "./dist/output.d.ts",
+			"import": "./dist/output.js"
 		},
 		"./sqlite": {
 			"source": "./src/sqlite/index.ts",
@@ -56,6 +51,81 @@
 			"types": "./dist/sqlite/cloudflare.d.ts",
 			"import": "./dist/sqlite/cloudflare.js"
 		},
+		"./telemetry-sqlite": {
+			"source": "./src/telemetry-sqlite/index.ts",
+			"types": "./dist/telemetry-sqlite/index.d.ts",
+			"import": "./dist/telemetry-sqlite/index.js"
+		},
+		"./telemetry-sqlite/node": {
+			"source": "./src/telemetry-sqlite/node.ts",
+			"types": "./dist/telemetry-sqlite/node.d.ts",
+			"import": "./dist/telemetry-sqlite/node.js"
+		},
+		"./http": {
+			"source": "./src/node/http/index.ts",
+			"types": "./dist/node/http/index.d.ts",
+			"import": "./dist/node/http/index.js"
+		},
+		"./workers": {
+			"source": "./src/node/workers/index.ts",
+			"types": "./dist/node/workers/index.d.ts",
+			"import": "./dist/node/workers/index.js"
+		},
+		"./workers/child": {
+			"source": "./src/node/workers/child.ts",
+			"types": "./dist/node/workers/child.d.ts",
+			"import": "./dist/node/workers/child.js"
+		},
+		"./plugins": {
+			"source": "./src/node/plugins/index.ts",
+			"types": "./dist/node/plugins/index.d.ts",
+			"import": "./dist/node/plugins/index.js"
+		},
+		"./plugins/runtime": {
+			"source": "./src/node/plugins/runtime.ts",
+			"types": "./dist/node/plugins/runtime.d.ts",
+			"import": "./dist/node/plugins/runtime.js"
+		},
+		"./app": {
+			"source": "./src/node/app/index.ts",
+			"types": "./dist/node/app/index.d.ts",
+			"import": "./dist/node/app/index.js"
+		},
+		"./app/files": {
+			"source": "./src/node/app/files-entry.ts",
+			"types": "./dist/node/app/files-entry.d.ts",
+			"import": "./dist/node/app/files-entry.js"
+		},
+		"./web": {
+			"source": "./src/web/index.ts",
+			"types": "./dist/web/index.d.ts",
+			"import": "./dist/web/index.js"
+		},
+		"./surfaces": {
+			"source": "./src/node/surfaces/index.ts",
+			"types": "./dist/node/surfaces/index.d.ts",
+			"import": "./dist/node/surfaces/index.js"
+		},
+		"./react": {
+			"source": "./src/react/index.ts",
+			"types": "./dist/react/index.d.ts",
+			"import": "./dist/react/index.js"
+		},
+		"./tui": {
+			"source": "./src/tui/index.ts",
+			"types": "./dist/tui/index.d.ts",
+			"import": "./dist/tui/index.js"
+		},
+		"./tui/launcher": {
+			"source": "./src/node/tui/index.ts",
+			"types": "./dist/node/tui/index.d.ts",
+			"import": "./dist/node/tui/index.js"
+		},
+		"./sync": {
+			"source": "./src/sync/index.ts",
+			"types": "./dist/sync/index.d.ts",
+			"import": "./dist/sync/index.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"sideEffects": false,
@@ -90,23 +160,31 @@
 		"node": ">=22.19.0"
 	},
 	"dependencies": {
-		"@earendil-works/pi-schema": "1.5.0",
-		"@earendil-works/pi-telemetry": "1.5.0"
+		"@earendil-works/pi-schema": "1.5.1",
+		"@earendil-works/pi-telemetry": "1.5.1"
 	},
 	"peerDependencies": {
 		"esbuild": "0.28.2",
+		"react": "19.3.0",
 		"ws": "8.21.0"
 	},
 	"peerDependenciesMeta": {
 		"esbuild": {
 			"optional": true
 		},
+		"react": {
+			"optional": true
+		},
 		"ws": {
 			"optional": true
 		}
 	},
 	"devDependencies": {
+		"@types/react": "19.2.14",
+		"@types/react-dom": "19.2.3",
 		"@types/ws": "8.18.2",
+		"react": "19.3.0",
+		"react-dom": "19.3.0",
 		"vitest": "4.1.12",
 		"ws": "8.21.0"
 	}

package/dist/cell.d.ts

@@ -1,122 +0,0 @@
-import type { Schema } from "@earendil-works/pi-schema";
-import { type Draft } from "./delta/index.ts";
-import { ChordError } from "./errors.ts";
-import type { Ctx, Readable, StateEvent } from "./types.ts";
-export interface SourceOptions {
-    readonly dev: boolean;
-    readonly report: (error: unknown) => void;
-}
-/** Checks that `ctx` may write an object's cells now; throws otherwise. */
-export type WriteGuard = (ctx: Ctx) => void;
-/** Fans out values and delta events; listener errors are reported, not thrown to the writer. */
-declare class Fanout<T> {
-    #private;
-    constructor(report: (error: unknown) => void);
-    subscribe(listener: (value: T) => void, current: T): () => void;
-    events(listener: (event: StateEvent<T>) => void, current: T): () => void;
-    /**
-     * Queues delivery to the listeners subscribed now. A listener that subscribes later already got this revision in
-     * its snapshot; one that unsubscribes before delivery is skipped.
-     */
-    emit(event: StateEvent<T>): void;
-}
-/**
- * Whether a state source has its value (entry 8): a remote reference's member before its first snapshot has none, and
- * neither has anything derived from or forwarding it. Sources without this symbol always have their value.
- */
-export declare const HYDRATION: unique symbol;
-export interface Hydration {
-    readonly hydrated: boolean;
-    /** Resolves once hydrated; rejects if the source ends first. */
-    whenHydrated(): Promise<void>;
-}
-/** The hydration of a readable, or undefined for a source that always has its value. */
-export declare function hydrationOf(value: unknown): Hydration | undefined;
-/** The hydrations of `sources` that are not hydrated yet. */
-export declare const unhydrated: (sources: Iterable<unknown>) => Hydration[];
-/** An object-owned state source (cell or derivation). Writes recompute dependents atomically. */
-export declare abstract class Source<T> implements Readable<T> {
-    readonly key: string;
-    readonly seq: number;
-    readonly dependents: Set<Derived<unknown>>;
-    /** Schemas of remote state members currently exposing this source (checked per write in dev mode). */
-    schemas: readonly Schema[];
-    protected readonly options: SourceOptions;
-    protected readonly fanout: Fanout<T>;
-    constructor(key: string, options: SourceOptions);
-    abstract get value(): T;
-    subscribe(listener: (value: T) => void): () => void;
-    events(listener: (event: StateEvent<T>) => void): () => void;
-    /** Per-write validation, dev mode only. */
-    validate(value: unknown): void;
-    protected ownSchemas(): readonly Schema[];
-}
-/** A state cell holding any JSON value, validated against its schema at creation and (dev mode) on writes. */
-export declare class Cell<T> extends Source<T> {
-    #private;
-    /** Replaced at a reload commit that changes the schema (state-version bump). */
-    schema: Schema;
-    /**
-     * `initial` is always validated against `schema`; ownership moves to the cell. Without `initial`, the cell has no
-     * value until `initialize` (a cell declared with `init`, filled before its object goes live).
-     */
-    constructor(key: string, schema: Schema, initial: {
-        readonly value: T;
-    } | undefined, guard: WriteGuard, options: SourceOptions);
-    /** Sets the first value of a cell declared with `init` (validated; ownership moves to the cell). Publishes nothing. */
-    initialize(value: T): void;
-    protected ownSchemas(): readonly Schema[];
-    get value(): T;
-    /**
-     * Mutates a draft (only mutated paths are published), or returns a new value (`n => n + 1`). A returned value is
-     * always validated against the schema. The draft is unusable after `fn` returns.
-     */
-    change(ctx: Ctx, fn: (draft: Draft<T>) => T): void;
-    change(ctx: Ctx, fn: (draft: Draft<T>) => void): void;
-    /**
-     * Replaces the whole value. Ownership of `value` moves to the cell: never mutate it afterwards.
-     *
-     * Subscribers get a structural diff (`diffRevisions`) when `diff` is true, or by default when the new value shares
-     * containers with the old one (a new immutable revision of the same state, e.g. mirrored from another store);
-     * otherwise a single `r` op. The resulting value is the same either way; only the ops differ.
-     */
-    replace(ctx: Ctx, value: T, options?: {
-        readonly diff?: boolean;
-    }): void;
-    /**
-     * Installs a migrated value and its schema (reload commit). The caller validated the value and the derivations
-     * over it against every schema that will apply, so nothing is checked here. Subscribers receive a reset.
-     */
-    reset(value: T, schema: Schema): void;
-}
-export type Sources = readonly Readable<unknown>[];
-export type SourceValues<S extends Sources> = {
-    [K in keyof S]: S[K] extends Readable<infer T> ? T : never;
-};
-/**
- * A synchronous derivation. Sources are object cells/derivations (recomputed atomically with the write) or other
- * readables such as reference state members (recomputed when they publish). Subscribers receive diffs.
- */
-export declare class Derived<T> extends Source<T> {
-    #private;
-    readonly sources: readonly Readable<unknown>[];
-    constructor(key: string, sources: Sources, fn: (...values: never[]) => unknown, options: SourceOptions);
-    get value(): T;
-    /** Hydrated once every source is (a derivation over a remote member waits for its snapshot). */
-    get [HYDRATION](): Hydration | undefined;
-    /**
-     * Computes the first value (or takes it from `precomputed`, a reload's validated dry run) and starts following
-     * the sources (at install, never inside a factory).
-     */
-    attach(precomputed?: ReadonlyMap<unknown, unknown>): void;
-    detach(): void;
-    compute(read: (source: Readable<unknown>) => unknown): T;
-    /** Recomputes and republishes, including dependents. Errors are reported (the source write already happened). */
-    refresh(): void;
-    install(next: T): void;
-}
-export declare const isSource: (value: unknown) => value is Cell<unknown> | Derived<unknown>;
-/** Thrown by placeholders used before activation finished. */
-export declare const notReady: (what: string) => ChordError;
-export {};
-//# sourceMappingURL=cell.d.ts.map

package/dist/cell.d.ts.map

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

package/dist/cell.js

@@ -1,356 +0,0 @@
-import { diffRevisions, track } from "./delta/index.js";
-import { ChordError } from "./errors.js";
-import { enqueue, holdPublications } from "./publish.js";
-import { assertValid } from "./schema.js";
-let sequence = 0;
-/** Fans out values and delta events; listener errors are reported, not thrown to the writer. */
-class Fanout {
-    #values = new Set();
-    #events = new Set();
-    #report;
-    constructor(report) {
-        this.#report = report;
-    }
-    subscribe(listener, current) {
-        this.#values.add(listener);
-        this.#call(listener, current);
-        return () => this.#values.delete(listener);
-    }
-    events(listener, current) {
-        this.#events.add(listener);
-        this.#call(listener, { type: "snap", value: current });
-        return () => this.#events.delete(listener);
-    }
-    /**
-     * Queues delivery to the listeners subscribed now. A listener that subscribes later already got this revision in
-     * its snapshot; one that unsubscribes before delivery is skipped.
-     */
-    emit(event) {
-        const events = [...this.#events];
-        const values = [...this.#values];
-        enqueue(() => {
-            for (const listener of events)
-                if (this.#events.has(listener))
-                    this.#call(listener, event);
-            for (const listener of values)
-                if (this.#values.has(listener))
-                    this.#call(listener, event.value);
-        });
-    }
-    #call(listener, value) {
-        try {
-            listener(value);
-        }
-        catch (error) {
-            this.#report(error);
-        }
-    }
-}
-/**
- * Whether a state source has its value (entry 8): a remote reference's member before its first snapshot has none, and
- * neither has anything derived from or forwarding it. Sources without this symbol always have their value.
- */
-export const HYDRATION = Symbol("chord.hydration");
-/** The hydration of a readable, or undefined for a source that always has its value. */
-export function hydrationOf(value) {
-    if (value === null || typeof value !== "object")
-        return undefined;
-    return value[HYDRATION];
-}
-/** The hydrations of `sources` that are not hydrated yet. */
-export const unhydrated = (sources) => [...sources].map(hydrationOf).filter((hydration) => hydration?.hydrated === false);
-/** An object-owned state source (cell or derivation). Writes recompute dependents atomically. */
-export class Source {
-    key;
-    seq = ++sequence;
-    dependents = new Set();
-    /** Schemas of remote state members currently exposing this source (checked per write in dev mode). */
-    schemas = [];
-    options;
-    fanout;
-    constructor(key, options) {
-        this.key = key;
-        this.options = options;
-        this.fanout = new Fanout(options.report);
-    }
-    subscribe(listener) {
-        return this.fanout.subscribe(listener, this.value);
-    }
-    events(listener) {
-        return this.fanout.events(listener, this.value);
-    }
-    /** Per-write validation, dev mode only. */
-    validate(value) {
-        if (!this.options.dev)
-            return;
-        for (const schema of this.ownSchemas())
-            assertValid("state", `state ${this.key}`, schema, value);
-        for (const schema of this.schemas)
-            assertValid("state", `state ${this.key}`, schema, value);
-    }
-    ownSchemas() {
-        return [];
-    }
-}
-function unbox(ops, value) {
-    const result = [];
-    for (const op of ops) {
-        if (op[0] === "r" || op[1].length === 0)
-            return [["r", value]];
-        const path = op[1].slice(1);
-        switch (op[0]) {
-            case "p":
-                result.push(["p", path, op[2], op[3], op[4]]);
-                break;
-            case "m":
-                result.push(["m", path, op[2]]);
-                break;
-            default:
-                // s/d/a/t on the value itself replace it.
-                if (path.length === 0)
-                    return [["r", value]];
-                if (op[0] === "d")
-                    result.push(["d", path]);
-                else
-                    result.push([op[0], path, op[2]]);
-        }
-    }
-    return result;
-}
-/** A state cell holding any JSON value, validated against its schema at creation and (dev mode) on writes. */
-export class Cell extends Source {
-    /** Replaced at a reload commit that changes the schema (state-version bump). */
-    schema;
-    #tracker;
-    #guard;
-    /** False until `initialize` for a cell declared with `init`: reads and writes throw `not_ready`. */
-    #initialized;
-    /**
-     * `initial` is always validated against `schema`; ownership moves to the cell. Without `initial`, the cell has no
-     * value until `initialize` (a cell declared with `init`, filled before its object goes live).
-     */
-    constructor(key, schema, initial, guard, options) {
-        super(key, options);
-        if (initial !== undefined)
-            assertValid("state", `initial value of state ${key}`, schema, initial.value);
-        this.schema = schema;
-        this.#tracker = track({ v: (initial?.value ?? null) });
-        this.#guard = guard;
-        this.#initialized = initial !== undefined;
-    }
-    /** Sets the first value of a cell declared with `init` (validated; ownership moves to the cell). Publishes nothing. */
-    initialize(value) {
-        if (this.#initialized)
-            throw new Error(`state ${this.key} is already initialized`);
-        assertValid("state", `initial value of state ${this.key}`, this.schema, value);
-        this.#tracker = track({ v: value });
-        this.#initialized = true;
-    }
-    ownSchemas() {
-        return [this.schema];
-    }
-    get value() {
-        if (!this.#initialized)
-            throw notReady(`state ${this.key} (its init has not run)`);
-        return this.#tracker.value.v;
-    }
-    change(ctx, fn) {
-        this.#guard(ctx);
-        if (!this.#initialized)
-            throw notReady(`state ${this.key} (its init has not run)`);
-        const change = this.#tracker.beginChange();
-        let prepared;
-        try {
-            const draft = change.state;
-            const result = fn(draft.v);
-            if (result instanceof Promise)
-                throw new TypeError("cell.change callbacks must be synchronous");
-            if (result !== undefined) {
-                if (result !== draft.v)
-                    assertValid("state", `state ${this.key}`, this.schema, result);
-                draft.v = result;
-            }
-            prepared = change.prepare();
-        }
-        catch (error) {
-            change.abort();
-            throw error;
-        }
-        this.#publish(prepared, "ops");
-    }
-    /**
-     * Replaces the whole value. Ownership of `value` moves to the cell: never mutate it afterwards.
-     *
-     * Subscribers get a structural diff (`diffRevisions`) when `diff` is true, or by default when the new value shares
-     * containers with the old one (a new immutable revision of the same state, e.g. mirrored from another store);
-     * otherwise a single `r` op. The resulting value is the same either way; only the ops differ.
-     */
-    replace(ctx, value, options = {}) {
-        this.#guard(ctx);
-        if (!this.#initialized)
-            throw notReady(`state ${this.key} (its init has not run)`);
-        const before = this.value;
-        const diff = options.diff ?? sharesStructure(before, value);
-        const ops = diff ? diffRevisions(before, value) : undefined;
-        this.#publish(this.#tracker.prepareReplace({ v: value }), "ops", true, ops);
-    }
-    /**
-     * Installs a migrated value and its schema (reload commit). The caller validated the value and the derivations
-     * over it against every schema that will apply, so nothing is checked here. Subscribers receive a reset.
-     */
-    reset(value, schema) {
-        this.schema = schema;
-        this.#publish(this.#tracker.prepareReplace({ v: value }), "reset", false);
-    }
-    /** Adopts this revision and every derived one, then queues all notifications (cell first, then derivations). */
-    #publish(prepared, type, validate = true, ops) {
-        if (prepared.ops.length === 0 && type === "ops") {
-            this.#tracker.adopt(prepared);
-            return;
-        }
-        const value = prepared.value.v;
-        let candidates;
-        try {
-            if (validate)
-                this.validate(value);
-            candidates = computeDependents(this, value, validate);
-        }
-        catch (error) {
-            prepared.abort();
-            throw error;
-        }
-        holdPublications(() => {
-            this.#tracker.adopt(prepared);
-            const published = ops !== undefined && ops.length > 0 ? ops : unbox(prepared.ops, value);
-            this.fanout.emit(type === "reset" ? { type, value } : { type, ops: published, value });
-            for (const [derived, next] of candidates)
-                derived.install(next);
-        });
-    }
-}
-/** True if `b` reuses at least one container of `a` at the same key: a new revision of the same state. */
-function sharesStructure(a, b) {
-    if (a === null || b === null || typeof a !== "object" || typeof b !== "object" || a === b)
-        return false;
-    if (Array.isArray(a) !== Array.isArray(b))
-        return false;
-    for (const [key, child] of Object.entries(b)) {
-        if (child !== null && typeof child === "object" && a[key] === child)
-            return true;
-    }
-    return false;
-}
-/** Recomputes every transitive dependent of `changed` against candidate values and validates them. */
-function computeDependents(changed, value, validate = true) {
-    const pending = new Set();
-    const visit = (source) => {
-        for (const derived of source.dependents) {
-            if (pending.has(derived))
-                continue;
-            pending.add(derived);
-            visit(derived);
-        }
-    };
-    visit(changed);
-    const values = new Map([[changed, value]]);
-    const result = new Map();
-    for (const derived of [...pending].sort((a, b) => a.seq - b.seq)) {
-        const next = derived.compute((source) => (values.has(source) ? values.get(source) : source.value));
-        if (validate)
-            derived.validate(next);
-        values.set(derived, next);
-        result.set(derived, next);
-    }
-    return result;
-}
-const isReadable = (value) => value !== null &&
-    typeof value === "object" &&
-    typeof value.subscribe === "function" &&
-    "value" in value;
-/**
- * A synchronous derivation. Sources are object cells/derivations (recomputed atomically with the write) or other
- * readables such as reference state members (recomputed when they publish). Subscribers receive diffs.
- */
-export class Derived extends Source {
-    sources;
-    #fn;
-    #value;
-    #external = [];
-    constructor(key, sources, fn, options) {
-        super(key, options);
-        this.sources = sources.map((source) => {
-            if (!isReadable(source))
-                throw new TypeError(`derive ${key}: sources must be readables`);
-            return source;
-        });
-        this.#fn = fn;
-        this.#value = undefined;
-    }
-    get value() {
-        return this.#value;
-    }
-    /** Hydrated once every source is (a derivation over a remote member waits for its snapshot). */
-    get [HYDRATION]() {
-        const pending = unhydrated(this.sources);
-        if (pending.length === 0)
-            return undefined;
-        return {
-            hydrated: false,
-            whenHydrated: () => Promise.all(pending.map((hydration) => hydration.whenHydrated())).then(() => { }),
-        };
-    }
-    /**
-     * Computes the first value (or takes it from `precomputed`, a reload's validated dry run) and starts following
-     * the sources (at install, never inside a factory).
-     */
-    attach(precomputed) {
-        this.#value = precomputed?.has(this) ? precomputed.get(this) : this.compute((source) => source.value);
-        for (const source of this.sources) {
-            if (source instanceof Source)
-                source.dependents.add(this);
-            else
-                this.#external.push(source.subscribe(() => this.refresh()));
-        }
-    }
-    detach() {
-        for (const source of this.sources)
-            if (source instanceof Source)
-                source.dependents.delete(this);
-        for (const unsubscribe of this.#external.splice(0))
-            unsubscribe();
-    }
-    compute(read) {
-        const result = this.#fn(...this.sources.map(read));
-        if (result instanceof Promise)
-            throw new TypeError(`derive ${this.key}: fn must be synchronous`);
-        return result;
-    }
-    /** Recomputes and republishes, including dependents. Errors are reported (the source write already happened). */
-    refresh() {
-        try {
-            const next = this.compute((source) => source.value);
-            const dependents = computeDependents(this, next);
-            holdPublications(() => {
-                this.install(next);
-                for (const [derived, value] of dependents)
-                    derived.install(value);
-            });
-        }
-        catch (error) {
-            this.options.report(error);
-        }
-    }
-    install(next) {
-        const before = this.#value;
-        this.#value = next;
-        const ops = before === undefined || next === undefined
-            ? [["r", (next ?? null)]]
-            : diffRevisions(before, next);
-        if (ops.length > 0)
-            this.fanout.emit({ type: "ops", ops, value: next });
-    }
-}
-export const isSource = (value) => value instanceof Source;
-/** Thrown by placeholders used before activation finished. */
-export const notReady = (what) => new ChordError("not_ready", `${what} is not ready`);
-//# sourceMappingURL=cell.js.map