@franzzemen/brokenstock-shell 0.9.1 → 0.9.3

package/fesm2022/franzzemen-brokenstock-shell.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, makeEnvironmentProviders, signal, computed, Injectable, inject, input, Directive, isDevMode, effect, untracked, HostListener, ViewChild, ViewEncapsulation, ChangeDetectionStrategy, Component, DestroyRef, NgZone, viewChild, afterNextRender, output } from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, signal, computed, Injectable, inject, input, Directive, isDevMode, effect, untracked, HostListener, ViewChild, ViewEncapsulation, ChangeDetectionStrategy, Component, DestroyRef, NgZone, PLATFORM_ID, viewChild, afterNextRender, output } from '@angular/core';
 import * as i2$1 from '@angular/router';
 import { Router, RouterLink, RouterLinkActive, ActivatedRoute, RouterOutlet } from '@angular/router';
 import { BEARER_TOKEN_REGEX, HttpHeader, USERNAME_REGEX, PASSWORD_REGEX } from '@franzzemen/utility';
@@ -11,7 +11,7 @@ import { NG_VALIDATORS, FormsModule } from '@angular/forms';
 import { Marked } from 'marked';
 import { gfmHeadingId } from 'marked-gfm-heading-id';
 import fm from 'front-matter';
-import { NgClass, CommonModule, DOCUMENT, DatePipe } from '@angular/common';
+import { NgClass, CommonModule, DOCUMENT, isPlatformBrowser, DatePipe } from '@angular/common';
 import { Title, Meta } from '@angular/platform-browser';
 import { z } from 'zod/v4';
 import * as i1 from '@angular/material/icon';
@@ -2844,6 +2844,98 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImpor
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [] });
 
