@symbiote-native/navigation 1.0.0

package/build/angular/navigation-scope.directive.js

@@ -0,0 +1,90 @@
+// The Angular twin of react/navigation-context.ts's `NavigationContext.Provider` usage in
+// stack.ts/tabs.ts/drawer.ts's render loops: one directive instance = one fresh scope. Applying
+// `[symbioteNavigationScope]` to an element re-`providers: [NavigationContextService]`
+// (component/directive-level DI), so every usage mints its OWN service instance - the DI twin of
+// `createElement(NavigationContext.Provider, { value }, content)`. Descendants (a screen's own
+// component tree, reached through `*ngComponentOutlet`) call `inject(NavigationContextService)`
+// and resolve to the NEAREST enclosing instance, exactly like `useContext(NavigationContext)`
+// walks to the nearest Provider.
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Directive, Input, inject } from '@angular/core';
+import { NavigationContextService } from './navigation-context.service.js';
+let NavigationScopeDirective = (() => {
+    let _classDecorators = [Directive({
+            selector: '[symbioteNavigationScope]',
+            standalone: true,
+            providers: [NavigationContextService],
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _route_decorators;
+    let _route_initializers = [];
+    let _route_extraInitializers = [];
+    let _navigation_decorators;
+    let _navigation_initializers = [];
+    let _navigation_extraInitializers = [];
+    let _emitter_decorators;
+    let _emitter_initializers = [];
+    let _emitter_extraInitializers = [];
+    var NavigationScopeDirective = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _route_decorators = [Input({ required: true, alias: 'symbioteNavigationScope' })];
+            _navigation_decorators = [Input({ required: true })];
+            _emitter_decorators = [Input({ required: true })];
+            __esDecorate(null, null, _route_decorators, { kind: "field", name: "route", static: false, private: false, access: { has: obj => "route" in obj, get: obj => obj.route, set: (obj, value) => { obj.route = value; } }, metadata: _metadata }, _route_initializers, _route_extraInitializers);
+            __esDecorate(null, null, _navigation_decorators, { kind: "field", name: "navigation", static: false, private: false, access: { has: obj => "navigation" in obj, get: obj => obj.navigation, set: (obj, value) => { obj.navigation = value; } }, metadata: _metadata }, _navigation_initializers, _navigation_extraInitializers);
+            __esDecorate(null, null, _emitter_decorators, { kind: "field", name: "emitter", static: false, private: false, access: { has: obj => "emitter" in obj, get: obj => obj.emitter, set: (obj, value) => { obj.emitter = value; } }, metadata: _metadata }, _emitter_initializers, _emitter_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            NavigationScopeDirective = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        route = __runInitializers(this, _route_initializers, void 0);
+        navigation = (__runInitializers(this, _route_extraInitializers), __runInitializers(this, _navigation_initializers, void 0));
+        emitter = (__runInitializers(this, _navigation_extraInitializers), __runInitializers(this, _emitter_initializers, void 0));
+        context = (__runInitializers(this, _emitter_extraInitializers), inject(NavigationContextService));
+        ngOnChanges() {
+            this.context.setRoute(this.route);
+            this.context.navigation = this.navigation;
+            this.context.emitter = this.emitter;
+        }
+    };
+    return NavigationScopeDirective = _classThis;
+})();
+export { NavigationScopeDirective };

package/build/angular/screen.directive.d.ts

@@ -0,0 +1,22 @@
+import { type Type } from '@angular/core';
+import type { ISearchBarCommands, ISearchBarOptions, IScreenOptions, IRoute } from '../core';
+import type { INavigatorHandle } from '../core';
+export type IAngularSearchBarOptions = ISearchBarOptions & {
+    ref?: {
+        current: ISearchBarCommands | null;
+    };
+};
+export type IAngularScreenOptions = Omit<IScreenOptions, 'headerSearchBarOptions'> & {
+    headerSearchBarOptions?: IAngularSearchBarOptions;
+};
+export type IScreenOptionsArgs = {
+    route: IRoute<unknown>;
+    navigation: INavigatorHandle;
+};
+export type IScreenOptionsResolver = (args: IScreenOptionsArgs) => IAngularScreenOptions;
+export declare class ScreenDirective {
+    name: string;
+    component: Type<unknown>;
+    options?: IAngularScreenOptions | IScreenOptionsResolver;
+    initialParams?: unknown;
+}

package/build/angular/screen.directive.js

@@ -0,0 +1,90 @@
+// [symbioteScreen]: a declarative marker, never rendered on its own - Stack reads its inputs via
+// @ContentChildren to build the static name -> {component, options} registry, then mounts the
+// registered component itself for each pushed route. Angular's twin of react/screen.ts's Screen
+// marker component; mirrors Angular Material's own `@ContentChildren(MatTab) tabs: QueryList<MatTab>`
+// pattern (a directive applied to an inert `<ng-template>`, never instantiated as a view - see
+// stack.ts's header for why that's safe: @ContentChildren resolves the light-DOM declaration,
+// independent of whether the template is ever instantiated).
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Directive, Input } from '@angular/core';
+let ScreenDirective = (() => {
+    let _classDecorators = [Directive({
+            selector: 'ng-template[symbioteScreen]',
+            standalone: true,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _component_decorators;
+    let _component_initializers = [];
+    let _component_extraInitializers = [];
+    let _options_decorators;
+    let _options_initializers = [];
+    let _options_extraInitializers = [];
+    let _initialParams_decorators;
+    let _initialParams_initializers = [];
+    let _initialParams_extraInitializers = [];
+    var ScreenDirective = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _name_decorators = [Input({ required: true })];
+            _component_decorators = [Input({ required: true })];
+            _options_decorators = [Input()];
+            _initialParams_decorators = [Input()];
+            __esDecorate(null, null, _name_decorators, { kind: "field", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(null, null, _component_decorators, { kind: "field", name: "component", static: false, private: false, access: { has: obj => "component" in obj, get: obj => obj.component, set: (obj, value) => { obj.component = value; } }, metadata: _metadata }, _component_initializers, _component_extraInitializers);
+            __esDecorate(null, null, _options_decorators, { kind: "field", name: "options", static: false, private: false, access: { has: obj => "options" in obj, get: obj => obj.options, set: (obj, value) => { obj.options = value; } }, metadata: _metadata }, _options_initializers, _options_extraInitializers);
+            __esDecorate(null, null, _initialParams_decorators, { kind: "field", name: "initialParams", static: false, private: false, access: { has: obj => "initialParams" in obj, get: obj => obj.initialParams, set: (obj, value) => { obj.initialParams = value; } }, metadata: _metadata }, _initialParams_initializers, _initialParams_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            ScreenDirective = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        name = __runInitializers(this, _name_initializers, void 0);
+        component = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _component_initializers, void 0));
+        options = (__runInitializers(this, _component_extraInitializers), __runInitializers(this, _options_initializers, void 0));
+        initialParams = (__runInitializers(this, _options_extraInitializers), __runInitializers(this, _initialParams_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _initialParams_extraInitializers);
+        }
+    };
+    return ScreenDirective = _classThis;
+})();
+export { ScreenDirective };

package/build/angular/search-bar-ref.directive.d.ts

@@ -0,0 +1,10 @@
+import { type OnDestroy, type OnInit } from '@angular/core';
+import type { ISearchBarCommands } from '../core';
+export declare class SearchBarRefDirective implements OnInit, OnDestroy {
+    ref: {
+        current: ISearchBarCommands | null;
+    } | undefined;
+    private readonly elementRef;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+}

package/build/angular/search-bar-ref.directive.js

@@ -0,0 +1,88 @@
+// Assigns the app-supplied `headerSearchBarOptions.ref` (a plain `{ current }` cell - see
+// screen.directive.ts's IAngularSearchBarOptions) once the RNSSearchBar native node exists.
+// Angular's twin of react/stack.ts's callback `ref` prop on the RNSSearchBar element: a directive
+// applied directly onto the raw `<RNSSearchBar>` tag can `inject(ElementRef)` the same way
+// SymbioteHostPropsDirective does (primitives/shared.ts's own pattern) - ElementRef.nativeElement
+// is the real engine node the moment the element is created (synchronous, no whenCommitted wait
+// needed here: buildSearchBarHandle's own methods are already a LAZY getter over the node,
+// tolerant of the node existing-but-not-yet-committed, same contract every adapter shares).
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Directive, Input, inject, ElementRef } from '@angular/core';
+import { isSymbioteNode, dlog, debugNodeId } from '@symbiote-native/engine';
+import { buildSearchBarHandle } from '../core/index.js';
+let SearchBarRefDirective = (() => {
+    let _classDecorators = [Directive({
+            selector: '[symbioteSearchBarRef]',
+            standalone: true,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _ref_decorators;
+    let _ref_initializers = [];
+    let _ref_extraInitializers = [];
+    var SearchBarRefDirective = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _ref_decorators = [Input('symbioteSearchBarRef')];
+            __esDecorate(null, null, _ref_decorators, { kind: "field", name: "ref", static: false, private: false, access: { has: obj => "ref" in obj, get: obj => obj.ref, set: (obj, value) => { obj.ref = value; } }, metadata: _metadata }, _ref_initializers, _ref_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            SearchBarRefDirective = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        ref = __runInitializers(this, _ref_initializers, void 0);
+        elementRef = (__runInitializers(this, _ref_extraInitializers), inject(ElementRef));
+        ngOnInit() {
+            if (!this.ref)
+                return;
+            const node = this.elementRef.nativeElement;
+            if (!isSymbioteNode(node)) {
+                this.ref.current = null;
+                return;
+            }
+            dlog(`SearchBarRefDirective: attached to node=${debugNodeId(node)}`);
+            this.ref.current = buildSearchBarHandle(() => node);
+        }
+        ngOnDestroy() {
+            if (this.ref)
+                this.ref.current = null;
+        }
+    };
+    return SearchBarRefDirective = _classThis;
+})();
+export { SearchBarRefDirective };

package/build/angular/stack/index.d.ts

@@ -0,0 +1,55 @@
+import { type AfterContentInit, type OnDestroy, type Type } from '@angular/core';
+import type { INavigationEmitter, INavigatorHandle, INavigatorState, IRoute, ISearchBarCommands } from '../../core';
+import type { IAngularScreenOptions } from '../screen.directive';
+export type { INavigatorHandle } from '../../core';
+export declare class Stack implements AfterContentInit, OnDestroy, INavigatorHandle {
+    private readonly screenChildren;
+    initialRouteName?: string;
+    screenOptions?: IAngularScreenOptions;
+    readonly headerSubviewProps: Record<string, unknown>;
+    private readonly routeIdPrefix;
+    private readonly registry;
+    private readonly emitters;
+    private readonly planCache;
+    private routeSequence;
+    private screenChildrenSubscription;
+    private readonly stateSignal;
+    readonly state: import("@angular/core").Signal<Readonly<{
+        routes: readonly Readonly<{
+            key: string;
+            name: string;
+            params: unknown;
+        }>[];
+    }> | undefined>;
+    readonly push: (name: string, params?: unknown) => void;
+    readonly pop: (count?: number) => void;
+    readonly popToTop: () => void;
+    readonly popTo: (key: string) => void;
+    readonly replace: (name: string, params?: unknown) => void;
+    readonly setParams: (params: unknown, key?: string) => void;
+    readonly reset: (nextState: INavigatorState) => void;
+    readonly canGoBack: () => boolean;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    private rebuildRegistry;
+    private initializeState;
+    private createRoute;
+    private dispatch;
+    emitterFor(routeKey: string): INavigationEmitter;
+    private mergedOptionsFor;
+    componentFor(route: IRoute<unknown>): Type<unknown> | null;
+    stackHostProps(): Record<string, unknown>;
+    private planFor;
+    outerScreenIsModal(route: IRoute<unknown>, index: number): boolean;
+    isInModal(route: IRoute<unknown>, index: number): boolean;
+    screenHostProps(route: IRoute<unknown>, index: number): Record<string, unknown>;
+    innerStackProps(): Record<string, unknown>;
+    innerScreenProps(route: IRoute<unknown>, index: number): Record<string, unknown>;
+    contentWrapperProps(route: IRoute<unknown>, index: number): Record<string, unknown>;
+    headerConfigProps(route: IRoute<unknown>, index: number): Record<string, unknown>;
+    hasSearchBar(route: IRoute<unknown>): boolean;
+    searchBarRef(route: IRoute<unknown>): {
+        current: ISearchBarCommands | null;
+    } | undefined;
+    searchBarProps(route: IRoute<unknown>, index: number): Record<string, unknown>;
+}