@takazudo/zfb 2.22.1 → 3.1.0

package/dist/zudo-react/props-transport.js

@@ -0,0 +1,95 @@
+const forbidden = new Set(["__proto__", "prototype", "constructor"]);
+function fail(code, path, detail = "") {
+    throw new TypeError(`${code} at ${path}${detail ? ` (${detail})` : ""}`);
+}
+function validate(value, path, ancestors) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            fail("ZR_PROPS_NUMBER", path);
+        return;
+    }
+    if (value === undefined)
+        fail("ZR_PROPS_UNDEFINED", path);
+    if (typeof value === "function" || typeof value === "symbol" || typeof value === "bigint")
+        fail(`ZR_PROPS_${typeof value}`.toUpperCase(), path);
+    if (typeof value !== "object")
+        fail("ZR_PROPS_VALUE", path);
+    const record = value;
+    if ("$$zudo" in record || "$$zudoReactive" in record)
+        fail("ZR_PROPS_RUNTIME_VALUE", path);
+    const ancestor = ancestors.get(record);
+    if (ancestor !== undefined)
+        fail("ZR_PROPS_CYCLE", path, `ancestor ${ancestor}`);
+    const array = Array.isArray(record);
+    if (!array &&
+        Object.getPrototypeOf(record) !== Object.prototype &&
+        Object.getPrototypeOf(record) !== null)
+        fail("ZR_PROPS_OBJECT_KIND", path);
+    ancestors.set(record, path);
+    try {
+        const descriptors = Object.getOwnPropertyDescriptors(record);
+        for (const key of Reflect.ownKeys(descriptors)) {
+            if (typeof key === "symbol")
+                fail("ZR_PROPS_PROPERTY", path, "symbol key");
+            if (array && key === "length")
+                continue;
+            const next = array ? `${path}[${key}]` : `${path}.${key}`;
+            if (forbidden.has(key))
+                fail("ZR_PROPS_KEY", next);
+            const descriptor = descriptors[key];
+            if (!descriptor || !descriptor.enumerable || !("value" in descriptor))
+                fail("ZR_PROPS_PROPERTY", next);
+            if (array && (!/^(0|[1-9]\d*)$/.test(key) || Number(key) >= record.length))
+                fail("ZR_PROPS_PROPERTY", next);
+            validate(descriptor.value, next, ancestors);
+        }
+        if (array) {
+            for (let index = 0; index < record.length; index++) {
+                if (!Object.hasOwn(record, index))
+                    fail("ZR_PROPS_UNDEFINED", `${path}[${index}]`);
+            }
+        }
+    }
+    finally {
+        ancestors.delete(record);
+    }
+}
+export function serializeProps(props) {
+    if (props === null || Array.isArray(props) || typeof props !== "object")
+        fail("ZR_PROPS_OBJECT_KIND", "props");
+    const descriptors = Object.getOwnPropertyDescriptors(props);
+    const child = descriptors.children;
+    if (child) {
+        if (!child.enumerable || !("value" in child))
+            fail("ZR_PROPS_PROPERTY", "props.children");
+        if (!emptyChildren(child.value))
+            fail("ZR_PROPS_CHILDREN", "props.children");
+        delete descriptors.children;
+    }
+    const payload = Object.defineProperties(Object.create(Object.getPrototypeOf(props)), descriptors);
+    validate(payload, "props", new Map());
+    return JSON.stringify(payload);
+}
+function emptyChildren(value) {
+    return (value == null ||
+        typeof value === "boolean" ||
+        (Array.isArray(value) && value.every(emptyChildren)));
+}
+export function parseProps(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        fail("ZR_PROPS_JSON", "props");
+    }
+    if (parsed === null || Array.isArray(parsed) || typeof parsed !== "object")
+        fail("ZR_PROPS_OBJECT_KIND", "props");
+    if (Object.hasOwn(parsed, "children"))
+        fail("ZR_PROPS_CHILDREN", "props.children");
+    validate(parsed, "props", new Map());
+    return parsed;
+}
+//# sourceMappingURL=props-transport.js.map

