@tachui/core 0.7.0-alpha1

package/dist/state/state-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * State Manager Implementation
+ *
+ * Manages the lifecycle of all property wrappers (@State, @Binding, @ObservedObject, @EnvironmentObject)
+ * within a component context. Handles registration, cleanup, and debugging utilities.
+ */
+import type { ComponentContext } from '../runtime/types';
+import type { Binding, BindingOptions, EnvironmentObject, EnvironmentObjectOptions, ObservableObject, ObservableObjectOptions, ObservedObject, PropertyWrapperRegistry, State, StateManager, StateWrapperOptions } from './types';
+/**
+ * Internal state manager implementation
+ */
+export declare class StateManagerImpl implements StateManager {
+    readonly componentContext: ComponentContext;
+    private states;
+    private bindings;
+    private observedObjects;
+    private environmentObjects;
+    private registry;
+    constructor(componentContext: ComponentContext);
+    /**
+     * Register a @State property wrapper
+     */
+    registerState<T>(state: State<T>, _options?: StateWrapperOptions): void;
+    /**
+     * Register a @Binding property wrapper
+     */
+    registerBinding<T>(binding: Binding<T>, options?: BindingOptions<T>): void;
+    /**
+     * Register an @ObservedObject property wrapper
+     */
+    registerObservedObject<T extends ObservableObject>(observedObject: ObservedObject<T>, _options?: ObservableObjectOptions): void;
+    /**
+     * Register an @EnvironmentObject property wrapper
+     */
+    registerEnvironmentObject<T>(environmentObject: EnvironmentObject<T>, _options: EnvironmentObjectOptions<T>): void;
+    /**
+     * Clean up all property wrappers for this component
+     */
+    cleanup(): void;
+    /**
+     * Get all registered states (for debugging)
+     */
+    getStates(): Map<string, State<any>>;
+    /**
+     * Get all registered bindings (for debugging)
+     */
+    getBindings(): Map<string, Binding<any>>;
+    /**
+     * Get all registered observed objects (for debugging)
+     */
+    getObservedObjects(): Map<string, ObservedObject<any>>;
+    /**
+     * Get all registered environment objects (for debugging)
+     */
+    getEnvironmentObjects(): Map<string, EnvironmentObject<any>>;
+    /**
+     * Get property wrapper registry
+     */
+    getRegistry(): PropertyWrapperRegistry;
+    /**
+     * Set up debugging for @State property wrappers
+     */
+    private setupStateDebugging;
+    /**
+     * Set up debugging for @ObservedObject property wrappers
+     */
+    private setupObservedObjectDebugging;
+}
+/**
+ * Create a state manager for a component
+ */
+export declare function createStateManager(componentContext: ComponentContext): StateManager;
+/**
+ * Register a state manager globally
+ */
+export declare function registerStateManager(componentId: string, manager: StateManager): void;
+/**
+ * Unregister a state manager globally
+ */
+export declare function unregisterStateManager(componentId: string): void;
+/**
+ * Get a state manager by component ID
+ */
+export declare function getStateManager(componentId: string): StateManager | undefined;
+/**
+ * Get all state managers (for debugging)
+ */
+export declare function getAllStateManagers(): Map<string, StateManager>;
+/**
+ * Get debugging information for all state managers
+ */
+export declare function getStateManagerDebugInfo(): any;
+/**
+ * Initialize global debugging utilities
+ */
+export declare function initializeStateDebugging(): void;
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/state/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/state/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EAEd,uBAAuB,EACvB,KAAK,EACL,YAAY,EACZ,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;aAOvB,gBAAgB,EAAE,gBAAgB;IAN9D,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,kBAAkB,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAyB;gBAEb,gBAAgB,EAAE,gBAAgB;IAI9D;;OAEG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAE,mBAAwB,GAAG,IAAI;IAc3E;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAAG,IAAI;IAa9E;;OAEG;IACH,sBAAsB,CAAC,CAAC,SAAS,gBAAgB,EAC/C,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,EACjC,QAAQ,GAAE,uBAA4B,GACrC,IAAI;IAcP;;OAEG;IACH,yBAAyB,CAAC,CAAC,EACzB,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACvC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACpC,IAAI;IASP;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAIpC;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAIxC;;OAEG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAItD;;OAEG;IACH,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAI5D;;OAEG;IACH,WAAW,IAAI,uBAAuB;IAItC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,4BAA4B;CAoBrC;AAsDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,CAEnF;AAoDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAErF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAE9C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAgB/C"}

package/dist/state/state-manager.js

