@saolabs/client 1.0.0

package/dist/src/core/bootstrap/providers/ViewServiceProvider.d.ts

@@ -0,0 +1,9 @@
+import { ServiceProvider } from "./ServiceProvider";
+export declare class ViewServiceProvider extends ServiceProvider {
+    readonly name: "view";
+    readonly dependsOn: "core"[];
+    static config: Record<string, any>;
+    register(): void;
+    boot(): void;
+}
+//# sourceMappingURL=ViewServiceProvider.d.ts.map

package/dist/src/core/bootstrap/providers/ViewServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewServiceProvider.d.ts","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/ViewServiceProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,mBAAoB,SAAQ,eAAe;IACpD,QAAQ,CAAC,IAAI,SAAuB;IACpC,QAAQ,CAAC,SAAS,WAAyB;IAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;IAExC,QAAQ,IAAI,IAAI;IAIhB,IAAI,IAAI,IAAI;CAGf"}

package/dist/src/core/bootstrap/providers/ViewServiceProvider.js

@@ -0,0 +1,18 @@
+import { ViewManager } from "../../view";
+import { PROVIDER_NAMES } from "./provider-order";
+import { ServiceProvider } from "./ServiceProvider";
+export class ViewServiceProvider extends ServiceProvider {
+    constructor() {
+        super(...arguments);
+        this.name = PROVIDER_NAMES.VIEW;
+        this.dependsOn = [PROVIDER_NAMES.CORE];
+    }
+    register() {
+        this.app.set("View", new ViewManager(this.app), true);
+    }
+    boot() {
+        this.app.get("View").init(ViewServiceProvider.config);
+    }
+}
+ViewServiceProvider.config = {};
+//# sourceMappingURL=ViewServiceProvider.js.map

package/dist/src/core/bootstrap/providers/ViewServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewServiceProvider.js","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/ViewServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IAAxD;;QACa,SAAI,GAAG,cAAc,CAAC,IAAI,CAAC;QAC3B,cAAS,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAU/C,CAAC;IAPG,QAAQ;QACJ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAc,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,IAAI;QACA,IAAI,CAAC,GAAG,CAAC,GAAG,CAAc,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvE,CAAC;;AARM,0BAAM,GAAwB,EAAE,AAA1B,CAA2B"}

package/dist/src/core/bootstrap/providers/default-providers.d.ts

@@ -0,0 +1,14 @@
+import { NamedServiceProvider } from "./provider-order";
+/**
+ * Tạo danh sách providers mặc định.
+ *
+ * Hỗ trợ:
+ * - Config cho service mặc định: `config.view`, `config.router`, `config.api`
+ * - Liệt kê provider class: `config.providers = [AuthServiceProvider, NotificationProvider]`
+ * - Liệt kê provider instance: `config.providers = [new AuthServiceProvider()]`
+ * - Đăng ký service đơn giản: `config.services = { Auth: AuthService, Toast: ToastService }`
+ *
+ * System providers (core, view, router, helper, api) luôn chạy trước và không thể bị ghi đè.
+ */
+export declare function buildDefaultProviders(config?: Record<string, any>): NamedServiceProvider[];
+//# sourceMappingURL=default-providers.d.ts.map

package/dist/src/core/bootstrap/providers/default-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-providers.d.ts","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/default-providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAkB,MAAM,kBAAkB,CAAC;AA6CxE;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,oBAAoB,EAAE,CAmC9F"}

package/dist/src/core/bootstrap/providers/default-providers.js

