@leo-alvarenga/pi-zen-frame 0.13.0 → 0.15.0

package/README.md

@@ -52,11 +52,6 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
     "enable": true,
     // Header renderer by registered name (built-in: "basic")
     "type": "basic",
-    "logo": ["█████████  ", "███   ███  ", "██████     ", "███     ███"],
-    "heading": "Welcome back!",
-    "subheading": "Ready for your next session? Terminal warm, context clean, tools ready to execute",
-    "logoColor": "text",
-    "accentColor": "customMessageLabel",
   },
 
   "frame": {
@@ -65,15 +60,6 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
     // Minimum terminal width required to render the border frame
     "minWidth": 20,
 
-    // Padding inside the frame
-    "paddingTop": 1,
-    "paddingBottom": 1,
-    "paddingX": 2,
-
-    // Outer margin around the frame
-    "marginTop": 0,
-    "marginBottom": 0,
-
     // Toggle individual status segments
     "showCwd": true,
     "showModel": true,
@@ -81,24 +67,6 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
     "showThinking": true,
     "showSpinner": false,
     "showAgentMode": true,
-
-    // Color options: "border", "accentColor", or "agentMode"
-    "borderColor": "border",
-
-    // Input prompt prefix glyph and color settings
-    "prefix": "┃",
-    "prefixColor": "muted", // Options: "agentMode", "frameBorder", or any ThemeColor
-
-    // Override default Nerd-Font glyphs
-    "icons": {
-      // Keys: folder, model, context, thinking, gitDirty, gitBranch
-    },
-
-    // Per-segment foreground color overrides (supersedes default theme colors)
-    "colors": {
-      "model": "accent",
-      "cwd": "accent",
-    },
   },
 
   // Randomized status messages shown while streaming responses

package/extensions/components/frame.ts

