@tachui/cli 0.8.11 → 0.8.12

package/dist/core/src/components/factory.d.ts

@@ -0,0 +1,24 @@
+import type { ComponentInstance, ComponentProps } from '../runtime/types';
+/**
+ * Options for class-based component creation.
+ */
+export interface CreateComponentOptions {
+    /**
+     * When true, the returned instance is immediately wrapped in the modifier proxy.
+     * Defaults to true so that downstream code can access modifier methods without
+     * re-wrapping manually. Legacy paths that apply modifiers separately can set
+     * this to false.
+     */
+    prewarmProxy?: boolean;
+}
+/**
+ * Instantiate a class-based component and ensure modifier proxy state is primed.
+ *
+ * This helper mirrors SwiftUI's component allocation flow while keeping
+ * TachUI's modifier proxy cache in sync. When proxy mode is enabled the
+ * instance is registered with the proxy cache so subsequent `withModifiers`
+ * calls can reuse the same proxy. When proxy mode is disabled the raw
+ * instance is returned.
+ */
+export declare function createComponentInstance<P extends ComponentProps, R extends ComponentInstance<P>, Args extends unknown[]>(ComponentClass: new (props: P, ...rest: Args) => R, props: P, options?: CreateComponentOptions, ...rest: Args): R;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/src/components/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../core/src/components/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS,cAAc,EACxB,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAC9B,IAAI,SAAS,OAAO,EAAE,EAEtB,cAAc,EAAE,KAAK,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EAClD,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,sBAA2B,EACpC,GAAG,IAAI,EAAE,IAAI,GACZ,CAAC,CAQH"}

package/dist/core/src/components/factory.js

