@symbiote-native/angular 0.6.0 → 0.6.2

package/build/host-instance/index.js

@@ -1,36 +0,0 @@
-// findNodeHandle, the Angular twin of adapters/react/src/host-instance.ts and
-// adapters/vue/src/host-instance/index.ts. RN's "ref/instance -> native reactTag" lookup,
-// the seam imperative-interop libraries reach through.
-//
-// Angular template refs on a primitive host (`<View #myView>`) receive the component instance,
-// not the raw engine node. SymbiotePrimitiveHost exposes `nativeElement`, which holds the
-// engine host node that `getNativeTag` is keyed on. This adapter accepts:
-//   - a bare number (idempotent)
-//   - an engine host node / public instance
-//   - an Angular ElementRef wrapping the host node
-//   - a SymbiotePrimitiveHost component instance (via its public `nativeElement` getter)
-//   - null/undefined -> null
-// An uncommitted or unknown input surfaces as null.
-import { ElementRef } from '@angular/core';
-import { getNativeTag, isSymbioteNode } from '@symbiote-native/engine';
-function resolveHostNode(candidate) {
-    if (candidate === null || candidate === undefined)
-        return null;
-    if (isSymbioteNode(candidate))
-        return candidate;
-    if (candidate instanceof ElementRef)
-        return resolveHostNode(candidate.nativeElement);
-    const maybeHost = candidate;
-    if (typeof maybeHost.nativeElement !== 'undefined') {
-        return resolveHostNode(maybeHost.nativeElement);
-    }
-    return null;
-}
-export function findNodeHandle(componentOrHandle) {
-    if (componentOrHandle === null || componentOrHandle === undefined)
-        return null;
-    if (typeof componentOrHandle === 'number')
-        return componentOrHandle;
-    const node = resolveHostNode(componentOrHandle);
-    return node ? (getNativeTag(node) ?? null) : null;
-}

package/build/index.d.ts

