@ai-matrx/content-ir-react 0.24.5 → 0.25.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.25.1
+### A host can word a failure's Details (G15, 2026-10-07)
+
+- `DirectiveFailureWords.details` (optional): when the host's `explainFailure` returns it, the card shows it behind "Details" instead of the raw server text — so a field reads as the form names it ("Title is required", never "name is required"). Absent → the raw text, as before.
+
+Consumer action: none required; matrx-frontend `explainDirectiveFailure` returns `details`.
+
+## 0.25.0
+### An update that changes nothing says so (G11B, 2026-10-07)
+
+- `changesNothing(changes)` (new export, `directives/item-changes`): true when an update sets no field, or every field already holds its value. Unknown current values count as a change.
+- `SideEffectDirectiveCard`: once a row reads its record, an update whose every field already holds its value shows "Nothing to change" and a muted Apply — it used to be full-weight while the confirm listed "(no change)".
+- A row's name wraps to two lines on a phone instead of being cut to one.
+
+Consumer action: a host confirm for an update can call `changesNothing(itemChanges(item, values))` to say "Nothing to change" (matrx-frontend `DirectiveConsequence` does).
+
 ## 0.24.4
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/{directive-host-QjoZEeik.d.cts → directive-host-BF9Zzfbr.d.cts}

