@cplieger/web-terminal-ui 8.3.5-dev.1 → 8.4.0-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplieger/web-terminal-ui",
-  "version": "8.3.5-dev.1",
+  "version": "8.4.0-dev.1",
   "type": "module",
   "description": "Reference touch-first browser UI for @cplieger/web-terminal-engine: a composable kernel + feature modules (tabs, activity monitor, mobile toolbar, context menu, IME, predictive echo, viewport handling) and CSS. One createTerminal() call.",
   "license": "MPL-2.0",

package/src/composition.ts

@@ -18,7 +18,7 @@ import { windowOf } from "./kernel/realm.js";
  *  after a pause, against losing all input until an unrelated event fires. */
 const COMPOSITION_IDLE_MS = 5000;
 
-export interface CompositionOptions {
+interface CompositionOptions {
   textarea: HTMLTextAreaElement;
   compositionView: HTMLElement;
   getCursorPx: () => { left: number; top: number; cellH: number };

package/src/features/tabs/model.ts

@@ -246,7 +246,7 @@ export function isUnseenCue(
 
 /** What the cue fold reads per tab; structural, so a caller passes its own tab
  *  objects. */
-export interface CueCandidate {
+interface CueCandidate {
   readonly id: string;
   readonly status: string;
 }
@@ -255,7 +255,7 @@ export interface CueCandidate {
  *  WORST for the icon. A count is set-valued and needs no rule for choosing among
  *  sessions; severity is a total order, so the icon's choice is not arbitrary.
  *  Neither names a session, the standing constraint on a page-wide surface. */
-export interface CueSummary {
+interface CueSummary {
   readonly count: number;
   readonly worst: CueStatus | "";
 }
@@ -480,7 +480,7 @@ export function hasPinnedName(tab: Tab): boolean {
 
 /** The realm a session API runs in: the mounted window's `fetch`, its abort
  *  signals and its clock, never the importing page's. */
-export interface SessionAPIRealm {
+interface SessionAPIRealm {
   readonly fetch: typeof fetch;
   readonly AbortSignal: typeof AbortSignal;
   readonly Date: typeof Date;
@@ -489,7 +489,7 @@ export interface SessionAPIRealm {
 /** The session REST client, bound to an apiBase. Every call is timeout-bounded:
  *  fetch has no default timeout, and a stalled-but-open server would leave a
  *  bootstrap await pending forever. */
-export interface SessionAPI {
+interface SessionAPI {
   list(): Promise<SessionInfo[]>;
   create(): Promise<SessionInfo>;
   close(id: string): Promise<void>;
@@ -753,7 +753,7 @@ export function createSessionAPI(apiBase: string, realm: SessionAPIRealm): Sessi
  *  listing (the SSE re-open snapshot, or the poll's GET /api/sessions) that
  *  predates the server reaping the session does not re-adopt (flash back) the
  *  closed tab. */
-export interface Tombstones {
+interface Tombstones {
   add(id: string): void;
   /** True while `id` is tombstoned (within the TTL). A hit past the TTL clears
    *  the entry and reports false (the adopt may proceed). */

package/src/features/tabs/switch-anim.ts

@@ -23,7 +23,7 @@ export const SWITCH_ANIMATIONS = {
 } as const;
 
 /** A class the tabs feature puts on the terminal surface to play a switch animation. */
-export type SwitchClass = keyof typeof SWITCH_ANIMATIONS;
+type SwitchClass = keyof typeof SWITCH_ANIMATIONS;
 
 /** The three classes, for a caller that has to clear whichever one is present. */
 export const SWITCH_CLASSES = Object.keys(SWITCH_ANIMATIONS) as SwitchClass[];

package/src/kernel/a11y.ts

@@ -33,6 +33,7 @@ let REANNOUNCE_DELAY_MS = 100;
 
 /** @internal Test seam: re-set every later announcement after `ms`; returns the
  *  previous value so the caller can restore it. */
+// deadset:ignore DS1004 -- the browser tests shorten the re-announce delay so they need not wait out the real one
 export function setReannounceDelayMs(ms: number): number {
   const previous = REANNOUNCE_DELAY_MS;
   REANNOUNCE_DELAY_MS = ms;

package/src/kernel/bus.ts

@@ -9,7 +9,7 @@
 import type { TerminalEvents, Unsubscribe } from "./types.js";
 
 /** A typed event bus over TerminalEvents. */
-export interface TypedBus {
+interface TypedBus {
   on<K extends keyof TerminalEvents>(e: K, fn: (p: TerminalEvents[K]) => void): Unsubscribe;
   emit<K extends keyof TerminalEvents>(e: K, p: TerminalEvents[K]): void;
   /** Drop every listener (used on kernel destroy). */

package/src/kernel/conn-state.ts

@@ -41,7 +41,7 @@ export interface ConnStateMachine {
 
 /** The timers the machine schedules on: the mounted window's, so a grace delay
  *  runs on the terminal's own clock. */
-export interface ConnStateTimers {
+interface ConnStateTimers {
   setTimeout(handler: () => void, ms: number): number;
   clearTimeout(id: number): void;
 }

package/src/kernel/fatal.ts

@@ -15,7 +15,7 @@ export function fadeOutOverlay(ld: HTMLElement | undefined): void {
   windowOf(ld.ownerDocument).setTimeout(removeOverlay, 1500);
 }
 
-export interface FatalPanelOptions {
+interface FatalPanelOptions {
   message?: string;
   /** `showModal()` (the terminal IS the page) or the bare `open` attribute (an
    *  embedded panel, or a pane beside a live one). */

package/src/kernel/feature-host.ts

@@ -50,7 +50,7 @@ interface Entry {
   readonly scope: CleanupScope;
 }
 
-export interface FeatureHost {
+interface FeatureHost {
   /** Set one feature up. The scope exists before `setup` runs, so a throw drains
    *  what the feature acquired; a `destroyed()` true after the await tears the
    *  instance down instead of registering it. */

package/src/kernel/keyboard-presence.ts

@@ -27,7 +27,7 @@ export interface KeyboardPresenceTracker extends KeyboardPresence {
   noteSoftKeyboard(heightPx: number, editableFocused: boolean): void;
 }
 
-export interface KeyboardPresenceOptions {
+interface KeyboardPresenceOptions {
   readonly win: Window & typeof globalThis;
   /** Never the suppressed inset: the suppression itself reads this tracker. */
   readonly softKeyboardHeight: () => number;

package/src/kernel/notify.ts

@@ -5,6 +5,7 @@
 import type { Notifier } from "./types.js";
 
 interface NotificationLike {
+  // deadset:ignore DS1301 -- the browser's Notification calls this handler when the user clicks the notification
   onclick: ((event: Event) => void) | null;
   close: () => void;
 }

package/src/kernel/pane.ts

@@ -200,7 +200,6 @@ export interface PaneKernel extends PaneHandle {
   ): Unsubscribe;
   connectionInitiated(): boolean;
   isDestroyed(): boolean;
-  layout(): { narrow: boolean; coarse: boolean };
   toast(message: string, ms?: number): void;
   announce(message: string, politeness?: "polite" | "assertive"): void;
   paste(text: string): void;
@@ -1468,7 +1467,6 @@ function buildPaneInto(
       ),
     connectionInitiated: () => connectionInitiated,
     isDestroyed: () => destroyed,
-    layout,
     toast,
     announce: (message, politeness) => {
       announcer.announce(message, politeness);

package/src/kernel/scrollback.ts

@@ -44,7 +44,7 @@ const DEFAULT_SAVE_INTERVAL_MS = 10_000;
 
 /** What the kernel drives. Every method is safe to call at any point in the
  *  terminal's life, including after stop(). */
-export interface ScrollbackKeeper {
+interface ScrollbackKeeper {
   /** The store for a session: hydrated from storage when a usable entry exists,
    *  otherwise a fresh one. Either way the store is tracked for saving. Seeds
    *  the persisted server epoch, so this MUST be called before that session

package/src/kernel/status-share.ts

@@ -7,7 +7,7 @@ import type { Unsubscribe } from "./types.js";
 
 /** Opens the server's status stream at a path; the engine's `connectStatusStream`
  *  in production. */
-export type StatusConnector = (path: string, callbacks: StatusStreamCallbacks) => StatusStream;
+type StatusConnector = (path: string, callbacks: StatusStreamCallbacks) => StatusStream;
 
 /** The shell's shared status streams. */
 export interface StatusShare {

package/src/viewport.ts

@@ -13,6 +13,7 @@ let SETTLE_MS = 350;
 
 /** @internal Test seam: arm every settle started from now on at `ms`; returns the
  *  previous value so the caller can restore it. */
+// deadset:ignore DS1004 -- the browser tests shorten the settle delay so they need not wait out the real one
 export function setSettleMs(ms: number): number {
   const previous = SETTLE_MS;
   SETTLE_MS = ms;
@@ -27,7 +28,7 @@ interface KeyboardGeometry {
   readonly bottom: number;
 }
 
-export interface KeyboardInsetsOptions {
+interface KeyboardInsetsOptions {
   /** The outermost terminal root: receives --kb-inset and --vv-top, which every
    *  pane and chrome element beneath it inherits, so they scope to the terminal
    *  subtree instead of leaking onto the host document. */
@@ -56,7 +57,7 @@ export interface KeyboardInsets {
   teardown(): void;
 }
 
-export interface ViewportOptions {
+interface ViewportOptions {
   termWrap: HTMLElement;
   /** The box termWrap is pinned within, observed in its place: termWrap's
    *  insets follow chrome measured in ResizeObserver callbacks on boxes deeper