package/dist/zudo-react/props-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props-transport.js","sourceRoot":"","sources":["../../src/zudo-react/props-transport.ts"],"names":[],"mappings":"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","sourcesContent":["const forbidden = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\nfunction fail(code: string, path: string, detail = \"\"): never {\n  throw new TypeError(`${code} at ${path}${detail ? ` (${detail})` : \"\"}`);\n}\n\nfunction validate(value: unknown, path: string, ancestors: Map<object, string>): void {\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return;\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) fail(\"ZR_PROPS_NUMBER\", path);\n    return;\n  }\n  if (value === undefined) fail(\"ZR_PROPS_UNDEFINED\", path);\n  if (typeof value === \"function\" || typeof value === \"symbol\" || typeof value === \"bigint\")\n    fail(`ZR_PROPS_${typeof value}`.toUpperCase(), path);\n  if (typeof value !== \"object\") fail(\"ZR_PROPS_VALUE\", path);\n  const record = value as object;\n  if (\"$$zudo\" in record || \"$$zudoReactive\" in record) fail(\"ZR_PROPS_RUNTIME_VALUE\", path);\n  const ancestor = ancestors.get(record);\n  if (ancestor !== undefined) fail(\"ZR_PROPS_CYCLE\", path, `ancestor ${ancestor}`);\n  const array = Array.isArray(record);\n  if (\n    !array &&\n    Object.getPrototypeOf(record) !== Object.prototype &&\n    Object.getPrototypeOf(record) !== null\n  )\n    fail(\"ZR_PROPS_OBJECT_KIND\", path);\n  ancestors.set(record, path);\n  try {\n    const descriptors = Object.getOwnPropertyDescriptors(record);\n    for (const key of Reflect.ownKeys(descriptors)) {\n      if (typeof key === \"symbol\") fail(\"ZR_PROPS_PROPERTY\", path, \"symbol key\");\n      if (array && key === \"length\") continue;\n      const next = array ? `${path}[${key}]` : `${path}.${key}`;\n      if (forbidden.has(key)) fail(\"ZR_PROPS_KEY\", next);\n      const descriptor = descriptors[key];\n      if (!descriptor || !descriptor.enumerable || !(\"value\" in descriptor))\n        fail(\"ZR_PROPS_PROPERTY\", next);\n      if (array && (!/^(0|[1-9]\\d*)$/.test(key) || Number(key) >= record.length))\n        fail(\"ZR_PROPS_PROPERTY\", next);\n      validate(descriptor.value, next, ancestors);\n    }\n    if (array) {\n      for (let index = 0; index < record.length; index++) {\n        if (!Object.hasOwn(record, index)) fail(\"ZR_PROPS_UNDEFINED\", `${path}[${index}]`);\n      }\n    }\n  } finally {\n    ancestors.delete(record);\n  }\n}\n\nexport function serializeProps(props: Record<string, unknown>): string {\n  if (props === null || Array.isArray(props) || typeof props !== \"object\")\n    fail(\"ZR_PROPS_OBJECT_KIND\", \"props\");\n  const descriptors = Object.getOwnPropertyDescriptors(props);\n  const child = descriptors.children;\n  if (child) {\n    if (!child.enumerable || !(\"value\" in child)) fail(\"ZR_PROPS_PROPERTY\", \"props.children\");\n    if (!emptyChildren(child.value)) fail(\"ZR_PROPS_CHILDREN\", \"props.children\");\n    delete descriptors.children;\n  }\n  const payload = Object.defineProperties(Object.create(Object.getPrototypeOf(props)), descriptors);\n  validate(payload, \"props\", new Map());\n  return JSON.stringify(payload);\n}\n\nfunction emptyChildren(value: unknown): boolean {\n  return (\n    value == null ||\n    typeof value === \"boolean\" ||\n    (Array.isArray(value) && value.every(emptyChildren))\n  );\n}\n\nexport function parseProps(json: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch {\n    fail(\"ZR_PROPS_JSON\", \"props\");\n  }\n  if (parsed === null || Array.isArray(parsed) || typeof parsed !== \"object\")\n    fail(\"ZR_PROPS_OBJECT_KIND\", \"props\");\n  if (Object.hasOwn(parsed, \"children\")) fail(\"ZR_PROPS_CHILDREN\", \"props.children\");\n  validate(parsed, \"props\", new Map());\n  return parsed as Record<string, unknown>;\n}\n"]}

package/dist/zudo-react/reactive-types.d.ts

