@lark.js/mvc 0.0.10 → 0.0.12

package/dist/index.d.cts

@@ -121,6 +121,34 @@ declare class EventEmitter<T = unknown> implements EventEmitterInterface<T> {
     fire(event: string, data?: Record<string, unknown>, remove?: boolean, lastToFirst?: boolean): this;
 }
 
+/**
+ * Minimal HMR context interface.
+ * Compatible with Vite's `import.meta.hot` and webpack's `module.hot`.
+ * Defined here to avoid depending on bundler-specific type packages.
+ */
+interface HotContext {
+    /** Accept a self-update. The callback receives the new module namespace. */
+    accept(cb?: (mod: {
+        default?: unknown;
+    } | undefined) => void): void;
+    /** Register a cleanup callback that runs before this module is replaced. */
+    dispose(cb: (data: unknown) => void): void;
+    /** Force a full page reload (fallback when HMR cannot handle the update). */
+    invalidate(): void;
+}
+/**
+ * Find all currently mounted frames whose viewPath matches the given path,
+ * and re-mount them.
+ *
+ * After a new View class is registered via `registerViewClass`, calling this
+ * function triggers `frame.mountView()` on each matching frame. Since the new
+ * class is already in the registry, `Frame.mountView` takes the synchronous
+ * path (`getViewClass` returns the class immediately).
+ *
+ * @param viewPath - The view path to match (e.g. 'home', 'components/list')
+ */
+declare function reloadViews(viewPath: string): void;
+
 /**
  * Base View class.
  * Views are created via View.extend() and mounted by Frame.
@@ -274,6 +302,37 @@ declare class View implements ViewInterface {
      * Merge mixins into View prototype.
      */
     static merge(this: typeof View, ...mixins: Record<string, unknown>[]): typeof View;
+    /**
+     * Set up HMR accept handler for this view module.
+     *
+     * When the module is hot-replaced, the new View class is extracted from
+     * the new module, registered in the view registry, and all currently
+     * mounted frames using this viewPath are re-mounted.
+     *
+     * No-op when `hot` is undefined (production / non-HMR environment).
+     *
+     * ```ts
+     * if (import.meta.hot) {
+     *   HomeView.accept(import.meta.hot, 'home');
+     * }
+     * ```
+     */
+    static accept(hot: HotContext | undefined, viewPath: string): void;
+    /**
+     * Set up HMR dispose handler for this view module.
+     *
+     * When the module is about to be replaced, the old View class is removed
+     * from the registry so subsequent lookups don't return the stale class.
+     *
+     * No-op when `hot` is undefined (production / non-HMR environment).
+     *
+     * ```ts
+     * if (import.meta.hot) {
+     *   HomeView.dispose(import.meta.hot, 'home');
+     * }
+     * ```
+     */
+    static dispose(hot: HotContext | undefined, viewPath: string): void;
 }
 /**
  * Type-safe wrapper around `View.extend()`.
@@ -665,6 +724,68 @@ interface DomRef {
  * Comment), so the child slots are typed as ChildNode.
  */
 type DomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
