@saolabs/client 1.0.0 → 1.0.2

package/dist/src/core/helpers/ApiClient.d.ts

@@ -0,0 +1,58 @@
+/**
+ * API Module - V2 TypeScript
+ * Centralized API service for backend communication
+ */
+import { APIClientInterface } from '../contracts/ApiInterface.js';
+import { HttpService } from '../services/HttpService.js';
+export interface APIEndpoints {
+    system?: {
+        config?: string;
+        data?: string;
+    };
+    [key: string]: any;
+}
+export declare class ApiClient implements APIClientInterface {
+    private http;
+    private endpoints;
+    constructor();
+    /**
+     * Setup default headers including CSRF token
+     * @private
+     */
+    private setupDefaultHeaders;
+    init(config: Record<string, any>): void;
+    /**
+     * Load API endpoints from config
+     * @private
+     */
+    private loadEndpoints;
+    /**
+     * Get view data for specific URI
+     * V1 compatible: returns response.data if status=true, else {}
+     */
+    getViewData(uri: string): Promise<any>;
+    /**
+     * Get system configuration
+     * V1 compatible
+     */
+    getSystemConfig(): Promise<any>;
+    /**
+     * Get system data
+     * V1 compatible
+     */
+    getSystemData(): Promise<any>;
+    /**
+     * Get data for current URI
+     * Optimization: SSR-safe window access
+     */
+    getURIData(): Promise<any>;
+    /**
+     * Set custom endpoint
+     */
+    setEndpoint(key: string, value: string): void;
+    /**
+     * Get HTTP service instance for custom requests
+     */
+    getHttpService(): HttpService;
+}
+//# sourceMappingURL=ApiClient.d.ts.map

package/dist/src/core/helpers/ApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../../../../src/core/helpers/ApiClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,qBAAa,SAAU,YAAW,kBAAkB;IAChD,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,SAAS,CAAe;;IAQhC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAkB3B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAWvC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAU5C;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAerC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;IAenC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAShC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7C;;OAEG;IACH,cAAc,IAAI,WAAW;CAGhC"}

package/dist/src/core/helpers/ApiClient.js

@@ -0,0 +1,131 @@
+/**
+ * API Module - V2 TypeScript
+ * Centralized API service for backend communication
+ */
+import { HttpService } from '../services/HttpService.js';
+export class ApiClient {
+    constructor() {
+        this.http = new HttpService();
+        this.setupDefaultHeaders();
+        this.endpoints = this.loadEndpoints();
+    }
+    /**
+     * Setup default headers including CSRF token
+     * @private
+     */
+    setupDefaultHeaders() {
+        this.http.setHeader('Content-Type', 'application/json');
+        this.http.setHeader('Accept', 'application/json');
+        this.http.setHeader('X-Requested-With', 'XMLHttpRequest');
+        this.http.setHeader('X-DATA-TYPE', 'json');
+        // Get CSRF token from meta tag (SSR support)
+        if (typeof document !== 'undefined') {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]');
+            if (csrfToken) {
+                const token = csrfToken.getAttribute('content');
+                if (token) {
+                    this.http.setHeader('X-CSRF-TOKEN', token);
+                }
+            }
+        }
+    }
+    init(config) {
+        if (typeof config.baseUrl === 'string')
+            this.http.setBaseUrl(config.baseUrl);
+        if (typeof config.timeout === 'number')
+            this.http.setTimeout(config.timeout);
+        for (const [name, value] of Object.entries(config.headers || {})) {
+            this.http.setHeader(name, String(value));
+        }
+        if (config.endpoints && typeof config.endpoints === 'object') {
+            this.endpoints = { ...this.endpoints, ...config.endpoints };
+        }
+    }
+    /**
+     * Load API endpoints from config
+     * @private
+     */
+    loadEndpoints() {
+        if (typeof window === 'undefined') {
+            return {};
+        }
+        return window.ONE_CONFIGS?.api?.endpoints || {};
+    }
+    /**
+     * Get view data for specific URI
+     * V1 compatible: returns response.data if status=true, else {}
+     */
+    async getViewData(uri) {
+        try {
+            const response = await this.http.get(uri);
+            return response.status ? response.data : {};
+        }
+        catch (error) {
+            console.error('[API] Error getting view data:', error);
+            return {};
+        }
+    }
+    /**
+     * Get system configuration
+     * V1 compatible
+     */
+    async getSystemConfig() {
+        const endpoint = this.endpoints?.system?.config;
+        if (!endpoint) {
+            return {};
+        }
+        try {
+            const response = await this.http.get(endpoint);
+            return response.status ? response.data : {};
+        }
+        catch (error) {
+            console.error('[API] Error getting system config:', error);
+            return {};
+        }
+    }
+    /**
+     * Get system data
+     * V1 compatible
+     */
+    async getSystemData() {
+        const endpoint = this.endpoints?.system?.data;
+        if (!endpoint) {
+            return {};
+        }
+        try {
+            const response = await this.http.get(endpoint);
+            return response.status ? response.data : {};
+        }
+        catch (error) {
+            console.error('[API] Error getting system data:', error);
+            return {};
+        }
+    }
+    /**
+     * Get data for current URI
+     * Optimization: SSR-safe window access
+     */
+    async getURIData() {
+        if (typeof window === 'undefined') {
+            return {};
+        }
+        const uri = window.location.pathname + window.location.search;
+        return this.getViewData(uri);
+    }
+    /**
+     * Set custom endpoint
+     */
+    setEndpoint(key, value) {
+        if (!this.endpoints[key]) {
+            this.endpoints[key] = {};
+        }
+        Object.assign(this.endpoints[key], typeof value === 'string' ? { url: value } : value);
+    }
+    /**
+     * Get HTTP service instance for custom requests
+     */
+    getHttpService() {
+        return this.http;
+    }
+}
+//# sourceMappingURL=ApiClient.js.map

