@furystack/shades-common-components 11.0.0 → 12.0.1

package/esm/services/theme-provider-service.d.ts

@@ -78,8 +78,222 @@ export interface Background {
     paper: Color;
 }
 /**
- * Complete theme definition containing all color tokens for the application.
+ * Interactive state colors for hover, selection, focus and overlay backgrounds.
+ */
+export type ActionColors = {
+    /** Background color on hover for interactive elements */
+    hoverBackground: Color;
+    /** Background color for selected/checked elements */
+    selectedBackground: Color;
+    /** Background color for actively pressed elements */
+    activeBackground: Color;
+    /** Box-shadow value for focus ring indicators */
+    focusRing: string;
+    /** Opacity value for disabled elements (e.g. '0.6') */
+    disabledOpacity: string;
+    /** Overlay background color for backdrops (drawers, modals) */
+    backdrop: Color;
+    /** Subtle border color for structural dividers, input borders, and dropdown outlines */
+    subtleBorder: Color;
+};
+/**
+ * Border radius scale for consistent rounded corners.
+ */
+export type BorderRadiusScale = {
+    /** 2px - grid cells, small elements */
+    xs: string;
+    /** 4px - badges, compact items */
+    sm: string;
+    /** 8px - buttons, paper, inputs, cards */
+    md: string;
+    /** 12px - suggest, command palette */
+    lg: string;
+    /** 50% - circular elements (avatar, FAB, loader) */
+    full: string;
+};
+/**
+ * Shape tokens for geometric properties.
+ */
+export type Shape = {
+    /** Border radius scale */
+    borderRadius: BorderRadiusScale;
+};
+/**
+ * Elevation shadow presets from subtle to prominent.
+ */
+export type Shadows = {
+    /** No shadow */
+    none: string;
+    /** Subtle shadow (paper elevation 1, notifications) */
+    sm: string;
+    /** Medium shadow (paper elevation 2, context-menu, dropdowns) */
+    md: string;
+    /** Large shadow (paper elevation 3, modals, overlays) */
+    lg: string;
+    /** Extra large shadow (floating elements like FAB, avatar hover) */
+    xl: string;
+};
+/**
+ * Font size scale for consistent text sizing.
+ */
+export type FontSizeScale = {
+    /** 11px - labels, helper text */
+    xs: string;
+    /** 13px - small body, secondary text */
+    sm: string;
+    /** 14px - body text, buttons */
+    md: string;
+    /** 16px - large body, icons */
+    lg: string;
+    /** 24px - page headings */
+    xl: string;
+};
+/**
+ * Font weight scale.
+ */
+export type FontWeightScale = {
+    /** 400 - normal weight */
+    normal: string;
+    /** 500 - medium weight */
+    medium: string;
+    /** 600 - semibold weight */
+    semibold: string;
+    /** 700 - bold weight */
+    bold: string;
+};
+/**
+ * Line height scale.
+ */
+export type LineHeightScale = {
+    /** 1.3 - headings, compact text */
+    tight: string;
+    /** 1.5 - standard body text */
+    normal: string;
+    /** 1.75 - relaxed spacing */
+    relaxed: string;
+};
+/**
+ * Letter spacing scale for consistent character spacing.
+ */
+export type LetterSpacingScale = {
+    /** -0.5px - tight spacing for large display text */
+    tight: string;
+    /** -0.25px - slightly tight spacing for headings */
+    dense: string;
+    /** 0px - default spacing */
+    normal: string;
+    /** 0.15px - slightly wider for body text */
+    wide: string;
+    /** 0.5px - wider for buttons and labels */
+    wider: string;
+    /** 1.5px - widest for overline/caption text */
+    widest: string;
+};
+/**
+ * Typography tokens for text styling.
+ */
+export type ThemeTypography = {
+    /** Base font family stack */
+    fontFamily: string;
+    /** Font size scale */
+    fontSize: FontSizeScale;
+    /** Font weight scale */
+    fontWeight: FontWeightScale;
+    /** Line height scale */
+    lineHeight: LineHeightScale;
+    /** Letter spacing scale */
+    letterSpacing?: LetterSpacingScale;
+};
+/**
+ * Transition duration presets.
+ */
+export type TransitionDurations = {
+    /** 150ms - micro-interactions (hover, active states) */
+    fast: string;
+    /** 200ms - default transitions */
+    normal: string;
+    /** 300ms - layout changes, drawers */
+    slow: string;
+};
+/**
+ * Transition easing presets.
+ */
+export type TransitionEasings = {
+    /** Standard Material easing - cubic-bezier(0.4, 0, 0.2, 1) */
+    default: string;
+    /** Decelerate easing - cubic-bezier(0.23, 1.0, 0.32, 1.0) */
+    easeOut: string;
+    /** Symmetric easing - ease-in-out */
+    easeInOut: string;
+};
+/**
+ * Transition timing tokens for animations and state changes.
+ */
+export type Transitions = {
+    /** Duration presets */
+    duration: TransitionDurations;
+    /** Easing function presets */
+    easing: TransitionEasings;
+};
+/**
+ * Spacing scale for consistent padding, margins and gaps.
+ */
+export type Spacing = {
+    /** 4px */
+    xs: string;
+    /** 8px */
+    sm: string;
+    /** 16px */
+    md: string;
+    /** 24px */
+    lg: string;
+    /** 32px */
+    xl: string;
+};
+/**
+ * Z-index layer scale for consistent stacking context.
+ */
+export type ZIndex = {
+    /** 1000 - drawers and sidebar panels */
+    drawer: string;
+    /** 1100 - app bars and sticky headers */
+    appBar: string;
+    /** 1200 - modals and dialogs */
+    modal: string;
+    /** 1300 - tooltips and popovers */
+    tooltip: string;
+    /** 1400 - dropdowns and context menus */
+    dropdown: string;
+};
+/**
+ * Visual effect tokens for blur and backdrop effects.
+ */
+export type Effects = {
+    /** 4px - subtle blur for glassy surfaces */
+    blurSm: string;
+    /** 8px - medium blur for overlays */
+    blurMd: string;
+    /** 15px - strong blur for app bar / prominent overlays */
+    blurLg: string;
+    /** 20px - heavy blur for command palette / suggestion lists */
+    blurXl: string;
+};
+/**
+ * Complete theme definition containing all design tokens for the application.
  * Themes can be switched at runtime to support light/dark modes or custom branding.
+ *
+ * **Future extension — Component size variants:**
+ * When introducing size variants for form controls (e.g. sm/md/lg Button, Input),
+ * add a `componentDefaults` section to this interface:
+ *
+ * ```typescript
+ * type ComponentSize = 'sm' | 'md' | 'lg'
+ * type SizeTokens = { height: string; padding: string; fontSize: string; borderRadius: string; iconSize: string }
+ * componentDefaults: { size: Record<ComponentSize, SizeTokens> }
+ * ```
+ *
+ * The existing `typography.fontSize` and `shape.borderRadius` scales provide
+ * the building blocks that size tokens should reference.
  */
 export interface Theme {
     /** Unique identifier for the theme */
@@ -94,6 +308,22 @@ export interface Theme {
     background: Background;
     /** Color for dividers and borders */
     divider: Color;
+    /** Interactive state colors */
+    action: ActionColors;
+    /** Shape tokens (border radius) */
+    shape: Shape;
+    /** Elevation shadow presets */
+    shadows: Shadows;
+    /** Typography scale (font sizes, weights, line heights, letter spacing) */
+    typography: ThemeTypography;
+    /** Transition timing tokens */
+    transitions: Transitions;
+    /** Spacing scale */
+    spacing: Spacing;
+    /** Z-index stacking layers */
+    zIndex?: ZIndex;
+    /** Visual effect tokens (blur, backdrop) */
+    effects?: Effects;
 }
 export declare class RgbColor {
     r: number;
@@ -124,7 +354,162 @@ export declare class ThemeProviderService extends EventHub<{
      * @returns The parsed R,G,B, A values
      */
     getRgbFromColorString(color: string): RgbColor;
-    readonly theme: Theme;
+    readonly theme: {
+        name: string;
+        text: {
+            primary: string;
+            secondary: string;
+            disabled: string;
+        };
+        button: {
+            active: string;
+            hover: string;
+            selected: string;
+            disabled: string;
+            disabledBackground: string;
+        };
+        background: {
+            default: string;
+            paper: string;
+        };
+        palette: {
+            primary: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+            secondary: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+            error: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+            warning: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+            info: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+            success: {
+                light: string;
+                lightContrast: string;
+                main: string;
+                mainContrast: string;
+                dark: string;
+                darkContrast: string;
+            };
+        };
+        divider: string;
+        action: {
+            hoverBackground: string;
+            selectedBackground: string;
+            activeBackground: string;
+            focusRing: string;
+            disabledOpacity: string;
+            backdrop: string;
+            subtleBorder: string;
+        };
+        shape: {
+            borderRadius: {
+                xs: string;
+                sm: string;
+                md: string;
+                lg: string;
+                full: string;
+            };
+        };
+        shadows: {
+            none: string;
+            sm: string;
+            md: string;
+            lg: string;
+            xl: string;
+        };
+        typography: {
+            fontFamily: string;
+            fontSize: {
+                xs: string;
+                sm: string;
+                md: string;
+                lg: string;
+                xl: string;
+            };
+            fontWeight: {
+                normal: string;
+                medium: string;
+                semibold: string;
+                bold: string;
+            };
+            lineHeight: {
+                tight: string;
+                normal: string;
+                relaxed: string;
+            };
+            letterSpacing: {
+                tight: string;
+                dense: string;
+                normal: string;
+                wide: string;
+                wider: string;
+                widest: string;
+            };
+        };
+        transitions: {
+            duration: {
+                fast: string;
+                normal: string;
+                slow: string;
+            };
+            easing: {
+                default: string;
+                easeOut: string;
+                easeInOut: string;
+            };
+        };
+        spacing: {
+            xs: string;
+            sm: string;
+            md: string;
+            lg: string;
+            xl: string;
+        };
+        zIndex: {
+            drawer: string;
+            appBar: string;
+            modal: string;
+            tooltip: string;
+            dropdown: string;
+        };
+        effects: {
+            blurSm: string;
+            blurMd: string;
+            blurLg: string;
+            blurXl: string;
+        };
+    };
     private _assignedTheme;
     /**
      * Returns the last assigned theme object

package/esm/services/theme-provider-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-provider-service.d.ts","sourceRoot":"","sources":["../../src/services/theme-provider-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme-provider-service.d.ts","sourceRoot":"","sources":["../../src/services/theme-provider-service.ts"],"names":[],"mappings":"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"}

package/esm/services/theme-provider-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-provider-service.js","sourceRoot":"","sources":["../../src/services/theme-provider-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme-provider-service.js","sourceRoot":"","sources":["../../src/services/theme-provider-service.ts"],"names":[],"mappings":"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"}

package/esm/services/tree-service.d.ts

@@ -0,0 +1,61 @@
+import { ObservableValue } from '@furystack/utils';
+import type { ListServiceOptions } from './list-service.js';
+import { ListService } from './list-service.js';
+export type TreeServiceOptions<T> = ListServiceOptions<T> & {
+    /**
+     * Returns the children of a given node
+     * @param item The parent node
+     * @returns The child nodes, or an empty array if the node has no children
+     */
+    getChildren: (item: T) => T[];
+};
+export type FlattenedTreeNode<T> = {
+    item: T;
+    level: number;
+    hasChildren: boolean;
+    isExpanded: boolean;
+};
+/**
+ * Service for managing tree state including expand/collapse, hierarchy navigation,
+ * and flattening the tree into a visible items list for rendering
+ */
+export declare class TreeService<T> extends ListService<T> {
+    private treeOptions;
+    expandedNodes: ObservableValue<Set<T>>;
+    rootItems: ObservableValue<T[]>;
+    flattenedNodes: ObservableValue<FlattenedTreeNode<T>[]>;
+    [Symbol.dispose](): void;
+    /**
+     * Checks whether a node is currently expanded
+     */
+    isExpanded: (item: T) => boolean;
+    /**
+     * Expands a node, making its children visible
+     */
+    expand: (item: T) => void;
+    /**
+     * Collapses a node, hiding its children
+     */
+    collapse: (item: T) => void;
+    /**
+     * Toggles the expanded state of a node
+     */
+    toggleExpanded: (item: T) => void;
+    /**
+     * Finds the parent of a given item in the tree
+     */
+    getParent(item: T): T | undefined;
+    /**
+     * Flattens the tree based on which nodes are expanded, and syncs the result
+     * to both flattenedNodes and the inherited ListService items
+     */
+    updateFlattenedNodes(): void;
+    /**
+     * Gets the FlattenedTreeNode for a given item
+     */
+    getNodeInfo(item: T): FlattenedTreeNode<T> | undefined;
+    handleKeyDown(ev: KeyboardEvent): void;
+    handleItemDoubleClick(item: T): void;
+    constructor(treeOptions: TreeServiceOptions<T>);
+}
+//# sourceMappingURL=tree-service.d.ts.map

package/esm/services/tree-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-service.d.ts","sourceRoot":"","sources":["../../src/services/tree-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG;IAC1D;;;;OAIG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAuJpC,OAAO,CAAC,WAAW;IAtJxB,aAAa,0BAAyC;IAEtD,SAAS,uBAA+B;IAExC,cAAc,0CAAuD;IAE5D,CAAC,MAAM,CAAC,OAAO,CAAC;IAOhC;;OAEG;IACI,UAAU,GAAI,MAAM,CAAC,aAA4C;IAExE;;OAEG;IACI,MAAM,GAAI,MAAM,CAAC,UAKvB;IAED;;OAEG;IACI,QAAQ,GAAI,MAAM,CAAC,UAKzB;IAED;;OAEG;IACI,cAAc,GAAI,MAAM,CAAC,UAS/B;IAED;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAexC;;;OAGG;IACI,oBAAoB;IAuB3B;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAI7C,aAAa,CAAC,EAAE,EAAE,aAAa;IAuC/B,qBAAqB,CAAC,IAAI,EAAE,CAAC;gBAOzB,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAGvD"}

package/esm/services/tree-service.js

@@ -0,0 +1,149 @@
+import { ObservableValue } from '@furystack/utils';
+import { ListService } from './list-service.js';
+/**
+ * Service for managing tree state including expand/collapse, hierarchy navigation,
+ * and flattening the tree into a visible items list for rendering
+ */
+export class TreeService extends ListService {
+    treeOptions;
+    expandedNodes = new ObservableValue(new Set());
+    rootItems = new ObservableValue([]);
+    flattenedNodes = new ObservableValue([]);
+    [Symbol.dispose]() {
+        super[Symbol.dispose]();
+        this.expandedNodes[Symbol.dispose]();
+        this.rootItems[Symbol.dispose]();
+        this.flattenedNodes[Symbol.dispose]();
+    }
+    /**
+     * Checks whether a node is currently expanded
+     */
+    isExpanded = (item) => this.expandedNodes.getValue().has(item);
+    /**
+     * Expands a node, making its children visible
+     */
+    expand = (item) => {
+        const expanded = new Set(this.expandedNodes.getValue());
+        expanded.add(item);
+        this.expandedNodes.setValue(expanded);
+        this.updateFlattenedNodes();
+    };
+    /**
+     * Collapses a node, hiding its children
+     */
+    collapse = (item) => {
+        const expanded = new Set(this.expandedNodes.getValue());
+        expanded.delete(item);
+        this.expandedNodes.setValue(expanded);
+        this.updateFlattenedNodes();
+    };
+    /**
+     * Toggles the expanded state of a node
+     */
+    toggleExpanded = (item) => {
+        if (this.isExpanded(item)) {
+            this.collapse(item);
+        }
+        else {
+            const children = this.treeOptions.getChildren(item);
+            if (children.length > 0) {
+                this.expand(item);
+            }
+        }
+    };
+    /**
+     * Finds the parent of a given item in the tree
+     */
+    getParent(item) {
+        const findParent = (nodes) => {
+            for (const node of nodes) {
+                const children = this.treeOptions.getChildren(node);
+                if (children.includes(item)) {
+                    return node;
+                }
+                const found = findParent(children);
+                if (found)
+                    return found;
+            }
+            return undefined;
+        };
+        return findParent(this.rootItems.getValue());
+    }
+    /**
+     * Flattens the tree based on which nodes are expanded, and syncs the result
+     * to both flattenedNodes and the inherited ListService items
+     */
+    updateFlattenedNodes() {
+        const expanded = this.expandedNodes.getValue();
+        const result = [];
+        const flatten = (nodes, level) => {
+            for (const node of nodes) {
+                const children = this.treeOptions.getChildren(node);
+                const hasChildren = children.length > 0;
+                const isExpanded = expanded.has(node);
+                result.push({ item: node, level, hasChildren, isExpanded });
+                if (hasChildren && isExpanded) {
+                    flatten(children, level + 1);
+                }
+            }
+        };
+        flatten(this.rootItems.getValue(), 0);
+        this.flattenedNodes.setValue(result);
+        this.items.setValue(result.map((n) => n.item));
+    }
+    /**
+     * Gets the FlattenedTreeNode for a given item
+     */
+    getNodeInfo(item) {
+        return this.flattenedNodes.getValue().find((n) => n.item === item);
+    }
+    handleKeyDown(ev) {
+        const hasFocus = this.hasFocus.getValue();
+        const focusedItem = this.focusedItem.getValue();
+        if (hasFocus && focusedItem) {
+            switch (ev.key) {
+                case 'ArrowRight': {
+                    ev.preventDefault();
+                    const children = this.treeOptions.getChildren(focusedItem);
+                    if (children.length > 0) {
+                        if (this.isExpanded(focusedItem)) {
+                            this.focusedItem.setValue(children[0]);
+                        }
+                        else {
+                            this.expand(focusedItem);
+                        }
+                    }
+                    return;
+                }
+                case 'ArrowLeft': {
+                    ev.preventDefault();
+                    if (this.isExpanded(focusedItem)) {
+                        this.collapse(focusedItem);
+                    }
+                    else {
+                        const parent = this.getParent(focusedItem);
+                        if (parent) {
+                            this.focusedItem.setValue(parent);
+                        }
+                    }
+                    return;
+                }
+                default: {
+                    break;
+                }
+            }
+        }
+        super.handleKeyDown(ev);
+    }
+    handleItemDoubleClick(item) {
+        const children = this.treeOptions.getChildren(item);
+        if (children.length > 0) {
+            this.toggleExpanded(item);
+        }
+    }
+    constructor(treeOptions) {
+        super(treeOptions);
+        this.treeOptions = treeOptions;
+    }
+}
+//# sourceMappingURL=tree-service.js.map

package/esm/services/tree-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-service.js","sourceRoot":"","sources":["../../src/services/tree-service.ts"],"names":[],"mappings":"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"}

package/esm/services/tree-service.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree-service.spec.d.ts.map

package/esm/services/tree-service.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-service.spec.d.ts","sourceRoot":"","sources":["../../src/services/tree-service.spec.ts"],"names":[],"mappings":""}