+/**
+ * Virtual DOM node. Produced by `vdomCreate`, consumed by the VDOM diff engine.
+ *
+ * Property semantics:
+ * - Text nodes: tag = 0 (V_TEXT_NODE), html = text content
+ * - Element nodes: tag = string, attrs = serialized opening tag, children = child VDomNodes
+ * - Raw HTML nodes: tag = SPLITTER (\x1e), html = raw HTML string
+ * - Self-closing: selfClose = true (children param was 1)
+ */
+interface VDomNode {
+    /** Tag name for elements, 0 (V_TEXT_NODE) for text, SPLITTER for raw HTML */
+    tag: string | number;
+    /** Inner HTML (serialized children for elements, text content for text nodes) */
+    html: string;
+    /** Serialized opening tag with attributes, e.g. '<div class="row"' */
+    attrs?: string;
+    /** Attribute key-value map */
+    attrsMap?: Record<string, unknown>;
+    /** Attribute names that are set as DOM properties (not attributes) */
+    attrsSpecials?: Record<string, string>;
+    /** Original specials argument before defaulting (for change detection) */
+    hasSpecials?: Record<string, string> | undefined;
+    /** Child VDomNode array (undefined for text/raw/self-closing) */
+    children?: VDomNode[] | undefined;
+    /** Diff key: from id, #, or v-lark path */
+    compareKey?: string | undefined;
+    /** Keyed children count map (compareKey -> count) */
+    reused?: Record<string, number> | undefined;
+    /** Total count of keyed children */
+    reusedTotal?: number;
+    /** Sub-view references: [viewPath, owner, uri, params] tuples */
+    views?: [string, string, string, Record<string, string>][] | undefined;
+    /** Whether self-closing (children param was literal 1) */
+    selfClose?: boolean;
+    /** Sub-view path if this node hosts a v-lark view, otherwise falsy */
+    isLarkView?: string | undefined;
+}
+/**
+ * VDOM diff operation tracker. Parallel to DomRef but for the VDOM pipeline.
+ */
+interface VDomRef {
+    /** View ID (for placeholder replacement) */
+    viewId: string;
+    /** Sub-views that need re-rendering after diff */
+    viewRenders: ViewInterface[];
+    /** Deferred DOM property assignments: [element, propName, value][] */
+    nodeProps: [Element, string, unknown][];
+    /** Pending async operation count */
+    asyncCount: number;
+    /** Whether the DOM actually changed */
+    changed: number;
+    /** DOM mutation operations (same format as DomOp) */
+    domOps: DomOp[];
+}
+/** VDOM node creation function signature (vdomCreate) */
+type VDomCreateFn = (tag: string | number, props?: Record<string, unknown> | number | null, children?: VDomNode[] | number | null, specials?: Record<string, string>) => VDomNode;
+/**
+ * VDOM template function signature.
+ * The compiled template imports vdomCreate via ES module import and
+ * takes only (data, viewId, refData). Extra arguments are ignored.
+ */
+type VDomTemplate = (data: unknown, viewId: string, refData: unknown) => VDomNode;
 interface FrameInvokeEntry {
     /** Method name */
     name: string;
@@ -858,7 +979,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
      * View template function. Receives data + viewId + refData and a set of
      * encoder helpers wired in by the Updater, and returns the rendered HTML.
      */
-    template?: ViewTemplate;
+    template?: ViewTemplate | VDomTemplate;
     /**
      * Mixin object array for extending view functionality.
      * Framework merges properties and methods from mixins into view prototype.
@@ -879,6 +1000,8 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     globalEventList: ViewGlobalEventEntry[];
     /** Whether endUpdate has been called (1 = pending) */
     endUpdatePending?: number;
+    /** Last rendered VDOM tree (only used when virtualDom is enabled) */
+    vdom?: VDomNode;
     /** Render method (wrapped) */
     render(): void;
     /**
@@ -1602,7 +1725,7 @@ interface FrameworkConfig {
      */
     crossConfigs?: CrossSiteConfig[];
     /** Default false. */
-    virtualDOM?: boolean;
+    virtualDom?: boolean;
     /** Dynamic config access, custom config items */
     [key: string]: unknown;
 }
@@ -1659,6 +1782,10 @@ interface CompileOptions {
     globalVars?: string[];
     /** File path for debug error messages (default: undefined) */
     file?: string;
+    /** Generate VDOM output instead of HTML string (default: false) */
+    virtualDom?: boolean;
+    /** Use SWC instead of Babel for parsing (default: false) */
+    useSwc?: boolean;
 }
 
 /**
@@ -1828,6 +1955,8 @@ declare class Updater implements UpdaterInterface {
     private version;
     /** Snapshot of `version` taken by `snapshot()`, used by `altered()`. */
     private snapshotVersion;
+    /** Last rendered VDOM tree (only used when virtualDom is enabled) */
+    private vdom?;
     constructor(viewId: string);
     /**
      * Get data by key.
@@ -1890,6 +2019,21 @@ declare class Updater implements UpdaterInterface {
     getChangedKeys(): ReadonlySet<string>;
 }
 
+/**
+ * Create a virtual DOM node.
+ *
+ * Text node: `vdomCreate(0, 'text content')`
+ * Element: `vdomCreate('div', { class: 'row' }, [child1, child2])`
+ * Self-closing: `vdomCreate('br', null, 1)`
+ * Raw HTML: `vdomCreate(0, '<b>bold</b>', 1)` (children truthy → raw HTML node)
+ * Root: `vdomCreate(viewId, 0, [children])`
+ */
+declare function vdomCreate(tag: string | number, props?: Record<string, unknown> | string | number | null, children?: VDomNode[] | string | number | null, specials?: Record<string, string>): VDomNode;
+/**
+ * Create an empty VDomRef for tracking diff operations.
+ */
+declare function createVDomRef(viewId: string): VDomRef;
+
 /**
  * Payload wraps API response data with convenient access methods.
  */