@@ -1,21 +0,0 @@
-export { ActivityIndicator, anchorHostStyle, Button, FlatList, HorizontalScrollContentView, HorizontalScrollView, Image, ImageBackground, InputAccessoryView, KeyboardAvoidingView, Modal, Pressable, RefreshControl, SafeAreaView, ScrollContentView, ScrollView, ScrollViewStickyHeader, SectionList, stableAnchorStyle, Switch, SymbioteHostPropsDirective, Text, TextInput, TouchableHighlight, TouchableNativeFeedback, TouchableOpacity, TouchableWithoutFeedback, View, VirtualizedList, VirtualizedSectionList, VListEmptyDirective, VListFooterDirective, VListHeaderDirective, VListItemDirective, VListSeparatorDirective, VSectionFooterDirective, VSectionHeaderDirective, VSectionItemDirective, VSectionSeparatorDirective, } from './components';
-export { Animated } from './modules/animated';
-export { AnimatedFlatList, AnimatedImage, AnimatedScrollView, AnimatedSectionList, AnimatedText, AnimatedView, } from './modules/animated';
-export type { IActivityIndicatorProps, IAngularImageBackgroundProps, IAngularInputAccessoryViewProps, IAngularKeyboardAvoidingViewProps, IAngularModalProps, IAngularPressableProps, IAngularRefreshControlProps, IAngularSafeAreaViewProps, IAngularScrollViewProps, IAngularTextInputProps, IAngularTouchableHighlightProps, IAngularTouchableNativeFeedbackProps, IAngularTouchableOpacityProps, IAngularTouchableWithoutFeedbackProps, IButtonProps, ICellLayout, IFlatListHandle, IFlatListProps, IEnterKeyHint, IImageCacheStatus, IImageProps, IImageSize, IImageSource, IImageSourceProp, IInputMode, IKeyboardAvoidingBehavior, IModalAnimationType, IModalOrientation, IModalOrientationChangeEvent, IModalPresentationStyle, INativeFeedbackBackground, IResizeMode, IRippleBackground, IScrollViewHandle, ISectionListHandle, ISectionListProps, ISeparatorProps, ISeparators, IStickyHeaderComponentType, ISubmitBehavior, IThemeAttrBackground, IViewabilityConfig, IViewabilityConfigCallbackPair, IViewableItemsChangedInfo, IViewToken, IVirtualizedListHandle, IVirtualizedListProps, IVirtualizedSectionListHandle, IVirtualizedSectionListProps, IVListItemContext, IVListSeparatorContext, IVSectionContext, IVSectionItemContext, ISection, ISwitchProps, ISwitchTrackColor, ITextInputHandle, ITextInputSelection, } from './components';
-export { setImageSourceResolver } from './components';
-export { mount, unmount } from './render';
-export { DescriptorOutlet } from './descriptor-to-angular';
-export { PortalDirective, PortalOutletDirective } from './create-portal';
-export { createTunnel, TunnelInDirective, TunnelOut, type ITunnelStore } from './create-tunnel';
-export { registerComposedComponent, SymbioteRenderer, SymbioteRendererFactory } from './renderer';
-export { findNodeHandle } from './host-instance';
-export type { IHostInstance } from './host-instance';
-export { StatusBar } from './modules/status-bar';
-export type { IStatusBarProps, IStatusBarStyle } from './modules/status-bar';
-export { AppRegistry, setHostRegistrar } from './modules/app-registry';
-export type { IComponentProvider, IAppParameters, IRunnable, IHostRegistrar, IWrapperComponentProvider, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './modules/app-registry';
-export { ColorSchemeService, WindowDimensionsService } from './services';
-export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, AccessibilityInfo, LayoutAnimation, InteractionManager, PanResponder, PixelRatio, PlatformColor, DynamicColorIOS, } from '@symbiote-native/engine';
-export type { IAlertType, IAlertButtonStyle, IAlertButton, IAlertButtons, IAlertOptions, IShareContent, IShareOptions, IShareAction, IActionSheetIOSOptions, IShareActionSheetIOSOptions, IShareActionSheetError, IUrlEvent, II18nManagerConstants, IDisplayMetrics, IDisplayMetricsAndroid, IDimensionsPayload, IDimensionsSet, IDimensionsKey, IDimensionsChangeListener, IDimensionsStatic, IColorSchemeName, IColorSchemePreference, IAppStateStatus, IAppStateEvent, IKeyboardEventName, IKeyboardEvent, IKeyboardMetrics, IBackPressEventName, IBackPressHandler, IPermission, IPermissionStatus, IRationale, IAccessibilityChangeEvent, IAccessibilityChangeEventName, IAccessibilityChangeEventHandler, IAccessibilityAnnouncementFinishedEvent, IAnnounceForAccessibilityOptions, IAccessibilityEventType, ILayoutAnimationType, ILayoutAnimationProperty, ILayoutAnimationConfig, ILayoutAnimationAnim, IInteractionEvent, ISimpleTask, IPromiseTask, ITask, IHandle, IPanResponderGestureState, IPanResponderCallbacks, IGestureResponderHandlers, IPanResponderInstance, IPixelRatioStatic, IColorValue, IOpaqueColorValue, IDynamicColorIOSTuple, } from '@symbiote-native/engine';
-export { dlog, flattenStyle, isDebug, Platform, processColor, setColorProcessor, setDeviceEventSource, setNativeViewConfigSource, StyleSheet, } from '@symbiote-native/engine';
-export type { IRootTag, ISymbioteEvent, ISymbioteNode } from '@symbiote-native/engine';

package/build/index.js

