// DalaNode.h — Data model node for the Dala UI tree (iOS SwiftUI layer). // Created and mutated by dala_nif.m NIFs; read by DalaRootView.swift for rendering. // No BEAM headers here — kept clean for Swift import via bridging header. #pragma once #import #import #import #import // Shared camera preview session — set by nif_camera_start/stop_preview, read by DalaRootView. extern AVCaptureSession* _Nullable g_preview_session; // Shared WebView — set by DalaWebView when created, read by webview NIFs. extern WKWebView* _Nullable g_webview; typedef NS_ENUM(NSInteger, DalaNodeType) { DalaNodeTypeColumn, DalaNodeTypeRow, DalaNodeTypeLabel, DalaNodeTypeButton, DalaNodeTypeScroll, DalaNodeTypeBox, DalaNodeTypeDivider, DalaNodeTypeSpacer, DalaNodeTypeProgress, DalaNodeTypeTextField, DalaNodeTypeToggle, DalaNodeTypeSlider, DalaNodeTypeImage, DalaNodeTypeLazyList, DalaNodeTypeTabBar, DalaNodeTypeVideo, DalaNodeTypeCameraPreview, DalaNodeTypeWebView, DalaNodeTypeNativeView, DalaNodeTypeIcon, }; NS_ASSUME_NONNULL_BEGIN @interface DalaNode : NSObject // Layout @property (nonatomic) DalaNodeType nodeType; @property (nonatomic, strong, nullable) UIColor* backgroundColor; @property (nonatomic) CGFloat padding; // uniform; -1 if unset @property (nonatomic) CGFloat paddingTop; // -1 = use uniform padding @property (nonatomic) CGFloat paddingRight; // -1 = use uniform padding @property (nonatomic) CGFloat paddingBottom; // -1 = use uniform padding @property (nonatomic) CGFloat paddingLeft; // -1 = use uniform padding // Text / Button @property (nonatomic, copy, nullable) NSString* text; @property (nonatomic) CGFloat textSize; @property (nonatomic, strong, nullable) UIColor* textColor; // Tap @property (nonatomic, copy, nullable) void (^onTap)(void); // Value-bearing change callbacks (set by dala_nif.m; called by SwiftUI) @property (nonatomic, copy, nullable) void (^onChangeStr)(NSString*); @property (nonatomic, copy, nullable) void (^onChangeBool)(BOOL); @property (nonatomic, copy, nullable) void (^onChangeFloat)(double); // Selection (pickers, menus, segmented controls) @property (nonatomic, copy, nullable) void (^onSelect)(void); // Gestures (Batch 4) — set by dala_nif.m via tap-handle registration. // SwiftUI side wires these through .onLongPressGesture, .gesture(TapGesture(count:2)), // .gesture(DragGesture(...)). Each is opt-in (nil = no gesture recognizer). @property (nonatomic, copy, nullable) void (^onLongPress)(void); @property (nonatomic, copy, nullable) void (^onDoubleTap)(void); @property (nonatomic, copy, nullable) void (^onSwipe)(NSString* direction); @property (nonatomic, copy, nullable) void (^onSwipeLeft)(void); @property (nonatomic, copy, nullable) void (^onSwipeRight)(void); @property (nonatomic, copy, nullable) void (^onSwipeUp)(void); @property (nonatomic, copy, nullable) void (^onSwipeDown)(void); // ── Batch 5 Tier 1: high-frequency scroll/drag/pinch/rotate/pointer ── // These callbacks are wired by dala_nif.m. Throttling and delta-thresholding // happen native-side BEFORE invocation — by the time these fire, the BEAM // crossing is already justified. Apps SHOULD NOT throttle in the closure. // // Scroll: SwiftUI .onScrollGeometryChange (iOS 17+) or UIScrollView delegate. // (CGFloat dx, CGFloat dy, CGFloat x, CGFloat y, CGFloat vx, CGFloat vy, NSString phase) @property (nonatomic, copy, nullable) void (^onScroll)(CGFloat, CGFloat, CGFloat, CGFloat, CGFloat, CGFloat, NSString*); // Drag: pan gesture deltas. // (CGFloat dx, CGFloat dy, CGFloat x, CGFloat y, NSString phase) @property (nonatomic, copy, nullable) void (^onDrag)(CGFloat, CGFloat, CGFloat, CGFloat, NSString*); // Pinch: scale + velocity. (CGFloat scale, CGFloat velocity, NSString phase) @property (nonatomic, copy, nullable) void (^onPinch)(CGFloat, CGFloat, NSString*); // Rotate: angle in degrees + velocity. (CGFloat degrees, CGFloat velocity, NSString phase) @property (nonatomic, copy, nullable) void (^onRotate)(CGFloat, CGFloat, NSString*); // Pointer move (iPad trackpad / Apple Pencil hover). // (CGFloat x, CGFloat y) @property (nonatomic, copy, nullable) void (^onPointerMove)(CGFloat, CGFloat); // ── Batch 5 Tier 2: semantic scroll events (single-fire) ── @property (nonatomic, copy, nullable) void (^onScrollBegan)(void); @property (nonatomic, copy, nullable) void (^onScrollEnded)(void); @property (nonatomic, copy, nullable) void (^onScrollSettled)(void); @property (nonatomic, copy, nullable) void (^onTopReached)(void); @property (nonatomic, copy, nullable) void (^onScrolledPast)(void); @property (nonatomic) CGFloat scrolledPastThreshold; // y boundary // ── Batch 5 Tier 3: native-side scroll-driven UI ── // Each is a config dict (decoded from JSON). The SwiftUI view layer reads // these and wires them up using .scrollPosition / .onScrollGeometryChange // observers without going through the BEAM. nil = not configured. @property (nonatomic, strong, nullable) NSDictionary* parallaxConfig; @property (nonatomic, strong, nullable) NSDictionary* fadeOnScrollConfig; @property (nonatomic, strong, nullable) NSDictionary* stickyWhenScrolledPastConfig; // text_field @property (nonatomic, copy, nullable) NSString* placeholder; @property (nonatomic, copy, nonnull) NSString* keyboardTypeStr; // "default","number","decimal","email","phone","url" @property (nonatomic, copy, nonnull) NSString* returnKeyStr; // "done","next","go","search","send" @property (nonatomic, copy, nullable) void (^onFocus)(void); @property (nonatomic, copy, nullable) void (^onBlur)(void); @property (nonatomic, copy, nullable) void (^onSubmit)(void); // IME composition (CJK, Korean, Vietnamese, accent input). Called by // the iOS text-input layer when marked-text state changes. // text: the in-progress (or committed) text // phase: "began" | "updating" | "committed" | "cancelled" @property (nonatomic, copy, nullable) void (^onCompose)(NSString* text, NSString* phase); // toggle @property (nonatomic) BOOL checked; // slider @property (nonatomic) CGFloat minValue; // default 0.0 @property (nonatomic) CGFloat maxValue; // default 1.0 // Divider @property (nonatomic) CGFloat thickness; // default 1.0 // Scroll @property (nonatomic, copy, nonnull) NSString* axis; // "vertical" | "horizontal" @property (nonatomic) BOOL showIndicator; // default YES // Spacer — fixedSize == 0 means fill available space @property (nonatomic) CGFloat fixedSize; // Progress — NaN means indeterminate @property (nonatomic) CGFloat value; @property (nonatomic, strong, nullable) UIColor* color; // track / indicator color // Layout behaviour @property (nonatomic) BOOL fillWidth; // fill parent width (default NO; button default YES) @property (nonatomic) CGFloat cornerRadius; // rounded corners in pt (default 0) @property (nonatomic) CGFloat gap; // spacing between children in VStack/HStack (default 0) @property (nonatomic) BOOL disabled; // disables interaction (default NO) // Border (currently honored on box). Both must be set for a border to draw. @property (nonatomic, strong, nullable) UIColor* borderColor; @property (nonatomic) CGFloat borderWidth; // pt; default 0 = no border // image @property (nonatomic, copy, nullable) NSString* src; @property (nonatomic, copy, nonnull) NSString* contentModeStr; // "fit" | "fill" | "stretch" @property (nonatomic) CGFloat fixedWidth; // 0 = fill available @property (nonatomic) CGFloat fixedHeight; // 0 = auto @property (nonatomic, strong, nullable) UIColor* placeholderColor; // Typography @property (nonatomic, copy, nullable) NSString* fontFamily; // nil = system font @property (nonatomic, copy, nonnull) NSString* fontWeight; // "regular","medium","semibold","bold","light","thin" @property (nonatomic, copy, nonnull) NSString* textAlign; // "left","center","right" @property (nonatomic) BOOL italic; @property (nonatomic) CGFloat lineHeight; // multiplier; 0 = default @property (nonatomic) CGFloat letterSpacing; // Tab bar @property (nonatomic, strong, nullable) NSArray* tabDefs; // array of NSDictionary, each with id/label/icon @property (nonatomic, copy, nullable) NSString* activeTab; // selected tab id @property (nonatomic, copy, nullable) void (^onTabSelect)(NSString*); // sends selected tab id as string // Video player @property (nonatomic) BOOL videoAutoplay; @property (nonatomic) BOOL videoLoop; @property (nonatomic) BOOL videoControls; // Camera preview @property (nonatomic, copy, nonnull) NSString* cameraFacing; // "back" | "front" // WebView @property (nonatomic, copy, nullable) NSString* webViewUrl; // URL to load @property (nonatomic, copy, nullable) NSString* webViewAllow; // comma-separated allowed URL prefixes @property (nonatomic) BOOL webViewShowUrl; @property (nonatomic, copy, nullable) NSString* webViewTitle; // static title label; overrides show_url // NativeView — rendered by DalaNativeViewRegistry @property (nonatomic, copy, nullable) NSString* nativeViewModule; // registry key (e.g. "MyApp_ChartComponent") @property (nonatomic, copy, nullable) NSString* nativeViewId; // user-assigned id @property (nonatomic) int nativeViewHandle; // NIF component handle for event callbacks @property (nonatomic, strong, nullable) NSDictionary* nativeViewProps; // full props dict forwarded to the factory // Accessibility — set from the tap tag atom name; read by XCTest / ui_describe_all @property (nonatomic, copy, nullable) NSString* accessibilityId; // Icon — logical name resolved to an SF Symbol on iOS / Material Symbol // on Android. textSize and textColor control glyph sizing + tint. @property (nonatomic, copy, nullable) NSString* iconName; // Children @property (nonatomic, strong, nonnull) NSMutableArray* children; // Unique identifier for SwiftUI ForEach stability @property (nonatomic, copy, nonnull) NSString* nodeId; /// Create a DalaNode tree from a parsed JSON dictionary (Elixir map → NSDictionary). /// Returns nil if the dictionary is malformed. + (nullable instancetype)fromDictionary:(nonnull NSDictionary*)dict; @end NS_ASSUME_NONNULL_END