@saolabs/client 1.0.0

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

@@ -0,0 +1,69 @@
+import { InitMode } from "../contracts/common";
+import type { HtmlInterface, OutputInterface } from "../contracts/ElementInterface";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import type { OneObjectType } from "../types/utils";
+/**
+ * Output — reactive text output between comment markers.
+ *
+ * Compiled từ: {{ $expression }}   → output({ctx, parentElement, stateKeys, isEscapeHTML: true}, () => expression)
+ * Compiled từ: {!! $expression !!} → output({ctx, parentElement, stateKeys, isEscapeHTML: false}, () => expression)
+ *
+ * Render: Tạo Text node giữa <!--o:id-s--> và <!--o:id-e-->
+ * Update: Khi stateKeys thay đổi → re-evaluate contentFactory → update textContent
+ */
+export declare class Output implements OutputInterface {
+    oneType: OneObjectType;
+    ctx: ViewControllerInterface;
+    parent: HtmlInterface | null;
+    openTag: Comment;
+    closeTag: Comment;
+    stateKeys: string[];
+    contentFactory: () => string;
+    isEscapeHTML: boolean;
+    domChildren: Node[];
+    private textNode;
+    private unsubscribe;
+    private _isStarted;
+    private _isDestroyed;
+    private id;
+    initMode: InitMode;
+    constructor({ ctx, id, parent, stateKeys, contentFactory, isEscapeHTML, initMode }: {
+        ctx: ViewControllerInterface;
+        id?: string | null;
+        parent?: HtmlInterface | null;
+        stateKeys?: string[];
+        contentFactory?: () => string;
+        isEscapeHTML?: boolean;
+        initMode?: InitMode;
+    });
+    setParentElement(parent: HtmlInterface | null): void;
+    setContentFactory(factory: () => string): void;
+    setStateKeys(stateKeys: string[]): void;
+    /**
+     * Render — insert markers + initial text into parent element.
+     */
+    render(): void;
+    /**
+     * Start — subscribe to state changes for reactive updates.
+     * Called during START phase of view lifecycle.
+     */
+    start(): void;
+    /**
+     * Stop — unsubscribe from state changes.
+     */
+    stop(): void;
+    /**
+     * Update — re-evaluate contentFactory and update text node in-place.
+     * O(1) — chỉ thay textContent, không tạo/xóa DOM nodes.
+     */
+    private update;
+    /**
+     * Destroy — cleanup everything.
+     */
+    destroy(): void;
+    get isOneElement(): boolean;
+    set isOneElement(_: boolean);
+    get isOneOutput(): boolean;
+    set isOneOutput(_: boolean);
+}
+//# sourceMappingURL=Output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Output.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;GAQG;AACH,qBAAa,MAAO,YAAW,eAAe;IAC1C,OAAO,EAAE,aAAa,CAAY;IAClC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,EAAE,CAAS;IACnB,QAAQ,EAAE,QAAQ,CAAoB;gBAE1B,EACR,GAAG,EACH,EAAS,EACT,MAAa,EACb,SAAc,EACd,cAAyB,EACzB,YAAmB,EACnB,QAA2B,EAC9B,EAAE;QACC,GAAG,EAAE,uBAAuB,CAAC;QAC7B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;QAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAaD,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAGpD,iBAAiB,CAAC,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI;IAG9C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IASvC;;OAEG;IACH,MAAM,IAAI,IAAI;IAgBd;;;OAGG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;;OAGG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,IAAI,IAAI;IAoBf,IAAI,YAAY,IAAI,OAAO,CAAiB;IAC5C,IAAI,YAAY,CAAC,CAAC,EAAE,OAAO,EAAI;IAC/B,IAAI,WAAW,IAAI,OAAO,CAAiB;IAC3C,IAAI,WAAW,CAAC,CAAC,EAAE,OAAO,EAAI;CACjC"}

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

