@tachui/core 0.7.0-alpha1

package/dist/minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal.js","sources":["../src/bundles/minimal.ts"],"sourcesContent":["/**\n * @fileoverview TachUI Minimal Bundle (~60KB)\n * \n * Optimized for calculator-style apps and landing pages.\n * This bundle re-exports the complete framework but with metadata\n * to guide bundlers on tree-shaking optimization.\n */\n\n// For Phase 3, we export everything but provide metadata for optimal tree-shaking\nexport * from '../index'\n\n/**\n * Minimal Bundle Metadata - guides tree-shaking tools\n */\nexport const BUNDLE_INFO = {\n  name: '@tachui/core/minimal',\n  version: '0.1.0',\n  description: 'Minimal TachUI bundle for calculator-style apps and landing pages',\n  targetSize: '~60KB',\n  recommendedComponents: ['Text', 'Button', 'Image', 'HStack', 'VStack', 'Spacer', 'Show'],\n  useCase: 'Calculator-style apps, landing pages, simple UIs',\n  treeShakingHints: {\n    include: ['reactive', 'runtime', 'components/basic', 'modifiers/basic'],\n    exclude: ['components/advanced', 'modifiers/advanced', 'gradients', 'animations']\n  }\n} as const"],"names":["BUNDLE_INFO"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcO,MAAMA,IAAc;AAAA,EACzB,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,uBAAuB,CAAC,QAAQ,UAAU,SAAS,UAAU,UAAU,UAAU,MAAM;AAAA,EACvF,SAAS;AAAA,EACT,kBAAkB;AAAA,IAChB,SAAS,CAAC,YAAY,WAAW,oBAAoB,iBAAiB;AAAA,IACtE,SAAS,CAAC,uBAAuB,sBAAsB,aAAa,YAAY;AAAA,EAAA;AAEpF;"}