@@ -0,0 +1,79 @@
+import { app } from "../../hellpers/app";
+import { PROVIDER_NAMES } from "./provider-order";
+import { ApiServiceProvider } from "./ApiServiceProvider";
+import { CoreServiceProvider } from "./CoreServiceProvider";
+import { HelperServiceProvider } from "./HelperServiceProvider";
+import { RouteServiceProvider } from "./RouteServiceProvider";
+import { ViewServiceProvider } from "./ViewServiceProvider";
+/** Tên system providers — không cho phép override */
+const SYSTEM_PROVIDER_NAMES = new Set(Object.values(PROVIDER_NAMES));
+/** Tên system services — không cho phép ghi đè qua config.services */
+const SYSTEM_SERVICE_KEYS = new Set(['Marker', 'Store', 'Storage', 'Event', 'Http', 'View', 'Router', 'Helper', 'API']);
+/**
+ * Chuyển `config.services` dạng { name: Class } thành NamedServiceProvider[].
+ *
+ * @example
+ * services: { Auth: AuthService, Toast: ToastService }
+ * → 2 providers, mỗi cái dependsOn ['core'], register = app.set(name, new Class(app))
+ */
+function servicesFromMap(map) {
+    const appInstance = app();
+    return Object.entries(map)
+        .filter(([name]) => {
+        if (SYSTEM_SERVICE_KEYS.has(name)) {
+            console.warn(`[Bootstrap] Cannot override system service "${name}" via config.services. Ignored.`);
+            return false;
+        }
+        return true;
+    })
+        .map(([name, ServiceClass]) => ({
+        name,
+        dependsOn: [PROVIDER_NAMES.CORE],
+        register() {
+            appInstance.set(name, new ServiceClass(appInstance));
+        }
+    }));
+}
+/**
+ * Tạo danh sách providers mặc định.
+ *
+ * Hỗ trợ:
+ * - Config cho service mặc định: `config.view`, `config.router`, `config.api`
+ * - Liệt kê provider class: `config.providers = [AuthServiceProvider, NotificationProvider]`
+ * - Liệt kê provider instance: `config.providers = [new AuthServiceProvider()]`
+ * - Đăng ký service đơn giản: `config.services = { Auth: AuthService, Toast: ToastService }`
+ *
+ * System providers (core, view, router, helper, api) luôn chạy trước và không thể bị ghi đè.
+ */
+export function buildDefaultProviders(config = {}) {
+    // Set static config cho default providers trước khi tạo instance
+    ViewServiceProvider.config = config.view || {};
+    RouteServiceProvider.config = config.router || {};
+    ApiServiceProvider.config = config.api || {};
+    const App = app();
+    const defaults = [
+        CoreServiceProvider,
+        ViewServiceProvider,
+        RouteServiceProvider,
+        HelperServiceProvider,
+        ApiServiceProvider,
+    ].map(Cls => new Cls(App));
+    // config.services: { Name: Class } → auto-wrap providers
+    const serviceProviders = config.services
+        ? servicesFromMap(config.services)
+        : [];
+    // config.providers: (ProviderClass | NamedServiceProvider)[] → instantiate classes
+    const customProviders = Array.isArray(config.providers)
+        ? config.providers
+            .map((p) => typeof p === 'function' ? new p(App) : p)
+            .filter(p => {
+            if (SYSTEM_PROVIDER_NAMES.has(p.name)) {
+                console.warn(`[Bootstrap] Cannot override system provider "${p.name}". Ignored.`);
+                return false;
+            }
+            return true;
+        })
+        : [];
+    return [...defaults, ...serviceProviders, ...customProviders];
+}
+//# sourceMappingURL=default-providers.js.map

package/dist/src/core/bootstrap/providers/default-providers.js.map

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

package/dist/src/core/bootstrap/providers/index.d.ts

@@ -0,0 +1,10 @@
+export { NamedServiceProvider, resolveProviderOrder, PROVIDER_NAMES } from './provider-order';
+export type { ProviderName } from './provider-order';
+export { ServiceProvider } from './ServiceProvider';
+export { buildDefaultProviders } from './default-providers';
+export { CoreServiceProvider } from './CoreServiceProvider';
+export { ViewServiceProvider } from './ViewServiceProvider';
+export { RouteServiceProvider } from './RouteServiceProvider';
+export { HelperServiceProvider } from './HelperServiceProvider';
+export { ApiServiceProvider } from './ApiServiceProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/bootstrap/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9F,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/core/bootstrap/providers/index.js

@@ -0,0 +1,9 @@
+export { resolveProviderOrder, PROVIDER_NAMES } from './provider-order';
+export { ServiceProvider } from './ServiceProvider';
+export { buildDefaultProviders } from './default-providers';
+export { CoreServiceProvider } from './CoreServiceProvider';
+export { ViewServiceProvider } from './ViewServiceProvider';
+export { RouteServiceProvider } from './RouteServiceProvider';
+export { HelperServiceProvider } from './HelperServiceProvider';
+export { ApiServiceProvider } from './ApiServiceProvider';
+//# sourceMappingURL=index.js.map

