rune-lab 0.5.0-rc.2 → 0.5.0

package/dist/src/core/forge/define-plugin.d.ts

@@ -1,7 +1,16 @@
+import type { Schema } from "effect";
 import type { ContributionEntry } from "./define-contribution.js";
 import type { SettingsSchema } from "./define-settings.js";
 import type { BaseSlotSpec } from "./define-slot.js";
 import { type SlotDescriptor } from "./descriptors.js";
+export type SlotConfigInput<TSpec extends BaseSlotSpec> = TSpec extends {
+	config: Schema.Schema<infer TConfig, unknown, never>;
+}
+	? TConfig
+	: unknown;
+export type PluginConfigInput<TSlots extends Record<string, BaseSlotSpec>> = {
+	[K in keyof TSlots]?: SlotConfigInput<TSlots[K]>;
+};
 export interface ForgedPlugin<
 	TId extends string = string,
 	TSlots extends Record<string, BaseSlotSpec> = Record<string, BaseSlotSpec>,
@@ -13,6 +22,8 @@ export interface ForgedPlugin<
 	overlays?: unknown[];
 	contributions?: ContributionEntry<unknown>[];
 	descriptors: Record<keyof TSlots, SlotDescriptor>;
+	config?: Record<string, unknown>;
+	with(config: PluginConfigInput<TSlots>): ForgedPlugin<TId, TSlots>;
 }
 export type PluginInput =
 	| ForgedPlugin<string, Record<string, BaseSlotSpec>>

package/dist/src/core/forge/define-plugin.js

@@ -9,7 +9,7 @@ export function definePlugin(spec) {
 			accessorName: getAccessorName(slotName),
 		};
 	}
-	return {
+	const plugin = {
 		id: spec.id,
 		requires: spec.requires,
 		slots: slots,
@@ -17,5 +17,15 @@ export function definePlugin(spec) {
 		overlays: spec.overlays,
 		contributions: spec.contributions,
 		descriptors: descriptors,
+		with(config) {
+			return {
+				...this,
+				config: {
+					...(this.config || {}),
+					...config,
+				},
+			};
+		},
 	};
+	return plugin;
 }

package/dist/src/core/kernel/wiring.d.ts

@@ -13,6 +13,7 @@ export interface NormalizedSlot {
 	expose: boolean;
 	persist?: boolean | string[];
 	configSchema?: unknown;
+	pluginConfig?: Record<string, unknown>;
 	create: (context: SlotContext<unknown>) => unknown;
 }
 export declare function resolveSlotRef(

package/dist/src/core/kernel/wiring.js

@@ -33,12 +33,6 @@ function normalizePlugins(inputs) {
 		return true;
 	});
 }