@@ -228,6 +228,12 @@ interface DirectiveFailure {
 interface DirectiveFailureWords {
     what: string;
     next: string;
+    /**
+     * The text behind "Details", when the host words it (e.g. the server's field
+     * names read as the form labels them — "Title is required", never
+     * "name is required"). Absent → the raw text.
+     */
+    details?: string;
 }
 /** Where a directive renders — today, the conversation it sits in (if any). */
 interface DirectiveScope {

package/dist/{directive-host-QjoZEeik.d.ts → directive-host-BF9Zzfbr.d.ts}

@@ -228,6 +228,12 @@ interface DirectiveFailure {
 interface DirectiveFailureWords {
     what: string;
     next: string;
+    /**
+     * The text behind "Details", when the host words it (e.g. the server's field
+     * names read as the form labels them — "Title is required", never
+     * "name is required"). Absent → the raw text.
+     */
+    details?: string;
 }
 /** Where a directive renders — today, the conversation it sits in (if any). */
 interface DirectiveScope {

package/dist/directives.cjs

@@ -33,6 +33,7 @@ __export(directives_exports, {
   NO_TITLE_WORD: () => NO_TITLE_WORD,
   SideEffectDirectiveCard: () => SideEffectDirectiveCard,
   TARGETING_CLASSES: () => TARGETING_CLASSES,
+  changesNothing: () => changesNothing,
   defaultFailureWords: () => defaultFailureWords,
   describeChangeValue: () => describeChangeValue,
   directiveFieldLabel: () => directiveFieldLabel,
@@ -190,6 +191,9 @@ function itemChanges(item, current, options = {}) {
   }
   return out;
 }
+function changesNothing(changes) {
+  return changes.every((change) => change.same === true);
+}
 
 // directives/record-values.ts
 var import_react2 = require("react");
@@ -698,7 +702,7 @@ function ApplyDirectiveButton({
         onFocus: warm,
         disabled: view.status === "applying" || view.status === "asking" || items.length === 0,
         "data-apply-tone": muted ? "muted" : destructive ? "destructive" : "default",
-        title: muted ? "It sets no fields, so applying it changes nothing." : void 0,
+        title: muted ? "Applying it changes nothing." : void 0,
         className: `inline-flex shrink-0 items-center gap-1 whitespace-nowrap rounded-md border px-2 py-1 text-xs font-medium disabled:opacity-50 ${muted ? "border-border/60 bg-background text-muted-foreground hover:bg-accent" : destructive ? "border-destructive/50 bg-background text-destructive hover:bg-destructive/10" : "border-border bg-background hover:bg-accent"}`,
         children: [
           view.status === "applying" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PlayIcon, { className: "h-3.5 w-3.5" }),
@@ -738,7 +742,7 @@ function FailureNotice({
   raw
 }) {
   const [open, setOpen] = (0, import_react3.useState)(false);
-  const detail = raw?.trim() ?? "";
+  const detail = raw?.trim() ? words.details?.trim() || raw.trim() : "";
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "flex min-w-0 flex-col gap-0.5", "data-apply-failure": true, children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "min-w-0", children: [
       words.what,
@@ -785,12 +789,23 @@ function ItemRow({
   item,
   index,
   total,
-  phase
+  phase,
+  onNothing
 }) {
   const host = useDirectiveHost();
   const recordId = TARGETING_CLASSES.has(directive.directiveClass) ? itemRecordId(item) : null;
   if (recordId) {
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(TargetRow, { directive, item, recordId, index, phase });
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      TargetRow,
+      {
+        directive,
+        item,
+        recordId,
+        index,
+        phase,
+        onNothing
+      }
+    );
   }
   const titleColumn = (0, import_content_ir4.nounTitleColumn)(directive.noun, host.nouns);
   const ownName = itemOwnName(item, titleColumn);
@@ -809,7 +824,8 @@ function ItemRow({
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       "span",
       {
-        className: `min-w-0 shrink-0 truncate font-medium ${ownName ? "text-foreground" : "italic text-muted-foreground"}`,
+        className: `min-w-0 line-clamp-2 font-medium [overflow-wrap:anywhere] sm:shrink-0 sm:truncate ${ownName ? "text-foreground" : "italic text-muted-foreground"}`,
+        "data-item-name": "",
         "data-item-untitled": ownName ? void 0 : "",
         children: title
       }
@@ -898,7 +914,8 @@ function TargetRow({
   item,
   recordId,
   index,
-  phase
+  phase,
+  onNothing
 }) {
   const host = useDirectiveHost();
   const fallback = recordFallbackName((0, import_content_ir4.nounLabel)(directive.noun, host.nouns));
@@ -913,7 +930,11 @@ function TargetRow({
     titleColumn: (0, import_content_ir4.nounTitleColumn)(directive.noun, host.nouns),
     valueWord: directiveValueWord(host, directive.noun)
   }) : [];
-  const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "truncate font-medium text-foreground", children: fallback });
+  const nothing = readsLive && live.values !== null && changesNothing(changes);
+  (0, import_react4.useEffect)(() => {
+    onNothing?.(index, nothing);
+  }, [onNothing, index, nothing]);
+  const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "line-clamp-2 min-w-0 font-medium text-foreground [overflow-wrap:anywhere]", children: fallback });
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "py-1 text-xs", "data-directive-target": recordId, children: [
     /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "flex min-w-0 items-center gap-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "flex min-w-0 flex-1 items-center gap-1 px-1", children: name }),
@@ -937,7 +958,9 @@ function SideEffectDirectiveCard({ directive }) {
   const [phase, setPhase] = (0, import_react4.useState)(
     () => readsApplyLedger(host, directive) ? { phase: "pending" } : { phase: "open" }
   );
-  const nothingToChange = directive.directiveClass === "update" && total > 0 && items.every((item) => itemChanges(item).length === 0);
+  const [nothingAt, setNothingAt] = (0, import_react4.useState)({});
+  const noteNothing = (index, nothing) => setNothingAt((prev) => prev[index] === nothing ? prev : { ...prev, [index]: nothing });
+  const nothingToChange = directive.directiveClass === "update" && total > 0 && items.every((item, index) => itemChanges(item).length === 0 || nothingAt[index] === true);
   const shown = expanded ? items : items.slice(0, ROWS_BEFORE_FOLD);
   const hidden = total - shown.length;
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
@@ -966,7 +989,18 @@ function SideEffectDirectiveCard({ directive }) {
     total === 0 ? (
       // Stated, never silent: an empty batch is a real (and suspicious) state.
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
-    ) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ItemRow, { directive, item, index: i, total, phase }, i)) }),
+    ) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      ItemRow,
+      {
+        directive,
+        item,
+        index: i,
+        total,
+        phase,
+        onNothing: noteNothing
+      },
+      i
+    )) }),
     hidden > 0 || expanded ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
       "button",
       {