package/dist/src/core/bootstrap/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/core/bootstrap/providers/provider-order.d.ts

@@ -0,0 +1,19 @@
+import type { ServiceProviderInterface } from "../../contracts/ServiceProviderInterface";
+/**
+ * Tên các provider mặc định — dùng constant thay vì magic string.
+ * Custom providers có thể dùng tên khác hoặc override tên mặc định.
+ */
+export declare const PROVIDER_NAMES: {
+    readonly CORE: "core";
+    readonly VIEW: "view";
+    readonly ROUTER: "router";
+    readonly HELPER: "helper";
+    readonly API: "api";
+};
+export type ProviderName = typeof PROVIDER_NAMES[keyof typeof PROVIDER_NAMES];
+export type NamedServiceProvider = ServiceProviderInterface & {
+    name: string;
+    dependsOn?: string[];
+};
+export declare function resolveProviderOrder(providers: ServiceProviderInterface[]): ServiceProviderInterface[];
+//# sourceMappingURL=provider-order.d.ts.map

package/dist/src/core/bootstrap/providers/provider-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-order.d.ts","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/provider-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CA4CtG"}

package/dist/src/core/bootstrap/providers/provider-order.js

@@ -0,0 +1,51 @@
+/**
+ * Tên các provider mặc định — dùng constant thay vì magic string.
+ * Custom providers có thể dùng tên khác hoặc override tên mặc định.
+ */
+export const PROVIDER_NAMES = {
+    CORE: 'core',
+    VIEW: 'view',
+    ROUTER: 'router',
+    HELPER: 'helper',
+    API: 'api',
+};
+export function resolveProviderOrder(providers) {
+    const providerMap = new Map();
+    for (const provider of providers) {
+        if (!provider.name) {
+            throw new Error(`[Bootstrap] Provider name is required.`);
+        }
+        if (providerMap.has(provider.name)) {
+            throw new Error(`[Bootstrap] Duplicate provider name detected: "${provider.name}".`);
+        }
+        providerMap.set(provider.name, provider);
+    }
+    const visited = new Set();
+    const inStack = new Set();
+    const ordered = [];
+    const visit = (name) => {
+        if (visited.has(name))
+            return;
+        if (inStack.has(name)) {
+            throw new Error(`[Bootstrap] Circular service provider dependency detected at "${name}".`);
+        }
+        const provider = providerMap.get(name);
+        if (!provider) {
+            throw new Error(`[Bootstrap] Missing provider dependency: "${name}".`);
+        }
+        inStack.add(name);
+        for (const dep of provider.dependsOn ?? []) {
+            visit(dep);
+        }
+        inStack.delete(name);
+        visited.add(name);
+        ordered.push(provider);
+    };
+    for (const provider of providers) {
+        if (provider.name) {
+            visit(provider.name);
+        }
+    }
+    return ordered;
+}
+//# sourceMappingURL=provider-order.js.map

package/dist/src/core/bootstrap/providers/provider-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-order.js","sourceRoot":"","sources":["../../../../../src/core/bootstrap/providers/provider-order.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACJ,CAAC;AASX,MAAM,UAAU,oBAAoB,CAAC,SAAqC;IACtE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoC,CAAC;IAChE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QACzF,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAA+B,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAG,CAAC,IAAY,EAAQ,EAAE;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iEAAiE,IAAI,IAAI,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,IAAI,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACzC,KAAK,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/src/core/cache/ViewCache.d.ts

