pi-extension-utils 0.3.0 → 0.3.2

package/dist/src/logger/config.js

@@ -0,0 +1,27 @@
+import { Type } from "typebox";
+export const LOG_LEVELS = ["debug", "info", "warn", "error"];
+export const loggerLevelSchema = Type.Union([
+    Type.Literal("debug"),
+    Type.Literal("info"),
+    Type.Literal("warn"),
+    Type.Literal("error"),
+    Type.Literal("silent"),
+], {
+    default: "info",
+    description: "Minimum log level to write.",
+});
+export const loggingConfigSchema = Type.Object({
+    level: loggerLevelSchema,
+    maxFiles: Type.Number({
+        default: 3,
+        minimum: 0,
+        description: "Number of rotated log files to retain.",
+    }),
+    maxBytes: Type.Number({
+        default: 1048576,
+        minimum: 0,
+        description: "Rotate a log file when it grows beyond this many bytes. Use 0 to disable rotation.",
+    }),
+}, {
+    description: "Default logger settings used when createLogger() options omit a value.",
+});

package/dist/src/logger/index.d.ts

@@ -0,0 +1,20 @@
+import { type LoggerLevel, type LogLevel } from "./config.ts";
+export { LOG_LEVELS, loggerLevelSchema, loggingConfigSchema, type LoggerLevel, type LoggingConfig, type LogLevel } from "./config.ts";
+export interface LoggerOptions {
+    dir?: string;
+    maxBytes?: number;
+    /** Number of rotated files to retain: name.log.1, name.log.2, ... */
+    maxFiles?: number;
+    /** Minimum level to write. Defaults to utilsConfig.logging.level. */
+    level?: LoggerLevel;
+}
+export interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    log(level: LogLevel, message: string): void;
+    setLevel(level: LoggerLevel): void;
+    isEnabled(level: LogLevel): boolean;
+}
+export declare function createLogger(name: string, opts?: LoggerOptions): Logger;

package/dist/src/logger/index.js

@@ -0,0 +1,76 @@
+import { appendFileSync, existsSync, mkdirSync, renameSync, rmSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { readUtilsConfigOrDefaults } from "../utils-config.js";
+export { LOG_LEVELS, loggerLevelSchema, loggingConfigSchema } from "./config.js";
+const LEVEL_WEIGHT = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: Number.POSITIVE_INFINITY,
+};
+export function createLogger(name, opts = {}) {
+    if (!name || name.includes("/") || name.includes("\\")) {
+        throw new Error("Logger name must not contain path separators");
+    }
+    const configured = opts.level === undefined || opts.maxBytes === undefined || opts.maxFiles === undefined
+        ? readUtilsConfigOrDefaults().logging
+        : undefined;
+    const dir = opts.dir ?? join(getAgentDir(), "log");
+    const maxBytes = Math.max(0, Math.floor(opts.maxBytes ?? configured?.maxBytes ?? 1024 * 1024));
+    const maxFiles = Math.max(0, Math.floor(opts.maxFiles ?? configured?.maxFiles ?? 3));
+    let level = opts.level ?? configured?.level ?? "info";
+    const file = join(dir, `${name}.log`);
+    mkdirSync(dirname(file), { recursive: true });
+    function rotateIfNeeded(nextBytes) {
+        if (maxBytes <= 0 || !existsSync(file))
+            return;
+        const size = statSync(file).size;
+        if (size + nextBytes <= maxBytes)
+            return;
+        if (maxFiles <= 0) {
+            rmSync(file);
+            return;
+        }
+        const oldest = `${file}.${maxFiles}`;
+        if (existsSync(oldest))
+            rmSync(oldest);
+        for (let index = maxFiles - 1; index >= 1; index--) {
+            const from = `${file}.${index}`;
+            if (existsSync(from))
+                renameSync(from, `${file}.${index + 1}`);
+        }
+        renameSync(file, `${file}.1`);
+    }
+    function isEnabled(candidate) {
+        return LEVEL_WEIGHT[candidate] >= LEVEL_WEIGHT[level];
+    }
+    function log(candidate, message) {
+        if (!isEnabled(candidate))
+            return;
+        const line = `${new Date().toISOString()} ${candidate} ${message}\n`;
+        mkdirSync(dirname(file), { recursive: true });
+        rotateIfNeeded(Buffer.byteLength(line));
+        appendFileSync(file, line);
+    }
+    return {
+        debug(message) {
+            log("debug", message);
+        },
+        info(message) {
+            log("info", message);
+        },
+        warn(message) {
+            log("warn", message);
+        },
+        error(message) {
+            log("error", message);
+        },
+        log,
+        setLevel(nextLevel) {
+            level = nextLevel;
+        },
+        isEnabled,
+    };
+}

