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

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

@@ -2,7 +2,7 @@ import { CoreResourceOperation, type TransitionConfig } from '@wildo-ai/saas-mod
 import { NavigationUtils } from '../../core/navigation/navigation.utils';
 import type { NavigationInitiatorContext, NavigationZone } from '../../core/navigation/navigation.schemas';
 import { FrontendResourceUtils } from '../../core/resources/frontend-resource.utils';
-import { UpdateLikeMutationFallbackMode } from '../../core/resources/rmm/update-like-mutation-fallback.frontend';
+import { type UpdateLikeMutationFallbackMode } from '../../core/resources/rmm/update-like-mutation-fallback.frontend';
 import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
 interface NavigateToResourceOperationOptions {
     operation: FrontendResourceConfiguration_Operation;
@@ -55,9 +55,10 @@ export interface UseResourceOperationSurfaceParams {
     navigationInitiator?: NavigationInitiatorContext;
     /**
      * Controls whether `executeCurrentOperation()` may directly execute
-     * update-like operations without RMM participation. Defaults to
-     * `RMM_REQUIRED` so update-family callers must classify the weaker-guarantee
-     * direct lane explicitly.
+     * update-like operations without RMM participation. When omitted, the lane is
+     * the one the OPERATION declared (`operationFrontendConfig.updateLikeMutationFallbackMode`),
+     * which is `RMM_REQUIRED` unless it declared otherwise — so the weaker direct
+     * lane is always an explicit classification, by the caller or by the operation.
      */
     updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;
 }
@@ -78,7 +79,8 @@ export interface ResourceOperationSurface {
     /**
      * Executes the currently hosted operation. Read/create/action execution stays
      * direct. Update-like execution fails closed by default unless the caller
-     * explicitly opts into `DIRECT_OPERATION_FALLBACK`, because this headless
+     * passes `DIRECT_OPERATION_FALLBACK` or the operation declares it
+     * (`operationFrontendConfig.updateLikeMutationFallbackMode`), because this headless
      * seam does not attach an RMM instance on its own. Even when the operation is
      * semantically update-like, this direct fallback lane must not be described as
      * carrying the same guaranteed authoritative conflict-detail contract as the
@@ -97,7 +99,7 @@ export interface ResourceOperationSurface {
  * detection, initiator construction, error reporting, and navigation toward the
  * preferred addressable READ surface.
  */
-export declare function useResourceOperationSurface({ resourceContext, navigationZone, navigationInitiator, updateLikeMutationFallbackMode, }: UseResourceOperationSurfaceParams): ResourceOperationSurface;
+export declare function useResourceOperationSurface({ resourceContext, navigationZone, navigationInitiator, updateLikeMutationFallbackMode: callerUpdateLikeMutationFallbackMode, }: UseResourceOperationSurfaceParams): ResourceOperationSurface;
 export declare function useReadOperationSurface(params: UseResourceOperationSurfaceParams): ResourceOperationSurface;
 export declare function useListOperationSurface(params: UseResourceOperationSurfaceParams): ResourceOperationSurface;
 export declare function useCreateOperationSurface(params: UseResourceOperationSurfaceParams): ResourceOperationSurface;

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

@@ -3,7 +3,7 @@ import { CoreResourceOperation, ErrorCustomMessageReference, ResourcesConfig_Ope
 import { useError } from '../../core/errors/useError.js';
 import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
 import { frontendResourceUtils, FrontendResourceUtils, } from '../../core/resources/frontend-resource.utils.js';
-import { allowsDirectOperationFallback, MissingRMMRuntimeError, UpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
+import { allowsDirectOperationFallback, MissingRMMRuntimeError, resolveDeclaredUpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
 import { isSingleResourceUpdateLikeOperation, mergeBulkSelectionIntoRequestData, isSemanticCustomResourceOperation, pickPreferredOperationForCoreSemantic, resolveEffectiveCoreOperationFromOperation, resolveResourceOperationLayoutKind, } from '../../core/resources/operation-semantics.frontend.utils.js';
 import { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability, shouldRequireCurrentContextAddressabilityForOperation, } from '../../core/resources/resource-addressability.frontend.utils.js';
 import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
@@ -49,11 +49,12 @@ function injectResourceIdEvidence(contextResourceIdentifiers, resourceType, reso
  * detection, initiator construction, error reporting, and navigation toward the
  * preferred addressable READ surface.
  */
-export function useResourceOperationSurface({ resourceContext, navigationZone, navigationInitiator, updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED, }) {
+export function useResourceOperationSurface({ resourceContext, navigationZone, navigationInitiator, updateLikeMutationFallbackMode: callerUpdateLikeMutationFallbackMode, }) {
     const { registry, doOperation } = useResourceRegistry();
     const { navigateToResource, goBack } = useNavigationController();
     const { handleError: contextHandleError } = useError();
     const { resourceType, operation } = resourceContext;
+    const updateLikeMutationFallbackMode = callerUpdateLikeMutationFallbackMode ?? resolveDeclaredUpdateLikeMutationFallbackMode(operation);
     const operationId = String(operation.operationIdentifier);
     const resourceConfig = useMemo(() => {
         return registry.resourceConfigurations[resourceType];

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   * 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"]}
+{"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  resolveDeclaredUpdateLikeMutationFallbackMode,\n  type 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. When omitted, the lane is\n   * the one the OPERATION declared (`operationFrontendConfig.updateLikeMutationFallbackMode`),\n   * which is `RMM_REQUIRED` unless it declared otherwise — so the weaker direct\n   * lane is always an explicit classification, by the caller or by the operation.\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   * passes `DIRECT_OPERATION_FALLBACK` or the operation declares it\n   * (`operationFrontendConfig.updateLikeMutationFallbackMode`), 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: callerUpdateLikeMutationFallbackMode,\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 updateLikeMutationFallbackMode = callerUpdateLikeMutationFallbackMode ?? resolveDeclaredUpdateLikeMutationFallbackMode(operation);\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/runtime/AppRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouter.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/AppRouter.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,OAAO,CAAC;AAyrB1B,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EA2R7B,CAAC"}
+{"version":3,"file":"AppRouter.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/AppRouter.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,OAAO,CAAC;AA8sB1B,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EA2R7B,CAAC"}

package/dist/esm/core/runtime/AppRouter.js

@@ -32,9 +32,10 @@ import { RouterErrorBoundary } from '../../core/errors/RouterErrorBoundary.js';
 import { useError } from '../../core/errors/useError.js';
 import { NavigationContentType, NavigationSource, NavigationZone } from '../../core/navigation/navigation.schemas.js';
 import { NavigationRequestBridge } from '../../core/navigation/NavigationRequestBridge.js';
+import { adjacentZoneUsableAtViewport } from '../../core/navigation/zone-collapse.js';
 import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
 import { useTransactionAwareSyncRetry } from '../../core/navigation/useTransactionAwareSyncRetry.js';
-import { useRouterSync, useViewRouterSync, useEnginePageRouterSync } from '../../core/navigation/useNavigationController.js';
+import { useRouterSync, useViewRouterSync, useEnginePageRouterSync } from '../../core/navigation/useNavigationRouterSync.js';
 import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
 import { resolveResourceOperationLayoutKind } from '../../core/resources/operation-semantics.frontend.utils.js';
 import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
@@ -232,6 +233,8 @@ const ResourcePageWrapper = ({ resourceType, operation, PageComponent, routePath
     const { handleError } = useError();
     const appScope = useAppScopeSafe();
     const { navigationLayout, currentBreakpoint } = useUI();
+    // The measured content area, for the same collapse question the resolver and the renderer ask.
+    const { contentAreaWidth } = useNavigationState();
     // Extract URL parameters from React Router
     const urlParameters = useParams();
     // Validate URL parameters before allowing router-sync to reconstruct
@@ -290,11 +293,29 @@ const ResourcePageWrapper = ({ resourceType, operation, PageComponent, routePath
     const prefersAdjacentZoneForDetail = resourceRelationshipDepth === 0
         && !!navigationLayout?.zones?.secondary
         && NavigationUtils.layoutSplitsOperationFromPrimary(navigationLayout, operation, currentBreakpoint);
-    const navigationZone = NavigationUtils.resolveResourceTargetZone(resourceRelationshipDepth, {
+    const preferredNavigationZone = NavigationUtils.resolveResourceTargetZone(resourceRelationshipDepth, {
         hasSecondary: !!navigationLayout?.zones?.secondary,
         hasCompanion: !!navigationLayout?.zones?.companion,
         prefersAdjacentZoneForDetail,
     });
+    /*
+     * ─── The VIEWPORT decides here too, for the reason the comment below already gives ─────────────
+     *
+     * `resolveResourceTargetZone` takes no viewport, so every caller applies the collapse itself.
+     * There are exactly two, and when the collapse was added to the URL-sync caller on 2026-09-25 this
+     * one was left behind — in the pass whose whole subject was an invariant applied at some of its
+     * sites. On a phone URL sync restores a depth-1 resource into PRIMARY while this wrapper still
+     * handed the page `navigationZone: SECONDARY`, so every zone-keyed affordance in it answered for a
+     * zone the content is not in. Precisely the disagreement the comment below warns about.
+     */
+    const navigationZone = adjacentZoneUsableAtViewport({
+        zone: preferredNavigationZone,
+        layout: navigationLayout,
+        viewport: currentBreakpoint,
+        contentAreaWidth,
+    })
+        ? preferredNavigationZone
+        : NavigationZoneName.PRIMARY;
     // Routed resource pages must receive the same owning zone as URL-sync restore.
     // Otherwise the rendered page props can disagree with the live navigation stack
     // after refresh/deep-link reconstruction.