@saolabs/client 1.0.0

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

@@ -0,0 +1,40 @@
+export interface ViewStateInterface {
+    /** StateManager accessor */
+    __: StateManagerInterface;
+    /** Subscribe to state changes */
+    on(key: string | number | string[] | Record<string, (value: any) => void>, callback?: (value: any) => void): () => void;
+    /** Unsubscribe */
+    off(key: string | number | string[] | Record<string, (value: any) => void>, callback?: (value: any) => void): void;
+    [key: string]: any;
+}
+export interface StateManagerInterface {
+    /** Create reactive state — returns [value, setter, key] */
+    useState(value: any, key?: string | number): [any, (newValue: any) => void, string | number];
+    /** 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;
+    /** 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;
+    /** Destroy — cleanup all listeners and states */
+    destroy(): void;
+}
+/** State listener callback */
+export type StateListener = (value: any) => void;
+/** Multi-key state listener */
+export interface MultiKeyStateListener {
+    keys: Set<string | number>;
+    callback: (values: Record<string, any>) => void;
+    called: boolean;
+}
+/** State item stored internally by StateManager */
+export interface StateItem {
+    value: any;
+    setValue: (value: any) => void;
+    key: string | number;
+}
+//# sourceMappingURL=ViewStateInterface.d.ts.map

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

@@ -0,0 +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"}

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

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

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

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

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

