@ai-matrx/content-ir-react 0.20.1 → 0.21.0

package/dist/directives.d.cts

@@ -119,10 +119,25 @@ declare function directiveFieldLabel(key: string, titleColumn: string | null | u
  * fields; null → the value as stored.
  */
 type DirectiveValueWord = (field: string, value: string) => string | null;
+/**
+ * The name a NEW item carries, or null when it has none — the one rule the card
+ * and a host's confirm share. `itemTitle`'s last resort ("Item", "Item 2 of 3")
+ * is a placeholder, never a name: a create with an empty title used to ask
+ * "Create project Item?" and its card row read "Item" (G10B review, 2026-10-02).
+ */
+declare function itemOwnName(item: Record<string, unknown>, titleColumn: string | null): string | null;
+/** What a nameless new item is called — said as such, never a placeholder name. */
+declare const NO_TITLE_WORD = "No title";
 /** How an empty value reads — before or after, on the card and in the confirm. */
 declare const EMPTY_VALUE_WORD = "None";
-/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
-declare function recordFallbackName(nounLabel: string, id: string): string;
+/**
+ * What a record is called when its name cannot be read: its TYPE ("Task").
+ * Never its id, in any slot — text, tooltip or screen-reader label. It used to
+ * be "Task a8a00001", and a link to a record that no longer exists hovered
+ * "Open Task a8a00001" (G10B review, 2026-10-02). The host says WHY the name is
+ * missing (not found, no access) beside it.
+ */
+declare function recordFallbackName(nounLabel: string): string;
 /** One value as a row reads it: shortened, the whole of it, and whether it is empty. */
 interface ChangeValue {
     value: string;
@@ -263,4 +278,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, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, 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, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };

package/dist/directives.d.ts

@@ -119,10 +119,25 @@ declare function directiveFieldLabel(key: string, titleColumn: string | null | u
  * fields; null → the value as stored.
  */
 type DirectiveValueWord = (field: string, value: string) => string | null;
+/**
+ * The name a NEW item carries, or null when it has none — the one rule the card
+ * and a host's confirm share. `itemTitle`'s last resort ("Item", "Item 2 of 3")
+ * is a placeholder, never a name: a create with an empty title used to ask
+ * "Create project Item?" and its card row read "Item" (G10B review, 2026-10-02).
+ */
+declare function itemOwnName(item: Record<string, unknown>, titleColumn: string | null): string | null;
+/** What a nameless new item is called — said as such, never a placeholder name. */
+declare const NO_TITLE_WORD = "No title";
 /** How an empty value reads — before or after, on the card and in the confirm. */
 declare const EMPTY_VALUE_WORD = "None";
-/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
-declare function recordFallbackName(nounLabel: string, id: string): string;
+/**
+ * What a record is called when its name cannot be read: its TYPE ("Task").
+ * Never its id, in any slot — text, tooltip or screen-reader label. It used to
+ * be "Task a8a00001", and a link to a record that no longer exists hovered
+ * "Open Task a8a00001" (G10B review, 2026-10-02). The host says WHY the name is
+ * missing (not found, no access) beside it.
+ */
+declare function recordFallbackName(nounLabel: string): string;
 /** One value as a row reads it: shortened, the whole of it, and whether it is empty. */
 interface ChangeValue {
     value: string;
@@ -263,4 +278,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, type RecordReader, type RecordValues, type RecordValuesStatus, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, 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, defaultFailureWords, describeChangeValue, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, itemChanges, itemOwnName, itemRecordId, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useRecordRevision, useRecordValues };

package/dist/directives.js

@@ -48,8 +48,8 @@ import { useEffect as useEffect2, useRef, useState as useState2, useSyncExternal
 import { nounLabel } from "@ai-matrx/content-ir";
 
 // directives/item-changes.ts
-import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
+import { itemTitle } from "@ai-matrx/content-ir";
 var TARGETING_CLASSES = /* @__PURE__ */ new Set(["update", "delete"]);
 var NOT_A_CHANGE = /* @__PURE__ */ new Set(["__kind", "id"]);
 var CHANGE_VALUE_MAX = 280;
@@ -65,10 +65,14 @@ function fieldLabel(key) {
 function directiveFieldLabel(key, titleColumn) {
   return titleColumn && key === titleColumn ? "Title" : fieldLabel(key);
 }
+function itemOwnName(item, titleColumn) {
+  const probe = itemTitle(item, titleColumn, 0, 2);
+  return probe === "Item 1 of 2" ? null : probe;
+}
+var NO_TITLE_WORD = "No title";
 var EMPTY_VALUE_WORD = "None";
-function recordFallbackName(nounLabel3, id) {
-  const short = isUuidShape(id) ? id.slice(0, 8) : id.length > 12 ? `${id.slice(0, 12)}\u2026` : id;
-  return `${nounLabel3} ${short}`;
+function recordFallbackName(nounLabel3) {
+  return nounLabel3.trim() || "Record";
 }
 function describeChangeValue(value, word) {
   return describeValue(value, word);
@@ -570,7 +574,7 @@ function ApplyDirectiveButton({
           ) : null,
           records.map((record) => /* @__PURE__ */ jsx3("span", { className: "inline-flex min-w-0 items-center", children: host.renderRecord?.({
             ...record,
-            fallback: recordFallbackName(label2, record.id),
+            fallback: recordFallbackName(label2),
             context: "applied",
             trashed
           }) }, `${record.noun}:${record.id}`)),
@@ -618,6 +622,14 @@ function ApplyDirectiveButton({
       }
     );
   }
+  const warm = () => {
+    const read2 = host.readRecord;
+    if (!read2 || !TARGETING_CLASSES.has(directive.directiveClass)) return;
+    for (const item of items) {
+      const id = itemRecordId(item);
+      if (id) void read2({ noun: directive.noun, id }).catch(() => null);
+    }
+  };
   const destructive = directive.directiveClass === "delete";
   const muted = nothingToChange && view.status === "idle";
   return /* @__PURE__ */ jsxs2("span", { className: "flex min-w-0 flex-wrap items-center justify-end gap-x-2 gap-y-1", children: [
@@ -627,6 +639,8 @@ function ApplyDirectiveButton({
       {
         type: "button",
         onClick: () => void handleApply(),
+        onPointerEnter: warm,
+        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,
@@ -705,7 +719,6 @@ import {
   directiveDisplay,
   itemFacts,
   itemSubtitle,
-  itemTitle,
   nounLabel as nounLabel2,
   nounTitleColumn
 } from "@ai-matrx/content-ir";
@@ -732,7 +745,8 @@ function ItemRow({
     return /* @__PURE__ */ jsx4(TargetRow, { directive, item, recordId, index, phase });
   }
   const titleColumn = nounTitleColumn(directive.noun, host.nouns);
-  const title = itemTitle(item, titleColumn, index, total);
+  const ownName = itemOwnName(item, titleColumn);
+  const title = ownName ?? NO_TITLE_WORD;
   const subtitle = itemSubtitle(item);
   const valueWord = directiveValueWord(host, directive.noun);
   const facts = itemFacts(titleColumn ? omitKey(item, titleColumn) : item).map((fact) => ({
@@ -744,7 +758,14 @@ function ItemRow({
   const display = directiveDisplay(directive.directiveClass, directive.noun, host.nouns);
   const openItem = host.openItem;
   const body = /* @__PURE__ */ jsxs3(Fragment, { children: [
-    /* @__PURE__ */ jsx4("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
+    /* @__PURE__ */ jsx4(
+      "span",
+      {
+        className: `min-w-0 shrink-0 truncate font-medium ${ownName ? "text-foreground" : "italic text-muted-foreground"}`,
+        "data-item-untitled": ownName ? void 0 : "",
+        children: title
+      }
+    ),
     /* @__PURE__ */ jsx4("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ jsxs3("span", { className: "truncate text-[11px] text-muted-foreground", "data-item-fact": fact.key, children: [
       fact.label,
       " ",
@@ -773,7 +794,12 @@ function ItemRow({
         children: body
       }
     ) : /* @__PURE__ */ jsx4("span", { className: "flex min-w-0 flex-1 items-center gap-2 px-1 py-0.5", children: body }),
-    host.renderCopy?.({ label: title, value: item, kind, size: "xs" })
+    host.renderCopy?.({
+      label: ownName ?? `this ${nounLabel2(directive.noun, host.nouns)}`,
+      value: item,
+      kind,
+      size: "xs"
+    })
   ] });
 }
 function DirectiveChangeList({
@@ -827,7 +853,7 @@ function TargetRow({
   phase
 }) {
   const host = useDirectiveHost();
-  const fallback = recordFallbackName(nounLabel2(directive.noun, host.nouns), recordId);
+  const fallback = recordFallbackName(nounLabel2(directive.noun, host.nouns));
   const isUpdate = directive.directiveClass === "update";
   const readsLive = isUpdate && phase.phase === "open";
   const live = useRecordValues(
@@ -1026,6 +1052,7 @@ export {
   DirectiveRender,
   DirectiveScopeProvider,
   EMPTY_VALUE_WORD,
+  NO_TITLE_WORD,
   SideEffectDirectiveCard,
   TARGETING_CLASSES,
   defaultFailureWords,
@@ -1036,6 +1063,7 @@ export {
   fieldLabel,
   getDirectiveRenderer,
   itemChanges,
+  itemOwnName,
   itemRecordId,
   noteRecordChanged,
   provisionalDirectiveSlug,