rune-lab 0.4.0 → 0.4.1

package/dist/state/auth/session.svelte.js

@@ -1,59 +0,0 @@
-// sdk/state/src/auth/session.svelte.ts
-// SessionStore — manages authentication state via Svelte 5 runes.
-// This is a SKELETON — full Better-Auth wiring is deferred to a dedicated spec.
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "../context.ts";
-/**
- * SessionStore — reactive authentication state.
- *
- * Once Better-Auth is fully integrated, this store will:
- * - Initialize from the Better-Auth client SDK
- * - Manage session lifecycle (login, logout, refresh)
- * - Expose the current user + session tokens
- * - Fire onSessionChange callbacks
- *
- * For now, it provides the interface contract that consuming apps
- * and other rune-lab components (UserAvatar, UserProfile) can code against.
- */
-export class SessionStore {
-    /** Whether authentication has been checked (vs. loading) */
-    isReady = $state(false);
-    /** Whether a user is currently authenticated */
-    isAuthenticated = $state(false);
-    /** Current user (null when logged out) */
-    user = $state(null);
-    /** Current session (null when logged out) */
-    session = $state(null);
-    /**
-     * Initialize the session — placeholder for Better-Auth client setup
-     */
-    init() {
-        // TODO: Wire Better-Auth client.getSession() here
-        this.isReady = true;
-        return Promise.resolve();
-    }
-    /**
-     * Log in — placeholder
-     */
-    login(_credentials) {
-        // TODO: Wire Better-Auth client.signIn.email() here
-        console.warn("SessionStore.login() is a stub — implement Better-Auth integration");
-        return Promise.resolve(false);
-    }
-    /**
-     * Log out — placeholder
-     */
-    logout() {
-        // TODO: Wire Better-Auth client.signOut() here
-        this.user = null;
-        this.session = null;
-        this.isAuthenticated = false;
-        return Promise.resolve();
-    }
-}
-export function createSessionStore() {
-    return new SessionStore();
-}
-export function getSessionStore() {
-    return getContext(RUNE_LAB_CONTEXT.session);
-}

package/dist/state/auth/types.d.ts

@@ -1,30 +0,0 @@
-/**
- * Minimal user representation for rune-lab's auth layer.
- * Consuming apps can extend this with domain-specific fields.
- */
-export interface User {
-    id: string;
-    name: string;
-    email: string;
-    avatar_url?: string;
-    role?: string;
-}
-/**
- * Active session information
- */
-export interface Session {
-    user: User;
-    accessToken: string;
-    expiresAt: Date;
-}
-/**
- * Auth configuration passed to RuneProvider
- */
-export interface AuthConfig {
-    /** Better-Auth client instance */
-    client?: unknown;
-    /** Callback when session changes (login, logout, expiry) */
-    onSessionChange?: (session: Session | null) => void;
-    /** Routes that require authentication */
-    protectedRoutes?: string[];
-}

package/dist/state/auth/types.js

@@ -1,3 +0,0 @@
-// sdk/state/src/auth/types.ts
-// Core auth types — framework-agnostic interfaces
-export {};

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

