@normful/pi-show-theme-colors 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Norman Sue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @normful/pi-show-theme-colors
+
+Pi extension that shows available theme colors in the current Pi theme.
+
+## Installation
+
+```bash
+npm install @normful/pi-show-theme-colors
+```
+
+The extension is loaded automatically by Pi when declared in your Pi configuration.
+
+## Usage
+
+Once installed, run:
+
+```
+/show-theme-colors
+```
+
+A display of all theme colors available in the current theme will be shown.
+
+## Keywords
+
+`pi-extension` `pi-package` `theme` `colors`

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@normful/pi-show-theme-colors",
+  "version": "0.2.0",
+  "private": false,
+  "description": "Pi extension that shows available theme colors",
+  "keywords": [
+    "pi",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package"
+  ],
+  "bugs": {
+    "url": "https://github.com/normful/pi-bakery/issues"
+  },
+  "license": "MIT",
+  "author": "Norman Sue",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/normful/pi-bakery.git",
+    "directory": "packages/pi-show-theme-colors"
+  },
+  "type": "module",
+  "dependencies": {
+    "@spences10/pi-tui-modal": "0.0.22"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vite-plus": "^0.2.5"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ],
+    "video": "https://www.github.com/normful/pi-bakery/packages/pi-show-theme-colors/demo.mp4"
+  }
+}

package/src/index.ts

@@ -0,0 +1,92 @@
+import type { ExtensionAPI, Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
+import { show_text_modal } from "@spences10/pi-tui-modal";
+
+export const ALL_COLORS: ThemeColor[] = [
+  "accent",
+  "border",
+  "borderAccent",
+  "borderMuted",
+  "success",
+  "error",
+  "warning",
+  "muted",
+  "dim",
+  "text",
+  "thinkingText",
+  "userMessageText",
+  "customMessageText",
+  "customMessageLabel",
+  "toolTitle",
+  "toolOutput",
+  "mdHeading",
+  "mdLink",
+  "mdLinkUrl",
+  "mdCode",
+  "mdCodeBlock",
+  "mdCodeBlockBorder",
+  "mdQuote",
+  "mdQuoteBorder",
+  "mdHr",
+  "mdListBullet",
+  "toolDiffAdded",
+  "toolDiffRemoved",
+  "toolDiffContext",
+  "syntaxComment",
+  "syntaxKeyword",
+  "syntaxFunction",
+  "syntaxVariable",
+  "syntaxString",
+  "syntaxNumber",
+  "syntaxType",
+  "syntaxOperator",
+  "syntaxPunctuation",
+  "thinkingOff",
+  "thinkingMinimal",
+  "thinkingLow",
+  "thinkingMedium",
+  "thinkingHigh",
+  "thinkingXhigh",
+  "thinkingMax",
+  "bashMode",
+];
+
+const RESET = "\x1b[0m";
+const DEFAULT_SAMPLE = "The quick brown fox";
+
+/**
+ * Build display lines for theme colors.
+ * Pure function — no side effects, no TUI dependency.
+ *
+ * @param theme - Theme instance with getFgAnsi method
+ * @param colors - ThemeColor values to display
+ * @param sample - Sample text to render in each color (default: "The quick brown fox")
+ * @returns Lines of the form "<color-name> <ANSI-colored-sample>"
+ */
+export function buildColorDisplayLines(
+  theme: Pick<Theme, "getFgAnsi">,
+  colors: ThemeColor[],
+  sample = DEFAULT_SAMPLE,
+): string[] {
+  const lines: string[] = [];
+  for (const color of colors) {
+    const ansi = theme.getFgAnsi(color);
+    const colored = `${ansi}${sample}${RESET}`;
+    lines.push(`${color.padEnd(24)} ${colored}`);
+  }
+  return lines;
+}
+
+export default function (pi: ExtensionAPI) {
+  pi.registerCommand("theme-colors", {
+    description: "Show all current theme's colors using sample text",
+    handler: async (_args, ctx) => {
+      const theme = ctx.ui.theme;
+      const themeName = theme.name ?? "(unknown)";
+      const lines = buildColorDisplayLines(theme, ALL_COLORS);
+      await show_text_modal(ctx, {
+        title: `Colors of current theme: ${themeName}`,
+        text: lines.join("\n"),
+      });
+    },
+  });
+}