@tachui/core 0.7.0-alpha1 → 0.8.0-alpha

package/src/state/types.ts

@@ -1,192 +0,0 @@
-/**
- * SwiftUI-Style State Management Types
- *
- * Type definitions for @State, @Binding, @ObservedObject, and @EnvironmentObject
- * property wrappers that provide SwiftUI-compatible state management patterns.
- */
-
-import type { Accessor, Setter, Signal } from '../reactive/types'
-import type { ComponentContext } from '../runtime/types'
-
-/**
- * Property wrapper base interface
- */
-export interface PropertyWrapper<T> {
-  readonly wrappedValue: T
-  readonly projectedValue?: any
-}
-
-/**
- * @State property wrapper for local component state
- * Provides a two-way binding to a reactive value
- */
-export interface State<T> extends PropertyWrapper<T> {
-  wrappedValue: T // State wrappedValue should be mutable
-  readonly projectedValue: Binding<T>
-}
-
-/**
- * @Binding property wrapper for two-way data binding
- * Allows child components to read and write parent state
- */
-export interface Binding<T> extends PropertyWrapper<T> {
-  readonly wrappedValue: T
-  readonly projectedValue: Binding<T>
-  get(): T
-  set(value: T | ((prev: T) => T)): void
-  map<U>(getter: (value: T) => U, setter: (newValue: U, oldValue: T) => T): Binding<U>
-  constant(): Binding<T>
-}
-
-/**
- * Observable object interface for @ObservedObject
- * Objects that can notify observers of changes
- */
-export interface ObservableObject {
-  readonly objectWillChange: Signal<void>
-  readonly notificationCount: number
-  notifyChange(): void
-}
-
-/**
- * @ObservedObject property wrapper for external observable objects
- * Automatically triggers re-renders when the observed object changes
- */
-export interface ObservedObject<T extends ObservableObject> extends PropertyWrapper<T> {
-  readonly wrappedValue: T
-  readonly projectedValue: ObservedObject<T>
-}
-
-/**
- * @EnvironmentObject property wrapper for dependency injection
- * Provides access to objects from the environment context
- */
-export interface EnvironmentObject<T> extends PropertyWrapper<T> {
-  readonly wrappedValue: T
-  readonly projectedValue: EnvironmentObject<T>
-}
-
-/**
- * Environment key for type-safe environment object access
- */
-export interface EnvironmentKey<T> {
-  readonly symbol: symbol
-  readonly defaultValue?: T
-}
-
-/**
- * State wrapper configuration options
- */
-export interface StateWrapperOptions {
-  name?: string
-  resetOnMount?: boolean
-  persist?: boolean
-  debounce?: number
-}
-
-/**
- * Binding configuration options
- */
-export interface BindingOptions<T> {
-  name?: string
-  validate?: (value: T) => boolean
-  transform?: {
-    get?: (value: T) => T
-    set?: (value: T) => T
-  }
-}
-
-/**
- * Observable object configuration
- */
-export interface ObservableObjectOptions {
-  name?: string
-  autoNotify?: boolean
-}
-
-/**
- * Environment object configuration
- */
-export interface EnvironmentObjectOptions<T> {
-  key: EnvironmentKey<T>
-  required?: boolean
-}
-
-/**
- * State manager interface for component state lifecycle
- */
-export interface StateManager {
-  readonly componentContext: ComponentContext
-  registerState<T>(state: State<T>, options?: StateWrapperOptions): void
-  registerBinding<T>(binding: Binding<T>, options?: BindingOptions<T>): void
-  registerObservedObject<T extends ObservableObject>(
-    observedObject: ObservedObject<T>,
-    options?: ObservableObjectOptions
-  ): void
-  registerEnvironmentObject<T>(
-    environmentObject: EnvironmentObject<T>,
-    options?: EnvironmentObjectOptions<T>
-  ): void
-  cleanup(): void
-}
-
-/**
- * Property wrapper metadata for runtime introspection
- */
-export interface PropertyWrapperMetadata {
-  readonly type: 'State' | 'Binding' | 'ObservedObject' | 'EnvironmentObject'
-  readonly propertyName: string
-  readonly componentId: string
-  readonly options: Record<string, any>
-}
-
-/**
- * State binding syntax types for SwiftUI-style $ prefix bindings
- */
-export type StateBinding<T> = T extends State<infer U> ? Binding<U> : never
-export type BindingValue<T> = T extends Binding<infer U> ? U : never
-
-/**
- * Environment object provider interface
- */
-export interface EnvironmentObjectProvider<T> {
-  readonly key: EnvironmentKey<T>
-  readonly value: T
-  provide(): void
-  revoke(): void
-}
-
-/**
- * SwiftUI-compatible property wrapper factory types
- */
-export type StateFactory = <T>(initialValue: T, options?: StateWrapperOptions) => State<T>
-export type BindingFactory = <T>(
-  get: Accessor<T>,
-  set: Setter<T>,
-  options?: BindingOptions<T>
-) => Binding<T>
-export type ObservedObjectFactory = <T extends ObservableObject>(
-  object: T,
-  options?: ObservableObjectOptions
-) => ObservedObject<T>
-export type EnvironmentObjectFactory = <T>(
-  options: EnvironmentObjectOptions<T>
-) => EnvironmentObject<T>
-
-/**
- * Computed property types for derived state
- */
-export interface ComputedProperty<T> extends PropertyWrapper<T> {
-  readonly wrappedValue: T
-  readonly projectedValue: ComputedProperty<T>
-}
-
-/**
- * Property wrapper registry for component lifecycle management
- */
-export interface PropertyWrapperRegistry {
-  register(metadata: PropertyWrapperMetadata): void
-  unregister(componentId: string, propertyName: string): void
-  cleanup(componentId: string): void
-  getMetadata(componentId: string): PropertyWrapperMetadata[]
-}