-function getPluginConfig(pluginId, config) {
-	if (config[pluginId] !== undefined) {
-		return config[pluginId];
-	}
-	return config;
-}
 function sortPlugins(resolved) {
 	const pluginMap = new Map(resolved.map((p) => [p.id, p]));
 	const graphNodes = resolved.map((p) => ({
@@ -97,6 +91,7 @@ export function normalizeSlots(sorted) {
 				expose: slotSpec.expose !== false,
 				persist: slotSpec.persist,
 				configSchema: slotSpec.config,
+				pluginConfig: plugin.config,
 				create: slotSpec.create,
 			};
 			allSlots.push(slot);
@@ -151,18 +146,22 @@ function buildLayers(slots, options) {
 		const storeLayer = Layer.effect(
 			storeTag,
 			Effect.gen(function* () {
-				const pluginConfig = getPluginConfig(slot.pluginId, options.config);
-				let configSlice = pluginConfig;
+				const rawConfig = slot.pluginConfig?.[slot.slotName];
+				let configSlice = rawConfig;
 				if (slot.configSchema) {
-					try {
-						configSlice = Schema.decodeUnknownSync(slot.configSchema)(
-							pluginConfig,
-						);
-					} catch (err) {
-						const errMsg = err instanceof Error ? err.message : String(err);
-						throw new Error(
-							`[Kernel] Config validation failed for plugin "${slot.pluginId}", slot "${slot.slotName}": ${errMsg}`,
-						);
+					if (rawConfig !== undefined) {
+						try {
+							configSlice = Schema.decodeUnknownSync(slot.configSchema)(
+								rawConfig,
+							);
+						} catch (err) {
+							const errMsg = err instanceof Error ? err.message : String(err);
+							throw new Error(
+								`[Kernel] Config validation failed for plugin "${slot.pluginId}", slot "${slot.slotName}": ${errMsg}`,
+							);
+						}
+					} else {
+						configSlice = undefined;
 					}
 				}
 				let persistenceHandle;

package/dist/src/plugins/layout/stores/theme.svelte.js

@@ -51,13 +51,21 @@ export function createThemeStore(ctx) {
 		icon: "🎨",
 		driver: ctx.persistence,
 	});
-	if (!store.current && BROWSER) {
-		const prefersDark = globalThis.matchMedia(
-			"(prefers-color-scheme: dark)",
-		).matches;
-		const systemDefault = prefersDark ? "dark" : "light";
-		if (store.get(systemDefault)) {
-			store.set(systemDefault);
+	const saved = ctx.persistence.get("theme");
+	const hasPersisted =
+		typeof saved === "string" ? Boolean(saved && store.get(saved)) : false;
+	if (!hasPersisted) {
+		const configTheme = typeof ctx.config === "string" ? ctx.config : undefined;
+		if (configTheme && store.get(configTheme)) {
+			store.set(configTheme);
+		} else if (BROWSER) {
+			const prefersDark = globalThis.matchMedia(
+				"(prefers-color-scheme: dark)",
+			).matches;
+			const systemDefault = prefersDark ? "dark" : "light";
+			if (store.get(systemDefault)) {
+				store.set(systemDefault);
+			}
 		}
 	}
 	return store;

package/dist/src/plugins/palettes/palettes/shortcuts/ShortcutPalette.svelte

@@ -166,6 +166,8 @@ function formatKeys(keys: string) {
       <span><kbd class="kbd kbd-xs">ctrl</kbd> +
         <kbd class="kbd kbd-xs">/</kbd> to open help</span>
     </div>
-    <div>rune-lab v{appStore.version}</div>
+    {#if appStore.data.version}
+      <div>rune-lab v{appStore.data.version}</div>
+    {/if}
   </div>
 </div>

package/dist/src/plugins/palettes/plugin.d.ts

@@ -1,14 +1,19 @@
 import type { ForgedPlugin, SlotSpec } from "rune-lab/core";
 import type { CommandStore } from "./commands/store.svelte.js";
 import type { ToastStore } from "./notifications/store.svelte.js";
-import type { PaletteRegistryStore } from "./registry/registry.svelte.js";
+import type {
+	PaletteRegistryStore,
+	RouterAdapter,
+} from "./registry/registry.svelte.js";
 import type { ShortcutStore } from "./shortcuts/store.svelte.js";
-
+export interface RegistrySlotConfig {
+	router?: RouterAdapter;
+}
 type PalettesSlots = {
 	commands: SlotSpec<unknown, CommandStore>;
 	shortcuts: SlotSpec<unknown, ShortcutStore>;
 	toasts: SlotSpec<unknown, ToastStore>;
-	registry: SlotSpec<unknown, PaletteRegistryStore>;
+	registry: SlotSpec<RegistrySlotConfig, PaletteRegistryStore>;
 };
 export declare const PalettesPlugin: ForgedPlugin<
 	"rune-lab.palettes",

package/dist/src/plugins/palettes/plugin.js

@@ -31,8 +31,8 @@ export const PalettesPlugin = definePlugin({
 			expose: true,
 		}),
 		registry: defineSlot({
-			create: () => {
-				const store = createPaletteRegistryStore();
+			create: (ctx) => {
+				const store = createPaletteRegistryStore(ctx.config);
 				store.register({
 					id: "commands",
 					title: "Commands",

package/dist/src/plugins/palettes/registry/registry.svelte.d.ts

@@ -1,4 +1,8 @@
 import type { Component } from "svelte";
+export interface RouterAdapter {
+	replaceState?: (url: string) => void;
+	pushState?: (url: string) => void;
+}
 export interface PaletteDefinition {
 	id: string;
 	title: string;
@@ -12,10 +16,16 @@ export declare class PaletteRegistryStore {
 	palettes: PaletteDefinition[];
 	activePaletteId: string | null;
 	activeSectionId: string;
+	router?: RouterAdapter;
+	constructor(config?: {
+		router?: RouterAdapter;
+	});
 	register(palette: PaletteDefinition): void;
 	unregister(id: string): void;
 	open(id: string, section?: string): void;
 	setSection(sectionId: string): void;
 	close(): void;
 }
-export declare function createPaletteRegistryStore(): PaletteRegistryStore;
+export declare function createPaletteRegistryStore(config?: {
+	router?: RouterAdapter;
+}): PaletteRegistryStore;

package/dist/src/plugins/palettes/registry/registry.svelte.js

@@ -2,6 +2,10 @@ export class PaletteRegistryStore {
 	palettes = $state([]);
 	activePaletteId = $state(null);
 	activeSectionId = $state("general");
+	router;
+	constructor(config) {
+		this.router = config?.router;
+	}
 	register(palette) {
 		if (this.palettes.some((p) => p.id === palette.id)) {
 			return;
@@ -27,6 +31,6 @@ export class PaletteRegistryStore {
 		this.activePaletteId = null;
 	}
 }
-export function createPaletteRegistryStore() {
-	return new PaletteRegistryStore();
+export function createPaletteRegistryStore(config) {
+	return new PaletteRegistryStore(config);
 }

package/dist/src/plugins/palettes/settings-modal/AppMetadata.svelte

@@ -3,18 +3,18 @@ import { getAppStore } from "rune-lab";
 
 const appStore = getAppStore();
 const initial = $derived(
-  appStore.name ? appStore.name.charAt(0).toUpperCase() : "",
+  appStore.data.name ? appStore.data.name.charAt(0).toUpperCase() : "",
 );
 </script>
 
 <div class="p-4 flex items-center gap-4 bg-base-200 rounded-box">
-  {#if appStore.icon}
+  {#if appStore.data.icon}
     <img
-      src={appStore.icon}
-      alt={appStore.name}
+      src={appStore.data.icon}
+      alt={appStore.data.name ?? ""}
       class="w-12 h-12 rounded-box object-cover shrink-0"
     />
-  {:else}
+  {:else if initial}
     <div class="flex items-center justify-center w-12 h-12 bg-primary/10 text-primary font-bold rounded-box text-xl shrink-0">
       {initial}
     </div>
@@ -22,29 +22,37 @@ const initial = $derived(
 
   <div class="flex-1 min-w-0">
     <div class="flex items-center gap-2">
-      <span class="font-medium text-sm">{appStore.name}</span>
-      <span class="badge badge-primary badge-sm">v{appStore.version}</span>
+      {#if appStore.data.name}
+        <span class="font-medium text-sm">{appStore.data.name}</span>
+      {/if}
+      {#if appStore.data.version}
+        <span class="badge badge-primary badge-sm">v{appStore.data.version}</span>
+      {/if}
     </div>
-    <p class="text-base-content/60 text-xs truncate mt-0.5">{appStore.description}</p>
+    {#if appStore.data.description}
+      <p class="text-base-content/60 text-xs truncate mt-0.5">{appStore.data.description}</p>
+    {/if}
   </div>
 
   <div class="text-right shrink-0 flex flex-col items-end gap-1">
-    <span class="text-base-content/70 text-xs font-medium">{appStore.author}</span>
+    {#if appStore.data.author}
+      <span class="text-base-content/70 text-xs font-medium">{appStore.data.author}</span>
+    {/if}
     <div class="flex items-center gap-2 text-xs text-base-content/50">
-      {#if appStore.repository}
-        <a href={appStore.repository} target="_blank" rel="noopener noreferrer" class="link link-hover text-xs">Repo</a>
+      {#if appStore.data.repository}
+        <a href={appStore.data.repository} target="_blank" rel="noopener noreferrer" class="link link-hover text-xs">Repo</a>
       {/if}
-      {#if appStore.homepage}
-        {#if appStore.repository}
+      {#if appStore.data.homepage}
+        {#if appStore.data.repository}
           <span>•</span>
         {/if}
-        <a href={appStore.homepage} target="_blank" rel="noopener noreferrer" class="link link-hover text-xs">Home</a>
+        <a href={appStore.data.homepage} target="_blank" rel="noopener noreferrer" class="link link-hover text-xs">Home</a>
       {/if}
-      {#if appStore.license}
-        {#if appStore.repository || appStore.homepage}
+      {#if appStore.data.license}
+        {#if appStore.data.repository || appStore.data.homepage}
           <span>•</span>
         {/if}
-        <span class="text-xs">{appStore.license}</span>
+        <span class="text-xs">{appStore.data.license}</span>
       {/if}
     </div>
   </div>

package/dist/src/plugins/palettes/settings-modal/route.svelte.js

@@ -26,15 +26,21 @@ export function installSettingsRoute(registry) {
 			if (activeId === "settings") {
 				const want = formatSettingsHash(activeSec);
 				if (globalThis.location.hash !== want) {
-					history.replaceState(null, "", want);
+					if (registry.router?.replaceState) {
+						registry.router.replaceState(want);
+					} else {
+						history.replaceState(null, "", want);
+					}
 				}
 			} else {
 				if (globalThis.location.hash.startsWith("#settings")) {
-					history.pushState(
-						null,
-						"",
-						globalThis.location.pathname + globalThis.location.search,
-					);
+					const targetUrl =
+						globalThis.location.pathname + globalThis.location.search;
+					if (registry.router?.pushState) {
+						registry.router.pushState(targetUrl);
+					} else {
+						history.pushState(null, "", targetUrl);
+					}
 				}
 			}
 		});

package/dist/src/ui/RuneProvider.svelte

@@ -22,13 +22,10 @@ import { type AppData, createAppStore } from "./reactivity/app.svelte.js";
 export interface RuneLabConfig {
 	persistence?: PersistenceDriver;
 	/** Optional head management properties */
-	favicon?: string;
 	manageHead?: boolean;
 	icons?: "material" | "none";
 	/** App metadata — passed to AppStore.init() */
 	app?: Partial<AppData>;
-	/** Namespaced config for plugins */
-	[pluginId: string]: unknown;
 }
 
 let {
@@ -59,11 +56,9 @@ const initialPersistence = untrack(() => {
 // 0. Create and provide the built-in AppStore
 const appStore = createAppStore();
 untrack(() => {
-	const appData = {
-		...config.app,
-		icon: config.app?.icon ?? config.favicon,
-	};
-	appStore.init(appData);
+	if (config.app) {
+		appStore.init(config.app);
+	}
 });
 setContext(RUNE_LAB_CONTEXT.app, appStore);
 
@@ -100,19 +95,23 @@ const allOverlays = $derived(kernel.overlays as Component[]);
 
 // Meta tags derived from app store state
 const metaTags = $derived([
-	{ name: "description", content: appStore.description },
-	{ name: "author", content: appStore.author },
+	{ name: "description", content: appStore.data.description },
+	{ name: "author", content: appStore.data.author },
 ]);
 </script>
 
 <svelte:head>
   {#if config.manageHead !== false && appStore}
-    <title>{appStore.name}</title>
-    {#if config.favicon}
-      <link rel="icon" href={config.favicon} />
+    {#if appStore.data.name}
+      <title>{appStore.data.name}</title>
+    {/if}
+    {#if appStore.data.icon}
+      <link rel="icon" href={appStore.data.icon} />
     {/if}
     {#each metaTags as meta}
-      <meta name={meta.name} content={meta.content} />
+      {#if meta.content}
+        <meta name={meta.name} content={meta.content} />
+      {/if}
     {/each}
     {#if config.icons === "material"}
       <link

package/dist/src/ui/RuneProvider.svelte.d.ts

@@ -12,13 +12,10 @@ import { type AppData } from "./reactivity/app.svelte.js";
 export interface RuneLabConfig {
 	persistence?: PersistenceDriver;
 	/** Optional head management properties */
-	favicon?: string;
 	manageHead?: boolean;
 	icons?: "material" | "none";
 	/** App metadata — passed to AppStore.init() */
 	app?: Partial<AppData>;
-	/** Namespaced config for plugins */
-	[pluginId: string]: unknown;
 }
 type $$ComponentProps = {
 	children: Snippet;

package/dist/src/ui/mod.js

@@ -15,4 +15,4 @@ export { createAppStore, getAppStore } from "./reactivity/app.svelte.js";
 // Reactivity & Context exports
 export { useCell } from "./reactivity/use-cell.svelte.js";
 export { default as SettingsFields } from "./settings/SettingsFields.svelte";
-export const version = () => "0.5.0-rc.2";
+export const version = () => "0.5.0";

package/dist/src/ui/reactivity/app.svelte.d.ts

@@ -1,3 +1,4 @@
+import { type DataStore } from "./data-store.svelte.js";
 export interface AppData {
 	name: string;
 	version: string;
@@ -8,17 +9,6 @@ export interface AppData {
 	homepage?: string;
 	icon?: string;
 }
-export declare class AppStore {
-	#private;
-	name: string;
-	version: string;
-	description: string;
-	author: string;
-	repository: string;
-	license: string;
-	homepage: string;
-	icon: string;
-	init(data: Partial<AppData>): void;
-}
+export type AppStore = DataStore<AppData>;
 export declare function createAppStore(): AppStore;
 export declare function getAppStore(): AppStore;

package/dist/src/ui/reactivity/app.svelte.js

@@ -1,56 +1,19 @@
-import { DEV } from "esm-env";
 import { getContext } from "svelte";
 import { RUNE_LAB_CONTEXT } from "../provider/context.js";
-export class AppStore {
-	name = $state("Rune Lab");
-	version = $state("0.0.1");
-	description = $state("Modern toolkit for Svelte 5 Runes");
-	author = $state("Yrrrrrf");
-	repository = $state("https://github.com/Yrrrrrf/rune-lab");
-	license = $state("MIT");
-	homepage = $state("https://jsr.io/@yrrrrrf/rune-lab");
-	icon = $state("");
-	#initialized = false;
-	init(data) {
-		if (this.#initialized) {
-			if (DEV) {
-				console.warn(
-					"AppStore.init() called multiple times. Ignoring subsequent calls.",
-					"Overwritten properties would have been:",
-					data,
-				);
-			}
-			return;
-		}
-		if (data.name) {
-			this.name = data.name;
-		}
-		if (data.version) {
-			this.version = data.version;
-		}
-		if (data.description) {
-			this.description = data.description;
-		}
-		if (data.author) {
-			this.author = data.author;
-		}
-		if (data.repository) {
-			this.repository = data.repository;
-		}
-		if (data.license) {
-			this.license = data.license;
-		}
-		if (data.homepage) {
-			this.homepage = data.homepage;
-		}
-		if (data.icon) {
-			this.icon = data.icon;
-		}
-		this.#initialized = true;
-	}
-}
+import { createDataStore } from "./data-store.svelte.js";
+
+const APP_DATA_KEYS = [
+	"name",
+	"version",
+	"description",
+	"author",
+	"repository",
+	"license",
+	"homepage",
+	"icon",
+];
 export function createAppStore() {
-	return new AppStore();
+	return createDataStore(APP_DATA_KEYS);
 }
 export function getAppStore() {
 	const store = getContext(RUNE_LAB_CONTEXT.app);

package/dist/src/ui/reactivity/data-store.svelte.d.ts

@@ -0,0 +1,10 @@
+export type NullableData<T> = {
+	[K in keyof T]: T[K] | null;
+};
+export interface DataStore<T extends object> {
+	readonly data: NullableData<T>;
+	init(input?: Partial<T>): void;
+}
+export declare function createDataStore<T extends object>(
+	keys: readonly (keyof T & string)[],
+): DataStore<T>;

package/dist/src/ui/reactivity/data-store.svelte.js

@@ -0,0 +1,35 @@
+import { DEV } from "esm-env";
+export function createDataStore(keys) {
+	const initial = {};
+	for (const k of keys) {
+		initial[k] = null;
+	}
+	const data = $state(initial);
+	let initialized = false;
+	return {
+		get data() {
+			return data;
+		},
+		init(input) {
+			if (initialized) {
+				if (DEV) {
+					console.warn(
+						"DataStore.init() called multiple times. Ignoring subsequent calls.",
+						"Overwritten properties would have been:",
+						input,
+					);
+				}
+				return;
+			}
+			initialized = true;
+			if (input) {
+				for (const k of keys) {
+					const val = input[k];
+					if (val !== undefined && val !== null) {
+						data[k] = val;
+					}
+				}
+			}
+		},
+	};
+}

package/dist/src/ui/settings/SettingsFields.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-import { getContext } from "svelte";
+import { getKernel } from "../provider/context.js";
 import { useCell } from "../reactivity/use-cell.svelte.js";
 
 let {
@@ -12,13 +12,15 @@ let {
   onCommit?: (fieldId: string, value: any) => void;
 } = $props();
 
+const kernel = getKernel();
+
 // Resolve cells reactively using Svelte 5's $derived.by
 const cellBinds = $derived.by(() => {
   const binds = new Map<string, any>();
   for (const field of fields) {
     if (field.target?.type === "cell") {
       try {
-        binds.set(field.id, useCell(field.target.name));
+        binds.set(field.id, useCell(kernel, field.target.name));
       } catch (e) {
         console.warn(
           `[SettingsFields] Failed to bind cell ${field.target.name}:`,
@@ -33,7 +35,8 @@ const cellBinds = $derived.by(() => {
 function getStoreForField(field: any): any {
   if (field.target?.type !== "store") return undefined;
   const pluginId = field.id.slice(0, field.id.lastIndexOf("."));
-  return getContext(Symbol.for(`rl:${pluginId}:${field.target.storeId}`));
+  const storeKey = `rl:${pluginId}:${field.target.storeId}`;
+  return kernel.stores.get(storeKey);
 }
 
 function getValue(field: any): any {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rune-lab",
-	"version": "0.5.0-rc.2",
+	"version": "0.5.0",
 	"description": "A comprehensive full-stack application template with Tauri integration",
 	"readme": "README.md",
 	"license": "MIT",