@panoboard/core 1.2.0 → 1.8.0

package/dist/theme/colors.d.ts

@@ -0,0 +1,11 @@
+import type { Theme } from "../schemas/theme";
+/**
+ * Convert a hex color string to an "R, G, B" string for use in rgba().
+ */
+export declare function hexToRgb(hex: string): string;
+/**
+ * Generate a flat record of CSS custom property name → value from a Theme.
+ * Each hex color gets both a direct value and an -rgb variant.
+ */
+export declare function themeToVars(theme: Theme): Record<string, string>;
+//# sourceMappingURL=colors.d.ts.map

package/dist/theme/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/theme/colors.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkDhE"}

package/dist/theme/colors.js

@@ -0,0 +1,71 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * Convert a hex color string to an "R, G, B" string for use in rgba().
+ */
+export function hexToRgb(hex) {
+    let h = hex.replace("#", "");
+    if (h.length === 3) {
+        h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+    }
+    const n = parseInt(h, 16);
+    return `${(n >> 16) & 255}, ${(n >> 8) & 255}, ${n & 255}`;
+}
+/**
+ * Generate a flat record of CSS custom property name → value from a Theme.
+ * Each hex color gets both a direct value and an -rgb variant.
+ */
+export function themeToVars(theme) {
+    const vars = {};
+    function set(name, hex) {
+        vars[name] = hex;
+        vars[`${name}-rgb`] = hexToRgb(hex);
+    }
+    // Top-level
+    set("--primary", theme.primary);
+    set("--primary-hover", theme.primaryHover);
+    // Surfaces
+    set("--surface-page", theme.surfaces.page);
+    set("--surface-header", theme.surfaces.header);
+    set("--surface-overlay", theme.surfaces.overlay);
+    set("--surface-overlay-border", theme.surfaces.overlayBorder);
+    // Panel
+    set("--panel-surface", theme.panel.surface);
+    set("--panel-border", theme.panel.border);
+    set("--panel-header", theme.panel.header);
+    set("--panel-title", theme.panel.title);
+    // Typography
+    set("--text-title", theme.typography.title);
+    set("--text-label", theme.typography.label);
+    set("--text-value", theme.typography.value);
+    set("--text-muted", theme.typography.muted);
+    set("--text-link", theme.typography.link);
+    // Filters
+    set("--filter-bg", theme.filters.background);
+    set("--filter-border", theme.filters.border);
+    set("--filter-text", theme.filters.text);
+    set("--filter-placeholder", theme.filters.placeholder);
+    set("--filter-focus", theme.filters.focus);
+    // Status
+    set("--status-positive", theme.status.positive);
+    set("--status-negative", theme.status.negative);
+    set("--status-warning", theme.status.warning);
+    set("--status-neutral", theme.status.neutral);
+    // Palette
+    theme.palette.forEach((color, i) => {
+        vars[`--palette-${i}`] = color;
+    });
+    return vars;
+}
+//# sourceMappingURL=colors.js.map

package/dist/theme/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/theme/colors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAIjC;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,IAAI,GAA2B,EAAE,CAAC;IAExC,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACjB,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,YAAY;IACZ,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAE3C,WAAW;IACX,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3C,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,0BAA0B,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAE9D,QAAQ;IACR,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAExC,aAAa;IACb,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAE1C,UAAU;IACV,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3C,SAAS;IACT,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE9C,UAAU;IACV,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACjC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/theme/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/theme/context.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,2CAIA;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAIhC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/theme/context.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAiB9C,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,2CASA;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAIhC"}

package/dist/theme/context.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Copyright 2026 Mataki Labs LLC
 //
 // Licensed under the Business Source License 1.1 (the "License");
@@ -12,10 +12,23 @@ import { jsx as _jsx } from "react/jsx-runtime";
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-import { createContext, useContext } from "react";
+import { createContext, useContext, useMemo } from "react";
+import { themeToVars } from "./colors";
 const ThemeContext = createContext(null);