@@ -1,40 +0,0 @@
-// @symbiote-native/angular: a thin Angular reconciler over @symbiote-native/engine. A custom Renderer2 +
-// RendererFactory2 map each node op onto the engine's mutation API; all Fabric clone-on-write
-// lives in the engine, shared with every other adapter. App code names only @symbiote-native/angular.
-//
-// SEAM SCAFFOLD: mount/unmount + the renderer seam + host intrinsic selectors. Full RN-like
-// composed components still flow through the shared @symbiote-native/components bridge.
-export { ActivityIndicator, anchorHostStyle, Button, FlatList, HorizontalScrollContentView, HorizontalScrollView, Image, ImageBackground, InputAccessoryView, KeyboardAvoidingView, Modal, Pressable, RefreshControl, SafeAreaView, ScrollContentView, ScrollView, ScrollViewStickyHeader, SectionList, stableAnchorStyle, Switch, SymbioteHostPropsDirective, Text, TextInput, TouchableHighlight, TouchableNativeFeedback, TouchableOpacity, TouchableWithoutFeedback, View, VirtualizedList, VirtualizedSectionList, VListEmptyDirective, VListFooterDirective, VListHeaderDirective, VListItemDirective, VListSeparatorDirective, VSectionFooterDirective, VSectionHeaderDirective, VSectionItemDirective, VSectionSeparatorDirective, } from './components';
-export { Animated } from './modules/animated';
-// Also exposed as named top-level symbols (not just Animated.View/.Text/...): ngtsc's partial-mode
-// static evaluator can't trace a component class through property access on an external
-// namespace object, only through a direct named import binding —
-// so `<AnimatedView>` in a template requires `import { AnimatedView } from '@symbiote-native/angular'`,
-// not `const AnimatedView = Animated.View`. Plain tsc/vitest don't catch this; only a real ngc run does.
-export { AnimatedFlatList, AnimatedImage, AnimatedScrollView, AnimatedSectionList, AnimatedText, AnimatedView, } from './modules/animated';
-export { setImageSourceResolver } from './components';
-export { mount, unmount } from './render';
-// The generic Descriptor→Angular bridge, the twin of descriptorToReact/descriptorToVue.
-// Exported so a component defined OUTSIDE this package (e.g.
-// @symbiote-native/slider) can render a shared @symbiote-native/components/@symbiote-native/slider Descriptor tree
-// without hand-writing its own Renderer2 walker.
-export { DescriptorOutlet } from './descriptor-to-angular';
-// createPortal (same-surface only — see the file header) and createTunnel (cross-surface,
-// see its file header) are the Angular twins of the React/Vue portal/tunnel primitives.
-// Angular can't synthesize components at runtime (no JIT under Metro/Hermes), so both are
-// static, pre-authored structural directives (`*portal`/`*tunnelIn`, the `*ngIf`/`*ngFor`
-// idiom) parameterized by an `@Input()`, rather than a factory returning fresh components per
-// call.
-export { PortalDirective, PortalOutletDirective } from './create-portal';
-export { createTunnel, TunnelInDirective, TunnelOut } from './create-tunnel';
-export { registerComposedComponent, SymbioteRenderer, SymbioteRendererFactory } from './renderer';
-export { findNodeHandle } from './host-instance';
-export { StatusBar } from './modules/status-bar';
-// AppRegistry: RN's app entry point over `mount`. setHostRegistrar wires RN's own
-// registrar so the native Fabric host finds our runnable by app key.
-export { AppRegistry, setHostRegistrar } from './modules/app-registry';
-export { ColorSchemeService, WindowDimensionsService } from './services';
-// Framework-agnostic runtime modules from @symbiote-native/engine. Every adapter re-exports them so
-// app code names only @symbiote-native/angular.
-export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, AccessibilityInfo, LayoutAnimation, InteractionManager, PanResponder, PixelRatio, PlatformColor, DynamicColorIOS, } from '@symbiote-native/engine';
-export { dlog, flattenStyle, isDebug, Platform, processColor, setColorProcessor, setDeviceEventSource, setNativeViewConfigSource, StyleSheet, } from '@symbiote-native/engine';

package/build/modules/animated/animated-leaf-binder/index.d.ts

@@ -1,14 +0,0 @@
-import { type ISymbioteNode } from '@symbiote-native/engine';
-export declare class AnimatedLeafBinder {
-    private readonly resolveNode;
-    private readonly label;
-    private attached;
-    private cancelBind;
-    private eventDetachers;
-    constructor(resolveNode: () => ISymbioteNode | null, label: string);
-    reconcile(props: Record<string, unknown>, wantsNative: boolean): void;
-    private bindNode;
-    private attachEvents;
-    private detachEvents;
-    destroy(): void;
-}

