@saolabs/client 1.0.0 → 1.1.0

package/dist/src/core/contracts/RouterInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/RouterInterface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RouterInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/RouterInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,KAAK,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAI,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAAC;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC/C,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,uBAAuB;IACvB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAC/D,0BAA0B;IAC1B,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gCAAgC;IAChC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAClE,4BAA4B;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,wBAAwB;IACxB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAC/C,wBAAwB;IACxB,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/H,sFAAsF;IACtF,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5F,qCAAqC;IACrC,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,qBAAqB;IACrB,IAAI,IAAI,IAAI,CAAC;IACb,mBAAmB;IACnB,OAAO,IAAI,IAAI,CAAC;IAEhB,UAAU,IAAI,MAAM,CAAC;CACxB"}

package/dist/src/core/contracts/SectionInterface.d.ts

@@ -0,0 +1,48 @@
+import type { SaoElementChildren } from "../types/utils.js";
+import type { ViewControllerInterface } from "./ViewControllerInterface.js";
+import type { HtmlInterface } from "./ElementInterface.js";
+export type SectionItemType = 'static' | 'dynamic' | 'async' | 'reactive';
+export type SectionContentType = 'text' | 'html';
+export type SectionContentRenderer = (parentElement?: HtmlInterface | null | undefined) => string | SaoElementChildren;
+export type SectionConstruvtorArgs = {
+    ctx?: ViewControllerInterface | null;
+    name: string;
+    type: SectionItemType;
+    contentType?: SectionContentType;
+    stateKeys?: string[];
+    renderFactory: SectionContentRenderer;
+    [key: string]: any;
+};
+export interface SectionInterface {
+    ctx?: ViewControllerInterface | null;
+    /** Owning view instance — mirrors Block/BlockOutlet keying (`name` + `viewId`). */
+    viewId?: string | null;
+    name: string;
+    type: SectionItemType;
+    contentType?: SectionContentType;
+    stateKeys?: string[];
+    renderFactory?: SectionContentRenderer;
+}
+export interface SectionManagerInterface {
+    sections: Map<string, SectionInterface>;
+    subscribers: Map<string, ((section: SectionInterface) => void)[]>;
+    add(section: SectionInterface): void;
+    subscribe(name: string, callback: (section: SectionInterface) => void): () => void;
+    unsubscribe(name: string, callback?: (section: SectionInterface) => void): void;
+    /** Register a @yield(...) marker so mountViewSections() can find it by name. */
+    addYield(id: string, yieldEl: any): void;
+    /** Resolve the current value of a named section synchronously — used by `this.yieldContent()` in attribute/prop bindings. */
+    resolve(name: string, defaultValue?: any): any;
+    /** Mount sections owned by one controller (page or layout) into their matching yields. Mirrors BlockManagerService.mountViewBlocks(). */
+    mountViewSections(viewId: string): void;
+    /** Hydrate counterpart — claim SSR content, no DOM insertion, only (re)subscribe. */
+    hydrateViewSections(viewId: string): void;
+    startAll(): void;
+    stopAll(): void;
+    unmountView(viewId: string): void;
+    removeYieldsOfView(viewId: string): void;
+    /** Revert every page-scoped head tag (title/meta) before mounting a new page's chain. */
+    resetPageHead(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=SectionInterface.d.ts.map

package/dist/src/core/contracts/SectionInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/SectionInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAiE,MAAM,uBAAuB,CAAC;AAG1H,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAA;AAChD,MAAM,MAAM,sBAAsB,GAAG,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,GAAG,kBAAkB,CAAC;AACvH,MAAM,MAAM,sBAAsB,GAAG;IACjC,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,sBAAsB,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB,CAAA;AACD,MAAM,WAAW,gBAAgB;IAC7B,GAAG,CAAC,EAAG,uBAAuB,GAAG,IAAI,CAAC;IACtC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AACD,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IAChF,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IACzC,6HAA6H;IAC7H,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC/C,yIAAyI;IACzI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qFAAqF;IACrF,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,IAAI,IAAI,CAAC;IAChB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yFAAyF;IACzF,aAAa,IAAI,IAAI,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACnB"}

package/dist/src/core/contracts/SectionInterface.js

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

package/dist/src/core/contracts/SectionInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionInterface.js","sourceRoot":"","sources":["../../../../src/core/contracts/SectionInterface.ts"],"names":[],"mappings":""}

package/dist/src/core/contracts/ServiceProviderInterface.d.ts

@@ -1,8 +1,8 @@
-import { OneObjectType } from "../types/utils";
-import type { ApplicationInterface } from "./ApplicationInterface";
+import { SaoObjectType } from "../types/utils.js";
+import type { ApplicationInterface } from "./ApplicationInterface.js";
 /** Service Provider — register() đăng ký, boot() khởi động */
 export interface ServiceProviderInterface {
-    oneType?: OneObjectType;
+    saoType?: SaoObjectType;
     name: string;
     dependsOn?: string[];
     initApplication?(App?: ApplicationInterface): void;

package/dist/src/core/contracts/ServiceProviderInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceProviderInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ServiceProviderInterface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"ServiceProviderInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ServiceProviderInterface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,IAAI,IAAI,CAAC;CACjB"}

package/dist/src/core/contracts/ViewControllerInterface.d.ts

@@ -1,36 +1,66 @@
-import type { OneObjectType } from "../types/utils";
-import type { ViewInterface, ViewRenderFactory } from "./ViewInterface";
-import type { ViewStateInterface } from "./ViewStateInterface";
-import type { HtmlInterface, FragmentInterface, OneElementEventHandler, OneChildrenFactory, WrapperInterface } from "./ElementInterface";
-import type { ReactiveInterface } from "./ReactiveInterface";
-import type { BlockInterface } from "./BlockInterface";
-import type { LoopContextInterface } from "./LoopContextInterface";
-import { SectionInterface } from "./views";
+import type { SaoObjectType } from "../types/utils.js";
+import type { ViewInterface, ViewRenderFactory } from "./ViewInterface.js";
+import type { ViewUserConfig } from "../view/View.js";
+import type { ViewStateInterface } from "./ViewStateInterface.js";
+import type { HtmlInterface, FragmentInterface, SaoElementEventHandler, SaoChildrenFactory, SaoChildrenFactoryOutput, SaoChildrenSlotContent, WrapperInterface, EventModifier } from "./ElementInterface.js";
+import type { ReactiveInterface } from "./ReactiveInterface.js";
+import type { BlockInterface } from "./BlockInterface.js";
+import type { LoopContextInterface } from "./LoopContextInterface.js";
+import { SectionInterface } from "../contracts/SectionInterface.js";
+import type { ForeachSlotCache } from "../elements/ForeachSlotCache.js";
+import type { InitMode } from "./common.js";
+import type { ResourceScope } from '../view/ResourceScope.js';
 export type ViewType = 'view' | 'layout' | 'component' | 'template';
 export interface ViewControllerInterface {
-    oneType: OneObjectType;
+    saoType: SaoObjectType;
     view: ViewInterface;
     viewId: string;
     path: string;
     viewType: ViewType;
     states: ViewStateInterface;
+    readonly scope: ResourceScope;
+    afterDom(callback: () => void): () => void;
     loopContext: LoopContextInterface | null;
     /** Raw input data reference */
     data: Record<string, any>;
     /** Whether this view defines a super view (layout) */
     hasSuperView: boolean;
+    /** Exact DOM listener references, used for element-level cleanup before destroy. */
+    elementEventHandlers: Map<HTMLElement, Map<string, EventListener[]>>;
+    /**
+     * Active ForeachSlotCache — set bởi Reactive.renderForeach() trước khi gọi factory.
+     * __foreach() dùng để quyết định reuse hay create elements.
+     * null = không có cache active (render bình thường).
+     */
+    _currentForeachCache: ForeachSlotCache | null;
+    /** Element gọi trong destroy() để tự gỡ khỏi registry (no-op nếu key đã trỏ bản mới) */
+    releaseElement(el: object): void;
+    /** Compiler helper for raw interpolation inside HTML RCDATA. */
+    decodeTextContent(value: string): string;
     /** Path to super view (layout) */
     superViewPath: string | null;
     /** Main element (Wrapper) for this view */
-    mainElement: any;
+    mainElement: WrapperInterface | null;
+    preloadElement: WrapperInterface | null;
     sections: Map<string, SectionInterface>;
     blocks: Map<string, BlockInterface>;
     urlPath: string | null;
-    childrenFactory: OneChildrenFactory | null;
-    wrapper: (factory: OneChildrenFactory) => WrapperInterface;
-    addEventListener(element: HTMLElement, event: string, handlers: OneElementEventHandler): void;
+    isActive: boolean;
+    childrenFactory: SaoChildrenFactory | null;
+    wrapper: (factory: SaoChildrenFactory) => WrapperInterface;
+    removeEventListener(element: HTMLElement, event: string): void;
+    addEventListener(element: HTMLElement, event: string, handlers: SaoElementEventHandler, modifiers?: EventModifier[]): void;
     /** Called by reactive system to schedule an update */
     scheduleUpdate(reactive: ReactiveInterface): void;
+    /** Còn vùng reactive chờ re-render trong frame này không? */
+    hasPendingReactiveUpdate(): boolean;
+    /** Flush đồng bộ các reactive update đang chờ (sau mount/hydrate). */
+    flushReactiveUpdatesNow(): void;
+    /**
+     * Chế độ khởi tạo của view: 'create' (CSR) hoặc 'hydrate' (SSR).
+     * Truyền xuống mọi element con để chúng tạo mới hay claim DOM server.
+     */
+    initMode: InitMode;
     /** Lifecycle */
     setup(config: Record<string, any>): void;
     /** Commit initial data — set initial state values after render */
@@ -39,20 +69,36 @@ export interface ViewControllerInterface {
     updateData(data: Record<string, any>): void;
     /** Update single data item */
     updateDataItem(key: string, value: any): void;
+    /** Mount — gắn instance vào real DOM (root!=null) + fire mounting/mounted + acquire asset */
+    mount(root?: HtmlInterface | null): void;
+    /** Unmount — gỡ instance khỏi real DOM + fire unmounting/unmounted + release asset */
+    unmount(): void;
     /** Start reactive subscriptions */
     start(): void;
     /** Stop reactive subscriptions (for caching) */
     stop(): void;
+    /** Pause — dirty-mode + buffer async, dùng khi vào PageCache (ROUTE_RENDER_FLOW §7) */
+    pause(): void;
+    /** Resume — flush dirty keys + apply buffered data, dùng khi restore từ PageCache */
+    resume(): void;
+    /** State machine: created → active ⇄ paused → destroyed */
+    readonly lifecycleState: string;
+    active(): void;
+    deactive(): void;
+    pushBlockAndSections(): void;
+    /** Materialize the lazy parent-owned slot only when ChildrenNode is rendered. */
+    __children(content: SaoChildrenSlotContent, parentElement: HtmlInterface | null): SaoChildrenFactoryOutput;
     /** Loop directives */
-    __foreach<T>(list: T[] | Record<string, T>, callback: (item: T, key: string, index: number, loop: any) => any): any[];
+    __foreach<T>(list: T[] | Record<string, T>, callback: (item: T, key: string, index: number, loop: any, identity: number) => any, keyFn?: (item: T, index: number) => any, reconcile?: boolean, scopeId?: string): any[];
     __for(loopType?: string, start?: number, end?: number, execute?: (loop: any) => any): any;
     __while(execute: (loop: any) => any, maxIterations?: number): any;
     /** App reference */
     App: any;
     setApp(app: any): void;
-    setUserDefinedConfig(config: Record<string, any>): void;
+    setUserDefinedConfig<T extends object>(config: ViewUserConfig<T>): void;
     /** Set root element — the container this view renders into */
     setRootElement(rootElement: HtmlInterface): void;
+    setParentElement(parentElement: HtmlInterface): void;
     /** Render the view's element tree into rootElement */
     render(): ViewInterface | FragmentInterface | null;
     prerender(): ViewInterface | FragmentInterface | null;
@@ -63,6 +109,13 @@ export interface ViewControllerInterface {
     setIsSuperView(isSuper: boolean): void;
     /** Set the parent layout's controller */
     setSuperView(superView: ViewControllerInterface): void;
+    /** Nested view tree (@include): parent controller */
+    parent: ViewControllerInterface | null;
+    /** Nested view tree (@include): child controllers */
+    children: ViewControllerInterface[];
+    setParent(parent: ViewControllerInterface | null): void;
+    addChild(child: ViewControllerInterface): void;
+    removeChild(child: ViewControllerInterface): void;
     /** Track the original page view's controller for block mounting */
     originView: ViewControllerInterface | null;
     /** Set the origin (page) controller reference */
@@ -73,6 +126,15 @@ export interface ViewControllerInterface {
     /** Get config value with optional default */
     getConfig(key?: string, defaultValue?: any): any;
     getConfig(): ViewControllerConfig;
+    /**
+     * Đưa lỗi cho error boundary gần nhất (chính controller này hoặc tổ tiên
+     * qua `parent`). Trả `{ handled: true, fallback }` nếu có boundary xử lý;
+     * `{ handled: false }` → caller giữ nguyên hành vi cũ (bubble lên trên).
+     */
+    handleError(err: unknown, info: ErrorInfo): {
+        handled: boolean;
+        fallback?: any;
+    };
 }
 export type ViewConfig = {
     hasSuperView?: boolean;
@@ -109,7 +171,46 @@ export type ViewRuntimeConfig = {
     updateVariableItemData?: (key: string, value: any) => void;
     prerender?: ViewRenderFactory | null;
     render?: ViewRenderFactory | null;
+    /**
+     * Error boundary. Trả children → dùng làm fallback cho vùng lỗi;
+     * trả void → chỉ ghi nhận, lỗi tiếp tục bubble lên boundary cha.
+     */
+    onError?: ErrorBoundaryHandler;
     [key: string]: any;
 };
+/** Giai đoạn phát sinh lỗi — giúp handler phân biệt lỗi render lần đầu với lỗi sau tương tác. */
+export type ErrorPhase = 'render' | 'update' | 'async';
+export type ErrorInfo = {
+    phase: ErrorPhase;
+    /** path của view NƠI lỗi xảy ra (có thể là view con, khác với view chứa boundary) */
+    path: string;
+};
+export type ErrorBoundaryHandler = (err: unknown, info: ErrorInfo) => any;
 export type ViewControllerConfig = ViewConfig & ViewRuntimeConfig;
+/**
+ * `this` bên trong các hàm config do compiler sinh — `commitConstructorData`,
+ * `updateVariableData`, `updateVariableItemData`.
+ *
+ * Chúng được gọi bằng `fn.call(makeConfigThis(), …)`, tức receiver KHÔNG phải
+ * object chứa chúng. TypeScript mặc định suy `this` = chính object literal đó,
+ * nên `this.config` không tồn tại theo kiểu và `tsc --strict` báo TS2339.
+ *
+ * Compiler emit `function(this: ViewConfigThis)` cho đầu ra `.ts`; đầu ra `.js`
+ * không có tham số này vì tham số `this` là cú pháp chỉ có ở TypeScript và bị
+ * xoá khi emit — nó không bao giờ là đối số thật.
+ */
+export interface ViewConfigThis {
+    /**
+     * Config runtime của chính view — nơi các hàm sinh ra gọi lẫn nhau.
+     *
+     * KHÔNG nullable, và `ViewController.runtimeConfig` cũng vậy: nó khởi tạo
+     * `{}` rồi chỉ bị `setup()` ghi đè bằng config thật. Cái CÓ THỂ vắng là
+     * từng hàm trong đó (`commitConstructorData`… đều optional) — mỗi lời gọi
+     * đã tự canh bằng `typeof fn === 'function'`.
+     */
+    config: ViewRuntimeConfig;
+    data: Record<string, any>;
+    ctrl: ViewControllerInterface;
+    view: ViewInterface;
+}
 //# sourceMappingURL=ViewControllerInterface.d.ts.map

package/dist/src/core/contracts/ViewControllerInterface.d.ts.map

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

package/dist/src/core/contracts/ViewInterface.d.ts

@@ -1,8 +1,8 @@
-import type { OneObjectType } from "../types/utils";
-import type { ViewControllerInterface, ViewType } from "./ViewControllerInterface";
-import type { FragmentInterface } from "./ElementInterface";
+import type { SaoObjectType } from "../types/utils.js";
+import type { ViewControllerInterface, ViewType } from "./ViewControllerInterface.js";
+import type { FragmentInterface } from "./ElementInterface.js";
 export interface ViewInterface {
-    oneType: OneObjectType;
+    saoType: SaoObjectType;
     __ctrl__: ViewControllerInterface;
     path: string;
     viewType: ViewType;
@@ -12,13 +12,39 @@ export interface ViewInterface {
 export type ViewRenderFactory = () => FragmentInterface | ViewInterface | null;
 /** View class constructor signature */
 export type ViewConstructor = new (path: string, viewType: 'view' | 'layout' | 'component', viewControllerClass?: any) => ViewInterface;
-/** View lifecycle hooks — user can implement any of these */
+/**
+ * View lifecycle hooks — user có thể cài bất kỳ hook nào (mẫu examples/sao/app.sao).
+ * Mỗi transition có cặp before/after:
+ *   mount   → mounting / mounted        (gắn vào real DOM)
+ *   start   → starting / started        (subscribe reactive + attach events)
+ *   pause   → pausing  / paused         (vào PageCache — rời real DOM)
+ *   resume  → resuming / resumed        (khôi phục từ PageCache)
+ *   stop    → stopping / stopped        (deactivate reactive)
+ *   unmount → unmounting / unmounted    (gỡ khỏi real DOM)
+ *   destroy → destroying / destroyed    (cleanup toàn bộ)
+ */
 export interface ViewLifecycleHooks {
+    mounting?(): void | Promise<void>;
+    mounted?(): void | Promise<void>;
+    starting?(): void | Promise<void>;
+    started?(): void | Promise<void>;
+    pausing?(): void | Promise<void>;
+    paused?(): void | Promise<void>;
+    resuming?(): void | Promise<void>;
+    resumed?(): void | Promise<void>;
+    stopping?(): void | Promise<void>;
+    stopped?(): void | Promise<void>;
+    unmounting?(): void | Promise<void>;
+    unmounted?(): void | Promise<void>;
+    destroying?(): void | Promise<void>;
+    destroyed?(): void | Promise<void>;
     onInit?(): void | Promise<void>;
     onMounted?(): void | Promise<void>;
     onUpdated?(): void | Promise<void>;
     onDestroy?(): void | Promise<void>;
     onActivated?(): void | Promise<void>;
     onDeactivated?(): void | Promise<void>;
+    onPause?(): void | Promise<void>;
+    onResume?(): void | Promise<void>;
 }
 //# sourceMappingURL=ViewInterface.d.ts.map

package/dist/src/core/contracts/ViewInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAID,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAAC;AAE/E,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,EAAE,mBAAmB,CAAC,EAAE,GAAG,KAAK,aAAa,CAAC;AAExI,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,WAAW,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"ViewInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAID,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAAC;AAE/E,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,EAAE,mBAAmB,CAAC,EAAE,GAAG,KAAK,aAAa,CAAC;AAExI;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAE/B,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGnC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,WAAW,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/src/core/contracts/ViewManagerInterface.d.ts

@@ -1,6 +1,6 @@
-import type { ViewInterface } from "./ViewInterface";
-import type { ApplicationInterface } from "./ApplicationInterface";
-import { RouterNavigationType } from "./RouterInterface";
+import type { ViewInterface } from "./ViewInterface.js";
+import type { ApplicationInterface } from "./ApplicationInterface.js";
+import { RouterNavigationType } from "./RouterInterface.js";
 export interface ActiveViewInfo {
     view: ViewInterface;
     path: string;
@@ -21,15 +21,36 @@ export interface ViewManagerInterface {
     registerView(name: string, loader: ((...args: any[]) => any) | (() => Promise<any>)): void;
     /** Initialize with optional config */
     init(config?: {
-        container?: HTMLElement;
+        container?: HTMLElement | string;
         registry?: Record<string, any>;
+        systemData?: Record<string, any>;
+        revision?: string;
+        contextViews?: string;
+        dataEndpoint?: string;
+        fetchOptions?: Record<string, any>;
     }): void;
+    /** Apply a newer server-authoritative view context. Returns true when changed. */
+    applyViewContext?(state: Record<string, any>): boolean;
+    /** A changed view namespace needs a full document load before it can be applied safely. */
+    requiresReloadForViewContext?(state: Record<string, any>): boolean;
+    /** Current server view-context fingerprint. */
+    getContextRevision?(): string | null;
     /** Mount a view by name — main entry point */
     mountView(name: string, data?: Record<string, any>, route?: any, navigationType?: RouterNavigationType): any;
+    /**
+     * Hydrate a server-side rendered view.
+     * data PHẢI có __SSR_VIEW_ID__ — viewId mà Blade dùng để prefix element classes.
+     */
+    hydrateView(name: string, data: Record<string, any> & {
+        __SSR_VIEW_ID__: string;
+    }, route?: any): any;
+    /** Còn SSR boot chưa consume? (route đầu tiên nên hydrate thay vì mount) */
+    hasSSRBoot?(): boolean;
+    /** Lấy + consume viewId SSR cho view name (chỉ trả 1 lần, cho route đầu) */
+    consumeSSRViewId?(viewName: string): string | null;
     /** Unmount all active views */
     unmountAll(): void;
     /** Unmount a specific view by path */
-    unmountView(path: string): void;
     /** Get currently active page view */
     getCurrentView(): ViewInterface | null;
     /** Get current layout view */
@@ -38,7 +59,28 @@ export interface ViewManagerInterface {
     getViewStack(): ViewInterface[];
     /** Check if a view is mounted */
     isViewMounted(path: string): boolean;
+    /** Invalidate async work of the navigation currently being rendered. */
+    cancelNavigation?(): void;
     /** Full destroy */
     destroy(): void;
+    /**
+     * generateViewId — tạo unique ID cho mỗi view instance.
+     * Compiled output gọi: App.View.generateViewId()
+     */
+    generateViewId(): string;
+    /**
+     * exists — kiểm tra view đã đăng ký trong registry chưa.
+     * Dùng bởi @includeIf directive.
+     */
+    exists(name: string): boolean;
+    /**
+     * view — lấy view instance từ registry, có thể cache.
+     */
+    /** Tạo View instance; hỗ trợ registry lazy (`() => import(...)`) — dùng cho view cấp route. */
+    view(name: string, data: Record<string, any>, cache: boolean): Promise<any>;
+    /** Bản đồng bộ cho `@include`/`@extends`; view lazy chưa preload → null. */
+    resolveViewSync(name: string, data: Record<string, any>, cache: boolean): any;
+    /** Nạp trước view lazy để dùng được đồng bộ sau đó. */
+    preloadView(name: string): Promise<boolean>;
 }
 //# sourceMappingURL=ViewManagerInterface.d.ts.map

package/dist/src/core/contracts/ViewManagerInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewManagerInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewManagerInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,6BAA6B;IAC7B,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3C,yBAAyB;IACzB,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IACnC,oCAAoC;IACpC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClG,oCAAoC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3F,sCAAsC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACjF,8CAA8C;IAC9C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,oBAAoB,GAAI,GAAG,CAAC;IAC9G,+BAA+B;IAC/B,UAAU,IAAI,IAAI,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qCAAqC;IACrC,cAAc,IAAI,aAAa,GAAG,IAAI,CAAC;IACvC,8BAA8B;IAC9B,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAAC;IACzC,0BAA0B;IAC1B,YAAY,IAAI,aAAa,EAAE,CAAC;IAChC,iCAAiC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,mBAAmB;IACnB,OAAO,IAAI,IAAI,CAAC;CACnB"}
+{"version":3,"file":"ViewManagerInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewManagerInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAK5D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,6BAA6B;IAC7B,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3C,yBAAyB;IACzB,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IACnC,oCAAoC;IACpC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClG,oCAAoC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3F,sCAAsC;IACtC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACjO,kFAAkF;IAClF,gBAAgB,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACvD,2FAA2F;IAC3F,4BAA4B,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACnE,+CAA+C;IAC/C,kBAAkB,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;IACrC,8CAA8C;IAC9C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,oBAAoB,GAAI,GAAG,CAAC;IAC9G;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACrG,4EAA4E;IAC5E,UAAU,CAAC,IAAI,OAAO,CAAC;IACvB,4EAA4E;IAC5E,gBAAgB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD,+BAA+B;IAC/B,UAAU,IAAI,IAAI,CAAC;IACnB,sCAAsC;IACtC,qCAAqC;IACrC,cAAc,IAAI,aAAa,GAAG,IAAI,CAAC;IACvC,8BAA8B;IAC9B,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAAC;IACzC,0BAA0B;IAC1B,YAAY,IAAI,aAAa,EAAE,CAAC;IAChC,iCAAiC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,wEAAwE;IACxE,gBAAgB,CAAC,IAAI,IAAI,CAAC;IAC1B,mBAAmB;IACnB,OAAO,IAAI,IAAI,CAAC;IAChB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B;;OAEG;IACH,+FAA+F;IAC/F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5E,4EAA4E;IAC5E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;IAC9E,uDAAuD;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C"}

package/dist/src/core/contracts/ViewStateInterface.d.ts

@@ -10,16 +10,53 @@ export interface ViewStateInterface {
 export interface StateManagerInterface {
     /** Create reactive state — returns [value, setter, key] */
     useState(value: any, key?: string | number): [any, (newValue: any) => void, string | number];
+    /**
+     * State dẫn xuất có memo hoá — chỉ tính lại khi `deps` đổi, và lazy
+     * (đánh dấu bẩn lúc dep đổi, tính lúc đọc). Đọc qua `getStateByKey(key)`
+     * hoặc `subscribe([key])` như state thường.
+     */
+    computed<T>(key: string, fn: () => T, deps?: string[]): () => T;
     /** Update state by key */
     updateStateByKey(key: string | number, value: any): any;
     /** Get state value by key (supports nested paths: 'user.name') */
     getStateByKey(key: string | number): any;
+    getStateVersion(key: string): number;
     /** Subscribe to state changes */
     subscribe(key: string | number | string[] | Record<string, (value: any) => void>, callback?: (value: any) => void): () => void;
     /** Unsubscribe */
     unsubscribe(key: string | number | string[] | Record<string, (value: any) => void>, callback?: (value: any) => void): void;
-    /** Register shorthand — useState alias */
-    register(key: string | number, value: any): (newValue: any) => void;
+    /**
+     * Register shorthand — pre-declare a state slot, returns setter.
+     * Value is optional — compiler calls register(key) with 1 arg;
+     * initial value is set later via update$xxx() in commitConstructorData.
+     */
+    register(key: string | number, value?: any): (newValue: any) => void;
+    /**
+     * Setter map — exposed for direct access by compiled views.
+     * e.g. __STATE__.__.setters.setCount = setCount;
+     */
+    setters: Record<string | number, (value: any) => void>;
+    /**
+     * Flag — true while commitConstructorData is running, false after lockUpdateRealState().
+     * Compiler-generated update$xxx() checks this before calling updateStateByKey.
+     */
+    readonly canUpdateStateByKey: boolean;
+    /**
+     * Lock — called at end of commitConstructorData() to prevent update$xxx from
+     * being accidentally triggered after initialization.
+     */
+    lockUpdateRealState(): void;
+    /**
+     * Unlock — called before updateVariableData() to allow update$xxx again.
+     */
+    unlockUpdateRealState(): void;
+    /**
+     * Flush đồng bộ pending state changes (huỷ RAF đang chờ nếu có).
+     * Dùng sau commitData()/mount để DOM phản ánh state ngay trong cùng tick.
+     */
+    flushNow(): void;
+    /** Opt into expensive mutation diagnostics; disabled by default in browsers. */
+    setMutationDiagnostics(enabled: boolean): void;
     /** Destroy — cleanup all listeners and states */
     destroy(): void;
 }

package/dist/src/core/contracts/ViewStateInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewStateInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewStateInterface.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAC/B,4BAA4B;IAC5B,EAAE,EAAE,qBAAqB,CAAC;IAC1B,iCAAiC;IACjC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxH,kBAAkB;IAClB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACnH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7F,0BAA0B;IAC1B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IACxD,kEAAkE;IAClE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;IACzC,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/H,kBAAkB;IAClB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3H,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IACpE,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAC;CACnB;AAID,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAEjD,+BAA+B;AAC/B,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB"}
+{"version":3,"file":"ViewStateInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ViewStateInterface.ts"],"names":[],"mappings":"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"}

package/dist/src/core/contracts/common.d.ts

@@ -4,13 +4,13 @@ export declare enum InitModes {
     HYDRATE = "hydrate"
 }
 /**
- * Common types and utilities for OneView contracts
- * This file defines shared types and enums used across OneView's contracts, such as initialization modes and system keys for HTML elements.
+ * Common types and utilities for SaoView contracts
+ * This file defines shared types and enums used across SaoView's contracts, such as initialization modes and system keys for HTML elements.
  *
  * Key exports:
  */
 /**
- * System keys for HTML elements used by OneView.
+ * System keys for HTML elements used by SaoView.
  * These keys are used to store metadata on HTML elements, such as IDs and view information.
  * @name ESK (Element System Keys)
  * @enum {string}

package/dist/src/core/contracts/common.js

@@ -4,13 +4,13 @@ export var InitModes;
     InitModes["HYDRATE"] = "hydrate";
 })(InitModes || (InitModes = {}));
 /**
- * Common types and utilities for OneView contracts
- * This file defines shared types and enums used across OneView's contracts, such as initialization modes and system keys for HTML elements.
+ * Common types and utilities for SaoView contracts
+ * This file defines shared types and enums used across SaoView's contracts, such as initialization modes and system keys for HTML elements.
  *
  * Key exports:
  */
 /**
- * System keys for HTML elements used by OneView.
+ * System keys for HTML elements used by SaoView.
  * These keys are used to store metadata on HTML elements, such as IDs and view information.
  * @name ESK (Element System Keys)
  * @enum {string}