@@ -0,0 +1,121 @@
+import { InitModes } from "../contracts/common";
+import { escapeHTML, generateUUID } from "../hellpers/utils";
+/**
+ * Output — reactive text output between comment markers.
+ *
+ * Compiled từ: {{ $expression }}   → output({ctx, parentElement, stateKeys, isEscapeHTML: true}, () => expression)
+ * Compiled từ: {!! $expression !!} → output({ctx, parentElement, stateKeys, isEscapeHTML: false}, () => expression)
+ *
+ * Render: Tạo Text node giữa <!--o:id-s--> và <!--o:id-e-->
+ * Update: Khi stateKeys thay đổi → re-evaluate contentFactory → update textContent
+ */
+export class Output {
+    constructor({ ctx, id = null, parent = null, stateKeys = [], contentFactory = () => '', isEscapeHTML = true, initMode = InitModes.CREATE }) {
+        this.oneType = 'Output';
+        this.domChildren = []; // For compatibility with HtmlInterface; Output itself doesn't have a single root element
+        this.textNode = null;
+        this.unsubscribe = null;
+        this._isStarted = false;
+        this._isDestroyed = false;
+        this.initMode = InitModes.CREATE;
+        this.ctx = ctx;
+        this.parent = parent;
+        this.stateKeys = stateKeys;
+        this.contentFactory = contentFactory;
+        this.isEscapeHTML = isEscapeHTML;
+        this.id = `${ctx.viewId}-${id ?? generateUUID(8)}`;
+        this.initMode = initMode;
+        this.openTag = document.createComment(`o:${this.id}-s`);
+        this.closeTag = document.createComment(`o:${this.id}-e`);
+    }
+    setParentElement(parent) {
+        this.parent = parent;
+    }
+    setContentFactory(factory) {
+        this.contentFactory = factory;
+    }
+    setStateKeys(stateKeys) {
+        this.stateKeys = stateKeys;
+        // If already started, we need to resubscribe with new keys
+        if (this._isStarted) {
+            this.stop();
+            this.start();
+        }
+    }
+    /**
+     * Render — insert markers + initial text into parent element.
+     */
+    render() {
+        if (!this.parent?.element || this._isDestroyed)
+            return;
+        const parentEl = this.parent.element;
+        // Append markers + text node
+        parentEl.appendChild(this.openTag);
+        const rawText = String(this.contentFactory() ?? '');
+        const displayText = this.isEscapeHTML ? escapeHTML(rawText) : rawText;
+        this.textNode = document.createTextNode(displayText);
+        parentEl.appendChild(this.textNode);
+        parentEl.appendChild(this.closeTag);
+    }
+    /**
+     * Start — subscribe to state changes for reactive updates.
+     * Called during START phase of view lifecycle.
+     */
+    start() {
+        if (this._isStarted || this._isDestroyed)
+            return;
+        this._isStarted = true;
+        if (this.stateKeys.length > 0) {
+            this.unsubscribe = this.ctx.states.__.subscribe(this.stateKeys, () => this.update());
+        }
+    }
+    /**
+     * Stop — unsubscribe from state changes.
+     */
+    stop() {
+        if (!this._isStarted)
+            return;
+        this._isStarted = false;
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+    }
+    /**
+     * Update — re-evaluate contentFactory and update text node in-place.
+     * O(1) — chỉ thay textContent, không tạo/xóa DOM nodes.
+     */
+    update() {
+        if (!this.textNode || this._isDestroyed)
+            return;
+        const rawText = String(this.contentFactory() ?? '');
+        const displayText = this.isEscapeHTML ? escapeHTML(rawText) : rawText;
+        if (this.textNode.textContent !== displayText) {
+            this.textNode.textContent = displayText;
+        }
+    }
+    /**
+     * Destroy — cleanup everything.
+     */
+    destroy() {
+        if (this._isDestroyed)
+            return;
+        this._isDestroyed = true;
+        this.stop();
+        // Remove text node
+        if (this.textNode) {
+            this.textNode.remove();
+            this.textNode = null;
+        }
+        // Remove markers
+        this.openTag.remove();
+        this.closeTag.remove();
+        this.parent = null;
+    }
+    // ─── OneElement markers ─────────────────────────────
+    get isOneElement() { return true; }
+    set isOneElement(_) { }
+    get isOneOutput() { return true; }
+    set isOneOutput(_) { }
+}
+//# sourceMappingURL=Output.js.map

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

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

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