package/build/modules/animated/animated-leaf-binder/index.js

@@ -1,90 +0,0 @@
-// Pure Fabrication (GRASP): the leaf-lifecycle orchestration shared by every Animated*
-// wrapper, extracted out of AnimatedComponentBase so AnimatedImage — which cannot extend
-// AnimatedComponentBase, since it must extend ImageBase for TS's-native image handling —
-// gets the SAME logic via composition instead of copy-pasting it. Framework-thin on
-// purpose: it knows nothing about Angular (@ViewChild, DI, change detection), only the
-// engine's Animated leaf + commit primitives, so it stays testable without any Angular
-// bootstrap. NOTE: react/vue drive this same dance through their own runtime HOC
-// (createAnimatedComponent) rather than a class, so there is no cross-adapter dedup
-// opportunity here yet — this Pure Fabrication is local to the angular adapter.
-import { AnimatedProps, attachNativeEventHandler, dlog, whenCommitted, } from '@symbiote-native/engine';
-export class AnimatedLeafBinder {
-    resolveNode;
-    label;
-    // The leaf currently wired into the value graph. Null until the first reconcile.
-    attached = null;
-    // The whenCommitted waiter for the current leaf's node binding, cancelled before the next.
-    cancelBind;
-    // Detachers for any Animated.event prop bound natively to the committed node (JS path: none).
-    eventDetachers = [];
-    // `resolveNode` stays a caller-supplied resolver (not a constructor-captured node) so this
-    // class never needs to know HOW the host node is found — AnimatedComponentBase and
-    // AnimatedImage both resolve it the same way (resolveHostNode + isSymbioteNode over their
-    // own @ViewChild), but that's Angular DI state this binder has no business touching.
-    // `label` is purely diagnostic (dlog), mirroring the constructor.name the pre-extraction
-    // dlog call used.
-    constructor(resolveNode, label) {
-        this.resolveNode = resolveNode;
-        this.label = label;
-    }
-    // Build a fresh AnimatedProps leaf from the current props (the React/Vue per-render
-    // useMemo(rest)), wire it into the graph, and swap the previous one out. Attach the NEW leaf
-    // BEFORE detaching the OLD one: a shared Value self-detaches (dropping its native node) the
-    // instant its child count hits zero, so detaching first would kill a running native animation
-    // on any unrelated re-render (mirrors RN's AnimatedComponent._attachProps). Then bind the
-    // committed node, go native if wanted, and rebind native events.
-    reconcile(props, wantsNative) {
-        dlog(`${this.label} reconcile`);
-        const newLeaf = new AnimatedProps(props);
-        newLeaf.__attach();
-        if (this.attached !== null && this.attached !== newLeaf)
-            this.attached.__detach();
-        this.attached = newLeaf;
-        this.bindNode(newLeaf, props, wantsNative);
-    }
-    // Bind the leaf to the host's Fabric node THROUGH whenCommitted: under Angular's zoneless
-    // batched change detection the inner host's tag does not exist yet at ngAfterViewInit time
-    // (the same async-commit gotcha Vue documents), so binding eagerly would no-op. whenCommitted
-    // runs the action now if already committed, else after the commit that assigns the tag.
-    bindNode(leaf, props, wantsNative) {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        const node = this.resolveNode();
-        if (node === null)
-            return;
-        this.cancelBind = whenCommitted(node, () => {
-            leaf.setNativeView(node);
-            if (wantsNative)
-                leaf.__makeNative();
-            this.attachEvents(node, props);
-        });
-    }
-    // Native-attach any Animated.event prop (e.g. onScroll={Animated.event(…,{useNativeDriver:true})})
-    // to the committed node. attachNativeEventHandler no-ops (returns undefined) unless the prop is a
-    // native event handler with a committed tag, so the JS path stays the fallback. Rebound each
-    // reconcile so a new inline event re-attaches; detached first to avoid leaking the prior binding.
-    attachEvents(node, props) {
-        this.detachEvents();
-        for (const key of Object.keys(props)) {
-            const attachment = attachNativeEventHandler(node, key, props[key]);
-            if (attachment !== undefined)
-                this.eventDetachers.push(attachment.detach);
-        }
-    }
-    detachEvents() {
-        for (const detach of this.eventDetachers)
-            detach();
-        this.eventDetachers = [];
-    }
-    // Tear down everything: cancel a still-pending bind, drop native event listeners, detach the
-    // current leaf from the value graph. Safe to call even if reconcile() was never called.
-    destroy() {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        this.detachEvents();
-        if (this.attached !== null) {
-            this.attached.__detach();
-            this.attached = null;
-        }
-    }
-}