@@ -2186,86 +2330,4 @@ declare function create<T>(name: string, creator: StateCreator<T>): StoreApi<T>;
  */
 declare function bindStore<T>(view: unknown, store: StoreApi<T>, selector?: (state: T) => Record<string, unknown>): () => void;
 
-/** Serialized view info attached to a frame node */
-interface SerializedViewInfo {
-    /** View ID (same as frame ID) */
-    id: string;
-    /** Whether the view has rendered at least once */
-    rendered: boolean;
-    /** View signature (> 0 = active) */
-    signature: number;
-    /** Observed state keys */
-    observedStateKeys: string[] | null;
-    /** Location observation config */
-    locationObserved: {
-        flag: number;
-        keys: string[];
-        observePath: boolean;
-    };
-    /** Whether view has a template function */
-    hasTemplate: boolean;
-    /** Delegated event types (keys from $evtObjMap) */
-    eventMethodKeys: string[];
-    /** Captured resource keys */
-    resourceKeys: string[];
-    /** Whether view exposes an assign method (supports CrossSite reuse) */
-    hasAssign: boolean;
-    /** Updater refData snapshot (shallow copy of current data) */
-    updaterData: Record<string, unknown> | null;
-}
-/** A single node in the serialized frame tree */
-interface SerializedFrameNode {
-    /** Frame ID (same as owner DOM element ID) */
-    id: string;
-    /** Parent frame ID (null for root) */
-    parentId: string | null;
-    /** View path (v-lark attribute value) */
-    viewPath: string | null;
-    /** Number of child frames */
-    childrenCount: number;
-    /** Number of children that have fired 'created' */
-    readyCount: number;
-    /** Whether children have been created */
-    childrenCreated: number;
-    /** Whether children are in alter state */
-    childrenAlter: number;
-    /** Whether this frame is destroyed */
-    destroyed: number;
-    /** Serialized view info (null if no view mounted) */
-    view: SerializedViewInfo | null;
-    /** Child frame nodes */
-    children: SerializedFrameNode[];
-}
-/** Top-level serialized frame tree */
-interface SerializedFrameTree {
-    /** Root frame node */
-    root: SerializedFrameNode | null;
-    /** Total frame count */
-    totalFrames: number;
-    /** Timestamp of serialization */
-    timestamp: number;
-    /** Root element ID */
-    rootId: string;
-}
-declare const FrameVisualBridge: {
-    MSG_PING: string;
-    MSG_PONG: string;
-    MSG_REQUEST_TREE: string;
-    MSG_TREE: string;
-    MSG_TREE_DELTA: string;
-};
-/**
- * Serialize the entire Frame tree starting from root.
- * Returns an empty snapshot if the app hasn't booted yet.
- */
-declare function serializeFrameTree(): SerializedFrameTree;
-/**
- * Install the Frame Visualizer Bridge.
- * Listens for postMessage events from the visualizer and responds
- * with serialized frame tree data.
- *
- * This should be called once during Framework.boot().
- */
-declare function installFrameVisualizerBridge(): void;
-
-export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEvent, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyStyle, bindStore, computed, create, defineView, config as frameworkConfig, getRouteMode, installFrameVisualizerBridge, invalidateViewClass, mark, markBooted, markRouterBooted, nextCounter, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, unmark, use, useUrlState };
+export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, Framework, type FrameworkConfig, type FrameworkInterface, type HotContext, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, Service, type ServiceCacheInfo, type ServiceEvent, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, type VDomCreateFn, type VDomNode, type VDomRef, type VDomTemplate, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyStyle, bindStore, computed, create, createVDomRef, defineView, config as frameworkConfig, getRouteMode, invalidateViewClass, mark, markBooted, markRouterBooted, nextCounter, registerViewClass, reloadViews, resetProjectsMap, safeguard, unmark, use, useUrlState, vdomCreate };