+/**
+ * Build a CSS string of custom properties from the theme.
+ * This is safe to inject via a <style> tag — all values are
+ * Zod-validated hex colors from the theme schema.
+ */
+function buildCssVarBlock(theme) {
+    const vars = themeToVars(theme);
+    return Object.entries(vars)
+        .map(([k, v]) => `${k}:${v}`)
+        .join(";");
+}
 export function ThemeProvider({ theme, children, }) {
-    return (_jsx(ThemeContext.Provider, { value: theme, children: children }));
+    const cssBlock = useMemo(() => buildCssVarBlock(theme), [theme]);
+    return (_jsxs(ThemeContext.Provider, { value: theme, children: [_jsx("style", { children: `:root{${cssBlock}}` }), children] }));
 }
 export function useTheme() {
     const theme = useContext(ThemeContext);

package/dist/theme/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/theme/context.tsx"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,YAAY,GAAG,aAAa,CAAe,IAAI,CAAC,CAAC;AAEvD,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/theme/context.tsx"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,YAAY,GAAG,aAAa,CAAe,IAAI,CAAC,CAAC;AAEvD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAY;IACpC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GAIT;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjE,OAAO,CACL,MAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,aACjC,0BAAQ,SAAS,QAAQ,GAAG,GAAS,EACpC,QAAQ,IACa,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/theme/loader-export.d.ts

@@ -1,2 +1,2 @@
-export { loadTheme, getAvailableThemes, setThemesDir } from "./loader";
+export { loadTheme, getAvailableThemes, setThemesDir, setBundledThemes } from "./loader";
 //# sourceMappingURL=loader-export.d.ts.map

package/dist/theme/loader-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-export.d.ts","sourceRoot":"","sources":["../../src/theme/loader-export.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"loader-export.d.ts","sourceRoot":"","sources":["../../src/theme/loader-export.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/theme/loader-export.js

@@ -11,5 +11,5 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-export { loadTheme, getAvailableThemes, setThemesDir } from "./loader";
+export { loadTheme, getAvailableThemes, setThemesDir, setBundledThemes } from "./loader";
 //# sourceMappingURL=loader-export.js.map

package/dist/theme/loader-export.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader-export.js","sourceRoot":"","sources":["../../src/theme/loader-export.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"loader-export.js","sourceRoot":"","sources":["../../src/theme/loader-export.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/theme/loader.d.ts

@@ -1,11 +1,16 @@
 import { type Theme } from "../schemas/theme";
+/**
+ * Register bundled themes (from @panoboard/themes or similar).
+ * Lower priority than custom themes from disk.
+ */
+export declare function setBundledThemes(themes: Record<string, Theme>): void;
 /**
  * Set the directory to scan for custom theme YAML files.
- * Call this at startup before loading themes.
+ * Custom themes override bundled and built-in themes.
  */
 export declare function setThemesDir(dir: string): void;
-/** List all available theme names (built-in + custom). */
+/** List all available theme names (built-in + bundled + custom). */
 export declare function getAvailableThemes(): string[];
-/** Load a theme by name. Custom themes override built-ins. */
+/** Load a theme by name. Custom > bundled > built-in. */
 export declare function loadTheme(themeName: string): Theme;
 //# sourceMappingURL=loader.d.ts.map

package/dist/theme/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/theme/loader.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAM3D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB9C;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAM7C;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CASlD"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/theme/loader.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAwB3D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,CAEpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAO7C;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAUlD"}

package/dist/theme/loader.js

@@ -16,41 +16,52 @@ import path from "path";
 import { parse } from "yaml";
 import { themeSchema } from "../schemas/theme";
 import { builtinThemes } from "./builtin";
-let _customThemesDir = null;
+let _bundledThemes = {};
 let customThemes = {};
-/**
- * Set the directory to scan for custom theme YAML files.
- * Call this at startup before loading themes.
- */
-export function setThemesDir(dir) {
-    _customThemesDir = dir;
-    customThemes = {};
+function loadThemesFromDir(dir) {
+    const themes = {};
     if (!existsSync(dir))
-        return;
+        return themes;
     for (const file of readdirSync(dir)) {
         if (!file.endsWith(".yaml"))
             continue;
         const name = file.replace(/\.yaml$/, "");
         try {
             const content = readFileSync(path.join(dir, file), "utf-8");
-            customThemes[name] = themeSchema.parse(parse(content));
+            themes[name] = themeSchema.parse(parse(content));
         }
         catch {
             console.warn(`Warning: failed to load theme '${name}' from ${dir}/${file}`);
         }
     }
+    return themes;
+}
+/**
+ * Register bundled themes (from @panoboard/themes or similar).
+ * Lower priority than custom themes from disk.
+ */
+export function setBundledThemes(themes) {
+    _bundledThemes = themes;
+}
+/**
+ * Set the directory to scan for custom theme YAML files.
+ * Custom themes override bundled and built-in themes.
+ */
+export function setThemesDir(dir) {
+    customThemes = loadThemesFromDir(dir);
 }
-/** List all available theme names (built-in + custom). */
+/** List all available theme names (built-in + bundled + custom). */
 export function getAvailableThemes() {
     const names = new Set([
         ...Object.keys(builtinThemes),
+        ...Object.keys(_bundledThemes),
         ...Object.keys(customThemes),
     ]);
     return [...names].sort();
 }
-/** Load a theme by name. Custom themes override built-ins. */
+/** Load a theme by name. Custom > bundled > built-in. */
 export function loadTheme(themeName) {
-    const theme = customThemes[themeName] ?? builtinThemes[themeName];
+    const theme = customThemes[themeName] ?? _bundledThemes[themeName] ?? builtinThemes[themeName];
     if (!theme) {
         const available = getAvailableThemes().join(", ");
         throw new Error(`Theme '${themeName}' not found. Available themes: ${available}`);

package/dist/theme/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/theme/loader.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAC3C,IAAI,YAAY,GAA0B,EAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,gBAAgB,GAAG,GAAG,CAAC;IACvB,YAAY,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5D,YAAY,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACV,kCAAkC,IAAI,UAAU,GAAG,IAAI,IAAI,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;QACpB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7B,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,kCAAkC,SAAS,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/theme/loader.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,IAAI,cAAc,GAA0B,EAAE,CAAC;AAC/C,IAAI,YAAY,GAA0B,EAAE,CAAC;AAE7C,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACV,kCAAkC,IAAI,UAAU,GAAG,IAAI,IAAI,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,cAAc,GAAG,MAAM,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;QACpB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7B,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9B,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,KAAK,GACT,YAAY,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,kCAAkC,SAAS,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/transforms/computed.d.ts

@@ -0,0 +1,11 @@
+import type { ColumnMeta } from "../connectors/types";
+import type { Transform } from "../schemas/transforms";
+type ComputedConfig = Extract<Transform, {
+    type: "computed";
+}>;
+export declare function applyComputed(rows: Record<string, unknown>[], columns: ColumnMeta[], config: ComputedConfig): {
+    rows: Record<string, unknown>[];
+    columns: ColumnMeta[];
+};
+export {};
+//# sourceMappingURL=computed.d.ts.map

package/dist/transforms/computed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/transforms/computed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,KAAK,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAQ/D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,cAAc,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAkB5D"}

package/dist/transforms/computed.js

@@ -0,0 +1,24 @@
+import { evaluate } from "./expression";
+function inferColumnType(value) {
+    if (typeof value === "boolean")
+        return "boolean";
+    if (typeof value === "string")
+        return "string";
+    return "number";
+}
+export function applyComputed(rows, columns, config) {
+    const { field, expression } = config;
+    const newRows = rows.map((row) => {
+        const value = evaluate(expression, row);
+        return { ...row, [field]: value };
+    });
+    // Infer type from first row's computed value (or default to number)
+    const sampleValue = newRows.length > 0 ? newRows[0][field] : 0;
+    const colType = inferColumnType(sampleValue);
+    const newColumns = [
+        ...columns,
+        { name: field, type: colType, nullable: true },
+    ];
+    return { rows: newRows, columns: newColumns };
+}
+//# sourceMappingURL=computed.js.map

package/dist/transforms/computed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../src/transforms/computed.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIxC,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAA+B,EAC/B,OAAqB,EACrB,MAAsB;IAEtB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAErC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAiB;QAC/B,GAAG,OAAO;QACV,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/C,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAChD,CAAC"}

package/dist/transforms/engine.d.ts

@@ -0,0 +1,17 @@
+import type { QueryResult } from "../connectors/types";
+import type { Transform } from "../schemas/transforms";
+export interface TransformError {
+    transform: string;
+    index: number;
+    message: string;
+}
+export interface TransformResult extends QueryResult {
+    error?: TransformError;
+}
+/**
+ * Apply a pipeline of transforms to a QueryResult.
+ * Transforms execute in declared order. On error, the pipeline stops and
+ * returns the result as it was before the failing transform, plus an error descriptor.
+ */
+export declare function applyTransforms(result: QueryResult, transforms: Transform[]): TransformResult;
+//# sourceMappingURL=engine.d.ts.map

package/dist/transforms/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/transforms/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAuBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,SAAS,EAAE,GACtB,eAAe,CA+CjB"}

package/dist/transforms/engine.js

@@ -0,0 +1,65 @@
+import { applyComputed } from "./computed";
+import { applyRename } from "./rename";
+import { applySort } from "./sort";
+import { applyLimit } from "./limit";
+import { applyPercentage } from "./percentage";
+import { applyFilter } from "./filter";
+const handlers = {
+    computed: (rows, columns, config) => applyComputed(rows, columns, config),
+    rename: (rows, columns, config) => applyRename(rows, columns, config),
+    sort: (rows, columns, config) => applySort(rows, columns, config),
+    limit: (rows, columns, config) => applyLimit(rows, columns, config),
+    percentage: (rows, columns, config) => applyPercentage(rows, columns, config),
+    filter: (rows, columns, config) => applyFilter(rows, columns, config),
+};
+/**
+ * Apply a pipeline of transforms to a QueryResult.
+ * Transforms execute in declared order. On error, the pipeline stops and
+ * returns the result as it was before the failing transform, plus an error descriptor.
+ */
+export function applyTransforms(result, transforms) {
+    let rows = result.rows;
+    let columns = result.columns;
+    for (let i = 0; i < transforms.length; i++) {
+        const transform = transforms[i];
+        const handler = handlers[transform.type];
+        if (!handler) {
+            return {
+                ...result,
+                rows,
+                columns,
+                rowCount: rows.length,
+                error: {
+                    transform: transform.type,
+                    index: i,
+                    message: `Unknown transform type '${transform.type}'`,
+                },
+            };
+        }
+        try {
+            const output = handler(rows, columns, transform);
+            rows = output.rows;
+            columns = output.columns;
+        }
+        catch (err) {
+            return {
+                ...result,
+                rows,
+                columns,
+                rowCount: rows.length,
+                error: {
+                    transform: transform.type,
+                    index: i,
+                    message: err.message,
+                },
+            };
+        }
+    }
+    return {
+        ...result,
+        rows,
+        columns,
+        rowCount: rows.length,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/transforms/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/transforms/engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBvC,MAAM,QAAQ,GAAgC;IAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAClC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAkD,CAAC;IAClF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAChC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAgD,CAAC;IAC9E,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAC9B,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAA8C,CAAC;IAC1E,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAA+C,CAAC;IAC5E,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CACpC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAoD,CAAC;IACtF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAChC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAgD,CAAC;CAC/E,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,UAAuB;IAEvB,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACvB,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI;gBACJ,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,MAAM;gBACrB,KAAK,EAAE;oBACL,SAAS,EAAE,SAAS,CAAC,IAAI;oBACzB,KAAK,EAAE,CAAC;oBACR,OAAO,EAAE,2BAA2B,SAAS,CAAC,IAAI,GAAG;iBACtD;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YACjD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI;gBACJ,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,MAAM;gBACrB,KAAK,EAAE;oBACL,SAAS,EAAE,SAAS,CAAC,IAAI;oBACzB,KAAK,EAAE,CAAC;oBACR,OAAO,EAAG,GAAa,CAAC,OAAO;iBAChC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/transforms/expression.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Evaluate an expression string against a row of data.
+ *
+ * @param expression - The expression to evaluate (e.g. "value / total * 100")
+ * @param row - The current row data (field names map to values)
+ * @returns The evaluated result (number, boolean, or string)
+ */
+export declare function evaluate(expression: string, row: Record<string, unknown>): unknown;
+//# sourceMappingURL=expression.d.ts.map

package/dist/transforms/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/transforms/expression.ts"],"names":[],"mappings":"AA8VA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAIT"}