@herbertgao/pi-extensions 2026.8.3 → 2026.8.5

package/node_modules/pi-footer/src/widgets/core/text-verbosity.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const TextVerbosityWidget = defineWidget({
+  type: "text-verbosity",
+  label: "Text Verbosity",
+  category: "Core",
+  description: "Text verbosity for models/providers that support it",
+  dependencies: ["textVerbosity"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "📝", nerd: "󰉿", text: "verbosity" },
+  defaultStyle: { fg: "cyan", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.textVerbosity);
+  },
+});

package/node_modules/pi-footer/src/widgets/core/thinking-level.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const ThinkingLevelWidget = defineWidget({
+  type: "thinking-level",
+  label: "Thinking Level",
+  category: "Core",
+  description: "Pi reasoning/thinking level for reasoning-capable models",
+  dependencies: ["thinkingLevel"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "🧠", nerd: "󰈈", text: "thinking" },
+  defaultStyle: { fg: "magenta", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.thinkingLevel);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/ahead-behind.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitAheadBehindWidget = defineWidget({
+  type: "git-ahead-behind",
+  label: "Git Ahead/Behind",
+  category: "Git",
+  description: "Ahead/behind upstream counts",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "↕️", nerd: "󰦻", text: "upstream" },
+  defaultStyle: { fg: "cyan", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.git.isRepo ? `↑${ctx.git.ahead} ↓${ctx.git.behind}` : "");
+  },
+});

package/node_modules/pi-footer/src/widgets/git/branch.ts