package/src/sui-compat.ts

@@ -1,163 +0,0 @@
-/**
- * SUI Compatibility Layer (SUI = SwiftUI-inspired)
- *
- * Provides SwiftUI-style APIs and constants for familiar development experience.
- * Enables easy migration from SwiftUI to TachUI with minimal syntax changes.
- */
-
-import { infinity } from './constants/layout'
-import type { Dimension } from './constants/layout'
-
-/**
- * SUI-style constant exports (SUI = SwiftUI-inspired)
- * Allows usage like: import { SUI } from '@tachui/core'; SUI.infinity
- */
-export const SUI = {
-  infinity: infinity
-} as const
-
-/**
- * Direct infinity export for convenience
- * Allows usage like: import { infinity } from '@tachui/core'
- */
-export { infinity }
-
-/**
- * Type exports for SwiftUI compatibility
- */
-export type { Dimension }
-
-/**
- * Frame utility exports for convenience
- */
-export {
-  fillMaxWidth,
-  fillMaxHeight,
-  fillMaxSize,
-  expand,
-  fixedWidthExpandHeight,
-  fixedHeightExpandWidth,
-  constrainedExpand,
-  responsive,
-  flexible,
-  fullScreen,
-  remainingSpace,
-  equalShare
-} from './constants/frame-utils'
-
-// Import frame utilities for internal use
-import {
-  fillMaxWidth,
-  fillMaxHeight,
-  fillMaxSize,
-  expand,
-  fixedWidthExpandHeight,
-  fixedHeightExpandWidth,
-  constrainedExpand,
-  responsive,
-  flexible,
-  fullScreen,
-  remainingSpace,
-  equalShare
-} from './constants/frame-utils'
-
-/**
- * SUI-style frame helpers namespace (SUI = SwiftUI-inspired)
- * Provides organized access to frame utilities
- */
-export const Frame = {
-  fillMaxWidth,
-  fillMaxHeight,
-  fillMaxSize,
-  expand,
-  flexible,
-  fullScreen,
-  remainingSpace,
-  equalShare
-} as const
-
-/**
- * Common SUI layout patterns (SUI = SwiftUI-inspired)
- */
-export const LayoutPatterns = {
-  /**
-   * Full-width button pattern
-   * Common in forms and action sheets
-   */
-  fullWidthButton: fillMaxWidth,
-  
-  /**
-   * Sidebar layout pattern
-   * Fixed width with full height
-   */
-  sidebar: (width: number | string = 250) => fixedWidthExpandHeight(width),
-  
-  /**
-   * Header/footer pattern
-   * Fixed height with full width
-   */
-  header: (height: number | string = 60) => fixedHeightExpandWidth(height),
-  
-  /**
-   * Content area pattern
-   * Fills remaining space with constraints
-   */
-  content: (maxWidth?: number | string) => constrainedExpand(maxWidth),
-  
-  /**
-   * Card layout pattern
-   * Responsive with sensible constraints
-   */
-  card: responsive(320, 800, 200),
-  
-  /**
-   * Modal overlay pattern
-   * Full screen coverage
-   */
-  overlay: fullScreen
-} as const
-
-/**
- * Migration helpers for SUI developers (SUI = SwiftUI-inspired)
- * Common patterns mapped to TachUI equivalents
- */
-export const SuiMigration = {
-  /**
-   * Pattern: .frame(maxWidth: .infinity)
-   * TachUI: fillMaxWidth()
-   */
-  'frame(maxWidth: .infinity)': fillMaxWidth,
-  
-  /**
-   * Pattern: .frame(maxHeight: .infinity)
-   * TachUI: fillMaxHeight()
-   */
-  'frame(maxHeight: .infinity)': fillMaxHeight,
-  
-  /**
-   * Pattern: .frame(maxWidth: .infinity, maxHeight: .infinity)
-   * TachUI: fillMaxSize()
-   */
-  'frame(maxWidth: .infinity, maxHeight: .infinity)': fillMaxSize,
-  
-  /**
-   * Pattern: .frame(width: .infinity, height: .infinity)
-   * TachUI: expand()
-   */
-  'frame(width: .infinity, height: .infinity)': expand
-} as const
-
-/**
- * Debug helper for SUI compatibility (SUI = SwiftUI-inspired)
- * Logs equivalencies for learning purposes
- */
-export function logSuiEquivalent(suiCode: string): void {
-  if (process.env.NODE_ENV === 'development') {
-    const equivalent = (SuiMigration as any)[suiCode]
-    if (equivalent) {
-      console.info(`SUI Pattern: ${suiCode} → TachUI: ${equivalent.name}()`)
-    } else {
-      console.warn(`No TachUI equivalent found for: ${suiCode}`)
-    }
-  }
-}