rune-lab 0.3.0 → 0.4.0

package/dist/core/money/money.d.ts

@@ -1,4 +1,4 @@
-import { type Dinero, type DineroCurrency } from "dinero.js";
+import { type Dinero, type DineroCurrency, type DineroSnapshot } from "dinero.js";
 /**
  * Map of ISO 4217 currency codes to Dinero currency objects
  */
@@ -8,6 +8,24 @@ export declare const CURRENCY_MAP: Record<string, DineroCurrency<number>>;
  * Enables IDE autocomplete while allowing any string for dynamic currencies.
  */
 export type ISO4217Code = keyof typeof CURRENCY_MAP;
+/**
+ * Scaled integer rate for Dinero.js conversion.
+ * Avoids floating-point errors by using integer amounts with a scale.
+ */
+export type ScaledRate = {
+    amount: number;
+    scale: number;
+};
+/**
+ * Map of currency codes to their exchange rates relative to a base currency.
+ * Rates can be plain numbers (integers) or ScaledRate objects.
+ */
+export type RateMap = Record<string, ScaledRate | number>;
+/**
+ * Converts a human-readable float rate (e.g., 17.23) into a ScaledRate.
+ * Defaults to 4 decimal places of precision if not specified.
+ */
+export declare function scaledRate(float: number, precision?: number): ScaledRate;
 /**
  * Register a new currency in CURRENCY_MAP atomically.
  * Ensures the core registry and any store-level registries stay in sync.
@@ -53,5 +71,59 @@ export declare function subtractMoney(a: Dinero<number>, b: Dinero<number>): Din
  * Multiply a monetary value by a factor
  */
 export declare function multiplyMoney(money: Dinero<number>, factor: number): Dinero<number>;
-export type { Dinero, DineroCurrency };
+/**
+ * Converts a Dinero object to another currency.
+ * Both currencies must share the same base (base 10 for all standard ISO currencies).
+ */
+export declare function convertMoney(money: Dinero<number>, toCurrencyCode: string, rates: RateMap): Dinero<number>;
+/**
+ * Converts a raw minor-unit amount between currencies.
+ * Returns the original amount if from and to currencies are the same.
+ */
+export declare function convertAmount(amount: number, fromCode: string, toCode: string, rates: RateMap): number;
+/**
+ * Converts Dinero object to a Stripe-compatible payload.
+ */
+export declare function toStripeMoney(money: Dinero<number>): {
+    amount: number;
+    currency: string;
+};
+/**
+ * Converts Dinero object to a PayPal-compatible payload.
+ */
+export declare function toPaypalMoney(money: Dinero<number>): {
+    value: string;
+    currency_code: string;
+};
+/**
+ * Converts Dinero object to an Adyen-compatible payload.
+ */
+export declare function toAdyenMoney(money: Dinero<number>): {
+    value: number;
+    currency: string;
+};
+/**
+ * Converts Dinero object to a Square-compatible payload (uses BigInt).
+ */
+export declare function toSquareMoney(money: Dinero<number>): {
+    amount: bigint;
+    currency: string;
+};
+/**
+ * Serializes a Dinero object into a plain object snapshot.
+ */
+export declare function toMoneySnapshot(money: Dinero<number>): {
+    amount: number;
+    currency: string;
+    scale: number;
+};
+/**
+ * Restores a Dinero object from a snapshot.
+ */
+export declare function fromMoneySnapshot(snapshot: {
+    amount: number;
+    currency: string;
+    scale?: number;
+}): Dinero<number>;
+export type { Dinero, DineroCurrency, DineroSnapshot };
 //# sourceMappingURL=money.d.ts.map

package/dist/core/money/money.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/money.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,MAAM,EAEX,KAAK,cAAc,EAYpB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAY/D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAC/B,IAAI,CAEN;AA2BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,MAAM,CAAC,MAAM,CAAC,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,GAAE,MAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,EAClC,MAAM,GAAE,MAAgB,GACvB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,CAEhB;AAGD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/money.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,MAAM,EAEX,KAAK,cAAc,EACnB,KAAK,cAAc,EAcpB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAY/D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,UAAU,CAM3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAC/B,IAAI,CAEN;AA2BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,MAAM,CAAC,MAAM,CAAC,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,GAAE,MAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,WAAW,GAAG,MAAM,EAClC,MAAM,GAAE,MAAgB,GACvB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,CAAC,CAuBhB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,CAOA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAOA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAAC,MAAM,CAAC,CAYjB;AAGD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/money/money.js

@@ -1,9 +1,9 @@
 // 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, dinero, EUR, GBP, INR, JPY, KRW, multiply as dineroMultiply, MXN, subtract as dineroSubtract, toDecimal, 
+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
-USD, } from "dinero.js";
+toSnapshot, transformScale as dineroTransformScale, USD, } from "dinero.js";
 /**
  * Map of ISO 4217 currency codes to Dinero currency objects
  */
