@linxiraos/pi-tui 1.1.26 → 1.2.0

package/src/components/loader.d.ts

@@ -1,3 +1,4 @@
+import type { KeyId } from "../keys";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node";
 import { type ShimmerPalette } from "../theme/shimmer";
 import type { TUI } from "../tui";
@@ -23,16 +24,14 @@ export interface WorkingRowSpec {
     readonly variant?: WorkingRowVariant;
     /** Shimmer palette of the label (a session-accented intent). */
     readonly palette?: ShimmerPalette;
-    /** Live tok/s, docked before the stop control. */
-    readonly rate?: number;
     /** Key id that interrupts (`escape`); undefined hides the stop control (Esc would not cancel). */
-    readonly interruptKey?: string;
+    readonly interruptKey?: KeyId;
 }
 /**
  * The dock's working row: `starburst` spinner (or a retry countdown ring),
- * the intent shimmering, `·`, the elapsed time, a grow spacer, then the stop
- * control whose click sends `interrupt`. Compaction adds an indeterminate
- * `progress` before the stop control; a retry says "Cancel".
+ * the elapsed time, the `·` divider, the intent shimmering, a grow spacer,
+ * then the stop control whose click sends `interrupt`. Compaction adds an
+ * indeterminate `progress` before the stop control; a retry says "Cancel".
  */
 export declare function describeWorkingRow(spec: WorkingRowSpec, cx: DescribeContext, now?: number): NativeNode;
 type ColorFn = (str: string) => string;

package/src/components/loader.ts

@@ -1,4 +1,6 @@
 import type { TspProps } from "@linxiraos/pi-wire";
+import { formatTooltipKey } from "../key-hint-format";
+import type { KeyId } from "../keys";
 import { elapsed, kbd, keyed, node, row, span, text } from "../native/describe";
 import { plainText } from "../native/spans";
 import type { DescribeContext, NativeChild, NativeNode, NativeUiEvent } from "../native/node";
