@vmz/core 0.0.4 → 0.1.0

package/dist/dom.client.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Browser / client-only DOM entry — tree-shakeable (no SSR serialize/hydrate).
+ */
+export * from './dom-core.js';

package/dist/dom.client.js

@@ -0,0 +1,5 @@
+// @ts-nocheck
+/**
+ * Browser / client-only DOM entry — tree-shakeable (no SSR serialize/hydrate).
+ */
+export * from './dom-core.js';

package/dist/dom.d.ts

@@ -1,222 +1,6 @@
 /**
  * VMZ DOM / SSR runtime — precise patches, no VDOM diff.
- *
- *
- * Direct components expose `__vmzCreate` / `__vmzSerialize` / `__vmzPlan`.
- * Mount, SSR, hydrate, and resume all run that same schedule.
- * Field writes only run registered dep patches — never re-create structure.
+ * Compat barrel for `@vmz/core/dom` (full client + SSR).
  */
-/** @param {boolean} [on] */
-export declare function __vmzPrecisionEnable(on?: boolean): void;
-/** @param {boolean} [on] */
-export declare function __vmzTraceEnable(on?: boolean): void;
-export declare function __vmzPrecisionReset(): void;
-export declare function __vmzTraceReset(): void;
-/**
- * StableId event snapshot (`vmz.dx.trace.v0` shape without schema stamp —
- * host may wrap via ingestRuntimeTrace).
- * @returns {{ schema: string, events: typeof traceBuf.events, status: string }}
- */
-export declare function __vmzTraceSnapshot(): {
-    schema: string;
-    events: any[];
-    status: string;
-};
-/** @returns {typeof precision} */
-export declare function __vmzPrecisionSnapshot(): {
-    enabled: boolean;
-    writes: number;
-    bindingEvals: number;
-    patchExecs: number;
-    domCreates: number;
-    domMoves: number;
-    domRemoves: number;
-    componentExecs: number;
-    writesByRoot: any;
-    bindingEvalsByDep: any;
-    patchesByDep: any;
-    bindingEvalsByBinding: any;
-    patchesByBinding: any;
-};
-/** @param {Record<string, any>} map */
-export declare function registerComponents(map: any): void;
-/**
- * @param {new (props?: object) => any} Component
- * @param {object} [props]
- */
-export declare function renderToString(Component: any, props?: {}, opts?: {}): Promise<any>;
-/**
- * Stream SSR via the same Direct serialize schedule as `renderToString`.
- * Yields HTML chunks (open tag → children → close). Joining chunks equals `renderToString`.
- * Supports AbortSignal for cancel; consumers should respect backpressure (await between chunks).
- * @param {new (props?: object) => any} Component
- * @param {object} [props]
- * @param {{ signal?: AbortSignal, slotHtml?: string }} [opts]
- * @returns {AsyncGenerator<string, void, void>}
- */
-export declare function renderToStream(Component: any, props?: {}, opts?: {}): AsyncGenerator<any, void, unknown>;
-/**
- * Live-DOM counterpart: first default `<slot>` owned by this tree, not by a nested
- * `[data-vmz]` component (Button/Link labels, etc.).
- * @param {Element | null | undefined} root
- * @returns {Element | null}
- */
-export declare function findOwnedDefaultSlot(root: any): any;
-/**
- * Hydrate/mount a file-route page inside an optional layout chain (outer → inner).
- * Mirrors SSR `slotHtml` wrapping: each layout's owned default slot becomes the
- * outlet for the next layout or the page. Retains layout instances on `container`
- * so SPA transitions can dispose only the page host.
- * @param {new (props?: object) => any} Page
- * @param {Element} container
- * @param {object} [props]
- * @param {Array<new (props?: object) => any>} [layoutCtors] outer → inner
- * @param {{ preserveState?: boolean | Record<string, unknown>, skipOnMount?: boolean }} [opts]
- */
-export declare function hydrateRoute(Page: any, container: any, props?: {}, layoutCtors?: any[], opts?: {}): Promise<any>;
-/**
- * Mount once; later updates are dep patches only (never re-run structure).
- * Requires compiler `__vmzCreate` (production Direct emit — no blueprint fallback).
- * @param {new (props?: object) => any} Component
- * @param {Element} container
- * @param {object} [props]
- */
-export declare function mount(Component: any, container: any, props?: {}): Promise<any>;
-/**
- * Snapshot plain state/prop field values for Island HMR (session).
- * @param {object} inst
- * @returns {Record<string, unknown> | null}
- */
-export declare function snapshotInstanceState(inst: any): {};
-/**
- * @param {object} inst
- * @param {Record<string, unknown> | null | undefined} state
- */
-export declare function applyPreservedState(inst: any, state: any): void;
-/**
- * resume: attach to existing Island DOM without re-running construct structure or onMount.
- * Consumes ResumeEntry product (`data-vmz-resume`) derived from the same Execution Plan.
- * @param {new (props?: object) => any} Component
- * @param {HTMLElement} container
- * @param {{ props?: object, state?: Record<string, unknown>, strategy?: string } | null} [slice]
- */
-export declare function resume(Component: any, container: any, slice?: any): Promise<any>;
-/**
- * Resume all `[data-vmz-island]` hosts (prefer ResumeEntry / EventEntry over mount).
- * Event strategy islands wait for the DOM event before attach (lazy EventEntry).
- * @param {ParentNode} [root]
- */
-export declare function resumeIslands(root?: Document): void;
-/**
- * EventEntry attach: only wire `client:event` / `client:event:*` islands.
- * Idle/load/visible ResumeEntries are left alone (static shell can defer framework work).
- * @param {ParentNode} [root]
- */
-export declare function attachEventEntries(root?: Document): void;
-/**
- * @param {new (props?: object) => any} Component
- * @param {HTMLElement} container
- * @param {object} [props]
- * @param {{ preserveState?: boolean | Record<string, unknown>, skipOnMount?: boolean }} [opts]
- */
-export declare function hydrate(Component: any, container: any, props?: {}, opts?: {}): Promise<any>;
-/**
- * Tear down binders and stop patches. Safe to call more than once.
- * Field writes after destroy no longer update DOM (values may still change).
- *: also dispose owned DOM trees (child __vmzInst / region __vmzDispose).
- * @param {object} inst
- */
-export declare function destroy(inst: any): void;
-/**
- *: walk a DOM subtree and run lifetime dispose hooks + nested instance destroy.
- * Does not mark the *calling* parent destroyed; safe from destroy(inst).
- * @param {Node | null | undefined} root
- */
-export declare function disposeDomTree(root: any): void;
-/**
- * @param {ParentNode} [root]
- */
-export declare function hydrateIslands(root?: Document): void;
-export declare function scheduleClient(strategy: any, fn: any): void;
-/**
- * AsyncTask cancel protocol (first slice): keyed generation + AbortSignal.
- * Superseded runs and `destroy(inst)` abort prior work; stale results must not apply.
- * @param {object} inst
- * @param {string} key
- * @param {(signal: AbortSignal, meta: { generation: number }) => any | Promise<any>} fn
- * @returns {Promise<any>}
- */
-export declare function __vmzRunTask(inst: any, key: any, fn: any): Promise<any>;
-/** Abort all keyed tasks on an instance (also called from destroy). */
-export declare function __vmzCancelTasks(inst: any): void;
-/** @returns {'pending'|'success'|'error'|'cancelled'|null} */
-export declare function __vmzTaskStatus(inst: any, key: any): any;
-/**
- * Mark a plain object as intentionally shared across ownership boundaries.
- * @param {any} value
- */
-export declare function __vmzAllowShared(value: any): any;
-/**
- * Take exclusive ownership intent: clear multi-owner registry for this object.
- * Subsequent field assigns re-register from the assigning instance only.
- * @param {any} value
- */
-export declare function __vmzTakeShared(value: any): any;
-/**
- * @returns {Array<{ kind: string, message: string }>}
- */
-export declare function __vmzSharedCrossComponentDiagnostics(): any[];
-export declare function __vmzSharedCrossComponentDiagnosticsReset(): void;
-/**
- * Read a nested path under a field root (for compound / update expansion).
- * @param {any} inst
- * @param {string} root
- * @param {string[]} segs
- */
-export declare function __vmzReadPath(inst: any, root: any, segs: any): any;
-/**
- * Short-circuit logical path assign (`||=` / `&&=` / `??=`).
- * @param {any} inst
- * @param {string} root
- * @param {string[]} segs
- * @param {'||'|'&&'|'??'} kind
- * @param {any} rhs
- */
-export declare function __vmzWritePathLogical(inst: any, root: any, segs: any, kind: any, rhs: any): any;
-/**
- * Mutates a plain owned object/array and schedules the same path notice Proxy would.
- *
- * Root-array index assigns (`tags[0] = x`) notify as field replace (structural),
- * matching the transitional Proxy wrapArray behavior.
- * Shared multi-owner: writing through one field notifies all owners of the same raw object.
- *
- * @param {any} inst
- * @param {string} root field root
- * @param {string[]} segs path under root (non-empty); dynamic indices already String(...)'d
- * @param {any} value
- */
-export declare function __vmzWritePath(inst: any, root: any, segs: any, value: any): any;
-/**
- * Compiler-inserted array mutator barrier (push/pop/splice/…).
- * Applies the mutator on the plain array and schedules a structural notice
- * at `root` + `baseSegs` (empty baseSegs → field replace).
- *
- * @param {any} inst
- * @param {string} root
- * @param {string[]} baseSegs
- * @param {string} method
- * @param {any[]} args
- */
-export declare function __vmzArrayMutate(inst: any, root: any, baseSegs: any, method: any, args: any): any;
-/**
- * WriteBarrier: true when value is an owned plain object with path barriers (no Proxy).
- * @param {any} value
- */
-export declare function __vmzIsWriteBarrierOwned(value: any): boolean;
-/**
- * True when value is the Proxy wrapper from array (or residual) reactive wrap.
- * @param {any} value
- */
-export declare function __vmzIsReactiveProxy(value: any): boolean;
-/** @param {object} inst */
-export declare function flushPending(inst: any): Promise<void>;
+export * from './dom-core.js';
+export * from './dom-ssr.js';