rune-lab 0.3.1 → 0.4.1

package/dist/state/cart.svelte.d.ts

@@ -1,64 +0,0 @@
-import type { PersistenceDriver } from "rune-lab/core";
-/**
- * Configuration for creating a CartStore
- */
-export interface CartStoreConfig<T> {
-    /** Extract a unique identifier from an item */
-    idExtractor: (item: T) => string;
-    /** Extract the price (in minor units / cents) from an item */
-    priceExtractor: (item: T) => number;
-    /** Optional persistence driver for cart recovery */
-    driver?: PersistenceDriver;
-    /** Storage key for persistence */
-    storageKey?: string;
-}
-export interface CartEntry<T> {
-    item: T;
-    qty: number;
-}
-/**
- * Generic cart store factory.
- * Works with any item type via extractors.
- *
- * **Note**: Consumers must call `setContext(RUNE_LAB_CONTEXT.cart, store)` manually
- * since CartStore is app-specific (needs `idExtractor` and `priceExtractor`).
- * RuneProvider can optionally wire it via `config.cart`.
- *
- * Usage:
- *   const cart = createCartStore<Property>({
- *     idExtractor: (p) => p.id,
- *     priceExtractor: (p) => p.price,
- *   });
- *   cart.add(someProperty);
- *   cart.totalPrice; // sum of all items * qty in minor units
- */
-export declare function createCartStore<T>(config: CartStoreConfig<T>): {
-    /** All cart entries */
-    readonly items: CartEntry<T>[];
-    /** Total number of items (sum of quantities) */
-    readonly totalItems: number;
-    /** Total price in minor units */
-    readonly totalPrice: number;
-    /** Whether the cart is empty */
-    readonly isEmpty: boolean;
-    /** Add an item (or increment quantity if already present) */
-    add(item: T, qty?: number): void;
-    /** Remove an item entirely */
-    remove(id: string): void;
-    /** Update the quantity of an item (removes if qty ≤ 0) */
-    updateQty(id: string, qty: number): void;
-    /** Clear all items */
-    clear(): void;
-    /** Check if an item is in the cart */
-    has(id: string): boolean;
-    /** Get a specific entry by ID */
-    getEntry(id: string): CartEntry<T> | undefined;
-};
-/** Return type of createCartStore for context typing */
-export type CartStore<T = unknown> = ReturnType<typeof createCartStore<T>>;
-/**
- * Get CartStore from Svelte context.
- * Only works if the consuming app has called setContext(RUNE_LAB_CONTEXT.cart, store)
- * or passed a cart config to RuneProvider.
- */
-export declare function getCartStore<T = unknown>(): CartStore<T>;

package/dist/state/cart.svelte.js

