rune-lab 0.4.0 → 0.4.1

package/dist/core/money/money.js

@@ -1,250 +0,0 @@
-// sdk/core/src/money/money.ts
-// Framework-agnostic money utilities using Dinero.js v2
-// Consumers should never import Dinero directly — these helpers encapsulate it.
-import { add as dineroAdd, AED, BRL, CAD, CNY, convert as dineroConvert, dinero, EUR, GBP, INR, JPY, KRW, multiply as dineroMultiply, MXN, subtract as dineroSubtract, toDecimal, 
-// ISO 4217 currency definitions
-toSnapshot, transformScale as dineroTransformScale, USD, } from "dinero.js";
-/**
- * Map of ISO 4217 currency codes to Dinero currency objects
- */
-export const CURRENCY_MAP = {
-    USD,
-    EUR,
-    MXN,
-    JPY,
-    KRW,
-    CNY,
-    AED,
-    GBP,
-    CAD,
-    BRL,
-    INR,
-};
-/**
- * Converts a human-readable float rate (e.g., 17.23) into a ScaledRate.
- * Defaults to 4 decimal places of precision if not specified.
- */
-export function scaledRate(float, precision = 4) {
-    const factor = Math.pow(10, precision);
-    return {
-        amount: Math.round(float * factor),
-        scale: precision,
-    };
-}
-/**
- * Register a new currency in CURRENCY_MAP atomically.
- * Ensures the core registry and any store-level registries stay in sync.
- */
-export function registerCurrency(code, currency) {
-    CURRENCY_MAP[code] = currency;
-}
-/**
- * Normalizes an unknown input into a valid finite number.
- * Handles null, undefined, bigints, and SurrealDB Decimal objects via toString().
- */
-function toNumber(amount) {
-    if (amount === null || amount === undefined)
-        return 0;
-    if (typeof amount === "number")
-        return Number.isFinite(amount) ? amount : 0;
-    if (typeof amount === "bigint")
-        return Number(amount);
-    // Handle SurrealDB Decimal (which has a toString method) or other objects
-    if (typeof amount === "object") {
-        try {
-            // SurrealDB Decimal.toString() returns a numeric string
-            const str = String(amount);
-            const parsed = parseFloat(str);
-            return Number.isFinite(parsed) ? parsed : 0;
-        }
-        catch {
-            return 0;
-        }
-    }
-    const coerced = Number(amount);
-    return Number.isFinite(coerced) ? coerced : 0;
-}
-/**
- * Normalizes an unknown input into a valid integer for Dinero.js.
- * Exported so consumers can apply the same defensive coercion.
- */
-export function safeAmount(amount) {
-    return Math.round(toNumber(amount));
-}
-/**
- * Converts a major-unit amount (e.g., pesos) to a minor-unit integer (e.g., centavos).
- * Uses the currency's exponent from CURRENCY_MAP.
- */
-export function toMinorUnit(amount, currencyCode) {
-    const currency = CURRENCY_MAP[currencyCode];
-    if (!currency) {
-        throw new Error(`Unknown currency code: ${currencyCode}. Register it first via registerCurrency().`);
-    }
-    const base = Array.isArray(currency.base) ? currency.base[0] : currency.base;
-    const factor = Math.pow(Number(base), Number(currency.exponent));
-    return Math.round(toNumber(amount) * factor);
-}
-/**
- * Create a Dinero monetary value from an amount.
- * @param amount - Amount (normalized internally via safeAmount)
- * @param currencyCode - ISO 4217 currency code (e.g., "USD")
- */
-export function createMoney(amount, currencyCode) {
-    const currency = CURRENCY_MAP[currencyCode];
-    if (!currency) {
-        throw new Error(`Unknown currency code: ${currencyCode}. Register it first via registerCurrency().`);
-    }
-    return dinero({ amount: safeAmount(amount), currency });
-}
-/**
- * Format a Dinero value as a locale-aware string
- * @param money - Dinero monetary value
- * @param locale - BCP 47 locale string (e.g., "en-US", "es-MX")
- * @param currencyCode - ISO 4217 code for Intl.NumberFormat (e.g., "USD")
- */
-export function formatMoney(money, locale = "en-US", currencyCode) {
-    return toDecimal(money, ({ value, currency }) => {
-        const code = currencyCode ??
-            Object.entries(CURRENCY_MAP).find(([, c]) => c.code === currency.code)?.[0] ??
-            currency.code;
-        return new Intl.NumberFormat(locale, {
-            style: "currency",
-            currency: code,
-            minimumFractionDigits: currency.exponent,
-            maximumFractionDigits: currency.exponent,
-        }).format(Number(value));
-    });
-}
-/**
- * Format a raw amount as a locale-aware currency string.
- * Convenience wrapper around createMoney + formatMoney.
- */
-export function formatAmount(amount, currencyCode, locale = "en-US") {
-    const money = createMoney(amount, currencyCode);
-    return formatMoney(money, locale, currencyCode);
-}
-/**
- * Add two monetary values (must be same currency)
- */
-export function addMoney(a, b) {
-    return dineroAdd(a, b);
-}
-/**
- * Subtract two monetary values (must be same currency)
- */
-export function subtractMoney(a, b) {
-    return dineroSubtract(a, b);
-}
-/**
- * Multiply a monetary value by a factor
- */
-export function multiplyMoney(money, factor) {
-    return dineroMultiply(money, factor);
-}
-/**
- * Converts a Dinero object to another currency.
- * Both currencies must share the same base (base 10 for all standard ISO currencies).
- */
-export function convertMoney(money, toCurrencyCode, rates) {
-    const targetCurrency = CURRENCY_MAP[toCurrencyCode];
-    if (!targetCurrency) {
-        throw new Error(`Unknown target currency: ${toCurrencyCode}. Register it first via registerCurrency().`);
-    }
-    const rate = rates[toCurrencyCode];
-    if (rate === undefined) {
-        throw new Error(`Missing exchange rate for currency: ${toCurrencyCode}`);
-    }
-    try {
-        return dineroConvert(money, targetCurrency, { [toCurrencyCode]: rate });
-    }
-    catch (err) {
-        if (err instanceof Error && err.message.includes("base")) {
-            throw new Error(`Cannot convert between currencies with different bases. Ensure both are base 10.`);
-        }
-        throw err;
-    }
-}
-/**
- * Converts a raw minor-unit amount between currencies.
- * Returns the original amount if from and to currencies are the same.
- */
-export function convertAmount(amount, fromCode, toCode, rates) {
-    if (fromCode === toCode)
-        return amount;
-    const targetCurrency = CURRENCY_MAP[toCode];
-    if (!targetCurrency) {
-        throw new Error(`Unknown target currency: ${toCode}`);
-    }
-    const sourceMoney = createMoney(amount, fromCode);
-    const convertedMoney = convertMoney(sourceMoney, toCode, rates);
-    // Normalize back to the target currency's standard exponent
-    const targetMoney = dineroTransformScale(convertedMoney, targetCurrency.exponent);
-    const snapshot = toSnapshot(targetMoney);
-    return snapshot.amount;
-}
-/**
- * Converts Dinero object to a Stripe-compatible payload.
- */
-export function toStripeMoney(money) {
-    const snapshot = toSnapshot(money);
-    return {
-        amount: snapshot.amount,
-        currency: snapshot.currency.code.toLowerCase(),
-    };
-}
-/**
- * Converts Dinero object to a PayPal-compatible payload.
- */
-export function toPaypalMoney(money) {
-    const value = toDecimal(money);
-    const snapshot = toSnapshot(money);
-    return {
-        value,
-        currency_code: snapshot.currency.code,
-    };
-}
-/**
- * Converts Dinero object to an Adyen-compatible payload.
- */
-export function toAdyenMoney(money) {
-    const snapshot = toSnapshot(money);
-    return {
-        value: snapshot.amount,
-        currency: snapshot.currency.code.toUpperCase(),
-    };
-}
-/**
- * Converts Dinero object to a Square-compatible payload (uses BigInt).
- */
-export function toSquareMoney(money) {
-    const snapshot = toSnapshot(money);
-    return {
-        amount: BigInt(snapshot.amount),
-        currency: snapshot.currency.code,
-    };
-}
-/**
- * Serializes a Dinero object into a plain object snapshot.
- */
-export function toMoneySnapshot(money) {
-    const snapshot = toSnapshot(money);
-    return {
-        amount: snapshot.amount,
-        currency: snapshot.currency.code,
-        scale: snapshot.scale,
-    };
-}
-/**
- * Restores a Dinero object from a snapshot.
- */
-export function fromMoneySnapshot(snapshot) {
-    const currency = CURRENCY_MAP[snapshot.currency];
-    if (!currency) {
-        throw new Error(`Unknown currency: ${snapshot.currency}. Register it first.`);
-    }
-    return dinero({
-        amount: snapshot.amount,
-        currency,
-        scale: snapshot.scale ?? currency.exponent,
-    });
-}

