pi-one-ui 0.7.0 → 0.7.1

package/extensions/shared/working-line-text.ts

@@ -0,0 +1,108 @@
+import { stripVTControlCharacters } from "node:util";
+import { visibleWidth } from "@earendil-works/pi-tui";
+
+export const MAX_WORKING_LINE_MESSAGES = 48;
+export const MAX_WORKING_LINE_MESSAGE_CELLS = 43;
+export const MAX_WORKING_LINE_RAW_CODE_UNITS = 4096;
+export const MAX_WORKING_LINE_NORMALIZED_CODE_UNITS = 256;
+export const MAX_WORKING_LINE_ENTRIES_EXAMINED = 256;
+
+export function* segmentGraphemes(value: string): Iterable<string> {
+  for (const part of new Intl.Segmenter(undefined, {
+    granularity: "grapheme",
+  }).segment(value)) {
+    yield part.segment;
+  }
+}
+
+export function truncateGraphemes(
+  value: string,
+  maximumCells: number,
+  maximumCodeUnits = Number.POSITIVE_INFINITY,
+): string {
+  let width = 0;
+  let codeUnits = 0;
+  const output: string[] = [];
+  for (const grapheme of segmentGraphemes(value)) {
+    const nextWidth = visibleWidth(grapheme);
+    if (
+      width >= maximumCells ||
+      width + nextWidth > maximumCells ||
+      codeUnits + grapheme.length > maximumCodeUnits
+    ) {
+      break;
+    }
+    output.push(grapheme);
+    width += nextWidth;
+    codeUnits += grapheme.length;
+  }
+  while (output.length > 0 && /^\s+$/u.test(output.at(-1) ?? "")) {
+    output.pop();
+  }
+  return output.join("");
+}
+
+/** 配置与渲染共同使用的文本限制，保留完整 grapheme。 */
+export function normalizeWorkingLineMessage(value: unknown): string {
+  if (typeof value !== "string") {
+    return "";
+  }
+  let bounded = value;
+  if (value.length > MAX_WORKING_LINE_RAW_CODE_UNITS) {
+    const graphemes = [
+      ...segmentGraphemes(value.slice(0, MAX_WORKING_LINE_RAW_CODE_UNITS)),
+    ];
+    graphemes.pop();
+    bounded = graphemes.join("");
+  }
+  const withoutTerminalSequences = stripVTControlCharacters(
+    bounded
+      .replaceAll(
+        /[\u0090\u0098\u009d\u009e\u009f][\s\S]*?(?:\u0007|\u009c|\x1b\\|$)/g,
+        "",
+      )
+      .replaceAll(/\u009b[0-?]*[ -/]*[@-~]/g, ""),
+  );
+  const normalized = withoutTerminalSequences
+    .replaceAll(/[\u0000-\u001f\u007f-\u009f]/g, " ")
+    .replaceAll(
+      /[\u034f\u061c\u200b\u200e\u200f\u202a-\u202e\u2060\u2066-\u206f]/g,
+      "",
+    )
+    .normalize("NFC")
+    .replaceAll(/\s+/gu, " ");
+  const graphemes = [...segmentGraphemes(normalized)];
+  while (graphemes.length > 0 && /^\s+$/u.test(graphemes[0] ?? "")) {
+    graphemes.shift();
+  }
+  while (graphemes.length > 0 && /^\s+$/u.test(graphemes.at(-1) ?? "")) {
+    graphemes.pop();
+  }
+  const truncated = truncateGraphemes(
+    graphemes.join(""),
+    MAX_WORKING_LINE_MESSAGE_CELLS,
+    MAX_WORKING_LINE_NORMALIZED_CODE_UNITS,
+  );
+  return visibleWidth(truncated) > 0 ? truncated : "";
+}
+
+export function normalizeWorkingLineMessages(values: unknown): string[] {
+  if (!Array.isArray(values)) {
+    return [];
+  }
+  const output: string[] = [];
+  const seen = new Set<string>();
+  const examined = Math.min(values.length, MAX_WORKING_LINE_ENTRIES_EXAMINED);
+  for (let index = 0; index < examined; index += 1) {
+    const normalized = normalizeWorkingLineMessage(values[index]);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    output.push(normalized);
+    if (output.length === MAX_WORKING_LINE_MESSAGES) {
+      break;
+    }
+  }
+  return output;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-one-ui",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "A single, customizable Pi UI package with layout-oriented Context and Shell rendering for Pi.",
   "type": "module",
   "license": "MIT",

package/extensions/app/host/pi-extension-port.ts

@@ -1,25 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-export type PiExtensionPort = Pick<
-  ExtensionAPI,
-  | "appendEntry"
-  | "on"
-  | "registerCommand"
-  | "registerEntryRenderer"
-  | "registerMarkdownTransformer"
-  | "registerMessageRenderer"
->;
-
-/**
- * Binds the host extension API once so modules do not pass the raw object around.
- */
-export function createPiExtensionPort(pi: ExtensionAPI): PiExtensionPort {
-  return {
-    appendEntry: pi.appendEntry.bind(pi),
-    on: pi.on.bind(pi) as PiExtensionPort["on"],
-    registerCommand: pi.registerCommand.bind(pi),
-    registerEntryRenderer: pi.registerEntryRenderer.bind(pi),
-    registerMarkdownTransformer: pi.registerMarkdownTransformer.bind(pi),
-    registerMessageRenderer: pi.registerMessageRenderer.bind(pi),
-  };
-}

package/extensions/app/host/pi-ui-port.ts

@@ -1,52 +0,0 @@
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-type PiUi = ExtensionContext["ui"];
-
-export type PiUiPort = Pick<
-  PiUi,
-  | "custom"
-  | "getEditorComponent"
-  | "getToolsExpanded"
-  | "notify"
-  | "onTerminalInput"
-  | "setEditorComponent"
-  | "setFooter"
-  | "setHeader"
-  | "setStatus"
-  | "setToolsExpanded"
-  | "setWidget"
-  | "setWorkingIndicator"
-  | "setWorkingMessage"
-  | "setWorkingVisible"
-> & {
-  readonly theme: PiUi["theme"];
-  requestRender(force?: boolean): void;
-};
-
-/**
- * Adapts a session UI context to the narrow port consumed by layouts.
- */
-export function createPiUiPort(
-  ctx: ExtensionContext,
-  requestRender: (force?: boolean) => void = () => {},
-): PiUiPort {
-  const ui = ctx.ui;
-  return {
-    custom: (...args) => ui.custom(...args),
-    getEditorComponent: () => ui.getEditorComponent(),
-    getToolsExpanded: () => ui.getToolsExpanded(),
-    notify: (...args) => ui.notify(...args),
-    onTerminalInput: (handler) => ui.onTerminalInput(handler),
-    setEditorComponent: (factory) => ui.setEditorComponent(factory),
-    setFooter: (factory) => ui.setFooter(factory),
-    setHeader: (factory) => ui.setHeader(factory),
-    setStatus: (key, text) => ui.setStatus(key, text),
-    setToolsExpanded: (expanded) => ui.setToolsExpanded(expanded),
-    setWidget: ui.setWidget.bind(ui) as PiUiPort["setWidget"],
-    setWorkingIndicator: (options) => ui.setWorkingIndicator(options),
-    setWorkingMessage: (message) => ui.setWorkingMessage(message),
-    setWorkingVisible: (visible) => ui.setWorkingVisible(visible),
-    theme: ui.theme,
-    requestRender,
-  };
-}

package/extensions/app/host/tui-capabilities.ts

@@ -1,27 +0,0 @@
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-export type TuiCapabilities = Readonly<{
-  interactive: boolean;
-  customUi: boolean;
-  editorFactory: boolean;
-  footer: boolean;
-  header: boolean;
-  workingIndicator: boolean;
-  overlays: boolean;
-}>;
-
-/**
- * Detects which interactive UI seams are available in the current host context.
- */
-export function detectTuiCapabilities(ctx: ExtensionContext): TuiCapabilities {
-  const ui = ctx.ui as Partial<ExtensionContext["ui"]>;
-  return {
-    interactive: ctx.mode === "tui" && ctx.hasUI,
-    customUi: typeof ui.custom === "function",
-    editorFactory: typeof ui.setEditorComponent === "function",
-    footer: typeof ui.setFooter === "function",
-    header: typeof ui.setHeader === "function",
-    workingIndicator: typeof ui.setWorkingIndicator === "function",
-    overlays: typeof ui.custom === "function",
-  };
-}

package/extensions/app/ownership/layout-registry.ts

@@ -1,65 +0,0 @@
-export const LAYOUT_OWNERSHIP = {
-  header: "header",
-  context: "context",
-  workingLine: "working-line",
-  editor: "editor",
-  footer: "footer",
-  overlay: "overlay",
-  input: "overlay",
-} as const;
-
-export type LayoutId = keyof typeof LAYOUT_OWNERSHIP;
-export type LayoutOwner = (typeof LAYOUT_OWNERSHIP)[LayoutId];
-
-type Claim = {
-  owner: LayoutOwner;
-  token: object;
-};
-
-/**
- * Tracks ownership of host UI seams. A layout can be claimed once and its
- * release callback is safe to call repeatedly or after another owner wins.
- */
-export class LayoutRegistry {
-  private readonly claims = new Map<LayoutId, Claim>();
-
-  /**
-   * Claims one layout for a runtime token.
-   *
-   * @returns A release function that only removes this token's claim.
-   */
-  claim(layout: LayoutId, token: object): () => void {
-    const owner = LAYOUT_OWNERSHIP[layout];
-    const current = this.claims.get(layout);
-    if (current && current.token !== token) {
-      throw new Error(
-        `UI layout ${layout} is already owned by ${current.owner}`,
-      );
-    }
-    this.claims.set(layout, { owner, token });
-    return () => {
-      if (this.claims.get(layout)?.token === token) this.claims.delete(layout);
-    };
-  }
-
-  /**
-   * Returns the canonical owner assigned to a claimed layout.
-   */
-  ownerOf(layout: LayoutId): LayoutOwner | undefined {
-    return this.claims.get(layout)?.owner;
-  }
-
-  /**
-   * Reports whether a runtime token currently claims the layout.
-   */
-  isClaimed(layout: LayoutId): boolean {
-    return this.claims.has(layout);
-  }
-
-  /**
-   * Releases all claims, normally during runtime disposal.
-   */
-  clear(): void {
-    this.claims.clear();
-  }
-}

package/extensions/app/ownership.ts

@@ -1,32 +0,0 @@
-/** Legacy slot map retained for existing callers during Layout extraction. */
-export const UI_OWNERSHIP = {
-  editor: "editor",
-  userMessage: "context",
-  footer: "shell",
-  workingLine: "shell",
-  selector: "overlay",
-  toolRenderer: "context",
-  diffRenderer: "context",
-  thinking: "context",
-  agentSummary: "context",
-} as const;
-
-export type UiSlot = keyof typeof UI_OWNERSHIP;
-export type UiOwner = (typeof UI_OWNERSHIP)[UiSlot];
-
-/**
- * Returns the canonical visual owner for a Pi UI slot.
- *
- * @param slot UI slot to resolve.
- * @returns Canonical owner identifier.
- */
-export function ownerFor(slot: UiSlot): UiOwner {
-  return UI_OWNERSHIP[slot];
-}
-
-export {
-  LAYOUT_OWNERSHIP,
-  type LayoutId,
-  type LayoutOwner,
-  LayoutRegistry,
-} from "./ownership/layout-registry.ts";