package/dist/src/core/helpers/ApiClient.js.map

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

package/dist/src/core/helpers/app.d.ts

@@ -0,0 +1,3 @@
+import { AppFactory } from "../contracts/ApplicationInterface.js";
+export declare const app: AppFactory;
+//# sourceMappingURL=app.d.ts.map

package/dist/src/core/helpers/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/core/helpers/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAc,MAAM,sCAAsC,CAAC;AAkE9E,eAAO,MAAM,GAAG,EAAiB,UAAU,CAAC"}

package/dist/src/core/helpers/app.js

@@ -0,0 +1,63 @@
+import { Application } from "../app/Application.js";
+/**
+ * Container instance để quản lý services
+ * Tương tự Laravel's app container
+ */
+const AppInstance = new Application();
+// Tự đăng ký container dưới key 'App' — compiled view luôn gọi `app("App")`
+// để lấy Application (App.View, App.Helper, App.Router...). Thiếu dòng này thì
+// mọi view compiled ném "Cannot resolve: App". (Unit test cũ dùng `new View()`
+// trực tiếp nên không lộ; chỉ lộ khi chạy view compiled thật trên trình duyệt.)
+AppInstance.instance('App', AppInstance);
+/**
+ * Helper function để lấy/đăng ký services
+ * Cách dùng:
+ * - app() - trả về container instance
+ * - app('service_name') - lấy service
+ * - app('key', value) - đăng ký instance
+ *
+ * @param key - Tên service (optional)
+ * @param value - Giá trị service (optional)
+ * @returns Container instance, service, hoặc void
+ *
+ * @example
+ * // Lấy container
+ * const container = app();
+ * container.singleton('store', Store);
+ *
+ * // Lấy service trực tiếp
+ * const store = app('store');
+ *
+ * // Đăng ký instance
+ * app('config', { api: 'https://api.example.com' });
+ */
+const appFactory = (key, value) => {
+    if (key === undefined || key === null) {
+        // Không truyền gì → trả về container
+        return AppInstance;
+    }
+    // Compiler contract: mọi generated view dùng app("App"). Alias này phải
+    // tồn tại cả sau flush()/test teardown, không phụ thuộc singleton map.
+    if (key === 'App' && value === undefined) {
+        return AppInstance;
+    }
+    if (value !== undefined) {
+        // Truyền 2 tham số → đăng ký instance
+        AppInstance.instance(key, value);
+        return;
+    }
+    // Truyền 1 tham số → lấy service
+    return AppInstance.make(key);
+};
+// Add make method to app function for TypeScript compatibility
+appFactory.make = (name) => AppInstance.make(name);
+appFactory.instance = (name, value) => AppInstance.instance(name, value);
+appFactory.resolve = (name, defaultValue) => AppInstance.resolve(name, defaultValue);
+appFactory.register = (name, factory) => AppInstance.bind(name, factory);
+appFactory.bind = (name, factory) => AppInstance.bind(name, factory);
+appFactory.singleton = (name, factory) => AppInstance.singleton(name, factory);
+appFactory.has = (name) => AppInstance.has(name);
+appFactory.flush = () => { AppInstance.flush(); };
+appFactory.destroy = () => { AppInstance.destroy(); };
+export const app = appFactory;
+//# sourceMappingURL=app.js.map