package/dist/modifiers/as-html-validator.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p=Object.defineProperty,d=(s,e,t)=>e in s?p(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t,c=(s,e,t)=>d(s,e+"",t);class a{static validate(e,t={}){if(t.suppressWarnings)return{isValid:!0,warnings:[]};const r=[];for(const{pattern:i,message:n}of this.SUSPICIOUS_PATTERNS)i.test(e)&&r.push(n);return this.looksLikeUserInput(e)&&r.push("Content appears to contain user input - ensure it's properly sanitized"),{isValid:r.length===0,warnings:r}}static looksLikeUserInput(e){return[/&lt;script/i,/&amp;#/,/%3Cscript/i,/\{\{.*\}\}/,/\$\{.*\}/].some(r=>r.test(e))}}c(a,"SUSPICIOUS_PATTERNS",[{pattern:/<script/i,message:"Script tags detected"},{pattern:/javascript:/i,message:"JavaScript URLs detected"},{pattern:/on\w+\s*=/i,message:"Event handlers detected"},{pattern:/<iframe/i,message:"Iframe elements detected"},{pattern:/<object/i,message:"Object elements detected"},{pattern:/<embed/i,message:"Embed elements detected"},{pattern:/<form/i,message:"Form elements detected"},{pattern:/data:.*script/i,message:"Data URLs with scripts detected"},{pattern:/@import/i,message:"CSS import statements detected"},{pattern:/expression\s*\(/i,message:"CSS expressions detected"}]);exports.AsHTMLValidator=a;
+//# sourceMappingURL=as-html-validator.cjs.map

package/dist/modifiers/as-html-validator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html-validator.cjs","sources":["../../src/modifiers/as-html-validator.ts"],"sourcesContent":["/**\n * Development-time validator for AsHTML content\n * Provides warnings about potentially dangerous content patterns\n */\n\nexport class AsHTMLValidator {\n  private static readonly SUSPICIOUS_PATTERNS = [\n    { pattern: /<script/i, message: 'Script tags detected' },\n    { pattern: /javascript:/i, message: 'JavaScript URLs detected' },\n    { pattern: /on\\w+\\s*=/i, message: 'Event handlers detected' },\n    { pattern: /<iframe/i, message: 'Iframe elements detected' },\n    { pattern: /<object/i, message: 'Object elements detected' },\n    { pattern: /<embed/i, message: 'Embed elements detected' },\n    { pattern: /<form/i, message: 'Form elements detected' },\n    { pattern: /data:.*script/i, message: 'Data URLs with scripts detected' },\n    { pattern: /@import/i, message: 'CSS import statements detected' },\n    { pattern: /expression\\s*\\(/i, message: 'CSS expressions detected' }\n  ]\n\n  /**\n   * Validate HTML content in development mode\n   */\n  static validate(html: string, options: ValidationOptions = {}): ValidationResult {\n    if (options.suppressWarnings) {\n      return { isValid: true, warnings: [] }\n    }\n\n    const warnings: string[] = []\n    \n    for (const { pattern, message } of this.SUSPICIOUS_PATTERNS) {\n      if (pattern.test(html)) {\n        warnings.push(message)\n      }\n    }\n\n    // Check for user input patterns\n    if (this.looksLikeUserInput(html)) {\n      warnings.push('Content appears to contain user input - ensure it\\'s properly sanitized')\n    }\n\n    return {\n      isValid: warnings.length === 0,\n      warnings\n    }\n  }\n\n  private static looksLikeUserInput(html: string): boolean {\n    // Heuristics to detect potential user input\n    const userInputIndicators = [\n      /&lt;script/i,  // HTML-encoded script tags\n      /&amp;#/,        // HTML entities that might be user input\n      /%3Cscript/i,    // URL-encoded script tags\n      /\\{\\{.*\\}\\}/,    // Template syntax\n      /\\$\\{.*\\}/       // ES6 template literals\n    ]\n\n    return userInputIndicators.some(pattern => pattern.test(html))\n  }\n}\n\nexport interface ValidationOptions {\n  suppressWarnings?: boolean\n}\n\nexport interface ValidationResult {\n  isValid: boolean\n  warnings: string[]\n}"],"names":["AsHTMLValidator","html","options","warnings","pattern","message","__publicField"],"mappings":"uNAKO,MAAMA,CAAgB,CAiB3B,OAAO,SAASC,EAAcC,EAA6B,GAAsB,CAC/E,GAAIA,EAAQ,iBACV,MAAO,CAAE,QAAS,GAAM,SAAU,CAAA,CAAC,EAGrC,MAAMC,EAAqB,CAAA,EAE3B,SAAW,CAAE,QAAAC,EAAS,QAAAC,CAAA,IAAa,KAAK,oBAClCD,EAAQ,KAAKH,CAAI,GACnBE,EAAS,KAAKE,CAAO,EAKzB,OAAI,KAAK,mBAAmBJ,CAAI,GAC9BE,EAAS,KAAK,wEAAyE,EAGlF,CACL,QAASA,EAAS,SAAW,EAC7B,SAAAA,CAAA,CAEJ,CAEA,OAAe,mBAAmBF,EAAuB,CAUvD,MAR4B,CAC1B,cACA,SACA,aACA,aACA,UAAA,EAGyB,KAAKG,GAAWA,EAAQ,KAAKH,CAAI,CAAC,CAC/D,CACF,CApDEK,EADWN,EACa,sBAAsB,CAC5C,CAAE,QAAS,WAAY,QAAS,sBAAA,EAChC,CAAE,QAAS,eAAgB,QAAS,0BAAA,EACpC,CAAE,QAAS,aAAc,QAAS,yBAAA,EAClC,CAAE,QAAS,WAAY,QAAS,0BAAA,EAChC,CAAE,QAAS,WAAY,QAAS,0BAAA,EAChC,CAAE,QAAS,UAAW,QAAS,yBAAA,EAC/B,CAAE,QAAS,SAAU,QAAS,wBAAA,EAC9B,CAAE,QAAS,iBAAkB,QAAS,iCAAA,EACtC,CAAE,QAAS,WAAY,QAAS,gCAAA,EAChC,CAAE,QAAS,mBAAoB,QAAS,0BAAA,CAC1C,CAAA"}

package/dist/modifiers/as-html-validator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Development-time validator for AsHTML content
+ * Provides warnings about potentially dangerous content patterns
+ */
+export declare class AsHTMLValidator {
+    private static readonly SUSPICIOUS_PATTERNS;
+    /**
+     * Validate HTML content in development mode
+     */
+    static validate(html: string, options?: ValidationOptions): ValidationResult;
+    private static looksLikeUserInput;
+}
+export interface ValidationOptions {
+    suppressWarnings?: boolean;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    warnings: string[];
+}
+//# sourceMappingURL=as-html-validator.d.ts.map

package/dist/modifiers/as-html-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html-validator.d.ts","sourceRoot":"","sources":["../../src/modifiers/as-html-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAW1C;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB;IAwBhF,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAYlC;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB"}

package/dist/modifiers/as-html-validator.js

@@ -0,0 +1,47 @@
+var n = Object.defineProperty, p = (s, e, t) => e in s ? n(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t, d = (s, e, t) => p(s, e + "", t);
+class c {
+  /**
+   * Validate HTML content in development mode
+   */
+  static validate(e, t = {}) {
+    if (t.suppressWarnings)
+      return { isValid: !0, warnings: [] };
+    const r = [];
+    for (const { pattern: a, message: i } of this.SUSPICIOUS_PATTERNS)
+      a.test(e) && r.push(i);
+    return this.looksLikeUserInput(e) && r.push("Content appears to contain user input - ensure it's properly sanitized"), {
+      isValid: r.length === 0,
+      warnings: r
+    };
+  }
+  static looksLikeUserInput(e) {
+    return [
+      /<script/i,
+      // HTML-encoded script tags
+      /&#/,
+      // HTML entities that might be user input
+      /%3Cscript/i,
+      // URL-encoded script tags
+      /\{\{.*\}\}/,
+      // Template syntax
+      /\$\{.*\}/
+      // ES6 template literals
+    ].some((r) => r.test(e));
+  }
+}
+d(c, "SUSPICIOUS_PATTERNS", [
+  { pattern: /<script/i, message: "Script tags detected" },
+  { pattern: /javascript:/i, message: "JavaScript URLs detected" },
+  { pattern: /on\w+\s*=/i, message: "Event handlers detected" },
+  { pattern: /<iframe/i, message: "Iframe elements detected" },
+  { pattern: /<object/i, message: "Object elements detected" },
+  { pattern: /<embed/i, message: "Embed elements detected" },
+  { pattern: /<form/i, message: "Form elements detected" },
+  { pattern: /data:.*script/i, message: "Data URLs with scripts detected" },
+  { pattern: /@import/i, message: "CSS import statements detected" },
+  { pattern: /expression\s*\(/i, message: "CSS expressions detected" }
+]);
+export {
+  c as AsHTMLValidator
+};
+//# sourceMappingURL=as-html-validator.js.map

package/dist/modifiers/as-html-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html-validator.js","sources":["../../src/modifiers/as-html-validator.ts"],"sourcesContent":["/**\n * Development-time validator for AsHTML content\n * Provides warnings about potentially dangerous content patterns\n */\n\nexport class AsHTMLValidator {\n  private static readonly SUSPICIOUS_PATTERNS = [\n    { pattern: /<script/i, message: 'Script tags detected' },\n    { pattern: /javascript:/i, message: 'JavaScript URLs detected' },\n    { pattern: /on\\w+\\s*=/i, message: 'Event handlers detected' },\n    { pattern: /<iframe/i, message: 'Iframe elements detected' },\n    { pattern: /<object/i, message: 'Object elements detected' },\n    { pattern: /<embed/i, message: 'Embed elements detected' },\n    { pattern: /<form/i, message: 'Form elements detected' },\n    { pattern: /data:.*script/i, message: 'Data URLs with scripts detected' },\n    { pattern: /@import/i, message: 'CSS import statements detected' },\n    { pattern: /expression\\s*\\(/i, message: 'CSS expressions detected' }\n  ]\n\n  /**\n   * Validate HTML content in development mode\n   */\n  static validate(html: string, options: ValidationOptions = {}): ValidationResult {\n    if (options.suppressWarnings) {\n      return { isValid: true, warnings: [] }\n    }\n\n    const warnings: string[] = []\n    \n    for (const { pattern, message } of this.SUSPICIOUS_PATTERNS) {\n      if (pattern.test(html)) {\n        warnings.push(message)\n      }\n    }\n\n    // Check for user input patterns\n    if (this.looksLikeUserInput(html)) {\n      warnings.push('Content appears to contain user input - ensure it\\'s properly sanitized')\n    }\n\n    return {\n      isValid: warnings.length === 0,\n      warnings\n    }\n  }\n\n  private static looksLikeUserInput(html: string): boolean {\n    // Heuristics to detect potential user input\n    const userInputIndicators = [\n      /&lt;script/i,  // HTML-encoded script tags\n      /&amp;#/,        // HTML entities that might be user input\n      /%3Cscript/i,    // URL-encoded script tags\n      /\\{\\{.*\\}\\}/,    // Template syntax\n      /\\$\\{.*\\}/       // ES6 template literals\n    ]\n\n    return userInputIndicators.some(pattern => pattern.test(html))\n  }\n}\n\nexport interface ValidationOptions {\n  suppressWarnings?: boolean\n}\n\nexport interface ValidationResult {\n  isValid: boolean\n  warnings: string[]\n}"],"names":["AsHTMLValidator","html","options","warnings","pattern","message","__publicField"],"mappings":";AAKO,MAAMA,EAAgB;AAAA;AAAA;AAAA;AAAA,EAiB3B,OAAO,SAASC,GAAcC,IAA6B,IAAsB;AAC/E,QAAIA,EAAQ;AACV,aAAO,EAAE,SAAS,IAAM,UAAU,CAAA,EAAC;AAGrC,UAAMC,IAAqB,CAAA;AAE3B,eAAW,EAAE,SAAAC,GAAS,SAAAC,EAAA,KAAa,KAAK;AACtC,MAAID,EAAQ,KAAKH,CAAI,KACnBE,EAAS,KAAKE,CAAO;AAKzB,WAAI,KAAK,mBAAmBJ,CAAI,KAC9BE,EAAS,KAAK,wEAAyE,GAGlF;AAAA,MACL,SAASA,EAAS,WAAW;AAAA,MAC7B,UAAAA;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEA,OAAe,mBAAmBF,GAAuB;AAUvD,WAR4B;AAAA,MAC1B;AAAA;AAAA,MACA;AAAA;AAAA,MACA;AAAA;AAAA,MACA;AAAA;AAAA,MACA;AAAA;AAAA,IAAA,EAGyB,KAAK,CAAAG,MAAWA,EAAQ,KAAKH,CAAI,CAAC;AAAA,EAC/D;AACF;AApDEK,EADWN,GACa,uBAAsB;AAAA,EAC5C,EAAE,SAAS,YAAY,SAAS,uBAAA;AAAA,EAChC,EAAE,SAAS,gBAAgB,SAAS,2BAAA;AAAA,EACpC,EAAE,SAAS,cAAc,SAAS,0BAAA;AAAA,EAClC,EAAE,SAAS,YAAY,SAAS,2BAAA;AAAA,EAChC,EAAE,SAAS,YAAY,SAAS,2BAAA;AAAA,EAChC,EAAE,SAAS,WAAW,SAAS,0BAAA;AAAA,EAC/B,EAAE,SAAS,UAAU,SAAS,yBAAA;AAAA,EAC9B,EAAE,SAAS,kBAAkB,SAAS,kCAAA;AAAA,EACtC,EAAE,SAAS,YAAY,SAAS,iCAAA;AAAA,EAChC,EAAE,SAAS,oBAAoB,SAAS,2BAAA;AAC1C,CAAA;"}

package/dist/modifiers/as-html.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./base.cjs"),u=require("./basic-sanitizer.cjs"),l=require("./as-html-validator.cjs");var d=Object.defineProperty,f=(r,e,t)=>e in r?d(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t,n=(r,e,t)=>f(r,typeof e!="symbol"?e+"":e,t);class o extends p.BaseModifier{constructor(e={}){super(e),n(this,"type","asHTML"),n(this,"priority",25)}apply(e,t){if(!t.element||!t.componentInstance)return;const i=t.componentInstance;if(!this.isTextComponent(i))throw new Error(`AsHTML modifier can only be applied to Text components. Found: ${i.type||"unknown"} component. Use Text('<your-html>').modifier.asHTML() instead.`);const s=this.getTextComponentContent(i);if(!s){process.env.NODE_ENV==="development"&&console.warn("asHTML: No content found in Text component");return}const a=this.sanitizeHTML(s);for(;t.element.firstChild;)t.element.removeChild(t.element.firstChild);t.element.innerHTML=a,t.element.__tachui_asHTML=!0,process.env.NODE_ENV==="development"&&this.validateContent(s)}isTextComponent(e){return e.type==="Text"||e.constructor?.name==="TextComponent"||e.__tachui_component_type==="Text"||e.props&&e.props.__componentType==="Text"||e.componentMetadata&&e.componentMetadata.type==="Text"||e.componentMetadata&&e.componentMetadata.originalType==="Text"}getTextComponentContent(e){if(typeof e.content=="string")return e.content;if(e.props&&typeof e.props.content=="string")return e.props.content;if(e.children&&Array.isArray(e.children)&&e.children.length>0){const t=e.children[0];if(t&&t.type==="text"&&typeof t.text=="string")return t.text}if(typeof e.text=="string")return e.text;if(e.props){if(typeof e.props.text=="string")return e.props.text;if(typeof e.props.children=="string")return e.props.children}return typeof e=="string"?e:""}sanitizeHTML(e){return!e||typeof e!="string"?"":this.properties.skipSanitizer?e:this.properties.customSanitizer?this.properties.customSanitizer(e):u.BasicSanitizer.sanitize(e,this.properties)}validateContent(e){if(this.properties.__suppressWarnings)return;const t=l.AsHTMLValidator.validate(e,{suppressWarnings:this.properties.__suppressWarnings});!t.isValid&&t.warnings.length>0&&(console.group("🔒 AsHTML Security Warnings"),console.warn("Potentially dangerous content detected in asHTML:"),t.warnings.forEach(i=>{console.warn(`  • ${i}`)}),console.warn("Consider using a more comprehensive sanitization solution like DOMPurify"),console.warn("To suppress these warnings, use { __suppressWarnings: true }"),console.groupEnd()),this.properties.skipSanitizer&&console.warn("🚨 AsHTML: Sanitization is DISABLED. Ensure content is safe!")}}function c(r={}){return new o(r)}exports.AsHTMLModifier=o;exports.asHTML=c;
+//# sourceMappingURL=as-html.cjs.map

package/dist/modifiers/as-html.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html.cjs","sources":["../../src/modifiers/as-html.ts"],"sourcesContent":["/**\n * AsHTML Modifier - Renders Text component content as HTML\n * \n * Security-first design with:\n * - Text component restriction only\n * - Built-in basic sanitization by default\n * - Non-reactive for performance\n * - Clear error messages for misuse\n */\n\nimport { BaseModifier } from './base'\nimport type { DOMNode, ComponentInstance } from '../runtime/types'\nimport type { ModifierContext } from './types'\nimport { BasicSanitizer, type BasicSanitizerOptions } from './basic-sanitizer'\nimport { AsHTMLValidator } from './as-html-validator'\n\nexport interface AsHTMLOptions extends BasicSanitizerOptions {\n  /** Skip basic sanitization (use with extreme caution) */\n  skipSanitizer?: boolean\n  /** Custom sanitization function */\n  customSanitizer?: (html: string) => string\n  /** Development-only validation */\n  __devModeValidate?: boolean\n  /** Suppress development warnings */\n  __suppressWarnings?: boolean\n}\n\n/**\n * Text component interface for type safety\n */\nexport interface TextComponent extends ComponentInstance {\n  readonly __tachui_component_type: 'Text'\n  content: string\n}\n\nexport class AsHTMLModifier extends BaseModifier<AsHTMLOptions> {\n  readonly type = 'asHTML'\n  readonly priority = 25 // After layout, before styling\n\n  constructor(options: AsHTMLOptions = {}) {\n    super(options)\n  }\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element || !context.componentInstance) return\n\n    // Security check: Only allow Text components\n    const component = context.componentInstance\n    if (!this.isTextComponent(component)) {\n      throw new Error(\n        `AsHTML modifier can only be applied to Text components. ` +\n        `Found: ${component.type || 'unknown'} component. ` +\n        `Use Text('<your-html>').modifier.asHTML() instead.`\n      )\n    }\n\n    // Get the content from the Text component\n    const htmlContent = this.getTextComponentContent(component)\n    \n    if (!htmlContent) {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn('asHTML: No content found in Text component')\n      }\n      return undefined\n    }\n\n    // Process and apply HTML content (non-reactive for performance)\n    const processedHTML = this.sanitizeHTML(htmlContent)\n    \n    // Clear all existing child nodes first\n    while (context.element.firstChild) {\n      context.element.removeChild(context.element.firstChild)\n    }\n    \n    // Set HTML content\n    context.element.innerHTML = processedHTML\n    \n    // Mark element to prevent text() function from overwriting innerHTML\n    ;(context.element as any).__tachui_asHTML = true\n\n    // Perform validation after processing (development only)\n    if (process.env.NODE_ENV === 'development') {\n      this.validateContent(htmlContent) // Validate original content, not processed\n    }\n\n    return undefined\n  }\n\n  private isTextComponent(component: any): boolean {\n    // Check if component is a Text component\n    // Multiple checks for different ways Text components might be identified\n    return component.type === 'Text' || \n           component.constructor?.name === 'TextComponent' ||\n           component.__tachui_component_type === 'Text' ||\n           (component.props && component.props.__componentType === 'Text') ||\n           // Check componentMetadata for enhanced Text components\n           (component.componentMetadata && component.componentMetadata.type === 'Text') ||\n           (component.componentMetadata && component.componentMetadata.originalType === 'Text')\n  }\n\n  private getTextComponentContent(component: any): string {\n    // Extract content from Text component\n    // Text components should have their content in a predictable location\n    \n    // Primary: Direct content property\n    if (typeof component.content === 'string') {\n      return component.content\n    }\n    \n    // Secondary: Props content\n    if (component.props && typeof component.props.content === 'string') {\n      return component.props.content\n    }\n    \n    // Tertiary: Check children array for text nodes (for enhanced Text components)\n    if (component.children && Array.isArray(component.children) && component.children.length > 0) {\n      const firstChild = component.children[0]\n      if (firstChild && firstChild.type === 'text' && typeof firstChild.text === 'string') {\n        return firstChild.text\n      }\n    }\n    \n    // Quaternary: Text property\n    if (typeof component.text === 'string') {\n      return component.text\n    }\n    \n    // Fifth: Check props for common text properties\n    if (component.props) {\n      if (typeof component.props.text === 'string') {\n        return component.props.text\n      }\n      if (typeof component.props.children === 'string') {\n        return component.props.children\n      }\n    }\n\n    // Fallback: Check for direct string (in case of simple Text usage)\n    if (typeof component === 'string') {\n      return component\n    }\n\n    return ''\n  }\n\n  private sanitizeHTML(html: string): string {\n    if (!html || typeof html !== 'string') {\n      return ''\n    }\n\n    // Skip sanitization if explicitly requested\n    if (this.properties.skipSanitizer) {\n      return html\n    }\n\n    // Use custom sanitizer if provided\n    if (this.properties.customSanitizer) {\n      return this.properties.customSanitizer(html)\n    }\n\n    // Apply basic sanitization\n    return BasicSanitizer.sanitize(html, this.properties)\n  }\n\n  private validateContent(html: string): void {\n    if (this.properties.__suppressWarnings) return\n\n    // Validate content\n    const validationResult = AsHTMLValidator.validate(html, {\n      suppressWarnings: this.properties.__suppressWarnings\n    })\n\n    if (!validationResult.isValid && validationResult.warnings.length > 0) {\n      console.group('🔒 AsHTML Security Warnings')\n      console.warn('Potentially dangerous content detected in asHTML:')\n      validationResult.warnings.forEach(warning => {\n        console.warn(`  • ${warning}`)\n      })\n      console.warn('Consider using a more comprehensive sanitization solution like DOMPurify')\n      console.warn('To suppress these warnings, use { __suppressWarnings: true }')\n      console.groupEnd()\n    }\n\n    // Warn about skipped sanitization\n    if (this.properties.skipSanitizer) {\n      console.warn('🚨 AsHTML: Sanitization is DISABLED. Ensure content is safe!')\n    }\n  }\n}\n\n/**\n * Create an asHTML modifier for rendering HTML content\n * \n * By default, applies basic sanitization to remove common XSS vectors.\n * Use { skipSanitizer: true } to bypass sanitization (dangerous).\n * \n * The modifier treats the component's content as HTML instead of plain text.\n * SECURITY: Only works on Text components.\n * \n * @param options - Configuration options\n * \n * @example\n * ```typescript\n * // Safe: Basic sanitization applied\n * Text('<p>Hello <strong>world</strong></p>').modifier.asHTML().build()\n * \n * // Dangerous: Skip sanitization\n * Text(serverTemplate).modifier.asHTML({ skipSanitizer: true }).build()\n * \n * // Custom sanitization\n * Text(content).modifier.asHTML({ customSanitizer: DOMPurify.sanitize }).build()\n * ```\n */\nexport function asHTML(options: AsHTMLOptions = {}): AsHTMLModifier {\n  return new AsHTMLModifier(options)\n}"],"names":["AsHTMLModifier","BaseModifier","options","__publicField","_node","context","component","htmlContent","processedHTML","firstChild","html","BasicSanitizer","validationResult","AsHTMLValidator","warning","asHTML"],"mappings":"kVAmCO,MAAMA,UAAuBC,EAAAA,YAA4B,CAI9D,YAAYC,EAAyB,GAAI,CACvC,MAAMA,CAAO,EAJfC,EAAA,KAAS,OAAO,QAAA,EAChBA,EAAA,KAAS,WAAW,EAAA,CAIpB,CAEA,MAAMC,EAAgBC,EAA+C,CACnE,GAAI,CAACA,EAAQ,SAAW,CAACA,EAAQ,kBAAmB,OAGpD,MAAMC,EAAYD,EAAQ,kBAC1B,GAAI,CAAC,KAAK,gBAAgBC,CAAS,EACjC,MAAM,IAAI,MACR,kEACUA,EAAU,MAAQ,SAAS,gEAAA,EAMzC,MAAMC,EAAc,KAAK,wBAAwBD,CAAS,EAE1D,GAAI,CAACC,EAAa,CACZ,QAAQ,IAAI,WAAa,eAC3B,QAAQ,KAAK,4CAA4C,EAE3D,MACF,CAGA,MAAMC,EAAgB,KAAK,aAAaD,CAAW,EAGnD,KAAOF,EAAQ,QAAQ,YACrBA,EAAQ,QAAQ,YAAYA,EAAQ,QAAQ,UAAU,EAIxDA,EAAQ,QAAQ,UAAYG,EAG1BH,EAAQ,QAAgB,gBAAkB,GAGxC,QAAQ,IAAI,WAAa,eAC3B,KAAK,gBAAgBE,CAAW,CAIpC,CAEQ,gBAAgBD,EAAyB,CAG/C,OAAOA,EAAU,OAAS,QACnBA,EAAU,aAAa,OAAS,iBAChCA,EAAU,0BAA4B,QACrCA,EAAU,OAASA,EAAU,MAAM,kBAAoB,QAEvDA,EAAU,mBAAqBA,EAAU,kBAAkB,OAAS,QACpEA,EAAU,mBAAqBA,EAAU,kBAAkB,eAAiB,MACtF,CAEQ,wBAAwBA,EAAwB,CAKtD,GAAI,OAAOA,EAAU,SAAY,SAC/B,OAAOA,EAAU,QAInB,GAAIA,EAAU,OAAS,OAAOA,EAAU,MAAM,SAAY,SACxD,OAAOA,EAAU,MAAM,QAIzB,GAAIA,EAAU,UAAY,MAAM,QAAQA,EAAU,QAAQ,GAAKA,EAAU,SAAS,OAAS,EAAG,CAC5F,MAAMG,EAAaH,EAAU,SAAS,CAAC,EACvC,GAAIG,GAAcA,EAAW,OAAS,QAAU,OAAOA,EAAW,MAAS,SACzE,OAAOA,EAAW,IAEtB,CAGA,GAAI,OAAOH,EAAU,MAAS,SAC5B,OAAOA,EAAU,KAInB,GAAIA,EAAU,MAAO,CACnB,GAAI,OAAOA,EAAU,MAAM,MAAS,SAClC,OAAOA,EAAU,MAAM,KAEzB,GAAI,OAAOA,EAAU,MAAM,UAAa,SACtC,OAAOA,EAAU,MAAM,QAE3B,CAGA,OAAI,OAAOA,GAAc,SAChBA,EAGF,EACT,CAEQ,aAAaI,EAAsB,CACzC,MAAI,CAACA,GAAQ,OAAOA,GAAS,SACpB,GAIL,KAAK,WAAW,cACXA,EAIL,KAAK,WAAW,gBACX,KAAK,WAAW,gBAAgBA,CAAI,EAItCC,EAAAA,eAAe,SAASD,EAAM,KAAK,UAAU,CACtD,CAEQ,gBAAgBA,EAAoB,CAC1C,GAAI,KAAK,WAAW,mBAAoB,OAGxC,MAAME,EAAmBC,EAAAA,gBAAgB,SAASH,EAAM,CACtD,iBAAkB,KAAK,WAAW,kBAAA,CACnC,EAEG,CAACE,EAAiB,SAAWA,EAAiB,SAAS,OAAS,IAClE,QAAQ,MAAM,6BAA6B,EAC3C,QAAQ,KAAK,mDAAmD,EAChEA,EAAiB,SAAS,QAAQE,GAAW,CAC3C,QAAQ,KAAK,OAAOA,CAAO,EAAE,CAC/B,CAAC,EACD,QAAQ,KAAK,0EAA0E,EACvF,QAAQ,KAAK,8DAA8D,EAC3E,QAAQ,SAAA,GAIN,KAAK,WAAW,eAClB,QAAQ,KAAK,8DAA8D,CAE/E,CACF,CAyBO,SAASC,EAAOb,EAAyB,GAAoB,CAClE,OAAO,IAAIF,EAAeE,CAAO,CACnC"}

package/dist/modifiers/as-html.d.ts

@@ -0,0 +1,65 @@
+/**
+ * AsHTML Modifier - Renders Text component content as HTML
+ *
+ * Security-first design with:
+ * - Text component restriction only
+ * - Built-in basic sanitization by default
+ * - Non-reactive for performance
+ * - Clear error messages for misuse
+ */
+import { BaseModifier } from './base';
+import type { DOMNode, ComponentInstance } from '../runtime/types';
+import type { ModifierContext } from './types';
+import { type BasicSanitizerOptions } from './basic-sanitizer';
+export interface AsHTMLOptions extends BasicSanitizerOptions {
+    /** Skip basic sanitization (use with extreme caution) */
+    skipSanitizer?: boolean;
+    /** Custom sanitization function */
+    customSanitizer?: (html: string) => string;
+    /** Development-only validation */
+    __devModeValidate?: boolean;
+    /** Suppress development warnings */
+    __suppressWarnings?: boolean;
+}
+/**
+ * Text component interface for type safety
+ */
+export interface TextComponent extends ComponentInstance {
+    readonly __tachui_component_type: 'Text';
+    content: string;
+}
+export declare class AsHTMLModifier extends BaseModifier<AsHTMLOptions> {
+    readonly type = "asHTML";
+    readonly priority = 25;
+    constructor(options?: AsHTMLOptions);
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private isTextComponent;
+    private getTextComponentContent;
+    private sanitizeHTML;
+    private validateContent;
+}
+/**
+ * Create an asHTML modifier for rendering HTML content
+ *
+ * By default, applies basic sanitization to remove common XSS vectors.
+ * Use { skipSanitizer: true } to bypass sanitization (dangerous).
+ *
+ * The modifier treats the component's content as HTML instead of plain text.
+ * SECURITY: Only works on Text components.
+ *
+ * @param options - Configuration options
+ *
+ * @example
+ * ```typescript
+ * // Safe: Basic sanitization applied
+ * Text('<p>Hello <strong>world</strong></p>').modifier.asHTML().build()
+ *
+ * // Dangerous: Skip sanitization
+ * Text(serverTemplate).modifier.asHTML({ skipSanitizer: true }).build()
+ *
+ * // Custom sanitization
+ * Text(content).modifier.asHTML({ customSanitizer: DOMPurify.sanitize }).build()
+ * ```
+ */
+export declare function asHTML(options?: AsHTMLOptions): AsHTMLModifier;
+//# sourceMappingURL=as-html.d.ts.map

package/dist/modifiers/as-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html.d.ts","sourceRoot":"","sources":["../../src/modifiers/as-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAG9E,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mCAAmC;IACnC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,cAAe,SAAQ,YAAY,CAAC,aAAa,CAAC;IAC7D,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,QAAQ,MAAK;gBAEV,OAAO,GAAE,aAAkB;IAIvC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,GAAG,SAAS;IA6CpE,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,uBAAuB;IA6C/B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;CAwBxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,cAAc,CAElE"}

package/dist/modifiers/as-html.js

@@ -0,0 +1,71 @@
+import { BaseModifier as a } from "./base.js";
+import { BasicSanitizer as p } from "./basic-sanitizer.js";
+import { AsHTMLValidator as u } from "./as-html-validator.js";
+var l = Object.defineProperty, f = (r, e, t) => e in r ? l(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, n = (r, e, t) => f(r, typeof e != "symbol" ? e + "" : e, t);
+class d extends a {
+  // After layout, before styling
+  constructor(e = {}) {
+    super(e), n(this, "type", "asHTML"), n(this, "priority", 25);
+  }
+  apply(e, t) {
+    if (!t.element || !t.componentInstance) return;
+    const i = t.componentInstance;
+    if (!this.isTextComponent(i))
+      throw new Error(
+        `AsHTML modifier can only be applied to Text components. Found: ${i.type || "unknown"} component. Use Text('<your-html>').modifier.asHTML() instead.`
+      );
+    const s = this.getTextComponentContent(i);
+    if (!s) {
+      process.env.NODE_ENV === "development" && console.warn("asHTML: No content found in Text component");
+      return;
+    }
+    const o = this.sanitizeHTML(s);
+    for (; t.element.firstChild; )
+      t.element.removeChild(t.element.firstChild);
+    t.element.innerHTML = o, t.element.__tachui_asHTML = !0, process.env.NODE_ENV === "development" && this.validateContent(s);
+  }
+  isTextComponent(e) {
+    return e.type === "Text" || e.constructor?.name === "TextComponent" || e.__tachui_component_type === "Text" || e.props && e.props.__componentType === "Text" || // Check componentMetadata for enhanced Text components
+    e.componentMetadata && e.componentMetadata.type === "Text" || e.componentMetadata && e.componentMetadata.originalType === "Text";
+  }
+  getTextComponentContent(e) {
+    if (typeof e.content == "string")
+      return e.content;
+    if (e.props && typeof e.props.content == "string")
+      return e.props.content;
+    if (e.children && Array.isArray(e.children) && e.children.length > 0) {
+      const t = e.children[0];
+      if (t && t.type === "text" && typeof t.text == "string")
+        return t.text;
+    }
+    if (typeof e.text == "string")
+      return e.text;
+    if (e.props) {
+      if (typeof e.props.text == "string")
+        return e.props.text;
+      if (typeof e.props.children == "string")
+        return e.props.children;
+    }
+    return typeof e == "string" ? e : "";
+  }
+  sanitizeHTML(e) {
+    return !e || typeof e != "string" ? "" : this.properties.skipSanitizer ? e : this.properties.customSanitizer ? this.properties.customSanitizer(e) : p.sanitize(e, this.properties);
+  }
+  validateContent(e) {
+    if (this.properties.__suppressWarnings) return;
+    const t = u.validate(e, {
+      suppressWarnings: this.properties.__suppressWarnings
+    });
+    !t.isValid && t.warnings.length > 0 && (console.group("🔒 AsHTML Security Warnings"), console.warn("Potentially dangerous content detected in asHTML:"), t.warnings.forEach((i) => {
+      console.warn(`  • ${i}`);
+    }), console.warn("Consider using a more comprehensive sanitization solution like DOMPurify"), console.warn("To suppress these warnings, use { __suppressWarnings: true }"), console.groupEnd()), this.properties.skipSanitizer && console.warn("🚨 AsHTML: Sanitization is DISABLED. Ensure content is safe!");
+  }
+}
+function g(r = {}) {
+  return new d(r);
+}
+export {
+  d as AsHTMLModifier,
+  g as asHTML
+};
+//# sourceMappingURL=as-html.js.map

package/dist/modifiers/as-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-html.js","sources":["../../src/modifiers/as-html.ts"],"sourcesContent":["/**\n * AsHTML Modifier - Renders Text component content as HTML\n * \n * Security-first design with:\n * - Text component restriction only\n * - Built-in basic sanitization by default\n * - Non-reactive for performance\n * - Clear error messages for misuse\n */\n\nimport { BaseModifier } from './base'\nimport type { DOMNode, ComponentInstance } from '../runtime/types'\nimport type { ModifierContext } from './types'\nimport { BasicSanitizer, type BasicSanitizerOptions } from './basic-sanitizer'\nimport { AsHTMLValidator } from './as-html-validator'\n\nexport interface AsHTMLOptions extends BasicSanitizerOptions {\n  /** Skip basic sanitization (use with extreme caution) */\n  skipSanitizer?: boolean\n  /** Custom sanitization function */\n  customSanitizer?: (html: string) => string\n  /** Development-only validation */\n  __devModeValidate?: boolean\n  /** Suppress development warnings */\n  __suppressWarnings?: boolean\n}\n\n/**\n * Text component interface for type safety\n */\nexport interface TextComponent extends ComponentInstance {\n  readonly __tachui_component_type: 'Text'\n  content: string\n}\n\nexport class AsHTMLModifier extends BaseModifier<AsHTMLOptions> {\n  readonly type = 'asHTML'\n  readonly priority = 25 // After layout, before styling\n\n  constructor(options: AsHTMLOptions = {}) {\n    super(options)\n  }\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element || !context.componentInstance) return\n\n    // Security check: Only allow Text components\n    const component = context.componentInstance\n    if (!this.isTextComponent(component)) {\n      throw new Error(\n        `AsHTML modifier can only be applied to Text components. ` +\n        `Found: ${component.type || 'unknown'} component. ` +\n        `Use Text('<your-html>').modifier.asHTML() instead.`\n      )\n    }\n\n    // Get the content from the Text component\n    const htmlContent = this.getTextComponentContent(component)\n    \n    if (!htmlContent) {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn('asHTML: No content found in Text component')\n      }\n      return undefined\n    }\n\n    // Process and apply HTML content (non-reactive for performance)\n    const processedHTML = this.sanitizeHTML(htmlContent)\n    \n    // Clear all existing child nodes first\n    while (context.element.firstChild) {\n      context.element.removeChild(context.element.firstChild)\n    }\n    \n    // Set HTML content\n    context.element.innerHTML = processedHTML\n    \n    // Mark element to prevent text() function from overwriting innerHTML\n    ;(context.element as any).__tachui_asHTML = true\n\n    // Perform validation after processing (development only)\n    if (process.env.NODE_ENV === 'development') {\n      this.validateContent(htmlContent) // Validate original content, not processed\n    }\n\n    return undefined\n  }\n\n  private isTextComponent(component: any): boolean {\n    // Check if component is a Text component\n    // Multiple checks for different ways Text components might be identified\n    return component.type === 'Text' || \n           component.constructor?.name === 'TextComponent' ||\n           component.__tachui_component_type === 'Text' ||\n           (component.props && component.props.__componentType === 'Text') ||\n           // Check componentMetadata for enhanced Text components\n           (component.componentMetadata && component.componentMetadata.type === 'Text') ||\n           (component.componentMetadata && component.componentMetadata.originalType === 'Text')\n  }\n\n  private getTextComponentContent(component: any): string {\n    // Extract content from Text component\n    // Text components should have their content in a predictable location\n    \n    // Primary: Direct content property\n    if (typeof component.content === 'string') {\n      return component.content\n    }\n    \n    // Secondary: Props content\n    if (component.props && typeof component.props.content === 'string') {\n      return component.props.content\n    }\n    \n    // Tertiary: Check children array for text nodes (for enhanced Text components)\n    if (component.children && Array.isArray(component.children) && component.children.length > 0) {\n      const firstChild = component.children[0]\n      if (firstChild && firstChild.type === 'text' && typeof firstChild.text === 'string') {\n        return firstChild.text\n      }\n    }\n    \n    // Quaternary: Text property\n    if (typeof component.text === 'string') {\n      return component.text\n    }\n    \n    // Fifth: Check props for common text properties\n    if (component.props) {\n      if (typeof component.props.text === 'string') {\n        return component.props.text\n      }\n      if (typeof component.props.children === 'string') {\n        return component.props.children\n      }\n    }\n\n    // Fallback: Check for direct string (in case of simple Text usage)\n    if (typeof component === 'string') {\n      return component\n    }\n\n    return ''\n  }\n\n  private sanitizeHTML(html: string): string {\n    if (!html || typeof html !== 'string') {\n      return ''\n    }\n\n    // Skip sanitization if explicitly requested\n    if (this.properties.skipSanitizer) {\n      return html\n    }\n\n    // Use custom sanitizer if provided\n    if (this.properties.customSanitizer) {\n      return this.properties.customSanitizer(html)\n    }\n\n    // Apply basic sanitization\n    return BasicSanitizer.sanitize(html, this.properties)\n  }\n\n  private validateContent(html: string): void {\n    if (this.properties.__suppressWarnings) return\n\n    // Validate content\n    const validationResult = AsHTMLValidator.validate(html, {\n      suppressWarnings: this.properties.__suppressWarnings\n    })\n\n    if (!validationResult.isValid && validationResult.warnings.length > 0) {\n      console.group('🔒 AsHTML Security Warnings')\n      console.warn('Potentially dangerous content detected in asHTML:')\n      validationResult.warnings.forEach(warning => {\n        console.warn(`  • ${warning}`)\n      })\n      console.warn('Consider using a more comprehensive sanitization solution like DOMPurify')\n      console.warn('To suppress these warnings, use { __suppressWarnings: true }')\n      console.groupEnd()\n    }\n\n    // Warn about skipped sanitization\n    if (this.properties.skipSanitizer) {\n      console.warn('🚨 AsHTML: Sanitization is DISABLED. Ensure content is safe!')\n    }\n  }\n}\n\n/**\n * Create an asHTML modifier for rendering HTML content\n * \n * By default, applies basic sanitization to remove common XSS vectors.\n * Use { skipSanitizer: true } to bypass sanitization (dangerous).\n * \n * The modifier treats the component's content as HTML instead of plain text.\n * SECURITY: Only works on Text components.\n * \n * @param options - Configuration options\n * \n * @example\n * ```typescript\n * // Safe: Basic sanitization applied\n * Text('<p>Hello <strong>world</strong></p>').modifier.asHTML().build()\n * \n * // Dangerous: Skip sanitization\n * Text(serverTemplate).modifier.asHTML({ skipSanitizer: true }).build()\n * \n * // Custom sanitization\n * Text(content).modifier.asHTML({ customSanitizer: DOMPurify.sanitize }).build()\n * ```\n */\nexport function asHTML(options: AsHTMLOptions = {}): AsHTMLModifier {\n  return new AsHTMLModifier(options)\n}"],"names":["AsHTMLModifier","BaseModifier","options","__publicField","_node","context","component","htmlContent","processedHTML","firstChild","html","BasicSanitizer","validationResult","AsHTMLValidator","warning","asHTML"],"mappings":"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"}

package/dist/modifiers/attributes.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./base.cjs"),l=require("./types.cjs");var h=Object.defineProperty,y=(i,t,e)=>t in i?h(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e,s=(i,t,e)=>y(i,typeof t!="symbol"?t+"":t,e);class p extends d.BaseModifier{constructor(){super(...arguments),s(this,"type","id"),s(this,"priority",l.ModifierPriority.CUSTOM+10)}apply(t,e){if(!e.element)return;const{id:r}=this.properties;process.env.NODE_ENV==="development"&&this.validateId(r),e.element.setAttribute("id",r)}validateId(t){if(!t||typeof t!="string"){console.warn("TachUI ID Modifier: ID must be a non-empty string");return}/^[a-zA-Z][a-zA-Z0-9_:-]*$/.test(t)||console.warn(`TachUI ID Modifier: Invalid ID format "${t}". IDs must start with a letter and contain only letters, digits, hyphens, underscores, colons, and periods.`),document.getElementById(t)&&console.warn(`TachUI ID Modifier: Duplicate ID "${t}" detected. IDs should be unique within the document.`)}}function I(i){return new p({id:i})}class f extends d.BaseModifier{constructor(){super(...arguments),s(this,"type","data"),s(this,"priority",l.ModifierPriority.CUSTOM+5)}apply(t,e){if(!e.element)return;const{data:r}=this.properties;process.env.NODE_ENV==="development"&&this.validateDataAttributes(r),Object.entries(r).forEach(([a,o])=>{const c=this.formatDataAttributeName(a),u=this.formatDataAttributeValue(o);e.element.setAttribute(c,u)})}formatDataAttributeName(t){const e=t.replace(/[A-Z]/g,r=>`-${r.toLowerCase()}`);return e.startsWith("data-")?e:`data-${e}`}formatDataAttributeValue(t){return typeof t=="boolean"?t?"true":"false":String(t)}validateDataAttributes(t){Object.entries(t).forEach(([e,r])=>{if(!e||typeof e!="string"){console.warn("TachUI Data Modifier: Data attribute keys must be non-empty strings");return}/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(e.replace(/^data-/,""))||console.warn(`TachUI Data Modifier: Invalid data attribute key "${e}". Keys should contain only letters, numbers, hyphens, and underscores.`),r!=null&&typeof r!="string"&&typeof r!="number"&&typeof r!="boolean"&&console.warn(`TachUI Data Modifier: Data attribute "${e}" has invalid value type. Only strings, numbers, and booleans are supported.`)})}}function A(i){return new f({data:i})}class b extends d.BaseModifier{constructor(){super(...arguments),s(this,"type","aria"),s(this,"priority",l.ModifierPriority.CUSTOM+15)}apply(t,e){if(!e.element)return;const{aria:r}=this.properties;process.env.NODE_ENV==="development"&&this.validateAriaAttributes(r),Object.entries(r).forEach(([a,o])=>{if(o!=null){const c=this.formatAriaAttributeName(a),u=this.formatAriaAttributeValue(o);e.element.setAttribute(c,u)}})}formatAriaAttributeName(t){if(t==="role")return"role";const e=t.replace(/[A-Z]/g,r=>`-${r.toLowerCase()}`);return e.startsWith("aria-")?e:`aria-${e}`}formatAriaAttributeValue(t){return typeof t=="boolean"?t?"true":"false":String(t)}validateAriaAttributes(t){const e=new Set(["label","labelledby","describedby","expanded","hidden","live","atomic","busy","controls","current","disabled","grabbed","haspopup","invalid","level","multiline","multiselectable","orientation","owns","placeholder","posinset","pressed","readonly","relevant","required","selected","setsize","sort","valuemax","valuemin","valuenow","valuetext","role"]);Object.entries(t).forEach(([r,a])=>{if(!r||typeof r!="string"){console.warn("TachUI ARIA Modifier: ARIA attribute keys must be non-empty strings");return}const o=r.replace(/^aria-/,"");!e.has(o)&&!o.startsWith("aria-")&&console.warn(`TachUI ARIA Modifier: Unknown ARIA attribute "${r}". This may not be a valid ARIA attribute. Did you mean "${this.suggestCorrection(o)}"?`),this.validateSpecificAriaAttribute(r,a)})}validateSpecificAriaAttribute(t,e){const r=t.replace(/^aria-/,"");switch(r){case"live":e!=="off"&&e!=="polite"&&e!=="assertive"&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-live. Valid values are: "off", "polite", "assertive"`);break;case"haspopup":typeof e=="string"&&!["false","true","menu","listbox","tree","grid","dialog"].includes(e)&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-haspopup. Valid values are: false, true, "menu", "listbox", "tree", "grid", "dialog"`);break;case"current":typeof e=="string"&&!["page","step","location","date","time"].includes(e)&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-current. Valid values are: false, true, "page", "step", "location", "date", "time"`);break;case"invalid":typeof e=="string"&&!["false","true","grammar","spelling"].includes(e)&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-invalid. Valid values are: false, true, "grammar", "spelling"`);break;case"orientation":e!=="horizontal"&&e!=="vertical"&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-orientation. Valid values are: "horizontal", "vertical"`);break;case"sort":["none","ascending","descending","other"].includes(e)||console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-sort. Valid values are: "none", "ascending", "descending", "other"`);break;case"level":case"posinset":case"setsize":case"valuemax":case"valuemin":case"valuenow":typeof e=="number"&&(e<0||!Number.isInteger(e))&&console.warn(`TachUI ARIA Modifier: Invalid value "${e}" for aria-${r}. Must be a non-negative integer.`);break}}suggestCorrection(t){return{lable:"label",labeledby:"labelledby",descripedby:"describedby",descibed:"describedby",controled:"controls",expaned:"expanded",hiden:"hidden",disbled:"disabled",requird:"required",selectd:"selected"}[t]||t}}function g(i){return new b({aria:i})}class m extends d.BaseModifier{constructor(){super(...arguments),s(this,"type","tabIndex"),s(this,"priority",l.ModifierPriority.CUSTOM+12)}apply(t,e){if(!e.element)return;const{tabIndex:r}=this.properties;process.env.NODE_ENV==="development"&&this.validateTabIndex(r),e.element.setAttribute("tabindex",String(r))}validateTabIndex(t){if(typeof t!="number"||!Number.isInteger(t)){console.warn("TachUI TabIndex Modifier: tabIndex must be an integer");return}t>0&&console.info('TachUI TabIndex Modifier: Positive tabIndex values can disrupt natural tab order. Consider using tabIndex="0" for focusable elements and tabIndex="-1" for programmatically focusable elements.'),t<-1&&console.warn("TachUI TabIndex Modifier: tabIndex values less than -1 are not recommended. Use -1 to remove from tab order or 0+ for tab order.")}}function v(i){return new m({tabIndex:i})}class n extends d.BaseModifier{constructor(t){const e={};for(const[r,a]of Object.entries(t))typeof a=="function"&&"peek"in a?e[r]=a.peek():e[r]=a;super(e),s(this,"type","customProperties"),s(this,"priority",5)}apply(t,e){if(!e.element)return;const r=this.computeCustomPropertyStyles(this.properties);this.applyStyles(e.element,r)}computeCustomPropertyStyles(t){const e={};if(t.properties)for(const[r,a]of Object.entries(t.properties)){const o=r.startsWith("--")?r:`--${r}`;e[o]=this.formatPropertyValue(a)}return e}formatPropertyValue(t){return typeof t=="number"?t.toString():t}}function M(i){return new n({properties:i.properties,scope:i.scope||"local"})}function w(i,t,e){const r=i.startsWith("--")?i:`--${i}`;return new n({properties:{[r]:t},scope:e||"local"})}function T(i){return new n({properties:i,scope:"local"})}function D(i){const t={};for(const[e,r]of Object.entries(i))t[`--theme-color-${e}`]=r;return new n({properties:t,scope:"local"})}function P(i){const t={};for(const[e,r]of Object.entries(i))t[`--token-${e}`]=r;return new n({properties:t,scope:"local"})}exports.AriaModifier=b;exports.CustomPropertiesModifier=n;exports.DataModifier=f;exports.IdModifier=p;exports.TabIndexModifier=m;exports.aria=g;exports.cssVariables=T;exports.customProperties=M;exports.customProperty=w;exports.data=A;exports.designTokens=P;exports.id=I;exports.tabIndex=v;exports.themeColors=D;
+//# sourceMappingURL=attributes.cjs.map

package/dist/modifiers/attributes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.cjs","sources":["../../src/modifiers/attributes.ts"],"sourcesContent":["/**\n * HTML and ARIA Attributes Implementation\n *\n * Implementation of HTML attributes, ARIA accessibility attributes, and related modifiers.\n * These modifiers provide essential web functionality for accessibility, testing, and semantic markup.\n */\n\nimport type { DOMNode } from '../runtime/types'\nimport { BaseModifier } from './base'\nimport type { ModifierContext, ReactiveModifierProps } from './types'\nimport { ModifierPriority } from './types'\n\n// ============================================================================\n// HTML and ARIA Attribute Modifiers\n// ============================================================================\n\n/**\n * ID Modifier - HTML Element ID\n * Sets the id attribute for page anchoring, accessibility, and testing selectors\n */\nexport interface IdOptions {\n  id: string\n}\n\nexport type ReactiveIdOptions = ReactiveModifierProps<IdOptions>\n\nexport class IdModifier extends BaseModifier<IdOptions> {\n  readonly type = 'id'\n  readonly priority = ModifierPriority.CUSTOM + 10\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element) return\n\n    const { id } = this.properties\n\n    // Validate ID in development mode\n    if (process.env.NODE_ENV === 'development') {\n      this.validateId(id)\n    }\n\n    // Set id attribute\n    context.element.setAttribute('id', id)\n    \n    return undefined\n  }\n\n  private validateId(id: string): void {\n    // Check for valid HTML ID format\n    if (!id || typeof id !== 'string') {\n      console.warn('TachUI ID Modifier: ID must be a non-empty string')\n      return\n    }\n\n    // HTML ID rules: must start with letter, can contain letters, digits, hyphens, underscores, colons, periods\n    const validIdPattern = /^[a-zA-Z][a-zA-Z0-9_:-]*$/\n    if (!validIdPattern.test(id)) {\n      console.warn(`TachUI ID Modifier: Invalid ID format \"${id}\". IDs must start with a letter and contain only letters, digits, hyphens, underscores, colons, and periods.`)\n    }\n\n    // Check for duplicate IDs in development\n    if (document.getElementById(id)) {\n      console.warn(`TachUI ID Modifier: Duplicate ID \"${id}\" detected. IDs should be unique within the document.`)\n    }\n  }\n}\n\n/**\n * ID modifier function\n */\nexport function id(value: string): IdModifier {\n  return new IdModifier({ id: value })\n}\n\n// ============================================================================\n// Data Attributes Modifier - Data Attributes for Testing and Analytics\n// ============================================================================\n\nexport interface DataAttributes {\n  [key: string]: string | number | boolean\n}\n\nexport interface DataOptions {\n  data: DataAttributes\n}\n\nexport type ReactiveDataOptions = ReactiveModifierProps<DataOptions>\n\nexport class DataModifier extends BaseModifier<DataOptions> {\n  readonly type = 'data'\n  readonly priority = ModifierPriority.CUSTOM + 5\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element) return\n\n    const { data } = this.properties\n\n    // Validate data attributes in development mode\n    if (process.env.NODE_ENV === 'development') {\n      this.validateDataAttributes(data)\n    }\n\n    // Apply data attributes\n    Object.entries(data).forEach(([key, value]) => {\n      const attributeName = this.formatDataAttributeName(key)\n      const attributeValue = this.formatDataAttributeValue(value)\n      context.element!.setAttribute(attributeName, attributeValue)\n    })\n    \n    return undefined\n  }\n\n  private formatDataAttributeName(key: string): string {\n    // Convert camelCase to kebab-case and ensure data- prefix\n    const kebabKey = key.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`)\n    return kebabKey.startsWith('data-') ? kebabKey : `data-${kebabKey}`\n  }\n\n  private formatDataAttributeValue(value: string | number | boolean): string {\n    if (typeof value === 'boolean') {\n      return value ? 'true' : 'false'\n    }\n    return String(value)\n  }\n\n  private validateDataAttributes(data: DataAttributes): void {\n    Object.entries(data).forEach(([key, value]) => {\n      // Validate key format\n      if (!key || typeof key !== 'string') {\n        console.warn('TachUI Data Modifier: Data attribute keys must be non-empty strings')\n        return\n      }\n\n      // Check for valid data attribute naming\n      const validKeyPattern = /^[a-zA-Z][a-zA-Z0-9-_]*$/\n      if (!validKeyPattern.test(key.replace(/^data-/, ''))) {\n        console.warn(`TachUI Data Modifier: Invalid data attribute key \"${key}\". Keys should contain only letters, numbers, hyphens, and underscores.`)\n      }\n\n      // Validate value types\n      if (value !== null && value !== undefined && \n          typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean') {\n        console.warn(`TachUI Data Modifier: Data attribute \"${key}\" has invalid value type. Only strings, numbers, and booleans are supported.`)\n      }\n    })\n  }\n}\n\n/**\n * Data attributes modifier function\n */\nexport function data(attributes: DataAttributes): DataModifier {\n  return new DataModifier({ data: attributes })\n}\n\n// ============================================================================\n// ARIA Attributes Modifier - Accessibility Attributes\n// ============================================================================\n\nexport interface AriaAttributes {\n  // Common ARIA attributes with type safety\n  label?: string\n  labelledby?: string\n  describedby?: string\n  expanded?: boolean\n  hidden?: boolean\n  live?: 'off' | 'polite' | 'assertive'\n  atomic?: boolean\n  busy?: boolean\n  controls?: string\n  current?: boolean | 'page' | 'step' | 'location' | 'date' | 'time'\n  disabled?: boolean\n  grabbed?: boolean\n  haspopup?: boolean | 'false' | 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog'\n  invalid?: boolean | 'false' | 'true' | 'grammar' | 'spelling'\n  level?: number\n  multiline?: boolean\n  multiselectable?: boolean\n  orientation?: 'horizontal' | 'vertical'\n  owns?: string\n  placeholder?: string\n  posinset?: number\n  pressed?: boolean\n  readonly?: boolean\n  relevant?: 'additions' | 'removals' | 'text' | 'all' | string\n  required?: boolean\n  selected?: boolean\n  setsize?: number\n  sort?: 'none' | 'ascending' | 'descending' | 'other'\n  valuemax?: number\n  valuemin?: number\n  valuenow?: number\n  valuetext?: string\n  role?: string\n  // Allow custom ARIA attributes\n  [key: string]: string | number | boolean | undefined\n}\n\nexport interface AriaOptions {\n  aria: AriaAttributes\n}\n\nexport type ReactiveAriaOptions = ReactiveModifierProps<AriaOptions>\n\nexport class AriaModifier extends BaseModifier<AriaOptions> {\n  readonly type = 'aria'\n  readonly priority = ModifierPriority.CUSTOM + 15\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element) return\n\n    const { aria } = this.properties\n\n    // Validate ARIA attributes in development mode\n    if (process.env.NODE_ENV === 'development') {\n      this.validateAriaAttributes(aria)\n    }\n\n    // Apply ARIA attributes\n    Object.entries(aria).forEach(([key, value]) => {\n      if (value !== undefined && value !== null) {\n        const attributeName = this.formatAriaAttributeName(key)\n        const attributeValue = this.formatAriaAttributeValue(value)\n        context.element!.setAttribute(attributeName, attributeValue)\n      }\n    })\n    \n    return undefined\n  }\n\n  private formatAriaAttributeName(key: string): string {\n    // Handle special case of 'role' attribute\n    if (key === 'role') {\n      return 'role'\n    }\n\n    // Convert camelCase to kebab-case and ensure aria- prefix\n    const kebabKey = key.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`)\n    return kebabKey.startsWith('aria-') ? kebabKey : `aria-${kebabKey}`\n  }\n\n  private formatAriaAttributeValue(value: string | number | boolean): string {\n    if (typeof value === 'boolean') {\n      return value ? 'true' : 'false'\n    }\n    return String(value)\n  }\n\n  private validateAriaAttributes(aria: AriaAttributes): void {\n    const knownAttributes = new Set([\n      'label', 'labelledby', 'describedby', 'expanded', 'hidden', 'live', 'atomic',\n      'busy', 'controls', 'current', 'disabled', 'grabbed', 'haspopup', 'invalid',\n      'level', 'multiline', 'multiselectable', 'orientation', 'owns', 'placeholder',\n      'posinset', 'pressed', 'readonly', 'relevant', 'required', 'selected',\n      'setsize', 'sort', 'valuemax', 'valuemin', 'valuenow', 'valuetext', 'role'\n    ])\n\n    Object.entries(aria).forEach(([key, value]) => {\n      // Check for valid attribute names\n      if (!key || typeof key !== 'string') {\n        console.warn('TachUI ARIA Modifier: ARIA attribute keys must be non-empty strings')\n        return\n      }\n\n      // Warn about unknown ARIA attributes (but still allow them for extensibility)\n      const normalizedKey = key.replace(/^aria-/, '')\n      if (!knownAttributes.has(normalizedKey) && !normalizedKey.startsWith('aria-')) {\n        console.warn(`TachUI ARIA Modifier: Unknown ARIA attribute \"${key}\". This may not be a valid ARIA attribute. Did you mean \"${this.suggestCorrection(normalizedKey)}\"?`)\n      }\n\n      // Validate specific attribute values\n      this.validateSpecificAriaAttribute(key, value)\n    })\n  }\n\n  private validateSpecificAriaAttribute(key: string, value: any): void {\n    const normalizedKey = key.replace(/^aria-/, '')\n\n    switch (normalizedKey) {\n      case 'live':\n        if (value !== 'off' && value !== 'polite' && value !== 'assertive') {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-live. Valid values are: \"off\", \"polite\", \"assertive\"`)\n        }\n        break\n      case 'haspopup':\n        if (typeof value === 'string' && !['false', 'true', 'menu', 'listbox', 'tree', 'grid', 'dialog'].includes(value)) {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-haspopup. Valid values are: false, true, \"menu\", \"listbox\", \"tree\", \"grid\", \"dialog\"`)\n        }\n        break\n      case 'current':\n        if (typeof value === 'string' && !['page', 'step', 'location', 'date', 'time'].includes(value)) {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-current. Valid values are: false, true, \"page\", \"step\", \"location\", \"date\", \"time\"`)\n        }\n        break\n      case 'invalid':\n        if (typeof value === 'string' && !['false', 'true', 'grammar', 'spelling'].includes(value)) {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-invalid. Valid values are: false, true, \"grammar\", \"spelling\"`)\n        }\n        break\n      case 'orientation':\n        if (value !== 'horizontal' && value !== 'vertical') {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-orientation. Valid values are: \"horizontal\", \"vertical\"`)\n        }\n        break\n      case 'sort':\n        if (!['none', 'ascending', 'descending', 'other'].includes(value as string)) {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-sort. Valid values are: \"none\", \"ascending\", \"descending\", \"other\"`)\n        }\n        break\n      case 'level':\n      case 'posinset':\n      case 'setsize':\n      case 'valuemax':\n      case 'valuemin':\n      case 'valuenow':\n        if (typeof value === 'number' && (value < 0 || !Number.isInteger(value))) {\n          console.warn(`TachUI ARIA Modifier: Invalid value \"${value}\" for aria-${normalizedKey}. Must be a non-negative integer.`)\n        }\n        break\n    }\n  }\n\n  private suggestCorrection(key: string): string {\n    const suggestions: Record<string, string> = {\n      'lable': 'label',\n      'labeledby': 'labelledby',\n      'descripedby': 'describedby',\n      'descibed': 'describedby',\n      'controled': 'controls',\n      'expaned': 'expanded',\n      'hiden': 'hidden',\n      'disbled': 'disabled',\n      'requird': 'required',\n      'selectd': 'selected'\n    }\n    \n    return suggestions[key] || key\n  }\n}\n\n/**\n * ARIA attributes modifier function\n */\nexport function aria(attributes: AriaAttributes): AriaModifier {\n  return new AriaModifier({ aria: attributes })\n}\n\n// NOTE: TextShadow functionality has been moved to enhanced.ts for unified shadow system\n// Use the enhanced textShadow modifier instead: import { textShadow } from './enhanced'\n\n// ============================================================================\n// Tab Index Modifier - Tab Navigation Order\n// ============================================================================\n\nexport interface TabIndexOptions {\n  tabIndex: number\n}\n\nexport type ReactiveTabIndexOptions = ReactiveModifierProps<TabIndexOptions>\n\nexport class TabIndexModifier extends BaseModifier<TabIndexOptions> {\n  readonly type = 'tabIndex'\n  readonly priority = ModifierPriority.CUSTOM + 12\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element) return\n\n    const { tabIndex } = this.properties\n\n    // Validate tabIndex in development mode\n    if (process.env.NODE_ENV === 'development') {\n      this.validateTabIndex(tabIndex)\n    }\n\n    // Set tabindex attribute\n    context.element.setAttribute('tabindex', String(tabIndex))\n    \n    return undefined\n  }\n\n  private validateTabIndex(tabIndex: number): void {\n    if (typeof tabIndex !== 'number' || !Number.isInteger(tabIndex)) {\n      console.warn('TachUI TabIndex Modifier: tabIndex must be an integer')\n      return\n    }\n\n    // Provide helpful guidance\n    if (tabIndex > 0) {\n      console.info('TachUI TabIndex Modifier: Positive tabIndex values can disrupt natural tab order. Consider using tabIndex=\"0\" for focusable elements and tabIndex=\"-1\" for programmatically focusable elements.')\n    }\n\n    if (tabIndex < -1) {\n      console.warn('TachUI TabIndex Modifier: tabIndex values less than -1 are not recommended. Use -1 to remove from tab order or 0+ for tab order.')\n    }\n  }\n}\n\n/**\n * TabIndex modifier function\n */\nexport function tabIndex(value: number): TabIndexModifier {\n  return new TabIndexModifier({ tabIndex: value })\n}\n\n// ============================================================================\n// CSS Custom Properties Modifier (Moved from css-features.ts)\n// ============================================================================\n\nexport interface CSSCustomPropertiesConfig {\n  properties: Record<string, string | number>\n  scope?: 'local' | 'global' | 'root'\n}\n\nexport interface CustomPropertiesOptions {\n  properties?: Record<string, string | number>\n  scope?: 'local' | 'global' | 'root'\n}\n\nexport type ReactiveCustomPropertiesOptions = ReactiveModifierProps<CustomPropertiesOptions>\n\nexport class CustomPropertiesModifier extends BaseModifier<CustomPropertiesOptions> {\n  readonly type = 'customProperties'\n  readonly priority = 5  // Early application for CSS variables\n\n  constructor(options: ReactiveCustomPropertiesOptions) {\n    const resolvedOptions: CustomPropertiesOptions = {}\n    for (const [key, value] of Object.entries(options)) {\n      if (typeof value === 'function' && 'peek' in value) {\n        ;(resolvedOptions as any)[key] = (value as any).peek()\n      } else {\n        ;(resolvedOptions as any)[key] = value\n      }\n    }\n    super(resolvedOptions)\n  }\n\n  apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined {\n    if (!context.element) return\n\n    const styles = this.computeCustomPropertyStyles(this.properties)\n    this.applyStyles(context.element, styles)\n    \n    return undefined\n  }\n\n  private computeCustomPropertyStyles(props: CustomPropertiesOptions) {\n    const styles: Record<string, string> = {}\n\n    if (props.properties) {\n      for (const [name, value] of Object.entries(props.properties)) {\n        const propertyName = name.startsWith('--') ? name : `--${name}`\n        styles[propertyName] = this.formatPropertyValue(value)\n      }\n    }\n\n    return styles\n  }\n\n  private formatPropertyValue(value: string | number): string {\n    if (typeof value === 'number') {\n      return value.toString()\n    }\n    return value\n  }\n}\n\n/**\n * CSS custom properties modifier for creating CSS variables\n *\n * @example\n * ```typescript\n * .customProperties({\n *   properties: {\n *     'primary-color': '#007AFF',\n *     'font-size': 16,\n *     '--custom-spacing': '1rem'  // Already prefixed\n *   },\n *   scope: 'local'\n * })\n * ```\n */\nexport function customProperties(config: CSSCustomPropertiesConfig): CustomPropertiesModifier {\n  return new CustomPropertiesModifier({\n    properties: config.properties,\n    scope: config.scope || 'local'\n  })\n}\n\n/**\n * Single CSS custom property modifier\n *\n * @example\n * ```typescript\n * .customProperty('primary-color', '#007AFF')\n * .customProperty('--font-size', 16)  // Already prefixed\n * .customProperty('spacing', '1rem', 'global')\n * ```\n */\nexport function customProperty(name: string, value: string | number, scope?: 'local' | 'global' | 'root'): CustomPropertiesModifier {\n  const propertyName = name.startsWith('--') ? name : `--${name}`\n  return new CustomPropertiesModifier({\n    properties: { [propertyName]: value },\n    scope: scope || 'local'\n  })\n}\n\n/**\n * CSS variables modifier - alias for customProperties\n *\n * @example\n * ```typescript\n * .cssVariables({\n *   'primary': '#007AFF',\n *   'secondary': '#34C759',\n *   'spacing': 16\n * })\n * ```\n */\nexport function cssVariables(variables: Record<string, string | number>): CustomPropertiesModifier {\n  return new CustomPropertiesModifier({\n    properties: variables,\n    scope: 'local'\n  })\n}\n\n/**\n * Theme colors as CSS custom properties\n *\n * @example\n * ```typescript\n * .themeColors({\n *   primary: '#007AFF',\n *   secondary: '#34C759',\n *   accent: '#FF9500',\n *   background: '#FFFFFF',\n *   surface: '#F2F2F7'\n * })\n * ```\n */\nexport function themeColors(colors: Record<string, string>): CustomPropertiesModifier {\n  const themeProperties: Record<string, string> = {}\n  for (const [name, value] of Object.entries(colors)) {\n    themeProperties[`--theme-color-${name}`] = value\n  }\n  return new CustomPropertiesModifier({\n    properties: themeProperties,\n    scope: 'local'\n  })\n}\n\n/**\n * Design tokens as CSS custom properties\n *\n * @example\n * ```typescript\n * .designTokens({\n *   'spacing-sm': 8,\n *   'spacing-md': 16,\n *   'spacing-lg': 24,\n *   'border-radius': 8,\n *   'font-size-body': 16,\n *   'font-size-title': 24\n * })\n * ```\n */\nexport function designTokens(tokens: Record<string, string | number>): CustomPropertiesModifier {\n  const tokenProperties: Record<string, string | number> = {}\n  for (const [name, value] of Object.entries(tokens)) {\n    tokenProperties[`--token-${name}`] = value\n  }\n  return new CustomPropertiesModifier({\n    properties: tokenProperties,\n    scope: 'local'\n  })\n}"],"names":["IdModifier","BaseModifier","__publicField","ModifierPriority","_node","context","id","value","DataModifier","data","key","attributeName","attributeValue","kebabKey","letter","attributes","AriaModifier","aria","knownAttributes","normalizedKey","TabIndexModifier","tabIndex","CustomPropertiesModifier","options","resolvedOptions","styles","props","name","propertyName","customProperties","config","customProperty","scope","cssVariables","variables","themeColors","colors","themeProperties","designTokens","tokens","tokenProperties"],"mappings":"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"}

package/dist/modifiers/attributes.d.ts

@@ -0,0 +1,203 @@
+/**
+ * HTML and ARIA Attributes Implementation
+ *
+ * Implementation of HTML attributes, ARIA accessibility attributes, and related modifiers.
+ * These modifiers provide essential web functionality for accessibility, testing, and semantic markup.
+ */
+import type { DOMNode } from '../runtime/types';
+import { BaseModifier } from './base';
+import type { ModifierContext, ReactiveModifierProps } from './types';
+/**
+ * ID Modifier - HTML Element ID
+ * Sets the id attribute for page anchoring, accessibility, and testing selectors
+ */
+export interface IdOptions {
+    id: string;
+}
+export type ReactiveIdOptions = ReactiveModifierProps<IdOptions>;
+export declare class IdModifier extends BaseModifier<IdOptions> {
+    readonly type = "id";
+    readonly priority: number;
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private validateId;
+}
+/**
+ * ID modifier function
+ */
+export declare function id(value: string): IdModifier;
+export interface DataAttributes {
+    [key: string]: string | number | boolean;
+}
+export interface DataOptions {
+    data: DataAttributes;
+}
+export type ReactiveDataOptions = ReactiveModifierProps<DataOptions>;
+export declare class DataModifier extends BaseModifier<DataOptions> {
+    readonly type = "data";
+    readonly priority: number;
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private formatDataAttributeName;
+    private formatDataAttributeValue;
+    private validateDataAttributes;
+}
+/**
+ * Data attributes modifier function
+ */
+export declare function data(attributes: DataAttributes): DataModifier;
+export interface AriaAttributes {
+    label?: string;
+    labelledby?: string;
+    describedby?: string;
+    expanded?: boolean;
+    hidden?: boolean;
+    live?: 'off' | 'polite' | 'assertive';
+    atomic?: boolean;
+    busy?: boolean;
+    controls?: string;
+    current?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
+    disabled?: boolean;
+    grabbed?: boolean;
+    haspopup?: boolean | 'false' | 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+    invalid?: boolean | 'false' | 'true' | 'grammar' | 'spelling';
+    level?: number;
+    multiline?: boolean;
+    multiselectable?: boolean;
+    orientation?: 'horizontal' | 'vertical';
+    owns?: string;
+    placeholder?: string;
+    posinset?: number;
+    pressed?: boolean;
+    readonly?: boolean;
+    relevant?: 'additions' | 'removals' | 'text' | 'all' | string;
+    required?: boolean;
+    selected?: boolean;
+    setsize?: number;
+    sort?: 'none' | 'ascending' | 'descending' | 'other';
+    valuemax?: number;
+    valuemin?: number;
+    valuenow?: number;
+    valuetext?: string;
+    role?: string;
+    [key: string]: string | number | boolean | undefined;
+}
+export interface AriaOptions {
+    aria: AriaAttributes;
+}
+export type ReactiveAriaOptions = ReactiveModifierProps<AriaOptions>;
+export declare class AriaModifier extends BaseModifier<AriaOptions> {
+    readonly type = "aria";
+    readonly priority: number;
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private formatAriaAttributeName;
+    private formatAriaAttributeValue;
+    private validateAriaAttributes;
+    private validateSpecificAriaAttribute;
+    private suggestCorrection;
+}
+/**
+ * ARIA attributes modifier function
+ */
+export declare function aria(attributes: AriaAttributes): AriaModifier;
+export interface TabIndexOptions {
+    tabIndex: number;
+}
+export type ReactiveTabIndexOptions = ReactiveModifierProps<TabIndexOptions>;
+export declare class TabIndexModifier extends BaseModifier<TabIndexOptions> {
+    readonly type = "tabIndex";
+    readonly priority: number;
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private validateTabIndex;
+}
+/**
+ * TabIndex modifier function
+ */
+export declare function tabIndex(value: number): TabIndexModifier;
+export interface CSSCustomPropertiesConfig {
+    properties: Record<string, string | number>;
+    scope?: 'local' | 'global' | 'root';
+}
+export interface CustomPropertiesOptions {
+    properties?: Record<string, string | number>;
+    scope?: 'local' | 'global' | 'root';
+}
+export type ReactiveCustomPropertiesOptions = ReactiveModifierProps<CustomPropertiesOptions>;
+export declare class CustomPropertiesModifier extends BaseModifier<CustomPropertiesOptions> {
+    readonly type = "customProperties";
+    readonly priority = 5;
+    constructor(options: ReactiveCustomPropertiesOptions);
+    apply(_node: DOMNode, context: ModifierContext): DOMNode | undefined;
+    private computeCustomPropertyStyles;
+    private formatPropertyValue;
+}
+/**
+ * CSS custom properties modifier for creating CSS variables
+ *
+ * @example
+ * ```typescript
+ * .customProperties({
+ *   properties: {
+ *     'primary-color': '#007AFF',
+ *     'font-size': 16,
+ *     '--custom-spacing': '1rem'  // Already prefixed
+ *   },
+ *   scope: 'local'
+ * })
+ * ```
+ */
+export declare function customProperties(config: CSSCustomPropertiesConfig): CustomPropertiesModifier;
+/**
+ * Single CSS custom property modifier
+ *
+ * @example
+ * ```typescript
+ * .customProperty('primary-color', '#007AFF')
+ * .customProperty('--font-size', 16)  // Already prefixed
+ * .customProperty('spacing', '1rem', 'global')
+ * ```
+ */
+export declare function customProperty(name: string, value: string | number, scope?: 'local' | 'global' | 'root'): CustomPropertiesModifier;
+/**
+ * CSS variables modifier - alias for customProperties
+ *
+ * @example
+ * ```typescript
+ * .cssVariables({
+ *   'primary': '#007AFF',
+ *   'secondary': '#34C759',
+ *   'spacing': 16
+ * })
+ * ```
+ */
+export declare function cssVariables(variables: Record<string, string | number>): CustomPropertiesModifier;
+/**
+ * Theme colors as CSS custom properties
+ *
+ * @example
+ * ```typescript
+ * .themeColors({
+ *   primary: '#007AFF',
+ *   secondary: '#34C759',
+ *   accent: '#FF9500',
+ *   background: '#FFFFFF',
+ *   surface: '#F2F2F7'
+ * })
+ * ```
+ */
+export declare function themeColors(colors: Record<string, string>): CustomPropertiesModifier;
+/**
+ * Design tokens as CSS custom properties
+ *
+ * @example
+ * ```typescript
+ * .designTokens({
+ *   'spacing-sm': 8,
+ *   'spacing-md': 16,
+ *   'spacing-lg': 24,
+ *   'border-radius': 8,
+ *   'font-size-body': 16,
+ *   'font-size-title': 24
+ * })
+ * ```
+ */
+export declare function designTokens(tokens: Record<string, string | number>): CustomPropertiesModifier;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/modifiers/attributes.d.ts.map

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