package/dist/index.d.ts

@@ -121,6 +121,34 @@ declare class EventEmitter<T = unknown> implements EventEmitterInterface<T> {
     fire(event: string, data?: Record<string, unknown>, remove?: boolean, lastToFirst?: boolean): this;
 }
 
+/**
+ * Minimal HMR context interface.
+ * Compatible with Vite's `import.meta.hot` and webpack's `module.hot`.
+ * Defined here to avoid depending on bundler-specific type packages.
+ */
+interface HotContext {
+    /** Accept a self-update. The callback receives the new module namespace. */
+    accept(cb?: (mod: {
+        default?: unknown;
+    } | undefined) => void): void;
+    /** Register a cleanup callback that runs before this module is replaced. */
+    dispose(cb: (data: unknown) => void): void;
+    /** Force a full page reload (fallback when HMR cannot handle the update). */
+    invalidate(): void;
+}
+/**
+ * Find all currently mounted frames whose viewPath matches the given path,
+ * and re-mount them.
+ *
+ * After a new View class is registered via `registerViewClass`, calling this
+ * function triggers `frame.mountView()` on each matching frame. Since the new
+ * class is already in the registry, `Frame.mountView` takes the synchronous
+ * path (`getViewClass` returns the class immediately).
+ *
+ * @param viewPath - The view path to match (e.g. 'home', 'components/list')
+ */
+declare function reloadViews(viewPath: string): void;
+
 /**
  * Base View class.
  * Views are created via View.extend() and mounted by Frame.
@@ -274,6 +302,37 @@ declare class View implements ViewInterface {
      * Merge mixins into View prototype.
      */
     static merge(this: typeof View, ...mixins: Record<string, unknown>[]): typeof View;
+    /**
+     * Set up HMR accept handler for this view module.
+     *
+     * When the module is hot-replaced, the new View class is extracted from
+     * the new module, registered in the view registry, and all currently
+     * mounted frames using this viewPath are re-mounted.
+     *
+     * No-op when `hot` is undefined (production / non-HMR environment).
+     *
+     * ```ts
+     * if (import.meta.hot) {
+     *   HomeView.accept(import.meta.hot, 'home');
+     * }
+     * ```
+     */
+    static accept(hot: HotContext | undefined, viewPath: string): void;
+    /**
+     * Set up HMR dispose handler for this view module.
+     *
+     * When the module is about to be replaced, the old View class is removed
+     * from the registry so subsequent lookups don't return the stale class.
+     *
+     * No-op when `hot` is undefined (production / non-HMR environment).
+     *
+     * ```ts
+     * if (import.meta.hot) {
+     *   HomeView.dispose(import.meta.hot, 'home');
+     * }
+     * ```
+     */
+    static dispose(hot: HotContext | undefined, viewPath: string): void;
 }
 /**
  * Type-safe wrapper around `View.extend()`.
@@ -665,6 +724,68 @@ interface DomRef {
  * Comment), so the child slots are typed as ChildNode.
  */
 type DomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
