@hheei/pi-ext-ui 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hheei/pi-ext-ui",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Collapsible tool rendering frame and tool renderer pilot for Pi.",
   "type": "module",
   "main": "dist/index.js",
@@ -36,15 +36,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@hheei/pi-ext-core": "^0.3.0"
+    "@hheei/pi-ext-core": "^0.4.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=1.2.0",
-    "@earendil-works/pi-tui": ">=1.2.0"
+    "@earendil-works/pi-coding-agent": ">=1.3.0",
+    "@earendil-works/pi-tui": ">=1.3.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "1.2.0",
-    "@earendil-works/pi-tui": "1.2.0"
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-tui": "1.3.0"
   },
   "scripts": {
     "build": "node -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json"

package/dist/apply-patch-glyph.d.ts

@@ -1,10 +0,0 @@
-import type { Theme } from "@earendil-works/pi-coding-agent";
-/**
- * Display contract mirror of pi-ext-tools' MUTATION_GLYPH/MUTATION_TONE: how one
- * mutation outcome is drawn. The persisted `ApplyPatchToolDetails` carries the
- * outcome facts; pi-ext-ui never imports pi-ext-tools, so the glyph vocabulary is
- * restated here as part of the rendering contract it consumes.
- */
-export declare const APPLY_PATCH_GLYPH: Record<string, string>;
-export declare const APPLY_PATCH_TONE: Record<string, "success" | "warning" | "dim" | "error">;
-export declare function applyPatchGlyph(status: string, theme: Theme): string;

package/dist/apply-patch-glyph.js

@@ -1,29 +0,0 @@
-/**
- * Display contract mirror of pi-ext-tools' MUTATION_GLYPH/MUTATION_TONE: how one
- * mutation outcome is drawn. The persisted `ApplyPatchToolDetails` carries the
- * outcome facts; pi-ext-ui never imports pi-ext-tools, so the glyph vocabulary is
- * restated here as part of the rendering contract it consumes.
- */
-export const APPLY_PATCH_GLYPH = {
-    pending: "⋯",
-    applied: "✓",
-    partial: "▲",
-    fuzzy: "▲",
-    unconfirmed: "▲",
-    not_applied: "·",
-    rejected: "✗",
-};
-export const APPLY_PATCH_TONE = {
-    pending: "dim",
-    applied: "success",
-    partial: "warning",
-    fuzzy: "warning",
-    unconfirmed: "warning",
-    not_applied: "dim",
-    rejected: "error",
-};
-export function applyPatchGlyph(status, theme) {
-    const glyph = APPLY_PATCH_GLYPH[status] ?? "✗";
-    const tone = APPLY_PATCH_TONE[status] ?? "error";
-    return theme.fg(tone, glyph);
-}

package/dist/apply-patch-preview.d.ts

@@ -1,30 +0,0 @@
-/**
- * Display-only recognition of V4A operation headers in a patch that is still
- * streaming. Mirrors the recognition rules pi-ext-tools' parser applies, but
- * only as far as drawing `󰄰 create|modify|delete path +A -D` preview rows
- * requires: a line is a candidate header, a payload line, or stops the preview.
- */
-export interface V4aPreviewOperationView {
-    readonly kind: "add" | "delete" | "update";
-    readonly path: string;
-    readonly addedLines: number;
-    readonly removedLines: number;
-}
-/** Opaque cursor stored in the render state across streamed updates. */
-export interface V4aPreviewCursor {
-    consumed: string;
-    operations: MutablePreviewOperation[];
-    stopped: boolean;
-}
-type MutablePreviewOperation = {
-    kind: "add" | "delete" | "update";
-    path: string;
-    addedLines: number;
-    removedLines: number;
-};
-/**
- * Incremental preview of the operation headers completed so far. The cursor
- * lives in the render state so each streamed update only processes new lines.
- */
-export declare function previewV4aOperations(input: string, argsComplete: boolean, cursor: V4aPreviewCursor | undefined): readonly V4aPreviewOperationView[];
-export {};

package/dist/apply-patch-preview.js

@@ -1,89 +0,0 @@
-const ADD = "*** Add File: ";
-const DELETE = "*** Delete File: ";
-const UPDATE = "*** Update File: ";
-const MOVE = "*** Move to: ";
-const BEGIN = "*** Begin Patch";
-const END = "*** End Patch";
-const MAX_PREVIEW_OPERATIONS = 128;
-function parseHeader(text) {
-    if (text.startsWith(ADD))
-        return { kind: "add", path: text.slice(ADD.length) };
-    if (text.startsWith(DELETE))
-        return { kind: "delete", path: text.slice(DELETE.length) };
-    if (text.startsWith(UPDATE))
-        return { kind: "update", path: text.slice(UPDATE.length) };
-    return undefined;
-}
-function previewablePath(path) {
-    return path !== "" && !path.includes("\0") && path !== BEGIN && path !== END;
-}
-function applyPreviewLine(state, text) {
-    if (text === BEGIN || text === END)
-        return true;
-    const header = parseHeader(text);
-    if (header !== undefined) {
-        if (!previewablePath(header.path) || state.operations.length >= MAX_PREVIEW_OPERATIONS)
-            return false;
-        state.operations.push({ kind: header.kind, path: header.path, addedLines: 0, removedLines: 0 });
-        return true;
-    }
-    const current = state.operations.at(-1);
-    if (current === undefined)
-        return true;
-    if (current.kind === "update" && text.startsWith(MOVE)) {
-        const moveTo = text.slice(MOVE.length);
-        if (!previewablePath(moveTo))
-            return false;
-        current.path = moveTo;
-        return true;
-    }
-    if (current.kind === "add") {
-        if (!text.startsWith("+"))
-            return false;
-        if (text.slice(1).length > 0)
-            current.addedLines += 1;
-        return true;
-    }
-    if (current.kind === "delete")
-        return false;
-    if (text.startsWith("@@") || text.startsWith(" "))
-        return true;
-    if (text.startsWith("+")) {
-        current.addedLines += 1;
-        return true;
-    }
-    if (text.startsWith("-")) {
-        current.removedLines += 1;
-        return true;
-    }
-    return false;
-}
-/**
- * Incremental preview of the operation headers completed so far. The cursor
- * lives in the render state so each streamed update only processes new lines.
- */
-export function previewV4aOperations(input, argsComplete, cursor) {
-    const state = cursor ?? { consumed: "", operations: [], stopped: false };
-    if (!input.startsWith(state.consumed)) {
-        state.consumed = "";
-        state.operations = [];
-        state.stopped = false;
-    }
-    if (state.stopped)
-        return state.operations.map((operation) => ({ ...operation }));
-    const lines = (input.slice(state.consumed.length).match(/[^\n]*\n?/g) ?? []).filter((line) => line !== "");
-    for (const [index, raw] of lines.entries()) {
-        const newline = raw.endsWith("\n") ? "\n" : "";
-        const text = newline === "" ? raw : raw.slice(0, -1).replace(/\r$/, "");
-        const complete = newline !== "" || (argsComplete && index === lines.length - 1);
-        if (!complete)
-            break;
-        const applied = applyPreviewLine(state, text);
-        if (!applied) {
-            state.stopped = true;
-            break;
-        }
-        state.consumed += raw;
-    }
-    return state.operations.map((operation) => ({ ...operation }));
-}

package/dist/apply-patch-view.d.ts

@@ -1,47 +0,0 @@
-import type { Theme } from "@earendil-works/pi-coding-agent";
-/**
- * Display-side view of pi-ext-tools' persisted `ApplyPatchToolDetails`.
- * The details are the contract; every field is read defensively at this
- * untrusted boundary and dropped when it does not match the contract.
- */
-export interface ApplyPatchOperationView {
-    readonly operationIndex: number;
-    readonly kind: "add" | "delete" | "update";
-    readonly path: string;
-    readonly addedLines: number;
-    readonly removedLines: number;
-    readonly status: string;
-    readonly appliedHunks: number | undefined;
-    readonly totalHunks: number | undefined;
-    readonly partialReason: string | undefined;
-}
-export interface ApplyPatchSnapshotView {
-    readonly path: string;
-    readonly startLine: number;
-    readonly before: readonly string[];
-    readonly after: readonly string[];
-}
-export interface ApplyPatchRejectionView {
-    readonly paths: readonly string[];
-    readonly error: string;
-    readonly diagnostics: readonly {
-        readonly text: string;
-    }[];
-}
-export interface ApplyPatchFacts {
-    readonly status: "success" | "partial" | "failed";
-    readonly operations: readonly ApplyPatchOperationView[];
-    readonly snapshots: readonly ApplyPatchSnapshotView[];
-    readonly rejected: readonly ApplyPatchRejectionView[];
-    readonly unconfirmed: readonly ApplyPatchRejectionView[];
-    readonly notApplied: readonly ApplyPatchRejectionView[];
-    readonly addedLines: number;
-    readonly removedLines: number;
-    readonly changedPaths: readonly string[];
-    readonly target: string | undefined;
-    readonly inProgress: boolean;
-}
-/** Reads only the persisted apply_patch details; other shapes return undefined. */
-export declare function applyPatchFacts(details: unknown): ApplyPatchFacts | undefined;
-/** One operation row: glyph, verb, path, delta, fuzzy marker, hunk summary. */
-export declare function formatApplyPatchOperationRow(operation: ApplyPatchOperationView, theme: Theme, host: string | undefined): string;

package/dist/apply-patch-view.js

@@ -1,198 +0,0 @@
-import { applyPatchGlyph } from "./apply-patch-glyph.js";
-const PATCH_STATUSES = ["success", "partial", "failed"];
-function isPatchStatus(value) {
-    return PATCH_STATUSES.includes(value);
-}
-const OPERATION_STATUSES = new Set([
-    "pending",
-    "applied",
-    "partial",
-    "fuzzy",
-    "unconfirmed",
-    "not_applied",
-    "rejected",
-]);
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function operationView(value) {
-    const path = typeof value.path === "string" ? value.path : undefined;
-    if (path === undefined)
-        return undefined;
-    const kind = value.kind === "add" || value.kind === "delete" || value.kind === "update"
-        ? value.kind
-        : undefined;
-    if (kind === undefined)
-        return undefined;
-    const status = typeof value.status === "string" && OPERATION_STATUSES.has(value.status)
-        ? value.status
-        : undefined;
-    if (status === undefined)
-        return undefined;
-    return {
-        operationIndex: typeof value.operationIndex === "number" ? value.operationIndex : 0,
-        kind,
-        path,
-        addedLines: typeof value.addedLines === "number" ? value.addedLines : 0,
-        removedLines: typeof value.removedLines === "number" ? value.removedLines : 0,
-        status,
-        appliedHunks: typeof value.appliedHunks === "number" ? value.appliedHunks : undefined,
-        totalHunks: typeof value.totalHunks === "number" ? value.totalHunks : undefined,
-        partialReason: typeof value.partialReason === "string" ? value.partialReason : undefined,
-    };
-}
-function snapshotView(value) {
-    const path = typeof value.path === "string" ? value.path : undefined;
-    if (path === undefined)
-        return undefined;
-    const before = Array.isArray(value.before)
-        ? value.before.filter((line) => typeof line === "string")
-        : undefined;
-    const after = Array.isArray(value.after)
-        ? value.after.filter((line) => typeof line === "string")
-        : undefined;
-    if (before === undefined || after === undefined)
-        return undefined;
-    return {
-        path,
-        startLine: typeof value.startLine === "number" && value.startLine > 0 ? value.startLine : 1,
-        before,
-        after,
-    };
-}
-function rejectionView(value) {
-    const error = typeof value.error === "string" ? value.error : undefined;
-    if (error === undefined)
-        return undefined;
-    const paths = Array.isArray(value.paths)
-        ? value.paths.filter((path) => typeof path === "string")
-        : [];
-    const diagnostics = Array.isArray(value.diagnostics)
-        ? value.diagnostics
-            .filter(isRecord)
-            .map((diagnostic) => {
-            if (diagnostic.kind === "context_not_found") {
-                return typeof diagnostic.hint === "string"
-                    ? `context not found (${diagnostic.hint})`
-                    : "context not found";
-            }
-            if (diagnostic.kind === "ambiguous_exact") {
-                const candidates = Array.isArray(diagnostic.candidateStartLines)
-                    ? diagnostic.candidateStartLines.filter((line) => typeof line === "number")
-                    : [];
-                return `exact context is ambiguous at lines ${candidates.join(", ")}`;
-            }
-            return undefined;
-        })
-            .filter((text) => text !== undefined)
-            .map((text) => ({ text }))
-        : [];
-    return { paths, error, diagnostics };
-}
-function rejectionList(value) {
-    if (!Array.isArray(value))
-        return [];
-    const views = [];
-    for (const entry of value) {
-        if (!isRecord(entry))
-            continue;
-        const view = rejectionView(entry);
-        if (view !== undefined)
-            views.push(view);
-    }
-    return views;
-}
-/** Reads only the persisted apply_patch details; other shapes return undefined. */
-export function applyPatchFacts(details) {
-    if (!isRecord(details))
-        return undefined;
-    if (typeof details.status !== "string" || !isPatchStatus(details.status))
-        return undefined;
-    const status = details.status;
-    const operations = Array.isArray(details.operations)
-        ? details.operations
-            .filter(isRecord)
-            .map(operationView)
-            .filter((operation) => operation !== undefined)
-        : [];
-    // Older results carry applied/rejected lists instead of operations; the operation
-    // rows are rebuilt from them without hunk counts.
-    const applied = Array.isArray(details.applied) ? details.applied.filter(isRecord) : [];
-    const rejected = rejectionList(details.rejected);
-    if (operations.length === 0) {
-        for (const operation of applied) {
-            const path = typeof operation.paths === "object" &&
-                operation.paths !== null &&
-                Array.isArray(operation.paths) &&
-                typeof operation.paths[0] === "string"
-                ? operation.paths[0]
-                : undefined;
-            if (path === undefined)
-                continue;
-            const view = operationView({
-                operationIndex: operation.operationIndex,
-                kind: operation.kind,
-                path,
-                addedLines: 0,
-                removedLines: 0,
-                status: "applied",
-            });
-            if (view !== undefined)
-                operations.push(view);
-        }
-        for (const [index, rejection] of rejected.entries()) {
-            const view = operationView({
-                operationIndex: index,
-                kind: "update",
-                path: rejection.paths[0] ?? "<unknown>",
-                addedLines: 0,
-                removedLines: 0,
-                status: "rejected",
-            });
-            if (view !== undefined)
-                operations.push(view);
-        }
-    }
-    const snapshots = Array.isArray(details.applied)
-        ? details.applied.filter(isRecord).flatMap((operation) => Array.isArray(operation.snapshots)
-            ? operation.snapshots
-                .filter(isRecord)
-                .map(snapshotView)
-                .filter((snapshot) => snapshot !== undefined)
-            : [])
-        : [];
-    return {
-        status,
-        operations,
-        snapshots,
-        rejected,
-        unconfirmed: rejectionList(details.unconfirmed),
-        notApplied: rejectionList(details.notApplied),
-        addedLines: typeof details.addedLines === "number" ? details.addedLines : 0,
-        removedLines: typeof details.removedLines === "number" ? details.removedLines : 0,
-        changedPaths: Array.isArray(details.changedPaths)
-            ? details.changedPaths.filter((path) => typeof path === "string")
-            : [],
-        target: typeof details.target === "string" && details.target !== "local" ? details.target : undefined,
-        inProgress: isRecord(details.progress),
-    };
-}
-/** One operation row: glyph, verb, path, delta, fuzzy marker, hunk summary. */
-export function formatApplyPatchOperationRow(operation, theme, host) {
-    const glyph = applyPatchGlyph(operation.status, theme);
-    const kind = operation.kind === "add" ? "create" : operation.kind === "delete" ? "delete" : "modify";
-    const path = host === undefined ? operation.path : `${theme.fg("warning", `${host}:`)}${operation.path}`;
-    const deltaParts = [];
-    if (operation.addedLines > 0)
-        deltaParts.push(theme.fg("success", `+${String(operation.addedLines)}`));
-    if (operation.removedLines > 0)
-        deltaParts.push(theme.fg("error", `-${String(operation.removedLines)}`));
-    const delta = deltaParts.length > 0 ? ` (${deltaParts.join(" ")})` : "";
-    const score = operation.status === "fuzzy" ? ` ${theme.fg("dim", "fuzzy")}` : "";
-    const hunks = operation.status === "partial" &&
-        operation.appliedHunks !== undefined &&
-        operation.totalHunks !== undefined
-        ? ` ${theme.fg("dim", `(${String(operation.appliedHunks)}/${String(operation.totalHunks)} hunks applied${operation.partialReason === undefined ? "" : `; ${operation.partialReason}`})`)}`
-        : "";
-    return `${glyph} ${theme.fg("toolTitle", kind)} ${path}${delta}${score}${hunks}`.trimEnd();
-}