@symbiote-native/angular 0.6.0 → 0.6.2

package/build/components/scroll-view/sticky-header.d.ts

@@ -1,38 +0,0 @@
-import { EventEmitter, type OnChanges, type OnDestroy, type OnInit } from '@angular/core';
-import { AnimatedValue, type ISymbioteEvent } from '@symbiote-native/engine';
-import { type IStickyHeaderProps } from '@symbiote-native/components';
-export type IStickyHeaderComponentType = unknown;
-export declare class ScrollViewStickyHeader implements Omit<IStickyHeaderProps, 'onLayout'>, OnInit, OnChanges, OnDestroy {
-    scrollAnimatedValue: AnimatedValue;
-    nextHeaderLayoutY: number | undefined;
-    inverted: boolean | undefined;
-    scrollViewHeight: number | undefined;
-    readonly layout: EventEmitter<ISymbioteEvent>;
-    private measured;
-    private layoutY;
-    private layoutHeight;
-    private animatedTranslateY;
-    private translateY;
-    private haveReceivedInitialZeroTranslateY;
-    private debounceTimer;
-    private listenerId;
-    private readonly changeDetector;
-    private readonly elementRef;
-    ngOnInit(): void;
-    ngOnChanges(): void;
-    ngOnDestroy(): void;
-    get headerStyle(): unknown;
-    private readonly onHostLayout;
-    readonly headerAnimatedProps: Record<string, unknown>;
-    get passthrough(): {
-        style: {
-            transform: Array<{
-                translateY: number;
-            }>;
-        };
-    } | null;
-    private handleLayout;
-    private readonly animatedValueListener;
-    private rebuildInterpolation;
-    private teardownInterpolation;
-}

package/build/components/scroll-view/sticky-header.js

