@lark.js/mvc 0.0.15 → 0.0.16

package/dist/mark.d.ts

@@ -1,26 +0,0 @@
-/**
- * Mark/Unmark: signature-based lifecycle tracking for async callbacks.
- *
- * `mark(host, key)` returns a validity checker. The checker returns `false`
- * once the host is unmarked (e.g. when a view re-renders or is destroyed),
- * so stale async callbacks can short-circuit and skip work.
- *
- * State is stored in a module-level WeakMap, not on the host object, so
- * `mark/unmark` never pollutes user objects with magic keys, never breaks
- * on `Object.freeze`-ed inputs, and never shows up in debug snapshots.
- */
-/**
- * Create a mark for tracking async callback validity.
- * Returns a function that returns true while the mark is still valid.
- *
- * @param host - Object to associate the mark with (typically a view)
- * @param key  - Key to track (typically "render" or a specific async-op identifier)
- */
-export declare function mark(host: object, key: string): () => boolean;
-/**
- * Clear all marks for a host object, invalidating every existing checker.
- * Called when a view re-renders or is destroyed.
- *
- * @param host - Object whose marks should be invalidated
- */
-export declare function unmark(host: object): void;

package/dist/module-loader.d.ts

@@ -1,20 +0,0 @@
-/**
- * Module loader: async view loading via FrameworkConfig.require or dynamic import.
- *
- * Extracted from framework.ts to avoid circular dependency with frame.ts.
- * Both framework.ts and frame.ts import from this module.
- */
-import type { FrameworkConfig } from "./types";
-/** Framework configuration */
-export declare const config: FrameworkConfig;
-/**
- * Load modules via the configured require function or dynamic import fallback.
- *
- * Two calling conventions:
- * 1. `use(name | name[], callback)`
- * 2. `use(name | name[])` — returns Promise<unknown[]> (no callback)
- *
- * When `FrameworkConfig.require` is configured, delegates to it (e.g., Webpack Module Federation).
- * When not configured, falls back to `dynamic import()` for ESM-based loading.
- */
-export declare function use(names: string | string[], callback?: (...modules: unknown[]) => void): Promise<unknown[]>;

package/dist/router.d.ts

@@ -1,14 +0,0 @@
-import type { RouterInterface } from "./types";
-/**
- * Router with two-phase change confirmation (supports history and hash modes).
- *
- * @example
- * Router.to('/list', { page: 2 });
- * const loc = Router.parse();
- * const diff = Router.diff();
- */
-export declare const Router: RouterInterface;
-/** Mark framework as booted (called by Framework.boot) */
-export declare function markRouterBooted(): void;
-/** Get current routing mode */
-export declare function getRouteMode(): "history" | "hash";

package/dist/runtime.amd.js