+/**
+ * Virtual DOM node. Produced by `vdomCreate`, consumed by the VDOM diff engine.
+ *
+ * Property semantics:
+ * - Text nodes: tag = 0 (V_TEXT_NODE), html = text content
+ * - Element nodes: tag = string, attrs = serialized opening tag, children = child VDomNodes
+ * - Raw HTML nodes: tag = SPLITTER (\x1e), html = raw HTML string
+ * - Self-closing: selfClose = true (children param was 1)
+ */
+interface VDomNode {
+    /** Tag name for elements, 0 (V_TEXT_NODE) for text, SPLITTER for raw HTML */
+    tag: string | number;
+    /** Inner HTML (serialized children for elements, text content for text nodes) */
+    html: string;
+    /** Serialized opening tag with attributes, e.g. '<div class="row"' */
+    attrs?: string;
+    /** Attribute key-value map */
+    attrsMap?: Record<string, unknown>;
+    /** Attribute names that are set as DOM properties (not attributes) */
+    attrsSpecials?: Record<string, string>;
+    /** Original specials argument before defaulting (for change detection) */
+    hasSpecials?: Record<string, string> | undefined;
+    /** Child VDomNode array (undefined for text/raw/self-closing) */
+    children?: VDomNode[] | undefined;
+    /** Diff key: from id, #, or v-lark path */
+    compareKey?: string | undefined;
+    /** Keyed children count map (compareKey -> count) */
+    reused?: Record<string, number> | undefined;
+    /** Total count of keyed children */
+    reusedTotal?: number;
+    /** Sub-view references: [viewPath, owner, uri, params] tuples */
+    views?: [string, string, string, Record<string, string>][] | undefined;
+    /** Whether self-closing (children param was literal 1) */
+    selfClose?: boolean;
+    /** Sub-view path if this node hosts a v-lark view, otherwise falsy */
+    isLarkView?: string | undefined;
+}
+/**
+ * VDOM diff operation tracker. Parallel to DomRef but for the VDOM pipeline.
+ */
+interface VDomRef {
+    /** View ID (for placeholder replacement) */
+    viewId: string;
+    /** Sub-views that need re-rendering after diff */
+    viewRenders: ViewInterface[];
+    /** Deferred DOM property assignments: [element, propName, value][] */
+    nodeProps: [Element, string, unknown][];
+    /** Pending async operation count */
+    asyncCount: number;
+    /** Whether the DOM actually changed */
+    changed: number;
+    /** DOM mutation operations (same format as DomOp) */
+    domOps: DomOp[];
+}
+/** VDOM node creation function signature (vdomCreate) */
+type VDomCreateFn = (tag: string | number, props?: Record<string, unknown> | number | null, children?: VDomNode[] | number | null, specials?: Record<string, string>) => VDomNode;
+/**
+ * VDOM template function signature.
+ * The compiled template imports vdomCreate via ES module import and
+ * takes only (data, viewId, refData). Extra arguments are ignored.
+ */
+type VDomTemplate = (data: unknown, viewId: string, refData: unknown) => VDomNode;
 interface FrameInvokeEntry {
     /** Method name */
     name: string;
@@ -858,7 +979,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
      * View template function. Receives data + viewId + refData and a set of
      * encoder helpers wired in by the Updater, and returns the rendered HTML.
      */
-    template?: ViewTemplate;
+    template?: ViewTemplate | VDomTemplate;
     /**
      * Mixin object array for extending view functionality.
      * Framework merges properties and methods from mixins into view prototype.
@@ -879,6 +1000,8 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     globalEventList: ViewGlobalEventEntry[];
     /** Whether endUpdate has been called (1 = pending) */
     endUpdatePending?: number;
+    /** Last rendered VDOM tree (only used when virtualDom is enabled) */
+    vdom?: VDomNode;
     /** Render method (wrapped) */
     render(): void;
     /**
@@ -1602,7 +1725,7 @@ interface FrameworkConfig {
      */
     crossConfigs?: CrossSiteConfig[];
     /** Default false. */
-    virtualDOM?: boolean;
+    virtualDom?: boolean;
     /** Dynamic config access, custom config items */
     [key: string]: unknown;
 }
@@ -1659,6 +1782,10 @@ interface CompileOptions {
     globalVars?: string[];
     /** File path for debug error messages (default: undefined) */
     file?: string;
+    /** Generate VDOM output instead of HTML string (default: false) */
+    virtualDom?: boolean;
+    /** Use SWC instead of Babel for parsing (default: false) */
+    useSwc?: boolean;
 }
 
 /**
@@ -1828,6 +1955,8 @@ declare class Updater implements UpdaterInterface {
     private version;
     /** Snapshot of `version` taken by `snapshot()`, used by `altered()`. */
     private snapshotVersion;
+    /** Last rendered VDOM tree (only used when virtualDom is enabled) */
+    private vdom?;
     constructor(viewId: string);
     /**
      * Get data by key.
@@ -1890,6 +2019,21 @@ declare class Updater implements UpdaterInterface {
     getChangedKeys(): ReadonlySet<string>;
 }
 
+/**
+ * Create a virtual DOM node.
+ *
+ * Text node: `vdomCreate(0, 'text content')`
+ * Element: `vdomCreate('div', { class: 'row' }, [child1, child2])`
+ * Self-closing: `vdomCreate('br', null, 1)`
+ * Raw HTML: `vdomCreate(0, '<b>bold</b>', 1)` (children truthy → raw HTML node)
+ * Root: `vdomCreate(viewId, 0, [children])`
+ */
+declare function vdomCreate(tag: string | number, props?: Record<string, unknown> | string | number | null, children?: VDomNode[] | string | number | null, specials?: Record<string, string>): VDomNode;
+/**
+ * Create an empty VDomRef for tracking diff operations.
+ */
+declare function createVDomRef(viewId: string): VDomRef;
+
 /**
  * Payload wraps API response data with convenient access methods.
  */
