@ng-native/router 0.0.1 → 0.1.0

package/dist/native-navigation.d.ts

@@ -0,0 +1,84 @@
+import { type NavigationExtras } from '@angular/router';
+import type { ScreenPresentation, StackPresentation } from './screen-presentation.ts';
+/** What `Router` takes: a url string, or the array form with segments and params. */
+export type NavigationCommands = string | readonly unknown[];
+/**
+ * Where the intent rides. `NavigationExtras.state` is the app's own object, so ours sits under
+ * one reserved key rather than spread through it.
+ */
+export declare const NATIVE_INTENT = "\u0275nativeStack";
+/** What a navigation asks the outlet to do with the stack, over and above rendering the route. */
+export interface NativeIntent {
+    /** `replace` drops the screen it supersedes; `reset` empties the stack first. */
+    readonly stack?: 'push' | 'replace' | 'reset';
+    readonly presentation?: ScreenPresentation;
+}
+export interface NativeNavigationOptions extends NavigationExtras {
+    /** How the screen arrives: presentation, animation, gesture and sheet props. */
+    presentation?: ScreenPresentation;
+}
+export interface PresentOptions extends NativeNavigationOptions {
+    /** Shorthand for `presentation.stackPresentation`. Defaults to `modal`. */
+    as?: StackPresentation;
+}
+/** Read the intent off a navigation's state, if it carries one. */
+export declare function intentOf(state: unknown): NativeIntent | null;
+export declare class NativeNavigation {
+    private readonly router;
+    private readonly outlets;
+    /**
+     * Push a new screen onto the stack. The plain case, and what `nativeRouterLink` does.
+     *
+     * From a presented screen the new one is presented the same way, over it, since a pushed
+     * screen would slide in under it; `presentation` says otherwise, `stackAnimation` and all.
+     */
+    push(commands: NavigationCommands, options?: NativeNavigationOptions): Promise<boolean>;
+    /**
+     * Swap the current screen for another. The history entry is replaced too, so a back from the
+     * new screen goes where a back from the old one would have.
+     */
+    replace(commands: NavigationCommands, options?: NavigationExtras): Promise<boolean>;
+    /**
+     * Present a screen over the stack rather than pushing into it: a modal, or a sheet.
+     *
+     * `present('/filters', { as: 'formSheet', presentation: { sheetAllowedDetents: [0.5, 1] } })`.
+     *
+     * A presented screen is put on screen outside the stack's navigation controller, so it has no
+     * native header and no automatic safe-area insets: it needs its own way out, and its own
+     * `safe-area-view`. A sheet can also be dragged away, but `fullScreenModal` cannot, and with
+     * `gestureEnabled: false` neither can.
+     */
+    present(commands: NavigationCommands, options?: PresentOptions): Promise<boolean>;
+    /**
+     * Replace the whole stack with one screen, the way signing out or finishing onboarding does.
+     * Every screen below is destroyed, so there is nothing to go back to.
+     */
+    reset(commands: NavigationCommands, options?: NavigationExtras): Promise<boolean>;
+    /**
+     * Go back exactly as the Android back button does: pop the stack in front, or at the root of a
+     * tab's stack, go to the first tab. Not one entry back through history, which after a trip to
+     * another tab is that tab. At the root of the app there is nowhere to go, and this does nothing.
+     */
+    back(): void;
+    /**
+     * Pop straight back to the screen at `commands`, taking every screen above it off the stack at
+     * once - `popToViewController`. The screen is the one already there, with its state, not a new
+     * one. Resolves false, doing nothing, when no screen below the top of a stack in front is
+     * showing that url; a push is the way to a screen that is not there.
+     */
+    popTo(commands: NavigationCommands): Promise<boolean>;
+    /**
+     * Pop the stack in front to its first screen - `popToRootViewController`. Inside a tab, that is
+     * the tab's first screen; the screens below keep their state. Resolves false at the root already.
+     */
+    popToRoot(): Promise<boolean>;
+    private go;
+    /**
+     * The query and fragment written into a url string, as the extras `navigate` takes them: it
+     * reads a string command as one path segment, and would encode a `?` into it. Extras given
+     * alongside win over the ones in the string.
+     */
+    private queryOf;
+    private firstNavigationRunning;
+    private firstNavigation;
+}

package/dist/native-navigation.js

