@trawlme/cli 3.4.1 → 3.4.2

package/dist/lib/pinch.d.ts

@@ -42,20 +42,14 @@ export declare function renderPinch(state: PinchState, frame?: number): string;
 /**
  * #131 — the ART lines only (no caption), optionally COMPACT: trailing and
  * leading fully-transparent grid rows are dropped so Pinch takes fewer
- * terminal lines (some grids carry an all-'.' padding row). Used by the
- * animation loop, where a caption + full height would be too heavy for a
- * frame redrawn every ~380ms. `working` is rendered at frame 0 (blip on).
+ * terminal lines (some grids carry an all-'.' padding row). `frame` is passed
+ * through to `gridForState` — only `working` reacts to it (the cyan antenna
+ * blip toggles), so the loop can pulse the tips while the body stays still.
  */
 export declare function renderPinchArt(state: PinchState, opts?: {
     compact?: boolean;
+    frame?: number;
 }): string;
-/**
- * #131 — frame sequence for the "working" animation shown during long waits
- * (the `create` wizard, `--watch`). The claws pump up (working → wave →
- * celebrating) and back down, reading as Pinch busily working. No new art —
- * an order over the canonical state grids.
- */
-export declare const WORKING_FRAMES: readonly PinchState[];
 /**
  * True when it's safe to print Pinch art: a real color-capable interactive
  * terminal. False under NO_COLOR (https://no-color.org — presence, not

package/dist/lib/pinch.js

@@ -247,12 +247,12 @@ export function renderPinch(state, frame = 0) {
 /**
  * #131 — the ART lines only (no caption), optionally COMPACT: trailing and
  * leading fully-transparent grid rows are dropped so Pinch takes fewer
- * terminal lines (some grids carry an all-'.' padding row). Used by the
- * animation loop, where a caption + full height would be too heavy for a
- * frame redrawn every ~380ms. `working` is rendered at frame 0 (blip on).
+ * terminal lines (some grids carry an all-'.' padding row). `frame` is passed
+ * through to `gridForState` — only `working` reacts to it (the cyan antenna
+ * blip toggles), so the loop can pulse the tips while the body stays still.
  */
 export function renderPinchArt(state, opts = {}) {
-    let grid = gridForState(state, 0);
+    let grid = gridForState(state, opts.frame ?? 0);
     if (opts.compact) {
         const blank = (row) => [...row].every((c) => c === TRANSPARENT);
         let start = 0;
@@ -268,13 +268,6 @@ export function renderPinchArt(state, opts = {}) {
         lines[1] = `${lines[1]}  \x1b[1m?${RESET}`;
     return lines.join('\n');
 }
-/**
- * #131 — frame sequence for the "working" animation shown during long waits
- * (the `create` wizard, `--watch`). The claws pump up (working → wave →
- * celebrating) and back down, reading as Pinch busily working. No new art —
- * an order over the canonical state grids.
- */
-export const WORKING_FRAMES = ['working', 'wave', 'celebrating', 'wave'];
 /**
  * True when it's safe to print Pinch art: a real color-capable interactive
  * terminal. False under NO_COLOR (https://no-color.org — presence, not

package/dist/lib/pinchAnimation.d.ts

@@ -4,9 +4,12 @@ export interface PinchAnimation {
     stop(): void;
 }
 /**
- * #131 — animate Pinch (a claw-wiggle over the r6f grids) IN PLACE on STDERR
- * while a long operation runs (the `create` wizard, `--watch`). The frame is
- * redrawn every {@link FRAME_MS} via ANSI cursor moves; `stop()` clears it.
+ * #131 / #139 — show Pinch IN PLACE on STDERR while a long operation runs (the
+ * `create` wizard, `--watch`). Pinch stays a STILL `working` sprite; the ONLY
+ * animation is the cyan antenna-tip blip pulsing on/off every {@link FRAME_MS}
+ * (frame 0 = cyan, frame 1 = orange). The body — mouth, claws, eyes — never
+ * moves (the old loop cycled whole poses, which flickered "in every
+ * direction"). Redrawn via ANSI cursor moves; `stop()` clears the block.
  *
  * Contract: the CALLER must have already checked `pinchEnabled()` (TTY /
  * !NO_COLOR) and that the command is NOT `--json` — this writes only to

package/dist/lib/pinchAnimation.js

@@ -1,11 +1,16 @@
 import chalk from 'chalk';
-import { renderPinchArt, WORKING_FRAMES } from './pinch.js';
-/** Frame cadence — slow enough to read as a wave, fast enough to feel alive. */
-const FRAME_MS = 380;
+import { renderPinchArt } from './pinch.js';
+/** Frame cadence — a calm, ~2/second pulse. The only thing that moves is the
+ * cyan antenna blip, so this is intentionally slow: a fast rate on a 2-pixel
+ * color change reads as a nervous flicker. */
+const FRAME_MS = 600;
 /**
- * #131 — animate Pinch (a claw-wiggle over the r6f grids) IN PLACE on STDERR
- * while a long operation runs (the `create` wizard, `--watch`). The frame is
- * redrawn every {@link FRAME_MS} via ANSI cursor moves; `stop()` clears it.
+ * #131 / #139 — show Pinch IN PLACE on STDERR while a long operation runs (the
+ * `create` wizard, `--watch`). Pinch stays a STILL `working` sprite; the ONLY
+ * animation is the cyan antenna-tip blip pulsing on/off every {@link FRAME_MS}
+ * (frame 0 = cyan, frame 1 = orange). The body — mouth, claws, eyes — never
+ * moves (the old loop cycled whole poses, which flickered "in every
+ * direction"). Redrawn via ANSI cursor moves; `stop()` clears the block.
  *
  * Contract: the CALLER must have already checked `pinchEnabled()` (TTY /
  * !NO_COLOR) and that the command is NOT `--json` — this writes only to
@@ -14,7 +19,12 @@ const FRAME_MS = 380;
  * own.
  */
 export function startPinchAnimation(statusText) {
-    const frames = WORKING_FRAMES.map((s) => renderPinchArt(s, { compact: true }));
+    // Two frames of the SAME `working` sprite — identical geometry, the antenna
+    // tips just toggle cyan↔orange. Nothing else changes between frames.
+    const frames = [
+        renderPinchArt('working', { compact: true, frame: 0 }), // cyan tips
+        renderPinchArt('working', { compact: true, frame: 1 }), // orange tips
+    ];
     const artHeight = frames[0].split('\n').length;
     const totalHeight = artHeight + 1; // + the status line below the art
     const out = process.stderr;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trawlme/cli",
-  "version": "3.4.1",
+  "version": "3.4.2",
   "description": "Trawl CLI — manage scraps from the terminal",
   "type": "module",
   "bin": {