@@ -0,0 +1,77 @@
+import { InitMode } from "../contracts/common";
+import type { HtmlInterface, OneElementChildren } from "../contracts/ElementInterface";
+import type { ReactiveInterface, ReactiveChildrenFactory } from "../contracts/ReactiveInterface";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import type { OneObjectType } from "../types/utils";
+/**
+ * Reactive — a region in the DOM bounded by comment markers that
+ * can re-render its content when reactive dependencies change.
+ *
+ * Use cases:
+ *   - o-if / o-show conditional rendering
+ *   - o-for list rendering
+ *   - @useBlock(name) slot mounting
+ *   - Any expression binding that affects DOM structure
+ *
+ * The open/close comment markers stay in place; only the content
+ * between them is replaced on re-render. This avoids the need to
+ * scan/diff the entire DOM tree.
+ */
+export declare class Reactive implements ReactiveInterface {
+    static class: string;
+    oneType: OneObjectType;
+    id: string;
+    type: string;
+    openTag: Comment;
+    closeTag: Comment;
+    parentElement: HtmlInterface | null;
+    parentReactive: ReactiveInterface | null;
+    parent: HtmlInterface | null;
+    ctx: ViewControllerInterface;
+    childrenFactory: ReactiveChildrenFactory;
+    children: OneElementChildren;
+    private mounted;
+    stateKeys: string[];
+    unsubscribe: () => void;
+    private _isStarted;
+    domChildren: Node[];
+    initMode: InitMode;
+    constructor({ type, id, ctx, parentElement, parentReactive, stateKeys, childrenFactory, initMode, }: {
+        id?: string | null;
+        type?: string;
+        ctx: ViewControllerInterface;
+        parentElement?: HtmlInterface | null;
+        parentReactive?: ReactiveInterface | null;
+        stateKeys?: string[];
+        childrenFactory: ReactiveChildrenFactory;
+        initMode?: InitMode;
+    });
+    setParentElement(parent: HtmlInterface | null): void;
+    setChildrenFactory(factory: ReactiveChildrenFactory): void;
+    setStateKeys(stateKeys: string[]): void;
+    /** Mount markers into parent and render content */
+    render(): void;
+    /** Schedule a re-render through the ViewController */
+    update(): void;
+    /** Clear all DOM nodes between the open and close markers */
+    private clearContent;
+    /** Insert a node just before the close marker */
+    private insertBeforeClose;
+    /** Determine the actual DOM element to insert into */
+    private getInsertionTarget;
+    /** Start — subscribe to stateKeys and recursively start children.
+     * Called during START phase of view lifecycle. */
+    start(): void;
+    /** Stop — unsubscribe and recursively stop children. */
+    stop(): void;
+    /** Remove content but keep markers (for hide/show scenarios) */
+    hide(): void;
+    /** Re-render content (for show after hide) */
+    show(): void;
+    destroy(): void;
+    get isOneReactive(): boolean;
+    set isOneReactive(value: boolean);
+    set isOneElement(value: boolean);
+    get isOneElement(): boolean;
+}
+//# sourceMappingURL=Reactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Reactive.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Reactive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAA4B,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAoB,MAAM,gCAAgC,CAAC;AACnH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAS,YAAW,iBAAiB;IAC9C,MAAM,CAAC,KAAK,SAAc;IAC1B,OAAO,EAAE,aAAa,CAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,cAAc,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IAEpC,GAAG,EAAE,uBAAuB,CAAC;IAC7B,eAAe,EAAE,uBAAuB,CAAC;IACzC,QAAQ,EAAE,kBAAkB,CAAM;IACzC,OAAO,CAAC,OAAO,CAAkB;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,IAAI,CAAY;IAC1C,OAAO,CAAC,UAAU,CAAS;IAI3B,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,QAAQ,EAAE,QAAQ,CAAoB;gBAC1B,EACR,IAAiB,EACjB,EAAS,EACT,GAAG,EACH,aAAoB,EACpB,cAAqB,EACrB,SAAc,EACd,eAA0B,EAC1B,QAA2B,GAC9B,EAAE;QACC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,uBAAuB,CAAC;QAC7B,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,cAAc,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,eAAe,EAAE,uBAAuB,CAAC;QACzC,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAmBD,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIpD,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAI1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IASvC,mDAAmD;IACnD,MAAM,IAAI,IAAI;IA4Cd,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAId,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAkBpB,iDAAiD;IACjD,OAAO,CAAC,iBAAiB;IAIzB,sDAAsD;IACtD,OAAO,CAAC,kBAAkB;IAO1B;sDACkD;IAClD,KAAK,IAAI,IAAI;IAoBb,wDAAwD;IACxD,IAAI,IAAI,IAAI;IAiBZ,gEAAgE;IAChE,IAAI,IAAI,IAAI;IAIZ,8CAA8C;IAC9C,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;IASf,IAAI,aAAa,IAAI,OAAO,CAE3B;IACD,IAAI,aAAa,CAAC,KAAK,EAAE,OAAO,EAE/B;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IACD,IAAI,YAAY,IAAI,OAAO,CAE1B;CACJ"}

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

