@vincemakes/kiso-tui 0.24.0 → 0.24.1

package/dist/compositor.js

@@ -3119,6 +3119,8 @@ export class Body {
     }
     /** Invariant ①: every emitted line fits the width — a violation is a
      *  CRASH with the diagnostic, never a silent truncate. */
+    /** DC-48 — the field cut is announced ONCE per session. */
+    #cutOnce = false;
     #checked(line, W) {
         // Invariant ①b (R3f): a ROW IS ONE PHYSICAL ROW.
         //
@@ -3148,7 +3150,26 @@ export class Body {
         }
         const w = visibleWidth(line);
         if (w > W) {
-            throw new Error(`kiso-tui invariant ① violated: a line of visible width ${w} > ${W} was about to be emitted — ${JSON.stringify(line.slice(0, 80))}`);
+            // DECLARED REVERSAL of "the crash is the contract, not a
+            // symptom" — owner-lane ruling 2026-09-04, after the SECOND
+            // instance of this class in two days: DC-45 in a gate, DC-48 in
+            // the owner's hands. Under test the crash is exactly right and
+            // keeps every tooth; in the field it costs a human the
+            // composer's contents and the whole session, to save them a row
+            // that is one column too wide.
+            //
+            // So: THROW UNDER TEST, CUT IN THE FIELD, and say so. The
+            // notice is once per session — a defect worth reporting is
+            // worth saying once, and a row-by-row complaint on a resize
+            // storm would be its own defect.
+            const why = `kiso-tui invariant ① violated: a line of visible width ${w} > ${W} was about to be emitted — ${JSON.stringify(line.slice(0, 80))}`;
+            if (process.env.KISO_INVARIANTS === "throw")
+                throw new Error(why);
+            if (!this.#cutOnce) {
+                this.#cutOnce = true;
+                queueMicrotask(() => this.notice("kiso-tui: a row was cut to width (invariant ①) · please report"));
+            }
+            return cutLine(line, W);
         }
         return line;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.24.0",
+	"version": "0.24.1",
 	"description": "kiso tui — the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.24.0"
+		"@vincemakes/kiso-tui-cells": "0.24.1"
 	}
 }