@@ -1,122 +0,0 @@
-// sdk/state/src/cart.svelte.ts
-// Generic cart store factory — business-agnostic add/remove/total pattern.
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context";
-import { DEV } from "esm-env";
-/**
- * Generic cart store factory.
- * Works with any item type via extractors.
- *
- * **Note**: Consumers must call `setContext(RUNE_LAB_CONTEXT.cart, store)` manually
- * since CartStore is app-specific (needs `idExtractor` and `priceExtractor`).
- * RuneProvider can optionally wire it via `config.cart`.
- *
- * Usage:
- *   const cart = createCartStore<Property>({
- *     idExtractor: (p) => p.id,
- *     priceExtractor: (p) => p.price,
- *   });
- *   cart.add(someProperty);
- *   cart.totalPrice; // sum of all items * qty in minor units
- */
-export function createCartStore(config) {
-    const { idExtractor, priceExtractor, driver, storageKey = "cart", } = config;
-    // Internal entries store — using a plain array for correct serialization
-    let _entries = $state([]);
-    /** Lookup by ID */
-    function _findIndex(id) {
-        return _entries.findIndex((e) => idExtractor(e.item) === id);
-    }
-    /** @internal Persist current state (Map serialized as Array) */
-    function _persist() {
-        if (!driver)
-            return;
-        try {
-            const data = _entries.map((entry) => ({
-                id: idExtractor(entry.item),
-                qty: entry.qty,
-            }));
-            driver.set(storageKey, JSON.stringify(data));
-        }
-        catch {
-            // Persistence is best-effort
-        }
-    }
-    return {
-        /** All cart entries */
-        get items() {
-            return _entries;
-        },
-        /** Total number of items (sum of quantities) */
-        get totalItems() {
-            let total = 0;
-            for (const entry of _entries)
-                total += entry.qty;
-            return total;
-        },
-        /** Total price in minor units */
-        get totalPrice() {
-            let total = 0;
-            for (const entry of _entries) {
-                total += priceExtractor(entry.item) * entry.qty;
-            }
-            return total;
-        },
-        /** Whether the cart is empty */
-        get isEmpty() {
-            return _entries.length === 0;
-        },
-        /** Add an item (or increment quantity if already present) */
-        add(item, qty = 1) {
-            const id = idExtractor(item);
-            const idx = _findIndex(id);
-            if (idx >= 0) {
-                _entries[idx] = { ..._entries[idx], qty: _entries[idx].qty + qty };
-            }
-            else {
-                _entries = [..._entries, { item, qty }];
-            }
-            _persist();
-            if (DEV)
-                console.log(`🛒 Added ${id} (qty: ${qty})`);
-        },
-        /** Remove an item entirely */
-        remove(id) {
-            _entries = _entries.filter((e) => idExtractor(e.item) !== id);
-            _persist();
-        },
-        /** Update the quantity of an item (removes if qty ≤ 0) */
-        updateQty(id, qty) {
-            if (qty <= 0) {
-                this.remove(id);
-                return;
-            }
-            const idx = _findIndex(id);
-            if (idx >= 0) {
-                _entries[idx] = { ..._entries[idx], qty };
-                _persist();
-            }
-        },
-        /** Clear all items */
-        clear() {
-            _entries = [];
-            _persist();
-        },
-        /** Check if an item is in the cart */
-        has(id) {
-            return _findIndex(id) >= 0;
-        },
-        /** Get a specific entry by ID */
-        getEntry(id) {
-            return _entries.find((e) => idExtractor(e.item) === id);
-        },
-    };
-}
-/**
- * Get CartStore from Svelte context.
- * Only works if the consuming app has called setContext(RUNE_LAB_CONTEXT.cart, store)
- * or passed a cart config to RuneProvider.
- */
-export function getCartStore() {
-    return getContext(RUNE_LAB_CONTEXT.cart);
-}

package/dist/state/commands.svelte.d.ts

@@ -1,46 +0,0 @@
-import type { AppStore } from "./app.svelte";
-import type { ApiStore } from "./api.svelte";
-import type { ConfigStore } from "./createConfigStore.svelte";
-import type { ToastStore } from "./toast.svelte";
-import type { Theme } from "./theme.svelte";
-import type { Language } from "./language.svelte";
-import type { Currency } from "./currency.svelte";
-/**
- * Command Palette Store
- */
-export interface Command {
-    id: string;
-    label: string;
-    category?: string;
-    icon?: string;
-    action?: () => void;
-    children?: Command[];
-}
-export interface CommandServices {
-    appStore: AppStore;
-    apiStore: ApiStore;
-    toastStore: ToastStore;
-    themeStore: ConfigStore<Theme>;
-    languageStore: ConfigStore<Language>;
-    currencyStore: ConfigStore<Currency>;
-}
-export declare class CommandStore {
-    #private;
-    constructor(services: CommandServices);
-    commands: Command[];
-    refreshDefaultCommands(): void;
-    /**
-     * Register a new command
-     */
-    register(command: Command): void;
-    /**
-     * Remove a command by id
-     */
-    unregister(id: string): void;
-    /**
-     * Search commands, optionally scoped to a parent's children
-     */
-    search(query: string, parentId?: string): Command[];
-}
-export declare function createCommandStore(services: CommandServices): CommandStore;
-export declare function getCommandStore(): CommandStore;

package/dist/state/commands.svelte.js