package/dist/src/{tui-chrome.js → pane/chrome.js}

@@ -113,28 +113,37 @@ export function titledTopSegment(theme, opts) {
         const fillDashes = Math.max(1, width - labelLen - 3);
         return clipStyled(`${dash(1)} ${labelStyled} ${dash(fillDashes)}`, width);
     }
+    const width = Math.max(0, opts.width);
+    if (width <= 0)
+        return "";
     const labelColor = opts.labelColor ?? "text";
     const tailColor = opts.tailColor ?? "dim";
-    // Reserve at least `─ ` + label + ` ─` (4 chars) and 1 dash on each side of the tail when present.
-    const labelBudget = opts.width <= 4 ? 0 : opts.width - 4;
+    const tailPlain = opts.tailPlain ?? opts.tail ?? "";
+    const rawTailRendered = opts.tailRendered ?? (opts.tail !== undefined ? theme.fg(tailColor, opts.tail) : "");
+    const tailLen = visibleWidth(tailPlain);
+    // With a tail, the minimum chrome is:
+    // `─ ` + label + ` ` + `─` + ` ` + tail + ` ` + `─` = label + tail + 7.
+    // The previous math reserved only 6 columns, so long label+tail combinations
+    // could render one column too wide and crash Pi's TUI at terminal width.
+    const tailFits = tailLen > 0 && width >= tailLen + 7;
+    const labelBudget = tailFits ? Math.max(0, width - tailLen - 7) : Math.max(0, width - 3);
     // Defensive: callers occasionally pass undefined labels for transient/legacy
     // runs that lack agent+mode+label; treat as empty rather than crashing pi.