@@ -0,0 +1,46 @@
+import type { ViewCacheInterface } from "../contracts/ViewCacheInterface";
+/**
+ * ViewCache — stores rendered view DOM for instant restore on navigation.
+ *
+ * When a user navigates away from a page, the view's DOM is detached and
+ * stored in a DocumentFragment. When navigating back, the DOM is
+ * re-attached instead of re-rendered — preserving form inputs, scroll
+ * positions, and in-progress user work.
+ *
+ * Used by the router/BlockManager to implement "keep-alive" behavior.
+ *
+ * @example
+ * // Router navigates away from 'home'
+ * cache.store('home', homeRootElement);
+ *
+ * // Router navigates back to 'home'
+ * const cached = cache.retrieve('home');
+ * if (cached) container.appendChild(cached); // instant restore!
+ */
+export declare class ViewCache implements ViewCacheInterface {
+    private cache;
+    /** Maximum cached views (LRU eviction when exceeded) */
+    private maxSize;
+    /** Access order tracking for LRU */
+    private accessOrder;
+    constructor(maxSize?: number);
+    /** Store a view's DOM state */
+    store(viewId: string, element: HTMLElement | DocumentFragment): void;
+    /** Retrieve cached DOM — returns null if not cached */
+    retrieve(viewId: string): HTMLElement | DocumentFragment | null;
+    /** Check if a view is cached */
+    has(viewId: string): boolean;
+    /** Remove a specific view from cache */
+    remove(viewId: string): void;
+    /** Clear all cached views */
+    clear(): void;
+    /** Get number of cached views */
+    get size(): number;
+    /** Get all cached view IDs */
+    keys(): string[];
+    /** Move viewId to end of access order (most recently used) */
+    private touchAccess;
+    /** Remove the least recently used cached view */
+    private evictOldest;
+}
+//# sourceMappingURL=ViewCache.d.ts.map

package/dist/src/core/cache/ViewCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewCache.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/ViewCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,YAAW,kBAAkB;IAChD,OAAO,CAAC,KAAK,CAA0D;IAEvE,wDAAwD;IACxD,OAAO,CAAC,OAAO,CAAS;IAExB,oCAAoC;IACpC,OAAO,CAAC,WAAW,CAAgB;gBAEvB,OAAO,GAAE,MAAW;IAIhC,+BAA+B;IAC/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,gBAAgB,GAAG,IAAI;IAiBpE,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,gBAAgB,GAAG,IAAI;IAQ/D,gCAAgC;IAChC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,wCAAwC;IACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAKb,iCAAiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8BAA8B;IAC9B,IAAI,IAAI,MAAM,EAAE;IAMhB,8DAA8D;IAC9D,OAAO,CAAC,WAAW;IAKnB,iDAAiD;IACjD,OAAO,CAAC,WAAW;CAKtB"}

package/dist/src/core/cache/ViewCache.js

@@ -0,0 +1,85 @@
+/**
+ * ViewCache — stores rendered view DOM for instant restore on navigation.
+ *
+ * When a user navigates away from a page, the view's DOM is detached and
+ * stored in a DocumentFragment. When navigating back, the DOM is
+ * re-attached instead of re-rendered — preserving form inputs, scroll
+ * positions, and in-progress user work.
+ *
+ * Used by the router/BlockManager to implement "keep-alive" behavior.
+ *
+ * @example
+ * // Router navigates away from 'home'
+ * cache.store('home', homeRootElement);
+ *
+ * // Router navigates back to 'home'
+ * const cached = cache.retrieve('home');
+ * if (cached) container.appendChild(cached); // instant restore!
+ */
+export class ViewCache {
+    constructor(maxSize = 10) {
+        this.cache = new Map();
+        /** Access order tracking for LRU */
+        this.accessOrder = [];
+        this.maxSize = maxSize;
+    }
+    /** Store a view's DOM state */
+    store(viewId, element) {
+        // If already cached, update
+        if (this.cache.has(viewId)) {
+            this.cache.set(viewId, element);
+            this.touchAccess(viewId);
+            return;
+        }
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.maxSize) {
+            this.evictOldest();
+        }
+        this.cache.set(viewId, element);
+        this.accessOrder.push(viewId);
+    }
+    /** Retrieve cached DOM — returns null if not cached */
+    retrieve(viewId) {
+        const cached = this.cache.get(viewId) ?? null;
+        if (cached) {
+            this.touchAccess(viewId);
+        }
+        return cached;
+    }
+    /** Check if a view is cached */
+    has(viewId) {
+        return this.cache.has(viewId);
+    }
+    /** Remove a specific view from cache */
+    remove(viewId) {
+        this.cache.delete(viewId);
+        this.accessOrder = this.accessOrder.filter(id => id !== viewId);
+    }
+    /** Clear all cached views */
+    clear() {
+        this.cache.clear();
+        this.accessOrder = [];
+    }
+    /** Get number of cached views */
+    get size() {
+        return this.cache.size;
+    }
+    /** Get all cached view IDs */
+    keys() {
+        return [...this.cache.keys()];
+    }
+    // ─── Private ────────────────────────────────────────────────
+    /** Move viewId to end of access order (most recently used) */
+    touchAccess(viewId) {
+        this.accessOrder = this.accessOrder.filter(id => id !== viewId);
+        this.accessOrder.push(viewId);
+    }
+    /** Remove the least recently used cached view */
+    evictOldest() {
+        if (this.accessOrder.length === 0)
+            return;
+        const oldest = this.accessOrder.shift();
+        this.cache.delete(oldest);
+    }
+}
+//# sourceMappingURL=ViewCache.js.map

