@north-light/crouter 0.3.192 → 0.3.193

package/dist/clients/inbox/page-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { PageResponses } from '../../core/human/page-schema.js';
+import type { PageSourceProjection } from '../../core/human/page.js';
+import type { PageTicket } from '../../core/human/tickets.js';
+import type { Key } from './tui/keys.js';
+export interface PageAdapterOptions {
+    dir: string;
+    ticket: PageTicket;
+    projection: PageSourceProjection;
+    productKinds: string[];
+    cols: number;
+    rows: number;
+    onProgress?: (responses: PageResponses) => void;
+    onComplete: (responses: PageResponses) => void;
+    onBack: () => void;
+    onDirty: () => void;
+    onEditorRequest?: () => void;
+}
+/** Embeds the page renderer in a controller-owned rectangle. */
+export declare class PageAdapter {
+    private readonly opts;
+    private panel;
+    /** The live manifest — reload() can swap a display page for a response-bearing one. */
+    private manifest;
+    constructor(opts: PageAdapterOptions);
+    render(): string[];
+    resize(cols: number, rows: number): string[];
+    inputBuffer(): string | undefined;
+    setInputBuffer(text: string): void;
+    canAcceptHostKeys(): boolean;
+    handleKey(input: string, key: Key): void;
+    reload(ticket: PageTicket, projection: PageSourceProjection): void;
+    close(): void;
+}

package/dist/clients/inbox/page-adapter.js

@@ -0,0 +1,54 @@
+import { writePageProgress } from '../../core/human/tickets.js';
+import { mountPanel } from './tui/panel.js';
+import { awaitsResponse } from './tui/slots.js';
+/** Embeds the page renderer in a controller-owned rectangle. */
+export class PageAdapter {
+    opts;
+    panel;
+    /** The live manifest — reload() can swap a display page for a response-bearing one. */
+    manifest;
+    constructor(opts) {
+        this.opts = opts;
+        this.manifest = opts.ticket.manifest;
+        this.panel = mountPanel({
+            manifest: opts.ticket.manifest,
+            projection: opts.projection,
+            productKinds: opts.productKinds,
+            initialResponses: opts.ticket.progress,
+            cols: opts.cols,
+            rows: opts.rows,
+            onProgress: (responses) => {
+                try {
+                    writePageProgress(opts.dir, responses, opts.productKinds);
+                }
+                catch { /* partial in-flight input may not validate yet */ }
+                opts.onProgress?.(responses);
+            },
+            onComplete: opts.onComplete,
+            onExit: () => { if (awaitsResponse(this.manifest))
+                opts.onBack();
+            else
+                opts.onComplete({}); },
+            onDirty: opts.onDirty,
+            onEditorRequest: opts.onEditorRequest,
+        });
+    }
+    render() { return this.panel.render(); }
+    resize(cols, rows) { return this.panel.handleResize(cols, rows); }
+    inputBuffer() { return this.panel.getInputBuffer(); }
+    setInputBuffer(text) { this.panel.setInputBuffer(text); }
+    canAcceptHostKeys() { return this.panel.canAcceptHostKeys(); }
+    handleKey(input, key) {
+        if (key.escape && this.panel.atPageTop()) {
+            this.opts.onBack();
+            return;
+        }
+        this.panel.handleKey(input, key);
+    }
+    reload(ticket, projection) {
+        this.manifest = ticket.manifest;
+        this.panel.loadPage(ticket.manifest, projection, { initialResponses: ticket.progress, productKinds: this.opts.productKinds });
+        this.opts.onDirty();
+    }
+    close() { this.panel.unmount(); }
+}

package/dist/clients/inbox/resolve.d.ts

@@ -1,6 +1,6 @@
-import type { InteractionResponse } from '../../core/human/types.js';
+import type { PageResponses } from '../../core/human/page-schema.js';
 export declare function nodeIdFor(dir: string): string;