-    const labelText = truncateToWidth(opts.label ?? "", labelBudget);
+    const rawLabel = opts.label ?? "";
+    const labelText = truncateToWidth(rawLabel, labelBudget, "").replace(/\u001b\[[0-9;]*m/g, "");
     const labelStyled = opts.labelBold && theme.bold
         ? theme.bold(theme.fg(labelColor, labelText))
         : theme.fg(labelColor, labelText);
-    const tailPlain = opts.tailPlain ?? opts.tail ?? "";
-    const tailRendered = opts.tailRendered ?? (opts.tail !== undefined ? theme.fg(tailColor, opts.tail) : "");
     const labelLen = visibleWidth(labelText);
-    const tailLen = visibleWidth(tailPlain);
-    // Layout with tail: `─ <label> ──…── <tail> ─` => fixed = 6 + labelLen + tailLen.
-    // Layout without tail: `─ <label> ──…────`     => fixed = 3 + labelLen (one space + label + space).
-    if (tailLen > 0) {
-        const fillDashes = Math.max(1, opts.width - (labelLen + tailLen + 6));
-        return `${dash(1)} ${labelStyled} ${dash(fillDashes)} ${tailRendered} ${dash(1)}`;
+    // Layout with tail: `─ <label> ──…── <tail> ─`.
+    // Layout without tail: `─ <label> ──…────`.
+    if (tailFits) {
+        const tailRendered = visibleWidth(rawTailRendered) > tailLen ? clipStyled(rawTailRendered, tailLen) : rawTailRendered;
+        const fillDashes = Math.max(1, width - (labelLen + tailLen + 6));
+        return clipStyled(`${dash(1)} ${labelStyled} ${dash(fillDashes)} ${tailRendered} ${dash(1)}`, width);
     }
-    const fillDashes = Math.max(1, opts.width - (labelLen + 3));
-    return `${dash(1)} ${labelStyled} ${dash(fillDashes)}`;
+    const fillDashes = Math.max(0, width - (labelLen + 3));
+    return clipStyled(`${dash(1)} ${labelStyled} ${dash(fillDashes)}`, width);
 }
 /**
  * Build one half of a bottom border with an embedded hint string.

package/dist/src/pane/overlay.d.ts

@@ -0,0 +1,75 @@
+import type { FullscreenComponentFactory } from "../ui/client.ts";
+export interface PaneOverlayContext<T = unknown, Row = unknown> {
+    tui: unknown;
+    primaryFocus: boolean;
+    detailFocus: boolean;
+    selectedRow: Row | undefined;
+    selectedIndex: number;
+    selectedKey: string;
+    primary: {
+        mode: "cursor" | "scroll";
+        cursor: number;
+        scrollOffset: number;
+    };
+    detail: {
+        scrollOffset: number;
+    };
+    close(result?: T): void;
+    requestRender(): void;
+}
+export interface PaneOverlayCustomAction<T = unknown, Row = unknown> {
+    keys: string | readonly string[];
+    label: string;
+    run(ctx: PaneOverlayContext<T, Row>): void;
+    when?(ctx: PaneOverlayContext<T, Row>): boolean;
+    showInLegend?: boolean;
+}
+export interface PrimaryPaneOptions<Row = unknown> {
+    mode?: "cursor" | "scroll";
+    rows: Row[] | ((ctx: PaneOverlayContext<unknown, Row>) => Row[]);
+    renderRow?(row: Row, ctx: PaneOverlayContext<unknown, Row>): string;
+    selectionKey?(row: Row, index: number): string;
+    onSelectionChange?(row: Row | undefined, index: number, key: string, ctx: PaneOverlayContext<unknown, Row>): void;
+    title?: string | ((ctx: PaneOverlayContext<unknown, Row>) => string);
+    footer?: string | ((ctx: PaneOverlayContext<unknown, Row>) => string);
+}
+export interface DetailPaneOptions<Row = unknown> {
+    rows(ctx: PaneOverlayContext<unknown, Row>): string[];
+    title?: string | ((ctx: PaneOverlayContext<unknown, Row>) => string);
+    footer?: string | ((ctx: PaneOverlayContext<unknown, Row>) => string);
+}
+export interface PaneOverlaySplitOptions {
+    initialFraction?: number;
+    minPrimaryWidth?: number;
+    minDetailWidth?: number;
+    maxPrimaryWidth?: number;
+    stepCols?: number;
+    minFraction?: number;
+    maxFraction?: number;
+    fractionBasis?: "total" | "interior";
+}
+export interface PaneCollapseOptions {
+    key?: string;
+    collapsedWidth?: number;
+    label?: string;
+}
+export interface PaneOverlayOptions<T = unknown, Row = unknown> {
+    primary: PrimaryPaneOptions<Row>;
+    detail: DetailPaneOptions<Row>;
+    height?: number | ((tui: unknown) => number);
+    closeKeys?: readonly string[];
+    closeResult?: T;
+    customActions?: readonly PaneOverlayCustomAction<T, Row>[];
+    bannedKeys?: readonly string[];
+    split?: PaneOverlaySplitOptions;
+    legendPlacement?: "footer" | "primary";
+    collapse?: PaneCollapseOptions;
+    perSelectionScroll?: boolean;
+    stickyBottom?: boolean;
+}
+export interface PaneOverlayComponent {
+    render(width: number): string[];
+    handleInput(data: string): void;
+    dispose(): void;
+}
+export declare function paneOverlay<T = undefined, Row = unknown>(options: PaneOverlayOptions<T, Row>): FullscreenComponentFactory<T>;