@ng-native/router 0.0.1 → 0.1.0

package/dist/native-tabs-outlet.js

@@ -0,0 +1,408 @@
+/**
+ * A `RouterOutlet` that renders a native tab bar: a `UITabBarController` on iOS, a bottom
+ * navigation bar on Android.
+ *
+ * The outlet's host element *is* the tabs host, and each `<native-tab>` in its content is one
+ * item and the screen behind it. An activated route's component is created on a child view of
+ * the matching tab screen. The screen belongs to the tab declaration and must survive the route
+ * component being destroyed; Angular removes a component's host node when it destroys the ref.
+ *
+ * ```html
+ * <native-tabs-outlet>
+ *   <native-tab path="library" title="Library" sfSymbol="books.vertical.fill" />
+ *   <native-tab path="inbox" title="Inbox" sfSymbol="tray" [badge]="unread()" />
+ * </native-tabs-outlet>
+ * ```
+ *
+ * **Native holds the selection, not us.** The tabs host owns its navigation state and reports
+ * every change - a tap, or one we asked for - through `tabSelected`, carrying a `provenance`
+ * number that increments per change. We send `navStateRequest` with the provenance of the last
+ * state we acknowledged, which is how native tells a stale request from a current one when a tap
+ * and a navigation cross in flight. The alternative, holding the selection in JS, means a tap is
+ * only reflected after a round trip, and the bar lags the finger. See ADR 0006.
+ *
+ * **Each tab keeps its own screen mounted**, so switching away and back finds a tab exactly as it
+ * was: its scroll offset, its text, and its own stack if it has one. That is the reuse strategy
+ * detaching the tab's whole subtree rather than only its leaf.
+ */
+import { ApplicationRef, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, ErrorHandler, Injector, Renderer2, computed, contentChildren, createComponent, inject, input, signal, } from '@angular/core';
+import { SCREEN_IN_FRONT } from '@ng-native/device';
+import { ActivatedRoute, ChildrenOutletContexts, NavigationEnd, PRIMARY_OUTLET, Router, } from '@angular/router';
+import { bindRouteInputs } from "./bind-route-inputs.js";
+import { NATIVE_TAB_DEFAULTS } from "./native-bar-defaults.js";
+import { NativeBack, isShowing } from "./native-back.js";
+import { optionalBoolean } from "./transforms.js";
+import { NativeTab } from "./native-tab.js";
+import { ownHost } from "./own-host.js";
+import { markTabRoute } from "./tab-routes.js";
+import * as i0 from "@angular/core";
+export class NativeTabsOutlet {
+    name = PRIMARY_OUTLET;
+    supportsBindingToComponentInputs = true;
+    parentContexts = inject(ChildrenOutletContexts);
+    renderer = inject(Renderer2);
+    applicationRef = inject(ApplicationRef);
+    injector = inject(Injector);
+    host = inject(ElementRef);
+    route = inject(ActivatedRoute);
+    /** Optional so the outlet can be driven through `RouterOutletContract` directly, as tests do. */
+    router = inject(Router, { optional: true });
+    errors = inject(ErrorHandler);
+    /** What activation has reported already, so the failed navigation it causes is not reported again. */
+    reported = new WeakSet();
+    /** The app's `withTabDefaults`, for whatever the outlet does not bind itself. */
+    defaults = inject(NATIVE_TAB_DEFAULTS);
+    declared = contentChildren(NativeTab, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "declared" }] : /* istanbul ignore next */ []));
+    entries = [];
+    selected = null;
+    /** The provenance of the last state native told us about. Starts before native's first. */
+    provenance = 0;
+    fill = { flex: 1 };
+    // --- the bar itself -----------------------------------------------------
+    /** Hide the bar without unmounting the tabs, for a screen that wants the whole window. */
+    barHidden = input(undefined, { ...(ngDevMode ? { debugName: "barHidden" } : /* istanbul ignore next */ {}), transform: optionalBoolean });
+    /** The colour of the selected item. iOS. */
+    tintColor = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "tintColor" }] : /* istanbul ignore next */ []));
+    /** Behind the tabs, where a screen does not paint. */
+    backgroundColor = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "backgroundColor" }] : /* istanbul ignore next */ []));
+    /** Force the bar's light or dark appearance, whatever the app's is. */
+    colorScheme = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "colorScheme" }] : /* istanbul ignore next */ []));
+    /** iOS 26: let the bar shrink out of the way as content scrolls. */
+    minimizeBehavior = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "minimizeBehavior" }] : /* istanbul ignore next */ []));
+    /** iOS: `tabSidebar` is the iPad layout, with the tabs down the side. */
+    controllerMode = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "controllerMode" }] : /* istanbul ignore next */ []));
+    /** Android: keep the bar above the keyboard rather than behind it. */
+    respectsKeyboard = input(undefined, { ...(ngDevMode ? { debugName: "respectsKeyboard" } : /* istanbul ignore next */ {}), transform: optionalBoolean });
+    constructor() {
+        ownHost(this.host.nativeElement);
+        // In the constructor rather than a lifecycle hook: the router activates a child route as soon
+        // as this component exists, which is before any hook has run.
+        this.parentContexts.onChildOutletCreated(this.name, this);
+        this.renderer.listen(this.host.nativeElement, 'tabSelected', (event) => this.onNativeSelect(event?.nativeEvent));
+        // A push inside a tab's own stack reuses the tab's route, so this outlet is never activated
+        // for it; the router's navigation is the only sign. Without this, coming back to the tab
+        // returns it to its root and pops the screens the user left it on.
+        const following = this.router?.events?.subscribe((event) => {
+            if (event instanceof NavigationEnd)
+                this.follow(event.urlAfterRedirects);
+        });
+        // Android's back button, and `NativeNavigation.back()`, once the stack in front, if the tab
+        // has one, is at its root. Subscribed before any tab's own stack, so it is asked after them.
+        const unsubscribeBack = inject(NativeBack).handle(() => this.goBack());
+        inject(DestroyRef).onDestroy(() => {
+            unsubscribeBack();
+            following?.unsubscribe();
+            for (const entry of this.entries) {
+                entry.unbind();
+                entry.ref?.destroy();
+            }
+            this.entries.length = 0;
+            this.parentContexts.onChildOutletDestroyed(this.name);
+        });
+    }
+    /** A bar nobody has navigated into yet still has to show a selected item. */
+    ngAfterContentInit() {
+        this.readTabs();
+    }
+    /** The tabs in the bar, in template order. Exposed for tests. */
+    get tabKeys() {
+        return this.readTabs().map((entry) => entry.key);
+    }
+    /** Which tab native is showing. Exposed for tests. */
+    get selectedKey() {
+        return this.selected?.key ?? null;
+    }
+    // --- RouterOutletContract ----------------------------------------------
+    get isActivated() {
+        return this.selected?.ref != null && !this.selected.detached;
+    }
+    get component() {
+        return this.isActivated ? this.selected.ref.instance : null;
+    }
+    get activatedRoute() {
+        return this.isActivated ? this.selected.route : null;
+    }
+    get activatedRouteData() {
+        return this.activatedRoute?.snapshot.data ?? {};
+    }
+    /** The input binder reads this to bind route params to component inputs. */
+    get activatedComponentRef() {
+        return this.selected?.ref ?? null;
+    }
+    activateWith(route, environmentInjector) {
+        const component = (route.component ?? route.snapshot.component);
+        if (!component) {
+            throw new Error('[angular-native] route has no component to activate');
+        }
+        const entry = this.entryFor(route);
+        // The tab screen is owned by <native-tab>, not by this route component. If the route uses
+        // deactivate() rather than detach(), Angular removes the component host on destroy. Giving
+        // the component its own child host keeps that removal from taking the tab bar item with it.
+        const content = ownHost(this.renderer.createElement('view'));
+        this.renderer.setStyle(content, 'flex', 1);
+        this.renderer.appendChild(entry.tab.screen, content);
+        let ref;
+        try {
+            ref = createComponent(component, {
+                environmentInjector,
+                elementInjector: this.outletInjector(route, entry.inFront),
+                hostElement: content,
+            });
+            this.applicationRef.attachView(ref.hostView);
+            // Route params onto inputs before the first change detection, as the stack outlet does: a
+            // required input still unset when the page first renders throws NG0950.
+            entry.unbind = this.bindInputs(ref, route);
+            // Before anything can commit. Creating the page's nodes dirties the tree, which schedules a
+            // commit of its own - and that commit would capture the page with its elements created and
+            // its bindings not yet applied. On iOS the props catch up a frame later and nobody sees it;
+            // on Android the flattening decision is made from the props a view is created with, so a
+            // content wrapper that arrives without its `collapsable: false` is flattened for good and
+            // its children end up parented to a scroll view that allows exactly one.
+            ref.changeDetectorRef.detectChanges();
+        }
+        catch (error) {
+            this.abandon(entry, ref, content);
+            this.errors.handleError(error);
+            if (error !== null && typeof error === 'object')
+                this.reported.add(error);
+            throw error;
+        }
+        entry.ref = ref;
+        entry.route = route;
+        entry.detached = false;
+        this.select(entry);
+    }
+    deactivate() {
+        const entry = this.selected;
+        if (!entry?.ref)
+            return;
+        entry.unbind();
+        entry.unbind = () => { };
+        entry.ref.destroy();
+        entry.ref = null;
+        entry.route = null;
+    }
+    /**
+     * Hand the live `ComponentRef` back to the router. The tab's screen stays where it is with the
+     * component still inside it, so the tab keeps running while another one is in front.
+     */
+    detach() {
+        const entry = this.selected;
+        if (!entry?.ref)
+            throw new Error('[angular-native] outlet is not activated, nothing to detach');
+        entry.detached = true;
+        entry.inFront.set(false);
+        // As in the stack outlet: stop change detection without unmounting the views.
+        entry.ref.hostView.detach();
+        return entry.ref;
+    }
+    attach(ref, route) {
+        const entry = this.entryFor(route);
+        // A ref from a previous instance of this outlet still lives on its old tab screen, which is
+        // gone; re-parent it onto this one's rather than rebuild the tab.
+        if (entry.ref !== ref) {
+            this.renderer.appendChild(entry.tab.screen, ref.location.nativeElement);
+            this.applicationRef.attachView(ref.hostView);
+            entry.ref = ref;
+        }
+        entry.route = route;
+        entry.detached = false;
+        // The route object is new even when the url is not, so the inputs follow the new one.
+        entry.unbind();
+        entry.unbind = this.bindInputs(ref, route);
+        ref.hostView.reattach();
+        this.select(entry);
+    }
+    // --- native tabs --------------------------------------------------------
+    /**
+     * Undo a tab page that threw on its first render, which fails the navigation: its component
+     * and its content view go, and the tab that was showing carries on, change detection and all.
+     */
+    abandon(entry, ref, content) {
+        entry.unbind();
+        entry.unbind = () => { };
+        ref?.destroy();
+        this.renderer.removeChild(entry.tab.screen, content);
+        const showing = this.selected;
+        if (showing?.detached && showing.ref) {
+            showing.detached = false;
+            showing.ref.hostView.reattach();
+        }
+    }
+    /** Route params onto inputs only under `withComponentInputBinding()`, as in the stack outlet. */
+    bindInputs(ref, route) {
+        return this.router?.componentInputBindingEnabled ? bindRouteInputs(ref, route) : () => { };
+    }
+    /**
+     * Take the bar from the `<native-tab>` elements in the content, once.
+     *
+     * On demand rather than in a lifecycle hook, because the router activates a child route during
+     * this component's creation, before any hook has run - but after the content nodes themselves
+     * exist, which is all this needs.
+     */
+    readTabs() {
+        if (this.entries.length > 0)
+            return this.entries;
+        const children = this.route.routeConfig?.children ?? [];
+        for (const tab of this.declared()) {
+            const key = tab.path();
+            this.entries.push({
+                tab,
+                key,
+                url: '',
+                ref: null,
+                route: null,
+                detached: false,
+                unbind: () => { },
+                inFront: signal(false),
+            });
+            // The reuse strategy detaches a tab whole, and has only the route to go on.
+            // A path can have multiple route configs selected by canMatch (for example an iPad split
+            // layout and an iPhone stack). Mark every variant: the reuse strategy sees the config
+            // Angular actually matched, which may not be the first one in the route array.
+            for (const config of children) {
+                if (config.path === key)
+                    markTabRoute(config);
+            }
+        }
+        if (this.entries.length === 0) {
+            throw new Error('[angular-native] <native-tabs-outlet> has no tabs. Put a <native-tab path="..."> ' +
+                'inside it for each child route the bar should reach.');
+        }
+        // Before the first navigation nothing is selected, which is not a state a tab bar has.
+        this.request(this.entries[0]);
+        return this.entries;
+    }
+    entryFor(route) {
+        const path = (route.routeConfig ?? route.snapshot.routeConfig)?.path;
+        const entry = this.readTabs().find((candidate) => candidate.key === path);
+        if (!entry) {
+            throw new Error(`[angular-native] no <native-tab> has path="${path}". Every child route the bar can ` +
+                `reach needs one, and its path is what native identifies the tab by.`);
+        }
+        return entry;
+    }
+    /** Remember where this tab is, and tell native to show it. */
+    select(entry) {
+        this.selected = entry;
+        for (const other of this.entries)
+            other.inFront.set(other === entry);
+        entry.url = this.router?.url ?? entry.url;
+        this.request(entry);
+    }
+    /**
+     * A back with nothing left to pop inside the tab: go to the first tab, where it was left, which
+     * is what a bottom navigation bar does on Android. From the first tab, decline, so the platform
+     * leaves the app. The order tabs were visited in is not retraced, so a back never lands on a
+     * tab the user did not expect. Not while the bar is covered by a screen pushed over it: that
+     * screen's stack answers instead.
+     */
+    goBack() {
+        const first = this.entries[0];
+        const selected = this.selected;
+        if (!first || !selected || selected === first || !this.router)
+            return false;
+        if (!this.isActivated || !isShowing(this.router, selected.route))
+            return false;
+        void this.router.navigateByUrl(first.url || this.pathOf(first));
+        return true;
+    }
+    /** Keep the tab in front on the url it has reached, as long as the url is still inside it. */
+    follow(url) {
+        const entry = this.selected;
+        if (!entry)
+            return;
+        const root = this.pathOf(entry);
+        if (url === root || url.startsWith(`${root}/`) || url.startsWith(`${root}?`))
+            entry.url = url;
+    }
+    request(entry) {
+        this.renderer.setProperty(this.host.nativeElement, 'navStateRequest', {
+            selectedScreenKey: entry.key,
+            baseProvenance: this.provenance,
+        });
+    }
+    /**
+     * Native switched tab. Acknowledge the new state, then navigate: the router is authoritative
+     * about what is on screen (ADR 0003), so the tap becomes a navigation to where that tab was,
+     * and the activation that follows is what fills the tab in.
+     */
+    onNativeSelect(selection) {
+        if (!selection)
+            return;
+        this.provenance = selection.provenance;
+        const entry = this.readTabs().find((tab) => tab.key === selection.selectedScreenKey);
+        if (!entry || entry === this.selected)
+            return;
+        // Returning to a tab returns to the url it was last on, which is the whole point of keeping
+        // it mounted. A tab never visited starts at its own path.
+        // A navigation that fails is reported, unless activation reported it already: a page that
+        // does not load, caught here, would otherwise leave nothing but a tab that will not open.
+        void this.router?.navigateByUrl(entry.url || this.pathOf(entry)).then((arrived) => this.revertUnless(arrived), (error) => {
+            if (error === null || typeof error !== 'object' || !this.reported.has(error)) {
+                this.errors.handleError(error);
+            }
+            this.revertUnless(false);
+        });
+    }
+    /**
+     * Native switched tab before the router agreed to. When a guard refuses, or the navigation
+     * fails, the router stays where it was and so must the bar, or it shows a tab nobody is on.
+     * Not while another navigation is under way: that one superseded this, and its own activation
+     * selects the tab it lands on.
+     */
+    revertUnless(arrived) {
+        if (arrived || !this.selected || this.router?.getCurrentNavigation())
+            return;
+        this.request(this.selected);
+    }
+    /** A tab's own url, from the outlet's route down. */
+    pathOf(entry) {
+        const parent = this.route.snapshot.pathFromRoot
+            .flatMap((snapshot) => snapshot.url.map((segment) => segment.path))
+            .join('/');
+        return `/${[parent, entry.key].filter(Boolean).join('/')}`;
+    }
+    /** As the stack outlet's: the route, the outlet contexts, and whether the tab is showing. */
+    outletInjector(route, inFront) {
+        const outer = this.injector.get(SCREEN_IN_FRONT);
+        return Injector.create({
+            parent: this.injector,
+            providers: [
+                { provide: SCREEN_IN_FRONT, useValue: computed(() => outer() && inFront()) },
+                { provide: ActivatedRoute, useValue: route },
+                {
+                    provide: ChildrenOutletContexts,
+                    useValue: this.parentContexts.getOrCreateContext(this.name).children,
+                },
+            ],
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeTabsOutlet, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "22.2.0", type: NativeTabsOutlet, isStandalone: true, selector: "native-tabs-outlet", inputs: { barHidden: { classPropertyName: "barHidden", publicName: "barHidden", isSignal: true, isRequired: false, transformFunction: null }, tintColor: { classPropertyName: "tintColor", publicName: "tintColor", isSignal: true, isRequired: false, transformFunction: null }, backgroundColor: { classPropertyName: "backgroundColor", publicName: "backgroundColor", isSignal: true, isRequired: false, transformFunction: null }, colorScheme: { classPropertyName: "colorScheme", publicName: "colorScheme", isSignal: true, isRequired: false, transformFunction: null }, minimizeBehavior: { classPropertyName: "minimizeBehavior", publicName: "minimizeBehavior", isSignal: true, isRequired: false, transformFunction: null }, controllerMode: { classPropertyName: "controllerMode", publicName: "controllerMode", isSignal: true, isRequired: false, transformFunction: null }, respectsKeyboard: { classPropertyName: "respectsKeyboard", publicName: "respectsKeyboard", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "style": "fill", "tabBarHidden": "barHidden()", "tabBarTintColor": "tintColor() ?? defaults().tintColor", "nativeContainerBackgroundColor": "backgroundColor() ?? defaults().backgroundColor", "colorScheme": "colorScheme() ?? defaults().colorScheme", "tabBarMinimizeBehavior": "minimizeBehavior()", "tabBarControllerMode": "controllerMode()", "tabBarRespectsIMEInsets": "respectsKeyboard()" } }, queries: [{ propertyName: "declared", predicate: NativeTab, isSignal: true }], ngImport: i0, template: '<ng-content />', isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeTabsOutlet, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'native-tabs-outlet',
+                    template: '<ng-content />',
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    host: {
+                        '[style]': 'fill',
+                        '[tabBarHidden]': 'barHidden()',
+                        '[tabBarTintColor]': 'tintColor() ?? defaults().tintColor',
+                        '[nativeContainerBackgroundColor]': 'backgroundColor() ?? defaults().backgroundColor',
+                        '[colorScheme]': 'colorScheme() ?? defaults().colorScheme',
+                        '[tabBarMinimizeBehavior]': 'minimizeBehavior()',
+                        '[tabBarControllerMode]': 'controllerMode()',
+                        '[tabBarRespectsIMEInsets]': 'respectsKeyboard()',
+                    },
+                }]
+        }], ctorParameters: () => [], propDecorators: { declared: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => NativeTab), { isSignal: true }] }], barHidden: [{ type: i0.Input, args: [{ isSignal: true, alias: "barHidden", required: false }] }], tintColor: [{ type: i0.Input, args: [{ isSignal: true, alias: "tintColor", required: false }] }], backgroundColor: [{ type: i0.Input, args: [{ isSignal: true, alias: "backgroundColor", required: false }] }], colorScheme: [{ type: i0.Input, args: [{ isSignal: true, alias: "colorScheme", required: false }] }], minimizeBehavior: [{ type: i0.Input, args: [{ isSignal: true, alias: "minimizeBehavior", required: false }] }], controllerMode: [{ type: i0.Input, args: [{ isSignal: true, alias: "controllerMode", required: false }] }], respectsKeyboard: [{ type: i0.Input, args: [{ isSignal: true, alias: "respectsKeyboard", required: false }] }] } });
+//# sourceMappingURL=native-tabs-outlet.js.map

