rune-lab 0.4.2-beta.6 → 0.4.2-beta.8

package/.gitignore

@@ -0,0 +1,12 @@
+# all that start with a dot except .gitignore
+.*
+!.gitignore
+
+# lock files (from various package managers)
+*.lock
+
+# web-generated files
+node_modules
+dist
+lab
+build

package/deno.json

@@ -0,0 +1,47 @@
+{
+  "name": "@yrrrrrf/rune-lab",
+  "version": "0.4.2-beta.8",
+  "description": "Modern toolkit for Svelte 5 Runes applications.",
+  "type": "module",
+  "license": "MIT",
+  "readme": "README.md",
+  "author": "Fernando Bryan Reza Campos",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yrrrrrf/rune-lab.git"
+  },
+  "exports": {
+    ".": "./src/lib/mod.ts"
+  },
+  "nodeModulesDir": "manual",
+  "workspace": [
+    "./src/lib/kernel",
+    "./src/lib/runes/layout",
+    "./src/lib/runes/palettes",
+    "./src/lib/runes/plugins/money"
+  ],
+  "imports": {
+    "@rune-lab/core": "./src/lib/mod.ts",
+    "@rune-lab/i18n/": "./src/lib/i18n/",
+    "typescript": "npm:typescript@5.9.3",
+    "@tailwindcss/vite": "npm:@tailwindcss/vite",
+    "esm-env": "npm:esm-env",
+    "vite": "npm:vite",
+    "vite-plus": "npm:vite-plus",
+    "daisyui/": "npm:daisyui/",
+    "hotkeys-js": "npm:hotkeys-js",
+    "@inlang/paraglide-js": "npm:@inlang/paraglide-js",
+    "svelte": "npm:svelte",
+    "@sveltejs/kit": "npm:@sveltejs/kit",
+    "@sveltejs/vite-plugin-svelte": "npm:@sveltejs/vite-plugin-svelte",
+    "@sveltejs/adapter-static": "npm:@sveltejs/adapter-static",
+    "jsdom": "npm:jsdom",
+    "@testing-library/jest-dom": "npm:@testing-library/jest-dom"
+  },
+  "exclude": [
+    ".*",
+    "scripts/**",
+    "dist/**",
+    "**/*.test.ts"
+  ]
+}

package/justfile

@@ -0,0 +1,5 @@
+set shell := ["bash", "-cu"]
+
+import 'scripts/dev.just'
+import 'scripts/ci.just'
+import 'scripts/deploy.just'

package/package.json

@@ -1,33 +1,5 @@
 {
   "name": "rune-lab",
-  "readme": "README.md",
-  "version": "0.4.2-beta.6",
-  "description": "Modern toolkit for Svelte 5 Runes applications.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Yrrrrrf/rune-lab.git"
-  },
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./src/mod.d.ts",
-      "default": "./src/mod.js"
-    }
-  },
-  "peerDependencies": {
-    "svelte": "^5.55.0",
-    "@sveltejs/kit": "^2.55.0",
-    "@inlang/paraglide-js": "^2.15.1",
-    "hotkeys-js": "^4.0.2",
-    "dinero.js": "^2.0.2",
-    "esm-env": "^1.2.2"
-  },
-  "keywords": [
-    "svelte",
-    "svelte-5",
-    "runes",
-    "ui",
-    "components"
-  ]
-}
+  "version": "0.4.2-beta.8",
+  "packageManager": "pnpm@10.33.0"
+}

package/scripts/ci.just

@@ -0,0 +1,25 @@
+[doc('Format Client code')]
+[group('CI')]
+fmt:
+    deno fmt .
+    @echo "✓ Client code formatted"
+
+[doc('Lint Client code')]
+[group('CI')]
+lint:
+    deno lint .
+    @echo "✓ Client code linted"
+
+[doc('Type-check Client workspace')]
+[group('CI')]
+typecheck:
+    # check ts types with strict deno.ns
+    deno check .
+    # check svelte types
+    deno run -A npm:svelte-check
+    @echo "✓ Client type-checked"
+
+[doc('Full client quality gate')]
+[group('CI')]
+quality: fmt lint typecheck
+    @echo "✓ Client quality checks passed"

