rune-lab 0.4.0 → 0.4.1

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

@@ -1,44 +0,0 @@
-import type { StoreRegistryEntry } from "./types.ts";
-export type { StoreFactory, StoreRegistryEntry } from "./types.ts";
-/**
- * The global store registry.
- * Pre-populated with built-in stores by RuneProvider.
- * Third-party plugins can register additional entries before mounting.
- *
- * @example
- * ```ts
- * // Plugin registration (before RuneProvider mounts)
- * registerStore({
- *   key: "analytics",
- *   factory: (config, driver) => createAnalyticsStore(config),
- *   optional: true,
- *   noPersistence: true,
- * });
- * ```
- */
-declare const STORE_REGISTRY: Map<string, StoreRegistryEntry<unknown, unknown>>;
-/**
- * Register a store entry in the global registry.
- * Must be called before RuneProvider mounts for the store to be auto-wired.
- *
- * @param entry - Store registry entry with key, factory, and options.
- * @throws Error if a store with the same key is already registered.
- */
-export declare function registerStore(entry: StoreRegistryEntry): void;
-/**
- * Get a registered store entry by key.
- */
-export declare function getRegisteredStore(key: string): StoreRegistryEntry | undefined;
-/**
- * Get all registered store entries.
- */
-export declare function getAllRegisteredStores(): Map<string, StoreRegistryEntry>;
-/**
- * Remove a store registration (primarily useful for testing).
- */
-export declare function unregisterStore(key: string): boolean;
-/**
- * Clear all store registrations (primarily useful for testing).
- */
-export declare function clearRegistry(): void;
-export { STORE_REGISTRY };

package/dist/state/registry/index.js

@@ -1,58 +0,0 @@
-// sdk/state/src/registry/index.ts
-// Store Registry — declarative map of context keys to store factories.
-// RuneProvider iterates this at mount time to auto-wire all stores.
-/**
- * The global store registry.
- * Pre-populated with built-in stores by RuneProvider.
- * Third-party plugins can register additional entries before mounting.
- *
- * @example
- * ```ts
- * // Plugin registration (before RuneProvider mounts)
- * registerStore({
- *   key: "analytics",
- *   factory: (config, driver) => createAnalyticsStore(config),
- *   optional: true,
- *   noPersistence: true,
- * });
- * ```
- */
-const STORE_REGISTRY = new Map();
-/**
- * Register a store entry in the global registry.
- * Must be called before RuneProvider mounts for the store to be auto-wired.
- *
- * @param entry - Store registry entry with key, factory, and options.
- * @throws Error if a store with the same key is already registered.
- */
-export function registerStore(entry) {
-    if (STORE_REGISTRY.has(entry.key)) {
-        console.warn(`[StoreRegistry] Overwriting existing store registration for key "${entry.key}"`);
-    }
-    STORE_REGISTRY.set(entry.key, entry);
-}
-/**
- * Get a registered store entry by key.
- */
-export function getRegisteredStore(key) {
-    return STORE_REGISTRY.get(key);
-}
-/**
- * Get all registered store entries.
- */
-export function getAllRegisteredStores() {
-    return STORE_REGISTRY;
-}
-/**
- * Remove a store registration (primarily useful for testing).
- */
-export function unregisterStore(key) {
-    return STORE_REGISTRY.delete(key);
-}
-/**
- * Clear all store registrations (primarily useful for testing).
- */
-export function clearRegistry() {
-    STORE_REGISTRY.clear();
-}
-export { STORE_REGISTRY };

package/dist/state/registry/registry.test.d.ts

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

package/dist/state/registry/registry.test.js

