@franzzemen/brokenstock-shell 0.0.27 → 0.0.28

package/fesm2022/franzzemen-brokenstock-shell.mjs

@@ -1,14 +1,17 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, makeEnvironmentProviders, signal, computed, Injectable, inject, input, Directive, NgZone, effect, Component, viewChild, afterNextRender } from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, signal, computed, Injectable, inject, input, Directive, isDevMode, effect, untracked, HostListener, ViewChild, ChangeDetectionStrategy, Component, NgZone, viewChild, afterNextRender } from '@angular/core';
 import * as i2$1 from '@angular/router';
-import { Router, RouterLink, RouterLinkActive, RouterOutlet } from '@angular/router';
+import { Router, RouterLink, RouterLinkActive, RouterOutlet, ActivatedRoute } from '@angular/router';
 import { HttpHeader, BEARER_TOKEN_REGEX, USERNAME_REGEX, PASSWORD_REGEX } from '@franzzemen/utility';
 import { validateCredentials } from '@franzzemen/identity';
 import { HttpClient } from '@angular/common/http';
-import { tap, catchError, from, switchMap, throwError } from 'rxjs';
+import { tap, catchError, from, switchMap, throwError, firstValueFrom } from 'rxjs';
 import * as i3 from '@angular/forms';
 import { NG_VALIDATORS, FormsModule } from '@angular/forms';
-import { DOCUMENT, DatePipe } from '@angular/common';
+import { Marked } from 'marked';
+import { gfmHeadingId } from 'marked-gfm-heading-id';
+import fm from 'front-matter';
+import { NgClass, DOCUMENT, DatePipe } from '@angular/common';
 import { z } from 'zod/v4';
 import * as i1 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
@@ -241,13 +244,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImpo
             args: [{ providedIn: 'root' }]
         }] });
 
-const authGuard = () => {
+const authGuard = (_route, state) => {
     const authService = inject(AuthenticationService);
     const router = inject(Router);
     if (authService.authenticated()) {
         return true;
     }
-    return router.createUrlTree(['/login']);
+    return router.createUrlTree(['/login'], {
+        queryParams: { returnUrl: state.url },
+    });
 };
 
 const guestGuard = () => {
@@ -319,6 +324,918 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImpo
                 }]
         }], propDecorators: { regex: [{ type: i0.Input, args: [{ isSignal: true, alias: "regex", required: false }] }] } });
 
