@trawlme/cli 3.4.0 → 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

@@ -60,10 +60,12 @@ export const PINCH_STATES = [
  *   row 1  head top      (+ claw at col 0/8 when RAISED)
  *   row 2  eyes          (+ claw at col 0/8 when RAISED)
  *   row 3  head mid
- *   row 4  mouth + blush  (+ claw at col 0/8 when RESTING)
- *   row 5  head bottom    (+ claw at col 0/8 when RESTING)
+ *   row 4  mouth corners + blush  (+ claw at col 0/8 when RESTING)
+ *   row 5  head bottom + mouth center  (+ claw at col 0/8 when RESTING)
  * Claws are the 1-wide 2-tall O blocks at cols 0/8. Eyes: left = W+K at
- * cols 2-3, right = K+W at cols 5-6 (pupils inward).
+ * cols 2-3, right = K+W at cols 5-6 (pupils inward). The smile is a U (like
+ * the source 3D / AVGRID): the mouth CORNERS sit on row 4 and the CENTER
+ * dips to row 5 — never a flat single-row bar (#137).
  */
 const GRIDS = {
     // calm resting face, both claws down, normal smile.
@@ -72,8 +74,8 @@ const GRIDS = {
         '.BBBBBBB.',
         '.BWKBKWB.',
         '.BBBBBBB.',
-        'OBPKKKPBO',
-        'OBBBBBBBO',
+        'OBPKBKPBO',
+        'OBBBKBBBO',
     ],
     // idle pose + the cyan thinking-blip on the antenna tips (frame-toggled in
     // `gridForState`) — the only animated static state.
@@ -82,8 +84,8 @@ const GRIDS = {
         '.BBBBBBB.',
         '.BWKBKWB.',
         '.BBBBBBB.',
-        'OBPKKKPBO',
-        'OBBBBBBBO',
+        'OBPKBKPBO',
+        'OBBBKBBBO',
     ],
     // both claws raised (rows 1-2) + a big open mouth.
     celebrating: [
@@ -91,8 +93,8 @@ const GRIDS = {
         'OBBBBBBBO',
         'OBWKBKWBO',
         '.BBBBBBB.',
-        '.BKKKKKB.',
-        '.BBBBBBB.',
+        '.BKBBBKB.',
+        '.BBKKKBB.',
     ],
     // right claw raised (rows 1-2) + a thumb pixel poking up above it (row 0,
     // col 8); left claw resting.
@@ -101,8 +103,8 @@ const GRIDS = {
         '.BBBBBBBO',
         '.BWKBKWBO',
         '.BBBBBBB.',
-        'OBPKKKPB.',
-        'OBBBBBBB.',
+        'OBPKBKPB.',
+        'OBBBKBBB.',
     ],
     // antennae drooped + spread, flat mouth (no K), claws resting. A '?' is
     // appended beside the eye line by `renderPinch`.
@@ -120,8 +122,8 @@ const GRIDS = {
         '.BBBBBBBO',
         '.BWKBKWBO',
         '.BBBBBBB.',
-        'OBPKKKPB.',
-        'OBBBBBBB.',
+        'OBPKBKPB.',
+        'OBBBKBBB.',
     ],
     // pink heart-eyes (P replaces the W+K pupils), claws resting, normal smile.
     heart: [
@@ -129,8 +131,8 @@ const GRIDS = {
         '.BBBBBBB.',
         '.BPPBPPB.',
         '.BBBBBBB.',
-        'OBPKKKPBO',
-        'OBBBBBBBO',
+        'OBPKBKPBO',
+        'OBBBKBBBO',
     ],
     // closed eyes (flat K line, no white), antennae drooped + spread, flat
     // mouth, claws resting — like confused but eyes shut and no '?'.
@@ -245,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;
@@ -266,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.0",
+  "version": "3.4.2",
   "description": "Trawl CLI — manage scraps from the terminal",
   "type": "module",
   "bin": {