@@ -0,0 +1,199 @@
+import { InitModes } from "../contracts/common";
+import { generateUUID } from "../hellpers/utils";
+import markerRegistry from "../services/MarkerRegistry";
+/**
+ * Reactive — a region in the DOM bounded by comment markers that
+ * can re-render its content when reactive dependencies change.
+ *
+ * Use cases:
+ *   - o-if / o-show conditional rendering
+ *   - o-for list rendering
+ *   - @useBlock(name) slot mounting
+ *   - Any expression binding that affects DOM structure
+ *
+ * The open/close comment markers stay in place; only the content
+ * between them is replaced on re-render. This avoids the need to
+ * scan/diff the entire DOM tree.
+ */
+export class Reactive {
+    constructor({ type = 'reactive', id = null, ctx, parentElement = null, parentReactive = null, stateKeys = [], childrenFactory = () => [], initMode = InitModes.CREATE, }) {
+        this.oneType = 'Reactive';
+        this.parent = null; // Alias for parentReactive to satisfy OneNodeInterface
+        this.children = [];
+        this.mounted = false;
+        this.unsubscribe = () => { };
+        this._isStarted = false;
+        this.domChildren = []; // For compatibility with HtmlInterface; Reactive itself doesn't have a single root element
+        this.initMode = InitModes.CREATE;
+        this.ctx = ctx;
+        this.parentElement = parentElement;
+        this.parentReactive = parentReactive;
+        this.id = `${ctx.viewId}-${id || generateUUID(5)}`;
+        this.type = type;
+        this.childrenFactory = childrenFactory;
+        this.stateKeys = stateKeys;
+        this.initMode = initMode;
+        markerRegistry.register('reactive', this.id, {
+            type: this.type,
+            stateKeys: this.stateKeys,
+            viewID: this.ctx.viewId,
+        });
+        this.openTag = markerRegistry.createMarkerStart('reactive', this.id);
+        this.closeTag = markerRegistry.createMarkerEnd('reactive', this.id);
+    }
+    setParentElement(parent) {
+        this.parentElement = parent;
+    }
+    setChildrenFactory(factory) {
+        this.childrenFactory = factory;
+    }
+    setStateKeys(stateKeys) {
+        this.stateKeys = stateKeys;
+        // If already started, we need to resubscribe with new keys
+        if (this._isStarted) {
+            this.stop();
+            this.start();
+        }
+    }
+    /** Mount markers into parent and render content */
+    render() {
+        const target = this.getInsertionTarget();
+        if (!target)
+            return;
+        if (!this.mounted) {
+            // First render: place markers
+            if (this.parentReactive) {
+                // Insert before the parent's close marker
+                target.insertBefore(this.openTag, this.parentReactive.closeTag);
+                target.insertBefore(this.closeTag, this.parentReactive.closeTag);
+            }
+            else {
+                target.appendChild(this.openTag);
+                target.appendChild(this.closeTag);
+            }
+            this.mounted = true;
+        }
+        else {
+            // Re-render: clear existing content between markers
+            this.clearContent();
+        }
+        // Produce children
+        const output = this.childrenFactory(this, this.parentElement);
+        // Insert children between markers
+        for (const child of output) {
+            if (typeof child === 'string' || typeof child === 'number') {
+                const textNode = document.createTextNode(String(child));
+                this.insertBeforeClose(textNode);
+                this.children.push(textNode);
+            }
+            else if (child && typeof child === 'object') {
+                if ('element' in child) {
+                    // HtmlInterface, TextInterface, FragmentInterface
+                    this.insertBeforeClose(child.element);
+                    this.children.push(child);
+                    child.render();
+                }
+                else if ('openTag' in child) {
+                    // Nested Reactive
+                    this.children.push(child);
+                    child.render();
+                }
+            }
+        }
+    }
+    /** Schedule a re-render through the ViewController */
+    update() {
+        this.ctx.scheduleUpdate(this);
+    }
+    /** Clear all DOM nodes between the open and close markers */
+    clearContent() {
+        // Destroy managed children first
+        for (const child of this.children) {
+            if (child && typeof child === 'object' && 'destroy' in child) {
+                child.destroy();
+            }
+        }
+        this.children = [];
+        // Remove DOM nodes between markers
+        let current = this.openTag.nextSibling;
+        while (current && current !== this.closeTag) {
+            const next = current.nextSibling;
+            current.remove();
+            current = next;
+        }
+    }
+    /** Insert a node just before the close marker */
+    insertBeforeClose(node) {
+        this.closeTag.parentNode?.insertBefore(node, this.closeTag);
+    }
+    /** Determine the actual DOM element to insert into */
+    getInsertionTarget() {
+        if (this.parentElement) {
+            return this.parentElement.element;
+        }
+        return null;
+    }
+    /** Start — subscribe to stateKeys and recursively start children.
+     * Called during START phase of view lifecycle. */
+    start() {
+        if (this._isStarted)
+            return;
+        this._isStarted = true;
+        // Subscribe to state changes → schedule re-render
+        if (this.stateKeys.length > 0) {
+            this.unsubscribe = this.ctx.states.__.subscribe(this.stateKeys, () => this.update());
+        }
+        // Recursively start children
+        for (const child of this.children) {
+            if (child && typeof child === 'object' && 'start' in child && typeof child.start === 'function') {
+                child.start();
+            }
+        }
+    }
+    /** Stop — unsubscribe and recursively stop children. */
+    stop() {
+        if (!this._isStarted)
+            return;
+        this._isStarted = false;
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = () => { };
+        }
+        // Recursively stop children
+        for (const child of this.children) {
+            if (child && typeof child === 'object' && 'stop' in child && typeof child.stop === 'function') {
+                child.stop();
+            }
+        }
+    }
+    /** Remove content but keep markers (for hide/show scenarios) */
+    hide() {
+        this.clearContent();
+    }
+    /** Re-render content (for show after hide) */
+    show() {
+        this.render();
+    }
+    destroy() {
+        this.clearContent();
+        this.openTag.remove();
+        this.closeTag.remove();
+        this.mounted = false;
+        this.parentElement = null;
+        this.parentReactive = null;
+    }
+    get isOneReactive() {
+        return true;
+    }
+    set isOneReactive(value) {
+        // No-op setter to satisfy the Interface; this property is always true for Reactive elements
+    }
+    set isOneElement(value) {
+        // No-op setter to satisfy the Interface; Reactive is a type of OneElement
+    }
+    get isOneElement() {
+        return true;
+    }
+}
+Reactive.class = 'Reactive';
+//# sourceMappingURL=Reactive.js.map

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

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

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

