@tachui/core 0.7.0-alpha1

package/dist/concatenation/concatenatable.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Concatenatable Interface Implementation
+ *
+ * Provides the base implementation for components that support concatenation
+ * using the SwiftUI-style + operator syntax.
+ */
+import type { ComponentInstance } from '../runtime/types';
+import type { Concatenatable, ComponentSegment } from './types';
+import { ConcatenatedComponent } from './concatenated-component';
+/**
+ * Symbol for concatenation operations - matches the one used in types
+ */
+export declare const CONCAT_SYMBOL: unique symbol;
+/**
+ * Base implementation for concatenatable functionality
+ * This can be mixed into component classes
+ */
+export declare abstract class ConcatenatableBase<T = any> implements Concatenatable<T> {
+    abstract readonly id: string;
+    abstract readonly type: string;
+    /**
+     * Concatenate this component with another concatenatable component
+     */
+    concat<U extends Concatenatable<any>>(other: U): ConcatenatedComponent<T | U>;
+    /**
+     * Convert this component to a segment for concatenation
+     */
+    abstract toSegment(): ComponentSegment;
+    /**
+     * Check if this component supports concatenation
+     */
+    isConcatenatable(): boolean;
+    /**
+     * Create metadata for a new concatenated component
+     */
+    protected createMetadata(totalSegments: number): import('./types').ConcatenationMetadata;
+    /**
+     * Merge metadata when concatenating with existing concatenated component
+     */
+    protected mergeMetadata(existing: import('./types').ConcatenationMetadata, newTotal: number): import('./types').ConcatenationMetadata;
+    /**
+     * Determine the accessibility role for this component
+     */
+    protected determineAccessibilityRole(): 'text' | 'group' | 'composite';
+    /**
+     * Determine the semantic structure for this component
+     */
+    protected determineSemanticStructure(): 'inline' | 'block' | 'mixed';
+    /**
+     * Merge accessibility roles when combining components
+     */
+    protected mergeAccessibilityRoles(existing: 'text' | 'group' | 'composite'): 'text' | 'group' | 'composite';
+    /**
+     * Merge semantic structures when combining components
+     */
+    protected mergeSemanticStructures(existing: 'inline' | 'block' | 'mixed'): 'inline' | 'block' | 'mixed';
+}
+/**
+ * Utility function to make any component concatenatable
+ * This can be used as a mixin for existing components
+ */
+export declare function makeConcatenatable<T extends ComponentInstance>(component: T): T & Concatenatable;
+//# sourceMappingURL=concatenatable.d.ts.map

package/dist/concatenation/concatenatable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concatenatable.d.ts","sourceRoot":"","sources":["../../src/concatenation/concatenatable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,aAAa,eAA8B,CAAA;AAExD;;;GAGG;AACH,8BAAsB,kBAAkB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAE9B;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC;IAmB7E;;OAEG;IACH,QAAQ,CAAC,SAAS,IAAI,gBAAgB;IAEtC;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,SAAS,EAAE,qBAAqB;IAQxF;;OAEG;IACH,SAAS,CAAC,aAAa,CACrB,QAAQ,EAAE,OAAO,SAAS,EAAE,qBAAqB,EACjD,QAAQ,EAAE,MAAM,GACf,OAAO,SAAS,EAAE,qBAAqB;IAQ1C;;OAEG;IACH,SAAS,CAAC,0BAA0B,IAAI,MAAM,GAAG,OAAO,GAAG,WAAW;IAWtE;;OAEG;IACH,SAAS,CAAC,0BAA0B,IAAI,QAAQ,GAAG,OAAO,GAAG,OAAO;IAUpE;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAC/B,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GACvC,MAAM,GAAG,OAAO,GAAG,WAAW;IAajC;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAC/B,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GACrC,QAAQ,GAAG,OAAO,GAAG,OAAO;CAYhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,iBAAiB,EAC5D,SAAS,EAAE,CAAC,GACX,CAAC,GAAG,cAAc,CAyDpB"}

package/dist/concatenation/concatenatable.js