@@ -1,112 +0,0 @@
-import { describe, expect, it, beforeEach } from "vitest";
-import { registerStore, getRegisteredStore, getAllRegisteredStores, unregisterStore, clearRegistry, STORE_REGISTRY, } from "./index.ts";
-describe("StoreRegistry", () => {
-    // Clean slate for each test
-    beforeEach(() => {
-        clearRegistry();
-    });
-    describe("registerStore", () => {
-        it("should register a store entry", () => {
-            registerStore({
-                key: "test",
-                factory: () => ({ value: 42 }),
-            });
-            expect(STORE_REGISTRY.size).toBe(1);
-            expect(STORE_REGISTRY.has("test")).toBe(true);
-        });
-        it("should allow overwriting with a warning", () => {
-            registerStore({ key: "test", factory: () => "v1" });
-            registerStore({ key: "test", factory: () => "v2" });
-            expect(STORE_REGISTRY.size).toBe(1);
-            const entry = getRegisteredStore("test");
-            // Factory should be the second one
-            expect(entry?.factory({}, {})).toBe("v2");
-        });
-        it("should register multiple entries", () => {
-            registerStore({ key: "a", factory: () => "A" });
-            registerStore({ key: "b", factory: () => "B" });
-            registerStore({ key: "c", factory: () => "C" });
-            expect(STORE_REGISTRY.size).toBe(3);
-        });
-    });
-    describe("getRegisteredStore", () => {
-        it("should return the entry for a registered key", () => {
-            registerStore({
-                key: "theme",
-                factory: () => "theme-store",
-                optional: false,
-            });
-            const entry = getRegisteredStore("theme");
-            expect(entry).toBeDefined();
-            expect(entry.key).toBe("theme");
-            expect(entry.optional).toBe(false);
-        });
-        it("should return undefined for unregistered keys", () => {
-            expect(getRegisteredStore("nonexistent")).toBeUndefined();
-        });
-    });
-    describe("getAllRegisteredStores", () => {
-        it("should return all registered stores", () => {
-            registerStore({ key: "a", factory: () => "A" });
-            registerStore({ key: "b", factory: () => "B" });
-            const all = getAllRegisteredStores();
-            expect(all.size).toBe(2);
-            expect(all.has("a")).toBe(true);
-            expect(all.has("b")).toBe(true);
-        });
-    });
-    describe("unregisterStore", () => {
-        it("should remove a registered store", () => {
-            registerStore({ key: "test", factory: () => "val" });
-            expect(STORE_REGISTRY.has("test")).toBe(true);
-            const result = unregisterStore("test");
-            expect(result).toBe(true);
-            expect(STORE_REGISTRY.has("test")).toBe(false);
-        });
-        it("should return false for non-existent keys", () => {
-            expect(unregisterStore("nope")).toBe(false);
-        });
-    });
-    describe("clearRegistry", () => {
-        it("should remove all entries", () => {
-            registerStore({ key: "a", factory: () => "A" });
-            registerStore({ key: "b", factory: () => "B" });
-            expect(STORE_REGISTRY.size).toBe(2);
-            clearRegistry();
-            expect(STORE_REGISTRY.size).toBe(0);
-        });
-    });
-    describe("StoreFactory contract", () => {
-        it("factory receives config and driver, returns store", () => {
-            const mockDriver = {
-                get: () => null,
-                set: () => { },
-                remove: () => { },
-            };
-            registerStore({
-                key: "analytics",
-                factory: (config, driver) => ({
-                    type: "analytics",
-                    hasDriver: !!driver,
-                }),
-                optional: true,
-                noPersistence: true,
-            });
-            const entry = getRegisteredStore("analytics");
-            const store = entry.factory({ apiUrl: "test" }, mockDriver);
-            expect(store).toEqual({
-                type: "analytics",
-                hasDriver: true,
-            });
-        });
-        it("optional factory can return null", () => {
-            registerStore({
-                key: "optional-feature",
-                factory: () => null,
-                optional: true,
-            });
-            const entry = getRegisteredStore("optional-feature");
-            expect(entry.factory({}, {})).toBeNull();
-        });
-    });
-});

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

@@ -1,20 +0,0 @@
-import type { PersistenceDriver } from "@internal/core";
-/**
- * Factory function signature for creating a store.
- * Receives the resolved config and driver, returns a store instance or null (for optional stores).
- */
-export type StoreFactory<TConfig = unknown, TStore = unknown> = (config: TConfig, driver: PersistenceDriver) => TStore | null;
-/**
- * An entry in the Store Registry.
- * Maps a context key to its factory function and metadata.
- */
-export interface StoreRegistryEntry<TConfig = unknown, TStore = unknown> {
-    /** Unique key matching the RUNE_LAB_CONTEXT key (e.g., "theme", "language") */
-    key: string;
-    /** Factory function that creates the store */
-    factory: StoreFactory<TConfig, TStore>;
-    /** If true, the store is optional — null return from factory means "skip" */
-    optional?: boolean;
-    /** If true, the store does not use persistence at all */
-    noPersistence?: boolean;
-}