package/dist/native-tabs-outlet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tabs-outlet.js","sourceRoot":"","sources":["../src/native-tabs-outlet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,eAAe,EACf,eAAe,EACf,MAAM,EACN,KAAK,EACL,MAAM,GAMP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,MAAM,GAGP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;;AAsC/C,MAAM,OAAO,gBAAgB;IAC3B,IAAI,GAAG,cAAc,CAAC;IAEb,gCAAgC,GAAG,IAAI,CAAC;IAEhC,cAAc,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAChD,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7B,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACxC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1B,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IAChD,iGAAiG;IAChF,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/C,sGAAsG;IACrF,QAAQ,GAAG,IAAI,OAAO,EAAU,CAAC;IAClD,iFAAiF;IAC9D,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEzC,QAAQ,GAAG,eAAe,CAAC,SAAS;iFAAC,CAAC;IACtC,OAAO,GAAe,EAAE,CAAC;IAClC,QAAQ,GAAoB,IAAI,CAAC;IACzC,2FAA2F;IACnF,UAAU,GAAG,CAAC,CAAC;IAEJ,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAEtC,2EAA2E;IAE3E,0FAA0F;IACjF,SAAS,GAAG,KAAK,CAAC,SAAS,iFAAI,SAAS,EAAE,eAAe,GAAG,CAAC;IACtE,4CAA4C;IACnC,SAAS,GAAG,KAAK;6FAAmB,CAAC;IAC9C,sDAAsD;IAC7C,eAAe,GAAG,KAAK;mGAAmB,CAAC;IACpD,uEAAuE;IAC9D,WAAW,GAAG,KAAK;+FAAgC,CAAC;IAC7D,oEAAoE;IAC3D,gBAAgB,GAAG,KAAK;oGAAyD,CAAC;IAC3F,yEAAyE;IAChE,cAAc,GAAG,KAAK;kGAAyC,CAAC;IACzE,sEAAsE;IAC7D,gBAAgB,GAAG,KAAK,CAAC,SAAS,wFAAI,SAAS,EAAE,eAAe,GAAG,CAAC;IAE7E;QACE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjC,8FAA8F;QAC9F,8DAA8D;QAC9D,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,IAAI,CAAC,IAAI,CAAC,aAAa,EACvB,aAAa,EACb,CAAC,KAAqC,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CACnF,CAAC;QAEF,4FAA4F;QAC5F,yFAAyF;QACzF,mEAAmE;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACzD,IAAI,KAAK,YAAY,aAAa;gBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,4FAA4F;QAC5F,6FAA6F;QAC7F,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEvE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;YAChC,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,WAAW,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,iEAAiE;IACjE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,sDAAsD;IACtD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,0EAA0E;IAE1E,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAE,IAAI,CAAC,QAAS,CAAC,GAAI,CAAC,QAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,4EAA4E;IAC5E,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,YAAY,CAAC,KAAqB,EAAE,mBAAwC;QAC1E,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAyB,CAAC;QACxF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEnC,0FAA0F;QAC1F,2FAA2F;QAC3F,4FAA4F;QAC5F,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAErD,IAAI,GAAsC,CAAC;QAC3C,IAAI,CAAC;YACH,GAAG,GAAG,eAAe,CAAC,SAAS,EAAE;gBAC/B,mBAAmB;gBACnB,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1D,WAAW,EAAE,OAAkB;aAChC,CAAC,CAAC;YACH,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7C,0FAA0F;YAC1F,wEAAwE;YACxE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3C,4FAA4F;YAC5F,2FAA2F;YAC3F,4FAA4F;YAC5F,yFAAyF;YACzF,0FAA0F;YAC1F,yEAAyE;YACzE,GAAG,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC;QACd,CAAC;QAED,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;QAChB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,GAAG;YAAE,OAAO;QACxB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACxB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;QACjB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAChG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,8EAA8E;QAC9E,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,GAAG,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAA0B,EAAE,KAAqB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEnC,4FAA4F;QAC5F,kEAAkE;QAClE,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YACxE,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7C,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QACvB,sFAAsF;QACtF,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACK,OAAO,CAAC,KAAe,EAAE,GAAsC,EAAE,OAAgB;QACvF,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACxB,GAAG,EAAE,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACrC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED,iGAAiG;IACzF,UAAU,CAAC,GAA0B,EAAE,KAAqB;QAClE,OAAO,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;OAMG;IACK,QAAQ;QACd,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,GAAG;gBACH,GAAG;gBACH,GAAG,EAAE,EAAE;gBACP,GAAG,EAAE,IAAI;gBACT,KAAK,EAAE,IAAI;gBACX,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;gBAChB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;aACvB,CAAC,CAAC;YACH,4EAA4E;YAC5E,yFAAyF;YACzF,sFAAsF;YACtF,+EAA+E;YAC/E,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG;oBAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mFAAmF;gBACjF,sDAAsD,CACzD,CAAC;QACJ,CAAC;QACD,uFAAuF;QACvF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,QAAQ,CAAC,KAAqB;QACpC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,8CAA8C,IAAI,mCAAmC;gBACnF,qEAAqE,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8DAA8D;IACtD,MAAM,CAAC,KAAe;QAC5B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACrE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACK,MAAM;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/E,KAAK,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8FAA8F;IACtF,MAAM,CAAC,GAAW;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IAChG,CAAC;IAEO,OAAO,CAAC,KAAe;QAC7B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,EAAE;YACpE,iBAAiB,EAAE,KAAK,CAAC,GAAG;YAC5B,cAAc,EAAE,IAAI,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,SAAmC;QACxD,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACrF,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE9C,4FAA4F;QAC5F,0DAA0D;QAC1D,0FAA0F;QAC1F,0FAA0F;QAC1F,KAAK,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CACnE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EACvC,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7E,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,OAAgB;QACnC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE;YAAE,OAAO;QAC7E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,qDAAqD;IAC7C,MAAM,CAAC,KAAe;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY;aAC5C,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aAClE,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,6FAA6F;IACrF,cAAc,CAAC,KAAqB,EAAE,OAAgC;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC,EAAE;gBAC5E,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;gBAC5C;oBACE,OAAO,EAAE,sBAAsB;oBAC/B,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ;iBACrE;aACF;SACF,CAAC,CAAC;IACL,CAAC;uGA/XU,gBAAgB;2FAAhB,gBAAgB,ggDAmBiB,SAAS,6CAhC3C,gBAAgB;;2FAaf,gBAAgB;kBAf5B,SAAS;mBAAC;oBACT,QAAQ,EAAE,oBAAoB;oBAC9B,QAAQ,EAAE,gBAAgB;oBAC1B,eAAe,EAAE,uBAAuB,CAAC,MAAM;oBAC/C,IAAI,EAAE;wBACJ,SAAS,EAAE,MAAM;wBACjB,gBAAgB,EAAE,aAAa;wBAC/B,mBAAmB,EAAE,qCAAqC;wBAC1D,kCAAkC,EAAE,iDAAiD;wBACrF,eAAe,EAAE,yCAAyC;wBAC1D,0BAA0B,EAAE,oBAAoB;wBAChD,wBAAwB,EAAE,kBAAkB;wBAC5C,2BAA2B,EAAE,oBAAoB;qBAClD;iBACF;0HAoB6C,SAAS","sourcesContent":["/**\n * A `RouterOutlet` that renders a native tab bar: a `UITabBarController` on iOS, a bottom\n * navigation bar on Android.\n *\n * The outlet's host element *is* the tabs host, and each `<native-tab>` in its content is one\n * item and the screen behind it. An activated route's component is created on a child view of\n * the matching tab screen. The screen belongs to the tab declaration and must survive the route\n * component being destroyed; Angular removes a component's host node when it destroys the ref.\n *\n * ```html\n * <native-tabs-outlet>\n *   <native-tab path=\"library\" title=\"Library\" sfSymbol=\"books.vertical.fill\" />\n *   <native-tab path=\"inbox\" title=\"Inbox\" sfSymbol=\"tray\" [badge]=\"unread()\" />\n * </native-tabs-outlet>\n * ```\n *\n * **Native holds the selection, not us.** The tabs host owns its navigation state and reports\n * every change - a tap, or one we asked for - through `tabSelected`, carrying a `provenance`\n * number that increments per change. We send `navStateRequest` with the provenance of the last\n * state we acknowledged, which is how native tells a stale request from a current one when a tap\n * and a navigation cross in flight. The alternative, holding the selection in JS, means a tap is\n * only reflected after a round trip, and the bar lags the finger. See ADR 0006.\n *\n * **Each tab keeps its own screen mounted**, so switching away and back finds a tab exactly as it\n * was: its scroll offset, its text, and its own stack if it has one. That is the reuse strategy\n * detaching the tab's whole subtree rather than only its leaf.\n */\nimport {\n  ApplicationRef,\n  ChangeDetectionStrategy,\n  Component,\n  DestroyRef,\n  ElementRef,\n  ErrorHandler,\n  Injector,\n  Renderer2,\n  computed,\n  contentChildren,\n  createComponent,\n  inject,\n  input,\n  signal,\n  type AfterContentInit,\n  type ComponentRef,\n  type EnvironmentInjector,\n  type Type,\n  type WritableSignal,\n} from '@angular/core';\nimport { SCREEN_IN_FRONT } from '@ng-native/device';\nimport {\n  ActivatedRoute,\n  ChildrenOutletContexts,\n  NavigationEnd,\n  PRIMARY_OUTLET,\n  Router,\n  type Data,\n  type RouterOutletContract,\n} from '@angular/router';\nimport { bindRouteInputs } from './bind-route-inputs.ts';\nimport { NATIVE_TAB_DEFAULTS } from './native-bar-defaults.ts';\nimport { NativeBack, isShowing } from './native-back.ts';\nimport { optionalBoolean } from './transforms.ts';\nimport { NativeTab } from './native-tab.ts';\nimport { ownHost } from './own-host.ts';\nimport { markTabRoute } from './tab-routes.ts';\n\ninterface TabEntry {\n  readonly tab: NativeTab;\n  /** The key native identifies this tab by: its path, unique among the bar's items. */\n  readonly key: string;\n  /** The url this tab was last on, so returning to it returns where the user left. */\n  url: string;\n  ref: ComponentRef<unknown> | null;\n  route: ActivatedRoute | null;\n  detached: boolean;\n  /** Stops feeding route params into the component's inputs. */\n  unbind: () => void;\n  /** Whether this tab is the one showing, for what its screens hold: see `SCREEN_IN_FRONT`. */\n  readonly inFront: WritableSignal<boolean>;\n}\n\n/** What `tabSelected` carries. Only two fields matter here; the rest is diagnostics. */\ninterface TabSelection {\n  readonly selectedScreenKey: string;\n  readonly provenance: number;\n}\n\n@Component({\n  selector: 'native-tabs-outlet',\n  template: '<ng-content />',\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  host: {\n    '[style]': 'fill',\n    '[tabBarHidden]': 'barHidden()',\n    '[tabBarTintColor]': 'tintColor() ?? defaults().tintColor',\n    '[nativeContainerBackgroundColor]': 'backgroundColor() ?? defaults().backgroundColor',\n    '[colorScheme]': 'colorScheme() ?? defaults().colorScheme',\n    '[tabBarMinimizeBehavior]': 'minimizeBehavior()',\n    '[tabBarControllerMode]': 'controllerMode()',\n    '[tabBarRespectsIMEInsets]': 'respectsKeyboard()',\n  },\n})\nexport class NativeTabsOutlet implements RouterOutletContract, AfterContentInit {\n  name = PRIMARY_OUTLET;\n\n  readonly supportsBindingToComponentInputs = true;\n\n  private readonly parentContexts = inject(ChildrenOutletContexts);\n  private readonly renderer = inject(Renderer2);\n  private readonly applicationRef = inject(ApplicationRef);\n  private readonly injector = inject(Injector);\n  private readonly host = inject(ElementRef);\n  private readonly route = inject(ActivatedRoute);\n  /** Optional so the outlet can be driven through `RouterOutletContract` directly, as tests do. */\n  private readonly router = inject(Router, { optional: true });\n  private readonly errors = inject(ErrorHandler);\n  /** What activation has reported already, so the failed navigation it causes is not reported again. */\n  private readonly reported = new WeakSet<object>();\n  /** The app's `withTabDefaults`, for whatever the outlet does not bind itself. */\n  protected readonly defaults = inject(NATIVE_TAB_DEFAULTS);\n\n  private readonly declared = contentChildren(NativeTab);\n  private readonly entries: TabEntry[] = [];\n  private selected: TabEntry | null = null;\n  /** The provenance of the last state native told us about. Starts before native's first. */\n  private provenance = 0;\n\n  protected readonly fill = { flex: 1 };\n\n  // --- the bar itself -----------------------------------------------------\n\n  /** Hide the bar without unmounting the tabs, for a screen that wants the whole window. */\n  readonly barHidden = input(undefined, { transform: optionalBoolean });\n  /** The colour of the selected item. iOS. */\n  readonly tintColor = input<string | number>();\n  /** Behind the tabs, where a screen does not paint. */\n  readonly backgroundColor = input<string | number>();\n  /** Force the bar's light or dark appearance, whatever the app's is. */\n  readonly colorScheme = input<'inherit' | 'light' | 'dark'>();\n  /** iOS 26: let the bar shrink out of the way as content scrolls. */\n  readonly minimizeBehavior = input<'automatic' | 'never' | 'onScrollDown' | 'onScrollUp'>();\n  /** iOS: `tabSidebar` is the iPad layout, with the tabs down the side. */\n  readonly controllerMode = input<'automatic' | 'tabBar' | 'tabSidebar'>();\n  /** Android: keep the bar above the keyboard rather than behind it. */\n  readonly respectsKeyboard = input(undefined, { transform: optionalBoolean });\n\n  constructor() {\n    ownHost(this.host.nativeElement);\n    // In the constructor rather than a lifecycle hook: the router activates a child route as soon\n    // as this component exists, which is before any hook has run.\n    this.parentContexts.onChildOutletCreated(this.name, this);\n\n    this.renderer.listen(\n      this.host.nativeElement,\n      'tabSelected',\n      (event: { nativeEvent?: TabSelection }) => this.onNativeSelect(event?.nativeEvent),\n    );\n\n    // A push inside a tab's own stack reuses the tab's route, so this outlet is never activated\n    // for it; the router's navigation is the only sign. Without this, coming back to the tab\n    // returns it to its root and pops the screens the user left it on.\n    const following = this.router?.events?.subscribe((event) => {\n      if (event instanceof NavigationEnd) this.follow(event.urlAfterRedirects);\n    });\n\n    // Android's back button, and `NativeNavigation.back()`, once the stack in front, if the tab\n    // has one, is at its root. Subscribed before any tab's own stack, so it is asked after them.\n    const unsubscribeBack = inject(NativeBack).handle(() => this.goBack());\n\n    inject(DestroyRef).onDestroy(() => {\n      unsubscribeBack();\n      following?.unsubscribe();\n      for (const entry of this.entries) {\n        entry.unbind();\n        entry.ref?.destroy();\n      }\n      this.entries.length = 0;\n      this.parentContexts.onChildOutletDestroyed(this.name);\n    });\n  }\n\n  /** A bar nobody has navigated into yet still has to show a selected item. */\n  ngAfterContentInit(): void {\n    this.readTabs();\n  }\n\n  /** The tabs in the bar, in template order. Exposed for tests. */\n  get tabKeys(): string[] {\n    return this.readTabs().map((entry) => entry.key);\n  }\n\n  /** Which tab native is showing. Exposed for tests. */\n  get selectedKey(): string | null {\n    return this.selected?.key ?? null;\n  }\n\n  // --- RouterOutletContract ----------------------------------------------\n\n  get isActivated(): boolean {\n    return this.selected?.ref != null && !this.selected.detached;\n  }\n\n  get component(): Object | null {\n    return this.isActivated ? (this.selected!.ref!.instance as Object) : null;\n  }\n\n  get activatedRoute(): ActivatedRoute | null {\n    return this.isActivated ? this.selected!.route : null;\n  }\n\n  get activatedRouteData(): Data {\n    return this.activatedRoute?.snapshot.data ?? {};\n  }\n\n  /** The input binder reads this to bind route params to component inputs. */\n  get activatedComponentRef(): ComponentRef<unknown> | null {\n    return this.selected?.ref ?? null;\n  }\n\n  activateWith(route: ActivatedRoute, environmentInjector: EnvironmentInjector): void {\n    const component = (route.component ?? route.snapshot.component) as Type<unknown> | null;\n    if (!component) {\n      throw new Error('[angular-native] route has no component to activate');\n    }\n    const entry = this.entryFor(route);\n\n    // The tab screen is owned by <native-tab>, not by this route component. If the route uses\n    // deactivate() rather than detach(), Angular removes the component host on destroy. Giving\n    // the component its own child host keeps that removal from taking the tab bar item with it.\n    const content = ownHost(this.renderer.createElement('view'));\n    this.renderer.setStyle(content, 'flex', 1);\n    this.renderer.appendChild(entry.tab.screen, content);\n\n    let ref: ComponentRef<unknown> | undefined;\n    try {\n      ref = createComponent(component, {\n        environmentInjector,\n        elementInjector: this.outletInjector(route, entry.inFront),\n        hostElement: content as Element,\n      });\n      this.applicationRef.attachView(ref.hostView);\n      // Route params onto inputs before the first change detection, as the stack outlet does: a\n      // required input still unset when the page first renders throws NG0950.\n      entry.unbind = this.bindInputs(ref, route);\n      // Before anything can commit. Creating the page's nodes dirties the tree, which schedules a\n      // commit of its own - and that commit would capture the page with its elements created and\n      // its bindings not yet applied. On iOS the props catch up a frame later and nobody sees it;\n      // on Android the flattening decision is made from the props a view is created with, so a\n      // content wrapper that arrives without its `collapsable: false` is flattened for good and\n      // its children end up parented to a scroll view that allows exactly one.\n      ref.changeDetectorRef.detectChanges();\n    } catch (error) {\n      this.abandon(entry, ref, content);\n      this.errors.handleError(error);\n      if (error !== null && typeof error === 'object') this.reported.add(error);\n      throw error;\n    }\n\n    entry.ref = ref;\n    entry.route = route;\n    entry.detached = false;\n    this.select(entry);\n  }\n\n  deactivate(): void {\n    const entry = this.selected;\n    if (!entry?.ref) return;\n    entry.unbind();\n    entry.unbind = () => {};\n    entry.ref.destroy();\n    entry.ref = null;\n    entry.route = null;\n  }\n\n  /**\n   * Hand the live `ComponentRef` back to the router. The tab's screen stays where it is with the\n   * component still inside it, so the tab keeps running while another one is in front.\n   */\n  detach(): ComponentRef<unknown> {\n    const entry = this.selected;\n    if (!entry?.ref) throw new Error('[angular-native] outlet is not activated, nothing to detach');\n    entry.detached = true;\n    entry.inFront.set(false);\n    // As in the stack outlet: stop change detection without unmounting the views.\n    entry.ref.hostView.detach();\n    return entry.ref;\n  }\n\n  attach(ref: ComponentRef<unknown>, route: ActivatedRoute): void {\n    const entry = this.entryFor(route);\n\n    // A ref from a previous instance of this outlet still lives on its old tab screen, which is\n    // gone; re-parent it onto this one's rather than rebuild the tab.\n    if (entry.ref !== ref) {\n      this.renderer.appendChild(entry.tab.screen, ref.location.nativeElement);\n      this.applicationRef.attachView(ref.hostView);\n      entry.ref = ref;\n    }\n\n    entry.route = route;\n    entry.detached = false;\n    // The route object is new even when the url is not, so the inputs follow the new one.\n    entry.unbind();\n    entry.unbind = this.bindInputs(ref, route);\n    ref.hostView.reattach();\n    this.select(entry);\n  }\n\n  // --- native tabs --------------------------------------------------------\n\n  /**\n   * Undo a tab page that threw on its first render, which fails the navigation: its component\n   * and its content view go, and the tab that was showing carries on, change detection and all.\n   */\n  private abandon(entry: TabEntry, ref: ComponentRef<unknown> | undefined, content: unknown): void {\n    entry.unbind();\n    entry.unbind = () => {};\n    ref?.destroy();\n    this.renderer.removeChild(entry.tab.screen, content);\n    const showing = this.selected;\n    if (showing?.detached && showing.ref) {\n      showing.detached = false;\n      showing.ref.hostView.reattach();\n    }\n  }\n\n  /** Route params onto inputs only under `withComponentInputBinding()`, as in the stack outlet. */\n  private bindInputs(ref: ComponentRef<unknown>, route: ActivatedRoute): () => void {\n    return this.router?.componentInputBindingEnabled ? bindRouteInputs(ref, route) : () => {};\n  }\n\n  /**\n   * Take the bar from the `<native-tab>` elements in the content, once.\n   *\n   * On demand rather than in a lifecycle hook, because the router activates a child route during\n   * this component's creation, before any hook has run - but after the content nodes themselves\n   * exist, which is all this needs.\n   */\n  private readTabs(): TabEntry[] {\n    if (this.entries.length > 0) return this.entries;\n\n    const children = this.route.routeConfig?.children ?? [];\n    for (const tab of this.declared()) {\n      const key = tab.path();\n      this.entries.push({\n        tab,\n        key,\n        url: '',\n        ref: null,\n        route: null,\n        detached: false,\n        unbind: () => {},\n        inFront: signal(false),\n      });\n      // The reuse strategy detaches a tab whole, and has only the route to go on.\n      // A path can have multiple route configs selected by canMatch (for example an iPad split\n      // layout and an iPhone stack). Mark every variant: the reuse strategy sees the config\n      // Angular actually matched, which may not be the first one in the route array.\n      for (const config of children) {\n        if (config.path === key) markTabRoute(config);\n      }\n    }\n\n    if (this.entries.length === 0) {\n      throw new Error(\n        '[angular-native] <native-tabs-outlet> has no tabs. Put a <native-tab path=\"...\"> ' +\n          'inside it for each child route the bar should reach.',\n      );\n    }\n    // Before the first navigation nothing is selected, which is not a state a tab bar has.\n    this.request(this.entries[0]!);\n    return this.entries;\n  }\n\n  private entryFor(route: ActivatedRoute): TabEntry {\n    const path = (route.routeConfig ?? route.snapshot.routeConfig)?.path;\n    const entry = this.readTabs().find((candidate) => candidate.key === path);\n    if (!entry) {\n      throw new Error(\n        `[angular-native] no <native-tab> has path=\"${path}\". Every child route the bar can ` +\n          `reach needs one, and its path is what native identifies the tab by.`,\n      );\n    }\n    return entry;\n  }\n\n  /** Remember where this tab is, and tell native to show it. */\n  private select(entry: TabEntry): void {\n    this.selected = entry;\n    for (const other of this.entries) other.inFront.set(other === entry);\n    entry.url = this.router?.url ?? entry.url;\n    this.request(entry);\n  }\n\n  /**\n   * A back with nothing left to pop inside the tab: go to the first tab, where it was left, which\n   * is what a bottom navigation bar does on Android. From the first tab, decline, so the platform\n   * leaves the app. The order tabs were visited in is not retraced, so a back never lands on a\n   * tab the user did not expect. Not while the bar is covered by a screen pushed over it: that\n   * screen's stack answers instead.\n   */\n  private goBack(): boolean {\n    const first = this.entries[0];\n    const selected = this.selected;\n    if (!first || !selected || selected === first || !this.router) return false;\n    if (!this.isActivated || !isShowing(this.router, selected.route)) return false;\n    void this.router.navigateByUrl(first.url || this.pathOf(first));\n    return true;\n  }\n\n  /** Keep the tab in front on the url it has reached, as long as the url is still inside it. */\n  private follow(url: string): void {\n    const entry = this.selected;\n    if (!entry) return;\n    const root = this.pathOf(entry);\n    if (url === root || url.startsWith(`${root}/`) || url.startsWith(`${root}?`)) entry.url = url;\n  }\n\n  private request(entry: TabEntry): void {\n    this.renderer.setProperty(this.host.nativeElement, 'navStateRequest', {\n      selectedScreenKey: entry.key,\n      baseProvenance: this.provenance,\n    });\n  }\n\n  /**\n   * Native switched tab. Acknowledge the new state, then navigate: the router is authoritative\n   * about what is on screen (ADR 0003), so the tap becomes a navigation to where that tab was,\n   * and the activation that follows is what fills the tab in.\n   */\n  private onNativeSelect(selection: TabSelection | undefined): void {\n    if (!selection) return;\n    this.provenance = selection.provenance;\n\n    const entry = this.readTabs().find((tab) => tab.key === selection.selectedScreenKey);\n    if (!entry || entry === this.selected) return;\n\n    // Returning to a tab returns to the url it was last on, which is the whole point of keeping\n    // it mounted. A tab never visited starts at its own path.\n    // A navigation that fails is reported, unless activation reported it already: a page that\n    // does not load, caught here, would otherwise leave nothing but a tab that will not open.\n    void this.router?.navigateByUrl(entry.url || this.pathOf(entry)).then(\n      (arrived) => this.revertUnless(arrived),\n      (error: unknown) => {\n        if (error === null || typeof error !== 'object' || !this.reported.has(error)) {\n          this.errors.handleError(error);\n        }\n        this.revertUnless(false);\n      },\n    );\n  }\n\n  /**\n   * Native switched tab before the router agreed to. When a guard refuses, or the navigation\n   * fails, the router stays where it was and so must the bar, or it shows a tab nobody is on.\n   * Not while another navigation is under way: that one superseded this, and its own activation\n   * selects the tab it lands on.\n   */\n  private revertUnless(arrived: boolean): void {\n    if (arrived || !this.selected || this.router?.getCurrentNavigation()) return;\n    this.request(this.selected);\n  }\n\n  /** A tab's own url, from the outlet's route down. */\n  private pathOf(entry: TabEntry): string {\n    const parent = this.route.snapshot.pathFromRoot\n      .flatMap((snapshot) => snapshot.url.map((segment) => segment.path))\n      .join('/');\n    return `/${[parent, entry.key].filter(Boolean).join('/')}`;\n  }\n\n  /** As the stack outlet's: the route, the outlet contexts, and whether the tab is showing. */\n  private outletInjector(route: ActivatedRoute, inFront: WritableSignal<boolean>): Injector {\n    const outer = this.injector.get(SCREEN_IN_FRONT);\n    return Injector.create({\n      parent: this.injector,\n      providers: [\n        { provide: SCREEN_IN_FRONT, useValue: computed(() => outer() && inFront()) },\n        { provide: ActivatedRoute, useValue: route },\n        {\n          provide: ChildrenOutletContexts,\n          useValue: this.parentContexts.getOrCreateContext(this.name).children,\n        },\n      ],\n    });\n  }\n}\n"]}

package/dist/own-host.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mark `node` as owned, and take off any prop Angular wrote there from a static attribute that
+ * one of `directive`'s inputs already consumed: `<native-header title="Settings">` feeds the
+ * input *and* writes a `title` attribute, and only the input's value should survive.
+ */
+export declare function ownHost<T>(node: T, directive?: unknown): T;

package/dist/own-host.js

@@ -0,0 +1,28 @@
+/**
+ * Claiming a host node, for the elements navigation owns.
+ *
+ * The engine reports any registered element name that reaches a commit without a component
+ * behind it, which is how a template that forgot an import is caught. Navigation's elements need
+ * the same treatment for the opposite reason: the outlet creates a `screen` itself, and the
+ * header components own theirs, so both are accounted for rather than reported.
+ *
+ * This duplicates a few lines of the components package on purpose. `@nx/enforce-module-boundaries`
+ * keeps the Angular-facing packages from reaching into each other, and a package dependency is a
+ * heavier price than the copy.
+ */
+import { claimHost } from '@ng-native/fabric';
+/**
+ * Mark `node` as owned, and take off any prop Angular wrote there from a static attribute that
+ * one of `directive`'s inputs already consumed: `<native-header title="Settings">` feeds the
+ * input *and* writes a `title` attribute, and only the input's value should survive.
+ */
+export function ownHost(node, directive) {
+    claimHost(node);
+    if (directive) {
+        const def = directive.ɵcmp;
+        for (const name of Object.keys(def?.inputs ?? {}))
+            delete node.props[name];
+    }
+    return node;
+}
+//# sourceMappingURL=own-host.js.map

package/dist/own-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-host.js","sourceRoot":"","sources":["../src/own-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAI,IAAO,EAAE,SAAmB;IACrD,SAAS,CAAC,IAAkB,CAAC,CAAC;IAC9B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,GAAG,GAAI,SAA4C,CAAC,IAAI,CAAC;QAC/D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;YAAE,OAAQ,IAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Claiming a host node, for the elements navigation owns.\n *\n * The engine reports any registered element name that reaches a commit without a component\n * behind it, which is how a template that forgot an import is caught. Navigation's elements need\n * the same treatment for the opposite reason: the outlet creates a `screen` itself, and the\n * header components own theirs, so both are accounted for rather than reported.\n *\n * This duplicates a few lines of the components package on purpose. `@nx/enforce-module-boundaries`\n * keeps the Angular-facing packages from reaching into each other, and a package dependency is a\n * heavier price than the copy.\n */\nimport { claimHost, type EngineNode } from '@ng-native/fabric';\n\n/**\n * Mark `node` as owned, and take off any prop Angular wrote there from a static attribute that\n * one of `directive`'s inputs already consumed: `<native-header title=\"Settings\">` feeds the\n * input *and* writes a `title` attribute, and only the input's value should survive.\n */\nexport function ownHost<T>(node: T, directive?: unknown): T {\n  claimHost(node as EngineNode);\n  if (directive) {\n    const def = (directive as { ɵcmp?: { inputs?: object } }).ɵcmp;\n    for (const name of Object.keys(def?.inputs ?? {})) delete (node as EngineNode).props[name];\n  }\n  return node;\n}\n"]}

package/dist/provide-native-router.d.ts

@@ -0,0 +1,41 @@
+import { type RouterFeatures, type Routes } from '@angular/router';
+import { type EnvironmentProviders, type Provider } from '@angular/core';
+import { type HeaderDefaults, type SchemeDefaults, type TabDefaults } from './native-bar-defaults.ts';
+import { type LinkParent } from './native-links.ts';
+/** A native-only router option, passed to `provideNativeRouter` beside Angular's own features. */
+export interface NativeRouterFeature {
+    readonly ɵnativeRouter: {
+        readonly linkParent?: LinkParent;
+        readonly providers?: Provider[];
+    };
+}
+/**
+ * The page a deep link opens on top of, or null to open it alone. Without it a link to
+ * `/settings/notifications` opens that page with no Back. See native-links.ts.
+ */
+export declare function withLinkParent(parentOf: LinkParent): NativeRouterFeature;
+/**
+ * How every `<native-header>` looks when it does not say: its colours, blur, shadow, fonts and
+ * light or dark style. A header's own binding always wins.
+ *
+ * ```ts
+ * provideNativeRouter(
+ *   routes,
+ *   withHeaderDefaults((scheme) => ({
+ *     backgroundColor: scheme === 'dark' ? '#101014' : '#f4f4f7',
+ *     titleColor: scheme === 'dark' ? '#ffffff' : '#101014',
+ *     color: '#3b6ef5',
+ *   })),
+ * );
+ * ```
+ *
+ * Colours it leaves out still come from `NATIVE_HEADER_PALETTE`.
+ */
+export declare function withHeaderDefaults(defaults: SchemeDefaults<HeaderDefaults>): NativeRouterFeature;
+/**
+ * How every `<native-tabs-outlet>` and `<native-tab>` looks when it does not say: the tint, the
+ * background behind the tabs, the light or dark style, and each tab's bar appearance. An outlet's
+ * or a tab's own binding always wins.
+ */
+export declare function withTabDefaults(defaults: SchemeDefaults<TabDefaults>): NativeRouterFeature;
+export declare function provideNativeRouter(routes: Routes, ...features: (RouterFeatures | NativeRouterFeature)[]): EnvironmentProviders;