@@ -2186,86 +2330,4 @@ declare function create<T>(name: string, creator: StateCreator<T>): StoreApi<T>;
  */
 declare function bindStore<T>(view: unknown, store: StoreApi<T>, selector?: (state: T) => Record<string, unknown>): () => void;
 
-/** Serialized view info attached to a frame node */
-interface SerializedViewInfo {
-    /** View ID (same as frame ID) */
-    id: string;
-    /** Whether the view has rendered at least once */
-    rendered: boolean;
-    /** View signature (> 0 = active) */
-    signature: number;
-    /** Observed state keys */
-    observedStateKeys: string[] | null;
-    /** Location observation config */
-    locationObserved: {
-        flag: number;
-        keys: string[];
-        observePath: boolean;
-    };
-    /** Whether view has a template function */
-    hasTemplate: boolean;
-    /** Delegated event types (keys from $evtObjMap) */
-    eventMethodKeys: string[];
-    /** Captured resource keys */
-    resourceKeys: string[];
-    /** Whether view exposes an assign method (supports CrossSite reuse) */
-    hasAssign: boolean;
-    /** Updater refData snapshot (shallow copy of current data) */
-    updaterData: Record<string, unknown> | null;
-}
-/** A single node in the serialized frame tree */
-interface SerializedFrameNode {
-    /** Frame ID (same as owner DOM element ID) */
-    id: string;
-    /** Parent frame ID (null for root) */
-    parentId: string | null;
-    /** View path (v-lark attribute value) */
-    viewPath: string | null;
-    /** Number of child frames */
-    childrenCount: number;
-    /** Number of children that have fired 'created' */
-    readyCount: number;
-    /** Whether children have been created */
-    childrenCreated: number;
-    /** Whether children are in alter state */
-    childrenAlter: number;
-    /** Whether this frame is destroyed */
-    destroyed: number;
-    /** Serialized view info (null if no view mounted) */
-    view: SerializedViewInfo | null;
-    /** Child frame nodes */
-    children: SerializedFrameNode[];
-}
-/** Top-level serialized frame tree */
-interface SerializedFrameTree {
-    /** Root frame node */
-    root: SerializedFrameNode | null;
-    /** Total frame count */
-    totalFrames: number;
-    /** Timestamp of serialization */
-    timestamp: number;
-    /** Root element ID */
-    rootId: string;
-}
-declare const FrameVisualBridge: {
-    MSG_PING: string;
-    MSG_PONG: string;
-    MSG_REQUEST_TREE: string;
-    MSG_TREE: string;
-    MSG_TREE_DELTA: string;
-};
-/**
- * Serialize the entire Frame tree starting from root.
- * Returns an empty snapshot if the app hasn't booted yet.
- */
-declare function serializeFrameTree(): SerializedFrameTree;
-/**
- * Install the Frame Visualizer Bridge.
- * Listens for postMessage events from the visualizer and responds
- * with serialized frame tree data.
- *
- * This should be called once during Framework.boot().
- */
-declare function installFrameVisualizerBridge(): void;
-
-export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEvent, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyStyle, bindStore, computed, create, defineView, config as frameworkConfig, getRouteMode, installFrameVisualizerBridge, invalidateViewClass, mark, markBooted, markRouterBooted, nextCounter, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, unmark, use, useUrlState };
+export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, Framework, type FrameworkConfig, type FrameworkInterface, type HotContext, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, Service, type ServiceCacheInfo, type ServiceEvent, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, type VDomCreateFn, type VDomNode, type VDomRef, type VDomTemplate, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyStyle, bindStore, computed, create, createVDomRef, defineView, config as frameworkConfig, getRouteMode, invalidateViewClass, mark, markBooted, markRouterBooted, nextCounter, registerViewClass, reloadViews, resetProjectsMap, safeguard, unmark, use, useUrlState, vdomCreate };