@tachui/core 0.7.0-alpha1

package/dist/css-classes/utilities.js

@@ -0,0 +1,41 @@
+import { cssClassManager as r } from "./css-class-manager.js";
+function l() {
+  return {
+    combineClasses(...t) {
+      const s = [];
+      return t.forEach((e) => {
+        if (e) {
+          const a = r.processClasses(e);
+          s.push(...a);
+        }
+      }), r.deduplicateClasses(s).join(" ");
+    },
+    conditionalClasses(t) {
+      return Object.entries(t).filter(([s, e]) => e).map(([s, e]) => s);
+    },
+    mergeClassProps(...t) {
+      const s = [];
+      return t.forEach((e) => {
+        if (e?.css) {
+          const a = r.processClasses(e.css);
+          s.push(...a);
+        }
+      }), s.length === 0 ? {} : {
+        css: r.deduplicateClasses(s)
+      };
+    },
+    extractClasses(t) {
+      return r.processClasses(t);
+    },
+    validateClassNames(t) {
+      const s = [], e = [];
+      return t.forEach((a) => {
+        r.sanitizeClassName(a) === a.toLowerCase() ? s.push(a) : e.push(a);
+      }), { valid: s, invalid: e };
+    }
+  };
+}
+export {
+  l as createCSSClassUtilities
+};
+//# sourceMappingURL=utilities.js.map