@@ -0,0 +1,46 @@
+import type { HtmlInterface, TextInterface } from "../contracts/ElementInterface";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import { OneObjectType } from "../types/utils";
+/**
+ * TextElement — wraps a DOM Text node.
+ *
+ * Supports reactive text updates without re-creating the node.
+ * When `update(newText)` is called, only the textContent changes —
+ * no DOM removal/insertion needed.
+ */
+export declare class TextElement implements TextInterface {
+    oneType: OneObjectType;
+    element: Text;
+    parent: HtmlInterface | null;
+    private ctx;
+    private statekeys;
+    private unsubscribe;
+    protected generateText: () => string;
+    _text: string;
+    shouldEscapeHTML: boolean;
+    isStarted: boolean;
+    domChildren: Node[];
+    constructor({ ctx, parent, stateKeys, generateText, isEscapeHTML }: {
+        ctx: ViewControllerInterface;
+        parent?: HtmlInterface | null;
+        stateKeys?: string[];
+        generateText?: () => string;
+        isEscapeHTML?: boolean;
+    });
+    /** Start reactive text updates */
+    start(): void;
+    stop(): void;
+    setParentElement(parent: HtmlInterface | null): void;
+    /** Update text content in-place */
+    update(newText: string): void;
+    render(): void;
+    remove(): void;
+    destroy(): void;
+    get text(): string;
+    set text(newText: string);
+    get isOneElement(): boolean;
+    set isOneElement(value: boolean);
+    get isOneText(): boolean;
+    set isOneText(value: boolean);
+}
+//# sourceMappingURL=TextElement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextElement.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/TextElement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC7C,OAAO,EAAE,aAAa,CAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,WAAW,CAA6B;IAChD,SAAS,CAAC,YAAY,EAAE,MAAM,MAAM,CAAoB;IACjD,KAAK,EAAE,MAAM,CAAM;IACnB,gBAAgB,EAAE,OAAO,CAAQ;IAEjC,SAAS,EAAE,OAAO,CAAS;IAGlC,WAAW,EAAE,IAAI,EAAE,CAAM;gBACb,EAAE,GAAG,EAAE,MAAa,EAAE,SAAc,EAAE,YAAuB,EAAE,YAAmB,EAAE,EAAE;QAAE,GAAG,EAAE,uBAAuB,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAa5O,kCAAkC;IAClC,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAQZ,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIpD,mCAAmC;IACnC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B,MAAM,IAAI,IAAI;IAMd,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IASf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAEvB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IACD,IAAI,SAAS,IAAI,OAAO,CAEvB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAE3B;CACJ"}

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