@@ -0,0 +1,8 @@
+export interface ReadonlySignal<T> {
+    readonly value: T;
+    readonly $$zudoReactive: "zudo-react.reactive.v1";
+}
+export interface Signal<T> extends ReadonlySignal<T> {
+    value: T;
+    readonly $$zudoWritable: "zudo-react.writable.v1";
+}

package/dist/zudo-react/reactive-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reactive-types.js.map

package/dist/zudo-react/reactive-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-types.js","sourceRoot":"","sources":["../../src/zudo-react/reactive-types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ReadonlySignal<T> {\n  readonly value: T;\n  readonly $$zudoReactive: \"zudo-react.reactive.v1\";\n}\n\nexport interface Signal<T> extends ReadonlySignal<T> {\n  value: T;\n  readonly $$zudoWritable: \"zudo-react.writable.v1\";\n}\n"]}

package/dist/zudo-react/reactive.d.ts

@@ -0,0 +1,20 @@
+import { type Job, type Phase } from "./scheduler.js";
+import type { ReadonlySignal, Signal } from "./reactive-types.js";
+declare function untracked<T>(fn: () => T): T;
+export { untracked };
+export declare function signal<T>(initial: T): Signal<T>;
+export declare function computed<T>(read: () => T): ReadonlySignal<T>;
+export declare function readSnapshot<T>(value: ReadonlySignal<T>): T;
+export interface Subscription {
+    readonly id: string;
+    run(): void;
+    dispose(): void;
+}
+export declare function subscribe(callback: () => void, options?: {
+    phase?: Phase;
+    id?: string;
+    active?: () => boolean;
+    report?: Job["report"];
+}): Subscription;
+/** Internal test introspection; absent from every public entry. */
+export declare function subscriberCount(value: ReadonlySignal<unknown>): number;

package/dist/zudo-react/reactive.js

@@ -0,0 +1,176 @@
+import { enqueue } from "./scheduler.js";
+let currentObserver = null;
+let evaluating = 0;
+const evaluationStack = [];
+let nextId = 0;
+// The quoted own key is the retained runtime definition witness.
+const core = { "@takazudo/zfb/zudo-react/runtime-definition-v1": true, nextId: () => ++nextId };
+function track(source) {
+    if (!currentObserver)
+        return;
+    source.subscribers.add(currentObserver);
+    currentObserver.dependencies.add(source);
+}
+function detach(observer) {
+    for (const source of observer.dependencies)
+        source.subscribers.delete(observer);
+    observer.dependencies.clear();
+}
+function untracked(fn) {
+    const previous = currentObserver;
+    currentObserver = null;
+    try {
+        return fn();
+    }
+    finally {
+        currentObserver = previous;
+    }
+}
+export { untracked };
+class Writable {
+    current;
+    $$zudoReactive = "zudo-react.reactive.v1";
+    $$zudoWritable = "zudo-react.writable.v1";
+    subscribers = new Set();
+    constructor(current) {
+        this.current = current;
+        if (!core["@takazudo/zfb/zudo-react/runtime-definition-v1"])
+            throw new Error("ZR_RUNTIME_DEFINITION");
+    }
+    get value() {
+        track(this);
+        return this.current;
+    }
+    set value(value) {
+        if (evaluating > 0)
+            throw new Error("ZR_COMPUTED_WRITE: write during computed evaluation");
+        if (Object.is(value, this.current))
+            return;
+        this.current = value;
+        for (const observer of [...this.subscribers])
+            observer.invalidate();
+    }
+}
+class Computed {
+    read;
+    $$zudoReactive = "zudo-react.reactive.v1";
+    id = `computed:${core.nextId()}`;
+    subscribers = new Set();
+    dependencies = new Set();
+    cached;
+    dirty = true;
+    evaluatingNow = false;
+    constructor(read) {
+        this.read = read;
+    }
+    get value() {
+        if (this.evaluatingNow) {
+            throw new Error(`ZR_COMPUTED_CYCLE: ${[...evaluationStack.map((entry) => entry.id), this.id].join(" -> ")}`);
+        }
+        if (this.dirty)
+            this.evaluate();
+        track(this);
+        if (this.subscribers.size === 0) {
+            detachAndRelease(this);
+            this.dirty = true;
+        }
+        return this.cached;
+    }
+    evaluate() {
+        detachAndRelease(this);
+        const previous = currentObserver;
+        currentObserver = this;
+        this.evaluatingNow = true;
+        evaluationStack.push(this);
+        evaluating++;
+        try {
+            this.cached = this.read();
+            this.dirty = false;
+        }
+        catch (error) {
+            detachAndRelease(this);
+            throw error;
+        }
+        finally {
+            evaluating--;
+            evaluationStack.pop();
+            this.evaluatingNow = false;
+            currentObserver = previous;
+        }
+    }
+    invalidate() {
+        if (this.dirty)
+            return;
+        this.dirty = true;
+        for (const observer of [...this.subscribers])
+            observer.invalidate();
+    }
+    release() {
+        if (this.subscribers.size === 0) {
+            detachAndRelease(this);
+            this.dirty = true;
+        }
+    }
+}
+function release(source) {
+    if (source instanceof Computed)
+        source.release();
+}
+function detachAndRelease(observer) {
+    const sources = [...observer.dependencies];
+    detach(observer);
+    for (const source of sources)
+        release(source);
+}
+export function signal(initial) {
+    return new Writable(initial);
+}
+export function computed(read) {
+    return new Computed(read);
+}
+export function readSnapshot(value) {
+    return untracked(() => value.value);
+}
+export function subscribe(callback, options = {}) {
+    let disposed = false;
+    const observer = {
+        id: options.id ?? `subscriber:${core.nextId()}`,
+        dependencies: new Set(),
+        invalidate() {
+            enqueue(job);
+        },
+    };
+    const job = {
+        id: observer.id,
+        phase: options.phase ?? "commit",
+        active: () => !disposed && (options.active?.() ?? true),
+        run: () => subscription.run(),
+        ...(options.report ? { report: options.report } : {}),
+    };
+    const subscription = {
+        id: observer.id,
+        run() {
+            if (!job.active())
+                return;
+            detachAndRelease(observer);
+            const previous = currentObserver;
+            currentObserver = observer;
+            try {
+                callback();
+            }
+            finally {
+                currentObserver = previous;
+            }
+        },
+        dispose() {
+            disposed = true;
+            detachAndRelease(observer);
+        },
+    };
+    return subscription;
+}
+/** Internal test introspection; absent from every public entry. */
+export function subscriberCount(value) {
+    return value instanceof Writable || value instanceof Computed ? value.subscribers.size : 0;
+}
+//# sourceMappingURL=reactive.js.map