@@ -1,62 +0,0 @@
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context";
-export class CommandStore {
-    // Dependency Injection
-    #services;
-    constructor(services) {
-        this.#services = services;
-        this.refreshDefaultCommands();
-    }
-    commands = $state([]);
-    refreshDefaultCommands() {
-        // Intentionally empty.
-        // Consumers (like the demo app) should inject their own default commands via `commandStore.register`.
-        this.commands = [];
-    }
-    /**
-     * Register a new command
-     */
-    register(command) {
-        if (this.commands.find((c) => c.id === command.id))
-            return;
-        this.commands.push(command);
-    }
-    /**
-     * Remove a command by id
-     */
-    unregister(id) {
-        this.commands = this.commands.filter((c) => c.id !== id);
-    }
-    /**
-     * Search commands, optionally scoped to a parent's children
-     */
-    search(query, parentId) {
-        const targetList = parentId
-            ? this.#findById(parentId, this.commands)?.children ?? []
-            : this.commands;
-        if (!query)
-            return targetList;
-        const q = query.toLowerCase();
-        return targetList.filter((c) => c.label.toLowerCase().includes(q) ||
-            c.category?.toLowerCase().includes(q));
-    }
-    // Native JS private field — TypeScript CAN emit .d.ts for this, unlike `private`
-    #findById(id, list) {
-        for (const cmd of list) {
-            if (cmd.id === id)
-                return cmd;
-            if (cmd.children) {
-                const found = this.#findById(id, cmd.children);
-                if (found)
-                    return found;
-            }
-        }
-        return undefined;
-    }
-}
-export function createCommandStore(services) {
-    return new CommandStore(services);
-}
-export function getCommandStore() {
-    return getContext(RUNE_LAB_CONTEXT.commands);
-}

package/dist/state/composables/useMoney.d.ts

@@ -1,15 +0,0 @@
-import { type Dinero, type ISO4217Code } from "rune-lab/core";
-/**
- * Context-aware money composable.
- * Reads CurrencyStore and LanguageStore from rune-lab context.
- *
- * Usage:
- *   const { format, toDinero, add, subtract } = useMoney();
- *   const display = format(150.00, undefined, 'major'); // "$150.00"
- */
-export declare function useMoney(): {
-    toDinero: (amount: number | null | undefined, currencyCode?: ISO4217Code | string, unit?: "major" | "minor") => Dinero<number>;
-    format: (amount: number | null | undefined, currencyCode?: ISO4217Code | string, unit?: "major" | "minor") => string;
-    add: (a: number, b: number, currencyCode?: ISO4217Code | string, unit?: "major" | "minor") => Dinero<number>;
-    subtract: (a: number, b: number, currencyCode?: ISO4217Code | string, unit?: "major" | "minor") => Dinero<number>;
-};

package/dist/state/composables/useMoney.js

@@ -1,62 +0,0 @@
-// sdk/state/src/composables/useMoney.ts
-// Context-aware money composable that reads CurrencyStore + LanguageStore
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "../context";
-import { addMoney, createMoney, formatMoney, subtractMoney, toMinorUnit, } from "rune-lab/core";
-/**
- * Context-aware money composable.
- * Reads CurrencyStore and LanguageStore from rune-lab context.
- *
- * Usage:
- *   const { format, toDinero, add, subtract } = useMoney();
- *   const display = format(150.00, undefined, 'major'); // "$150.00"
- */
-export function useMoney() {
-    const currencyStore = getContext(RUNE_LAB_CONTEXT.currency);
-    const languageStore = getContext(RUNE_LAB_CONTEXT.language);
-    /**
-     * Convert amount to a Dinero object using current currency
-     */
-    function toDinero(amount, currencyCode, unit = "minor") {
-        const code = currencyCode ?? String(currencyStore.current);
-        const minorAmount = unit === "major" && amount !== null && amount !== undefined
-            ? toMinorUnit(Number(amount), code)
-            : amount;
-        return createMoney(minorAmount, code);
-    }
-    /**
-     * Format an amount as a locale-aware currency string
-     */
-    function format(amount, currencyCode, unit = "minor") {
-        if (amount === null || amount === undefined ||
-            (typeof amount === "number" && isNaN(amount))) {
-            return "—";
-        }
-        const code = currencyCode ?? String(currencyStore.current);
-        const locale = String(languageStore.current) || "en";
-        const minorAmount = unit === "major"
-            ? toMinorUnit(Number(amount), code)
-            : amount;
-        const money = createMoney(minorAmount, code);
-        return formatMoney(money, locale, code);
-    }
-    /**
-     * Add two amounts in the current currency
-     */
-    function add(a, b, currencyCode, unit = "minor") {
-        const code = currencyCode ?? String(currencyStore.current);
-        const aMoney = toDinero(a, code, unit);
-        const bMoney = toDinero(b, code, unit);
-        return addMoney(aMoney, bMoney);
-    }
-    /**
-     * Subtract two amounts in the current currency
-     */
-    function subtract(a, b, currencyCode, unit = "minor") {
-        const code = currencyCode ?? String(currencyStore.current);
-        const aMoney = toDinero(a, code, unit);
-        const bMoney = toDinero(b, code, unit);
-        return subtractMoney(aMoney, bMoney);
-    }
-    return { toDinero, format, add, subtract };
-}

