@ai-matrx/content-ir-react 0.17.0 → 0.18.0

package/dist/react.d.cts

@@ -1,9 +1,9 @@
-import { c as KindDefinitionSource, C as ContentIrHost } from './host-types-Dxzs0C3f.cjs';
-import { d as ComponentResolutionSource } from './component-resolution.types-C1MzCf2s.cjs';
+import { c as KindDefinitionSource, C as ContentIrHost } from './host-types-YP_l_Q_t.cjs';
+import { d as ComponentResolutionSource } from './component-resolution.types-DwKSF64x.cjs';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-BOML4BQ7.cjs';
+import './directive-host-Bw2_PrgL.cjs';
 
 /**
  * The two registries this hook watches. Passed explicitly by a host whose
@@ -87,7 +87,7 @@ declare function KindInstanceRender(props: KindInstanceRenderProps): react.JSX.E
 /**
  * The safety net + the "still arriving" affordance for a provisional kind
  * render (streaming partial kinds — see `route/partial-kind-route.ts` and
- * `common-docs/systems/content-ir-system/STREAMING_PARTIAL_KINDS.md`).
+ * `common-docs/systems/architecture/content-ir/STREAMING_PARTIAL_KINDS.md`).
  *
  * TWO JOBS
  * --------

package/dist/react.d.ts

@@ -1,9 +1,9 @@
-import { c as KindDefinitionSource, C as ContentIrHost } from './host-types-uKO1zZo3.js';
-import { d as ComponentResolutionSource } from './component-resolution.types-C1MzCf2s.js';
+import { c as KindDefinitionSource, C as ContentIrHost } from './host-types-eSjFmXyF.js';
+import { d as ComponentResolutionSource } from './component-resolution.types-DwKSF64x.js';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-BOML4BQ7.js';
+import './directive-host-Bw2_PrgL.js';
 
 /**
  * The two registries this hook watches. Passed explicitly by a host whose
@@ -87,7 +87,7 @@ declare function KindInstanceRender(props: KindInstanceRenderProps): react.JSX.E
 /**
  * The safety net + the "still arriving" affordance for a provisional kind
  * render (streaming partial kinds — see `route/partial-kind-route.ts` and
- * `common-docs/systems/content-ir-system/STREAMING_PARTIAL_KINDS.md`).
+ * `common-docs/systems/architecture/content-ir/STREAMING_PARTIAL_KINDS.md`).
  *
  * TWO JOBS
  * --------

package/dist/react.js

@@ -291,17 +291,22 @@ function classIcon(directiveClass, noun) {
 import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
 var FINISH_POLL_MS = 2e3;
 var FINISH_POLLS_MAX = 30;
+function readsApplyLedger(host, directive) {
+  return !!host.applyState && !!host.confirm && directive.parsed.executes && directive.items.length > 0;
+}
 function ApplyDirectiveButton({
   directive,
   label = "Apply",
   itemCount,
-  onApplied
+  onApplied,
+  onPhase,
+  nothingToChange = false
 }) {
   const host = useDirectiveHost();
   const scope = useDirectiveScope();
   const conversationId = scope.conversationId || void 0;
   const items = directive.items;
-  const readsLedger = !!host.applyState && !!host.confirm && directive.parsed.executes && items.length > 0;
+  const readsLedger = readsApplyLedger(host, directive);
   const initial = readsLedger ? { status: "checking" } : { status: "idle" };
   const [state, setState] = useState(initial);
   const [elapsed, setElapsed] = useState(0);
@@ -342,7 +347,8 @@ function ApplyDirectiveButton({
               failed: 0,
               message: answer.message?.trim() ? answer.message.trim() : null,
               records: answer.records ?? [],
-              copies: Math.max(1, answer.copies ?? 1)
+              copies: Math.max(1, answer.copies ?? 1),
+              before: answer.before ?? null
             } : prev
           );
         } else if (answer.state === "in_flight" && polls < FINISH_POLLS_MAX) {
@@ -367,6 +373,15 @@ function ApplyDirectiveButton({
       if (timer) clearTimeout(timer);
     };
   }, [shellKey, read, report]);
+  const appliedClean = state.status === "applied" && state.failed === 0 ? state : null;
+  const appliedBefore = appliedClean ? appliedClean.before : null;
+  const phaseKey = state.status === "checking" || state.status === "finishing" ? "pending" : appliedClean ? `applied:${JSON.stringify(appliedBefore)}` : "open";
+  useEffect(() => {
+    if (!onPhase) return;
+    if (phaseKey === "pending") onPhase({ phase: "pending" });
+    else if (phaseKey === "open") onPhase({ phase: "open" });
+    else onPhase({ phase: "applied", before: appliedBefore });
+  }, [phaseKey, onPhase, appliedBefore]);
   useEffect(() => {
     if (state.status !== "applying") return;
     startedAt.current = Date.now();
@@ -381,7 +396,7 @@ function ApplyDirectiveButton({
   if (!confirm) return null;
   async function handleApply(again = false) {
     if (!confirm) return;
-    const before = state;
+    const prior = state;
     const askedFor = identity;
     const stillHere = () => currentIdentity.current === askedFor;
     const priorCopies = state.status === "applied" ? state.copies : 0;
@@ -408,7 +423,7 @@ function ApplyDirectiveButton({
       if (!stillHere()) return;
       setAskingAgain(false);
       if (!ok) {
-        setState(again ? before : { status: "idle" });
+        setState(again ? prior : { status: "idle" });
         return;
       }
     }
@@ -427,7 +442,10 @@ function ApplyDirectiveButton({
         message: result.message?.trim() ? result.message.trim() : null,
         records: result.records ?? [],
         // "Run again" made one more; a first apply (or a replay of one) is one.
-        copies: again ? Math.max(1, priorCopies) + 1 : Math.max(1, priorCopies)
+        copies: again ? Math.max(1, priorCopies) + 1 : Math.max(1, priorCopies),
+        // "Run again" wrote the same values over themselves; what the FIRST
+        // apply replaced is still the change this block made.
+        before: again && prior.status === "applied" && prior.before ? prior.before : result.before ?? null
       });
       onApplied?.();
     } catch (error) {
@@ -529,15 +547,18 @@ function ApplyDirectiveButton({
     );
   }
   const destructive = directive.directiveClass === "delete";
+  const muted = nothingToChange && state.status === "idle";
   return /* @__PURE__ */ jsxs2("span", { className: "inline-flex items-center gap-2", children: [
+    muted ? /* @__PURE__ */ jsx4("span", { className: "text-xs text-muted-foreground", "data-apply-nothing": "", children: "Nothing to change" }) : null,
     /* @__PURE__ */ jsxs2(
       "button",
       {
         type: "button",
         onClick: () => void handleApply(),
         disabled: state.status === "applying" || state.status === "asking" || items.length === 0,
-        "data-apply-tone": destructive ? "destructive" : "default",
-        className: `inline-flex items-center gap-1 rounded-md border px-2 py-1 text-xs font-medium disabled:opacity-50 ${destructive ? "border-destructive/50 bg-background text-destructive hover:bg-destructive/10" : "border-border bg-background hover:bg-accent"}`,
+        "data-apply-tone": muted ? "muted" : destructive ? "destructive" : "default",
+        title: muted ? "It sets no fields, so applying it changes nothing." : void 0,
+        className: `inline-flex items-center gap-1 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: [
           state.status === "applying" ? /* @__PURE__ */ jsx4(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ jsx4(PlayIcon, { className: "h-3.5 w-3.5" }),
           state.status === "applying" ? `Applying${itemCount ? ` ${itemCount} ${itemCount === 1 ? "item" : "items"}` : ""}\u2026${elapsed ? ` ${elapsed}s` : ""}` : label
@@ -735,12 +756,13 @@ function ItemRow({
   directive,
   item,
   index,
-  total
+  total,
+  phase
 }) {
   const host = useDirectiveHost();
   const recordId = TARGETING_CLASSES.has(directive.directiveClass) ? itemRecordId(item) : null;
   if (recordId) {
-    return /* @__PURE__ */ jsx7(TargetRow, { directive, item, recordId });
+    return /* @__PURE__ */ jsx7(TargetRow, { directive, item, recordId, index, phase });
   }
   const titleColumn = nounTitleColumn(directive.noun, host.nouns);
   const title = itemTitle(item, titleColumn, index, total);
@@ -827,16 +849,20 @@ function DirectiveChangeList({
 function TargetRow({
   directive,
   item,
-  recordId
+  recordId,
+  index,
+  phase
 }) {
   const host = useDirectiveHost();
   const fallback = recordFallbackName(nounLabel2(directive.noun, host.nouns), recordId);
   const isUpdate = directive.directiveClass === "update";
-  const current = useRecordValues(
-    isUpdate ? host.readRecord : void 0,
-    isUpdate ? { noun: directive.noun, id: recordId } : null
+  const readsLive = isUpdate && phase.phase === "open";
+  const live = useRecordValues(
+    readsLive ? host.readRecord : void 0,
+    readsLive ? { noun: directive.noun, id: recordId } : null
   );
-  const changes = isUpdate ? itemChanges(item, current.values, { titleColumn: nounTitleColumn(directive.noun, host.nouns) }) : [];
+  const compareTo = phase.phase === "applied" ? phase.before?.[index] ?? null : readsLive ? live.values : null;
+  const changes = isUpdate ? itemChanges(item, compareTo, { titleColumn: nounTitleColumn(directive.noun, host.nouns) }) : [];
   const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ jsx7("span", { className: "truncate font-medium text-foreground", children: fallback });
   return /* @__PURE__ */ jsxs5("div", { className: "py-1 text-xs", "data-directive-target": recordId, children: [
     /* @__PURE__ */ jsxs5("div", { className: "flex min-w-0 items-center gap-2", children: [
@@ -853,6 +879,10 @@ function SideEffectDirectiveCard({ directive }) {
   const total = items.length;
   const display = directiveDisplay3(directive.directiveClass, directive.noun, host.nouns);
   const Icon = classIcon(directive.directiveClass, directive.noun);
+  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 shown = expanded ? items : items.slice(0, ROWS_BEFORE_FOLD);
   const hidden = total - shown.length;
   return /* @__PURE__ */ jsxs5("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
@@ -867,13 +897,21 @@ function SideEffectDirectiveCard({ directive }) {
       ] }),
       /* @__PURE__ */ jsxs5("div", { className: "ml-auto flex items-center gap-1", children: [
         host.renderCopy?.({ label: display.title, value: directive.shell, size: "icon" }),
-        /* @__PURE__ */ jsx7(ApplyDirectiveButton, { directive, itemCount: total })
+        /* @__PURE__ */ jsx7(
+          ApplyDirectiveButton,
+          {
+            directive,
+            itemCount: total,
+            onPhase: setPhase,
+            nothingToChange
+          }
+        )
       ] })
     ] }),
     total === 0 ? (
       // Stated, never silent: an empty batch is a real (and suspicious) state.
       /* @__PURE__ */ jsx7("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
-    ) : /* @__PURE__ */ jsx7("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx7(ItemRow, { directive, item, index: i, total }, i)) }),
+    ) : /* @__PURE__ */ jsx7("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx7(ItemRow, { directive, item, index: i, total, phase }, i)) }),
     hidden > 0 || expanded ? /* @__PURE__ */ jsxs5(
       "button",
       {