@@ -0,0 +1,81 @@
+import { defineWidget } from "../types.js";
+
+const GIT_BRANCH_DISPLAY_STYLES = {
+  default: {
+    label: "Default",
+    list: "default",
+  },
+  "round-brackets": {
+    label: "Round brackets",
+    list: "brackets",
+  },
+  custom: {
+    label: "Custom surround text",
+    list: "custom",
+  },
+} as const;
+
+type GitBranchDisplayStyle = keyof typeof GIT_BRANCH_DISPLAY_STYLES;
+
+const GIT_BRANCH_DISPLAY_STYLE_VALUES = Object.keys(
+  GIT_BRANCH_DISPLAY_STYLES,
+) as GitBranchDisplayStyle[];
+
+export const GitBranchWidget = defineWidget({
+  type: "git-branch",
+  label: "Git Branch",
+  category: "Git",
+  description: "Current Git branch",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [
+    {
+      id: "gitBranchDisplayStyle",
+      label: "Display style",
+      kind: "choice",
+      description: "Branch name display style",
+      default: "default",
+      options: {
+        choices: GIT_BRANCH_DISPLAY_STYLE_VALUES.map((style) => ({
+          id: style,
+          label: GIT_BRANCH_DISPLAY_STYLES[style].label,
+          list: GIT_BRANCH_DISPLAY_STYLES[style].list,
+        })),
+        showInWidgets: true,
+        showInColors: false,
+        listProperty: "display",
+      },
+    },
+    {
+      id: "surroundLeft",
+      label: "Surround left",
+      kind: "text",
+      description: "Text before the branch name when custom display is enabled",
+      default: "",
+      showWhen: { property: "gitBranchDisplayStyle", equals: "custom" },
+      options: { showInWidgets: false, showInColors: false },
+    },
+    {
+      id: "surroundRight",
+      label: "Surround right",
+      kind: "text",
+      description: "Text after the branch name when custom display is enabled",
+      default: "",
+      showWhen: { property: "gitBranchDisplayStyle", equals: "custom" },
+      options: { showInWidgets: false, showInColors: false },
+    },
+  ],
+  icons: { emoji: "🌿", nerd: "", text: "git" },
+  defaultStyle: { fg: "magenta", bg: "default", bold: false },
+  render({ ctx, options, renderWidget }) {
+    const branch = ctx.git.branch;
+    if (!branch) return renderWidget("");
+
+    if (options.gitBranchDisplayStyle === "round-brackets") return renderWidget(`(${branch})`);
+    if (options.gitBranchDisplayStyle === "custom") {
+      return renderWidget(`${options.surroundLeft}${branch}${options.surroundRight}`);
+    }
+    return renderWidget(branch);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/clean.ts

@@ -0,0 +1,19 @@
+import { defineWidget } from "../types.js";
+
+export const GitCleanStatusWidget = defineWidget({
+  type: "git-clean",
+  label: "Git Clean Status",
+  category: "Git",
+  description: "Clean/dirty state",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "✅", nerd: "󰄬", text: "git" },
+  defaultStyle: { fg: "green", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    if (!ctx.git.isRepo) return renderWidget("");
+    const changes = ctx.git.staged + ctx.git.unstaged + ctx.git.untracked;
+    return renderWidget(changes === 0 ? "clean" : "dirty");
+  },
+});

package/node_modules/pi-footer/src/widgets/git/deletions.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitDeletionsWidget = defineWidget({
+  type: "git-deletions",
+  label: "Git Deletions",
+  category: "Git",
+  description: "Uncommitted deletion count",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenZero", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "➖", nerd: "-", text: "del" },
+  defaultStyle: { fg: "red", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(`${ctx.git.deletions}`);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/diff.ts

@@ -0,0 +1,38 @@
+import { defineWidget } from "../types.js";
+
+export const GitDiffWidget = defineWidget({
+  type: "git-diff",
+  label: "Git Diff",
+  category: "Git",
+  description: "Insertion/deletion diff summary",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [
+    {
+      id: "gitDiffMode",
+      label: "Display",
+      kind: "choice",
+      description: "Git diff display mode",
+      default: "plain",
+      options: {
+        choices: [
+          { id: "plain", label: "Plain (+/-)", list: "Plain (+/-)" },
+          { id: "compact", label: "Compact (+n,-n)", list: "Compact (+n,-n)" },
+        ],
+        showInWidgets: true,
+        showInColors: false,
+        listProperty: "display",
+      },
+    },
+  ],
+  icons: { emoji: "📈", nerd: "", text: "diff" },
+  defaultStyle: { fg: "yellow", bg: "default", bold: false },
+  render({ ctx, options, renderWidget }) {
+    return renderWidget(
+      options.gitDiffMode === "compact"
+        ? `(+${ctx.git.insertions},-${ctx.git.deletions})`
+        : `+${ctx.git.insertions}/-${ctx.git.deletions}`,
+    );
+  },
+});

package/node_modules/pi-footer/src/widgets/git/insertions.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitInsertionsWidget = defineWidget({
+  type: "git-insertions",
+  label: "Git Insertions",
+  category: "Git",
+  description: "Uncommitted insertion count",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenZero", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "➕", nerd: "+", text: "ins" },
+  defaultStyle: { fg: "green", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(`${ctx.git.insertions}`);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/remote.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitRemoteWidget = defineWidget({
+  type: "git-remote",
+  label: "Git Remote",
+  category: "Git",
+  description: "Origin remote",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "🌐", nerd: "󰊢", text: "remote" },
+  defaultStyle: { fg: "cyan", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.git.remote ?? "");
+  },
+});

package/node_modules/pi-footer/src/widgets/git/root.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitRootDirWidget = defineWidget({
+  type: "git-root",
+  label: "Git Root Dir",
+  category: "Git",
+  description: "Repository root directory name",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "📦", nerd: "", text: "repo" },
+  defaultStyle: { fg: "cyan", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.git.root ?? "");
+  },
+});

package/node_modules/pi-footer/src/widgets/git/sha.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitShaWidget = defineWidget({
+  type: "git-sha",
+  label: "Git SHA",
+  category: "Git",
+  description: "Short HEAD commit SHA",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "🔖", nerd: "", text: "sha" },
+  defaultStyle: { fg: "brightBlack", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(ctx.git.sha ?? "");
+  },
+});

package/node_modules/pi-footer/src/widgets/git/staged.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitStagedWidget = defineWidget({
+  type: "git-staged",
+  label: "Git Staged Files",
+  category: "Git",
+  description: "Staged file count",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenZero", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "➕", nerd: "+", text: "staged" },
+  defaultStyle: { fg: "green", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(`${ctx.git.staged}`);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/status.ts

@@ -0,0 +1,19 @@
+import { defineWidget } from "../types.js";
+
+export const GitStatusWidget = defineWidget({
+  type: "git-status",
+  label: "Git Status",
+  category: "Git",
+  description: "Staged/unstaged/untracked counts",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenEmpty", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "🔀", nerd: "", text: "git" },
+  defaultStyle: { fg: "yellow", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(
+      ctx.git.isRepo ? `+${ctx.git.staged} ±${ctx.git.unstaged} ?${ctx.git.untracked}` : "",
+    );
+  },
+});

package/node_modules/pi-footer/src/widgets/git/unstaged.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitUnstagedWidget = defineWidget({
+  type: "git-unstaged",
+  label: "Git Unstaged Files",
+  category: "Git",
+  description: "Unstaged file count",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenZero", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "📝", nerd: "±", text: "unstaged" },
+  defaultStyle: { fg: "yellow", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(`${ctx.git.unstaged}`);
+  },
+});

package/node_modules/pi-footer/src/widgets/git/untracked.ts

@@ -0,0 +1,17 @@
+import { defineWidget } from "../types.js";
+
+export const GitUntrackedWidget = defineWidget({
+  type: "git-untracked",
+  label: "Git Untracked Files",
+  category: "Git",
+  description: "Untracked file count",
+  dependencies: ["git"],
+  baseOptions: ["raw", "hideWhenZero", "icon", "text"],
+  baseOptionDefaults: { text: "" },
+  properties: [],
+  icons: { emoji: "❓", nerd: "?", text: "untracked" },
+  defaultStyle: { fg: "red", bg: "default", bold: false },
+  render({ ctx, renderWidget }) {
+    return renderWidget(`${ctx.git.untracked}`);
+  },
+});

package/node_modules/pi-footer/src/widgets/instance.ts

@@ -0,0 +1,118 @@
+import { applyColors, stripAnsi } from "../colors.js";
+import type { WidgetEntry, WidgetOptions } from "../types.js";
+import type { WidgetSpecUnion } from "./registry.js";
+import type {
+  BaseWidgetContext,
+  ContextFor,
+  OptionsFor,
+  TypedWidgetRenderArgs,
+  Widget,
+  WidgetContext,
+  WidgetRenderOptions,
+} from "./types.js";
+
+export class WidgetInstance<TSpec extends WidgetSpecUnion = WidgetSpecUnion> implements Widget {
+  constructor(
+    readonly spec: TSpec,
+    readonly entry: WidgetEntry,
+  ) {}
+
+  get id(): string {
+    return this.entry.id;
+  }
+
+  get type(): WidgetEntry["type"] {
+    return this.entry.type;
+  }
+
+  get enabled(): boolean {
+    return this.entry.enabled;
+  }
+
+  set enabled(value: boolean) {
+    this.entry.enabled = value;
+  }
+
+  get options(): WidgetOptions {
+    return this.entry.options;
+  }
+
+  set options(value: WidgetOptions) {
+    this.entry.options = value;
+  }
+
+  // TODO(widget-spec): remove casts once render context and hydrated entries preserve concrete spec types.
+  render(ctx: WidgetContext): string | undefined {
+    const spec = this.spec as unknown as TSpec & {
+      render(args: TypedWidgetRenderArgs<TSpec>): string | undefined;
+    };
+    return spec.render({
+      ctx: ctx as ContextFor<TSpec>,
+      options: this.options as OptionsFor<TSpec>,
+      renderWidget: (value, renderOptions) => {
+        return renderWidgetValue(this.entry, value, ctx, {
+          ...renderOptions,
+          icons: renderOptions?.icons ?? this.spec.icons,
+        });
+      },
+    });
+  }
+
+  toggle(enabled = !this.enabled): void {
+    this.enabled = enabled;
+  }
+
+  update(options: Partial<WidgetOptions>): void {
+    this.options = { ...this.options, ...options };
+  }
+
+  toEntry(): WidgetEntry {
+    return {
+      id: this.id,
+      type: this.type,
+      enabled: this.enabled,
+      options: { ...this.options },
+    };
+  }
+}
+
+function renderWidgetValue(
+  entry: WidgetEntry,
+  value: string | undefined,
+  ctx: BaseWidgetContext,
+  renderOptions: WidgetRenderOptions = {},
+): string | undefined {
+  // The persisted option fields the renderer reads (style + base options) — entry.options is
+  // already WidgetOptions, which is a superset, so no narrowing is needed.
+  const options = entry.options;
+  if (!entry.enabled) return undefined;
+
+  const rawValue = value ?? "";
+  if (rawValue.length === 0 && options.hideWhenEmpty) return undefined;
+  if (rawValue === "0" && options.hideWhenZero) return undefined;
+
+  const fallbackValue = rawValue.length === 0 ? (options.text ?? "-") : rawValue;
+  const displayValue = renderOptions.stripIncomingStyles ? stripAnsi(fallbackValue) : fallbackValue;
+  const label = renderOptions.icons?.[ctx.iconMode];
+  const unstyled =
+    options.raw === true || ctx.minimalist
+      ? displayValue
+      : options.icon
+        ? `${options.icon}${displayValue}`
+        : label
+          ? `${label} ${displayValue}`
+          : displayValue;
+  const styled =
+    renderOptions.preservedTrimStyles && !renderOptions.stripIncomingStyles
+      ? `${renderOptions.preservedTrimStyles}${unstyled}`
+      : unstyled;
+
+  return applyColors(
+    styled,
+    renderOptions.fg ?? options.fg,
+    renderOptions.bg ?? options.bg,
+    renderOptions.bold ?? options.bold,
+    ctx.colorLevel,
+    ctx.theme,
+  );
+}

package/node_modules/pi-footer/src/widgets/layout/custom-text.ts

@@ -0,0 +1,18 @@
+import { defineWidget } from "../types.js";
+
+export const CustomTextWidget = defineWidget({
+  type: "custom-text",
+  label: "Custom Text",
+  category: "Custom/Layout",
+  description: "User-defined text segment",
+  dependencies: [],
+  baseOptions: ["text"],
+  // Custom text only exposes the shared `text` field, with a widget-specific default.
+  baseOptionDefaults: { text: "custom" },
+  properties: [],
+  icons: { emoji: "", nerd: "", text: "" },
+  defaultStyle: { fg: "default", bg: "default", bold: false },
+  render({ options, renderWidget }) {
+    return renderWidget(options.text);
+  },
+});

package/node_modules/pi-footer/src/widgets/layout/flex-separator.ts

@@ -0,0 +1,32 @@
+import { defineWidget } from "../types.js";
+
+export const FlexSeparatorWidget = defineWidget({
+  type: "flex-separator",
+  label: "Flex Separator",
+  category: "Custom/Layout",
+  description: "Push following widgets to the right",
+  dependencies: [],
+  baseOptions: [],
+  baseOptionDefaults: {},
+  properties: [
+    {
+      id: "hideWhenEmpty",
+      label: "Hide when empty",
+      kind: "boolean",
+      description: "Hide empty flex separator output",
+      default: true,
+      options: {
+        // Hidden implementation detail: flex separators are structural and should not render text,
+        // while the visible UI remains only Enabled as it was before migration.
+        showInFields: false,
+        showInWidgets: false,
+        showInColors: false,
+      },
+    },
+  ],
+  icons: { emoji: "", nerd: "", text: "" },
+  defaultStyle: { fg: "default", bg: "default", bold: false },
+  render({ renderWidget }) {
+    return renderWidget("");
+  },
+});

package/node_modules/pi-footer/src/widgets/layout/separator.ts

@@ -0,0 +1,57 @@
+import { WIDGET_SEPARATOR_VALUES, widgetSeparatorText } from "../../separators.js";
+import { defineWidget } from "../types.js";
+
+export const SeparatorWidget = defineWidget({
+  type: "separator",
+  label: "Separator",
+  category: "Custom/Layout",
+  description: "Predefined or custom separator segment",
+  dependencies: [],
+  baseOptions: [],
+  baseOptionDefaults: {},
+  properties: [
+    {
+      id: "hideWhenEmpty",
+      label: "Hide when empty",
+      kind: "boolean",
+      description: "Hide empty separator output",
+      default: true,
+      options: {
+        // Hidden implementation detail: `separator=none` and empty custom text must render no segment,
+        // while the visible UI remains only Enabled/Separator/Text as it was before migration.
+        showInFields: false,
+        showInWidgets: false,
+        showInColors: false,
+      },
+    },
+    {
+      id: "separator",
+      label: "Separator",
+      kind: "choice",
+      description: "Separator style",
+      default: "pipe",
+      options: {
+        choices: WIDGET_SEPARATOR_VALUES.map((id) => ({ id, label: id, list: id })),
+        listProperty: "separator",
+        showInColors: true,
+      },
+    },
+    {
+      id: "text",
+      label: "Text",
+      kind: "text",
+      description: "Custom separator text",
+      default: "|",
+      showWhen: { property: "separator", equals: "custom" },
+      options: {
+        quoteValue: true,
+        showInColors: true,
+      },
+    },
+  ],
+  icons: { emoji: "", nerd: "", text: "" },
+  defaultStyle: { fg: "default", bg: "default", bold: false },
+  render({ options, renderWidget }) {
+    return renderWidget(widgetSeparatorText(options.separator, options.text));
+  },
+});

package/node_modules/pi-footer/src/widgets/layout/spacer.ts

@@ -0,0 +1,31 @@
+import { defineWidget } from "../types.js";
+
+export const SpacerWidget = defineWidget({
+  type: "spacer",
+  label: "Spacer",
+  category: "Custom/Layout",
+  description: "Fixed-width blank spacer",
+  dependencies: [],
+  baseOptions: [],
+  baseOptionDefaults: {},
+  properties: [
+    {
+      id: "width",
+      label: "Width",
+      kind: "number",
+      description: "Spacer width",
+      default: 2,
+      options: {
+        min: 1,
+        max: 40,
+        listProperty: "width",
+        showInColors: true,
+      },
+    },
+  ],
+  icons: { emoji: "", nerd: "", text: "" },
+  defaultStyle: { fg: "default", bg: "default", bold: false },
+  render({ options, renderWidget }) {
+    return renderWidget(" ".repeat(options.width));
+  },
+});