@@ -0,0 +1,153 @@
+/**
+ * The typed facade over `Router` for the intents a URL cannot express (ADR 0003).
+ *
+ * Angular's `Router` stays the single source of truth: each of these is a line over
+ * `router.navigate`, setting `replaceUrl` and a presentation on `NavigationExtras.state`. Deep
+ * links, guards and resolvers keep working because it is still the Router, and because state
+ * rides in history a back restores the presentation the screen was opened with.
+ *
+ * A navigation service that owns the stack was rejected: it either re-implements guards,
+ * resolvers and deep linking, or it drifts from the URL, and once the stack is not derived from
+ * router state the two can disagree.
+ *
+ * No decorators, so tests can import it at runtime and so it can be provided with `useClass`,
+ * exactly as `NativePlatformLocation` and `NativeStackReuseStrategy` are.
+ */
+import { inject } from '@angular/core';
+import { NavigationCancel, NavigationEnd, NavigationError, Router, } from '@angular/router';
+import { NativeBack } from "./native-back.js";
+/**
+ * Where the intent rides. `NavigationExtras.state` is the app's own object, so ours sits under
+ * one reserved key rather than spread through it.
+ */
+export const NATIVE_INTENT = 'ɵnativeStack';
+/** A url string up to its query or fragment. */
+const pathOf = (url) => url.split(/[?#]/, 1)[0];
+/** Read the intent off a navigation's state, if it carries one. */
+export function intentOf(state) {
+    if (!state || typeof state !== 'object')
+        return null;
+    const intent = state[NATIVE_INTENT];
+    return intent && typeof intent === 'object' ? intent : null;
+}
+export class NativeNavigation {
+    router = inject(Router);
+    outlets = inject(NativeBack);
+    /**
+     * Push a new screen onto the stack. The plain case, and what `nativeRouterLink` does.
+     *
+     * From a presented screen the new one is presented the same way, over it, since a pushed
+     * screen would slide in under it; `presentation` says otherwise, `stackAnimation` and all.
+     */
+    push(commands, options = {}) {
+        return this.go(commands, options, { stack: 'push' });
+    }
+    /**
+     * Swap the current screen for another. The history entry is replaced too, so a back from the
+     * new screen goes where a back from the old one would have.
+     */
+    replace(commands, options = {}) {
+        return this.go(commands, { ...options, replaceUrl: true }, { stack: 'replace' });
+    }
+    /**
+     * Present a screen over the stack rather than pushing into it: a modal, or a sheet.
+     *
+     * `present('/filters', { as: 'formSheet', presentation: { sheetAllowedDetents: [0.5, 1] } })`.
+     *
+     * A presented screen is put on screen outside the stack's navigation controller, so it has no
+     * native header and no automatic safe-area insets: it needs its own way out, and its own
+     * `safe-area-view`. A sheet can also be dragged away, but `fullScreenModal` cannot, and with
+     * `gestureEnabled: false` neither can.
+     */
+    present(commands, options = {}) {
+        const { as = 'modal', presentation, ...extras } = options;
+        return this.go(commands, extras, {
+            stack: 'push',
+            presentation: { stackPresentation: as, ...presentation },
+        });
+    }
+    /**
+     * Replace the whole stack with one screen, the way signing out or finishing onboarding does.
+     * Every screen below is destroyed, so there is nothing to go back to.
+     */
+    reset(commands, options = {}) {
+        return this.go(commands, { ...options, replaceUrl: true }, { stack: 'reset' });
+    }
+    /**
+     * Go back exactly as the Android back button does: pop the stack in front, or at the root of a
+     * tab's stack, go to the first tab. Not one entry back through history, which after a trip to
+     * another tab is that tab. At the root of the app there is nowhere to go, and this does nothing.
+     */
+    back() {
+        this.outlets.back();
+    }
+    /**
+     * Pop straight back to the screen at `commands`, taking every screen above it off the stack at
+     * once - `popToViewController`. The screen is the one already there, with its state, not a new
+     * one. Resolves false, doing nothing, when no screen below the top of a stack in front is
+     * showing that url; a push is the way to a screen that is not there.
+     */
+    popTo(commands) {
+        const tree = typeof commands === 'string'
+            ? this.router.parseUrl(commands)
+            : this.router.createUrlTree([...commands]);
+        return this.outlets.popTo(this.router.serializeUrl(tree));
+    }
+    /**
+     * Pop the stack in front to its first screen - `popToRootViewController`. Inside a tab, that is
+     * the tab's first screen; the screens below keep their state. Resolves false at the root already.
+     */
+    popToRoot() {
+        return this.outlets.popToRoot();
+    }
+    go(commands, options, intent) {
+        const { presentation, state, ...extras } = options;
+        const full = presentation
+            ? { ...intent, presentation: { ...intent.presentation, ...presentation } }
+            : intent;
+        const navigate = () => this.router.navigate(typeof commands === 'string' ? [pathOf(commands)] : [...commands], {
+            ...extras,
+            ...(typeof commands === 'string' ? this.queryOf(commands, extras) : {}),
+            state: { ...state, [NATIVE_INTENT]: full },
+        });
+        // A screen stacked on the first one waits for it. Navigating while the router's first
+        // navigation is still running - a lazily loaded root waiting on its import - cancels that
+        // navigation, and the app opens on this screen with nothing beneath it. A reset replaces the
+        // stack anyway, so it goes at once.
+        return intent.stack !== 'reset' && this.firstNavigationRunning()
+            ? this.firstNavigation().then(navigate)
+            : navigate();
+    }
+    /**
+     * The query and fragment written into a url string, as the extras `navigate` takes them: it
+     * reads a string command as one path segment, and would encode a `?` into it. Extras given
+     * alongside win over the ones in the string.
+     */
+    queryOf(url, extras) {
+        const cut = url.search(/[?#]/);
+        if (cut < 0)
+            return {};
+        const { queryParams, fragment } = this.router.parseUrl(url.slice(cut));
+        return {
+            queryParams: { ...queryParams, ...extras.queryParams },
+            fragment: extras.fragment ?? fragment ?? undefined,
+        };
+    }
+    firstNavigationRunning() {
+        const router = this.router;
+        return router.navigated === false && !!router.currentNavigation?.();
+    }
+    firstNavigation() {
+        return new Promise((resolve) => {
+            const events = this.router.events.subscribe((event) => {
+                if (event instanceof NavigationEnd ||
+                    event instanceof NavigationCancel ||
+                    event instanceof NavigationError) {
+                    events.unsubscribe();
+                    resolve();
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=native-navigation.js.map

package/dist/native-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-navigation.js","sourceRoot":"","sources":["../src/native-navigation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The typed facade over `Router` for the intents a URL cannot express (ADR 0003).\n *\n * Angular's `Router` stays the single source of truth: each of these is a line over\n * `router.navigate`, setting `replaceUrl` and a presentation on `NavigationExtras.state`. Deep\n * links, guards and resolvers keep working because it is still the Router, and because state\n * rides in history a back restores the presentation the screen was opened with.\n *\n * A navigation service that owns the stack was rejected: it either re-implements guards,\n * resolvers and deep linking, or it drifts from the URL, and once the stack is not derived from\n * router state the two can disagree.\n *\n * No decorators, so tests can import it at runtime and so it can be provided with `useClass`,\n * exactly as `NativePlatformLocation` and `NativeStackReuseStrategy` are.\n */\nimport { inject } from '@angular/core';\nimport {\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  Router,\n  type NavigationExtras,\n} from '@angular/router';\nimport { NativeBack } from './native-back.ts';\nimport type { ScreenPresentation, StackPresentation } from './screen-presentation.ts';\n\n/** What `Router` takes: a url string, or the array form with segments and params. */\nexport type NavigationCommands = string | readonly unknown[];\n\n/**\n * Where the intent rides. `NavigationExtras.state` is the app's own object, so ours sits under\n * one reserved key rather than spread through it.\n */\nexport const NATIVE_INTENT = 'ɵnativeStack';\n\n/** What a navigation asks the outlet to do with the stack, over and above rendering the route. */\nexport interface NativeIntent {\n  /** `replace` drops the screen it supersedes; `reset` empties the stack first. */\n  readonly stack?: 'push' | 'replace' | 'reset';\n  readonly presentation?: ScreenPresentation;\n}\n\nexport interface NativeNavigationOptions extends NavigationExtras {\n  /** How the screen arrives: presentation, animation, gesture and sheet props. */\n  presentation?: ScreenPresentation;\n}\n\nexport interface PresentOptions extends NativeNavigationOptions {\n  /** Shorthand for `presentation.stackPresentation`. Defaults to `modal`. */\n  as?: StackPresentation;\n}\n\n/** A url string up to its query or fragment. */\nconst pathOf = (url: string): string => url.split(/[?#]/, 1)[0]!;\n\n/** Read the intent off a navigation's state, if it carries one. */\nexport function intentOf(state: unknown): NativeIntent | null {\n  if (!state || typeof state !== 'object') return null;\n  const intent = (state as Record<string, unknown>)[NATIVE_INTENT];\n  return intent && typeof intent === 'object' ? (intent as NativeIntent) : null;\n}\n\nexport class NativeNavigation {\n  private readonly router = inject(Router);\n  private readonly outlets = inject(NativeBack);\n\n  /**\n   * Push a new screen onto the stack. The plain case, and what `nativeRouterLink` does.\n   *\n   * From a presented screen the new one is presented the same way, over it, since a pushed\n   * screen would slide in under it; `presentation` says otherwise, `stackAnimation` and all.\n   */\n  push(commands: NavigationCommands, options: NativeNavigationOptions = {}): Promise<boolean> {\n    return this.go(commands, options, { stack: 'push' });\n  }\n\n  /**\n   * Swap the current screen for another. The history entry is replaced too, so a back from the\n   * new screen goes where a back from the old one would have.\n   */\n  replace(commands: NavigationCommands, options: NavigationExtras = {}): Promise<boolean> {\n    return this.go(commands, { ...options, replaceUrl: true }, { stack: 'replace' });\n  }\n\n  /**\n   * Present a screen over the stack rather than pushing into it: a modal, or a sheet.\n   *\n   * `present('/filters', { as: 'formSheet', presentation: { sheetAllowedDetents: [0.5, 1] } })`.\n   *\n   * A presented screen is put on screen outside the stack's navigation controller, so it has no\n   * native header and no automatic safe-area insets: it needs its own way out, and its own\n   * `safe-area-view`. A sheet can also be dragged away, but `fullScreenModal` cannot, and with\n   * `gestureEnabled: false` neither can.\n   */\n  present(commands: NavigationCommands, options: PresentOptions = {}): Promise<boolean> {\n    const { as = 'modal', presentation, ...extras } = options;\n    return this.go(commands, extras, {\n      stack: 'push',\n      presentation: { stackPresentation: as, ...presentation },\n    });\n  }\n\n  /**\n   * Replace the whole stack with one screen, the way signing out or finishing onboarding does.\n   * Every screen below is destroyed, so there is nothing to go back to.\n   */\n  reset(commands: NavigationCommands, options: NavigationExtras = {}): Promise<boolean> {\n    return this.go(commands, { ...options, replaceUrl: true }, { stack: 'reset' });\n  }\n\n  /**\n   * Go back exactly as the Android back button does: pop the stack in front, or at the root of a\n   * tab's stack, go to the first tab. Not one entry back through history, which after a trip to\n   * another tab is that tab. At the root of the app there is nowhere to go, and this does nothing.\n   */\n  back(): void {\n    this.outlets.back();\n  }\n\n  /**\n   * Pop straight back to the screen at `commands`, taking every screen above it off the stack at\n   * once - `popToViewController`. The screen is the one already there, with its state, not a new\n   * one. Resolves false, doing nothing, when no screen below the top of a stack in front is\n   * showing that url; a push is the way to a screen that is not there.\n   */\n  popTo(commands: NavigationCommands): Promise<boolean> {\n    const tree =\n      typeof commands === 'string'\n        ? this.router.parseUrl(commands)\n        : this.router.createUrlTree([...commands]);\n    return this.outlets.popTo(this.router.serializeUrl(tree));\n  }\n\n  /**\n   * Pop the stack in front to its first screen - `popToRootViewController`. Inside a tab, that is\n   * the tab's first screen; the screens below keep their state. Resolves false at the root already.\n   */\n  popToRoot(): Promise<boolean> {\n    return this.outlets.popToRoot();\n  }\n\n  private go(\n    commands: NavigationCommands,\n    options: NativeNavigationOptions,\n    intent: NativeIntent,\n  ): Promise<boolean> {\n    const { presentation, state, ...extras } = options;\n    const full: NativeIntent = presentation\n      ? { ...intent, presentation: { ...intent.presentation, ...presentation } }\n      : intent;\n\n    const navigate = () =>\n      this.router.navigate(typeof commands === 'string' ? [pathOf(commands)] : [...commands], {\n        ...extras,\n        ...(typeof commands === 'string' ? this.queryOf(commands, extras) : {}),\n        state: { ...(state as object), [NATIVE_INTENT]: full },\n      });\n    // A screen stacked on the first one waits for it. Navigating while the router's first\n    // navigation is still running - a lazily loaded root waiting on its import - cancels that\n    // navigation, and the app opens on this screen with nothing beneath it. A reset replaces the\n    // stack anyway, so it goes at once.\n    return intent.stack !== 'reset' && this.firstNavigationRunning()\n      ? this.firstNavigation().then(navigate)\n      : navigate();\n  }\n\n  /**\n   * The query and fragment written into a url string, as the extras `navigate` takes them: it\n   * reads a string command as one path segment, and would encode a `?` into it. Extras given\n   * alongside win over the ones in the string.\n   */\n  private queryOf(url: string, extras: NavigationExtras): NavigationExtras {\n    const cut = url.search(/[?#]/);\n    if (cut < 0) return {};\n    const { queryParams, fragment } = this.router.parseUrl(url.slice(cut));\n    return {\n      queryParams: { ...queryParams, ...extras.queryParams },\n      fragment: extras.fragment ?? fragment ?? undefined,\n    };\n  }\n\n  private firstNavigationRunning(): boolean {\n    const router = this.router as Partial<Router>;\n    return router.navigated === false && !!router.currentNavigation?.();\n  }\n\n  private firstNavigation(): Promise<void> {\n    return new Promise((resolve) => {\n      const events = this.router.events.subscribe((event) => {\n        if (\n          event instanceof NavigationEnd ||\n          event instanceof NavigationCancel ||\n          event instanceof NavigationError\n        ) {\n          events.unsubscribe();\n          resolve();\n        }\n      });\n    });\n  }\n}\n"]}

package/dist/native-platform-location.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `PlatformLocation` over an in-memory history.
+ *
+ * Angular's `Location` reads and writes the URL through this. On the web the browser owns the
+ * history stack; here nothing does, so we keep it ourselves and the URL tree stays the source of
+ * truth in both directions: `router.navigate()` pushes an entry, and a swipe-back reaches the
+ * outlet as the screen's `dismissed` event, which usually calls `historyGo(-1)` here and emits
+ * `popstate` so the router follows. Not always: see the stack outlet's `popBy` for when the entry
+ * behind is another tab.
+ *
+ * No decorators, so tests can import it at runtime and so it can be provided with `useClass`.
+ */
+import type { LocationChangeListener, PlatformLocation } from '@angular/common';
+/**
+ * What the history needs of a deep-link source, which `DeepLinks` from
+ * `@ng-native/device` satisfies. Structural rather than the class itself: the router has no
+ * use for the rest of it, and a test has no use for a real one.
+ */
+export interface LinkSource {
+    /** The path the app was launched with, or null for a normal launch. */
+    initialUrl(): string | null;
+    /** Links that arrive while the app is running. Returns an unsubscribe. */
+    subscribe(listener: (url: string) => void): () => void;
+}
+export declare class NativePlatformLocation implements PlatformLocation {
+    private readonly entries;
+    private cursor;
+    private readonly popStateListeners;
+    private readonly hashChangeListeners;
+    /**
+     * A deep link is history, not a navigation of its own: the launch url *is* the first entry,
+     * and one that arrives later is pushed and announced as a popstate, which is the only thing
+     * the router listens to. `links` is null in a test that has no interest in either.
+     */
+    constructor(links?: LinkSource | null);
+    /** Follow a link that arrived while the app was running. */
+    open(url: string): void;
+    /**
+     * The url of the entry `offset` away from the current one, or null past either end. For the
+     * stack outlet, which has to know whether going back reaches the screen a native pop revealed.
+     */
+    ɵurlAt(offset: number): string | null;
+    private get current();
+    getBaseHrefFromDOM(): string;
+    getState(): unknown;
+    onPopState(fn: LocationChangeListener): VoidFunction;
+    onHashChange(fn: LocationChangeListener): VoidFunction;
+    get href(): string;
+    /** There is no origin on a device. Angular only ever compares these, never resolves them. */
+    get protocol(): string;
+    get hostname(): string;
+    get port(): string;
+    get pathname(): string;
+    get search(): string;
+    get hash(): string;
+    pushState(state: unknown, _title: string, url: string): void;
+    replaceState(state: unknown, _title: string, url: string): void;
+    forward(): void;
+    back(): void;
+    historyGo(relativePosition?: number): void;
+    private emitPopState;
+}

package/dist/native-platform-location.js

@@ -0,0 +1,110 @@
+/** Split a url into its path, `?search` and `#hash` parts. */
+function parse(url) {
+    const hashAt = url.indexOf('#');
+    const hash = hashAt === -1 ? '' : url.slice(hashAt);
+    const withoutHash = hashAt === -1 ? url : url.slice(0, hashAt);
+    const searchAt = withoutHash.indexOf('?');
+    const search = searchAt === -1 ? '' : withoutHash.slice(searchAt);
+    const pathname = searchAt === -1 ? withoutHash : withoutHash.slice(0, searchAt);
+    return { pathname: pathname || '/', search, hash };
+}
+export class NativePlatformLocation {
+    entries = [{ url: '/', state: null }];
+    cursor = 0;
+    popStateListeners = new Set();
+    hashChangeListeners = new Set();
+    /**
+     * A deep link is history, not a navigation of its own: the launch url *is* the first entry,
+     * and one that arrives later is pushed and announced as a popstate, which is the only thing
+     * the router listens to. `links` is null in a test that has no interest in either.
+     */
+    constructor(links = null) {
+        const initial = links?.initialUrl();
+        if (initial)
+            this.entries[0] = { url: initial, state: null };
+        links?.subscribe((url) => this.open(url));
+    }
+    /** Follow a link that arrived while the app was running. */
+    open(url) {
+        if (url === this.current.url)
+            return;
+        this.pushState(null, '', url);
+        this.emitPopState();
+    }
+    /**
+     * The url of the entry `offset` away from the current one, or null past either end. For the
+     * stack outlet, which has to know whether going back reaches the screen a native pop revealed.
+     */
+    ɵurlAt(offset) {
+        return this.entries[this.cursor + offset]?.url ?? null;
+    }
+    get current() {
+        return this.entries[this.cursor];
+    }
+    // --- PlatformLocation ---------------------------------------------------
+    getBaseHrefFromDOM() {
+        return '/';
+    }
+    getState() {
+        return this.current.state;
+    }
+    onPopState(fn) {
+        this.popStateListeners.add(fn);
+        return () => this.popStateListeners.delete(fn);
+    }
+    onHashChange(fn) {
+        this.hashChangeListeners.add(fn);
+        return () => this.hashChangeListeners.delete(fn);
+    }
+    get href() {
+        return this.current.url;
+    }
+    /** There is no origin on a device. Angular only ever compares these, never resolves them. */
+    get protocol() {
+        return 'app:';
+    }
+    get hostname() {
+        return '';
+    }
+    get port() {
+        return '';
+    }
+    get pathname() {
+        return parse(this.current.url).pathname;
+    }
+    get search() {
+        return parse(this.current.url).search;
+    }
+    get hash() {
+        return parse(this.current.url).hash;
+    }
+    pushState(state, _title, url) {
+        // A push after going back discards the forward entries, as a browser does.
+        this.entries.length = this.cursor + 1;
+        this.entries.push({ url, state });
+        this.cursor++;
+    }
+    replaceState(state, _title, url) {
+        this.entries[this.cursor] = { url, state };
+    }
+    forward() {
+        this.historyGo(1);
+    }
+    back() {
+        this.historyGo(-1);
+    }
+    historyGo(relativePosition = 0) {
+        const target = this.cursor + relativePosition;
+        // Out of range is a no-op, matching the browser rather than throwing.
+        if (target < 0 || target >= this.entries.length)
+            return;
+        this.cursor = target;
+        this.emitPopState();
+    }
+    emitPopState() {
+        const event = { type: 'popstate', state: this.current.state };
+        for (const listener of [...this.popStateListeners])
+            listener(event);
+    }
+}
+//# sourceMappingURL=native-platform-location.js.map

package/dist/native-platform-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-platform-location.js","sourceRoot":"","sources":["../src/native-platform-location.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `PlatformLocation` over an in-memory history.\n *\n * Angular's `Location` reads and writes the URL through this. On the web the browser owns the\n * history stack; here nothing does, so we keep it ourselves and the URL tree stays the source of\n * truth in both directions: `router.navigate()` pushes an entry, and a swipe-back reaches the\n * outlet as the screen's `dismissed` event, which usually calls `historyGo(-1)` here and emits\n * `popstate` so the router follows. Not always: see the stack outlet's `popBy` for when the entry\n * behind is another tab.\n *\n * No decorators, so tests can import it at runtime and so it can be provided with `useClass`.\n */\nimport type { LocationChangeListener, PlatformLocation } from '@angular/common';\n/**\n * What the history needs of a deep-link source, which `DeepLinks` from\n * `@ng-native/device` satisfies. Structural rather than the class itself: the router has no\n * use for the rest of it, and a test has no use for a real one.\n */\nexport interface LinkSource {\n  /** The path the app was launched with, or null for a normal launch. */\n  initialUrl(): string | null;\n  /** Links that arrive while the app is running. Returns an unsubscribe. */\n  subscribe(listener: (url: string) => void): () => void;\n}\n\ninterface HistoryEntry {\n  url: string;\n  state: unknown;\n}\n\n/** Split a url into its path, `?search` and `#hash` parts. */\nfunction parse(url: string): { pathname: string; search: string; hash: string } {\n  const hashAt = url.indexOf('#');\n  const hash = hashAt === -1 ? '' : url.slice(hashAt);\n  const withoutHash = hashAt === -1 ? url : url.slice(0, hashAt);\n\n  const searchAt = withoutHash.indexOf('?');\n  const search = searchAt === -1 ? '' : withoutHash.slice(searchAt);\n  const pathname = searchAt === -1 ? withoutHash : withoutHash.slice(0, searchAt);\n\n  return { pathname: pathname || '/', search, hash };\n}\n\nexport class NativePlatformLocation implements PlatformLocation {\n  private readonly entries: HistoryEntry[] = [{ url: '/', state: null }];\n  private cursor = 0;\n\n  private readonly popStateListeners = new Set<LocationChangeListener>();\n  private readonly hashChangeListeners = new Set<LocationChangeListener>();\n\n  /**\n   * A deep link is history, not a navigation of its own: the launch url *is* the first entry,\n   * and one that arrives later is pushed and announced as a popstate, which is the only thing\n   * the router listens to. `links` is null in a test that has no interest in either.\n   */\n  constructor(links: LinkSource | null = null) {\n    const initial = links?.initialUrl();\n    if (initial) this.entries[0] = { url: initial, state: null };\n    links?.subscribe((url) => this.open(url));\n  }\n\n  /** Follow a link that arrived while the app was running. */\n  open(url: string): void {\n    if (url === this.current.url) return;\n    this.pushState(null, '', url);\n    this.emitPopState();\n  }\n\n  /**\n   * The url of the entry `offset` away from the current one, or null past either end. For the\n   * stack outlet, which has to know whether going back reaches the screen a native pop revealed.\n   */\n  ɵurlAt(offset: number): string | null {\n    return this.entries[this.cursor + offset]?.url ?? null;\n  }\n\n  private get current(): HistoryEntry {\n    return this.entries[this.cursor]!;\n  }\n\n  // --- PlatformLocation ---------------------------------------------------\n\n  getBaseHrefFromDOM(): string {\n    return '/';\n  }\n\n  getState(): unknown {\n    return this.current.state;\n  }\n\n  onPopState(fn: LocationChangeListener): VoidFunction {\n    this.popStateListeners.add(fn);\n    return () => this.popStateListeners.delete(fn);\n  }\n\n  onHashChange(fn: LocationChangeListener): VoidFunction {\n    this.hashChangeListeners.add(fn);\n    return () => this.hashChangeListeners.delete(fn);\n  }\n\n  get href(): string {\n    return this.current.url;\n  }\n\n  /** There is no origin on a device. Angular only ever compares these, never resolves them. */\n  get protocol(): string {\n    return 'app:';\n  }\n\n  get hostname(): string {\n    return '';\n  }\n\n  get port(): string {\n    return '';\n  }\n\n  get pathname(): string {\n    return parse(this.current.url).pathname;\n  }\n\n  get search(): string {\n    return parse(this.current.url).search;\n  }\n\n  get hash(): string {\n    return parse(this.current.url).hash;\n  }\n\n  pushState(state: unknown, _title: string, url: string): void {\n    // A push after going back discards the forward entries, as a browser does.\n    this.entries.length = this.cursor + 1;\n    this.entries.push({ url, state });\n    this.cursor++;\n  }\n\n  replaceState(state: unknown, _title: string, url: string): void {\n    this.entries[this.cursor] = { url, state };\n  }\n\n  forward(): void {\n    this.historyGo(1);\n  }\n\n  back(): void {\n    this.historyGo(-1);\n  }\n\n  historyGo(relativePosition = 0): void {\n    const target = this.cursor + relativePosition;\n    // Out of range is a no-op, matching the browser rather than throwing.\n    if (target < 0 || target >= this.entries.length) return;\n    this.cursor = target;\n    this.emitPopState();\n  }\n\n  private emitPopState(): void {\n    const event = { type: 'popstate', state: this.current.state };\n    for (const listener of [...this.popStateListeners]) listener(event);\n  }\n}\n"]}

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

@@ -0,0 +1,14 @@
+import { type NavigationExtras } from '@angular/router';
+import * as i0 from "@angular/core";
+export declare class NativeRouterLink {
+    /** A url string, or the command array `Router.navigate` takes. */
+    readonly nativeRouterLink: import("@angular/core").InputSignal<string | readonly unknown[]>;
+    readonly extras: import("@angular/core").InputSignal<NavigationExtras | undefined>;
+    /** Replace the current screen rather than pushing a new one. */
+    readonly replace: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    private readonly router;
+    private readonly route;
+    protected navigate(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeRouterLink, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NativeRouterLink, "[nativeRouterLink]", never, { "nativeRouterLink": { "alias": "nativeRouterLink"; "required": true; "isSignal": true; }; "extras": { "alias": "extras"; "required": false; "isSignal": true; }; "replace": { "alias": "replace"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/dist/native-router-link.js

@@ -0,0 +1,51 @@
+/**
+ * `routerLink` for native.
+ *
+ * Angular's `RouterLink` host-binds `href` and listens for a DOM click, neither of which exists
+ * here. This binds to a `<pressable>`'s `press` output instead.
+ *
+ * Because Angular resolves outputs across every directive on an element, the host listener below
+ * binds to `Pressable`'s `press` output without importing it, so the router package does not
+ * depend on the components package.
+ */
+import { Directive, booleanAttribute, inject, input } from '@angular/core';
+import { ActivatedRoute, Router } from '@angular/router';
+import { NATIVE_INTENT } from "./native-navigation.js";
+import * as i0 from "@angular/core";
+export class NativeRouterLink {
+    /** A url string, or the command array `Router.navigate` takes. */
+    nativeRouterLink = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "nativeRouterLink" }] : /* istanbul ignore next */ []));
+    extras = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "extras" }] : /* istanbul ignore next */ []));
+    /** Replace the current screen rather than pushing a new one. */
+    replace = input(false, { ...(ngDevMode ? { debugName: "replace" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    router = inject(Router);
+    route = inject(ActivatedRoute, { optional: true });
+    navigate() {
+        const target = this.nativeRouterLink();
+        const own = this.extras();
+        const extras = {
+            relativeTo: this.route,
+            replaceUrl: this.replace(),
+            ...own,
+        };
+        // `replaceUrl` only swaps the history entry. The stack reads the intent to swap the screen,
+        // as `NativeNavigation.replace` sets it; without it the replaced screen stays mounted
+        // underneath, and a swipe back lands on a page the history no longer has.
+        if (this.replace()) {
+            extras.state = { ...own?.state, [NATIVE_INTENT]: { stack: 'replace' } };
+        }
+        void this.router.navigate(Array.isArray(target) ? [...target] : [target], extras);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeRouterLink, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.2.0", type: NativeRouterLink, isStandalone: true, selector: "[nativeRouterLink]", inputs: { nativeRouterLink: { classPropertyName: "nativeRouterLink", publicName: "nativeRouterLink", isSignal: true, isRequired: true, transformFunction: null }, extras: { classPropertyName: "extras", publicName: "extras", isSignal: true, isRequired: false, transformFunction: null }, replace: { classPropertyName: "replace", publicName: "replace", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "press": "navigate()" } }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeRouterLink, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[nativeRouterLink]',
+                    host: { '(press)': 'navigate()' },
+                }]
+        }], propDecorators: { nativeRouterLink: [{ type: i0.Input, args: [{ isSignal: true, alias: "nativeRouterLink", required: true }] }], extras: [{ type: i0.Input, args: [{ isSignal: true, alias: "extras", required: false }] }], replace: [{ type: i0.Input, args: [{ isSignal: true, alias: "replace", required: false }] }] } });
+//# sourceMappingURL=native-router-link.js.map

package/dist/native-router-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-router-link.js","sourceRoot":"","sources":["../src/native-router-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,EAAyB,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;;AAMvD,MAAM,OAAO,gBAAgB;IAC3B,kEAAkE;IACzD,gBAAgB,GAAG,KAAK,CAAC,QAAQ;yFAA+B,CAAC;IACjE,MAAM,GAAG,KAAK;0FAAoB,CAAC;IAE5C,gEAAgE;IACvD,OAAO,GAAG,KAAK,CAAC,KAAK,+EAAI,SAAS,EAAE,gBAAgB,GAAG,CAAC;IAEhD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,QAAQ;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAqB;YAC/B,UAAU,EAAE,IAAI,CAAC,KAAK;YACtB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE;YAC1B,GAAG,GAAG;SACP,CAAC;QACF,4FAA4F;QAC5F,sFAAsF;QACtF,0EAA0E;QAC1E,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;QAC1E,CAAC;QAED,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;uGA3BU,gBAAgB;2FAAhB,gBAAgB;;2FAAhB,gBAAgB;kBAJ5B,SAAS;mBAAC;oBACT,QAAQ,EAAE,oBAAoB;oBAC9B,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;iBAClC","sourcesContent":["/**\n * `routerLink` for native.\n *\n * Angular's `RouterLink` host-binds `href` and listens for a DOM click, neither of which exists\n * here. This binds to a `<pressable>`'s `press` output instead.\n *\n * Because Angular resolves outputs across every directive on an element, the host listener below\n * binds to `Pressable`'s `press` output without importing it, so the router package does not\n * depend on the components package.\n */\nimport { Directive, booleanAttribute, inject, input } from '@angular/core';\nimport { ActivatedRoute, Router, type NavigationExtras } from '@angular/router';\nimport { NATIVE_INTENT } from './native-navigation.ts';\n\n@Directive({\n  selector: '[nativeRouterLink]',\n  host: { '(press)': 'navigate()' },\n})\nexport class NativeRouterLink {\n  /** A url string, or the command array `Router.navigate` takes. */\n  readonly nativeRouterLink = input.required<string | readonly unknown[]>();\n  readonly extras = input<NavigationExtras>();\n\n  /** Replace the current screen rather than pushing a new one. */\n  readonly replace = input(false, { transform: booleanAttribute });\n\n  private readonly router = inject(Router);\n  private readonly route = inject(ActivatedRoute, { optional: true });\n\n  protected navigate(): void {\n    const target = this.nativeRouterLink();\n    const own = this.extras();\n    const extras: NavigationExtras = {\n      relativeTo: this.route,\n      replaceUrl: this.replace(),\n      ...own,\n    };\n    // `replaceUrl` only swaps the history entry. The stack reads the intent to swap the screen,\n    // as `NativeNavigation.replace` sets it; without it the replaced screen stays mounted\n    // underneath, and a swipe back lands on a page the history no longer has.\n    if (this.replace()) {\n      extras.state = { ...own?.state, [NATIVE_INTENT]: { stack: 'replace' } };\n    }\n\n    void this.router.navigate(Array.isArray(target) ? [...target] : [target], extras);\n  }\n}\n"]}

package/dist/native-search-bar.d.ts

@@ -0,0 +1,44 @@
+import * as i0 from "@angular/core";
+/** react-native-screens' placements for the navigation bar's search field. */
+export type SearchBarPlacement = 'automatic' | 'inline' | 'stacked' | 'integrated' | 'integratedButton' | 'integratedCentered';
+export declare class NativeSearchBar {
+    readonly query: import("@angular/core").ModelSignal<string>;
+    readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
+    /** Scroll the field away with the content, as iOS lists do by default. */
+    readonly hideWhenScrolling: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    readonly cancelButtonText: import("@angular/core").InputSignal<string | undefined>;
+    /**
+     * Where iOS puts the field. `automatic` lets iOS 26 fold it into a toolbar, which a presented
+     * sheet does not have, so there it shows nowhere; `stacked` keeps it under the title.
+     */
+    readonly placement: import("@angular/core").InputSignal<SearchBarPlacement | undefined>;
+    /** iOS 26: whether `automatic` may move the field into the toolbar. */
+    readonly allowToolbarIntegration: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    readonly autoCapitalize: import("@angular/core").InputSignal<"none" | "systemDefault" | "words" | "sentences" | "characters" | undefined>;
+    /** Dim the content behind the field while it is being typed in. */
+    readonly obscureBackground: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    /** Hide the navigation bar while the field is being typed in. */
+    readonly hideNavigationBar: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    readonly tintColor: import("@angular/core").InputSignal<string | undefined>;
+    readonly textColor: import("@angular/core").InputSignal<string | undefined>;
+    /** The keyboard's search key was pressed, with the text in the field. */
+    readonly search: import("@angular/core").OutputEmitterRef<string>;
+    /** The Cancel button was pressed. */
+    readonly cancel: import("@angular/core").OutputEmitterRef<void>;
+    readonly searchFocus: import("@angular/core").OutputEmitterRef<void>;
+    readonly searchBlur: import("@angular/core").OutputEmitterRef<void>;
+    private readonly node;
+    private readonly engine;
+    /** What the field last said it holds, to tell a query set from code from the field's echo. */
+    private fieldText;
+    constructor();
+    focus(): void;
+    blur(): void;
+    /** Empty the field, and the query with it. */
+    clear(): void;
+    /** Close the search, as the Cancel button does. */
+    cancelSearch(): void;
+    protected onNativeText(text: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeSearchBar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NativeSearchBar, "native-search-bar", never, { "query": { "alias": "query"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hideWhenScrolling": { "alias": "hideWhenScrolling"; "required": false; "isSignal": true; }; "cancelButtonText": { "alias": "cancelButtonText"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "allowToolbarIntegration": { "alias": "allowToolbarIntegration"; "required": false; "isSignal": true; }; "autoCapitalize": { "alias": "autoCapitalize"; "required": false; "isSignal": true; }; "obscureBackground": { "alias": "obscureBackground"; "required": false; "isSignal": true; }; "hideNavigationBar": { "alias": "hideNavigationBar"; "required": false; "isSignal": true; }; "tintColor": { "alias": "tintColor"; "required": false; "isSignal": true; }; "textColor": { "alias": "textColor"; "required": false; "isSignal": true; }; }, { "query": "queryChange"; "search": "search"; "cancel": "cancel"; "searchFocus": "searchFocus"; "searchBlur": "searchBlur"; }, never, never, true, never>;
+}