@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.6

package/dist/esm/components/resources/ResourceListItemRenderer.js

@@ -11,7 +11,7 @@ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-run
  */
 import React, { useMemo } from 'react';
 import { ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
-import { getSchemaType, FieldSchemaType, getEnumValues, DisplayChromeMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import { getEnumValues, DisplayChromeMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';
 import { UIContext } from '../../core/ui/UIContext.js';
 import { useLongPress } from '../../components/resources/useLongPress.js';
 import { DisplayField } from '../../components/data-display/DisplayField.js';
@@ -19,7 +19,9 @@ import { DisplayChromeProvider } from '../../components/data-display/chromes/Dis
 import { ResourceSummaryDisplayer } from '../../components/data-display/ResourceSummaryDisplayer.js';
 import { Text } from '../../components/typography/text.js';
 import { FrontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { useI18n } from '../../core/i18n/useI18n.js';
 import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
+import { resolveResourceLabelEnumSchema } from '../../core/resources/resource-label-field-paths.frontend.utils.js';
 import { cn } from '../../core/ui/cn.js';
 import { CheckboxRoot } from '../../components/form/controls/boolean/checkbox.js';
 import { CARD_ROW_PADDING_CLASS, CARD_SELECTION_RAIL_CLASS, CARD_SELECTION_SLOT_CLASS, } from '../../components/resources/collection-card-layout.utils.js';
@@ -49,10 +51,16 @@ export function FieldValueRenderer({ fieldName, value, fieldSchema, fieldLabel,
     // Build the enum value→label map from the same i18n translator the list
     // already uses, so enum badges show translated labels rather than raw enum
     // values. Hook runs unconditionally, before the null-value early return.
+    //
+    // The vocabulary is read off the ENUM-BEARING schema — the field, or an array's element — through the
+    // resolver the detail views and the labelling planner share. Asking only "is the field itself an enum"
+    // left every array of an enum raw in a list or a table: a member directory printed `ORG_MEMBER` while
+    // the same roles read "Organization member" on the member's own page.
     const enumLabels = useMemo(() => {
-        if (!fieldSchema || getSchemaType(fieldSchema) !== FieldSchemaType.ENUM)
+        const enumSchema = fieldSchema ? resolveResourceLabelEnumSchema(fieldSchema) : undefined;
+        if (!enumSchema)
             return undefined;
-        const enumValues = getEnumValues(fieldSchema);
+        const enumValues = getEnumValues(enumSchema);
         if (enumValues.length === 0)
             return undefined;
         return Object.fromEntries(enumValues.map((enumValue) => [enumValue, tResourceFieldEnumValue(resourceType, fieldName, enumValue, fieldSchema)]));
@@ -86,14 +94,24 @@ export function ResourceListItemRenderer({ item, resourceType, resourceConfig, r
     // Primary display: use computeFrontendResourceLabel for the primary value.
     // For a junction this resolves the server-projected instance label (e.g. a
     // `forwardedLabel` virtual field referenced by `getFrontendResourceLabel`).
+    /*
+     * The translator goes to the label callback. Without it `computeFrontendResourceLabel` falls back
+     * to an IDENTITY `t`, so a label callback that words its row through the label tree rendered the
+     * key — then its own fallback, a ref — on every card, while the same row's page header (which
+     * passes `t`) read correctly (#1454: governed documents titled `document-definition:…` in lists).
+     */
+    const { t: tLabel, formatDate, formatDateTime } = useI18n({ resource: resourceType });
     const primaryLabel = useMemo(() => {
         const label = FrontendResourceUtils.computeFrontendResourceLabel({
             resourceType,
             registry,
             currentObject: item,
+            t: tLabel,
+            formatDate,
+            formatDateTime,
         });
         return String(label || item[summaryFields[0]] || `${resourceType} #${itemId}`);
-    }, [item, resourceType, registry, summaryFields, itemId]);
+    }, [item, resourceType, registry, summaryFields, itemId, tLabel, formatDate, formatDateTime]);
     // Secondary fields: every summary field EXCEPT the one already shown as the
     // primary label (title). The title comes from `computeFrontendResourceLabel`
     // — an arbitrary label strategy (a `string[]` join or a function), NOT
@@ -170,43 +188,55 @@ export function ResourceListItemRenderer({ item, resourceType, resourceConfig, r
         }
         onItemClick?.(item);
     };
-    return (_jsx("div", { className: cn(CARD_ROW_PADDING_CLASS, transitionClass, 
+    /*
+     * ─── The card is NOT a button; its ACTIVATOR is ────────────────────────────────────────────
+     *
+     * The card root used to be `role="button"` with `tabIndex={0}` and Enter/Space handling, and it
+     * CONTAINED the row's selection checkbox and its "More actions" button. ARIA does not allow
+     * interactive descendants inside a button, and assistive technology may flatten the whole card
+     * into one control — a screen-reader user could reach "open this record" but not reliably
+     * "select it" or "its actions". axe reported it as `nested-interactive`, serious, on every card
+     * of the todos list (#1718).
+     *
+     * This is the settled card-with-a-primary-action shape: a real `<button>` carries the name and
+     * the keyboard activation, and it is a SIBLING of the checkbox and the actions rather than their
+     * container. It is laid over the whole card (`absolute inset-0`) so its focus ring outlines the
+     * card and a click on empty space lands on it; the rail after it is positioned too, so it stacks
+     * above and its controls stay directly clickable. The root keeps its pointer `onClick` and the
+     * long-press, so a click on the card's TEXT still opens the record — pointer behaviour is
+     * unchanged, and the keyboard path is now a button that needs no hand-written key handling.
+     */
+    return (_jsxs("div", { className: cn(CARD_ROW_PADDING_CLASS, transitionClass, isActivatable && 'relative', 
         // Both only when a click leads somewhere — see `isActivatable`.
         isActivatable && hoverClass, isActivatable && 'cursor-pointer', isSelected && 'bg-primary/5', 
         // Prevent the browser text-selection that a long-press would start.
-        selectable && 'select-none', className), onClick: isActivatable ? handleActivate : undefined, role: isActivatable ? 'button' : undefined, tabIndex: isActivatable ? 0 : undefined, "aria-label": String(primaryLabel), ...longPress.handlers, 
-        // Selection state is conveyed by the row's checkbox (aria-selected is not
-        // valid on role="button"); the bg tint is a purely visual reinforcement.
-        onKeyDown: isActivatable ? (e) => {
-            if (e.key === 'Enter' || e.key === ' ') {
-                e.preventDefault();
-                if (tapTogglesSelection) {
-                    onToggleSelect?.(item);
-                }
-                else {
-                    onItemClick?.(item);
-                }
-            }
-        } : undefined, children: _jsxs("div", { className: CARD_SELECTION_RAIL_CLASS, children: [selectable && (_jsx("div", { 
-                    // `pt-0.5` optically centres the box on the first line of text beside it; the
-                    // HORIZONTAL half comes from the shared constant, which the header rail also reads.
-                    className: cn(CARD_SELECTION_SLOT_CLASS, 'pt-0.5'), onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), onTouchStart: (e) => e.stopPropagation(), children: _jsx(CheckboxRoot, { checked: isSelected, onCheckedChange: () => onToggleSelect?.(item), "aria-label": selectAriaLabel ?? String(primaryLabel) }) })), _jsxs("div", { className: cn(placement.containerClass, 'min-w-0 flex-1'), children: [_jsx("div", { className: cn('space-y-item-xs', placement.contentClass), children: authoredSummaryTemplate && resourceConfig?.mainSchema ? (
-                            // Authored template owns title + body. The title is fed via
-                            // SummaryContext (primaryLabel) and rendered by `<SummaryTitle />`
-                            // inside the template, so we do NOT render our own title here. The
-                            // region stays click-through so the whole card navigates (same as the
-                            // legacy body); an author who embeds a genuinely interactive control
-                            // stops propagation within their own template.
-                            _jsx(ResourceSummaryDisplayer, { resourceType: resourceType, schema: resourceConfig.mainSchema, data: item, primaryLabel: primaryLabel })) : (_jsxs(_Fragment, { children: [_jsx(Text, { as: "p", className: "font-medium text-foreground", truncate: true, children: primaryLabel }), secondaryFields.map((fieldName) => {
-                                        const value = item[fieldName];
-                                        if (value === null || value === undefined)
-                                            return null;
-                                        return (_jsx("div", { children: _jsx(FieldValueRenderer, { fieldName: fieldName, value: value, fieldSchema: schemaShape?.[fieldName], fieldLabel: fieldLabelsMap[fieldName], resourceType: resourceType, record: item, tResourceFieldEnumValue: tResourceFieldEnumValue }) }, fieldName));
-                                    })] })) }), operationsSlot && (
-                        // stopPropagation on click, keydown AND touchstart: an action tap or
-                        // keyboard activation must not also navigate the row, and a hold over
-                        // an action must not arm the row's long-press selection. (Mirrors the
-                        // checkbox rail — all three axes.)
-                        _jsx("div", { className: placement.actionsClass, onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), onTouchStart: (e) => e.stopPropagation(), children: operationsSlot }))] })] }) }));
+        selectable && 'select-none', className), onClick: isActivatable ? handleActivate : undefined, ...longPress.handlers, children: [isActivatable && (_jsx("button", { type: "button", "aria-label": String(primaryLabel), 
+                // Selection state is conveyed by the row's checkbox; the bg tint is a purely visual
+                // reinforcement, and `aria-pressed` would misdescribe a button that OPENS the record.
+                className: "absolute inset-0 rounded-[inherit] focus-ring-inset outline-hidden", onClick: (e) => {
+                    // The root's own onClick would run the same activation again for this click.
+                    e.stopPropagation();
+                    handleActivate();
+                } })), _jsxs("div", { className: cn(CARD_SELECTION_RAIL_CLASS, isActivatable && 'relative'), children: [selectable && (_jsx("div", { 
+                        // `pt-0.5` optically centres the box on the first line of text beside it; the
+                        // HORIZONTAL half comes from the shared constant, which the header rail also reads.
+                        className: cn(CARD_SELECTION_SLOT_CLASS, 'pt-0.5'), onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), onTouchStart: (e) => e.stopPropagation(), children: _jsx(CheckboxRoot, { checked: isSelected, onCheckedChange: () => onToggleSelect?.(item), "aria-label": selectAriaLabel ?? String(primaryLabel) }) })), _jsxs("div", { className: cn(placement.containerClass, 'min-w-0 flex-1'), children: [_jsx("div", { className: cn('space-y-item-xs', placement.contentClass), children: authoredSummaryTemplate && resourceConfig?.mainSchema ? (
+                                // Authored template owns title + body. The title is fed via
+                                // SummaryContext (primaryLabel) and rendered by `<SummaryTitle />`
+                                // inside the template, so we do NOT render our own title here. The
+                                // region stays click-through so the whole card navigates (same as the
+                                // legacy body); an author who embeds a genuinely interactive control
+                                // stops propagation within their own template.
+                                _jsx(ResourceSummaryDisplayer, { resourceType: resourceType, schema: resourceConfig.mainSchema, data: item, primaryLabel: primaryLabel })) : (_jsxs(_Fragment, { children: [_jsx(Text, { as: "p", className: "font-medium text-foreground", truncate: true, children: primaryLabel }), secondaryFields.map((fieldName) => {
+                                            const value = item[fieldName];
+                                            if (value === null || value === undefined)
+                                                return null;
+                                            return (_jsx("div", { children: _jsx(FieldValueRenderer, { fieldName: fieldName, value: value, fieldSchema: schemaShape?.[fieldName], fieldLabel: fieldLabelsMap[fieldName], resourceType: resourceType, record: item, tResourceFieldEnumValue: tResourceFieldEnumValue }) }, fieldName));
+                                        })] })) }), operationsSlot && (
+                            // stopPropagation on click, keydown AND touchstart: an action tap or
+                            // keyboard activation must not also navigate the row, and a hold over
+                            // an action must not arm the row's long-press selection. (Mirrors the
+                            // checkbox rail — all three axes.)
+                            _jsx("div", { className: placement.actionsClass, onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), onTouchStart: (e) => e.stopPropagation(), children: operationsSlot }))] })] })] }));
 }
 //# sourceMappingURL=ResourceListItemRenderer.js.map

package/dist/esm/components/resources/ResourceListItemRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceListItemRenderer.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceListItemRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * ResourceListItemRenderer\n *\n * Shared item renderer for List and Search presets.\n * Encapsulates schema-aware field rendering (FK, enum, date, array),\n * primary/secondary field split, and per-item operations.\n *\n * Used by List_Default and Search_Default to ensure parity in how\n * resource items are displayed.\n */\n\nimport React, { useMemo, useCallback } from 'react';\nimport { z } from 'zod';\nimport {\n  CoreResourceOperation,\n  ResourceOperationDisplayMode,\n  ErrorCustomMessageReference,\n} from '@wildo-ai/saas-models';\nimport type { AnyFrontendResourceConfiguration, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { getSchemaType, FieldSchemaType, getEnumValues, DisplayChromeMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useLongPress } from '~wildo-frontend-lib/components/resources/useLongPress';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { DisplayChromeProvider } from '~wildo-frontend-lib/components/data-display/chromes/DisplayChromeContext';\nimport { ResourceSummaryDisplayer } from '~wildo-frontend-lib/components/data-display/ResourceSummaryDisplayer';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { CheckboxRoot } from '~wildo-frontend-lib/components/form/controls/boolean/checkbox';\nimport {\n  CARD_ROW_PADDING_CLASS,\n  CARD_SELECTION_RAIL_CLASS,\n  CARD_SELECTION_SLOT_CLASS,\n} from '~wildo-frontend-lib/components/resources/collection-card-layout.utils';\nimport type { CardActionPlacement } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { resolveCardActionPlacementClasses } from './card-action-placement.utils';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ResourceListItemRendererProps {\n  /** The data item to render */\n  item: Record<string, unknown>;\n  /** Resource type */\n  resourceType: string;\n  /** Resource configuration */\n  resourceConfig: AnyFrontendResourceConfiguration;\n  /** Resource registry */\n  registry: FrontendResourcesRegistry;\n  /** Ordered list of summary fields to display */\n  summaryFields: string[];\n  /** Pre-resolved field labels (from i18n) */\n  fieldLabelsMap: Record<string, string>;\n  /** Function to resolve enum display values via i18n — `fieldSchema` names the enum the field declares (#966) */\n  tResourceFieldEnumValue: (resourceType: string, fieldName: string, enumValue: string, fieldSchema: z.ZodTypeAny | undefined) => string;\n  /**\n   * What a click on the row does — and, by its ABSENCE, that a click does nothing.\n   *\n   * Optional since 2026-09-20, and the optionality is the point. The card used to take this\n   * REQUIRED and paint itself `cursor-pointer` + `role=\"button\"` + `tabIndex={0}` unconditionally,\n   * so every summary row in the product announced itself as a button. Whether the click could act\n   * was decided somewhere else entirely — in the host, by whether a READ operation resolves to a\n   * view — and the two were never compared. On the audit trail the answer was \"it cannot\", so the\n   * row invited a click, took focus, answered Enter and Space, and did nothing at any of them.\n   *\n   * A host that cannot open a row now omits this, and the affordance disappears with the behaviour\n   * because both are read off the same value.\n   */\n  onItemClick?: (item: Record<string, unknown>) => void;\n  /** Optional operations component to render for this item */\n  operationsSlot?: React.ReactNode;\n  /**\n   * Where the per-item operations sit within the card (2-axis anchor +\n   * orientation). Resolved by the host from `collectionDisplayConfig.cardActionPlacement`.\n   * Omitted → the default (inline-end, vertically centered, horizontal row).\n   */\n  cardActionPlacement?: CardActionPlacement;\n  /**\n   * Selection affordance. When `selectable`, a leading checkbox renders and\n   * toggles selection via `onToggleSelect` (independent of the row click, which\n   * still navigates). `isSelected` drives the checkbox + a selected highlight.\n   */\n  selectable?: boolean;\n  isSelected?: boolean;\n  onToggleSelect?: (item: Record<string, unknown>) => void;\n  /**\n   * Whether the collection is currently in SELECTION MODE (any item selected).\n   * Mobile UX: a long-press enters selection mode, and while active a plain TAP\n   * toggles selection instead of navigating (the \"long-press to multi-select\"\n   * pattern). Gated to touch/mobile — on desktop a click always navigates and\n   * the checkbox is the explicit toggle.\n   */\n  selectionActive?: boolean;\n  /** Accessible label for the selection checkbox (host provides the i18n string). */\n  selectAriaLabel?: string;\n  /** Optional className for the root container */\n  className?: string;\n  /** Interactive CSS classes from design system (hover state, transition) */\n  interactiveClasses?: {\n    hover?: string;\n    transition?: string;\n  };\n}\n\n// =============================================================================\n// FIELD VALUE RENDERER\n// =============================================================================\n\nexport interface FieldValueRendererProps {\n  fieldName: string;\n  value: unknown;\n  fieldSchema: z.ZodTypeAny | undefined;\n  fieldLabel: string | undefined;\n  resourceType: string;\n  tResourceFieldEnumValue: (resourceType: string, fieldName: string, enumValue: string, fieldSchema: z.ZodTypeAny | undefined) => string;\n  /**\n   * The whole record this cell belongs to, forwarded to the dispatcher as `parentData`.\n   *\n   * Optional so a caller rendering a bare value is unaffected — but every collection caller passes\n   * it, because a field frequently needs a sibling to render correctly and a cell that does not know\n   * its row cannot reach one.\n   */\n  record?: Record<string, unknown>;\n}\n\n/**\n * Renders a single summary field VALUE through the shared decorator-driven\n * display pipeline (`DisplayField` → `DisplayValueDispatcher` → presets) — the\n * SAME path the detail/read view uses — so the FULL zod-UI display policy is\n * honored in lists/tables by default: enum → badge (+ per-value colors),\n * boolean → checkmark / yes-no, string → truncate / multiline, FK → reference,\n * date → formatted, money/bigdecimal/duration/etc.\n *\n * Previously this re-implemented a weak subset (enum-as-plain-text, naive array\n * join, `String(value)` fallback) that silently ignored every\n * `{primitive}UI().display` decorator, so listings/tables diverged from the\n * detail view (e.g. a `displayMode: BADGE` enum rendered as plain text). Routing\n * through `DisplayField` removes that divergence and the maintenance burden of a\n * parallel renderer.\n *\n * The card (\"Label:\" prefix) and the table (column header) own the label, so the\n * value is rendered under COMPACT chrome — a bare value with no framework\n * label/description wrapper. i18n enum labels are threaded explicitly via\n * `enumLabels` because there is no surrounding `DisplayTemplateContext`\n * (which is what supplies them inside `AutomaticDisplayer`).\n */\nexport function FieldValueRenderer({\n  fieldName,\n  value,\n  fieldSchema,\n  fieldLabel,\n  resourceType,\n  record,\n  tResourceFieldEnumValue,\n}: FieldValueRendererProps): React.JSX.Element | null {\n  // Build the enum value→label map from the same i18n translator the list\n  // already uses, so enum badges show translated labels rather than raw enum\n  // values. Hook runs unconditionally, before the null-value early return.\n  const enumLabels = useMemo<Record<string, string> | undefined>(() => {\n    if (!fieldSchema || getSchemaType(fieldSchema) !== FieldSchemaType.ENUM) return undefined;\n    const enumValues = getEnumValues(fieldSchema);\n    if (enumValues.length === 0) return undefined;\n    return Object.fromEntries(\n      enumValues.map((enumValue) => [enumValue, tResourceFieldEnumValue(resourceType, fieldName, enumValue, fieldSchema)]),\n    );\n  }, [fieldSchema, resourceType, fieldName, tResourceFieldEnumValue]);\n\n  if (value === null || value === undefined) return null;\n\n  return (\n    <div className=\"flex min-w-0 items-baseline gap-element-sm\">\n      {fieldLabel && <span className=\"text-xs text-muted-foreground\">{fieldLabel}:</span>}\n      {fieldSchema ? (\n        // COMPACT chrome → bare value with the full decorator policy applied.\n        <DisplayChromeProvider displayChromeMode={DisplayChromeMode.COMPACT}>\n          <DisplayField\n            name={fieldName}\n            schema={fieldSchema}\n            value={value}\n            enumLabels={enumLabels}\n            // The ROW this cell belongs to. Every other display surface hands the dispatcher its\n            // record as `parentData`; a collection cell did not, so anything a field needs from its\n            // siblings was unreachable from a list or a table — including a foreign key's\n            // `labelFallbackField`, which is why a member directory printed raw ObjectIds.\n            parentData={record}\n            disableInlineEdit\n            className=\"min-w-0 truncate text-sm text-muted-foreground\"\n          />\n        </DisplayChromeProvider>\n      ) : (\n        // No schema resolved for this field — `DisplayField` requires a schema,\n        // so fall back to a plain string (matches the previous default branch).\n        <span className=\"min-w-0 truncate text-sm text-muted-foreground\">{String(value)}</span>\n      )}\n    </div>\n  );\n}\n\n// =============================================================================\n// MAIN COMPONENT\n// =============================================================================\n\nexport function ResourceListItemRenderer({\n  item,\n  resourceType,\n  resourceConfig,\n  registry,\n  summaryFields,\n  fieldLabelsMap,\n  tResourceFieldEnumValue,\n  onItemClick,\n  operationsSlot,\n  cardActionPlacement,\n  selectable = false,\n  isSelected = false,\n  onToggleSelect,\n  selectionActive = false,\n  selectAriaLabel,\n  className,\n  interactiveClasses,\n}: ResourceListItemRendererProps): React.JSX.Element {\n  if (!resourceConfig?.resourceFieldIdentifier) {\n    throw FrontendResourceUtils.buildConfigurationError(\n      ErrorCustomMessageReference.FRONTEND_RESOURCE_FIELD_IDENTIFIER_NOT_FOUND,\n      { resourceType, component: 'ResourceListItemRenderer' }\n    );\n  }\n  const fieldIdentifier = resourceConfig.resourceFieldIdentifier as string;\n  // Resolve the record's own id (`_id`), not the cross-resource field-identifier\n  // name (`<resource>Id`) which is absent from a plain record — see\n  // FrontendResourceUtils.getResourceObjectId.\n  const itemId = FrontendResourceUtils.getResourceObjectId(item, fieldIdentifier);\n\n  // Primary display: use computeFrontendResourceLabel for the primary value.\n  // For a junction this resolves the server-projected instance label (e.g. a\n  // `forwardedLabel` virtual field referenced by `getFrontendResourceLabel`).\n  const primaryLabel = useMemo((): string => {\n    const label = FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType,\n      registry,\n      currentObject: item,\n    });\n    return String(label || item[summaryFields[0]] || `${resourceType} #${itemId}`);\n  }, [item, resourceType, registry, summaryFields, itemId]);\n\n  // Secondary fields: every summary field EXCEPT the one already shown as the\n  // primary label (title). The title comes from `computeFrontendResourceLabel`\n  // — an arbitrary label strategy (a `string[]` join or a function), NOT\n  // necessarily `summaryFields[0]`. Excluding the title positionally (`slice(1)`)\n  // had two bugs: (a) it REPEATED the title when the label field wasn't first\n  // (e.g. a list whose label is `name` but whose first summary field is `status`\n  // → \"Name: …\" rendered under the identical title), and (b) it silently DROPPED\n  // `summaryFields[0]` whenever that field wasn't the label. Excluding the title\n  // by VALUE fixes both: the field whose value equals the title is the label\n  // field wherever it sits, and every genuine non-label summary field is kept.\n  // (The primary-scope FK is dropped upstream by\n  // `ResourceLayoutUtils.detectSummaryFields`, so it never reaches here.)\n  const secondaryFields = useMemo(\n    () => summaryFields.filter((fieldName) => {\n      const value = item[fieldName];\n      if (value === null || value === undefined) return false;\n      return String(value) !== primaryLabel;\n    }),\n    [summaryFields, item, primaryLabel],\n  );\n\n  // Schema shape for field type detection\n  const schemaShape = useMemo(() => {\n    const mainSchema = resourceConfig?.mainSchema;\n    if (!mainSchema) return null;\n    // Polymorphic resources feed a discriminated-union schema; resolve the union-aware field shape (else getObjectShape returns null for the union → no field labels).\n    return AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(mainSchema, { commonOnly: false }) ?? null;\n  }, [resourceConfig]);\n\n  // AUTHORED summary template — the `layout.summary` contract promises coverage\n  // of \"cards, list items, FK references\". When a resource authors one, the card\n  // defers its ENTIRE content region (title + body) to `ResourceSummaryDisplayer`:\n  // the title is now a first-class template element (`<SummaryTitle />`, placed by\n  // `<SummaryLayout>`), so a status badge can sit inline with the title and the\n  // exact same composition renders in the FK popover. We pass the primary label we\n  // already computed (correct `t`, junction forwardedLabel) into the displayer's\n  // SummaryContext instead of rendering our own title above it.\n  //\n  // Resources WITHOUT an authored template keep the legacy host-owned title +\n  // generic \"Label: value\" body: routing them through the GENERATED default\n  // template would restyle every list in every app for no authored reason.\n  const authoredSummaryTemplate = resourceConfig?.frontendConfiguration?.layout?.summary;\n\n  const hoverClass = interactiveClasses?.hover ?? '';\n  const transitionClass = interactiveClasses?.transition ?? '';\n  // Resolve where the per-item actions sit (2-axis anchor → flex classes). The\n  // content + actions share one flex container so actions never overlap text.\n  const placement = resolveCardActionPlacementClasses(cardActionPlacement);\n\n  // Mobile multi-select: a long-press ENTERS selection mode (selects this item);\n  // while selection mode is active (`selectionActive`), a plain TAP toggles\n  // selection instead of navigating. Gated to a mobile viewport — on desktop a\n  // click always navigates and the checkbox is the explicit toggle. Long-press\n  // is touch-only (the hook binds touch handlers).\n  // Optional UIContext read: a rendering leaf shouldn't hard-require the shell's\n  // UIProvider just to check the breakpoint — outside a provider (isolated\n  // renders/tests) it degrades to desktop behavior (isMobile = false).\n  const ui = React.useContext(UIContext);\n  const isMobile = ui?.UIConfig?.currentBreakpoint === ViewportBreakpoint.MOBILE;\n  const tapTogglesSelection = selectable && selectionActive && isMobile;\n  // Long-press ENTERS selection mode — gated to the SAME condition as tap-toggle\n  // (selectable + mobile viewport) so the two can't disagree (e.g. enter mode on\n  // a tablet where tap-toggle is off, stranding the user mid-multiselect).\n  const longPress = useLongPress(\n    () => onToggleSelect?.(item),\n    { enabled: selectable && !!onToggleSelect && isMobile },\n  );\n\n  /*\n   * A row is INTERACTIVE when something can happen on it: the host gave it a click handler, or the\n   * view is in mobile multi-select where a tap toggles selection. Everything the card says about\n   * itself — the pointer, the button role, the focusability, the key handling — is read off this one\n   * value, so the promise and the behaviour cannot drift apart.\n   */\n  const isActivatable = Boolean(onItemClick) || tapTogglesSelection;\n\n  const handleActivate = () => {\n    // Swallow the synthetic click that follows a long-press (it already selected).\n    if (longPress.consumeLongPress()) return;\n    if (tapTogglesSelection) {\n      onToggleSelect?.(item);\n      return;\n    }\n    onItemClick?.(item);\n  };\n\n  return (\n    <div\n      className={cn(\n        CARD_ROW_PADDING_CLASS, transitionClass,\n        // Both only when a click leads somewhere — see `isActivatable`.\n        isActivatable && hoverClass,\n        isActivatable && 'cursor-pointer',\n        isSelected && 'bg-primary/5',\n        // Prevent the browser text-selection that a long-press would start.\n        selectable && 'select-none',\n        className,\n      )}\n      onClick={isActivatable ? handleActivate : undefined}\n      role={isActivatable ? 'button' : undefined}\n      tabIndex={isActivatable ? 0 : undefined}\n      aria-label={String(primaryLabel)}\n      {...longPress.handlers}\n      // Selection state is conveyed by the row's checkbox (aria-selected is not\n      // valid on role=\"button\"); the bg tint is a purely visual reinforcement.\n      onKeyDown={isActivatable ? (e) => {\n        if (e.key === 'Enter' || e.key === ' ') {\n          e.preventDefault();\n          if (tapTogglesSelection) {\n            onToggleSelect?.(item);\n          } else {\n            onItemClick?.(item);\n          }\n        }\n      } : undefined}\n    >\n      {/* Leading selection rail (only when the view is selectable). The checkbox\n          toggles selection and stops propagation so it never triggers the row's\n          navigation — mirrors the table select-cell contract. */}\n      <div className={CARD_SELECTION_RAIL_CLASS}>\n        {/* stopPropagation on click, keydown AND touchstart: the row is a\n            role=\"button\" with Enter/Space navigation and a touch long-press, so\n            without these guards toggling the checkbox (tap/keyboard) would also\n            navigate, and a hold over it would arm the row's long-press. */}\n        {selectable && (\n          <div\n            // `pt-0.5` optically centres the box on the first line of text beside it; the\n            // HORIZONTAL half comes from the shared constant, which the header rail also reads.\n            className={cn(CARD_SELECTION_SLOT_CLASS, 'pt-0.5')}\n            onClick={(e) => e.stopPropagation()}\n            onKeyDown={(e) => e.stopPropagation()}\n            onTouchStart={(e) => e.stopPropagation()}\n          >\n            <CheckboxRoot\n              checked={isSelected}\n              onCheckedChange={() => onToggleSelect?.(item)}\n              aria-label={selectAriaLabel ?? String(primaryLabel)}\n            />\n          </div>\n        )}\n        <div className={cn(placement.containerClass, 'min-w-0 flex-1')}>\n          <div className={cn('space-y-item-xs', placement.contentClass)}>\n            {authoredSummaryTemplate && resourceConfig?.mainSchema ? (\n              // Authored template owns title + body. The title is fed via\n              // SummaryContext (primaryLabel) and rendered by `<SummaryTitle />`\n              // inside the template, so we do NOT render our own title here. The\n              // region stays click-through so the whole card navigates (same as the\n              // legacy body); an author who embeds a genuinely interactive control\n              // stops propagation within their own template.\n              <ResourceSummaryDisplayer\n                resourceType={resourceType}\n                schema={resourceConfig.mainSchema}\n                data={item}\n                primaryLabel={primaryLabel}\n              />\n            ) : (\n              <>\n                <Text as=\"p\" className=\"font-medium text-foreground\" truncate>{primaryLabel}</Text>\n                {secondaryFields.map((fieldName) => {\n                  const value = item[fieldName];\n                  if (value === null || value === undefined) return null;\n                  return (\n                    <div key={fieldName}>\n                      <FieldValueRenderer\n                        fieldName={fieldName}\n                        value={value}\n                        fieldSchema={schemaShape?.[fieldName] as z.ZodTypeAny | undefined}\n                        fieldLabel={fieldLabelsMap[fieldName]}\n                        resourceType={resourceType}\n                        record={item as Record<string, unknown>}\n                        tResourceFieldEnumValue={tResourceFieldEnumValue}\n                      />\n                    </div>\n                  );\n                })}\n              </>\n            )}\n          </div>\n          {operationsSlot && (\n            // stopPropagation on click, keydown AND touchstart: an action tap or\n            // keyboard activation must not also navigate the row, and a hold over\n            // an action must not arm the row's long-press selection. (Mirrors the\n            // checkbox rail — all three axes.)\n            <div\n              className={placement.actionsClass}\n              onClick={(e) => e.stopPropagation()}\n              onKeyDown={(e) => e.stopPropagation()}\n              onTouchStart={(e) => e.stopPropagation()}\n            >\n              {operationsSlot}\n            </div>\n          )}\n        </div>\n      </div>\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ResourceListItemRenderer.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceListItemRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * ResourceListItemRenderer\n *\n * Shared item renderer for List and Search presets.\n * Encapsulates schema-aware field rendering (FK, enum, date, array),\n * primary/secondary field split, and per-item operations.\n *\n * Used by List_Default and Search_Default to ensure parity in how\n * resource items are displayed.\n */\n\nimport React, { useMemo, useCallback } from 'react';\nimport { z } from 'zod';\nimport {\n  CoreResourceOperation,\n  ResourceOperationDisplayMode,\n  ErrorCustomMessageReference,\n} from '@wildo-ai/saas-models';\nimport type { AnyFrontendResourceConfiguration, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { getEnumValues, DisplayChromeMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useLongPress } from '~wildo-frontend-lib/components/resources/useLongPress';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { DisplayChromeProvider } from '~wildo-frontend-lib/components/data-display/chromes/DisplayChromeContext';\nimport { ResourceSummaryDisplayer } from '~wildo-frontend-lib/components/data-display/ResourceSummaryDisplayer';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { resolveResourceLabelEnumSchema } from '~wildo-frontend-lib/core/resources/resource-label-field-paths.frontend.utils';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { CheckboxRoot } from '~wildo-frontend-lib/components/form/controls/boolean/checkbox';\nimport {\n  CARD_ROW_PADDING_CLASS,\n  CARD_SELECTION_RAIL_CLASS,\n  CARD_SELECTION_SLOT_CLASS,\n} from '~wildo-frontend-lib/components/resources/collection-card-layout.utils';\nimport type { CardActionPlacement } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { resolveCardActionPlacementClasses } from './card-action-placement.utils';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface ResourceListItemRendererProps {\n  /** The data item to render */\n  item: Record<string, unknown>;\n  /** Resource type */\n  resourceType: string;\n  /** Resource configuration */\n  resourceConfig: AnyFrontendResourceConfiguration;\n  /** Resource registry */\n  registry: FrontendResourcesRegistry;\n  /** Ordered list of summary fields to display */\n  summaryFields: string[];\n  /** Pre-resolved field labels (from i18n) */\n  fieldLabelsMap: Record<string, string>;\n  /** Function to resolve enum display values via i18n — `fieldSchema` names the enum the field declares (#966) */\n  tResourceFieldEnumValue: (resourceType: string, fieldName: string, enumValue: string, fieldSchema: z.ZodTypeAny | undefined) => string;\n  /**\n   * What a click on the row does — and, by its ABSENCE, that a click does nothing.\n   *\n   * Optional since 2026-09-20, and the optionality is the point. The card used to take this\n   * REQUIRED and paint itself `cursor-pointer` + `role=\"button\"` + `tabIndex={0}` unconditionally,\n   * so every summary row in the product announced itself as a button. Whether the click could act\n   * was decided somewhere else entirely — in the host, by whether a READ operation resolves to a\n   * view — and the two were never compared. On the audit trail the answer was \"it cannot\", so the\n   * row invited a click, took focus, answered Enter and Space, and did nothing at any of them.\n   *\n   * A host that cannot open a row now omits this, and the affordance disappears with the behaviour\n   * because both are read off the same value.\n   */\n  onItemClick?: (item: Record<string, unknown>) => void;\n  /** Optional operations component to render for this item */\n  operationsSlot?: React.ReactNode;\n  /**\n   * Where the per-item operations sit within the card (2-axis anchor +\n   * orientation). Resolved by the host from `collectionDisplayConfig.cardActionPlacement`.\n   * Omitted → the default (inline-end, vertically centered, horizontal row).\n   */\n  cardActionPlacement?: CardActionPlacement;\n  /**\n   * Selection affordance. When `selectable`, a leading checkbox renders and\n   * toggles selection via `onToggleSelect` (independent of the row click, which\n   * still navigates). `isSelected` drives the checkbox + a selected highlight.\n   */\n  selectable?: boolean;\n  isSelected?: boolean;\n  onToggleSelect?: (item: Record<string, unknown>) => void;\n  /**\n   * Whether the collection is currently in SELECTION MODE (any item selected).\n   * Mobile UX: a long-press enters selection mode, and while active a plain TAP\n   * toggles selection instead of navigating (the \"long-press to multi-select\"\n   * pattern). Gated to touch/mobile — on desktop a click always navigates and\n   * the checkbox is the explicit toggle.\n   */\n  selectionActive?: boolean;\n  /** Accessible label for the selection checkbox (host provides the i18n string). */\n  selectAriaLabel?: string;\n  /** Optional className for the root container */\n  className?: string;\n  /** Interactive CSS classes from design system (hover state, transition) */\n  interactiveClasses?: {\n    hover?: string;\n    transition?: string;\n  };\n}\n\n// =============================================================================\n// FIELD VALUE RENDERER\n// =============================================================================\n\nexport interface FieldValueRendererProps {\n  fieldName: string;\n  value: unknown;\n  fieldSchema: z.ZodTypeAny | undefined;\n  fieldLabel: string | undefined;\n  resourceType: string;\n  tResourceFieldEnumValue: (resourceType: string, fieldName: string, enumValue: string, fieldSchema: z.ZodTypeAny | undefined) => string;\n  /**\n   * The whole record this cell belongs to, forwarded to the dispatcher as `parentData`.\n   *\n   * Optional so a caller rendering a bare value is unaffected — but every collection caller passes\n   * it, because a field frequently needs a sibling to render correctly and a cell that does not know\n   * its row cannot reach one.\n   */\n  record?: Record<string, unknown>;\n}\n\n/**\n * Renders a single summary field VALUE through the shared decorator-driven\n * display pipeline (`DisplayField` → `DisplayValueDispatcher` → presets) — the\n * SAME path the detail/read view uses — so the FULL zod-UI display policy is\n * honored in lists/tables by default: enum → badge (+ per-value colors),\n * boolean → checkmark / yes-no, string → truncate / multiline, FK → reference,\n * date → formatted, money/bigdecimal/duration/etc.\n *\n * Previously this re-implemented a weak subset (enum-as-plain-text, naive array\n * join, `String(value)` fallback) that silently ignored every\n * `{primitive}UI().display` decorator, so listings/tables diverged from the\n * detail view (e.g. a `displayMode: BADGE` enum rendered as plain text). Routing\n * through `DisplayField` removes that divergence and the maintenance burden of a\n * parallel renderer.\n *\n * The card (\"Label:\" prefix) and the table (column header) own the label, so the\n * value is rendered under COMPACT chrome — a bare value with no framework\n * label/description wrapper. i18n enum labels are threaded explicitly via\n * `enumLabels` because there is no surrounding `DisplayTemplateContext`\n * (which is what supplies them inside `AutomaticDisplayer`).\n */\nexport function FieldValueRenderer({\n  fieldName,\n  value,\n  fieldSchema,\n  fieldLabel,\n  resourceType,\n  record,\n  tResourceFieldEnumValue,\n}: FieldValueRendererProps): React.JSX.Element | null {\n  // Build the enum value→label map from the same i18n translator the list\n  // already uses, so enum badges show translated labels rather than raw enum\n  // values. Hook runs unconditionally, before the null-value early return.\n  //\n  // The vocabulary is read off the ENUM-BEARING schema — the field, or an array's element — through the\n  // resolver the detail views and the labelling planner share. Asking only \"is the field itself an enum\"\n  // left every array of an enum raw in a list or a table: a member directory printed `ORG_MEMBER` while\n  // the same roles read \"Organization member\" on the member's own page.\n  const enumLabels = useMemo<Record<string, string> | undefined>(() => {\n    const enumSchema = fieldSchema ? resolveResourceLabelEnumSchema(fieldSchema) : undefined;\n    if (!enumSchema) return undefined;\n    const enumValues = getEnumValues(enumSchema);\n    if (enumValues.length === 0) return undefined;\n    return Object.fromEntries(\n      enumValues.map((enumValue) => [enumValue, tResourceFieldEnumValue(resourceType, fieldName, enumValue, fieldSchema)]),\n    );\n  }, [fieldSchema, resourceType, fieldName, tResourceFieldEnumValue]);\n\n  if (value === null || value === undefined) return null;\n\n  return (\n    <div className=\"flex min-w-0 items-baseline gap-element-sm\">\n      {fieldLabel && <span className=\"text-xs text-muted-foreground\">{fieldLabel}:</span>}\n      {fieldSchema ? (\n        // COMPACT chrome → bare value with the full decorator policy applied.\n        <DisplayChromeProvider displayChromeMode={DisplayChromeMode.COMPACT}>\n          <DisplayField\n            name={fieldName}\n            schema={fieldSchema}\n            value={value}\n            enumLabels={enumLabels}\n            // The ROW this cell belongs to. Every other display surface hands the dispatcher its\n            // record as `parentData`; a collection cell did not, so anything a field needs from its\n            // siblings was unreachable from a list or a table — including a foreign key's\n            // `labelFallbackField`, which is why a member directory printed raw ObjectIds.\n            parentData={record}\n            disableInlineEdit\n            className=\"min-w-0 truncate text-sm text-muted-foreground\"\n          />\n        </DisplayChromeProvider>\n      ) : (\n        // No schema resolved for this field — `DisplayField` requires a schema,\n        // so fall back to a plain string (matches the previous default branch).\n        <span className=\"min-w-0 truncate text-sm text-muted-foreground\">{String(value)}</span>\n      )}\n    </div>\n  );\n}\n\n// =============================================================================\n// MAIN COMPONENT\n// =============================================================================\n\nexport function ResourceListItemRenderer({\n  item,\n  resourceType,\n  resourceConfig,\n  registry,\n  summaryFields,\n  fieldLabelsMap,\n  tResourceFieldEnumValue,\n  onItemClick,\n  operationsSlot,\n  cardActionPlacement,\n  selectable = false,\n  isSelected = false,\n  onToggleSelect,\n  selectionActive = false,\n  selectAriaLabel,\n  className,\n  interactiveClasses,\n}: ResourceListItemRendererProps): React.JSX.Element {\n  if (!resourceConfig?.resourceFieldIdentifier) {\n    throw FrontendResourceUtils.buildConfigurationError(\n      ErrorCustomMessageReference.FRONTEND_RESOURCE_FIELD_IDENTIFIER_NOT_FOUND,\n      { resourceType, component: 'ResourceListItemRenderer' }\n    );\n  }\n  const fieldIdentifier = resourceConfig.resourceFieldIdentifier as string;\n  // Resolve the record's own id (`_id`), not the cross-resource field-identifier\n  // name (`<resource>Id`) which is absent from a plain record — see\n  // FrontendResourceUtils.getResourceObjectId.\n  const itemId = FrontendResourceUtils.getResourceObjectId(item, fieldIdentifier);\n\n  // Primary display: use computeFrontendResourceLabel for the primary value.\n  // For a junction this resolves the server-projected instance label (e.g. a\n  // `forwardedLabel` virtual field referenced by `getFrontendResourceLabel`).\n  /*\n   * The translator goes to the label callback. Without it `computeFrontendResourceLabel` falls back\n   * to an IDENTITY `t`, so a label callback that words its row through the label tree rendered the\n   * key — then its own fallback, a ref — on every card, while the same row's page header (which\n   * passes `t`) read correctly (#1454: governed documents titled `document-definition:…` in lists).\n   */\n  const { t: tLabel, formatDate, formatDateTime } = useI18n({ resource: resourceType });\n  const primaryLabel = useMemo((): string => {\n    const label = FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType,\n      registry,\n      currentObject: item,\n      t: tLabel,\n      formatDate,\n      formatDateTime,\n    });\n    return String(label || item[summaryFields[0]] || `${resourceType} #${itemId}`);\n  }, [item, resourceType, registry, summaryFields, itemId, tLabel, formatDate, formatDateTime]);\n\n  // Secondary fields: every summary field EXCEPT the one already shown as the\n  // primary label (title). The title comes from `computeFrontendResourceLabel`\n  // — an arbitrary label strategy (a `string[]` join or a function), NOT\n  // necessarily `summaryFields[0]`. Excluding the title positionally (`slice(1)`)\n  // had two bugs: (a) it REPEATED the title when the label field wasn't first\n  // (e.g. a list whose label is `name` but whose first summary field is `status`\n  // → \"Name: …\" rendered under the identical title), and (b) it silently DROPPED\n  // `summaryFields[0]` whenever that field wasn't the label. Excluding the title\n  // by VALUE fixes both: the field whose value equals the title is the label\n  // field wherever it sits, and every genuine non-label summary field is kept.\n  // (The primary-scope FK is dropped upstream by\n  // `ResourceLayoutUtils.detectSummaryFields`, so it never reaches here.)\n  const secondaryFields = useMemo(\n    () => summaryFields.filter((fieldName) => {\n      const value = item[fieldName];\n      if (value === null || value === undefined) return false;\n      return String(value) !== primaryLabel;\n    }),\n    [summaryFields, item, primaryLabel],\n  );\n\n  // Schema shape for field type detection\n  const schemaShape = useMemo(() => {\n    const mainSchema = resourceConfig?.mainSchema;\n    if (!mainSchema) return null;\n    // Polymorphic resources feed a discriminated-union schema; resolve the union-aware field shape (else getObjectShape returns null for the union → no field labels).\n    return AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(mainSchema, { commonOnly: false }) ?? null;\n  }, [resourceConfig]);\n\n  // AUTHORED summary template — the `layout.summary` contract promises coverage\n  // of \"cards, list items, FK references\". When a resource authors one, the card\n  // defers its ENTIRE content region (title + body) to `ResourceSummaryDisplayer`:\n  // the title is now a first-class template element (`<SummaryTitle />`, placed by\n  // `<SummaryLayout>`), so a status badge can sit inline with the title and the\n  // exact same composition renders in the FK popover. We pass the primary label we\n  // already computed (correct `t`, junction forwardedLabel) into the displayer's\n  // SummaryContext instead of rendering our own title above it.\n  //\n  // Resources WITHOUT an authored template keep the legacy host-owned title +\n  // generic \"Label: value\" body: routing them through the GENERATED default\n  // template would restyle every list in every app for no authored reason.\n  const authoredSummaryTemplate = resourceConfig?.frontendConfiguration?.layout?.summary;\n\n  const hoverClass = interactiveClasses?.hover ?? '';\n  const transitionClass = interactiveClasses?.transition ?? '';\n  // Resolve where the per-item actions sit (2-axis anchor → flex classes). The\n  // content + actions share one flex container so actions never overlap text.\n  const placement = resolveCardActionPlacementClasses(cardActionPlacement);\n\n  // Mobile multi-select: a long-press ENTERS selection mode (selects this item);\n  // while selection mode is active (`selectionActive`), a plain TAP toggles\n  // selection instead of navigating. Gated to a mobile viewport — on desktop a\n  // click always navigates and the checkbox is the explicit toggle. Long-press\n  // is touch-only (the hook binds touch handlers).\n  // Optional UIContext read: a rendering leaf shouldn't hard-require the shell's\n  // UIProvider just to check the breakpoint — outside a provider (isolated\n  // renders/tests) it degrades to desktop behavior (isMobile = false).\n  const ui = React.useContext(UIContext);\n  const isMobile = ui?.UIConfig?.currentBreakpoint === ViewportBreakpoint.MOBILE;\n  const tapTogglesSelection = selectable && selectionActive && isMobile;\n  // Long-press ENTERS selection mode — gated to the SAME condition as tap-toggle\n  // (selectable + mobile viewport) so the two can't disagree (e.g. enter mode on\n  // a tablet where tap-toggle is off, stranding the user mid-multiselect).\n  const longPress = useLongPress(\n    () => onToggleSelect?.(item),\n    { enabled: selectable && !!onToggleSelect && isMobile },\n  );\n\n  /*\n   * A row is INTERACTIVE when something can happen on it: the host gave it a click handler, or the\n   * view is in mobile multi-select where a tap toggles selection. Everything the card says about\n   * itself — the pointer, the button role, the focusability, the key handling — is read off this one\n   * value, so the promise and the behaviour cannot drift apart.\n   */\n  const isActivatable = Boolean(onItemClick) || tapTogglesSelection;\n\n  const handleActivate = () => {\n    // Swallow the synthetic click that follows a long-press (it already selected).\n    if (longPress.consumeLongPress()) return;\n    if (tapTogglesSelection) {\n      onToggleSelect?.(item);\n      return;\n    }\n    onItemClick?.(item);\n  };\n\n  /*\n   * ─── The card is NOT a button; its ACTIVATOR is ────────────────────────────────────────────\n   *\n   * The card root used to be `role=\"button\"` with `tabIndex={0}` and Enter/Space handling, and it\n   * CONTAINED the row's selection checkbox and its \"More actions\" button. ARIA does not allow\n   * interactive descendants inside a button, and assistive technology may flatten the whole card\n   * into one control — a screen-reader user could reach \"open this record\" but not reliably\n   * \"select it\" or \"its actions\". axe reported it as `nested-interactive`, serious, on every card\n   * of the todos list (#1718).\n   *\n   * This is the settled card-with-a-primary-action shape: a real `<button>` carries the name and\n   * the keyboard activation, and it is a SIBLING of the checkbox and the actions rather than their\n   * container. It is laid over the whole card (`absolute inset-0`) so its focus ring outlines the\n   * card and a click on empty space lands on it; the rail after it is positioned too, so it stacks\n   * above and its controls stay directly clickable. The root keeps its pointer `onClick` and the\n   * long-press, so a click on the card's TEXT still opens the record — pointer behaviour is\n   * unchanged, and the keyboard path is now a button that needs no hand-written key handling.\n   */\n  return (\n    <div\n      className={cn(\n        CARD_ROW_PADDING_CLASS, transitionClass,\n        isActivatable && 'relative',\n        // Both only when a click leads somewhere — see `isActivatable`.\n        isActivatable && hoverClass,\n        isActivatable && 'cursor-pointer',\n        isSelected && 'bg-primary/5',\n        // Prevent the browser text-selection that a long-press would start.\n        selectable && 'select-none',\n        className,\n      )}\n      onClick={isActivatable ? handleActivate : undefined}\n      {...longPress.handlers}\n    >\n      {isActivatable && (\n        <button\n          type=\"button\"\n          aria-label={String(primaryLabel)}\n          // Selection state is conveyed by the row's checkbox; the bg tint is a purely visual\n          // reinforcement, and `aria-pressed` would misdescribe a button that OPENS the record.\n          className=\"absolute inset-0 rounded-[inherit] focus-ring-inset outline-hidden\"\n          onClick={(e) => {\n            // The root's own onClick would run the same activation again for this click.\n            e.stopPropagation();\n            handleActivate();\n          }}\n        />\n      )}\n      {/* Leading selection rail (only when the view is selectable). The checkbox\n          toggles selection and stops propagation so it never triggers the row's\n          navigation — mirrors the table select-cell contract. */}\n      <div className={cn(CARD_SELECTION_RAIL_CLASS, isActivatable && 'relative')}>\n        {/* stopPropagation on click, keydown AND touchstart: the card opens on a\n            click and arms a long-press on a touch hold, so without these guards\n            toggling the checkbox would also navigate, and a hold over it would arm\n            the row's long-press. */}\n        {selectable && (\n          <div\n            // `pt-0.5` optically centres the box on the first line of text beside it; the\n            // HORIZONTAL half comes from the shared constant, which the header rail also reads.\n            className={cn(CARD_SELECTION_SLOT_CLASS, 'pt-0.5')}\n            onClick={(e) => e.stopPropagation()}\n            onKeyDown={(e) => e.stopPropagation()}\n            onTouchStart={(e) => e.stopPropagation()}\n          >\n            <CheckboxRoot\n              checked={isSelected}\n              onCheckedChange={() => onToggleSelect?.(item)}\n              aria-label={selectAriaLabel ?? String(primaryLabel)}\n            />\n          </div>\n        )}\n        <div className={cn(placement.containerClass, 'min-w-0 flex-1')}>\n          <div className={cn('space-y-item-xs', placement.contentClass)}>\n            {authoredSummaryTemplate && resourceConfig?.mainSchema ? (\n              // Authored template owns title + body. The title is fed via\n              // SummaryContext (primaryLabel) and rendered by `<SummaryTitle />`\n              // inside the template, so we do NOT render our own title here. The\n              // region stays click-through so the whole card navigates (same as the\n              // legacy body); an author who embeds a genuinely interactive control\n              // stops propagation within their own template.\n              <ResourceSummaryDisplayer\n                resourceType={resourceType}\n                schema={resourceConfig.mainSchema}\n                data={item}\n                primaryLabel={primaryLabel}\n              />\n            ) : (\n              <>\n                <Text as=\"p\" className=\"font-medium text-foreground\" truncate>{primaryLabel}</Text>\n                {secondaryFields.map((fieldName) => {\n                  const value = item[fieldName];\n                  if (value === null || value === undefined) return null;\n                  return (\n                    <div key={fieldName}>\n                      <FieldValueRenderer\n                        fieldName={fieldName}\n                        value={value}\n                        fieldSchema={schemaShape?.[fieldName] as z.ZodTypeAny | undefined}\n                        fieldLabel={fieldLabelsMap[fieldName]}\n                        resourceType={resourceType}\n                        record={item as Record<string, unknown>}\n                        tResourceFieldEnumValue={tResourceFieldEnumValue}\n                      />\n                    </div>\n                  );\n                })}\n              </>\n            )}\n          </div>\n          {operationsSlot && (\n            // stopPropagation on click, keydown AND touchstart: an action tap or\n            // keyboard activation must not also navigate the row, and a hold over\n            // an action must not arm the row's long-press selection. (Mirrors the\n            // checkbox rail — all three axes.)\n            <div\n              className={placement.actionsClass}\n              onClick={(e) => e.stopPropagation()}\n              onKeyDown={(e) => e.stopPropagation()}\n              onTouchStart={(e) => e.stopPropagation()}\n            >\n              {operationsSlot}\n            </div>\n          )}\n        </div>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/esm/components/resources/ResourceOperationActionDropdown.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
+import type { NavigationZone } from '../../core/navigation/navigation.schemas';
+export interface ResourceOperationActionDropdownBodyProps {
+    resourceContext: FrontendResourceOperationContext;
+    navigationZone: NavigationZone;
+    /** The value the acted-on row currently holds for the choice field, marked ✓. Absent in bulk. */
+    currentValue?: string;
+    /** Closes the anchored list — on a successful pick, and on picking the value already held. */
+    onDismiss: () => void;
+}
+/**
+ * The body of a DROPDOWN action (`ResourceOperationActionPresentation.DROPDOWN`): the operation's
+ * admissible values, anchored to its button. Picking one executes the operation with it.
+ *
+ * ## A detached host, like the popover it sits beside
+ *
+ * It is drawn inside whatever page opened it, so it establishes its OWN operation view first — the
+ * rule `ResourceOperationDetachedHost` exists for, and the reason execution here cannot run the
+ * listing's operation by accident. Execution is `useOperationDirectExecution`, the same form-less path
+ * the operation fallback uses: RMM for an update-like row action, the bulk selection merged for a
+ * bulk one, the outcome announced either way.
+ *
+ * ## Two lists, because the two domains are different things
+ *
+ * An ENUM is closed and known: every value is listed, labelled by the same `useResourceLabels` call
+ * the form makes, so the menu and the form can never disagree about a word. A REFERENCE is records on
+ * the server: the list is `useResourceSearch`, the hook behind the form's reference picker, so its
+ * scoping (tenant, M:N junction, parent context) is the picker's by construction rather than a copy.
+ */
+export declare function ResourceOperationActionDropdownBody({ resourceContext, navigationZone, currentValue, onDismiss, }: ResourceOperationActionDropdownBodyProps): React.JSX.Element;
+//# sourceMappingURL=ResourceOperationActionDropdown.d.ts.map

package/dist/esm/components/resources/ResourceOperationActionDropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceOperationActionDropdown.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOperationActionDropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAM/D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AA+B7F,MAAM,WAAW,wCAAwC;IACvD,eAAe,EAAE,gCAAgC,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CAAC,EAClD,eAAe,EACf,cAAc,EACd,YAAY,EACZ,SAAS,GACV,EAAE,wCAAwC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAM9D"}

package/dist/esm/components/resources/ResourceOperationActionDropdown.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo } from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { resolveComponentLabel } from '../../core/i18n/component-label-resolution.utils.js';
+import { ResourceOperationViewProvider } from '../../core/resources/ResourceOperationViewProvider.js';
+import { useResourceOperationViewContext } from '../../core/resources/ResourceOperationViewContext.js';
+import { useOperationDirectExecution } from '../../core/resources/useOperationDirectExecution.js';
+import { useResourceLabels } from '../../core/resources/useResourceLabels.js';
+import { ResourceOperationChoiceDomain, resolveResourceOperationDropdownChoice, } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { useResourceSearch } from '../../components/resources-fields/resource-reference/useResourceSearch.js';
+import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, } from '../../components/navigation/command.js';
+import { LoadingSpinner } from '../../components/feedback/loading-spinner.js';
+import { useIconRegistry } from '../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../core/icons/icon-registry.frontend.schemas.js';
+import { cn } from '../../core/ui/cn.js';
+import { getEnumValues } from '@wildo-ai/zod-decorators';
+/**
+ * Above this many enum values the list gets a search input. Below it, typing is slower than
+ * scanning — a status menu of five does not want a text box above it.
+ */
+const ENUM_CHOICE_SEARCH_THRESHOLD = 7;
+/**
+ * The body of a DROPDOWN action (`ResourceOperationActionPresentation.DROPDOWN`): the operation's
+ * admissible values, anchored to its button. Picking one executes the operation with it.
+ *
+ * ## A detached host, like the popover it sits beside
+ *
+ * It is drawn inside whatever page opened it, so it establishes its OWN operation view first — the
+ * rule `ResourceOperationDetachedHost` exists for, and the reason execution here cannot run the
+ * listing's operation by accident. Execution is `useOperationDirectExecution`, the same form-less path
+ * the operation fallback uses: RMM for an update-like row action, the bulk selection merged for a
+ * bulk one, the outcome announced either way.
+ *
+ * ## Two lists, because the two domains are different things
+ *
+ * An ENUM is closed and known: every value is listed, labelled by the same `useResourceLabels` call
+ * the form makes, so the menu and the form can never disagree about a word. A REFERENCE is records on
+ * the server: the list is `useResourceSearch`, the hook behind the form's reference picker, so its
+ * scoping (tenant, M:N junction, parent context) is the picker's by construction rather than a copy.
+ */
+export function ResourceOperationActionDropdownBody({ resourceContext, navigationZone, currentValue, onDismiss, }) {
+    return (_jsx(ResourceOperationViewProvider, { resourceContext: resourceContext, navigationZone: navigationZone, children: _jsx(ResourceOperationChoiceList, { currentValue: currentValue, onDismiss: onDismiss }) }));
+}
+function ResourceOperationChoiceList({ currentValue, onDismiss }) {
+    const { operation, resourceType } = useResourceOperationViewContext();
+    // Resource-scoped like the executor and the fallback: a resource may override the component's words.
+    const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });
+    const choice = useMemo(() => resolveResourceOperationDropdownChoice(operation), [operation]);
+    const { execute, isExecuting, isBootstrapping } = useOperationDirectExecution({
+        onSuccess: onDismiss,
+        errorMessage: resolveComponentLabel({
+            tComponent,
+            componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,
+            key: 'executionFailed',
+        }),
+        errorComponent: 'ResourceOperationActionDropdownBody',
+    });
+    const handlePick = useCallback((value) => {
+        if (!choice)
+            return;
+        // Picking what the row already holds is a no-op a person expects to simply close the menu —
+        // sending it would write an identical value and announce a change that did not happen.
+        if (value === currentValue) {
+            onDismiss();
+            return;
+        }
+        void execute({ [choice.fieldName]: value });
+    }, [choice, currentValue, execute, onDismiss]);
+    // The resolver only selects DROPDOWN when a choice field exists, so this is a defensive boundary:
+    // an operation reshaped under a live panel renders nothing rather than a list for a field it lost.
+    if (!choice)
+        return null;
+    const busy = isExecuting || isBootstrapping;
+    return choice.domain === ResourceOperationChoiceDomain.REFERENCE
+        ? _jsx(ReferenceChoiceList, { choice: choice, currentValue: currentValue, busy: busy, onPick: handlePick })
+        : _jsx(EnumChoiceList, { choice: choice, currentValue: currentValue, busy: busy, onPick: handlePick });
+}
+function EnumChoiceList({ choice, currentValue, busy, onPick }) {
+    const { resourceType, operation } = useResourceOperationViewContext();
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
+    const { enumLabels, isReady: areLabelsReady } = useResourceLabels(
+    // A choice exists only for an object request body, so this is that body.
+    operation.requestDto, { resourceType, operationId: String(operation.operationIdentifier) }, undefined, 'edit');
+    const values = useMemo(() => getEnumValues(choice.fieldSchema) ?? [], [choice.fieldSchema]);
+    const labels = enumLabels[choice.fieldName];
+    const searchable = values.length > ENUM_CHOICE_SEARCH_THRESHOLD;
+    // Nothing until the words exist: a value list drawn before its labels load shows raw wire values
+    // for a frame, which reads as the missing labels this repository refuses to invent.
+    if (isReady === false || areLabelsReady === false)
+        return _jsx(ChoiceListLoading, {});
+    return (_jsxs(Command, { shouldFilter: searchable, children: [searchable && (_jsx(CommandInput, { placeholder: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'searchPlaceholder') })), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noResults') }), _jsx(CommandGroup, { children: values.map((value) => {
+                            const label = labels?.[value] ?? value;
+                            return (_jsx(ChoiceItem, { value: value, label: label, isCurrent: value === currentValue, disabled: busy, onPick: onPick }, value));
+                        }) })] })] }));
+}
+function ReferenceChoiceList({ choice, currentValue, busy, onPick }) {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
+    const { options, isLoading, setIsOpen, handleSearchChange, emptyMessage, fetchError } = useResourceSearch({
+        schema: choice.fieldSchema,
+        name: choice.fieldName,
+        value: currentValue,
+    });
+    // The list IS the open dropdown: it exists only while the panel is open, so it asks for its first
+    // page on mount and releases the search on unmount, exactly as the picker does on open/close.
+    useEffect(() => {
+        setIsOpen(true);
+        return () => setIsOpen(false);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    if (isReady === false)
+        return _jsx(ChoiceListLoading, {});
+    return (
+    // Server-side search: the options arriving are already the matches, so cmdk must not filter them
+    // a second time against the label it happens to hold.
+    _jsxs(Command, { shouldFilter: false, children: [_jsx(CommandInput, { placeholder: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'searchPlaceholder'), onValueChange: handleSearchChange, autoFocus: true }), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: isLoading ? _jsx(ChoiceListLoading, {}) : (fetchError?.message ?? emptyMessage) }), _jsx(CommandGroup, { children: options.map((option) => (_jsx(ChoiceItem, { value: option.value, label: option.label, isCurrent: option.value === currentValue, disabled: busy || option.disabled === true, onPick: onPick }, option.value))) })] })] }));
+}
+/** The list's place while its words load — the same spinner the reference search shows. */
+function ChoiceListLoading() {
+    return _jsx("span", { className: "flex justify-center py-element", children: _jsx(LoadingSpinner, { size: 16 }) });
+}
+/** One value. The ✓ column is always reserved, so labels align whether or not a row is current. */
+function ChoiceItem({ value, label, isCurrent, disabled, onPick }) {
+    const { renderIcon } = useIconRegistry();
+    return (_jsxs(CommandItem, { value: value, keywords: [label], disabled: disabled, onSelect: () => onPick(value), "aria-current": isCurrent ? 'true' : undefined, "data-choice-value": value, children: [renderIcon(StandardIconReference.CHECK, {
+                size: IconSize.SM,
+                className: cn('me-2 shrink-0', isCurrent ? 'opacity-100' : 'opacity-0'),
+            }), _jsx("span", { className: "truncate", children: label })] }));
+}
+//# sourceMappingURL=ResourceOperationActionDropdown.js.map

