@groeponline/pi-wishcraft 1.1.0 → 1.2.0

package/src/signal/render.ts

@@ -0,0 +1,178 @@
+/**
+ * Three-lane Signal renderer.
+ *
+ * Left: model/repository state. Center: live semantic activity and motion rail.
+ * Right: context/queue/usage. Modules retain the existing per-segment fault
+ * isolation because every item still renders through `renderSegment`.
+ */
+
+import { visibleWidth } from "@earendil-works/pi-tui";
+import type {
+  PresetDef,
+  SegmentContext,
+  SignalSpec,
+  StatusLineSegmentId,
+  StatusLineSeparatorStyle,
+} from "../config/types.ts";
+import { mergeSegmentsWithCustomItems } from "../config/powerline-config.ts";
+import { renderSegment } from "../segments/index.ts";
+import { ansi, colorEnabled, getFgAnsiCode } from "../theme/colors.ts";
+import { getSeparator } from "../theme/separators.ts";
+import { frameAt, getMotion } from "../motion/index.ts";
+import type { SignalRuntime } from "./controller.ts";
+
+export interface SignalRenderOptions {
+  separatorStyle: StatusLineSeparatorStyle;
+  signal: SignalSpec;
+  ascii?: boolean;
+  layout?: import("../config/types.ts").StatusLineLayout | null;
+  disabledSegments?: StatusLineSegmentId[];
+}
+
+interface Module {
+  content: string;
+  width: number;
+}
+
+export function renderSignal(
+  ctx: SegmentContext,
+  preset: PresetDef,
+  runtime: SignalRuntime,
+  availableWidth: number,
+  options: SignalRenderOptions,
+): { topContent: string; secondaryContent: string } {
+  const merged = mergeSegmentsWithCustomItems(
+    preset,
+    ctx.effectiveCustomItems,
+    {
+      layout: options.layout ?? null,
+      disabledSegments: options.disabledSegments ?? [],
+    },
+  );
+  const left = renderModules(merged.leftSegments, ctx);
+  const right = renderModules(merged.rightSegments, ctx);
+  const secondary = renderModules(merged.secondarySegments, ctx);
+  const separator = getSeparator(options.separatorStyle).left;
+
+  const center = renderActivity(runtime, options.signal, options.ascii);
+  const top = fitLanes(left, center, right, separator, availableWidth);
+  return {
+    topContent: top,
+    secondaryContent: joinModules(secondary, separator, availableWidth),
+  };
+}
+
+function renderModules(ids: readonly StatusLineSegmentId[], ctx: SegmentContext): Module[] {
+  const modules: Module[] = [];
+  for (const id of ids) {
+    // renderSegment is the established per-module error boundary.
+    const rendered = renderSegment(id, ctx);
+    if (!rendered.visible || !rendered.content) continue;
+    modules.push({
+      content: rendered.content,
+      width: visibleWidth(rendered.content),
+    });
+  }
+  return modules;
+}
+
+export function renderActivity(
+  runtime: SignalRuntime,
+  spec: SignalSpec,
+  ascii = false,
+): string {
+  const def = getMotion(runtime.motionId) ?? getMotion(spec.animation);
+  const glyph = def
+    ? frameAt(def, runtime.tick, ascii)
+    : ascii
+      ? "*"
+      : "◆";
+  const label = runtime.activity || "ready";
+  const open = spec.caps.leftOpen ?? "";
+  const close = spec.caps.leftClose ?? "";
+  const dim = getFgAnsiCode("sep");
+  const reset = colorEnabled() ? ansi.reset : "";
+  const rail = runtime.active
+    ? `${spec.separators.left}${glyph}${spec.separators.right}`
+    : `${spec.separators.left}${spec.separators.right}`;
+  return `${dim}${open}${rail}${close}${reset} ${label}`;
+}
+
+function fitLanes(
+  leftInput: Module[],
+  center: string,
+  rightInput: Module[],
+  separator: string,
+  availableWidth: number,
+): string {
+  if (availableWidth <= 0) return "";
+  const left = [...leftInput];
+  const right = [...rightInput];
+  const sep = styledSeparator(separator);
+  const centerWidth = visibleWidth(center);
+
+  const lane = (modules: Module[]) => modules.map((module) => module.content).join(sep);
+  const totalWidth = () => {
+    const leftText = lane(left);
+    const rightText = lane(right);
+    return (
+      visibleWidth(leftText) +
+      visibleWidth(rightText) +
+      centerWidth +
+      (leftText ? 2 : 0) +
+      (rightText ? 2 : 0)
+    );
+  };
+
+  // Preserve the model/git side first, then context/queue. Remove the least
+  // important outer modules until all three lanes fit.
+  while (totalWidth() + 2 > availableWidth && right.length > 1) right.shift();
+  while (totalWidth() + 2 > availableWidth && left.length > 1) left.pop();
+  while (totalWidth() + 2 > availableWidth && right.length > 0) right.shift();
+  while (totalWidth() + 2 > availableWidth && left.length > 0) left.pop();
+
+  const leftText = lane(left);
+  const rightText = lane(right);
+  if (centerWidth + 2 > availableWidth) {
+    return ` ${truncatePlain(center, Math.max(0, availableWidth - 2))} `;
+  }
+
+  const contentWidth =
+    visibleWidth(leftText) +
+    visibleWidth(rightText) +
+    centerWidth +
+    (leftText ? 2 : 0) +
+    (rightText ? 2 : 0);
+  const flexible = Math.max(0, availableWidth - 2 - contentWidth);
+  const before = leftText ? "  " : "";
+  const after = rightText ? "  " : "";
+  // Extra space lives between center and right, keeping state metrics pinned.
+  return ` ${leftText}${before}${center}${after}${" ".repeat(flexible)}${rightText} `;
+}
+
+function joinModules(modules: Module[], separator: string, width: number): string {
+  if (modules.length === 0) return "";
+  const sep = styledSeparator(separator);
+  const fitted: Module[] = [];
+  let used = 2;
+  for (const module of modules) {
+    const next = module.width + (fitted.length ? visibleWidth(separator) + 2 : 0);
+    if (used + next > width) break;
+    fitted.push(module);
+    used += next;
+  }
+  return fitted.length ? ` ${fitted.map((module) => module.content).join(sep)} ` : "";
+}
+
+function styledSeparator(separator: string): string {
+  const color = getFgAnsiCode("sep");
+  const reset = colorEnabled() ? ansi.reset : "";
+  return ` ${color}${separator}${reset} `;
+}
+
+function truncatePlain(text: string, width: number): string {
+  if (width <= 0) return "";
+  // Activity labels are ASCII; strip ANSI before this emergency narrow path.
+  const plain = text.replace(/\x1b\[[0-9;]*m/g, "");
+  return plain.length <= width ? plain : plain.slice(0, Math.max(0, width - 1)) + "…";
+}

package/src/theme/detect.ts

@@ -0,0 +1,48 @@
+/**
+ * Terminal and host capability detection. Pure: reads an env map, no process
+ * globals except the default argument. Motion policy is assembled elsewhere
+ * so this file stays free of the motion engine.
+ */
+
+export interface TerminalEnvironment {
+  noColor: boolean;
+  lowColor: boolean;
+  screenReader: boolean;
+  reducedMotion: boolean;
+  dumb: boolean;
+}
+
+const MOTION_LEVELS = ["full", "reduced", "functional", "off"] as const;
+
+export function detectEnvironment(
+  env: NodeJS.ProcessEnv = process.env,
+): TerminalEnvironment {
+  const term = (env.TERM ?? "").toLowerCase();
+  const colorterm = (env.COLORTERM ?? "").toLowerCase();
+  const noColor = env.NO_COLOR !== undefined && env.NO_COLOR !== "";
+  const dumb = term === "dumb" || term === "";
+  const lowColor =
+    !colorterm.includes("truecolor") &&
+    !colorterm.includes("24bit") &&
+    (term.includes("vt100") || term === "linux" || /\bansi\b/.test(term));
+  const screenReader =
+    env.WISHCRAFT_SCREEN_READER === "1" ||
+    env.ACCESSIBILITY_SCREEN_READER === "1" ||
+    env.NVDA !== undefined ||
+    env.VOICEOVER === "1";
+  const reducedMotion =
+    env.WISHCRAFT_REDUCED_MOTION === "1" ||
+    env.PREFER_REDUCED_MOTION === "1" ||
+    env.MOZ_PREFER_REDUCED_MOTION === "1";
+
+  return { noColor, lowColor: lowColor && !noColor, screenReader, reducedMotion, dumb };
+}
+
+export function motionLevelFromEnv(
+  env: NodeJS.ProcessEnv = process.env,
+): (typeof MOTION_LEVELS)[number] | null {
+  const raw = (env.WISHCRAFT_MOTION ?? "").toLowerCase();
+  return (MOTION_LEVELS as readonly string[]).includes(raw)
+    ? (raw as (typeof MOTION_LEVELS)[number])
+    : null;
+}

package/src/theme/tokens/index.ts

@@ -0,0 +1,9 @@
+/**
+ * src/theme/tokens/index.ts
+ * ---------------------------------------------------------------------------
+ * Public exports for Wishcraft Semantic Design Tokens.
+ * ---------------------------------------------------------------------------
+ */
+
+export * from "./types.ts";
+export * from "./mapping.ts";

package/src/theme/tokens/mapping.ts

@@ -0,0 +1,62 @@
+/**
+ * src/theme/tokens/mapping.ts
+ * ---------------------------------------------------------------------------
+ * Default token mapping and legacy SemanticColor bridge for Wishcraft.
+ * ---------------------------------------------------------------------------
+ */
+
+import type { ColorScheme, SemanticColor } from "../../config/types.ts";
+import type { WishcraftTokens } from "./types.ts";
+
+export const DEFAULT_TOKENS: WishcraftTokens = {
+  surface: "#0f172a",
+  surfaceRaised: "#1e293b",
+  text: "#f8fafc",
+  textMuted: "dim",
+  primary: "#f59e0b",
+  secondary: "#00afaf",
+  accent: "#ea580c",
+  success: "success",
+  warning: "warning",
+  error: "error",
+  focus: "#38bdf8",
+  selection: "#334155",
+  motionDim: "dim",
+  motionHot: "#fbbf24",
+  motionTrail: "#78350f",
+};
+
+/**
+ * Derives legacy SemanticColor configuration from modern WishcraftTokens.
+ */
+export function deriveColorSchemeFromTokens(tokens: WishcraftTokens): Required<ColorScheme> {
+  return {
+    model: tokens.primary,
+    shellMode: tokens.accent,
+    path: tokens.secondary,
+    gitClean: tokens.success,
+    gitDirty: tokens.warning,
+    thinking: "thinkingOff",
+    thinkingMinimal: "thinkingMinimal",
+    thinkingLow: "thinkingLow",
+    thinkingMedium: "thinkingMedium",
+    context: tokens.textMuted,
+    contextWarn: tokens.warning,
+    contextError: tokens.error,
+    cost: tokens.text,
+    tokens: tokens.textMuted,
+    queue: tokens.accent,
+    separator: tokens.textMuted,
+    border: tokens.surfaceRaised,
+  };
+}
+
+/**
+ * Creates WishcraftTokens by merging overrides onto defaults.
+ */
+export function createTokens(overrides?: Partial<WishcraftTokens>): WishcraftTokens {
+  return {
+    ...DEFAULT_TOKENS,
+    ...overrides,
+  };
+}

package/src/theme/tokens/types.ts

@@ -0,0 +1,39 @@
+/**
+ * src/theme/tokens/types.ts
+ * ---------------------------------------------------------------------------
+ * Semantic Design Tokens for Wishcraft (Crush pattern).
+ * ---------------------------------------------------------------------------
+ */
+
+import type { ThemeColor } from "@earendil-works/pi-coding-agent";
+
+export type ColorValue = ThemeColor | `#${string}`;
+
+export interface WishcraftTokens {
+  // Surfaces & Backgrounds
+  surface: ColorValue;
+  surfaceRaised: ColorValue;
+
+  // Typography
+  text: ColorValue;
+  textMuted: ColorValue;
+
+  // Brand & Accents
+  primary: ColorValue;
+  secondary: ColorValue;
+  accent: ColorValue;
+
+  // Feedback & State
+  success: ColorValue;
+  warning: ColorValue;
+  error: ColorValue;
+
+  // Interaction
+  focus: ColorValue;
+  selection: ColorValue;
+
+  // Motion & Animation Channels
+  motionDim: ColorValue;
+  motionHot: ColorValue;
+  motionTrail: ColorValue;
+}