@@ -43,21 +43,13 @@ export function composeBand(
   autocomplete: string[],
   opts: BandOptions,
 ): string[] {
-  const {
-    padX,
-    paint,
-    width,
-    prefix,
-    marginX,
-    boxBottom,
-    paddingTop,
-    paddingBottom,
-  } = opts;
+  const { padX, paint, width, prefix, boxBottom, paddingTop, paddingBottom } =
+    opts;
 
   const lead = Math.max(0, padX - visibleWidth(prefix));
 
   const inset = (row: string) =>
-    paint(prefix + " ".repeat(lead) + row + " ".repeat(padX));
+    prefix + paint(" ".repeat(lead) + row + " ".repeat(padX));
 
   const fill = () => inset(paint(" ".repeat(Math.max(0, width - 2 * padX))));
 

package/extensions/components/header.ts

@@ -8,7 +8,6 @@ import type {
 
 import {
   DEFAULT_ICONS,
-  DEFAULT_SETTINGS,
   HEADER_TIPS,
 } from "../config/constants";
 import type { Settings } from "../config/types";
@@ -19,6 +18,18 @@ import { getShortCwd } from "../utils";
 const MIN_BOX_WIDTH = 20;
 const LEFT_COL_RATIO = 0.4; // logo column width / total width
 
+/** BasicHeader preset styling — self-contained, not user-configurable. */
+const LOGO_LINES = [
+  "█████████  ",
+  "███   ███  ",
+  "██████     ",
+  "███     ███",
+];
+const LOGO_COLOR: ThemeColor = "text";
+const HEADING = "Welcome back!";
+const SUBHEADING =
+  "Ready for your next session? Terminal warm, context clean, tools ready to execute";
+
 /** Live env snapshot the header renders in the right column. */
 export interface HeaderEnv {
   gitBranch: string | undefined;
@@ -60,12 +71,11 @@ export function createHeader(
     };
   }
 
-  const accentColor =
-    settings.header?.accentColor ?? settings.accentColor ?? "accent";
+  const accentColor = settings.accentColor ?? "accent";
 
   const logo = {
-    lines: settings.header?.logo ?? DEFAULT_SETTINGS.header?.logo ?? [],
-    color: settings.header?.logoColor ?? DEFAULT_SETTINGS.header?.logoColor,
+    lines: LOGO_LINES,
+    color: LOGO_COLOR,
   };
 
   const border = (s: string, fg?: ThemeColor) => theme.fg(fg ?? accentColor, s);
@@ -151,18 +161,14 @@ export function createHeader(
         "",
 
         ...wrapLines(
-          [settings.header?.heading ?? DEFAULT_SETTINGS.header?.heading ?? ""],
+          [HEADING],
           leftW - 2,
         ).map((line) => theme.bold(theme.fg("muted", line))),
 
         "",
 
         ...wrapLines(
-          [
-            settings.header?.subheading ??
-              DEFAULT_SETTINGS.header?.subheading ??
-              "",
-          ],
+          [SUBHEADING],
           leftW - 2,
         ).map((line) => theme.italic(theme.fg("muted", line))),
       ];

package/extensions/config/constants/defaults.ts

@@ -8,14 +8,6 @@ export const DEFAULT_SETTINGS: Settings = {
   header: {
     enable: false,
     type: "basic",
-    logoColor: "text",
-    accentColor: "accent",
-
-    heading: "Welcome back!",
-    subheading:
-      "Ready for your next session? Terminal warm, context clean, tools ready to execute",
-
-    logo: ["█████████  ", "███   ███  ", "██████     ", "███     ███"],
   },
 
   workingMessage: {
@@ -25,22 +17,13 @@ export const DEFAULT_SETTINGS: Settings = {
   },
 
   frame: {
-    icons: {},
-    marginX: 1,
-    paddingX: 2,
-    prefix: "┃",
     enable: true,
     minWidth: 20,
-    marginTop: 0,
     showCwd: true,
-    paddingTop: 1,
-    marginBottom: 0,
     showModel: true,
-    paddingBottom: 1,
-    showSpinner: false,
     showContext: true,
     showThinking: true,
     showAgentMode: true,
-    prefixColor: "agentMode",
+    showSpinner: false,
   },
 };

package/extensions/config/constants/visuals.ts

@@ -11,7 +11,7 @@ export const SPINNER_FRAMES: Record<SpinnerPhase, string[]> = {
   // Sample ["░", "▒", "▓", "█", "▓", "▒"],
 };
 
-/** Nerd Font defaults (override any subset via `frame.icons`). */
+/** Nerd Font glyphs used by the blocky editor preset. */
 export const DEFAULT_ICONS: FrameIcons = {
   model: "󰣖",
   folder: " ",

package/extensions/config/settings.ts

@@ -31,9 +31,6 @@ function normalize(raw: unknown): Settings {
   const bool = (v: unknown, fallback: boolean | undefined): boolean =>
     typeof v === "boolean" ? v : (fallback ?? true);
 
-  const str = (v: unknown, fallback: string): string =>
-    typeof v === "string" ? v : fallback;
-
   const d = DEFAULT_SETTINGS;
   const r = raw as Record<string, unknown>;
 
@@ -50,31 +47,13 @@ function normalize(raw: unknown): Settings {
 
     out.frame = {
       enable: bool(f.enable, d.frame?.enable),
-      marginX: num(f.marginX, d.frame?.marginX ?? 1),
-      paddingX: num(f.paddingX, d.frame?.paddingX ?? 1),
       minWidth: num(f.minWidth, d.frame?.minWidth ?? 20),
-      paddingTop: num(f.paddingTop, d.frame?.paddingTop ?? 0),
-      paddingBottom: num(f.paddingBottom, d.frame?.paddingBottom ?? 1),
-      marginTop: num(f.marginTop, d.frame?.marginTop ?? 0),
-      marginBottom: num(f.marginBottom, d.frame?.marginBottom ?? 0),
       showModel: bool(f.showModel, d.frame?.showModel),
       showThinking: bool(f.showThinking, d.frame?.showThinking),
       showContext: bool(f.showContext, d.frame?.showContext),
       showCwd: bool(f.showCwd, d.frame?.showCwd),
       showAgentMode: bool(f.showAgentMode, d.frame?.showAgentMode),
       showSpinner: bool(f.showSpinner, d.frame?.showSpinner),
-      icons:
-        typeof f.icons === "object" && f.icons
-          ? { ...d.frame?.icons, ...(f.icons as Record<string, unknown>) }
-          : d.frame?.icons,
-      prefix:
-        typeof f.prefix === "string" ? f.prefix : (d.frame?.prefix ?? "┃"),
-
-      prefixColor:
-        typeof f.prefixColor === "string" &&
-        (f.prefixColor === "agentMode" || isThemeColor(f.prefixColor))
-          ? f.prefixColor
-          : d.frame?.prefixColor, // unset → text
     };
   }
 
@@ -84,20 +63,6 @@ function normalize(raw: unknown): Settings {
     out.header = {
       type: typeof h.type === "string" ? h.type : (d.header?.type ?? "basic"),
       enable: bool(h.enable, d.header?.enable),
-      heading: str(h.heading, d.header?.heading ?? ""),
-      subheading: str(h.subheading, d.header?.subheading ?? ""),
-      logoColor:
-        typeof h.logoColor === "string" && isThemeColor(h.logoColor)
-          ? h.logoColor
-          : (d.header?.logoColor ?? "accent"),
-      accentColor:
-        typeof h.accentColor === "string" && isThemeColor(h.accentColor)
-          ? h.accentColor
-          : (d.header?.accentColor ?? "accent"),
-      logo:
-        Array.isArray(h.logo) && h.logo.every((x) => typeof x === "string")
-          ? (h.logo as string[])
-          : (d.header?.logo ?? []),
     };
   }
 

package/extensions/config/types.ts

@@ -20,9 +20,9 @@ export interface FrameIcons {
 }
 
 /**
- * ``frame`` — the borderless band look. Padding values are plain
- * numbers (>= 0): paddingTop/paddingBottom are blank lines shown *inside*
- * the band above/below the content.
+ * ``frame`` — the editor frame preset. Styling and layout (prefix, colors,
+ * margins, paddings) are owned by the renderer; only these behavioral
+ * toggles are configurable.
  */
 export interface FrameSettings {
   enable?: boolean;
@@ -30,24 +30,6 @@ export interface FrameSettings {
   /** Below this terminal width the frame is skipped entirely (passthrough) */
   minWidth?: number;
 
-  /** Blank rows inside the band above the content. Default 1 */
-  paddingTop?: number;
-
-  /** Blank rows inside the band below the content. Default 1 */
-  paddingBottom?: number;
-
-  /** Horizontal inner padding for the content rows. Default 2 */
-  paddingX?: number;
-
-  /** Horizontal outer margin for the content rows. Default 1 */
-  marginX?: number;
-
-  /** Blank rows OUTSIDE the band, above it. Default 0 */
-  marginTop?: number;
-
-  /** Blank rows OUTSIDE the band, below the pseudo-footer. Default 0 */
-  marginBottom?: number;
-
   showCwd?: boolean;
   showModel?: boolean;
   showContext?: boolean;
@@ -56,24 +38,11 @@ export interface FrameSettings {
 
   /** Show the status-animation spinner segment while streaming. Default false */
   showSpinner?: boolean;
-
-  icons?: Partial<FrameIcons>;
-
-  /** Text before the editor content. Default "┃" */
-  prefix?: string;
-
-  /** ThemeColor for the prefix; "agentMode" follows the agent's color if (@leo-alvarenga/pi-agent-manager is installed, defaults to "text otherwise"). Default: "agentMode" */
-  prefixColor?: "agentMode" | ThemeColor;
 }
 
 /** `header` — the top-line header, which can show a logo or other text */
 export interface HeaderSettings {
-  logo: string[];
   enable: boolean;
-  heading: string;
-  subheading: string;
-  logoColor: ThemeColor;
-  accentColor: ThemeColor;
 
   /** Header renderer by registered name. Default "basic". */
   type?: string;

package/extensions/editor/blocky-editor.ts

@@ -20,7 +20,6 @@ import type {
   SegmentContext,
 } from "../components/types";
 import type { EditorFrameRenderOptions } from "../renderers/types";
-import { isThemeColor } from "../utils";
 
 export class BlockyEditor extends CustomEditor {
   private pi: ExtensionAPI;
@@ -77,15 +76,9 @@ export class BlockyEditor extends CustomEditor {
   render(width: number): string[] {
     const frame = this.opts.frame;
 
-    const padX = Math.min(
-      frame.paddingX ?? 1,
-      Math.max(0, Math.floor(width / 2)),
-    );
+    const padX = Math.min(2, Math.max(0, Math.floor(width / 2)));
 
-    const marginX = Math.min(
-      frame.marginX ?? 0,
-      Math.max(0, Math.floor(width / 2)),
-    );
+    const marginX = Math.min(1, Math.max(0, Math.floor(width / 2)));
 
     const contentWidth = width - marginX * 2;
     const innerWidth = width - padX * 2 - marginX * 2;
@@ -107,16 +100,11 @@ export class BlockyEditor extends CustomEditor {
       accentColor: this.opts.accentColor,
     };
 
-    let prefix = frame.prefix ?? "┃";
+    let prefix = "┃";
 
     if (ext.theme?.fg) {
-      let prefixColor: ThemeColor = "text";
-      if (frame.prefixColor === "agentMode") {
-        prefixColor = ext.agentMode?.color ?? "text";
-      } else if (frame.prefixColor && isThemeColor(frame.prefixColor)) {
-        prefixColor = frame.prefixColor;
-      }
-
+      const prefixColor: ThemeColor =
+        ext.agentMode?.color ?? this.opts.accentColor ?? "text";
       prefix = ext.theme.fg(prefixColor, prefix);
     }
 
@@ -145,10 +133,7 @@ export class BlockyEditor extends CustomEditor {
     const ctx: SegmentContext = {
       cfg: frame,
       theme: ext.theme,
-      icons: {
-        ...DEFAULT_ICONS,
-        ...frame.icons,
-      },
+      icons: DEFAULT_ICONS,
     };
 
     const box = composeBand(content, autocomplete, {
@@ -156,9 +141,9 @@ export class BlockyEditor extends CustomEditor {
       paint,
       prefix,
       width: contentWidth,
-      marginX: frame.marginX ?? 0,
-      paddingTop: frame.paddingTop ?? 1,
-      paddingBottom: frame.paddingBottom ?? 1,
+      marginX: 1,
+      paddingTop: 1,
+      paddingBottom: 1,
       boxBottom: fitInfoRow(
         segmentsFor("topLeft", d, ctx),
         segmentsFor("topRight", d, ctx),
@@ -174,10 +159,8 @@ export class BlockyEditor extends CustomEditor {
 
     // Blank rows OUTSIDE the band, above/below it.
     const marginRow = " ".repeat(contentWidth);
-    const marginTop = Array(Math.max(0, frame.marginTop ?? 0)).fill(marginRow);
-    const marginBottom = Array(Math.max(0, frame.marginBottom ?? 0)).fill(
-      marginRow,
-    );
+    const marginTop: string[] = [];
+    const marginBottom: string[] = [];
 
     return [...marginTop, ...box, marginRow, pseudoFooter, ...marginBottom].map(
       (row) => " ".repeat(marginX) + row + " ".repeat(marginX),

package/package.json

@@ -2,7 +2,7 @@
   "name": "@leo-alvarenga/pi-zen-frame",
   "description": "A pi-coding-agent extension that gives the TUI editor a simple yet polished look and feel",
   "author": "Leonardo A. Alvarenga",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "license": "MIT",
   "repository": "github.com/leo-alvarenga/pi-mono",
   "publishConfig": {