@vmz/core 0.2.5 → 0.2.6

package/dist/browser/dom-core.d.ts

@@ -1,252 +1,54 @@
-/**
- * VMZ DOM client runtime ??precise patches, no VDOM diff (SSR lives in dom-ssr).
- *
- *
- * Direct components expose `__vmzCreate` / `__vmzSerialize` / `__vmzPlan`.
- * Mount and client patches run that same schedule (SSR/hydrate/resume in dom-ssr).
- * Field writes only run registered dep patches ??never re-create structure.
- */
-import type { BindingId, DirectInstance, PatchFn } from './direct-api.types.js';
-import type { ComponentCtor, EachCtx, ResumeAdoptCtx } from './dom-core.types.js';
+/** Browser DOM runtime barrel. */
 export { mergeClassParts, mergeStyleParts } from '../shared/dom-attr-normalize.js';
 export { applyDirectHostBox, INLINE_HOST_CONTENTS, resolveDirectHostBox } from './direct-host-box.js';
 export { createUnknownComponentElement, markUnknownComponentHost, serializeUnknownComponentNode, UNKNOWN_COMPONENT_ERROR, } from './unknown-component.js';
-export declare function __vmzPrecisionEnable(on?: boolean): void;
-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).
- */
-export declare function __vmzTraceSnapshot(): {
-    schema: string;
-    events: {
-        stableId: {
-            kind: string;
-            id: string;
-        };
-        kind: string;
-        dep?: string;
-        t?: number;
-        chunkId?: string | null;
-    }[];
-    status: string;
-};
-export declare function __vmzPrecisionSnapshot(): {
-    enabled: boolean;
-    writes: number;
-    bindingEvals: number;
-    patchExecs: number;
-    domCreates: number;
-    domMoves: number;
-    domRemoves: number;
-    componentExecs: number;
-    writesByRoot: {
-        [x: string]: number;
-    };
-    bindingEvalsByDep: {
-        [x: string]: number;
-    };
-    patchesByDep: {
-        [x: string]: number;
-    };
-    bindingEvalsByBinding: {
-        [x: string]: number;
-    };
-    patchesByBinding: {
-        [x: string]: number;
-    };
-};
-export declare function noteDomCreate(): void;
-export declare function registerComponents(map: any): void;
-export declare function getRegisteredComponent(name: any): ComponentCtor;
-/**
- * Lazy component loader for EventEntry mixed packs (set by entry-client / entry-event).
- */
-export declare function resolveComponent(name: any): Promise<ComponentCtor>;
-/**
- * Mount once; later updates are dep patches only (never re-run structure).
- * Requires compiler `__vmzCreate` (production Direct emit ??no blueprint fallback).
- */
-export declare function mount(Component: any, container: any, props?: any): Promise<any>;
-/**
- * Nested Direct `component` schedules child onMount asynchronously; drain before return
- * so SSR/hydrate callers see post-mount DOM (e.g. UserCard Ada, not Loading??.
- */
-export declare function settlePendingChildMounts(inst: any): Promise<void>;
-export declare function runDirectCreate(Component: any, inst: any): any;
-/**
- * First default `<slot>` owned by this component tree ??skip nested `[data-vmz]`
- * hosts (Button/Link/Empty label slots). `querySelector('slot')` steals those and
- * projects parent siblings into the wrong host (commercial Drawer into Create btn).
- */
-export declare function findOwnedDefaultSlot(root: any): any;
-/** Button/Link shell when `<slot>` is absent (SSR-flattened or resume adopt). */
-export declare function findOwnedDefaultSlotTarget(root: any): any;
-export declare const directApi: {
-    _inst: DirectInstance | null;
-    _branchBinds: Array<{
-        deps: string[];
-        fn: PatchFn;
-        bindingId?: BindingId;
-    }> | null;
-    _itemPatches: PatchFn[] | null;
-    _eachCtx: EachCtx | null;
-    _resumeAdopt: ResumeAdoptCtx | null;
-    el(tag: any): any;
-    elNS(ns: any, tag: any): Element;
-    text(value: any): Text;
-    adoptEnter(node: any): boolean;
-    adoptLeave(): void;
-    frag(): DocumentFragment;
-    comment(value: any): Comment;
-    insertBefore(parent: any, node: any, ref: any): void;
-    removeNode(node: any): void;
-    /**
-     * Register a generated per-binding patch (0.2.0). No generic get/cf interpreter.
-     */
-    trackPatch(inst: any, deps: any, patch: any, bindingId?: any): void;
-    untrackPatch(inst: any, deps: any, patch: any, bindingId?: any): void;
-    disposeTree(root: any): void;
-    attr(el: any, name: any, value: any): void;
-    mergeClass(...parts: any[]): string;
-    mergeStyle(...parts: any[]): string;
-    on(el: any, type: any, handler: any): void;
-    /**
-     * Bind a named instance method (no arrow / Function#toString).
-     * Learns `skipFlush` after a sync invocation that schedules no dirty work
-     * (stride / transpose self-apply DOM).
-     */
-    onMethod(el: any, type: any, methodName: any, opts: any): void;
-    /**
-     * Specialized single-field attr bind (0.1.29): compile-time field name, no generic get closure in artifact.
-     */
-    specFieldAttr(inst: any, bindingId: any, fieldName: any, el: any, name: any): void;
-    /**
-     * Specialized single-field text bind (0.1.29): compile-time field name in generated artifact.
-     */
-    specFieldText(inst: any, bindingId: any, fieldName: any, textNode: any): void;
-    setHtml(el: any, value: any): void;
-    bindHtml(inst: any, bindingId: any, deps: any, get: any, el: any): void;
-    /**
-     * Nested component (sync Direct child or island schedule).
-     */
-    component(hostInst: any, nameOrCtor: any, props: any, client: any): any;
-    /**
-     * Subscribe to a child component event (`@submit` ??event name `submit`).
-     * Orthogonal to function props (`:on-submit` ??prop `onSubmit`).
-     */
-    onComponentEvent(hostEl: any, eventName: any, handler: any): void;
-    /**
-     * Keep nested Direct child props live with parent field writes.
-     */
-    bindComponentProp(hostInst: any, hostEl: any, propName: any, deps: any, get: any): void;
-    /**
-     * Project parent children into nested Direct component default `<slot>`.
-     * Uses {@link findOwnedDefaultSlot} so nested Button/Link slots are not stolen.
-     */
-    projectDefaultSlot(hostEl: any, node: any): void;
-};
-/**
- * Function prop wire: only `onXxx` camelCase is a handler prop.
- * Component `@event` must never normalize here ??that channel is `onComponentEvent`.
- */
-export declare function eventPropHandlerName(name: any): string;
-/**
- * Dispatch a component event to parent subscribers registered via `onComponentEvent`.
- * Installed on every Direct instance as `inst.emit`.
- */
-export declare function emitComponentEvent(inst: any, eventName: any, ...payload: any[]): void;
-export declare function isEventPropName(name: any): boolean;
-export declare const BOOLEAN_HTML_ATTRS: Set<string>;
-export declare function applyDomAttr(el: any, name: any, value: any): void;
-export declare function stripFns(obj: any): {};
-/**
- * Snapshot plain state/prop field values for Island HMR (session).
- */
-export declare function snapshotInstanceState(inst: any): {};
-export declare function applyPreservedState(inst: any, state: any): void;
-/**
- * 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).
- */
-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).
- */
-export declare function disposeDomTree(root: any): void;
-export declare function scheduleClient(strategy: any, fn: any): void;
-export declare function isEventEntryStrategy(strategy: any): boolean;
-export declare function scheduleClientOn(el: any, 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.
- */
-export declare function __vmzRunTask(inst: any, key: any, fn: any): Promise<any>;
-export declare function __vmzCancelTasks(inst: any): void;
-export declare function __vmzTaskStatus(inst: any, key: any): any;
-export declare function createInstance(Component: any, props?: any): any;
-/**
- * Mark a plain object as intentionally shared across ownership boundaries.
- */
-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.
- */
-export declare function __vmzTakeShared(value: any): any;
-export declare function __vmzSharedCrossComponentDiagnostics(): any[];
-export declare function __vmzSharedCrossComponentDiagnosticsReset(): void;
-/**
- * Read a nested path under a field root (for compound / update expansion).
- */
-export declare function __vmzReadPath(inst: any, root: any, segs: any): any;
-/**
- * Short-circuit logical path assign (`||=` / `&&=` / `??=`).
- */
-export declare function __vmzWritePathLogical(inst: any, root: any, segs: any, kind: any, rhs: any): any;
-export declare function __vmzWritePath(inst: any, root: any, segs: any, value: any): any;
-/**
- * Array-item leaf write without segs array alloc (`rows[i].label = v`).
- */
-export declare function __vmzWritePathItem(inst: any, root: any, idx: any, leaf: any, value: any): any;
-/**
- * In-place two-index swap on an owned list field (WriteBarrier Slice 5).
- * Prefers eachBlock O(1) DOM transpose hook; otherwise schedules a list replace.
- */
-export declare function __vmzListTranspose(inst: any, root: any, ia: any, ib: any): void;
-/**
- * Compound leaf write (`rows[i].label += x`) ??one item touch, no separate ReadPath.
- */
-export declare function __vmzWritePathCompound(inst: any, root: any, segs: any, op: any, rhs: any): any;
-/**
- * Array-item compound without segs array alloc (`rows[i].label += x`).
- */
-export declare function __vmzWritePathCompoundItem(inst: any, root: any, idx: any, leaf: any, op: any, rhs: any): any;
-/**
- * Stride compound over an owned array (`for (i=start; i<n; i+=step) arr[i].leaf op= rhs`).
- * Mutates + applies DOM in one pass when eachBlock leaf hook is installed (update-every-Nth).
- */
-export declare function __vmzArrayItemCompoundStride(inst: any, root: any, leaf: any, op: any, rhs: any, start: any, step: any): void;
-/**
- * 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).
- *
- */
-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).
- */
-export declare function __vmzIsWriteBarrierOwned(value: any): boolean;
-/**
- * True when value is the Proxy wrapper from array (or residual) reactive wrap.
- */
-export declare function __vmzIsReactiveProxy(value: any): boolean;
-export declare function flushPending(inst: any): any;
-/**
- * True when the container already has meaningful DOM (SSR / resume shell).
- */
-export declare function hasMeaningfulChild(el: any): boolean;
+export { __vmzPrecisionEnable } from './diagnostics/precision-trace.js';
+export { __vmzTraceEnable } from './diagnostics/precision-trace.js';
+export { __vmzPrecisionReset } from './diagnostics/precision-trace.js';
+export { __vmzTraceReset } from './diagnostics/precision-trace.js';
+export { __vmzTraceSnapshot } from './diagnostics/precision-trace.js';
+export { __vmzPrecisionSnapshot } from './diagnostics/precision-trace.js';
+export { registerComponents } from './dom/registry.js';
+export { getRegisteredComponent } from './dom/registry.js';
+export { resolveComponent } from './dom/registry.js';
+export { mount } from './dom/component.js';
+export { settlePendingChildMounts } from './dom/component.js';
+export { runDirectCreate } from './dom/component.js';
+export { findOwnedDefaultSlot } from './dom/component.js';
+export { findOwnedDefaultSlotTarget } from './dom/component.js';
+export { createInstance } from './dom/component.js';
+export { destroy } from './dom/component.js';
+export { disposeDomTree } from './dom/component.js';
+export { snapshotInstanceState } from './dom/component.js';
+export { applyPreservedState } from './dom/component.js';
+export { stripFns } from './dom/component.js';
+export { BOOLEAN_HTML_ATTRS } from './dom/attributes.js';
+export { applyDomAttr } from './dom/attributes.js';
+export { eventPropHandlerName } from './dom/attributes.js';
+export { emitComponentEvent } from './dom/attributes.js';
+export { isEventPropName } from './dom/attributes.js';
+export { noteDomCreate } from './dom/lifecycle.js';
+export { scheduleClient } from './dom/lifecycle.js';
+export { isEventEntryStrategy } from './dom/lifecycle.js';
+export { scheduleClientOn } from './dom/lifecycle.js';
+export { __vmzRunTask } from './dom/lifecycle.js';
+export { __vmzCancelTasks } from './dom/lifecycle.js';
+export { __vmzTaskStatus } from './dom/lifecycle.js';
+export { directApi } from './dom/direct-api.js';
+export { __vmzAllowShared } from './reactivity/write-barrier.js';
+export { __vmzTakeShared } from './reactivity/write-barrier.js';
+export { __vmzSharedCrossComponentDiagnostics } from './reactivity/write-barrier.js';
+export { __vmzSharedCrossComponentDiagnosticsReset } from './reactivity/write-barrier.js';
+export { __vmzReadPath } from './reactivity/write-barrier.js';
+export { __vmzWritePathLogical } from './reactivity/write-barrier.js';
+export { __vmzWritePath } from './reactivity/write-barrier.js';
+export { __vmzWritePathItem } from './reactivity/write-barrier.js';
+export { __vmzListTranspose } from './reactivity/write-barrier.js';
+export { __vmzWritePathCompound } from './reactivity/write-barrier.js';
+export { __vmzWritePathCompoundItem } from './reactivity/write-barrier.js';
+export { __vmzArrayItemCompoundStride } from './reactivity/write-barrier.js';
+export { __vmzArrayMutate } from './reactivity/write-barrier.js';
+export { __vmzIsWriteBarrierOwned } from './reactivity/write-barrier.js';
+export { __vmzIsReactiveProxy } from './reactivity/write-barrier.js';
+export { flushPending } from './reactivity/patch-scheduler.js';
+export { hasMeaningfulChild } from './reactivity/patch-scheduler.js';