package/dist/esm/components/resources/ResourceOperationActionDropdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceOperationActionDropdown.js","sourceRoot":"","sources":["../../../../../src/components/resources/ResourceOperationActionDropdown.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AAGvG,OAAO,EAAE,6BAA6B,EAAE,MAAM,kEAAkE,CAAC;AACjH,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AACzF,OAAO,EACL,6BAA6B,EAC7B,sCAAsC,GAEvC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sFAAsF,CAAC;AACzH,OAAO,EACL,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAWvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mCAAmC,CAAC,EAClD,eAAe,EACf,cAAc,EACd,YAAY,EACZ,SAAS,GACgC;IACzC,OAAO,CACL,KAAC,6BAA6B,IAAC,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,YAC7F,KAAC,2BAA2B,IAAC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAI,GACnD,CACjC,CAAC;AACJ,CAAC;AAOD,SAAS,2BAA2B,CAAC,EAAE,YAAY,EAAE,SAAS,EAAmB;IAC/E,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,+BAA+B,EAAE,CAAC;IACtE,qGAAqG;IACrG,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,wBAAwB,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IACtH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7F,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,2BAA2B,CAAC;QAC5E,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,qBAAqB,CAAC;YAClC,UAAU;YACV,aAAa,EAAE,qBAAqB,CAAC,wBAAwB;YAC7D,GAAG,EAAE,iBAAiB;SACvB,CAAC;QACF,cAAc,EAAE,qCAAqC;KACtD,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,KAAa,EAAE,EAAE;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,4FAA4F;QAC5F,uFAAuF;QACvF,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YAC3B,SAAS,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,KAAK,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAE/C,kGAAkG;IAClG,mGAAmG;IACnG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,IAAI,GAAG,WAAW,IAAI,eAAe,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,KAAK,6BAA6B,CAAC,SAAS;QAC9D,CAAC,CAAC,KAAC,mBAAmB,IAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAI;QACrG,CAAC,CAAC,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAI,CAAC;AACrG,CAAC;AASD,SAAS,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAmB;IAC7E,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,+BAA+B,EAAE,CAAC;IACtE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnG,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,iBAAiB;IAC/D,yEAAyE;IACzE,SAAS,CAAC,UAA0B,EACpC,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,EACpE,SAAS,EACT,MAAM,CACP,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,4BAA4B,CAAC;IAEhE,iGAAiG;IACjG,oFAAoF;IACpF,IAAI,OAAO,KAAK,KAAK,IAAI,cAAc,KAAK,KAAK;QAAE,OAAO,KAAC,iBAAiB,KAAG,CAAC;IAEhF,OAAO,CACL,MAAC,OAAO,IAAC,YAAY,EAAE,UAAU,aAC9B,UAAU,IAAI,CACb,KAAC,YAAY,IAAC,WAAW,EAAE,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,GAAI,CAC3G,EACD,MAAC,WAAW,eACV,KAAC,YAAY,cAAE,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAgB,EAClG,KAAC,YAAY,cACV,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;4BACpB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;4BACvC,OAAO,CACL,KAAC,UAAU,IAET,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,KAAK,KAAK,YAAY,EACjC,QAAQ,EAAE,IAAI,EACd,MAAM,EAAE,MAAM,IALT,KAAK,CAMV,CACH,CAAC;wBACJ,CAAC,CAAC,GACW,IACH,IACN,CACX,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAmB;IAClF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC;QACxG,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;IAEH,kGAAkG;IAClG,8FAA8F;IAC9F,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,KAAC,iBAAiB,KAAG,CAAC;IAEpD,OAAO;IACL,iGAAiG;IACjG,sDAAsD;IACtD,MAAC,OAAO,IAAC,YAAY,EAAE,KAAK,aAC1B,KAAC,YAAY,IACX,WAAW,EAAE,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EACxF,aAAa,EAAE,kBAAkB,EACjC,SAAS,SACT,EACF,MAAC,WAAW,eACV,KAAC,YAAY,cACV,SAAS,CAAC,CAAC,CAAC,KAAC,iBAAiB,KAAG,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,IAAI,YAAY,CAAC,GAC7D,EACf,KAAC,YAAY,cACV,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,KAAC,UAAU,IAET,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,SAAS,EAAE,MAAM,CAAC,KAAK,KAAK,YAAY,EACxC,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAC1C,MAAM,EAAE,MAAM,IALT,MAAM,CAAC,KAAK,CAMjB,CACH,CAAC,GACW,IACH,IACN,CACX,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,SAAS,iBAAiB;IACxB,OAAO,eAAM,SAAS,EAAC,gCAAgC,YAAC,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GAAO,CAAC;AAC9F,CAAC;AAUD,mGAAmG;AACnG,SAAS,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAmB;IAChF,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;IACzC,OAAO,CACL,MAAC,WAAW,IACV,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,KAAK,CAAC,EACjB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBACf,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,uBACzB,KAAK,aAEvB,UAAU,CAAC,qBAAqB,CAAC,KAAK,EAAE;gBACvC,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACjB,SAAS,EAAE,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;aACxE,CAAC,EACF,eAAM,SAAS,EAAC,UAAU,YAAE,KAAK,GAAQ,IAC7B,CACf,CAAC;AACJ,CAAC","sourcesContent":["import React, { useCallback, useEffect, useMemo } from 'react';\nimport type { z } from 'zod';\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { ResourceOperationViewProvider } from '~wildo-frontend-lib/core/resources/ResourceOperationViewProvider';\nimport { useResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { useOperationDirectExecution } from '~wildo-frontend-lib/core/resources/useOperationDirectExecution';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport {\n  ResourceOperationChoiceDomain,\n  resolveResourceOperationDropdownChoice,\n  type ResourceOperationDropdownChoice,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceSearch } from '~wildo-frontend-lib/components/resources-fields/resource-reference/useResourceSearch';\nimport {\n  Command,\n  CommandEmpty,\n  CommandGroup,\n  CommandInput,\n  CommandItem,\n  CommandList,\n} from '~wildo-frontend-lib/components/navigation/command';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { getEnumValues } from '@wildo-ai/zod-decorators';\n\n/**\n * Above this many enum values the list gets a search input. Below it, typing is slower than\n * scanning — a status menu of five does not want a text box above it.\n */\nconst ENUM_CHOICE_SEARCH_THRESHOLD = 7;\n\nexport interface ResourceOperationActionDropdownBodyProps {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  /** The value the acted-on row currently holds for the choice field, marked ✓. Absent in bulk. */\n  currentValue?: string;\n  /** Closes the anchored list — on a successful pick, and on picking the value already held. */\n  onDismiss: () => void;\n}\n\n/**\n * The body of a DROPDOWN action (`ResourceOperationActionPresentation.DROPDOWN`): the operation's\n * admissible values, anchored to its button. Picking one executes the operation with it.\n *\n * ## A detached host, like the popover it sits beside\n *\n * It is drawn inside whatever page opened it, so it establishes its OWN operation view first — the\n * rule `ResourceOperationDetachedHost` exists for, and the reason execution here cannot run the\n * listing's operation by accident. Execution is `useOperationDirectExecution`, the same form-less path\n * the operation fallback uses: RMM for an update-like row action, the bulk selection merged for a\n * bulk one, the outcome announced either way.\n *\n * ## Two lists, because the two domains are different things\n *\n * An ENUM is closed and known: every value is listed, labelled by the same `useResourceLabels` call\n * the form makes, so the menu and the form can never disagree about a word. A REFERENCE is records on\n * the server: the list is `useResourceSearch`, the hook behind the form's reference picker, so its\n * scoping (tenant, M:N junction, parent context) is the picker's by construction rather than a copy.\n */\nexport function ResourceOperationActionDropdownBody({\n  resourceContext,\n  navigationZone,\n  currentValue,\n  onDismiss,\n}: ResourceOperationActionDropdownBodyProps): React.JSX.Element {\n  return (\n    <ResourceOperationViewProvider resourceContext={resourceContext} navigationZone={navigationZone}>\n      <ResourceOperationChoiceList currentValue={currentValue} onDismiss={onDismiss} />\n    </ResourceOperationViewProvider>\n  );\n}\n\ninterface ChoiceListProps {\n  currentValue?: string;\n  onDismiss: () => void;\n}\n\nfunction ResourceOperationChoiceList({ currentValue, onDismiss }: ChoiceListProps): React.JSX.Element | null {\n  const { operation, resourceType } = useResourceOperationViewContext();\n  // Resource-scoped like the executor and the fallback: a resource may override the component's words.\n  const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });\n  const choice = useMemo(() => resolveResourceOperationDropdownChoice(operation), [operation]);\n\n  const { execute, isExecuting, isBootstrapping } = useOperationDirectExecution({\n    onSuccess: onDismiss,\n    errorMessage: resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,\n      key: 'executionFailed',\n    }),\n    errorComponent: 'ResourceOperationActionDropdownBody',\n  });\n\n  const handlePick = useCallback((value: string) => {\n    if (!choice) return;\n    // Picking what the row already holds is a no-op a person expects to simply close the menu —\n    // sending it would write an identical value and announce a change that did not happen.\n    if (value === currentValue) {\n      onDismiss();\n      return;\n    }\n    void execute({ [choice.fieldName]: value });\n  }, [choice, currentValue, execute, onDismiss]);\n\n  // The resolver only selects DROPDOWN when a choice field exists, so this is a defensive boundary:\n  // an operation reshaped under a live panel renders nothing rather than a list for a field it lost.\n  if (!choice) return null;\n\n  const busy = isExecuting || isBootstrapping;\n  return choice.domain === ResourceOperationChoiceDomain.REFERENCE\n    ? <ReferenceChoiceList choice={choice} currentValue={currentValue} busy={busy} onPick={handlePick} />\n    : <EnumChoiceList choice={choice} currentValue={currentValue} busy={busy} onPick={handlePick} />;\n}\n\ninterface DomainListProps {\n  choice: ResourceOperationDropdownChoice;\n  currentValue?: string;\n  busy: boolean;\n  onPick: (value: string) => void;\n}\n\nfunction EnumChoiceList({ choice, currentValue, busy, onPick }: DomainListProps): React.JSX.Element {\n  const { resourceType, operation } = useResourceOperationViewContext();\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });\n  const { enumLabels, isReady: areLabelsReady } = useResourceLabels(\n    // A choice exists only for an object request body, so this is that body.\n    operation.requestDto as z.ZodTypeAny,\n    { resourceType, operationId: String(operation.operationIdentifier) },\n    undefined,\n    'edit',\n  );\n  const values = useMemo(() => getEnumValues(choice.fieldSchema) ?? [], [choice.fieldSchema]);\n  const labels = enumLabels[choice.fieldName];\n  const searchable = values.length > ENUM_CHOICE_SEARCH_THRESHOLD;\n\n  // Nothing until the words exist: a value list drawn before its labels load shows raw wire values\n  // for a frame, which reads as the missing labels this repository refuses to invent.\n  if (isReady === false || areLabelsReady === false) return <ChoiceListLoading />;\n\n  return (\n    <Command shouldFilter={searchable}>\n      {searchable && (\n        <CommandInput placeholder={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'searchPlaceholder')} />\n      )}\n      <CommandList>\n        <CommandEmpty>{tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noResults')}</CommandEmpty>\n        <CommandGroup>\n          {values.map((value) => {\n            const label = labels?.[value] ?? value;\n            return (\n              <ChoiceItem\n                key={value}\n                value={value}\n                label={label}\n                isCurrent={value === currentValue}\n                disabled={busy}\n                onPick={onPick}\n              />\n            );\n          })}\n        </CommandGroup>\n      </CommandList>\n    </Command>\n  );\n}\n\nfunction ReferenceChoiceList({ choice, currentValue, busy, onPick }: DomainListProps): React.JSX.Element {\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });\n  const { options, isLoading, setIsOpen, handleSearchChange, emptyMessage, fetchError } = useResourceSearch({\n    schema: choice.fieldSchema,\n    name: choice.fieldName,\n    value: currentValue,\n  });\n\n  // The list IS the open dropdown: it exists only while the panel is open, so it asks for its first\n  // page on mount and releases the search on unmount, exactly as the picker does on open/close.\n  useEffect(() => {\n    setIsOpen(true);\n    return () => setIsOpen(false);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  if (isReady === false) return <ChoiceListLoading />;\n\n  return (\n    // Server-side search: the options arriving are already the matches, so cmdk must not filter them\n    // a second time against the label it happens to hold.\n    <Command shouldFilter={false}>\n      <CommandInput\n        placeholder={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'searchPlaceholder')}\n        onValueChange={handleSearchChange}\n        autoFocus\n      />\n      <CommandList>\n        <CommandEmpty>\n          {isLoading ? <ChoiceListLoading /> : (fetchError?.message ?? emptyMessage)}\n        </CommandEmpty>\n        <CommandGroup>\n          {options.map((option) => (\n            <ChoiceItem\n              key={option.value}\n              value={option.value}\n              label={option.label}\n              isCurrent={option.value === currentValue}\n              disabled={busy || option.disabled === true}\n              onPick={onPick}\n            />\n          ))}\n        </CommandGroup>\n      </CommandList>\n    </Command>\n  );\n}\n\n/** The list's place while its words load — the same spinner the reference search shows. */\nfunction ChoiceListLoading(): React.JSX.Element {\n  return <span className=\"flex justify-center py-element\"><LoadingSpinner size={16} /></span>;\n}\n\ninterface ChoiceItemProps {\n  value: string;\n  label: string;\n  isCurrent: boolean;\n  disabled: boolean;\n  onPick: (value: string) => void;\n}\n\n/** One value. The ✓ column is always reserved, so labels align whether or not a row is current. */\nfunction ChoiceItem({ value, label, isCurrent, disabled, onPick }: ChoiceItemProps): React.JSX.Element {\n  const { renderIcon } = useIconRegistry();\n  return (\n    <CommandItem\n      value={value}\n      keywords={[label]}\n      disabled={disabled}\n      onSelect={() => onPick(value)}\n      aria-current={isCurrent ? 'true' : undefined}\n      data-choice-value={value}\n    >\n      {renderIcon(StandardIconReference.CHECK, {\n        size: IconSize.SM,\n        className: cn('me-2 shrink-0', isCurrent ? 'opacity-100' : 'opacity-0'),\n      })}\n      <span className=\"truncate\">{label}</span>\n    </CommandItem>\n  );\n}\n"]}

package/dist/esm/components/resources/collection-create-placement.utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Where a collection offers "create" — the toolbar, or the empty state — decided in ONE place.
+ *
+ * One create, one place. While the collection is genuinely EMPTY and its empty state offers the
+ * first-item action, that call to action IS the create affordance: a toolbar button beside it was the
+ * same verb twice, often under two labels ("Add draft" above, "Add note" below — measured on Wonder
+ * Todos). A NARROWED listing — an inline search, or any active filter such as a status tab or a preset
+ * pill — is not empty: it matched nothing. It shows the "no matching items" message rather than the
+ * empty state (whose "none yet" would be false), and the toolbar keeps its button.
+ */
+/**
+ * Whether one filter value narrows the listing. Unset shapes — `undefined`, `null`, `''`, an empty array,
+ * an empty object — narrow nothing; anything else (a scalar, a picked set, a preset's relative range)
+ * does.
+ */
+export declare function isActiveFilterValue(value: unknown): boolean;
+/** Whether the listing is narrowed by a search or by any active filter. */
+export declare function isCollectionNarrowed(args: {
+    isSearchActive: boolean;
+    filterValues: Record<string, unknown>;
+}): boolean;
+/**
+ * Whether the TOOLBAR shows the create action. `false` exactly when the empty state renders and visibly
+ * offers it; `hasLoadedOnce` keeps the button from blinking out during the initial fetch.
+ */
+export declare function toolbarOffersCreate(args: {
+    hasLoadedOnce: boolean;
+    itemCount: number;
+    isNarrowed: boolean;
+    emptyStateOffersCreate: boolean;
+}): boolean;
+//# sourceMappingURL=collection-create-placement.utils.d.ts.map

package/dist/esm/components/resources/collection-create-placement.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-create-placement.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/collection-create-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,OAAO,CAEtH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,sBAAsB,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAGV"}