package/scripts/deploy.just

@@ -0,0 +1,20 @@
+[doc('Build Client')]
+[group('Build')]
+build:
+    # * Clean up previous build
+    rm -rf dist/
+    deno run -A npm:@inlang/paraglide-js compile  --project ./src/lib/i18n/project.inlang --outdir ./src/lib/i18n/paraglide
+    deno run -A npm:@sveltejs/package -- -i src -o dist
+    # * Build ESM package
+    # deno run -A scripts/build_pkg.ts
+    @echo "✓ build done"
+
+[doc('Publish to jsr')]
+[group('Deploy')]
+deploy: build
+    # * Format build output
+    deno fmt --no-config dist
+    # * Publish to npm
+    (cd dist && bun publish)
+    # * Publish to jsr
+    @echo "✓ deploy done"

package/scripts/dev.just

@@ -0,0 +1,4 @@
+[doc('Test the client (runs once)')]
+[group('Dev')]
+test *args:
+    vp test

package/scripts/inject.just

@@ -0,0 +1,72 @@
+# inject.just — surgical local rune-lab injection
+#
+# ⚠  IMPORTANT: `just -f` changes cwd to the justfile's directory.
+#    Never pass `.` as dest — pass $PWD or an absolute path instead.
+#
+# Usage:
+#   just -f ~/rune-lab/scripts/inject.just inject $PWD
+#   just -f ~/rune-lab/scripts/inject.just inject /absolute/path/to/project
+#   just -f ~/rune-lab/scripts/inject.just inject-clean $PWD
+#``
+# Recipes:
+#   inject        — build rune-lab, then hot-swap node_modules/rune-lab
+#   inject-clean  — full dep reset (yog reborn --deep), then inject
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Hot-swap: rebuild rune-lab and inject into <dest>/node_modules/rune-lab
+inject dest: _build-for-inject
+    #!/usr/bin/env bash
+    set -euo pipefail
+
+    dest_abs="{{ dest }}"
+
+    # Reject relative paths — they resolve to rune-lab's own dir, not the caller's
+    if [[ "$dest_abs" != /* ]]; then
+        echo "❌  dest must be an absolute path."
+        echo "    Call with:  just -f ... inject \$PWD"
+        echo "    Got:        $dest_abs"
+        exit 1
+    fi
+
+    if [ ! -d "$dest_abs/node_modules" ]; then
+        echo "❌  No node_modules/ found in $dest_abs"
+        echo "    Run your package manager's install first, then retry."
+        exit 1
+    fi
+
+    echo "🗑  Removing stale $dest_abs/node_modules/rune-lab..."
+    rm -rf "$dest_abs/node_modules/rune-lab"
+
+    echo "📦 Copying local dist into $dest_abs/node_modules/rune-lab..."
+    mkdir -p "$dest_abs/node_modules/rune-lab"
+    cp -r "{{ justfile_directory() }}/../dist"         "$dest_abs/node_modules/rune-lab/dist"
+    cp    "{{ justfile_directory() }}/../package.json" "$dest_abs/node_modules/rune-lab/package.json"
+
+    echo "✅  Done! node_modules/rune-lab → $(du -sh $dest_abs/node_modules/rune-lab | cut -f1)"
+    echo "    Source:  {{ justfile_directory() }}/../dist"
+    echo "    Target:  $dest_abs/node_modules/rune-lab"
+
+# Full reset: nuke deps in <dest>, reinstall, then hot-swap rune-lab
+inject-clean dest: _build-for-inject
+    #!/usr/bin/env bash
+    set -euo pipefail
+
+    dest_abs="{{ dest }}"
+
+    if [[ "$dest_abs" != /* ]]; then
+        echo "❌  dest must be an absolute path. Call with: just -f ... inject-clean \$PWD"
+        exit 1
+    fi
+
+    echo "💀 Running yog reborn --deep in $dest_abs..."
+    (cd "$dest_abs" && yog reborn --deep)
+
+    just -f "{{ justfile_directory() }}/inject.just" inject "$dest_abs"
+
+# ── Internal ──────────────────────────────────────────────────────────────────
+
+[private]
+_build-for-inject:
+    @echo "🔨 Building rune-lab from {{ justfile_directory() }}/.."
+    just --justfile "{{ justfile_directory() }}/../justfile" --working-directory "{{ justfile_directory() }}/.." build
+    @echo "✅  rune-lab built."

package/src/app.d.ts

@@ -0,0 +1,13 @@
+// See https://svelte.dev/docs/kit/types#app.d.ts
+// for information about these interfaces
+declare global {
+  namespace App {
+    // interface Error {}
+    // interface Locals {}
+    // interface PageData {}
+    // interface PageState {}
+    // interface Platform {}
+  }
+}
+
+export {};

package/src/app.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%sveltekit.assets%/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>

package/src/{i18n/message-resolver.test.js → lib/i18n/message-resolver.test.ts}

@@ -1,11 +1,14 @@
 import { describe, expect, it, vi } from "vite-plus/test";
+
 // Mock esm-env before importing the module
 vi.mock("esm-env", () => ({ DEV: true }));
+
 import {
   batchResolveMessages,
   createMessageResolver,
   hasMessage,
 } from "./message-resolver.ts";
+
 describe("MessageResolver", () => {
   const mockMessages = {
     usd: () => "US Dollar",
@@ -13,70 +16,87 @@ describe("MessageResolver", () => {
     mxn: () => "Mexican Peso",
     jpy: () => "Japanese Yen",
   };
+
   describe("createMessageResolver", () => {
     it("should resolve a key via keyExtractor", () => {
-      const resolver = createMessageResolver(mockMessages, {
+      const resolver = createMessageResolver<{ code: string }>(mockMessages, {
         keyExtractor: (opt) => opt.code,
         keyTransformer: (key) => key.toLowerCase(),
       });
+
       expect(resolver({ code: "USD" })).toBe("US Dollar");
       expect(resolver({ code: "EUR" })).toBe("Euro");
     });
+
     it("should use untransformed key when no transformer provided", () => {
-      const resolver = createMessageResolver(mockMessages, {
+      const resolver = createMessageResolver<{ code: string }>(mockMessages, {
         keyExtractor: (opt) => opt.code,
       });
+
       // Without transformer, keys must match exactly
       expect(resolver({ code: "usd" })).toBe("US Dollar");
     });
+
     it("should fall back to the raw key for missing translations", () => {
       const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
-      const resolver = createMessageResolver(mockMessages, {
+
+      const resolver = createMessageResolver<{ code: string }>(mockMessages, {
         keyExtractor: (opt) => opt.code,
         keyTransformer: (key) => key.toLowerCase(),
       });
+
       const result = resolver({ code: "UNKNOWN" });
       expect(result).toBe("UNKNOWN"); // falls back to original key
       expect(warnSpy).toHaveBeenCalledWith(
         expect.stringContaining("Missing translation"),
       );
+
       warnSpy.mockRestore();
     });
   });
+
   describe("hasMessage", () => {
     it("should return true for existing keys", () => {
       expect(hasMessage(mockMessages, "usd")).toBe(true);
       expect(hasMessage(mockMessages, "eur")).toBe(true);
     });
+
     it("should return false for missing keys", () => {
       expect(hasMessage(mockMessages, "UNKNOWN")).toBe(false);
       expect(hasMessage(mockMessages, "")).toBe(false);
     });
   });
+
   describe("batchResolveMessages", () => {
     it("should resolve all options at once", () => {
       const options = [{ code: "USD" }, { code: "EUR" }, { code: "MXN" }];
+
       const result = batchResolveMessages(mockMessages, options, {
         keyExtractor: (opt) => opt.code,
         keyTransformer: (key) => key.toLowerCase(),
       });
+
       expect(result).toEqual({
         USD: "US Dollar",
         EUR: "Euro",
         MXN: "Mexican Peso",
       });
     });
+
     it("should include fallback values for missing keys", () => {
       vi.spyOn(console, "warn").mockImplementation(() => {});
+
       const options = [{ code: "USD" }, { code: "XYZ" }];
       const result = batchResolveMessages(mockMessages, options, {
         keyExtractor: (opt) => opt.code,
         keyTransformer: (key) => key.toLowerCase(),
       });
+
       expect(result).toEqual({
         USD: "US Dollar",
         XYZ: "XYZ", // fallback
       });
+
       vi.restoreAllMocks();
     });
   });

package/src/{i18n/message-resolver.d.ts → lib/i18n/message-resolver.ts}

@@ -1,22 +1,29 @@
+// sdk/devtools/src/patterns/message-resolver.ts
+import { DEV } from "esm-env";
+
 /**
  * Dynamic i18n Message Resolver Pattern
  *
  * Enables dynamic message function calls for config selectors.
  * Creates a resolver that dynamically looks up and calls message functions.
  */
+
 type MessageBundle = Record<string, (...args: unknown[]) => string>;
+
 interface MessageResolverConfig<T> {
   /**
    * Function to extract the message key from an option
    * @example (currency) => currency.code // "USD"
    */
   keyExtractor: (option: T) => string;
+
   /**
    * Optional transformer for the key before message lookup
    * @example (key) => key.toLowerCase() // "USD" -> "usd"
    */
   keyTransformer?: (key: string) => string;
 }
+
 /**
  * Creates a message resolver function for dynamic i18n lookups
  *
@@ -29,23 +36,54 @@ interface MessageResolverConfig<T> {
  * getCurrencyLabel({ code: "EUR", symbol: "€" }); // "Euro"
  * ```
  */
-export declare function createMessageResolver<T>(
+export function createMessageResolver<T>(
   messages: MessageBundle,
   config: MessageResolverConfig<T>,
-): (option: T) => string;
+) {
+  return (option: T): string => {
+    const key = config.keyExtractor(option);
+    const transformedKey = config.keyTransformer
+      ? config.keyTransformer(key)
+      : key;
+
+    const messageFn = messages[transformedKey];
+
+    if (!messageFn || typeof messageFn !== "function") {
+      if (DEV) {
+        console.warn(
+          `[MessageResolver] Missing translation for key: "${transformedKey}"`,
+        );
+      }
+      return key; // Fallback to key
+    }
+
+    return messageFn();
+  };
+}
+
 /**
  * Type guard to check if a message key exists
  */
-export declare function hasMessage(
-  messages: MessageBundle,
-  key: string,
-): boolean;
+export function hasMessage(messages: MessageBundle, key: string): boolean {
+  return key in messages && typeof messages[key] === "function";
+}
+
 /**
  * Batch resolver for multiple options at once
  */
-export declare function batchResolveMessages<T>(
+export function batchResolveMessages<T>(
   messages: MessageBundle,
   options: T[],
   config: MessageResolverConfig<T>,
-): Record<string, string>;
-export {};
+): Record<string, string> {
+  const resolver = createMessageResolver(messages, config);
+
+  return options.reduce(
+    (acc, option) => {
+      const key = config.keyExtractor(option);
+      acc[key] = resolver(option);
+      return acc;
+    },
+    {} as Record<string, string>,
+  );
+}

package/src/{kernel/src/actions/portal.js → lib/kernel/src/actions/portal.ts}

@@ -1,11 +1,16 @@
 import { DEV } from "esm-env";
+
 /**
  * Svelte action to teleport a DOM element to a different target (e.g. body)
  */
-export function portal(node, target = "body") {
-  let targetNode;
+export function portal(
+  node: HTMLElement,
+  target: string | HTMLElement = "body",
+): { update(newTarget: string | HTMLElement): void; destroy(): void } {
+  let targetNode: HTMLElement | null;
   let isTeleported = false;
-  function update(newTarget) {
+
+  function update(newTarget: string | HTMLElement) {
     if (typeof newTarget === "string") {
       targetNode = document.querySelector(newTarget);
       if (!targetNode && DEV) {
@@ -16,12 +21,15 @@ export function portal(node, target = "body") {
     } else {
       targetNode = newTarget;
     }
+
     if (targetNode) {
       targetNode.appendChild(node);
       isTeleported = true;
     }
   }
+
   update(target);
+
   return {
     update,
     destroy() {

package/src/{kernel/src/actions/shortcut-listener.js → lib/kernel/src/actions/shortcut-listener.ts}

@@ -1,31 +1,46 @@
 import hotkeys from "hotkeys-js";
 import { untrack } from "svelte";
+
+export interface ShortcutStoreLike {
+  entries: {
+    enabled?: boolean;
+    keys: string;
+    when?: () => boolean;
+    handler: (event: KeyboardEvent) => void;
+  }[];
+}
+
 /**
  * Svelte Action to listen for shortcuts registered in shortcutStore.
  * Applied to the root element of the layout.
  */
-export function shortcutListener(_node, shortcutStore) {
+export function shortcutListener(
+  _node: HTMLElement,
+  shortcutStore: ShortcutStoreLike,
+): { destroy(): void } {
   // Use $effect to reactively sync shortcuts
   const cleanup = $effect.root(() => {
     $effect(() => {
       // Unbind everything first to ensure clean state
       hotkeys.unbind();
+
       // We read entries here, so this effect re-runs when entries change.
       for (const entry of shortcutStore.entries) {
         // @ts-ignore: enabled might not be on the interface but we check it anyway
-        if (entry.enabled === false) {
-          continue;
-        }
+        if (entry.enabled === false) continue;
+
         hotkeys(entry.keys, "all", (event, _handler) => {
           // Check "when" predicate if it exists
-          if (entry.when && !untrack(() => entry.when())) {
+          if (entry.when && !untrack(() => entry.when!())) {
             return;
           }
+
           entry.handler(event);
         });
       }
     });
   });
+
   return {
     destroy() {
       cleanup();

package/src/lib/kernel/src/context/app.svelte.ts

@@ -0,0 +1,98 @@
+// src/kernel/src/context/app.svelte.ts
+import { getContext } from "svelte";
+import { RUNE_LAB_CONTEXT } from "./context.ts";
+import { DEV } from "esm-env";
+
+/**
+ * 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 class AppStore {
+  // State
+  name: string = $state("Rune Lab");
+  version: string = $state("0.0.1");
+  description: string = $state("Modern toolkit for Svelte 5 Runes");
+  author: string = $state("Yrrrrrf");
+  repository: string = $state("https://github.com/Yrrrrrf/rune-lab");
+  license: string = $state("MIT");
+  homepage: string = $state("https://jsr.io/@yrrrrrf/rune-lab");
+  customIcons: Record<string, string> = $state<Record<string, string>>({});
+
+  #initialized = false;
+
+  /**
+   * Initialize app store with metadata.
+   */
+  init(data: Partial<AppData>): void {
+    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(): void {
+    this.#initialized = false;
+  }
+
+  /**
+   * Get full app information object
+   */
+  get info(): AppData {
+    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: Record<string, string>) {
+    this.customIcons = { ...this.customIcons, ...icons };
+  }
+}
+
+export function createAppStore(): AppStore {
+  return new AppStore();
+}
+
+export function getAppStore(): AppStore {
+  return getContext<AppStore>(RUNE_LAB_CONTEXT.app);
+}

package/src/{kernel/src/context/context.js → lib/kernel/src/context/context.ts}

@@ -1,5 +1,20 @@
 // src/lib/context.ts
-export const RUNE_LAB_CONTEXT = {
+
+export const RUNE_LAB_CONTEXT: {
+  app: symbol;
+  api: symbol;
+  toast: symbol;
+  theme: symbol;
+  language: symbol;
+  currency: symbol;
+  shortcut: symbol;
+  layout: symbol;
+  commands: symbol;
+  persistence: symbol;
+  cart: symbol;
+  session: symbol;
+  exchangeRate: symbol;
+} = {
   app: Symbol("rl:app"),
   api: Symbol("rl:api"),
   toast: Symbol("rl:toast"),
@@ -13,4 +28,4 @@ export const RUNE_LAB_CONTEXT = {
   cart: Symbol("rl:cart"),
   session: Symbol("rl:session"),
   exchangeRate: Symbol("rl:exchange-rate"),
-};
+} as const;