package/dist/src/core/cache/ViewCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewCache.js","sourceRoot":"","sources":["../../../../src/core/cache/ViewCache.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,SAAS;IASlB,YAAY,UAAkB,EAAE;QARxB,UAAK,GAAgD,IAAI,GAAG,EAAE,CAAC;QAKvE,oCAAoC;QAC5B,gBAAW,GAAa,EAAE,CAAC;QAG/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,MAAc,EAAE,OAAuC;QACzD,4BAA4B;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;QACX,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,QAAQ,CAAC,MAAc;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,gCAAgC;IAChC,GAAG,CAAC,MAAc;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,MAAc;QACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,8BAA8B;IAC9B,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,+DAA+D;IAE/D,8DAA8D;IACtD,WAAW,CAAC,MAAc;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,iDAAiD;IACzC,WAAW;QACf,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAG,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ"}

package/dist/src/core/cache/index.d.ts

@@ -0,0 +1,2 @@
+export { ViewCache } from './ViewCache';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/core/cache/index.js

@@ -0,0 +1,2 @@
+export { ViewCache } from './ViewCache';
+//# sourceMappingURL=index.js.map

package/dist/src/core/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,11 @@
+import { HttpService } from '../services/HttpService.js';
+export interface APIClientInterface {
+    init(config: Record<string, any>): void;
+    getViewData<T = any>(uri: string): Promise<T>;
+    getSystemConfig<T = any>(): Promise<T>;
+    getSystemData<T = any>(): Promise<T>;
+    getURIData<T = any>(): Promise<T>;
+    setEndpoint(key: string, value: string): void;
+    getHttpService(): HttpService;
+}
+//# sourceMappingURL=ApiInterface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApiInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ApiInterface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,eAAe,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,aAAa,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrC,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAClC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,cAAc,IAAI,WAAW,CAAC;CACjC"}

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

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

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

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

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