+/**
+ * Shared types for the FAQ help system.
+ *
+ * Manifest is generated by the build-time validator (E9) and read at runtime
+ * by FaqContentLoader (E1) and FaqService (E2).
+ */
+
+const FAQ_CONTENT_LOADER = new InjectionToken('FAQ_CONTENT_LOADER');
+
+/**
+ * Stateless markdown renderer for FAQ content.
+ *
+ * Two responsibilities:
+ *   1. Split a `.md` file into `{ frontmatter, body }` (front-matter parser).
+ *   2. Render the body to HTML via marked with a context-aware link hook:
+ *      - `faq:<key>`     — in-modal nav (modal) | `<a href="/help/<file>">` (page)
+ *      - `app:/path`     — close-modal-and-route (modal) | `<a href="/path">` (page)
+ *      - `http(s)://...` — external, target=_blank rel=noopener (both)
+ *      - `#anchor`       — intra-page scroll (both)
+ *
+ * In modal context, links are emitted with `data-faq-href` / `data-faq-kind`
+ * sentinels so the modal's click handler (E5) can intercept and dispatch.
+ * In page context, links are emitted as plain navigable anchors; the prerendered
+ * static HTML can be clicked through directly.
+ */
+class FaqMarkdownRendererService {
+    parse(raw) {
+        const parsed = fm(raw);
+        return {
+            frontmatter: parsed.attributes,
+            body: parsed.body,
+        };
+    }
+    render(body, opts) {
+        const marked = new Marked({ gfm: true, breaks: false });
+        marked.use(gfmHeadingId());
+        marked.use({ renderer: this.buildRenderer(opts) });
+        return marked.parse(body, { async: false });
+    }
+    buildRenderer(opts) {
+        const { context, imagePrefix } = opts;
+        return {
+            link: ({ href, title, tokens }) => {
+                // marked passes child tokens; we render their textual form ourselves.
+                const text = tokens.map((t) => ('text' in t ? t.text : '')).join('');
+                const titleAttr = title ? ` title="${escapeAttr(title)}"` : '';
+                // Intra-page anchor
+                if (href.startsWith('#')) {
+                    return `<a href="${escapeAttr(href)}"${titleAttr} data-faq-kind="anchor">${text}</a>`;
+                }
+                // faq: protocol — in-modal nav (modal) | static link to /help/<key path> (page)
+                if (href.startsWith('faq:')) {
+                    const key = href.slice('faq:'.length);
+                    if (context === 'modal') {
+                        return `<a href="#" data-faq-href="${escapeAttr(href)}" data-faq-kind="faq">${text}</a>`;
+                    }
+                    const filePath = key.replace(/\./g, '/');
+                    return `<a href="/help/${escapeAttr(filePath)}"${titleAttr} data-faq-kind="faq">${text}</a>`;
+                }
+                // app: protocol — close modal + route (modal) | normal anchor (page)
+                if (href.startsWith('app:')) {
+                    const path = href.slice('app:'.length);
+                    if (context === 'modal') {
+                        return `<a href="#" data-faq-href="${escapeAttr(href)}" data-faq-kind="app">${text} <span class="faq-app-arrow" aria-hidden="true">→</span></a>`;
+                    }
+                    return `<a href="${escapeAttr(path)}"${titleAttr} data-faq-kind="app">${text} <span class="faq-app-arrow" aria-hidden="true">→</span></a>`;
+                }
+                // External
+                if (/^https?:\/\//i.test(href)) {
+                    return `<a href="${escapeAttr(href)}"${titleAttr} target="_blank" rel="noopener" data-faq-kind="external">${text}</a>`;
+                }
+                // Fallback: treat as relative; render plain anchor.
+                return `<a href="${escapeAttr(href)}"${titleAttr}>${text}</a>`;
+            },
+            image: ({ href, title, text }) => {
+                const resolved = resolveImageHref(href, imagePrefix);
+                const titleAttr = title ? ` title="${escapeAttr(title)}"` : '';
+                return `<img src="${escapeAttr(resolved)}" alt="${escapeAttr(text)}"${titleAttr} loading="lazy" />`;
+            },
+        };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqMarkdownRendererService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqMarkdownRendererService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqMarkdownRendererService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+function escapeAttr(s) {
+    return s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+}
+function resolveImageHref(href, prefix) {
+    if (!prefix)
+        return href;
+    if (/^([a-z]+:)?\/\//i.test(href) || href.startsWith('/'))
+        return href;
+    const cleaned = prefix.endsWith('/') ? prefix : `${prefix}/`;
+    return `${cleaned}${href}`;
+}
+
+/**
+ * Default FaqContentLoader. Reads the build-generated manifest from
+ * `/assets/faq/manifest.json` and lazy-fetches individual `.md` files
+ * from `/assets/faq/<entry.file>.md`.
+ *
+ * Manifest is cached after first load; .md fetches are cached per key.
+ */
+class HttpFaqContentLoader {
+    constructor() {
+        this.http = inject(HttpClient);
+        this.manifestPromise = null;
+        this.contentCache = new Map();
+    }
+    loadManifest() {
+        if (!this.manifestPromise) {
+            this.manifestPromise = firstValueFrom(this.http.get('/assets/faq/manifest.json')).catch((err) => {
+                this.manifestPromise = null;
+                throw err;
+            });
+        }
+        return this.manifestPromise;
+    }
+    async loadContent(key) {
+        const cached = this.contentCache.get(key);
+        if (cached)
+            return cached;
+        const manifest = await this.loadManifest();
+        const entry = manifest.entries.find((e) => e.key === key);
+        if (!entry)
+            return null;
+        const fetchPromise = firstValueFrom(this.http.get(`/assets/faq/${entry.file}.md`, { responseType: 'text' })).catch(() => null);
+        this.contentCache.set(key, fetchPromise);
+        return fetchPromise;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: HttpFaqContentLoader, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: HttpFaqContentLoader, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: HttpFaqContentLoader, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * E8 — In-modal navigation history.
+ *
+ * The browser's `history` API is shared by Angular Router and any other
+ * code that calls `pushState`. We tag each FAQ entry's state object with
+ * `faq: true` so we can distinguish our entries from router/app entries.
+ *
+ * On open: `pushState({faq:true, faqPosition:0})` once; stack=[initialKey].
+ * On in-modal nav: truncate forward, push key, `pushState({faq:true,
+ *   faqPosition:position})`.
+ * On browser back/forward (`popstate`):
+ *   - If next state has `faq:true` → set position to its `faqPosition`,
+ *     swap content for `stack[position]`.
+ *   - If next state lacks `faq:true` (user backed out of the modal entirely)
+ *     → close modal without further history manipulation.
+ * On explicit close (close button / Esc / backdrop): `history.go(-(position+1))`
+ *   to unwind our entries; suppress in-flight popstates while unwinding;
+ *   finalize close once we've seen the expected number of popstates.
+ */
+class FaqHistoryService {
+    constructor() {
+        this._stack = signal([], ...(ngDevMode ? [{ debugName: "_stack" }] : /* istanbul ignore next */ []));
+        this._position = signal(0, ...(ngDevMode ? [{ debugName: "_position" }] : /* istanbul ignore next */ []));
+        this.stack = this._stack.asReadonly();
+        this.position = this._position.asReadonly();
+        /** True when popstate is processing the unwind kicked off by closeAndUnwind(). */
+        this.unwinding = false;
+        this.unwindRemaining = 0;
+        this.onUnwindComplete = null;
+        this.popstateListener = null;
+        this.onInModalNav = null;
+        this.onExitModal = null;
+    }
+    /**
+     * Begin a new FAQ history session. Pushes the initial state entry and
+     * starts listening for popstate. Callbacks fire for in-modal navs and
+     * for popping out of FAQ entirely.
+     */
+    begin(initialKey, onNav, onExit) {
+        this._stack.set([initialKey]);
+        this._position.set(0);
+        this.onInModalNav = onNav;
+        this.onExitModal = onExit;
+        this.pushHistoryState(0);
+        this.attachListener();
+    }
+    /** Push a new key onto the stack. Truncates any forward history. */
+    navigate(key) {
+        const stack = this._stack();
+        const pos = this._position();
+        const next = [...stack.slice(0, pos + 1), key];
+        const nextPos = next.length - 1;
+        this._stack.set(next);
+        this._position.set(nextPos);
+        this.pushHistoryState(nextPos);
+    }
+    canGoBack() {
+        return this._position() > 0;
+    }
+    canGoForward() {
+        return this._position() < this._stack().length - 1;
+    }
+    /** Programmatic back — triggers a real browser back so popstate handles UI. */
+    back() {
+        if (!this.canGoBack())
+            return;
+        history.back();
+    }
+    forward() {
+        if (!this.canGoForward())
+            return;
+        history.forward();
+    }
+    /** Currently rendered key. */
+    currentKey() {
+        return this._stack()[this._position()] ?? null;
+    }
+    /**
+     * Close the modal cleanly by unwinding our FAQ history entries so the
+     * underlying app route is left exactly where it was before the modal opened.
+     * `onComplete` fires after the unwind settles.
+     */
+    closeAndUnwind(onComplete) {
+        const depth = this._position() + 1;
+        if (depth === 0) {
+            this.teardown();
+            onComplete();
+            return;
+        }
+        this.unwinding = true;
+        this.unwindRemaining = depth;
+        this.onUnwindComplete = () => {
+            this.teardown();
+            onComplete();
+        };
+        history.go(-depth);
+    }
+    teardown() {
+        this._stack.set([]);
+        this._position.set(0);
+        this.detachListener();
+        this.onInModalNav = null;
+        this.onExitModal = null;
+        this.unwinding = false;
+        this.unwindRemaining = 0;
+        this.onUnwindComplete = null;
+    }
+    pushHistoryState(position) {
+        history.pushState({ faq: true, faqPosition: position }, '');
+    }
+    attachListener() {
+        if (this.popstateListener)
+            return;
+        this.popstateListener = (e) => this.handlePopState(e);
+        window.addEventListener('popstate', this.popstateListener);
+    }
+    detachListener() {
+        if (!this.popstateListener)
+            return;
+        window.removeEventListener('popstate', this.popstateListener);
+        this.popstateListener = null;
+    }
+    handlePopState(e) {
+        if (this.unwinding) {
+            this.unwindRemaining--;
+            if (this.unwindRemaining <= 0) {
+                const cb = this.onUnwindComplete;
+                this.onUnwindComplete = null;
+                cb?.();
+            }
+            return;
+        }
+        const state = e.state;
+        if (state?.faq && typeof state.faqPosition === 'number') {
+            // In-modal back/forward
+            const target = state.faqPosition;
+            this._position.set(target);
+            const key = this._stack()[target];
+            if (key && this.onInModalNav)
+                this.onInModalNav(key);
+            return;
+        }
+        // User backed out beyond our entries — close modal, leave history alone.
+        const exit = this.onExitModal;
+        this.teardown();
+        exit?.();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqHistoryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqHistoryService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqHistoryService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Central FAQ state + resolution service.
+ *
+ * Responsibilities:
+ *  - Track the current route's FAQ key (set by components on activation /
+ *    tab change via `register()`).
+ *  - Lazy-load and cache the FAQ manifest from the configured FaqContentLoader.
+ *  - Resolve a dot-notation key against the manifest with parent fallback,
+ *    audience filtering, and `index` as the terminal fallback.
+ */
+class FaqService {
+    constructor() {
+        this.loader = inject(FAQ_CONTENT_LOADER);
+        this.history = inject(FaqHistoryService);
+        this.auth = inject(AuthenticationService);
+        this._currentFaqKey = signal(null, ...(ngDevMode ? [{ debugName: "_currentFaqKey" }] : /* istanbul ignore next */ []));
+        /** Component-set current key. Bare `faq` opens at this key. */
+        this.currentFaqKey = this._currentFaqKey.asReadonly();
+        this._manifest = signal(null, ...(ngDevMode ? [{ debugName: "_manifest" }] : /* istanbul ignore next */ []));
+        this.manifest = this._manifest.asReadonly();
+        this.entries = computed(() => this._manifest()?.entries ?? [], ...(ngDevMode ? [{ debugName: "entries" }] : /* istanbul ignore next */ []));
+        // Modal state (E3 + E8).
+        this._modalOpen = signal(false, ...(ngDevMode ? [{ debugName: "_modalOpen" }] : /* istanbul ignore next */ []));
+        this.modalOpen = this._modalOpen.asReadonly();
+        this._activeEntry = signal(null, ...(ngDevMode ? [{ debugName: "_activeEntry" }] : /* istanbul ignore next */ []));
+        this.activeEntry = this._activeEntry.asReadonly();
+        this._activeContent = signal(null, ...(ngDevMode ? [{ debugName: "_activeContent" }] : /* istanbul ignore next */ []));
+        this.activeContent = this._activeContent.asReadonly();
+        this._activeAttempted = signal([], ...(ngDevMode ? [{ debugName: "_activeAttempted" }] : /* istanbul ignore next */ []));
+        this.activeAttempted = this._activeAttempted.asReadonly();
+        this._navigating = signal(false, ...(ngDevMode ? [{ debugName: "_navigating" }] : /* istanbul ignore next */ []));
+        this.navigating = this._navigating.asReadonly();
+        // Search pre-fill consumed by E4 search UI on modal open / navigateTo.
+        this._initialSearchTerm = signal(null, ...(ngDevMode ? [{ debugName: "_initialSearchTerm" }] : /* istanbul ignore next */ []));
+        this.initialSearchTerm = this._initialSearchTerm.asReadonly();
+        this.canGoBack = computed(() => this.history.position() > 0, ...(ngDevMode ? [{ debugName: "canGoBack" }] : /* istanbul ignore next */ []));
+        this.canGoForward = computed(() => this.history.position() < this.history.stack().length - 1, ...(ngDevMode ? [{ debugName: "canGoForward" }] : /* istanbul ignore next */ []));
+        this.manifestPromise = null;
+    }
+    /** Called by the search UI once it has consumed the pre-fill term. */
+    consumeInitialSearchTerm() {
+        this._initialSearchTerm.set(null);
+    }
+    /**
+     * Triggers manifest load if not already loaded. Idempotent. Subsequent
+     * calls return the cached promise.
+     */
+    ensureManifest() {
+        if (this._manifest())
+            return Promise.resolve(this._manifest());
+        if (!this.manifestPromise) {
+            this.manifestPromise = this.loader
+                .loadManifest()
+                .then((m) => {
+                this._manifest.set(m);
+                return m;
+            })
+                .catch((err) => {
+                this.manifestPromise = null;
+                throw err;
+            });
+        }
+        return this.manifestPromise;
+    }
+    /**
+     * Walks the dot-notation fallback chain (`a.b.c` → `a.b` → `a` → `index`)
+     * and returns the first entry whose audience allows the caller and whose
+     * content loads. Audience filtering: unauthenticated callers only see
+     * `audience: public` entries.
+     */
+    async resolveKey(key, isAuthenticated) {
+        await this.ensureManifest();
+        const entries = this.entries();
+        const chain = buildFallbackChain(key);
+        for (const candidate of chain) {
+            const entry = entries.find((e) => e.key === candidate);
+            if (!entry)
+                continue;
+            if (!audienceAllowed(entry.audience, isAuthenticated))
+                continue;
+            const content = await this.loader.loadContent(entry.key);
+            if (content === null)
+                continue;
+            return { key: entry.key, content, entry, attempted: chain };
+        }
+        return { key: null, content: null, entry: null, attempted: chain };
+    }
+    /**
+     * Component registration. Sets `currentFaqKey`; on `deregister()` the
+     * key is cleared only if it still matches (so a sibling tab activating
+     * mid-teardown doesn't get its key clobbered).
+     */
+    register(key) {
+        this._currentFaqKey.set(key);
+        return {
+            deregister: () => {
+                if (this._currentFaqKey() === key)
+                    this._currentFaqKey.set(null);
+            },
+        };
+    }
+    /**
+     * E3 — Open the FAQ modal. If `initialKey` is omitted, falls back to
+     * `currentFaqKey` and then to `'index'`. Resolves the key, loads content,
+     * and starts an E8 history session so subsequent in-modal nav uses
+     * `history.pushState`.
+     */
+    async openModal(initialKey, opts) {
+        const searchTerm = opts?.searchTerm?.trim();
+        this._initialSearchTerm.set(searchTerm && searchTerm.length > 0 ? searchTerm : null);
+        if (this._modalOpen()) {
+            // Already open — treat as a navigate-to instead.
+            if (initialKey)
+                await this.navigateTo(initialKey);
+            return;
+        }
+        const target = initialKey ?? this._currentFaqKey() ?? 'index';
+        this._modalOpen.set(true);
+        await this.loadIntoActive(target);
+        const resolved = this._activeEntry()?.key ?? target;
+        this.history.begin(resolved, (key) => {
+            // popstate-driven in-modal nav: load without pushing a new entry.
+            void this.loadIntoActive(key);
+        }, () => {
+            // User backed out of FAQ history entirely — close without unwinding.
+            this.finalizeClose();
+        });
+    }
+    /**
+     * Programmatic in-modal nav. Pushes a new history entry and loads `key`
+     * into the active slot. Use this for click handlers on `faq:` links and
+     * for the TOC sidebar.
+     */
+    async navigateTo(key) {
+        if (!this._modalOpen()) {
+            await this.openModal(key);
+            return;
+        }
+        await this.loadIntoActive(key);
+        const resolved = this._activeEntry()?.key ?? key;
+        this.history.navigate(resolved);
+    }
+    back() {
+        this.history.back();
+    }
+    forward() {
+        this.history.forward();
+    }
+    /**
+     * Close button / Esc / backdrop close. Unwinds the FAQ history entries
+     * so the underlying app route is left untouched.
+     */
+    closeModal() {
+        if (!this._modalOpen())
+            return;
+        this.history.closeAndUnwind(() => this.finalizeClose());
+    }
+    finalizeClose() {
+        this._modalOpen.set(false);
+        this._activeContent.set(null);
+        this._activeEntry.set(null);
+        this._activeAttempted.set([]);
+    }
+    async loadIntoActive(key) {
+        this._navigating.set(true);
+        try {
+            const resolution = await this.resolveKey(key, this.auth.authenticated());
+            this._activeEntry.set(resolution.entry);
+            this._activeContent.set(resolution.content);
+            this._activeAttempted.set(resolution.attempted);
+        }
+        finally {
+            this._navigating.set(false);
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+function buildFallbackChain(key) {
+    if (!key)
+        return ['index'];
+    const parts = key.split('.').filter(Boolean);
+    if (parts.length === 0)
+        return ['index'];
+    const chain = [];
+    for (let i = parts.length; i > 0; i--) {
+        chain.push(parts.slice(0, i).join('.'));
+    }
+    chain.push('index');
+    return chain;
+}
+function audienceAllowed(audience, isAuthenticated) {
+    if (audience === 'public')
+        return true;
+    return isAuthenticated;
+}
+
+/**
+ * Gate for the dev-only FAQ authoring panel (E11).
+ *
+ * Defaults to Angular's `isDevMode()` so the panel auto-enables in `ng serve`
+ * and auto-disables in production builds. Consumers can override with an
+ * explicit value (e.g. `!environment.production`, or `true` for a staging
+ * diagnostic build) via `{provide: FAQ_DEV_MODE, useValue: ...}`.
+ *
+ * The panel is loaded via dynamic `import()` and lives in its own lazy chunk;
+ * builds where this resolves to `false` never request the chunk.
+ */
+const FAQ_DEV_MODE = new InjectionToken('FAQ_DEV_MODE', {
+    providedIn: 'root',
+    factory: () => isDevMode(),
+});
+/**
+ * Optional absolute filesystem root of the consuming app's workspace (e.g.
+ * `/Users/foo/dev/broken-stock`). When set, the authoring panel emits
+ * `webstorm://open?file=<root>/<relative-path>` deeplinks pointing at the
+ * exact source file. When unset, the panel falls back to a relative path.
+ */
+const FAQ_DEV_WORKSPACE_ROOT = new InjectionToken('FAQ_DEV_WORKSPACE_ROOT', { providedIn: 'root', factory: () => '' });
+const FAQ_DEV_EDITOR = new InjectionToken('FAQ_DEV_EDITOR', { providedIn: 'root', factory: () => 'webstorm' });
+
+/**
+ * E3 — FAQ modal. Two-pane layout (TOC sidebar + content pane), 80% viewport.
+ *
+ * E4 — Search uses a lazy-imported `fuse.js` index over title + body,
+ * built on first search activation, filtered by audience, cached for the
+ * modal session and invalidated on auth state change.
+ *
+ * E5 — `app:` link clicks close the modal and route to the app path; the
+ * returnUrl-aware `authGuard` funnels unauthenticated users through
+ * `/login?returnUrl=...`, and `Login` honors returnUrl on success.
+ */
+class FaqModal {
+    constructor() {
+        this.devMode = inject(FAQ_DEV_MODE);
+        this.faq = inject(FaqService);
+        this.renderer = inject(FaqMarkdownRendererService);
+        this.auth = inject(AuthenticationService);
+        this.router = inject(Router);
+        this.loader = inject(FAQ_CONTENT_LOADER);
+        this.open = this.faq.modalOpen;
+        this.navigating = this.faq.navigating;
+        this.activeEntry = this.faq.activeEntry;
+        this.attempted = this.faq.activeAttempted;
+        this.canGoBack = this.faq.canGoBack;
+        this.canGoForward = this.faq.canGoForward;
+        this.sidebarCollapsed = signal(false, ...(ngDevMode ? [{ debugName: "sidebarCollapsed" }] : /* istanbul ignore next */ []));
+        this.searchMode = signal(false, ...(ngDevMode ? [{ debugName: "searchMode" }] : /* istanbul ignore next */ []));
+        this.searchQuery = signal('', ...(ngDevMode ? [{ debugName: "searchQuery" }] : /* istanbul ignore next */ []));
+        this.searchLoading = signal(false, ...(ngDevMode ? [{ debugName: "searchLoading" }] : /* istanbul ignore next */ []));
+        this.searchResults = signal([], ...(ngDevMode ? [{ debugName: "searchResults" }] : /* istanbul ignore next */ []));
+        this.fuse = null;
+        this.fuseBuild = null;
+        this.renderedHtml = computed(() => {
+            const content = this.faq.activeContent();
+            const entry = this.faq.activeEntry();
+            if (!content)
+                return '';
+            return this.renderer.render(content, {
+                context: 'modal',
+                imagePrefix: entry?.imagePrefix,
+            });
+        }, ...(ngDevMode ? [{ debugName: "renderedHtml" }] : /* istanbul ignore next */ []));
+        this.toc = computed(() => {
+            const isAuth = this.auth.authenticated();
+            const entries = this.faq.entries().filter((e) => {
+                if (e.audience === 'public')
+                    return true;
+                return isAuth;
+            });
+            const groups = new Map();
+            for (const e of entries) {
+                const list = groups.get(e.category) ?? [];
+                list.push(e);
+                groups.set(e.category, list);
+            }
+            return [...groups.entries()]
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([category, list]) => ({
+                category,
+                entries: list.sort((a, b) => a.order - b.order || a.title.localeCompare(b.title)),
+            }));
+        }, ...(ngDevMode ? [{ debugName: "toc" }] : /* istanbul ignore next */ []));
+        // Scroll content pane to top on key change.
+        effect(() => {
+            this.activeEntry();
+            queueMicrotask(() => {
+                this.contentPaneRef?.nativeElement.scrollTo({ top: 0 });
+            });
+        });
+        // Invalidate the search index on auth state change so the audience
+        // filter is re-applied on next search activation.
+        effect(() => {
+            this.auth.authenticated();
+            this.fuse = null;
+            this.fuseBuild = null;
+            if (this.searchMode())
+                this.searchResults.set([]);
+        });
+        // Consume `faq search <term>` pre-fill: when FaqService.initialSearchTerm
+        // is non-null while the modal is open, switch to search mode with that
+        // query and immediately invoke the index build.
+        effect(() => {
+            const term = this.faq.initialSearchTerm();
+            if (!term || !this.faq.modalOpen())
+                return;
+            untracked(() => {
+                this.searchMode.set(true);
+                this.searchQuery.set(term);
+                this.faq.consumeInitialSearchTerm();
+                void this.ensureSearchIndex().then(() => this.runSearch(term));
+            });
+        });
+    }
+    onEscape() {
+        if (this.open())
+            this.close();
+    }
+    close() {
+        this.faq.closeModal();
+    }
+    onBackdropClick() {
+        this.close();
+    }
+    stopPropagation(event) {
+        event.stopPropagation();
+    }
+    toggleSidebar() {
+        this.sidebarCollapsed.update((v) => !v);
+    }
+    goBack() {
+        this.faq.back();
+    }
+    goForward() {
+        this.faq.forward();
+    }
+    goIndex() {
+        void this.faq.navigateTo('index');
+    }
+    toggleSearch() {
+        const next = !this.searchMode();
+        this.searchMode.set(next);
+        if (next) {
+            void this.ensureSearchIndex().then(() => this.runSearch(this.searchQuery()));
+        }
+    }
+    onSearchInput(event) {
+        const value = event.target.value;
+        this.searchQuery.set(value);
+        void this.ensureSearchIndex().then(() => this.runSearch(value));
+    }
+    onSearchResultClick(key) {
+        void this.faq.navigateTo(key);
+    }
+    onTocClick(key) {
+        void this.faq.navigateTo(key);
+    }
+    async ensureSearchIndex() {
+        if (this.fuse)
+            return;
+        if (this.fuseBuild)
+            return this.fuseBuild;
+        this.searchLoading.set(true);
+        this.fuseBuild = (async () => {
+            const [{ default: Fuse }] = await Promise.all([
+                import('fuse.js'),
+                this.faq.ensureManifest(),
+            ]);
+            const isAuth = this.auth.authenticated();
+            const entries = this.faq.entries().filter((e) => e.audience === 'public' ? true : isAuth);
+            const docs = await Promise.all(entries.map(async (e) => {
+                const body = (await this.loader.loadContent(e.key)) ?? '';
+                return { key: e.key, title: e.title, category: e.category, body };
+            }));
+            this.fuse = new Fuse(docs, {
+                keys: [
+                    { name: 'title', weight: 0.6 },
+                    { name: 'body', weight: 0.4 },
+                ],
+                includeMatches: true,
+                ignoreLocation: true,
+                threshold: 0.4,
+                minMatchCharLength: 2,
+            });
+        })()
+            .catch((err) => {
+            console.error('FAQ search index build failed', err);
+            this.fuseBuild = null;
+        })
+            .finally(() => {
+            this.searchLoading.set(false);
+        });
+        return this.fuseBuild;
+    }
+    runSearch(query) {
+        const q = query.trim();
+        if (!q || !this.fuse) {
+            this.searchResults.set([]);
+            return;
+        }
+        const hits = this.fuse.search(q).slice(0, 30);
+        this.searchResults.set(hits.map((h) => ({
+            key: h.item.key,
+            title: h.item.title,
+            category: h.item.category,
+            snippet: buildSnippet(h.item.body, h.matches),
+        })));
+    }
+    /**
+     * Event-delegated click handler for the rendered content pane.
+     * Intercepts our sentinel anchors emitted by FaqMarkdownRendererService.
+     */
+    onContentClick(event) {
+        const target = event.target;
+        if (!(target instanceof HTMLElement))
+            return;
+        const anchor = target.closest('a[data-faq-kind]');
+        if (!anchor)
+            return;
+        const kind = anchor.getAttribute('data-faq-kind');
+        if (kind === 'external') {
+            return;
+        }
+        if (kind === 'anchor') {
+            event.preventDefault();
+            const href = anchor.getAttribute('href') ?? '';
+            const id = href.startsWith('#') ? href.slice(1) : href;
+            if (!id)
+                return;
+            const pane = this.contentPaneRef?.nativeElement;
+            const el = pane?.querySelector(`#${CSS.escape(id)}`);
+            el?.scrollIntoView({ behavior: 'smooth', block: 'start' });
+            return;
+        }
+        const faqHref = anchor.getAttribute('data-faq-href') ?? '';
+        if (kind === 'faq' && faqHref.startsWith('faq:')) {
+            event.preventDefault();
+            const key = faqHref.slice('faq:'.length);
+            void this.faq.navigateTo(key);
+            return;
+        }
+        if (kind === 'app' && faqHref.startsWith('app:')) {
+            event.preventDefault();
+            const path = faqHref.slice('app:'.length);
+            this.close();
+            // Defer route until after modal close finishes unwinding history,
+            // so navigation lands as a fresh entry on top of the pre-modal URL.
+            // The returnUrl-aware authGuard handles unauthenticated callers by
+            // redirecting to /login?returnUrl=<path>; Login honors it on success.
+            queueMicrotask(() => {
+                void this.router.navigateByUrl(path);
+            });
+            return;
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqModal, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: FaqModal, isStandalone: true, selector: "faq-modal", host: { listeners: { "document:keydown.escape": "onEscape()" } }, viewQueries: [{ propertyName: "contentPaneRef", first: true, predicate: ["contentPane"], descendants: true }], ngImport: i0, template: "@if (open()) {\n  <div class=\"faq-backdrop\" (click)=\"onBackdropClick()\" role=\"presentation\">\n    <div\n      class=\"faq-modal\"\n      role=\"dialog\"\n      aria-modal=\"true\"\n      [attr.aria-label]=\"activeEntry()?.title ?? 'FAQ'\"\n      (click)=\"stopPropagation($event)\"\n    >\n      <header class=\"faq-toolbar\">\n        <div class=\"faq-toolbar-nav\">\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"toggleSidebar()\"\n            [attr.aria-label]=\"sidebarCollapsed() ? 'Show contents' : 'Hide contents'\"\n            [attr.aria-pressed]=\"!sidebarCollapsed()\"\n          >\u2630</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goBack()\"\n            [disabled]=\"!canGoBack()\"\n            aria-label=\"Back\"\n          >\u2039</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goForward()\"\n            [disabled]=\"!canGoForward()\"\n            aria-label=\"Forward\"\n          >\u203A</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goIndex()\"\n            aria-label=\"Index\"\n          >\u2302</button>\n        </div>\n        <div class=\"faq-toolbar-title\">\n          @if (activeEntry(); as entry) {\n            <span class=\"faq-category\">{{ entry.category }}</span>\n            <span class=\"faq-sep\">/</span>\n            <span class=\"faq-title\">{{ entry.title }}</span>\n          } @else {\n            <span class=\"faq-title\">FAQ</span>\n          }\n        </div>\n        <div class=\"faq-toolbar-actions\">\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"toggleSearch()\"\n            [class.active]=\"searchMode()\"\n            aria-label=\"Search\"\n          >\u2315</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn faq-close-btn\"\n            (click)=\"close()\"\n            aria-label=\"Close\"\n          >\u2715</button>\n        </div>\n      </header>\n\n      <div class=\"faq-body\" [class.sidebar-collapsed]=\"sidebarCollapsed()\">\n        <aside class=\"faq-sidebar\" aria-label=\"FAQ contents\">\n          @if (searchMode()) {\n            <div class=\"faq-search\">\n              <input\n                type=\"search\"\n                class=\"faq-search-input\"\n                placeholder=\"Search FAQ\u2026\"\n                aria-label=\"Search FAQ\"\n                [value]=\"searchQuery()\"\n                (input)=\"onSearchInput($event)\"\n              />\n              @if (searchLoading()) {\n                <p class=\"faq-search-status\">Building index\u2026</p>\n              } @else if (!searchQuery().trim()) {\n                <p class=\"faq-search-status\">Type to search titles and content.</p>\n              } @else if (searchResults().length === 0) {\n                <p class=\"faq-search-status\">No matches.</p>\n              } @else {\n                <ul class=\"faq-search-results\">\n                  @for (r of searchResults(); track r.key) {\n                    <li>\n                      <button\n                        type=\"button\"\n                        class=\"faq-search-result\"\n                        [class.active]=\"activeEntry()?.key === r.key\"\n                        (click)=\"onSearchResultClick(r.key)\"\n                      >\n                        <span class=\"faq-search-result-title\">{{ r.title }}</span>\n                        <span class=\"faq-search-result-category\">{{ r.category }}</span>\n                        @if (r.snippet) {\n                          <span class=\"faq-search-result-snippet\">{{ r.snippet }}</span>\n                        }\n                      </button>\n                    </li>\n                  }\n                </ul>\n              }\n            </div>\n          } @else {\n            <nav class=\"faq-toc\">\n              @for (group of toc(); track group.category) {\n                <div class=\"faq-toc-group\">\n                  <h3 class=\"faq-toc-category\">{{ group.category }}</h3>\n                  <ul>\n                    @for (entry of group.entries; track entry.key) {\n                      <li>\n                        <button\n                          type=\"button\"\n                          class=\"faq-toc-link\"\n                          [class.active]=\"activeEntry()?.key === entry.key\"\n                          (click)=\"onTocClick(entry.key)\"\n                        >{{ entry.title }}</button>\n                      </li>\n                    }\n                  </ul>\n                </div>\n              } @empty {\n                <p class=\"faq-toc-empty\">No FAQ entries yet.</p>\n              }\n            </nav>\n          }\n        </aside>\n\n        <main\n          #contentPane\n          class=\"faq-content\"\n          (click)=\"onContentClick($event)\"\n        >\n          @if (navigating()) {\n            <div class=\"faq-loading\">Loading\u2026</div>\n          } @else if (renderedHtml(); as html) {\n            <article class=\"faq-article\" [innerHTML]=\"html\"></article>\n            @if (devMode && activeEntry(); as entry) {\n              @defer (when devMode) {\n                <faq-authoring-panel\n                  mode=\"existing\"\n                  [key]=\"entry.key\"\n                  [attempted]=\"attempted()\"\n                  [entry]=\"entry\"\n                />\n              }\n            }\n          } @else {\n            <div class=\"faq-empty\">\n              <h2>No FAQ available</h2>\n              <p>No content is registered for this route.</p>\n              @if (attempted().length) {\n                <p class=\"faq-empty-chain\">\n                  Attempted keys:\n                  <code>{{ attempted().join(' \u2192 ') }}</code>\n                </p>\n              }\n              @if (devMode && attempted().length) {\n                @defer (when devMode) {\n                  <faq-authoring-panel\n                    mode=\"missing\"\n                    [key]=\"attempted()[0]\"\n                    [attempted]=\"attempted()\"\n                  />\n                } @loading (minimum 100ms) {\n                  <p class=\"faq-empty-hint\">Loading authoring panel\u2026</p>\n                }\n              }\n            </div>\n          }\n        </main>\n      </div>\n    </div>\n  </div>\n}\n", styles: [":host{display:contents}.faq-backdrop{position:fixed;inset:0;z-index:1100;background:#0000008c;display:flex;align-items:center;justify-content:center;padding:5vh 5vw}.faq-modal{width:80vw;height:80vh;max-width:1600px;max-height:1100px;background:var(--shell-surface, #1d1f23);color:var(--shell-fg, #e6e6e6);border-radius:8px;box-shadow:0 12px 32px #00000080;display:grid;grid-template-rows:auto 1fr;overflow:hidden;font-family:var(--shell-font, system-ui, sans-serif)}.faq-toolbar{display:grid;grid-template-columns:auto 1fr auto;align-items:center;gap:.5rem;padding:.5rem .75rem;border-bottom:1px solid var(--shell-border, rgba(255, 255, 255, .08));background:var(--shell-surface-2, rgba(255, 255, 255, .03))}.faq-toolbar-nav,.faq-toolbar-actions{display:flex;gap:.25rem}.faq-toolbar-title{text-align:center;font-size:.95rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.faq-category{opacity:.7;margin-right:.25rem}.faq-sep{opacity:.4;margin:0 .25rem}.faq-title{font-weight:600}.faq-icon-btn{background:transparent;border:1px solid transparent;color:inherit;width:2rem;height:2rem;border-radius:4px;cursor:pointer;font-size:1rem;line-height:1;display:inline-flex;align-items:center;justify-content:center}.faq-icon-btn:hover:not(:disabled){background:#ffffff14}.faq-icon-btn:disabled{opacity:.35;cursor:not-allowed}.faq-icon-btn.active{background:#ffffff1f;border-color:#ffffff2e}.faq-body{display:grid;grid-template-columns:260px 1fr;min-height:0}.faq-body.sidebar-collapsed{grid-template-columns:0 1fr}.faq-body.sidebar-collapsed .faq-sidebar{display:none}.faq-sidebar{border-right:1px solid var(--shell-border, rgba(255, 255, 255, .08));overflow-y:auto;padding:.75rem .5rem;background:var(--shell-surface, #1d1f23)}.faq-toc-group{margin-bottom:1rem}.faq-toc-category{font-size:.72rem;font-weight:700;letter-spacing:.06em;text-transform:uppercase;opacity:.6;margin:0 0 .4rem .4rem}.faq-toc ul{list-style:none;padding:0;margin:0}.faq-toc-link{display:block;width:100%;text-align:left;background:transparent;border:none;color:inherit;padding:.35rem .5rem;border-radius:4px;cursor:pointer;font-size:.88rem}.faq-toc-link:hover{background:#ffffff0f}.faq-toc-link.active{background:#ffffff1f;font-weight:600}.faq-toc-empty{padding:1rem .5rem;opacity:.7;font-size:.85rem}.faq-search{display:flex;flex-direction:column;gap:.5rem;padding:.25rem}.faq-search-input{width:100%;padding:.5rem .6rem;border-radius:4px;border:1px solid rgba(255,255,255,.18);background:#00000040;color:inherit;font-size:.9rem;box-sizing:border-box}.faq-search-input:focus{outline:none;border-color:#fff6}.faq-search-status{padding:.5rem;opacity:.65;font-size:.82rem;margin:0}.faq-search-results{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.15rem}.faq-search-result{display:flex;flex-direction:column;gap:.15rem;width:100%;text-align:left;background:transparent;border:none;color:inherit;padding:.45rem .5rem;border-radius:4px;cursor:pointer}.faq-search-result:hover{background:#ffffff0f}.faq-search-result.active{background:#ffffff1f}.faq-search-result-title{font-size:.9rem;font-weight:600}.faq-search-result-category{font-size:.72rem;opacity:.6;text-transform:uppercase;letter-spacing:.04em}.faq-search-result-snippet{font-size:.78rem;opacity:.75;line-height:1.35}.faq-content{overflow-y:auto;padding:1.25rem 2rem;min-width:0}.faq-loading,.faq-empty{opacity:.75;padding:1rem 0}.faq-empty-chain code{background:#ffffff14;padding:.1rem .4rem;border-radius:3px;font-size:.85rem}.faq-empty-hint{margin-top:1rem;opacity:.55;font-size:.85rem}.faq-article{max-width:70ch;line-height:1.55;font-size:.95rem}.faq-article h1,.faq-article h2,.faq-article h3{font-weight:600;margin:1.4rem 0 .6rem}.faq-article h1{font-size:1.4rem;margin-top:0}.faq-article h2{font-size:1.15rem}.faq-article h3{font-size:1rem}.faq-article p{margin:.6rem 0}.faq-article a{color:var(--shell-link, #6ea8fe);text-decoration:none}.faq-article a:hover{text-decoration:underline}.faq-article a[data-faq-kind=external]:after{content:\" \\2197\";opacity:.65;font-size:.85em}.faq-article .faq-app-arrow{opacity:.7;font-size:.9em}.faq-article code{background:#ffffff14;padding:.1rem .35rem;border-radius:3px;font-size:.88em}.faq-article pre{background:#00000059;padding:.75rem 1rem;border-radius:4px;overflow-x:auto}.faq-article pre code{background:transparent;padding:0}.faq-article img{max-width:100%;border-radius:4px;margin:.6rem 0}.faq-article ul,.faq-article ol{padding-left:1.4rem;margin:.6rem 0}.faq-article blockquote{border-left:3px solid var(--shell-border, rgba(255, 255, 255, .15));padding-left:.9rem;margin:.8rem 0;opacity:.85}@media(max-width:900px){.faq-modal{width:100vw;height:100vh;border-radius:0;max-width:none;max-height:none}.faq-backdrop{padding:0}.faq-body{grid-template-columns:1fr}.faq-sidebar{display:none}.faq-body:not(.sidebar-collapsed) .faq-sidebar{display:block;position:absolute;inset:0;z-index:1}}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [Promise.resolve().then(function () { return faqAuthoringPanel; }).then(m => m.FaqAuthoringPanel)], () => [Promise.resolve().then(function () { return faqAuthoringPanel; }).then(m => m.FaqAuthoringPanel)]] }); }
+}
+i0.ɵɵngDeclareClassMetadataAsync({ minVersion: "18.0.0", version: "21.2.13", ngImport: i0, type: FaqModal, resolveDeferredDeps: () => [Promise.resolve().then(function () { return faqAuthoringPanel; }).then(m => m.FaqAuthoringPanel)], resolveMetadata: FaqAuthoringPanel => ({ decorators: [{
+                type: Component,
+                args: [{ selector: 'faq-modal', standalone: true, imports: [FaqAuthoringPanel], changeDetection: ChangeDetectionStrategy.OnPush, template: "@if (open()) {\n  <div class=\"faq-backdrop\" (click)=\"onBackdropClick()\" role=\"presentation\">\n    <div\n      class=\"faq-modal\"\n      role=\"dialog\"\n      aria-modal=\"true\"\n      [attr.aria-label]=\"activeEntry()?.title ?? 'FAQ'\"\n      (click)=\"stopPropagation($event)\"\n    >\n      <header class=\"faq-toolbar\">\n        <div class=\"faq-toolbar-nav\">\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"toggleSidebar()\"\n            [attr.aria-label]=\"sidebarCollapsed() ? 'Show contents' : 'Hide contents'\"\n            [attr.aria-pressed]=\"!sidebarCollapsed()\"\n          >\u2630</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goBack()\"\n            [disabled]=\"!canGoBack()\"\n            aria-label=\"Back\"\n          >\u2039</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goForward()\"\n            [disabled]=\"!canGoForward()\"\n            aria-label=\"Forward\"\n          >\u203A</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"goIndex()\"\n            aria-label=\"Index\"\n          >\u2302</button>\n        </div>\n        <div class=\"faq-toolbar-title\">\n          @if (activeEntry(); as entry) {\n            <span class=\"faq-category\">{{ entry.category }}</span>\n            <span class=\"faq-sep\">/</span>\n            <span class=\"faq-title\">{{ entry.title }}</span>\n          } @else {\n            <span class=\"faq-title\">FAQ</span>\n          }\n        </div>\n        <div class=\"faq-toolbar-actions\">\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn\"\n            (click)=\"toggleSearch()\"\n            [class.active]=\"searchMode()\"\n            aria-label=\"Search\"\n          >\u2315</button>\n          <button\n            type=\"button\"\n            class=\"faq-icon-btn faq-close-btn\"\n            (click)=\"close()\"\n            aria-label=\"Close\"\n          >\u2715</button>\n        </div>\n      </header>\n\n      <div class=\"faq-body\" [class.sidebar-collapsed]=\"sidebarCollapsed()\">\n        <aside class=\"faq-sidebar\" aria-label=\"FAQ contents\">\n          @if (searchMode()) {\n            <div class=\"faq-search\">\n              <input\n                type=\"search\"\n                class=\"faq-search-input\"\n                placeholder=\"Search FAQ\u2026\"\n                aria-label=\"Search FAQ\"\n                [value]=\"searchQuery()\"\n                (input)=\"onSearchInput($event)\"\n              />\n              @if (searchLoading()) {\n                <p class=\"faq-search-status\">Building index\u2026</p>\n              } @else if (!searchQuery().trim()) {\n                <p class=\"faq-search-status\">Type to search titles and content.</p>\n              } @else if (searchResults().length === 0) {\n                <p class=\"faq-search-status\">No matches.</p>\n              } @else {\n                <ul class=\"faq-search-results\">\n                  @for (r of searchResults(); track r.key) {\n                    <li>\n                      <button\n                        type=\"button\"\n                        class=\"faq-search-result\"\n                        [class.active]=\"activeEntry()?.key === r.key\"\n                        (click)=\"onSearchResultClick(r.key)\"\n                      >\n                        <span class=\"faq-search-result-title\">{{ r.title }}</span>\n                        <span class=\"faq-search-result-category\">{{ r.category }}</span>\n                        @if (r.snippet) {\n                          <span class=\"faq-search-result-snippet\">{{ r.snippet }}</span>\n                        }\n                      </button>\n                    </li>\n                  }\n                </ul>\n              }\n            </div>\n          } @else {\n            <nav class=\"faq-toc\">\n              @for (group of toc(); track group.category) {\n                <div class=\"faq-toc-group\">\n                  <h3 class=\"faq-toc-category\">{{ group.category }}</h3>\n                  <ul>\n                    @for (entry of group.entries; track entry.key) {\n                      <li>\n                        <button\n                          type=\"button\"\n                          class=\"faq-toc-link\"\n                          [class.active]=\"activeEntry()?.key === entry.key\"\n                          (click)=\"onTocClick(entry.key)\"\n                        >{{ entry.title }}</button>\n                      </li>\n                    }\n                  </ul>\n                </div>\n              } @empty {\n                <p class=\"faq-toc-empty\">No FAQ entries yet.</p>\n              }\n            </nav>\n          }\n        </aside>\n\n        <main\n          #contentPane\n          class=\"faq-content\"\n          (click)=\"onContentClick($event)\"\n        >\n          @if (navigating()) {\n            <div class=\"faq-loading\">Loading\u2026</div>\n          } @else if (renderedHtml(); as html) {\n            <article class=\"faq-article\" [innerHTML]=\"html\"></article>\n            @if (devMode && activeEntry(); as entry) {\n              @defer (when devMode) {\n                <faq-authoring-panel\n                  mode=\"existing\"\n                  [key]=\"entry.key\"\n                  [attempted]=\"attempted()\"\n                  [entry]=\"entry\"\n                />\n              }\n            }\n          } @else {\n            <div class=\"faq-empty\">\n              <h2>No FAQ available</h2>\n              <p>No content is registered for this route.</p>\n              @if (attempted().length) {\n                <p class=\"faq-empty-chain\">\n                  Attempted keys:\n                  <code>{{ attempted().join(' \u2192 ') }}</code>\n                </p>\n              }\n              @if (devMode && attempted().length) {\n                @defer (when devMode) {\n                  <faq-authoring-panel\n                    mode=\"missing\"\n                    [key]=\"attempted()[0]\"\n                    [attempted]=\"attempted()\"\n                  />\n                } @loading (minimum 100ms) {\n                  <p class=\"faq-empty-hint\">Loading authoring panel\u2026</p>\n                }\n              }\n            </div>\n          }\n        </main>\n      </div>\n    </div>\n  </div>\n}\n", styles: [":host{display:contents}.faq-backdrop{position:fixed;inset:0;z-index:1100;background:#0000008c;display:flex;align-items:center;justify-content:center;padding:5vh 5vw}.faq-modal{width:80vw;height:80vh;max-width:1600px;max-height:1100px;background:var(--shell-surface, #1d1f23);color:var(--shell-fg, #e6e6e6);border-radius:8px;box-shadow:0 12px 32px #00000080;display:grid;grid-template-rows:auto 1fr;overflow:hidden;font-family:var(--shell-font, system-ui, sans-serif)}.faq-toolbar{display:grid;grid-template-columns:auto 1fr auto;align-items:center;gap:.5rem;padding:.5rem .75rem;border-bottom:1px solid var(--shell-border, rgba(255, 255, 255, .08));background:var(--shell-surface-2, rgba(255, 255, 255, .03))}.faq-toolbar-nav,.faq-toolbar-actions{display:flex;gap:.25rem}.faq-toolbar-title{text-align:center;font-size:.95rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.faq-category{opacity:.7;margin-right:.25rem}.faq-sep{opacity:.4;margin:0 .25rem}.faq-title{font-weight:600}.faq-icon-btn{background:transparent;border:1px solid transparent;color:inherit;width:2rem;height:2rem;border-radius:4px;cursor:pointer;font-size:1rem;line-height:1;display:inline-flex;align-items:center;justify-content:center}.faq-icon-btn:hover:not(:disabled){background:#ffffff14}.faq-icon-btn:disabled{opacity:.35;cursor:not-allowed}.faq-icon-btn.active{background:#ffffff1f;border-color:#ffffff2e}.faq-body{display:grid;grid-template-columns:260px 1fr;min-height:0}.faq-body.sidebar-collapsed{grid-template-columns:0 1fr}.faq-body.sidebar-collapsed .faq-sidebar{display:none}.faq-sidebar{border-right:1px solid var(--shell-border, rgba(255, 255, 255, .08));overflow-y:auto;padding:.75rem .5rem;background:var(--shell-surface, #1d1f23)}.faq-toc-group{margin-bottom:1rem}.faq-toc-category{font-size:.72rem;font-weight:700;letter-spacing:.06em;text-transform:uppercase;opacity:.6;margin:0 0 .4rem .4rem}.faq-toc ul{list-style:none;padding:0;margin:0}.faq-toc-link{display:block;width:100%;text-align:left;background:transparent;border:none;color:inherit;padding:.35rem .5rem;border-radius:4px;cursor:pointer;font-size:.88rem}.faq-toc-link:hover{background:#ffffff0f}.faq-toc-link.active{background:#ffffff1f;font-weight:600}.faq-toc-empty{padding:1rem .5rem;opacity:.7;font-size:.85rem}.faq-search{display:flex;flex-direction:column;gap:.5rem;padding:.25rem}.faq-search-input{width:100%;padding:.5rem .6rem;border-radius:4px;border:1px solid rgba(255,255,255,.18);background:#00000040;color:inherit;font-size:.9rem;box-sizing:border-box}.faq-search-input:focus{outline:none;border-color:#fff6}.faq-search-status{padding:.5rem;opacity:.65;font-size:.82rem;margin:0}.faq-search-results{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.15rem}.faq-search-result{display:flex;flex-direction:column;gap:.15rem;width:100%;text-align:left;background:transparent;border:none;color:inherit;padding:.45rem .5rem;border-radius:4px;cursor:pointer}.faq-search-result:hover{background:#ffffff0f}.faq-search-result.active{background:#ffffff1f}.faq-search-result-title{font-size:.9rem;font-weight:600}.faq-search-result-category{font-size:.72rem;opacity:.6;text-transform:uppercase;letter-spacing:.04em}.faq-search-result-snippet{font-size:.78rem;opacity:.75;line-height:1.35}.faq-content{overflow-y:auto;padding:1.25rem 2rem;min-width:0}.faq-loading,.faq-empty{opacity:.75;padding:1rem 0}.faq-empty-chain code{background:#ffffff14;padding:.1rem .4rem;border-radius:3px;font-size:.85rem}.faq-empty-hint{margin-top:1rem;opacity:.55;font-size:.85rem}.faq-article{max-width:70ch;line-height:1.55;font-size:.95rem}.faq-article h1,.faq-article h2,.faq-article h3{font-weight:600;margin:1.4rem 0 .6rem}.faq-article h1{font-size:1.4rem;margin-top:0}.faq-article h2{font-size:1.15rem}.faq-article h3{font-size:1rem}.faq-article p{margin:.6rem 0}.faq-article a{color:var(--shell-link, #6ea8fe);text-decoration:none}.faq-article a:hover{text-decoration:underline}.faq-article a[data-faq-kind=external]:after{content:\" \\2197\";opacity:.65;font-size:.85em}.faq-article .faq-app-arrow{opacity:.7;font-size:.9em}.faq-article code{background:#ffffff14;padding:.1rem .35rem;border-radius:3px;font-size:.88em}.faq-article pre{background:#00000059;padding:.75rem 1rem;border-radius:4px;overflow-x:auto}.faq-article pre code{background:transparent;padding:0}.faq-article img{max-width:100%;border-radius:4px;margin:.6rem 0}.faq-article ul,.faq-article ol{padding-left:1.4rem;margin:.6rem 0}.faq-article blockquote{border-left:3px solid var(--shell-border, rgba(255, 255, 255, .15));padding-left:.9rem;margin:.8rem 0;opacity:.85}@media(max-width:900px){.faq-modal{width:100vw;height:100vh;border-radius:0;max-width:none;max-height:none}.faq-backdrop{padding:0}.faq-body{grid-template-columns:1fr}.faq-sidebar{display:none}.faq-body:not(.sidebar-collapsed) .faq-sidebar{display:block;position:absolute;inset:0;z-index:1}}\n"] }]
+            }], ctorParameters: () => [], propDecorators: { contentPaneRef: [{
+                    type: ViewChild,
+                    args: ['contentPane']
+                }], onEscape: [{
+                    type: HostListener,
+                    args: ['document:keydown.escape']
+                }] } }) });
+/**
+ * Builds a short contextual snippet around the first body match. Falls back
+ * to the head of the body when the only matches are in the title.
+ */
+function buildSnippet(body, matches) {
+    const RADIUS = 60;
+    const MAX = 180;
+    const bodyMatch = matches?.find((m) => m.key === 'body' && m.indices.length);
+    if (!bodyMatch) {
+        return body.replace(/\s+/g, ' ').slice(0, MAX).trim();
+    }
+    const [start, end] = bodyMatch.indices[0];
+    const from = Math.max(0, start - RADIUS);
+    const to = Math.min(body.length, end + RADIUS);
+    let snippet = body.slice(from, to).replace(/\s+/g, ' ').trim();
+    if (from > 0)
+        snippet = '…' + snippet;
+    if (to < body.length)
+        snippet = snippet + '…';
+    return snippet.length > MAX ? snippet.slice(0, MAX) + '…' : snippet;
+}
+
+/**
+ * E11 — Dev-only FAQ authoring panel.
+ *
+ * Two modes, both dynamic-imported by `FaqModal` and gated behind
+ * `FAQ_DEV_MODE`:
+ *   - `missing`: full scaffold panel rendered when no FAQ resolved.
+ *   - `existing`: collapsed source strip rendered below the article when an
+ *     entry IS resolved.
+ *
+ * The panel never imports `environment.*` directly — gating is the modal's
+ * responsibility (via the FAQ_DEV_MODE token + dynamic import).
+ */
+class FaqAuthoringPanel {
+    constructor() {
+        this.faq = inject(FaqService);
+        this.workspaceRoot = inject(FAQ_DEV_WORKSPACE_ROOT);
+        this.editor = inject(FAQ_DEV_EDITOR);
+        /** `'missing'` shows the full scaffold; `'existing'` shows the collapsed strip. */
+        this.mode = input.required(...(ngDevMode ? [{ debugName: "mode" }] : /* istanbul ignore next */ []));
+        /**
+         * The dot-notation key actually being authored. For `missing` mode this is
+         * the deepest attempted key (chain[0]); for `existing` it's the resolved key.
+         */
+        this.key = input.required(...(ngDevMode ? [{ debugName: "key" }] : /* istanbul ignore next */ []));
+        /** Fallback chain that was attempted. For `missing` every entry is missing. */
+        this.attempted = input([], ...(ngDevMode ? [{ debugName: "attempted" }] : /* istanbul ignore next */ []));
+        /** Resolved entry — only set in `existing` mode. */
+        this.entry = input(null, ...(ngDevMode ? [{ debugName: "entry" }] : /* istanbul ignore next */ []));
+        this.expanded = signal(false, ...(ngDevMode ? [{ debugName: "expanded" }] : /* istanbul ignore next */ []));
+        this.showAllFiles = signal(false, ...(ngDevMode ? [{ debugName: "showAllFiles" }] : /* istanbul ignore next */ []));
+        this.copyState = signal(null, ...(ngDevMode ? [{ debugName: "copyState" }] : /* istanbul ignore next */ []));
+        this.relPath = computed(() => {
+            const e = this.entry();
+            if (e)
+                return `src/assets/faq/${e.file}.md`;
+            return `src/assets/faq/${keyToFilePath(this.key())}.md`;
+        }, ...(ngDevMode ? [{ debugName: "relPath" }] : /* istanbul ignore next */ []));
+        this.absPath = computed(() => {
+            const rel = this.relPath();
+            return this.workspaceRoot ? joinPosix(this.workspaceRoot, rel) : rel;
+        }, ...(ngDevMode ? [{ debugName: "absPath" }] : /* istanbul ignore next */ []));
+        this.editorHref = computed(() => {
+            const abs = this.absPath();
+            if (this.editor === 'vscode')
+                return `vscode://file/${abs}`;
+            return `webstorm://open?file=${encodeURI(abs)}`;
+        }, ...(ngDevMode ? [{ debugName: "editorHref" }] : /* istanbul ignore next */ []));
+        this.editorLabel = computed(() => this.editor === 'vscode' ? 'Open in VS Code' : 'Open in WebStorm', ...(ngDevMode ? [{ debugName: "editorLabel" }] : /* istanbul ignore next */ []));
+        this.scaffoldCmd = computed(() => `npm run faq:new -- ${this.key()}`, ...(ngDevMode ? [{ debugName: "scaffoldCmd" }] : /* istanbul ignore next */ []));
+        this.frontmatterScaffold = computed(() => {
+            const k = this.key();
+            const title = humanize(k);
+            const category = humanize(k.split('.')[0]);
+            return [
+                '---',
+                `title: "${title}"`,
+                `category: "${category}"`,
+                'audience: authenticated',
+                'seo-ready: false',
+                'description: ""',
+                '---',
+                '',
+                `# ${title}`,
+                '',
+                `TODO: write content for "${title}".`,
+                '',
+            ].join('\n');
+        }, ...(ngDevMode ? [{ debugName: "frontmatterScaffold" }] : /* istanbul ignore next */ []));
+        this.allEntries = computed(() => this.faq.entries(), ...(ngDevMode ? [{ debugName: "allEntries" }] : /* istanbul ignore next */ []));
+        this.missedChain = computed(() => {
+            const present = new Set(this.allEntries().map((e) => e.key));
+            return this.attempted().map((k) => ({ key: k, present: present.has(k) }));
+        }, ...(ngDevMode ? [{ debugName: "missedChain" }] : /* istanbul ignore next */ []));
+    }
+    toggleExpanded() {
+        this.expanded.update((v) => !v);
+    }
+    toggleAllFiles() {
+        this.showAllFiles.update((v) => !v);
+    }
+    async copy(text, label) {
+        try {
+            await navigator.clipboard.writeText(text);
+            this.copyState.set(label);
+            setTimeout(() => {
+                if (this.copyState() === label)
+                    this.copyState.set(null);
+            }, 1500);
+        }
+        catch {
+            this.copyState.set(`${label}:err`);
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqAuthoringPanel, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: FaqAuthoringPanel, isStandalone: true, selector: "faq-authoring-panel", inputs: { mode: { classPropertyName: "mode", publicName: "mode", isSignal: true, isRequired: true, transformFunction: null }, key: { classPropertyName: "key", publicName: "key", isSignal: true, isRequired: true, transformFunction: null }, attempted: { classPropertyName: "attempted", publicName: "attempted", isSignal: true, isRequired: false, transformFunction: null }, entry: { classPropertyName: "entry", publicName: "entry", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "@if (mode() === 'missing') {\n  <section class=\"faq-authoring missing\" aria-label=\"FAQ authoring panel\">\n    <header class=\"faq-authoring-header\">\n      <span class=\"faq-authoring-tag\">[dev]</span>\n      <h3>Start authoring this FAQ</h3>\n    </header>\n\n    <dl class=\"faq-authoring-meta\">\n      <dt>Key</dt>\n      <dd><code>{{ key() }}</code></dd>\n\n      <dt>Fallback chain</dt>\n      <dd>\n        <ul class=\"faq-authoring-chain\">\n          @for (step of missedChain(); track step.key) {\n            <li [ngClass]=\"step.present ? 'present' : 'missed'\">\n              <span class=\"mark\">{{ step.present ? '\u2713' : '\u2717' }}</span>\n              <code>{{ step.key }}</code>\n            </li>\n          }\n        </ul>\n      </dd>\n\n      <dt>Target file</dt>\n      <dd>\n        <code>{{ relPath() }}</code>\n        <a\n          class=\"faq-authoring-editor\"\n          [href]=\"editorHref()\"\n        >{{ editorLabel() }} \u2197</a>\n      </dd>\n    </dl>\n\n    <div class=\"faq-authoring-block\">\n      <div class=\"faq-authoring-block-head\">\n        <span>Scaffold via CLI</span>\n        <button type=\"button\" (click)=\"copy(scaffoldCmd(), 'cmd')\">\n          {{ copyState() === 'cmd' ? 'Copied \u2713' : 'Copy' }}\n        </button>\n      </div>\n      <pre><code>{{ scaffoldCmd() }}</code></pre>\n    </div>\n\n    <div class=\"faq-authoring-block\">\n      <div class=\"faq-authoring-block-head\">\n        <span>Frontmatter scaffold</span>\n        <button type=\"button\" (click)=\"copy(frontmatterScaffold(), 'fm')\">\n          {{ copyState() === 'fm' ? 'Copied \u2713' : 'Copy' }}\n        </button>\n      </div>\n      <pre><code>{{ frontmatterScaffold() }}</code></pre>\n    </div>\n\n    <details class=\"faq-authoring-cheat\">\n      <summary>Link syntax cheat sheet</summary>\n      <ul>\n        <li><code>[label](faq:trade.segments)</code> \u2014 in-modal nav</li>\n        <li><code>[label](app:/settings)</code> \u2014 navigates the app (modal closes)</li>\n        <li><code>[label](https://example.com)</code> \u2014 external (new tab)</li>\n        <li><code>[label](#section-id)</code> \u2014 intra-page anchor</li>\n        <li><code>![alt](./images/foo.png)</code> \u2014 image (drop into <code>src/assets/faq/images/</code>)</li>\n      </ul>\n    </details>\n\n    <details class=\"faq-authoring-all\" [open]=\"showAllFiles()\">\n      <summary (click)=\"toggleAllFiles(); $event.preventDefault()\">\n        Show all FAQ files ({{ allEntries().length }})\n      </summary>\n      <ul class=\"faq-authoring-file-list\">\n        @for (e of allEntries(); track e.key) {\n          <li>\n            <code>{{ e.key }}</code>\n            <span class=\"faq-authoring-file-path\">src/assets/faq/{{ e.file }}.md</span>\n          </li>\n        } @empty {\n          <li class=\"empty\">Manifest is empty.</li>\n        }\n      </ul>\n    </details>\n  </section>\n} @else {\n  <aside class=\"faq-authoring existing\" aria-label=\"FAQ source info\">\n    <div class=\"faq-authoring-strip\">\n      <span class=\"faq-authoring-tag\">[dev]</span>\n      <span>Key: <code>{{ key() }}</code></span>\n      <span class=\"sep\">\u2022</span>\n      <span>Source: <code>{{ relPath() }}</code></span>\n      <a class=\"faq-authoring-editor\" [href]=\"editorHref()\">{{ editorLabel() }} \u2197</a>\n      <button type=\"button\" class=\"faq-authoring-more\" (click)=\"toggleExpanded()\">\n        {{ expanded() ? '\u25B2 Less' : '\u25BC More' }}\n      </button>\n    </div>\n    @if (expanded()) {\n      <div class=\"faq-authoring-expanded\">\n        <div>\n          <strong>Fallback chain attempted:</strong>\n          <ul class=\"faq-authoring-chain inline\">\n            @for (step of missedChain(); track step.key) {\n              <li [ngClass]=\"step.present ? 'present' : 'missed'\">\n                <span class=\"mark\">{{ step.present ? '\u2713' : '\u2717' }}</span>\n                <code>{{ step.key }}</code>\n              </li>\n            }\n          </ul>\n        </div>\n        <details class=\"faq-authoring-cheat\" open>\n          <summary>Link syntax cheat sheet</summary>\n          <ul>\n            <li><code>[label](faq:trade.segments)</code> \u2014 in-modal nav</li>\n            <li><code>[label](app:/settings)</code> \u2014 navigates the app</li>\n            <li><code>[label](https://example.com)</code> \u2014 external</li>\n            <li><code>[label](#section-id)</code> \u2014 intra-page anchor</li>\n            <li><code>![alt](./images/foo.png)</code> \u2014 image</li>\n          </ul>\n        </details>\n        <div class=\"faq-authoring-rescaffold\">\n          <span>Re-scaffold (overwrites if you delete first):</span>\n          <code>{{ scaffoldCmd() }}</code>\n          <button type=\"button\" (click)=\"copy(scaffoldCmd(), 'cmd')\">\n            {{ copyState() === 'cmd' ? 'Copied \u2713' : 'Copy' }}\n          </button>\n        </div>\n      </div>\n    }\n  </aside>\n}\n", styles: [":host{display:block;font-family:var(--shell-font, system-ui, sans-serif);font-size:.875rem;color:var(--shell-fg, #e6e6e6)}.faq-authoring{border:1px dashed var(--shell-accent, #6aa0ff);border-radius:6px;background:#6aa0ff0a}.faq-authoring.missing{padding:1rem 1.25rem;display:grid;gap:.85rem}.faq-authoring.existing{margin-top:1.5rem;padding:.5rem .75rem;background:#6aa0ff08;border-style:dotted}.faq-authoring-header{display:flex;align-items:baseline;gap:.5rem;margin:0}.faq-authoring-header h3{margin:0;font-size:1rem}.faq-authoring-tag{display:inline-block;padding:.05rem .4rem;background:var(--shell-accent, #6aa0ff);color:#0b0d11;border-radius:3px;font-size:.7rem;font-weight:700;letter-spacing:.04em;text-transform:uppercase}.faq-authoring-meta{display:grid;grid-template-columns:max-content 1fr;gap:.35rem .85rem;margin:0}.faq-authoring-meta dt{font-weight:600;opacity:.75}.faq-authoring-meta dd{margin:0}.faq-authoring code{font-family:var(--shell-mono, ui-monospace, monospace);background:#ffffff0f;padding:.05rem .3rem;border-radius:3px;font-size:.85em}.faq-authoring-chain{list-style:none;padding:0;margin:0;display:flex;flex-wrap:wrap;gap:.4rem}.faq-authoring-chain.inline{display:inline-flex;margin-left:.5rem}.faq-authoring-chain li{display:inline-flex;align-items:center;gap:.25rem}.faq-authoring-chain .mark{font-weight:700}.faq-authoring-chain .missed .mark{color:#ff7676}.faq-authoring-chain .present .mark{color:#8ad27a}.faq-authoring-editor{margin-left:.75rem;color:var(--shell-accent, #6aa0ff);text-decoration:none}.faq-authoring-editor:hover{text-decoration:underline}.faq-authoring-block{border:1px solid var(--shell-border, rgba(255, 255, 255, .08));border-radius:4px;overflow:hidden}.faq-authoring-block-head{display:flex;justify-content:space-between;align-items:center;padding:.4rem .6rem;background:#ffffff0a;font-weight:600;font-size:.8rem}.faq-authoring-block-head button,.faq-authoring-more,.faq-authoring-rescaffold button{background:var(--shell-accent, #6aa0ff);color:#0b0d11;border:0;border-radius:3px;padding:.2rem .55rem;font-size:.75rem;cursor:pointer;font-family:inherit}.faq-authoring-block pre{margin:0;padding:.6rem .75rem;overflow-x:auto;background:#00000040;font-size:.8rem}.faq-authoring-cheat,.faq-authoring-all{font-size:.85rem}.faq-authoring-cheat summary,.faq-authoring-all summary{cursor:pointer;opacity:.85}.faq-authoring-cheat ul,.faq-authoring-file-list{margin:.4rem 0 0;padding-left:1.25rem}.faq-authoring-file-list{list-style:none;padding-left:0;max-height:200px;overflow-y:auto}.faq-authoring-file-list li{display:flex;justify-content:space-between;gap:.5rem;padding:.15rem 0;border-bottom:1px solid rgba(255,255,255,.04)}.faq-authoring-file-path{opacity:.6;font-family:var(--shell-mono, ui-monospace, monospace);font-size:.75rem}.faq-authoring-strip{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem;font-size:.8rem}.faq-authoring-strip .sep{opacity:.4}.faq-authoring-more{margin-left:auto}.faq-authoring-expanded{margin-top:.6rem;padding-top:.5rem;border-top:1px solid rgba(255,255,255,.08);display:grid;gap:.6rem}.faq-authoring-rescaffold{display:flex;align-items:center;gap:.5rem;flex-wrap:wrap;font-size:.8rem}\n"], dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqAuthoringPanel, decorators: [{
+            type: Component,
+            args: [{ selector: 'faq-authoring-panel', standalone: true, imports: [NgClass], changeDetection: ChangeDetectionStrategy.OnPush, template: "@if (mode() === 'missing') {\n  <section class=\"faq-authoring missing\" aria-label=\"FAQ authoring panel\">\n    <header class=\"faq-authoring-header\">\n      <span class=\"faq-authoring-tag\">[dev]</span>\n      <h3>Start authoring this FAQ</h3>\n    </header>\n\n    <dl class=\"faq-authoring-meta\">\n      <dt>Key</dt>\n      <dd><code>{{ key() }}</code></dd>\n\n      <dt>Fallback chain</dt>\n      <dd>\n        <ul class=\"faq-authoring-chain\">\n          @for (step of missedChain(); track step.key) {\n            <li [ngClass]=\"step.present ? 'present' : 'missed'\">\n              <span class=\"mark\">{{ step.present ? '\u2713' : '\u2717' }}</span>\n              <code>{{ step.key }}</code>\n            </li>\n          }\n        </ul>\n      </dd>\n\n      <dt>Target file</dt>\n      <dd>\n        <code>{{ relPath() }}</code>\n        <a\n          class=\"faq-authoring-editor\"\n          [href]=\"editorHref()\"\n        >{{ editorLabel() }} \u2197</a>\n      </dd>\n    </dl>\n\n    <div class=\"faq-authoring-block\">\n      <div class=\"faq-authoring-block-head\">\n        <span>Scaffold via CLI</span>\n        <button type=\"button\" (click)=\"copy(scaffoldCmd(), 'cmd')\">\n          {{ copyState() === 'cmd' ? 'Copied \u2713' : 'Copy' }}\n        </button>\n      </div>\n      <pre><code>{{ scaffoldCmd() }}</code></pre>\n    </div>\n\n    <div class=\"faq-authoring-block\">\n      <div class=\"faq-authoring-block-head\">\n        <span>Frontmatter scaffold</span>\n        <button type=\"button\" (click)=\"copy(frontmatterScaffold(), 'fm')\">\n          {{ copyState() === 'fm' ? 'Copied \u2713' : 'Copy' }}\n        </button>\n      </div>\n      <pre><code>{{ frontmatterScaffold() }}</code></pre>\n    </div>\n\n    <details class=\"faq-authoring-cheat\">\n      <summary>Link syntax cheat sheet</summary>\n      <ul>\n        <li><code>[label](faq:trade.segments)</code> \u2014 in-modal nav</li>\n        <li><code>[label](app:/settings)</code> \u2014 navigates the app (modal closes)</li>\n        <li><code>[label](https://example.com)</code> \u2014 external (new tab)</li>\n        <li><code>[label](#section-id)</code> \u2014 intra-page anchor</li>\n        <li><code>![alt](./images/foo.png)</code> \u2014 image (drop into <code>src/assets/faq/images/</code>)</li>\n      </ul>\n    </details>\n\n    <details class=\"faq-authoring-all\" [open]=\"showAllFiles()\">\n      <summary (click)=\"toggleAllFiles(); $event.preventDefault()\">\n        Show all FAQ files ({{ allEntries().length }})\n      </summary>\n      <ul class=\"faq-authoring-file-list\">\n        @for (e of allEntries(); track e.key) {\n          <li>\n            <code>{{ e.key }}</code>\n            <span class=\"faq-authoring-file-path\">src/assets/faq/{{ e.file }}.md</span>\n          </li>\n        } @empty {\n          <li class=\"empty\">Manifest is empty.</li>\n        }\n      </ul>\n    </details>\n  </section>\n} @else {\n  <aside class=\"faq-authoring existing\" aria-label=\"FAQ source info\">\n    <div class=\"faq-authoring-strip\">\n      <span class=\"faq-authoring-tag\">[dev]</span>\n      <span>Key: <code>{{ key() }}</code></span>\n      <span class=\"sep\">\u2022</span>\n      <span>Source: <code>{{ relPath() }}</code></span>\n      <a class=\"faq-authoring-editor\" [href]=\"editorHref()\">{{ editorLabel() }} \u2197</a>\n      <button type=\"button\" class=\"faq-authoring-more\" (click)=\"toggleExpanded()\">\n        {{ expanded() ? '\u25B2 Less' : '\u25BC More' }}\n      </button>\n    </div>\n    @if (expanded()) {\n      <div class=\"faq-authoring-expanded\">\n        <div>\n          <strong>Fallback chain attempted:</strong>\n          <ul class=\"faq-authoring-chain inline\">\n            @for (step of missedChain(); track step.key) {\n              <li [ngClass]=\"step.present ? 'present' : 'missed'\">\n                <span class=\"mark\">{{ step.present ? '\u2713' : '\u2717' }}</span>\n                <code>{{ step.key }}</code>\n              </li>\n            }\n          </ul>\n        </div>\n        <details class=\"faq-authoring-cheat\" open>\n          <summary>Link syntax cheat sheet</summary>\n          <ul>\n            <li><code>[label](faq:trade.segments)</code> \u2014 in-modal nav</li>\n            <li><code>[label](app:/settings)</code> \u2014 navigates the app</li>\n            <li><code>[label](https://example.com)</code> \u2014 external</li>\n            <li><code>[label](#section-id)</code> \u2014 intra-page anchor</li>\n            <li><code>![alt](./images/foo.png)</code> \u2014 image</li>\n          </ul>\n        </details>\n        <div class=\"faq-authoring-rescaffold\">\n          <span>Re-scaffold (overwrites if you delete first):</span>\n          <code>{{ scaffoldCmd() }}</code>\n          <button type=\"button\" (click)=\"copy(scaffoldCmd(), 'cmd')\">\n            {{ copyState() === 'cmd' ? 'Copied \u2713' : 'Copy' }}\n          </button>\n        </div>\n      </div>\n    }\n  </aside>\n}\n", styles: [":host{display:block;font-family:var(--shell-font, system-ui, sans-serif);font-size:.875rem;color:var(--shell-fg, #e6e6e6)}.faq-authoring{border:1px dashed var(--shell-accent, #6aa0ff);border-radius:6px;background:#6aa0ff0a}.faq-authoring.missing{padding:1rem 1.25rem;display:grid;gap:.85rem}.faq-authoring.existing{margin-top:1.5rem;padding:.5rem .75rem;background:#6aa0ff08;border-style:dotted}.faq-authoring-header{display:flex;align-items:baseline;gap:.5rem;margin:0}.faq-authoring-header h3{margin:0;font-size:1rem}.faq-authoring-tag{display:inline-block;padding:.05rem .4rem;background:var(--shell-accent, #6aa0ff);color:#0b0d11;border-radius:3px;font-size:.7rem;font-weight:700;letter-spacing:.04em;text-transform:uppercase}.faq-authoring-meta{display:grid;grid-template-columns:max-content 1fr;gap:.35rem .85rem;margin:0}.faq-authoring-meta dt{font-weight:600;opacity:.75}.faq-authoring-meta dd{margin:0}.faq-authoring code{font-family:var(--shell-mono, ui-monospace, monospace);background:#ffffff0f;padding:.05rem .3rem;border-radius:3px;font-size:.85em}.faq-authoring-chain{list-style:none;padding:0;margin:0;display:flex;flex-wrap:wrap;gap:.4rem}.faq-authoring-chain.inline{display:inline-flex;margin-left:.5rem}.faq-authoring-chain li{display:inline-flex;align-items:center;gap:.25rem}.faq-authoring-chain .mark{font-weight:700}.faq-authoring-chain .missed .mark{color:#ff7676}.faq-authoring-chain .present .mark{color:#8ad27a}.faq-authoring-editor{margin-left:.75rem;color:var(--shell-accent, #6aa0ff);text-decoration:none}.faq-authoring-editor:hover{text-decoration:underline}.faq-authoring-block{border:1px solid var(--shell-border, rgba(255, 255, 255, .08));border-radius:4px;overflow:hidden}.faq-authoring-block-head{display:flex;justify-content:space-between;align-items:center;padding:.4rem .6rem;background:#ffffff0a;font-weight:600;font-size:.8rem}.faq-authoring-block-head button,.faq-authoring-more,.faq-authoring-rescaffold button{background:var(--shell-accent, #6aa0ff);color:#0b0d11;border:0;border-radius:3px;padding:.2rem .55rem;font-size:.75rem;cursor:pointer;font-family:inherit}.faq-authoring-block pre{margin:0;padding:.6rem .75rem;overflow-x:auto;background:#00000040;font-size:.8rem}.faq-authoring-cheat,.faq-authoring-all{font-size:.85rem}.faq-authoring-cheat summary,.faq-authoring-all summary{cursor:pointer;opacity:.85}.faq-authoring-cheat ul,.faq-authoring-file-list{margin:.4rem 0 0;padding-left:1.25rem}.faq-authoring-file-list{list-style:none;padding-left:0;max-height:200px;overflow-y:auto}.faq-authoring-file-list li{display:flex;justify-content:space-between;gap:.5rem;padding:.15rem 0;border-bottom:1px solid rgba(255,255,255,.04)}.faq-authoring-file-path{opacity:.6;font-family:var(--shell-mono, ui-monospace, monospace);font-size:.75rem}.faq-authoring-strip{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem;font-size:.8rem}.faq-authoring-strip .sep{opacity:.4}.faq-authoring-more{margin-left:auto}.faq-authoring-expanded{margin-top:.6rem;padding-top:.5rem;border-top:1px solid rgba(255,255,255,.08);display:grid;gap:.6rem}.faq-authoring-rescaffold{display:flex;align-items:center;gap:.5rem;flex-wrap:wrap;font-size:.8rem}\n"] }]
+        }], propDecorators: { mode: [{ type: i0.Input, args: [{ isSignal: true, alias: "mode", required: true }] }], key: [{ type: i0.Input, args: [{ isSignal: true, alias: "key", required: true }] }], attempted: [{ type: i0.Input, args: [{ isSignal: true, alias: "attempted", required: false }] }], entry: [{ type: i0.Input, args: [{ isSignal: true, alias: "entry", required: false }] }] } });
+function keyToFilePath(key) {
+    return key.split('.').join('/');
+}
+function humanize(s) {
+    return s
+        .split(/[.\-_/]/)
+        .filter(Boolean)
+        .map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1))
+        .join(' ');
+}
+function joinPosix(a, b) {
+    const left = a.endsWith('/') ? a.slice(0, -1) : a;
+    const right = b.startsWith('/') ? b.slice(1) : b;
+    return `${left}/${right}`;
+}
+
+var faqAuthoringPanel = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    FaqAuthoringPanel: FaqAuthoringPanel
+});
+
 class ThemeService {
     constructor() {
         this.mode = signal('dark', ...(ngDevMode ? [{ debugName: "mode" }] : /* istanbul ignore next */ []));
@@ -431,9 +1348,67 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImpo
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [] });
 
+const FAQ_USAGE = 'faq\n' +
+    'faq <key>\n' +
+    'faq search <term>\n' +
+    'faq index\n' +
+    'faq help\n\n' +
+    '  Opens the in-app FAQ help system. Does not require authentication.\n\n' +
+    '  Subcommands:\n' +
+    '    (none)        Open the FAQ at the current route\'s resolved key.\n' +
+    '    <key>         Open at a specific dot-notation key (e.g. trade.segments).\n' +
+    '    search <term> Open with the search field pre-filled.\n' +
+    '    index         Open at the index table-of-contents.\n' +
+    '    help          Show this help.';
+class FaqCommand {
+    constructor() {
+        this.faqService = inject(FaqService);
+        this.name = 'faq';
+        this.description = 'Open the in-app FAQ help system';
+        this.usage = FAQ_USAGE;
+        this.requiresAuth = false;
+        this.argsSchema = z.array(z.string()).max(50);
+    }
+    execute(args) {
+        const ts = () => new Date();
+        if (args.length === 0) {
+            void this.faqService.openModal();
+            return { success: true, message: '', timestamp: ts() };
+        }
+        const sub = args[0].toLowerCase();
+        if (sub === 'index') {
+            void this.faqService.openModal('index');
+            return { success: true, message: '', timestamp: ts() };
+        }
+        if (sub === 'search') {
+            const term = args.slice(1).join(' ').trim();
+            if (!term) {
+                return {
+                    success: false,
+                    message: 'Usage: faq search <term>',
+                    timestamp: ts(),
+                };
+            }
+            void this.faqService.openModal(undefined, { searchTerm: term });
+            return { success: true, message: '', timestamp: ts() };
+        }
+        void this.faqService.openModal(args[0]);
+        return { success: true, message: '', timestamp: ts() };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqCommand, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqCommand, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: FaqCommand, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 class CommandRegistryService {
     constructor() {
         this.commands = new Map();
+        // Built-in shell commands registered ahead of app-provided commands so
+        // an app cannot accidentally shadow them.
+        this.register(inject(FaqCommand));
         const appCommands = inject(SHELL_COMMANDS, { optional: true }) ?? [];
         for (const cmd of appCommands) {
             this.register(cmd);
@@ -456,7 +1431,8 @@ class CommandRegistryService {
         if (!prefix)
             return [];
         if (!isAuthenticated) {
-            return 'login'.startsWith(prefix) && 'login' !== prefix ? ['login'] : [];
+            const open = ['login', ...[...this.commands.values()].filter(c => c.requiresAuth === false).map(c => c.name)];
+            return open.filter(name => name.startsWith(prefix) && name !== prefix).sort();
         }
         const builtIns = ['clear', 'help'];
         const registered = [...this.commands.values()].map(c => c.name);
@@ -596,16 +1572,22 @@ class CommandService {
         }
         const hasHelp = args.some(a => a.toLowerCase() === 'help');
         const isAuthenticated = this.authService.authenticated();
-        if (!isAuthenticated && command !== 'login') {
-            return { success: false, message: 'Not logged in. Use "login" to authenticate.', timestamp: new Date() };
-        }
+        const notLoggedIn = () => ({
+            success: false,
+            message: 'Not logged in. Use "login" to authenticate.',
+            timestamp: new Date(),
+        });
         if (command === 'clear') {
+            if (!isAuthenticated)
+                return notLoggedIn();
             if (hasHelp)
                 return { success: true, message: CLEAR_USAGE, timestamp: new Date(), isHelp: true };
             this.history.set([]);
             return { success: true, message: '', timestamp: new Date() };
         }
         if (command === 'help') {
+            if (!isAuthenticated)
+                return notLoggedIn();
             const target = args[0]?.toLowerCase();
             if (target)
                 return this.#commandHelp(target);
@@ -632,9 +1614,14 @@ class CommandService {
                 command = swapped;
             }
             else {
+                if (!isAuthenticated && command !== 'login')
+                    return notLoggedIn();
                 return { success: false, message: `Unknown command: ${command}`, timestamp: new Date() };
             }
         }
+        if (!isAuthenticated && command !== 'login' && def.requiresAuth !== false) {
+            return notLoggedIn();
+        }
         if (hasHelp) {
             return { success: true, message: def.usage, timestamp: new Date(), isHelp: true };
         }
@@ -682,12 +1669,16 @@ class StatusBar {
         this.#commandService.echoCommand('logout');
         this.#focusService.requestFocus();
     }
+    openFaq() {
+        this.#commandService.execute('faq');
+        this.#focusService.requestFocus();
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: StatusBar, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: StatusBar, isStandalone: true, selector: "shell-status-bar", ngImport: i0, template: "<div class=\"status-bar\">\n  <div class=\"status-item\">\n    <span class=\"status-label text-secondary-info\">Status:</span>\n    @if (isAuthenticated()) {\n      <a class=\"status-value text-interactive logout-link\" (click)=\"logout()\">Log Out</a>\n    } @else {\n      <span class=\"status-value text-loss\">{{ loginStatus() }}</span>\n    }\n  </div>\n  @if (isAuthenticated()) {\n    <ng-content />\n  }\n</div>\n", styles: [".status-bar{display:flex;align-items:center;gap:24px;padding:0 16px;height:100%;background-color:var(--color-surface);border-bottom:1px solid var(--color-surface-border);font-size:.8rem}.status-item{display:flex;align-items:baseline;gap:6px}.status-label{font-weight:500;text-transform:uppercase;letter-spacing:.05em;font-size:.7rem}.logout-link{cursor:pointer;text-decoration:underline}.logout-link:hover{opacity:.8}\n"] }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: StatusBar, isStandalone: true, selector: "shell-status-bar", ngImport: i0, template: "<div class=\"status-bar\">\n  <div class=\"status-item\">\n    <span class=\"status-label text-secondary-info\">Status:</span>\n    @if (isAuthenticated()) {\n      <a class=\"status-value text-interactive logout-link\" (click)=\"logout()\">Log Out</a>\n    } @else {\n      <span class=\"status-value text-loss\">{{ loginStatus() }}</span>\n    }\n  </div>\n  @if (isAuthenticated()) {\n    <ng-content />\n  }\n  <button\n    type=\"button\"\n    class=\"faq-button text-interactive\"\n    (click)=\"openFaq()\"\n    title=\"Open FAQ (or type `faq`)\"\n    aria-label=\"Open FAQ\"\n  >?</button>\n</div>\n", styles: [".status-bar{display:flex;align-items:center;gap:24px;padding:0 16px;height:100%;background-color:var(--color-surface);border-bottom:1px solid var(--color-surface-border);font-size:.8rem}.status-item{display:flex;align-items:baseline;gap:6px}.status-label{font-weight:500;text-transform:uppercase;letter-spacing:.05em;font-size:.7rem}.logout-link{cursor:pointer;text-decoration:underline}.logout-link:hover{opacity:.8}.faq-button{margin-left:auto;background:none;border:1px solid var(--color-surface-border);border-radius:50%;width:22px;height:22px;font-size:.85rem;font-weight:600;line-height:1;cursor:pointer;display:inline-flex;align-items:center;justify-content:center;padding:0}.faq-button:hover{opacity:.8}\n"] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: StatusBar, decorators: [{
             type: Component,
-            args: [{ selector: 'shell-status-bar', template: "<div class=\"status-bar\">\n  <div class=\"status-item\">\n    <span class=\"status-label text-secondary-info\">Status:</span>\n    @if (isAuthenticated()) {\n      <a class=\"status-value text-interactive logout-link\" (click)=\"logout()\">Log Out</a>\n    } @else {\n      <span class=\"status-value text-loss\">{{ loginStatus() }}</span>\n    }\n  </div>\n  @if (isAuthenticated()) {\n    <ng-content />\n  }\n</div>\n", styles: [".status-bar{display:flex;align-items:center;gap:24px;padding:0 16px;height:100%;background-color:var(--color-surface);border-bottom:1px solid var(--color-surface-border);font-size:.8rem}.status-item{display:flex;align-items:baseline;gap:6px}.status-label{font-weight:500;text-transform:uppercase;letter-spacing:.05em;font-size:.7rem}.logout-link{cursor:pointer;text-decoration:underline}.logout-link:hover{opacity:.8}\n"] }]
+            args: [{ selector: 'shell-status-bar', template: "<div class=\"status-bar\">\n  <div class=\"status-item\">\n    <span class=\"status-label text-secondary-info\">Status:</span>\n    @if (isAuthenticated()) {\n      <a class=\"status-value text-interactive logout-link\" (click)=\"logout()\">Log Out</a>\n    } @else {\n      <span class=\"status-value text-loss\">{{ loginStatus() }}</span>\n    }\n  </div>\n  @if (isAuthenticated()) {\n    <ng-content />\n  }\n  <button\n    type=\"button\"\n    class=\"faq-button text-interactive\"\n    (click)=\"openFaq()\"\n    title=\"Open FAQ (or type `faq`)\"\n    aria-label=\"Open FAQ\"\n  >?</button>\n</div>\n", styles: [".status-bar{display:flex;align-items:center;gap:24px;padding:0 16px;height:100%;background-color:var(--color-surface);border-bottom:1px solid var(--color-surface-border);font-size:.8rem}.status-item{display:flex;align-items:baseline;gap:6px}.status-label{font-weight:500;text-transform:uppercase;letter-spacing:.05em;font-size:.7rem}.logout-link{cursor:pointer;text-decoration:underline}.logout-link:hover{opacity:.8}.faq-button{margin-left:auto;background:none;border:1px solid var(--color-surface-border);border-radius:50%;width:22px;height:22px;font-size:.85rem;font-weight:600;line-height:1;cursor:pointer;display:inline-flex;align-items:center;justify-content:center;padding:0}.faq-button:hover{opacity:.8}\n"] }]
         }] });
 
 class SideMenu {
@@ -892,17 +1883,18 @@ class Shell {
         document.addEventListener('mouseup', this.#onMouseUp);
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: Shell, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: Shell, isStandalone: true, selector: "shell-root", ngImport: i0, template: "<div class=\"shell\" [style.--terminal-height]=\"terminalHeight()\" [class.is-dragging]=\"isDragging()\">\n  <shell-status-bar class=\"shell-status\" [class.disabled-zone]=\"isThinking()\">\n    <ng-content />\n  </shell-status-bar>\n  @if (isAuthenticated()) {\n    <shell-side-menu class=\"shell-menu\" [class.disabled-zone]=\"isThinking()\" />\n  }\n  <shell-main-content class=\"shell-main\" [class.full-width]=\"!isAuthenticated()\" />\n  <div class=\"shell-resize\" [class.dragging]=\"isDragging()\" (mousedown)=\"onResizeStart($event)\"></div>\n  <shell-command-terminal class=\"shell-terminal\" [class.disabled-zone]=\"isThinking()\" />\n  @if (helpOverlay(); as helpText) {\n    <div class=\"help-backdrop\" (click)=\"dismissHelp()\">\n      <div class=\"help-panel\" (click)=\"$event.stopPropagation()\" role=\"dialog\" aria-label=\"Command help\">\n        <div class=\"help-panel-header\">\n          <span class=\"help-panel-title\">Help</span>\n          <button class=\"help-panel-close\" type=\"button\" (click)=\"dismissHelp()\" aria-label=\"Close help\">\u2715</button>\n        </div>\n        <div class=\"help-panel-content\">{{ helpText }}</div>\n        <div class=\"help-panel-footer\">\n          <span>Tip: for most commands you can swap the first and second words \u2014 e.g. \"disable user\" works the same as \"user disable\"</span>\n          <span class=\"help-panel-footer-dismiss\">Press Escape, click outside, or start typing to close</span>\n        </div>\n      </div>\n    </div>\n  }\n</div>\n", styles: [".shell{position:relative;display:grid;grid-template-areas:\"status   status\" \"menu     main\" \"resize   resize\" \"terminal terminal\";grid-template-columns:56px 1fr;grid-template-rows:48px 1fr 4px var(--terminal-height, 160px);height:100vh;width:100vw;overflow:hidden;background-color:var(--color-surface-dark)}.shell-status{grid-area:status}.shell-menu{grid-area:menu}.shell-main{grid-area:main;overflow:hidden}.shell-main.full-width{grid-column:1 / -1}.shell-resize{grid-area:resize;cursor:row-resize;background-color:var(--color-surface-border);transition:background-color .15s ease}.shell-resize:hover,.shell-resize.dragging{background-color:var(--color-interactive)}.shell-terminal{grid-area:terminal}.shell.is-dragging{user-select:none;-webkit-user-select:none}.disabled-zone{pointer-events:none;opacity:.4;transition:opacity .2s ease}.help-backdrop{position:absolute;inset:0;z-index:100;background-color:#000000a6;display:flex;align-items:center;justify-content:center}.help-panel{background-color:var(--color-surface, #161b22);border:2px solid var(--color-interactive, #00e5ff);border-radius:4px;width:70%;max-width:820px;max-height:75vh;display:flex;flex-direction:column;font-family:Roboto Mono,Courier New,monospace;font-size:.85rem}.help-panel-header{display:flex;justify-content:space-between;align-items:center;padding:8px 16px;background-color:var(--color-surface-light, #21262d);border-bottom:1px solid var(--color-interactive, #00e5ff);border-radius:2px 2px 0 0;flex-shrink:0}.help-panel-title{color:var(--color-interactive, #00e5ff);font-weight:700;letter-spacing:.05em;text-transform:uppercase;font-size:.75rem}.help-panel-close{background:none;border:1px solid var(--color-surface-border, #30363d);color:var(--color-secondary-info, #9e9e9e);cursor:pointer;padding:2px 8px;font-size:.9rem;line-height:1.4;border-radius:3px;transition:color .15s ease,border-color .15s ease}.help-panel-close:hover{color:var(--color-text-primary, #ffffff);border-color:var(--color-interactive, #00e5ff)}.help-panel-content{flex:1;overflow-y:auto;padding:16px 20px;color:var(--color-text-primary, #ffffff);white-space:pre-wrap;line-height:1.7}.help-panel-footer{padding:6px 16px;background-color:var(--color-surface-light, #21262d);border-top:1px solid var(--color-surface-border, #30363d);border-radius:0 0 2px 2px;color:var(--color-secondary-info, #9e9e9e);font-size:.75rem;flex-shrink:0;display:flex;flex-direction:column;gap:2px}.help-panel-footer-dismiss{opacity:.6}\n"], dependencies: [{ kind: "component", type: StatusBar, selector: "shell-status-bar" }, { kind: "component", type: SideMenu, selector: "shell-side-menu" }, { kind: "component", type: MainContent, selector: "shell-main-content" }, { kind: "component", type: CommandTerminal, selector: "shell-command-terminal" }] }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.13", type: Shell, isStandalone: true, selector: "shell-root", ngImport: i0, template: "<div class=\"shell\" [style.--terminal-height]=\"terminalHeight()\" [class.is-dragging]=\"isDragging()\">\n  <shell-status-bar class=\"shell-status\" [class.disabled-zone]=\"isThinking()\">\n    <ng-content />\n  </shell-status-bar>\n  @if (isAuthenticated()) {\n    <shell-side-menu class=\"shell-menu\" [class.disabled-zone]=\"isThinking()\" />\n  }\n  <shell-main-content class=\"shell-main\" [class.full-width]=\"!isAuthenticated()\" />\n  <div class=\"shell-resize\" [class.dragging]=\"isDragging()\" (mousedown)=\"onResizeStart($event)\"></div>\n  <shell-command-terminal class=\"shell-terminal\" [class.disabled-zone]=\"isThinking()\" />\n  <faq-modal />\n\n  @if (helpOverlay(); as helpText) {\n    <div class=\"help-backdrop\" (click)=\"dismissHelp()\">\n      <div class=\"help-panel\" (click)=\"$event.stopPropagation()\" role=\"dialog\" aria-label=\"Command help\">\n        <div class=\"help-panel-header\">\n          <span class=\"help-panel-title\">Help</span>\n          <button class=\"help-panel-close\" type=\"button\" (click)=\"dismissHelp()\" aria-label=\"Close help\">\u2715</button>\n        </div>\n        <div class=\"help-panel-content\">{{ helpText }}</div>\n        <div class=\"help-panel-footer\">\n          <span>Tip: for most commands you can swap the first and second words \u2014 e.g. \"disable user\" works the same as \"user disable\"</span>\n          <span class=\"help-panel-footer-dismiss\">Press Escape, click outside, or start typing to close</span>\n        </div>\n      </div>\n    </div>\n  }\n</div>\n", styles: [".shell{position:relative;display:grid;grid-template-areas:\"status   status\" \"menu     main\" \"resize   resize\" \"terminal terminal\";grid-template-columns:56px 1fr;grid-template-rows:48px 1fr 4px var(--terminal-height, 160px);height:100vh;width:100vw;overflow:hidden;background-color:var(--color-surface-dark)}.shell-status{grid-area:status}.shell-menu{grid-area:menu}.shell-main{grid-area:main;overflow:hidden}.shell-main.full-width{grid-column:1 / -1}.shell-resize{grid-area:resize;cursor:row-resize;background-color:var(--color-surface-border);transition:background-color .15s ease}.shell-resize:hover,.shell-resize.dragging{background-color:var(--color-interactive)}.shell-terminal{grid-area:terminal}.shell.is-dragging{user-select:none;-webkit-user-select:none}.disabled-zone{pointer-events:none;opacity:.4;transition:opacity .2s ease}.help-backdrop{position:absolute;inset:0;z-index:100;background-color:#000000a6;display:flex;align-items:center;justify-content:center}.help-panel{background-color:var(--color-surface, #161b22);border:2px solid var(--color-interactive, #00e5ff);border-radius:4px;width:70%;max-width:820px;max-height:75vh;display:flex;flex-direction:column;font-family:Roboto Mono,Courier New,monospace;font-size:.85rem}.help-panel-header{display:flex;justify-content:space-between;align-items:center;padding:8px 16px;background-color:var(--color-surface-light, #21262d);border-bottom:1px solid var(--color-interactive, #00e5ff);border-radius:2px 2px 0 0;flex-shrink:0}.help-panel-title{color:var(--color-interactive, #00e5ff);font-weight:700;letter-spacing:.05em;text-transform:uppercase;font-size:.75rem}.help-panel-close{background:none;border:1px solid var(--color-surface-border, #30363d);color:var(--color-secondary-info, #9e9e9e);cursor:pointer;padding:2px 8px;font-size:.9rem;line-height:1.4;border-radius:3px;transition:color .15s ease,border-color .15s ease}.help-panel-close:hover{color:var(--color-text-primary, #ffffff);border-color:var(--color-interactive, #00e5ff)}.help-panel-content{flex:1;overflow-y:auto;padding:16px 20px;color:var(--color-text-primary, #ffffff);white-space:pre-wrap;line-height:1.7}.help-panel-footer{padding:6px 16px;background-color:var(--color-surface-light, #21262d);border-top:1px solid var(--color-surface-border, #30363d);border-radius:0 0 2px 2px;color:var(--color-secondary-info, #9e9e9e);font-size:.75rem;flex-shrink:0;display:flex;flex-direction:column;gap:2px}.help-panel-footer-dismiss{opacity:.6}\n"], dependencies: [{ kind: "component", type: StatusBar, selector: "shell-status-bar" }, { kind: "component", type: SideMenu, selector: "shell-side-menu" }, { kind: "component", type: MainContent, selector: "shell-main-content" }, { kind: "component", type: CommandTerminal, selector: "shell-command-terminal" }, { kind: "component", type: FaqModal, selector: "faq-modal" }] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: Shell, decorators: [{
             type: Component,
-            args: [{ selector: 'shell-root', imports: [StatusBar, SideMenu, MainContent, CommandTerminal], template: "<div class=\"shell\" [style.--terminal-height]=\"terminalHeight()\" [class.is-dragging]=\"isDragging()\">\n  <shell-status-bar class=\"shell-status\" [class.disabled-zone]=\"isThinking()\">\n    <ng-content />\n  </shell-status-bar>\n  @if (isAuthenticated()) {\n    <shell-side-menu class=\"shell-menu\" [class.disabled-zone]=\"isThinking()\" />\n  }\n  <shell-main-content class=\"shell-main\" [class.full-width]=\"!isAuthenticated()\" />\n  <div class=\"shell-resize\" [class.dragging]=\"isDragging()\" (mousedown)=\"onResizeStart($event)\"></div>\n  <shell-command-terminal class=\"shell-terminal\" [class.disabled-zone]=\"isThinking()\" />\n  @if (helpOverlay(); as helpText) {\n    <div class=\"help-backdrop\" (click)=\"dismissHelp()\">\n      <div class=\"help-panel\" (click)=\"$event.stopPropagation()\" role=\"dialog\" aria-label=\"Command help\">\n        <div class=\"help-panel-header\">\n          <span class=\"help-panel-title\">Help</span>\n          <button class=\"help-panel-close\" type=\"button\" (click)=\"dismissHelp()\" aria-label=\"Close help\">\u2715</button>\n        </div>\n        <div class=\"help-panel-content\">{{ helpText }}</div>\n        <div class=\"help-panel-footer\">\n          <span>Tip: for most commands you can swap the first and second words \u2014 e.g. \"disable user\" works the same as \"user disable\"</span>\n          <span class=\"help-panel-footer-dismiss\">Press Escape, click outside, or start typing to close</span>\n        </div>\n      </div>\n    </div>\n  }\n</div>\n", styles: [".shell{position:relative;display:grid;grid-template-areas:\"status   status\" \"menu     main\" \"resize   resize\" \"terminal terminal\";grid-template-columns:56px 1fr;grid-template-rows:48px 1fr 4px var(--terminal-height, 160px);height:100vh;width:100vw;overflow:hidden;background-color:var(--color-surface-dark)}.shell-status{grid-area:status}.shell-menu{grid-area:menu}.shell-main{grid-area:main;overflow:hidden}.shell-main.full-width{grid-column:1 / -1}.shell-resize{grid-area:resize;cursor:row-resize;background-color:var(--color-surface-border);transition:background-color .15s ease}.shell-resize:hover,.shell-resize.dragging{background-color:var(--color-interactive)}.shell-terminal{grid-area:terminal}.shell.is-dragging{user-select:none;-webkit-user-select:none}.disabled-zone{pointer-events:none;opacity:.4;transition:opacity .2s ease}.help-backdrop{position:absolute;inset:0;z-index:100;background-color:#000000a6;display:flex;align-items:center;justify-content:center}.help-panel{background-color:var(--color-surface, #161b22);border:2px solid var(--color-interactive, #00e5ff);border-radius:4px;width:70%;max-width:820px;max-height:75vh;display:flex;flex-direction:column;font-family:Roboto Mono,Courier New,monospace;font-size:.85rem}.help-panel-header{display:flex;justify-content:space-between;align-items:center;padding:8px 16px;background-color:var(--color-surface-light, #21262d);border-bottom:1px solid var(--color-interactive, #00e5ff);border-radius:2px 2px 0 0;flex-shrink:0}.help-panel-title{color:var(--color-interactive, #00e5ff);font-weight:700;letter-spacing:.05em;text-transform:uppercase;font-size:.75rem}.help-panel-close{background:none;border:1px solid var(--color-surface-border, #30363d);color:var(--color-secondary-info, #9e9e9e);cursor:pointer;padding:2px 8px;font-size:.9rem;line-height:1.4;border-radius:3px;transition:color .15s ease,border-color .15s ease}.help-panel-close:hover{color:var(--color-text-primary, #ffffff);border-color:var(--color-interactive, #00e5ff)}.help-panel-content{flex:1;overflow-y:auto;padding:16px 20px;color:var(--color-text-primary, #ffffff);white-space:pre-wrap;line-height:1.7}.help-panel-footer{padding:6px 16px;background-color:var(--color-surface-light, #21262d);border-top:1px solid var(--color-surface-border, #30363d);border-radius:0 0 2px 2px;color:var(--color-secondary-info, #9e9e9e);font-size:.75rem;flex-shrink:0;display:flex;flex-direction:column;gap:2px}.help-panel-footer-dismiss{opacity:.6}\n"] }]
+            args: [{ selector: 'shell-root', imports: [StatusBar, SideMenu, MainContent, CommandTerminal, FaqModal], template: "<div class=\"shell\" [style.--terminal-height]=\"terminalHeight()\" [class.is-dragging]=\"isDragging()\">\n  <shell-status-bar class=\"shell-status\" [class.disabled-zone]=\"isThinking()\">\n    <ng-content />\n  </shell-status-bar>\n  @if (isAuthenticated()) {\n    <shell-side-menu class=\"shell-menu\" [class.disabled-zone]=\"isThinking()\" />\n  }\n  <shell-main-content class=\"shell-main\" [class.full-width]=\"!isAuthenticated()\" />\n  <div class=\"shell-resize\" [class.dragging]=\"isDragging()\" (mousedown)=\"onResizeStart($event)\"></div>\n  <shell-command-terminal class=\"shell-terminal\" [class.disabled-zone]=\"isThinking()\" />\n  <faq-modal />\n\n  @if (helpOverlay(); as helpText) {\n    <div class=\"help-backdrop\" (click)=\"dismissHelp()\">\n      <div class=\"help-panel\" (click)=\"$event.stopPropagation()\" role=\"dialog\" aria-label=\"Command help\">\n        <div class=\"help-panel-header\">\n          <span class=\"help-panel-title\">Help</span>\n          <button class=\"help-panel-close\" type=\"button\" (click)=\"dismissHelp()\" aria-label=\"Close help\">\u2715</button>\n        </div>\n        <div class=\"help-panel-content\">{{ helpText }}</div>\n        <div class=\"help-panel-footer\">\n          <span>Tip: for most commands you can swap the first and second words \u2014 e.g. \"disable user\" works the same as \"user disable\"</span>\n          <span class=\"help-panel-footer-dismiss\">Press Escape, click outside, or start typing to close</span>\n        </div>\n      </div>\n    </div>\n  }\n</div>\n", styles: [".shell{position:relative;display:grid;grid-template-areas:\"status   status\" \"menu     main\" \"resize   resize\" \"terminal terminal\";grid-template-columns:56px 1fr;grid-template-rows:48px 1fr 4px var(--terminal-height, 160px);height:100vh;width:100vw;overflow:hidden;background-color:var(--color-surface-dark)}.shell-status{grid-area:status}.shell-menu{grid-area:menu}.shell-main{grid-area:main;overflow:hidden}.shell-main.full-width{grid-column:1 / -1}.shell-resize{grid-area:resize;cursor:row-resize;background-color:var(--color-surface-border);transition:background-color .15s ease}.shell-resize:hover,.shell-resize.dragging{background-color:var(--color-interactive)}.shell-terminal{grid-area:terminal}.shell.is-dragging{user-select:none;-webkit-user-select:none}.disabled-zone{pointer-events:none;opacity:.4;transition:opacity .2s ease}.help-backdrop{position:absolute;inset:0;z-index:100;background-color:#000000a6;display:flex;align-items:center;justify-content:center}.help-panel{background-color:var(--color-surface, #161b22);border:2px solid var(--color-interactive, #00e5ff);border-radius:4px;width:70%;max-width:820px;max-height:75vh;display:flex;flex-direction:column;font-family:Roboto Mono,Courier New,monospace;font-size:.85rem}.help-panel-header{display:flex;justify-content:space-between;align-items:center;padding:8px 16px;background-color:var(--color-surface-light, #21262d);border-bottom:1px solid var(--color-interactive, #00e5ff);border-radius:2px 2px 0 0;flex-shrink:0}.help-panel-title{color:var(--color-interactive, #00e5ff);font-weight:700;letter-spacing:.05em;text-transform:uppercase;font-size:.75rem}.help-panel-close{background:none;border:1px solid var(--color-surface-border, #30363d);color:var(--color-secondary-info, #9e9e9e);cursor:pointer;padding:2px 8px;font-size:.9rem;line-height:1.4;border-radius:3px;transition:color .15s ease,border-color .15s ease}.help-panel-close:hover{color:var(--color-text-primary, #ffffff);border-color:var(--color-interactive, #00e5ff)}.help-panel-content{flex:1;overflow-y:auto;padding:16px 20px;color:var(--color-text-primary, #ffffff);white-space:pre-wrap;line-height:1.7}.help-panel-footer{padding:6px 16px;background-color:var(--color-surface-light, #21262d);border-top:1px solid var(--color-surface-border, #30363d);border-radius:0 0 2px 2px;color:var(--color-secondary-info, #9e9e9e);font-size:.75rem;flex-shrink:0;display:flex;flex-direction:column;gap:2px}.help-panel-footer-dismiss{opacity:.6}\n"] }]
         }] });
 
 class Login {
     #postLoginRoute;
     #commandService;
     #terminalFocusService;
+    #activatedRoute;
     constructor(authenticationService, router) {
         this.authenticationService = authenticationService;
         this.router = router;
@@ -917,6 +1909,24 @@ class Login {
         this.#postLoginRoute = inject(SHELL_POST_LOGIN_ROUTE, { optional: true }) ?? '/';
         this.#commandService = inject(CommandService);
         this.#terminalFocusService = inject(TerminalFocusService);
+        this.#activatedRoute = inject(ActivatedRoute);
+    }
+    /**
+     * Returns the post-login destination. Honors a `returnUrl` query param if
+     * present and safe (same-origin, leading `/`, not protocol-relative);
+     * otherwise falls back to `SHELL_POST_LOGIN_ROUTE`.
+     */
+    #resolvePostLoginUrl() {
+        const candidate = this.#activatedRoute.snapshot.queryParamMap.get('returnUrl');
+        if (!candidate)
+            return this.#postLoginRoute;
+        if (!candidate.startsWith('/'))
+            return this.#postLoginRoute;
+        if (candidate.startsWith('//'))
+            return this.#postLoginRoute;
+        if (/^https?:\/\//i.test(candidate))
+            return this.#postLoginRoute;
+        return candidate;
     }
     onAutofill(event, inputEl) {
         if (event.isAutofilled) {
@@ -961,7 +1971,7 @@ class Login {
             .login(this.model, force)
             .then(() => {
             this.#commandService.echoCommand(`login ${this.model.username}`);
-            this.router.navigate([this.#postLoginRoute]).then(() => {
+            this.router.navigateByUrl(this.#resolvePostLoginUrl()).then(() => {
                 setTimeout(() => this.#terminalFocusService.requestFocus());
             }).catch(console.error);
         })
@@ -1038,5 +2048,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AuthenticationService, CLEAR_USAGE, CommandRegistryService, CommandService, CommandTerminal, ConfirmDialog, HELP_USAGE, KeyboardShortcutService, Login, MainContent, RegexValidatorDirective, SHELL_APP_NAME, SHELL_AUTH_URLS, SHELL_COMMANDS, SHELL_MENU_ITEMS, SHELL_POST_LOGIN_ROUTE, Shell, SideMenu, StatusBar, TerminalFocusService, ThemeService, ThinkingService, authGuard, authInterceptor, guestGuard, provideShellConfig, tokenize };
+export { AuthenticationService, CLEAR_USAGE, CommandRegistryService, CommandService, CommandTerminal, ConfirmDialog, FAQ_CONTENT_LOADER, FAQ_DEV_EDITOR, FAQ_DEV_MODE, FAQ_DEV_WORKSPACE_ROOT, FaqAuthoringPanel, FaqHistoryService, FaqMarkdownRendererService, FaqModal, FaqService, HELP_USAGE, HttpFaqContentLoader, KeyboardShortcutService, Login, MainContent, RegexValidatorDirective, SHELL_APP_NAME, SHELL_AUTH_URLS, SHELL_COMMANDS, SHELL_MENU_ITEMS, SHELL_POST_LOGIN_ROUTE, Shell, SideMenu, StatusBar, TerminalFocusService, ThemeService, ThinkingService, audienceAllowed, authGuard, authInterceptor, buildFallbackChain, guestGuard, provideShellConfig, tokenize };
 //# sourceMappingURL=franzzemen-brokenstock-shell.mjs.map