package/dist/css-classes/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sources":["../../src/css-classes/utilities.ts"],"sourcesContent":["/**\n * CSS Classes Enhancement - Utilities\n * \n * Utility functions for CSS class processing and common patterns.\n */\n\nimport { cssClassManager } from './css-class-manager'\nimport type { CSSClassesProps } from './types'\n\n/**\n * Utility functions for CSS class operations\n */\nexport interface CSSClassUtilities {\n  /**\n   * Combine multiple class sources into a single class string\n   */\n  combineClasses(...sources: (string | string[] | undefined)[]): string\n\n  /**\n   * Create conditional classes based on boolean conditions\n   */\n  conditionalClasses(conditions: Record<string, boolean>): string[]\n\n  /**\n   * Merge CSS class props from multiple sources\n   */\n  mergeClassProps(...props: (CSSClassesProps | undefined)[]): CSSClassesProps\n\n  /**\n   * Extract unique classes from a class string\n   */\n  extractClasses(classString: string): string[]\n\n  /**\n   * Validate CSS class names\n   */\n  validateClassNames(classes: string[]): { valid: string[], invalid: string[] }\n}\n\n/**\n * Create CSS class utilities instance\n */\nexport function createCSSClassUtilities(): CSSClassUtilities {\n  return {\n    combineClasses(...sources: (string | string[] | undefined)[]): string {\n      const allClasses: string[] = []\n      \n      sources.forEach(source => {\n        if (source) {\n          const processed = cssClassManager.processClasses(source)\n          allClasses.push(...processed)\n        }\n      })\n      \n      return cssClassManager.deduplicateClasses(allClasses).join(' ')\n    },\n\n    conditionalClasses(conditions: Record<string, boolean>): string[] {\n      return Object.entries(conditions)\n        .filter(([_, condition]) => condition)\n        .map(([className, _]) => className)\n    },\n\n    mergeClassProps(...props: (CSSClassesProps | undefined)[]): CSSClassesProps {\n      const allClasses: string[] = []\n      \n      props.forEach(prop => {\n        if (prop?.css) {\n          const processed = cssClassManager.processClasses(prop.css)\n          allClasses.push(...processed)\n        }\n      })\n      \n      if (allClasses.length === 0) {\n        return {}\n      }\n      \n      return {\n        css: cssClassManager.deduplicateClasses(allClasses)\n      }\n    },\n\n    extractClasses(classString: string): string[] {\n      return cssClassManager.processClasses(classString)\n    },\n\n    validateClassNames(classes: string[]): { valid: string[], invalid: string[] } {\n      const valid: string[] = []\n      const invalid: string[] = []\n      \n      classes.forEach(className => {\n        const sanitized = cssClassManager.sanitizeClassName(className)\n        if (sanitized === className.toLowerCase()) {\n          valid.push(className)\n        } else {\n          invalid.push(className)\n        }\n      })\n      \n      return { valid, invalid }\n    }\n  }\n}\n\n/**\n * Default CSS class utilities instance\n */\nexport const cssClassUtils = createCSSClassUtilities()\n\n/**\n * Common CSS class patterns for popular frameworks\n */\nexport const CSSPatterns = {\n  /**\n   * Tailwind CSS utility patterns\n   */\n  tailwind: {\n    flexCenter: 'flex items-center justify-center',\n    flexBetween: 'flex items-center justify-between',\n    absoluteCenter: 'absolute top-1/2 left-1/2 transform -translate-x-1/2 -translate-y-1/2',\n    srOnly: 'sr-only',\n    card: 'bg-white rounded-lg shadow-md p-6',\n    btn: {\n      primary: 'bg-blue-500 hover:bg-blue-600 text-white px-4 py-2 rounded transition-colors',\n      secondary: 'bg-gray-500 hover:bg-gray-600 text-white px-4 py-2 rounded transition-colors',\n      outline: 'border border-blue-500 text-blue-500 hover:bg-blue-50 px-4 py-2 rounded transition-colors'\n    }\n  },\n\n  /**\n   * Bootstrap component patterns\n   */\n  bootstrap: {\n    flexCenter: 'd-flex align-items-center justify-content-center',\n    flexBetween: 'd-flex align-items-center justify-content-between',\n    srOnly: 'visually-hidden',\n    card: 'card',\n    btn: {\n      primary: 'btn btn-primary',\n      secondary: 'btn btn-secondary',\n      outline: 'btn btn-outline-primary'\n    }\n  }\n}\n\n/**\n * Framework-specific class builders\n */\nexport const FrameworkBuilders = {\n  /**\n   * Tailwind CSS class builder\n   */\n  tailwind: {\n    spacing: (value: number) => `p-${value}`,\n    margin: (value: number) => `m-${value}`,\n    textSize: (size: 'xs' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl') => `text-${size}`,\n    backgroundColor: (color: string) => `bg-${color}`,\n    textColor: (color: string) => `text-${color}`,\n    rounded: (size: 'none' | 'sm' | 'base' | 'md' | 'lg' | 'xl' | 'full' = 'base') => \n      size === 'base' ? 'rounded' : `rounded-${size}`\n  },\n\n  /**\n   * Bootstrap class builder\n   */\n  bootstrap: {\n    spacing: (value: 1 | 2 | 3 | 4 | 5) => `p-${value}`,\n    margin: (value: 1 | 2 | 3 | 4 | 5) => `m-${value}`,\n    textSize: (size: 1 | 2 | 3 | 4 | 5 | 6) => `h${size}`,\n    backgroundColor: (color: string) => `bg-${color}`,\n    textColor: (color: string) => `text-${color}`,\n    rounded: (size: 0 | 1 | 2 | 3 | 'circle' | 'pill' = 1) => \n      typeof size === 'number' ? `rounded-${size}` : `rounded-${size}`\n  }\n}"],"names":["createCSSClassUtilities","sources","allClasses","source","processed","cssClassManager","conditions","_","condition","className","props","prop","classString","classes","valid","invalid"],"mappings":";AA0CO,SAASA,IAA6C;AAC3D,SAAO;AAAA,IACL,kBAAkBC,GAAoD;AACpE,YAAMC,IAAuB,CAAA;AAE7B,aAAAD,EAAQ,QAAQ,CAAAE,MAAU;AACxB,YAAIA,GAAQ;AACV,gBAAMC,IAAYC,EAAgB,eAAeF,CAAM;AACvD,UAAAD,EAAW,KAAK,GAAGE,CAAS;AAAA,QAC9B;AAAA,MACF,CAAC,GAEMC,EAAgB,mBAAmBH,CAAU,EAAE,KAAK,GAAG;AAAA,IAChE;AAAA,IAEA,mBAAmBI,GAA+C;AAChE,aAAO,OAAO,QAAQA,CAAU,EAC7B,OAAO,CAAC,CAACC,GAAGC,CAAS,MAAMA,CAAS,EACpC,IAAI,CAAC,CAACC,GAAWF,CAAC,MAAME,CAAS;AAAA,IACtC;AAAA,IAEA,mBAAmBC,GAAyD;AAC1E,YAAMR,IAAuB,CAAA;AAS7B,aAPAQ,EAAM,QAAQ,CAAAC,MAAQ;AACpB,YAAIA,GAAM,KAAK;AACb,gBAAMP,IAAYC,EAAgB,eAAeM,EAAK,GAAG;AACzD,UAAAT,EAAW,KAAK,GAAGE,CAAS;AAAA,QAC9B;AAAA,MACF,CAAC,GAEGF,EAAW,WAAW,IACjB,CAAA,IAGF;AAAA,QACL,KAAKG,EAAgB,mBAAmBH,CAAU;AAAA,MAAA;AAAA,IAEtD;AAAA,IAEA,eAAeU,GAA+B;AAC5C,aAAOP,EAAgB,eAAeO,CAAW;AAAA,IACnD;AAAA,IAEA,mBAAmBC,GAA2D;AAC5E,YAAMC,IAAkB,CAAA,GAClBC,IAAoB,CAAA;AAE1B,aAAAF,EAAQ,QAAQ,CAAAJ,MAAa;AAE3B,QADkBJ,EAAgB,kBAAkBI,CAAS,MAC3CA,EAAU,gBAC1BK,EAAM,KAAKL,CAAS,IAEpBM,EAAQ,KAAKN,CAAS;AAAA,MAE1B,CAAC,GAEM,EAAE,OAAAK,GAAO,SAAAC,EAAA;AAAA,IAClB;AAAA,EAAA;AAEJ;"}

package/dist/debug/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * TachUI Debug System
+ *
+ * Provides visual debugging tools for component hierarchy and layout
+ */
+export interface DebugConfig {
+    enabled: boolean;
+    showLabels: boolean;
+    showBounds: boolean;
+    logComponentTree: boolean;
+}
+declare class DebugManager {
+    private config;
+    private componentTree;
+    /**
+     * Enable debug mode with optional configuration
+     */
+    enable(options?: Partial<DebugConfig>): void;
+    /**
+     * Disable debug mode
+     */
+    disable(): void;
+    /**
+     * Check if debug mode is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Get current debug configuration
+     */
+    getConfig(): DebugConfig;
+    /**
+     * Add debug attributes to DOM element
+     */
+    addDebugAttributes(element: HTMLElement, componentType: string, debugLabel?: string): void;
+    /**
+     * Log component to tree (for hierarchical debugging)
+     */
+    logComponent(type: string, label?: string, depth?: number): void;
+    /**
+     * Print component tree to console
+     */
+    printComponentTree(): void;
+    /**
+     * Get icon for component type
+     */
+    private getComponentIcon;
+    /**
+     * Inject debug CSS styles
+     */
+    private injectDebugStyles;
+    /**
+     * Remove debug CSS styles
+     */
+    private removeDebugStyles;
+}
+export declare const debugManager: DebugManager;
+export declare const enableDebug: (options?: Partial<DebugConfig>) => void;
+export declare const disableDebug: () => void;
+export declare const isDebugEnabled: () => boolean;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAKb;IAED,OAAO,CAAC,aAAa,CAA4D;IAEjF;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,IAAI;IAkBhD;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB1F;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAUnE;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAe1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6DzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAW1B;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,eAAO,MAAM,WAAW,GAAI,UAAU,OAAO,CAAC,WAAW,CAAC,SAAiC,CAAA;AAC3F,eAAO,MAAM,YAAY,YAA+B,CAAA;AACxD,eAAO,MAAM,cAAc,eAAiC,CAAA"}

package/dist/debug.cjs

@@ -0,0 +1,52 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var r=Object.defineProperty,u=(o,e,t)=>e in o?r(o,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):o[e]=t,s=(o,e,t)=>u(o,typeof e!="symbol"?e+"":e,t);class d{constructor(){s(this,"config",{enabled:!1,showLabels:!1,showBounds:!1,logComponentTree:!1}),s(this,"componentTree",[])}enable(e={}){this.config={enabled:!0,showLabels:!0,showBounds:!0,logComponentTree:!0,...e},this.config.enabled&&this.injectDebugStyles()}disable(){this.config.enabled=!1,this.removeDebugStyles()}isEnabled(){return this.config.enabled}getConfig(){return{...this.config}}addDebugAttributes(e,t,n){this.config.enabled&&(e.setAttribute("data-tachui-component",t),n&&e.setAttribute("data-tachui-label",n),(this.config.showLabels||this.config.showBounds)&&e.classList.add("tachui-debug"),this.config.showLabels&&n&&e.classList.add("tachui-debug-labeled"),this.config.showBounds&&e.classList.add("tachui-debug-bounds"))}logComponent(e,t,n=0){!this.config.enabled||!this.config.logComponentTree||this.componentTree.push({label:t||`<${e}>`,type:e,depth:n})}printComponentTree(){!this.config.enabled||!this.config.logComponentTree||(console.group("🌳 TachUI Component Tree:"),this.componentTree.forEach(({label:e,type:t,depth:n})=>{const i="  ".repeat(n),l=this.getComponentIcon(t);console.log(`${i}${l} ${t}: "${e}"`)}),console.groupEnd(),this.componentTree=[])}getComponentIcon(e){const t={VStack:"📚",HStack:"➡️",ZStack:"📑",Button:"🔘",Text:"📝",Image:"🖼️",ScrollView:"📜",List:"📋",Form:"📋",Section:"📁",default:"🧩"};return t[e]||t.default}injectDebugStyles(){if(document.getElementById("tachui-debug-styles"))return;const e=`
+      /* TachUI Debug Styles */
+      .tachui-debug {
+        position: relative;
+      }
+
+      .tachui-debug-bounds {
+        outline: 1px dashed rgba(255, 0, 0, 0.3) !important;
+        outline-offset: -1px;
+      }
+
+      .tachui-debug-labeled::before {
+        content: attr(data-tachui-label);
+        position: absolute;
+        top: -1px;
+        left: -1px;
+        background: rgba(255, 0, 0, 0.9);
+        color: white;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 10px;
+        font-weight: bold;
+        line-height: 1;
+        padding: 2px 4px;
+        border-radius: 2px;
+        z-index: 9999;
+        pointer-events: none;
+        white-space: nowrap;
+        max-width: 200px;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .tachui-debug-labeled:hover::before {
+        background: rgba(255, 0, 0, 1);
+        max-width: none;
+        white-space: normal;
+      }
+
+      /* Component type indicators */
+      [data-tachui-component="VStack"] {
+        border-left: 2px solid rgba(0, 255, 0, 0.5) !important;
+      }
+
+      [data-tachui-component="HStack"] {
+        border-top: 2px solid rgba(0, 0, 255, 0.5) !important;
+      }
+
+      [data-tachui-component="Button"] {
+        box-shadow: inset 0 0 0 1px rgba(255, 165, 0, 0.5) !important;
+      }
+    `,t=document.createElement("style");t.id="tachui-debug-styles",t.textContent=e,document.head.appendChild(t)}removeDebugStyles(){const e=document.getElementById("tachui-debug-styles");e&&e.remove(),document.querySelectorAll(".tachui-debug").forEach(t=>{t.classList.remove("tachui-debug","tachui-debug-labeled","tachui-debug-bounds")})}}const a=new d,c=o=>a.enable(o),b=()=>a.disable(),g=()=>a.isEnabled();if(typeof window<"u"){const e=new URLSearchParams(window.location.search).get("debug");e==="true"||e==="1"?(a.enable({enabled:!0,showLabels:!0,showBounds:!0,logComponentTree:!0}),console.log("🔧 TachUI Debug Mode: Enabled via URL parameter (?debug=true)")):e==="labels"?(a.enable({enabled:!0,showLabels:!0,showBounds:!1,logComponentTree:!1}),console.log("🔧 TachUI Debug Mode: Labels only (?debug=labels)")):e==="bounds"&&(a.enable({enabled:!0,showLabels:!1,showBounds:!0,logComponentTree:!1}),console.log("🔧 TachUI Debug Mode: Bounds only (?debug=bounds)"))}exports.debugManager=a;exports.disableDebug=b;exports.enableDebug=c;exports.isDebugEnabled=g;
+//# sourceMappingURL=debug.cjs.map

package/dist/debug.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.cjs","sources":["../src/debug/index.ts"],"sourcesContent":["/**\n * TachUI Debug System\n * \n * Provides visual debugging tools for component hierarchy and layout\n */\n\nexport interface DebugConfig {\n  enabled: boolean\n  showLabels: boolean\n  showBounds: boolean\n  logComponentTree: boolean\n}\n\nclass DebugManager {\n  private config: DebugConfig = {\n    enabled: false,\n    showLabels: false,\n    showBounds: false,\n    logComponentTree: false\n  }\n\n  private componentTree: Array<{ label: string; type: string; depth: number }> = []\n\n  /**\n   * Enable debug mode with optional configuration\n   */\n  enable(options: Partial<DebugConfig> = {}): void {\n    this.config = {\n      enabled: true,\n      showLabels: true,\n      showBounds: true,\n      logComponentTree: true,\n      ...options\n    }\n\n    if (this.config.enabled) {\n      this.injectDebugStyles()\n      // Only log in development mode\n      if (typeof import.meta !== 'undefined' && (import.meta as any).env?.DEV) {\n        console.log('🔧 TachUI Debug Mode Enabled')\n      }\n    }\n  }\n\n  /**\n   * Disable debug mode\n   */\n  disable(): void {\n    this.config.enabled = false\n    this.removeDebugStyles()\n    if (typeof import.meta !== 'undefined' && (import.meta as any).env?.DEV) {\n      console.log('🔧 TachUI Debug Mode Disabled')\n    }\n  }\n\n  /**\n   * Check if debug mode is enabled\n   */\n  isEnabled(): boolean {\n    return this.config.enabled\n  }\n\n  /**\n   * Get current debug configuration\n   */\n  getConfig(): DebugConfig {\n    return { ...this.config }\n  }\n\n  /**\n   * Add debug attributes to DOM element\n   */\n  addDebugAttributes(element: HTMLElement, componentType: string, debugLabel?: string): void {\n    if (!this.config.enabled) return\n\n    element.setAttribute('data-tachui-component', componentType)\n    \n    if (debugLabel) {\n      element.setAttribute('data-tachui-label', debugLabel)\n    }\n\n    if (this.config.showLabels || this.config.showBounds) {\n      element.classList.add('tachui-debug')\n    }\n\n    if (this.config.showLabels && debugLabel) {\n      element.classList.add('tachui-debug-labeled')\n    }\n\n    if (this.config.showBounds) {\n      element.classList.add('tachui-debug-bounds')\n    }\n  }\n\n  /**\n   * Log component to tree (for hierarchical debugging)\n   */\n  logComponent(type: string, label?: string, depth: number = 0): void {\n    if (!this.config.enabled || !this.config.logComponentTree) return\n\n    this.componentTree.push({\n      label: label || `<${type}>`,\n      type,\n      depth\n    })\n  }\n\n  /**\n   * Print component tree to console\n   */\n  printComponentTree(): void {\n    if (!this.config.enabled || !this.config.logComponentTree) return\n\n    console.group('🌳 TachUI Component Tree:')\n    this.componentTree.forEach(({ label, type, depth }) => {\n      const indent = '  '.repeat(depth)\n      const icon = this.getComponentIcon(type)\n      console.log(`${indent}${icon} ${type}: \"${label}\"`)\n    })\n    console.groupEnd()\n    \n    // Clear tree for next render cycle\n    this.componentTree = []\n  }\n\n  /**\n   * Get icon for component type\n   */\n  private getComponentIcon(type: string): string {\n    const icons: Record<string, string> = {\n      VStack: '📚',\n      HStack: '➡️',\n      ZStack: '📑',\n      Button: '🔘',\n      Text: '📝',\n      Image: '🖼️',\n      ScrollView: '📜',\n      List: '📋',\n      Form: '📋',\n      Section: '📁',\n      default: '🧩'\n    }\n    return icons[type] || icons.default\n  }\n\n  /**\n   * Inject debug CSS styles\n   */\n  private injectDebugStyles(): void {\n    if (document.getElementById('tachui-debug-styles')) return\n\n    const styles = `\n      /* TachUI Debug Styles */\n      .tachui-debug {\n        position: relative;\n      }\n\n      .tachui-debug-bounds {\n        outline: 1px dashed rgba(255, 0, 0, 0.3) !important;\n        outline-offset: -1px;\n      }\n\n      .tachui-debug-labeled::before {\n        content: attr(data-tachui-label);\n        position: absolute;\n        top: -1px;\n        left: -1px;\n        background: rgba(255, 0, 0, 0.9);\n        color: white;\n        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;\n        font-size: 10px;\n        font-weight: bold;\n        line-height: 1;\n        padding: 2px 4px;\n        border-radius: 2px;\n        z-index: 9999;\n        pointer-events: none;\n        white-space: nowrap;\n        max-width: 200px;\n        overflow: hidden;\n        text-overflow: ellipsis;\n      }\n\n      .tachui-debug-labeled:hover::before {\n        background: rgba(255, 0, 0, 1);\n        max-width: none;\n        white-space: normal;\n      }\n\n      /* Component type indicators */\n      [data-tachui-component=\"VStack\"] {\n        border-left: 2px solid rgba(0, 255, 0, 0.5) !important;\n      }\n\n      [data-tachui-component=\"HStack\"] {\n        border-top: 2px solid rgba(0, 0, 255, 0.5) !important;\n      }\n\n      [data-tachui-component=\"Button\"] {\n        box-shadow: inset 0 0 0 1px rgba(255, 165, 0, 0.5) !important;\n      }\n    `\n\n    const styleElement = document.createElement('style')\n    styleElement.id = 'tachui-debug-styles'\n    styleElement.textContent = styles\n    document.head.appendChild(styleElement)\n  }\n\n  /**\n   * Remove debug CSS styles\n   */\n  private removeDebugStyles(): void {\n    const styleElement = document.getElementById('tachui-debug-styles')\n    if (styleElement) {\n      styleElement.remove()\n    }\n\n    // Remove debug classes from all elements\n    document.querySelectorAll('.tachui-debug').forEach(el => {\n      el.classList.remove('tachui-debug', 'tachui-debug-labeled', 'tachui-debug-bounds')\n    })\n  }\n}\n\n// Global debug instance\nexport const debugManager = new DebugManager()\n\n// Convenience functions\nexport const enableDebug = (options?: Partial<DebugConfig>) => debugManager.enable(options)\nexport const disableDebug = () => debugManager.disable()\nexport const isDebugEnabled = () => debugManager.isEnabled()\n\n// Auto-enable debug mode based on URL parameters\nif (typeof window !== 'undefined') {\n  const urlParams = new URLSearchParams(window.location.search)\n  const debugParam = urlParams.get('debug')\n  \n  if (debugParam === 'true' || debugParam === '1') {\n    // Enable full debug mode\n    debugManager.enable({\n      enabled: true,\n      showLabels: true,\n      showBounds: true,\n      logComponentTree: true\n    })\n    console.log('🔧 TachUI Debug Mode: Enabled via URL parameter (?debug=true)')\n  } else if (debugParam === 'labels') {\n    // Enable only labels\n    debugManager.enable({\n      enabled: true,\n      showLabels: true,\n      showBounds: false,\n      logComponentTree: false\n    })\n    console.log('🔧 TachUI Debug Mode: Labels only (?debug=labels)')\n  } else if (debugParam === 'bounds') {\n    // Enable only bounds\n    debugManager.enable({\n      enabled: true,\n      showLabels: false,\n      showBounds: true,\n      logComponentTree: false\n    })\n    console.log('🔧 TachUI Debug Mode: Bounds only (?debug=bounds)')\n  }\n}"],"names":["DebugManager","__publicField","options","element","componentType","debugLabel","type","label","depth","indent","icon","icons","styles","styleElement","el","debugManager","enableDebug","disableDebug","isDebugEnabled","debugParam"],"mappings":"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"}

package/dist/debug.js

@@ -0,0 +1,179 @@
+var r = Object.defineProperty, u = (o, e, t) => e in o ? r(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t, s = (o, e, t) => u(o, typeof e != "symbol" ? e + "" : e, t);
+class d {
+  constructor() {
+    s(this, "config", {
+      enabled: !1,
+      showLabels: !1,
+      showBounds: !1,
+      logComponentTree: !1
+    }), s(this, "componentTree", []);
+  }
+  /**
+   * Enable debug mode with optional configuration
+   */
+  enable(e = {}) {
+    this.config = {
+      enabled: !0,
+      showLabels: !0,
+      showBounds: !0,
+      logComponentTree: !0,
+      ...e
+    }, this.config.enabled && this.injectDebugStyles();
+  }
+  /**
+   * Disable debug mode
+   */
+  disable() {
+    this.config.enabled = !1, this.removeDebugStyles();
+  }
+  /**
+   * Check if debug mode is enabled
+   */
+  isEnabled() {
+    return this.config.enabled;
+  }
+  /**
+   * Get current debug configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Add debug attributes to DOM element
+   */
+  addDebugAttributes(e, t, n) {
+    this.config.enabled && (e.setAttribute("data-tachui-component", t), n && e.setAttribute("data-tachui-label", n), (this.config.showLabels || this.config.showBounds) && e.classList.add("tachui-debug"), this.config.showLabels && n && e.classList.add("tachui-debug-labeled"), this.config.showBounds && e.classList.add("tachui-debug-bounds"));
+  }
+  /**
+   * Log component to tree (for hierarchical debugging)
+   */
+  logComponent(e, t, n = 0) {
+    !this.config.enabled || !this.config.logComponentTree || this.componentTree.push({
+      label: t || `<${e}>`,
+      type: e,
+      depth: n
+    });
+  }
+  /**
+   * Print component tree to console
+   */
+  printComponentTree() {
+    !this.config.enabled || !this.config.logComponentTree || (console.group("🌳 TachUI Component Tree:"), this.componentTree.forEach(({ label: e, type: t, depth: n }) => {
+      const i = "  ".repeat(n), l = this.getComponentIcon(t);
+      console.log(`${i}${l} ${t}: "${e}"`);
+    }), console.groupEnd(), this.componentTree = []);
+  }
+  /**
+   * Get icon for component type
+   */
+  getComponentIcon(e) {
+    const t = {
+      VStack: "📚",
+      HStack: "➡️",
+      ZStack: "📑",
+      Button: "🔘",
+      Text: "📝",
+      Image: "🖼️",
+      ScrollView: "📜",
+      List: "📋",
+      Form: "📋",
+      Section: "📁",
+      default: "🧩"
+    };
+    return t[e] || t.default;
+  }
+  /**
+   * Inject debug CSS styles
+   */
+  injectDebugStyles() {
+    if (document.getElementById("tachui-debug-styles")) return;
+    const e = `
+      /* TachUI Debug Styles */
+      .tachui-debug {
+        position: relative;
+      }
+
+      .tachui-debug-bounds {
+        outline: 1px dashed rgba(255, 0, 0, 0.3) !important;
+        outline-offset: -1px;
+      }
+
+      .tachui-debug-labeled::before {
+        content: attr(data-tachui-label);
+        position: absolute;
+        top: -1px;
+        left: -1px;
+        background: rgba(255, 0, 0, 0.9);
+        color: white;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 10px;
+        font-weight: bold;
+        line-height: 1;
+        padding: 2px 4px;
+        border-radius: 2px;
+        z-index: 9999;
+        pointer-events: none;
+        white-space: nowrap;
+        max-width: 200px;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .tachui-debug-labeled:hover::before {
+        background: rgba(255, 0, 0, 1);
+        max-width: none;
+        white-space: normal;
+      }
+
+      /* Component type indicators */
+      [data-tachui-component="VStack"] {
+        border-left: 2px solid rgba(0, 255, 0, 0.5) !important;
+      }
+
+      [data-tachui-component="HStack"] {
+        border-top: 2px solid rgba(0, 0, 255, 0.5) !important;
+      }
+
+      [data-tachui-component="Button"] {
+        box-shadow: inset 0 0 0 1px rgba(255, 165, 0, 0.5) !important;
+      }
+    `, t = document.createElement("style");
+    t.id = "tachui-debug-styles", t.textContent = e, document.head.appendChild(t);
+  }
+  /**
+   * Remove debug CSS styles
+   */
+  removeDebugStyles() {
+    const e = document.getElementById("tachui-debug-styles");
+    e && e.remove(), document.querySelectorAll(".tachui-debug").forEach((t) => {
+      t.classList.remove("tachui-debug", "tachui-debug-labeled", "tachui-debug-bounds");
+    });
+  }
+}
+const a = new d(), c = (o) => a.enable(o), b = () => a.disable(), g = () => a.isEnabled();
+if (typeof window < "u") {
+  const e = new URLSearchParams(window.location.search).get("debug");
+  e === "true" || e === "1" ? (a.enable({
+    enabled: !0,
+    showLabels: !0,
+    showBounds: !0,
+    logComponentTree: !0
+  }), console.log("🔧 TachUI Debug Mode: Enabled via URL parameter (?debug=true)")) : e === "labels" ? (a.enable({
+    enabled: !0,
+    showLabels: !0,
+    showBounds: !1,
+    logComponentTree: !1
+  }), console.log("🔧 TachUI Debug Mode: Labels only (?debug=labels)")) : e === "bounds" && (a.enable({
+    enabled: !0,
+    showLabels: !1,
+    showBounds: !0,
+    logComponentTree: !1
+  }), console.log("🔧 TachUI Debug Mode: Bounds only (?debug=bounds)"));
+}
+export {
+  a as debugManager,
+  b as disableDebug,
+  c as enableDebug,
+  g as isDebugEnabled
+};
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sources":["../src/debug/index.ts"],"sourcesContent":["/**\n * TachUI Debug System\n * \n * Provides visual debugging tools for component hierarchy and layout\n */\n\nexport interface DebugConfig {\n  enabled: boolean\n  showLabels: boolean\n  showBounds: boolean\n  logComponentTree: boolean\n}\n\nclass DebugManager {\n  private config: DebugConfig = {\n    enabled: false,\n    showLabels: false,\n    showBounds: false,\n    logComponentTree: false\n  }\n\n  private componentTree: Array<{ label: string; type: string; depth: number }> = []\n\n  /**\n   * Enable debug mode with optional configuration\n   */\n  enable(options: Partial<DebugConfig> = {}): void {\n    this.config = {\n      enabled: true,\n      showLabels: true,\n      showBounds: true,\n      logComponentTree: true,\n      ...options\n    }\n\n    if (this.config.enabled) {\n      this.injectDebugStyles()\n      // Only log in development mode\n      if (typeof import.meta !== 'undefined' && (import.meta as any).env?.DEV) {\n        console.log('🔧 TachUI Debug Mode Enabled')\n      }\n    }\n  }\n\n  /**\n   * Disable debug mode\n   */\n  disable(): void {\n    this.config.enabled = false\n    this.removeDebugStyles()\n    if (typeof import.meta !== 'undefined' && (import.meta as any).env?.DEV) {\n      console.log('🔧 TachUI Debug Mode Disabled')\n    }\n  }\n\n  /**\n   * Check if debug mode is enabled\n   */\n  isEnabled(): boolean {\n    return this.config.enabled\n  }\n\n  /**\n   * Get current debug configuration\n   */\n  getConfig(): DebugConfig {\n    return { ...this.config }\n  }\n\n  /**\n   * Add debug attributes to DOM element\n   */\n  addDebugAttributes(element: HTMLElement, componentType: string, debugLabel?: string): void {\n    if (!this.config.enabled) return\n\n    element.setAttribute('data-tachui-component', componentType)\n    \n    if (debugLabel) {\n      element.setAttribute('data-tachui-label', debugLabel)\n    }\n\n    if (this.config.showLabels || this.config.showBounds) {\n      element.classList.add('tachui-debug')\n    }\n\n    if (this.config.showLabels && debugLabel) {\n      element.classList.add('tachui-debug-labeled')\n    }\n\n    if (this.config.showBounds) {\n      element.classList.add('tachui-debug-bounds')\n    }\n  }\n\n  /**\n   * Log component to tree (for hierarchical debugging)\n   */\n  logComponent(type: string, label?: string, depth: number = 0): void {\n    if (!this.config.enabled || !this.config.logComponentTree) return\n\n    this.componentTree.push({\n      label: label || `<${type}>`,\n      type,\n      depth\n    })\n  }\n\n  /**\n   * Print component tree to console\n   */\n  printComponentTree(): void {\n    if (!this.config.enabled || !this.config.logComponentTree) return\n\n    console.group('🌳 TachUI Component Tree:')\n    this.componentTree.forEach(({ label, type, depth }) => {\n      const indent = '  '.repeat(depth)\n      const icon = this.getComponentIcon(type)\n      console.log(`${indent}${icon} ${type}: \"${label}\"`)\n    })\n    console.groupEnd()\n    \n    // Clear tree for next render cycle\n    this.componentTree = []\n  }\n\n  /**\n   * Get icon for component type\n   */\n  private getComponentIcon(type: string): string {\n    const icons: Record<string, string> = {\n      VStack: '📚',\n      HStack: '➡️',\n      ZStack: '📑',\n      Button: '🔘',\n      Text: '📝',\n      Image: '🖼️',\n      ScrollView: '📜',\n      List: '📋',\n      Form: '📋',\n      Section: '📁',\n      default: '🧩'\n    }\n    return icons[type] || icons.default\n  }\n\n  /**\n   * Inject debug CSS styles\n   */\n  private injectDebugStyles(): void {\n    if (document.getElementById('tachui-debug-styles')) return\n\n    const styles = `\n      /* TachUI Debug Styles */\n      .tachui-debug {\n        position: relative;\n      }\n\n      .tachui-debug-bounds {\n        outline: 1px dashed rgba(255, 0, 0, 0.3) !important;\n        outline-offset: -1px;\n      }\n\n      .tachui-debug-labeled::before {\n        content: attr(data-tachui-label);\n        position: absolute;\n        top: -1px;\n        left: -1px;\n        background: rgba(255, 0, 0, 0.9);\n        color: white;\n        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;\n        font-size: 10px;\n        font-weight: bold;\n        line-height: 1;\n        padding: 2px 4px;\n        border-radius: 2px;\n        z-index: 9999;\n        pointer-events: none;\n        white-space: nowrap;\n        max-width: 200px;\n        overflow: hidden;\n        text-overflow: ellipsis;\n      }\n\n      .tachui-debug-labeled:hover::before {\n        background: rgba(255, 0, 0, 1);\n        max-width: none;\n        white-space: normal;\n      }\n\n      /* Component type indicators */\n      [data-tachui-component=\"VStack\"] {\n        border-left: 2px solid rgba(0, 255, 0, 0.5) !important;\n      }\n\n      [data-tachui-component=\"HStack\"] {\n        border-top: 2px solid rgba(0, 0, 255, 0.5) !important;\n      }\n\n      [data-tachui-component=\"Button\"] {\n        box-shadow: inset 0 0 0 1px rgba(255, 165, 0, 0.5) !important;\n      }\n    `\n\n    const styleElement = document.createElement('style')\n    styleElement.id = 'tachui-debug-styles'\n    styleElement.textContent = styles\n    document.head.appendChild(styleElement)\n  }\n\n  /**\n   * Remove debug CSS styles\n   */\n  private removeDebugStyles(): void {\n    const styleElement = document.getElementById('tachui-debug-styles')\n    if (styleElement) {\n      styleElement.remove()\n    }\n\n    // Remove debug classes from all elements\n    document.querySelectorAll('.tachui-debug').forEach(el => {\n      el.classList.remove('tachui-debug', 'tachui-debug-labeled', 'tachui-debug-bounds')\n    })\n  }\n}\n\n// Global debug instance\nexport const debugManager = new DebugManager()\n\n// Convenience functions\nexport const enableDebug = (options?: Partial<DebugConfig>) => debugManager.enable(options)\nexport const disableDebug = () => debugManager.disable()\nexport const isDebugEnabled = () => debugManager.isEnabled()\n\n// Auto-enable debug mode based on URL parameters\nif (typeof window !== 'undefined') {\n  const urlParams = new URLSearchParams(window.location.search)\n  const debugParam = urlParams.get('debug')\n  \n  if (debugParam === 'true' || debugParam === '1') {\n    // Enable full debug mode\n    debugManager.enable({\n      enabled: true,\n      showLabels: true,\n      showBounds: true,\n      logComponentTree: true\n    })\n    console.log('🔧 TachUI Debug Mode: Enabled via URL parameter (?debug=true)')\n  } else if (debugParam === 'labels') {\n    // Enable only labels\n    debugManager.enable({\n      enabled: true,\n      showLabels: true,\n      showBounds: false,\n      logComponentTree: false\n    })\n    console.log('🔧 TachUI Debug Mode: Labels only (?debug=labels)')\n  } else if (debugParam === 'bounds') {\n    // Enable only bounds\n    debugManager.enable({\n      enabled: true,\n      showLabels: false,\n      showBounds: true,\n      logComponentTree: false\n    })\n    console.log('🔧 TachUI Debug Mode: Bounds only (?debug=bounds)')\n  }\n}"],"names":["DebugManager","__publicField","options","element","componentType","debugLabel","type","label","depth","indent","icon","icons","styles","styleElement","el","debugManager","enableDebug","disableDebug","isDebugEnabled","debugParam"],"mappings":"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"}

package/dist/developer-experience/enhanced-errors.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Enhanced Error Messages and Developer Experience (Phase Maroon Week 2)
+ *
+ * Provides better error messages, debugging aids, and developer-friendly
+ * error reporting for the TachUI framework.
+ */
+import type { Modifier } from '../modifiers/types';
+import type { ComponentInstance } from '../runtime/types';
+/**
+ * Enhanced error with developer-friendly context
+ */
+export interface EnhancedTachUIError extends Error {
+    code: string;
+    category: 'modifier' | 'component' | 'runtime' | 'reactive' | 'validation';
+    severity: 'warning' | 'error' | 'fatal';
+    component?: string;
+    suggestion: string;
+    documentation?: string;
+    examples?: string[];
+    relatedErrors?: string[];
+}
+/**
+ * Developer experience error factory
+ */
+export declare class DeveloperErrorFactory {
+    /**
+     * Create modifier validation error
+     */
+    static modifierValidationError(modifier: string, issue: string, component?: ComponentInstance): EnhancedTachUIError;
+    /**
+     * Create component validation error
+     */
+    static componentValidationError(componentType: string, prop: string, expectedType: string, actualValue: any): EnhancedTachUIError;
+    /**
+     * Create reactive system error
+     */
+    static reactiveSystemError(operation: string, issue: string, context?: string): EnhancedTachUIError;
+    /**
+     * Create runtime error
+     */
+    static runtimeError(operation: string, issue: string, component?: string): EnhancedTachUIError;
+    /**
+     * Get modifier-specific suggestion
+     */
+    private static getModifierSuggestion;
+    /**
+     * Get modifier examples
+     */
+    private static getModifierExamples;
+    /**
+     * Get component examples
+     */
+    private static getComponentExamples;
+    /**
+     * Get type conversion suggestion
+     */
+    private static getTypeConversionSuggestion;
+    /**
+     * Get reactive system suggestion
+     */
+    private static getReactiveSuggestion;
+    /**
+     * Get reactive examples
+     */
+    private static getReactiveExamples;
+    /**
+     * Get runtime suggestion
+     */
+    private static getRuntimeSuggestion;
+}
+/**
+ * Enhanced warning system
+ */
+export declare class DeveloperWarnings {
+    private static warningsSeen;
+    /**
+     * Warn about deprecated API usage
+     */
+    static deprecation(oldAPI: string, newAPI: string, component?: string, willBeRemovedIn?: string): void;
+    /**
+     * Warn about performance issues
+     */
+    static performance(issue: string, suggestion: string, component?: string): void;
+    /**
+     * Warn about accessibility issues
+     */
+    static accessibility(issue: string, suggestion: string, component?: string): void;
+    /**
+     * Clear warning cache (for testing)
+     */
+    static clearWarnings(): void;
+}
+/**
+ * Type validation helpers
+ */
+export declare class TypeValidation {
+    /**
+     * Validate component props with enhanced error messages
+     */
+    static validateComponentProps<T extends Record<string, any>>(componentType: string, props: T, schema: Record<keyof T, {
+        type: string;
+        required?: boolean;
+        validator?: (value: any) => boolean;
+        message?: string;
+    }>): void;
+    /**
+     * Validate type
+     */
+    private static validateType;
+    /**
+     * Validate modifier combination
+     */
+    static validateModifierCombination(modifiers: Modifier[]): void;
+}
+/**
+ * Development mode utilities
+ */
+export declare const devMode: {
+    /**
+     * Enable enhanced error reporting in development
+     */
+    enableEnhancedErrors(): void;
+    /**
+     * Log component tree for debugging
+     */
+    logComponentTree(root: any, depth?: number): void;
+};
+//# sourceMappingURL=enhanced-errors.d.ts.map

package/dist/developer-experience/enhanced-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-errors.d.ts","sourceRoot":"","sources":["../../src/developer-experience/enhanced-errors.ts"],"names":[],"mappings":"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"}