@timurproko/a1 0.2.4 → 0.2.5-dev.698

package/dist/ui/apps/host.d.ts

@@ -22,9 +22,10 @@ export interface AppHostOptions {
     readonly theme?: UiTheme;
 }
 /**
- * Presents at most one app. Input reaches the presented app first; anything it
- * does not consume continues to the caller. A failure while rendering or
- * handling input closes the app rather than leaving a broken surface on screen.
+ * Presents at most one app. An opted-in interrupt closes at the host boundary;
+ * other input reaches the presented app first and anything it does not consume
+ * continues to the caller. A failure while rendering or handling input closes
+ * the app rather than leaving a broken surface on screen.
  */
 export declare class UiAppHost {
     #private;

package/dist/ui/apps/host.js

@@ -5,9 +5,10 @@ const INTERRUPT = "";
 /** How long the first interrupt of the chord stays armed. */
 const INTERRUPT_CHORD_MS = 1_500;
 /**
- * Presents at most one app. Input reaches the presented app first; anything it
- * does not consume continues to the caller. A failure while rendering or
- * handling input closes the app rather than leaving a broken surface on screen.
+ * Presents at most one app. An opted-in interrupt closes at the host boundary;
+ * other input reaches the presented app first and anything it does not consume
+ * continues to the caller. A failure while rendering or handling input closes
+ * the app rather than leaving a broken surface on screen.
  */
 export class UiAppHost {
     #registry;
@@ -70,6 +71,10 @@ export class UiAppHost {
         const app = this.#app;
         if (app === null)
             return { consumed: false };
+        if (data === INTERRUPT && this.#closeOnInterrupt) {
+            this.close();
+            return { consumed: true, render: true };
+        }
         const result = this.#guard(() => app.onInput?.(data, this.#services())) ?? { consumed: false };
         if (this.#app === null)
             return { consumed: true, render: true };
@@ -91,7 +96,7 @@ export class UiAppHost {
             this.render();
         return result;
     }
-    // Protocol: two interrupts within the chord window leave A1 from every screen.
+    // Protocol: a non-opted-in host preserves the two-interrupt application exit chord.
     #interrupt() {
         const now = Date.now();
         const armed = this.#interruptArmedAt;

package/dist/ui/components/dialog-panel.js

@@ -1,4 +1,4 @@
-import { renderShortcutHints, shortcutHintsText } from "./shortcut-hints.js";
+import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
 import { displayWidth, truncateToWidth } from "./text.js";
 const LABEL_COLUMN_CAP = 30;
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
@@ -22,18 +22,17 @@ export function renderDialogPanel(state, width, theme) {
         const padded = `${row.label}${" ".repeat(Math.max(0, labelColumn - displayWidth(row.label)))}`;
         const cursor = selected ? "→ " : "  ";
         const raw = `${cursor}${padded}  ${row.value}`;
-        // Compatibility: match pinned SettingsList: selected cursor, label, and value all use the
-        // accent role; an unselected label is plain and its value is muted.
-        const painted = selected
-            ? `${theme.fg("accent", cursor)}${theme.fg("accent", padded)}  ${theme.fg("accent", row.value)}`
+        const content = selected
+            ? `${theme.fg("accent", cursor)}${theme.fg("text", padded)}  ${theme.fg("muted", row.value)}`
             : `${cursor}${padded}  ${theme.fg("muted", row.value)}`;
+        const painted = selected ? theme.highlight(content) : content;
         return contentRow(painted, raw);
     });
     const description = state.rows[state.index]?.description ?? "";
     const hint = typeof state.hint === "string"
         ? theme.fg("dim", state.hint)
-        : renderShortcutHints(state.hint, theme, 0);
-    const plainHint = typeof state.hint === "string" ? state.hint : shortcutHintsText(state.hint, 0);
+        : renderShortcutHintsWithClose(state.hint, theme, contentWidth, 0);
+    const plainHint = typeof state.hint === "string" ? state.hint : " ".repeat(displayWidth(hint));
     return [
         rule,
         ...rows,

package/dist/ui/components/index.d.ts

@@ -23,7 +23,7 @@ export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selecti
 export type { SelectionCopyPrompt, SelectionCopyRow, SelectionCopySnapshot } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export type { RailPointer, RailPosition, ScrollbarAppearance, ScrollbarGeometry, ScrollbarInput, ScrollbarPresentation, ScrollbarPresentationInput, ScrollbarSpeed, ScrollbarStyle, } from "./scrollbar.js";
-export { renderShortcutHints } from "./shortcut-hints.js";
+export { renderShortcutHints, renderShortcutHintsWithClose } from "./shortcut-hints.js";
 export type { ShortcutHintEntry } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
 export type { ShortcutConflict, ShortcutDeclaration, ShortcutRegistryResult } from "./shortcuts.js";

package/dist/ui/components/index.js

@@ -11,7 +11,7 @@ export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
-export { renderShortcutHints } from "./shortcut-hints.js";
+export { renderShortcutHints, renderShortcutHintsWithClose } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
 export { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, hyperlinkTargetAtColumn, nativeHyperlinkStyle, overlaySpan } from "./spans.js";
 export { readVisibleHyperlinks } from "./visible-hyperlinks.js";

package/dist/ui/components/list-view.d.ts

@@ -44,9 +44,9 @@ export declare function valueColumnFor(rows: readonly ListViewRow[], indent?: nu
 /** A group's name with the shared one-cell section inset used by owned screens. */
 export declare function renderGroupHeader(title: string, width: number, theme: UiTheme): string;
 /**
- * One row, painted. The label carries the selection, the value carries the
- * pointer, and the stepper appears only when the pointer is on the value it
- * belongs to — an affordance, not decoration.
+ * One row, painted. The selected item keeps an accent cursor, normal-text label,
+ * muted value, and item-bounded highlight; the value carries the pointer, and the
+ * stepper appears only when the pointer is on the value it belongs to.
  */
 export declare function renderListRow(row: ListViewRow, state: ListRowState, valueColumn: number, width: number, theme: UiTheme): string;
 /** A line that stands in for rows: why a group has none, or what it is waiting on. */

package/dist/ui/components/list-view.js

@@ -18,9 +18,9 @@ export function renderGroupHeader(title, width, theme) {
     return ` ${truncateToWidth(theme.fg("mdHeading", theme.bold(title)), width - 1)}`;
 }
 /**
- * One row, painted. The label carries the selection, the value carries the
- * pointer, and the stepper appears only when the pointer is on the value it
- * belongs to — an affordance, not decoration.
+ * One row, painted. The selected item keeps an accent cursor, normal-text label,
+ * muted value, and item-bounded highlight; the value carries the pointer, and the
+ * stepper appears only when the pointer is on the value it belongs to.
  */
 export function renderListRow(row, state, valueColumn, width, theme) {
     const cursor = state.selected ? "→ " : "  ";
@@ -28,13 +28,11 @@ export function renderListRow(row, state, valueColumn, width, theme) {
     const labelPadded = `${row.label}${" ".repeat(Math.max(0, labelColumn - displayWidth(row.label)))}`;
     const leftRaw = `${cursor}${labelPadded}`;
     const left = state.selected
-        ? `${theme.fg("accent", cursor)}${theme.fg("accent", labelPadded)}`
+        ? `${theme.fg("accent", cursor)}${theme.fg("text", labelPadded)}`
         : `${cursor}${theme.plain(labelPadded)}`;
     const gap = Math.max(2, valueColumn - displayWidth(leftRaw));
-    // Rationale: a declared difference from pinned SettingsList, which paints the selected
-    // value in the accent too. Here only the cursor and label carry the selection; the
-    // value reads the same on every row, and pointer hover brightens it without moving
-    // the keyboard selection.
+    // Rationale: the value keeps the same semantic foreground on selected and unselected
+    // rows; pointer hover brightens it without moving keyboard selection.
     const valueHovered = state.hovered && state.region !== "label";
     const stepper = row.stepper !== undefined && valueHovered;
     const value = valueHovered ? theme.plain(row.value) : theme.fg("muted", row.value);
@@ -50,7 +48,8 @@ export function renderListRow(row, state, valueColumn, width, theme) {
         : "";
     const indent = Math.max(2, stepper ? gap - STEPPER_RESERVE : gap);
     const suffix = row.suffix === undefined ? "" : theme.fg("dim", `  ${row.suffix}`);
-    return truncateToWidth(`${left}${" ".repeat(indent)}${minus}${value}${plus}${suffix}`, width);
+    const rendered = truncateToWidth(`${left}${" ".repeat(indent)}${minus}${value}${plus}${suffix}`, width);
+    return state.selected ? theme.highlight(rendered) : rendered;
 }
 /** A line that stands in for rows: why a group has none, or what it is waiting on. */
 export function renderNote(text, width, theme) {

package/dist/ui/components/shortcut-hints.d.ts

@@ -5,3 +5,5 @@ export type ShortcutHintEntry = SemanticShortcutHint;
 export declare function shortcutHintsText(entries: readonly ShortcutHintEntry[], indent?: number): string;
 /** Paints one modal instruction row without decorative separator glyphs. */
 export declare function renderShortcutHints(entries: readonly ShortcutHintEntry[], theme: Pick<UiTheme, "fg">, indent?: number): string;
+/** Clips preceding guidance first so a final canonical close entry remains complete whenever it fits. */
+export declare function renderShortcutHintsWithClose(entries: readonly ShortcutHintEntry[], theme: Pick<UiTheme, "fg">, width: number, indent?: number): string;

package/dist/ui/components/shortcut-hints.js

@@ -1,4 +1,5 @@
-import { renderSemanticShortcutHints, } from "../../contracts/presentation/index.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, renderSemanticShortcutHints, } from "../../contracts/presentation/index.js";
+import { displayWidth, truncateToWidth } from "./text.js";
 /** Returns an unstyled modal instruction row for width-aware clipping. */
 export function shortcutHintsText(entries, indent = 0) {
     return renderSemanticShortcutHints(entries, { key: text => text, action: text => text }, indent);
@@ -10,3 +11,18 @@ export function renderShortcutHints(entries, theme, indent = 0) {
         action: text => theme.fg("muted", text),
     }, indent);
 }
+/** Clips preceding guidance first so a final canonical close entry remains complete whenever it fits. */
+export function renderShortcutHintsWithClose(entries, theme, width, indent = 0) {
+    const hasClose = entries.at(-1)?.key === DIALOG_CLOSE_SHORTCUT_HINT.key
+        && entries.at(-1)?.action === DIALOG_CLOSE_SHORTCUT_HINT.action;
+    if (!hasClose)
+        return truncateToWidth(renderShortcutHints(entries, theme, indent), width);
+    const withoutClose = entries.slice(0, -1);
+    const close = renderShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT], theme);
+    const closeWidth = displayWidth(close);
+    if (width <= closeWidth)
+        return truncateToWidth(close, width);
+    const bodyWidth = Math.max(0, width - closeWidth - 2);
+    const body = bodyWidth < 3 ? "" : truncateToWidth(renderShortcutHints(withoutClose, theme, indent), bodyWidth);
+    return displayWidth(body) === 0 ? close : `${body}  ${close}`;
+}

package/dist/ui/components/theme.d.ts

@@ -8,7 +8,7 @@ export interface UiTheme {
      * into a dark terminal, which is how the engine leaves its lists too.
      */
     plain(text: string): string;
-    /** Inverted styling for the active row of a floating surface. */
+    /** Selection background for an active list item or floating-surface row. */
     highlight(text: string): string;
     /** A control that is present but cannot act: quieter than quiet text. */
     disabled(text: string): string;

package/docs/assets/readme/separator-dark.svg

@@ -1,13 +1,11 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 220 52" width="220" height="52">
   <style>
-    text { font: 700 22px 'JetBrains Mono', SFMono-Regular, Consolas, Menlo, monospace; fill: rgb(166,181,255); text-anchor: middle; dominant-baseline: central; }
+    text { font: 400 22px 'JetBrains Mono', SFMono-Regular, Consolas, Menlo, monospace; fill: rgb(166,181,255); text-anchor: middle; dominant-baseline: central; }
     .star { animation: twinkle 2.4s ease-in-out infinite; }
     .s2 { animation-delay: -.8s; }
     .s3 { animation-delay: -1.6s; }
     @keyframes twinkle { 0%,100% { fill-opacity: .25; } 45%,55% { fill-opacity: 1; } }
     @media (prefers-reduced-motion: reduce) { .star { animation: none; fill-opacity: .7; } }
   </style>
-  <text class="star s1" x="70" y="26">*</text>
-  <text class="star s2" x="110" y="26">*</text>
-  <text class="star s3" x="150" y="26">*</text>
+  <text x="110" y="30" xml:space="preserve"><tspan class="star s1">*</tspan> <tspan class="star s2">*</tspan> <tspan class="star s3">*</tspan></text>
 </svg>

package/docs/assets/readme/separator.svg

@@ -1,13 +1,11 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 220 52" width="220" height="52">
   <style>
-    text { font: 700 22px 'JetBrains Mono', SFMono-Regular, Consolas, Menlo, monospace; fill: rgb(38,56,210); text-anchor: middle; dominant-baseline: central; }
+    text { font: 400 22px 'JetBrains Mono', SFMono-Regular, Consolas, Menlo, monospace; fill: rgb(38,56,210); text-anchor: middle; dominant-baseline: central; }
     .star { animation: twinkle 2.4s ease-in-out infinite; }
     .s2 { animation-delay: -.8s; }
     .s3 { animation-delay: -1.6s; }
     @keyframes twinkle { 0%,100% { fill-opacity: .25; } 45%,55% { fill-opacity: 1; } }
     @media (prefers-reduced-motion: reduce) { .star { animation: none; fill-opacity: .7; } }
   </style>
-  <text class="star s1" x="70" y="26">*</text>
-  <text class="star s2" x="110" y="26">*</text>
-  <text class="star s3" x="150" y="26">*</text>
+  <text x="110" y="30" xml:space="preserve"><tspan class="star s1">*</tspan> <tspan class="star s2">*</tspan> <tspan class="star s3">*</tspan></text>
 </svg>

package/docs/releases/0.2.4.md

@@ -1,16 +1,12 @@
 ## [0.2.4] - 2026-10-05
 
-### New Features
-
-- add README section navigation ([#678](https://github.com/timurproko/a1/pull/678))
-
 ### Changed
 
 - upgrade pinned Pi to 1.0.0 ([#658](https://github.com/timurproko/a1/pull/658))
+- upgrade pinned Pi to 1.0.2 ([#669](https://github.com/timurproko/a1/pull/669))
 - add animated mark, section art, and browser preview ([#665](https://github.com/timurproko/a1/pull/665))
 - keep the hero mark still and link only it to the site ([#666](https://github.com/timurproko/a1/pull/666))
 - pick dark-mode art via picture sources ([#668](https://github.com/timurproko/a1/pull/668))
-- upgrade pinned Pi to 1.0.2 ([#669](https://github.com/timurproko/a1/pull/669))
 
 ### Fixed
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.2.4",
+  "version": "0.2.5-dev.698",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "privateLaunchContract": "neutral-launch-v1",
@@ -65,8 +65,8 @@
     "typecheck:bin": "tsgo -p tsconfig.bin.json"
   },
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@earendil-works/pi-tui": "1.0.2",
+    "@earendil-works/pi-coding-agent": "1.0.4",
+    "@earendil-works/pi-tui": "1.0.4",
     "@silvia-odwyer/photon-node": "0.3.4",
     "chalk": "5.6.2",
     "cross-spawn": "7.0.6",