@saolabs/client 1.0.0

package/dist/src/core/services/StoreService.js

@@ -0,0 +1,301 @@
+/**
+ * StoreService — In-memory reactive key-value store.
+ *
+ * Features:
+ *   - get/set/has/remove with TTL (minutes)
+ *   - Subscribe to single or multiple keys (batched via microtask)
+ *   - Expiration callbacks (onExpire)
+ *   - Lazy expiration on access + periodic batch cleanup
+ *   - Dynamic property access: store.user === store.get('user')
+ *
+ * Register via DI:
+ *   app.singleton('store', StoreService);
+ */
+// ─── StoreService ───────────────────────────────────────────────
+export class StoreService {
+    static getInstance(key = 'default') {
+        if (!StoreService.instances.has(key)) {
+            StoreService.instances.set(key, new StoreService());
+        }
+        return StoreService.instances.get(key);
+    }
+    static instance(key = 'default') {
+        return StoreService.getInstance(key);
+    }
+    static removeInstance(key = 'default') {
+        StoreService.instances.delete(key);
+    }
+    constructor(cleanupIntervalMs = 60000) {
+        this.data = {};
+        this.ttlMap = new Map();
+        this.listeners = new Map();
+        this.multiListeners = [];
+        this.expirationListeners = new Map();
+        this.changedKeys = new Set();
+        this.pendingFlush = false;
+        this.cleanupTimer = null;
+        if (cleanupIntervalMs > 0) {
+            this.cleanupTimer = setInterval(() => this.cleanExpired(), cleanupIntervalMs);
+        }
+    }
+    // ─── CRUD ───────────────────────────────────────────────────
+    /** Set value with optional TTL (in minutes) */
+    set(key, value, ttl = null) {
+        if (StoreService.RESERVED.has(key))
+            return;
+        this.data[key] = value;
+        if (ttl !== null && ttl > 0) {
+            const ms = ttl * 60000;
+            this.ttlMap.set(key, { ttl, createdAt: Date.now(), expiresAt: Date.now() + ms });
+        }
+        else {
+            this.ttlMap.delete(key);
+        }
+        // Dynamic property
+        if (!Object.getOwnPropertyDescriptor(this, key)?.get) {
+            Object.defineProperty(this, key, {
+                get: () => this.get(key),
+                set: (v) => this.set(key, v, ttl),
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        this.queueChange(key);
+    }
+    /** Get value (returns null if expired or missing) */
+    get(key) {
+        if (this.isExpired(key)) {
+            this.expire(key);
+            return null;
+        }
+        return this.data[key] ?? null;
+    }
+    /** Check if key exists and is not expired */
+    has(key) {
+        if (this.isExpired(key)) {
+            this.expire(key);
+            return false;
+        }
+        return key in this.data;
+    }
+    /** Remove key, returns removed value or null */
+    remove(key) {
+        if (!(key in this.data))
+            return null;
+        const value = this.data[key];
+        delete this.data[key];
+        this.ttlMap.delete(key);
+        this.listeners.delete(key);
+        this.expirationListeners.delete(key);
+        this.removeDynamicProp(key);
+        this.queueChange(key);
+        return value;
+    }
+    /** Clear all data, listeners, TTLs */
+    clear() {
+        const keys = Object.keys(this.data);
+        this.data = {};
+        this.ttlMap.clear();
+        this.listeners.clear();
+        this.multiListeners = [];
+        this.expirationListeners.clear();
+        this.changedKeys.clear();
+        this.pendingFlush = false;
+        keys.forEach((k) => this.removeDynamicProp(k));
+    }
+    // ─── Subscriptions ──────────────────────────────────────────
+    /**
+     * Subscribe to key changes. Returns unsubscribe function.
+     *
+     * @example
+     * store.subscribe('user', (value) => { ... });
+     * store.subscribe(['user', 'token'], (values) => { ... });
+     */
+    subscribe(key, callback) {
+        if (Array.isArray(key)) {
+            const listener = {
+                keys: new Set(key),
+                callback: callback,
+                called: false,
+            };
+            this.multiListeners.push(listener);
+            return () => {
+                const idx = this.multiListeners.indexOf(listener);
+                if (idx !== -1)
+                    this.multiListeners.splice(idx, 1);
+            };
+        }
+        if (!this.listeners.has(key))
+            this.listeners.set(key, []);
+        this.listeners.get(key).push(callback);
+        return () => this.unsubscribe(key, callback);
+    }
+    /** Unsubscribe specific callback from key */
+    unsubscribe(key, callback) {
+        const list = this.listeners.get(key);
+        if (!list)
+            return;
+        const filtered = list.filter((cb) => cb !== callback);
+        filtered.length > 0 ? this.listeners.set(key, filtered) : this.listeners.delete(key);
+    }
+    /** Subscribe to TTL expiration of a key */
+    onExpire(key, callback) {
+        if (!this.expirationListeners.has(key))
+            this.expirationListeners.set(key, []);
+        this.expirationListeners.get(key).push(callback);
+        return () => {
+            const list = this.expirationListeners.get(key);
+            if (list) {
+                const filtered = list.filter((cb) => cb !== callback);
+                filtered.length > 0
+                    ? this.expirationListeners.set(key, filtered)
+                    : this.expirationListeners.delete(key);
+            }
+        };
+    }
+    // ─── TTL Utilities ──────────────────────────────────────────
+    /** Get TTL info for a key */
+    getTTL(key) {
+        const info = this.ttlMap.get(key);
+        if (!info)
+            return null;
+        const remaining = Math.max(0, info.expiresAt - Date.now());
+        return { ttl: info.ttl, createdAt: info.createdAt, expiresAt: info.expiresAt, remaining, expired: remaining <= 0 };
+    }
+    /** Refresh TTL (reset timer). Pass null to use existing TTL. */
+    refreshTTL(key, ttl) {
+        if (!(key in this.data))
+            return;
+        const finalTTL = (ttl != null && ttl > 0) ? ttl : this.ttlMap.get(key)?.ttl ?? null;
+        if (finalTTL != null && finalTTL > 0) {
+            const ms = finalTTL * 60000;
+            this.ttlMap.set(key, { ttl: finalTTL, createdAt: Date.now(), expiresAt: Date.now() + ms });
+        }
+    }
+    /** Remove TTL from key (key lives forever) */
+    removeTTL(key) {
+        this.ttlMap.delete(key);
+    }
+    // ─── Iteration ──────────────────────────────────────────────
+    /** All non-expired keys */
+    keys() {
+        this.cleanExpired();
+        return Object.keys(this.data);
+    }
+    /** All non-expired values */
+    values() {
+        return this.keys().map((k) => this.get(k));
+    }
+    /** All non-expired entries */
+    entries() {
+        return this.keys().map((k) => [k, this.get(k)]);
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────
+    /** Destroy — clear all + stop cleanup timer */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.clear();
+    }
+    // ─── Private ────────────────────────────────────────────────
+    isExpired(key) {
+        const info = this.ttlMap.get(key);
+        return info ? Date.now() > info.expiresAt : false;
+    }
+    expire(key) {
+        if (!(key in this.data))
+            return;
+        const value = this.data[key];
+        // Notify expiration listeners
+        const cbs = this.expirationListeners.get(key);
+        if (cbs) {
+            for (const cb of cbs) {
+                try {
+                    cb(value);
+                }
+                catch (e) {
+                    console.error(`[StoreService] Expiration listener error for "${key}":`, e);
+                }
+            }
+        }
+        delete this.data[key];
+        this.ttlMap.delete(key);
+        this.listeners.delete(key);
+        this.expirationListeners.delete(key);
+        this.removeDynamicProp(key);
+        this.queueChange(key);
+    }
+    cleanExpired() {
+        let count = 0;
+        for (const [key, info] of this.ttlMap) {
+            if (Date.now() > info.expiresAt) {
+                this.expire(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    queueChange(key) {
+        this.changedKeys.add(key);
+        if (!this.pendingFlush) {
+            this.pendingFlush = true;
+            Promise.resolve().then(() => this.flush());
+        }
+    }
+    flush() {
+        const keys = [...this.changedKeys];
+        this.changedKeys.clear();
+        this.pendingFlush = false;
+        this.multiListeners.forEach((l) => (l.called = false));
+        for (const key of keys) {
+            const value = this.get(key);
+            // Single-key listeners
+            const cbs = this.listeners.get(key);
+            if (cbs) {
+                for (const cb of cbs) {
+                    try {
+                        cb(value);
+                    }
+                    catch (e) {
+                        console.error(`[StoreService] Listener error for "${key}":`, e);
+                    }
+                }
+            }
+            // Multi-key listeners
+            for (const listener of this.multiListeners) {
+                if (listener.keys.has(key) && !listener.called) {
+                    listener.called = true;
+                    const values = {};
+                    for (const k of listener.keys) {
+                        if (keys.includes(k))
+                            values[k] = this.get(k);
+                    }
+                    try {
+                        listener.callback(values);
+                    }
+                    catch (e) {
+                        console.error('[StoreService] Multi-key listener error:', e);
+                    }
+                }
+            }
+        }
+    }
+    removeDynamicProp(key) {
+        try {
+            const desc = Object.getOwnPropertyDescriptor(this, key);
+            if (desc?.configurable)
+                delete this[key];
+        }
+        catch { /* noop */ }
+    }
+}
+StoreService.instances = new Map();
+/** Protected method names — cannot be used as data keys */
+StoreService.RESERVED = new Set([
+    'get', 'set', 'has', 'remove', 'clear', 'subscribe',
+    'unsubscribe', 'onExpire', 'keys', 'values', 'entries',
+    'destroy',
+]);
+//# sourceMappingURL=StoreService.js.map

package/dist/src/core/services/StoreService.js.map

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

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

@@ -0,0 +1,9 @@
+export * from "./BlockManager";
+export * from "./EventService";
+export * from "./LoggerService";
+export * from './HelperService';
+export * from './HttpService';
+export * from './MarkerRegistry';
+export * from "./StoreService";
+export * from "./StorageService";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,9 @@
+export * from "./BlockManager";
+export * from "./EventService";
+export * from "./LoggerService";
+export * from './HelperService';
+export * from './HttpService';
+export * from './MarkerRegistry';
+export * from "./StoreService";
+export * from "./StorageService";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,29 @@
+export type OneObjectType = 'Application' | 'App' | 'ServiceProvider' | 'Html' | 'Reactive' | 'TextElement' | 'Fragment' | 'Wrapper' | 'Block' | 'BlockOutlet' | 'Output' | 'ViewController' | 'View' | 'Service' | 'Router' | 'App' | 'Component' | 'Unknown' | 'Yield' | '' | null;
+export declare enum OOTEnum {
+    APPLICATION = "Application",
+    HTML = "Html",
+    REACTIVE = "Reactive",
+    TEXT_ELEMENT = "TextElement",
+    FRAGMENT = "Fragment",
+    WRAPPER = "Wrapper",
+    BLOCK = "Block",
+    BLOCK_OUTLET = "BlockOutlet",
+    OUTPUT = "Output",
+    VIEW_CONTROLLER = "ViewController",
+    VIEW = "View",
+    SERVICE = "Service",
+    ROUTER = "Router",
+    APP = "App",
+    SERVICE_PROVIDER = "ServiceProvider",
+    COMPONENT = "Component",
+    UNKNOWN = "Unknown",
+    YIELD = "Yield"
+}
+export type { OneElementConfig, HtmlElementConfig, OneElementEventHandler, OneElementChildren, OneChildrenFactoryOutput, OneChildrenFactory } from "../contracts/ElementInterface";
+export type { ReactiveRenderFn, ReactiveChildrenFactory, ReactiveConfig } from "../contracts/ReactiveInterface";
+export type { BlockRenderFactory } from "../contracts/BlockInterface";
+export type { ViewRenderFactory, ViewConstructor, ViewLifecycleHooks } from "../contracts/ViewInterface";
+export type { StateListener, MultiKeyStateListener, StateItem } from "../contracts/ViewStateInterface";
+export type { ServiceKey, ServiceFactory, ServiceBinding } from "../contracts/ApplicationInterface";
+export type { ViewConfig, ViewRuntimeConfig } from "../contracts/ViewControllerInterface";
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/core/types/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,KAAK,GAAG,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC;AACrR,oBAAY,OAAO;IACf,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,YAAY,gBAAgB;IAC5B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,YAAY,gBAAgB;IAC5B,MAAM,WAAW;IACjB,eAAe,mBAAmB;IAClC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,gBAAgB,oBAAoB;IACpC,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,KAAK,UAAU;CAClB;AAGD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnL,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChH,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzG,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACvG,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACpG,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC"}

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

@@ -0,0 +1,22 @@
+export var OOTEnum;
+(function (OOTEnum) {
+    OOTEnum["APPLICATION"] = "Application";
+    OOTEnum["HTML"] = "Html";
+    OOTEnum["REACTIVE"] = "Reactive";
+    OOTEnum["TEXT_ELEMENT"] = "TextElement";
+    OOTEnum["FRAGMENT"] = "Fragment";
+    OOTEnum["WRAPPER"] = "Wrapper";
+    OOTEnum["BLOCK"] = "Block";
+    OOTEnum["BLOCK_OUTLET"] = "BlockOutlet";
+    OOTEnum["OUTPUT"] = "Output";
+    OOTEnum["VIEW_CONTROLLER"] = "ViewController";
+    OOTEnum["VIEW"] = "View";
+    OOTEnum["SERVICE"] = "Service";
+    OOTEnum["ROUTER"] = "Router";
+    OOTEnum["APP"] = "App";
+    OOTEnum["SERVICE_PROVIDER"] = "ServiceProvider";
+    OOTEnum["COMPONENT"] = "Component";
+    OOTEnum["UNKNOWN"] = "Unknown";
+    OOTEnum["YIELD"] = "Yield";
+})(OOTEnum || (OOTEnum = {}));
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/core/types/utils.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,OAmBX;AAnBD,WAAY,OAAO;IACf,sCAA2B,CAAA;IAC3B,wBAAa,CAAA;IACb,gCAAqB,CAAA;IACrB,uCAA4B,CAAA;IAC5B,gCAAqB,CAAA;IACrB,8BAAmB,CAAA;IACnB,0BAAe,CAAA;IACf,uCAA4B,CAAA;IAC5B,4BAAiB,CAAA;IACjB,6CAAkC,CAAA;IAClC,wBAAa,CAAA;IACb,8BAAmB,CAAA;IACnB,4BAAiB,CAAA;IACjB,sBAAW,CAAA;IACX,+CAAoC,CAAA;IACpC,kCAAuB,CAAA;IACvB,8BAAmB,CAAA;IACnB,0BAAe,CAAA;AACnB,CAAC,EAnBW,OAAO,KAAP,OAAO,QAmBlB"}

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

@@ -0,0 +1,38 @@
+import type { LoopContextInterface } from "../contracts/LoopContextInterface";
+/**
+ * LoopContext — provides loop metadata for @foreach, @for, @while directives.
+ *
+ * Available properties inside loops:
+ *   $loop.index      — 0-based index
+ *   $loop.iteration  — 1-based iteration count
+ *   $loop.count      — total items (or -1 for @while)
+ *   $loop.remaining  — items left
+ *   $loop.first      — is first iteration
+ *   $loop.last       — is last iteration
+ *   $loop.odd        — is odd iteration (1-based)
+ *   $loop.even       — is even iteration (1-based)
+ *   $loop.depth      — nesting depth (starts at 1)
+ *   $loop.parent     — parent LoopContext (for nested loops)
+ */
+export declare class LoopContext implements LoopContextInterface {
+    index: number;
+    iteration: number;
+    count: number;
+    remaining: number;
+    first: boolean;
+    last: boolean;
+    odd: boolean;
+    even: boolean;
+    depth: number;
+    parent: LoopContext | null;
+    private type;
+    constructor(parent?: LoopContext | null);
+    setType(type: 'increment' | 'decrement'): void;
+    setCount(count: number): void;
+    setCurrentTimes(index: number): void;
+    next(): void;
+    reset(): void;
+    private increment;
+    private decrement;
+}
+//# sourceMappingURL=LoopContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoopContext.d.ts","sourceRoot":"","sources":["../../../../src/core/view/LoopContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,YAAW,oBAAoB;IAC7C,KAAK,EAAE,MAAM,CAAK;IAClB,SAAS,EAAE,MAAM,CAAK;IACtB,KAAK,EAAE,MAAM,CAAK;IAClB,SAAS,EAAE,MAAM,CAAM;IACvB,KAAK,EAAE,OAAO,CAAS;IACvB,IAAI,EAAE,OAAO,CAAS;IACtB,GAAG,EAAE,OAAO,CAAQ;IACpB,IAAI,EAAE,OAAO,CAAS;IACtB,KAAK,EAAE,MAAM,CAAK;IAClB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAElC,OAAO,CAAC,IAAI,CAA0C;gBAE1C,MAAM,GAAE,WAAW,GAAG,IAAW;IAO7C,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI;IAM9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW7B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYpC,IAAI,IAAI,IAAI;IAQZ,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,SAAS;CAUpB"}

package/dist/src/core/view/LoopContext.js

@@ -0,0 +1,100 @@
+/**
+ * LoopContext — provides loop metadata for @foreach, @for, @while directives.
+ *
+ * Available properties inside loops:
+ *   $loop.index      — 0-based index
+ *   $loop.iteration  — 1-based iteration count
+ *   $loop.count      — total items (or -1 for @while)
+ *   $loop.remaining  — items left
+ *   $loop.first      — is first iteration
+ *   $loop.last       — is last iteration
+ *   $loop.odd        — is odd iteration (1-based)
+ *   $loop.even       — is even iteration (1-based)
+ *   $loop.depth      — nesting depth (starts at 1)
+ *   $loop.parent     — parent LoopContext (for nested loops)
+ */
+export class LoopContext {
+    constructor(parent = null) {
+        this.index = 0;
+        this.iteration = 0;
+        this.count = 0;
+        this.remaining = -1;
+        this.first = false;
+        this.last = false;
+        this.odd = true;
+        this.even = false;
+        this.depth = 1;
+        this.type = 'increment';
+        this.parent = parent;
+        if (parent) {
+            this.depth = parent.depth + 1;
+        }
+    }
+    setType(type) {
+        if (type === 'increment' || type === 'decrement') {
+            this.type = type;
+        }
+    }
+    setCount(count) {
+        this.count = count;
+        if (count === -1) {
+            // Unknown count (@while) — remaining/last unreliable
+            this.remaining = -1;
+            this.last = false;
+        }
+        else {
+            this.remaining = count;
+        }
+    }
+    setCurrentTimes(index) {
+        this.index = index;
+        this.iteration = index + 1;
+        this.first = index === 0;
+        this.last = this.count > 0 ? index === this.count - 1 : false;
+        this.odd = this.iteration % 2 === 1;
+        this.even = !this.odd;
+        if (this.count > 0) {
+            this.remaining = this.count - this.iteration;
+        }
+    }
+    next() {
+        if (this.type === 'increment') {
+            this.increment();
+        }
+        else {
+            this.decrement();
+        }
+    }
+    reset() {
+        this.iteration = 0;
+        this.index = 0;
+        this.remaining = -1;
+        this.count = 0;
+        this.first = false;
+        this.last = false;
+        this.odd = true;
+        this.even = false;
+    }
+    increment() {
+        this.iteration++;
+        this.index = this.iteration - 1;
+        if (this.remaining !== -1) {
+            this.remaining--;
+        }
+        this.first = this.index === 0;
+        this.last = this.count > 0 ? this.index === this.count - 1 : false;
+        this.odd = this.iteration % 2 === 1;
+        this.even = !this.odd;
+    }
+    decrement() {
+        this.iteration--;
+        this.index = this.iteration - 1;
+        if (this.remaining !== -1) {
+            this.remaining++;
+        }
+        this.last = this.count > 0 ? this.index === this.count - 1 : false;
+        this.odd = this.iteration % 2 === 1;
+        this.even = !this.odd;
+    }
+}
+//# sourceMappingURL=LoopContext.js.map

package/dist/src/core/view/LoopContext.js.map

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

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

@@ -0,0 +1,41 @@
+import { HtmlInterface } from "../contracts/ElementInterface";
+import { ViewControllerInterface } from "../contracts/ViewControllerInterface";
+import { SectionConstruvtorArgs, SectionContentRenderer, SectionContentType, SectionInterface, SectionItemType } from "../contracts/views";
+export declare class Section implements SectionInterface {
+    ctx: ViewControllerInterface | undefined | null;
+    name: string;
+    type: SectionItemType;
+    contentType: SectionContentType;
+    stateKeys?: string[];
+    renderFactory: SectionContentRenderer;
+    subscribeFn: (() => void) | null;
+    unsubscribeFn: (() => void) | null;
+    content: any;
+    parentElement: HtmlInterface | undefined | null;
+    isStarted: boolean;
+    constructor({ ctx, name, type, contentType, stateKeys, renderFactory }: SectionConstruvtorArgs);
+    initialize(): void;
+    render(parentElement?: HtmlInterface | null | undefined): void;
+    start(): void;
+    stop(): void;
+}
+/**
+ * Note: The "Section" concept is being phased out in favor of a more flexible Block/BlockOutlet system.
+ * Sections are still supported for backward compatibility but may be deprecated in future versions.
+ * For new development, consider using Blocks instead of Sections for better flexibility and composability.
+ *
+ * --- CHANGELOG ---
+ * vX.X.X - Introduced Block/BlockOutlet system as a more flexible alternative to Sections.
+ *   - Sections are now considered legacy and may be deprecated in future versions.
+ *   - ViewController's section management is being refactored to support Blocks instead of Sections.
+ *   - Updated documentation and examples to encourage use of Blocks over Sections.
+ *
+ * --- FUTURE PLANS ---
+ * - Phase out Sections entirely in favor of Blocks, which offer more composability and dynamic capabilities.
+ * - Provide migration guides for existing users to transition from Sections to Blocks.
+ * - Enhance Block system with features like nested blocks, dynamic block registration, and improved lifecycle management.
+ *
+ * --- CURRENT RECOMMENDATION ---
+ * For new views, prefer using Blocks and BlockOutlets for layout composition instead of Sections. Sections will still work but are not recommended for new development.
+ */ 
+//# sourceMappingURL=Section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../src/core/view/Section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE3I,qBAAa,OAAQ,YAAW,gBAAgB;IAC5C,GAAG,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAAQ;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,aAAa,EAAE,sBAAsB,CAAC;IACtC,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IACxC,aAAa,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE1C,OAAO,EAAE,GAAG,CAAQ;IAEpB,aAAa,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAAQ;IAEvD,SAAS,EAAE,OAAO,CAAS;gBAEf,EAAE,GAAG,EAAE,IAAI,EAAE,IAAe,EAAE,WAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,sBAAsB;IAWlH,UAAU;IAQV,MAAM,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS;IAKvD,KAAK;IAYL,IAAI;CAQP;AAED;;;;;;;;;;;;;;;;;;GAkBG"}