@ai-matrx/content-ir-react 0.24.4 → 0.25.0

package/dist/directives.d.cts

@@ -179,6 +179,15 @@ interface ItemChangesOptions {
     valueWord?: DirectiveValueWord | null;
 }
 declare function itemChanges(item: Record<string, unknown>, current?: Record<string, unknown> | null, options?: ItemChangesOptions): ItemChange[];
+/**
+ * 🚨 AN UPDATE THAT WOULD CHANGE NOTHING SAYS SO (G11B review, 2026-10-07: the
+ * confirm listed every field "(no change)", Apply stayed full-weight, and the
+ * run ended "Updated task. Ran 2 times"). True when the item sets no field, or
+ * when the record was read and EVERY field already holds its new value. A field
+ * whose current value is unknown counts as a change — doubt never mutes Apply.
+ * ONE rule for the card and the host's confirm.
+ */
+declare function changesNothing(changes: ReadonlyArray<ItemChange>): boolean;
 
 interface SideEffectDirectiveCardProps {
     directive: DecodedDirective;
@@ -278,4 +287,4 @@ declare function noteRecordChanged(id: string): void;
 declare function useRecordRevision(id: string): number;
 declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, type ItemChange, type ItemChangesOptions, NO_TITLE_WORD, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, type ItemChange, type ItemChangesOptions, NO_TITLE_WORD, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, changesNothing, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };

package/dist/directives.d.ts

@@ -179,6 +179,15 @@ interface ItemChangesOptions {
     valueWord?: DirectiveValueWord | null;
 }
 declare function itemChanges(item: Record<string, unknown>, current?: Record<string, unknown> | null, options?: ItemChangesOptions): ItemChange[];
+/**
+ * 🚨 AN UPDATE THAT WOULD CHANGE NOTHING SAYS SO (G11B review, 2026-10-07: the
+ * confirm listed every field "(no change)", Apply stayed full-weight, and the
+ * run ended "Updated task. Ran 2 times"). True when the item sets no field, or
+ * when the record was read and EVERY field already holds its new value. A field
+ * whose current value is unknown counts as a change — doubt never mutes Apply.
+ * ONE rule for the card and the host's confirm.
+ */
+declare function changesNothing(changes: ReadonlyArray<ItemChange>): boolean;
 
 interface SideEffectDirectiveCardProps {
     directive: DecodedDirective;
@@ -278,4 +287,4 @@ declare function noteRecordChanged(id: string): void;
 declare function useRecordRevision(id: string): number;
 declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, type ItemChange, type ItemChangesOptions, NO_TITLE_WORD, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, type ItemChange, type ItemChangesOptions, NO_TITLE_WORD, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, changesNothing, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };

package/dist/directives.js

@@ -135,6 +135,9 @@ function itemChanges(item, current, options = {}) {
   }
   return out;
 }
+function changesNothing(changes) {
+  return changes.every((change) => change.same === true);
+}
 
 // directives/record-values.ts
 import { useEffect, useState, useSyncExternalStore } from "react";
@@ -643,7 +646,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__ */ jsx3(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ jsx3(PlayIcon, { className: "h-3.5 w-3.5" }),
@@ -713,7 +716,7 @@ function FailureNotice({
 }
 
 // directives/SideEffectDirectiveCard.tsx
-import { useState as useState3 } from "react";
+import { useEffect as useEffect3, useState as useState3 } from "react";
 import {
   asKindInstance,
   directiveDisplay,
@@ -737,12 +740,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__ */ jsx4(TargetRow, { directive, item, recordId, index, phase });
+    return /* @__PURE__ */ jsx4(
+      TargetRow,
+      {
+        directive,
+        item,
+        recordId,
+        index,
+        phase,
+        onNothing
+      }
+    );
   }
   const titleColumn = nounTitleColumn(directive.noun, host.nouns);
   const ownName = itemOwnName(item, titleColumn);
@@ -761,7 +775,8 @@ function ItemRow({
     /* @__PURE__ */ jsx4(
       "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
       }
@@ -850,7 +865,8 @@ function TargetRow({
   item,
   recordId,
   index,
-  phase
+  phase,
+  onNothing
 }) {
   const host = useDirectiveHost();
   const fallback = recordFallbackName(nounLabel2(directive.noun, host.nouns));
@@ -865,7 +881,11 @@ function TargetRow({
     titleColumn: 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__ */ jsx4("span", { className: "truncate font-medium text-foreground", children: fallback });
+  const nothing = readsLive && live.values !== null && changesNothing(changes);
+  useEffect3(() => {
+    onNothing?.(index, nothing);
+  }, [onNothing, index, nothing]);
+  const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ jsx4("span", { className: "line-clamp-2 min-w-0 font-medium text-foreground [overflow-wrap:anywhere]", children: fallback });
   return /* @__PURE__ */ jsxs3("div", { className: "py-1 text-xs", "data-directive-target": recordId, children: [
     /* @__PURE__ */ jsxs3("div", { className: "flex min-w-0 items-center gap-2", children: [
       /* @__PURE__ */ jsx4("span", { className: "flex min-w-0 flex-1 items-center gap-1 px-1", children: name }),
@@ -889,7 +909,9 @@ function SideEffectDirectiveCard({ directive }) {
   const [phase, setPhase] = useState3(
     () => readsApplyLedger(host, directive) ? { phase: "pending" } : { phase: "open" }
   );
-  const nothingToChange = directive.directiveClass === "update" && total > 0 && items.every((item) => itemChanges(item).length === 0);
+  const [nothingAt, setNothingAt] = useState3({});
+  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__ */ jsxs3("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
@@ -918,7 +940,18 @@ function SideEffectDirectiveCard({ directive }) {
     total === 0 ? (
       // Stated, never silent: an empty batch is a real (and suspicious) state.
       /* @__PURE__ */ jsx4("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
-    ) : /* @__PURE__ */ jsx4("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx4(ItemRow, { directive, item, index: i, total, phase }, i)) }),
+    ) : /* @__PURE__ */ jsx4("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx4(
+      ItemRow,
+      {
+        directive,
+        item,
+        index: i,
+        total,
+        phase,
+        onNothing: noteNothing
+      },
+      i
+    )) }),
     hidden > 0 || expanded ? /* @__PURE__ */ jsxs3(
       "button",
       {
@@ -1055,6 +1088,7 @@ export {
   NO_TITLE_WORD,
   SideEffectDirectiveCard,
   TARGETING_CLASSES,
+  changesNothing,
   defaultFailureWords,
   describeChangeValue,
   directiveFieldLabel,