package/dist/src/core/helpers/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/core/helpers/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD;;;GAGG;AACH,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,GAAG,CAAI,GAAgB,EAAE,KAAW,EAAgC,EAAE;IAClF,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACpC,qCAAqC;QACrC,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,IAAI,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,sCAAsC;QACtC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO;IACX,CAAC;IACD,iCAAiC;IACjC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,+DAA+D;AAC/D,UAAU,CAAC,IAAI,GAAG,CAAI,IAAgB,EAAK,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrE,UAAU,CAAC,QAAQ,GAAG,CAAI,IAAgB,EAAE,KAAQ,EAAe,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxG,UAAU,CAAC,OAAO,GAAG,CAAI,IAAgB,EAAE,YAAgB,EAAK,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAC3G,UAAU,CAAC,QAAQ,GAAG,CAAI,IAAgB,EAAE,OAAgB,EAAe,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9G,UAAU,CAAC,IAAI,GAAG,CAAI,IAAgB,EAAE,OAAgB,EAAe,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1G,UAAU,CAAC,SAAS,GAAG,CAAI,IAAgB,EAAE,OAAgB,EAAe,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpH,UAAU,CAAC,GAAG,GAAG,CAAC,IAAgB,EAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtE,UAAU,CAAC,KAAK,GAAG,GAAS,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,UAAU,CAAC,OAAO,GAAG,GAAS,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,GAAG,GAAG,UAAwB,CAAC"}

package/dist/src/core/helpers/transition.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Transition enter/leave cho element — `@transition('fade')`.
+ *
+ * # Quy ước class (giống Vue, để người dùng không phải học lại)
+ *   enter: `{n}-enter-from` `{n}-enter-active` → frame sau → `{n}-enter-to`
+ *   leave: `{n}-leave-from` `{n}-leave-active` → frame sau → `{n}-leave-to`
+ * `-active` có mặt suốt quá trình (chỗ đặt `transition:`), `-from`/`-to` là
+ * hai đầu giá trị.
+ *
+ * # Vì sao dùng `getAnimations()` chứ không nghe `transitionend`
+ * `transitionend` bắn MỘT lần cho MỖI property, không bắn nếu giá trị không
+ * đổi, và không phân biệt transition của element với của con nó — nên cách
+ * làm kinh điển phải parse `transition-duration` + hẹn giờ dự phòng.
+ * `element.getAnimations()` trả thẳng mọi animation/transition đang chạy trên
+ * element kèm promise `.finished`, xử lý đúng cả trường hợp nhiều property và
+ * bị huỷ giữa chừng. Không có animation nào → resolve ngay → hành vi y hệt
+ * lúc chưa có transition (đây cũng là đường chạy trong jsdom).
+ *
+ * # Vì sao cần `isLeaving()`
+ * Element rời đi phải NẰM LẠI DOM tới khi animation xong, trong khi
+ * `Reactive.clearContent()`/`_cleanOrphanNodes()` quét sạch mọi node giữa cặp
+ * marker. Hai vòng quét đó phải bỏ qua node đang leave, nếu không node bị giật
+ * đi ngay và animation không bao giờ thấy được.
+ */
+/** True khi node đang chạy leave và chưa được gỡ. */
+export declare function isLeaving(node: Node): boolean;
+/** Chạy enter. Bị enter/leave khác chen ngang → thoát, không đụng DOM nữa. */
+export declare function runEnter(el: Element, name: string): Promise<void>;
+/**
+ * Chạy leave rồi GỠ node. Trả promise resolve sau khi node đã rời DOM.
+ * Element được đánh dấu leaving ngay lập tức để không ai giật mất giữa chừng.
+ */
+export declare function runLeave(el: Element, name: string): Promise<void>;
+//# sourceMappingURL=transition.d.ts.map

package/dist/src/core/helpers/transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../../../src/core/helpers/transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7C;AAgDD,8EAA8E;AAC9E,wBAAsB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBvE;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBvE"}

package/dist/src/core/helpers/transition.js