@@ -1,64 +0,0 @@
-import type { PersistenceDriver } from "@internal/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.ts";
-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.ts";
-import type { ApiStore } from "./api.svelte.ts";
-import type { ConfigStore } from "./createConfigStore.svelte.ts";
-import type { ToastStore } from "./toast.svelte.ts";
-import type { Theme } from "./theme.svelte.ts";
-import type { Language } from "./language.svelte.ts";
-import type { Currency } from "./currency.svelte.ts";
-/**
- * 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.ts";
-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,31 +0,0 @@
-import { type Dinero, type ISO4217Code } from "@internal/core";
-/**
- * Context-aware money composable.
- * Reads CurrencyStore and LanguageStore from rune-lab context.
- *
- * Usage:
- *   const { format, toDinero, add, subtract, convert } = 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", localeOverride?: string) => 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>;
-    convert: (amount: number, fromCode: string, unit?: "major" | "minor") => Dinero<number>;
-    formatConverted: (amount: number, fromCode: string, unit?: "major" | "minor") => string;
-    toPayload: (amount: number, currencyCode?: string, target?: "stripe" | "paypal" | "adyen" | "square", unit?: "major" | "minor") => {
-        amount: number;
-        currency: string;
-    } | {
-        value: string;
-        currency_code: string;
-    } | {
-        value: number;
-        currency: string;
-    } | {
-        amount: bigint;
-        currency: string;
-    };
-    multiply: (amount: number, factor: number, currencyCode?: ISO4217Code | string, unit?: "major" | "minor") => Dinero<number>;
-};

package/dist/state/composables/useMoney.js

@@ -1,126 +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.ts";
-import { addMoney, convertMoney, createMoney, formatMoney, multiplyMoney, subtractMoney, toAdyenMoney, toMinorUnit, toMoneySnapshot, toPaypalMoney, toSquareMoney, toStripeMoney, } from "@internal/core";
-/**
- * Context-aware money composable.
- * Reads CurrencyStore and LanguageStore from rune-lab context.
- *
- * Usage:
- *   const { format, toDinero, add, subtract, convert } = 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);
-    const exchangeRateStore = getContext(RUNE_LAB_CONTEXT.exchangeRate);
-    /**
-     * 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", localeOverride) {
-        if (amount === null || amount === undefined ||
-            (typeof amount === "number" && isNaN(amount))) {
-            return "—";
-        }
-        const code = currencyCode ?? String(currencyStore.current);
-        const locale = localeOverride ?? (String(languageStore.current) || "en");
-        const minorAmount = unit === "major"
-            ? toMinorUnit(Number(amount), code)
-            : amount;
-        const money = createMoney(minorAmount, code);
-        return formatMoney(money, locale, code);
-    }
-    /**
-     * Converts an amount from fromCode to the current display currency.
-     */
-    function convert(amount, fromCode, unit = "minor") {
-        const minorAmount = unit === "major"
-            ? toMinorUnit(amount, fromCode)
-            : amount;
-        const currentCode = String(currencyStore.current);
-        if (!exchangeRateStore?.hasRates || fromCode === currentCode) {
-            return createMoney(minorAmount, fromCode);
-        }
-        const sourceMoney = createMoney(minorAmount, fromCode);
-        return convertMoney(sourceMoney, currentCode, exchangeRateStore.rates);
-    }
-    /**
-     * Convenience: converts and formats an amount in one go.
-     */
-    function formatConverted(amount, fromCode, unit = "minor") {
-        const money = convert(amount, fromCode, unit);
-        const locale = String(languageStore.current) || "en";
-        const currentCode = String(currencyStore.current);
-        const snapshot = toMoneySnapshot(money);
-        // If conversion didn't happen (no rates), format as original currency
-        const displayCode = exchangeRateStore?.hasRates
-            ? currentCode
-            : snapshot.currency;
-        return formatMoney(money, locale, displayCode);
-    }
-    /**
-     * Multiply an amount by a factor.
-     */
-    function multiply(amount, factor, currencyCode, unit = "minor") {
-        const money = toDinero(amount, currencyCode, unit);
-        return multiplyMoney(money, factor);
-    }
-    /**
-     * Format an amount for a specific payment provider payload.
-     */
-    function toPayload(amount, currencyCode, target = "stripe", unit = "minor") {
-        const code = currencyCode ?? String(currencyStore.current);
-        const money = toDinero(amount, code, unit);
-        switch (target) {
-            case "stripe":
-                return toStripeMoney(money);
-            case "paypal":
-                return toPaypalMoney(money);
-            case "adyen":
-                return toAdyenMoney(money);
-            case "square":
-                return toSquareMoney(money);
-            default:
-                return toStripeMoney(money);
-        }
-    }
-    /**
-     * 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,
-        convert,
-        formatConverted,
-        toPayload,
-        multiply,
-    };
-}

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

@@ -1,20 +0,0 @@
-export interface MoneyFilterOptions {
-    min?: number;
-    max?: number;
-    unit?: "major" | "minor";
-    autoConvertOnChange?: boolean;
-}
-/**
- * A reactive currency-aware filter composable.
- * Handles min/max thresholds that auto-convert when the display currency changes.
- */
-export declare function useMoneyFilter(options?: MoneyFilterOptions): {
-    min: number;
-    max: number;
-    readonly displayMin: string;
-    readonly displayMax: string;
-    setMin: (value: number) => void;
-    setMax: (value: number) => void;
-    reset: () => void;
-    matches: (amount: number, entityCurrency: string) => boolean;
-};

package/dist/state/composables/useMoneyFilter.js

@@ -1,81 +0,0 @@
-// sdk/state/src/composables/useMoneyFilter.ts
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "../context.ts";
-import { useMoney } from "./useMoney.ts";
-/**
- * A reactive currency-aware filter composable.
- * Handles min/max thresholds that auto-convert when the display currency changes.
- */
-export function useMoneyFilter(options = {}) {
-    const currencyStore = getContext(RUNE_LAB_CONTEXT.currency);
-    const { format } = useMoney();
-    let min = $state(options.min ?? 0);
-    let max = $state(options.max ?? Infinity);
-    const unit = options.unit ?? "minor";
-    const autoConvertOnChange = options.autoConvertOnChange ?? true;
-    let lastCurrency = String(currencyStore.current);
-    $effect(() => {
-        const currentCurrency = String(currencyStore.current);
-        if (autoConvertOnChange && currentCurrency !== lastCurrency) {
-            if (currencyStore.canConvert) {
-                if (min !== 0) {
-                    min = currencyStore.convertAmount(min, lastCurrency, currentCurrency);
-                }
-                if (max !== Infinity) {
-                    max = currencyStore.convertAmount(max, lastCurrency, currentCurrency);
-                }
-            }
-            else {
-                // Reset if no rates available
-                min = 0;
-                max = Infinity;
-            }
-        }
-        lastCurrency = currentCurrency;
-    });
-    function setMin(value) {
-        min = value;
-    }
-    function setMax(value) {
-        max = value;
-    }
-    function reset() {
-        min = 0;
-        max = Infinity;
-    }
-    /**
-     * Checks if an amount (in its entity currency) matches the current filter.
-     */
-    function matches(amount, entityCurrency) {
-        const currentCurrency = String(currencyStore.current);
-        // Convert entity amount to display currency for comparison
-        const convertedAmount = currencyStore.convertAmount(amount, entityCurrency, currentCurrency);
-        return convertedAmount >= min && convertedAmount <= max;
-    }
-    const displayMin = $derived(format(min, undefined, unit));
-    const displayMax = $derived(max === Infinity ? "∞" : format(max, undefined, unit));
-    return {
-        get min() {
-            return min;
-        },
-        set min(v) {
-            min = v;
-        },
-        get max() {
-            return max;
-        },
-        set max(v) {
-            max = v;
-        },
-        get displayMin() {
-            return displayMin;
-        },
-        get displayMax() {
-            return displayMax;
-        },
-        setMin,
-        setMax,
-        reset,
-        matches,
-    };
-}

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

@@ -1,2 +0,0 @@
-import type { PersistenceDriver } from "@internal/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.ts";
-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.ts";
-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;