@@ -1,94 +0,0 @@
-define('lark-mvc/runtime', ['exports'], (function (exports) { 'use strict';
-
-    /**
-     * Lark framework constants.
-     */
-    /** Global counter for generating unique IDs */
-    /** Internal splitter character (U+001E Record Separator, invisible, used as namespace separator).
-     * Uses String.fromCharCode to survive bundlers that strip control-char literals. */
-    const SPLITTER = String.fromCharCode(0x1e);
-    // ============================================================
-    // Encoding helpers (shared by dom.ts, runtime.ts, updater.ts)
-    // ============================================================
-    const HTML_ENT_MAP = {
-        "&": "amp",
-        "<": "lt",
-        ">": "gt",
-        '"': "#34",
-        "'": "#39",
-        "`": "#96",
-    };
-    const HTML_ENT_REGEXP = /[&<>"'`]/g;
-    /** Null-safe String conversion */
-    function strSafe$1(v) {
-        return String(v == null ? "" : v);
-    }
-    /** HTML entity encoding for safe output */
-    function encodeHTML(v) {
-        return String(v == null ? "" : v).replace(HTML_ENT_REGEXP, (m) => "&" + HTML_ENT_MAP[m] + ";");
-    }
-    const URI_ENT_MAP = {
-        "!": "%21",
-        "'": "%27",
-        "(": "%28",
-        ")": "%29",
-        "*": "%2A",
-    };
-    const URI_ENT_REGEXP = /[!')(*]/g;
-    /** URI-encode with extra character encoding */
-    function encodeURIExtra(v) {
-        return encodeURIComponent(strSafe$1(v)).replace(URI_ENT_REGEXP, (m) => URI_ENT_MAP[m]);
-    }
-    const QUOTE_ENT_REGEXP = /['"\\]/g;
-    /** Quote-encode for attribute values */
-    function encodeQuote(v) {
-        return strSafe$1(v).replace(QUOTE_ENT_REGEXP, "\\$&");
-    }
-    /**
-     * Template reference function for creating stable keys for objects.
-     * Stores objects in refData with SPLITTER-prefixed keys.
-     */
-    function refFn(ref, value, key) {
-        const counter = ref[SPLITTER];
-        for (let i = counter; --i;) {
-            key = SPLITTER + i;
-            if (ref[key] === value)
-                return key;
-        }
-        key = SPLITTER + ref[SPLITTER]++;
-        ref[key] = value;
-        return key;
-    }
-    // export function isCjs(): boolean {
-    //   return typeof module !== "undefined" && typeof module.exports !== "undefined";
-    // }
-
-    /**
-     * Template runtime helpers.
-     *
-     * Compiled templates import these helpers from `@lark.js/mvc/runtime` instead
-     * of inlining the implementations. That keeps each compiled `.html` module
-     * small — no more ~400 bytes of duplicated helper code per template.
-     *
-     * The helpers below are aliased to `$strSafe / $encHtml / $encUri / $encQuote /
-     * $refFn` inside the IIFE that the compiler produces — see `compiler.ts`.
-     *
-     * Canonical implementations live in `./common` so that dom.ts, runtime.ts,
-     * and updater.ts all share a single copy.
-     */
-    /** Null-safe `String(value)` — `null`/`undefined` become `""`. */
-    const strSafe = strSafe$1;
-    /** HTML-escape a value for safe embedding in markup. */
-    const encHtml = encodeHTML;
-    /** Percent-encode a value, with extra characters escaped for stricter URIs. */
-    const encUri = encodeURIExtra;
-    /** Backslash-escape quotes and backslashes for attribute string contents. */
-    const encQuote = encodeQuote;
-
-    exports.encHtml = encHtml;
-    exports.encQuote = encQuote;
-    exports.encUri = encUri;
-    exports.refFn = refFn;
-    exports.strSafe = strSafe;
-
-}));

package/dist/runtime.umd.js

@@ -1,98 +0,0 @@
-(function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-    typeof define === 'function' && define.amd ? define(['exports'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.LarkMvc = {}));
-})(this, (function (exports) { 'use strict';
-
-    /**
-     * Lark framework constants.
-     */
-    /** Global counter for generating unique IDs */
-    /** Internal splitter character (U+001E Record Separator, invisible, used as namespace separator).
-     * Uses String.fromCharCode to survive bundlers that strip control-char literals. */
-    const SPLITTER = String.fromCharCode(0x1e);
-    // ============================================================
-    // Encoding helpers (shared by dom.ts, runtime.ts, updater.ts)
-    // ============================================================
-    const HTML_ENT_MAP = {
-        "&": "amp",
-        "<": "lt",
-        ">": "gt",
-        '"': "#34",
-        "'": "#39",
-        "`": "#96",
-    };
-    const HTML_ENT_REGEXP = /[&<>"'`]/g;
-    /** Null-safe String conversion */
-    function strSafe$1(v) {
-        return String(v == null ? "" : v);
-    }
-    /** HTML entity encoding for safe output */
-    function encodeHTML(v) {
-        return String(v == null ? "" : v).replace(HTML_ENT_REGEXP, (m) => "&" + HTML_ENT_MAP[m] + ";");
-    }
-    const URI_ENT_MAP = {
-        "!": "%21",
-        "'": "%27",
-        "(": "%28",
-        ")": "%29",
-        "*": "%2A",
-    };
-    const URI_ENT_REGEXP = /[!')(*]/g;
-    /** URI-encode with extra character encoding */
-    function encodeURIExtra(v) {
-        return encodeURIComponent(strSafe$1(v)).replace(URI_ENT_REGEXP, (m) => URI_ENT_MAP[m]);
-    }
-    const QUOTE_ENT_REGEXP = /['"\\]/g;
-    /** Quote-encode for attribute values */
-    function encodeQuote(v) {
-        return strSafe$1(v).replace(QUOTE_ENT_REGEXP, "\\$&");
-    }
-    /**
-     * Template reference function for creating stable keys for objects.
-     * Stores objects in refData with SPLITTER-prefixed keys.
-     */
-    function refFn(ref, value, key) {
-        const counter = ref[SPLITTER];
-        for (let i = counter; --i;) {
-            key = SPLITTER + i;
-            if (ref[key] === value)
-                return key;
-        }
-        key = SPLITTER + ref[SPLITTER]++;
-        ref[key] = value;
-        return key;
-    }
-    // export function isCjs(): boolean {
-    //   return typeof module !== "undefined" && typeof module.exports !== "undefined";
-    // }
-
-    /**
-     * Template runtime helpers.
-     *
-     * Compiled templates import these helpers from `@lark.js/mvc/runtime` instead
-     * of inlining the implementations. That keeps each compiled `.html` module
-     * small — no more ~400 bytes of duplicated helper code per template.
-     *
-     * The helpers below are aliased to `$strSafe / $encHtml / $encUri / $encQuote /
-     * $refFn` inside the IIFE that the compiler produces — see `compiler.ts`.
-     *
-     * Canonical implementations live in `./common` so that dom.ts, runtime.ts,
-     * and updater.ts all share a single copy.
-     */
-    /** Null-safe `String(value)` — `null`/`undefined` become `""`. */
-    const strSafe = strSafe$1;
-    /** HTML-escape a value for safe embedding in markup. */
-    const encHtml = encodeHTML;
-    /** Percent-encode a value, with extra characters escaped for stricter URIs. */
-    const encUri = encodeURIExtra;
-    /** Backslash-escape quotes and backslashes for attribute string contents. */
-    const encQuote = encodeQuote;
-
-    exports.encHtml = encHtml;
-    exports.encQuote = encQuote;
-    exports.encUri = encUri;
-    exports.refFn = refFn;
-    exports.strSafe = strSafe;
-
-}));

package/dist/service.d.ts

@@ -1,173 +0,0 @@
-import { Cache } from "./cache";
-import { EventEmitter } from "./event-emitter";
-import type { AnyFunc, ServiceMetaEntry, ServiceCacheInfo, PendingCacheEntry, PayloadInterface, EventEmitterInterface } from "./types";
-/**
- * Payload wraps API response data with convenient access methods.
- */
-export declare class Payload implements PayloadInterface {
-    /** Payload data */
-    data: Record<string, unknown>;
-    /** Internal cache info */
-    cacheInfo?: ServiceCacheInfo;
-    constructor(data?: Record<string, unknown>);
-    /** Get a value from payload data */
-    get<T = unknown>(key: string): T;
-    /** Set a value in payload data */
-    set(keyOrData: string | Record<string, unknown> | ServiceMetaEntry, value?: unknown): PayloadInterface;
-}
-/**
- * Minimal interface describing what serviceSend actually uses
- * from a service instance. This avoids coupling to the full
- * ServiceInterface which mixes instance and static methods.
- */
-interface ServiceSendTarget {
-    destroyed: number;
-    busy: number;
-    internals: {
-        metaList: Record<string, ServiceMetaEntry>;
-        payloadCache: Cache<Payload>;
-        pendingCacheKeys: Record<string, PendingCacheEntry>;
-        syncFn: (payload: Payload, callback: () => void) => void;
-        staticEmitter: EventEmitter;
-    };
-    type: {
-        get(attrs: Record<string, unknown>, createNew?: boolean): {
-            entity: Payload;
-            needsUpdate: boolean;
-        };
-    };
-    enqueue(callback: AnyFunc): unknown;
-}
-/**
- * Service: API request management with caching, deduplication, and queue.
- *
- * - Service.extend(syncFn, cacheMax?, cacheBuffer?): creates subclass with sync function
- * - Service.add(attrs): registers API endpoint metadata
- * - new Service().all(attrs, done): fetch all, use cache when available
- * - new Service().one(attrs, done): fetch all, callback on each completion
- * - new Service().save(attrs, done): fetch all, skip cache (always request)
- * - enqueue/dequeue: task queue for sequential async operations
- * - destroy: cancel pending requests
- *
- * Per-type state (metaList, payloadCache, pendingCacheKeys, syncFn, staticEmitter)
- * is stored as static class properties. When extend() creates a subclass,
- * each subclass gets its own copies of these static properties, ensuring
- * isolation between different Service types.
- */
-export declare class Service {
-    /** Service instance ID */
-    id: string;
-    /** Whether service is busy (1 = busy) */
-    busy: number;
-    /** Whether service is destroyed (1 = destroyed) */
-    destroyed: number;
-    /** Task queue for sequential operations */
-    taskQueue: AnyFunc[];
-    /** Previous dequeue arguments */
-    prevArgs: unknown[];
-    /** Instance event emitter */
-    private _emitter;
-    constructor();
-    /** Instance event emitter (public accessor) */
-    get emitter(): EventEmitterInterface;
-    /**
-     * Get internals object for serviceSend compatibility.
-     * References per-type static state from the current class.
-     */
-    get internals(): ServiceSendTarget["internals"];
-    /**
-     * Get type reference (the constructor) for serviceSend compatibility.
-     * Static methods like get/create are accessible via the constructor.
-     */
-    get type(): ServiceSendTarget["type"];
-    /**
-     * Fetch all endpoints, callback when all complete.
-     * Uses cache when available.
-     */
-    all(attrs: string | Record<string, unknown> | (string | Record<string, unknown>)[], done: AnyFunc): this;
-    /**
-     * Fetch all endpoints, callback on each completion.
-     */
-    one(attrs: string | Record<string, unknown> | (string | Record<string, unknown>)[], done: AnyFunc): this;
-    /**
-     * Fetch all endpoints, skip cache (always request).
-     */
-    save(attrs: string | Record<string, unknown> | (string | Record<string, unknown>)[], done: AnyFunc): this;
-    /**
-     * Enqueue a task for sequential execution.
-     */
-    enqueue(callback: AnyFunc): this;
-    /**
-     * Dequeue and execute the next task in queue.
-     */
-    dequeue(...args: unknown[]): void;
-    /**
-     * Destroy the service instance.
-     * After destruction, no new requests can be sent.
-     */
-    destroy(): void;
-    on(event: string, handler: AnyFunc): this;
-    off(event: string, handler?: AnyFunc): this;
-    fire(event: string, data?: Record<string, unknown>): this;
-    /** Per-type metadata registry */
-    static _metaList: Record<string, ServiceMetaEntry>;
-    /** Per-type payload cache (LFU with frequency eviction) */
-    static _payloadCache: Cache<Payload>;
-    /** Per-type pending cache keys for deduplication */
-    static _pendingCacheKeys: Record<string, PendingCacheEntry>;
-    /** Per-type sync function */
-    static _syncFn: (payload: Payload, callback: () => void) => void;
-    /** Per-type static event emitter */
-    static _staticEmitter: EventEmitter<unknown>;
-    /** Per-type cache max size */
-    static _cacheMax: number;
-    /** Per-type cache buffer size */
-    static _cacheBuffer: number;
-    /**
-     * Register API endpoint metadata.
-     */
-    static add(attrs: ServiceMetaEntry | ServiceMetaEntry[]): void;
-    /**
-     * Get metadata for an API endpoint.
-     */
-    static meta(attrs: string | Record<string, unknown>): ServiceMetaEntry;
-    /**
-     * Create a Payload for an API request.
-     */
-    static create(attrs: Record<string, unknown>): Payload;
-    /**
-     * Get or create a Payload for an API request.
-     */
-    static get(attrs: Record<string, unknown>, createNew?: boolean): {
-        entity: Payload;
-        needsUpdate: boolean;
-    };
-    /**
-     * Get cached Payload if available and not expired.
-     */
-    static cached(attrs: Record<string, unknown>): Payload | undefined;
-    /**
-     * Clear cached payloads by endpoint name.
-     */
-    static clear(names: string | string[]): void;
-    static on(event: string, handler: AnyFunc): void;
-    static off(event: string, handler?: AnyFunc): void;
-    static fire(event: string, data?: Record<string, unknown>): void;
-    /**
-     * Create a new Service subclass with a custom sync function.
-     *
-     * Each subclass gets its OWN copies of every per-type static field
-     * (`_metaList`, `_payloadCache`, `_pendingCacheKeys`, `_syncFn`,
-     * `_staticEmitter`, `_cacheMax`, `_cacheBuffer`) via `static override`.
-     * This is intentional: it ensures that endpoint metadata, cache state,
-     * in-flight dedup keys, and event subscribers are fully isolated between
-     * different Service types, even when one extends another.
-     *
-     * **Do not refactor these `static override` declarations away** — sharing
-     * them through prototype inheritance would let endpoints registered on one
-     * subclass leak into another, and the LFU cache evictions of one type
-     * would race with those of another.
-     */
-    static extend(this: typeof Service, newSyncFn: (payload: Payload, callback: () => void) => void, newCacheMax?: number, newCacheBuffer?: number): typeof Service;
-}
-export {};

package/dist/state.d.ts

@@ -1,8 +0,0 @@
-import type { StateInterface } from "./types";
-/** Mark framework as booted (called from Framework.boot) */
-export declare function markBooted(): void;
-/**
- * Observable in-memory data object.
- * Provides get/set/digest/diff/clean methods for cross-view data sharing.
- */
-export declare const State: StateInterface;

package/dist/store.d.ts

@@ -1,60 +0,0 @@
-/**
- * @lark.js/mvc Store
- *
- * Zustand-aligned state management for Lark MVC.
- *
- * Core API:
- * - create(name, creator): define a store with (set, get) => initialState
- * - store.getState(): read current state snapshot
- * - store.setState(partial | updater): shallow-merge state and notify listeners
- * - store.subscribe(listener): listen for state changes
- * - store.destroy(): tear down the store
- * - computed(deps, fn): derived state that auto-recomputes when deps change
- * - bindStore(view, store, selector?): Lark View lifecycle binding
- */
-type Listener<T> = (state: T, prevState: T) => void;
-export interface StoreApi<T = Record<string, unknown>> {
-    getState(): T;
-    setState(partial: Partial<T> | ((prev: T) => Partial<T>)): void;
-    subscribe(listener: Listener<T>): () => void;
-    destroy(): void;
-}
-type StateCreator<T> = (set: (partial: Partial<T> | ((prev: T) => Partial<T>)) => void, get: () => T) => T;
-/**
- * Declare a derived (computed) store property.
- *
- * Usage inside a `create` creator:
- * ```ts
- * const store = create("counter", (set, get) => ({
- *   count: 0,
- *   doubled: computed(["count"], () => get().count * 2),
- * }));
- * ```
- *
- * `deps` lists the state keys the computed reads. Whenever any dep changes
- * via `setState`, the computed re-evaluates before listeners are notified.
- * Writes to a computed key via `setState` are silently ignored.
- */
-export declare function computed<T>(deps: readonly string[], fn: () => T): T;
-export declare function create<T>(name: string, creator: StateCreator<T>): StoreApi<T>;
-/**
- * Bind a store to a Lark View. Subscribes to state changes and auto-unsubscribes
- * when the view is destroyed.
- *
- * @param view - Lark View instance (must have updater.set/digest and on("destroy"))
- * @param store - Store created via `create()`
- * @param selector - Optional function to pick a subset of state for the updater.
- *   If omitted, only non-function state keys are forwarded.
- * @returns unsubscribe function
- *
- * @example
- * ```ts
- * // Observe all state
- * bindStore(this, useCountStore);
- *
- * // Observe with selector
- * bindStore(this, useCountStore, (s) => ({ count: s.count }));
- * ```
- */
-export declare function bindStore<T>(view: unknown, store: StoreApi<T>, selector?: (state: T) => Record<string, unknown>): () => void;
-export {};