package/build/modules/animated/animated-leaf-binder.d.ts

@@ -1,14 +0,0 @@
-import { type ISymbioteNode } from '@symbiote-native/engine';
-export declare class AnimatedLeafBinder {
-    private readonly resolveNode;
-    private readonly label;
-    private attached;
-    private cancelBind;
-    private eventDetachers;
-    constructor(resolveNode: () => ISymbioteNode | null, label: string);
-    reconcile(props: Record<string, unknown>, wantsNative: boolean): void;
-    private bindNode;
-    private attachEvents;
-    private detachEvents;
-    destroy(): void;
-}

package/build/modules/animated/animated-leaf-binder.js

@@ -1,90 +0,0 @@
-// Pure Fabrication (GRASP): the leaf-lifecycle orchestration shared by every Animated*
-// wrapper, extracted out of AnimatedComponentBase so AnimatedImage — which cannot extend
-// AnimatedComponentBase, since it must extend ImageBase for TS's-native image handling —
-// gets the SAME logic via composition instead of copy-pasting it. Framework-thin on
-// purpose: it knows nothing about Angular (@ViewChild, DI, change detection), only the
-// engine's Animated leaf + commit primitives, so it stays testable without any Angular
-// bootstrap. NOTE: react/vue drive this same dance through their own runtime HOC
-// (createAnimatedComponent) rather than a class, so there is no cross-adapter dedup
-// opportunity here yet — this Pure Fabrication is local to the angular adapter.
-import { AnimatedProps, attachNativeEventHandler, dlog, whenCommitted, } from '@symbiote-native/engine';
-export class AnimatedLeafBinder {
-    resolveNode;
-    label;
-    // The leaf currently wired into the value graph. Null until the first reconcile.
-    attached = null;
-    // The whenCommitted waiter for the current leaf's node binding, cancelled before the next.
-    cancelBind;
-    // Detachers for any Animated.event prop bound natively to the committed node (JS path: none).
-    eventDetachers = [];
-    // `resolveNode` stays a caller-supplied resolver (not a constructor-captured node) so this
-    // class never needs to know HOW the host node is found — AnimatedComponentBase and
-    // AnimatedImage both resolve it the same way (resolveHostNode + isSymbioteNode over their
-    // own @ViewChild), but that's Angular DI state this binder has no business touching.
-    // `label` is purely diagnostic (dlog), mirroring the constructor.name the pre-extraction
-    // dlog call used.
-    constructor(resolveNode, label) {
-        this.resolveNode = resolveNode;
-        this.label = label;
-    }
-    // Build a fresh AnimatedProps leaf from the current props (the React/Vue per-render
-    // useMemo(rest)), wire it into the graph, and swap the previous one out. Attach the NEW leaf
-    // BEFORE detaching the OLD one: a shared Value self-detaches (dropping its native node) the
-    // instant its child count hits zero, so detaching first would kill a running native animation
-    // on any unrelated re-render (mirrors RN's AnimatedComponent._attachProps). Then bind the
-    // committed node, go native if wanted, and rebind native events.
-    reconcile(props, wantsNative) {
-        dlog(`${this.label} reconcile`);
-        const newLeaf = new AnimatedProps(props);
-        newLeaf.__attach();
-        if (this.attached !== null && this.attached !== newLeaf)
-            this.attached.__detach();
-        this.attached = newLeaf;
-        this.bindNode(newLeaf, props, wantsNative);
-    }
-    // Bind the leaf to the host's Fabric node THROUGH whenCommitted: under Angular's zoneless
-    // batched change detection the inner host's tag does not exist yet at ngAfterViewInit time
-    // (the same async-commit gotcha Vue documents), so binding eagerly would no-op. whenCommitted
-    // runs the action now if already committed, else after the commit that assigns the tag.
-    bindNode(leaf, props, wantsNative) {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        const node = this.resolveNode();
-        if (node === null)
-            return;
-        this.cancelBind = whenCommitted(node, () => {
-            leaf.setNativeView(node);
-            if (wantsNative)
-                leaf.__makeNative();
-            this.attachEvents(node, props);
-        });
-    }
-    // Native-attach any Animated.event prop (e.g. onScroll={Animated.event(…,{useNativeDriver:true})})
-    // to the committed node. attachNativeEventHandler no-ops (returns undefined) unless the prop is a
-    // native event handler with a committed tag, so the JS path stays the fallback. Rebound each
-    // reconcile so a new inline event re-attaches; detached first to avoid leaking the prior binding.
-    attachEvents(node, props) {
-        this.detachEvents();
-        for (const key of Object.keys(props)) {
-            const attachment = attachNativeEventHandler(node, key, props[key]);
-            if (attachment !== undefined)
-                this.eventDetachers.push(attachment.detach);
-        }
-    }
-    detachEvents() {
-        for (const detach of this.eventDetachers)
-            detach();
-        this.eventDetachers = [];
-    }
-    // Tear down everything: cancel a still-pending bind, drop native event listeners, detach the
-    // current leaf from the value graph. Safe to call even if reconcile() was never called.
-    destroy() {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        this.detachEvents();
-        if (this.attached !== null) {
-            this.attached.__detach();
-            this.attached = null;
-        }
-    }
-}