package/dist/state/registry/types.js

@@ -1,3 +0,0 @@
-// sdk/state/src/registry/types.ts
-// Types for the Store Registry — the declarative store auto-wiring engine.
-export {};

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

@@ -1,121 +0,0 @@
-/**
- * Metadata for a keyboard shortcut
- */
-export interface ShortcutMeta {
-    /** Unique dot-namespaced identifier (e.g. "rl:layout:toggle-nav") */
-    id: string;
-    /** Hotkeys.js-compatible key string (e.g. "ctrl+\\", "alt+down") */
-    keys: string;
-    /** Human-readable description shown in the Shortcut Palette */
-    label: string;
-    /** Display group within a scope (e.g. "Layout", "Navigation") */
-    category: string;
-    /** When the shortcut is eligible to fire */
-    scope: "global" | "layout" | `panel:${string}`;
-    /** Whether the shortcut is currently active in the execution engine */
-    enabled?: boolean;
-    /** Whether to hide the shortcut from the Shortcut Palette */
-    hidden?: boolean;
-}
-/**
- * Descriptor for a keyboard shortcut with handler
- */
-export interface ShortcutEntry extends ShortcutMeta {
-    /** The function to execute when the shortcut is triggered */
-    handler: (event: KeyboardEvent) => void;
-}
-/**
- * Built-in layout shortcuts
- */
-export declare const LAYOUT_SHORTCUTS: {
-    readonly TOGGLE_NAV: {
-        readonly id: "rl:layout:toggle-nav";
-        readonly keys: "ctrl+\\";
-        readonly label: "Toggle Navigation Panel";
-        readonly category: "Layout";
-        readonly scope: "global";
-    };
-    readonly TOGGLE_DETAIL: {
-        readonly id: "rl:layout:toggle-detail";
-        readonly keys: "ctrl+shift+\\";
-        readonly label: "Toggle Detail Panel";
-        readonly category: "Layout";
-        readonly scope: "global";
-    };
-    readonly OPEN_SHORTCUTS: {
-        readonly id: "rl:shortcuts:open";
-        readonly keys: "ctrl+/";
-        readonly label: "Show Shortcut Palette";
-        readonly category: "Help";
-        readonly scope: "global";
-    };
-    readonly NAV_NEXT: {
-        readonly id: "rl:nav:next-item";
-        readonly keys: "alt+down";
-        readonly label: "Next navigation item";
-        readonly category: "Navigation";
-        readonly scope: "panel:navigation";
-    };
-    readonly NAV_PREV: {
-        readonly id: "rl:nav:prev-item";
-        readonly keys: "alt+up";
-        readonly label: "Previous navigation item";
-        readonly category: "Navigation";
-        readonly scope: "panel:navigation";
-    };
-    readonly NAV_EXPAND: {
-        readonly id: "rl:nav:expand-section";
-        readonly keys: "alt+right";
-        readonly label: "Expand section";
-        readonly category: "Navigation";
-        readonly scope: "panel:navigation";
-    };
-    readonly NAV_COLLAPSE: {
-        readonly id: "rl:nav:collapse-section";
-        readonly keys: "alt+left";
-        readonly label: "Collapse section";
-        readonly category: "Navigation";
-        readonly scope: "panel:navigation";
-    };
-};
-export declare class ShortcutStore {
-    /** All registered shortcuts */
-    entries: ShortcutEntry[];
-    /** Whether the shortcut palette is currently visible */
-    showPalette: boolean;
-    /** Subset of shortcuts that should be displayed in the palette */
-    active: ShortcutEntry[];
-    /** Grouped entries for display (scope -> category -> entries) */
-    byScopeAndCategory: Record<string, Record<string, ShortcutEntry[]>>;
-    /** Scopes sorted by importance (global first, then layout, then alphabetical) */
-    sortedScopes: string[];
-    /**
-     * Register a new shortcut
-     */
-    register(entry: ShortcutEntry): void;
-    /**
-     * Unregister a shortcut by ID
-     */
-    unregister(id: string): void;
-    /**
-     * Enable a shortcut
-     */
-    enable(id: string): void;
-    /**
-     * Disable a shortcut
-     */
-    disable(id: string): void;
-    /**
-     * Find conflicts for a given key combo and scope
-     */
-    findConflicts(keys: string, scope: string): ShortcutEntry[];
-}
-/**
- * Svelte Action to listen for shortcuts registered in shortcutStore.
- * Applied to the root element of the layout.
- */
-export declare function shortcutListener(node: HTMLElement, shortcutStore: ShortcutStore): {
-    destroy(): void;
-};
-export declare function createShortcutStore(): ShortcutStore;
-export declare function getShortcutStore(): ShortcutStore;