@@ -0,0 +1,118 @@
+import { ConcatenatedComponent as n } from "./concatenated-component.js";
+const a = Symbol.for("tachui.concat");
+class m {
+  /**
+   * Concatenate this component with another concatenatable component
+   */
+  concat(e) {
+    const t = this.toSegment(), r = e.toSegment();
+    return e instanceof n ? new n(
+      [t, ...e.segments],
+      this.mergeMetadata(e.metadata, e.segments.length + 1)
+    ) : new n(
+      [t, r],
+      this.createMetadata(2)
+    );
+  }
+  /**
+   * Check if this component supports concatenation
+   */
+  isConcatenatable() {
+    return !0;
+  }
+  /**
+   * Create metadata for a new concatenated component
+   */
+  createMetadata(e) {
+    return {
+      totalSegments: e,
+      accessibilityRole: this.determineAccessibilityRole(),
+      semanticStructure: this.determineSemanticStructure()
+    };
+  }
+  /**
+   * Merge metadata when concatenating with existing concatenated component
+   */
+  mergeMetadata(e, t) {
+    return {
+      totalSegments: t,
+      accessibilityRole: this.mergeAccessibilityRoles(e.accessibilityRole),
+      semanticStructure: this.mergeSemanticStructures(e.semanticStructure)
+    };
+  }
+  /**
+   * Determine the accessibility role for this component
+   */
+  determineAccessibilityRole() {
+    const e = this.constructor.name;
+    return e === "EnhancedText" ? "text" : e === "EnhancedImage" || e === "EnhancedButton" || e === "EnhancedLink" ? "group" : "composite";
+  }
+  /**
+   * Determine the semantic structure for this component
+   */
+  determineSemanticStructure() {
+    const e = this.constructor.name;
+    return e === "EnhancedText" || e === "EnhancedImage" ? "inline" : "mixed";
+  }
+  /**
+   * Merge accessibility roles when combining components
+   */
+  mergeAccessibilityRoles(e) {
+    const t = this.determineAccessibilityRole();
+    return t === "text" && e === "text" ? "text" : t === "composite" || e === "composite" ? "composite" : "group";
+  }
+  /**
+   * Merge semantic structures when combining components
+   */
+  mergeSemanticStructures(e) {
+    const t = this.determineSemanticStructure();
+    return t === "inline" && e === "inline" ? "inline" : t === "block" && e === "block" ? "block" : "mixed";
+  }
+}
+function u(c) {
+  const e = c;
+  return e.concat = function(t) {
+    const r = {
+      id: this.id,
+      component: this,
+      modifiers: this.modifiers || [],
+      render: () => {
+        const i = this.render();
+        return Array.isArray(i) ? i[0] : i;
+      }
+    }, s = t.toSegment();
+    return t instanceof n ? new n(
+      [r, ...t.segments],
+      {
+        totalSegments: t.segments.length + 1,
+        accessibilityRole: "group",
+        semanticStructure: "mixed"
+      }
+    ) : new n(
+      [r, s],
+      {
+        totalSegments: 2,
+        accessibilityRole: "group",
+        semanticStructure: "mixed"
+      }
+    );
+  }, e.toSegment = function() {
+    return {
+      id: this.id,
+      component: this,
+      modifiers: this.modifiers || [],
+      render: () => {
+        const t = this.render();
+        return Array.isArray(t) ? t[0] : t;
+      }
+    };
+  }, e.isConcatenatable = function() {
+    return !0;
+  }, e;
+}
+export {
+  a as CONCAT_SYMBOL,
+  m as ConcatenatableBase,
+  u as makeConcatenatable
+};
+//# sourceMappingURL=concatenatable.js.map