package/dist/zudo-react/reactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../src/zudo-react/reactive.ts"],"names":[],"mappings":"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","sourcesContent":["import { enqueue, type Job, type Phase } from \"./scheduler.js\";\nimport type { ReadonlySignal, Signal } from \"./reactive-types.js\";\n\ninterface Source {\n  readonly subscribers: Set<Observer>;\n}\ninterface Observer {\n  readonly id: string;\n  readonly dependencies: Set<Source>;\n  invalidate(): void;\n}\nlet currentObserver: Observer | null = null;\nlet evaluating = 0;\nconst evaluationStack: Computed<unknown>[] = [];\nlet nextId = 0;\n\n// The quoted own key is the retained runtime definition witness.\nconst core = { \"@takazudo/zfb/zudo-react/runtime-definition-v1\": true, nextId: () => ++nextId };\n\nfunction track(source: Source): void {\n  if (!currentObserver) return;\n  source.subscribers.add(currentObserver);\n  currentObserver.dependencies.add(source);\n}\nfunction detach(observer: Observer): void {\n  for (const source of observer.dependencies) source.subscribers.delete(observer);\n  observer.dependencies.clear();\n}\nfunction untracked<T>(fn: () => T): T {\n  const previous = currentObserver;\n  currentObserver = null;\n  try {\n    return fn();\n  } finally {\n    currentObserver = previous;\n  }\n}\nexport { untracked };\n\nclass Writable<T> implements Signal<T>, Source {\n  readonly $$zudoReactive = \"zudo-react.reactive.v1\" as const;\n  readonly $$zudoWritable = \"zudo-react.writable.v1\" as const;\n  readonly subscribers = new Set<Observer>();\n  constructor(private current: T) {\n    if (!core[\"@takazudo/zfb/zudo-react/runtime-definition-v1\"])\n      throw new Error(\"ZR_RUNTIME_DEFINITION\");\n  }\n  get value(): T {\n    track(this);\n    return this.current;\n  }\n  set value(value: T) {\n    if (evaluating > 0) throw new Error(\"ZR_COMPUTED_WRITE: write during computed evaluation\");\n    if (Object.is(value, this.current)) return;\n    this.current = value;\n    for (const observer of [...this.subscribers]) observer.invalidate();\n  }\n}\n\nclass Computed<T> implements ReadonlySignal<T>, Source, Observer {\n  readonly $$zudoReactive = \"zudo-react.reactive.v1\" as const;\n  readonly id = `computed:${core.nextId()}`;\n  readonly subscribers = new Set<Observer>();\n  readonly dependencies = new Set<Source>();\n  private cached!: T;\n  private dirty = true;\n  private evaluatingNow = false;\n  constructor(private readonly read: () => T) {}\n  get value(): T {\n    if (this.evaluatingNow) {\n      throw new Error(\n        `ZR_COMPUTED_CYCLE: ${[...evaluationStack.map((entry) => entry.id), this.id].join(\" -> \")}`,\n      );\n    }\n    if (this.dirty) this.evaluate();\n    track(this);\n    if (this.subscribers.size === 0) {\n      detachAndRelease(this);\n      this.dirty = true;\n    }\n    return this.cached;\n  }\n  private evaluate(): void {\n    detachAndRelease(this);\n    const previous = currentObserver;\n    currentObserver = this;\n    this.evaluatingNow = true;\n    evaluationStack.push(this as Computed<unknown>);\n    evaluating++;\n    try {\n      this.cached = this.read();\n      this.dirty = false;\n    } catch (error) {\n      detachAndRelease(this);\n      throw error;\n    } finally {\n      evaluating--;\n      evaluationStack.pop();\n      this.evaluatingNow = false;\n      currentObserver = previous;\n    }\n  }\n  invalidate(): void {\n    if (this.dirty) return;\n    this.dirty = true;\n    for (const observer of [...this.subscribers]) observer.invalidate();\n  }\n  release(): void {\n    if (this.subscribers.size === 0) {\n      detachAndRelease(this);\n      this.dirty = true;\n    }\n  }\n}\n\nfunction release(source: Source): void {\n  if (source instanceof Computed) source.release();\n}\nfunction detachAndRelease(observer: Observer): void {\n  const sources = [...observer.dependencies];\n  detach(observer);\n  for (const source of sources) release(source);\n}\n\nexport function signal<T>(initial: T): Signal<T> {\n  return new Writable(initial);\n}\nexport function computed<T>(read: () => T): ReadonlySignal<T> {\n  return new Computed(read);\n}\nexport function readSnapshot<T>(value: ReadonlySignal<T>): T {\n  return untracked(() => value.value);\n}\n\nexport interface Subscription {\n  readonly id: string;\n  run(): void;\n  dispose(): void;\n}\nexport function subscribe(\n  callback: () => void,\n  options: { phase?: Phase; id?: string; active?: () => boolean; report?: Job[\"report\"] } = {},\n): Subscription {\n  let disposed = false;\n  const observer: Observer = {\n    id: options.id ?? `subscriber:${core.nextId()}`,\n    dependencies: new Set(),\n    invalidate() {\n      enqueue(job);\n    },\n  };\n  const job: Job = {\n    id: observer.id,\n    phase: options.phase ?? \"commit\",\n    active: () => !disposed && (options.active?.() ?? true),\n    run: () => subscription.run(),\n    ...(options.report ? { report: options.report } : {}),\n  };\n  const subscription: Subscription = {\n    id: observer.id,\n    run() {\n      if (!job.active()) return;\n      detachAndRelease(observer);\n      const previous = currentObserver;\n      currentObserver = observer;\n      try {\n        callback();\n      } finally {\n        currentObserver = previous;\n      }\n    },\n    dispose() {\n      disposed = true;\n      detachAndRelease(observer);\n    },\n  };\n  return subscription;\n}\n\n/** Internal test introspection; absent from every public entry. */\nexport function subscriberCount(value: ReadonlySignal<unknown>): number {\n  return value instanceof Writable || value instanceof Computed ? value.subscribers.size : 0;\n}\n"]}

package/dist/zudo-react/render-html.d.ts

@@ -0,0 +1,3 @@
+import { type Child } from "./description.js";
+import type { RenderOptions } from "./server.js";
+export declare function renderHtml(node: Child, options: RenderOptions): string;