@vincemakes/kiso-tui-cells 0.12.0 → 0.13.0

package/dist/approval-panel.d.ts

@@ -63,6 +63,44 @@ export interface SaferRuntime {
  *  all still there, which is the only thing they need to know to keep
  *  going. */
 export declare const SAFER_DEGRADED = "couldn't get safer options \u2014 the original choices stand";
+/**
+ * R3v2-F1 — the same sentence, for the one failure the reply's own text
+ * can PROVE.
+ *
+ * The unqualified line is true of every failure the ask has, which is
+ * exactly why it explains nothing when the cause was knowable. A reply
+ * the token budget cut in half is knowable: the JSON opens and never
+ * closes. So that case gets the cause in a parenthesis and keeps
+ * everything else — one line, dim, still leading with what is still
+ * true — because the human is mid-approval and the shape of the sentence
+ * is what they have already learned to read.
+ */
+export declare const SAFER_DEGRADED_TRUNCATED = "couldn't get safer options (the reply was cut short) \u2014 the original choices stand";
+/**
+ * R3v2-F1 — a failure that knows why it failed.
+ *
+ * `truncated` is the only cause the caller can demonstrate from the
+ * text, and it is deliberately the only member: a diagnosis the product
+ * cannot prove is worse than no diagnosis, so every other failure stays
+ * the unqualified line rather than growing a guess.
+ */
+export interface SaferFailure {
+    readonly reason: "truncated";
+}
+/**
+ * R3v2-F1 — what the safer-options provider hands back.
+ *
+ * A list is the answer. `null` is a failure with nothing to add, and is
+ * still the whole contract for any caller that has nothing to add — the
+ * widening is additive, so an existing provider's behaviour is
+ * byte-identical. A SaferFailure is a failure that can name its cause.
+ */
+export type SaferAnswer = readonly SaferOption[] | SaferFailure | null;
+/** R3v2-F1: the line a failed ask owes the human — the unqualified one,
+ *  unless the answer named a cause. The panel asks this instead of
+ *  reaching for a constant, so the choice of sentence lives with the
+ *  sentences. */
+export declare function saferDegradedNote(answer: SaferAnswer): string;
 /** The row that returns to state 1. Rendered last, always present — an
  *  alternatives list you cannot back out of would be a trap. */
 export declare const SAFER_BACK = "back to the original choices";

package/dist/approval-panel.js

@@ -35,6 +35,27 @@ import { escapeTerminal, palette } from "./render.js";
  *  all still there, which is the only thing they need to know to keep
  *  going. */
 export const SAFER_DEGRADED = "couldn't get safer options — the original choices stand";
+/**
+ * R3v2-F1 — the same sentence, for the one failure the reply's own text
+ * can PROVE.
+ *
+ * The unqualified line is true of every failure the ask has, which is
+ * exactly why it explains nothing when the cause was knowable. A reply
+ * the token budget cut in half is knowable: the JSON opens and never
+ * closes. So that case gets the cause in a parenthesis and keeps
+ * everything else — one line, dim, still leading with what is still
+ * true — because the human is mid-approval and the shape of the sentence
+ * is what they have already learned to read.
+ */
+export const SAFER_DEGRADED_TRUNCATED = "couldn't get safer options (the reply was cut short) — the original choices stand";
+/** R3v2-F1: the line a failed ask owes the human — the unqualified one,
+ *  unless the answer named a cause. The panel asks this instead of
+ *  reaching for a constant, so the choice of sentence lives with the
+ *  sentences. */
+export function saferDegradedNote(answer) {
+    const failure = answer === null || Array.isArray(answer) ? null : answer;
+    return failure?.reason === "truncated" ? SAFER_DEGRADED_TRUNCATED : SAFER_DEGRADED;
+}
 /** The row that returns to state 1. Rendered last, always present — an
  *  alternatives list you cannot back out of would be a trap. */
 export const SAFER_BACK = "back to the original choices";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-tui-cells",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "kiso tui-cells — the components cell renderer (components, diff, width, the render slice). Zero runtime dependencies: input is data, output is bytes.",
   "type": "module",
   "license": "MIT",