@@ -0,0 +1,118 @@
+/**
+ * Transition enter/leave cho element — `@transition('fade')`.
+ *
+ * # Quy ước class (giống Vue, để người dùng không phải học lại)
+ *   enter: `{n}-enter-from` `{n}-enter-active` → frame sau → `{n}-enter-to`
+ *   leave: `{n}-leave-from` `{n}-leave-active` → frame sau → `{n}-leave-to`
+ * `-active` có mặt suốt quá trình (chỗ đặt `transition:`), `-from`/`-to` là
+ * hai đầu giá trị.
+ *
+ * # Vì sao dùng `getAnimations()` chứ không nghe `transitionend`
+ * `transitionend` bắn MỘT lần cho MỖI property, không bắn nếu giá trị không
+ * đổi, và không phân biệt transition của element với của con nó — nên cách
+ * làm kinh điển phải parse `transition-duration` + hẹn giờ dự phòng.
+ * `element.getAnimations()` trả thẳng mọi animation/transition đang chạy trên
+ * element kèm promise `.finished`, xử lý đúng cả trường hợp nhiều property và
+ * bị huỷ giữa chừng. Không có animation nào → resolve ngay → hành vi y hệt
+ * lúc chưa có transition (đây cũng là đường chạy trong jsdom).
+ *
+ * # Vì sao cần `isLeaving()`
+ * Element rời đi phải NẰM LẠI DOM tới khi animation xong, trong khi
+ * `Reactive.clearContent()`/`_cleanOrphanNodes()` quét sạch mọi node giữa cặp
+ * marker. Hai vòng quét đó phải bỏ qua node đang leave, nếu không node bị giật
+ * đi ngay và animation không bao giờ thấy được.
+ */
+/** Node đang chạy leave — vòng quét DOM giữa marker phải BỎ QUA. */
+const leavingNodes = new WeakSet();
+/** Sequence hiện tại của mỗi element — chống enter/leave chồng nhau (reorder). */
+const generation = new WeakMap();
+/** True khi node đang chạy leave và chưa được gỡ. */
+export function isLeaving(node) {
+    return leavingNodes.has(node);
+}
+function bump(el) {
+    const next = (generation.get(el) ?? 0) + 1;
+    generation.set(el, next);
+    return next;
+}
+const isCurrent = (el, token) => generation.get(el) === token;
+/** Đợi sang frame kế — để trình duyệt kịp áp `-from` trước khi đổi sang `-to`. */
+function nextFrame() {
+    return new Promise(resolve => {
+        if (typeof requestAnimationFrame !== 'function')
+            return resolve();
+        requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
+    });
+}
+/**
+ * Đợi mọi animation/transition trên element kết thúc.
+ * `allSettled` vì `.finished` REJECT khi animation bị huỷ — với ta thì huỷ
+ * cũng là xong, không phải lỗi.
+ *
+ * ponytail: animation vô hạn (`animation-iteration-count: infinite`) trên
+ * element đang leave sẽ giữ node lại mãi. Thêm timeout trần nếu gặp thật.
+ */
+async function whenAnimationsDone(el) {
+    const getAnimations = el.getAnimations;
+    if (typeof getAnimations !== 'function')
+        return; // jsdom / browser cũ
+    const running = getAnimations.call(el);
+    if (!running || running.length === 0)
+        return;
+    await Promise.allSettled(running.map(a => a.finished));
+}
+const classesOf = (name, phase) => ({
+    from: `${name}-${phase}-from`,
+    active: `${name}-${phase}-active`,
+    to: `${name}-${phase}-to`,
+});
+/** Gỡ mọi class transition của cả 2 phase — dùng khi bị huỷ giữa chừng. */
+function clearClasses(el, name) {
+    for (const phase of ['enter', 'leave']) {
+        const c = classesOf(name, phase);
+        el.classList.remove(c.from, c.active, c.to);
+    }
+}
+/** Chạy enter. Bị enter/leave khác chen ngang → thoát, không đụng DOM nữa. */
+export async function runEnter(el, name) {
+    const token = bump(el);
+    const c = classesOf(name, 'enter');
+    clearClasses(el, name);
+    el.classList.add(c.from, c.active);
+    await nextFrame();
+    if (!isCurrent(el, token))
+        return;
+    el.classList.remove(c.from);
+    el.classList.add(c.to);
+    await whenAnimationsDone(el);
+    if (!isCurrent(el, token))
+        return;
+    el.classList.remove(c.active, c.to);
+}
+/**
+ * Chạy leave rồi GỠ node. Trả promise resolve sau khi node đã rời DOM.
+ * Element được đánh dấu leaving ngay lập tức để không ai giật mất giữa chừng.
+ */
+export async function runLeave(el, name) {
+    const token = bump(el);
+    const c = classesOf(name, 'leave');
+    leavingNodes.add(el);
+    clearClasses(el, name);
+    el.classList.add(c.from, c.active);
+    await nextFrame();
+    if (!isCurrent(el, token)) {
+        leavingNodes.delete(el);
+        return;
+    }
+    el.classList.remove(c.from);
+    el.classList.add(c.to);
+    await whenAnimationsDone(el);
+    if (!isCurrent(el, token)) {
+        leavingNodes.delete(el);
+        return;
+    }
+    leavingNodes.delete(el);
+    el.classList.remove(c.active, c.to);
+    el.remove();
+}
+//# sourceMappingURL=transition.js.map