@@ -0,0 +1,28 @@
+export type InitMode = 'create' | 'hydrate';
+export declare enum InitModes {
+    CREATE = "create",
+    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.
+ *
+ * Key exports:
+ */
+/**
+ * System keys for HTML elements used by OneView.
+ * These keys are used to store metadata on HTML elements, such as IDs and view information.
+ * @name ESK (Element System Keys)
+ * @enum {string}
+ * @property {string} ID - Key for unique element ID
+ * @property {string} VIEW_ID - Key for associated view ID
+ * @property {string} BLOCK_NAME - Key for block name in block outlets
+ * @property {string} BLOCKOUTLET_NAME - Key for block outlet name
+ */
+export declare enum ESK {
+    ID = "data-one-id",
+    VIEW_ID = "data-one-view-id",
+    BLOCK_NAME = "data-one-block-name",
+    BLOCKOUTLET_NAME = "data-one-blockoutlet-name"
+}
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,oBAAY,SAAS;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AACD;;;;;GAKG;AACH;;;;;;;;;GASG;AACH,oBAAY,GAAG;IACX,EAAE,gBAAgB;IAClB,OAAO,qBAAqB;IAC5B,UAAU,wBAAwB;IAClC,gBAAgB,8BAA8B;CACjD"}

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

@@ -0,0 +1,29 @@
+export var InitModes;
+(function (InitModes) {
+    InitModes["CREATE"] = "create";
+    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.
+ *
+ * Key exports:
+ */
+/**
+ * System keys for HTML elements used by OneView.
+ * These keys are used to store metadata on HTML elements, such as IDs and view information.
+ * @name ESK (Element System Keys)
+ * @enum {string}
+ * @property {string} ID - Key for unique element ID
+ * @property {string} VIEW_ID - Key for associated view ID
+ * @property {string} BLOCK_NAME - Key for block name in block outlets
+ * @property {string} BLOCKOUTLET_NAME - Key for block outlet name
+ */
+export var ESK;
+(function (ESK) {
+    ESK["ID"] = "data-one-id";
+    ESK["VIEW_ID"] = "data-one-view-id";
+    ESK["BLOCK_NAME"] = "data-one-block-name";
+    ESK["BLOCKOUTLET_NAME"] = "data-one-blockoutlet-name";
+})(ESK || (ESK = {}));
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/core/contracts/common.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACjB,8BAAiB,CAAA;IACjB,gCAAmB,CAAA;AACvB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AACD;;;;;GAKG;AACH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,GAKX;AALD,WAAY,GAAG;IACX,yBAAkB,CAAA;IAClB,mCAA4B,CAAA;IAC5B,yCAAkC,CAAA;IAClC,qDAA8C,CAAA;AAClD,CAAC,EALW,GAAG,KAAH,GAAG,QAKd"}

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

@@ -0,0 +1,20 @@
+export type { LoopContextInterface } from "./LoopContextInterface";
+export type { ViewStateInterface, StateManagerInterface, StateListener, MultiKeyStateListener, StateItem } from "./ViewStateInterface";
+export type { OneNodeInterface, HtmlInterface, TextInterface, OutputInterface, FragmentInterface, OneElementConfig, HtmlElementConfig, OneElementEventHandler, OneElementChildren, OneChildrenFactoryOutput, OneChildrenFactory } from "./ElementInterface";
+export type { ReactiveInterface, ReactiveRenderFn, ReactiveChildrenFactory, ReactiveConfig } from "./ReactiveInterface";
+export type { BlockInterface, BlockOutletInterface, BlockManagerInterface, BlockRenderFactory } from "./BlockInterface";
+export type { ViewControllerInterface, ViewType, ViewConfig, ViewRuntimeConfig } from "./ViewControllerInterface";
+export type { ViewInterface, ViewRenderFactory, ViewConstructor, ViewLifecycleHooks } from "./ViewInterface";
+export type { ComponentInterface } from "./ComponentInterface";
+export type { ApplicationInterface, AppFactory, ServiceKey, ServiceFactory, ServiceBinding } from "./ApplicationInterface";
+export type { ServiceProviderInterface } from "./ServiceProviderInterface";
+export type { ViewCacheInterface } from "./ViewCacheInterface";
+export type { ViewManagerInterface, ActiveViewInfo } from "./ViewManagerInterface";
+export type { RouterInterface } from "./RouterInterface";
+export type { HelperInterface, CollectionProxyInterface } from "./HelperInterface";
+export type { EventServiceInterface, EventCallback } from "./EventServiceInterface";
+export type { HttpServiceInterface, HttpRequestConfig, HttpResponse, HttpInterceptor } from "./HttpServiceInterface";
+export type { StoreServiceInterface } from "./StoreServiceInterface";
+export type { StorageServiceInterface, StorageEventCallback } from "./StorageServiceInterface";
+export type { LoggerServiceInterface, LoggerConfig, LogEntry, LogLevel } from "./LoggerServiceInterface";
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/utils.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACvI,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5P,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxH,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxH,YAAY,EAAE,uBAAuB,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAClH,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7G,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3H,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrH,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,4 @@
+// ─── Barrel Re-exports ───────────────────────────────────────────
+// All interfaces and related types re-exported for backward compatibility
+export {};
+//# sourceMappingURL=utils.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { HtmlInterface, OneElementChildren } from "./ElementInterface";
+import { ViewControllerInterface } from "./utils";
+export type SectionItemType = 'static' | 'dynamic' | 'async' | 'reactive';
+export type SectionContentType = 'text' | 'html';
+export type SectionContentRenderer = (parentElement?: HtmlInterface | null | undefined) => string | OneElementChildren;
+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;
+    name: string;
+    type: SectionItemType;
+    contentType?: SectionContentType;
+    stateKeys?: string[];
+    renderFactory?: SectionContentRenderer;
+}
+//# sourceMappingURL=views.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,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,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"}

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

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

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

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

package/dist/src/core/elements/Block.d.ts

@@ -0,0 +1,58 @@
+import type { BlockInterface, BlockRenderFactory } from "../contracts/BlockInterface";
+import { InitMode } from "../contracts/common";
+import type { FragmentInterface, HtmlInterface } from "../contracts/ElementInterface";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import type { OneObjectType } from "../types/utils";
+/**
+ * Block — a named mounting slot used in layout views.
+ *
+ * In a layout (super view), you declare blocks like `@useBlock('content')`.
+ * Each block is a Reactive region that mounts/unmounts page view content.
+ *
+ * Key behaviors:
+ *   - Only active when the layout view is active
+ *   - Caches previously mounted view content (DOM nodes) so that
+ *     navigating back doesn't re-render and lose user state
+ *   - Tracks which viewId is currently active in this slot
+ *
+ * Flow:
+ *   1. Layout declares: `@useBlock('content')` → creates Block('content')
+ *   2. Router navigates to page → BlockManager.mount('content', viewId, factory)
+ *   3. Block caches old content, mounts new content
+ *   4. Browser back → BlockManager restores cached content without re-render
+ */
+export declare class Block implements BlockInterface {
+    oneType: OneObjectType;
+    id: string;
+    name: string;
+    ctx: ViewControllerInterface;
+    viewId: string | null;
+    fragment: FragmentInterface | null;
+    contentRenderFactory: BlockRenderFactory | null;
+    openTag: Comment;
+    closeTag: Comment;
+    domChildren: Node[];
+    initMode?: InitMode | undefined;
+    parentElement: HtmlInterface | null;
+    readonly isOneBlock = true;
+    readonly isOneElement = false;
+    constructor({ ctx, name, viewId, contentRenderFactory, id, initMode }: {
+        ctx: ViewControllerInterface;
+        name: string;
+        viewId?: string | null;
+        contentRenderFactory?: BlockRenderFactory;
+        id?: string | null;
+        initMode?: InitMode;
+    });
+    /** Initialize the block */
+    init(): void;
+    /** Render the block's content into the parent element */
+    render(): void;
+    mount(mountCtx: ViewControllerInterface, parentElement: HtmlInterface): any;
+    unmount(): void;
+    destroy(): void;
+    update(): void;
+    /** Set the block's parent element (used for mounting) */
+    setParentElement(parentElement: HtmlInterface | null): void;
+}
+//# sourceMappingURL=Block.d.ts.map

package/dist/src/core/elements/Block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAM,YAAW,cAAc;IACxC,OAAO,EAAE,aAAa,CAAW;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAC1C,oBAAoB,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAElB,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE3C,SAAgB,UAAU,QAAQ;IAClC,SAAgB,YAAY,SAAS;gBAEzB,EACR,GAAG,EACH,IAAI,EACJ,MAAa,EACb,oBAA2D,EAC3D,EAAS,EACT,QAAmB,EACtB,EAAE;QACC,GAAG,EAAE,uBAAuB,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;QAC1C,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAaD,2BAA2B;IAC3B,IAAI,IAAI,IAAI;IAQZ,yDAAyD;IACzD,MAAM,IAAI,IAAI;IASd,KAAK,CAAC,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,GAAG,GAAG;IAM3E,OAAO,IAAI,IAAI;IAGf,OAAO,IAAI,IAAI;IAGf,MAAM,IAAI,IAAI;IAIb,yDAAyD;IACzD,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;CAI/D"}

package/dist/src/core/elements/Block.js

@@ -0,0 +1,77 @@
+import { generateUUID } from "../hellpers/utils";
+import markerRegistry from "../services/MarkerRegistry";
+/**
+ * Block — a named mounting slot used in layout views.
+ *
+ * In a layout (super view), you declare blocks like `@useBlock('content')`.
+ * Each block is a Reactive region that mounts/unmounts page view content.
+ *
+ * Key behaviors:
+ *   - Only active when the layout view is active
+ *   - Caches previously mounted view content (DOM nodes) so that
+ *     navigating back doesn't re-render and lose user state
+ *   - Tracks which viewId is currently active in this slot
+ *
+ * Flow:
+ *   1. Layout declares: `@useBlock('content')` → creates Block('content')
+ *   2. Router navigates to page → BlockManager.mount('content', viewId, factory)
+ *   3. Block caches old content, mounts new content
+ *   4. Browser back → BlockManager restores cached content without re-render
+ */
+export class Block {
+    constructor({ ctx, name, viewId = null, contentRenderFactory = (parentElement) => [], id = null, initMode = 'create' }) {
+        this.oneType = 'Block';
+        this.viewId = null;
+        this.fragment = null;
+        this.contentRenderFactory = null;
+        this.domChildren = [];
+        this.parentElement = null;
+        this.isOneBlock = true;
+        this.isOneElement = false;
+        this.id = `${this.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        this.ctx = ctx;
+        this.name = name;
+        this.viewId = viewId ?? ctx.viewId; // Associate block with current viewId
+        this.initMode = initMode;
+        this.contentRenderFactory = contentRenderFactory || ((parentElement) => []);
+        markerRegistry.register('block', this.id, { name, viewId }); // Register block in marker registry
+        this.openTag = markerRegistry.createMarkerStart('block', this.id);
+        this.closeTag = markerRegistry.createMarkerEnd('block', this.id);
+    }
+    /** Initialize the block */
+    init() {
+        if (this.initMode === 'hydrate') {
+            // Hydration logic here
+        }
+        else {
+            // Creation logic here
+        }
+    }
+    /** Render the block's content into the parent element */
+    render() {
+        if (!this.contentRenderFactory)
+            return;
+        // Generate content using the factory
+        const content = this.contentRenderFactory(this.parentElement);
+    }
+    mount(mountCtx, parentElement) {
+        if (this.fragment) {
+            this.fragment.parent = parentElement;
+            this.fragment.render();
+        }
+    }
+    unmount() {
+        // Unmount logic (e.g. hide or remove DOM nodes, stop reactions)
+    }
+    destroy() {
+        // Cleanup logic (e.g. remove DOM nodes, clear caches)
+    }
+    update() {
+        // Update logic (e.g. re-render content on state change)
+    }
+    /** Set the block's parent element (used for mounting) */
+    setParentElement(parentElement) {
+        this.parentElement = parentElement;
+    }
+}
+//# sourceMappingURL=Block.js.map

package/dist/src/core/elements/Block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Block.js","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,cAAc,MAAM,4BAA4B,CAAC;AAGxD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,KAAK;IAkBd,YAAY,EACR,GAAG,EACH,IAAI,EACJ,MAAM,GAAG,IAAI,EACb,oBAAoB,GAAG,CAAC,aAA4B,EAAE,EAAE,CAAC,EAAE,EAC3D,EAAE,GAAG,IAAI,EACT,QAAQ,GAAG,QAAQ,EAQtB;QA/BD,YAAO,GAAkB,OAAO,CAAC;QAIjC,WAAM,GAAkB,IAAI,CAAC;QAC7B,aAAQ,GAA6B,IAAI,CAAC;QAC1C,yBAAoB,GAA8B,IAAI,CAAC;QAIvD,gBAAW,GAAW,EAAE,CAAC;QAEzB,kBAAa,GAAyB,IAAI,CAAC;QAE3B,eAAU,GAAG,IAAI,CAAC;QAClB,iBAAY,GAAG,KAAK,CAAC;QAiBjC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0BAA0B;QAChF,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,sCAAsC;QAC1E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,IAAI,CAAC,CAAC,aAA4B,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3F,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,oCAAoC;QACjG,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAErE,CAAC;IAED,2BAA2B;IAC3B,IAAI;QACA,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC9B,uBAAuB;QAC3B,CAAC;aAAM,CAAC;YACJ,sBAAsB;QAC1B,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,MAAM;QAEF,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAAE,OAAO;QAEvC,qCAAqC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAc,CAAC,CAAC;IAEnE,CAAC;IAED,KAAK,CAAC,QAAiC,EAAE,aAA4B;QACjE,IAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO;QACH,gEAAgE;IACpE,CAAC;IACD,OAAO;QACH,sDAAsD;IAC1D,CAAC;IACD,MAAM;QACF,wDAAwD;IAC5D,CAAC;IAEA,yDAAyD;IACzD,gBAAgB,CAAC,aAAmC;QACjD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CAEJ"}

package/dist/src/core/elements/BlockOutlet.d.ts

@@ -0,0 +1,34 @@
+import type { BlockOutletInterface } from "../contracts/BlockInterface";
+import { InitMode } from "../contracts/common";
+import type { HtmlInterface } from "../contracts/ElementInterface";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import type { OneObjectType } from "../types/utils";
+export declare class BlockOutlet implements BlockOutletInterface {
+    oneType: OneObjectType;
+    id: string;
+    name: string;
+    openTag: Comment;
+    closeTag: Comment;
+    parent: HtmlInterface | null;
+    parentElement: HtmlInterface | null;
+    ctx: ViewControllerInterface;
+    initMode: InitMode;
+    constructor({ ctx, parentElement, name, id, initMode }: {
+        ctx: ViewControllerInterface;
+        parentElement?: HtmlInterface | null;
+        name: string;
+        id?: string | null;
+        initMode?: InitMode;
+    });
+    hydrate(): void;
+    render(): void;
+    destroy(): void;
+    start(): void;
+    stop(): void;
+    setParentElement(parentElement: HtmlInterface | null): void;
+    get isOneElement(): boolean;
+    set isOneElement(value: boolean);
+    get isOneBlockOutlet(): boolean;
+    set isOneBlockOutlet(value: boolean);
+}
+//# sourceMappingURL=BlockOutlet.d.ts.map

package/dist/src/core/elements/BlockOutlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockOutlet.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,qBAAa,WAAY,YAAW,oBAAoB;IACpD,OAAO,EAAE,aAAa,CAAiB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IACpC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAC3C,GAAG,EAAE,uBAAuB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAY;gBAClB,EAAE,GAAG,EAAE,aAAoB,EAAE,IAAI,EAAE,EAAS,EAAE,QAAmB,EAAE,EAAE;QAAE,GAAG,EAAE,uBAAuB,CAAC;QAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;IAc9M,OAAO,IAAI,IAAI;IAIf,MAAM,IAAI,IAAI;IAYd,OAAO,IAAI,IAAI;IAMf,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAK3D,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;CACJ"}

package/dist/src/core/elements/BlockOutlet.js

@@ -0,0 +1,59 @@
+import { generateUUID } from "../hellpers/utils";
+import markerRegistry from "../services/MarkerRegistry";
+export class BlockOutlet {
+    constructor({ ctx, parentElement = null, name, id = null, initMode = 'create' }) {
+        this.oneType = 'BlockOutlet';
+        this.parent = null;
+        this.parentElement = null;
+        this.initMode = 'create';
+        this.id = `${ctx.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        this.ctx = ctx;
+        this.name = name;
+        this.parent = parentElement;
+        this.parentElement = parentElement;
+        this.initMode = initMode;
+        markerRegistry.register('blockoutlet', this.id, { name, viewId: ctx.viewId }); // Register this outlet in the MarkerRegistry
+        this.openTag = markerRegistry.createMarkerStart('blockoutlet', this.id);
+        this.closeTag = markerRegistry.createMarkerEnd('blockoutlet', this.id);
+    }
+    hydrate() {
+        // Hydration logic if needed (e.g. reattach event listeners)
+    }
+    render() {
+        if (!this.parentElement || !this.parentElement.element)
+            return;
+        const parentEl = this.parentElement.element;
+        // Place markers
+        parentEl.appendChild(this.openTag);
+        // Register this outlet in the MarkerRegistry for block mounting
+        parentEl.appendChild(this.closeTag);
+    }
+    destroy() {
+        // Remove markers from DOM
+        this.openTag.remove();
+        this.closeTag.remove();
+    }
+    start() {
+        // Placeholder for any setup needed when the outlet becomes active
+    }
+    stop() {
+        // Placeholder for any cleanup needed when the outlet becomes inactive
+    }
+    setParentElement(parentElement) {
+        this.parent = parentElement;
+        this.parentElement = parentElement;
+    }
+    get isOneElement() {
+        return true;
+    }
+    set isOneElement(value) {
+        // No-op setter to satisfy OneElement interface
+    }
+    get isOneBlockOutlet() {
+        return true;
+    }
+    set isOneBlockOutlet(value) {
+        // No-op setter to satisfy the Interface; this property is always true for BlockOutlet elements
+    }
+}
+//# sourceMappingURL=BlockOutlet.js.map

package/dist/src/core/elements/BlockOutlet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockOutlet.js","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,cAAc,MAAO,4BAA4B,CAAC;AAGzD,MAAM,OAAO,WAAW;IAUpB,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAiI;QAT9M,YAAO,GAAkB,aAAa,CAAC;QAKvC,WAAM,GAAyB,IAAI,CAAC;QACpC,kBAAa,GAAyB,IAAI,CAAC;QAE3C,aAAQ,GAAa,QAAQ,CAAC;QAE1B,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0BAA0B;QAC/E,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,6CAA6C;QAE5H,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACH,4DAA4D;IAChE,CAAC;IAED,MAAM;QACF,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO;YAAE,OAAO;QAE/D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAE5C,gBAAgB;QAChB,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,gEAAgE;QAChE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAExC,CAAC;IAED,OAAO;QACH,0BAA0B;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACD,kEAAkE;IACtE,CAAC;IAED,IAAI;QACA,sEAAsE;IAC1E,CAAC;IAED,gBAAgB,CAAC,aAAmC;QAChD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,YAAY,CAAC,KAAc;QAC3B,+CAA+C;IACnD,CAAC;IAED,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAc;QAC/B,+FAA+F;IACnG,CAAC;CACJ"}

package/dist/src/core/elements/Component.d.ts

@@ -0,0 +1,62 @@
+import { InitMode } from "../contracts/common";
+import { ComponentInterface } from "../contracts/ComponentInterface";
+import { HtmlInterface } from "../contracts/ElementInterface";
+import { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import { ViewInterface } from "../contracts/ViewInterface";
+import { OneObjectType } from "../types/utils";
+export declare class Component implements ComponentInterface {
+    oneType: OneObjectType;
+    ctx: ViewControllerInterface;
+    parent: HtmlInterface | null;
+    domChildren: Node[];
+    stateKeys: string[];
+    data: Record<string, any>;
+    openTag: Comment;
+    closeTag: Comment;
+    viewRef: ViewInterface | null;
+    id: string;
+    path: string | null;
+    type: 'default' | 'if' | 'when';
+    condition: {
+        stateKeys: string[];
+        checker: () => any;
+    } | null;
+    initMode: InitMode;
+    subscribeFn: () => void;
+    unsubscribeFn: () => void;
+    dataFactory: ((parentElement: HtmlInterface | null) => Record<string, any>) | null;
+    constructor({ ctx, parent, id, stateKeys, data, dataFactory, path, type, condition, initMode, }: {
+        ctx: ViewControllerInterface;
+        parent?: HtmlInterface | null;
+        id?: string | null;
+        stateKeys?: string[];
+        data?: Record<string, any>;
+        dataFactory?: ((parentElement: HtmlInterface | null) => Record<string, any>) | null;
+        path?: string | null;
+        type?: 'default' | 'if' | 'when';
+        condition?: {
+            stateKeys: string[];
+            checker: () => any;
+        } | null;
+        initMode?: InitMode;
+    });
+    mergeData(newData: Record<string, any>): void;
+    setDataFactory(factory: (parentElement: HtmlInterface | null) => Record<string, any>): void;
+    setCondition(condition: {
+        stateKeys: string[];
+        checker: () => any;
+    }): void;
+    setStateKeys(stateKeys: string[]): void;
+    setParentElement(parent: HtmlInterface | null): void;
+    setView(view: ViewInterface): void;
+    setParent(parent: HtmlInterface | null): void;
+    start(): void;
+    stop(): void;
+    render(): void;
+    destroy(): void;
+    get isOneElement(): boolean;
+    set isOneElement(value: boolean);
+    get isOneComponent(): boolean;
+    set isOneComponent(value: boolean);
+}
+//# sourceMappingURL=Component.d.ts.map

package/dist/src/core/elements/Component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAsB,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,SAAU,YAAW,kBAAkB;IAChD,OAAO,EAAE,aAAa,CAAe;IACrC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAQ;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3B,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAAa;IAC5C,SAAS,EAAE;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,CAAA;KAAC,GAAG,IAAI,CAAQ;IACnE,QAAQ,EAAE,QAAQ,CAAoB;IACtC,WAAW,EAAE,MAAM,IAAI,CAAY;IACnC,aAAa,EAAE,MAAM,IAAI,CAAY;IACrC,WAAW,EAAE,CAAC,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAQ;gBAE9E,EACR,GAAG,EACH,MAAa,EACb,EAAS,EACT,SAAc,EACd,IAAS,EACT,WAAkB,EAClB,IAAW,EACX,IAAgB,EAChB,SAAgB,EAChB,QAA2B,GAC9B,EAAE;QACC,GAAG,EAAE,uBAAuB,CAAC;QAC7B,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAC9B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,WAAW,CAAC,EAAE,CAAC,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QACpF,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;QACjC,SAAS,CAAC,EAAE;YAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,GAAG,CAAA;SAAC,GAAG,IAAI,CAAC;QAC7D,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAeD,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI7C,cAAc,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAGpF,YAAY,CAAC,SAAS,EAAE;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,CAAA;KAAC;IAGjE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE;IAGhC,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,IAAI,EAAE,aAAa;IAG3B,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;IAGb,IAAI,IAAI,IAAI;IAGZ,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAGf,IAAI,YAAY,IAAI,OAAO,CAE1B;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IACD,IAAI,cAAc,IAAI,OAAO,CAE5B;IACD,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,EAEhC;CACJ"}

package/dist/src/core/elements/Component.js

@@ -0,0 +1,72 @@
+import { InitModes } from "../contracts/common";
+import { generateUUID } from "../hellpers/utils";
+export class Component {
+    constructor({ ctx, parent = null, id = null, stateKeys = [], data = {}, dataFactory = null, path = null, type = 'default', condition = null, initMode = InitModes.CREATE, }) {
+        this.oneType = 'Component';
+        this.domChildren = []; // For compatibility with HtmlInterface; Component itself doesn't have a single root element
+        this.viewRef = null;
+        this.path = null; // For dynamic imports
+        this.type = 'default';
+        this.condition = null; // For 'when' type components
+        this.initMode = InitModes.CREATE; // Default initialization mode
+        this.subscribeFn = () => { };
+        this.unsubscribeFn = () => { };
+        this.dataFactory = null;
+        this.ctx = ctx;
+        this.parent = parent;
+        this.stateKeys = stateKeys;
+        this.data = data || {};
+        this.openTag = document.createComment(`component-start`);
+        this.closeTag = document.createComment(`component-end`);
+        this.id = `${ctx.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        this.dataFactory = dataFactory;
+        this.path = path;
+        this.type = type;
+        this.condition = condition;
+        this.initMode = initMode ?? InitModes.CREATE;
+    }
+    mergeData(newData) {
+        this.data = { ...this.data, ...newData };
+    }
+    setDataFactory(factory) {
+        this.dataFactory = factory;
+    }
+    setCondition(condition) {
+        this.condition = condition;
+    }
+    setStateKeys(stateKeys) {
+        this.stateKeys = stateKeys;
+    }
+    setParentElement(parent) {
+        this.parent = parent;
+    }
+    setView(view) {
+        this.viewRef = view;
+    }
+    setParent(parent) {
+        this.parent = parent;
+    }
+    start() {
+    }
+    stop() {
+    }
+    render() {
+        // To be implemented by specific components
+    }
+    destroy() {
+        // To be implemented by specific components
+    }
+    get isOneElement() {
+        return true;
+    }
+    set isOneElement(value) {
+        // No-op, just for type compatibility
+    }
+    get isOneComponent() {
+        return true;
+    }
+    set isOneComponent(value) {
+        // No-op, just for type compatibility
+    }
+}
+//# sourceMappingURL=Component.js.map

package/dist/src/core/elements/Component.js.map

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

package/dist/src/core/elements/ElementManager.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OneElementManager — factory/registry for creating One elements.
+ *
+ * Provides shorthand functions so compiled output stays clean:
+ *   oem.h(ctx, parent, 'div', config, children)  → Html
+ *   oem.t('Hello')                                → TextElement
+ *   oem.r(ctx, parent, renderFn)                  → Reactive
+ *   oem.f(ctx, parent, children)                  → Fragment
+ *   oem.b(ctx, parent, 'content')                 → Block
+ */
+export declare class ElementManagerService {
+    /** Custom element factories (for user-defined components) */
+    private factories;
+    /** Register a custom component factory */
+    set(name: string, factory: (...args: any[]) => any): void;
+    /** Get a custom component factory */
+    get(name: string): ((...args: any[]) => any) | undefined;
+    /** Check if a custom component is registered */
+    has(name: string): boolean;
+}
+export declare const ElementManager: ElementManagerService;
+export default ElementManager;
+//# sourceMappingURL=ElementManager.d.ts.map

package/dist/src/core/elements/ElementManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementManager.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/ElementManager.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,SAAS,CAAmD;IAQpE,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAIzD,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS;IAIxD,gDAAgD;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG7B;AAED,eAAO,MAAM,cAAc,uBAA8B,CAAC;AAC1D,eAAe,cAAc,CAAC"}