@symbiote-native/angular 1.0.0 → 2.0.1

package/src/components/scroll-view/sticky-header.ts

@@ -1,267 +0,0 @@
-// Sticky headers: RN does stickiness PURELY IN JS (ScrollView.js / ScrollViewStickyHeader.js).
-// A single `_scrollAnimatedValue` an Animated.event drives from `onScroll` feeds each flagged
-// header's translateY through an interpolation that pins it to the top (or bottom, inverted)
-// until the next header collides with it — the native Fabric scroll view does NOT honor
-// `stickyHeaderIndices` on its own. The interpolation math (computeStickyInterpolation) lives
-// framework-agnostic in @symbiote-native/components, shared verbatim with React/Vue; this file
-// holds the Angular component shell, layout state, and interpolation build.
-//
-// This is the public sticky-header WRAPPER for explicit composition. ScrollView also auto-wraps
-// projected children named by stickyHeaderIndices through its projection bridge (projection.ts),
-// because Angular templates cannot map <ng-content> children directly; that auto path
-// intentionally reuses this built-in wrapper rather than instantiating arbitrary component types.
-
-import {
-  ChangeDetectionStrategy,
-  ChangeDetectorRef,
-  Component,
-  ElementRef,
-  EventEmitter,
-  Input,
-  Output,
-  inject,
-  type OnChanges,
-  type OnDestroy,
-  type OnInit,
-} from '@angular/core';
-import {
-  type AnimatedInterpolation,
-  AnimatedValue,
-  Platform,
-  dlog,
-  type ISymbioteEvent,
-} from '@symbiote-native/engine';
-import {
-  createInitialStickyState,
-  readLayoutNumber,
-  reduceSticky,
-  STICKY_HEADER_Z_INDEX,
-  type IStickyAction,
-  type IStickyEffect,
-  type IStickyHeaderProps,
-  type IStickyReducerInputs,
-} from '@symbiote-native/components';
-import { AnimatedView } from '../../modules/animated';
-import { anchorHostStyle } from '../../primitives';
-
-// A custom sticky wrapper must accept the same shape the built-in does: the IStickyHeaderProps
-// fields as inputs + the wrapped child via <ng-content>. Unlike React/Vue, Angular ScrollView cannot
-// AOT-safely instantiate an arbitrary component Type while auto-projecting stickyHeaderIndices,
-// because that renderer-level bridge only sees committed engine nodes, not a ViewContainerRef with
-// Angular projectable nodes. This type remains public for explicit composition: compose your wrapper
-// around <ScrollViewStickyHeader>/<symbiote-sticky-header> in the template when custom visuals are
-// needed. Auto projection intentionally uses the built-in wrapper.
-export type IStickyHeaderComponentType = unknown;
-
-// One sticky header. Measures its own y/height via onLayout, interpolates the shared scroll offset
-// into a translateY that keeps it pinned to the top (or bottom, inverted) until the next header
-// collides with it, and drives that translate through the native driver when available so the pin
-// tracks scroll on the UI thread (no JS jitter). Ported from ScrollViewStickyHeader.js, including
-// the Fabric ShadowTree debounce path. The inputs (scrollAnimatedValue/nextHeaderLayoutY/…) never
-// reach the host node: they configure the interpolation; only the resolved transform reaches
-// AnimatedView (a scrollAnimatedValue on a host node would crash Android's folly::dynamic).
-@Component({
-  selector: 'ScrollViewStickyHeader, symbiote-sticky-header',
-  standalone: true,
-  imports: [AnimatedView],
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: `
-    <AnimatedView
-      [style]="headerStyle"
-      [animatedProps]="headerAnimatedProps"
-      [passthroughAnimatedPropExplicitValues]="passthrough"
-    >
-      <ng-content></ng-content>
-    </AnimatedView>
-  `,
-})
-export class ScrollViewStickyHeader
-  implements Omit<IStickyHeaderProps, 'onLayout'>, OnInit, OnChanges, OnDestroy
-{
-  // A fresh fallback AnimatedValue keeps the component working if the parent ever fails to supply
-  // one (the wrap invariant); held by IDENTITY in a plain field (Angular does not proxy fields).
-  @Input() scrollAnimatedValue: AnimatedValue = new AnimatedValue(0);
-  @Input() nextHeaderLayoutY: number | undefined = undefined;
-  @Input() inverted: boolean | undefined = undefined;
-  @Input() scrollViewHeight: number | undefined = undefined;
-  // The parent's layout recorder (RN _onStickyHeaderLayout): records this header's own y so the
-  // previous header learns its collision point. Called after the header measures.
-  @Output() readonly layout = new EventEmitter<ISymbioteEvent>();
-
-  // The one folded state cell, mutated in place by reduceSticky. The DECISIONS — zero-swallow gate,
-  // debounce delay, rebuild ranges — all live there; this component supplies only the Angular
-  // lifecycle (inputs + manual change detection), the interpolation-node + listener wiring, the
-  // debounce setTimeout, and the markForCheck re-render.
-  private readonly state = createInitialStickyState();
-  // The animated node driving the transform (RN's animatedTranslateY), replaced by the
-  // rebuild-interpolation effect. When the scroll value is native, this interpolation runs on the UI
-  // thread: the smooth pin.
-  private animatedTranslateY: AnimatedInterpolation = new AnimatedValue(
-    0,
-  ).interpolate({
-    inputRange: [-1, 0],
-    outputRange: [0, 0],
-  });
-  // The current interpolation node + its listener id, held so the next rebuild detaches the old
-  // listener (an engine call the reducer does not own) and ngOnDestroy cleans up.
-  private interpolation: AnimatedInterpolation | undefined;
-  private debounceTimer: ReturnType<typeof setTimeout> | undefined;
-  private listenerId: string | undefined;
-
-  private readonly changeDetector = inject(ChangeDetectorRef);
-  // This component's OWN host — the non-painting anchor `class="..."` at the use site resolves
-  // onto (see anchorHostStyle's doc comment in primitives/shared.ts) — NOT the inner AnimatedView
-  // one level down.
-  private readonly elementRef = inject(ElementRef);
-
-  ngOnInit(): void {
-    this.dispatch({ kind: 'inputs-changed' });
-  }
-
-  // Rebuild on any layout/collision input change (RN's effect deps: measured, layoutY, layoutHeight,
-  // scrollViewHeight, nextHeaderLayoutY, inverted). scrollAnimatedValue is stable for one ScrollView.
-  ngOnChanges(): void {
-    this.dispatch({ kind: 'inputs-changed' });
-  }
-
-  ngOnDestroy(): void {
-    this.teardown();
-  }
-
-  get headerStyle(): unknown {
-    // collapsable:false keeps the wrapper a real Yoga node; zIndex paints the pinned header OVER the
-    // rows scrolling under it. The interpolation node rides inside the transform; AnimatedView's
-    // reduceProps rasterizes it into a numeric translateY for the committed tree. This component is
-    // its own ANCHOR_HOST_COMPONENTS entry, so a `class="..."` at its use site resolves onto
-    // `elementRef`, not the inner AnimatedView — merge it back in (anchorHostStyle's doc comment),
-    // anchor style first so the fixed transform/zIndex below still wins on conflict.
-    return [
-      anchorHostStyle(this.elementRef),
-      {
-        transform: [{ translateY: this.animatedTranslateY }],
-        zIndex: STICKY_HEADER_Z_INDEX,
-      },
-    ];
-  }
-
-  // Stable reference (bound once) so AnimatedView's directive does not re-wire the layout listener
-  // every change-detection pass.
-  private readonly onHostLayout = (event: ISymbioteEvent): void =>
-    this.handleLayout(event);
-
-  // Also a stable reference, not a getter: jsonEqual (commit.ts) can't structurally compare the
-  // embedded onLayout function, so a fresh object here would read as "props changed" on every
-  // change-detection pass and force a real Fabric re-clone that cascades up every ancestor to the
-  // root (see AnimatedComponentBase.reconcile()'s identical warning) — every unrelated press
-  // anywhere in the app, not just this header's own layout events. Not `private`: the template
-  // binds it directly (`strictTemplates` requires template-bound members stay accessible).
-  readonly headerAnimatedProps: Record<string, unknown> = {
-    onLayout: this.onHostLayout,
-    collapsable: false,
-  };
-
-  // The EXPLICIT debounced translateY overrides the committed transform for hit-testing while
-  // animatedTranslateY does the smooth (native-driven) pin (RN ScrollViewStickyHeader.js).
-  get passthrough(): {
-    style: { transform: Array<{ translateY: number }> };
-  } | null {
-    return this.state.translateY !== null
-      ? { style: { transform: [{ translateY: this.state.translateY }] } }
-      : null;
-  }
-
-  private inputs(): IStickyReducerInputs {
-    return {
-      os: Platform.OS,
-      inverted: this.inverted,
-      scrollViewHeight: this.scrollViewHeight,
-      nextHeaderLayoutY: this.nextHeaderLayoutY,
-    };
-  }
-
-  private dispatch(action: IStickyAction): void {
-    this.runEffects(reduceSticky(this.state, action, this.inputs()).effects);
-  }
-
-  private runEffects(effects: IStickyEffect[]): void {
-    for (const effect of effects) {
-      switch (effect.kind) {
-        case 'rebuild-interpolation': {
-          // Detach the old listener, build a fresh interpolation onto the shared scroll value, and
-          // wire the settled-value listener (symbiote is always Fabric; RN attaches it only there).
-          if (
-            this.interpolation !== undefined &&
-            this.listenerId !== undefined
-          ) {
-            this.interpolation.removeListener(this.listenerId);
-            this.listenerId = undefined;
-          }
-          const next = this.scrollAnimatedValue.interpolate({
-            inputRange: effect.inputRange,
-            outputRange: effect.outputRange,
-          });
-          this.listenerId = next.addListener(this.animatedValueListener);
-          this.interpolation = next;
-          this.animatedTranslateY = next;
-          dlog(
-            `STICKY[header] interpolation measured=${this.state.measured} y=${this.state.layoutY}`,
-          );
-          break;
-        }
-        case 'schedule-debounce':
-          // The animated value updates several times per frame; debounce the settled value into the
-          // committed transform so hit detection stays current (a Fabric issue, worse on Android).
-          if (this.debounceTimer !== undefined)
-            clearTimeout(this.debounceTimer);
-          this.debounceTimer = setTimeout(() => {
-            this.debounceTimer = undefined;
-            this.dispatch({ kind: 'debounce-fired', value: effect.value });
-          }, effect.delay);
-          break;
-        case 'apply-passthrough':
-          this.changeDetector.markForCheck();
-          break;
-        case 'record-header-y':
-          // The Angular header records through the `layout` EventEmitter (handleLayout below), the
-          // public recorder contract; the reducer emits no index for it.
-          break;
-      }
-    }
-  }
-
-  // Record own y/height, mark measured, rebuild the interpolation (all via the reducer), then fire
-  // the parent's recorder (RN ScrollViewStickyHeader.js._onLayout order). The wrapped child keeps its
-  // own onLayout binding (projected with its bindings intact), so unlike React/Vue we do not forward.
-  private handleLayout(event: ISymbioteEvent): void {
-    const y = readLayoutNumber(event, 'y');
-    const height = readLayoutNumber(event, 'height');
-    // Keep the previous value when a field is absent (RN sets state only on a defined read).
-    this.dispatch({
-      kind: 'layout',
-      y: y ?? this.state.layoutY,
-      height: height ?? this.state.layoutHeight,
-    });
-    this.layout.emit(event);
-    this.changeDetector.markForCheck();
-  }
-
-  private readonly animatedValueListener = ({
-    value,
-  }: {
-    value: number | string;
-  }): void => {
-    if (typeof value === 'number')
-      this.dispatch({ kind: 'animated-tick', value });
-  };
-
-  private teardown(): void {
-    if (this.interpolation !== undefined && this.listenerId !== undefined) {
-      this.interpolation.removeListener(this.listenerId);
-      this.listenerId = undefined;
-    }
-    if (this.debounceTimer !== undefined) {
-      clearTimeout(this.debounceTimer);
-      this.debounceTimer = undefined;
-    }
-  }
-}

