@pi-unipi/footer 3.0.0-alpha.22 → 3.0.0-alpha.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.22",
+  "version": "3.0.0-alpha.24",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.22",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.22"
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/src/config.ts

@@ -93,44 +93,63 @@ registerSettings({
     {
       title: "General",
       fields: [
-        { key: "enabled", type: "boolean", label: "Footer enabled" },
+        { key: "enabled", type: "boolean", label: "Footer enabled", description: "The status line above the input. Off removes it and every segment entirely." },
+        { key: "glanceMode", type: "boolean", label: "Glance mode", description: "The framed input surface with status in its bottom border. Applies to new renders." },
+        {
+          key: "iconStyle",
+          type: "enum",
+          label: "Icon style",
+          description: "Glyph set for the brand and segment icons (glance frame included).",
+          options: [
+            { value: "emoji", label: "emoji", description: "emoji glyphs, always render" },
+            { value: "nerd", label: "nerd font", description: "nerd-font glyphs, need a patched font" },
+            { value: "text", label: "text only", description: "no icons, plain text labels" },
+          ],
+        },
+      ],
+    },
+    {
+      title: "Classic footer",
+      description: "Used only when Glance mode is off.",
+      advanced: true,
+      fields: [
         {
           key: "preset",
           type: "enum",
           label: "Preset",
-          options: ["default", "classic", "minimal", "dense", "devops", "zen"],
-          description: "Segment layout preset (glance mode uses its own frame)",
+          description: "Which segments appear and in what order.",
+          options: [
+            { value: "default", label: "default", description: "model, git, context, cost, clock — the balanced line" },
+            { value: "classic", label: "classic", description: "the pre-v3 view with more status segments" },
+            { value: "minimal", label: "minimal", description: "mode, model, git, context, clock only" },
+            { value: "compact", label: "compact", description: "minimal plus tps and cost" },
+            { value: "full", label: "full", description: "every segment, incl. servers, loops and tasks" },
+            { value: "ascii", label: "ascii", description: "compact set, safe on any terminal" },
+          ],
         },
-        { key: "glanceMode", type: "boolean", label: "Glance mode", description: "The input-box frame renderer" },
-        { key: "showFullLabels", type: "boolean", label: "Full labels", description: "Labeled instead of compact segments" },
         {
           key: "separator",
           type: "enum",
           label: "Separator",
-          description: "Segment divider style",
+          plainOptions: true,
+          description: "Style of the divider drawn between segments.",
           options: ["powerline", "powerline-thin", "slash", "pipe", "dot", "ascii"],
         },
         {
           key: "zoneSeparator",
           type: "enum",
           label: "Zone separator",
-          description: "Divider between zones (left · center · right)",
+          plainOptions: true,
+          description: "Divider between the left, center and right zones.",
           options: ["│", "╎", "·", "─", "none"],
         },
-        {
-          key: "iconStyle",
-          type: "enum",
-          label: "Icon style",
-          options: [
-            { value: "emoji", label: "emoji" },
-            { value: "nerd", label: "nerd font" },
-            { value: "text", label: "text only" },
-          ],
-        },
+        { key: "showFullLabels", type: "boolean", label: "Full labels", description: "Show each segment's name next to its value." },
         {
           key: "colorMode",
           type: "enum",
           label: "Color mode",
+          plainOptions: true,
+          description: "How much color the footer emits.",
           options: ["auto", "truecolor", "256", "mono"],
         },
       ],
@@ -142,16 +161,17 @@ registerSettings({
           key: "segments-page",
           type: "page",
           label: "Segments…",
-          description: "Per-group and per-segment visibility",
+          description: "Choose which groups and segments appear in the footer.",
           sections: () =>
             getFooterRegistry().getAllGroups().map((g) => ({
               title: g.name,
               fields: [
-                { key: `groups.${g.id}.show`, type: "boolean" as const, label: `Show ${g.name}` },
+                { key: `groups.${g.id}.show`, type: "boolean" as const, label: `Show ${g.name}`, description: `Show the ${g.name} group in the footer.` },
                 ...g.segments.map((seg) => ({
                   key: `groups.${g.id}.segments.${seg.id}`,
                   type: "boolean" as const,
                   label: seg.label,
+                  description: `Show the ${seg.label} segment in the ${g.name} group.`,
                 })),
               ],
             })),