package/dist/src/core/helpers/transition.js.map

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

package/dist/src/core/helpers/utils.d.ts

@@ -0,0 +1,26 @@
+export declare function generateUUID(length?: number): string;
+export declare function escapeHTML(str: string): string;
+export declare function isEmpty(value: any): boolean;
+export declare function isObject(value: any): boolean;
+export declare function hasProperty(obj: any, prop: string): boolean;
+export declare function hasMethod(obj: any, method: string): boolean;
+export declare function hasAnyProperty(obj: any, props: string[]): boolean;
+export declare function hasData(value: any): boolean;
+export declare function isArray(value: any): boolean;
+export declare function isString(value: any): boolean;
+export declare function isNumber(value: any): boolean;
+export declare function isBoolean(value: any): boolean;
+export declare function isFunction(value: any): boolean;
+export declare function isPromise(value: any): boolean;
+export declare function isHTMLElement(value: any): boolean;
+export declare function isNode(value: any): boolean;
+export declare function isCommentNode(value: any): boolean;
+export declare function isTextNode(value: any): boolean;
+export declare function isSaoElement(value: any): boolean;
+export declare function isOneHtml(value: any): boolean;
+export declare function isOneText(value: any): boolean;
+export declare function isOneNativeElement(value: any): boolean;
+export declare function isOneReactive(value: any): boolean;
+export declare function isSaoFragment(value: any): boolean;
+export declare function isOneBlock(value: any): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/core/helpers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/core/helpers/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAMxD;AAUD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAM3C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE5C;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjE;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE3C;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE3C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE5C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE5C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE9C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEjD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE1C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEhD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE9C"}

package/dist/src/core/helpers/utils.js