-export declare function resolveTicketDeck(dir: string, responses: InteractionResponse[]): Promise<void>;
+export declare function resolveTicketPage(dir: string, responses: PageResponses): Promise<void>;
 export declare function cancelTicketViaDaemon(dir: string, opts: {
     reason: string;
     actor: string;

package/dist/clients/inbox/resolve.js

@@ -4,7 +4,7 @@ import { cliClient } from '../../commands/api-client.js';
 export function nodeIdFor(dir) {
     return basename(dir);
 }
-export async function resolveTicketDeck(dir, responses) {
+export async function resolveTicketPage(dir, responses) {
     await cliClient().resolveHumanTicket(nodeIdFor(dir), { responses });
 }
 export async function cancelTicketViaDaemon(dir, opts) {

package/dist/clients/inbox/review-visibility.d.ts

@@ -1,5 +1,5 @@
 import type { TicketSummary } from '../../core/human/types.js';
 /** Match the daemon's opaque inbox id: canonical tickets root, NUL, bridge id. */
 export declare function opaqueTicketId(canonicalTicketsRoot: string, bridgeNodeId: string): string;
-/** Retain local deck rows and only daemon-visible review rows. */
+/** Retain local page rows and only daemon-visible review rows. */
 export declare function filterVisibleReviewTickets(tickets: readonly TicketSummary[], visibleIds: ReadonlySet<string>): TicketSummary[];

package/dist/clients/inbox/review-visibility.js

@@ -6,7 +6,7 @@ import { ticketsRoot } from '../../core/human/root.js';
 export function opaqueTicketId(canonicalTicketsRoot, bridgeNodeId) {
     return createHash('sha256').update(`${canonicalTicketsRoot}\0${bridgeNodeId}`, 'utf8').digest('hex');
 }
-/** Retain local deck rows and only daemon-visible review rows. */
+/** Retain local page rows and only daemon-visible review rows. */
 export function filterVisibleReviewTickets(tickets, visibleIds) {
     let canonicalTicketsRoot;
     try {

package/dist/clients/inbox/tui/ansi.d.ts

@@ -13,7 +13,7 @@ export declare function sanitize(text: string): string;
 export declare function singleLine(text: string): string;
 export declare function hline(width: number, char?: string): string;
 export declare function padRight(text: string, width: number): string;
-/** Char-based width truncation with a trailing ellipsis. The canonical deck
+/** Char-based width truncation with a trailing ellipsis. The canonical page
  *  renderer variant. */
 export declare function truncate(text: string, maxWidth: number): string;
 /** Word-aware truncation that also flattens newlines and strips decorative

package/dist/clients/inbox/tui/ansi.js

@@ -1,6 +1,6 @@
 import stringWidth from 'string-width';
 // ── ANSI escape constants ─────────────────────────────────────────────────────
-// The single home for these — both the deck renderer (render.ts) and the inbox
+// The single home for these — both the page renderer (render.ts) and the inbox
 // picker (inbox/tui.ts) import from here rather than keeping their own copies.
 export const ESC = '\x1b[';
 export const RESET = `${ESC}0m`;
@@ -34,7 +34,7 @@ export function padRight(text, width) {
         return text;
     return text + ' '.repeat(width - w);
 }
-/** Char-based width truncation with a trailing ellipsis. The canonical deck
+/** Char-based width truncation with a trailing ellipsis. The canonical page
  *  renderer variant. */
 export function truncate(text, maxWidth) {
     if (maxWidth < 1)

package/dist/clients/inbox/tui/input.d.ts

@@ -1,7 +1,5 @@
 import type { TuiState } from './types.js';
-import type { Interaction } from '../../../core/human/types.js';
 import type { Key } from './keys.js';
 export type RenderFn = () => void;
-export type ExitFn = () => void;
-export declare function assignShortcuts(interactions: Interaction[]): void;
+export type ExitFn = (submit?: boolean) => void;
 export declare function handleKeypress(input: string, key: Key, state: TuiState, render: RenderFn, exit: ExitFn): void;