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

package/dist/esm/core/resources/useOperationDirectExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationDirectExecution.js","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport type { FieldMetaEntry } from '@wildo-ai/saas-models';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\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 { useResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  resolveDeclaredUpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { useResourceRMM } from '~wildo-frontend-lib/core/resources/rmm/useResourceRMM';\nimport { mutationErrorForReport } from '~wildo-frontend-lib/core/resources/rmm/mutation-error-report.utils';\nimport { ConflictStrategy, MutationPriority, MutationSourceType, MutationType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n  performCanonicalRMMRead,\n  resolveCanonicalRMMReadOperationPathKey,\n} from '~wildo-frontend-lib/core/resources/rmm/canonical-read.frontend.utils';\nimport { isSingleResourceUpdateLikeOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceOperationOutcomeEmitter } from '~wildo-frontend-lib/core/resources/useResourceOperationOutcomeEmitter';\n\nexport interface UseOperationDirectExecutionParams {\n  /** Replaces what happens AFTER a success. The outcome is announced either way. Omitted: go back within the zone. */\n  onSuccess?: (result: unknown) => void;\n  /** The message a failure is reported under. */\n  errorMessage: string;\n  /** The component a failure is attributed to in the report. */\n  errorComponent: string;\n}\n\nexport interface OperationDirectExecution {\n  /**\n   * Execute the hosted operation with this exact request body — no form, no validation pass beyond\n   * the server's. Resolves once the outcome has been announced (success) or reported (failure).\n   * Omitted means \"no body at all\", which is what a zero-input action sends — not an empty object.\n   */\n  execute: (requestData?: Record<string, unknown>) => Promise<void>;\n  /** True while a request is in flight. */\n  isExecuting: boolean;\n  /**\n   * True while an update-like operation with no target id in its context is resolving that id from\n   * the canonical READ. Execution must wait for it: the RMM that carries the mutation is keyed on it.\n   */\n  isBootstrapping: boolean;\n  /**\n   * The success path itself — announce the outcome, then `onSuccess` or go back. Exposed so a host\n   * that ALSO renders a form hands the form this very function, and \"what success means\" has one\n   * definition across the form and the form-less paths.\n   */\n  completeWithSuccess: (result: unknown) => void;\n  /** The failure path — reports under `errorMessage` / `errorComponent`. Same reason as above. */\n  reportFailure: (error: Error) => void;\n}\n\ntype BootstrappedTargetRow = {\n  contextKey: string;\n  row: Record<string, unknown>;\n};\n\n/**\n * Execute the NEAREST operation view's operation with a body the caller already has — the form-less\n * half of every operation host.\n *\n * ## Why this is its own hook\n *\n * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` (\"Run\" with an\n * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is\n * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ\n * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already\n * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a\n * form inherits the whole contract by using it:\n *\n * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`\n *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;\n * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a\n *   bulk bar, a singleton) still mutates the right row;\n * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;\n * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.\n *\n * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows\n * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.\n *\n * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a\n * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).\n */\nexport function useOperationDirectExecution({\n  onSuccess,\n  errorMessage,\n  errorComponent,\n}: UseOperationDirectExecutionParams): OperationDirectExecution {\n  const {\n    resourceContext: currentResourceContext,\n    resourceType,\n    operation,\n    reportError,\n    goBackWithinZone,\n    executeCurrentOperation,\n  } = useResourceOperationViewContext();\n  const { doOperation, registry } = useResourceRegistry();\n  // `resource` as well as the component: a resource may override the component's words, and the\n  // fallback this was extracted from resolved them resource-scoped.\n  const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const [isExecuting, setIsExecuting] = useState(false);\n  const [isBootstrapping, setIsBootstrapping] = useState(false);\n  const [bootstrappedRow, setBootstrappedRow] = useState<BootstrappedTargetRow | null>(null);\n  /*\n   * A single-row update-like operation addresses ONE row, whichever lane it runs on, so its target id\n   * is resolved (the canonical-READ bootstrap below) for both lanes, and the row's RMM is attached when\n   * the row has one.\n   *\n   * It runs through that RMM when there is one. Without one it runs directly only if the operation\n   * DECLARED the direct lane (`operationFrontendConfig.updateLikeMutationFallbackMode`), read through the\n   * same function the form host and `useResourceOperationSurface` read, so the two hosts pick the same lane;\n   * otherwise it fails closed.\n   */\n  const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);\n  const acceptsDirectLane = isSingleRowUpdateLike\n    && allowsDirectOperationFallback(resolveDeclaredUpdateLikeMutationFallbackMode(operation));\n\n  const bootstrapContextKey = useMemo(() => JSON.stringify({\n    contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(\n      currentResourceContext.contextResourceIdentifiers ?? {},\n    ),\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],\n  }), [\n    currentResourceContext.contextResourceIdentifiers,\n    currentResourceContext.parentResourcesRequirements,\n  ]);\n  const routeResourceId = useMemo(() => {\n    const identifier = currentResourceContext.contextResourceIdentifiers?.[resourceType];\n    if (!identifier) {\n      return null;\n    }\n    return frontendResourceUtils.getResourceId(identifier) ?? null;\n  }, [currentResourceContext.contextResourceIdentifiers, resourceType]);\n  const currentResourceId = routeResourceId ?? (\n    bootstrappedRow?.contextKey === bootstrapContextKey\n    && typeof bootstrappedRow.row._id === 'string'\n    && bootstrappedRow.row._id.length > 0\n      ? bootstrappedRow.row._id\n      : null\n  );\n  const contextResourceIdentifiersWithResourceId = useMemo(() => {\n    if (!currentResourceId || currentResourceContext.contextResourceIdentifiers?.[resourceType]) {\n      return currentResourceContext.contextResourceIdentifiers;\n    }\n\n    return {\n      ...currentResourceContext.contextResourceIdentifiers,\n      [resourceType]: currentResourceId,\n    };\n  }, [currentResourceContext.contextResourceIdentifiers, currentResourceId, resourceType]);\n  const contextualParameters = useMemo(() => {\n    return FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiersWithResourceId,\n      registry,\n    );\n  }, [contextResourceIdentifiersWithResourceId, registry]);\n  const canonicalReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(currentResourceId),\n      contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersWithResourceId, contextualParameters, currentResourceId, registry, resourceType]);\n  const { rmm } = useResourceRMM({\n    resourceType,\n    resourceId: currentResourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,\n    resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,\n    enabled: isSingleRowUpdateLike && !!currentResourceId,\n    conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },\n    directFallbackAccepted: acceptsDirectLane,\n  });\n\n  const executionFailedLabel = useMemo(() => {\n    return resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,\n      key: 'executionFailed',\n    });\n  }, [tComponent]);\n\n  /*\n   * Announced with the context that carries the RESOLVED row id, not the route's. A context-addressed\n   * singleton has no id on its route; the id comes from the canonical READ, and a page showing that row\n   * re-reads only when the announcement names it (#1782). The route context named no row, so an action\n   * whose result carries no `_id` (a secret's change outcome) announced a change to nobody.\n   */\n  const announcedContext = useMemo(\n    () => (contextResourceIdentifiersWithResourceId === currentResourceContext.contextResourceIdentifiers\n      ? currentResourceContext\n      : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }),\n    [contextResourceIdentifiersWithResourceId, currentResourceContext],\n  );\n  const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);\n  const handleSuccess = useCallback((result: unknown) => {\n    announceOutcome(result);\n    if (onSuccess) {\n      onSuccess(result);\n      return;\n    }\n    goBackWithinZone();\n  }, [announceOutcome, goBackWithinZone, onSuccess]);\n\n  const handleError = useCallback((error: Error) => {\n    reportError(error, errorMessage, errorComponent);\n  }, [errorComponent, errorMessage, reportError]);\n\n  useEffect(() => {\n    if (!isSingleRowUpdateLike || currentResourceId || !canonicalReadOperationPathKey) {\n      return;\n    }\n\n    let cancelled = false;\n    setIsBootstrapping(true);\n    void performCanonicalRMMRead({\n      doOperation: doOperationRef.current,\n      readOperationPathKey: canonicalReadOperationPathKey,\n      contextualParameters,\n      parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n    }).then((row) => {\n      if (cancelled) return;\n      setBootstrappedRow({\n        contextKey: bootstrapContextKey,\n        row,\n      });\n    }).catch((error: unknown) => {\n      if (cancelled) return;\n      handleError(error instanceof Error ? error : new Error(String(error)));\n    }).finally(() => {\n      if (!cancelled) {\n        setIsBootstrapping(false);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [\n    bootstrapContextKey,\n    canonicalReadOperationPathKey,\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    currentResourceId,\n    handleError,\n    isSingleRowUpdateLike,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !bootstrappedRow || bootstrappedRow.contextKey !== bootstrapContextKey) {\n      return;\n    }\n\n    if (typeof rmm.getSnapshot === 'function' && rmm.getSnapshot().confirmedData !== null) {\n      return;\n    }\n\n    if (typeof rmm.setInitialState === 'function') {\n      const row = bootstrappedRow.row;\n      rmm.setInitialState(\n        row,\n        (row._version as number | undefined) ?? 0,\n        row._field_meta as Record<string, FieldMetaEntry> | undefined,\n      );\n    }\n  }, [bootstrapContextKey, bootstrappedRow, rmm]);\n\n  const execute = useCallback(async (requestData?: Record<string, unknown>) => {\n    setIsExecuting(true);\n    try {\n      let result: unknown;\n\n      if (isSingleRowUpdateLike && (rmm || !acceptsDirectLane)) {\n        if (!rmm) {\n          throw new MissingRMMRuntimeError({\n            surfaceName: 'useOperationDirectExecution',\n            resourceType,\n            operationIdentifier: String(operation.operationIdentifier),\n          });\n        }\n\n        // No optimistic patch: the body is the OPERATION's input, not a set of resource fields, and a\n        // custom operation's input names need not be the row's. The row is read back on success.\n        const mutationResult = await rmm.queueMutation({}, {\n          type: MutationType.CUSTOM,\n          priority: MutationPriority.HIGH,\n          source: {\n            type: MutationSourceType.CUSTOM,\n            subscriberId: `direct-execution:${String(operation.operationIdentifier)}`,\n          },\n          transportOverride: {\n            operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation),\n            contextualParameters,\n            parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n            requestData: requestData ?? {},\n            readBackOnSuccess: true,\n          },\n        });\n\n        if (!mutationResult.success) {\n          throw mutationErrorForReport(mutationResult.error, executionFailedLabel);\n        }\n\n        result = mutationResult.responseData;\n      } else if (isSingleRowUpdateLike) {\n        /*\n         * No RMM and the direct lane declared, still for ONE row: sent with the parameters this hook resolved, which carry the\n         * bootstrapped id when the route had none. `executeCurrentOperation` builds its parameters from the\n         * route alone, so from a detail-less context (a singleton, a bulk bar) it would address `{id}`\n         * unresolved. With no id at all the operation has no row to act on, and says so instead of sending.\n         */\n        if (!currentResourceId) {\n          throw new Error(`${String(operation.operationIdentifier)} on ${resourceType} has no row to act on: no id on the route and none from its canonical READ.`);\n        }\n        result = await doOperationRef.current(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {\n          contextualParameters,\n          parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,\n          requestData: requestData ?? {},\n        });\n      } else {\n        result = await executeCurrentOperation(requestData);\n      }\n\n      handleSuccess(result);\n    } catch (error) {\n      handleError(error instanceof Error ? error : new Error(executionFailedLabel));\n    } finally {\n      setIsExecuting(false);\n    }\n  }, [\n    contextualParameters,\n    currentResourceContext.parentResourcesRequirements,\n    executeCurrentOperation,\n    handleError,\n    handleSuccess,\n    acceptsDirectLane,\n    isSingleRowUpdateLike,\n    currentResourceId,\n    operation,\n    resourceType,\n    rmm,\n    executionFailedLabel,\n  ]);\n\n  return {\n    execute,\n    isExecuting,\n    isBootstrapping,\n    completeWithSuccess: handleSuccess,\n    reportFailure: handleError,\n  };\n}\n"]}

package/dist/esm/core/resources/useResourceOperationActions.d.ts

@@ -12,7 +12,7 @@ import { type EphemeralFieldInfo } from './ephemeral-fields.utils';
 import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas';
 import { ActionPlacement } from '../../core/resources/resources.frontend.schemas';
-import type { ActionBarItem } from '../../components/actions/action-bar';
+import { type ActionBarItem } from '../../components/actions/action-bar';
 import { ResourceOperationDisplayMode, type ResourceType } from '@wildo-ai/saas-models';
 export interface UseResourceOperationActionsParams {
     /** Resource type identifier */

package/dist/esm/core/resources/useResourceOperationActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useResourceOperationActions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationActions.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/resources/useResourceOperationActions.js

@@ -31,14 +31,16 @@ import { IconCategory, IconSize, StandardIconReference } from '../../core/icons/
 import { WebSocketContext } from '../../core/requests/websockets/WebSocketContext.js';
 import { extractEphemeralFields } from './ephemeral-fields.utils.js';
 import { ActionVisibility, ActionPlacement, DisabledActionHandling, ResourceOperationActionPresentation, resolveActionDisclosure, isOperationHeadless } from '../../core/resources/resources.frontend.schemas.js';
+import { ActionBarPopoverChrome } from '../../components/actions/action-bar.js';
 import { ResourceOperationActionPopoverBody } from '../../components/resources/ResourceOperationActionPopover.js';
+import { ResourceOperationActionDropdownBody } from '../../components/resources/ResourceOperationActionDropdown.js';
 import { InPlaceOperationTargetKind, useInPlaceOperation } from '../../core/resources/in-place/InPlaceOperationContext.js';
 import { ButtonVariants_Variant } from '../../components/actions/button.js';
-import { actionPresentationNavigates, BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY, buildBulkOperationMatchPayload, buildBulkOperationSelectorPayload, resolveResourceOperationActionPresentation, getOperationsForCoreSemantic, RESOURCE_OPERATION_EXECUTED_DISCRIMINATOR_CONTEXT_KEY, isGeneratedFileRegenerateOperation, isCollectionScopedResourceOperation, isGeneratedCollectionExportOperation, readResourceOperationExecutedDiscriminator, resolveEffectiveCoreOperationFromOperation, shouldEmitResourceRefreshAfterDirectOperation, shouldTreatAsNonItemResourceOperation, toOperationResultSummary, } from './operation-semantics.frontend.utils.js';
+import { actionPresentationNavigates, BULK_OPERATION_MATCH_SELECTION_CONTEXT_KEY, BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY, buildBulkOperationMatchPayload, buildBulkOperationSelectorPayload, resolveResourceOperationActionPresentation, resolveResourceOperationDropdownChoice, isRiskyResourceOperation, getOperationsForCoreSemantic, RESOURCE_OPERATION_EXECUTED_DISCRIMINATOR_CONTEXT_KEY, isGeneratedFileRegenerateOperation, isCollectionScopedResourceOperation, isGeneratedCollectionExportOperation, readResourceOperationExecutedDiscriminator, resolveEffectiveCoreOperationFromOperation, shouldEmitResourceRefreshAfterDirectOperation, shouldTreatAsNonItemResourceOperation, toOperationResultSummary, } from './operation-semantics.frontend.utils.js';
 import { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability, shouldRequireCurrentContextAddressabilityForOperation, } from './resource-addressability.frontend.utils.js';
 import { normalizeContextResourceIdentifiersForOutcome, normalizeContextResourceIdentifiersForTransport, } from './context-resource-identifiers.frontend.utils.js';
 import { CoreResourceOperation, ResourceOperationRiskLevel, isIrreversibleOperation, ResourceOperationDisplayMode, ResourcesConfig_OperationPathUtils, Resources_SharedUtils, ResourceGeneratedOperationKind, ResourceCollectionExportRowScope, listCollectionExportSelections, ResourceOperationVariantType, FeatureUnavailabilityBehavior, userRolesSatisfyRequiredRoles, selectHighestRightsVariants, resolveBulkOperationMaxSelection, } from '@wildo-ai/saas-models';
-import { describeResourceErrorForNotification } from '../../components/form/validation-errors/resource-error-notification-context.utils.js';
+import { describeErrorGuidance, describeResourceErrorForNotification } from '../../components/form/validation-errors/resource-error-notification-context.utils.js';
 function toActionBarFeatureAvailability(featureAvailability) {
     return featureAvailability;
 }
@@ -167,9 +169,6 @@ function riskLevelToVariant(riskLevel) {
 function withUnavailability(unavailability) {
     return unavailability ? { unavailability } : {};
 }
-function isRiskyOperation(riskLevel) {
-    return riskLevel === ResourceOperationRiskLevel.HIGH || riskLevel === ResourceOperationRiskLevel.CRITICAL;
-}
 // ─────────────────────────────────────────────────────────────────────────────
 // Label resolution for core operations
 // ─────────────────────────────────────────────────────────────────────────────
@@ -185,6 +184,10 @@ const EMPTY_ROLES = [];
 // ─────────────────────────────────────────────────────────────────────────────
 export function useResourceOperationActions(params) {
     const { resourceType, displayMode, currentObject, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, operationId = 'operations', excludeOperations, bulkOnly = false, selectionObjects, onSelectionNarrow, collectionOnly = false, placementFilter, selectedItemIds, matchAllSelection, additionalContext, successDiscriminator, suppressViewDetails = false, onOperationExecuted, collectionExportQuery, } = params;
+    // Read at panel-build time by the DROPDOWN body (its ✓ on the held value). A ref rather than a
+    // dependency because callers re-create `currentObject` every render; see the note at `items`.
+    const currentObjectRef = useRef(currentObject);
+    currentObjectRef.current = currentObject;
     const { registry, doOperation } = useResourceRegistry();
     const { permissions } = useUserOrgs();
     const appScope = useAppScopeSafe();
@@ -776,11 +779,21 @@ export function useResourceOperationActions(params) {
             operation,
             contextResourceIdentifiers: contextResourceIdentifiersWithIdEvidence,
             additionalContext: {
-                ...(operation.isBulkOperation === true && selectedItemIds?.length
+                // Exactly one selection travels, and a cross-page one wins: the form host executes this
+                // action through `mergeBulkSelectionIntoRequestData`, and a form-bearing bulk action given
+                // only the ids key sent NO selection for "select all N matching" (#2035 run, 2026-09-30).
+                ...(operation.isBulkOperation === true && matchAllSelection
                     ? {
-                        [BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY]: selectedItemIds,
+                        [BULK_OPERATION_MATCH_SELECTION_CONTEXT_KEY]: {
+                            ...(matchAllSelection.filters ? { filters: matchAllSelection.filters } : {}),
+                            ...(matchAllSelection.search ? { search: matchAllSelection.search } : {}),
+                        },
                     }
-                    : {}),
+                    : operation.isBulkOperation === true && selectedItemIds?.length
+                        ? {
+                            [BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY]: selectedItemIds,
+                        }
+                        : {}),
                 ...(effectiveSuccessDiscriminator
                     ? {
                         [RESOURCE_OPERATION_EXECUTED_DISCRIMINATOR_CONTEXT_KEY]: effectiveSuccessDiscriminator,
@@ -790,7 +803,7 @@ export function useResourceOperationActions(params) {
             parentResourcesRequirements: stableParentResourcesRequirements,
             isOperationDefault: operation.isOperationDefault ?? true,
         });
-    }, [resourceType, contextResourceIdentifiersWithIdEvidence, stableParentResourcesRequirements, selectedItemIds, effectiveSuccessDiscriminator]);
+    }, [resourceType, contextResourceIdentifiersWithIdEvidence, stableParentResourcesRequirements, selectedItemIds, matchAllSelection, effectiveSuccessDiscriminator]);
     // Navigate to an operation (UPDATE, READ, etc.)
     const handleNavigateOperation = useCallback((operation) => {
         if (!resourceConfig)
@@ -1093,6 +1106,8 @@ export function useResourceOperationActions(params) {
                     errorHttpStatus: failure.httpStatus,
                     // The declared refusal the server named in `details.code` (#1048).
                     errorRefusalCode: describeResourceErrorForNotification(err).errorRefusalCode,
+                    // The guidance the server gave, so the toast says why rather than the generic category.
+                    ...describeErrorGuidance(err),
                 },
             });
         }
@@ -1159,9 +1174,11 @@ export function useResourceOperationActions(params) {
                 return;
             }
         }
-        if (presentation === ResourceOperationActionPresentation.POPOVER) {
+        if (presentation === ResourceOperationActionPresentation.POPOVER
+            || presentation === ResourceOperationActionPresentation.DROPDOWN) {
             // The panel is rendered BY the action bar, anchored to this very button, so all this handler
-            // does is name which operation is open. A bar that cannot anchor (an item collapsed into the
+            // does is name which operation is open. A DROPDOWN is the same anchored host with a list of
+            // values for a body instead of a form, so it opens identically. A bar that cannot anchor (an item collapsed into the
             // overflow menu or nested in a subgroup) never routes here — it calls `onClick` on the item,
             // which is wired to `handleNavigateOperation` and degrades to the overlay.
             setOpenPopoverOperationKey(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation));
@@ -1181,7 +1198,7 @@ export function useResourceOperationActions(params) {
             return;
         }
         // Risky operations — show confirmation first
-        if (isRiskyOperation(riskLevel)) {
+        if (isRiskyResourceOperation(riskLevel)) {
             // Dialog title: DELETE uses the framework "confirmDelete" copy; every other
             // risky action (custom collection/drain ops, lifecycle ops) names ITSELF via
             // its resolved label, so the operator sees "Retry all" / "Purge all" rather
@@ -1240,18 +1257,20 @@ export function useResourceOperationActions(params) {
      * The click handler for an action the bar CANNOT anchor a panel to — a sub-item inside a
      * subgroup's dropdown, which is portalled and has no trigger of its own to hang a popover from.
      *
-     * `handleOperationClick` answers a POPOVER by naming which operation is open and returning; the
-     * panel itself is rendered by the BAR, against the item's own trigger. Where no such trigger
-     * exists that is a button that sets a flag nobody reads — a dead control. This routes the same
-     * presentation to its documented degrade instead (`resolveActionPresentationTransition` maps
-     * POPOVER to an OVERLAY, never to the page the ordinary chain would otherwise produce).
+     * `handleOperationClick` answers a POPOVER or a DROPDOWN by naming which operation is open and
+     * returning; the panel itself is rendered by the BAR, against the item's own trigger. Where no such
+     * trigger exists that is a button that sets a flag nobody reads — a dead control. This routes the
+     * same presentation to its documented degrade instead (`resolveActionPresentationTransition` maps
+     * both to an OVERLAY, never to the page the ordinary chain would otherwise produce).
      *
      * The single-variant branch already did exactly this through its `anchoredPanel ? … : …` ternary.
      * This exists so the subgroup branch stops being the one place the rule is not applied — it was
      * latent while nothing DERIVED a popover, and became reachable the moment the derivation did.
      */
     const handleUnanchorableOperationClick = useCallback((operation) => {
-        if (resolveResourceOperationActionPresentation(operation) === ResourceOperationActionPresentation.POPOVER) {
+        const presentation = resolveResourceOperationActionPresentation(operation);
+        if (presentation === ResourceOperationActionPresentation.POPOVER
+            || presentation === ResourceOperationActionPresentation.DROPDOWN) {
             handleNavigateOperation(operation);
             return;
         }
@@ -1289,8 +1308,10 @@ export function useResourceOperationActions(params) {
     const buildAnchoredPanel = useCallback((operation, label) => {
         const presentation = resolveResourceOperationActionPresentation(operation);
         /*
-         * INLINE degrades to an ANCHORED PANEL here, not to an overlay — and this is where the two
-         * non-navigating presentations meet.
+         * The three presentations that live in an ANCHORED PANEL meet here: POPOVER (a form), DROPDOWN
+         * (a list of values — its own body below), and INLINE where no row can transform.
+         *
+         * INLINE degrades to an ANCHORED PANEL here, not to an overlay.
          *
          * `INLINE` asks the ELEMENT being acted on to become the form, which needs a row to transform.
          * The same action also renders where there is none: a detail page, a danger zone, a picker, and
@@ -1310,6 +1331,7 @@ export function useResourceOperationActions(params) {
          * falls through to `onClick` only where no panel was built.
          */
         const wantsAnchoredPanel = presentation === ResourceOperationActionPresentation.POPOVER
+            || presentation === ResourceOperationActionPresentation.DROPDOWN
             || (presentation === ResourceOperationActionPresentation.INLINE && !inPlaceHost.isAvailable);
         if (!wantsAnchoredPanel) {
             return undefined;
@@ -1319,6 +1341,31 @@ export function useResourceOperationActions(params) {
         }
         const operationKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation);
         const dismiss = () => setOpenPopoverOperationKey(null);
+        // A DROPDOWN's body is the list of values — edge to edge, like any menu — and executes on a
+        // pick; everything else is the form. Both are detached hosts over the same operation view, so
+        // they execute through the same contract.
+        if (presentation === ResourceOperationActionPresentation.DROPDOWN) {
+            // The ✓ marks what the acted-on row holds now. Read through a ref at BUILD time — the panel is
+            // rebuilt when it opens, which is the moment the mark has to be right — so `currentObject`, which
+            // callers re-create every render, stays out of the memo's dependencies (see the note at `items`).
+            // A bulk action targets many rows and has no single current value to mark.
+            const choice = resolveResourceOperationDropdownChoice(operation);
+            const heldValue = operation.isBulkOperation === true || !choice
+                ? undefined
+                : currentObjectRef.current?.[choice.fieldName];
+            return {
+                open: openPopoverOperationKey === operationKey,
+                onOpenChange: (open) => setOpenPopoverOperationKey(open ? operationKey : null),
+                title: label,
+                chrome: ActionBarPopoverChrome.LIST,
+                content: React.createElement(ResourceOperationActionDropdownBody, {
+                    resourceContext: buildOperationContext(operation),
+                    navigationZone,
+                    onDismiss: dismiss,
+                    ...(typeof heldValue === 'string' ? { currentValue: heldValue } : {}),
+                }),
+            };
+        }
         return {
             open: openPopoverOperationKey === operationKey,
             onOpenChange: (open) => setOpenPopoverOperationKey(open ? operationKey : null),
@@ -1408,7 +1455,7 @@ export function useResourceOperationActions(params) {
             //
             // ## The second conjunct is new, and the first alone was wrong
             //
-            // This read `isRiskyOperation(riskLevel)` alone, which made risk the sole membership test for
+            // This read `isRiskyOperation(riskLevel)` alone (the helper since moved to `isRiskyResourceOperation`), which made risk the sole membership test for
             // the one surface that exists to mark the point of no return. Measured 2026-09-19 over
             // `engine/saas-models`: of 150 HIGH/CRITICAL variants the owning verbs are 48 DELETE — and
             // then 29 UPDATE_MANY, 14 CREATE, 9 UPDATE, plus `RESTORE`, `APPROVE`, `GRANT_OWNERSHIP`,
@@ -1424,7 +1471,7 @@ export function useResourceOperationActions(params) {
             // keeps a LOW-risk delete (a draft, a scratch row) out of a section reserved for consequential
             // acts. What it no longer does alone is decide permanence, which was never its question.
             const placement = defaultVariant.operationFrontendConfig?.actionPlacement
-                ?? ((isRiskyOperation(riskLevel) && isIrreversibleOperation(defaultVariant))
+                ?? ((isRiskyResourceOperation(riskLevel) && isIrreversibleOperation(defaultVariant))
                     ? ActionPlacement.DANGER_ZONE
                     : ActionPlacement.PRIMARY);
             // Surface filter: the main bar requests PRIMARY, the danger-zone section