@@ -0,0 +1,94 @@
+import { escapeHTML } from "../hellpers/utils";
+/**
+ * TextElement — wraps a DOM Text node.
+ *
+ * Supports reactive text updates without re-creating the node.
+ * When `update(newText)` is called, only the textContent changes —
+ * no DOM removal/insertion needed.
+ */
+export class TextElement {
+    constructor({ ctx, parent = null, stateKeys = [], generateText = () => '', isEscapeHTML = true }) {
+        this.oneType = 'TextElement';
+        this.statekeys = [];
+        this.unsubscribe = null;
+        this.generateText = () => this._text;
+        this._text = '';
+        this.shouldEscapeHTML = true; // Whether to escape HTML in text content
+        this.isStarted = false;
+        this.domChildren = []; // For compatibility with HtmlInterface; Text itself doesn't have a single root element
+        this.ctx = ctx;
+        this.generateText = generateText;
+        this.parent = parent;
+        this.statekeys = stateKeys;
+        this.shouldEscapeHTML = isEscapeHTML;
+        this._text = this.generateText();
+        if (this.shouldEscapeHTML) {
+            this._text = escapeHTML(this._text);
+        }
+        this.element = document.createTextNode(this._text);
+    }
+    /** Start reactive text updates */
+    start() {
+        if (this.isStarted)
+            return;
+        this.isStarted = true;
+        if (this.statekeys.length > 0) {
+            this.unsubscribe = this.ctx.states.__.subscribe(this.statekeys, (newText) => {
+                this.update(this.generateText());
+            });
+        }
+    }
+    stop() {
+        if (!this.isStarted)
+            return;
+        this.isStarted = false;
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+    }
+    setParentElement(parent) {
+    }
+    /** Update text content in-place */
+    update(newText) {
+        if (this._text !== newText) {
+            this._text = newText;
+            this.element.textContent = this.shouldEscapeHTML ? escapeHTML(newText) : newText;
+        }
+    }
+    render() {
+        if (this.parent && this.parent.element) {
+            this.parent.element.appendChild(this.element);
+        }
+    }
+    remove() {
+        this.element.remove();
+    }
+    destroy() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        this.element.remove();
+        this.parent = null;
+    }
+    get text() {
+        return this._text;
+    }
+    set text(newText) {
+        this.update(newText);
+    }
+    get isOneElement() {
+        return true;
+    }
+    set isOneElement(value) {
+        // No-op setter to satisfy the Interface; this property is always true for Text elements
+    }
+    get isOneText() {
+        return true;
+    }
+    set isOneText(value) {
+        // No-op setter to satisfy the Interface; this property is always true for Text elements
+    }
+}
+//# sourceMappingURL=TextElement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextElement.js","sourceRoot":"","sources":["../../../../src/core/elements/TextElement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IAepB,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,YAAY,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,EAA8I;QAd5O,YAAO,GAAkB,aAAa,CAAC;QAI/B,cAAS,GAAa,EAAE,CAAC;QACzB,gBAAW,GAAwB,IAAI,CAAC;QACtC,iBAAY,GAAiB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,UAAK,GAAW,EAAE,CAAC;QACnB,qBAAgB,GAAY,IAAI,CAAC,CAAC,yCAAyC;QAE3E,cAAS,GAAY,KAAK,CAAC;QAGlC,gBAAW,GAAW,EAAE,CAAC,CAAC,uFAAuF;QAE7G,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,kCAAkC;IAClC,KAAK;QACD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAe,EAAE,EAAE;gBAChF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IACD,IAAI;QACA,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IACD,gBAAgB,CAAC,MAA4B;IAE7C,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,OAAe;QAClB,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACrF,CAAC;IACL,CAAC;IAED,MAAM;QACF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,MAAM;QACF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO;QACH,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,OAAe;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,YAAY,CAAC,KAAc;QAC3B,wFAAwF;IAC5F,CAAC;IACD,IAAI,SAAS;QACT,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,SAAS,CAAC,KAAc;QACxB,wFAAwF;IAC5F,CAAC;CACJ"}