package/dist/state/composables/usePersistence.d.ts

@@ -1,2 +0,0 @@
-import type { PersistenceDriver } from "rune-lab/core";
-export declare function usePersistence(): PersistenceDriver | undefined;

package/dist/state/composables/usePersistence.js

@@ -1,5 +0,0 @@
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "../context";
-export function usePersistence() {
-    return getContext(RUNE_LAB_CONTEXT.persistence);
-}

package/dist/state/composables/useRuneLab.d.ts

@@ -1,19 +0,0 @@
-import { getApiStore, getAppStore, getCommandStore, getCurrencyStore, getLanguageStore, getLayoutStore, getShortcutStore, getThemeStore, getToastStore, type SessionStore } from "../index";
-export interface RuneLabContext {
-    app: ReturnType<typeof getAppStore>;
-    api: ReturnType<typeof getApiStore>;
-    toast: ReturnType<typeof getToastStore>;
-    theme: ReturnType<typeof getThemeStore>;
-    language: ReturnType<typeof getLanguageStore>;
-    currency: ReturnType<typeof getCurrencyStore>;
-    shortcut: ReturnType<typeof getShortcutStore>;
-    layout: ReturnType<typeof getLayoutStore>;
-    commands: ReturnType<typeof getCommandStore>;
-    /** Available when auth is enabled in RuneProvider config */
-    session?: SessionStore;
-}
-/**
- * Retrieves all Rune Lab stores from the Svelte context tree.
- * Must be called during component initialization (in the `<script>` block).
- */
-export declare function useRuneLab(): RuneLabContext;

package/dist/state/composables/useRuneLab.js

@@ -1,30 +0,0 @@
-// src/lib/composables/useRuneLab.ts
-import { getApiStore, getAppStore, getCommandStore, getCurrencyStore, getLanguageStore, getLayoutStore, getShortcutStore, getThemeStore, getToastStore, } from "../index";
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "../context";
-/**
- * Retrieves all Rune Lab stores from the Svelte context tree.
- * Must be called during component initialization (in the `<script>` block).
- */
-export function useRuneLab() {
-    // Session is optional — only present when auth is enabled
-    let session;
-    try {
-        session = getContext(RUNE_LAB_CONTEXT.session);
-    }
-    catch {
-        // Auth not enabled — session stays undefined
-    }
-    return {
-        app: getAppStore(),
-        api: getApiStore(),
-        toast: getToastStore(),
-        theme: getThemeStore(),
-        language: getLanguageStore(),
-        currency: getCurrencyStore(),
-        shortcut: getShortcutStore(),
-        layout: getLayoutStore(),
-        commands: getCommandStore(),
-        session,
-    };
-}

package/dist/state/context.d.ts

@@ -1,14 +0,0 @@
-export declare const RUNE_LAB_CONTEXT: {
-    readonly app: symbol;
-    readonly api: symbol;
-    readonly toast: symbol;
-    readonly theme: symbol;
-    readonly language: symbol;
-    readonly currency: symbol;
-    readonly shortcut: symbol;
-    readonly layout: symbol;
-    readonly commands: symbol;
-    readonly persistence: symbol;
-    readonly cart: symbol;
-    readonly session: symbol;
-};

package/dist/state/context.js

@@ -1,15 +0,0 @@
-// src/lib/context.ts
-export const RUNE_LAB_CONTEXT = {
-    app: Symbol("rl:app"),
-    api: Symbol("rl:api"),
-    toast: Symbol("rl:toast"),
-    theme: Symbol("rl:theme"),
-    language: Symbol("rl:language"),
-    currency: Symbol("rl:currency"),
-    shortcut: Symbol("rl:shortcut"),
-    layout: Symbol("rl:layout"),
-    commands: Symbol("rl:commands"),
-    persistence: Symbol("rl:persistence"),
-    cart: Symbol("rl:cart"),
-    session: Symbol("rl:session"),
-};

package/dist/state/createConfigStore.svelte.d.ts