package/src/components/switch/index.android.ts

@@ -1,113 +0,0 @@
-import {
-  CUSTOM_ELEMENTS_SCHEMA,
-  Component,
-  ElementRef,
-  forwardRef,
-  inject,
-  signal,
-  type DoCheck,
-} from '@angular/core';
-import { NG_VALUE_ACCESSOR } from '@angular/forms';
-import {
-  anchorHostStyle,
-  ManagedSwitchHost,
-  SymbioteHostPropsDirective,
-  SymbioteStyleInputDirective,
-} from '../../primitives';
-import { SwitchBase } from './shared';
-export type { ISwitchProps, ISwitchTrackColor } from './shared';
-
-@Component({
-  selector: 'Switch',
-  standalone: true,
-  hostDirectives: [
-    { directive: SymbioteStyleInputDirective, inputs: ['style'] },
-  ],
-  schemas: [CUSTOM_ELEMENTS_SCHEMA],
-  imports: [ManagedSwitchHost, SymbioteHostPropsDirective],
-  providers: [
-    {
-      provide: NG_VALUE_ACCESSOR,
-      useExisting: forwardRef(() => Switch),
-      multi: true,
-    },
-  ],
-  inputs: [
-    'value',
-    'disabled',
-    'trackColor',
-    'thumbColor',
-    'ios_backgroundColor',
-    'style',
-    'nativeID',
-    'testID',
-    'accessibilityLabel',
-    'accessibilityRole',
-    'accessibilityState',
-    'accessibilityValue',
-    'accessibilityHint',
-    'accessible',
-    'role',
-    'aria-label',
-    'aria-disabled',
-    'aria-checked',
-  ],
-  outputs: ['valueChange', 'change'],
-  template: `
-    <symbiote-switch-managed
-      #nativeSwitch="symbioteHost"
-      [symbioteHostProps]="hostProps()"
-      (change)="handleChange($event, nativeSwitch)"
-    />
-  `,
-})
-export class Switch extends SwitchBase implements DoCheck {
-  // This component's OWN host — the non-painting anchor `class="..."` at the use site resolves
-  // onto (see anchorHostStyle's doc comment) — NOT the <symbiote-switch-managed> leaf one level down.
-  private readonly elementRef = inject(ElementRef);
-
-  protected readonly platform = {
-    snapBackCommand: 'setNativeValue',
-    trackColorProps: (
-      value: boolean,
-      trackColor?: { false?: string; true?: string },
-    ) => ({
-      trackColorForFalse: trackColor?.false,
-      trackColorForTrue: trackColor?.true,
-      trackTintColor: value ? trackColor?.true : trackColor?.false,
-    }),
-  };
-
-  // The anchor's class-derived style is written by the renderer's addClass/removeClass and never
-  // reaches Angular's input pipeline (a bare `class="x"` never appears in SimpleChanges — see
-  // anchorHostStyle's doc comment), so SwitchBase's inputsRevision cannot see it. Hence its own
-  // signal: a plain field read inside a computed() would be untracked and the bag would go stale
-  // the moment a `[class.x]`/`[ngClass]` toggled.
-  //
-  // ngDoCheck is the right cadence: render3's callHooks flushes a node's pre-order hooks at the
-  // next `ɵɵadvance` past it (or in refreshView's post-template flush), i.e. AFTER the declaring
-  // template's ɵɵclassProp wrote the class onto this element and BEFORE this component's own view
-  // refreshes — the exact window a class poll needs. callHooks also runs under
-  // setActiveConsumer(null), so the write registers no dependency on the caller's view (no NG0600).
-  // commitClassStyle allocates a fresh style array only when a token actually moved, so signal.set's
-  // own Object.is check makes an unchanged poll a no-op that dirties nothing.
-  //
-  // Known gap, shared with every other component polling this way (Pressable, SafeAreaView,
-  // TouchableNativeFeedback): `[ngClass]` applies its tokens from NgClass's OWN ngDoCheck, and a
-  // node's hooks flush in registration order with the component's first, so an [ngClass] flip lands
-  // one pass after this poll reads it. `class=` and `[class.x]` are written by the declaring
-  // template's styling instructions and so are always current here.
-  private readonly anchorStyle = signal<unknown>(undefined);
-
-  ngDoCheck(): void {
-    this.anchorStyle.set(anchorHostStyle(this.elementRef));
-  }
-
-  // The anchor's class-derived style goes first, then whatever SwitchBase already resolved
-  // (its own explicit `style` @Input plus the ios_backgroundColor fold), so an explicit [style]
-  // still beats the ambient class.
-  protected override buildHostProps(): Record<string, unknown> {
-    const props = super.buildHostProps();
-    return { ...props, style: [this.anchorStyle(), props['style']] };
-  }
-}