@@ -0,0 +1,66 @@
+import { RouterInterface, ViewManagerInterface } from "./utils";
+import type { HelperInterface } from "./HelperInterface";
+import type { EventServiceInterface } from "./EventServiceInterface";
+import type { HttpServiceInterface } from "./HttpServiceInterface";
+import type { StoreServiceInterface } from "./StoreServiceInterface";
+import type { StorageServiceInterface } from "./StorageServiceInterface";
+import type { LoggerServiceInterface } from "./LoggerServiceInterface";
+import { APIClientInterface } from "./ApiInterface";
+import type { ServiceProviderInterface } from "./ServiceProviderInterface";
+import { OneObjectType } from "../types/utils";
+export interface ApplicationInterface {
+    [key: string]: any;
+    transient<T>(key: ServiceKey, value: any): this;
+    bind<T>(key: ServiceKey, value: any): this;
+    singleton<T>(key: ServiceKey, value?: any): this;
+    instance<T>(key: ServiceKey, value: T): this;
+    alias(alias: string | symbol, key: ServiceKey): this;
+    make<T>(key: ServiceKey, defaultValue?: T): T;
+    resolve<T>(key: ServiceKey, defaultValue?: T): T;
+    has(key: ServiceKey): boolean;
+    bound(key: ServiceKey): boolean;
+    register(provider: ServiceProviderInterface): this;
+    boot(): void;
+    flush(): void;
+    destroy(): void;
+    set<T = any>(name: string, method: T, isOne?: boolean): void;
+    setMethod(name: string, method: Function, isOne?: boolean): void;
+    get<T = any>(name: string): T;
+    oneType?: OneObjectType;
+    isInitialized: boolean;
+    isStarted: boolean;
+    View: ViewManagerInterface;
+    Router: RouterInterface;
+    Helper: HelperInterface;
+    Events: EventServiceInterface;
+    Http: HttpServiceInterface;
+    API: APIClientInterface;
+    Store: StoreServiceInterface;
+    Storage: StorageServiceInterface;
+    Logger: LoggerServiceInterface;
+}
+/** Type cho helper function app() — callable + có methods */
+export interface AppFactory {
+    <T>(): T;
+    (): ApplicationInterface;
+    <T>(key: ServiceKey): T;
+    (key: ServiceKey, value: any): ApplicationInterface;
+    make<T>(name: ServiceKey): T;
+    make<T>(name: ServiceKey, defaultValue: T): T;
+    instance<T>(name: ServiceKey, value: T): ApplicationInterface;
+    resolve<T>(name: ServiceKey): T;
+    resolve<T>(name: ServiceKey, defaultValue: T): T;
+    register<T>(name: ServiceKey, factory: () => T): ApplicationInterface;
+    bind<T>(name: ServiceKey, factory: () => T): ApplicationInterface;
+    singleton<T>(name: ServiceKey, factory: () => T): ApplicationInterface;
+    has(name: ServiceKey): boolean;
+    flush(): void;
+    destroy(): void;
+}
+/** Định danh duy nhất cho service: string, symbol, hoặc class constructor */
+export type ServiceKey<T = any> = string | symbol | (new (...args: any[]) => T);
+/** Factory function nhận app (container) để resolve dependencies */
+export type ServiceFactory<T> = (app: ApplicationInterface) => T;
+/** Giá trị có thể bind: factory function hoặc class constructor */
+export type ServiceBinding<T = any> = ServiceFactory<T> | (new (...args: any[]) => T);
+//# sourceMappingURL=ApplicationInterface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/ApplicationInterface.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IAC9B,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnD,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjE,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAE9B,OAAO,CAAC,EAAE,aAAa,CAAC;IAGxB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,GAAG,EAAE,kBAAkB,CAAC;IACxB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,sBAAsB,CAAC;CAClC;AAID,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACvB,CAAC,CAAC,KAAK,CAAC,CAAC;IACT,IAAI,oBAAoB,CAAC;IACzB,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC;IACxB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,GAAG,oBAAoB,CAAC;IACpD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9C,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,oBAAoB,CAAC;IAC9D,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IACjD,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,oBAAoB,CAAC;IACtE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,oBAAoB,CAAC;IAClE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,oBAAoB,CAAC;IACvE,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC/B,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACnB;AAID,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAEhF,oEAAoE;AACpE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,KAAK,CAAC,CAAC;AAEjE,mEAAmE;AACnE,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,3 @@
+// ─── Application Interface ───────────────────────────────────────
+export {};
+//# sourceMappingURL=ApplicationInterface.js.map

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

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

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

