rune-lab 0.4.8-alpha.2 → 0.4.8

package/dist/RuneProvider.svelte

@@ -3,6 +3,7 @@
   import {
     RUNE_LAB_CONTEXT,
     localStorageDriver,
+    namespaced,
     initializeStores,
     defineRune,
     createAppStore,
@@ -43,7 +44,7 @@
   }>();
 
   const initialPlugins = untrack(() => plugins);
-  const initialPersistence = untrack(() => config.persistence ?? localStorageDriver);
+  const initialPersistence = untrack(() => namespaced(config.persistence ?? localStorageDriver, "rl:"));
 
   // 0. Create and provide the built-in AppStore
   const appStore = createAppStore();

package/dist/i18n/paraglide/README.md

@@ -4,7 +4,7 @@
 > strings.
 
 Compiled from:
-`/home/yrrrrrf/docs/lab/code/typescript/rune-lab/src/package/src/lib/i18n/project.inlang`
+`/home/yrrrrrf/Documents/lab/code/typescript/rune-lab/src/package/src/lib/i18n/project.inlang`
 
 ## What is this folder?
 

package/dist/kernel/src/context/accessors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/kernel/src/context/accessors.test.js

@@ -0,0 +1,68 @@
+import { describe, expect, it, vi } from "vite-plus/test";
+// Mock Svelte's getContext so we can test the behavior when a context is not present
+// without triggering Svelte's lifecycle_outside_component error.
+vi.mock("svelte", () => ({
+  getContext: () => undefined,
+}));
+import {
+  getCommandStore,
+  getCurrencyStore,
+  getLanguageStore,
+  getLayoutStore,
+  getShortcutStore,
+  getThemeStore,
+  getToastStore,
+} from "./stores.svelte.js";
+import { getAppStore } from "./app.svelte.js";
+import { getExchangeRateStore } from "../../../runes/plugins/money/src/exchange-rate.svelte.js";
+import { useMoney } from "../../../runes/plugins/money/src/useMoney.js";
+describe("Fail-fast context accessors", () => {
+  it("should throw a helpful error for getAppStore", () => {
+    expect(() => getAppStore()).toThrow(/getAppStore\(\) found no AppStore/i);
+  });
+  it("should throw a helpful error for getLayoutStore", () => {
+    expect(() => getLayoutStore()).toThrow(
+      /getLayoutStore\(\) found no LayoutStore.*LayoutPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getLanguageStore", () => {
+    expect(() => getLanguageStore()).toThrow(
+      /getLanguageStore\(\) found no LanguageStore.*LayoutPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getThemeStore", () => {
+    expect(() => getThemeStore()).toThrow(
+      /getThemeStore\(\) found no ThemeStore.*LayoutPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getShortcutStore", () => {
+    expect(() => getShortcutStore()).toThrow(
+      /getShortcutStore\(\) found no ShortcutStore.*PalettesPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getCommandStore", () => {
+    expect(() => getCommandStore()).toThrow(
+      /getCommandStore\(\) found no CommandStore.*PalettesPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getToastStore", () => {
+    expect(() => getToastStore()).toThrow(
+      /getToastStore\(\) found no ToastStore.*PalettesPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getCurrencyStore", () => {
+    expect(() => getCurrencyStore()).toThrow(
+      /getCurrencyStore\(\) found no CurrencyStore.*MoneyPlugin/i,
+    );
+  });
+  it("should throw a helpful error for getExchangeRateStore", () => {
+    expect(() => getExchangeRateStore()).toThrow(
+      /getExchangeRateStore\(\) found no ExchangeRateStore.*MoneyPlugin/i,
+    );
+  });
+  it("should throw a helpful error for useMoney", () => {
+    expect(() => useMoney()).toThrow(
+      /useMoney\(\) found no CurrencyStore.*MoneyPlugin/i,
+    );
+  });
+});

package/dist/kernel/src/context/app.svelte.js

@@ -85,5 +85,11 @@ export function createAppStore() {
   return new AppStore();
 }
 export function getAppStore() {
-  return getContext(RUNE_LAB_CONTEXT.app);
+  const store = getContext(RUNE_LAB_CONTEXT.app);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getAppStore() found no AppStore. Did you wrap your application in <RuneProvider>?",
+    );
+  }
+  return store;
 }

package/dist/kernel/src/context/stores.svelte.d.ts

@@ -26,8 +26,10 @@ export interface IToastStore {
   warn(msg: string): void;
   info(msg: string): void;
   dismiss(id: string): void;
+  pause(id: string): void;
+  resume(id: string): void;
 }
-export interface ICurrencyStore extends ConfigStore<Currency> {
+export interface ICurrencyStore extends ConfigStore<Currency, "code"> {
   canConvert: boolean;
   convertAmount(amount: number, fromCode: string, toCode?: string): number;
   addCurrency(meta: Currency, dineroDef?: unknown): void;
@@ -36,8 +38,8 @@ export interface ICurrencyStore extends ConfigStore<Currency> {
  * Store context accessors
  */
 export declare function getLayoutStore(): LayoutStore;
-export declare function getLanguageStore(): ConfigStore<Language>;
-export declare function getThemeStore(): ConfigStore<Theme>;
+export declare function getLanguageStore(): ConfigStore<Language, "code">;
+export declare function getThemeStore(): ConfigStore<Theme, "name">;
 export declare function getShortcutStore(): ShortcutStore;
 export declare function getCommandStore(): ICommandStore;
 export declare function getToastStore(): IToastStore;

package/dist/kernel/src/context/stores.svelte.js

@@ -4,25 +4,67 @@ import { RUNE_LAB_CONTEXT } from "./context.js";
  * Store context accessors
  */
 export function getLayoutStore() {
-  return getContext(RUNE_LAB_CONTEXT.layout);
+  const store = getContext(RUNE_LAB_CONTEXT.layout);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getLayoutStore() found no LayoutStore. Did you register LayoutPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getLanguageStore() {
-  return getContext(RUNE_LAB_CONTEXT.language);
+  const store = getContext(RUNE_LAB_CONTEXT.language);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getLanguageStore() found no LanguageStore. Did you register LayoutPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getThemeStore() {
-  return getContext(RUNE_LAB_CONTEXT.theme);
+  const store = getContext(RUNE_LAB_CONTEXT.theme);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getThemeStore() found no ThemeStore. Did you register LayoutPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getShortcutStore() {
-  return getContext(RUNE_LAB_CONTEXT.shortcut);
+  const store = getContext(RUNE_LAB_CONTEXT.shortcut);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getShortcutStore() found no ShortcutStore. Did you register PalettesPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getCommandStore() {
-  return getContext(RUNE_LAB_CONTEXT.commands);
+  const store = getContext(RUNE_LAB_CONTEXT.commands);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getCommandStore() found no CommandStore. Did you register PalettesPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getToastStore() {
-  return getContext(RUNE_LAB_CONTEXT.toast);
+  const store = getContext(RUNE_LAB_CONTEXT.toast);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getToastStore() found no ToastStore. Did you register PalettesPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 export function getCurrencyStore() {
-  return getContext(RUNE_LAB_CONTEXT.currency);
+  const store = getContext(RUNE_LAB_CONTEXT.currency);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getCurrencyStore() found no CurrencyStore. Did you register MoneyPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }
 /**
  * Standard layout shortcuts

package/dist/kernel/src/persistence/createConfigStore.svelte.d.ts

@@ -1,16 +1,16 @@
 import type { PersistenceDriver } from "./types.js";
-export type ConfigStore<T = unknown> = {
-  current: unknown;
+export type ConfigStore<T, K extends keyof T = keyof T> = {
+  current: T[K];
   available: T[];
-  set: (id: unknown) => void;
-  get: (id: unknown) => T | undefined;
-  getProp: <K extends keyof T>(prop: K, id?: unknown) => T[K] | undefined;
-  addItems: (newItems: T[]) => void;
+  set(id: T[K]): void;
+  get(id: T[K]): T | undefined;
+  getProp<P extends keyof T>(prop: P, id?: T[K]): T[P] | undefined;
+  addItems(newItems: T[]): void;
   /**
    * Register a callback to fire when the current item changes.
    * Returns an unsubscribe function.
    */
-  onChange: (cb: (newId: unknown, oldId: unknown) => void) => () => void;
+  onChange: (cb: (newId: T[K], oldId: T[K]) => void) => () => void;
   /**
    * Inject (or replace) the persistence driver at runtime.
    * Call this inside your plugin factory so the real driver
@@ -20,7 +20,7 @@ export type ConfigStore<T = unknown> = {
    */
   setDriver: (driver: PersistenceDriver) => void;
 };
-export interface ConfigStoreOptions<T = unknown> {
+export interface ConfigStoreOptions<T, K extends keyof T = keyof T> {
   /** Array of available items */
   items: readonly T[];
   /** Storage key used by the persistence driver */
@@ -28,7 +28,7 @@ export interface ConfigStoreOptions<T = unknown> {
   /** Display name for logging (e.g., "Theme", "Language") */
   displayName: string;
   /** Key to use as identifier (e.g., "code", "name") */
-  idKey: keyof T;
+  idKey: K;
   /** Icon for logs */
   icon?: string;
   /** Persistence driver */
@@ -37,6 +37,6 @@ export interface ConfigStoreOptions<T = unknown> {
 /**
  * Creates a reactive configuration store with persistence
  */
-export declare function createConfigStore<T = unknown>(
-  options: ConfigStoreOptions<T>,
-): ConfigStore<T>;
+export declare function createConfigStore<T, K extends keyof T>(
+  options: ConfigStoreOptions<T, K>,
+): ConfigStore<T, K>;

package/dist/kernel/src/persistence/createConfigStore.svelte.js

@@ -16,7 +16,7 @@ class ConfigStoreImpl {
       options;
     this.#driver = driver;
     this.available = [...items];
-    this.current = items[0]?.[idKey] ?? "";
+    this.current = items[0][idKey];
     const saved = this.#driver.get(storageKey);
     // Only load saved if it actually exists in our available items
     if (saved && this.get(saved)) {

package/dist/kernel/src/persistence/drivers.d.ts

@@ -7,6 +7,19 @@ export declare const createCookieDriver: (options?: {
   path?: string;
   maxAge?: number;
   sameSite?: "Lax" | "Strict" | "None";
+  secure?: boolean;
 }) => PersistenceDriver;
 /** Default cookie driver singleton (path='/') */
 export declare const cookieDriver: PersistenceDriver;
+/**
+ * Wraps a persistence driver so all keys are prefixed with the given string.
+ * Use this to namespace storage keys and avoid cross-app collisions.
+ *
+ * @param driver - The underlying persistence driver to wrap
+ * @param prefix - The prefix to prepend to all keys (e.g., "rl:")
+ * @returns A new PersistenceDriver that transparently namespaces keys
+ */
+export declare function namespaced(
+  driver: PersistenceDriver,
+  prefix: string,
+): PersistenceDriver;

package/dist/kernel/src/persistence/drivers.js

@@ -72,6 +72,9 @@ export const createCookieDriver = (options = {}) => ({
     if (options.sameSite) {
       cookie += `; samesite=${options.sameSite}`;
     }
+    if (options.secure) {
+      cookie += "; Secure";
+    }
     document.cookie = cookie;
   },
   remove: (key) => {
@@ -85,3 +88,18 @@ export const createCookieDriver = (options = {}) => ({
 export const cookieDriver = createCookieDriver({
   path: "/",
 });
+/**
+ * Wraps a persistence driver so all keys are prefixed with the given string.
+ * Use this to namespace storage keys and avoid cross-app collisions.
+ *
+ * @param driver - The underlying persistence driver to wrap
+ * @param prefix - The prefix to prepend to all keys (e.g., "rl:")
+ * @returns A new PersistenceDriver that transparently namespaces keys
+ */
+export function namespaced(driver, prefix) {
+  return {
+    get: (key) => driver.get(`${prefix}${key}`),
+    set: (key, value) => driver.set(`${prefix}${key}`, value),
+    remove: (key) => driver.remove(`${prefix}${key}`),
+  };
+}

package/dist/kernel/src/registry/mod.js

@@ -1,3 +1,4 @@
+import { createInMemoryDriver } from "../persistence/drivers.js";
 /**
  * The global store registry.
  * Pre-populated with built-in stores by RuneProvider.
@@ -127,7 +128,10 @@ export function initializeStores(
     if (entry.conditional && !(entry.conditional in pluginConfig)) {
       continue;
     }
-    const store = entry.factory(pluginConfig, driver, stores);
+    const effectiveDriver = entry.noPersistence
+      ? createInMemoryDriver()
+      : driver;
+    const store = entry.factory(pluginConfig, effectiveDriver, stores);
     if (store === null && entry.optional) {
       continue; // Optional store chose not to create
     }

package/dist/mod.js

@@ -4,4 +4,4 @@ export * from "./kernel/src/mod.js";
 export * from "./runes/layout/src/mod.js";
 export * from "./runes/palettes/src/mod.js";
 export * from "./runes/plugins/money/src/mod.js";
-export const version = () => "0.4.8-alpha.1";
+export const version = () => "0.4.8";

package/dist/runes/layout/src/ResourceSelector.svelte

@@ -6,7 +6,7 @@
 
     interface Props {
         /** ConfigStore instance to bind to */
-        store: ConfigStore<T>;
+        store: ConfigStore<T, keyof T>;
         /** Key to use as identifier (e.g., "name", "code") */
         idKey: string;
         /** Optional subset of IDs to show */
@@ -35,7 +35,7 @@
     }: Props = $props();
 
     const userDictionary =
-        getContext<Record<string, any>>("rl:dictionary") ?? {};
+        getContext<Record<string, (...args: unknown[]) => string>>("rl:dictionary") ?? {};
 
     /**
      * Resolve a label for an item through the message chain:
@@ -43,11 +43,11 @@
      * 2. Paraglide messages
      * 3. Raw key fallback
      */
-    function resolveLabel(item: any): string {
-        const key = String(item[idKey]);
+    function resolveLabel(item: T): string {
+        const key = String((item as Record<string, unknown>)[idKey]);
         if (typeof userDictionary[key] === "function")
             return userDictionary[key]();
-        if (typeof (m as any)[key] === "function") return (m as any)[key]();
+        if (typeof (m as Record<string, (...args: unknown[]) => string>)[key] === "function") return (m as Record<string, (...args: unknown[]) => string>)[key]();
         return key;
     }
 
@@ -55,8 +55,8 @@
 
     let available = $derived(
         filterKeys.length > 0
-            ? store.available.filter((item: any) =>
-                  filterKeys.includes(String(item[idKey])),
+            ? store.available.filter((item: T) =>
+                  filterKeys.includes(String((item as Record<string, unknown>)[idKey])),
               )
             : store.available,
     );

package/dist/runes/layout/src/ResourceSelector.svelte.d.ts

@@ -3,7 +3,7 @@ import { type Snippet } from "svelte";
 declare function $$render<T>(): {
   props: {
     /** ConfigStore instance to bind to */
-    store: ConfigStore<T>;
+    store: ConfigStore<T, keyof T>;
     /** Key to use as identifier (e.g., "name", "code") */
     idKey: string;
     /** Optional subset of IDs to show */

package/dist/runes/layout/src/language.svelte.d.ts

@@ -1,5 +1,4 @@
 import {
-  type ConfigStore,
   createConfigStore,
   getLanguageStore,
 } from "../../../kernel/src/mod.js";
@@ -49,6 +48,11 @@ export declare const LANGUAGES: readonly [{
   readonly code: "vi";
   readonly flag: "🇻🇳";
 }];
-export declare const languageStore: ConfigStore<Language>;
-export type LanguageStore = ReturnType<typeof createConfigStore<Language>>;
+export declare const languageStore: import("../../../mod.ts").ConfigStore<
+  Language,
+  "code"
+>;
+export type LanguageStore = ReturnType<
+  typeof createConfigStore<Language, "code">
+>;
 export { getLanguageStore };

package/dist/runes/layout/src/theme.svelte.d.ts

@@ -5,6 +5,9 @@ export type { Theme };
  * Resolver to get the display name of a theme in the current locale
  */
 export declare const getThemeName: (option: Theme) => string;
-export declare const themeStore: ConfigStore<Theme>;
-export type ThemeStore = ReturnType<typeof createConfigStore<Theme>>;
+export declare const themeStore: import("../../../mod.ts").ConfigStore<
+  Theme,
+  "name"
+>;
+export type ThemeStore = ReturnType<typeof createConfigStore<Theme, "name">>;
 export { getThemeStore };

package/dist/runes/palettes/src/commands/store.svelte.d.ts

@@ -9,9 +9,9 @@ export interface CommandServices {
   appStore: unknown;
   apiStore: unknown;
   toastStore: IToastStore;
-  themeStore: ConfigStore<unknown>;
-  languageStore: ConfigStore<unknown>;
-  currencyStore: ConfigStore<unknown>;
+  themeStore: ConfigStore<Record<string, unknown>, string>;
+  languageStore: ConfigStore<Record<string, unknown>, string>;
+  currencyStore: ConfigStore<Record<string, unknown>, string>;
 }
 export declare class CommandStore {
   #private;

package/dist/runes/palettes/src/notifications/Toaster.svelte

@@ -1,7 +1,5 @@
 <script lang="ts">
   import { getToastStore, portal } from "../../../../kernel/src/mod.js";
-  import { flip } from "svelte/animate";
-  import { fade, fly } from "svelte/transition";
 
   const toastStore = getToastStore();
 
@@ -28,7 +26,7 @@
         "bg-amber-500/10 border-amber-500/20 text-amber-600 dark:text-amber-400",
       iconColor: "text-amber-500",
       iconPath:
-        "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z", // Proper warning icon
+        "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z",
     },
     error: {
       colors: "bg-red-500/10 border-red-500/20 text-red-600 dark:text-red-400",
@@ -39,6 +37,15 @@
   };
 </script>
 
+<style>
+  @media (prefers-reduced-motion: reduce) {
+    .toast-item {
+      animation: none !important;
+      transition: none !important;
+    }
+  }
+</style>
+
 <div
   use:portal
   class="toast toast-end toast-bottom z-[9999] p-4 gap-3 pointer-events-none"
@@ -47,8 +54,10 @@
     {@const styles = typeDetails[toast.type] || typeDetails.info}
 
     <div
-      class="pointer-events-auto relative flex w-full max-w-sm items-start gap-4 overflow-hidden rounded-xl border p-4 shadow-lg backdrop-blur-xl transition-all duration-300 sm:min-w-[320px] {styles.colors} animate-in fade-in slide-in-from-bottom-4 zoom-in-95 ease-out data-[state=closed]:animate-out data-[state=closed]:fade-out data-[state=closed]:slide-out-to-right-full"
+      class="toast-item pointer-events-auto relative flex w-full max-w-sm items-start gap-4 overflow-hidden rounded-xl border p-4 shadow-lg backdrop-blur-xl transition-all duration-300 sm:min-w-[320px] {styles.colors} animate-in fade-in slide-in-from-bottom-4 zoom-in-95 ease-out data-[state=closed]:animate-out data-[state=closed]:fade-out data-[state=closed]:slide-out-to-right-full"
       role="alert"
+      onmouseenter={() => toastStore.pause(toast.id)}
+      onmouseleave={() => toastStore.resume(toast.id)}
     >
       <!-- Icon -->
       <div class="shrink-0 {styles.iconColor} mt-0.5">

package/dist/runes/palettes/src/notifications/store.svelte.d.ts

@@ -5,15 +5,24 @@ import { getToastStore } from "../../../../kernel/src/mod.js";
 import type { Toast, ToastType } from "../../../../kernel/src/mod.js";
 export type { Toast, ToastType };
 export declare class ToastStore {
+  #private;
   toasts: Toast[];
   /**
-   * Add a new toast
+   * Add a new toast with FIFO eviction capped at exactly 5
    */
   send(message: string, type?: ToastType, duration?: number): void;
   /**
-   * Remove a toast by id
+   * Remove a toast by id and clean up its active timer
    */
   dismiss(id: string): void;
+  /**
+   * Pause the auto-dismiss timer for a toast (e.g. on hover)
+   */
+  pause(id: string): void;
+  /**
+   * Resume the auto-dismiss timer for a toast (e.g. on mouse leave)
+   */
+  resume(id: string): void;
   success(msg: string): void;
   error(msg: string): void;
   warn(msg: string): void;

package/dist/runes/palettes/src/notifications/store.svelte.js

@@ -4,25 +4,76 @@
 import { getToastStore } from "../../../../kernel/src/mod.js";
 export class ToastStore {
   toasts = $state([]);
+  #meta = new Map();
   /**
-   * Add a new toast
+   * Add a new toast with FIFO eviction capped at exactly 5
    */
   send(message, type = "info", duration = 3000) {
-    const id = crypto.randomUUID();
+    // Evict oldest if we are at cap (FIFO)
+    while (this.toasts.length >= 5) {
+      const oldest = this.toasts[0];
+      this.dismiss(oldest.id);
+    }
+    // Generate id: use crypto.randomUUID if available, else fallback
+    let id;
+    if (
+      typeof crypto !== "undefined" && typeof crypto.randomUUID === "function"
+    ) {
+      id = crypto.randomUUID();
+    } else {
+      id = "toast-" + Math.random().toString(36).substring(2, 9) + "-" +
+        Date.now();
+    }
     const toast = { id, message, type, duration };
     this.toasts.push(toast);
     if (duration > 0) {
-      setTimeout(() => {
+      const meta = {
+        remaining: duration,
+        lastStarted: Date.now(),
+      };
+      this.#meta.set(id, meta);
+      meta.timeoutId = setTimeout(() => {
         this.dismiss(id);
       }, duration);
     }
   }
   /**
-   * Remove a toast by id
+   * Remove a toast by id and clean up its active timer
    */
   dismiss(id) {
+    const meta = this.#meta.get(id);
+    if (meta) {
+      if (meta.timeoutId) {
+        clearTimeout(meta.timeoutId);
+      }
+      this.#meta.delete(id);
+    }
     this.toasts = this.toasts.filter((t) => t.id !== id);
   }
+  /**
+   * Pause the auto-dismiss timer for a toast (e.g. on hover)
+   */
+  pause(id) {
+    const meta = this.#meta.get(id);
+    if (meta && meta.timeoutId) {
+      clearTimeout(meta.timeoutId);
+      const elapsed = Date.now() - meta.lastStarted;
+      meta.remaining = Math.max(0, meta.remaining - elapsed);
+      meta.timeoutId = undefined;
+    }
+  }
+  /**
+   * Resume the auto-dismiss timer for a toast (e.g. on mouse leave)
+   */
+  resume(id) {
+    const meta = this.#meta.get(id);
+    if (meta && !meta.timeoutId && meta.remaining > 0) {
+      meta.lastStarted = Date.now();
+      meta.timeoutId = setTimeout(() => {
+        this.dismiss(id);
+      }, meta.remaining);
+    }
+  }
   // Helper methods
   success(msg) {
     this.send(msg, "success");

package/dist/runes/palettes/src/notifications/store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runes/palettes/src/notifications/store.test.js

@@ -0,0 +1,83 @@
+import { describe, expect, it, vi } from "vite-plus/test";
+import { ToastStore } from "./store.svelte.js";
+describe("ToastStore", () => {
+  it("should initialize with empty toasts", () => {
+    const store = new ToastStore();
+    expect(store.toasts).toEqual([]);
+  });
+  it("should cap at exactly 5 toasts and evict the oldest first (FIFO)", () => {
+    const store = new ToastStore();
+    store.send("Msg 1");
+    store.send("Msg 2");
+    store.send("Msg 3");
+    store.send("Msg 4");
+    store.send("Msg 5");
+    expect(store.toasts.length).toBe(5);
+    expect(store.toasts[0].message).toBe("Msg 1");
+    store.send("Msg 6");
+    expect(store.toasts.length).toBe(5);
+    expect(store.toasts[0].message).toBe("Msg 2");
+    expect(store.toasts.map((t) => t.message)).toEqual([
+      "Msg 2",
+      "Msg 3",
+      "Msg 4",
+      "Msg 5",
+      "Msg 6",
+    ]);
+  });
+  it("should generate valid fallback IDs when crypto is not present", () => {
+    const store = new ToastStore();
+    const originalCrypto = globalThis.crypto;
+    // Temporarily hide crypto
+    // @ts-ignore: Mocking globalThis.crypto for test
+    delete globalThis.crypto;
+    try {
+      store.send("No crypto id test");
+      expect(store.toasts.length).toBe(1);
+      expect(store.toasts[0].id).toContain("toast-");
+    } finally {
+      // Restore crypto
+      globalThis.crypto = originalCrypto;
+    }
+  });
+  it("should dismiss a toast manually and clean up its timer", () => {
+    vi.useFakeTimers();
+    try {
+      const store = new ToastStore();
+      const clearTimeoutSpy = vi.spyOn(globalThis, "clearTimeout");
+      store.send("Timer test", "info", 5000);
+      const toastId = store.toasts[0].id;
+      store.dismiss(toastId);
+      expect(store.toasts).toEqual([]);
+      expect(clearTimeoutSpy).toHaveBeenCalled();
+      clearTimeoutSpy.mockRestore();
+    } finally {
+      vi.useRealTimers();
+    }
+  });
+  it("should pause auto-dismiss timer on pause() and resume on resume()", () => {
+    vi.useFakeTimers();
+    try {
+      const store = new ToastStore();
+      store.send("Pause test", "info", 1000);
+      const toastId = store.toasts[0].id;
+      // Advance time by 400ms
+      vi.advanceTimersByTime(400);
+      // Hover: pause
+      store.pause(toastId);
+      // Advance time by another 1000ms. Toast should still be present because it was paused!
+      vi.advanceTimersByTime(1000);
+      expect(store.toasts.length).toBe(1);
+      // Leave: resume. Remaining duration should be 600ms.
+      store.resume(toastId);
+      // Advance 500ms. Still present.
+      vi.advanceTimersByTime(500);
+      expect(store.toasts.length).toBe(1);
+      // Advance final 100ms. Toast should be dismissed.
+      vi.advanceTimersByTime(100);
+      expect(store.toasts.length).toBe(0);
+    } finally {
+      vi.useRealTimers();
+    }
+  });
+});

package/dist/runes/plugins/money/src/currency.svelte.d.ts

@@ -27,7 +27,7 @@ declare function convertAmount(
   fromCode: string,
   toCode?: string,
 ): number;
-export declare const currencyStore: ConfigStore<Currency> & {
+export declare const currencyStore: ConfigStore<Currency, "code"> & {
   addCurrency: typeof addCurrency;
   convertAmount: typeof convertAmount;
   readonly canConvert: boolean;

package/dist/runes/plugins/money/src/exchange-rate.svelte.d.ts

@@ -29,8 +29,7 @@ export declare class ExchangeRateStore {
    */
   getRate(fromCode: string, toCode: string): ScaledRate | number | undefined;
   /**
-   * Internal conversion logic that handles triangulation through base currency.
-   * Delegates all math to ConversionStrategies (directConversion, inverseConversion, triangularConversion).
+   * Internal conversion logic that reads directly from the derived cross-rate matrix.
    */
   convertAmount(amount: number, fromCode: string, toCode: string): number;
 }

package/dist/runes/plugins/money/src/exchange-rate.svelte.js

@@ -1,20 +1,59 @@
 // sdk/state/src/exchange-rate.svelte.ts
 import { getContext } from "svelte";
-import {
-  convertMoney,
-  createMoney,
-  CURRENCY_MAP,
-  directConversion,
-  inverseConversion,
-  resolveRate,
-  scaledRate,
-  toMoneySnapshot,
-  triangularConversion,
-} from "./mod.js";
+import { CURRENCY_MAP, resolveRate, scaledRate } from "./mod.js";
 import { RUNE_LAB_CONTEXT } from "../../../../kernel/src/mod.js";
 export class ExchangeRateStore {
   #rates = $state({});
   #baseCurrency = $state("USD");
+  /**
+   * Combined reactive cross-rate matrix: from -> to -> floatRate
+   */
+  #matrix = $derived.by(() => {
+    const base = this.#baseCurrency;
+    const rates = this.#rates;
+    if (!rates || Object.keys(rates).length === 0) {
+      return {};
+    }
+    const currencies = new Set([base, ...Object.keys(rates)]);
+    const mat = {};
+    for (const from of currencies) {
+      mat[from] = {};
+      for (const to of currencies) {
+        if (from === to) {
+          mat[from][to] = 1.0;
+          continue;
+        }
+        // Direct: base -> to
+        if (from === base) {
+          const rateTo = rates[to];
+          if (rateTo !== undefined) {
+            mat[from][to] = resolveRate(rateTo);
+          }
+        } // Inverse: from -> base
+        else if (to === base) {
+          const rateFrom = rates[from];
+          if (rateFrom !== undefined) {
+            const r = resolveRate(rateFrom);
+            if (r !== 0) {
+              mat[from][to] = 1.0 / r;
+            }
+          }
+        } // Triangular: from -> base -> to
+        else {
+          const rateFrom = rates[from];
+          const rateTo = rates[to];
+          if (rateFrom !== undefined && rateTo !== undefined) {
+            const rFrom = resolveRate(rateFrom);
+            if (rFrom !== 0) {
+              const rTo = resolveRate(rateTo);
+              mat[from][to] = rTo / rFrom;
+            }
+          }
+        }
+      }
+    }
+    return mat;
+  });
   /**
    * The current exchange rates relative to the base currency.
    */
@@ -69,56 +108,26 @@ export class ExchangeRateStore {
     if (!this.hasRates) {
       return undefined;
     }
-    try {
-      // 1 unit of fromCode (major unit)
-      const oneUnit = Math.pow(
-        Array.isArray(fromCurrency.base)
-          ? fromCurrency.base[0]
-          : fromCurrency.base,
-        fromCurrency.exponent,
-      );
-      const currentRates = this.#rates;
-      const currentBase = this.#baseCurrency;
-      const sourceMoney = createMoney(oneUnit, fromCode);
-      let targetMoney;
-      if (fromCode === currentBase) {
-        // Direct: base → target
-        targetMoney = convertMoney(sourceMoney, toCode, currentRates);
-      } else if (toCode === currentBase) {
-        // Inverse: target → base
-        const rateToBase = currentRates[fromCode];
-        if (!rateToBase) {
-          return undefined;
-        }
-        const r = resolveRate(rateToBase);
-        targetMoney = convertMoney(sourceMoney, toCode, {
-          [toCode]: scaledRate(1 / r, 6),
-        });
-      } else {
-        // Triangular: source → base → target
-        const rateToBase = currentRates[fromCode];
-        const rateToTarget = currentRates[toCode];
-        if (!rateToBase || !rateToTarget) {
-          return undefined;
-        }
-        const r1 = resolveRate(rateToBase);
-        const r2 = resolveRate(rateToTarget);
-        targetMoney = convertMoney(sourceMoney, toCode, {
-          [toCode]: scaledRate(r2 / r1, 6),
-        });
-      }
-      const snapshot = toMoneySnapshot(targetMoney);
-      return {
-        amount: snapshot.amount,
-        scale: snapshot.scale,
-      };
-    } catch (_err) {
+    const rate = this.#matrix[fromCode]?.[toCode];
+    if (rate === undefined) {
       return undefined;
     }
+    let scale = 6;
+    if (fromCode === this.#baseCurrency) {
+      const rateEntry = this.#rates[toCode];
+      const rateScale = (rateEntry && typeof rateEntry === "object")
+        ? rateEntry.scale
+        : 4;
+      const exponent = toCurrency.exponent;
+      scale = exponent + rateScale;
+    } else {
+      const exponent = toCurrency.exponent;
+      scale = exponent + 6;
+    }
+    return scaledRate(rate, scale);
   }
   /**
-   * Internal conversion logic that handles triangulation through base currency.
-   * Delegates all math to ConversionStrategies (directConversion, inverseConversion, triangularConversion).
+   * Internal conversion logic that reads directly from the derived cross-rate matrix.
    */
   convertAmount(amount, fromCode, toCode) {
     if (fromCode === toCode) {
@@ -127,33 +136,11 @@ export class ExchangeRateStore {
     if (!this.hasRates) {
       return amount;
     }
-    // Direct: Base → Target
-    if (fromCode === this.#baseCurrency) {
-      const rateToTarget = this.#rates[toCode];
-      if (!rateToTarget) {
-        return amount;
-      }
-      return directConversion(amount, resolveRate(rateToTarget));
-    }
-    // Inverse: Target → Base
-    if (toCode === this.#baseCurrency) {
-      const rateFromSource = this.#rates[fromCode];
-      if (!rateFromSource) {
-        return amount;
-      }
-      return inverseConversion(amount, resolveRate(rateFromSource));
-    }
-    // Triangulation: From → Base → To
-    const rateFromSource = this.#rates[fromCode];
-    const rateToTarget = this.#rates[toCode];
-    if (!rateFromSource || !rateToTarget) {
+    const rate = this.#matrix[fromCode]?.[toCode];
+    if (rate === undefined) {
       return amount;
     }
-    return triangularConversion(
-      amount,
-      resolveRate(rateFromSource),
-      resolveRate(rateToTarget),
-    );
+    return Math.round(amount * rate);
   }
 }
 /**
@@ -166,5 +153,11 @@ export function createExchangeRateStore() {
  * Consumer to retrieve the ExchangeRateStore from context.
  */
 export function getExchangeRateStore() {
-  return getContext(RUNE_LAB_CONTEXT.exchangeRate);
+  const store = getContext(RUNE_LAB_CONTEXT.exchangeRate);
+  if (!store) {
+    throw new Error(
+      "[rune-lab] getExchangeRateStore() found no ExchangeRateStore. Did you register MoneyPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
+  return store;
 }

package/dist/runes/plugins/money/src/useMoney.js

@@ -26,8 +26,23 @@ import {
  */
 export function useMoney() {
   const currencyStore = getContext(RUNE_LAB_CONTEXT.currency);
+  if (!currencyStore) {
+    throw new Error(
+      "[rune-lab] useMoney() found no CurrencyStore. Did you register MoneyPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
   const languageStore = getContext(RUNE_LAB_CONTEXT.language);
+  if (!languageStore) {
+    throw new Error(
+      "[rune-lab] useMoney() found no LanguageStore. Did you register LayoutPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
   const exchangeRateStore = getContext(RUNE_LAB_CONTEXT.exchangeRate);
+  if (!exchangeRateStore) {
+    throw new Error(
+      "[rune-lab] useMoney() found no ExchangeRateStore. Did you register MoneyPlugin in <RuneProvider plugins={[…]}>?",
+    );
+  }
   /**
    * Convert amount to a Dinero object using current currency
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rune-lab",
-  "version": "0.4.8-alpha.2",
+  "version": "0.4.8",
   "description": "Modern toolkit for Svelte 5 Runes applications.",
   "type": "module",
   "author": "Fernando Bryan Reza Campos",
@@ -33,7 +33,7 @@
   "devDependencies": {
     "vite-plus": "npm:vite-plus",
     "svelte": "npm:svelte",
-    "@sveltejs/package": "npm:@sveltejs/package@^2.5.7",
+    "@sveltejs/package": "npm:@sveltejs/package",
     "@sveltejs/vite-plugin-svelte": "npm:@sveltejs/vite-plugin-svelte",
     "jsdom": "npm:jsdom",
     "@testing-library/jest-dom": "npm:@testing-library/jest-dom"
@@ -45,4 +45,4 @@
     "ui",
     "components"
   ]
-}
+}