@@ -0,0 +1,233 @@
+var d = Object.defineProperty, p = (s, e, n) => e in s ? d(s, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : s[e] = n, i = (s, e, n) => p(s, typeof e != "symbol" ? e + "" : e, n);
+class u {
+  constructor(e) {
+    this.componentContext = e, i(this, "states", /* @__PURE__ */ new Map()), i(this, "bindings", /* @__PURE__ */ new Map()), i(this, "observedObjects", /* @__PURE__ */ new Map()), i(this, "environmentObjects", /* @__PURE__ */ new Map()), i(this, "registry"), this.registry = new l();
+  }
+  /**
+   * Register a @State property wrapper
+   */
+  registerState(e, n = {}) {
+    const t = e.metadata;
+    if (t) {
+      const a = `${t.componentId}_${t.propertyName}`;
+      this.states.set(a, e), this.registry.register(t), process.env.NODE_ENV === "development" && this.setupStateDebugging(e, t);
+    }
+  }
+  /**
+   * Register a @Binding property wrapper
+   */
+  registerBinding(e, n = {}) {
+    const t = `${this.componentContext.id}_${n.name || "binding"}_${Date.now()}`;
+    this.bindings.set(t, e);
+    const a = {
+      type: "Binding",
+      propertyName: n.name || "binding",
+      componentId: this.componentContext.id,
+      options: n
+    };
+    this.registry.register(a);
+  }
+  /**
+   * Register an @ObservedObject property wrapper
+   */
+  registerObservedObject(e, n = {}) {
+    const t = e.metadata;
+    if (t) {
+      const a = `${t.componentId}_${t.propertyName}`;
+      this.observedObjects.set(a, e), this.registry.register(t), process.env.NODE_ENV === "development" && this.setupObservedObjectDebugging(e, t);
+    }
+  }
+  /**
+   * Register an @EnvironmentObject property wrapper
+   */
+  registerEnvironmentObject(e, n) {
+    const t = e.metadata;
+    if (t) {
+      const a = `${t.componentId}_${t.propertyName}`;
+      this.environmentObjects.set(a, e), this.registry.register(t);
+    }
+  }
+  /**
+   * Clean up all property wrappers for this component
+   */
+  cleanup() {
+    this.states.clear(), this.bindings.clear(), this.observedObjects.clear(), this.environmentObjects.clear(), this.registry.cleanup(this.componentContext.id);
+  }
+  /**
+   * Get all registered states (for debugging)
+   */
+  getStates() {
+    return new Map(this.states);
+  }
+  /**
+   * Get all registered bindings (for debugging)
+   */
+  getBindings() {
+    return new Map(this.bindings);
+  }
+  /**
+   * Get all registered observed objects (for debugging)
+   */
+  getObservedObjects() {
+    return new Map(this.observedObjects);
+  }
+  /**
+   * Get all registered environment objects (for debugging)
+   */
+  getEnvironmentObjects() {
+    return new Map(this.environmentObjects);
+  }
+  /**
+   * Get property wrapper registry
+   */
+  getRegistry() {
+    return this.registry;
+  }
+  /**
+   * Set up debugging for @State property wrappers
+   */
+  setupStateDebugging(e, n) {
+    if (typeof window < "u") {
+      const t = window.__TACHUI_DEBUG__ || {};
+      t.states || (t.states = {}), t.states[`${n.componentId}_${n.propertyName}`] = {
+        state: e,
+        metadata: n,
+        getValue: () => e.wrappedValue,
+        setValue: (a) => {
+          e.projectedValue.set(a);
+        },
+        getBinding: () => e.projectedValue
+      }, window.__TACHUI_DEBUG__ = t;
+    }
+  }
+  /**
+   * Set up debugging for @ObservedObject property wrappers
+   */
+  setupObservedObjectDebugging(e, n) {
+    if (typeof window < "u") {
+      const t = window.__TACHUI_DEBUG__ || {};
+      t.observedObjects || (t.observedObjects = {}), t.observedObjects[`${n.componentId}_${n.propertyName}`] = {
+        observedObject: e,
+        metadata: n,
+        getObject: () => e.wrappedValue,
+        getNotificationCount: () => e.wrappedValue.notificationCount || 0,
+        triggerChange: () => e.wrappedValue.notifyChange()
+      }, window.__TACHUI_DEBUG__ = t;
+    }
+  }
+}
+class l {
+  constructor() {
+    i(this, "metadata", /* @__PURE__ */ new Map());
+  }
+  /**
+   * Register property wrapper metadata
+   */
+  register(e) {
+    const n = e.componentId, t = this.metadata.get(n) || [];
+    t.push(e), this.metadata.set(n, t);
+  }
+  /**
+   * Unregister a specific property wrapper
+   */
+  unregister(e, n) {
+    const a = (this.metadata.get(e) || []).filter((c) => c.propertyName !== n);
+    a.length > 0 ? this.metadata.set(e, a) : this.metadata.delete(e);
+  }
+  /**
+   * Clean up all metadata for a component
+   */
+  cleanup(e) {
+    this.metadata.delete(e);
+  }
+  /**
+   * Get all metadata for a component
+   */
+  getMetadata(e) {
+    return this.metadata.get(e) || [];
+  }
+  /**
+   * Get all registered metadata (for debugging)
+   */
+  getAllMetadata() {
+    return new Map(this.metadata);
+  }
+}
+function h(s) {
+  return new u(s);
+}
+const o = class r {
+  constructor() {
+    i(this, "managers", /* @__PURE__ */ new Map());
+  }
+  static getInstance() {
+    return r.instance || (r.instance = new r()), r.instance;
+  }
+  register(e, n) {
+    this.managers.set(e, n);
+  }
+  unregister(e) {
+    this.managers.delete(e);
+  }
+  getManager(e) {
+    return this.managers.get(e);
+  }
+  getAllManagers() {
+    return new Map(this.managers);
+  }
+  /**
+   * Get debugging information for all components
+   */
+  getDebugInfo() {
+    const e = {};
+    for (const [n, t] of this.managers)
+      e[n] = {
+        states: t.getStates().size,
+        bindings: t.getBindings().size,
+        observedObjects: t.getObservedObjects().size,
+        environmentObjects: t.getEnvironmentObjects().size,
+        metadata: t.getRegistry().getMetadata(n)
+      };
+    return e;
+  }
+};
+i(o, "instance");
+let g = o;
+function f(s, e) {
+  g.getInstance().register(s, e);
+}
+function w(s) {
+  g.getInstance().unregister(s);
+}
+function b(s) {
+  return g.getInstance().getManager(s);
+}
+function m() {
+  return g.getInstance().getAllManagers();
+}
+function _() {
+  return g.getInstance().getDebugInfo();
+}
+function M() {
+  if (typeof window < "u" && process.env.NODE_ENV === "development") {
+    const s = window.__TACHUI_DEBUG__ || {};
+    s.stateManagers = {
+      getAll: m,
+      getDebugInfo: _,
+      getManager: b
+    }, window.__TACHUI_DEBUG__ = s, console.log(
+      "TachUI State Management debugging enabled. Use window.__TACHUI_DEBUG__.stateManagers"
+    );
+  }
+}
+export {
+  u as StateManagerImpl,
+  h as createStateManager,
+  m as getAllStateManagers,
+  b as getStateManager,
+  _ as getStateManagerDebugInfo,
+  M as initializeStateDebugging,
+  f as registerStateManager,
+  w as unregisterStateManager
+};
+//# sourceMappingURL=state-manager.js.map

package/dist/state/state-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.js","sources":["../../src/state/state-manager.ts"],"sourcesContent":["/**\n * State Manager Implementation\n *\n * Manages the lifecycle of all property wrappers (@State, @Binding, @ObservedObject, @EnvironmentObject)\n * within a component context. Handles registration, cleanup, and debugging utilities.\n */\n\nimport type { ComponentContext } from '../runtime/types'\nimport type {\n  Binding,\n  BindingOptions,\n  EnvironmentObject,\n  EnvironmentObjectOptions,\n  ObservableObject,\n  ObservableObjectOptions,\n  ObservedObject,\n  PropertyWrapperMetadata,\n  PropertyWrapperRegistry,\n  State,\n  StateManager,\n  StateWrapperOptions,\n} from './types'\n\n/**\n * Internal state manager implementation\n */\nexport class StateManagerImpl implements StateManager {\n  private states = new Map<string, State<any>>()\n  private bindings = new Map<string, Binding<any>>()\n  private observedObjects = new Map<string, ObservedObject<any>>()\n  private environmentObjects = new Map<string, EnvironmentObject<any>>()\n  private registry: PropertyWrapperRegistry\n\n  constructor(public readonly componentContext: ComponentContext) {\n    this.registry = new PropertyWrapperRegistryImpl()\n  }\n\n  /**\n   * Register a @State property wrapper\n   */\n  registerState<T>(state: State<T>, _options: StateWrapperOptions = {}): void {\n    const metadata = (state as any).metadata as PropertyWrapperMetadata\n    if (metadata) {\n      const key = `${metadata.componentId}_${metadata.propertyName}`\n      this.states.set(key, state)\n      this.registry.register(metadata)\n\n      // Set up debugging if in development mode\n      if (process.env.NODE_ENV === 'development') {\n        this.setupStateDebugging(state, metadata)\n      }\n    }\n  }\n\n  /**\n   * Register a @Binding property wrapper\n   */\n  registerBinding<T>(binding: Binding<T>, options: BindingOptions<T> = {}): void {\n    const key = `${this.componentContext.id}_${options.name || 'binding'}_${Date.now()}`\n    this.bindings.set(key, binding)\n\n    const metadata: PropertyWrapperMetadata = {\n      type: 'Binding',\n      propertyName: options.name || 'binding',\n      componentId: this.componentContext.id,\n      options,\n    }\n    this.registry.register(metadata)\n  }\n\n  /**\n   * Register an @ObservedObject property wrapper\n   */\n  registerObservedObject<T extends ObservableObject>(\n    observedObject: ObservedObject<T>,\n    _options: ObservableObjectOptions = {}\n  ): void {\n    const metadata = (observedObject as any).metadata as PropertyWrapperMetadata\n    if (metadata) {\n      const key = `${metadata.componentId}_${metadata.propertyName}`\n      this.observedObjects.set(key, observedObject)\n      this.registry.register(metadata)\n\n      // Set up debugging if in development mode\n      if (process.env.NODE_ENV === 'development') {\n        this.setupObservedObjectDebugging(observedObject, metadata)\n      }\n    }\n  }\n\n  /**\n   * Register an @EnvironmentObject property wrapper\n   */\n  registerEnvironmentObject<T>(\n    environmentObject: EnvironmentObject<T>,\n    _options: EnvironmentObjectOptions<T>\n  ): void {\n    const metadata = (environmentObject as any).metadata as PropertyWrapperMetadata\n    if (metadata) {\n      const key = `${metadata.componentId}_${metadata.propertyName}`\n      this.environmentObjects.set(key, environmentObject)\n      this.registry.register(metadata)\n    }\n  }\n\n  /**\n   * Clean up all property wrappers for this component\n   */\n  cleanup(): void {\n    // Clear all registered property wrappers\n    this.states.clear()\n    this.bindings.clear()\n    this.observedObjects.clear()\n    this.environmentObjects.clear()\n\n    // Clean up registry\n    this.registry.cleanup(this.componentContext.id)\n  }\n\n  /**\n   * Get all registered states (for debugging)\n   */\n  getStates(): Map<string, State<any>> {\n    return new Map(this.states)\n  }\n\n  /**\n   * Get all registered bindings (for debugging)\n   */\n  getBindings(): Map<string, Binding<any>> {\n    return new Map(this.bindings)\n  }\n\n  /**\n   * Get all registered observed objects (for debugging)\n   */\n  getObservedObjects(): Map<string, ObservedObject<any>> {\n    return new Map(this.observedObjects)\n  }\n\n  /**\n   * Get all registered environment objects (for debugging)\n   */\n  getEnvironmentObjects(): Map<string, EnvironmentObject<any>> {\n    return new Map(this.environmentObjects)\n  }\n\n  /**\n   * Get property wrapper registry\n   */\n  getRegistry(): PropertyWrapperRegistry {\n    return this.registry\n  }\n\n  /**\n   * Set up debugging for @State property wrappers\n   */\n  private setupStateDebugging<T>(state: State<T>, metadata: PropertyWrapperMetadata): void {\n    if (typeof window !== 'undefined') {\n      // Add to global debug object\n      const globalDebug = (window as any).__TACHUI_DEBUG__ || {}\n      if (!globalDebug.states) globalDebug.states = {}\n\n      globalDebug.states[`${metadata.componentId}_${metadata.propertyName}`] = {\n        state,\n        metadata,\n        getValue: () => state.wrappedValue,\n        setValue: (value: T) => {\n          state.projectedValue.set(value)\n        },\n        getBinding: () => state.projectedValue,\n      }\n\n      ;(window as any).__TACHUI_DEBUG__ = globalDebug\n    }\n  }\n\n  /**\n   * Set up debugging for @ObservedObject property wrappers\n   */\n  private setupObservedObjectDebugging<T extends ObservableObject>(\n    observedObject: ObservedObject<T>,\n    metadata: PropertyWrapperMetadata\n  ): void {\n    if (typeof window !== 'undefined') {\n      // Add to global debug object\n      const globalDebug = (window as any).__TACHUI_DEBUG__ || {}\n      if (!globalDebug.observedObjects) globalDebug.observedObjects = {}\n\n      globalDebug.observedObjects[`${metadata.componentId}_${metadata.propertyName}`] = {\n        observedObject,\n        metadata,\n        getObject: () => observedObject.wrappedValue,\n        getNotificationCount: () => (observedObject.wrappedValue as any).notificationCount || 0,\n        triggerChange: () => observedObject.wrappedValue.notifyChange(),\n      }\n\n      ;(window as any).__TACHUI_DEBUG__ = globalDebug\n    }\n  }\n}\n\n/**\n * Property wrapper registry implementation\n */\nclass PropertyWrapperRegistryImpl implements PropertyWrapperRegistry {\n  private metadata = new Map<string, PropertyWrapperMetadata[]>()\n\n  /**\n   * Register property wrapper metadata\n   */\n  register(metadata: PropertyWrapperMetadata): void {\n    const key = metadata.componentId\n    const existing = this.metadata.get(key) || []\n    existing.push(metadata)\n    this.metadata.set(key, existing)\n  }\n\n  /**\n   * Unregister a specific property wrapper\n   */\n  unregister(componentId: string, propertyName: string): void {\n    const existing = this.metadata.get(componentId) || []\n    const filtered = existing.filter((m) => m.propertyName !== propertyName)\n\n    if (filtered.length > 0) {\n      this.metadata.set(componentId, filtered)\n    } else {\n      this.metadata.delete(componentId)\n    }\n  }\n\n  /**\n   * Clean up all metadata for a component\n   */\n  cleanup(componentId: string): void {\n    this.metadata.delete(componentId)\n  }\n\n  /**\n   * Get all metadata for a component\n   */\n  getMetadata(componentId: string): PropertyWrapperMetadata[] {\n    return this.metadata.get(componentId) || []\n  }\n\n  /**\n   * Get all registered metadata (for debugging)\n   */\n  getAllMetadata(): Map<string, PropertyWrapperMetadata[]> {\n    return new Map(this.metadata)\n  }\n}\n\n/**\n * Create a state manager for a component\n */\nexport function createStateManager(componentContext: ComponentContext): StateManager {\n  return new StateManagerImpl(componentContext)\n}\n\n/**\n * Global state manager registry for debugging and introspection\n */\nclass GlobalStateManagerRegistry {\n  private static instance: GlobalStateManagerRegistry\n  private managers = new Map<string, StateManager>()\n\n  static getInstance(): GlobalStateManagerRegistry {\n    if (!GlobalStateManagerRegistry.instance) {\n      GlobalStateManagerRegistry.instance = new GlobalStateManagerRegistry()\n    }\n    return GlobalStateManagerRegistry.instance\n  }\n\n  register(componentId: string, manager: StateManager): void {\n    this.managers.set(componentId, manager)\n  }\n\n  unregister(componentId: string): void {\n    this.managers.delete(componentId)\n  }\n\n  getManager(componentId: string): StateManager | undefined {\n    return this.managers.get(componentId)\n  }\n\n  getAllManagers(): Map<string, StateManager> {\n    return new Map(this.managers)\n  }\n\n  /**\n   * Get debugging information for all components\n   */\n  getDebugInfo(): any {\n    const info: any = {}\n\n    for (const [componentId, manager] of this.managers) {\n      info[componentId] = {\n        states: (manager as StateManagerImpl).getStates().size,\n        bindings: (manager as StateManagerImpl).getBindings().size,\n        observedObjects: (manager as StateManagerImpl).getObservedObjects().size,\n        environmentObjects: (manager as StateManagerImpl).getEnvironmentObjects().size,\n        metadata: (manager as StateManagerImpl).getRegistry().getMetadata(componentId),\n      }\n    }\n\n    return info\n  }\n}\n\n/**\n * Register a state manager globally\n */\nexport function registerStateManager(componentId: string, manager: StateManager): void {\n  GlobalStateManagerRegistry.getInstance().register(componentId, manager)\n}\n\n/**\n * Unregister a state manager globally\n */\nexport function unregisterStateManager(componentId: string): void {\n  GlobalStateManagerRegistry.getInstance().unregister(componentId)\n}\n\n/**\n * Get a state manager by component ID\n */\nexport function getStateManager(componentId: string): StateManager | undefined {\n  return GlobalStateManagerRegistry.getInstance().getManager(componentId)\n}\n\n/**\n * Get all state managers (for debugging)\n */\nexport function getAllStateManagers(): Map<string, StateManager> {\n  return GlobalStateManagerRegistry.getInstance().getAllManagers()\n}\n\n/**\n * Get debugging information for all state managers\n */\nexport function getStateManagerDebugInfo(): any {\n  return GlobalStateManagerRegistry.getInstance().getDebugInfo()\n}\n\n/**\n * Initialize global debugging utilities\n */\nexport function initializeStateDebugging(): void {\n  if (typeof window !== 'undefined' && process.env.NODE_ENV === 'development') {\n    const globalDebug = (window as any).__TACHUI_DEBUG__ || {}\n\n    globalDebug.stateManagers = {\n      getAll: getAllStateManagers,\n      getDebugInfo: getStateManagerDebugInfo,\n      getManager: getStateManager,\n    }\n\n    ;(window as any).__TACHUI_DEBUG__ = globalDebug\n\n    console.log(\n      'TachUI State Management debugging enabled. Use window.__TACHUI_DEBUG__.stateManagers'\n    )\n  }\n}\n"],"names":["StateManagerImpl","componentContext","__publicField","PropertyWrapperRegistryImpl","state","_options","metadata","key","binding","options","observedObject","environmentObject","globalDebug","value","existing","componentId","propertyName","filtered","m","createStateManager","_GlobalStateManagerRegistry","manager","info","GlobalStateManagerRegistry","registerStateManager","unregisterStateManager","getStateManager","getAllStateManagers","getStateManagerDebugInfo","initializeStateDebugging"],"mappings":"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"}

package/dist/state/state.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("../reactive/context.cjs"),g=require("../reactive/effect.cjs"),f=require("../reactive/signal.cjs"),m=require("../runtime/component-context.cjs");var w=Object.defineProperty,S=(e,t,n)=>t in e?w(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,u=(e,t,n)=>S(e,typeof t!="symbol"?t+"":t,n);class V{constructor(t,n,r,s={}){u(this,"_accessor"),u(this,"_setter"),u(this,"_binding"),u(this,"_metadata");const[i,a]=f.createSignal(t);this._accessor=i,this._setter=a,this._binding=c(i,a,{name:s.name||`${r}Binding`}),this._metadata={type:"State",propertyName:r,componentId:n.id,options:s},n.setState(r,t);const o=_.getCurrentOwner();o&&o.cleanups.push(()=>{this.cleanup()}),s.resetOnMount&&this.resetToInitialValue(t),s.persist&&typeof window<"u"&&this.setupPersistence(r,t)}get wrappedValue(){return this._accessor()}set wrappedValue(t){this._setter(t)}get projectedValue(){return this._binding}get accessor(){return this._accessor}get setter(){return this._setter}get metadata(){return this._metadata}resetToInitialValue(t){this._setter(t)}setupPersistence(t,n){const r=`tachui_state_${this._metadata.componentId}_${t}`;try{const s=localStorage.getItem(r);if(s!=null&&s!=="undefined"){const i=JSON.parse(s);this._setter(i)}}catch(s){console.warn(`Failed to load persisted state for ${t}:`,s)}g.createEffect(()=>{const s=this._accessor();try{localStorage.setItem(r,JSON.stringify(s))}catch(i){console.warn(`Failed to persist state for ${t}:`,i)}})}cleanup(){}}function c(e,t,n={}){return new b(e,t,n)}class b{constructor(t,n,r={}){this._get=t,this._set=n,this._options=r}get wrappedValue(){return this._get()}set wrappedValue(t){this._set(t)}get projectedValue(){return this}get(){return this._get()}set(t){this._set(t)}map(t,n){return c(()=>t(this._get()),i=>{const a=this._get(),o=t(a),h=typeof i=="function"?i(o):i,l=n(h,a);this._set(l)},{name:`${this._options.name||"binding"}_mapped`})}constant(){return c(this._get,()=>(console.warn("Attempted to set value on constant binding"),this._get()),{name:`${this._options.name||"binding"}_constant`})}}const y=(e,t={})=>{const n=m.getCurrentComponentContext(),r=I()||"state";return new V(e,n,r,t)},B=c;function I(){try{const e=new Error().stack;if(e)return e.match(/at (\w+)\./)?.[1]||null}catch{}return null}function d(e){return e&&typeof e=="object"&&"wrappedValue"in e&&"projectedValue"in e}function p(e){return e&&typeof e=="object"&&"get"in e&&"set"in e&&"wrappedValue"in e}function $(e){return d(e)||p(e)?e.wrappedValue:e}exports.State=y;exports.createBinding=c;exports.createStateBinding=B;exports.isBinding=p;exports.isState=d;exports.unwrapValue=$;
+//# sourceMappingURL=state.cjs.map

package/dist/state/state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.cjs","sources":["../../src/state/state.ts"],"sourcesContent":["/**\n * @State Property Wrapper Implementation\n *\n * Implements SwiftUI's @State property wrapper for local component state management.\n * Provides reactive state with automatic component re-rendering on changes.\n */\n\nimport { getCurrentOwner } from '../reactive/context'\nimport { createEffect } from '../reactive/effect'\nimport { createSignal } from '../reactive/signal'\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, PropertyWrapperMetadata, StateFactory, StateWrapperOptions } from './types'\n\n/**\n * Internal state wrapper implementation\n */\nclass StateImpl<T> implements Types.State<T> {\n  private _accessor: Accessor<T>\n  private _setter: Setter<T>\n  private _binding: Binding<T>\n  private _metadata: PropertyWrapperMetadata\n\n  constructor(\n    initialValue: T,\n    componentContext: ComponentContext,\n    propertyName: string,\n    options: StateWrapperOptions = {}\n  ) {\n    // Create the underlying reactive signal\n    const [accessor, setter] = createSignal(initialValue)\n    this._accessor = accessor\n    this._setter = setter\n\n    // Create the projected binding\n    this._binding = createBinding(accessor, setter, {\n      name: options.name || `${propertyName}Binding`,\n    })\n\n    // Store metadata for introspection\n    this._metadata = {\n      type: 'State',\n      propertyName,\n      componentId: componentContext.id,\n      options,\n    }\n\n    // Register with component context for lifecycle management\n    componentContext.setState(propertyName, initialValue)\n\n    // Set up cleanup on component unmount\n    const owner = getCurrentOwner()\n    if (owner) {\n      owner.cleanups.push(() => {\n        // Cleanup any resources if needed\n        this.cleanup()\n      })\n    }\n\n    // Handle reset on mount if configured\n    if (options.resetOnMount) {\n      this.resetToInitialValue(initialValue)\n    }\n\n    // Set up persistence if configured\n    if (options.persist && typeof window !== 'undefined') {\n      this.setupPersistence(propertyName, initialValue)\n    }\n  }\n\n  get wrappedValue(): T {\n    return this._accessor()\n  }\n\n  set wrappedValue(value: T) {\n    this._setter(value)\n  }\n\n  get projectedValue(): Binding<T> {\n    return this._binding\n  }\n\n  /**\n   * Get the underlying signal accessor (for advanced usage)\n   */\n  get accessor(): Accessor<T> {\n    return this._accessor\n  }\n\n  /**\n   * Get the underlying signal setter (for advanced usage)\n   */\n  get setter(): Setter<T> {\n    return this._setter\n  }\n\n  /**\n   * Get property wrapper metadata\n   */\n  get metadata(): PropertyWrapperMetadata {\n    return this._metadata\n  }\n\n  /**\n   * Reset to initial value\n   */\n  private resetToInitialValue(initialValue: T): void {\n    this._setter(initialValue)\n  }\n\n  /**\n   * Set up local storage persistence\n   */\n  private setupPersistence(propertyName: string, _initialValue: T): void {\n    const storageKey = `tachui_state_${this._metadata.componentId}_${propertyName}`\n\n    // Try to load persisted value\n    try {\n      const stored = localStorage.getItem(storageKey)\n      if (stored !== null && stored !== undefined && stored !== 'undefined') {\n        const parsedValue = JSON.parse(stored)\n        this._setter(parsedValue)\n      }\n    } catch (error) {\n      console.warn(`Failed to load persisted state for ${propertyName}:`, error)\n    }\n\n    // Set up automatic persistence on changes\n    createEffect(() => {\n      const currentValue = this._accessor()\n      try {\n        localStorage.setItem(storageKey, JSON.stringify(currentValue))\n      } catch (error) {\n        console.warn(`Failed to persist state for ${propertyName}:`, error)\n      }\n    })\n  }\n\n  /**\n   * Cleanup resources\n   */\n  private cleanup(): void {\n    // Any cleanup logic would go here\n    // Currently no cleanup needed for basic state\n  }\n}\n\n/**\n * Create a binding from getter and setter functions\n */\nfunction createBinding<T>(\n  get: Accessor<T>,\n  set: Setter<T>,\n  options: { name?: string } = {}\n): Binding<T> {\n  return new BindingImpl(get, set, options)\n}\n\n/**\n * Internal binding implementation\n */\nclass BindingImpl<T> implements Binding<T> {\n  constructor(\n    private _get: Accessor<T>,\n    private _set: Setter<T>,\n    private _options: { name?: string } = {}\n  ) {}\n\n  get wrappedValue(): T {\n    return this._get()\n  }\n\n  set wrappedValue(value: T) {\n    this._set(value)\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)\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)\n    }\n\n    return createBinding(mappedGet, mappedSet as Setter<U>, {\n      name: `${this._options.name || 'binding'}_mapped`,\n    })\n  }\n\n  /**\n   * Create a constant binding (read-only)\n   */\n  constant(): Binding<T> {\n    return createBinding(\n      this._get,\n      () => {\n        console.warn('Attempted to set value on constant binding')\n        return this._get()\n      },\n      { name: `${this._options.name || 'binding'}_constant` }\n    )\n  }\n}\n\n/**\n * @State property wrapper factory\n *\n * Creates a @State property wrapper for local component state.\n *\n * @param initialValue - The initial value for the state\n * @param options - Configuration options for the state wrapper\n * @returns A State property wrapper\n *\n * @example\n * ```typescript\n * class MyComponent {\n *   @State(0)\n *   private count: number\n *\n *   @State('Hello')\n *   private message: string\n *\n *   render() {\n *     return Text(`${this.message}: ${this.count}`)\n *       .modifier\n *       .onTap(() => this.count++)\n *       .build()\n *   }\n * }\n * ```\n */\nexport const State: StateFactory = <T>(\n  initialValue: T,\n  options: StateWrapperOptions = {}\n): Types.State<T> => {\n  // This will be replaced by the decorator transformer during compilation\n  // For runtime usage, we need component context\n  const componentContext = getCurrentComponentContext()\n  const propertyName = getCallerPropertyName() || 'state'\n\n  return new StateImpl(initialValue, componentContext, propertyName, options)\n}\n\n/**\n * Create a binding from external getter/setter functions\n *\n * @param get - Function to get current value\n * @param set - Function to set new value\n * @param options - Configuration options\n * @returns A Binding property wrapper\n *\n * @example\n * ```typescript\n * const binding = createBinding(\n *   () => externalValue,\n *   (value) => { externalValue = value },\n *   { name: 'externalBinding' }\n * )\n * ```\n */\nexport const createStateBinding = createBinding\n\n// getCurrentComponentContext is now imported from component-context module\n\n/**\n * Helper to get the property name of the caller (used for metadata)\n */\nfunction getCallerPropertyName(): string | null {\n  // This would be replaced by the compiler with actual property name\n  // For runtime debugging, we can try to infer from call stack\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// ComponentContextSymbol is now imported from component-context module\n\n/**\n * Export binding factory for external use\n */\nexport { createBinding }\n\n/**\n * Type guard for State property wrappers\n */\nexport function isState<T>(value: any): value is Types.State<T> {\n  return value && typeof value === 'object' && 'wrappedValue' in value && 'projectedValue' in value\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  )\n}\n\n/**\n * Utility to extract the raw value from State or Binding\n */\nexport function unwrapValue<T>(wrapper: Types.State<T> | Binding<T> | T): T {\n  if (isState(wrapper) || isBinding(wrapper)) {\n    return (wrapper as Types.State<T> | Binding<T>).wrappedValue\n  }\n  return wrapper as T\n}\n"],"names":["StateImpl","initialValue","componentContext","propertyName","options","__publicField","accessor","setter","createSignal","createBinding","owner","getCurrentOwner","value","_initialValue","storageKey","stored","parsedValue","error","createEffect","currentValue","get","set","BindingImpl","_get","_set","_options","getter","currentMapped","newMapped","newOriginal","State","getCurrentComponentContext","getCallerPropertyName","createStateBinding","stack","isState","isBinding","unwrapValue","wrapper"],"mappings":"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"}

package/dist/state/state.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @State Property Wrapper Implementation
+ *
+ * Implements SwiftUI's @State property wrapper for local component state management.
+ * Provides reactive state with automatic component re-rendering on changes.
+ */
+import type { Accessor, Setter } from '../reactive/types';
+import type * as Types from './types';
+import type { Binding, StateFactory } from './types';
+/**
+ * Create a binding from getter and setter functions
+ */
+declare function createBinding<T>(get: Accessor<T>, set: Setter<T>, options?: {
+    name?: string;
+}): Binding<T>;
+/**
+ * @State property wrapper factory
+ *
+ * Creates a @State property wrapper for local component state.
+ *
+ * @param initialValue - The initial value for the state
+ * @param options - Configuration options for the state wrapper
+ * @returns A State property wrapper
+ *
+ * @example
+ * ```typescript
+ * class MyComponent {
+ *   @State(0)
+ *   private count: number
+ *
+ *   @State('Hello')
+ *   private message: string
+ *
+ *   render() {
+ *     return Text(`${this.message}: ${this.count}`)
+ *       .modifier
+ *       .onTap(() => this.count++)
+ *       .build()
+ *   }
+ * }
+ * ```
+ */
+export declare const State: StateFactory;
+/**
+ * Create a binding from external getter/setter functions
+ *
+ * @param get - Function to get current value
+ * @param set - Function to set new value
+ * @param options - Configuration options
+ * @returns A Binding property wrapper
+ *
+ * @example
+ * ```typescript
+ * const binding = createBinding(
+ *   () => externalValue,
+ *   (value) => { externalValue = value },
+ *   { name: 'externalBinding' }
+ * )
+ * ```
+ */
+export declare const createStateBinding: typeof createBinding;
+/**
+ * Export binding factory for external use
+ */
+export { createBinding };
+/**
+ * Type guard for State property wrappers
+ */
+export declare function isState<T>(value: any): value is Types.State<T>;
+/**
+ * Type guard for Binding property wrappers
+ */
+export declare function isBinding<T>(value: any): value is Binding<T>;
+/**
+ * Utility to extract the raw value from State or Binding
+ */
+export declare function unwrapValue<T>(wrapper: Types.State<T> | Binding<T> | T): T;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAGzD,OAAO,KAAK,KAAK,KAAK,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAA2B,YAAY,EAAuB,MAAM,SAAS,CAAA;AAuIlG;;GAEG;AACH,iBAAS,aAAa,CAAC,CAAC,EACtB,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChB,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EACd,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAkED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,EAAE,YAUnB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,sBAAgB,CAAA;AAyB/C;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAQ5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAK1E"}

package/dist/state/state.js

@@ -0,0 +1,159 @@
+import { getCurrentOwner as h } from "../reactive/context.js";
+import { createEffect as _ } from "../reactive/effect.js";
+import { createSignal as l } from "../reactive/signal.js";
+import { getCurrentComponentContext as g } from "../runtime/component-context.js";
+var m = Object.defineProperty, f = (e, t, n) => t in e ? m(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n, c = (e, t, n) => f(e, typeof t != "symbol" ? t + "" : t, n);
+class w {
+  constructor(t, n, r, s = {}) {
+    c(this, "_accessor"), c(this, "_setter"), c(this, "_binding"), c(this, "_metadata");
+    const [i, a] = l(t);
+    this._accessor = i, this._setter = a, this._binding = u(i, a, {
+      name: s.name || `${r}Binding`
+    }), this._metadata = {
+      type: "State",
+      propertyName: r,
+      componentId: n.id,
+      options: s
+    }, n.setState(r, t);
+    const o = h();
+    o && o.cleanups.push(() => {
+      this.cleanup();
+    }), s.resetOnMount && this.resetToInitialValue(t), s.persist && typeof window < "u" && this.setupPersistence(r, t);
+  }
+  get wrappedValue() {
+    return this._accessor();
+  }
+  set wrappedValue(t) {
+    this._setter(t);
+  }
+  get projectedValue() {
+    return this._binding;
+  }
+  /**
+   * Get the underlying signal accessor (for advanced usage)
+   */
+  get accessor() {
+    return this._accessor;
+  }
+  /**
+   * Get the underlying signal setter (for advanced usage)
+   */
+  get setter() {
+    return this._setter;
+  }
+  /**
+   * Get property wrapper metadata
+   */
+  get metadata() {
+    return this._metadata;
+  }
+  /**
+   * Reset to initial value
+   */
+  resetToInitialValue(t) {
+    this._setter(t);
+  }
+  /**
+   * Set up local storage persistence
+   */
+  setupPersistence(t, n) {
+    const r = `tachui_state_${this._metadata.componentId}_${t}`;
+    try {
+      const s = localStorage.getItem(r);
+      if (s != null && s !== "undefined") {
+        const i = JSON.parse(s);
+        this._setter(i);
+      }
+    } catch (s) {
+      console.warn(`Failed to load persisted state for ${t}:`, s);
+    }
+    _(() => {
+      const s = this._accessor();
+      try {
+        localStorage.setItem(r, JSON.stringify(s));
+      } catch (i) {
+        console.warn(`Failed to persist state for ${t}:`, i);
+      }
+    });
+  }
+  /**
+   * Cleanup resources
+   */
+  cleanup() {
+  }
+}
+function u(e, t, n = {}) {
+  return new V(e, t, n);
+}
+class V {
+  constructor(t, n, r = {}) {
+    this._get = t, this._set = n, this._options = r;
+  }
+  get wrappedValue() {
+    return this._get();
+  }
+  set wrappedValue(t) {
+    this._set(t);
+  }
+  get projectedValue() {
+    return this;
+  }
+  get() {
+    return this._get();
+  }
+  set(t) {
+    this._set(t);
+  }
+  /**
+   * Create a derived binding with transformation
+   */
+  map(t, n) {
+    return u(() => t(this._get()), (i) => {
+      const a = this._get(), o = t(a), d = typeof i == "function" ? i(o) : i, p = n(d, a);
+      this._set(p);
+    }, {
+      name: `${this._options.name || "binding"}_mapped`
+    });
+  }
+  /**
+   * Create a constant binding (read-only)
+   */
+  constant() {
+    return u(
+      this._get,
+      () => (console.warn("Attempted to set value on constant binding"), this._get()),
+      { name: `${this._options.name || "binding"}_constant` }
+    );
+  }
+}
+const B = (e, t = {}) => {
+  const n = g(), r = S() || "state";
+  return new w(e, n, r, t);
+}, C = u;
+function S() {
+  try {
+    const e = new Error().stack;
+    if (e)
+      return e.match(/at (\w+)\./)?.[1] || null;
+  } catch {
+  }
+  return null;
+}
+function b(e) {
+  return e && typeof e == "object" && "wrappedValue" in e && "projectedValue" in e;
+}
+function I(e) {
+  return e && typeof e == "object" && "get" in e && "set" in e && "wrappedValue" in e;
+}
+function j(e) {
+  return b(e) || I(e) ? e.wrappedValue : e;
+}
+export {
+  B as State,
+  u as createBinding,
+  C as createStateBinding,
+  I as isBinding,
+  b as isState,
+  j as unwrapValue
+};
+//# sourceMappingURL=state.js.map