footprint-explainable-ui 0.3.2 → 0.5.0

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,13 @@
+import type { ThemeTokens } from "./tokens";
+export declare function useFootprintTheme(): ThemeTokens;
+interface FootprintThemeProps {
+    tokens?: ThemeTokens;
+    children: React.ReactNode;
+}
+/**
+ * Optional theme provider — wraps children with CSS custom properties.
+ * Consumers can also just set --fp-* CSS variables directly.
+ */
+export declare function FootprintTheme({ tokens, children }: FootprintThemeProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ThemeProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAW,EAAE,QAAQ,EAAE,EAAE,mBAAmB,2CAU5E"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { tokensToCSSVars } from "./tokens";
+const ThemeContext = createContext({});
+export function useFootprintTheme() {
+    return useContext(ThemeContext);
+}
+/**
+ * Optional theme provider — wraps children with CSS custom properties.
+ * Consumers can also just set --fp-* CSS variables directly.
+ */
+export function FootprintTheme({ tokens = {}, children }) {
+    const cssVars = tokensToCSSVars(tokens);
+    return (_jsx(ThemeContext.Provider, { value: tokens, children: _jsx("div", { style: cssVars, className: "fp-theme-root", children: children }) }));
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,YAAY,GAAG,aAAa,CAAc,EAAE,CAAC,CAAC;AAEpD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,EAAuB;IAC3E,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAExC,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAClC,cAAK,KAAK,EAAE,OAA8B,EAAE,SAAS,EAAC,eAAe,YAClE,QAAQ,GACL,GACgB,CACzB,CAAC;AACJ,CAAC"}

package/dist/theme/index.d.ts

@@ -0,0 +1,7 @@
+export { FootprintTheme, useFootprintTheme } from "./ThemeProvider";
+export { tokensToCSSVars, defaultTokens } from "./tokens";
+export type { ThemeTokens } from "./tokens";
+export { theme, fontSize, padding, v } from "./styles";
+export { themePresets, coolDark, warmDark, warmLight } from "./presets";
+export type { ThemePresetName } from "./presets";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,5 @@
+export { FootprintTheme, useFootprintTheme } from "./ThemeProvider";
+export { tokensToCSSVars, defaultTokens } from "./tokens";
+export { theme, fontSize, padding, v } from "./styles";
+export { themePresets, coolDark, warmDark, warmLight } from "./presets";
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/theme/presets.d.ts

@@ -0,0 +1,15 @@
+import type { ThemeTokens } from "./tokens";
+/** Cool dark theme (the library default) */
+export declare const coolDark: ThemeTokens;
+/** Warm dark theme — charcoal-purple palette */
+export declare const warmDark: ThemeTokens;
+/** Warm light theme — cream/peach palette */
+export declare const warmLight: ThemeTokens;
+/** All built-in theme presets */
+export declare const themePresets: {
+    readonly coolDark: ThemeTokens;
+    readonly warmDark: ThemeTokens;
+    readonly warmLight: ThemeTokens;
+};
+export type ThemePresetName = keyof typeof themePresets;
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,EAAE,WAmBtB,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,QAAQ,EAAE,WAmBtB,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,SAAS,EAAE,WAmBvB,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAC"}

package/dist/theme/presets.js

@@ -0,0 +1,70 @@
+/** Cool dark theme (the library default) */
+export const coolDark = {
+    colors: {
+        primary: "#6366f1",
+        success: "#22c55e",
+        error: "#ef4444",
+        warning: "#f59e0b",
+        bgPrimary: "#0f172a",
+        bgSecondary: "#1e293b",
+        bgTertiary: "#334155",
+        textPrimary: "#f8fafc",
+        textSecondary: "#94a3b8",
+        textMuted: "#64748b",
+        border: "#334155",
+    },
+    radius: "8px",
+    fontFamily: {
+        sans: "Inter, system-ui, -apple-system, sans-serif",
+        mono: "'JetBrains Mono', 'Fira Code', monospace",
+    },
+};
+/** Warm dark theme — charcoal-purple palette */
+export const warmDark = {
+    colors: {
+        primary: "#7c6cf0",
+        success: "#3dd68c",
+        error: "#f06292",
+        warning: "#ffb74d",
+        bgPrimary: "#1e1a2e",
+        bgSecondary: "#2a2540",
+        bgTertiary: "#3a3455",
+        textPrimary: "#f0e6d6",
+        textSecondary: "#a89eb4",
+        textMuted: "#6e6480",
+        border: "#3a3455",
+    },
+    radius: "8px",
+    fontFamily: {
+        sans: "Inter, system-ui, -apple-system, sans-serif",
+        mono: "'JetBrains Mono', 'Fira Code', monospace",
+    },
+};
+/** Warm light theme — cream/peach palette */
+export const warmLight = {
+    colors: {
+        primary: "#7c6cf0",
+        success: "#22a860",
+        error: "#d94452",
+        warning: "#e09030",
+        bgPrimary: "#faf5ef",
+        bgSecondary: "#f0e6d6",
+        bgTertiary: "#e4d5c3",
+        textPrimary: "#2e2938",
+        textSecondary: "#5c5468",
+        textMuted: "#8a7e96",
+        border: "#d6c8b4",
+    },
+    radius: "8px",
+    fontFamily: {
+        sans: "Inter, system-ui, -apple-system, sans-serif",
+        mono: "'JetBrains Mono', 'Fira Code', monospace",
+    },
+};
+/** All built-in theme presets */
+export const themePresets = {
+    coolDark,
+    warmDark,
+    warmLight,
+};
+//# sourceMappingURL=presets.js.map

package/dist/theme/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,MAAM,EAAE,KAAK;IACb,UAAU,EAAE;QACV,IAAI,EAAE,6CAA6C;QACnD,IAAI,EAAE,0CAA0C;KACjD;CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,MAAM,EAAE,KAAK;IACb,UAAU,EAAE;QACV,IAAI,EAAE,6CAA6C;QACnD,IAAI,EAAE,0CAA0C;KACjD;CACF,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAgB;IACpC,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,MAAM,EAAE,KAAK;IACb,UAAU,EAAE;QACV,IAAI,EAAE,6CAA6C;QACnD,IAAI,EAAE,0CAA0C;KACjD;CACF,CAAC;AAEF,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,QAAQ;IACR,SAAS;CACD,CAAC"}

package/dist/theme/styles.d.ts

@@ -0,0 +1,32 @@
+import type { Size } from "../types";
+/**
+ * Helper to resolve a CSS variable with a fallback.
+ * Usage: v("--fp-color-primary", "#6366f1")
+ */
+export declare function v(varName: string, fallback: string): string;
+/** Shorthand for common theme variables */
+export declare const theme: {
+    readonly primary: string;
+    readonly success: string;
+    readonly error: string;
+    readonly warning: string;
+    readonly bgPrimary: string;
+    readonly bgSecondary: string;
+    readonly bgTertiary: string;
+    readonly textPrimary: string;
+    readonly textSecondary: string;
+    readonly textMuted: string;
+    readonly border: string;
+    readonly radius: string;
+    readonly fontSans: string;
+    readonly fontMono: string;
+};
+/** Font sizes per size variant */
+export declare const fontSize: Record<Size, {
+    label: number;
+    body: number;
+    small: number;
+}>;
+/** Padding per size variant */
+export declare const padding: Record<Size, number>;
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/theme/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC;;;GAGG;AACH,wBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,2CAA2C;AAC3C,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;CAeR,CAAC;AAEX,kCAAkC;AAClC,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIjF,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIxC,CAAC"}

package/dist/theme/styles.js

@@ -0,0 +1,37 @@
+/**
+ * Helper to resolve a CSS variable with a fallback.
+ * Usage: v("--fp-color-primary", "#6366f1")
+ */
+export function v(varName, fallback) {
+    return `var(${varName}, ${fallback})`;
+}
+/** Shorthand for common theme variables */
+export const theme = {
+    primary: v("--fp-color-primary", "#6366f1"),
+    success: v("--fp-color-success", "#22c55e"),
+    error: v("--fp-color-error", "#ef4444"),
+    warning: v("--fp-color-warning", "#f59e0b"),
+    bgPrimary: v("--fp-bg-primary", "#0f172a"),
+    bgSecondary: v("--fp-bg-secondary", "#1e293b"),
+    bgTertiary: v("--fp-bg-tertiary", "#334155"),
+    textPrimary: v("--fp-text-primary", "#f8fafc"),
+    textSecondary: v("--fp-text-secondary", "#94a3b8"),
+    textMuted: v("--fp-text-muted", "#64748b"),
+    border: v("--fp-border", "#334155"),
+    radius: v("--fp-radius", "8px"),
+    fontSans: v("--fp-font-sans", "Inter, system-ui, -apple-system, sans-serif"),
+    fontMono: v("--fp-font-mono", "'JetBrains Mono', 'Fira Code', monospace"),
+};
+/** Font sizes per size variant */
+export const fontSize = {
+    compact: { label: 10, body: 11, small: 9 },
+    default: { label: 11, body: 12, small: 10 },
+    detailed: { label: 12, body: 13, small: 11 },
+};
+/** Padding per size variant */
+export const padding = {
+    compact: 8,
+    default: 12,
+    detailed: 16,
+};
+//# sourceMappingURL=styles.js.map

package/dist/theme/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/theme/styles.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,CAAC,CAAC,OAAe,EAAE,QAAgB;IACjD,OAAO,OAAO,OAAO,KAAK,QAAQ,GAAG,CAAC;AACxC,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,kBAAkB,EAAE,SAAS,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,oBAAoB,EAAE,SAAS,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,kBAAkB,EAAE,SAAS,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,qBAAqB,EAAE,SAAS,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,gBAAgB,EAAE,6CAA6C,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,gBAAgB,EAAE,0CAA0C,CAAC;CACjE,CAAC;AAEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAiE;IACpF,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;IAC1C,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3C,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CAC7C,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,OAAO,GAAyB;IAC3C,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;CACb,CAAC"}

package/dist/theme/tokens.d.ts

@@ -0,0 +1,28 @@
+/** Default theme tokens — consumers override via CSS variables or ThemeProvider. */
+export interface ThemeTokens {
+    colors?: {
+        primary?: string;
+        success?: string;
+        error?: string;
+        warning?: string;
+        bgPrimary?: string;
+        bgSecondary?: string;
+        bgTertiary?: string;
+        textPrimary?: string;
+        textSecondary?: string;
+        textMuted?: string;
+        border?: string;
+    };
+    radius?: string;
+    fontFamily?: {
+        sans?: string;
+        mono?: string;
+    };
+}
+/** Maps ThemeTokens to CSS custom property assignments. */
+export declare function tokensToCSSVars(tokens: ThemeTokens): Record<string, string>;
+/** Default dark theme values (used as CSS variable fallbacks). */
+export declare const defaultTokens: Required<{
+    [K in keyof ThemeTokens]-?: Required<ThemeTokens[K]>;
+}>;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB3E;AAED,kEAAkE;AAClE,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC;KAClC,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CACrD,CAmBA,CAAC"}

package/dist/theme/tokens.js

@@ -0,0 +1,58 @@
+/** Maps ThemeTokens to CSS custom property assignments. */
+export function tokensToCSSVars(tokens) {
+    const vars = {};
+    if (tokens.colors) {
+        const c = tokens.colors;
+        if (c.primary)
+            vars["--fp-color-primary"] = c.primary;
+        if (c.success)
+            vars["--fp-color-success"] = c.success;
+        if (c.error)
+            vars["--fp-color-error"] = c.error;
+        if (c.warning)
+            vars["--fp-color-warning"] = c.warning;
+        if (c.bgPrimary)
+            vars["--fp-bg-primary"] = c.bgPrimary;
+        if (c.bgSecondary)
+            vars["--fp-bg-secondary"] = c.bgSecondary;
+        if (c.bgTertiary)
+            vars["--fp-bg-tertiary"] = c.bgTertiary;
+        if (c.textPrimary)
+            vars["--fp-text-primary"] = c.textPrimary;
+        if (c.textSecondary)
+            vars["--fp-text-secondary"] = c.textSecondary;
+        if (c.textMuted)
+            vars["--fp-text-muted"] = c.textMuted;
+        if (c.border)
+            vars["--fp-border"] = c.border;
+    }
+    if (tokens.radius)
+        vars["--fp-radius"] = tokens.radius;
+    if (tokens.fontFamily?.sans)
+        vars["--fp-font-sans"] = tokens.fontFamily.sans;
+    if (tokens.fontFamily?.mono)
+        vars["--fp-font-mono"] = tokens.fontFamily.mono;
+    return vars;
+}
+/** Default dark theme values (used as CSS variable fallbacks). */
+export const defaultTokens = {
+    colors: {
+        primary: "#6366f1",
+        success: "#22c55e",
+        error: "#ef4444",
+        warning: "#f59e0b",
+        bgPrimary: "#0f172a",
+        bgSecondary: "#1e293b",
+        bgTertiary: "#334155",
+        textPrimary: "#f8fafc",
+        textSecondary: "#94a3b8",
+        textMuted: "#64748b",
+        border: "#334155",
+    },
+    radius: "8px",
+    fontFamily: {
+        sans: "Inter, system-ui, -apple-system, sans-serif",
+        mono: "'JetBrains Mono', 'Fira Code', monospace",
+    },
+};
+//# sourceMappingURL=tokens.js.map

package/dist/theme/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAsBA,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,CAAC,OAAO;YAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACtD,IAAI,CAAC,CAAC,OAAO;YAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACtD,IAAI,CAAC,CAAC,KAAK;YAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QAChD,IAAI,CAAC,CAAC,OAAO;YAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACtD,IAAI,CAAC,CAAC,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;QACvD,IAAI,CAAC,CAAC,WAAW;YAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAC7D,IAAI,CAAC,CAAC,UAAU;YAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QAC1D,IAAI,CAAC,CAAC,WAAW;YAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAC7D,IAAI,CAAC,CAAC,aAAa;YAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;QACnE,IAAI,CAAC,CAAC,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;QACvD,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACvD,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI;QAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;IAC7E,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI;QAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;IAC7E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAErB;IACH,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;KAClB;IACD,MAAM,EAAE,KAAK;IACb,UAAU,EAAE;QACV,IAAI,EAAE,6CAA6C;QACnD,IAAI,EAAE,0CAA0C;KACjD;CACF,CAAC"}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/flowchart.ts","../src/index.ts","../src/types.ts","../src/adapters/fromruntimesnapshot.ts","../src/components/explainableshell/explainableshell.tsx","../src/components/explainableshell/index.ts","../src/components/flowchartview/flowchartview.tsx","../src/components/flowchartview/subflowbreadcrumb.tsx","../src/components/flowchartview/subflowtree.tsx","../src/components/flowchartview/tracedflowchartview.tsx","../src/components/flowchartview/index.ts","../src/components/flowchartview/spectoreactflow.ts","../src/components/flowchartview/usesubflownavigation.ts","../src/components/gantttimeline/gantttimeline.tsx","../src/components/gantttimeline/index.ts","../src/components/memoryinspector/memoryinspector.tsx","../src/components/memoryinspector/index.ts","../src/components/narrativelog/narrativelog.tsx","../src/components/narrativelog/index.ts","../src/components/narrativetrace/narrativetrace.tsx","../src/components/narrativetrace/index.ts","../src/components/resultpanel/resultpanel.tsx","../src/components/resultpanel/index.ts","../src/components/scopediff/scopediff.tsx","../src/components/scopediff/index.ts","../src/components/snapshotpanel/snapshotpanel.tsx","../src/components/snapshotpanel/index.ts","../src/components/stagenode/stagenode.tsx","../src/components/stagenode/index.ts","../src/components/timetravelcontrols/timetravelcontrols.tsx","../src/components/timetravelcontrols/index.ts","../src/components/timetraveldebugger/timetraveldebugger.tsx","../src/components/timetraveldebugger/index.ts","../src/theme/themeprovider.tsx","../src/theme/index.ts","../src/theme/presets.ts","../src/theme/styles.ts","../src/theme/tokens.ts"],"version":"5.9.3"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+/** Snapshot of a single pipeline stage — the core data shape for all components. */
+export interface StageSnapshot {
+    /** Internal stage identifier */
+    stageName: string;
+    /** Human-readable label */
+    stageLabel: string;
+    /** Accumulated memory state after this stage ran */
+    memory: Record<string, unknown>;
+    /** Narrative text describing what happened */
+    narrative: string;
+    /** When this stage started (ms from pipeline start) */
+    startMs: number;
+    /** How long this stage took (ms) */
+    durationMs: number;
+    /** Execution status */
+    status?: "pending" | "active" | "done" | "error";
+    /** Human-readable description of what this stage does */
+    description?: string;
+    /** Subflow identifier (when this stage is inside a subflow) */
+    subflowId?: string;
+}
+/** Component size variants */
+export type Size = "compact" | "default" | "detailed";
+/** Common props shared by all visualization components */
+export interface BaseComponentProps {
+    /** Size variant */
+    size?: Size;
+    /** Strip all built-in styles — bring your own */
+    unstyled?: boolean;
+    /** Additional CSS class name */
+    className?: string;
+    /** Inline style overrides */
+    style?: React.CSSProperties;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8BAA8B;AAC9B,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "footprint-explainable-ui",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Themeable React components for visualizing FootPrint pipeline execution",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,7 +26,12 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "release:patch": "bash scripts/release.sh patch",
+    "release:minor": "bash scripts/release.sh minor",
+    "release:major": "bash scripts/release.sh major"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -40,11 +45,12 @@
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@xyflow/react": "^12.10.1",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "@xyflow/react": "^12.10.1",
     "tsup": "^8.4.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "vitest": "^4.1.0"
   },
   "license": "MIT",
   "repository": {