@tachui/core 0.7.0-alpha1

package/dist/constants/layout.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.cjs","sources":["../../src/constants/layout.ts"],"sourcesContent":["/**\n * TachUI Layout Constants\n *\n * Provides SwiftUI-style constants for layout and sizing operations.\n * Enables familiar APIs like `.frame(maxWidth: infinity)` for responsive layouts.\n */\n\n/**\n * Infinity constant representing unlimited space availability\n * Equivalent to SwiftUI's .infinity for frame dimensions\n */\nexport const infinity = Symbol.for('tachui.infinity')\n\n/**\n * Type definition for the infinity constant\n */\nexport type InfinityValue = typeof infinity\n\n/**\n * Dimension type that accepts numbers, strings, or infinity\n * Used throughout the modifier system for size-related properties\n */\nexport type Dimension = number | string | InfinityValue\n\n/**\n * SUI-compatible export object (SUI = SwiftUI-inspired)\n * Allows usage like: import { SUI } from '@tachui/core'; SUI.infinity\n */\nexport const SUI = {\n  infinity: infinity\n} as const\n\n/**\n * Helper function to check if a value is the infinity constant\n */\nexport function isInfinity(value: any): value is InfinityValue {\n  return value === infinity\n}\n\n/**\n * Convert a Dimension value to appropriate CSS value\n * \n * @param value - The dimension value to convert\n * @returns CSS-compatible string or undefined\n */\nexport function dimensionToCSS(value: Dimension | undefined): string | undefined {\n  if (value === undefined) {\n    return undefined\n  }\n  \n  if (value === infinity) {\n    return '100%'\n  }\n  \n  if (typeof value === 'number') {\n    return `${value}px`\n  }\n  \n  // String values are passed through as-is (allows for custom units)\n  return value\n}\n\n/**\n * Convert infinity to flexbox properties for proper expansion\n * Used when width/height is set to infinity to ensure proper flex behavior\n */\nexport function infinityToFlexCSS(): Record<string, string> {\n  return {\n    flexGrow: '1',\n    flexShrink: '1',\n    flexBasis: '0%'\n  }\n}\n\n/**\n * Helper to determine if a frame constraint should expand to fill\n * Takes precedence of constraints into account\n */\nexport function shouldExpandForInfinity(options: {\n  width?: Dimension\n  height?: Dimension\n  maxWidth?: Dimension\n  maxHeight?: Dimension\n  minWidth?: Dimension\n  minHeight?: Dimension\n}): { \n  expandWidth: boolean\n  expandHeight: boolean \n  cssProps: Record<string, string>\n} {\n  const expandWidth = options.width === infinity || options.maxWidth === infinity\n  const expandHeight = options.height === infinity || options.maxHeight === infinity\n  \n  const cssProps: Record<string, string> = {}\n  \n  // Apply flex properties for infinity dimensions\n  if (expandWidth) {\n    Object.assign(cssProps, {\n      flexGrow: '1 !important',\n      flexShrink: '1 !important', \n      flexBasis: '0% !important',\n      alignSelf: 'stretch !important'  // Override parent's align-items constraint\n    })\n  }\n  \n  if (expandHeight) {\n    Object.assign(cssProps, {\n      flexGrow: '1 !important',\n      flexShrink: '1 !important',\n      flexBasis: '0% !important',\n      alignSelf: 'stretch !important'  // Override parent's align-items constraint\n    })\n  }\n  \n  return {\n    expandWidth,\n    expandHeight,\n    cssProps\n  }\n}"],"names":["infinity","SUI","isInfinity","value","dimensionToCSS","infinityToFlexCSS","shouldExpandForInfinity","options","expandWidth","expandHeight","cssProps"],"mappings":"gFAWO,MAAMA,EAAW,OAAO,IAAI,iBAAiB,EAiBvCC,EAAM,CACjB,SAAAD,CACF,EAKO,SAASE,EAAWC,EAAoC,CAC7D,OAAOA,IAAUH,CACnB,CAQO,SAASI,EAAeD,EAAkD,CAC/E,GAAIA,IAAU,OAId,OAAIA,IAAUH,EACL,OAGL,OAAOG,GAAU,SACZ,GAAGA,CAAK,KAIVA,CACT,CAMO,SAASE,GAA4C,CAC1D,MAAO,CACL,SAAU,IACV,WAAY,IACZ,UAAW,IAAA,CAEf,CAMO,SAASC,EAAwBC,EAWtC,CACA,MAAMC,EAAcD,EAAQ,QAAUP,GAAYO,EAAQ,WAAaP,EACjES,EAAeF,EAAQ,SAAWP,GAAYO,EAAQ,YAAcP,EAEpEU,EAAmC,CAAA,EAGzC,OAAIF,GACF,OAAO,OAAOE,EAAU,CACtB,SAAU,eACV,WAAY,eACZ,UAAW,gBACX,UAAW,oBAAA,CACZ,EAGCD,GACF,OAAO,OAAOC,EAAU,CACtB,SAAU,eACV,WAAY,eACZ,UAAW,gBACX,UAAW,oBAAA,CACZ,EAGI,CACL,YAAAF,EACA,aAAAC,EACA,SAAAC,CAAA,CAEJ"}

package/dist/constants/layout.d.ts

@@ -0,0 +1,60 @@
+/**
+ * TachUI Layout Constants
+ *
+ * Provides SwiftUI-style constants for layout and sizing operations.
+ * Enables familiar APIs like `.frame(maxWidth: infinity)` for responsive layouts.
+ */
+/**
+ * Infinity constant representing unlimited space availability
+ * Equivalent to SwiftUI's .infinity for frame dimensions
+ */
+export declare const infinity: unique symbol;
+/**
+ * Type definition for the infinity constant
+ */
+export type InfinityValue = typeof infinity;
+/**
+ * Dimension type that accepts numbers, strings, or infinity
+ * Used throughout the modifier system for size-related properties
+ */
+export type Dimension = number | string | InfinityValue;
+/**
+ * SUI-compatible export object (SUI = SwiftUI-inspired)
+ * Allows usage like: import { SUI } from '@tachui/core'; SUI.infinity
+ */
+export declare const SUI: {
+    readonly infinity: typeof infinity;
+};
+/**
+ * Helper function to check if a value is the infinity constant
+ */
+export declare function isInfinity(value: any): value is InfinityValue;
+/**
+ * Convert a Dimension value to appropriate CSS value
+ *
+ * @param value - The dimension value to convert
+ * @returns CSS-compatible string or undefined
+ */
+export declare function dimensionToCSS(value: Dimension | undefined): string | undefined;
+/**
+ * Convert infinity to flexbox properties for proper expansion
+ * Used when width/height is set to infinity to ensure proper flex behavior
+ */
+export declare function infinityToFlexCSS(): Record<string, string>;
+/**
+ * Helper to determine if a frame constraint should expand to fill
+ * Takes precedence of constraints into account
+ */
+export declare function shouldExpandForInfinity(options: {
+    width?: Dimension;
+    height?: Dimension;
+    maxWidth?: Dimension;
+    maxHeight?: Dimension;
+    minWidth?: Dimension;
+    minHeight?: Dimension;
+}): {
+    expandWidth: boolean;
+    expandHeight: boolean;
+    cssProps: Record<string, string>;
+};
+//# sourceMappingURL=layout.d.ts.map

package/dist/constants/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/constants/layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,eAAgC,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,QAAQ,CAAA;AAE3C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,GAAG;;CAEN,CAAA;AAEV;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAe/E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,GAAG;IACF,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CA8BA"}

package/dist/constants/layout.js

@@ -0,0 +1,46 @@
+const t = Symbol.for("tachui.infinity"), f = {
+  infinity: t
+};
+function o(i) {
+  return i === t;
+}
+function s(i) {
+  if (i !== void 0)
+    return i === t ? "100%" : typeof i == "number" ? `${i}px` : i;
+}
+function a() {
+  return {
+    flexGrow: "1",
+    flexShrink: "1",
+    flexBasis: "0%"
+  };
+}
+function x(i) {
+  const r = i.width === t || i.maxWidth === t, e = i.height === t || i.maxHeight === t, n = {};
+  return r && Object.assign(n, {
+    flexGrow: "1 !important",
+    flexShrink: "1 !important",
+    flexBasis: "0% !important",
+    alignSelf: "stretch !important"
+    // Override parent's align-items constraint
+  }), e && Object.assign(n, {
+    flexGrow: "1 !important",
+    flexShrink: "1 !important",
+    flexBasis: "0% !important",
+    alignSelf: "stretch !important"
+    // Override parent's align-items constraint
+  }), {
+    expandWidth: r,
+    expandHeight: e,
+    cssProps: n
+  };
+}
+export {
+  f as SUI,
+  s as dimensionToCSS,
+  t as infinity,
+  a as infinityToFlexCSS,
+  o as isInfinity,
+  x as shouldExpandForInfinity
+};
+//# sourceMappingURL=layout.js.map

package/dist/constants/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sources":["../../src/constants/layout.ts"],"sourcesContent":["/**\n * TachUI Layout Constants\n *\n * Provides SwiftUI-style constants for layout and sizing operations.\n * Enables familiar APIs like `.frame(maxWidth: infinity)` for responsive layouts.\n */\n\n/**\n * Infinity constant representing unlimited space availability\n * Equivalent to SwiftUI's .infinity for frame dimensions\n */\nexport const infinity = Symbol.for('tachui.infinity')\n\n/**\n * Type definition for the infinity constant\n */\nexport type InfinityValue = typeof infinity\n\n/**\n * Dimension type that accepts numbers, strings, or infinity\n * Used throughout the modifier system for size-related properties\n */\nexport type Dimension = number | string | InfinityValue\n\n/**\n * SUI-compatible export object (SUI = SwiftUI-inspired)\n * Allows usage like: import { SUI } from '@tachui/core'; SUI.infinity\n */\nexport const SUI = {\n  infinity: infinity\n} as const\n\n/**\n * Helper function to check if a value is the infinity constant\n */\nexport function isInfinity(value: any): value is InfinityValue {\n  return value === infinity\n}\n\n/**\n * Convert a Dimension value to appropriate CSS value\n * \n * @param value - The dimension value to convert\n * @returns CSS-compatible string or undefined\n */\nexport function dimensionToCSS(value: Dimension | undefined): string | undefined {\n  if (value === undefined) {\n    return undefined\n  }\n  \n  if (value === infinity) {\n    return '100%'\n  }\n  \n  if (typeof value === 'number') {\n    return `${value}px`\n  }\n  \n  // String values are passed through as-is (allows for custom units)\n  return value\n}\n\n/**\n * Convert infinity to flexbox properties for proper expansion\n * Used when width/height is set to infinity to ensure proper flex behavior\n */\nexport function infinityToFlexCSS(): Record<string, string> {\n  return {\n    flexGrow: '1',\n    flexShrink: '1',\n    flexBasis: '0%'\n  }\n}\n\n/**\n * Helper to determine if a frame constraint should expand to fill\n * Takes precedence of constraints into account\n */\nexport function shouldExpandForInfinity(options: {\n  width?: Dimension\n  height?: Dimension\n  maxWidth?: Dimension\n  maxHeight?: Dimension\n  minWidth?: Dimension\n  minHeight?: Dimension\n}): { \n  expandWidth: boolean\n  expandHeight: boolean \n  cssProps: Record<string, string>\n} {\n  const expandWidth = options.width === infinity || options.maxWidth === infinity\n  const expandHeight = options.height === infinity || options.maxHeight === infinity\n  \n  const cssProps: Record<string, string> = {}\n  \n  // Apply flex properties for infinity dimensions\n  if (expandWidth) {\n    Object.assign(cssProps, {\n      flexGrow: '1 !important',\n      flexShrink: '1 !important', \n      flexBasis: '0% !important',\n      alignSelf: 'stretch !important'  // Override parent's align-items constraint\n    })\n  }\n  \n  if (expandHeight) {\n    Object.assign(cssProps, {\n      flexGrow: '1 !important',\n      flexShrink: '1 !important',\n      flexBasis: '0% !important',\n      alignSelf: 'stretch !important'  // Override parent's align-items constraint\n    })\n  }\n  \n  return {\n    expandWidth,\n    expandHeight,\n    cssProps\n  }\n}"],"names":["infinity","SUI","isInfinity","value","dimensionToCSS","infinityToFlexCSS","shouldExpandForInfinity","options","expandWidth","expandHeight","cssProps"],"mappings":"AAWO,MAAMA,IAAW,OAAO,IAAI,iBAAiB,GAiBvCC,IAAM;AAAA,EACjB,UAAAD;AACF;AAKO,SAASE,EAAWC,GAAoC;AAC7D,SAAOA,MAAUH;AACnB;AAQO,SAASI,EAAeD,GAAkD;AAC/E,MAAIA,MAAU;AAId,WAAIA,MAAUH,IACL,SAGL,OAAOG,KAAU,WACZ,GAAGA,CAAK,OAIVA;AACT;AAMO,SAASE,IAA4C;AAC1D,SAAO;AAAA,IACL,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,WAAW;AAAA,EAAA;AAEf;AAMO,SAASC,EAAwBC,GAWtC;AACA,QAAMC,IAAcD,EAAQ,UAAUP,KAAYO,EAAQ,aAAaP,GACjES,IAAeF,EAAQ,WAAWP,KAAYO,EAAQ,cAAcP,GAEpEU,IAAmC,CAAA;AAGzC,SAAIF,KACF,OAAO,OAAOE,GAAU;AAAA,IACtB,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,WAAW;AAAA;AAAA,EAAA,CACZ,GAGCD,KACF,OAAO,OAAOC,GAAU;AAAA,IACtB,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,WAAW;AAAA;AAAA,EAAA,CACZ,GAGI;AAAA,IACL,aAAAF;AAAA,IACA,cAAAC;AAAA,IACA,UAAAC;AAAA,EAAA;AAEJ;"}

package/dist/css-classes/component-base.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../reactive/cleanup.cjs");const a=require("../reactive/computed.cjs");require("../reactive/unified-scheduler.cjs");const i=require("../reactive/signal.cjs");require("../reactive/scheduler.cjs");require("../reactive/theme.cjs");const o=require("./css-class-manager.cjs");var l=Object.defineProperty,C=(r,s,e)=>s in r?l(r,s,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[s]=e,u=(r,s,e)=>C(r,s+"",e);class g{constructor(){u(this,"cssClassManager",o.cssClassManager)}processComponentClasses(s,e=[]){if(!s.css)return e;const n=this.cssClassManager.processClasses(s.css);return this.cssClassManager.combineClasses(e,n)}createClassString(s,e=[]){return s.css&&(i.isSignal(s.css)||a.isComputed(s.css))?a.createComputed(()=>this.processComponentClasses(s,e).join(" ")):this.processComponentClasses(s,e).join(" ")}createClassArray(s,e=[]){return s.css&&i.isSignal(s.css)?a.createComputed(()=>this.processComponentClasses(s,e)):this.processComponentClasses(s,e)}validateCSSClasses(s){if(process.env.NODE_ENV!=="development"||!s.css)return;const e=s.css;if(typeof e=="string"||Array.isArray(e)||i.isSignal(e)||console.warn("[tachUI] css must be a string, array of strings, or signal. Got:",typeof e),Array.isArray(e)){const t=e.filter(c=>typeof c!="string");t.length>0&&console.warn("[tachUI] All items in css array must be strings. Invalid items:",t)}}getClassDebugInfo(s,e=[]){const n=s.css?this.cssClassManager.processClasses(s.css):[],t=this.processComponentClasses(s,e);return{base:e,user:n,processed:t,final:t.join(" ")}}}exports.ComponentWithCSSClasses=g;
+//# sourceMappingURL=component-base.cjs.map

package/dist/css-classes/component-base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-base.cjs","sources":["../../src/css-classes/component-base.ts"],"sourcesContent":["/**\n * CSS Classes Enhancement - Component Base\n * \n * Base class for components that support CSS class integration.\n * Provides utilities for processing and applying CSS classes.\n */\n\nimport { createComputed, isSignal, isComputed } from '../reactive'\nimport type { Signal } from '../reactive/types'\nimport { cssClassManager } from './css-class-manager'\nimport type { CSSClassesProps } from './types'\n\n/**\n * Base class for components with CSS class support\n */\nexport abstract class ComponentWithCSSClasses {\n  protected cssClassManager = cssClassManager\n\n  /**\n   * Process CSS classes from props and integrate with component classes\n   */\n  protected processComponentClasses(\n    props: CSSClassesProps, \n    baseClasses: string[] = []\n  ): string[] {\n    if (!props.css) {\n      return baseClasses\n    }\n\n    const userClasses = this.cssClassManager.processClasses(props.css)\n    return this.cssClassManager.combineClasses(baseClasses, userClasses)\n  }\n\n  /**\n   * Create class string for DOM nodes - handles both static and reactive classes\n   */\n  protected createClassString(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): Signal<string> | string {\n    // If css is reactive, create reactive class string\n    if (props.css && (isSignal(props.css) || isComputed(props.css))) {\n      return createComputed(() => {\n        const processedClasses = this.processComponentClasses(props, baseClasses)\n        return processedClasses.join(' ')\n      })\n    }\n\n    // Static class processing\n    const processedClasses = this.processComponentClasses(props, baseClasses)\n    return processedClasses.join(' ')\n  }\n\n  /**\n   * Create class array for components that need array format\n   */\n  protected createClassArray(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): Signal<string[]> | string[] {\n    // If css is reactive, create reactive class array\n    if (props.css && isSignal(props.css)) {\n      return createComputed(() => {\n        return this.processComponentClasses(props, baseClasses)\n      })\n    }\n\n    // Static class processing\n    return this.processComponentClasses(props, baseClasses)\n  }\n\n  /**\n   * Validate CSS classes for development warnings\n   */\n  protected validateCSSClasses(props: CSSClassesProps): void {\n    if (process.env.NODE_ENV !== 'development' || !props.css) {\n      return\n    }\n\n    // Validate that css is the right type\n    const classes = props.css\n    const isValidType = typeof classes === 'string' || \n                       Array.isArray(classes) || \n                       isSignal(classes)\n\n    if (!isValidType) {\n      console.warn('[tachUI] css must be a string, array of strings, or signal. Got:', typeof classes)\n    }\n\n    // Validate array contents if it's an array\n    if (Array.isArray(classes)) {\n      const invalidItems = classes.filter(item => typeof item !== 'string')\n      if (invalidItems.length > 0) {\n        console.warn('[tachUI] All items in css array must be strings. Invalid items:', invalidItems)\n      }\n    }\n  }\n\n  /**\n   * Get debug information about processed classes\n   */\n  protected getClassDebugInfo(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): { base: string[], user: string[], processed: string[], final: string } {\n    const userClasses = props.css ? \n      this.cssClassManager.processClasses(props.css) : []\n    const processedClasses = this.processComponentClasses(props, baseClasses)\n    \n    return {\n      base: baseClasses,\n      user: userClasses,\n      processed: processedClasses,\n      final: processedClasses.join(' ')\n    }\n  }\n}"],"names":["ComponentWithCSSClasses","__publicField","cssClassManager","props","baseClasses","userClasses","isSignal","isComputed","createComputed","classes","invalidItems","item","processedClasses"],"mappings":"8eAeO,MAAeA,CAAwB,CAAvC,aAAA,CACLC,EAAA,KAAU,kBAAkBC,iBAAA,CAAA,CAKlB,wBACRC,EACAC,EAAwB,GACd,CACV,GAAI,CAACD,EAAM,IACT,OAAOC,EAGT,MAAMC,EAAc,KAAK,gBAAgB,eAAeF,EAAM,GAAG,EACjE,OAAO,KAAK,gBAAgB,eAAeC,EAAaC,CAAW,CACrE,CAKU,kBACRF,EACAC,EAAwB,GACC,CAEzB,OAAID,EAAM,MAAQG,EAAAA,SAASH,EAAM,GAAG,GAAKI,aAAWJ,EAAM,GAAG,GACpDK,EAAAA,eAAe,IACK,KAAK,wBAAwBL,EAAOC,CAAW,EAChD,KAAK,GAAG,CACjC,EAIsB,KAAK,wBAAwBD,EAAOC,CAAW,EAChD,KAAK,GAAG,CAClC,CAKU,iBACRD,EACAC,EAAwB,GACK,CAE7B,OAAID,EAAM,KAAOG,EAAAA,SAASH,EAAM,GAAG,EAC1BK,EAAAA,eAAe,IACb,KAAK,wBAAwBL,EAAOC,CAAW,CACvD,EAII,KAAK,wBAAwBD,EAAOC,CAAW,CACxD,CAKU,mBAAmBD,EAA8B,CACzD,GAAI,QAAQ,IAAI,WAAa,eAAiB,CAACA,EAAM,IACnD,OAIF,MAAMM,EAAUN,EAAM,IAUtB,GAToB,OAAOM,GAAY,UACpB,MAAM,QAAQA,CAAO,GACrBH,EAAAA,SAASG,CAAO,GAGjC,QAAQ,KAAK,mEAAoE,OAAOA,CAAO,EAI7F,MAAM,QAAQA,CAAO,EAAG,CAC1B,MAAMC,EAAeD,EAAQ,OAAOE,GAAQ,OAAOA,GAAS,QAAQ,EAChED,EAAa,OAAS,GACxB,QAAQ,KAAK,kEAAmEA,CAAY,CAEhG,CACF,CAKU,kBACRP,EACAC,EAAwB,GACgD,CACxE,MAAMC,EAAcF,EAAM,IACxB,KAAK,gBAAgB,eAAeA,EAAM,GAAG,EAAI,CAAA,EAC7CS,EAAmB,KAAK,wBAAwBT,EAAOC,CAAW,EAExE,MAAO,CACL,KAAMA,EACN,KAAMC,EACN,UAAWO,EACX,MAAOA,EAAiB,KAAK,GAAG,CAAA,CAEpC,CACF"}

package/dist/css-classes/component-base.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CSS Classes Enhancement - Component Base
+ *
+ * Base class for components that support CSS class integration.
+ * Provides utilities for processing and applying CSS classes.
+ */
+import type { Signal } from '../reactive/types';
+import type { CSSClassesProps } from './types';
+/**
+ * Base class for components with CSS class support
+ */
+export declare abstract class ComponentWithCSSClasses {
+    protected cssClassManager: import("./css-class-manager").CSSClassManager;
+    /**
+     * Process CSS classes from props and integrate with component classes
+     */
+    protected processComponentClasses(props: CSSClassesProps, baseClasses?: string[]): string[];
+    /**
+     * Create class string for DOM nodes - handles both static and reactive classes
+     */
+    protected createClassString(props: CSSClassesProps, baseClasses?: string[]): Signal<string> | string;
+    /**
+     * Create class array for components that need array format
+     */
+    protected createClassArray(props: CSSClassesProps, baseClasses?: string[]): Signal<string[]> | string[];
+    /**
+     * Validate CSS classes for development warnings
+     */
+    protected validateCSSClasses(props: CSSClassesProps): void;
+    /**
+     * Get debug information about processed classes
+     */
+    protected getClassDebugInfo(props: CSSClassesProps, baseClasses?: string[]): {
+        base: string[];
+        user: string[];
+        processed: string[];
+        final: string;
+    };
+}
+//# sourceMappingURL=component-base.d.ts.map

package/dist/css-classes/component-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-base.d.ts","sourceRoot":"","sources":["../../src/css-classes/component-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;GAEG;AACH,8BAAsB,uBAAuB;IAC3C,SAAS,CAAC,eAAe,gDAAkB;IAE3C;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAC/B,KAAK,EAAE,eAAe,EACtB,WAAW,GAAE,MAAM,EAAO,GACzB,MAAM,EAAE;IASX;;OAEG;IACH,SAAS,CAAC,iBAAiB,CACzB,KAAK,EAAE,eAAe,EACtB,WAAW,GAAE,MAAM,EAAO,GACzB,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM;IAc1B;;OAEG;IACH,SAAS,CAAC,gBAAgB,CACxB,KAAK,EAAE,eAAe,EACtB,WAAW,GAAE,MAAM,EAAO,GACzB,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE;IAY9B;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAwB1D;;OAEG;IACH,SAAS,CAAC,iBAAiB,CACzB,KAAK,EAAE,eAAe,EACtB,WAAW,GAAE,MAAM,EAAO,GACzB;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAY1E"}

package/dist/css-classes/component-base.js

@@ -0,0 +1,62 @@
+import "../reactive/cleanup.js";
+import { isComputed as c, createComputed as o } from "../reactive/computed.js";
+import "../reactive/unified-scheduler.js";
+import { isSignal as a } from "../reactive/signal.js";
+import "../reactive/scheduler.js";
+import "../reactive/theme.js";
+import { cssClassManager as l } from "./css-class-manager.js";
+var C = Object.defineProperty, m = (r, s, e) => s in r ? C(r, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[s] = e, u = (r, s, e) => m(r, s + "", e);
+class _ {
+  constructor() {
+    u(this, "cssClassManager", l);
+  }
+  /**
+   * Process CSS classes from props and integrate with component classes
+   */
+  processComponentClasses(s, e = []) {
+    if (!s.css)
+      return e;
+    const n = this.cssClassManager.processClasses(s.css);
+    return this.cssClassManager.combineClasses(e, n);
+  }
+  /**
+   * Create class string for DOM nodes - handles both static and reactive classes
+   */
+  createClassString(s, e = []) {
+    return s.css && (a(s.css) || c(s.css)) ? o(() => this.processComponentClasses(s, e).join(" ")) : this.processComponentClasses(s, e).join(" ");
+  }
+  /**
+   * Create class array for components that need array format
+   */
+  createClassArray(s, e = []) {
+    return s.css && a(s.css) ? o(() => this.processComponentClasses(s, e)) : this.processComponentClasses(s, e);
+  }
+  /**
+   * Validate CSS classes for development warnings
+   */
+  validateCSSClasses(s) {
+    if (process.env.NODE_ENV !== "development" || !s.css)
+      return;
+    const e = s.css;
+    if (typeof e == "string" || Array.isArray(e) || a(e) || console.warn("[tachUI] css must be a string, array of strings, or signal. Got:", typeof e), Array.isArray(e)) {
+      const t = e.filter((i) => typeof i != "string");
+      t.length > 0 && console.warn("[tachUI] All items in css array must be strings. Invalid items:", t);
+    }
+  }
+  /**
+   * Get debug information about processed classes
+   */
+  getClassDebugInfo(s, e = []) {
+    const n = s.css ? this.cssClassManager.processClasses(s.css) : [], t = this.processComponentClasses(s, e);
+    return {
+      base: e,
+      user: n,
+      processed: t,
+      final: t.join(" ")
+    };
+  }
+}
+export {
+  _ as ComponentWithCSSClasses
+};
+//# sourceMappingURL=component-base.js.map

package/dist/css-classes/component-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-base.js","sources":["../../src/css-classes/component-base.ts"],"sourcesContent":["/**\n * CSS Classes Enhancement - Component Base\n * \n * Base class for components that support CSS class integration.\n * Provides utilities for processing and applying CSS classes.\n */\n\nimport { createComputed, isSignal, isComputed } from '../reactive'\nimport type { Signal } from '../reactive/types'\nimport { cssClassManager } from './css-class-manager'\nimport type { CSSClassesProps } from './types'\n\n/**\n * Base class for components with CSS class support\n */\nexport abstract class ComponentWithCSSClasses {\n  protected cssClassManager = cssClassManager\n\n  /**\n   * Process CSS classes from props and integrate with component classes\n   */\n  protected processComponentClasses(\n    props: CSSClassesProps, \n    baseClasses: string[] = []\n  ): string[] {\n    if (!props.css) {\n      return baseClasses\n    }\n\n    const userClasses = this.cssClassManager.processClasses(props.css)\n    return this.cssClassManager.combineClasses(baseClasses, userClasses)\n  }\n\n  /**\n   * Create class string for DOM nodes - handles both static and reactive classes\n   */\n  protected createClassString(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): Signal<string> | string {\n    // If css is reactive, create reactive class string\n    if (props.css && (isSignal(props.css) || isComputed(props.css))) {\n      return createComputed(() => {\n        const processedClasses = this.processComponentClasses(props, baseClasses)\n        return processedClasses.join(' ')\n      })\n    }\n\n    // Static class processing\n    const processedClasses = this.processComponentClasses(props, baseClasses)\n    return processedClasses.join(' ')\n  }\n\n  /**\n   * Create class array for components that need array format\n   */\n  protected createClassArray(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): Signal<string[]> | string[] {\n    // If css is reactive, create reactive class array\n    if (props.css && isSignal(props.css)) {\n      return createComputed(() => {\n        return this.processComponentClasses(props, baseClasses)\n      })\n    }\n\n    // Static class processing\n    return this.processComponentClasses(props, baseClasses)\n  }\n\n  /**\n   * Validate CSS classes for development warnings\n   */\n  protected validateCSSClasses(props: CSSClassesProps): void {\n    if (process.env.NODE_ENV !== 'development' || !props.css) {\n      return\n    }\n\n    // Validate that css is the right type\n    const classes = props.css\n    const isValidType = typeof classes === 'string' || \n                       Array.isArray(classes) || \n                       isSignal(classes)\n\n    if (!isValidType) {\n      console.warn('[tachUI] css must be a string, array of strings, or signal. Got:', typeof classes)\n    }\n\n    // Validate array contents if it's an array\n    if (Array.isArray(classes)) {\n      const invalidItems = classes.filter(item => typeof item !== 'string')\n      if (invalidItems.length > 0) {\n        console.warn('[tachUI] All items in css array must be strings. Invalid items:', invalidItems)\n      }\n    }\n  }\n\n  /**\n   * Get debug information about processed classes\n   */\n  protected getClassDebugInfo(\n    props: CSSClassesProps,\n    baseClasses: string[] = []\n  ): { base: string[], user: string[], processed: string[], final: string } {\n    const userClasses = props.css ? \n      this.cssClassManager.processClasses(props.css) : []\n    const processedClasses = this.processComponentClasses(props, baseClasses)\n    \n    return {\n      base: baseClasses,\n      user: userClasses,\n      processed: processedClasses,\n      final: processedClasses.join(' ')\n    }\n  }\n}"],"names":["ComponentWithCSSClasses","__publicField","cssClassManager","props","baseClasses","userClasses","isSignal","isComputed","createComputed","classes","invalidItems","item","processedClasses"],"mappings":";;;;;;;;AAeO,MAAeA,EAAwB;AAAA,EAAvC,cAAA;AACL,IAAAC,EAAA,MAAU,mBAAkBC,CAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAKlB,wBACRC,GACAC,IAAwB,IACd;AACV,QAAI,CAACD,EAAM;AACT,aAAOC;AAGT,UAAMC,IAAc,KAAK,gBAAgB,eAAeF,EAAM,GAAG;AACjE,WAAO,KAAK,gBAAgB,eAAeC,GAAaC,CAAW;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA,EAKU,kBACRF,GACAC,IAAwB,IACC;AAEzB,WAAID,EAAM,QAAQG,EAASH,EAAM,GAAG,KAAKI,EAAWJ,EAAM,GAAG,KACpDK,EAAe,MACK,KAAK,wBAAwBL,GAAOC,CAAW,EAChD,KAAK,GAAG,CACjC,IAIsB,KAAK,wBAAwBD,GAAOC,CAAW,EAChD,KAAK,GAAG;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKU,iBACRD,GACAC,IAAwB,IACK;AAE7B,WAAID,EAAM,OAAOG,EAASH,EAAM,GAAG,IAC1BK,EAAe,MACb,KAAK,wBAAwBL,GAAOC,CAAW,CACvD,IAII,KAAK,wBAAwBD,GAAOC,CAAW;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA,EAKU,mBAAmBD,GAA8B;AACzD,QAAI,QAAQ,IAAI,aAAa,iBAAiB,CAACA,EAAM;AACnD;AAIF,UAAMM,IAAUN,EAAM;AAUtB,QAToB,OAAOM,KAAY,YACpB,MAAM,QAAQA,CAAO,KACrBH,EAASG,CAAO,KAGjC,QAAQ,KAAK,oEAAoE,OAAOA,CAAO,GAI7F,MAAM,QAAQA,CAAO,GAAG;AAC1B,YAAMC,IAAeD,EAAQ,OAAO,CAAAE,MAAQ,OAAOA,KAAS,QAAQ;AACpE,MAAID,EAAa,SAAS,KACxB,QAAQ,KAAK,mEAAmEA,CAAY;AAAA,IAEhG;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKU,kBACRP,GACAC,IAAwB,IACgD;AACxE,UAAMC,IAAcF,EAAM,MACxB,KAAK,gBAAgB,eAAeA,EAAM,GAAG,IAAI,CAAA,GAC7CS,IAAmB,KAAK,wBAAwBT,GAAOC,CAAW;AAExE,WAAO;AAAA,MACL,MAAMA;AAAA,MACN,MAAMC;AAAA,MACN,WAAWO;AAAA,MACX,OAAOA,EAAiB,KAAK,GAAG;AAAA,IAAA;AAAA,EAEpC;AACF;"}

package/dist/css-classes/css-class-manager.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../reactive/cleanup.cjs");const f=require("../reactive/computed.cjs");require("../reactive/unified-scheduler.cjs");const C=require("../reactive/signal.cjs");require("../reactive/scheduler.cjs");require("../reactive/theme.cjs");var g=Object.defineProperty,u=(r,e,s)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):r[e]=s,c=(r,e,s)=>u(r,typeof e!="symbol"?e+"":e,s);const d={sanitizeClassNames:!0,sanitizationRules:{allowNumbers:!0,allowUnderscores:!0,customReplacements:{}},enableCaching:!0,maxCacheSize:1e3,warnDuplicateClasses:process.env.NODE_ENV==="development",warnInvalidClasses:process.env.NODE_ENV==="development"};class h{constructor(e={}){c(this,"config"),c(this,"classCache"),c(this,"processingCache"),this.config={...d,...e};const s=(()=>{try{return typeof Map<"u"&&typeof Map=="function"}catch{return!1}})();this.classCache=s?new Map:{},this.processingCache=s?new Map:{}}cacheHas(e,s){try{return e instanceof Map?e.has(s):s in e}catch{return s in e}}cacheGet(e,s){try{return e instanceof Map?e.get(s):e[s]}catch{return e[s]}}cacheSet(e,s,t){try{e instanceof Map?e.set(s,t):e[s]=t}catch{e[s]=t}}cacheDelete(e,s){try{e instanceof Map?e.delete(s):delete e[s]}catch{delete e[s]}}cacheClear(e){try{e instanceof Map?e.clear():Object.keys(e).forEach(s=>delete e[s])}catch{Object.keys(e).forEach(t=>delete e[t])}}cacheSize(e){try{return e instanceof Map?e.size:Object.keys(e).length}catch{return Object.keys(e).length}}cacheKeys(e){try{return e instanceof Map?e.keys():Object.keys(e)}catch{return Object.keys(e)}}processClasses(e){if(!e)return[];if(C.isSignal(e)||f.isComputed(e)){const a=e();return this.processClasses(a)}const s=this.getCacheKey(e);if(this.config.enableCaching&&this.cacheHas(this.classCache,s))return this.cacheGet(this.classCache,s);let t=[];if(typeof e=="string")t=e.trim().split(/\s+/).filter(Boolean);else if(Array.isArray(e))t=e.flatMap(a=>{if(a==null||a==="")return[];const n=(typeof a=="string"?a:String(a)).trim();return typeof a!="string"&&n?[n]:n.split(/\s+/)}).filter(Boolean);else{const a=String(e).trim();t=a?[a]:[]}const i=this.processClassArray(t);return this.config.enableCaching&&this.setCachedClasses(s,i),i}processClassArray(e){let s=e;return this.config.sanitizeClassNames&&(s=s.map(t=>this.sanitizeClassName(t))),s=this.deduplicateClasses(s),this.config.warnDuplicateClasses&&e.length!==s.length&&console.warn("[tachUI] Duplicate CSS classes detected and removed:",e.filter((t,i)=>e.indexOf(t)!==i)),s}sanitizeClassName(e){if(!e||typeof e!="string")return"";const s=this.config.sanitizationRules;let t=e.trim();t.includes(" ")&&(t=t.replace(/\s+/g,"-"),this.config.warnInvalidClasses&&console.warn(`[tachUI] CSS class names cannot contain spaces. Converted "${e}" to "${t}"`)),Object.entries(s.customReplacements||{}).forEach(([a,o])=>{t=t.replace(new RegExp(a,"g"),o)});let i="a-zA-Z\\-\\.";return s.allowNumbers&&(i+="0-9"),s.allowUnderscores&&(i+="_"),i+=":\\[\\]/%",t=t.replace(new RegExp(`[^${i}]`,"g"),"-"),/^[0-9]/.test(t)&&(t="cls-"+t),t=t.replace(/---+/g,"--"),this.config.warnInvalidClasses&&t!==e.trim()&&console.warn(`[tachUI] CSS class "${e}" sanitized to "${t}"`),t}deduplicateClasses(e){return[...new Set(e.filter(Boolean))]}combineClasses(e,s){const t=this.processClasses(s),i=[...e,...t];return this.deduplicateClasses(i)}updateConfig(e){this.config={...this.config,...e},this.clearCaches()}getConfig(){return{...this.config}}clearCaches(){this.cacheClear(this.classCache),this.cacheClear(this.processingCache)}getCacheStats(){return{size:this.cacheSize(this.classCache),maxSize:this.config.maxCacheSize,hitRate:0}}getCacheKey(e){return Array.isArray(e)?e.join("|"):e}setCachedClasses(e,s){if(this.cacheSize(this.classCache)>=this.config.maxCacheSize){const t=this.cacheKeys(this.classCache),i=Array.isArray(t)?t[0]:t.next().value;i!==void 0&&this.cacheDelete(this.classCache,i)}this.cacheSet(this.classCache,e,s)}}const l=new h;function p(r){l.updateConfig(r)}function S(){return l.getConfig()}exports.CSSClassManager=h;exports.configureCSSClasses=p;exports.cssClassManager=l;exports.getCSSClassConfig=S;
+//# sourceMappingURL=css-class-manager.cjs.map

package/dist/css-classes/css-class-manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-class-manager.cjs","sources":["../../src/css-classes/css-class-manager.ts"],"sourcesContent":["/**\n * CSS Classes Enhancement - Class Manager\n *\n * Core CSS class processing system that handles sanitization,\n * deduplication, and integration with tachUI components.\n */\n\nimport { isSignal, isComputed } from '../reactive'\nimport type { Signal } from '../reactive/types'\nimport type {\n  CSSClassProcessor,\n  CSSClassConfig,\n  ClassProcessingResult\n} from './types'\n\n/**\n * Default configuration for CSS class processing\n */\nconst DEFAULT_CONFIG: CSSClassConfig = {\n  sanitizeClassNames: true,\n  sanitizationRules: {\n    allowNumbers: true,\n    allowUnderscores: true,\n    customReplacements: {}\n  },\n  enableCaching: true,\n  maxCacheSize: 1000,\n  warnDuplicateClasses: process.env.NODE_ENV === 'development',\n  warnInvalidClasses: process.env.NODE_ENV === 'development'\n}\n\n/**\n * CSS Class Manager - Core processing system\n */\nexport class CSSClassManager implements CSSClassProcessor {\n  private config: CSSClassConfig\n  private classCache: Map<string, string[]> | { [key: string]: string[] }\n  private processingCache: Map<string, ClassProcessingResult> | { [key: string]: ClassProcessingResult }\n\n  constructor(config: Partial<CSSClassConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config }\n\n    // Initialize caches with Map if available, otherwise use plain objects\n    // Use safe check for Map availability to handle all edge cases\n    const mapAvailable = (() => {\n      try {\n        return typeof Map !== 'undefined' && typeof Map === 'function'\n      } catch (_e) {\n        return false\n      }\n    })()\n\n    this.classCache = mapAvailable ? new Map() : {}\n    this.processingCache = mapAvailable ? new Map() : {}\n  }\n\n  /**\n   * Cache helper methods to work with both Map and plain object fallbacks\n   */\n  private cacheHas(cache: Map<string, any> | { [key: string]: any }, key: string): boolean {\n    try {\n      return cache instanceof Map ? cache.has(key) : key in cache\n    } catch (_e) {\n      // Fallback if Map check fails\n      return key in cache\n    }\n  }\n\n  private cacheGet<T>(cache: Map<string, T> | { [key: string]: T }, key: string): T | undefined {\n    try {\n      return cache instanceof Map ? cache.get(key) : cache[key]\n    } catch (_e) {\n      return (cache as { [key: string]: T })[key]\n    }\n  }\n\n  private cacheSet<T>(cache: Map<string, T> | { [key: string]: T }, key: string, value: T): void {\n    try {\n      if (cache instanceof Map) {\n        cache.set(key, value)\n      } else {\n        cache[key] = value\n      }\n    } catch (_e) {\n      ;(cache as { [key: string]: T })[key] = value\n    }\n  }\n\n  private cacheDelete<T>(cache: Map<string, T> | { [key: string]: T }, key: string): void {\n    try {\n      if (cache instanceof Map) {\n        cache.delete(key)\n      } else {\n        delete cache[key]\n      }\n    } catch (_e) {\n      delete (cache as { [key: string]: T })[key]\n    }\n  }\n\n  private cacheClear<T>(cache: Map<string, T> | { [key: string]: T }): void {\n    try {\n      if (cache instanceof Map) {\n        cache.clear()\n      } else {\n        Object.keys(cache).forEach(key => delete cache[key])\n      }\n    } catch (_e) {\n      Object.keys(cache as { [key: string]: T }).forEach(key => delete (cache as { [key: string]: T })[key])\n    }\n  }\n\n  private cacheSize<T>(cache: Map<string, T> | { [key: string]: T }): number {\n    try {\n      return cache instanceof Map ? cache.size : Object.keys(cache).length\n    } catch (_e) {\n      return Object.keys(cache).length\n    }\n  }\n\n  private cacheKeys<T>(cache: Map<string, T> | { [key: string]: T }): IterableIterator<string> | string[] {\n    try {\n      return cache instanceof Map ? cache.keys() : Object.keys(cache)\n    } catch (_e) {\n      return Object.keys(cache)\n    }\n  }\n\n  /**\n   * Process CSS classes from various input formats\n   */\n  processClasses(input: string | string[] | Signal<string | string[]>): string[] {\n    if (!input) return []\n\n    // Handle reactive signals and computed values - no caching for dynamic values\n    if (isSignal(input) || isComputed(input)) {\n      const resolved = input()\n      return this.processClasses(resolved)\n    }\n\n    // Check cache for static inputs\n    const cacheKey = this.getCacheKey(input)\n    if (this.config.enableCaching && this.cacheHas(this.classCache, cacheKey)) {\n      return this.cacheGet(this.classCache, cacheKey)!\n    }\n\n    let classes: string[] = []\n\n    // Handle string input - split on whitespace\n    if (typeof input === 'string') {\n      classes = input.trim().split(/\\s+/).filter(Boolean)\n    }\n    // Handle array input - flatten and filter, convert non-strings to strings\n    else if (Array.isArray(input)) {\n      classes = input\n        .flatMap(cls => {\n          if (cls === null || cls === undefined || cls === '') {\n            return [] // Skip null, undefined, and empty strings\n          }\n          // Convert non-strings to strings\n          const stringified = typeof cls === 'string' ? cls : String(cls)\n          const trimmed = stringified.trim()\n\n          // For non-string values that have been stringified, treat as single class name\n          // to preserve object representations like \"[object Object]\"\n          if (typeof cls !== 'string' && trimmed) {\n            return [trimmed]\n          }\n\n          // For strings, split on whitespace as normal\n          return trimmed.split(/\\s+/)\n        })\n        .filter(Boolean)\n    }\n    // Handle other types by converting to string (for edge case testing)\n    // Treat the entire stringified value as a single class name to preserve object representations\n    else {\n      const stringified = String(input).trim()\n      classes = stringified ? [stringified] : []\n    }\n\n    // Process classes through sanitization and deduplication\n    const processed = this.processClassArray(classes)\n\n    // Cache the result if caching is enabled\n    if (this.config.enableCaching) {\n      this.setCachedClasses(cacheKey, processed)\n    }\n\n    return processed\n  }\n\n  /**\n   * Process an array of class names\n   */\n  private processClassArray(classes: string[]): string[] {\n    let processed = classes\n\n    // Sanitize class names if enabled\n    if (this.config.sanitizeClassNames) {\n      processed = processed.map(cls => this.sanitizeClassName(cls))\n    }\n\n    // Remove duplicates while preserving order\n    processed = this.deduplicateClasses(processed)\n\n    // Development warnings\n    if (this.config.warnDuplicateClasses && classes.length !== processed.length) {\n      console.warn('[tachUI] Duplicate CSS classes detected and removed:',\n        classes.filter((cls, i) => classes.indexOf(cls) !== i))\n    }\n\n    return processed\n  }\n\n  /**\n   * Sanitize class name to be valid CSS identifier\n   */\n  sanitizeClassName(className: string): string {\n    if (!className || typeof className !== 'string') return ''\n\n    const rules = this.config.sanitizationRules!\n    let sanitized = className.trim()\n\n    // Handle spaces in class names\n    // CSS class names cannot contain spaces - convert them to hyphens to create valid single class names\n    if (sanitized.includes(' ')) {\n      sanitized = sanitized.replace(/\\s+/g, '-')\n      if (this.config.warnInvalidClasses) {\n        console.warn(`[tachUI] CSS class names cannot contain spaces. Converted \"${className}\" to \"${sanitized}\"`)\n      }\n    }\n\n    // Apply custom replacements first\n    Object.entries(rules.customReplacements || {}).forEach(([from, to]) => {\n      sanitized = sanitized.replace(new RegExp(from, 'g'), to)\n    })\n\n    // Build character allowlist - be more permissive for modern CSS frameworks\n    let allowedChars = 'a-zA-Z\\\\-\\\\.'  // Basic CSS characters\n    if (rules.allowNumbers) allowedChars += '0-9'\n    if (rules.allowUnderscores) allowedChars += '_'\n\n    // Allow modern CSS framework characters (Tailwind, CSS modules, etc.)\n    // : for pseudo-classes (hover:bg-blue-500)\n    // [ ] for arbitrary values ([10px])\n    // / for opacity modifiers (bg-black/50)\n    // % for percentages\n    allowedChars += ':\\\\[\\\\]/%'\n\n    // Only replace characters that are truly invalid in CSS class names\n    // Keep most characters as-is since modern CSS frameworks use many special chars\n    sanitized = sanitized.replace(new RegExp(`[^${allowedChars}]`, 'g'), '-')\n\n    // Ensure doesn't start with number (invalid CSS)\n    if (/^[0-9]/.test(sanitized)) {\n      sanitized = 'cls-' + sanitized\n    }\n\n    // Collapse excessive hyphens (3 or more) but preserve CSS custom property prefixes (--)\n    sanitized = sanitized.replace(/---+/g, '--')\n\n    // Keep leading/trailing hyphens - they are valid in CSS class names\n    // Only remove if they result from excessive collapsing (e.g., \"---\" became \"--\" then \"-\" at edges)\n\n    // Keep original case - many frameworks use camelCase and mixed case\n    // Do not convert to lowercase to preserve modern CSS framework conventions\n\n    // Warn about invalid classes in development\n    if (this.config.warnInvalidClasses && sanitized !== className.trim()) {\n      console.warn(`[tachUI] CSS class \"${className}\" sanitized to \"${sanitized}\"`)\n    }\n\n    return sanitized\n  }\n\n  /**\n   * Deduplicate classes while preserving first occurrence order\n   */\n  deduplicateClasses(classes: string[]): string[] {\n    return [...new Set(classes.filter(Boolean))]\n  }\n\n  /**\n   * Combine tachUI classes with user-provided CSS classes\n   * User classes come AFTER tachUI classes for proper CSS cascade\n   */\n  combineClasses(tachuiClasses: string[], userClasses: string[]): string[] {\n    const processedUserClasses = this.processClasses(userClasses)\n    const combined = [...tachuiClasses, ...processedUserClasses]\n    return this.deduplicateClasses(combined)\n  }\n\n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<CSSClassConfig>): void {\n    this.config = { ...this.config, ...config }\n\n    // Clear caches when config changes\n    this.clearCaches()\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): CSSClassConfig {\n    return { ...this.config }\n  }\n\n  /**\n   * Clear all caches\n   */\n  clearCaches(): void {\n    this.cacheClear(this.classCache)\n    this.cacheClear(this.processingCache)\n  }\n\n  /**\n   * Get cache statistics for debugging\n   */\n  getCacheStats(): { size: number; maxSize: number; hitRate: number } {\n    return {\n      size: this.cacheSize(this.classCache),\n      maxSize: this.config.maxCacheSize,\n      hitRate: 0 // TODO: Implement hit rate tracking if needed\n    }\n  }\n\n  /**\n   * Generate cache key for input\n   */\n  private getCacheKey(input: string | string[]): string {\n    return Array.isArray(input) ? input.join('|') : input\n  }\n\n  /**\n   * Set cached classes with LRU eviction\n   */\n  private setCachedClasses(key: string, classes: string[]): void {\n    // Implement LRU cache eviction\n    if (this.cacheSize(this.classCache) >= this.config.maxCacheSize) {\n      const keys = this.cacheKeys(this.classCache)\n      // const firstKey = keys instanceof Array ? keys[0] : keys.next().value\n      const firstKey = Array.isArray(keys) ? keys[0] : keys.next().value\n      if (firstKey !== undefined) {\n        this.cacheDelete(this.classCache, firstKey)\n      }\n    }\n\n    this.cacheSet(this.classCache, key, classes)\n  }\n}\n\n/**\n * Global CSS class manager instance\n */\nexport const cssClassManager = new CSSClassManager()\n\n/**\n * Configure global CSS class processing\n */\nexport function configureCSSClasses(config: Partial<CSSClassConfig>): void {\n  cssClassManager.updateConfig(config)\n}\n\n/**\n * Get current CSS class configuration\n */\nexport function getCSSClassConfig(): CSSClassConfig {\n  return cssClassManager.getConfig()\n}\n"],"names":["DEFAULT_CONFIG","CSSClassManager","config","__publicField","mapAvailable","cache","key","value","input","isSignal","isComputed","resolved","cacheKey","classes","cls","trimmed","stringified","processed","className","rules","sanitized","from","to","allowedChars","tachuiClasses","userClasses","processedUserClasses","combined","keys","firstKey","cssClassManager","configureCSSClasses","getCSSClassConfig"],"mappings":"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"}

package/dist/css-classes/css-class-manager.d.ts

@@ -0,0 +1,89 @@
+/**
+ * CSS Classes Enhancement - Class Manager
+ *
+ * Core CSS class processing system that handles sanitization,
+ * deduplication, and integration with tachUI components.
+ */
+import type { Signal } from '../reactive/types';
+import type { CSSClassProcessor, CSSClassConfig } from './types';
+/**
+ * CSS Class Manager - Core processing system
+ */
+export declare class CSSClassManager implements CSSClassProcessor {
+    private config;
+    private classCache;
+    private processingCache;
+    constructor(config?: Partial<CSSClassConfig>);
+    /**
+     * Cache helper methods to work with both Map and plain object fallbacks
+     */
+    private cacheHas;
+    private cacheGet;
+    private cacheSet;
+    private cacheDelete;
+    private cacheClear;
+    private cacheSize;
+    private cacheKeys;
+    /**
+     * Process CSS classes from various input formats
+     */
+    processClasses(input: string | string[] | Signal<string | string[]>): string[];
+    /**
+     * Process an array of class names
+     */
+    private processClassArray;
+    /**
+     * Sanitize class name to be valid CSS identifier
+     */
+    sanitizeClassName(className: string): string;
+    /**
+     * Deduplicate classes while preserving first occurrence order
+     */
+    deduplicateClasses(classes: string[]): string[];
+    /**
+     * Combine tachUI classes with user-provided CSS classes
+     * User classes come AFTER tachUI classes for proper CSS cascade
+     */
+    combineClasses(tachuiClasses: string[], userClasses: string[]): string[];
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CSSClassConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): CSSClassConfig;
+    /**
+     * Clear all caches
+     */
+    clearCaches(): void;
+    /**
+     * Get cache statistics for debugging
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: number;
+    };
+    /**
+     * Generate cache key for input
+     */
+    private getCacheKey;
+    /**
+     * Set cached classes with LRU eviction
+     */
+    private setCachedClasses;
+}
+/**
+ * Global CSS class manager instance
+ */
+export declare const cssClassManager: CSSClassManager;
+/**
+ * Configure global CSS class processing
+ */
+export declare function configureCSSClasses(config: Partial<CSSClassConfig>): void;
+/**
+ * Get current CSS class configuration
+ */
+export declare function getCSSClassConfig(): CSSClassConfig;
+//# sourceMappingURL=css-class-manager.d.ts.map

package/dist/css-classes/css-class-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-class-manager.d.ts","sourceRoot":"","sources":["../../src/css-classes/css-class-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEf,MAAM,SAAS,CAAA;AAkBhB;;GAEG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAqD;IACvE,OAAO,CAAC,eAAe,CAA+E;gBAE1F,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAiBhD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE;IA6D9E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IA0D5C;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAI/C;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAMxE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAOnD;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAQnE;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAazB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAA;AAEpD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAElD"}

package/dist/css-classes/css-class-manager.js

@@ -0,0 +1,209 @@
+import "../reactive/cleanup.js";
+import { isComputed as h } from "../reactive/computed.js";
+import "../reactive/unified-scheduler.js";
+import { isSignal as f } from "../reactive/signal.js";
+import "../reactive/scheduler.js";
+import "../reactive/theme.js";
+var C = Object.defineProperty, g = (r, e, s) => e in r ? C(r, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : r[e] = s, c = (r, e, s) => g(r, typeof e != "symbol" ? e + "" : e, s);
+const p = {
+  sanitizeClassNames: !0,
+  sanitizationRules: {
+    allowNumbers: !0,
+    allowUnderscores: !0,
+    customReplacements: {}
+  },
+  enableCaching: !0,
+  maxCacheSize: 1e3,
+  warnDuplicateClasses: process.env.NODE_ENV === "development",
+  warnInvalidClasses: process.env.NODE_ENV === "development"
+};
+class d {
+  constructor(e = {}) {
+    c(this, "config"), c(this, "classCache"), c(this, "processingCache"), this.config = { ...p, ...e };
+    const s = (() => {
+      try {
+        return typeof Map < "u" && typeof Map == "function";
+      } catch {
+        return !1;
+      }
+    })();
+    this.classCache = s ? /* @__PURE__ */ new Map() : {}, this.processingCache = s ? /* @__PURE__ */ new Map() : {};
+  }
+  /**
+   * Cache helper methods to work with both Map and plain object fallbacks
+   */
+  cacheHas(e, s) {
+    try {
+      return e instanceof Map ? e.has(s) : s in e;
+    } catch {
+      return s in e;
+    }
+  }
+  cacheGet(e, s) {
+    try {
+      return e instanceof Map ? e.get(s) : e[s];
+    } catch {
+      return e[s];
+    }
+  }
+  cacheSet(e, s, t) {
+    try {
+      e instanceof Map ? e.set(s, t) : e[s] = t;
+    } catch {
+      e[s] = t;
+    }
+  }
+  cacheDelete(e, s) {
+    try {
+      e instanceof Map ? e.delete(s) : delete e[s];
+    } catch {
+      delete e[s];
+    }
+  }
+  cacheClear(e) {
+    try {
+      e instanceof Map ? e.clear() : Object.keys(e).forEach((s) => delete e[s]);
+    } catch {
+      Object.keys(e).forEach((t) => delete e[t]);
+    }
+  }
+  cacheSize(e) {
+    try {
+      return e instanceof Map ? e.size : Object.keys(e).length;
+    } catch {
+      return Object.keys(e).length;
+    }
+  }
+  cacheKeys(e) {
+    try {
+      return e instanceof Map ? e.keys() : Object.keys(e);
+    } catch {
+      return Object.keys(e);
+    }
+  }
+  /**
+   * Process CSS classes from various input formats
+   */
+  processClasses(e) {
+    if (!e) return [];
+    if (f(e) || h(e)) {
+      const a = e();
+      return this.processClasses(a);
+    }
+    const s = this.getCacheKey(e);
+    if (this.config.enableCaching && this.cacheHas(this.classCache, s))
+      return this.cacheGet(this.classCache, s);
+    let t = [];
+    if (typeof e == "string")
+      t = e.trim().split(/\s+/).filter(Boolean);
+    else if (Array.isArray(e))
+      t = e.flatMap((a) => {
+        if (a == null || a === "")
+          return [];
+        const n = (typeof a == "string" ? a : String(a)).trim();
+        return typeof a != "string" && n ? [n] : n.split(/\s+/);
+      }).filter(Boolean);
+    else {
+      const a = String(e).trim();
+      t = a ? [a] : [];
+    }
+    const i = this.processClassArray(t);
+    return this.config.enableCaching && this.setCachedClasses(s, i), i;
+  }
+  /**
+   * Process an array of class names
+   */
+  processClassArray(e) {
+    let s = e;
+    return this.config.sanitizeClassNames && (s = s.map((t) => this.sanitizeClassName(t))), s = this.deduplicateClasses(s), this.config.warnDuplicateClasses && e.length !== s.length && console.warn(
+      "[tachUI] Duplicate CSS classes detected and removed:",
+      e.filter((t, i) => e.indexOf(t) !== i)
+    ), s;
+  }
+  /**
+   * Sanitize class name to be valid CSS identifier
+   */
+  sanitizeClassName(e) {
+    if (!e || typeof e != "string") return "";
+    const s = this.config.sanitizationRules;
+    let t = e.trim();
+    t.includes(" ") && (t = t.replace(/\s+/g, "-"), this.config.warnInvalidClasses && console.warn(`[tachUI] CSS class names cannot contain spaces. Converted "${e}" to "${t}"`)), Object.entries(s.customReplacements || {}).forEach(([a, o]) => {
+      t = t.replace(new RegExp(a, "g"), o);
+    });
+    let i = "a-zA-Z\\-\\.";
+    return s.allowNumbers && (i += "0-9"), s.allowUnderscores && (i += "_"), i += ":\\[\\]/%", t = t.replace(new RegExp(`[^${i}]`, "g"), "-"), /^[0-9]/.test(t) && (t = "cls-" + t), t = t.replace(/---+/g, "--"), this.config.warnInvalidClasses && t !== e.trim() && console.warn(`[tachUI] CSS class "${e}" sanitized to "${t}"`), t;
+  }
+  /**
+   * Deduplicate classes while preserving first occurrence order
+   */
+  deduplicateClasses(e) {
+    return [...new Set(e.filter(Boolean))];
+  }
+  /**
+   * Combine tachUI classes with user-provided CSS classes
+   * User classes come AFTER tachUI classes for proper CSS cascade
+   */
+  combineClasses(e, s) {
+    const t = this.processClasses(s), i = [...e, ...t];
+    return this.deduplicateClasses(i);
+  }
+  /**
+   * Update configuration
+   */
+  updateConfig(e) {
+    this.config = { ...this.config, ...e }, this.clearCaches();
+  }
+  /**
+   * Get current configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Clear all caches
+   */
+  clearCaches() {
+    this.cacheClear(this.classCache), this.cacheClear(this.processingCache);
+  }
+  /**
+   * Get cache statistics for debugging
+   */
+  getCacheStats() {
+    return {
+      size: this.cacheSize(this.classCache),
+      maxSize: this.config.maxCacheSize,
+      hitRate: 0
+      // TODO: Implement hit rate tracking if needed
+    };
+  }
+  /**
+   * Generate cache key for input
+   */
+  getCacheKey(e) {
+    return Array.isArray(e) ? e.join("|") : e;
+  }
+  /**
+   * Set cached classes with LRU eviction
+   */
+  setCachedClasses(e, s) {
+    if (this.cacheSize(this.classCache) >= this.config.maxCacheSize) {
+      const t = this.cacheKeys(this.classCache), i = Array.isArray(t) ? t[0] : t.next().value;
+      i !== void 0 && this.cacheDelete(this.classCache, i);
+    }
+    this.cacheSet(this.classCache, e, s);
+  }
+}
+const l = new d();
+function z(r) {
+  l.updateConfig(r);
+}
+function _() {
+  return l.getConfig();
+}
+export {
+  d as CSSClassManager,
+  z as configureCSSClasses,
+  l as cssClassManager,
+  _ as getCSSClassConfig
+};
+//# sourceMappingURL=css-class-manager.js.map