@@ -0,0 +1,96 @@
+export function generateUUID(length = 36) {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    }).substring(0, length);
+}
+const htmlEscapeMap = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+const htmlEscapeRe = /[&<>"']/g;
+export function escapeHTML(str) {
+    return str.replace(htmlEscapeRe, (ch) => htmlEscapeMap[ch]);
+}
+export function isEmpty(value) {
+    if (value == null)
+        return true;
+    if (typeof value === 'string' && value.trim() === '')
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    if (typeof value === 'object' && Object.keys(value).length === 0)
+        return true;
+    return false;
+}
+export function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function hasProperty(obj, prop) {
+    return obj != null && Object.prototype.hasOwnProperty.call(obj, prop);
+}
+export function hasMethod(obj, method) {
+    return obj != null && typeof obj[method] === 'function';
+}
+export function hasAnyProperty(obj, props) {
+    return obj != null && props.some(prop => Object.prototype.hasOwnProperty.call(obj, prop));
+}
+export function hasData(value) {
+    return isObject(value) && Object.keys(value).length > 0;
+}
+export function isArray(value) {
+    return Array.isArray(value);
+}
+export function isString(value) {
+    return typeof value === 'string';
+}
+export function isNumber(value) {
+    return typeof value === 'number' && !isNaN(value);
+}
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+export function isFunction(value) {
+    return typeof value === 'function';
+}
+export function isPromise(value) {
+    return value instanceof Promise || (value !== null && typeof value === 'object' && typeof value.then === 'function');
+}
+export function isHTMLElement(value) {
+    return value instanceof HTMLElement;
+}
+export function isNode(value) {
+    return value instanceof Node;
+}
+export function isCommentNode(value) {
+    return value instanceof Comment;
+}
+export function isTextNode(value) {
+    return value instanceof Text;
+}
+export function isSaoElement(value) {
+    return value && typeof value === 'object' && 'isSaoElement' in value && value.isSaoElement === true;
+}
+export function isOneHtml(value) {
+    return value && typeof value === 'object' && 'isOneHtml' in value && value.isOneHtml === true;
+}
+export function isOneText(value) {
+    return value && typeof value === 'object' && 'isOneText' in value && value.isOneText === true;
+}
+export function isOneNativeElement(value) {
+    return value && typeof value === 'object' && 'isOneNativeElement' in value && value.isOneNativeElement === true;
+}
+export function isOneReactive(value) {
+    return value && typeof value === 'object' && 'isOneReactive' in value && value.isOneReactive === true;
+}
+export function isSaoFragment(value) {
+    return value && typeof value === 'object' && 'isSaoFragment' in value && value.isSaoFragment === true;
+}
+export function isOneBlock(value) {
+    return value && typeof value === 'object' && 'isOneBlock' in value && value.isOneBlock === true;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/core/helpers/utils.js.map

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

package/dist/src/core/helpers/view.d.ts

@@ -0,0 +1,39 @@
+import type { HtmlInterface, SaoNodeInterface, SaoElementChildren, DOMElement, WrapperInterface, SaoChildrenFactoryOutput } from "../contracts/ElementInterface.js";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface.js";
+/** Commit initial data; hydration discards pending notifications before subscribe. */
+export declare function commitView(ctrl: ViewControllerInterface, discardPending?: boolean): void;
+/** Flush state + reactive queues after a lifecycle transition. */
+export declare function flushView(ctrl: ViewControllerInterface): void;
+/** Start a view through its controller, then make the initial DOM snapshot current. */
+export declare function activateView(ctrl: ViewControllerInterface): void;
+/**
+ * Claim an already-rendered Wrapper tree without inserting or clearing DOM.
+ * Used by both route hydration and nested @include hydration.
+ */
+export declare function claimHydratedView(ctrl: ViewControllerInterface, root: HtmlInterface, wrapper?: WrapperInterface | null): void;
+/**
+ * Mount danh sách children vào TRƯỚC một anchor node (RUNTIME_CONTRACT.md §2 —
+ * insertion point tường minh). Dùng cho Component (@include), và mọi chỗ cần
+ * mount content vào giữa cặp markers có sẵn.
+ */
+export declare function mountChildrenBeforeAnchor(anchor: Node, children: SaoChildrenFactoryOutput | SaoElementChildren, parentForSao: HtmlInterface | null): void;
+/**
+ * Hydrate mode: gọi render() đệ quy trên children để tạo JS objects
+ * và claim DOM nodes, nhưng KHÔNG appendChild/insertBefore vào DOM
+ * (vì DOM đã có từ server-rendered HTML).
+ *
+ * Khác mountElementList ở chỗ: bỏ mọi thao tác DOM mutation,
+ * chỉ giữ lại phần tạo element tree + gán parent.
+ */
+export declare function hydrateElementList(root: HtmlInterface, elements: SaoElementChildren): void;
+/**
+ * Mounts a list of SaoNodeInterface elements into a given root HtmlInterface.
+ * This function is responsible for appending the DOM nodes of each element
+ * to the root's DOM element and returning the list of mounted DOM nodes.
+ * @param root - The HtmlInterface to mount the elements into.
+ * @param elements - An array of SaoNodeInterface elements to be mounted.
+ * @returns An array of the mounted DOM nodes.
+ */
+export declare function mountElementList(root: HtmlInterface, elements: SaoNodeInterface[] | DOMElement[] | SaoElementChildren): Element[];
+export declare function mountElementListBefore(root: HtmlInterface, elements: SaoNodeInterface[] | DOMElement[] | SaoElementChildren): Element[];
+//# sourceMappingURL=view.d.ts.map

package/dist/src/core/helpers/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../../src/core/helpers/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAc,UAAU,EAAE,gBAAgB,EAAiB,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC/L,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,uBAAuB,EAAE,cAAc,GAAE,OAAe,GAAG,IAAI,CAG/F;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAG7D;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAGhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,uBAAuB,EAC7B,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,gBAAgB,GAAG,IAAuB,GACpD,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,wBAAwB,GAAG,kBAAkB,EACvD,YAAY,EAAE,aAAa,GAAG,IAAI,GACnC,IAAI,CAwBN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAsC1F;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,UAAU,EAAE,GAAG,kBAAkB,GAAG,OAAO,EAAE,CA4EjI;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,UAAU,EAAE,GAAG,kBAAkB,GAAG,OAAO,EAAE,CA4EvI"}