package/dist/core/persistence/types.d.ts

@@ -1,18 +0,0 @@
-/**
- * Synchronous persistence driver interface for Svelte stores
- */
-export interface PersistenceDriver {
-    /**
-     * Get a value by key. Should return null if not found.
-     */
-    get(key: string): string | null;
-    /**
-     * Set a value by key.
-     */
-    set(key: string, value: string): void;
-    /**
-     * Remove a value by key.
-     */
-    remove(key: string): void;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/persistence/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/persistence/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/core/persistence/types.js

@@ -1,2 +0,0 @@
-// src/lib/persistence/types.ts
-export {};

package/dist/core/shortcuts/types.d.ts

@@ -1,60 +0,0 @@
-/**
- * Declarative shortcut configuration.
- * Used by the `useShortcuts` composable to register shortcuts with automatic cleanup.
- *
- * @example
- * ```ts
- * const shortcuts: ShortcutConfig[] = [
- *   {
- *     id: "save:document",
- *     keys: "ctrl+s",
- *     handler: () => save(),
- *     label: "Save document",
- *     category: "Editing",
- *   },
- *   {
- *     id: "palette:open",
- *     keys: "ctrl+k",
- *     handler: () => openPalette(),
- *     when: () => !isModalOpen,
- *   },
- * ];
- * ```
- */
-export interface ShortcutConfig {
-    /**
-     * Unique dot-namespaced identifier.
-     * Must be namespaced by feature to prevent collisions in the global registry.
-     * @example "save:document", "palette:open"
-     */
-    id: string;
-    /**
-     * Hotkeys.js-compatible key combination string.
-     * @example "ctrl+s", "alt+shift+p", "escape"
-     */
-    keys: string;
-    /**
-     * Handler function invoked when the shortcut is triggered.
-     */
-    handler: (event: KeyboardEvent) => void;
-    /**
-     * Optional predicate — when provided, the shortcut only fires if this returns `true`.
-     * Useful for context-dependent shortcuts (e.g., only when a modal is closed).
-     */
-    when?: () => boolean;
-    /**
-     * Human-readable label for display in the shortcut palette.
-     * If omitted, the shortcut is registered but hidden from the palette.
-     */
-    label?: string;
-    /**
-     * Display category (e.g., "Navigation", "Editing") for grouping in the palette.
-     */
-    category?: string;
-    /**
-     * Scope in which the shortcut is active.
-     * @default "global"
-     */
-    scope?: "global" | "layout" | `panel:${string}`;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/shortcuts/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/shortcuts/types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAExC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,MAAM,EAAE,CAAC;CACjD"}

package/dist/core/shortcuts/types.js

@@ -1,4 +0,0 @@
-// sdk/core/src/shortcuts/types.ts
-// Framework-agnostic shortcut configuration types.
-// The composable layer (sdk/state) wraps these in Svelte 5 lifecycle management.
-export {};

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-// Auto-generated root barrel file
-export * from "./core/index.js";
-export * from "./state/index.js";
-export * from "./ui/index.js";
-
-export declare const version: () => string;

package/dist/index.js

@@ -1,7 +0,0 @@
-// Auto-generated root barrel file
-export * from "./core/index.js";
-export * from "./state/index.js";
-export * from "./ui/index.js";
-
-import pkg from "../package.json" with { type: "json" };
-export const version = () => pkg.version;

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

@@ -1,26 +0,0 @@
-/**
- * API connection state and configuration
- */
-export type ConnectionState = "connected" | "connecting" | "disconnected";
-export declare class ApiStore {
-    #private;
-    url: string;
-    version: string;
-    connectionState: ConnectionState;
-    isConnected: boolean;
-    isLoading: boolean;
-    get URL(): string;
-    get VERSION(): string;
-    get IS_CONNECTED(): boolean;
-    get IS_LOADING(): boolean;
-    /**
-     * Reconnect to the API
-     */
-    reconnect(): Promise<void>;
-    /**
-     * Initialize API settings
-     */
-    init(url: string, version?: string, healthCheck?: () => Promise<boolean>): void;
-}
-export declare function createApiStore(): ApiStore;
-export declare function getApiStore(): ApiStore;

package/dist/state/api.svelte.js

@@ -1,65 +0,0 @@
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context.ts";
-import { DEV } from "esm-env";
-export class ApiStore {
-    // State
-    url = $state("http://localhost:8000");
-    version = $state("v1");
-    connectionState = $state("disconnected");
-    #healthCheck;
-    // Derived
-    isConnected = $derived(this.connectionState === "connected");
-    isLoading = $derived(this.connectionState === "connecting");
-    // Short aliases for compatibility with the user's snippet
-    get URL() {
-        return this.url;
-    }
-    get VERSION() {
-        return this.version;
-    }
-    get IS_CONNECTED() {
-        return this.isConnected;
-    }
-    get IS_LOADING() {
-        return this.isLoading;
-    }
-    /**
-     * Reconnect to the API
-     */
-    async reconnect() {
-        this.connectionState = "connecting";
-        try {
-            if (this.#healthCheck) {
-                const isHealthy = await this.#healthCheck();
-                this.connectionState = isHealthy ? "connected" : "disconnected";
-            }
-            else {
-                // Simulate connection if no health check provided
-                if (DEV) {
-                    console.warn("[rune-lab] ApiStore: No healthCheck provided to init(). Using simulated connection delay.");
-                }
-                await new Promise((resolve) => setTimeout(resolve, 1500));
-                this.connectionState = "connected";
-            }
-        }
-        catch (_e) {
-            this.connectionState = "disconnected";
-        }
-    }
-    /**
-     * Initialize API settings
-     */
-    init(url, version = "v1", healthCheck) {
-        this.url = url;
-        this.version = version;
-        if (healthCheck)
-            this.#healthCheck = healthCheck;
-        this.reconnect();
-    }
-}
-export function createApiStore() {
-    return new ApiStore();
-}
-export function getApiStore() {
-    return getContext(RUNE_LAB_CONTEXT.api);
-}

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

@@ -1,48 +0,0 @@
-/**
- * Application metadata interface
- */
-export interface AppData {
-    name: string;
-    version: string;
-    description: string;
-    author: string;
-    repository?: string;
-    license?: string;
-    homepage?: string;
-}
-/**
- * App Store
- * Manages application metadata and identity
- */
-export declare class AppStore {
-    #private;
-    name: string;
-    version: string;
-    description: string;
-    author: string;
-    repository: string;
-    license: string;
-    homepage: string;
-    customIcons: Record<string, string>;
-    /**
-     * Initialize app store with metadata.
-     *
-     * @contract init() is idempotent. Call it once at app startup via RuneProvider.
-     * Subsequent calls are silently ignored to maintain stability across SSR/CSR cycles.
-     */
-    init(data: Partial<AppData>): void;
-    /**
-     * @internal Test-only. Resets initialization guard.
-     */
-    __reset(): void;
-    /**
-     * Get full app information object
-     */
-    get info(): AppData;
-    /**
-     * Registers custom SVG icons to be available globally in the Icon component
-     */
-    registerIcons(icons: Record<string, string>): void;
-}
-export declare function createAppStore(): AppStore;
-export declare function getAppStore(): AppStore;

package/dist/state/app.svelte.js

@@ -1,82 +0,0 @@
-// src/lib/stores/app-config.svelte.ts
-import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context.ts";
-import { DEV } from "esm-env";
-/**
- * App Store
- * Manages application metadata and identity
- */
-export class AppStore {
-    // State
-    name = $state("Rune Lab");
-    version = $state("0.0.1");
-    description = $state("Modern toolkit for Svelte 5 Runes");
-    author = $state("Yrrrrrf");
-    repository = $state("https://github.com/Yrrrrrf/rune-lab");
-    license = $state("MIT");
-    homepage = $state("https://jsr.io/@yrrrrrf/rune-lab");
-    customIcons = $state({});
-    #initialized = false;
-    /**
-     * Initialize app store with metadata.
-     *
-     * @contract init() is idempotent. Call it once at app startup via RuneProvider.
-     * Subsequent calls are silently ignored to maintain stability across SSR/CSR cycles.
-     */
-    init(data) {
-        if (this.#initialized) {
-            if (DEV) {
-                console.warn("AppStore.init() called multiple times. Ignoring subsequent calls.", "Overwritten properties would have been:", data);
-            }
-            return;
-        }
-        if (data.name)
-            this.name = data.name;
-        if (data.version)
-            this.version = data.version;
-        if (data.description)
-            this.description = data.description;
-        if (data.author)
-            this.author = data.author;
-        if (data.repository)
-            this.repository = data.repository;
-        if (data.license)
-            this.license = data.license;
-        if (data.homepage)
-            this.homepage = data.homepage;
-        this.#initialized = true;
-    }
-    /**
-     * @internal Test-only. Resets initialization guard.
-     */
-    __reset() {
-        this.#initialized = false;
-    }
-    /**
-     * Get full app information object
-     */
-    get info() {
-        return {
-            name: this.name,
-            version: this.version,
-            description: this.description,
-            author: this.author,
-            repository: this.repository,
-            license: this.license,
-            homepage: this.homepage,
-        };
-    }
-    /**
-     * Registers custom SVG icons to be available globally in the Icon component
-     */
-    registerIcons(icons) {
-        this.customIcons = { ...this.customIcons, ...icons };
-    }
-}
-// Export singleton instance
-export function createAppStore() {
-    return new AppStore();
-}
-export function getAppStore() {
-    return getContext(RUNE_LAB_CONTEXT.app);
-}

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

@@ -1,2 +0,0 @@
-export type { AuthConfig, Session, User } from "./types.ts";
-export { createSessionStore, getSessionStore, SessionStore, } from "./session.svelte.ts";

package/dist/state/auth/index.js

@@ -1,2 +0,0 @@
-// sdk/state/src/auth/index.ts
-export { createSessionStore, getSessionStore, SessionStore, } from "./session.svelte.ts";

package/dist/state/auth/session.svelte.d.ts

@@ -1,40 +0,0 @@
-import type { Session, User } from "./types.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 declare class SessionStore {
-    /** Whether authentication has been checked (vs. loading) */
-    isReady: boolean;
-    /** Whether a user is currently authenticated */
-    isAuthenticated: boolean;
-    /** Current user (null when logged out) */
-    user: User | null;
-    /** Current session (null when logged out) */
-    session: Session | null;
-    /**
-     * Initialize the session — placeholder for Better-Auth client setup
-     */
-    init(): Promise<void>;
-    /**
-     * Log in — placeholder
-     */
-    login(_credentials: {
-        email: string;
-        password: string;
-    }): Promise<boolean>;
-    /**
-     * Log out — placeholder
-     */
-    logout(): Promise<void>;
-}
-export declare function createSessionStore(): SessionStore;
-export declare function getSessionStore(): SessionStore;