@@ -1,257 +0,0 @@
-// Sticky headers: the Angular twin of adapters/{react,vue}/src/components/scroll-view/
-// sticky-header.{tsx,ts}, the JS layer RN implements in ScrollView.js / ScrollViewStickyHeader.js.
-//
-// Source-based: RN does stickiness PURELY IN 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 load-bearing top/inverted
-// interpolation math (computeStickyInterpolation) lives framework-agnostic in @symbiote-native/components
-// this file holds the Angular component shell, the layout state, and the interpolation
-// build, sharing the math verbatim with React/Vue. Angular supplies only the lifecycle (inputs +
-// manual change detection instead of useState/useEffect or refs/watch).
-//
-// This is the public sticky-header WRAPPER for explicit composition. ScrollView also auto-wraps
-// projected direct children named by stickyHeaderIndices through its projection bridge (see
-// projection.ts), because Angular templates cannot map <ng-content> children directly; that auto
-// path intentionally uses this built-in wrapper rather than dynamically instantiating arbitrary
-// custom component classes.
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-import { ChangeDetectionStrategy, ChangeDetectorRef, Component, ElementRef, EventEmitter, Input, Output, inject, } from '@angular/core';
-import { AnimatedValue, Platform, dlog, } from '@symbiote-native/engine';
-import { computeStickyInterpolation, readLayoutNumber, stickyDebounceMs, STICKY_HEADER_Z_INDEX, } from '@symbiote-native/components';
-import { AnimatedView } from '../../modules/animated';
-import { anchorHostStyle } from '../../primitives';
-// 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).
-let ScrollViewStickyHeader = (() => {
-    let _classDecorators = [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>
-  `,
-        })];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _scrollAnimatedValue_decorators;
-    let _scrollAnimatedValue_initializers = [];
-    let _scrollAnimatedValue_extraInitializers = [];
-    let _nextHeaderLayoutY_decorators;
-    let _nextHeaderLayoutY_initializers = [];
-    let _nextHeaderLayoutY_extraInitializers = [];
-    let _inverted_decorators;
-    let _inverted_initializers = [];
-    let _inverted_extraInitializers = [];
-    let _scrollViewHeight_decorators;
-    let _scrollViewHeight_initializers = [];
-    let _scrollViewHeight_extraInitializers = [];
-    let _layout_decorators;
-    let _layout_initializers = [];
-    let _layout_extraInitializers = [];
-    var ScrollViewStickyHeader = class {
-        static { _classThis = this; }
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            _scrollAnimatedValue_decorators = [Input()];
-            _nextHeaderLayoutY_decorators = [Input()];
-            _inverted_decorators = [Input()];
-            _scrollViewHeight_decorators = [Input()];
-            _layout_decorators = [Output()];
-            __esDecorate(null, null, _scrollAnimatedValue_decorators, { kind: "field", name: "scrollAnimatedValue", static: false, private: false, access: { has: obj => "scrollAnimatedValue" in obj, get: obj => obj.scrollAnimatedValue, set: (obj, value) => { obj.scrollAnimatedValue = value; } }, metadata: _metadata }, _scrollAnimatedValue_initializers, _scrollAnimatedValue_extraInitializers);
-            __esDecorate(null, null, _nextHeaderLayoutY_decorators, { kind: "field", name: "nextHeaderLayoutY", static: false, private: false, access: { has: obj => "nextHeaderLayoutY" in obj, get: obj => obj.nextHeaderLayoutY, set: (obj, value) => { obj.nextHeaderLayoutY = value; } }, metadata: _metadata }, _nextHeaderLayoutY_initializers, _nextHeaderLayoutY_extraInitializers);
-            __esDecorate(null, null, _inverted_decorators, { kind: "field", name: "inverted", static: false, private: false, access: { has: obj => "inverted" in obj, get: obj => obj.inverted, set: (obj, value) => { obj.inverted = value; } }, metadata: _metadata }, _inverted_initializers, _inverted_extraInitializers);
-            __esDecorate(null, null, _scrollViewHeight_decorators, { kind: "field", name: "scrollViewHeight", static: false, private: false, access: { has: obj => "scrollViewHeight" in obj, get: obj => obj.scrollViewHeight, set: (obj, value) => { obj.scrollViewHeight = value; } }, metadata: _metadata }, _scrollViewHeight_initializers, _scrollViewHeight_extraInitializers);
-            __esDecorate(null, null, _layout_decorators, { kind: "field", name: "layout", static: false, private: false, access: { has: obj => "layout" in obj, get: obj => obj.layout, set: (obj, value) => { obj.layout = value; } }, metadata: _metadata }, _layout_initializers, _layout_extraInitializers);
-            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-            ScrollViewStickyHeader = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        // 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).
-        scrollAnimatedValue = __runInitializers(this, _scrollAnimatedValue_initializers, new AnimatedValue(0));
-        nextHeaderLayoutY = (__runInitializers(this, _scrollAnimatedValue_extraInitializers), __runInitializers(this, _nextHeaderLayoutY_initializers, undefined));
-        inverted = (__runInitializers(this, _nextHeaderLayoutY_extraInitializers), __runInitializers(this, _inverted_initializers, undefined));
-        scrollViewHeight = (__runInitializers(this, _inverted_extraInitializers), __runInitializers(this, _scrollViewHeight_initializers, 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.
-        layout = (__runInitializers(this, _scrollViewHeight_extraInitializers), __runInitializers(this, _layout_initializers, new EventEmitter()));
-        measured = (__runInitializers(this, _layout_extraInitializers), false);
-        layoutY = 0;
-        layoutHeight = 0;
-        // The animated node driving the transform (RN's animatedTranslateY). When the scroll value is
-        // native (attachStickyScroll), this interpolation runs on the UI thread: the smooth pin.
-        animatedTranslateY = new AnimatedValue(0).interpolate({
-            inputRange: [-1, 0],
-            outputRange: [0, 0],
-        });
-        // The debounced EXPLICIT translateY pushed to the committed transform via the passthrough, so the
-        // Fabric ShadowTree (hit-testing) knows the pinned position while the native driver animates.
-        translateY = null;
-        haveReceivedInitialZeroTranslateY = true;
-        debounceTimer;
-        listenerId;
-        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.
-        elementRef = inject(ElementRef);
-        ngOnInit() {
-            this.animatedTranslateY = this.scrollAnimatedValue.interpolate({
-                inputRange: [-1, 0],
-                outputRange: [0, 0],
-            });
-            this.rebuildInterpolation();
-        }
-        // Rebuild on any layout/collision input change (RN's effect deps: measured, layoutY, layoutHeight,
-        // scrollViewHeight, nextHeaderLayoutY, inverted). scrollAnimatedValue is stable for one ScrollView.
-        ngOnChanges() {
-            this.rebuildInterpolation();
-        }
-        ngOnDestroy() {
-            this.teardownInterpolation();
-        }
-        get headerStyle() {
-            // 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.
-        onHostLayout = (event) => 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).
-        headerAnimatedProps = {
-            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() {
-            return this.translateY !== null
-                ? { style: { transform: [{ translateY: this.translateY }] } }
-                : null;
-        }
-        // Record own y/height, mark measured, rebuild the interpolation, then fire the parent's recorder
-        // (RN ScrollViewStickyHeader.js._onLayout order). The wrapped child keeps its own onLayout binding
-        // (it is projected with its bindings intact), so unlike React/Vue we do not forward to it here.
-        handleLayout(event) {
-            const y = readLayoutNumber(event, 'y');
-            const height = readLayoutNumber(event, 'height');
-            if (y !== undefined)
-                this.layoutY = y;
-            if (height !== undefined)
-                this.layoutHeight = height;
-            this.measured = true;
-            this.rebuildInterpolation();
-            this.layout.emit(event);
-            this.changeDetector.markForCheck();
-        }
-        // The animated value updates several times per frame during scroll; debounce it and push the
-        // settled value into the committed transform so hit detection stays current (a Fabric-only issue,
-        // worse on Android). A freshly-rebuilt interpolation re-emits 0; swallow that first zero (RN).
-        animatedValueListener = ({ value }) => {
-            if (typeof value !== 'number')
-                return;
-            if (value === 0 && !this.haveReceivedInitialZeroTranslateY) {
-                this.haveReceivedInitialZeroTranslateY = true;
-                return;
-            }
-            if (this.debounceTimer !== undefined)
-                clearTimeout(this.debounceTimer);
-            this.debounceTimer = setTimeout(() => {
-                this.translateY = value;
-                if (value !== 0)
-                    this.haveReceivedInitialZeroTranslateY = false;
-                this.changeDetector.markForCheck();
-            }, stickyDebounceMs(Platform.OS));
-        };
-        rebuildInterpolation() {
-            this.teardownInterpolation();
-            const { inputRange, outputRange } = computeStickyInterpolation({
-                measured: this.measured,
-                inverted: this.inverted,
-                scrollViewHeight: this.scrollViewHeight,
-                layoutY: this.layoutY,
-                layoutHeight: this.layoutHeight,
-                nextHeaderLayoutY: this.nextHeaderLayoutY,
-            });
-            const interpolation = this.scrollAnimatedValue.interpolate({ inputRange, outputRange });
-            // symbiote is always Fabric: listen to the settled value to keep the ShadowTree transform
-            // current for hit-testing (RN attaches this listener only under Fabric).
-            this.listenerId = interpolation.addListener(this.animatedValueListener);
-            this.animatedTranslateY = interpolation;
-            dlog(`Angular ScrollViewStickyHeader interpolation measured=${this.measured} y=${this.layoutY}`);
-        }
-        teardownInterpolation() {
-            if (this.listenerId !== undefined) {
-                this.animatedTranslateY.removeListener(this.listenerId);
-                this.listenerId = undefined;
-            }
-            if (this.debounceTimer !== undefined) {
-                clearTimeout(this.debounceTimer);
-                this.debounceTimer = undefined;
-            }
-        }
-    };
-    return ScrollViewStickyHeader = _classThis;
-})();
-export { ScrollViewStickyHeader };

package/build/components/section-list/index.d.ts

@@ -1,113 +0,0 @@
-import { EventEmitter } from '@angular/core';
-import type { IAccessibilityProps, IAccessibilityStateValue, IAriaProps, IScrollViewHandle, ISection, IVirtualizedSectionListHandle } from '@symbiote-native/components';
-import { type IStyleProp, type ISymbioteEvent, type ISymbioteNode, type IViewStyle } from '@symbiote-native/engine';
-import { VListEmptyDirective, VListFooterDirective, VListHeaderDirective, VListSeparatorDirective, type IVListSeparatorContext } from '../virtualized-list';
-import { VSectionFooterDirective, VSectionHeaderDirective, VSectionItemDirective, VSectionSeparatorDirective, type IVirtualizedSectionListProps } from '../virtualized-section-list';
-export type { ISection } from '@symbiote-native/components';
-export type ISectionListHandle = IVirtualizedSectionListHandle;
-export { VSectionFooterDirective, VSectionHeaderDirective, VSectionItemDirective, VSectionSeparatorDirective, } from '../virtualized-section-list';
-export { VListEmptyDirective, VListFooterDirective, VListHeaderDirective, VListSeparatorDirective, } from '../virtualized-list';
-export type ISectionListProps<ItemT> = IVirtualizedSectionListProps<ItemT>;
-export type ISectionListInputs<ItemT> = Omit<ISectionListProps<ItemT>, 'onEndReached' | 'onStartReached' | 'onRefresh' | 'onAccessibilityAction' | 'onAccessibilityTap' | 'onMagicTap' | 'onAccessibilityEscape'>;
-export declare class SectionList<ItemT = unknown> implements ISectionListInputs<ItemT>, IVirtualizedSectionListHandle {
-    sections: ReadonlyArray<ISection<ItemT>>;
-    keyExtractor?: (item: ItemT, index: number) => string;
-    stickySectionHeadersEnabled?: boolean;
-    extraData?: unknown;
-    readonly endReached: EventEmitter<{
-        distanceFromEnd: number;
-    }>;
-    onEndReachedThreshold?: number;
-    readonly startReached: EventEmitter<{
-        distanceFromStart: number;
-    }>;
-    onStartReachedThreshold?: number;
-    readonly refresh: EventEmitter<void>;
-    refreshing?: boolean | null;
-    progressViewOffset?: number;
-    initialNumToRender?: number;
-    initialScrollIndex?: number;
-    maxToRenderPerBatch?: number;
-    updateCellsBatchingPeriod?: number;
-    windowSize?: number;
-    inverted?: boolean;
-    maintainVisibleContentPosition?: {
-        minIndexForVisible: number;
-        autoscrollToTopThreshold?: number;
-    };
-    onScroll?: (event: ISymbioteEvent) => void;
-    onScrollBeginDrag?: (event: ISymbioteEvent) => void;
-    onScrollEndDrag?: (event: ISymbioteEvent) => void;
-    onMomentumScrollBegin?: (event: ISymbioteEvent) => void;
-    onMomentumScrollEnd?: (event: ISymbioteEvent) => void;
-    scrollEventThrottle?: number;
-    keyboardShouldPersistTaps?: boolean | 'always' | 'never' | 'handled';
-    keyboardDismissMode?: 'none' | 'on-drag' | 'interactive';
-    style?: IStyleProp<IViewStyle>;
-    contentContainerStyle?: IStyleProp<IViewStyle>;
-    testID?: string;
-    nativeID?: string;
-    private cachedResolvedStyle;
-    get resolvedStyle(): IViewStyle;
-    accessible?: boolean;
-    accessibilityLabel?: string;
-    accessibilityHint?: string;
-    accessibilityRole?: IAccessibilityProps['accessibilityRole'];
-    accessibilityState?: IAccessibilityStateValue;
-    accessibilityValue?: IAccessibilityProps['accessibilityValue'];
-    accessibilityActions?: IAccessibilityProps['accessibilityActions'];
-    accessibilityLabelledBy?: string | string[];
-    importantForAccessibility?: IAccessibilityProps['importantForAccessibility'];
-    accessibilityLiveRegion?: IAccessibilityProps['accessibilityLiveRegion'];
-    screenReaderFocusable?: boolean;
-    accessibilityViewIsModal?: boolean;
-    accessibilityElementsHidden?: boolean;
-    accessibilityIgnoresInvertColors?: boolean;
-    accessibilityLanguage?: string;
-    accessibilityRespondsToUserInteraction?: boolean;
-    accessibilityShowsLargeContentViewer?: boolean;
-    accessibilityLargeContentTitle?: string;
-    readonly accessibilityAction: EventEmitter<ISymbioteEvent>;
-    readonly accessibilityTap: EventEmitter<ISymbioteEvent>;
-    readonly magicTap: EventEmitter<ISymbioteEvent>;
-    readonly accessibilityEscape: EventEmitter<ISymbioteEvent>;
-    role?: IAriaProps['role'];
-    ariaLabel?: string;
-    ariaLabelledBy?: string;
-    ariaLive?: IAriaProps['aria-live'];
-    ariaHidden?: boolean;
-    ariaBusy?: boolean;
-    ariaChecked?: boolean | 'mixed';
-    ariaDisabled?: boolean;
-    ariaExpanded?: boolean;
-    ariaSelected?: boolean;
-    ariaModal?: boolean;
-    ariaValueMax?: number;
-    ariaValueMin?: number;
-    ariaValueNow?: number;
-    ariaValueText?: string;
-    sectionItemDir?: VSectionItemDirective<ItemT>;
-    sectionHeaderDir?: VSectionHeaderDirective<ItemT>;
-    sectionFooterDir?: VSectionFooterDirective<ItemT>;
-    sectionSeparatorDir?: VSectionSeparatorDirective;
-    listHeaderDir?: VListHeaderDirective;
-    listFooterDir?: VListFooterDirective;
-    listEmptyDir?: VListEmptyDirective;
-    itemSeparatorDir?: VListSeparatorDirective<ItemT>;
-    private list?;
-    private readonly elementRef;
-    itemSeparatorContext(highlighted: unknown, leadingItem: unknown, trailingItem: unknown): IVListSeparatorContext<ItemT>;
-    scrollToLocation(params: {
-        sectionIndex: number;
-        itemIndex: number;
-        viewOffset?: number;
-        viewPosition?: number;
-        animated?: boolean;
-    }): void;
-    flashScrollIndicators(): void;
-    getNativeScrollRef(): IScrollViewHandle | null;
-    getScrollableNode(): IScrollViewHandle | null;
-    getScrollResponder(): IScrollViewHandle | null;
-    getScrollNode(): ISymbioteNode | null;
-    recordInteraction(): void;
-}