@@ -0,0 +1,19 @@
+import { isProxyEnabled } from '../config';
+import { createComponentProxy } from '../modifiers/proxy';
+/**
+ * Instantiate a class-based component and ensure modifier proxy state is primed.
+ *
+ * This helper mirrors SwiftUI's component allocation flow while keeping
+ * TachUI's modifier proxy cache in sync. When proxy mode is enabled the
+ * instance is registered with the proxy cache so subsequent `withModifiers`
+ * calls can reuse the same proxy. When proxy mode is disabled the raw
+ * instance is returned.
+ */
+export function createComponentInstance(ComponentClass, props, options = {}, ...rest) {
+    const instance = new ComponentClass(props, ...rest);
+    if (isProxyEnabled() && options.prewarmProxy !== false) {
+        createComponentProxy(instance);
+    }
+    return instance;
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/src/components/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../core/src/components/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAgBzD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAKrC,cAAkD,EAClD,KAAQ,EACR,UAAkC,EAAE,EACpC,GAAG,IAAU;IAEb,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;IAEnD,IAAI,cAAc,EAAE,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QACvD,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/core/src/components/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * TachUI Component System
+ *
+ * Core component infrastructure and utilities that provide
+ * the foundation for building reactive UI components.
+ */
+export type { ModifiableComponent, ModifierBuilder } from '../modifiers/types';
+export type { ComponentInstance, ComponentProps, DOMNode, } from '../runtime/types';
+export type { WrapperOptions, BaseLayoutProps, VStackLayoutProps, HStackLayoutProps, ZStackLayoutProps, } from './wrapper';
+export { createModifiableComponentFactory, createReactiveWrapper, Layout, LayoutComponent, withModifierSupport, withModifiers, wrapComponent, } from './wrapper';
+export { createComponentInstance, type CreateComponentOptions } from './factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/src/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../core/src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC9E,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,gCAAgC,EAChC,qBAAqB,EACrB,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,WAAW,CAAA"}

package/dist/core/src/components/index.js

@@ -0,0 +1,9 @@
+/**
+ * TachUI Component System
+ *
+ * Core component infrastructure and utilities that provide
+ * the foundation for building reactive UI components.
+ */
+export { createModifiableComponentFactory, createReactiveWrapper, Layout, LayoutComponent, withModifierSupport, withModifiers, wrapComponent, } from './wrapper';
+export { createComponentInstance } from './factory';
+//# sourceMappingURL=index.js.map

package/dist/core/src/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../core/src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,EACL,gCAAgC,EAChC,qBAAqB,EACrB,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,uBAAuB,EAA+B,MAAM,WAAW,CAAA"}

package/dist/core/src/components/wrapper.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Component Wrapper System
+ *
+ * Provides wrapper functions to enhance regular components with modifier support
+ * and integrate them with the TachUI modifier system.
+ */
+import type { ModifiableComponent, ModifierBuilder, ModifiableComponentWithModifiers } from '../modifiers/types';
+import type { ComponentInstance, ComponentProps, DOMNode, CloneableComponent, CloneOptions } from '../runtime/types';
+import { type ElementOverrideProps } from '../runtime/element-override';
+import { ComponentWithCSSClasses, type CSSClassesProps } from '../css-classes';
+import type { Concatenatable } from '../concatenation/types';
+/**
+ * Wrapper options for enhancing components
+ */
+export interface WrapperOptions {
+    enableModifiers?: boolean;
+    enableReactivity?: boolean;
+    enableErrorBoundary?: boolean;
+    enablePerformanceTracking?: boolean;
+}
+export interface BaseLayoutProps extends ComponentProps, ElementOverrideProps, CSSClassesProps {
+    id?: string;
+    debugLabel?: string;
+    children?: ComponentInstance[];
+}
+export interface VStackLayoutProps extends BaseLayoutProps {
+    spacing?: number;
+    alignment?: 'leading' | 'center' | 'trailing';
+}
+export interface HStackLayoutProps extends BaseLayoutProps {
+    spacing?: number;
+    alignment?: 'top' | 'center' | 'bottom' | 'leading' | 'trailing' | 'left' | 'right';
+}
+export interface ZStackLayoutProps extends BaseLayoutProps {
+    alignment?: 'topLeading' | 'top' | 'topTrailing' | 'leading' | 'center' | 'trailing' | 'bottomLeading' | 'bottom' | 'bottomTrailing';
+}
+/**
+ * Enhanced component wrapper that adds modifier support and preserves concatenation methods
+ */
+export declare function withModifiers<P extends ComponentProps>(component: ComponentInstance<P>): ModifiableComponentWithModifiers<P> & (ComponentInstance<P> extends Concatenatable ? Concatenatable : {});
+/**
+ * Create a reactive component wrapper with full TachUI features
+ */
+export declare function createReactiveWrapper<P extends ComponentProps>(renderFn: (props: P) => DOMNode | DOMNode[], options?: WrapperOptions): (props: P) => ModifiableComponentWithModifiers<P>;
+/**
+ * Layout container component class with element override support
+ */
+export declare class LayoutComponent extends ComponentWithCSSClasses implements CloneableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps> {
+    props: ComponentProps & ElementOverrideProps & CSSClassesProps;
+    private layoutType;
+    children: ComponentInstance[];
+    private layoutProps;
+    readonly type: "component";
+    readonly id: string;
+    mounted: boolean;
+    cleanup: (() => void)[];
+    private effectiveTag;
+    private validationResult;
+    constructor(props: ComponentProps & ElementOverrideProps & CSSClassesProps, layoutType: 'vstack' | 'hstack' | 'zstack', children?: ComponentInstance[], layoutProps?: any);
+    /**
+     * Find DOM elements for a specific child component within the layout container
+     */
+    private findChildDOMElements;
+    render(): {
+        type: "element";
+        tag: string;
+        props: any;
+        children: DOMNode[];
+        componentMetadata: {
+            originalType: string;
+            overriddenTo: string | undefined;
+            validationResult: any;
+        };
+    }[] | {
+        type: "element";
+        tag: string;
+        props: {};
+        children: never[];
+    }[];
+    clone(options?: CloneOptions): this;
+    shallowClone(): this;
+    deepClone(): this;
+}
+/**
+ * Layout container components with modifier support
+ */
+export declare const Layout: {
+    /**
+     * Vertical stack container (flexbox column)
+     */
+    VStack: (props?: VStackLayoutProps) => ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps> & ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>> & {
+        modifier: ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>>;
+    };
+    /**
+     * Horizontal stack container (flexbox row)
+     */
+    HStack: (props?: HStackLayoutProps) => ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps> & ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>> & {
+        modifier: ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>>;
+    };
+    /**
+     * Z-index stack container (absolute positioning)
+     */
+    ZStack: (props?: ZStackLayoutProps) => ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps> & ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>> & {
+        modifier: ModifierBuilder<ModifiableComponent<ComponentProps & ElementOverrideProps & CSSClassesProps>>;
+    };
+};
+/**
+ * Utility to wrap any component with modifier support
+ */
+export declare function wrapComponent<P extends ComponentProps>(component: ComponentInstance<P>): ModifiableComponent<P> & {
+    modifier: ModifierBuilder<ModifiableComponent<P>>;
+};
+/**
+ * Higher-order component wrapper
+ */
+export declare function withModifierSupport<P extends ComponentProps>(ComponentClass: new (props: P) => ComponentInstance<P>): {
+    new (props: P): {
+        _modifiableComponent?: ModifiableComponent<P>;
+        get modifier(): ModifierBuilder<ModifiableComponent<P>>;
+        get modifiers(): any;
+        type: "component";
+        render: import("@tachui/types/runtime").RenderFunction;
+        props: P;
+        prevProps?: P | undefined;
+        children?: import("@tachui/types/runtime").ComponentChildren;
+        context?: import("@tachui/types/runtime").ComponentContext;
+        cleanup?: import("@tachui/types/runtime").LifecycleCleanup[];
+        id: string;
+        ref?: import("@tachui/types/runtime").Ref | undefined;
+        mounted?: boolean;
+        domElements?: Map<string, Element>;
+        primaryElement?: Element;
+        domReady?: boolean;
+    };
+};
+/**
+ * Factory function for creating modifiable components
+ */
+export declare function createModifiableComponentFactory<P extends ComponentProps>(renderFn: (props: P) => DOMNode | DOMNode[]): (props: P) => ModifiableComponent<P> & ModifierBuilder<ModifiableComponent<P>> & {
+    modifier: ModifierBuilder<ModifiableComponent<P>>;
+};
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/core/src/components/wrapper.d.ts.map

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