@tachui/core 0.7.0-alpha1

package/dist/runtime/semantic-role-manager.js

@@ -0,0 +1,82 @@
+import { getElementOverrideConfig as p, SEMANTIC_TAG_ROLES as s } from "./element-override.js";
+import { DevelopmentWarnings as c } from "./development-warnings.js";
+var A = Object.defineProperty, u = (n, e, t) => e in n ? A(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t, f = (n, e, t) => u(n, e + "", t);
+const m = class a {
+  static getInstance() {
+    return a.instance || (a.instance = new a()), a.instance;
+  }
+  /**
+   * Apply semantic ARIA attributes to an element based on its tag
+   */
+  applySemanticAttributes(e, t, o) {
+    const i = p();
+    if (!i.autoApplySemanticRoles) return;
+    const r = s.get(t);
+    if (!(!r || !r.applyARIA)) {
+      if (o?.role) {
+        i.warnOnSemanticIssues && c.warnProblematicCombination(
+          "SemanticRole",
+          t,
+          `ARIA role '${o.role}' overrides semantic role '${r.role}'`,
+          "info"
+        );
+        return;
+      }
+      if (e.hasAttribute("role")) {
+        i.warnOnSemanticIssues && c.warnProblematicCombination(
+          "SemanticRole",
+          t,
+          `Existing role attribute overrides semantic role '${r.role}'`,
+          "info"
+        );
+        return;
+      }
+      e.setAttribute("role", r.role), i.warnOnSemanticIssues && c.infoSemanticRole(t, r.role);
+    }
+  }
+  /**
+   * Get semantic role information for a tag
+   */
+  getSemanticRole(e) {
+    return s.get(e);
+  }
+  /**
+   * Check if a tag has automatic ARIA role application enabled
+   */
+  hasAutoARIA(e) {
+    const t = s.get(e);
+    return t ? t.applyARIA : !1;
+  }
+  /**
+   * Get all tags that support automatic ARIA roles
+   */
+  getAutoARIATags() {
+    return Array.from(s.entries()).filter(([, e]) => e.applyARIA).map(([e]) => e);
+  }
+  /**
+   * Apply semantic attributes during DOM node creation
+   * This is called by the renderer when creating elements
+   */
+  processElementNode(e, t, o, i) {
+    if (this.applySemanticAttributes(e, t, i), o && process.env.NODE_ENV !== "production") {
+      const r = this.getSemanticRole(t);
+      r && e.setAttribute("data-tachui-semantic", JSON.stringify({
+        originalComponent: o.originalType,
+        overriddenTo: t,
+        semanticRole: r.role,
+        autoApplied: r.applyARIA
+      }));
+    }
+  }
+};
+f(m, "instance");
+let R = m;
+const l = R.getInstance(), I = (n, e, t) => l.applySemanticAttributes(n, e, t), b = (n) => l.getSemanticRole(n), d = (n) => l.hasAutoARIA(n);
+export {
+  R as SemanticRoleManager,
+  I as applySemanticAttributes,
+  b as getSemanticRole,
+  d as hasAutoARIA,
+  l as semanticRoleManager
+};
+//# sourceMappingURL=semantic-role-manager.js.map

package/dist/runtime/semantic-role-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-role-manager.js","sources":["../../src/runtime/semantic-role-manager.ts"],"sourcesContent":["/**\n * Semantic Role Manager - Automatic ARIA Role Application\n * \n * Manages automatic application of ARIA roles for semantic HTML tags\n * while respecting explicit developer choices and context sensitivity.\n */\n\nimport { \n  SEMANTIC_TAG_ROLES, \n  getElementOverrideConfig,\n  type SemanticRoleInfo\n} from './element-override'\nimport { DevelopmentWarnings } from './development-warnings'\n\nexport class SemanticRoleManager {\n  private static instance: SemanticRoleManager\n\n  static getInstance(): SemanticRoleManager {\n    if (!SemanticRoleManager.instance) {\n      SemanticRoleManager.instance = new SemanticRoleManager()\n    }\n    return SemanticRoleManager.instance\n  }\n\n  /**\n   * Apply semantic ARIA attributes to an element based on its tag\n   */\n  applySemanticAttributes(\n    element: HTMLElement, \n    tag: string, \n    existingAria?: Record<string, string>\n  ): void {\n    const config = getElementOverrideConfig()\n    \n    // Global config: can disable all automatic ARIA role application\n    if (!config.autoApplySemanticRoles) return\n\n    const semanticInfo = SEMANTIC_TAG_ROLES.get(tag)\n    \n    // Per-tag config: only apply if applyARIA is true for this specific tag\n    if (!semanticInfo || !semanticInfo.applyARIA) return\n\n    // Always respect explicit ARIA attributes from .aria() modifier\n    if (existingAria?.role) {\n      if (config.warnOnSemanticIssues) {\n        DevelopmentWarnings.warnProblematicCombination(\n          'SemanticRole', \n          tag, \n          `ARIA role '${existingAria.role}' overrides semantic role '${semanticInfo.role}'`, \n          'info'\n        )\n      }\n      return\n    }\n\n    // Don't override existing role attribute\n    if (element.hasAttribute('role')) {\n      if (config.warnOnSemanticIssues) {\n        DevelopmentWarnings.warnProblematicCombination(\n          'SemanticRole', \n          tag, \n          `Existing role attribute overrides semantic role '${semanticInfo.role}'`, \n          'info'\n        )\n      }\n      return\n    }\n\n    // Safe to auto-apply the semantic role\n    element.setAttribute('role', semanticInfo.role)\n    \n    if (config.warnOnSemanticIssues) {\n      DevelopmentWarnings.infoSemanticRole(tag, semanticInfo.role)\n    }\n  }\n\n  /**\n   * Get semantic role information for a tag\n   */\n  getSemanticRole(tag: string): SemanticRoleInfo | undefined {\n    return SEMANTIC_TAG_ROLES.get(tag)\n  }\n\n  /**\n   * Check if a tag has automatic ARIA role application enabled\n   */\n  hasAutoARIA(tag: string): boolean {\n    const semanticInfo = SEMANTIC_TAG_ROLES.get(tag)\n    return semanticInfo ? semanticInfo.applyARIA : false\n  }\n\n  /**\n   * Get all tags that support automatic ARIA roles\n   */\n  getAutoARIATags(): string[] {\n    return Array.from(SEMANTIC_TAG_ROLES.entries())\n      .filter(([, info]) => info.applyARIA)\n      .map(([tag]) => tag)\n  }\n\n  /**\n   * Apply semantic attributes during DOM node creation\n   * This is called by the renderer when creating elements\n   */\n  processElementNode(\n    element: HTMLElement,\n    tag: string,\n    componentMetadata?: any,\n    existingAria?: Record<string, string>\n  ): void {\n    // Apply semantic roles\n    this.applySemanticAttributes(element, tag, existingAria)\n\n    // Store metadata for debugging\n    if (componentMetadata && process.env.NODE_ENV !== 'production') {\n      const semanticInfo = this.getSemanticRole(tag)\n      if (semanticInfo) {\n        element.setAttribute('data-tachui-semantic', JSON.stringify({\n          originalComponent: componentMetadata.originalType,\n          overriddenTo: tag,\n          semanticRole: semanticInfo.role,\n          autoApplied: semanticInfo.applyARIA\n        }))\n      }\n    }\n  }\n}\n\n// Global instance\nexport const semanticRoleManager = SemanticRoleManager.getInstance()\n\n// Convenience functions\nexport const applySemanticAttributes = (\n  element: HTMLElement, \n  tag: string, \n  existingAria?: Record<string, string>\n) => semanticRoleManager.applySemanticAttributes(element, tag, existingAria)\n\nexport const getSemanticRole = (tag: string) => semanticRoleManager.getSemanticRole(tag)\nexport const hasAutoARIA = (tag: string) => semanticRoleManager.hasAutoARIA(tag)"],"names":["_SemanticRoleManager","element","tag","existingAria","config","getElementOverrideConfig","semanticInfo","SEMANTIC_TAG_ROLES","DevelopmentWarnings","info","componentMetadata","__publicField","SemanticRoleManager","semanticRoleManager","applySemanticAttributes","getSemanticRole","hasAutoARIA"],"mappings":";;;AAcO,MAAMA,IAAN,MAAMA,EAAoB;AAAA,EAG/B,OAAO,cAAmC;AACxC,WAAKA,EAAoB,aACvBA,EAAoB,WAAW,IAAIA,EAAA,IAE9BA,EAAoB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,wBACEC,GACAC,GACAC,GACM;AACN,UAAMC,IAASC,EAAA;AAGf,QAAI,CAACD,EAAO,uBAAwB;AAEpC,UAAME,IAAeC,EAAmB,IAAIL,CAAG;AAG/C,QAAI,GAACI,KAAgB,CAACA,EAAa,YAGnC;AAAA,UAAIH,GAAc,MAAM;AACtB,QAAIC,EAAO,wBACTI,EAAoB;AAAA,UAClB;AAAA,UACAN;AAAA,UACA,cAAcC,EAAa,IAAI,8BAA8BG,EAAa,IAAI;AAAA,UAC9E;AAAA,QAAA;AAGJ;AAAA,MACF;AAGA,UAAIL,EAAQ,aAAa,MAAM,GAAG;AAChC,QAAIG,EAAO,wBACTI,EAAoB;AAAA,UAClB;AAAA,UACAN;AAAA,UACA,oDAAoDI,EAAa,IAAI;AAAA,UACrE;AAAA,QAAA;AAGJ;AAAA,MACF;AAGA,MAAAL,EAAQ,aAAa,QAAQK,EAAa,IAAI,GAE1CF,EAAO,wBACTI,EAAoB,iBAAiBN,GAAKI,EAAa,IAAI;AAAA;AAAA,EAE/D;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgBJ,GAA2C;AACzD,WAAOK,EAAmB,IAAIL,CAAG;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,YAAYA,GAAsB;AAChC,UAAMI,IAAeC,EAAmB,IAAIL,CAAG;AAC/C,WAAOI,IAAeA,EAAa,YAAY;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA,EAKA,kBAA4B;AAC1B,WAAO,MAAM,KAAKC,EAAmB,QAAA,CAAS,EAC3C,OAAO,CAAC,CAAA,EAAGE,CAAI,MAAMA,EAAK,SAAS,EACnC,IAAI,CAAC,CAACP,CAAG,MAAMA,CAAG;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,mBACED,GACAC,GACAQ,GACAP,GACM;AAKN,QAHA,KAAK,wBAAwBF,GAASC,GAAKC,CAAY,GAGnDO,KAAqB,QAAQ,IAAI,aAAa,cAAc;AAC9D,YAAMJ,IAAe,KAAK,gBAAgBJ,CAAG;AAC7C,MAAII,KACFL,EAAQ,aAAa,wBAAwB,KAAK,UAAU;AAAA,QAC1D,mBAAmBS,EAAkB;AAAA,QACrC,cAAcR;AAAA,QACd,cAAcI,EAAa;AAAA,QAC3B,aAAaA,EAAa;AAAA,MAAA,CAC3B,CAAC;AAAA,IAEN;AAAA,EACF;AACF;AA/GEK,EADWX,GACI,UAAA;AADV,IAAMY,IAANZ;AAmHA,MAAMa,IAAsBD,EAAoB,YAAA,GAG1CE,IAA0B,CACrCb,GACAC,GACAC,MACGU,EAAoB,wBAAwBZ,GAASC,GAAKC,CAAY,GAE9DY,IAAkB,CAACb,MAAgBW,EAAoB,gBAAgBX,CAAG,GAC1Ec,IAAc,CAACd,MAAgBW,EAAoB,YAAYX,CAAG;"}

package/dist/runtime/types.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Runtime System Type Definitions
+ *
+ * Core types for the TachUI runtime system including component
+ * lifecycle, DOM manipulation, and performance monitoring.
+ */
+/**
+ * Core component definition
+ */
+export interface Component<P = {}> {
+    (props: P): ComponentInstance;
+    displayName?: string;
+    defaultProps?: Partial<P>;
+}
+/**
+ * Component props with children support
+ */
+export interface ComponentProps {
+    children?: ComponentChildren;
+    key?: string | number;
+    ref?: ComponentRef;
+    debugLabel?: string;
+    [key: string]: any;
+}
+/**
+ * Strict component props for type safety
+ */
+export interface StrictComponentProps {
+    children?: ComponentChildren;
+    key?: string | number;
+    ref?: ComponentRef;
+}
+/**
+ * Props validation function
+ */
+export type PropsValidator<P> = (props: P) => boolean | string;
+/**
+ * Props with validation
+ */
+export interface ValidatedProps<P extends ComponentProps> {
+    validator?: PropsValidator<P>;
+    required?: (keyof P)[];
+    defaults?: Partial<P> | undefined;
+}
+/**
+ * Supported children types
+ */
+export type ComponentChildren = string | number | boolean | ComponentInstance | ComponentChildren[] | RenderFunction | null | undefined;
+/**
+ * Children render function
+ */
+export type ChildrenRenderer = (children: ComponentChildren) => DOMNode[];
+/**
+ * Fragment component for multiple children
+ */
+export interface Fragment {
+    children: ComponentChildren[];
+}
+/**
+ * Component instance returned by component functions
+ */
+export interface ComponentInstance<P extends ComponentProps = ComponentProps> {
+    type: 'component';
+    render: RenderFunction;
+    props: P;
+    prevProps?: P;
+    children?: ComponentChildren;
+    context?: ComponentContext;
+    cleanup?: LifecycleCleanup[];
+    id: string;
+    ref?: Ref | undefined;
+    mounted?: boolean;
+    domElements?: Map<string, Element>;
+    primaryElement?: Element;
+    domReady?: boolean;
+}
+/**
+ * Render function that creates DOM nodes
+ */
+export type RenderFunction = () => DOMNode | DOMNode[];
+/**
+ * DOM node representation
+ */
+export interface DOMNode {
+    type: 'element' | 'text' | 'comment';
+    tag?: string;
+    props?: Record<string, any>;
+    children?: DOMNode[];
+    text?: string;
+    element?: Element | Text | Comment | undefined;
+    dispose?: (() => void) | undefined;
+}
+/**
+ * Component context for dependency injection
+ */
+export interface ComponentContext {
+    id: string;
+    parent?: ComponentContext;
+    providers: Map<symbol, any>;
+    consumers: Set<symbol>;
+    cleanup: Set<() => void>;
+    setState(propertyName: string, value: any): void;
+    getState(propertyName: string): any;
+    hasState(propertyName: string): boolean;
+    setBinding(propertyName: string, binding: any): void;
+    getBinding(propertyName: string): any;
+    provide<T>(symbol: symbol, value: T): void;
+    consume<T>(symbol: symbol): T | undefined;
+    onCleanup(fn: () => void): void;
+    dispose(): void;
+}
+/**
+ * Component lifecycle hooks
+ */
+export interface LifecycleHooks<P extends ComponentProps = ComponentProps> {
+    onMount?: () => undefined | (() => void);
+    onUpdate?: (prevProps: P, nextProps: P) => void;
+    onPropsChange?: (prevProps: P, nextProps: P, changedKeys: (keyof P)[]) => void;
+    onChildrenChange?: (prevChildren: ComponentChildren, nextChildren: ComponentChildren) => void;
+    onUnmount?: () => void;
+    onError?: (error: Error) => void;
+    shouldUpdate?: (prevProps: P, nextProps: P) => boolean;
+    onRender?: () => void;
+    onDOMReady?: (elements: Map<string, Element>, primary?: Element) => void | (() => void);
+    onDOMError?: (error: DOMError, context: string) => void;
+}
+/**
+ * DOM Error type for enhanced error handling
+ */
+export interface DOMError extends Error {
+    code?: string;
+    element?: Element;
+    context?: string;
+}
+/**
+ * Cleanup function type
+ */
+export type LifecycleCleanup = () => void;
+/**
+ * Component reference
+ */
+export interface ComponentRef<T = any> {
+    current: T | null;
+}
+/**
+ * Ref callback function
+ */
+export type RefCallback<T = any> = (ref: T | null) => void;
+/**
+ * Ref types union
+ */
+export type Ref<T = any> = ComponentRef<T> | RefCallback<T> | null;
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    componentId: string;
+    mountTime: number;
+    renderTime: number;
+    updateCount: number;
+    lastUpdate: number;
+    memoryUsage: number;
+}
+/**
+ * Context provider value
+ */
+export interface ContextProvider<T> {
+    symbol: symbol;
+    value: T;
+    subscribers: Set<ComponentContext>;
+}
+/**
+ * Dependency injection service registration
+ */
+export interface ServiceRegistration<T = any> {
+    key: symbol | string;
+    implementation: T | (() => T);
+    singleton?: boolean;
+    scoped?: boolean;
+    dependencies?: (symbol | string)[];
+}
+/**
+ * DI container interface
+ */
+export interface IDIContainer {
+    register<T>(key: symbol | string, implementation: T | (() => T), options?: {
+        singleton?: boolean;
+        scoped?: boolean;
+        dependencies?: (symbol | string)[];
+    }): void;
+    resolve<T>(key: symbol | string): T;
+    has(key: symbol | string): boolean;
+    clear(): void;
+}
+/**
+ * Context subscription info
+ */
+export interface ContextSubscription {
+    contextSymbol: symbol;
+    componentId: string;
+    unsubscribe: () => void;
+}
+/**
+ * Mount options
+ */
+export interface MountOptions {
+    container: Element;
+    hydrate?: boolean;
+    onError?: (error: Error) => void;
+    enablePerformanceTracking?: boolean;
+}
+/**
+ * Update options
+ */
+export interface UpdateOptions {
+    force?: boolean;
+    suppressEffects?: boolean;
+}
+/**
+ * Component tree node for development tools
+ */
+export interface ComponentTreeNode {
+    id: string;
+    name: string;
+    props: ComponentProps;
+    children: ComponentTreeNode[];
+    metrics: PerformanceMetrics;
+    context: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

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

package/dist/state/binding.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("../runtime/component-context.cjs");var g=Object.defineProperty,m=(e,t,n)=>t in e?g(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,c=(e,t,n)=>m(e,typeof t!="symbol"?t+"":t,n);class r{constructor(t,n,s,o,i={}){c(this,"_get"),c(this,"_set"),c(this,"_options"),c(this,"_componentContext"),c(this,"_propertyName"),this._get=t,this._set=n,this._componentContext=s,this._propertyName=o,this._options=i,s.setBinding(o,this)}get wrappedValue(){return this._get()}set wrappedValue(t){this._set(t),this._componentContext.setState(`_binding_${this._propertyName}_trigger`,Date.now())}get projectedValue(){return this}get(){return this._get()}set(t){this._set(t),this._componentContext.setState(`_binding_${this._propertyName}_trigger`,Date.now())}map(t,n){const s=()=>t(this._get()),o=i=>{const a=this._get(),p=t(a),d=typeof i=="function"?i(p):i,h=n(d,a);this._set(h),this._componentContext.setState(`_binding_${this._propertyName}_mapped_trigger`,Date.now())};return new r(s,o,this._componentContext,`${this._propertyName}_mapped`,{name:`${this._options.name||"binding"}_mapped`})}constant(){const t=()=>(console.warn("Attempted to set value on constant binding"),this._get());return new r(this._get,t,this._componentContext,`${this._propertyName}_constant`,{name:`${this._options.name||"binding"}_constant`})}withValidation(t,n){const s=o=>{const i=typeof o=="function"?o(this._get()):o;return t(i)?(this._set(i),this._componentContext.setState(`_binding_${this._propertyName}_validated_trigger`,Date.now())):console.warn(n||`Validation failed for binding ${this._propertyName}`),i};return new r(this._get,s,this._componentContext,`${this._propertyName}_validated`,{name:`${this._options.name||"binding"}_validated`})}debounced(t=300){let n=null;const s=o=>{const i=typeof o=="function"?o(this._get()):o;return n&&clearTimeout(n),n=setTimeout(()=>{this._set(i),this._componentContext.setState(`_binding_${this._propertyName}_debounced_trigger`,Date.now()),n=null},t),i};return new r(this._get,s,this._componentContext,`${this._propertyName}_debounced`,{name:`${this._options.name||"binding"}_debounced`})}}function _(e,t,n={}){const s=u.getCurrentComponentContext(),o=l()||"binding";return new r(e,t,s,o,n)}function l(){try{const e=new Error().stack;if(e)return e.match(/at (\w+)\./)?.[1]||null}catch{}return null}function f(e){return e&&typeof e=="object"&&"get"in e&&"set"in e&&"wrappedValue"in e&&e instanceof r}const w={isReadOnly(e){if(e instanceof r)try{const t=e.get(),n=console.warn;let s=!1;return console.warn=(...o)=>{o[0]==="Attempted to set value on constant binding"&&(s=!0)},e.set(t),console.warn=n,s}catch{return!0}return!1},computed(e,t,n={}){const s=()=>{const i=e.map(a=>a.get());return t(...i)};return _(s,()=>(console.warn("Cannot set computed binding value"),s()),n)},chain(e,t={}){const n=()=>e.map(o=>o.get());return _(n,o=>{const i=typeof o=="function"?o(n()):o;return e.forEach((a,p)=>{p<i.length&&a.set(i[p])}),i},t)}};exports.BindingImpl=r;exports.BindingUtils=w;exports.createBinding=_;exports.isBinding=f;
+//# sourceMappingURL=binding.cjs.map

package/dist/state/binding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.cjs","sources":["../../src/state/binding.ts"],"sourcesContent":["/**\n * @Binding Property Wrapper Implementation\n *\n * Implements SwiftUI's @Binding property wrapper for two-way data binding.\n * Provides reactive binding with automatic component re-rendering on changes.\n */\n\nimport type { Accessor, Setter } from '../reactive/types'\nimport { getCurrentComponentContext } from '../runtime/component-context'\nimport type { ComponentContext } from '../runtime/types'\nimport type * as Types from './types'\nimport type { Binding } from './types'\n\n/**\n * Enhanced binding implementation with proper reactive updates\n */\nexport class BindingImpl<T> implements Binding<T> {\n  private _get: Accessor<T>\n  private _set: Setter<T>\n  private _options: { name?: string }\n  private _componentContext: ComponentContext\n  private _propertyName: string\n\n  constructor(\n    get: Accessor<T>,\n    set: Setter<T>,\n    componentContext: ComponentContext,\n    propertyName: string,\n    options: { name?: string } = {}\n  ) {\n    this._get = get\n    this._set = set\n    this._componentContext = componentContext\n    this._propertyName = propertyName\n    this._options = options\n\n    // Store binding in component context for lifecycle management\n    componentContext.setBinding(propertyName, this)\n  }\n\n  get wrappedValue(): T {\n    return this._get()\n  }\n\n  set wrappedValue(value: T) {\n    this._set(value)\n    // Trigger component re-render by updating component context\n    this._componentContext.setState(`_binding_${this._propertyName}_trigger`, Date.now())\n  }\n\n  get projectedValue(): Binding<T> {\n    return this\n  }\n\n  get(): T {\n    return this._get()\n  }\n\n  set(value: T | ((prev: T) => T)): void {\n    this._set(value as any)\n    // Trigger component re-render\n    this._componentContext.setState(`_binding_${this._propertyName}_trigger`, Date.now())\n  }\n\n  /**\n   * Create a derived binding with transformation\n   */\n  map<U>(getter: (value: T) => U, setter: (newValue: U, oldValue: T) => T): Binding<U> {\n    const mappedGet = () => getter(this._get())\n    const mappedSet = (value: U | ((prev: U) => U)) => {\n      const currentValue = this._get()\n      const currentMapped = getter(currentValue)\n      const newMapped =\n        typeof value === 'function' ? (value as (prev: U) => U)(currentMapped) : value\n      const newOriginal = setter(newMapped, currentValue)\n      this._set(newOriginal as any)\n      // Trigger re-render\n      this._componentContext.setState(`_binding_${this._propertyName}_mapped_trigger`, Date.now())\n    }\n\n    return new BindingImpl(\n      mappedGet as Accessor<U>,\n      mappedSet as Setter<U>,\n      this._componentContext,\n      `${this._propertyName}_mapped`,\n      { name: `${this._options.name || 'binding'}_mapped` }\n    )\n  }\n\n  /**\n   * Create a constant binding (read-only)\n   */\n  constant(): Binding<T> {\n    const readOnlySet: Setter<T> = () => {\n      console.warn('Attempted to set value on constant binding')\n      return this._get()\n    }\n\n    return new BindingImpl(\n      this._get,\n      readOnlySet,\n      this._componentContext,\n      `${this._propertyName}_constant`,\n      { name: `${this._options.name || 'binding'}_constant` }\n    )\n  }\n\n  /**\n   * Create a binding with validation\n   */\n  withValidation(validator: (value: T) => boolean, errorMessage?: string): Binding<T> {\n    const validatingSet: Setter<T> = (value: T | ((prev: T) => T)) => {\n      const newValue = typeof value === 'function' ? (value as (prev: T) => T)(this._get()) : value\n\n      if (validator(newValue)) {\n        this._set(newValue as any)\n        // Trigger re-render\n        this._componentContext.setState(\n          `_binding_${this._propertyName}_validated_trigger`,\n          Date.now()\n        )\n      } else {\n        console.warn(errorMessage || `Validation failed for binding ${this._propertyName}`)\n      }\n\n      return newValue\n    }\n\n    return new BindingImpl(\n      this._get,\n      validatingSet,\n      this._componentContext,\n      `${this._propertyName}_validated`,\n      { name: `${this._options.name || 'binding'}_validated` }\n    )\n  }\n\n  /**\n   * Create a debounced binding\n   */\n  debounced(delay: number = 300): Binding<T> {\n    let timeoutId: ReturnType<typeof setTimeout> | null = null\n\n    const debouncedSet: Setter<T> = (value: T | ((prev: T) => T)) => {\n      const newValue = typeof value === 'function' ? (value as (prev: T) => T)(this._get()) : value\n\n      if (timeoutId) {\n        clearTimeout(timeoutId)\n      }\n\n      timeoutId = setTimeout(() => {\n        this._set(newValue as any)\n        // Trigger re-render\n        this._componentContext.setState(\n          `_binding_${this._propertyName}_debounced_trigger`,\n          Date.now()\n        )\n        timeoutId = null\n      }, delay)\n\n      return newValue\n    }\n\n    return new BindingImpl(\n      this._get,\n      debouncedSet,\n      this._componentContext,\n      `${this._propertyName}_debounced`,\n      { name: `${this._options.name || 'binding'}_debounced` }\n    )\n  }\n}\n\n/**\n * Create a binding from external getter/setter functions\n */\nexport function createBinding<T>(\n  get: Accessor<T>,\n  set: Setter<T>,\n  options: { name?: string } = {}\n): Binding<T> {\n  const componentContext = getCurrentComponentContext()\n  const propertyName = getCallerPropertyName() || 'binding'\n\n  return new BindingImpl(get, set, componentContext, propertyName, options)\n}\n\n/**\n * Create a binding from a State property wrapper\n */\nexport function createStateBinding<T>(\n  state: Types.State<T>,\n  options: { name?: string } = {}\n): Binding<T> {\n  // Cast to implementation type to access internal methods\n  const stateImpl = state as any\n\n  const setter: Setter<T> = (value: T | ((prev: T) => T)) => {\n    if (typeof value === 'function') {\n      state.wrappedValue = (value as (prev: T) => T)(state.wrappedValue)\n    } else {\n      state.wrappedValue = value\n    }\n    return state.wrappedValue\n  }\n\n  return createBinding(() => state.wrappedValue, setter, {\n    ...options,\n    name: options.name || `${stateImpl.metadata?.propertyName || 'state'}Binding`,\n  })\n}\n\n/**\n * Create a binding to a specific property of an object\n */\nexport function createPropertyBinding<T, K extends keyof T>(\n  object: Accessor<T>,\n  setObject: Setter<T>,\n  property: K,\n  options: { name?: string } = {}\n): Binding<T[K]> {\n  const get = () => object()[property]\n  const set = (value: T[K] | ((prev: T[K]) => T[K])) => {\n    const currentObject = object()\n    const newValue =\n      typeof value === 'function' ? (value as (prev: T[K]) => T[K])(currentObject[property]) : value\n    const newObject = { ...currentObject, [property]: newValue }\n    setObject(newObject as any)\n  }\n\n  return createBinding(get, set as Setter<T[K]>, {\n    ...options,\n    name: options.name || `${String(property)}PropertyBinding`,\n  })\n}\n\n/**\n * Create a two-way binding between two state sources\n */\nexport function createTwoWayBinding<T>(\n  source1: Types.State<T>,\n  source2: Types.State<T>,\n  options: {\n    name?: string\n    transform?: (value: T) => T\n    reverseTransform?: (value: T) => T\n  } = {}\n): [Binding<T>, Binding<T>] {\n  const transform = options.transform || ((v: T) => v)\n  const reverseTransform = options.reverseTransform || options.transform || ((v: T) => v)\n\n  const binding1 = createBinding(\n    () => transform(source1.wrappedValue),\n    (value: T | ((prev: T) => T)) => {\n      const newValue =\n        typeof value === 'function' ? (value as (prev: T) => T)(source1.wrappedValue) : value\n      const transformedValue = reverseTransform(newValue)\n      source1.wrappedValue = transformedValue\n      source2.wrappedValue = transformedValue\n      return transformedValue\n    },\n    { name: `${options.name || 'twoWay'}Binding1` }\n  )\n\n  const binding2 = createBinding(\n    () => transform(source2.wrappedValue),\n    (value: T | ((prev: T) => T)) => {\n      const newValue =\n        typeof value === 'function' ? (value as (prev: T) => T)(source2.wrappedValue) : value\n      const transformedValue = reverseTransform(newValue)\n      source1.wrappedValue = transformedValue\n      source2.wrappedValue = transformedValue\n      return transformedValue\n    },\n    { name: `${options.name || 'twoWay'}Binding2` }\n  )\n\n  return [binding1, binding2]\n}\n\n/**\n * Helper to get the property name of the caller (used for metadata)\n */\nfunction getCallerPropertyName(): string | null {\n  try {\n    const stack = new Error().stack\n    if (stack) {\n      // Parse stack to get property name - this is a fallback for debugging\n      const match = stack.match(/at (\\w+)\\./)?.[1]\n      return match || null\n    }\n  } catch {\n    // Ignore errors in stack parsing\n  }\n  return null\n}\n\n/**\n * Type guard for Binding property wrappers\n */\nexport function isBinding<T>(value: any): value is Binding<T> {\n  return (\n    value &&\n    typeof value === 'object' &&\n    'get' in value &&\n    'set' in value &&\n    'wrappedValue' in value &&\n    value instanceof BindingImpl\n  )\n}\n\n/**\n * Utility functions for binding management\n */\nexport const BindingUtils = {\n  /**\n   * Check if a binding is read-only\n   */\n  isReadOnly<T>(binding: Binding<T>): boolean {\n    if (binding instanceof BindingImpl) {\n      // Check if it's a constant binding by testing the setter\n      try {\n        const originalValue = binding.get()\n        const consoleWarn = console.warn\n        let warningCalled = false\n        console.warn = (...args) => {\n          if (args[0] === 'Attempted to set value on constant binding') {\n            warningCalled = true\n          }\n        }\n\n        binding.set(originalValue)\n        console.warn = consoleWarn\n\n        return warningCalled\n      } catch {\n        return true\n      }\n    }\n    return false\n  },\n\n  /**\n   * Create a computed binding from multiple sources\n   */\n  computed<T, Args extends readonly any[]>(\n    sources: { [K in keyof Args]: Binding<Args[K]> },\n    compute: (...values: Args) => T,\n    options: { name?: string } = {}\n  ): Binding<T> {\n    const get = () => {\n      const values = sources.map((source) => source.get()) as any as Args\n      return compute(...values)\n    }\n\n    const set = () => {\n      console.warn('Cannot set computed binding value')\n      return get()\n    }\n\n    return createBinding(get, set, options)\n  },\n\n  /**\n   * Chain multiple bindings together\n   */\n  chain<T>(bindings: Binding<T>[], options: { name?: string } = {}): Binding<T[]> {\n    const get = () => bindings.map((binding) => binding.get())\n    const set = (values: T[] | ((prev: T[]) => T[])) => {\n      const newValues = typeof values === 'function' ? values(get()) : values\n      bindings.forEach((binding, index) => {\n        if (index < newValues.length) {\n          binding.set(newValues[index])\n        }\n      })\n      return newValues\n    }\n\n    return createBinding(get, set as Setter<T[]>, options)\n  },\n}\n"],"names":["BindingImpl","get","set","componentContext","propertyName","options","__publicField","value","getter","setter","mappedGet","mappedSet","currentValue","currentMapped","newMapped","newOriginal","readOnlySet","validator","errorMessage","validatingSet","newValue","delay","timeoutId","debouncedSet","createBinding","getCurrentComponentContext","getCallerPropertyName","stack","isBinding","BindingUtils","binding","originalValue","consoleWarn","warningCalled","args","sources","compute","values","source","bindings","newValues","index"],"mappings":"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"}

package/dist/state/binding.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @Binding Property Wrapper Implementation
+ *
+ * Implements SwiftUI's @Binding property wrapper for two-way data binding.
+ * Provides reactive binding with automatic component re-rendering on changes.
+ */
+import type { Accessor, Setter } from '../reactive/types';
+import type { ComponentContext } from '../runtime/types';
+import type * as Types from './types';
+import type { Binding } from './types';
+/**
+ * Enhanced binding implementation with proper reactive updates
+ */
+export declare class BindingImpl<T> implements Binding<T> {
+    private _get;
+    private _set;
+    private _options;
+    private _componentContext;
+    private _propertyName;
+    constructor(get: Accessor<T>, set: Setter<T>, componentContext: ComponentContext, propertyName: string, options?: {
+        name?: string;
+    });
+    get wrappedValue(): T;
+    set wrappedValue(value: T);
+    get projectedValue(): Binding<T>;
+    get(): T;
+    set(value: T | ((prev: T) => T)): void;
+    /**
+     * Create a derived binding with transformation
+     */
+    map<U>(getter: (value: T) => U, setter: (newValue: U, oldValue: T) => T): Binding<U>;
+    /**
+     * Create a constant binding (read-only)
+     */
+    constant(): Binding<T>;
+    /**
+     * Create a binding with validation
+     */
+    withValidation(validator: (value: T) => boolean, errorMessage?: string): Binding<T>;
+    /**
+     * Create a debounced binding
+     */
+    debounced(delay?: number): Binding<T>;
+}
+/**
+ * Create a binding from external getter/setter functions
+ */
+export declare function createBinding<T>(get: Accessor<T>, set: Setter<T>, options?: {
+    name?: string;
+}): Binding<T>;
+/**
+ * Create a binding from a State property wrapper
+ */
+export declare function createStateBinding<T>(state: Types.State<T>, options?: {
+    name?: string;
+}): Binding<T>;
+/**
+ * Create a binding to a specific property of an object
+ */
+export declare function createPropertyBinding<T, K extends keyof T>(object: Accessor<T>, setObject: Setter<T>, property: K, options?: {
+    name?: string;
+}): Binding<T[K]>;
+/**
+ * Create a two-way binding between two state sources
+ */
+export declare function createTwoWayBinding<T>(source1: Types.State<T>, source2: Types.State<T>, options?: {
+    name?: string;
+    transform?: (value: T) => T;
+    reverseTransform?: (value: T) => T;
+}): [Binding<T>, Binding<T>];
+/**
+ * Type guard for Binding property wrappers
+ */
+export declare function isBinding<T>(value: any): value is Binding<T>;
+/**
+ * Utility functions for binding management
+ */
+export declare const BindingUtils: {
+    /**
+     * Check if a binding is read-only
+     */
+    isReadOnly<T>(binding: Binding<T>): boolean;
+    /**
+     * Create a computed binding from multiple sources
+     */
+    computed<T, Args extends readonly any[]>(sources: { [K in keyof Args]: Binding<Args[K]>; }, compute: (...values: Args) => T, options?: {
+        name?: string;
+    }): Binding<T>;
+    /**
+     * Chain multiple bindings together
+     */
+    chain<T>(bindings: Binding<T>[], options?: {
+        name?: string;
+    }): Binding<T[]>;
+};
+//# sourceMappingURL=binding.d.ts.map

package/dist/state/binding.d.ts.map

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

package/dist/state/binding.js

@@ -0,0 +1,155 @@
+import { getCurrentComponentContext as u } from "../runtime/component-context.js";
+var m = Object.defineProperty, g = (e, t, n) => t in e ? m(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n, c = (e, t, n) => g(e, typeof t != "symbol" ? t + "" : t, n);
+class s {
+  constructor(t, n, r, o, i = {}) {
+    c(this, "_get"), c(this, "_set"), c(this, "_options"), c(this, "_componentContext"), c(this, "_propertyName"), this._get = t, this._set = n, this._componentContext = r, this._propertyName = o, this._options = i, r.setBinding(o, this);
+  }
+  get wrappedValue() {
+    return this._get();
+  }
+  set wrappedValue(t) {
+    this._set(t), this._componentContext.setState(`_binding_${this._propertyName}_trigger`, Date.now());
+  }
+  get projectedValue() {
+    return this;
+  }
+  get() {
+    return this._get();
+  }
+  set(t) {
+    this._set(t), this._componentContext.setState(`_binding_${this._propertyName}_trigger`, Date.now());
+  }
+  /**
+   * Create a derived binding with transformation
+   */
+  map(t, n) {
+    const r = () => t(this._get()), o = (i) => {
+      const a = this._get(), p = t(a), h = typeof i == "function" ? i(p) : i, d = n(h, a);
+      this._set(d), this._componentContext.setState(`_binding_${this._propertyName}_mapped_trigger`, Date.now());
+    };
+    return new s(
+      r,
+      o,
+      this._componentContext,
+      `${this._propertyName}_mapped`,
+      { name: `${this._options.name || "binding"}_mapped` }
+    );
+  }
+  /**
+   * Create a constant binding (read-only)
+   */
+  constant() {
+    const t = () => (console.warn("Attempted to set value on constant binding"), this._get());
+    return new s(
+      this._get,
+      t,
+      this._componentContext,
+      `${this._propertyName}_constant`,
+      { name: `${this._options.name || "binding"}_constant` }
+    );
+  }
+  /**
+   * Create a binding with validation
+   */
+  withValidation(t, n) {
+    const r = (o) => {
+      const i = typeof o == "function" ? o(this._get()) : o;
+      return t(i) ? (this._set(i), this._componentContext.setState(
+        `_binding_${this._propertyName}_validated_trigger`,
+        Date.now()
+      )) : console.warn(n || `Validation failed for binding ${this._propertyName}`), i;
+    };
+    return new s(
+      this._get,
+      r,
+      this._componentContext,
+      `${this._propertyName}_validated`,
+      { name: `${this._options.name || "binding"}_validated` }
+    );
+  }
+  /**
+   * Create a debounced binding
+   */
+  debounced(t = 300) {
+    let n = null;
+    const r = (o) => {
+      const i = typeof o == "function" ? o(this._get()) : o;
+      return n && clearTimeout(n), n = setTimeout(() => {
+        this._set(i), this._componentContext.setState(
+          `_binding_${this._propertyName}_debounced_trigger`,
+          Date.now()
+        ), n = null;
+      }, t), i;
+    };
+    return new s(
+      this._get,
+      r,
+      this._componentContext,
+      `${this._propertyName}_debounced`,
+      { name: `${this._options.name || "binding"}_debounced` }
+    );
+  }
+}
+function _(e, t, n = {}) {
+  const r = u(), o = l() || "binding";
+  return new s(e, t, r, o, n);
+}
+function l() {
+  try {
+    const e = new Error().stack;
+    if (e)
+      return e.match(/at (\w+)\./)?.[1] || null;
+  } catch {
+  }
+  return null;
+}
+function w(e) {
+  return e && typeof e == "object" && "get" in e && "set" in e && "wrappedValue" in e && e instanceof s;
+}
+const b = {
+  /**
+   * Check if a binding is read-only
+   */
+  isReadOnly(e) {
+    if (e instanceof s)
+      try {
+        const t = e.get(), n = console.warn;
+        let r = !1;
+        return console.warn = (...o) => {
+          o[0] === "Attempted to set value on constant binding" && (r = !0);
+        }, e.set(t), console.warn = n, r;
+      } catch {
+        return !0;
+      }
+    return !1;
+  },
+  /**
+   * Create a computed binding from multiple sources
+   */
+  computed(e, t, n = {}) {
+    const r = () => {
+      const i = e.map((a) => a.get());
+      return t(...i);
+    };
+    return _(r, () => (console.warn("Cannot set computed binding value"), r()), n);
+  },
+  /**
+   * Chain multiple bindings together
+   */
+  chain(e, t = {}) {
+    const n = () => e.map((o) => o.get());
+    return _(n, (o) => {
+      const i = typeof o == "function" ? o(n()) : o;
+      return e.forEach((a, p) => {
+        p < i.length && a.set(i[p]);
+      }), i;
+    }, t);
+  }
+};
+export {
+  s as BindingImpl,
+  b as BindingUtils,
+  _ as createBinding,
+  w as isBinding
+};
+//# sourceMappingURL=binding.js.map