@symbiote-native/navigation 1.0.0

package/build-ngc/angular/tabs/index.js

@@ -0,0 +1,231 @@
+// Tab, the Angular lifecycle half. The focused-index router (tab-router-state) and the tab-bar
+// Descriptor builder (render-tabs) live in @symbiote-native/navigation core, shared verbatim with
+// the React/Vue adapters; here Angular supplies the lifecycle - a signal for the focused index, a
+// per-instance counter for route-key generation, `jumpTo`/`setParams` as plain public methods
+// directly on the class (no ref forwarding needed, see stack.ts's header, same reasoning: `Tab
+// implements ITabNavigatorHandle`) - plus the descriptor bridge (`symbiote-descriptor-outlet`,
+// `@symbiote-native/angular`) for the tab-bar leaf, exactly like Stack bridges its header config.
+// Unlike Stack, a bottom-tabs bar is a PURE-JS UI: it paints
+// ordinary `symbiote-view`/`symbiote-text` primitives via the shared render fn, so there is no
+// react-native-screens ViewConfig to register - Tab needs no `../register` import. Every tag this
+// template names (`View`, `symbiote-descriptor-outlet`) is a REAL imported Angular component (no
+// raw non-dashed native tag names the way stack.ts needs `NO_ERRORS_SCHEMA` for), so no loosened
+// schema is needed here at all.
+//
+// RESOLVED (see stack.ts's header, identical reasoning): `'Tab'` has an `ANCHOR_HOST_COMPONENTS`
+// entry in `adapters/angular/src/renderer.ts`, so a real device build paints `<Tab>` correctly as
+// a nested tag.
+import { ChangeDetectionStrategy, Component, ContentChildren, Input, QueryList, signal, untracked, } from '@angular/core';
+import { NgComponentOutlet } from '@angular/common';
+import { dlog } from '@symbiote-native/engine';
+import { DescriptorOutlet, View } from '@symbiote-native/angular';
+import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, createInitialTabState, createNavigationEmitter, diffFocusedRoute, isFocusedRoute, renderTabBar, tabRouterReducer, } from '../../core';
+import { NavigationScopeDirective } from '../navigation-scope.directive';
+import { TabScreenDirective } from '../tab-screen.directive';
+import * as i0 from "@angular/core";
+const TAB_ROOT_STYLE = { flex: 1 };
+const TAB_CONTENT_STYLE = { flex: 1 };
+let tabInstanceCounter = 0;
+export class Tab {
+    tabScreenChildren;
+    initialRouteName;
+    screenOptions;
+    rootStyle = TAB_ROOT_STYLE;
+    contentStyle = TAB_CONTENT_STYLE;
+    routeIdPrefix = `tab-${(tabInstanceCounter += 1)}`;
+    // Keyed by name -> the LIVE TabScreenDirective instance - see stack.ts's matching comment for
+    // why a snapshot copy would go stale on an in-place `[options]`/`[component]` change.
+    registry = new Map();
+    tabScreenChildrenSubscription;
+    stateSignal = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "stateSignal" }] : /* istanbul ignore next */ []));
+    state = this.stateSignal.asReadonly();
+    currentEmitterKey;
+    currentEmitter;
+    jumpTo = (name, params) => this.dispatch({ type: 'jumpTo', name, params });
+    setParams = (params, key) => this.dispatch({ type: 'setParams', key, params });
+    ngAfterContentInit() {
+        this.rebuildRegistry();
+        this.initializeState();
+        this.tabScreenChildrenSubscription = this.tabScreenChildren.changes.subscribe(() => {
+            this.rebuildRegistry();
+        });
+    }
+    ngOnDestroy() {
+        this.tabScreenChildrenSubscription?.unsubscribe();
+        if (this.currentEmitter)
+            this.currentEmitter.emit(NAVIGATION_EVENT_BLUR);
+    }
+    rebuildRegistry() {
+        this.registry.clear();
+        for (const screen of this.tabScreenChildren) {
+            this.registry.set(screen.name, screen);
+        }
+    }
+    routesFromRegistry() {
+        return Array.from(this.registry.entries()).map(([name, entry]) => ({
+            key: `${this.routeIdPrefix}-${name}`,
+            name,
+            params: entry.initialParams,
+        }));
+    }
+    initializeState() {
+        if (this.stateSignal() !== undefined)
+            return;
+        const routes = this.routesFromRegistry();
+        if (routes.length === 0)
+            dlog('Tab: no <ng-template symbioteTabScreen> children registered');
+        this.stateSignal.set(createInitialTabState(routes, this.initialRouteName));
+    }
+    dispatch(action) {
+        const current = this.stateSignal();
+        if (current === undefined)
+            return;
+        this.stateSignal.set(tabRouterReducer(current, action));
+    }
+    resolveTabOptions(entry, route) {
+        const props = { route, navigation: this };
+        const own = typeof entry.options === 'function' ? entry.options(props) : entry.options;
+        return { ...this.screenOptions, ...own };
+    }
+    focusedRoute() {
+        const state = this.stateSignal();
+        return state?.routes[state.index];
+    }
+    componentForRoute(route) {
+        return this.registry.get(route.name)?.component ?? null;
+    }
+    // Lazily creates/replaces the focused route's emitter and synthesizes focus/blur - Tab paints
+    // its own bar in pure JS (no native onAppear/onDisappear the way Stack's RNSScreen has), so
+    // focus/blur is synthesized here exactly like react/tabs.ts's own useEffect does, just idempotent
+    // per read (called repeatedly with the same key during one CD pass) instead of dependency-array
+    // gated. Keyed on the route KEY, not the object, so a setParams-only change doesn't re-fire.
+    //
+    // Called from the template ([emitter]="focusedRouteEmitter()"), which runs inside Angular's
+    // reactive-read tracking context for the current CD pass - unlike React's useEffect, which runs
+    // in a separate post-commit phase. Two consequences of that, both fixed below:
+    //
+    // 1. Writing a signal from inside a tracked template read throws Angular's NG600 ("signal write
+    //    during a template execution") - untracked() opts this whole synthesis out of that tracking
+    //    context, matching what the post-commit useEffect phase gives React for free.
+    // 2. The NEW route's screen component (injectIsFocused's listener source) is created by
+    //    *ngComponentOutlet AFTER this binding is evaluated, but still within the SAME synchronous
+    //    template refresh - so emitting FOCUS right here fires to zero listeners and is silently
+    //    lost forever (isFocused stays false permanently, even for the very first-focused screen).
+    //    queueMicrotask defers the FOCUS emit past the end of the current synchronous refresh
+    //    (which includes the new screen's construction), guaranteeing its injectIsFocused()
+    //    listener is already attached by the time it fires. BLUR doesn't need this: the outgoing
+    //    screen's listener was already attached on an earlier tick, so it's safe to fire now.
+    focusedRouteEmitter() {
+        const key = this.focusedRoute()?.key;
+        return untracked(() => {
+            if (key === this.currentEmitterKey && this.currentEmitter)
+                return this.currentEmitter;
+            const { blurKey, focusKey } = diffFocusedRoute(this.currentEmitterKey, key);
+            if (blurKey !== undefined && this.currentEmitter) {
+                dlog('Tab: previous route blurred');
+                this.currentEmitter.emit(NAVIGATION_EVENT_BLUR);
+            }
+            const emitter = createNavigationEmitter();
+            this.currentEmitter = emitter;
+            this.currentEmitterKey = key;
+            if (focusKey !== undefined) {
+                queueMicrotask(() => {
+                    if (this.currentEmitter !== emitter)
+                        return; // superseded by a later switch
+                    dlog(`Tab: route "${this.focusedRoute()?.name}" focused`);
+                    emitter.emit(NAVIGATION_EVENT_FOCUS);
+                });
+            }
+            return emitter;
+        });
+    }
+    tabBarDescriptor() {
+        const state = this.stateSignal();
+        const routes = state?.routes ?? [];
+        const focusedIndex = state?.index ?? 0;
+        const items = routes.map((route, index) => {
+            const entry = this.registry.get(route.name);
+            const focused = isFocusedRoute(index, focusedIndex);
+            if (!entry) {
+                dlog(`Tab: no screen registered for route name "${route.name}"`);
+                return { key: route.key, focused, label: route.name, passthrough: {} };
+            }
+            const options = this.resolveTabOptions(entry, route);
+            return {
+                key: route.key,
+                focused,
+                label: options.tabBarLabel ?? options.title ?? route.name,
+                icon: options.tabBarIcon,
+                badge: options.tabBarBadge,
+                activeTintColor: options.tabBarActiveTintColor,
+                inactiveTintColor: options.tabBarInactiveTintColor,
+                passthrough: {
+                    onPress: () => this.jumpTo(route.name),
+                    accessibilityRole: 'tab',
+                    accessibilityState: { selected: focused },
+                },
+            };
+        });
+        const focusedRoute = this.focusedRoute();
+        const focusedEntry = focusedRoute ? this.registry.get(focusedRoute.name) : undefined;
+        const focusedOptions = focusedEntry && focusedRoute
+            ? this.resolveTabOptions(focusedEntry, focusedRoute)
+            : this.screenOptions;
+        return renderTabBar({ items, style: focusedOptions?.tabBarStyle, passthrough: {} });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: Tab, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.5", type: Tab, isStandalone: true, selector: "Tab", inputs: { initialRouteName: "initialRouteName", screenOptions: "screenOptions" }, queries: [{ propertyName: "tabScreenChildren", predicate: TabScreenDirective }], ngImport: i0, template: `
+    <View [style]="rootStyle">
+      <View [style]="contentStyle">
+        @if (focusedRoute(); as route) {
+          @if (componentForRoute(route); as component) {
+            <ng-container
+              [symbioteNavigationScope]="route"
+              [navigation]="this"
+              [emitter]="focusedRouteEmitter()"
+            >
+              <ng-container *ngComponentOutlet="component" />
+            </ng-container>
+          }
+        }
+      </View>
+      <symbiote-descriptor-outlet [node]="tabBarDescriptor()" />
+    </View>
+  `, isInline: true, dependencies: [{ kind: "directive", type: NgComponentOutlet, selector: "[ngComponentOutlet]", inputs: ["ngComponentOutlet", "ngComponentOutletInputs", "ngComponentOutletInjector", "ngComponentOutletEnvironmentInjector", "ngComponentOutletContent", "ngComponentOutletNgModule"], exportAs: ["ngComponentOutlet"] }, { kind: "directive", type: NavigationScopeDirective, selector: "[symbioteNavigationScope]", inputs: ["symbioteNavigationScope", "navigation", "emitter"] }, { kind: "component", type: DescriptorOutlet, selector: "symbiote-descriptor-outlet", inputs: ["node"] }, { kind: "component", type: View, selector: "symbiote-view, View" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: Tab, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'Tab',
+                    standalone: true,
+                    imports: [NgComponentOutlet, NavigationScopeDirective, DescriptorOutlet, View],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    template: `
+    <View [style]="rootStyle">
+      <View [style]="contentStyle">
+        @if (focusedRoute(); as route) {
+          @if (componentForRoute(route); as component) {
+            <ng-container
+              [symbioteNavigationScope]="route"
+              [navigation]="this"
+              [emitter]="focusedRouteEmitter()"
+            >
+              <ng-container *ngComponentOutlet="component" />
+            </ng-container>
+          }
+        }
+      </View>
+      <symbiote-descriptor-outlet [node]="tabBarDescriptor()" />
+    </View>
+  `,
+                }]
+        }], propDecorators: { tabScreenChildren: [{
+                type: ContentChildren,
+                args: [TabScreenDirective]
+            }], initialRouteName: [{
+                type: Input
+            }], screenOptions: [{
+                type: Input
+            }] } });
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/tabs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/angular/tabs/index.ts"],"names":[],"mappings":"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"}

package/build-ngc/angular/tabs.d.ts

@@ -0,0 +1,45 @@
+import { type AfterContentInit, type OnDestroy, type Type } from '@angular/core';
+import type { IDescriptor } from '@symbiote-native/components';
+import type { INavigationEmitter, IRoute, ITabNavigatorHandle, ITabOptions } from '../core';
+import * as i0 from "@angular/core";
+export type { ITabNavigatorHandle } from '../core';
+export declare class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
+    private readonly tabScreenChildren;
+    initialRouteName?: string;
+    screenOptions?: ITabOptions;
+    readonly rootStyle: {
+        flex: number;
+    };
+    readonly contentStyle: {
+        flex: number;
+    };
+    private readonly routeIdPrefix;
+    private readonly registry;
+    private tabScreenChildrenSubscription;
+    private readonly stateSignal;
+    readonly state: import("@angular/core").Signal<Readonly<{
+        routes: readonly Readonly<{
+            key: string;
+            name: string;
+            params: unknown;
+        }>[];
+        index: number;
+    }> | undefined>;
+    private currentEmitterKey;
+    private currentEmitter;
+    readonly jumpTo: (name: string, params?: unknown) => void;
+    readonly setParams: (params: unknown, key: string) => void;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    private rebuildRegistry;
+    private routesFromRegistry;
+    private initializeState;
+    private dispatch;
+    private resolveTabOptions;
+    focusedRoute(): IRoute<unknown> | undefined;
+    componentForRoute(route: IRoute<unknown>): Type<unknown> | null;
+    focusedRouteEmitter(): INavigationEmitter;
+    tabBarDescriptor(): IDescriptor;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Tab, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Tab, "Tab", never, { "initialRouteName": { "alias": "initialRouteName"; "required": false; }; "screenOptions": { "alias": "screenOptions"; "required": false; }; }, {}, ["tabScreenChildren"], never, true, never>;
+}

package/build-ngc/angular/tabs.js

@@ -0,0 +1,231 @@
+// Tab, the Angular lifecycle half. The focused-index router (tab-router-state) and the tab-bar
+// Descriptor builder (render-tabs) live in @symbiote-native/navigation core, shared verbatim with
+// the React/Vue adapters; here Angular supplies the lifecycle — a signal for the focused index, a
+// per-instance counter for route-key generation, `jumpTo`/`setParams` as plain public methods
+// directly on the class (no ref forwarding needed, see stack.ts's header, same reasoning: `Tab
+// implements ITabNavigatorHandle`) - plus the descriptor bridge (`symbiote-descriptor-outlet`,
+// `@symbiote-native/angular`) for the tab-bar leaf, exactly like Stack bridges its header config.
+// Unlike Stack, a bottom-tabs bar is a PURE-JS UI: it paints
+// ordinary `symbiote-view`/`symbiote-text` primitives via the shared render fn, so there is no
+// react-native-screens ViewConfig to register — Tab needs no `../register` import. Every tag this
+// template names (`View`, `symbiote-descriptor-outlet`) is a REAL imported Angular component (no
+// raw non-dashed native tag names the way stack.ts needs `NO_ERRORS_SCHEMA` for), so no loosened
+// schema is needed here at all.
+//
+// RESOLVED (see stack.ts's header, identical reasoning): `'Tab'` has an `ANCHOR_HOST_COMPONENTS`
+// entry in `adapters/angular/src/renderer.ts`, so a real device build paints `<Tab>` correctly as
+// a nested tag.
+import { ChangeDetectionStrategy, Component, ContentChildren, Input, QueryList, signal, untracked, } from '@angular/core';
+import { NgComponentOutlet } from '@angular/common';
+import { dlog } from '@symbiote-native/engine';
+import { DescriptorOutlet, View } from '@symbiote-native/angular';
+import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, createInitialTabState, createNavigationEmitter, diffFocusedRoute, isFocusedRoute, renderTabBar, tabRouterReducer, } from '../core';
+import { NavigationScopeDirective } from './navigation-scope.directive';
+import { TabScreenDirective } from './tab-screen.directive';
+import * as i0 from "@angular/core";
+const TAB_ROOT_STYLE = { flex: 1 };
+const TAB_CONTENT_STYLE = { flex: 1 };
+let tabInstanceCounter = 0;
+export class Tab {
+    tabScreenChildren;
+    initialRouteName;
+    screenOptions;
+    rootStyle = TAB_ROOT_STYLE;
+    contentStyle = TAB_CONTENT_STYLE;
+    routeIdPrefix = `tab-${(tabInstanceCounter += 1)}`;
+    // Keyed by name -> the LIVE TabScreenDirective instance — see stack.ts's matching comment for
+    // why a snapshot copy would go stale on an in-place `[options]`/`[component]` change.
+    registry = new Map();
+    tabScreenChildrenSubscription;
+    stateSignal = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "stateSignal" }] : /* istanbul ignore next */ []));
+    state = this.stateSignal.asReadonly();
+    currentEmitterKey;
+    currentEmitter;
+    jumpTo = (name, params) => this.dispatch({ type: 'jumpTo', name, params });
+    setParams = (params, key) => this.dispatch({ type: 'setParams', key, params });
+    ngAfterContentInit() {
+        this.rebuildRegistry();
+        this.initializeState();
+        this.tabScreenChildrenSubscription = this.tabScreenChildren.changes.subscribe(() => {
+            this.rebuildRegistry();
+        });
+    }
+    ngOnDestroy() {
+        this.tabScreenChildrenSubscription?.unsubscribe();
+        if (this.currentEmitter)
+            this.currentEmitter.emit(NAVIGATION_EVENT_BLUR);
+    }
+    rebuildRegistry() {
+        this.registry.clear();
+        for (const screen of this.tabScreenChildren) {
+            this.registry.set(screen.name, screen);
+        }
+    }
+    routesFromRegistry() {
+        return Array.from(this.registry.entries()).map(([name, entry]) => ({
+            key: `${this.routeIdPrefix}-${name}`,
+            name,
+            params: entry.initialParams,
+        }));
+    }
+    initializeState() {
+        if (this.stateSignal() !== undefined)
+            return;
+        const routes = this.routesFromRegistry();
+        if (routes.length === 0)
+            dlog('Tab: no <ng-template symbioteTabScreen> children registered');
+        this.stateSignal.set(createInitialTabState(routes, this.initialRouteName));
+    }
+    dispatch(action) {
+        const current = this.stateSignal();
+        if (current === undefined)
+            return;
+        this.stateSignal.set(tabRouterReducer(current, action));
+    }
+    resolveTabOptions(entry, route) {
+        const props = { route, navigation: this };
+        const own = typeof entry.options === 'function' ? entry.options(props) : entry.options;
+        return { ...this.screenOptions, ...own };
+    }
+    focusedRoute() {
+        const state = this.stateSignal();
+        return state?.routes[state.index];
+    }
+    componentForRoute(route) {
+        return this.registry.get(route.name)?.component ?? null;
+    }
+    // Lazily creates/replaces the focused route's emitter and synthesizes focus/blur — Tab paints
+    // its own bar in pure JS (no native onAppear/onDisappear the way Stack's RNSScreen has), so
+    // focus/blur is synthesized here exactly like react/tabs.ts's own useEffect does, just idempotent
+    // per read (called repeatedly with the same key during one CD pass) instead of dependency-array
+    // gated. Keyed on the route KEY, not the object, so a setParams-only change doesn't re-fire.
+    //
+    // Called from the template ([emitter]="focusedRouteEmitter()"), which runs inside Angular's
+    // reactive-read tracking context for the current CD pass — unlike React's useEffect, which runs
+    // in a separate post-commit phase. Two consequences of that, both fixed below:
+    //
+    // 1. Writing a signal from inside a tracked template read throws Angular's NG600 ("signal write
+    //    during a template execution") — untracked() opts this whole synthesis out of that tracking
+    //    context, matching what the post-commit useEffect phase gives React for free.
+    // 2. The NEW route's screen component (injectIsFocused's listener source) is created by
+    //    *ngComponentOutlet AFTER this binding is evaluated, but still within the SAME synchronous
+    //    template refresh — so emitting FOCUS right here fires to zero listeners and is silently
+    //    lost forever (isFocused stays false permanently, even for the very first-focused screen).
+    //    queueMicrotask defers the FOCUS emit past the end of the current synchronous refresh
+    //    (which includes the new screen's construction), guaranteeing its injectIsFocused()
+    //    listener is already attached by the time it fires. BLUR doesn't need this: the outgoing
+    //    screen's listener was already attached on an earlier tick, so it's safe to fire now.
+    focusedRouteEmitter() {
+        const key = this.focusedRoute()?.key;
+        return untracked(() => {
+            if (key === this.currentEmitterKey && this.currentEmitter)
+                return this.currentEmitter;
+            const { blurKey, focusKey } = diffFocusedRoute(this.currentEmitterKey, key);
+            if (blurKey !== undefined && this.currentEmitter) {
+                dlog('Tab: previous route blurred');
+                this.currentEmitter.emit(NAVIGATION_EVENT_BLUR);
+            }
+            const emitter = createNavigationEmitter();
+            this.currentEmitter = emitter;
+            this.currentEmitterKey = key;
+            if (focusKey !== undefined) {
+                queueMicrotask(() => {
+                    if (this.currentEmitter !== emitter)
+                        return; // superseded by a later switch
+                    dlog(`Tab: route "${this.focusedRoute()?.name}" focused`);
+                    emitter.emit(NAVIGATION_EVENT_FOCUS);
+                });
+            }
+            return emitter;
+        });
+    }
+    tabBarDescriptor() {
+        const state = this.stateSignal();
+        const routes = state?.routes ?? [];
+        const focusedIndex = state?.index ?? 0;
+        const items = routes.map((route, index) => {
+            const entry = this.registry.get(route.name);
+            const focused = isFocusedRoute(index, focusedIndex);
+            if (!entry) {
+                dlog(`Tab: no screen registered for route name "${route.name}"`);
+                return { key: route.key, focused, label: route.name, passthrough: {} };
+            }
+            const options = this.resolveTabOptions(entry, route);
+            return {
+                key: route.key,
+                focused,
+                label: options.tabBarLabel ?? options.title ?? route.name,
+                icon: options.tabBarIcon,
+                badge: options.tabBarBadge,
+                activeTintColor: options.tabBarActiveTintColor,
+                inactiveTintColor: options.tabBarInactiveTintColor,
+                passthrough: {
+                    onPress: () => this.jumpTo(route.name),
+                    accessibilityRole: 'tab',
+                    accessibilityState: { selected: focused },
+                },
+            };
+        });
+        const focusedRoute = this.focusedRoute();
+        const focusedEntry = focusedRoute ? this.registry.get(focusedRoute.name) : undefined;
+        const focusedOptions = focusedEntry && focusedRoute
+            ? this.resolveTabOptions(focusedEntry, focusedRoute)
+            : this.screenOptions;
+        return renderTabBar({ items, style: focusedOptions?.tabBarStyle, passthrough: {} });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: Tab, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.5", type: Tab, isStandalone: true, selector: "Tab", inputs: { initialRouteName: "initialRouteName", screenOptions: "screenOptions" }, queries: [{ propertyName: "tabScreenChildren", predicate: TabScreenDirective }], ngImport: i0, template: `
+    <View [style]="rootStyle">
+      <View [style]="contentStyle">
+        @if (focusedRoute(); as route) {
+          @if (componentForRoute(route); as component) {
+            <ng-container
+              [symbioteNavigationScope]="route"
+              [navigation]="this"
+              [emitter]="focusedRouteEmitter()"
+            >
+              <ng-container *ngComponentOutlet="component" />
+            </ng-container>
+          }
+        }
+      </View>
+      <symbiote-descriptor-outlet [node]="tabBarDescriptor()" />
+    </View>
+  `, isInline: true, dependencies: [{ kind: "directive", type: NgComponentOutlet, selector: "[ngComponentOutlet]", inputs: ["ngComponentOutlet", "ngComponentOutletInputs", "ngComponentOutletInjector", "ngComponentOutletEnvironmentInjector", "ngComponentOutletContent", "ngComponentOutletNgModule"], exportAs: ["ngComponentOutlet"] }, { kind: "directive", type: NavigationScopeDirective, selector: "[symbioteNavigationScope]", inputs: ["symbioteNavigationScope", "navigation", "emitter"] }, { kind: "component", type: DescriptorOutlet, selector: "symbiote-descriptor-outlet", inputs: ["node"] }, { kind: "component", type: View, selector: "symbiote-view, View" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: Tab, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'Tab',
+                    standalone: true,
+                    imports: [NgComponentOutlet, NavigationScopeDirective, DescriptorOutlet, View],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    template: `
+    <View [style]="rootStyle">
+      <View [style]="contentStyle">
+        @if (focusedRoute(); as route) {
+          @if (componentForRoute(route); as component) {
+            <ng-container
+              [symbioteNavigationScope]="route"
+              [navigation]="this"
+              [emitter]="focusedRouteEmitter()"
+            >
+              <ng-container *ngComponentOutlet="component" />
+            </ng-container>
+          }
+        }
+      </View>
+      <symbiote-descriptor-outlet [node]="tabBarDescriptor()" />
+    </View>
+  `,
+                }]
+        }], propDecorators: { tabScreenChildren: [{
+                type: ContentChildren,
+                args: [TabScreenDirective]
+            }], initialRouteName: [{
+                type: Input
+            }], screenOptions: [{
+                type: Input
+            }] } });
+//# sourceMappingURL=tabs.js.map

package/build-ngc/angular/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/angular/tabs.ts"],"names":[],"mappings":"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"}

package/build-ngc/core/constants.d.ts

@@ -0,0 +1,27 @@
+export declare const RNS_SCREEN_VIEW_NAME = "RNSScreen";
+export declare const RNS_MODAL_SCREEN_VIEW_NAME = "RNSModalScreen";
+export declare const RNS_SCREEN_STACK_VIEW_NAME = "RNSScreenStack";
+export declare const RNS_SCREEN_STACK_HEADER_CONFIG_VIEW_NAME = "RNSScreenStackHeaderConfig";
+export declare const RNS_SCREEN_STACK_HEADER_SUBVIEW_VIEW_NAME = "RNSScreenStackHeaderSubview";
+export declare const RNS_SEARCH_BAR_VIEW_NAME = "RNSSearchBar";
+export declare const RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME = "RNSScreenContentWrapper";
+export declare const SCREEN_ON_APPEAR = "onAppear";
+export declare const SCREEN_ON_DISAPPEAR = "onDisappear";
+export declare const SCREEN_ON_WILL_APPEAR = "onWillAppear";
+export declare const SCREEN_ON_WILL_DISAPPEAR = "onWillDisappear";
+export declare const SCREEN_ON_DISMISSED = "onDismissed";
+export declare const SCREEN_ON_HEADER_BACK_BUTTON_CLICKED = "onHeaderBackButtonClicked";
+export declare const STACK_ON_FINISH_TRANSITIONING = "onFinishTransitioning";
+export declare const HEADER_ON_PRESS_BAR_BUTTON_ITEM = "onPressHeaderBarButtonItem";
+export declare const HEADER_ON_PRESS_BAR_BUTTON_MENU_ITEM = "onPressHeaderBarButtonMenuItem";
+export declare const SEARCH_BAR_ON_FOCUS = "onSearchFocus";
+export declare const SEARCH_BAR_ON_BLUR = "onSearchBlur";
+export declare const SEARCH_BAR_ON_SEARCH_BUTTON_PRESS = "onSearchButtonPress";
+export declare const SEARCH_BAR_ON_CANCEL_BUTTON_PRESS = "onCancelButtonPress";
+export declare const SEARCH_BAR_ON_CHANGE_TEXT = "onChangeText";
+export declare const SEARCH_BAR_ON_CLOSE = "onClose";
+export declare const SEARCH_BAR_ON_OPEN = "onOpen";
+export declare const SCREEN_ACTIVITY_STATE_FOCUSED = 2;
+export declare const SCREEN_ACTIVITY_STATE_INACTIVE = 0;
+export declare const STACK_DEFAULT_ANIMATION = "default";
+export declare const STACK_DEFAULT_PRESENTATION = "push";

package/build-ngc/core/constants.js

@@ -0,0 +1,62 @@
+// Framework-agnostic constants for the react-native-screens native stack primitives. symbiote
+// ships zero ViewConfig metadata for these views at runtime - the engine derives events and
+// color processors from react-native-screens' own codegen ViewConfig - this file only names the
+// Fabric view names and event prop keys every adapter binds against, plus the RNS activityState
+// convention (mirrors @react-navigation/native-stack's internal screen focus signaling).
+// The Fabric view names react-native-screens' codegen components register. descriptorFor passes
+// any non-`symbiote-` string through as a raw Fabric name, so the render fns emit these directly.
+export const RNS_SCREEN_VIEW_NAME = 'RNSScreen';
+// The modal-presentation twin of RNSScreen - see resolveScreenViewName's comment in
+// render-stack.ts for why a formSheet/modal screen MUST use this different Fabric name.
+export const RNS_MODAL_SCREEN_VIEW_NAME = 'RNSModalScreen';
+export const RNS_SCREEN_STACK_VIEW_NAME = 'RNSScreenStack';
+export const RNS_SCREEN_STACK_HEADER_CONFIG_VIEW_NAME = 'RNSScreenStackHeaderConfig';
+// The header-subview leaf react-native-screens itself uses to host arbitrary framework children
+// (left/right/back/title/center/searchBar) inside the header. Registered here for ground-truth
+// parity, but unconsumed by any fold in v1 scope: renderHeaderConfig's Descriptor never takes
+// framework children (see render-stack.ts), so mounting a subview child is left to the adapter.
+export const RNS_SCREEN_STACK_HEADER_SUBVIEW_VIEW_NAME = 'RNSScreenStackHeaderSubview';
+export const RNS_SEARCH_BAR_VIEW_NAME = 'RNSSearchBar';
+// react-native-screens' own JS layer (ScreenStackItem -> DebugContainer -> ScreenContentWrapper)
+// ALWAYS wraps a screen's content in this native view, `collapsable: false` so Fabric can never
+// flatten it away. RNSScreen.mm's `registerContentWrapper:contentHeightErrata:` is a no-op for
+// `push` (early-returns NO), but for `formSheet` it's how the native side ever learns the
+// content's real size - RNSScreenContentWrapper's `willMoveToWindow` walks up to the ancestor
+// RNSScreen and registers itself, and its `receivedReactFrame:` delegate callback is what feeds
+// the sheet's own height/detent machinery. Skipping this wrapper is harmless for `push` (why it
+// went unnoticed) but leaves a formSheet screen's native side with nothing to attach to at all.
+export const RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME = 'RNSScreenContentWrapper';
+// RNSScreen event prop keys (all DirectEventHandler in the codegen spec).
+export const SCREEN_ON_APPEAR = 'onAppear';
+export const SCREEN_ON_DISAPPEAR = 'onDisappear';
+export const SCREEN_ON_WILL_APPEAR = 'onWillAppear';
+export const SCREEN_ON_WILL_DISAPPEAR = 'onWillDisappear';
+export const SCREEN_ON_DISMISSED = 'onDismissed';
+export const SCREEN_ON_HEADER_BACK_BUTTON_CLICKED = 'onHeaderBackButtonClicked';
+// RNSScreenStack event prop key.
+export const STACK_ON_FINISH_TRANSITIONING = 'onFinishTransitioning';
+// RNSScreenStackHeaderConfig event prop keys (both DirectEventHandler in the codegen spec): a
+// plain bar-button-item press, and a press on a (possibly nested) menu action of a 'menu'-type
+// bar-button item.
+export const HEADER_ON_PRESS_BAR_BUTTON_ITEM = 'onPressHeaderBarButtonItem';
+export const HEADER_ON_PRESS_BAR_BUTTON_MENU_ITEM = 'onPressHeaderBarButtonMenuItem';
+// RNSSearchBar event prop keys (all DirectEventHandler in the codegen spec). onClose/onOpen are
+// Android-only per the codegen spec's own comment.
+export const SEARCH_BAR_ON_FOCUS = 'onSearchFocus';
+export const SEARCH_BAR_ON_BLUR = 'onSearchBlur';
+export const SEARCH_BAR_ON_SEARCH_BUTTON_PRESS = 'onSearchButtonPress';
+export const SEARCH_BAR_ON_CANCEL_BUTTON_PRESS = 'onCancelButtonPress';
+export const SEARCH_BAR_ON_CHANGE_TEXT = 'onChangeText';
+export const SEARCH_BAR_ON_CLOSE = 'onClose';
+export const SEARCH_BAR_ON_OPEN = 'onOpen';
+// activityState RNS reads to decide which screen is attached to the native hierarchy. Per
+// react-native-screens' native RNSScreen.mm (maybeAssertActivityStateProgressionOldValue), an
+// already-mounted NativeStack screen's activityState can never DECREASE via a plain prop update -
+// only 0 (detached) and 2 (attached + focused) are used; there is no "1 = transitioning" value in
+// @react-navigation/native-stack's actual algorithm (NativeStackView.native.tsx computes
+// `activityState={isInactive ? 0 : 2}`, never 1). See computeActivityState for the full rationale.
+export const SCREEN_ACTIVITY_STATE_FOCUSED = 2;
+export const SCREEN_ACTIVITY_STATE_INACTIVE = 0;
+export const STACK_DEFAULT_ANIMATION = 'default';
+export const STACK_DEFAULT_PRESENTATION = 'push';
+//# sourceMappingURL=constants.js.map

package/build-ngc/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,gGAAgG;AAChG,gGAAgG;AAChG,yFAAyF;AAEzF,gGAAgG;AAChG,kGAAkG;AAClG,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAChD,oFAAoF;AACpF,wFAAwF;AACxF,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,CAAC,MAAM,wCAAwC,GAAG,4BAA4B,CAAC;AACrF,gGAAgG;AAChG,+FAA+F;AAC/F,8FAA8F;AAC9F,gGAAgG;AAChG,MAAM,CAAC,MAAM,yCAAyC,GAAG,6BAA6B,CAAC;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AACvD,iGAAiG;AACjG,gGAAgG;AAChG,+FAA+F;AAC/F,0FAA0F;AAC1F,8FAA8F;AAC9F,gGAAgG;AAChG,gGAAgG;AAChG,gGAAgG;AAChG,MAAM,CAAC,MAAM,oCAAoC,GAAG,yBAAyB,CAAC;AAE9E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAEhF,iCAAiC;AACjC,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AAErE,8FAA8F;AAC9F,+FAA+F;AAC/F,mBAAmB;AACnB,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG,gCAAgC,CAAC;AAErF,gGAAgG;AAChG,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CAAC;AACvE,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CAAC;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,0FAA0F;AAC1F,8FAA8F;AAC9F,kGAAkG;AAClG,kGAAkG;AAClG,yFAAyF;AACzF,mGAAmG;AACnG,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC"}