@@ -1,55 +0,0 @@
-import { type PersistenceDriver } from "rune-lab/core";
-export type ConfigStore<T extends ConfigItem> = {
-    current: T[keyof T];
-    available: T[];
-    set: (id: T[keyof T]) => void;
-    get: (id: T[keyof T]) => T | undefined;
-    getProp: <K extends keyof T>(prop: K, id?: T[keyof T]) => T[K] | undefined;
-    /** Append additional items (e.g. custom themes/currencies from the consuming app) */
-    addItems: (newItems: T[]) => void;
-};
-/**
- * Generic configuration store factory
- * Creates type-safe stores for theme, language, currency, etc.
- * with validation, persistence, and utilities
- */
-export interface ConfigItem {
-    [key: string]: any;
-}
-export interface ConfigStoreOptions<T extends ConfigItem> {
-    /** Array of available items */
-    items: readonly T[];
-    /** Storage key used by the persistence driver */
-    storageKey: string;
-    /** Display name for logging (e.g., "Theme", "Language") */
-    displayName: string;
-    /** Key to use as identifier (e.g., "code", "name") */
-    idKey: keyof T;
-    /** Icon for logs */
-    icon?: string;
-    /** Persistence driver */
-    driver?: PersistenceDriver;
-}
-/**
- * Creates a reactive configuration store with persistence
- */
-export declare function createConfigStore<T extends ConfigItem>(options: ConfigStoreOptions<T>): {
-    current: T[keyof T];
-    available: T[];
-    /**
-     * Set current item with validation
-     */
-    set(id: T[keyof T]): void;
-    /**
-     * Get item by id
-     */
-    get(id: T[keyof T]): T | undefined;
-    /**
-     * Get property from current or specified item
-     */
-    getProp<K extends keyof T>(prop: K, id?: T[keyof T]): T[K] | undefined;
-    /**
-     * Append additional items (deduplicates by idKey)
-     */
-    addItems(newItems: T[]): void;
-};

package/dist/state/createConfigStore.svelte.js

@@ -1,61 +0,0 @@
-// client/sdk/devtools/src/patterns/createConfigStore.svelte.ts
-import { createInMemoryDriver } from "./persistence/drivers";
-import { DEV } from "esm-env";
-/**
- * Creates a reactive configuration store with persistence
- */
-export function createConfigStore(options) {
-    const { items, storageKey, displayName, idKey, icon = "⚙️", driver = createInMemoryDriver(), } = options;
-    class ConfigStore {
-        current = $state(items[0]?.[idKey] ?? "");
-        available = $state([...items]);
-        constructor() {
-            const saved = driver.get(storageKey);
-            // Only load saved if it actually exists in our available items
-            if (saved && this.get(saved)) {
-                this.current = saved;
-            }
-            if (DEV) {
-                console.log(`${icon} ${displayName} configured:`, {
-                    current: this.current,
-                });
-            }
-        }
-        /**
-         * Set current item with validation
-         */
-        set(id) {
-            const item = this.get(id);
-            if (!item) {
-                console.warn(`${displayName} "${id}" not found`);
-                return;
-            }
-            this.current = id;
-            driver.set(storageKey, String(id));
-        }
-        /**
-         * Get item by id
-         */
-        get(id) {
-            return this.available.find((item) => item[idKey] === id);
-        }
-        /**
-         * Get property from current or specified item
-         */
-        getProp(prop, id) {
-            const targetId = id ?? this.current;
-            return this.get(targetId)?.[prop];
-        }
-        /**
-         * Append additional items (deduplicates by idKey)
-         */
-        addItems(newItems) {
-            for (const item of newItems) {
-                if (!this.get(item[idKey])) {
-                    this.available.push(item);
-                }
-            }
-        }
-    }
-    return new ConfigStore();
-}

package/dist/state/currency.svelte.d.ts

@@ -1,28 +0,0 @@
-/**
- * Currency configuration
- * Based on ISO 4217 currency codes
- */
-export interface Currency {
-    code: string;
-    symbol: string;
-    decimals: number;
-}
-import type { PersistenceDriver } from "rune-lab/core";
-export interface CurrencyStoreOptions {
-    driver?: PersistenceDriver | (() => PersistenceDriver | undefined);
-    /** Additional custom currencies to append to the built-in set */
-    customCurrencies?: Currency[];
-    /** Default currency code if no persisted value exists */
-    defaultCurrency?: string;
-}
-export declare function createCurrencyStore(driverOrOptions?: PersistenceDriver | (() => PersistenceDriver | undefined) | CurrencyStoreOptions): {
-    addCurrency: (meta: Currency, dineroDef?: any) => void;
-    current: string | number;
-    available: Currency[];
-};
-export type CurrencyStore = ReturnType<typeof createCurrencyStore>;
-export declare function getCurrencyStore(): {
-    addCurrency: (meta: Currency, dineroDef?: any) => void;
-    current: string | number;
-    available: Currency[];
-};