@ai-matrx/content-ir-react 0.18.1 → 0.19.1

package/dist/index.d.cts

@@ -428,6 +428,15 @@ interface RecordValues {
     status: RecordValuesStatus;
 }
 type RecordReader = (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
+/** How many times this page has changed record `id` (0 = never). */
+declare function recordRevision(id: string): number;
+/**
+ * Record `id` just changed (an apply wrote it, or any other writer on the page).
+ * Every `useRecordValues` naming it reads it again.
+ */
+declare function noteRecordChanged(id: string): void;
+/** The live revision of record `id`, re-rendering when it changes. */
+declare function useRecordRevision(id: string): number;
 declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
 /**
@@ -693,4 +702,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, defaultFailureWords, describeChangeValue, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordValues };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, defaultFailureWords, describeChangeValue, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, useRecordValues };

package/dist/index.d.ts

@@ -428,6 +428,15 @@ interface RecordValues {
     status: RecordValuesStatus;
 }
 type RecordReader = (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
+/** How many times this page has changed record `id` (0 = never). */
+declare function recordRevision(id: string): number;
+/**
+ * Record `id` just changed (an apply wrote it, or any other writer on the page).
+ * Every `useRecordValues` naming it reads it again.
+ */
+declare function noteRecordChanged(id: string): void;
+/** The live revision of record `id`, re-rendering when it changes. */
+declare function useRecordRevision(id: string): number;
 declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
 /**
@@ -693,4 +702,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, defaultFailureWords, describeChangeValue, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordValues };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, type DirectiveApplyPhase, DirectiveChangeList, DirectiveFailure, DirectiveFailureWords, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, defaultFailureWords, describeChangeValue, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, useRecordValues };

package/dist/index.js

@@ -268,8 +268,8 @@ var ComponentResolver = class {
   }
   bumpKind(kind) {
     this.kindVersions.set(kind, (this.kindVersions.get(kind) ?? 0) + 1);
-    const listeners = this.kindListeners.get(kind);
-    if (listeners) for (const listener of listeners) listener();
+    const listeners2 = this.kindListeners.get(kind);
+    if (listeners2) for (const listener of listeners2) listener();
   }
   notifyChanged() {
     this.version += 1;
@@ -753,7 +753,7 @@ import { looksLikeDirectiveHead, tryDecodeDirectiveContent } from "@ai-matrx/con
 import { directiveDisplay } from "@ai-matrx/content-ir";
 
 // directives/ApplyDirectiveButton.tsx
-import { useEffect, useRef, useState, useSyncExternalStore as useSyncExternalStore2 } from "react";
+import { useEffect as useEffect2, useRef, useState as useState2, useSyncExternalStore as useSyncExternalStore3 } from "react";
 import { nounLabel } from "@ai-matrx/content-ir";
 
 // directives/item-changes.ts
@@ -832,6 +832,73 @@ function itemChanges(item, current, options = {}) {
   return out;
 }
 
+// directives/record-values.ts
+import { useEffect, useState, useSyncExternalStore as useSyncExternalStore2 } from "react";
+var STORE_SLOT = /* @__PURE__ */ Symbol.for("@ai-matrx/content-ir-react/record-revisions");
+function revisionStore() {
+  const slots = globalThis;
+  let store = slots[STORE_SLOT];
+  if (!store) {
+    store = { revisions: /* @__PURE__ */ new Map(), listeners: /* @__PURE__ */ new Set() };
+    slots[STORE_SLOT] = store;
+  }
+  return store;
+}
+var { revisions, listeners } = revisionStore();
+function recordRevision(id) {
+  return revisions.get(id) ?? 0;
+}
+function noteRecordChanged(id) {
+  if (!id) return;
+  revisions.set(id, recordRevision(id) + 1);
+  for (const listener of listeners) listener();
+}
+function subscribeRevisions(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function useRecordRevision(id) {
+  return useSyncExternalStore2(
+    subscribeRevisions,
+    () => recordRevision(id),
+    () => 0
+  );
+}
+function useRecordValues(read, ref) {
+  const revision = useRecordRevision(ref?.id ?? "");
+  const key = ref && read ? `${ref.noun}:${ref.id}#${revision}` : "";
+  const [result, setResult] = useState({
+    key: "",
+    values: null,
+    status: "idle"
+  });
+  useEffect(() => {
+    if (!key || !read) return;
+    const split = key.indexOf(":");
+    const target = {
+      noun: key.slice(0, split),
+      id: key.slice(split + 1, key.lastIndexOf("#"))
+    };
+    let live = true;
+    setResult({ key, values: null, status: "loading" });
+    read(target).then((values) => {
+      if (!live) return;
+      setResult({ key, values, status: values ? "ready" : "unavailable" });
+    }).catch(() => {
+      if (!live) return;
+      setResult({ key, values: null, status: "unavailable" });
+    });
+    return () => {
+      live = false;
+    };
+  }, [key, read]);
+  if (!key) return { values: null, status: "idle" };
+  if (result.key !== key) return { values: null, status: "loading" };
+  return { values: result.values, status: result.status };
+}
+
 // directives/failure-words.ts
 var PAST = {
   create: "created",
@@ -951,6 +1018,13 @@ function classIcon(directiveClass, noun) {
 
 // directives/ApplyDirectiveButton.tsx
 import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
+function announceChangedRecords(directive, items) {
+  if (!TARGETING_CLASSES.has(directive.directiveClass)) return;
+  for (const item of items) {
+    const id = itemRecordId(item);
+    if (id) noteRecordChanged(id);
+  }
+}
 var applyOutcomes = /* @__PURE__ */ new WeakMap();
 var EMPTY_AUTHORITY = {};
 var outcomeListeners = /* @__PURE__ */ new Set();
@@ -973,7 +1047,7 @@ function subscribeOutcomes(listener) {
   };
 }
 function useApplyOutcome(host, identity) {
-  return useSyncExternalStore2(
+  return useSyncExternalStore3(
     subscribeOutcomes,
     () => applyOutcomes.get(host)?.get(identity) ?? null,
     () => null
@@ -998,12 +1072,12 @@ function ApplyDirectiveButton({
   const items = directive.items;
   const readsLedger = readsApplyLedger(host, directive);
   const initial = readsLedger ? { status: "checking" } : { status: "idle" };
-  const [state, setState] = useState(initial);
-  const [elapsed, setElapsed] = useState(0);
-  const [askingAgain, setAskingAgain] = useState(false);
+  const [state, setState] = useState2(initial);
+  const [elapsed, setElapsed] = useState2(0);
+  const [askingAgain, setAskingAgain] = useState2(false);
   const startedAt = useRef(null);
   const identity = JSON.stringify([directive.slug, items, conversationId ?? null]);
-  const [stateFor, setStateFor] = useState(identity);
+  const [stateFor, setStateFor] = useState2(identity);
   if (stateFor !== identity) {
     setStateFor(identity);
     setState(initial);
@@ -1013,14 +1087,14 @@ function ApplyDirectiveButton({
   const shared = useApplyOutcome(host.confirm ?? EMPTY_AUTHORITY, identity);
   const view = state.status === "asking" || !shared ? state : shared;
   const currentIdentity = useRef(identity);
-  useEffect(() => {
+  useEffect2(() => {
     currentIdentity.current = identity;
   }, [identity]);
   const nounText = nounLabel(directive.noun, host.nouns);
   const shellKey = readsLedger ? JSON.stringify([directive.slug, items, conversationId ?? null]) : "";
   const read = host.applyState;
   const report = host.reportError;
-  useEffect(() => {
+  useEffect2(() => {
     if (!shellKey || !read) return;
     const [slug, shellItems, inConversation] = JSON.parse(shellKey);
     const shell = { __kind: slug, items: shellItems };
@@ -1068,14 +1142,14 @@ function ApplyDirectiveButton({
   const appliedClean = view.status === "applied" && view.failed === 0 ? view : null;
   const appliedBefore = appliedClean ? appliedClean.before : null;
   const phaseKey = view.status === "checking" || view.status === "finishing" ? "pending" : appliedClean ? `applied:${JSON.stringify(appliedBefore)}` : "open";
-  useEffect(() => {
+  useEffect2(() => {
     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]);
   const applyingSince = view.status === "applying" ? view.startedAt : null;
-  useEffect(() => {
+  useEffect2(() => {
     if (applyingSince === null) return;
     startedAt.current = applyingSince;
     const id = setInterval(
@@ -1127,7 +1201,13 @@ function ApplyDirectiveButton({
       const shell = { __kind: directive.slug, items };
       if (conversationId) shell.conversationId = conversationId;
       if (again) shell.force = true;
-      const result = await confirm(shell);
+      let result;
+      try {
+        result = await confirm(shell);
+      } finally {
+        announceChangedRecords(directive, items);
+      }
+      for (const record of result.records ?? []) noteRecordChanged(record.id);
       publishOutcome(confirm, askedFor, {
         status: "applied",
         applied: result.applied,
@@ -1288,7 +1368,7 @@ function FailureNotice({
   words,
   raw
 }) {
-  const [open, setOpen] = useState(false);
+  const [open, setOpen] = useState2(false);
   const detail = raw?.trim() ?? "";
   return /* @__PURE__ */ jsxs2("span", { className: "flex min-w-0 flex-col gap-0.5", "data-apply-failure": true, children: [
     /* @__PURE__ */ jsxs2("span", { className: "min-w-0", children: [
@@ -1417,39 +1497,6 @@ import {
   nounLabel as nounLabel2,
   nounTitleColumn
 } from "@ai-matrx/content-ir";
-
-// directives/record-values.ts
-import { useEffect as useEffect2, useState as useState2 } from "react";
-function useRecordValues(read, ref) {
-  const key = ref && read ? `${ref.noun}:${ref.id}` : "";
-  const [result, setResult] = useState2({
-    key: "",
-    values: null,
-    status: "idle"
-  });
-  useEffect2(() => {
-    if (!key || !read) return;
-    const split = key.indexOf(":");
-    const target = { noun: key.slice(0, split), id: key.slice(split + 1) };
-    let live = true;
-    setResult({ key, values: null, status: "loading" });
-    read(target).then((values) => {
-      if (!live) return;
-      setResult({ key, values, status: values ? "ready" : "unavailable" });
-    }).catch(() => {
-      if (!live) return;
-      setResult({ key, values: null, status: "unavailable" });
-    });
-    return () => {
-      live = false;
-    };
-  }, [key, read]);
-  if (!key) return { values: null, status: "idle" };
-  if (result.key !== key) return { values: null, status: "loading" };
-  return { values: result.values, status: result.status };
-}
-
-// directives/SideEffectDirectiveCard.tsx
 import { Fragment, jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var ROWS_BEFORE_FOLD = 3;
 function ItemRow({
@@ -2137,10 +2184,12 @@ export {
   kindIsRoutable,
   kindServerDataFromStoredValue,
   markKindPartialUnsafe,
+  noteRecordChanged,
   provisionalDirectiveSlug,
   readIrRouteMarker,
   readsApplyLedger,
   recordFallbackName,
+  recordRevision,
   registerDirectiveRenderer,
   resetDirectiveRenderers,
   resetPartialUnsafeKinds,
@@ -2155,6 +2204,7 @@ export {
   useDirectiveHost,
   useDirectiveScope,
   useKindRouteEnv,
+  useRecordRevision,
   useRecordValues
 };
 //# sourceMappingURL=index.js.map