@@ -0,0 +1,67 @@
+import type { OneObjectType } from "../types/utils";
+import type { ViewControllerInterface } from "./ViewControllerInterface";
+import type { HtmlInterface, FragmentInterface, OneChildrenFactoryOutput, OneNodeInterface } from "./ElementInterface";
+import { InitMode } from "./common";
+export type BlockConstructorParams = {
+    ctx: ViewControllerInterface;
+    name: string;
+    viewId?: string | null;
+    contentRenderFactory?: BlockRenderFactory;
+    id?: string | null;
+    initMode?: InitMode;
+};
+export interface BlockInterface {
+    oneType: OneObjectType;
+    /** Unique block slot name (e.g. 'content', 'sidebar') */
+    name: string;
+    id: string;
+    ctx: ViewControllerInterface;
+    viewId: string | null;
+    openTag: Comment;
+    closeTag: Comment;
+    fragment: FragmentInterface | null;
+    parentElement: HtmlInterface | null;
+    domChildren: Node[];
+    isOneElement: boolean;
+    isOneBlock: boolean;
+    initMode?: InitMode;
+    /** Initialize the block (e.g. during hydration) */
+    init(): void;
+    /** Render the block's content into the parent element */
+    render(): void;
+    /** Mount the block's content into the DOM, finding matching outlets */
+    mount(mountCtx: ViewControllerInterface, parentElement: HtmlInterface): any;
+    /** Unmount the block's content from the DOM */
+    unmount(): void;
+    /** Destroy the block and clean up resources */
+    destroy(): void;
+    /** Update the block's content (e.g. on state change) */
+    update(): void;
+    /** Set the block's parent element (used for mounting) */
+    setParentElement(parentElement: HtmlInterface | null): void;
+    contentRenderFactory: BlockRenderFactory | null;
+}
+export interface BlockOutletInterface extends OneNodeInterface {
+    oneType: OneObjectType;
+    id: string;
+    name: string;
+    parent: HtmlInterface | null;
+    openTag: Comment;
+    closeTag: Comment;
+    parentElement: HtmlInterface | null;
+    ctx: ViewControllerInterface;
+    initMode: InitMode;
+    isOneElement: boolean;
+    isOneBlockOutlet: boolean;
+    /** Render the outlet's markers into the parent element */
+    render(): any;
+    hydrate(): any;
+    destroy(): any;
+    start(): any;
+    stop(): any;
+    setParentElement(parentElement: HtmlInterface | null): any;
+}
+export interface BlockManagerInterface {
+}
+export type BlockRenderFactory = (parentElement: HtmlInterface) => OneChildrenFactoryOutput;
+//# sourceMappingURL=BlockInterface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlockInterface.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/BlockInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC,MAAM,MAAM,sBAAsB,GAAG;IACjC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;IAC1C,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB,CAAC;AACF,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACnB,mDAAmD;IACpD,IAAI,IAAI,IAAI,CAAC;IACZ,yDAAyD;IAC1D,MAAM,IAAI,IAAI,CAAC;IACd,uEAAuE;IACxE,KAAK,CAAC,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,GAAG,GAAG,CAAC;IAC3E,+CAA+C;IAChD,OAAO,IAAI,IAAI,CAAC;IACf,+CAA+C;IAChD,OAAO,IAAI,IAAI,CAAC;IACf,wDAAwD;IACzD,MAAM,IAAI,IAAI,CAAC;IACd,yDAAyD;IAC1D,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;IAE5D,oBAAoB,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAEnD;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,OAAO,EAAE,aAAa,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IACzB,0DAA0D;IAC3D,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,IAAI,GAAG,CAAC;IACf,OAAO,IAAI,GAAG,CAAC;IACf,KAAK,IAAI,GAAG,CAAC;IACb,IAAI,IAAI,GAAG,CAAC;IACZ,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,GAAG,CAAC;CAC9D;AAED,MAAM,WAAW,qBAAqB;CAErC;AAID,MAAM,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,aAAa,KAAK,wBAAwB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,24 @@
+import type { OneObjectType } from "../types/utils";
+import type { ViewControllerInterface } from "./ViewControllerInterface";
+import type { ViewInterface } from "./ViewInterface";
+import type { HtmlInterface } from "./ElementInterface";
+export interface ComponentInterface {
+    oneType: OneObjectType;
+    id: string;
+    ctx: ViewControllerInterface;
+    viewRef: ViewInterface | null;
+    parent: HtmlInterface | null;
+    data: Record<string, any>;
+    openTag: Comment;
+    closeTag: Comment;
+    stateKeys: string[];
+    subscribeFn: () => void;
+    unsubscribeFn: () => void;
+    render(): void;
+    destroy(): void;
+    setParent(parent: HtmlInterface | null): void;
+    isOneElement: boolean;
+    isOneComponent: boolean;
+    [key: string]: any;
+}
+//# sourceMappingURL=ComponentInterface.d.ts.map