@pi-unipi/footer 0.1.2 → 0.1.4

package/src/types.ts

@@ -9,39 +9,64 @@ import type { Theme, ThemeColor } from "@mariozechner/pi-coding-agent";
 
 // ─── Semantic Colors ────────────────────────────────────────────────────────
 
+/** Zone assignment for segment positioning */
+export type SegmentZone = "left" | "center" | "right";
+
 /** Semantic color names mapped to segment groups */
 export type SemanticColor =
+  // ── Model & Identity (Left zone) ──
   | "model"
   | "path"
   | "git"
-  | "compactor"
-  | "memory"
-  | "mcp"
-  | "ralph"
-  | "ralphOn"
-  | "ralphOff"
+  | "gitClean"
+  | "gitDirty"
+  | "session"
+  | "worktree"
+  // ── Workflow (Left zone) ──
   | "workflow"
+  | "workflowNone"
   | "workflowBrainstorm"
   | "workflowPlan"
   | "workflowWork"
   | "workflowReview"
   | "workflowAuto"
+  | "workflowDebug"
+  | "workflowChoreExec"
   | "workflowOther"
+  // ── TPS tiers (Center zone) ──
+  | "tpsSlow"
+  | "tpsModerate"
+  | "tpsGood"
+  | "tpsFast"
+  | "tpsBlazing"
+  | "tpsIdle"
+  // ── Metrics (Center zone) ──
+  | "compactor"
+  | "memory"
+  | "mcp"
+  | "ralph"
+  | "ralphOn"
+  | "ralphOff"
   | "kanboard"
   | "notify"
-  | "separator"
-  | "border"
   | "context"
   | "contextWarn"
   | "contextError"
   | "cost"
   | "tokens"
+  // ── Time (Right zone) ──
+  | "clock"
+  | "duration"
+  // ── Thinking levels ──
   | "thinking"
   | "thinkingMinimal"
   | "thinkingLow"
   | "thinkingMedium"
   | "thinkingHigh"
-  | "thinkingXhigh";
+  | "thinkingXhigh"
+  // ── UI chrome ──
+  | "separator"
+  | "border";
 
 /** A theme color name or custom hex color */
 export type ColorValue = ThemeColor | `#${string}`;
@@ -98,6 +123,8 @@ export interface FooterSegmentContext {
   piContext?: unknown;
   /** Footer data provider (for core segments that need git, extension statuses) */
   footerData?: unknown;
+  /** Label mode: compact (shortLabel) or labeled (full label) */
+  labelMode?: "compact" | "labeled";
 }
 
 /** Segment render function type */
@@ -107,8 +134,14 @@ export type SegmentRenderFn = (ctx: FooterSegmentContext) => RenderedSegment;
 export interface FooterSegment {
   /** Unique segment identifier (e.g., "model", "compactions") */
   id: string;
-  /** Display label */
+  /** Display label (full name, used in labeled mode) */
   label: string;
+  /** Compact display name (used in compact mode, e.g. "ses", "tps", "ctx") */
+  shortLabel: string;
+  /** Human-readable description (shown in footer-help overlay) */
+  description: string;
+  /** Layout zone assignment */
+  zone: SegmentZone;
   /** Icon glyph (Nerd Font or ASCII) */
   icon: string;
   /** Render function */
@@ -153,6 +186,10 @@ export interface FooterSettings {
   separator: SeparatorStyle;
   /** Icon style: nerd (Nerd Font glyphs), emoji (Unicode emoji), text (plain labels) */
   iconStyle: IconStyle;
+  /** Zone separator string (between zones, default: "│") */
+  zoneSeparator?: string;
+  /** Show full labels instead of compact short labels */
+  showFullLabels?: boolean;
   /** Per-group settings */
   groups: Record<string, FooterGroupSettings>;
 }
@@ -174,10 +211,12 @@ export interface PresetDef {
   rightSegments: string[];
   /** Secondary row segments (shown when terminal is narrow) */
   secondarySegments: string[];
-  /** Separator style for this preset */
-  separator: SeparatorStyle;
   /** Color scheme for this preset */
   colors?: ColorScheme;
   /** Per-segment options */
   segmentOptions?: Record<string, Record<string, unknown>>;
+  /** Zone order (default: left, center, right) */
+  zoneOrder?: ("left" | "center" | "right")[];
+  /** Zone separator string (between zones) */
+  zoneSeparator?: string;
 }