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

package/dist/index.d.cts

@@ -326,10 +326,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;
@@ -733,4 +748,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, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, 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, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, 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, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NO_TITLE_WORD, 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, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemOwnName, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, useRecordValues };

package/dist/index.d.ts

@@ -326,10 +326,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;
@@ -733,4 +748,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, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, 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, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, 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, DirectiveHost, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, type DirectiveValueWord, EMPTY_VALUE_WORD, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NO_TITLE_WORD, 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, directiveFieldLabel, directiveValueWord, failureWords, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemOwnName, itemRecordId, kindIsRoutable, noteRecordChanged, provisionalDirectiveSlug, readsApplyLedger, recordFallbackName, recordRevision, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordRevision, useRecordValues };

package/dist/index.js

@@ -757,8 +757,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;
@@ -774,10 +774,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);
@@ -1279,7 +1283,7 @@ function ApplyDirectiveButton({
           ) : null,
           records.map((record) => /* @__PURE__ */ jsx4("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}`)),
@@ -1327,6 +1331,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: [
@@ -1336,6 +1348,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,
@@ -1502,7 +1516,6 @@ import {
   directiveDisplay as directiveDisplay3,
   itemFacts,
   itemSubtitle,
-  itemTitle,
   nounLabel as nounLabel2,
   nounTitleColumn
 } from "@ai-matrx/content-ir";
@@ -1529,7 +1542,8 @@ function ItemRow({
     return /* @__PURE__ */ jsx7(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) => ({
@@ -1541,7 +1555,14 @@ function ItemRow({
   const display = directiveDisplay3(directive.directiveClass, directive.noun, host.nouns);
   const openItem = host.openItem;
   const body = /* @__PURE__ */ jsxs5(Fragment, { children: [
-    /* @__PURE__ */ jsx7("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
+    /* @__PURE__ */ jsx7(
+      "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__ */ jsx7("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ jsxs5("span", { className: "truncate text-[11px] text-muted-foreground", "data-item-fact": fact.key, children: [
       fact.label,
       " ",
@@ -1570,7 +1591,12 @@ function ItemRow({
         children: body
       }
     ) : /* @__PURE__ */ jsx7("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({
@@ -1624,7 +1650,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(
@@ -2191,6 +2217,7 @@ export {
   IR_PROVISIONAL_KEY,
   IR_ROUTE_KEY,
   KindInstanceRender,
+  NO_TITLE_WORD,
   NodeOutcomeView,
   ProvisionalKindBoundary,
   ProvisionalKindFrame,
@@ -2214,6 +2241,7 @@ export {
   isProvisionalBlock,
   isRecordValue,
   itemChanges,
+  itemOwnName,
   itemRecordId,
   kindIsRoutable,
   kindServerDataFromStoredValue,