package/build/modules/animated/create-animated-component.d.ts

@@ -1,48 +0,0 @@
-import { type AfterViewInit, type OnChanges, type OnDestroy, type Type } from '@angular/core';
-import { FlatList } from '../../components/flat-list';
-import { ImageBase } from '../../components/image/shared';
-import { SectionList } from '../../components/section-list';
-export declare const ANIMATED_INPUTS: string[];
-export declare const ANIMATED_IMAGE_INPUTS: string[];
-export declare abstract class AnimatedComponentBase implements AfterViewInit, OnChanges, OnDestroy {
-    style: unknown;
-    animatedProps: Record<string, unknown> | undefined;
-    passthroughAnimatedPropExplicitValues: unknown;
-    private readonly elementRef;
-    private hostDirective?;
-    private readonly leafBinder;
-    private viewReady;
-    get reducedProps(): Record<string, unknown>;
-    ngAfterViewInit(): void;
-    ngOnChanges(): void;
-    ngOnDestroy(): void;
-    private reconcile;
-    private mergedProps;
-    private hostNode;
-}
-export declare class AnimatedView extends AnimatedComponentBase {
-}
-export declare class AnimatedText extends AnimatedComponentBase {
-}
-export declare class AnimatedImage extends ImageBase implements AfterViewInit, OnChanges, OnDestroy {
-    animatedProps: Record<string, unknown> | undefined;
-    passthroughAnimatedPropExplicitValues: unknown;
-    private readonly elementRef;
-    private hostDirective?;
-    private readonly leafBinder;
-    private viewReady;
-    get animatedImageProps(): Record<string, unknown>;
-    ngAfterViewInit(): void;
-    ngOnChanges(): void;
-    ngOnDestroy(): void;
-    private reconcile;
-    private mergedProps;
-    private hostNode;
-}
-export declare class AnimatedScrollView extends AnimatedComponentBase {
-    get reducedProps(): Record<string, unknown>;
-    get contentProps(): Record<string, unknown>;
-}
-export declare const AnimatedFlatList: typeof FlatList;
-export declare const AnimatedSectionList: typeof SectionList;
-export declare function createAnimatedComponent(base: unknown): Type<unknown>;