@@ -20,6 +20,17 @@ export const CURRENCY_MAP = {
     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.
@@ -130,3 +141,110 @@ export function subtractMoney(a, b) {
 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/shortcuts/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+// 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,5 +1,6 @@
-export * from "rune-lab/core";
-export * from "rune-lab/state";
-export * from "rune-lab/ui";
+// 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,5 +1,7 @@
-export * from "rune-lab/core";
-export * from "rune-lab/state";
-export * from "rune-lab/ui";
+// Auto-generated root barrel file
+export * from "./core/index.js";
+export * from "./state/index.js";
+export * from "./ui/index.js";
 
-export const version = () => "0.3.0";
+import pkg from "../package.json" with { type: "json" };
+export const version = () => pkg.version;

package/dist/state/api.svelte.js

@@ -1,5 +1,5 @@
 import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context";
+import { RUNE_LAB_CONTEXT } from "./context.ts";
 import { DEV } from "esm-env";
 export class ApiStore {
     // State
@@ -42,7 +42,7 @@ export class ApiStore {
                 this.connectionState = "connected";
             }
         }
-        catch (e) {
+        catch (_e) {
             this.connectionState = "disconnected";
         }
     }

package/dist/state/app.svelte.js

@@ -1,6 +1,6 @@
 // src/lib/stores/app-config.svelte.ts
 import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context";
+import { RUNE_LAB_CONTEXT } from "./context.ts";
 import { DEV } from "esm-env";
 /**
  * App Store

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

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

package/dist/state/auth/index.js

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

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

@@ -1,4 +1,4 @@
-import type { Session, User } from "./types";
+import type { Session, User } from "./types.ts";
 /**
  * SessionStore — reactive authentication state.
  *

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

@@ -2,7 +2,7 @@
 // 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";
+import { RUNE_LAB_CONTEXT } from "../context.ts";
 /**
  * SessionStore — reactive authentication state.
  *
@@ -27,26 +27,28 @@ export class SessionStore {
     /**
      * Initialize the session — placeholder for Better-Auth client setup
      */
-    async init() {
+    init() {
         // TODO: Wire Better-Auth client.getSession() here
         this.isReady = true;
+        return Promise.resolve();
     }
     /**
      * Log in — placeholder
      */
-    async login(_credentials) {
+    login(_credentials) {
         // TODO: Wire Better-Auth client.signIn.email() here
         console.warn("SessionStore.login() is a stub — implement Better-Auth integration");
-        return false;
+        return Promise.resolve(false);
     }
     /**
      * Log out — placeholder
      */
-    async logout() {
+    logout() {
         // TODO: Wire Better-Auth client.signOut() here
         this.user = null;
         this.session = null;
         this.isAuthenticated = false;
+        return Promise.resolve();
     }
 }
 export function createSessionStore() {

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

@@ -22,7 +22,7 @@ export interface Session {
  */
 export interface AuthConfig {
     /** Better-Auth client instance */
-    client?: any;
+    client?: unknown;
     /** Callback when session changes (login, logout, expiry) */
     onSessionChange?: (session: Session | null) => void;
     /** Routes that require authentication */

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

@@ -1,4 +1,4 @@
-import type { PersistenceDriver } from "rune-lab/core";
+import type { PersistenceDriver } from "@internal/core";
 /**
  * Configuration for creating a CartStore
  */

package/dist/state/cart.svelte.js

@@ -1,7 +1,7 @@
 // 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 { RUNE_LAB_CONTEXT } from "./context.ts";
 import { DEV } from "esm-env";
 /**
  * Generic cart store factory.

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

@@ -1,10 +1,10 @@
-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";
+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
  */

package/dist/state/commands.svelte.js

@@ -1,5 +1,5 @@
 import { getContext } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context";
+import { RUNE_LAB_CONTEXT } from "./context.ts";
 export class CommandStore {
     // Dependency Injection
     #services;

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

@@ -1,15 +1,31 @@
-import { type Dinero, type ISO4217Code } from "rune-lab/core";
+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 } = useMoney();
+ *   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") => string;
+    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,19 +1,20 @@
 // 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";
+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 } = useMoney();
+ *   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
      */
@@ -27,19 +28,73 @@ export function useMoney() {
     /**
      * Format an amount as a locale-aware currency string
      */
-    function format(amount, currencyCode, unit = "minor") {
+    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 = String(languageStore.current) || "en";
+        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
      */
@@ -58,5 +113,14 @@ export function useMoney() {
         const bMoney = toDinero(b, code, unit);
         return subtractMoney(aMoney, bMoney);
     }
-    return { toDinero, format, add, subtract };
+    return {
+        toDinero,
+        format,
+        add,
+        subtract,
+        convert,
+        formatConverted,
+        toPayload,
+        multiply,
+    };
 }

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

@@ -0,0 +1,20 @@
+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;
+};