package/src/components/switch/index.ios.ts

@@ -1,112 +0,0 @@
-import {
-  CUSTOM_ELEMENTS_SCHEMA,
-  Component,
-  ElementRef,
-  forwardRef,
-  inject,
-  signal,
-  type DoCheck,
-} from '@angular/core';
-import { NG_VALUE_ACCESSOR } from '@angular/forms';
-import {
-  anchorHostStyle,
-  ManagedSwitchHost,
-  SymbioteHostPropsDirective,
-  SymbioteStyleInputDirective,
-} from '../../primitives';
-import { SwitchBase } from './shared';
-export type { ISwitchProps, ISwitchTrackColor } from './shared';
-
-@Component({
-  selector: 'Switch',
-  standalone: true,
-  hostDirectives: [
-    { directive: SymbioteStyleInputDirective, inputs: ['style'] },
-  ],
-  schemas: [CUSTOM_ELEMENTS_SCHEMA],
-  imports: [ManagedSwitchHost, SymbioteHostPropsDirective],
-  providers: [
-    {
-      provide: NG_VALUE_ACCESSOR,
-      useExisting: forwardRef(() => Switch),
-      multi: true,
-    },
-  ],
-  inputs: [
-    'value',
-    'disabled',
-    'trackColor',
-    'thumbColor',
-    'ios_backgroundColor',
-    'style',
-    'nativeID',
-    'testID',
-    'accessibilityLabel',
-    'accessibilityRole',
-    'accessibilityState',
-    'accessibilityValue',
-    'accessibilityHint',
-    'accessible',
-    'role',
-    'aria-label',
-    'aria-disabled',
-    'aria-checked',
-  ],
-  outputs: ['valueChange', 'change'],
-  template: `
-    <symbiote-switch-managed
-      #nativeSwitch="symbioteHost"
-      [symbioteHostProps]="hostProps()"
-      (change)="handleChange($event, nativeSwitch)"
-    />
-  `,
-})
-export class Switch extends SwitchBase implements DoCheck {
-  // This component's OWN host — the non-painting anchor `class="..."` at the use site resolves
-  // onto (see anchorHostStyle's doc comment) — NOT the <symbiote-switch-managed> leaf one level down.
-  private readonly elementRef = inject(ElementRef);
-
-  protected readonly platform = {
-    snapBackCommand: 'setValue',
-    trackColorProps: (
-      _value: boolean,
-      trackColor?: { false?: string; true?: string },
-    ) => ({
-      onTintColor: trackColor?.true,
-      tintColor: trackColor?.false,
-    }),
-  };
-
-  // The anchor's class-derived style is written by the renderer's addClass/removeClass and never
-  // reaches Angular's input pipeline (a bare `class="x"` never appears in SimpleChanges — see
-  // anchorHostStyle's doc comment), so SwitchBase's inputsRevision cannot see it. Hence its own
-  // signal: a plain field read inside a computed() would be untracked and the bag would go stale
-  // the moment a `[class.x]`/`[ngClass]` toggled.
-  //
-  // ngDoCheck is the right cadence: render3's callHooks flushes a node's pre-order hooks at the
-  // next `ɵɵadvance` past it (or in refreshView's post-template flush), i.e. AFTER the declaring
-  // template's ɵɵclassProp wrote the class onto this element and BEFORE this component's own view
-  // refreshes — the exact window a class poll needs. callHooks also runs under
-  // setActiveConsumer(null), so the write registers no dependency on the caller's view (no NG0600).
-  // commitClassStyle allocates a fresh style array only when a token actually moved, so signal.set's
-  // own Object.is check makes an unchanged poll a no-op that dirties nothing.
-  //
-  // Known gap, shared with every other component polling this way (Pressable, SafeAreaView,
-  // TouchableNativeFeedback): `[ngClass]` applies its tokens from NgClass's OWN ngDoCheck, and a
-  // node's hooks flush in registration order with the component's first, so an [ngClass] flip lands
-  // one pass after this poll reads it. `class=` and `[class.x]` are written by the declaring
-  // template's styling instructions and so are always current here.
-  private readonly anchorStyle = signal<unknown>(undefined);
-
-  ngDoCheck(): void {
-    this.anchorStyle.set(anchorHostStyle(this.elementRef));
-  }
-
-  // The anchor's class-derived style goes first, then whatever SwitchBase already resolved
-  // (its own explicit `style` @Input plus the ios_backgroundColor fold), so an explicit [style]
-  // still beats the ambient class.
-  protected override buildHostProps(): Record<string, unknown> {
-    const props = super.buildHostProps();
-    return { ...props, style: [this.anchorStyle(), props['style']] };
-  }
-}

package/src/components/switch/index.ts

@@ -1,4 +0,0 @@
-// Base/default Switch. Re-exports the iOS build; Metro picks index.ios.ts / index.android.ts
-// in platform bundles. The Angular lifecycle reuses the shared Switch reducer + render fold.
-
-export * from './index.ios';