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

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

@@ -0,0 +1,23 @@
+import type { FrontendResourceConfiguration_Operation, FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
+/**
+ * Announces that a form-hosted operation SUCCEEDED — the one place that does, for every host.
+ *
+ * Two things follow a successful operation, and neither belongs to whichever surface happened to
+ * host the form:
+ *
+ * 1. **`RESOURCE_OPERATION_EXECUTED`**, which is how the rest of the screen learns the write
+ *    happened: the bulk bar clears its selection on it, and outcome listeners key on its
+ *    discriminator.
+ * 2. **For a bulk write with no WebSocket connected, a local `RESOURCE_REFRESH` of the listing.**
+ *    With a socket, the backend's broadcast refreshes the list; without one, nothing would, and N
+ *    rows would keep showing their old values.
+ *
+ * Why it is a hook rather than code in each host: the update page emitted both, the operation
+ * fallback emitted the first ONLY when its host passed no `onSuccess`, and the anchored panel and
+ * the in-place row — which must pass one to close themselves — therefore emitted nothing. A bulk
+ * "Change status" from the panel wrote every row, closed, and left the list showing the old status
+ * with the rows still selected. Hosts now decide only what happens NEXT (navigate, close); whether
+ * the screen hears about the write is not theirs to omit.
+ */
+export declare function useResourceOperationOutcomeEmitter(resourceContext: FrontendResourceOperationContext, operation: FrontendResourceConfiguration_Operation<any, any, any>): (result: unknown) => void;
+//# sourceMappingURL=useResourceOperationOutcomeEmitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceOperationOutcomeEmitter.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationOutcomeEmitter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,uCAAuC,EACvC,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kCAAkC,CAChD,eAAe,EAAE,gCAAgC,EACjD,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CA6D3B"}

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

@@ -0,0 +1,85 @@
+import { useCallback, useContext, useMemo } from 'react';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { WebSocketContext } from '../../core/requests/websockets/WebSocketContext.js';
+import { getOperationsForCoreSemantic, readResourceOperationExecutedDiscriminator, toOperationResultSummary } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { FrontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { normalizeContextResourceIdentifiersForOutcome, normalizeContextResourceIdentifiersForTransport, } from '../../core/resources/context-resource-identifiers.frontend.utils.js';
+import { operationInitiatorParametersSatisfied } from '../../core/resources/operation-initiator-satisfaction.frontend.utils.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+/**
+ * Announces that a form-hosted operation SUCCEEDED — the one place that does, for every host.
+ *
+ * Two things follow a successful operation, and neither belongs to whichever surface happened to
+ * host the form:
+ *
+ * 1. **`RESOURCE_OPERATION_EXECUTED`**, which is how the rest of the screen learns the write
+ *    happened: the bulk bar clears its selection on it, and outcome listeners key on its
+ *    discriminator.
+ * 2. **For a bulk write with no WebSocket connected, a local `RESOURCE_REFRESH` of the listing.**
+ *    With a socket, the backend's broadcast refreshes the list; without one, nothing would, and N
+ *    rows would keep showing their old values.
+ *
+ * Why it is a hook rather than code in each host: the update page emitted both, the operation
+ * fallback emitted the first ONLY when its host passed no `onSuccess`, and the anchored panel and
+ * the in-place row — which must pass one to close themselves — therefore emitted nothing. A bulk
+ * "Change status" from the panel wrote every row, closed, and left the list showing the old status
+ * with the rows still selected. Hosts now decide only what happens NEXT (navigate, close); whether
+ * the screen hears about the write is not theirs to omit.
+ */
+export function useResourceOperationOutcomeEmitter(resourceContext, operation) {
+    const { emit } = useEventBus();
+    const webSocket = useContext(WebSocketContext);
+    const { registry } = useResourceRegistry();
+    const isWebSocketConnected = webSocket?.isConnected ?? false;
+    const listOperations = useMemo(() => {
+        const resourceConfig = registry.resourceConfigurations[resourceContext.resourceType];
+        const { [resourceContext.resourceType]: _self, ...parentScopeIdentifiers } = normalizeContextResourceIdentifiersForTransport(resourceContext.contextResourceIdentifiers);
+        const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(parentScopeIdentifiers, registry);
+        return getOperationsForCoreSemantic(resourceConfig?.operations ?? [], CoreResourceOperation.LIST).filter((listOperation) => operationInitiatorParametersSatisfied({
+            operation: listOperation,
+            contextResourceIdentifiers: parentScopeIdentifiers,
+            contextualParameters: parentContextualParameters,
+        }));
+    }, [resourceContext.contextResourceIdentifiers, resourceContext.resourceType, registry]);
+    return useCallback((result) => {
+        emit(FrontendEvents.RESOURCE_OPERATION_EXECUTED, {
+            resourceType: resourceContext.resourceType,
+            operationIdentifier: String(operation.operationIdentifier),
+            operation,
+            variantType: operation.variantType,
+            isOperationDefault: operation.isOperationDefault ?? true,
+            isBulkOperation: operation.isBulkOperation ?? false,
+            variantKey: operation.variantKey,
+            contextResourceIdentifiers: normalizeContextResourceIdentifiersForOutcome({
+                contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,
+                resourceType: resourceContext.resourceType,
+                result,
+                isBulkOperation: operation.isBulkOperation === true,
+            }),
+            parentResourcesRequirements: resourceContext.parentResourcesRequirements,
+            optionalDiscriminator: readResourceOperationExecutedDiscriminator(resourceContext.additionalContext),
+            resultSummary: toOperationResultSummary(result),
+        });
+        if (!operation.isBulkOperation || isWebSocketConnected) {
+            return;
+        }
+        const { [resourceContext.resourceType]: _self, ...parentScopeIdentifiers } = normalizeContextResourceIdentifiersForTransport(resourceContext.contextResourceIdentifiers);
+        const refreshTargets = listOperations.length > 0 ? listOperations : [null];
+        for (const listOperation of refreshTargets) {
+            emit(FrontendEvents.RESOURCE_REFRESH, {
+                resourceType: resourceContext.resourceType,
+                operationIdentifier: String(listOperation?.operationIdentifier ?? CoreResourceOperation.LIST),
+                operation: listOperation ?? { operationIdentifier: CoreResourceOperation.LIST },
+                variantType: listOperation?.variantType,
+                isOperationDefault: listOperation?.isOperationDefault ?? true,
+                isBulkOperation: listOperation?.isBulkOperation ?? false,
+                variantKey: listOperation?.variantKey,
+                contextResourceIdentifiers: parentScopeIdentifiers,
+                parentResourcesRequirements: resourceContext.parentResourcesRequirements,
+            });
+        }
+    }, [emit, isWebSocketConnected, listOperations, operation, resourceContext.additionalContext, resourceContext.contextResourceIdentifiers, resourceContext.parentResourcesRequirements, resourceContext.resourceType]);
+}
+//# sourceMappingURL=useResourceOperationOutcomeEmitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceOperationOutcomeEmitter.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationOutcomeEmitter.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo } from 'react';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { FrontendEvents, type FrontendEventResourceOperation } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { WebSocketContext } from '~wildo-frontend-lib/core/requests/websockets/WebSocketContext';\nimport { getOperationsForCoreSemantic, readResourceOperationExecutedDiscriminator, toOperationResultSummary } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  normalizeContextResourceIdentifiersForOutcome,\n  normalizeContextResourceIdentifiersForTransport,\n} from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport type {\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/**\n * Announces that a form-hosted operation SUCCEEDED — the one place that does, for every host.\n *\n * Two things follow a successful operation, and neither belongs to whichever surface happened to\n * host the form:\n *\n * 1. **`RESOURCE_OPERATION_EXECUTED`**, which is how the rest of the screen learns the write\n *    happened: the bulk bar clears its selection on it, and outcome listeners key on its\n *    discriminator.\n * 2. **For a bulk write with no WebSocket connected, a local `RESOURCE_REFRESH` of the listing.**\n *    With a socket, the backend's broadcast refreshes the list; without one, nothing would, and N\n *    rows would keep showing their old values.\n *\n * Why it is a hook rather than code in each host: the update page emitted both, the operation\n * fallback emitted the first ONLY when its host passed no `onSuccess`, and the anchored panel and\n * the in-place row — which must pass one to close themselves — therefore emitted nothing. A bulk\n * \"Change status\" from the panel wrote every row, closed, and left the list showing the old status\n * with the rows still selected. Hosts now decide only what happens NEXT (navigate, close); whether\n * the screen hears about the write is not theirs to omit.\n */\nexport function useResourceOperationOutcomeEmitter(\n  resourceContext: FrontendResourceOperationContext,\n  operation: FrontendResourceConfiguration_Operation<any, any, any>,\n): (result: unknown) => void {\n  const { emit } = useEventBus();\n  const webSocket = useContext(WebSocketContext);\n  const { registry } = useResourceRegistry();\n  const isWebSocketConnected = webSocket?.isConnected ?? false;\n\n  const listOperations = useMemo(() => {\n    const resourceConfig = registry.resourceConfigurations[resourceContext.resourceType];\n    const { [resourceContext.resourceType]: _self, ...parentScopeIdentifiers } = normalizeContextResourceIdentifiersForTransport(resourceContext.contextResourceIdentifiers);\n    const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(parentScopeIdentifiers, registry);\n    return getOperationsForCoreSemantic(\n      resourceConfig?.operations ?? [],\n      CoreResourceOperation.LIST,\n    ).filter((listOperation) =>\n      operationInitiatorParametersSatisfied({\n        operation: listOperation,\n        contextResourceIdentifiers: parentScopeIdentifiers,\n        contextualParameters: parentContextualParameters,\n      })\n    );\n  }, [resourceContext.contextResourceIdentifiers, resourceContext.resourceType, registry]);\n\n  return useCallback((result: unknown) => {\n    emit(FrontendEvents.RESOURCE_OPERATION_EXECUTED, {\n      resourceType: resourceContext.resourceType,\n      operationIdentifier: String(operation.operationIdentifier),\n      operation,\n      variantType: operation.variantType,\n      isOperationDefault: operation.isOperationDefault ?? true,\n      isBulkOperation: operation.isBulkOperation ?? false,\n      variantKey: operation.variantKey,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForOutcome({\n        contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,\n        resourceType: resourceContext.resourceType,\n        result,\n        isBulkOperation: operation.isBulkOperation === true,\n      }),\n      parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n      optionalDiscriminator: readResourceOperationExecutedDiscriminator(resourceContext.additionalContext),\n      resultSummary: toOperationResultSummary(result),\n    } satisfies FrontendEventResourceOperation);\n\n    if (!operation.isBulkOperation || isWebSocketConnected) {\n      return;\n    }\n    const { [resourceContext.resourceType]: _self, ...parentScopeIdentifiers } = normalizeContextResourceIdentifiersForTransport(resourceContext.contextResourceIdentifiers);\n    const refreshTargets = listOperations.length > 0 ? listOperations : [null];\n    for (const listOperation of refreshTargets) {\n      emit(FrontendEvents.RESOURCE_REFRESH, {\n        resourceType: resourceContext.resourceType,\n        operationIdentifier: String(listOperation?.operationIdentifier ?? CoreResourceOperation.LIST),\n        operation: listOperation ?? ({ operationIdentifier: CoreResourceOperation.LIST } as FrontendEventResourceOperation['operation']),\n        variantType: listOperation?.variantType,\n        isOperationDefault: listOperation?.isOperationDefault ?? true,\n        isBulkOperation: listOperation?.isBulkOperation ?? false,\n        variantKey: listOperation?.variantKey,\n        contextResourceIdentifiers: parentScopeIdentifiers,\n        parentResourcesRequirements: resourceContext.parentResourcesRequirements,\n      } satisfies FrontendEventResourceOperation);\n    }\n  }, [emit, isWebSocketConnected, listOperations, operation, resourceContext.additionalContext, resourceContext.contextResourceIdentifiers, resourceContext.parentResourcesRequirements, resourceContext.resourceType]);\n}\n"]}

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

@@ -43,6 +43,11 @@ interface NavigateToPreferredReadOptions {
 interface ResolvePreferredOperationOptions {
     requireAddressable?: boolean;
     allowBulk?: boolean;
+    /**
+     * Refuse an operation that merely BORROWS `coreOperation` through `resourceOperationLike` — see
+     * `getOperationsForCoreSemantic`. For callers that supply the operation's words themselves.
+     */
+    requireLiteralIdentifier?: boolean;
 }
 export interface UseResourceOperationSurfaceParams {
     resourceContext: FrontendResourceOperationContext;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceOperationSurface.js","sourceRoot":"","sources":["../../../../src/core/resources/useResourceOperationSurface.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  ResourcesConfig_OperationPathUtils,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n  type TransitionConfig,\n} from '@wildo-ai/saas-models';\nimport { useError } from '~wildo-frontend-lib/core/errors/useError';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport type {\n  NavigationInitiatorContext,\n  NavigationZone,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport {\n  isSingleResourceUpdateLikeOperation,\n  isUpdateLikeCoreOperation,\n  mergeBulkSelectionIntoRequestData,\n  isSemanticCustomResourceOperation,\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n  resolveResourceOperationLayoutKind,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  pickPreferredOperationForCoreSemanticAddressability,\n  shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\n\ninterface NavigateToResourceOperationOptions {\n  operation: FrontendResourceConfiguration_Operation;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  parentResourcesRequirements?: FrontendResourceOperationContext['parentResourcesRequirements'];\n  initiatorOverride?: NavigationInitiatorContext;\n  /**\n   * Caller-forced navigation transition that overrides source-zone policy.\n   * Used to break a follow-up navigation out of a transient overlay (e.g. a\n   * post-create reveal that must `PROMOTE` into a structural zone rather than\n   * stack inside the create dialog).\n   */\n  transitionOverride?: TransitionConfig;\n}\n\ninterface NavigateToPreferredReadOptions {\n  /**\n   * Override map for the navigation target's resource context. When\n   * provided, replaces the component's `effectiveResourceContext.contextResourceIdentifiers`\n   * (post-create flows pass `{ [resourceType]: createdResourceId }` here so\n   * the resolver can prove the new READ surface is addressable).\n   *\n   * The override is then passed through `injectResourceIdEvidence` so the\n   * component's `additionalContextResourceId` (when present) is layered on\n   * top — same augmentation the fallback path receives. Callers do NOT\n   * have to mirror that step manually.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  parentResourcesRequirements?: FrontendResourceOperationContext['parentResourcesRequirements'];\n  fallbackToGoBack?: boolean;\n  initiatorOverride?: NavigationInitiatorContext;\n  /**\n   * Caller-forced navigation transition that overrides source-zone policy —\n   * forwarded to `navigateToResourceOperation`. Post-create flows hosted in an\n   * overlay pass `PROMOTE` here so the READ reveal breaks out of the dialog.\n   */\n  transitionOverride?: TransitionConfig;\n}\n\ninterface ResolvePreferredOperationOptions {\n  requireAddressable?: boolean;\n  allowBulk?: boolean;\n}\n\nexport interface UseResourceOperationSurfaceParams {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  /**\n   * Controls whether `executeCurrentOperation()` may directly execute\n   * update-like operations without RMM participation. Defaults to\n   * `RMM_REQUIRED` so update-family callers must classify the weaker-guarantee\n   * direct lane explicitly.\n   */\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ResourceOperationSurface {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  resourceType: string;\n  operation: FrontendResourceConfiguration_Operation;\n  operationId: string;\n  resourceConfig?: AnyFrontendResourceConfiguration;\n  effectiveCoreOperation?: CoreResourceOperation;\n  isSemanticCustomOperation: boolean;\n  operationInitiator: ReturnType<typeof NavigationUtils.createOperationInitiator>;\n  contextualParameters: ReturnType<typeof FrontendResourceUtils.buildContextualParameters>;\n  goBackWithinZone: () => void;\n  reportError: (error: Error, message: string, component: string) => void;\n  /**\n   * Executes the currently hosted operation. Read/create/action execution stays\n   * direct. Update-like execution fails closed by default unless the caller\n   * explicitly opts into `DIRECT_OPERATION_FALLBACK`, because this headless\n   * seam does not attach an RMM instance on its own. Even when the operation is\n   * semantically update-like, this direct fallback lane must not be described as\n   * carrying the same guaranteed authoritative conflict-detail contract as the\n   * single-resource RMM-backed path.\n   */\n  executeCurrentOperation: (requestData?: Record<string, unknown>) => Promise<unknown>;\n  resolvePreferredOperation: (\n    coreOperation: CoreResourceOperation,\n    options?: ResolvePreferredOperationOptions,\n  ) => FrontendResourceConfiguration_Operation | undefined;\n  navigateToResourceOperation: (options: NavigateToResourceOperationOptions) => boolean;\n  navigateToPreferredRead: (options?: NavigateToPreferredReadOptions) => boolean;\n}\n\nfunction buildResourceOperationSurfaceConfigurationError(\n  hookName: string,\n  expectedKind: string,\n  actualKind: string,\n  operationIdentifier: string,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      component: hookName,\n      message: `${hookName}() requires a ${expectedKind}-like operation host, but received \"${actualKind}\" for operation \"${operationIdentifier}\".`,\n      expectedKind,\n      actualKind,\n      operationIdentifier,\n    },\n  );\n}\n\nfunction getAdditionalContextCurrentObject(\n  additionalContext?: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const currentObject = additionalContext?.currentObject ?? additionalContext?.resource;\n  return currentObject && typeof currentObject === 'object' && !Array.isArray(currentObject)\n    ? currentObject as Record<string, unknown>\n    : undefined;\n}\n\nfunction injectResourceIdEvidence(\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  resourceType: string,\n  resourceId: string | undefined,\n): FrontendResourceOperationContext['contextResourceIdentifiers'] {\n  if (!resourceId) {\n    return contextResourceIdentifiers;\n  }\n\n  const currentValue = contextResourceIdentifiers[resourceType];\n  if (frontendResourceUtils.getResourceId(currentValue) === resourceId) {\n    return contextResourceIdentifiers;\n  }\n\n  const fieldIdentifier = currentValue\n    ? frontendResourceUtils.getFieldIdentifier(currentValue)\n    : undefined;\n  return {\n    ...contextResourceIdentifiers,\n    [resourceType]: fieldIdentifier\n      ? { fieldIdentifier, resourceId }\n      : resourceId,\n  };\n}\n\n/**\n * Headless runtime seam for a rendered resource operation surface.\n *\n * It centralizes the semantics and navigation behavior that resource layouts\n * were previously re-implementing ad hoc: operation identity, semantic-custom\n * detection, initiator construction, error reporting, and navigation toward the\n * preferred addressable READ surface.\n */\nexport function useResourceOperationSurface({\n  resourceContext,\n  navigationZone,\n  navigationInitiator,\n  updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n}: UseResourceOperationSurfaceParams): ResourceOperationSurface {\n  const { registry, doOperation } = useResourceRegistry();\n  const { navigateToResource, goBack } = useNavigationController();\n  const { handleError: contextHandleError } = useError();\n\n  const { resourceType, operation } = resourceContext;\n  const operationId = String(operation.operationIdentifier);\n\n  const resourceConfig = useMemo(() => {\n    return registry.resourceConfigurations[resourceType];\n  }, [registry, resourceType]);\n\n  const effectiveCoreOperation = useMemo(() => {\n    return resolveEffectiveCoreOperationFromOperation(operation);\n  }, [operation]);\n\n  const isSemanticCustomOperation = useMemo(() => {\n    return isSemanticCustomResourceOperation(operation);\n  }, [operation]);\n\n  const operationInitiator = useMemo(() => {\n    return NavigationUtils.createOperationInitiator(navigationZone, operationId);\n  }, [navigationZone, operationId]);\n\n  const additionalContextCurrentObject = useMemo(\n    () => getAdditionalContextCurrentObject(resourceContext.additionalContext),\n    [resourceContext.additionalContext],\n  );\n  const additionalContextResourceId = useMemo(() => {\n    const candidate = additionalContextCurrentObject?._id\n      ?? (resourceConfig?.resourceFieldIdentifier\n        ? additionalContextCurrentObject?.[resourceConfig.resourceFieldIdentifier]\n        : undefined);\n    return typeof candidate === 'string' && candidate.length > 0\n      ? candidate\n      : undefined;\n  }, [additionalContextCurrentObject, resourceConfig?.resourceFieldIdentifier]);\n  const contextResourceIdentifiersWithIdEvidence = useMemo(\n    () => injectResourceIdEvidence(\n      resourceContext.contextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    ),\n    [\n      additionalContextResourceId,\n      resourceContext.contextResourceIdentifiers,\n      resourceType,\n    ],\n  );\n  const effectiveResourceContext = useMemo(\n    () => ({\n      ...resourceContext,\n      contextResourceIdentifiers: contextResourceIdentifiersWithIdEvidence,\n    }),\n    [contextResourceIdentifiersWithIdEvidence, resourceContext],\n  );\n  const contextualParameters = useMemo(() => {\n    return FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiersWithIdEvidence,\n      registry,\n    );\n  }, [contextResourceIdentifiersWithIdEvidence, registry]);\n  const hasResourceIdEvidence = useCallback((\n    contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  ) => Boolean(\n    frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType])\n  ), [resourceType]);\n\n  const goBackWithinZone = useCallback(() => {\n    goBack(navigationZone);\n  }, [goBack, navigationZone]);\n\n  const reportError = useCallback((error: Error, message: string, component: string) => {\n    contextHandleError(error, message, {\n      resourceType,\n      operationId,\n      navigationZone,\n      component,\n    });\n  }, [contextHandleError, navigationZone, operationId, resourceType]);\n\n  const executeCurrentOperation = useCallback(async (requestData?: Record<string, unknown>) => {\n    if (\n      isSingleResourceUpdateLikeOperation(operation)\n      && !allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n    ) {\n      throw new MissingRMMRuntimeError({\n        surfaceName: 'useResourceOperationSurface.executeCurrentOperation()',\n        resourceType,\n        operationIdentifier: operationId,\n      });\n    }\n\n    const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation);\n    const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n      operation,\n      requestData,\n      additionalContext: effectiveResourceContext.additionalContext,\n    });\n\n    return doOperation(operationPathKey, {\n      contextualParameters,\n      parentResourcesRequirements: effectiveResourceContext.parentResourcesRequirements,\n      ...(effectiveRequestData ? { requestData: effectiveRequestData } : {}),\n    });\n  }, [\n    contextualParameters,\n    doOperation,\n    operation,\n    operationId,\n    effectiveResourceContext.additionalContext,\n    effectiveResourceContext.parentResourcesRequirements,\n    resourceType,\n    updateLikeMutationFallbackMode,\n  ]);\n\n  const resolvePreferredOperation = useCallback((\n    coreOperation: CoreResourceOperation,\n    options?: ResolvePreferredOperationOptions,\n  ): FrontendResourceConfiguration_Operation | undefined => {\n    if (!resourceConfig) {\n      return undefined;\n    }\n\n    const requiresRuntimeAddressability = coreOperation === CoreResourceOperation.READ\n      || coreOperation === CoreResourceOperation.UPDATE\n      || coreOperation === CoreResourceOperation.DELETE;\n\n    if (requiresRuntimeAddressability) {\n      return pickPreferredOperationForCoreSemanticAddressability({\n        resourceConfig,\n        operations: resourceConfig.operations ?? [],\n        coreOperation,\n        registry,\n        hasResourceId: hasResourceIdEvidence(contextResourceIdentifiersWithIdEvidence),\n        allowBulk: options?.allowBulk,\n        requireFrontendAddressable: true,\n        contextResourceIdentifiers: contextResourceIdentifiersWithIdEvidence,\n        contextualParameters,\n      });\n    }\n\n    return pickPreferredOperationForCoreSemantic(\n      resourceConfig.operations ?? [],\n      coreOperation,\n      options,\n    );\n  }, [\n    contextualParameters,\n    hasResourceIdEvidence,\n    registry,\n    resourceConfig,\n    contextResourceIdentifiersWithIdEvidence,\n  ]);\n\n  const navigateToResourceOperation = useCallback(({\n    operation: targetOperation,\n    contextResourceIdentifiers = effectiveResourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = effectiveResourceContext.parentResourcesRequirements,\n    initiatorOverride,\n    transitionOverride,\n  }: NavigateToResourceOperationOptions): boolean => {\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = injectResourceIdEvidence(\n      contextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    );\n    const targetContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      targetContextResourceIdentifiers,\n      registry,\n    );\n    const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n      operation: targetOperation,\n      resourceType,\n      resourceConfig,\n    });\n    if (\n      requiresAddressability\n      && targetOperation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig,\n        operation: targetOperation,\n        registry,\n        hasResourceId: hasResourceIdEvidence(targetContextResourceIdentifiers),\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n        contextualParameters: targetContextualParameters,\n      })\n    ) {\n      return false;\n    }\n\n    const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType,\n      operation: targetOperation,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      targetOperation,\n      registry.allResourceFieldIdentifiers,\n    );\n    const urlPath = routePaths.length > 0\n      ? frontendResourceUtils.selectMatchingRoutePath(\n          routePaths,\n          targetContext.contextResourceIdentifiers,\n          resourceType,\n          resourceConfig.resourceFieldIdentifier,\n          parentResourcesRequirements,\n          registry.allResourceFieldIdentifiers,\n        ).url\n      : undefined;\n\n    navigateToResource(\n      targetContext,\n      initiatorOverride ?? operationInitiator,\n      urlPath,\n      transitionOverride,\n    );\n\n    return true;\n  }, [\n    navigateToResource,\n    operationInitiator,\n    registry,\n    resourceConfig,\n    effectiveResourceContext.contextResourceIdentifiers,\n    effectiveResourceContext.parentResourcesRequirements,\n    resourceType,\n    hasResourceIdEvidence,\n    additionalContextResourceId,\n  ]);\n\n  const navigateToPreferredRead = useCallback((options?: NavigateToPreferredReadOptions): boolean => {\n    if (!resourceConfig) {\n      if (options?.fallbackToGoBack !== false) {\n        goBackWithinZone();\n      }\n      return false;\n    }\n\n    // Resolve the READ operation against the *target* context — typically the\n    // current context augmented with a freshly-created resource id (post-create\n    // flows pass `{ [resourceType]: createdResourceId }` here). Falling back to\n    // the component's current context would miss that new id and reject every\n    // addressable READ, defeating the intent of this helper.\n    //\n    // Run BOTH branches through `injectResourceIdEvidence` so the override\n    // path inherits the same `additionalContextResourceId` augmentation the\n    // fallback path gets via `effectiveResourceContext`. Without this parity,\n    // an override that omits `[resourceType]` (e.g. a caller that knows it\n    // has a parent-context-singleton route but doesn't have a child id yet)\n    // would silently miss the additional-context evidence that\n    // `navigateToResourceOperation` later relies on.\n    const baseTargetContextResourceIdentifiers = options?.contextResourceIdentifiers\n      ?? effectiveResourceContext.contextResourceIdentifiers;\n    const targetContextResourceIdentifiers = injectResourceIdEvidence(\n      baseTargetContextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    );\n    const targetParentResourcesRequirements = options?.parentResourcesRequirements\n      ?? effectiveResourceContext.parentResourcesRequirements;\n    const targetContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      targetContextResourceIdentifiers,\n      registry,\n    );\n    const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: hasResourceIdEvidence(targetContextResourceIdentifiers),\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      contextualParameters: targetContextualParameters,\n    });\n\n    if (!readOperation) {\n      if (options?.fallbackToGoBack !== false) {\n        goBackWithinZone();\n      }\n      return false;\n    }\n\n    return navigateToResourceOperation({\n      operation: readOperation,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      parentResourcesRequirements: targetParentResourcesRequirements,\n      initiatorOverride: options?.initiatorOverride,\n      transitionOverride: options?.transitionOverride,\n    });\n  }, [\n    additionalContextResourceId,\n    goBackWithinZone,\n    hasResourceIdEvidence,\n    navigateToResourceOperation,\n    registry,\n    resourceConfig,\n    resourceType,\n    effectiveResourceContext.contextResourceIdentifiers,\n    effectiveResourceContext.parentResourcesRequirements,\n  ]);\n\n  return {\n    resourceContext: effectiveResourceContext,\n    navigationZone,\n    navigationInitiator,\n    resourceType,\n    operation,\n    operationId,\n    resourceConfig,\n    effectiveCoreOperation,\n    isSemanticCustomOperation,\n    operationInitiator,\n    contextualParameters,\n    goBackWithinZone,\n    reportError,\n    executeCurrentOperation,\n    resolvePreferredOperation,\n    navigateToResourceOperation,\n    navigateToPreferredRead,\n  };\n}\n\nfunction useResourceOperationSurfaceByLayoutKind(\n  params: UseResourceOperationSurfaceParams,\n  expectedKind: 'read' | 'list' | 'create' | 'update' | 'search' | 'action',\n  hookName: string,\n): ResourceOperationSurface {\n  const surface = useResourceOperationSurface(params);\n  const actualKind = resolveResourceOperationLayoutKind(surface.operation);\n\n  if (actualKind !== expectedKind) {\n    throw buildResourceOperationSurfaceConfigurationError(\n      hookName,\n      expectedKind,\n      actualKind,\n      surface.operationId,\n    );\n  }\n\n  return surface;\n}\n\nexport function useReadOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'read', 'useReadOperationSurface');\n}\n\nexport function useListOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'list', 'useListOperationSurface');\n}\n\nexport function useCreateOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'create', 'useCreateOperationSurface');\n}\n\nexport function useUpdateOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'update', 'useUpdateOperationSurface');\n}\n\nexport function useSearchOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'search', 'useSearchOperationSurface');\n}\n\nexport function useActionOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'action', 'useActionOperationSurface');\n}\n\n"]}
+{"version":3,"file":"useResourceOperationSurface.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceOperationSurface.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  ResourcesConfig_OperationPathUtils,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n  type TransitionConfig,\n} from '@wildo-ai/saas-models';\nimport { useError } from '~wildo-frontend-lib/core/errors/useError';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport type {\n  NavigationInitiatorContext,\n  NavigationZone,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  allowsDirectOperationFallback,\n  MissingRMMRuntimeError,\n  UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport {\n  isSingleResourceUpdateLikeOperation,\n  isUpdateLikeCoreOperation,\n  mergeBulkSelectionIntoRequestData,\n  isSemanticCustomResourceOperation,\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n  resolveResourceOperationLayoutKind,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport {\n  isFrontendOperationAddressableForCurrentContext,\n  pickPreferredOperationForCoreSemanticAddressability,\n  shouldRequireCurrentContextAddressabilityForOperation,\n} from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\n\ninterface NavigateToResourceOperationOptions {\n  operation: FrontendResourceConfiguration_Operation;\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  parentResourcesRequirements?: FrontendResourceOperationContext['parentResourcesRequirements'];\n  initiatorOverride?: NavigationInitiatorContext;\n  /**\n   * Caller-forced navigation transition that overrides source-zone policy.\n   * Used to break a follow-up navigation out of a transient overlay (e.g. a\n   * post-create reveal that must `PROMOTE` into a structural zone rather than\n   * stack inside the create dialog).\n   */\n  transitionOverride?: TransitionConfig;\n}\n\ninterface NavigateToPreferredReadOptions {\n  /**\n   * Override map for the navigation target's resource context. When\n   * provided, replaces the component's `effectiveResourceContext.contextResourceIdentifiers`\n   * (post-create flows pass `{ [resourceType]: createdResourceId }` here so\n   * the resolver can prove the new READ surface is addressable).\n   *\n   * The override is then passed through `injectResourceIdEvidence` so the\n   * component's `additionalContextResourceId` (when present) is layered on\n   * top — same augmentation the fallback path receives. Callers do NOT\n   * have to mirror that step manually.\n   */\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  parentResourcesRequirements?: FrontendResourceOperationContext['parentResourcesRequirements'];\n  fallbackToGoBack?: boolean;\n  initiatorOverride?: NavigationInitiatorContext;\n  /**\n   * Caller-forced navigation transition that overrides source-zone policy —\n   * forwarded to `navigateToResourceOperation`. Post-create flows hosted in an\n   * overlay pass `PROMOTE` here so the READ reveal breaks out of the dialog.\n   */\n  transitionOverride?: TransitionConfig;\n}\n\ninterface ResolvePreferredOperationOptions {\n  requireAddressable?: boolean;\n  allowBulk?: boolean;\n  /**\n   * Refuse an operation that merely BORROWS `coreOperation` through `resourceOperationLike` — see\n   * `getOperationsForCoreSemantic`. For callers that supply the operation's words themselves.\n   */\n  requireLiteralIdentifier?: boolean;\n}\n\nexport interface UseResourceOperationSurfaceParams {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  /**\n   * Controls whether `executeCurrentOperation()` may directly execute\n   * update-like operations without RMM participation. Defaults to\n   * `RMM_REQUIRED` so update-family callers must classify the weaker-guarantee\n   * direct lane explicitly.\n   */\n  updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n}\n\nexport interface ResourceOperationSurface {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  resourceType: string;\n  operation: FrontendResourceConfiguration_Operation;\n  operationId: string;\n  resourceConfig?: AnyFrontendResourceConfiguration;\n  effectiveCoreOperation?: CoreResourceOperation;\n  isSemanticCustomOperation: boolean;\n  operationInitiator: ReturnType<typeof NavigationUtils.createOperationInitiator>;\n  contextualParameters: ReturnType<typeof FrontendResourceUtils.buildContextualParameters>;\n  goBackWithinZone: () => void;\n  reportError: (error: Error, message: string, component: string) => void;\n  /**\n   * Executes the currently hosted operation. Read/create/action execution stays\n   * direct. Update-like execution fails closed by default unless the caller\n   * explicitly opts into `DIRECT_OPERATION_FALLBACK`, because this headless\n   * seam does not attach an RMM instance on its own. Even when the operation is\n   * semantically update-like, this direct fallback lane must not be described as\n   * carrying the same guaranteed authoritative conflict-detail contract as the\n   * single-resource RMM-backed path.\n   */\n  executeCurrentOperation: (requestData?: Record<string, unknown>) => Promise<unknown>;\n  resolvePreferredOperation: (\n    coreOperation: CoreResourceOperation,\n    options?: ResolvePreferredOperationOptions,\n  ) => FrontendResourceConfiguration_Operation | undefined;\n  navigateToResourceOperation: (options: NavigateToResourceOperationOptions) => boolean;\n  navigateToPreferredRead: (options?: NavigateToPreferredReadOptions) => boolean;\n}\n\nfunction buildResourceOperationSurfaceConfigurationError(\n  hookName: string,\n  expectedKind: string,\n  actualKind: string,\n  operationIdentifier: string,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      component: hookName,\n      message: `${hookName}() requires a ${expectedKind}-like operation host, but received \"${actualKind}\" for operation \"${operationIdentifier}\".`,\n      expectedKind,\n      actualKind,\n      operationIdentifier,\n    },\n  );\n}\n\nfunction getAdditionalContextCurrentObject(\n  additionalContext?: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const currentObject = additionalContext?.currentObject ?? additionalContext?.resource;\n  return currentObject && typeof currentObject === 'object' && !Array.isArray(currentObject)\n    ? currentObject as Record<string, unknown>\n    : undefined;\n}\n\nfunction injectResourceIdEvidence(\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  resourceType: string,\n  resourceId: string | undefined,\n): FrontendResourceOperationContext['contextResourceIdentifiers'] {\n  if (!resourceId) {\n    return contextResourceIdentifiers;\n  }\n\n  const currentValue = contextResourceIdentifiers[resourceType];\n  if (frontendResourceUtils.getResourceId(currentValue) === resourceId) {\n    return contextResourceIdentifiers;\n  }\n\n  const fieldIdentifier = currentValue\n    ? frontendResourceUtils.getFieldIdentifier(currentValue)\n    : undefined;\n  return {\n    ...contextResourceIdentifiers,\n    [resourceType]: fieldIdentifier\n      ? { fieldIdentifier, resourceId }\n      : resourceId,\n  };\n}\n\n/**\n * Headless runtime seam for a rendered resource operation surface.\n *\n * It centralizes the semantics and navigation behavior that resource layouts\n * were previously re-implementing ad hoc: operation identity, semantic-custom\n * detection, initiator construction, error reporting, and navigation toward the\n * preferred addressable READ surface.\n */\nexport function useResourceOperationSurface({\n  resourceContext,\n  navigationZone,\n  navigationInitiator,\n  updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n}: UseResourceOperationSurfaceParams): ResourceOperationSurface {\n  const { registry, doOperation } = useResourceRegistry();\n  const { navigateToResource, goBack } = useNavigationController();\n  const { handleError: contextHandleError } = useError();\n\n  const { resourceType, operation } = resourceContext;\n  const operationId = String(operation.operationIdentifier);\n\n  const resourceConfig = useMemo(() => {\n    return registry.resourceConfigurations[resourceType];\n  }, [registry, resourceType]);\n\n  const effectiveCoreOperation = useMemo(() => {\n    return resolveEffectiveCoreOperationFromOperation(operation);\n  }, [operation]);\n\n  const isSemanticCustomOperation = useMemo(() => {\n    return isSemanticCustomResourceOperation(operation);\n  }, [operation]);\n\n  const operationInitiator = useMemo(() => {\n    return NavigationUtils.createOperationInitiator(navigationZone, operationId);\n  }, [navigationZone, operationId]);\n\n  const additionalContextCurrentObject = useMemo(\n    () => getAdditionalContextCurrentObject(resourceContext.additionalContext),\n    [resourceContext.additionalContext],\n  );\n  const additionalContextResourceId = useMemo(() => {\n    const candidate = additionalContextCurrentObject?._id\n      ?? (resourceConfig?.resourceFieldIdentifier\n        ? additionalContextCurrentObject?.[resourceConfig.resourceFieldIdentifier]\n        : undefined);\n    return typeof candidate === 'string' && candidate.length > 0\n      ? candidate\n      : undefined;\n  }, [additionalContextCurrentObject, resourceConfig?.resourceFieldIdentifier]);\n  const contextResourceIdentifiersWithIdEvidence = useMemo(\n    () => injectResourceIdEvidence(\n      resourceContext.contextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    ),\n    [\n      additionalContextResourceId,\n      resourceContext.contextResourceIdentifiers,\n      resourceType,\n    ],\n  );\n  const effectiveResourceContext = useMemo(\n    () => ({\n      ...resourceContext,\n      contextResourceIdentifiers: contextResourceIdentifiersWithIdEvidence,\n    }),\n    [contextResourceIdentifiersWithIdEvidence, resourceContext],\n  );\n  const contextualParameters = useMemo(() => {\n    return FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiersWithIdEvidence,\n      registry,\n    );\n  }, [contextResourceIdentifiersWithIdEvidence, registry]);\n  const hasResourceIdEvidence = useCallback((\n    contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n  ) => Boolean(\n    frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType])\n  ), [resourceType]);\n\n  const goBackWithinZone = useCallback(() => {\n    goBack(navigationZone);\n  }, [goBack, navigationZone]);\n\n  const reportError = useCallback((error: Error, message: string, component: string) => {\n    contextHandleError(error, message, {\n      resourceType,\n      operationId,\n      navigationZone,\n      component,\n    });\n  }, [contextHandleError, navigationZone, operationId, resourceType]);\n\n  const executeCurrentOperation = useCallback(async (requestData?: Record<string, unknown>) => {\n    if (\n      isSingleResourceUpdateLikeOperation(operation)\n      && !allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n    ) {\n      throw new MissingRMMRuntimeError({\n        surfaceName: 'useResourceOperationSurface.executeCurrentOperation()',\n        resourceType,\n        operationIdentifier: operationId,\n      });\n    }\n\n    const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation);\n    const effectiveRequestData = mergeBulkSelectionIntoRequestData({\n      operation,\n      requestData,\n      additionalContext: effectiveResourceContext.additionalContext,\n    });\n\n    return doOperation(operationPathKey, {\n      contextualParameters,\n      parentResourcesRequirements: effectiveResourceContext.parentResourcesRequirements,\n      ...(effectiveRequestData ? { requestData: effectiveRequestData } : {}),\n    });\n  }, [\n    contextualParameters,\n    doOperation,\n    operation,\n    operationId,\n    effectiveResourceContext.additionalContext,\n    effectiveResourceContext.parentResourcesRequirements,\n    resourceType,\n    updateLikeMutationFallbackMode,\n  ]);\n\n  const resolvePreferredOperation = useCallback((\n    coreOperation: CoreResourceOperation,\n    options?: ResolvePreferredOperationOptions,\n  ): FrontendResourceConfiguration_Operation | undefined => {\n    if (!resourceConfig) {\n      return undefined;\n    }\n\n    const requiresRuntimeAddressability = coreOperation === CoreResourceOperation.READ\n      || coreOperation === CoreResourceOperation.UPDATE\n      || coreOperation === CoreResourceOperation.DELETE;\n\n    if (requiresRuntimeAddressability) {\n      return pickPreferredOperationForCoreSemanticAddressability({\n        resourceConfig,\n        operations: resourceConfig.operations ?? [],\n        coreOperation,\n        registry,\n        hasResourceId: hasResourceIdEvidence(contextResourceIdentifiersWithIdEvidence),\n        allowBulk: options?.allowBulk,\n        requireFrontendAddressable: true,\n        contextResourceIdentifiers: contextResourceIdentifiersWithIdEvidence,\n        contextualParameters,\n      });\n    }\n\n    return pickPreferredOperationForCoreSemantic(\n      resourceConfig.operations ?? [],\n      coreOperation,\n      options,\n    );\n  }, [\n    contextualParameters,\n    hasResourceIdEvidence,\n    registry,\n    resourceConfig,\n    contextResourceIdentifiersWithIdEvidence,\n  ]);\n\n  const navigateToResourceOperation = useCallback(({\n    operation: targetOperation,\n    contextResourceIdentifiers = effectiveResourceContext.contextResourceIdentifiers,\n    parentResourcesRequirements = effectiveResourceContext.parentResourcesRequirements,\n    initiatorOverride,\n    transitionOverride,\n  }: NavigateToResourceOperationOptions): boolean => {\n    if (!resourceConfig) {\n      return false;\n    }\n\n    const targetContextResourceIdentifiers = injectResourceIdEvidence(\n      contextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    );\n    const targetContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      targetContextResourceIdentifiers,\n      registry,\n    );\n    const requiresAddressability = shouldRequireCurrentContextAddressabilityForOperation({\n      operation: targetOperation,\n      resourceType,\n      resourceConfig,\n    });\n    if (\n      requiresAddressability\n      && targetOperation.isBulkOperation !== true\n      && !isFrontendOperationAddressableForCurrentContext({\n        resourceConfig,\n        operation: targetOperation,\n        registry,\n        hasResourceId: hasResourceIdEvidence(targetContextResourceIdentifiers),\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n        contextualParameters: targetContextualParameters,\n      })\n    ) {\n      return false;\n    }\n\n    const targetContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType,\n      operation: targetOperation,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      targetOperation,\n      registry.allResourceFieldIdentifiers,\n    );\n    const urlPath = routePaths.length > 0\n      ? frontendResourceUtils.selectMatchingRoutePath(\n          routePaths,\n          targetContext.contextResourceIdentifiers,\n          resourceType,\n          resourceConfig.resourceFieldIdentifier,\n          parentResourcesRequirements,\n          registry.allResourceFieldIdentifiers,\n        ).url\n      : undefined;\n\n    navigateToResource(\n      targetContext,\n      initiatorOverride ?? operationInitiator,\n      urlPath,\n      transitionOverride,\n    );\n\n    return true;\n  }, [\n    navigateToResource,\n    operationInitiator,\n    registry,\n    resourceConfig,\n    effectiveResourceContext.contextResourceIdentifiers,\n    effectiveResourceContext.parentResourcesRequirements,\n    resourceType,\n    hasResourceIdEvidence,\n    additionalContextResourceId,\n  ]);\n\n  const navigateToPreferredRead = useCallback((options?: NavigateToPreferredReadOptions): boolean => {\n    if (!resourceConfig) {\n      if (options?.fallbackToGoBack !== false) {\n        goBackWithinZone();\n      }\n      return false;\n    }\n\n    // Resolve the READ operation against the *target* context — typically the\n    // current context augmented with a freshly-created resource id (post-create\n    // flows pass `{ [resourceType]: createdResourceId }` here). Falling back to\n    // the component's current context would miss that new id and reject every\n    // addressable READ, defeating the intent of this helper.\n    //\n    // Run BOTH branches through `injectResourceIdEvidence` so the override\n    // path inherits the same `additionalContextResourceId` augmentation the\n    // fallback path gets via `effectiveResourceContext`. Without this parity,\n    // an override that omits `[resourceType]` (e.g. a caller that knows it\n    // has a parent-context-singleton route but doesn't have a child id yet)\n    // would silently miss the additional-context evidence that\n    // `navigateToResourceOperation` later relies on.\n    const baseTargetContextResourceIdentifiers = options?.contextResourceIdentifiers\n      ?? effectiveResourceContext.contextResourceIdentifiers;\n    const targetContextResourceIdentifiers = injectResourceIdEvidence(\n      baseTargetContextResourceIdentifiers,\n      resourceType,\n      additionalContextResourceId,\n    );\n    const targetParentResourcesRequirements = options?.parentResourcesRequirements\n      ?? effectiveResourceContext.parentResourcesRequirements;\n    const targetContextualParameters = FrontendResourceUtils.buildContextualParameters(\n      targetContextResourceIdentifiers,\n      registry,\n    );\n    const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: hasResourceIdEvidence(targetContextResourceIdentifiers),\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      contextualParameters: targetContextualParameters,\n    });\n\n    if (!readOperation) {\n      if (options?.fallbackToGoBack !== false) {\n        goBackWithinZone();\n      }\n      return false;\n    }\n\n    return navigateToResourceOperation({\n      operation: readOperation,\n      contextResourceIdentifiers: targetContextResourceIdentifiers,\n      parentResourcesRequirements: targetParentResourcesRequirements,\n      initiatorOverride: options?.initiatorOverride,\n      transitionOverride: options?.transitionOverride,\n    });\n  }, [\n    additionalContextResourceId,\n    goBackWithinZone,\n    hasResourceIdEvidence,\n    navigateToResourceOperation,\n    registry,\n    resourceConfig,\n    resourceType,\n    effectiveResourceContext.contextResourceIdentifiers,\n    effectiveResourceContext.parentResourcesRequirements,\n  ]);\n\n  return {\n    resourceContext: effectiveResourceContext,\n    navigationZone,\n    navigationInitiator,\n    resourceType,\n    operation,\n    operationId,\n    resourceConfig,\n    effectiveCoreOperation,\n    isSemanticCustomOperation,\n    operationInitiator,\n    contextualParameters,\n    goBackWithinZone,\n    reportError,\n    executeCurrentOperation,\n    resolvePreferredOperation,\n    navigateToResourceOperation,\n    navigateToPreferredRead,\n  };\n}\n\nfunction useResourceOperationSurfaceByLayoutKind(\n  params: UseResourceOperationSurfaceParams,\n  expectedKind: 'read' | 'list' | 'create' | 'update' | 'search' | 'action',\n  hookName: string,\n): ResourceOperationSurface {\n  const surface = useResourceOperationSurface(params);\n  const actualKind = resolveResourceOperationLayoutKind(surface.operation);\n\n  if (actualKind !== expectedKind) {\n    throw buildResourceOperationSurfaceConfigurationError(\n      hookName,\n      expectedKind,\n      actualKind,\n      surface.operationId,\n    );\n  }\n\n  return surface;\n}\n\nexport function useReadOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'read', 'useReadOperationSurface');\n}\n\nexport function useListOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'list', 'useListOperationSurface');\n}\n\nexport function useCreateOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'create', 'useCreateOperationSurface');\n}\n\nexport function useUpdateOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'update', 'useUpdateOperationSurface');\n}\n\nexport function useSearchOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'search', 'useSearchOperationSurface');\n}\n\nexport function useActionOperationSurface(\n  params: UseResourceOperationSurfaceParams,\n): ResourceOperationSurface {\n  return useResourceOperationSurfaceByLayoutKind(params, 'action', 'useActionOperationSurface');\n}\n\n"]}

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

@@ -42,4 +42,22 @@ export declare const useResourceRegistry: () => ResourceRegistryContextType;
  * the provider.
  */
 export declare const useResourceRegistrySafe: () => ResourceRegistryContextType | undefined;
+/**
+ * Is `resourceType` part of THIS consumer's surface — may a shell provider fetch what that resource
+ * backs?
+ *
+ * The rule #268 established for billing, made one seam (#1069 found it applied at one of four sites):
+ * a shell provider must not fetch a route because the OBSERVED configuration enables the capability,
+ * but because this consumer can REACH it. The application-creation workbench renders a managed
+ * application's config while serving none of its tenant routes, so a configuration-only gate fired
+ * three 404s on every page there. The registry is the one place a consumer states its surface, so the
+ * answer is read from it rather than from a second opt-out that could drift.
+ *
+ * A registry that is ABSENT is ignorance, not a negative answer — only a registry that has been asked
+ * and says no closes the door. Blocking on the absent case disabled billing for every test that
+ * mounts a provider without a registry, which is what caught the first version of that gate.
+ */
+export declare function isResourceReachable(registry: ResourceRegistryContextType | undefined, resourceType: string): boolean;
+/** {@link isResourceReachable} against the registry in context, if any. */
+export declare const useResourceReachability: (resourceType: string) => boolean;
 //# sourceMappingURL=useResourceRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceRegistry.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAA2B,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAEtG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,QAAO,2BAMtC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,QAAO,2BAA2B,GAAG,SAExE,CAAC"}
+{"version":3,"file":"useResourceRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAA2B,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAEtG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,QAAO,2BAMtC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,QAAO,2BAA2B,GAAG,SAExE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEpH;AAED,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,GAAI,cAAc,MAAM,KAAG,OAG9D,CAAC"}

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

@@ -51,4 +51,27 @@ export const useResourceRegistry = () => {
 export const useResourceRegistrySafe = () => {
     return useContext(ResourceRegistryContext);
 };
+/**
+ * Is `resourceType` part of THIS consumer's surface — may a shell provider fetch what that resource
+ * backs?
+ *
+ * The rule #268 established for billing, made one seam (#1069 found it applied at one of four sites):
+ * a shell provider must not fetch a route because the OBSERVED configuration enables the capability,
+ * but because this consumer can REACH it. The application-creation workbench renders a managed
+ * application's config while serving none of its tenant routes, so a configuration-only gate fired
+ * three 404s on every page there. The registry is the one place a consumer states its surface, so the
+ * answer is read from it rather than from a second opt-out that could drift.
+ *
+ * A registry that is ABSENT is ignorance, not a negative answer — only a registry that has been asked
+ * and says no closes the door. Blocking on the absent case disabled billing for every test that
+ * mounts a provider without a registry, which is what caught the first version of that gate.
+ */
+export function isResourceReachable(registry, resourceType) {
+    return registry === undefined || registry.hasResource(resourceType);
+}
+/** {@link isResourceReachable} against the registry in context, if any. */
+export const useResourceReachability = (resourceType) => {
+    const registry = useResourceRegistrySafe();
+    return isResourceReachable(registry, resourceType);
+};
 //# sourceMappingURL=useResourceRegistry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceRegistry.js","sourceRoot":"","sources":["../../../../src/core/resources/useResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAoC,MAAM,2BAA2B,CAAC;AAEtG;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAgC,EAAE;IACnE,MAAM,OAAO,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAA4C,EAAE;IACnF,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC,CAAC","sourcesContent":["/**\n * useResourceRegistry Hook\n * \n * ARCHITECTURE NOTE:\n * This hook is separated from ResourceRegistryContext.tsx for React Fast Refresh compatibility.\n * \n * React Fast Refresh requires files to export EITHER:\n * - Only React components, OR\n * - Only non-component values (hooks, utilities)\n * \n * Mixing both in a single file causes HMR invalidation loops because Vite cannot\n * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).\n * \n * By separating the hook:\n * - ResourceRegistryContext.tsx exports only components and types → Fast Refresh works\n * - This file exports only the hook → Clean module boundary\n */\n\nimport { useContext } from 'react';\nimport { ResourceRegistryContext, type ResourceRegistryContextType } from './ResourceRegistryContext';\n\n/**\n * Hook to access the Resource Registry context\n * @returns ResourceRegistryContextType with resource operations, registry access, and enabled condition evaluation\n * @throws Error if used outside of ResourceRegistryProvider\n *\n * NOTE (Scopes / doOperation override):\n * The returned context value may come from either:\n * - `ResourceRegistryProvider` (base `doOperation()`), or\n * - `ScopedResourceRegistryProvider` (wrapped `doOperation()` that auto-injects AppScope fields).\n *\n * In other words: prefer calling `useResourceRegistry().doOperation(...)` and let the provider\n * hierarchy decide whether AppScope is injected automatically.\n */\nexport const useResourceRegistry = (): ResourceRegistryContextType => {\n  const context = useContext(ResourceRegistryContext);\n  if (!context) {\n    throw new Error('useResourceRegistry must be used within a ResourceRegistryProvider');\n  }\n  return context;\n};\n\n/**\n * Non-throwing variant of {@link useResourceRegistry}.\n *\n * Returns the resource-registry context if a `ResourceRegistryProvider` is\n * present, or `undefined` when called outside one — mirroring `useBillingSafe`\n * / `useAppScopeSafe`. Use this from cross-cutting hooks that may run above the\n * registry provider in the tree (e.g. `useLauncherRuntimeAvailabilityContext`,\n * which feeds early app-shell surfaces like the menubar/hotkeys). Prefer the\n * throwing {@link useResourceRegistry} inside surfaces guaranteed to sit under\n * the provider.\n */\nexport const useResourceRegistrySafe = (): ResourceRegistryContextType | undefined => {\n  return useContext(ResourceRegistryContext);\n};\n"]}
+{"version":3,"file":"useResourceRegistry.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAoC,MAAM,2BAA2B,CAAC;AAEtG;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAgC,EAAE;IACnE,MAAM,OAAO,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAA4C,EAAE;IACnF,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAiD,EAAE,YAAoB;IACzG,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAoB,EAAW,EAAE;IACvE,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,OAAO,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC,CAAC","sourcesContent":["/**\n * useResourceRegistry Hook\n * \n * ARCHITECTURE NOTE:\n * This hook is separated from ResourceRegistryContext.tsx for React Fast Refresh compatibility.\n * \n * React Fast Refresh requires files to export EITHER:\n * - Only React components, OR\n * - Only non-component values (hooks, utilities)\n * \n * Mixing both in a single file causes HMR invalidation loops because Vite cannot\n * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).\n * \n * By separating the hook:\n * - ResourceRegistryContext.tsx exports only components and types → Fast Refresh works\n * - This file exports only the hook → Clean module boundary\n */\n\nimport { useContext } from 'react';\nimport { ResourceRegistryContext, type ResourceRegistryContextType } from './ResourceRegistryContext';\n\n/**\n * Hook to access the Resource Registry context\n * @returns ResourceRegistryContextType with resource operations, registry access, and enabled condition evaluation\n * @throws Error if used outside of ResourceRegistryProvider\n *\n * NOTE (Scopes / doOperation override):\n * The returned context value may come from either:\n * - `ResourceRegistryProvider` (base `doOperation()`), or\n * - `ScopedResourceRegistryProvider` (wrapped `doOperation()` that auto-injects AppScope fields).\n *\n * In other words: prefer calling `useResourceRegistry().doOperation(...)` and let the provider\n * hierarchy decide whether AppScope is injected automatically.\n */\nexport const useResourceRegistry = (): ResourceRegistryContextType => {\n  const context = useContext(ResourceRegistryContext);\n  if (!context) {\n    throw new Error('useResourceRegistry must be used within a ResourceRegistryProvider');\n  }\n  return context;\n};\n\n/**\n * Non-throwing variant of {@link useResourceRegistry}.\n *\n * Returns the resource-registry context if a `ResourceRegistryProvider` is\n * present, or `undefined` when called outside one — mirroring `useBillingSafe`\n * / `useAppScopeSafe`. Use this from cross-cutting hooks that may run above the\n * registry provider in the tree (e.g. `useLauncherRuntimeAvailabilityContext`,\n * which feeds early app-shell surfaces like the menubar/hotkeys). Prefer the\n * throwing {@link useResourceRegistry} inside surfaces guaranteed to sit under\n * the provider.\n */\nexport const useResourceRegistrySafe = (): ResourceRegistryContextType | undefined => {\n  return useContext(ResourceRegistryContext);\n};\n\n/**\n * Is `resourceType` part of THIS consumer's surface — may a shell provider fetch what that resource\n * backs?\n *\n * The rule #268 established for billing, made one seam (#1069 found it applied at one of four sites):\n * a shell provider must not fetch a route because the OBSERVED configuration enables the capability,\n * but because this consumer can REACH it. The application-creation workbench renders a managed\n * application's config while serving none of its tenant routes, so a configuration-only gate fired\n * three 404s on every page there. The registry is the one place a consumer states its surface, so the\n * answer is read from it rather than from a second opt-out that could drift.\n *\n * A registry that is ABSENT is ignorance, not a negative answer — only a registry that has been asked\n * and says no closes the door. Blocking on the absent case disabled billing for every test that\n * mounts a provider without a registry, which is what caught the first version of that gate.\n */\nexport function isResourceReachable(registry: ResourceRegistryContextType | undefined, resourceType: string): boolean {\n  return registry === undefined || registry.hasResource(resourceType);\n}\n\n/** {@link isResourceReachable} against the registry in context, if any. */\nexport const useResourceReachability = (resourceType: string): boolean => {\n  const registry = useResourceRegistrySafe();\n  return isResourceReachable(registry, resourceType);\n};\n"]}

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

@@ -8,6 +8,19 @@ export interface UseResourceSelectionParams {
     /** Field used as the unique identifier for items (default: 'id') */
     idField?: string;
 }
+/**
+ * A selection that spans pages: the QUERY that produced the listing, plus how many rows it matched.
+ *
+ * It is deliberately not a list of ids — the client has not loaded the population, so it cannot
+ * enumerate it, and the server re-evaluates the query under the same scope as the listing (#1461).
+ * `matchedCount` is what the listing reported, so it is a statement about the moment the person
+ * chose, not a promise about the moment the action runs.
+ */
+export interface ResourceMatchAllSelection {
+    filters?: Record<string, unknown>;
+    search?: string;
+    matchedCount: number;
+}
 export interface UseResourceSelectionResult<T extends Record<string, any> = Record<string, any>> {
     /** Array of currently selected items */
     selectedItems: T[];
@@ -25,7 +38,29 @@ export interface UseResourceSelectionResult<T extends Record<string, any> = Reco
     selectAll: (items: T[]) => void;
     /** Clear all selections */
     clearSelection: () => void;
-    /** Number of selected items */
+    /**
+     * The cross-page selection, when the person chose "all N matching" instead of ticking rows.
+     * Mutually exclusive with `selectedItems`: choosing it clears the ticks, and ticking clears it.
+     */
+    matchAllSelection: ResourceMatchAllSelection | null;
+    /** Replace the tick selection with the QUERY that produced the listing. */
+    selectAllMatching: (selection: ResourceMatchAllSelection) => void;
+    /**
+     * A selection of NAMED ROWS the client never loaded — the rows a finished bulk run refused
+     * (#1510). Mutually exclusive with the other two, like they are with each other.
+     *
+     * It exists because those rows can be anywhere: a background run reaches beyond the loaded page,
+     * so the report names ids and the client holds no objects for them. Fetching them is not
+     * available — a listing's filters are its declared `filterFields` plus the two timestamps, and no
+     * resource declares an id-set filter — so this carries what there is. The consequence is the same
+     * one a cross-page selection already accepts: with no row objects, a per-row `enabledCondition`
+     * cannot be judged and the action falls back to the operation-level evaluation, with the server
+     * judging each row as it acts.
+     */
+    explicitIdSelection: string[] | null;
+    /** Replace the selection with rows named by id, whose objects the client does not hold. */
+    selectIds: (ids: readonly string[]) => void;
+    /** Number of selected items — the matched count while a cross-page selection is active. */
     selectionCount: number;
     /** Whether any items are selected */
     hasSelection: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceSelection.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useResourceSelection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7F,wCAAwC;IACxC,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,2CAA2C;IAC3C,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,MAAM,KAAK,OAAO,CAAC;IAC9C,wCAAwC;IACxC,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,6BAA6B;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,6DAA6D;IAC7D,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAChC,2BAA2B;IAC3B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtF,MAAM,GAAE,0BAA+B,GACtC,0BAA0B,CAAC,CAAC,CAAC,CA2E/B"}
+{"version":3,"file":"useResourceSelection.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceSelection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7F,wCAAwC;IACxC,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,2CAA2C;IAC3C,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,MAAM,KAAK,OAAO,CAAC;IAC9C,wCAAwC;IACxC,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,6BAA6B;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,6DAA6D;IAC7D,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAChC,2BAA2B;IAC3B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,iBAAiB,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD,2EAA2E;IAC3E,iBAAiB,EAAE,CAAC,SAAS,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAClE;;;;;;;;;;;OAWG;IACH,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,2FAA2F;IAC3F,SAAS,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5C,2FAA2F;IAC3F,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtF,MAAM,GAAE,0BAA+B,GACtC,0BAA0B,CAAC,CAAC,CAAC,CA4G/B"}

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

@@ -8,6 +8,11 @@ import { useState, useCallback, useMemo } from 'react';
 export function useResourceSelection(params = {}) {
     const { idField = 'id' } = params;
     const [selectedMap, setSelectedMap] = useState(new Map());
+    // The two selections are mutually exclusive by construction: every writer of one clears the
+    // other. Letting them coexist would leave the action layer to decide which wins, and whichever it
+    // chose the other would be silently inert — the same ambiguity the wire selector refuses.
+    const [matchAllSelection, setMatchAllSelection] = useState(null);
+    const [explicitIdSelection, setExplicitIdSelection] = useState(null);
     const getItemId = useCallback((item) => {
         return String(item[idField] ?? item['_id'] ?? '');
     }, [idField]);
@@ -17,6 +22,8 @@ export function useResourceSelection(params = {}) {
     }, [selectedMap, getItemId]);
     const toggleSelection = useCallback((item) => {
         const id = getItemId(item);
+        setMatchAllSelection(null);
+        setExplicitIdSelection(null);
         setSelectedMap((prev) => {
             const next = new Map(prev);
             if (next.has(id)) {
@@ -30,6 +37,8 @@ export function useResourceSelection(params = {}) {
     }, [getItemId]);
     const selectItem = useCallback((item) => {
         const id = getItemId(item);
+        setMatchAllSelection(null);
+        setExplicitIdSelection(null);
         setSelectedMap((prev) => {
             if (prev.has(id))
                 return prev;
@@ -40,6 +49,8 @@ export function useResourceSelection(params = {}) {
     }, [getItemId]);
     const deselectItem = useCallback((item) => {
         const id = getItemId(item);
+        setMatchAllSelection(null);
+        setExplicitIdSelection(null);
         setSelectedMap((prev) => {
             if (!prev.has(id))
                 return prev;
@@ -49,6 +60,8 @@ export function useResourceSelection(params = {}) {
         });
     }, [getItemId]);
     const selectAll = useCallback((items) => {
+        setMatchAllSelection(null);
+        setExplicitIdSelection(null);
         const next = new Map();
         for (const item of items) {
             next.set(getItemId(item), item);
@@ -57,10 +70,24 @@ export function useResourceSelection(params = {}) {
     }, [getItemId]);
     const clearSelection = useCallback(() => {
         setSelectedMap(new Map());
+        setMatchAllSelection(null);
+        setExplicitIdSelection(null);
+    }, []);
+    const selectAllMatching = useCallback((selection) => {
+        setSelectedMap(new Map());
+        setExplicitIdSelection(null);
+        setMatchAllSelection(selection);
+    }, []);
+    const selectIds = useCallback((ids) => {
+        setSelectedMap(new Map());
+        setMatchAllSelection(null);
+        setExplicitIdSelection(ids.length > 0 ? [...ids] : null);
     }, []);
     const selectedItems = useMemo(() => Array.from(selectedMap.values()), [selectedMap]);
     const selectedIds = useMemo(() => new Set(selectedMap.keys()), [selectedMap]);
-    const selectionCount = selectedMap.size;
+    const selectionCount = matchAllSelection
+        ? matchAllSelection.matchedCount
+        : explicitIdSelection?.length ?? selectedMap.size;
     const hasSelection = selectionCount > 0;
     return {
         selectedItems,
@@ -71,6 +98,10 @@ export function useResourceSelection(params = {}) {
         deselectItem,
         selectAll,
         clearSelection,
+        matchAllSelection,
+        selectAllMatching,
+        explicitIdSelection,
+        selectIds,
         selectionCount,
         hasSelection,
     };

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceSelection.js","sourceRoot":"","sources":["../../../../src/core/resources/useResourceSelection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceSelection\n * \n * Hook for managing item selection in resource lists/tables.\n * Provides select, deselect, toggle, select all, and clear operations.\n */\n\nimport { useState, useCallback, useMemo } from 'react';\n\nexport interface UseResourceSelectionParams {\n  /** Field used as the unique identifier for items (default: 'id') */\n  idField?: string;\n}\n\nexport interface UseResourceSelectionResult<T extends Record<string, any> = Record<string, any>> {\n  /** Array of currently selected items */\n  selectedItems: T[];\n  /** Set of selected item IDs for quick lookup */\n  selectedIds: Set<string>;\n  /** Check if a specific item is selected */\n  isSelected: (itemOrId: T | string) => boolean;\n  /** Toggle selection of a single item */\n  toggleSelection: (item: T) => void;\n  /** Select a single item (additive) */\n  selectItem: (item: T) => void;\n  /** Deselect a single item */\n  deselectItem: (item: T) => void;\n  /** Select all provided items (replaces current selection) */\n  selectAll: (items: T[]) => void;\n  /** Clear all selections */\n  clearSelection: () => void;\n  /** Number of selected items */\n  selectionCount: number;\n  /** Whether any items are selected */\n  hasSelection: boolean;\n}\n\nexport function useResourceSelection<T extends Record<string, any> = Record<string, any>>(\n  params: UseResourceSelectionParams = {}\n): UseResourceSelectionResult<T> {\n  const { idField = 'id' } = params;\n  const [selectedMap, setSelectedMap] = useState<Map<string, T>>(new Map());\n\n  const getItemId = useCallback((item: T): string => {\n    return String(item[idField] ?? item['_id'] ?? '');\n  }, [idField]);\n\n  const isSelected = useCallback((itemOrId: T | string): boolean => {\n    const id = typeof itemOrId === 'string' ? itemOrId : getItemId(itemOrId);\n    return selectedMap.has(id);\n  }, [selectedMap, getItemId]);\n\n  const toggleSelection = useCallback((item: T) => {\n    const id = getItemId(item);\n    setSelectedMap((prev) => {\n      const next = new Map(prev);\n      if (next.has(id)) {\n        next.delete(id);\n      } else {\n        next.set(id, item);\n      }\n      return next;\n    });\n  }, [getItemId]);\n\n  const selectItem = useCallback((item: T) => {\n    const id = getItemId(item);\n    setSelectedMap((prev) => {\n      if (prev.has(id)) return prev;\n      const next = new Map(prev);\n      next.set(id, item);\n      return next;\n    });\n  }, [getItemId]);\n\n  const deselectItem = useCallback((item: T) => {\n    const id = getItemId(item);\n    setSelectedMap((prev) => {\n      if (!prev.has(id)) return prev;\n      const next = new Map(prev);\n      next.delete(id);\n      return next;\n    });\n  }, [getItemId]);\n\n  const selectAll = useCallback((items: T[]) => {\n    const next = new Map<string, T>();\n    for (const item of items) {\n      next.set(getItemId(item), item);\n    }\n    setSelectedMap(next);\n  }, [getItemId]);\n\n  const clearSelection = useCallback(() => {\n    setSelectedMap(new Map());\n  }, []);\n\n  const selectedItems = useMemo(() => Array.from(selectedMap.values()), [selectedMap]);\n  const selectedIds = useMemo(() => new Set(selectedMap.keys()), [selectedMap]);\n  const selectionCount = selectedMap.size;\n  const hasSelection = selectionCount > 0;\n\n  return {\n    selectedItems,\n    selectedIds,\n    isSelected,\n    toggleSelection,\n    selectItem,\n    deselectItem,\n    selectAll,\n    clearSelection,\n    selectionCount,\n    hasSelection,\n  };\n}\n"]}
+{"version":3,"file":"useResourceSelection.js","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceSelection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceSelection\n * \n * Hook for managing item selection in resource lists/tables.\n * Provides select, deselect, toggle, select all, and clear operations.\n */\n\nimport { useState, useCallback, useMemo } from 'react';\n\nexport interface UseResourceSelectionParams {\n  /** Field used as the unique identifier for items (default: 'id') */\n  idField?: string;\n}\n\n/**\n * A selection that spans pages: the QUERY that produced the listing, plus how many rows it matched.\n *\n * It is deliberately not a list of ids — the client has not loaded the population, so it cannot\n * enumerate it, and the server re-evaluates the query under the same scope as the listing (#1461).\n * `matchedCount` is what the listing reported, so it is a statement about the moment the person\n * chose, not a promise about the moment the action runs.\n */\nexport interface ResourceMatchAllSelection {\n  filters?: Record<string, unknown>;\n  search?: string;\n  matchedCount: number;\n}\n\nexport interface UseResourceSelectionResult<T extends Record<string, any> = Record<string, any>> {\n  /** Array of currently selected items */\n  selectedItems: T[];\n  /** Set of selected item IDs for quick lookup */\n  selectedIds: Set<string>;\n  /** Check if a specific item is selected */\n  isSelected: (itemOrId: T | string) => boolean;\n  /** Toggle selection of a single item */\n  toggleSelection: (item: T) => void;\n  /** Select a single item (additive) */\n  selectItem: (item: T) => void;\n  /** Deselect a single item */\n  deselectItem: (item: T) => void;\n  /** Select all provided items (replaces current selection) */\n  selectAll: (items: T[]) => void;\n  /** Clear all selections */\n  clearSelection: () => void;\n  /**\n   * The cross-page selection, when the person chose \"all N matching\" instead of ticking rows.\n   * Mutually exclusive with `selectedItems`: choosing it clears the ticks, and ticking clears it.\n   */\n  matchAllSelection: ResourceMatchAllSelection | null;\n  /** Replace the tick selection with the QUERY that produced the listing. */\n  selectAllMatching: (selection: ResourceMatchAllSelection) => void;\n  /**\n   * A selection of NAMED ROWS the client never loaded — the rows a finished bulk run refused\n   * (#1510). Mutually exclusive with the other two, like they are with each other.\n   *\n   * It exists because those rows can be anywhere: a background run reaches beyond the loaded page,\n   * so the report names ids and the client holds no objects for them. Fetching them is not\n   * available — a listing's filters are its declared `filterFields` plus the two timestamps, and no\n   * resource declares an id-set filter — so this carries what there is. The consequence is the same\n   * one a cross-page selection already accepts: with no row objects, a per-row `enabledCondition`\n   * cannot be judged and the action falls back to the operation-level evaluation, with the server\n   * judging each row as it acts.\n   */\n  explicitIdSelection: string[] | null;\n  /** Replace the selection with rows named by id, whose objects the client does not hold. */\n  selectIds: (ids: readonly string[]) => void;\n  /** Number of selected items — the matched count while a cross-page selection is active. */\n  selectionCount: number;\n  /** Whether any items are selected */\n  hasSelection: boolean;\n}\n\nexport function useResourceSelection<T extends Record<string, any> = Record<string, any>>(\n  params: UseResourceSelectionParams = {}\n): UseResourceSelectionResult<T> {\n  const { idField = 'id' } = params;\n  const [selectedMap, setSelectedMap] = useState<Map<string, T>>(new Map());\n  // The two selections are mutually exclusive by construction: every writer of one clears the\n  // other. Letting them coexist would leave the action layer to decide which wins, and whichever it\n  // chose the other would be silently inert — the same ambiguity the wire selector refuses.\n  const [matchAllSelection, setMatchAllSelection] = useState<ResourceMatchAllSelection | null>(null);\n  const [explicitIdSelection, setExplicitIdSelection] = useState<string[] | null>(null);\n\n  const getItemId = useCallback((item: T): string => {\n    return String(item[idField] ?? item['_id'] ?? '');\n  }, [idField]);\n\n  const isSelected = useCallback((itemOrId: T | string): boolean => {\n    const id = typeof itemOrId === 'string' ? itemOrId : getItemId(itemOrId);\n    return selectedMap.has(id);\n  }, [selectedMap, getItemId]);\n\n  const toggleSelection = useCallback((item: T) => {\n    const id = getItemId(item);\n    setMatchAllSelection(null);\n    setExplicitIdSelection(null);\n    setSelectedMap((prev) => {\n      const next = new Map(prev);\n      if (next.has(id)) {\n        next.delete(id);\n      } else {\n        next.set(id, item);\n      }\n      return next;\n    });\n  }, [getItemId]);\n\n  const selectItem = useCallback((item: T) => {\n    const id = getItemId(item);\n    setMatchAllSelection(null);\n    setExplicitIdSelection(null);\n    setSelectedMap((prev) => {\n      if (prev.has(id)) return prev;\n      const next = new Map(prev);\n      next.set(id, item);\n      return next;\n    });\n  }, [getItemId]);\n\n  const deselectItem = useCallback((item: T) => {\n    const id = getItemId(item);\n    setMatchAllSelection(null);\n    setExplicitIdSelection(null);\n    setSelectedMap((prev) => {\n      if (!prev.has(id)) return prev;\n      const next = new Map(prev);\n      next.delete(id);\n      return next;\n    });\n  }, [getItemId]);\n\n  const selectAll = useCallback((items: T[]) => {\n    setMatchAllSelection(null);\n    setExplicitIdSelection(null);\n    const next = new Map<string, T>();\n    for (const item of items) {\n      next.set(getItemId(item), item);\n    }\n    setSelectedMap(next);\n  }, [getItemId]);\n\n  const clearSelection = useCallback(() => {\n    setSelectedMap(new Map());\n    setMatchAllSelection(null);\n    setExplicitIdSelection(null);\n  }, []);\n\n  const selectAllMatching = useCallback((selection: ResourceMatchAllSelection) => {\n    setSelectedMap(new Map());\n    setExplicitIdSelection(null);\n    setMatchAllSelection(selection);\n  }, []);\n\n  const selectIds = useCallback((ids: readonly string[]) => {\n    setSelectedMap(new Map());\n    setMatchAllSelection(null);\n    setExplicitIdSelection(ids.length > 0 ? [...ids] : null);\n  }, []);\n\n  const selectedItems = useMemo(() => Array.from(selectedMap.values()), [selectedMap]);\n  const selectedIds = useMemo(() => new Set(selectedMap.keys()), [selectedMap]);\n  const selectionCount = matchAllSelection\n    ? matchAllSelection.matchedCount\n    : explicitIdSelection?.length ?? selectedMap.size;\n  const hasSelection = selectionCount > 0;\n\n  return {\n    selectedItems,\n    selectedIds,\n    isSelected,\n    toggleSelection,\n    selectItem,\n    deselectItem,\n    selectAll,\n    clearSelection,\n    matchAllSelection,\n    selectAllMatching,\n    explicitIdSelection,\n    selectIds,\n    selectionCount,\n    hasSelection,\n  };\n}\n"]}

package/dist/esm/core/resources/utils/operation-enabled-condition.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-enabled-condition.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/utils/operation-enabled-condition.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EACX,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAW/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAGxJ;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,WAAW,GAAG,GAAG;IAC/D,gCAAgC;IAChC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,yDAAyD;IACzD,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,wCAAwC;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,6BAA6B,CAAC;IAC7C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,8DAA8D;IAC9D,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,yCAAyC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,0GAA0G;IAC1G,WAAW,CAAC,EAAE,CAAC,SAAS,GAAG,GAAG,EAC5B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,KACb,OAAO,CAAC,SAAS,CAAC,CAAC;CACzB;AAED,UAAU,6CAA6C;IACrD,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAmC;IAEpE,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAWvC;;;;;;;;;;OAUG;WACU,8BAA8B,CACzC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACjE,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,6CAA6C,CAAC,EAC/E,iBAAiB,EAAE,yBAAyB,EAC5C,WAAW,CAAC,EAAE,CAAC,SAAS,GAAG,GAAG,EAC5B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,KACb,OAAO,CAAC,SAAS,CAAC,GACtB,OAAO,CAAC,GAAG,CAAC;IAmGf;;;;;;;OAOG;WACU,wBAAwB,CAAC,WAAW,GAAG,GAAG,EACrD,MAAM,EAAE,8BAA8B,CAAC,WAAW,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC;IA+GnB;;;OAGG;IACH,MAAM,CAAC,wBAAwB,CAC7B,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE;QACD,kBAAkB,EAAE,OAAO,CAAC;QAC5B,gBAAgB,EAAE,OAAO,CAAC;KAC3B;IAQD,MAAM,CAAC,2BAA2B,CAChC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE,OAAO;IAIV,MAAM,CAAC,yBAAyB,CAC9B,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE,OAAO;CAGX;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAA+F,CAAC;AACrI,eAAO,MAAM,8BAA8B,KAAqG,CAAC;AACjJ,eAAO,MAAM,wBAAwB,KAA+F,CAAC;AACrI,eAAO,MAAM,2BAA2B,KAAkG,CAAC;AAC3I,eAAO,MAAM,yBAAyB,KAAgG,CAAC"}
+{"version":3,"file":"operation-enabled-condition.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/utils/operation-enabled-condition.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EACX,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAW/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAGxJ;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,WAAW,GAAG,GAAG;IAC/D,gCAAgC;IAChC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,yDAAyD;IACzD,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,wCAAwC;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,6BAA6B,CAAC;IAC7C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,8DAA8D;IAC9D,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,yCAAyC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,0GAA0G;IAC1G,WAAW,CAAC,EAAE,CAAC,SAAS,GAAG,GAAG,EAC5B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,KACb,OAAO,CAAC,SAAS,CAAC,CAAC;CACzB;AAED,UAAU,6CAA6C;IACrD,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAmC;IAEpE,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAWvC;;;;;;;;;;OAUG;WACU,8BAA8B,CACzC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACjE,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,6CAA6C,CAAC,EAC/E,iBAAiB,EAAE,yBAAyB,EAC5C,WAAW,CAAC,EAAE,CAAC,SAAS,GAAG,GAAG,EAC5B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,KACb,OAAO,CAAC,SAAS,CAAC,GACtB,OAAO,CAAC,GAAG,CAAC;IAmGf;;;;;;;OAOG;WACU,wBAAwB,CAAC,WAAW,GAAG,GAAG,EACrD,MAAM,EAAE,8BAA8B,CAAC,WAAW,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC;IA+GnB;;;OAGG;IACH,MAAM,CAAC,wBAAwB,CAC7B,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE;QACD,kBAAkB,EAAE,OAAO,CAAC;QAC5B,gBAAgB,EAAE,OAAO,CAAC;KAC3B;IAQD,MAAM,CAAC,2BAA2B,CAChC,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE,OAAO;IAIV,MAAM,CAAC,yBAAyB,CAC9B,SAAS,EAAE,uCAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAChE,OAAO;CAGX;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAA+F,CAAC;AACrI,eAAO,MAAM,8BAA8B,KAAqG,CAAC;AACjJ,eAAO,MAAM,wBAAwB,KAA+F,CAAC;AACrI,eAAO,MAAM,2BAA2B,KAAkG,CAAC;AAC3I,eAAO,MAAM,yBAAyB,KAAgG,CAAC"}