+/*
+Created by Franz Zemen 2026-10-18
+License Type: UNLICENSED
+
+Keys a screen owns while it is open: trading hotkeys (live-trading-foundation.prd.md D24, E8;
+live-trading.prd.md D34).
+
+`KeyboardShortcutService` cannot do this job, and is not changed to: it allows only Alt and Shift
+and switches itself off inside any input. Hotkeys need the opposite on both counts:
+
+- **Ctrl is allowed** (the defaults are Shift+F1 and Ctrl+F1). Meta (the Windows/Command key) never
+  matches.
+- **They work while the cursor is in the command terminal**, the one input that is not a place to
+  type a number. They do NOT fire while focus is in any other input, textarea, select or editable
+  element: a key there is typing.
+- **Matched on `event.code`**, the physical key, never the character produced.
+- **Held-down repeats are ignored** (`event.repeat`): one order per press.
+- **Only on the routes a registration names.**
+
+When a handler takes a key, the browser's own action for it is prevented and it goes no further.
+*/
+/** The class the command terminal's input carries; keys typed there still reach a screen's keys. */
+const TERMINAL_INPUT_CLASS = 'terminal-input';
+/** True when the key is typed into a box other than the command terminal. */
+function isTypingElsewhere(target) {
+    const el = target;
+    if (!el || typeof el.tagName !== 'string')
+        return false;
+    if (el.classList?.contains(TERMINAL_INPUT_CLASS))
+        return false;
+    if (el.isContentEditable)
+        return true;
+    const tag = el.tagName.toUpperCase();
+    if (tag === 'TEXTAREA' || tag === 'SELECT')
+        return true;
+    if (tag !== 'INPUT')
+        return false;
+    const type = (el.type || 'text').toLowerCase();
+    return !['checkbox', 'radio', 'button', 'submit', 'reset', 'range', 'color', 'file', 'image'].includes(type);
+}
+/** Exactly this combination: the key, and these modifiers and no others. */
+function comboMatches(combo, e) {
+    return e.code === combo.code && e.ctrlKey === combo.ctrl && e.shiftKey === combo.shift && e.altKey === combo.alt && !e.metaKey;
+}
+/** Whether a keydown may reach a screen's keys at all. */
+function isEligibleKey(e) {
+    return !e.repeat && !e.isComposing && !isTypingElsewhere(e.target);
+}
+class ScreenKeysService {
+    #document = inject(DOCUMENT);
+    #zone = inject(NgZone);
+    #router = inject(Router);
+    #registrations = new Set();
+    #listening = false;
+    constructor() {
+        if (!isPlatformBrowser(inject(PLATFORM_ID)))
+            return;
+        inject(DestroyRef).onDestroy(() => this.#document.removeEventListener('keydown', this.#onKey, true));
+    }
+    /** Registers keys for a screen; returns the function that removes them. */
+    register(registration) {
+        this.#registrations.add(registration);
+        if (!this.#listening) {
+            this.#listening = true;
+            // Capture phase, so a screen's key is seen before a focused control can act on it.
+            this.#zone.runOutsideAngular(() => this.#document.addEventListener('keydown', this.#onKey, true));
+        }
+        return () => this.#registrations.delete(registration);
+    }
+    #onKey = (e) => {
+        if (this.#registrations.size === 0 || !isEligibleKey(e))
+            return;
+        const url = this.#router.url;
+        for (const r of this.#registrations) {
+            if (!matchesRoute(url, r.routes))
+                continue;
+            const taken = this.#zone.run(() => r.handle(e));
+            if (taken) {
+                e.preventDefault();
+                e.stopPropagation();
+                return;
+            }
+        }
+    };
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: ScreenKeysService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: ScreenKeysService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImport: i0, type: ScreenKeysService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
 const FAQ_USAGE = 'faq\n' +
     'faq <key>\n' +
     'faq search <term>\n' +
@@ -3068,6 +3160,12 @@ class PendingPromptState {
 const CommandInputSchema = z.string().trim().min(1, 'Command cannot be empty');
 class CommandService {
     #prompts;
+    /**
+     * True while a command (or an answer) runs. A question it asks is written to the history only
+     * after the command's own lines, so it reads as the last thing said, under the preview it is about.
+     */
+    #running;
+    #deferredQuestion;
     constructor() {
         this.history = signal([], /* @ts-ignore */
         ...(ngDevMode ? [{ debugName: "history" }] : /* istanbul ignore next */ []));
@@ -3084,6 +3182,11 @@ class CommandService {
         this.pending = signal(null, /* @ts-ignore */
         ...(ngDevMode ? [{ debugName: "pending" }] : /* istanbul ignore next */ []));
         this.#prompts = new PendingPromptState();
+        /**
+         * True while a command (or an answer) runs. A question it asks is written to the history only
+         * after the command's own lines, so it reads as the last thing said, under the preview it is about.
+         */
+        this.#running = false;
         this.authService = inject(AuthenticationService);
         this.registry = inject(CommandRegistryService);
         this.router = inject(Router);
@@ -3108,11 +3211,25 @@ class CommandService {
     ask(prompt) {
         this.#prompts.ask(prompt);
         this.pending.set(prompt);
+        if (this.#running)
+            this.#deferredQuestion = prompt;
+        else
+            this.#writeQuestion(prompt);
+    }
+    #writeQuestion(prompt) {
         this.history.update(h => [...h, {
                 input: '',
                 result: { success: true, message: prompt.question, timestamp: new Date(), severity: 'info' },
             }]);
     }
+    /** After a command's or an answer's own lines: the question it asked, if it is still open. */
+    #finishRun() {
+        this.#running = false;
+        const q = this.#deferredQuestion;
+        this.#deferredQuestion = undefined;
+        if (q && this.#prompts.current === q)
+            this.#writeQuestion(q);
+    }
     /** Esc: closes the open question, if any. True when there was one. */
     cancelPending() {
         if (!this.#prompts.cancel())
@@ -3135,11 +3252,9 @@ class CommandService {
         this.currentInput.set('');
         const record = (result) => {
             this.history.update(h => [...h, { input: echo, result }]);
-            // An answer may ask again; show the new question after the answer's line.
-            const next = this.#prompts.current;
-            if (next && next !== this.pending())
-                this.pending.set(next);
+            this.#finishRun();
         };
+        this.#running = true;
         let out;
         try {
             out = prompt.answer(text);
@@ -3200,7 +3315,14 @@ class CommandService {
         // masked under `login` stays masked under any other word for it).
         const def = this.registry.resolve(command)?.command;
         const displayInput = def?.sanitizeInput ? def.sanitizeInput(input) : input;
-        const resultOrPromise = this.#dispatch(command, parts.slice(1));
+        this.#running = true;
+        let resultOrPromise;
+        try {
+            resultOrPromise = this.#dispatch(command, parts.slice(1));
+        }
+        catch (err) {
+            resultOrPromise = { success: false, message: err?.message ?? String(err), timestamp: new Date() };
+        }
         this.currentInput.set('');
         if (resultOrPromise instanceof Promise) {
             this.isProcessing.set(true);
@@ -3214,7 +3336,10 @@ class CommandService {
                     this.history.update(h => [...h, { input: displayInput, result: historyResult, repeatCount: 1 }]);
                 }
             })
-                .finally(() => this.isProcessing.set(false));
+                .finally(() => {
+                this.#finishRun();
+                this.isProcessing.set(false);
+            });
         }
         else {
             if (resultOrPromise.isHelp && resultOrPromise.message) {
@@ -3224,6 +3349,7 @@ class CommandService {
             if (!this.#coalesce(displayInput)) {
                 this.history.update(h => [...h, { input: displayInput, result: historyResult, repeatCount: 1 }]);
             }
+            this.#finishRun();
         }
     }
     #coalesce(input) {
@@ -4456,5 +4582,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AuthenticationService, AuthenticatorError, AuthenticatorSettings, CLEAR_USAGE, CODE_STEP, CodeDialog, CommandRegistryService, CommandService, CommandTerminal, ConfirmDialog, FAQ_CONTENT_LOADER, FAQ_DEV_EDITOR, FAQ_DEV_MODE, FAQ_DEV_WORKSPACE_ROOT, FAQ_PUBLIC_PUBLISHER, FAQ_PUBLIC_SITE_BASE_URL, FaqAuthoringPanel, FaqHistoryService, FaqMarkdownRendererService, FaqModal, FaqService, HELP_USAGE, HttpFaqContentLoader, KeyboardShortcutService, Login, MainContent, PendingPromptState, PhoneLayoutService, PublicFaqIndex, PublicFaqPage, PublicFaqToc, RecoveryCodes, RegexValidatorDirective, SESSION_TOKEN_KEY, SHELL_APP_NAME, SHELL_AUTH_URLS, SHELL_COMMANDS, SHELL_MENU_ITEMS, SHELL_PHONE_MEDIA_QUERY, SHELL_POST_LOGIN_ROUTE, SHELL_SHARED_SESSION, SessionTokenStore, Shell, SideMenu, StatusBar, TOO_MANY_ATTEMPTS, TerminalFocusService, TerminalVisibilityService, ThemeService, ThinkingService, answerEcho, audienceAllowed, authGuard, authInterceptor, authenticatorMessage, buildFallbackChain, buildLoginBody, decideRenewal, guestGuard, isYes, matchesRoute, openCodeDialog, provideShellConfig, recoveryCodesFile, tokenize };
+export { AuthenticationService, AuthenticatorError, AuthenticatorSettings, CLEAR_USAGE, CODE_STEP, CodeDialog, CommandRegistryService, CommandService, CommandTerminal, ConfirmDialog, FAQ_CONTENT_LOADER, FAQ_DEV_EDITOR, FAQ_DEV_MODE, FAQ_DEV_WORKSPACE_ROOT, FAQ_PUBLIC_PUBLISHER, FAQ_PUBLIC_SITE_BASE_URL, FaqAuthoringPanel, FaqHistoryService, FaqMarkdownRendererService, FaqModal, FaqService, HELP_USAGE, HttpFaqContentLoader, KeyboardShortcutService, Login, MainContent, PendingPromptState, PhoneLayoutService, PublicFaqIndex, PublicFaqPage, PublicFaqToc, RecoveryCodes, RegexValidatorDirective, SESSION_TOKEN_KEY, SHELL_APP_NAME, SHELL_AUTH_URLS, SHELL_COMMANDS, SHELL_MENU_ITEMS, SHELL_PHONE_MEDIA_QUERY, SHELL_POST_LOGIN_ROUTE, SHELL_SHARED_SESSION, ScreenKeysService, SessionTokenStore, Shell, SideMenu, StatusBar, TERMINAL_INPUT_CLASS, TOO_MANY_ATTEMPTS, TerminalFocusService, TerminalVisibilityService, ThemeService, ThinkingService, answerEcho, audienceAllowed, authGuard, authInterceptor, authenticatorMessage, buildFallbackChain, buildLoginBody, comboMatches, decideRenewal, guestGuard, isEligibleKey, isTypingElsewhere, isYes, matchesRoute, openCodeDialog, provideShellConfig, recoveryCodesFile, tokenize };
 //# sourceMappingURL=franzzemen-brokenstock-shell.mjs.map