@@ -38,22 +40,15 @@ export interface WorkingRowSpec {
 	readonly variant?: WorkingRowVariant;
 	/** Shimmer palette of the label (a session-accented intent). */
 	readonly palette?: ShimmerPalette;
-	/** Live tok/s, docked before the stop control. */
-	readonly rate?: number;
 	/** Key id that interrupts (`escape`); undefined hides the stop control (Esc would not cancel). */
-	readonly interruptKey?: string;
-}
-
-/** A key id as tooltip keys: `escape` reads `esc`, the rest as bound. */
-function titleKey(key: string): string {
-	return key === "escape" ? "esc" : key;
+	readonly interruptKey?: KeyId;
 }
 
 /**
  * The dock's working row: `starburst` spinner (or a retry countdown ring),
- * the intent shimmering, `·`, the elapsed time, a grow spacer, then the stop
- * control whose click sends `interrupt`. Compaction adds an indeterminate
- * `progress` before the stop control; a retry says "Cancel".
+ * the elapsed time, the `·` divider, the intent shimmering, a grow spacer,
+ * then the stop control whose click sends `interrupt`. Compaction adds an
+ * indeterminate `progress` before the stop control; a retry says "Cancel".
  */
 export function describeWorkingRow(spec: WorkingRowSpec, cx: DescribeContext, now = Date.now()): NativeNode {
 	const variant = spec.variant;
@@ -67,13 +62,12 @@ export function describeWorkingRow(spec: WorkingRowSpec, cx: DescribeContext, no
 	}
 	const label = describeShimmer([{ text: spec.label, palette: spec.palette }], "label");
 	children.push(
-		node(label.k, { ...label.p, role: "zeta.working.label" } as TspProps, label.c, label.key),
-		node("text", { text: "·", role: "zeta.working.sep" }, undefined, "sep"),
 		keyed(elapsed(now - spec.startedAt), "elapsed"),
+		node("text", { text: "·", role: "zeta.working.sep" }, undefined, "sep"),
+		node(label.k, { ...label.p, role: "zeta.working.label" } as TspProps, label.c, label.key),
 		node("row", { grow: 1 }, undefined, "fill"),
 	);
 	if (variant?.kind === "compaction") children.push(node("progress", { value: null }, undefined, "progress"));
-	if (spec.rate !== undefined) children.push(node("rate", { value: spec.rate, unit: "tok/s" }, undefined, "rate"));
 	if (spec.interruptKey !== undefined) {
 		const verb = variant?.kind === "retry" ? "Cancel" : "Stop";
 		children.push(
@@ -83,10 +77,10 @@ export function describeWorkingRow(spec: WorkingRowSpec, cx: DescribeContext, no
 					role: "zeta.working.stop",
 					gap: "xs",
 					align: "center",
-					title: `${verb}  ${titleKey(spec.interruptKey)}`,
+					title: `${verb}  ${formatTooltipKey(spec.interruptKey)}`,
 					actions: { click: "interrupt" },
 				},
-				[kbd(titleKey(spec.interruptKey)), text(verb)],
+				[kbd(spec.interruptKey), text(verb)],
 				"stop",
 			),
 		);
@@ -285,7 +279,6 @@ export class Loader extends Text {
 			variant?.kind,
 			variant?.kind === "retry" ? `${variant.attempt}/${variant.max}` : "",
 			countdown,
-			spec.rate,
 			spec.interruptKey,
 			spec.palette?.mid,
 			shimmerEnabled(),

package/src/components/markdown.d.ts

@@ -1,11 +1,27 @@
+import { type TokensList } from "@linxiraos/pi-utils/marked";
 import type { DescribeContext, NativeNode } from "../native/node";
 import type { SymbolTheme } from "../symbols";
 import type { Component } from "../tui";
-/** @internal exported for tests — the grown-line-start block-kind gate. */
+/** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
+/**
+ * Lex a whole document with the renderer's rules (math, custom rules,
+ * strikethrough). Callers that split a document along its blocks (table
+ * charts) lex through this so they see the blocks Markdown renders.
+ */
+export declare function lexDocument(text: string): TokensList;
+/**
+ * `source` as a fenced code block in `lang`: the fence is one backtick longer
+ * than any backtick run in the source (at least three), so the block always
+ * closes where intended. `open` leaves it unclosed, the source verbatim, for
+ * a body that is still arriving.
+ */
+export declare function fencedCode(lang: string, source: string, options?: {
+    open?: boolean;
+}): string;
 /** A hyperlink as the renderer sees it: inline `[text](href)`, `<autolink>`, bare GFM URL, or reference link. */
 export interface MarkdownLink {
-    /** Visible link text (equals `href` for autolinks and bare URLs). */
+    /** Flattened visible label with whitespace collapsed to one row; falls back to `href` when empty. */
     text: string;
     /** Destination exactly as marked resolved it (references resolved, no normalization). */
     href: string;
@@ -17,6 +33,17 @@ export interface MarkdownLink {
  * Duplicate hrefs are kept; callers decide how to fold them.
  */
 export declare function extractMarkdownLinks(text: string): MarkdownLink[];
+/**
+ * Rewrite the destinations of inline links and link reference definitions in
+ * `text` to `resolve(href)`, leaving everything else byte-for-byte intact.
+ * Hosts that render the Markdown source themselves (a native terminal's `md`
+ * node) resolve relative destinations against their own idea of the working
+ * directory; handing them the session-resolved target keeps links pointing at
+ * what the author meant. Links inside code, images, autolinks and reference
+ * uses (`[x][ref]`, rewritten through their definition) are untouched; a link
+ * whose source cannot be located exactly is left as written.
+ */
+export declare function rewriteMarkdownLinkDestinations(text: string, resolve: (href: string) => string | undefined): string;
 /** Drop all L2 cache entries. Call on theme change to prevent stale styled output. */
 export declare function clearRenderCache(): void;
 /**
@@ -26,6 +53,13 @@ export declare function clearRenderCache(): void;
 export interface DefaultTextStyle {
     /** Foreground color function */
     color?: (text: string) => string;
+    /**
+     * The `color` foreground is prose-level: semantically-themed markdown spans
+     * (headings, links) keep their own `md*` theme colors instead of being
+     * painted over by it, while plain text runs still use `color`. Unset keeps
+     * the historical behavior where `color` paints every run.
+     */
+    proseFg?: boolean;
     /** Background color function */
     bgColor?: (text: string) => string;
     /** Bold text */
@@ -82,7 +116,12 @@ export interface MarkdownTheme {
      * Return null to fall back to fenced code rendering.
      */
     resolveMermaidAscii?: (source: string, maxWidth?: number) => string | null;
-    symbols: SymbolTheme;
+    /**
+     * Glyphs for quote borders, rules, tables and color swatches. Optional so themes
+     * built to the upstream pi-tui `MarkdownTheme` shape (which has no `symbols`)
+     * still render; omitted symbols fall back to the active theme's set.
+     */
+    symbols?: SymbolTheme;
 }
 export declare class Markdown implements Component {
     #private;
@@ -92,6 +131,7 @@ export declare class Markdown implements Component {
     debugState(): Record<string, unknown>;
     setText(text: string): boolean;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * The unrendered source as an `md` node, `stream` while the streaming
      * (transient) cache is on. Append-only growth yields a fresh node of the
@@ -101,8 +141,10 @@ export declare class Markdown implements Component {
     describe(_cx: DescribeContext): NativeNode;
     /**
      * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary. Only meaningful while streaming (transient
-     * render cache on); grows monotonically under append-only `setText`.
+     * Markdown block boundary that no append can move: it stops in front of a
+     * display-math opener whose block an append could still close. Only
+     * meaningful while streaming (transient render cache on); grows
+     * monotonically under append-only `setText`.
      */
     getLastRenderStableText(): string;
     get transientRenderCache(): boolean;