package/dist/state/shortcuts.svelte.js

@@ -1,222 +0,0 @@
-import hotkeys from "hotkeys-js";
-import { getContext, untrack } from "svelte";
-import { RUNE_LAB_CONTEXT } from "./context.ts";
-import { DEV } from "esm-env";
-/**
- * Built-in layout shortcuts
- */
-export const LAYOUT_SHORTCUTS = {
-    TOGGLE_NAV: {
-        id: "rl:layout:toggle-nav",
-        keys: "ctrl+\\",
-        label: "Toggle Navigation Panel",
-        category: "Layout",
-        scope: "global",
-    },
-    TOGGLE_DETAIL: {
-        id: "rl:layout:toggle-detail",
-        keys: "ctrl+shift+\\",
-        label: "Toggle Detail Panel",
-        category: "Layout",
-        scope: "global",
-    },
-    OPEN_SHORTCUTS: {
-        id: "rl:shortcuts:open",
-        keys: "ctrl+/",
-        label: "Show Shortcut Palette",
-        category: "Help",
-        scope: "global",
-    },
-    NAV_NEXT: {
-        id: "rl:nav:next-item",
-        keys: "alt+down",
-        label: "Next navigation item",
-        category: "Navigation",
-        scope: "panel:navigation",
-    },
-    NAV_PREV: {
-        id: "rl:nav:prev-item",
-        keys: "alt+up",
-        label: "Previous navigation item",
-        category: "Navigation",
-        scope: "panel:navigation",
-    },
-    NAV_EXPAND: {
-        id: "rl:nav:expand-section",
-        keys: "alt+right",
-        label: "Expand section",
-        category: "Navigation",
-        scope: "panel:navigation",
-    },
-    NAV_COLLAPSE: {
-        id: "rl:nav:collapse-section",
-        keys: "alt+left",
-        label: "Collapse section",
-        category: "Navigation",
-        scope: "panel:navigation",
-    },
-};
-export class ShortcutStore {
-    /** All registered shortcuts */
-    entries = $state([]);
-    /** Whether the shortcut palette is currently visible */
-    showPalette = $state(false);
-    /** Subset of shortcuts that should be displayed in the palette */
-    active = $derived(this.entries.filter((e) => e.enabled !== false && !e.hidden));
-    /** Grouped entries for display (scope -> category -> entries) */
-    byScopeAndCategory = $derived.by(() => {
-        const groups = {};
-        for (const entry of this.active) {
-            const scope = entry.scope;
-            const category = entry.category;
-            if (!groups[scope])
-                groups[scope] = {};
-            if (!groups[scope][category])
-                groups[scope][category] = [];
-            groups[scope][category].push(entry);
-        }
-        return groups;
-    });
-    /** Scopes sorted by importance (global first, then layout, then alphabetical) */
-    sortedScopes = $derived.by(() => {
-        return Object.keys(this.byScopeAndCategory).sort((a, b) => {
-            if (a === "global")
-                return -1;
-            if (b === "global")
-                return 1;
-            if (a === "layout")
-                return -1;
-            if (b === "layout")
-                return 1;
-            return a.localeCompare(b);
-        });
-    });
-    /**
-     * Register a new shortcut
-     */
-    register(entry) {
-        untrack(() => {
-            const existingIndex = this.entries.findIndex((e) => e.id === entry.id);
-            if (existingIndex !== -1) {
-                if (DEV) {
-                    console.warn(`[ShortcutStore] Overwriting shortcut ID "${entry.id}"`, {
-                        old: this.entries[existingIndex],
-                        new: entry,
-                    });
-                }
-                this.entries[existingIndex] = { enabled: true, ...entry };
-                return;
-            }
-            // Check for collisions (keys + scope)
-            const collision = this.entries.find((e) => e.keys === entry.keys && e.scope === entry.scope);
-            if (collision && DEV) {
-                console.warn(`[ShortcutStore] Collision detected for keys "${entry.keys}" in scope "${entry.scope}". ` +
-                    `ID "${entry.id}" will displace "${collision.id}".`);
-            }
-            this.entries.push({ enabled: true, ...entry });
-        });
-    }
-    /**
-     * Unregister a shortcut by ID
-     */
-    unregister(id) {
-        untrack(() => {
-            this.entries = this.entries.filter((e) => e.id !== id);
-        });
-    }
-    /**
-     * Enable a shortcut
-     */
-    enable(id) {
-        untrack(() => {
-            const entry = this.entries.find((e) => e.id === id);
-            if (entry)
-                entry.enabled = true;
-        });
-    }
-    /**
-     * Disable a shortcut
-     */
-    disable(id) {
-        untrack(() => {
-            const entry = this.entries.find((e) => e.id === id);
-            if (entry)
-                entry.enabled = false;
-        });
-    }
-    /**
-     * Find conflicts for a given key combo and scope
-     */
-    findConflicts(keys, scope) {
-        return untrack(() => this.entries.filter((e) => e.keys === keys && e.scope === scope));
-    }
-}
-/**
- * Svelte Action to listen for shortcuts registered in shortcutStore.
- * Applied to the root element of the layout.
- */
-export function shortcutListener(node, shortcutStore) {
-    // 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.
-            // That's exactly what we want.
-            for (const entry of shortcutStore.entries) {
-                if (entry.enabled === false)
-                    continue;
-                hotkeys(entry.keys, "all", (event, _handler) => {
-                    // Scoping logic: check if the event target is within the required scope
-                    if (entry.scope === "global") {
-                        // Hotkeys.js already filters inputs by default
-                        entry.handler(event);
-                    }
-                    else if (entry.scope === "layout") {
-                        if (node.contains(event.target)) {
-                            entry.handler(event);
-                        }
-                    }
-                    else if (entry.scope.startsWith("panel:")) {
-                        const panelId = entry.scope.replace("panel:", "");
-                        const panel = node.querySelector(`[data-rl-panel="${panelId}"]`);
-                        if (panel && panel.contains(event.target)) {
-                            entry.handler(event);
-                        }
-                    }
-                });
-            }
-        });
-        // Helper to sync hotkeys-js scope with focus
-        const handleFocusIn = (e) => {
-            const target = e.target;
-            const panel = target.closest("[data-rl-panel]");
-            if (panel) {
-                const scope = `panel:${panel.getAttribute("data-rl-panel")}`;
-                hotkeys.setScope(scope);
-            }
-            else if (node.contains(target)) {
-                hotkeys.setScope("layout");
-            }
-            else {
-                hotkeys.setScope("global");
-            }
-        };
-        globalThis.addEventListener("focusin", handleFocusIn);
-        return () => {
-            globalThis.removeEventListener("focusin", handleFocusIn);
-        };
-    });
-    return {
-        destroy() {
-            cleanup();
-            hotkeys.unbind();
-        },
-    };
-}
-export function createShortcutStore() {
-    return new ShortcutStore();
-}
-export function getShortcutStore() {
-    return getContext(RUNE_LAB_CONTEXT.shortcut);
-}

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

@@ -1,15 +0,0 @@
-import { type ConfigStore } from "./createConfigStore.svelte.ts";
-export interface Theme {
-    name: string;
-    icon: string;
-}
-import type { PersistenceDriver } from "@internal/core";
-export interface ThemeStoreOptions {
-    driver?: PersistenceDriver | (() => PersistenceDriver | undefined);
-    /** Additional custom themes to append to the built-in DaisyUI set */
-    customThemes?: Theme[];
-    /** Fallback theme if no persisted value exists (after system preference check) */
-    defaultTheme?: string;
-}
-export declare function createThemeStore(driverOrOptions?: PersistenceDriver | (() => PersistenceDriver | undefined) | ThemeStoreOptions): ConfigStore<Theme>;
-export declare function getThemeStore(): ConfigStore<Theme>;