package/dist/concatenation/concatenatable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concatenatable.js","sources":["../../src/concatenation/concatenatable.ts"],"sourcesContent":["/**\n * Concatenatable Interface Implementation\n * \n * Provides the base implementation for components that support concatenation\n * using the SwiftUI-style + operator syntax.\n */\n\nimport type { ComponentInstance } from '../runtime/types'\nimport type { Concatenatable, ComponentSegment } from './types'\nimport { ConcatenatedComponent } from './concatenated-component'\n\n/**\n * Symbol for concatenation operations - matches the one used in types\n */\nexport const CONCAT_SYMBOL = Symbol.for('tachui.concat')\n\n/**\n * Base implementation for concatenatable functionality\n * This can be mixed into component classes\n */\nexport abstract class ConcatenatableBase<T = any> implements Concatenatable<T> {\n  abstract readonly id: string\n  abstract readonly type: string\n  \n  /**\n   * Concatenate this component with another concatenatable component\n   */\n  concat<U extends Concatenatable<any>>(other: U): ConcatenatedComponent<T | U> {\n    const thisSegment = this.toSegment()\n    const otherSegment = other.toSegment()\n    \n    // If other is already a concatenated component, merge segments\n    if (other instanceof ConcatenatedComponent) {\n      return new ConcatenatedComponent(\n        [thisSegment, ...other.segments],\n        this.mergeMetadata(other.metadata, other.segments.length + 1)\n      )\n    }\n    \n    // Create new concatenated component with both segments\n    return new ConcatenatedComponent(\n      [thisSegment, otherSegment],\n      this.createMetadata(2)\n    )\n  }\n  \n  /**\n   * Convert this component to a segment for concatenation\n   */\n  abstract toSegment(): ComponentSegment\n  \n  /**\n   * Check if this component supports concatenation\n   */\n  isConcatenatable(): boolean {\n    return true\n  }\n  \n  /**\n   * Create metadata for a new concatenated component\n   */\n  protected createMetadata(totalSegments: number): import('./types').ConcatenationMetadata {\n    return {\n      totalSegments,\n      accessibilityRole: this.determineAccessibilityRole(),\n      semanticStructure: this.determineSemanticStructure()\n    }\n  }\n  \n  /**\n   * Merge metadata when concatenating with existing concatenated component\n   */\n  protected mergeMetadata(\n    existing: import('./types').ConcatenationMetadata, \n    newTotal: number\n  ): import('./types').ConcatenationMetadata {\n    return {\n      totalSegments: newTotal,\n      accessibilityRole: this.mergeAccessibilityRoles(existing.accessibilityRole),\n      semanticStructure: this.mergeSemanticStructures(existing.semanticStructure)\n    }\n  }\n  \n  /**\n   * Determine the accessibility role for this component\n   */\n  protected determineAccessibilityRole(): 'text' | 'group' | 'composite' {\n    // Default implementation - subclasses should override\n    const componentType = this.constructor.name\n    \n    if (componentType === 'EnhancedText') return 'text'\n    if (componentType === 'EnhancedImage') return 'group'\n    if (componentType === 'EnhancedButton' || componentType === 'EnhancedLink') return 'group'\n    \n    return 'composite'\n  }\n  \n  /**\n   * Determine the semantic structure for this component\n   */\n  protected determineSemanticStructure(): 'inline' | 'block' | 'mixed' {\n    // Default implementation - subclasses should override\n    const componentType = this.constructor.name\n    \n    if (componentType === 'EnhancedText') return 'inline'\n    if (componentType === 'EnhancedImage') return 'inline'\n    \n    return 'mixed'\n  }\n  \n  /**\n   * Merge accessibility roles when combining components\n   */\n  protected mergeAccessibilityRoles(\n    existing: 'text' | 'group' | 'composite'\n  ): 'text' | 'group' | 'composite' {\n    const thisRole = this.determineAccessibilityRole()\n    \n    // If both are text, keep text\n    if (thisRole === 'text' && existing === 'text') return 'text'\n    \n    // If either is composite, result is composite\n    if (thisRole === 'composite' || existing === 'composite') return 'composite'\n    \n    // Otherwise, it's a group\n    return 'group'\n  }\n  \n  /**\n   * Merge semantic structures when combining components\n   */\n  protected mergeSemanticStructures(\n    existing: 'inline' | 'block' | 'mixed'\n  ): 'inline' | 'block' | 'mixed' {\n    const thisStructure = this.determineSemanticStructure()\n    \n    // If both are inline, keep inline\n    if (thisStructure === 'inline' && existing === 'inline') return 'inline'\n    \n    // If both are block, keep block\n    if (thisStructure === 'block' && existing === 'block') return 'block'\n    \n    // Otherwise, it's mixed\n    return 'mixed'\n  }\n}\n\n/**\n * Utility function to make any component concatenatable\n * This can be used as a mixin for existing components\n */\nexport function makeConcatenatable<T extends ComponentInstance>(\n  component: T\n): T & Concatenatable {\n  const concatenatable = component as T & Concatenatable\n  \n  // Add concatenation method\n  concatenatable.concat = function<U extends Concatenatable<any>>(\n    other: U\n  ): ConcatenatedComponent<any> {\n    const thisSegment: ComponentSegment = {\n      id: this.id,\n      component: this,\n      modifiers: (this as any).modifiers || [],\n      render: () => {\n        const rendered = this.render()\n        return Array.isArray(rendered) ? rendered[0] : rendered\n      }\n    }\n    \n    const otherSegment = other.toSegment()\n    \n    if (other instanceof ConcatenatedComponent) {\n      return new ConcatenatedComponent(\n        [thisSegment, ...other.segments],\n        {\n          totalSegments: other.segments.length + 1,\n          accessibilityRole: 'group',\n          semanticStructure: 'mixed'\n        }\n      )\n    }\n    \n    return new ConcatenatedComponent(\n      [thisSegment, otherSegment],\n      {\n        totalSegments: 2,\n        accessibilityRole: 'group',\n        semanticStructure: 'mixed'\n      }\n    )\n  }\n  \n  concatenatable.toSegment = function(): ComponentSegment {\n    return {\n      id: this.id,\n      component: this,\n      modifiers: (this as any).modifiers || [],\n      render: () => {\n        const rendered = this.render()\n        return Array.isArray(rendered) ? rendered[0] : rendered\n      }\n    }\n  }\n  \n  concatenatable.isConcatenatable = function(): boolean {\n    return true\n  }\n  \n  return concatenatable\n}"],"names":["CONCAT_SYMBOL","ConcatenatableBase","other","thisSegment","otherSegment","ConcatenatedComponent","totalSegments","existing","newTotal","componentType","thisRole","thisStructure","makeConcatenatable","component","concatenatable","rendered"],"mappings":"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"}

package/dist/concatenation/concatenated-component.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../runtime/renderer.cjs");var l=Object.defineProperty,u=(c,e,t)=>e in c?l(c,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):c[e]=t,r=(c,e,t)=>u(c,typeof e!="symbol"?e+"":e,t);class o{constructor(e,t,n=!0){this.metadata=t,r(this,"type","component"),r(this,"id"),r(this,"mounted",!1),r(this,"cleanup",[]),r(this,"props",{}),r(this,"segments"),this.id=`concat-${Date.now()}-${Math.random().toString(36).substr(2,9)}`,this.segments=e}render(){const e=this.determineContainerClass(),t=this.buildAccessibilityLabel(),n=this.buildAccessibilityAttributes(),s=this.segments.map(i=>i.render()).flat();return[m.h("span",{class:`tachui-concatenated ${e}`,...n,"aria-label":t||void 0,...this.hasInteractiveContent()&&{"aria-live":"polite","aria-atomic":"true"},...process.env.NODE_ENV==="development"&&{"data-concatenated-segments":this.segments.length,"data-semantic-structure":this.metadata.semanticStructure,"data-accessibility-role":this.metadata.accessibilityRole}},...s)]}buildAccessibilityAttributes(){const e={};switch(this.metadata.accessibilityRole){case"text":break;case"group":e.role="group",e["aria-describedby"]=this.generateGroupDescription();break;case"composite":e.role="group",e["aria-roledescription"]="interactive content group";break}return this.metadata.semanticStructure==="mixed"&&this.segments.length>2&&(e["aria-flowto"]=this.generateFlowTargets()),this.hasInteractiveContent()&&(e.tabindex="0",e["aria-description"]="Contains interactive elements. Use Tab to navigate."),e}generateGroupDescription(){const e=this.getUniqueComponentTypes();return e.length===1?`Group of ${this.segments.length} ${e[0]} elements`:`Group containing ${e.join(", ")} elements`}generateFlowTargets(){return""}hasInteractiveContent(){return this.segments.some(e=>{const t=e.component.constructor.name;return t==="EnhancedButton"||t==="EnhancedLinkComponent"})}getUniqueComponentTypes(){const e=new Set(this.segments.map(t=>{switch(t.component.constructor.name){case"EnhancedText":return"text";case"EnhancedImage":return"image";case"EnhancedButton":return"button";case"EnhancedLinkComponent":return"link";default:return"component"}}));return Array.from(e)}concat(e){let t,n;return e instanceof o?(t=[...this.segments,...e.segments],n=this.mergeMetadata(this.metadata,e.metadata,t.length)):(t=[...this.segments,e.toSegment()],n=this.mergeMetadata(this.metadata,{totalSegments:1,accessibilityRole:this.determineComponentAccessibilityRole(e),semanticStructure:this.determineComponentSemanticStructure(e)},t.length)),new o(t,n)}toSegment(){return{id:this.id,component:this,modifiers:[],render:()=>this.render()[0]}}isConcatenatable(){return!0}determineContainerClass(){const e=this.segments.map(i=>i.component.constructor.name),t=e.some(i=>i==="EnhancedImage"),n=e.some(i=>i==="EnhancedText"),s=e.some(i=>i==="EnhancedButton"),a=e.some(i=>i==="EnhancedLink");return t&&n&&(s||a)?"mixed-content":t&&n?"image-text-composition":t&&!n?"image-composition":n&&!t?"text-composition":"generic-composition"}buildAccessibilityLabel(){const t=this.segments.map(n=>this.extractAccessibilityText(n)).filter(Boolean);return t.length===0?"":this.joinAccessibilityLabels(t)}joinAccessibilityLabels(e){if(e.length===1)return e[0];switch(this.metadata.semanticStructure){case"inline":return e.join(" ");case"block":return e.join(". ");case"mixed":return this.smartJoinLabels(e);default:return e.join(" ")}}smartJoinLabels(e){const t=[];for(let n=0;n<e.length;n++){const s=e[n],a=e[n+1];t.push(s),a&&(this.needsExplicitSeparator(s,a)?t.push(". "):t.push(" "))}return t.join("")}needsExplicitSeparator(e,t){const n=/[.!?:;]$/.test(e.trim()),s=/^[A-Z]/.test(t.trim());return!n&&s}extractAccessibilityText(e){const t=e.component;switch(t.constructor.name){case"EnhancedText":return t.content||t.title||"";case"EnhancedImage":return t.alt||t.accessibilityLabel||"Image";case"EnhancedButton":return t.title||t.accessibilityLabel||"Button";case"EnhancedLink":return t.title||t.accessibilityLabel||"Link";case"ConcatenatedComponent":return t.buildAccessibilityLabel();default:return t.accessibilityLabel||""}}mergeMetadata(e,t,n){return{totalSegments:n,accessibilityRole:this.mergeAccessibilityRoles(e.accessibilityRole,t.accessibilityRole),semanticStructure:this.mergeSemanticStructures(e.semanticStructure,t.semanticStructure)}}mergeAccessibilityRoles(e,t){return e==="text"&&t==="text"?"text":e==="composite"||t==="composite"?"composite":"group"}mergeSemanticStructures(e,t){return e==="inline"&&t==="inline"?"inline":e==="block"&&t==="block"?"block":"mixed"}determineComponentAccessibilityRole(e){switch(e.constructor.name){case"EnhancedText":return"text";case"EnhancedImage":return"group";case"EnhancedButton":case"EnhancedLink":return"group";default:return"composite"}}determineComponentSemanticStructure(e){switch(e.constructor.name){case"EnhancedText":case"EnhancedImage":return"inline";case"EnhancedButton":case"EnhancedLink":return"inline";default:return"mixed"}}generateAccessibilityTree(){return{role:this.metadata.accessibilityRole,label:this.buildAccessibilityLabel(),children:this.segments.map(e=>this.segmentToAccessibilityNode(e))}}segmentToAccessibilityNode(e){const t=e.component;return{role:this.determineComponentAccessibilityRole(t),label:this.extractAccessibilityText(e),children:t instanceof o?t.generateAccessibilityTree().children:void 0}}}exports.ConcatenatedComponent=o;
+//# sourceMappingURL=concatenated-component.cjs.map

package/dist/concatenation/concatenated-component.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"concatenated-component.cjs","sources":["../../src/concatenation/concatenated-component.ts"],"sourcesContent":["/**\n * ConcatenatedComponent Implementation\n * \n * The main class that represents a concatenated component composed of multiple\n * component segments. Handles rendering, accessibility, and further concatenation.\n */\n\nimport { h } from '../runtime/renderer'\nimport type { ComponentInstance, DOMNode } from '../runtime/types'\nimport type { \n  Concatenatable, \n  ComponentSegment, \n  ConcatenationMetadata,\n  AccessibilityNode \n} from './types'\n// import { CONCAT_SYMBOL } from './concatenatable' // Unused\n\n/**\n * A component that represents the concatenation of multiple components\n */\nexport class ConcatenatedComponent<T = any> \n  implements ComponentInstance<any>, Concatenatable<T> {\n  \n  public readonly type = 'component' as const\n  public readonly id: string\n  public mounted = false\n  public cleanup: (() => void)[] = []\n  public props: any = {} // Required by ComponentInstance interface\n  public segments: ComponentSegment[] // Make segments public\n  \n  constructor(\n    segments: ComponentSegment[],\n    public metadata: ConcatenationMetadata,\n    _enableOptimization: boolean = true\n  ) {\n    this.id = `concat-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n    \n    // Temporarily disable optimization to avoid require() issues in browser\n    // TODO: Fix text optimization to work in browser environment\n    this.segments = segments\n    \n    // Apply text optimization if enabled and beneficial (disabled for now)\n    // if (enableOptimization && TextConcatenationOptimizer.shouldOptimize(segments)) {\n    //   this.segments = TextConcatenationOptimizer.optimize(segments)\n    //   \n    //   // Log optimization stats in development\n    //   if (process.env.NODE_ENV === 'development') {\n    //     const stats = TextConcatenationOptimizer.getOptimizationStats(segments, this.segments)\n    //     console.log(`TachUI Concatenation: Optimized ${stats.originalCount} → ${stats.optimizedCount} segments (${stats.reductionPercent}% reduction)`)\n    //   }\n    // } else {\n    //   this.segments = segments\n    // }\n  }\n  \n  /**\n   * Render the concatenated component to DOM nodes (Enhanced - Phase 4.2)\n   */\n  render(): DOMNode[] {\n    const containerClass = this.determineContainerClass()\n    const ariaLabel = this.buildAccessibilityLabel()\n    const accessibilityAttributes = this.buildAccessibilityAttributes()\n    \n    // Render all segments and flatten the results\n    const segmentNodes = this.segments.map(segment => segment.render()).flat()\n    \n    // Create container element with comprehensive accessibility\n    const container = h('span', {\n      class: `tachui-concatenated ${containerClass}`,\n      ...accessibilityAttributes,\n      'aria-label': ariaLabel || undefined,\n      // Enhanced live region support for dynamic content\n      ...(this.hasInteractiveContent() && {\n        'aria-live': 'polite',\n        'aria-atomic': 'true'\n      }),\n      // Add debug information in development\n      ...(process.env.NODE_ENV === 'development' && {\n        'data-concatenated-segments': this.segments.length,\n        'data-semantic-structure': this.metadata.semanticStructure,\n        'data-accessibility-role': this.metadata.accessibilityRole\n      })\n    }, ...segmentNodes)\n    \n    return [container]\n  }\n  \n  /**\n   * Build comprehensive accessibility attributes\n   */\n  private buildAccessibilityAttributes(): Record<string, string> {\n    const attributes: Record<string, string> = {}\n    \n    // Set appropriate role based on metadata\n    switch (this.metadata.accessibilityRole) {\n      case 'text':\n        // For text-only content, no explicit role needed (default text semantics)\n        break\n      \n      case 'group':\n        attributes.role = 'group'\n        // Add description for groups to clarify purpose\n        attributes['aria-describedby'] = this.generateGroupDescription()\n        break\n      \n      case 'composite':\n        attributes.role = 'group'\n        // For composite content (with interactive elements), mark as application region\n        attributes['aria-roledescription'] = 'interactive content group'\n        break\n    }\n    \n    // Add reading order hints for complex layouts\n    if (this.metadata.semanticStructure === 'mixed' && this.segments.length > 2) {\n      attributes['aria-flowto'] = this.generateFlowTargets()\n    }\n    \n    // Add keyboard navigation hints for interactive content\n    if (this.hasInteractiveContent()) {\n      attributes.tabindex = '0'\n      attributes['aria-description'] = 'Contains interactive elements. Use Tab to navigate.'\n    }\n    \n    return attributes\n  }\n  \n  /**\n   * Generate description for grouped content\n   */\n  private generateGroupDescription(): string {\n    const componentTypes = this.getUniqueComponentTypes()\n    \n    if (componentTypes.length === 1) {\n      return `Group of ${this.segments.length} ${componentTypes[0]} elements`\n    }\n    \n    return `Group containing ${componentTypes.join(', ')} elements`\n  }\n  \n  /**\n   * Generate flow targets for reading order\n   */\n  private generateFlowTargets(): string {\n    // This would typically reference IDs of next focusable elements\n    // For now, return empty string as it requires DOM coordination\n    return ''\n  }\n  \n  /**\n   * Check if concatenated content contains interactive elements\n   */\n  private hasInteractiveContent(): boolean {\n    return this.segments.some(segment => {\n      const componentType = segment.component.constructor.name\n      return componentType === 'EnhancedButton' || componentType === 'EnhancedLinkComponent'\n    })\n  }\n  \n  /**\n   * Get unique component types in this concatenation\n   */\n  private getUniqueComponentTypes(): string[] {\n    const types = new Set(this.segments.map(segment => {\n      const componentType = segment.component.constructor.name\n      switch (componentType) {\n        case 'EnhancedText': return 'text'\n        case 'EnhancedImage': return 'image'\n        case 'EnhancedButton': return 'button'\n        case 'EnhancedLinkComponent': return 'link'\n        default: return 'component'\n      }\n    }))\n    \n    return Array.from(types)\n  }\n  \n  /**\n   * Concatenate this component with another concatenatable component\n   */\n  concat<U extends Concatenatable<any>>(other: U): ConcatenatedComponent<T | U> {\n    let newSegments: ComponentSegment[]\n    let newMetadata: ConcatenationMetadata\n    \n    if (other instanceof ConcatenatedComponent) {\n      // Merging with another concatenated component\n      newSegments = [...this.segments, ...other.segments]\n      newMetadata = this.mergeMetadata(this.metadata, other.metadata, newSegments.length)\n    } else {\n      // Adding a single component\n      newSegments = [...this.segments, other.toSegment()]\n      newMetadata = this.mergeMetadata(\n        this.metadata, \n        {\n          totalSegments: 1,\n          accessibilityRole: this.determineComponentAccessibilityRole(other),\n          semanticStructure: this.determineComponentSemanticStructure(other)\n        },\n        newSegments.length\n      )\n    }\n    \n    return new ConcatenatedComponent(newSegments, newMetadata)\n  }\n  \n  /**\n   * Convert this concatenated component to a segment (for further concatenation)\n   */\n  toSegment(): ComponentSegment {\n    return {\n      id: this.id,\n      component: this as any, // Cast to satisfy interface requirements\n      modifiers: [], // Concatenated components don't have their own modifiers\n      render: () => this.render()[0]\n    }\n  }\n  \n  /**\n   * Check if this component supports concatenation\n   */\n  isConcatenatable(): boolean {\n    return true\n  }\n  \n  /**\n   * Determine the appropriate CSS class for the container\n   */\n  private determineContainerClass(): string {\n    const componentTypes = this.segments.map(s => s.component.constructor.name)\n    \n    const hasImages = componentTypes.some(type => type === 'EnhancedImage')\n    const hasText = componentTypes.some(type => type === 'EnhancedText')\n    const hasButtons = componentTypes.some(type => type === 'EnhancedButton')\n    const hasLinks = componentTypes.some(type => type === 'EnhancedLink')\n    \n    // Determine the most appropriate container class\n    if (hasImages && hasText && (hasButtons || hasLinks)) {\n      return 'mixed-content'\n    } else if (hasImages && hasText) {\n      return 'image-text-composition'\n    } else if (hasImages && !hasText) {\n      return 'image-composition'\n    } else if (hasText && !hasImages) {\n      return 'text-composition'\n    } else {\n      return 'generic-composition'\n    }\n  }\n  \n  /**\n   * Build comprehensive accessibility label for screen readers (Enhanced - Phase 4.2)\n   */\n  private buildAccessibilityLabel(): string {\n    const labels = this.segments.map(segment => this.extractAccessibilityText(segment))\n    \n    // Filter out empty labels and format appropriately\n    const cleanLabels = labels.filter(Boolean)\n    \n    if (cleanLabels.length === 0) return ''\n    \n    // Apply intelligent joining based on content type\n    return this.joinAccessibilityLabels(cleanLabels)\n  }\n  \n  /**\n   * Intelligently join accessibility labels based on content and structure\n   */\n  private joinAccessibilityLabels(labels: string[]): string {\n    if (labels.length === 1) return labels[0]\n    \n    // Analyze the semantic structure to determine appropriate joining\n    switch (this.metadata.semanticStructure) {\n      case 'inline':\n        // For inline content, join with spaces (natural reading flow)\n        return labels.join(' ')\n      \n      case 'block':\n        // For block content, use more explicit separators\n        return labels.join('. ')\n      \n      case 'mixed':\n        // For mixed content, use context-aware joining\n        return this.smartJoinLabels(labels)\n      \n      default:\n        return labels.join(' ')\n    }\n  }\n  \n  /**\n   * Context-aware label joining for mixed content\n   */\n  private smartJoinLabels(labels: string[]): string {\n    const result: string[] = []\n    \n    for (let i = 0; i < labels.length; i++) {\n      const current = labels[i]\n      const next = labels[i + 1]\n      \n      result.push(current)\n      \n      if (next) {\n        // Add appropriate separator based on content\n        if (this.needsExplicitSeparator(current, next)) {\n          result.push('. ')\n        } else {\n          result.push(' ')\n        }\n      }\n    }\n    \n    return result.join('')\n  }\n  \n  /**\n   * Determine if two accessibility labels need explicit separation\n   */\n  private needsExplicitSeparator(current: string, next: string): boolean {\n    // Add separator if current doesn't end with punctuation and next is a new concept\n    const currentEndsWithPunctuation = /[.!?:;]$/.test(current.trim())\n    const nextStartsWithCapital = /^[A-Z]/.test(next.trim())\n    \n    return !currentEndsWithPunctuation && nextStartsWithCapital\n  }\n  \n  /**\n   * Extract accessibility text from a component segment\n   */\n  private extractAccessibilityText(segment: ComponentSegment): string {\n    const component = segment.component\n    const componentType = component.constructor.name\n    \n    // Handle different component types\n    switch (componentType) {\n      case 'EnhancedText':\n        return (component as any).content || (component as any).title || ''\n      \n      case 'EnhancedImage':\n        return (component as any).alt || (component as any).accessibilityLabel || 'Image'\n      \n      case 'EnhancedButton':\n        return (component as any).title || (component as any).accessibilityLabel || 'Button'\n      \n      case 'EnhancedLink':\n        return (component as any).title || (component as any).accessibilityLabel || 'Link'\n      \n      case 'ConcatenatedComponent':\n        return (component as unknown as ConcatenatedComponent).buildAccessibilityLabel()\n      \n      default:\n        return (component as any).accessibilityLabel || ''\n    }\n  }\n  \n  /**\n   * Merge metadata from two concatenation operations\n   */\n  private mergeMetadata(\n    metadata1: ConcatenationMetadata,\n    metadata2: ConcatenationMetadata,\n    totalSegments: number\n  ): ConcatenationMetadata {\n    return {\n      totalSegments,\n      accessibilityRole: this.mergeAccessibilityRoles(\n        metadata1.accessibilityRole, \n        metadata2.accessibilityRole\n      ),\n      semanticStructure: this.mergeSemanticStructures(\n        metadata1.semanticStructure, \n        metadata2.semanticStructure\n      )\n    }\n  }\n  \n  /**\n   * Merge accessibility roles from two components\n   */\n  private mergeAccessibilityRoles(\n    role1: 'text' | 'group' | 'composite',\n    role2: 'text' | 'group' | 'composite'\n  ): 'text' | 'group' | 'composite' {\n    // If both are text, keep text\n    if (role1 === 'text' && role2 === 'text') return 'text'\n    \n    // If either is composite, result is composite\n    if (role1 === 'composite' || role2 === 'composite') return 'composite'\n    \n    // Otherwise, it's a group\n    return 'group'\n  }\n  \n  /**\n   * Merge semantic structures from two components\n   */\n  private mergeSemanticStructures(\n    structure1: 'inline' | 'block' | 'mixed',\n    structure2: 'inline' | 'block' | 'mixed'\n  ): 'inline' | 'block' | 'mixed' {\n    // If both are inline, keep inline\n    if (structure1 === 'inline' && structure2 === 'inline') return 'inline'\n    \n    // If both are block, keep block\n    if (structure1 === 'block' && structure2 === 'block') return 'block'\n    \n    // Otherwise, it's mixed\n    return 'mixed'\n  }\n  \n  /**\n   * Determine accessibility role for a single component\n   */\n  private determineComponentAccessibilityRole(component: Concatenatable): 'text' | 'group' | 'composite' {\n    const componentType = (component as any).constructor.name\n    \n    switch (componentType) {\n      case 'EnhancedText':\n        return 'text'\n      case 'EnhancedImage':\n        return 'group'\n      case 'EnhancedButton':\n      case 'EnhancedLink':\n        return 'group'\n      default:\n        return 'composite'\n    }\n  }\n  \n  /**\n   * Determine semantic structure for a single component\n   */\n  private determineComponentSemanticStructure(component: Concatenatable): 'inline' | 'block' | 'mixed' {\n    const componentType = (component as any).constructor.name\n    \n    switch (componentType) {\n      case 'EnhancedText':\n      case 'EnhancedImage':\n        return 'inline'\n      case 'EnhancedButton':\n      case 'EnhancedLink':\n        return 'inline' // Buttons and links are typically inline in concatenation\n      default:\n        return 'mixed'\n    }\n  }\n  \n  /**\n   * Generate comprehensive accessibility tree for this concatenated component\n   */\n  generateAccessibilityTree(): AccessibilityNode {\n    return {\n      role: this.metadata.accessibilityRole,\n      label: this.buildAccessibilityLabel(),\n      children: this.segments.map(segment => this.segmentToAccessibilityNode(segment))\n    }\n  }\n  \n  /**\n   * Convert a component segment to an accessibility node\n   */\n  private segmentToAccessibilityNode(segment: ComponentSegment): AccessibilityNode {\n    const component = segment.component\n    \n    return {\n      role: this.determineComponentAccessibilityRole(component as unknown as Concatenatable),\n      label: this.extractAccessibilityText(segment),\n      children: component instanceof ConcatenatedComponent \n        ? component.generateAccessibilityTree().children \n        : undefined\n    }\n  }\n}"],"names":["ConcatenatedComponent","segments","metadata","_enableOptimization","__publicField","containerClass","ariaLabel","accessibilityAttributes","segmentNodes","segment","h","attributes","componentTypes","componentType","types","other","newSegments","newMetadata","s","hasImages","type","hasText","hasButtons","hasLinks","cleanLabels","labels","result","i","current","next","currentEndsWithPunctuation","nextStartsWithCapital","component","metadata1","metadata2","totalSegments","role1","role2","structure1","structure2"],"mappings":"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"}

package/dist/concatenation/concatenated-component.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ConcatenatedComponent Implementation
+ *
+ * The main class that represents a concatenated component composed of multiple
+ * component segments. Handles rendering, accessibility, and further concatenation.
+ */
+import type { ComponentInstance, DOMNode } from '../runtime/types';
+import type { Concatenatable, ComponentSegment, ConcatenationMetadata, AccessibilityNode } from './types';
+/**
+ * A component that represents the concatenation of multiple components
+ */
+export declare class ConcatenatedComponent<T = any> implements ComponentInstance<any>, Concatenatable<T> {
+    metadata: ConcatenationMetadata;
+    readonly type: "component";
+    readonly id: string;
+    mounted: boolean;
+    cleanup: (() => void)[];
+    props: any;
+    segments: ComponentSegment[];
+    constructor(segments: ComponentSegment[], metadata: ConcatenationMetadata, _enableOptimization?: boolean);
+    /**
+     * Render the concatenated component to DOM nodes (Enhanced - Phase 4.2)
+     */
+    render(): DOMNode[];
+    /**
+     * Build comprehensive accessibility attributes
+     */
+    private buildAccessibilityAttributes;
+    /**
+     * Generate description for grouped content
+     */
+    private generateGroupDescription;
+    /**
+     * Generate flow targets for reading order
+     */
+    private generateFlowTargets;
+    /**
+     * Check if concatenated content contains interactive elements
+     */
+    private hasInteractiveContent;
+    /**
+     * Get unique component types in this concatenation
+     */
+    private getUniqueComponentTypes;
+    /**
+     * Concatenate this component with another concatenatable component
+     */
+    concat<U extends Concatenatable<any>>(other: U): ConcatenatedComponent<T | U>;
+    /**
+     * Convert this concatenated component to a segment (for further concatenation)
+     */
+    toSegment(): ComponentSegment;
+    /**
+     * Check if this component supports concatenation
+     */
+    isConcatenatable(): boolean;
+    /**
+     * Determine the appropriate CSS class for the container
+     */
+    private determineContainerClass;
+    /**
+     * Build comprehensive accessibility label for screen readers (Enhanced - Phase 4.2)
+     */
+    private buildAccessibilityLabel;
+    /**
+     * Intelligently join accessibility labels based on content and structure
+     */
+    private joinAccessibilityLabels;
+    /**
+     * Context-aware label joining for mixed content
+     */
+    private smartJoinLabels;
+    /**
+     * Determine if two accessibility labels need explicit separation
+     */
+    private needsExplicitSeparator;
+    /**
+     * Extract accessibility text from a component segment
+     */
+    private extractAccessibilityText;
+    /**
+     * Merge metadata from two concatenation operations
+     */
+    private mergeMetadata;
+    /**
+     * Merge accessibility roles from two components
+     */
+    private mergeAccessibilityRoles;
+    /**
+     * Merge semantic structures from two components
+     */
+    private mergeSemanticStructures;
+    /**
+     * Determine accessibility role for a single component
+     */
+    private determineComponentAccessibilityRole;
+    /**
+     * Determine semantic structure for a single component
+     */
+    private determineComponentSemanticStructure;
+    /**
+     * Generate comprehensive accessibility tree for this concatenated component
+     */
+    generateAccessibilityTree(): AccessibilityNode;
+    /**
+     * Convert a component segment to an accessibility node
+     */
+    private segmentToAccessibilityNode;
+}
+//# sourceMappingURL=concatenated-component.d.ts.map

package/dist/concatenation/concatenated-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concatenated-component.d.ts","sourceRoot":"","sources":["../../src/concatenation/concatenated-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAGhB;;GAEG;AACH,qBAAa,qBAAqB,CAAC,CAAC,GAAG,GAAG,CACxC,YAAW,iBAAiB,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAW3C,QAAQ,EAAE,qBAAqB;IATxC,SAAgB,IAAI,EAAG,WAAW,CAAS;IAC3C,SAAgB,EAAE,EAAE,MAAM,CAAA;IACnB,OAAO,UAAQ;IACf,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAK;IAC5B,KAAK,EAAE,GAAG,CAAK;IACf,QAAQ,EAAE,gBAAgB,EAAE,CAAA;gBAGjC,QAAQ,EAAE,gBAAgB,EAAE,EACrB,QAAQ,EAAE,qBAAqB,EACtC,mBAAmB,GAAE,OAAc;IAsBrC;;OAEG;IACH,MAAM,IAAI,OAAO,EAAE;IA6BnB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoCpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC;IAyB7E;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAS7B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA0BhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,mCAAmC;IAgB3C;;OAEG;IACH,OAAO,CAAC,mCAAmC;IAe3C;;OAEG;IACH,yBAAyB,IAAI,iBAAiB;IAQ9C;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAWnC"}