@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.1

package/dist/esm/components/resources/embeds/useEmbeddedResourceContext.js

@@ -0,0 +1,297 @@
+import { useCallback, useMemo } from 'react';
+import { CoreResourceOperation, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { useOptionalEmbeddedResourceHostContext } from '../../../components/resources/embeds/EmbeddedResourceHostContext.js';
+import { frontendResourceUtils, FrontendResourceUtils, } from '../../../core/resources/frontend-resource.utils.js';
+import { pickPreferredOperationForCoreSemantic, } 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';
+/**
+ * Stable empty fallback. A nullish composite context must not mint a fresh `{}`
+ * each render — `contextResourceIdentifiers` keys every memo below, so a new empty
+ * object identity would recompute them all (and the returned context value) every
+ * render, feeding the composite re-render loop.
+ */
+const EMPTY_CONTEXT_RESOURCE_IDENTIFIERS = Object.freeze({});
+function buildEmbeddedResourceConfigurationError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        message,
+        component: 'useEmbeddedResourceContext',
+        ...context,
+    });
+}
+function hasOperationIdentifier(target) {
+    return typeof target.operationIdentifier === 'string';
+}
+function resolveOperationOrThrow(resourceConfig, resourceType, target, registry, contextResourceIdentifiers) {
+    const matchingOperations = (resourceConfig?.operations ?? []).filter((candidate) => {
+        if (String(candidate.operationIdentifier) !== target.operationIdentifier) {
+            return false;
+        }
+        if (target.variantType !== undefined && candidate.variantType !== target.variantType) {
+            return false;
+        }
+        if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {
+            return false;
+        }
+        if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {
+            return false;
+        }
+        if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {
+            return false;
+        }
+        return true;
+    });
+    const defaultNonBulkOperations = matchingOperations.filter((candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true);
+    const operation = matchingOperations.length === 1
+        ? matchingOperations[0]
+        : target.variantType === undefined
+            && target.variantKey === undefined
+            && target.isOperationDefault === undefined
+            && target.isBulkOperation === undefined
+            && defaultNonBulkOperations.length === 1
+            ? defaultNonBulkOperations[0]
+            : undefined;
+    if (!operation) {
+        throw buildEmbeddedResourceConfigurationError(matchingOperations.length === 0
+            ? `Composite resource runtime cannot resolve operation "${target.operationIdentifier}" on resource "${resourceType}".`
+            : `Composite resource runtime found ambiguous operation "${target.operationIdentifier}" on resource "${resourceType}".`, {
+            resourceType,
+            operationIdentifier: target.operationIdentifier,
+            variantType: target.variantType,
+            variantKey: target.variantKey,
+            isOperationDefault: target.isOperationDefault,
+            isBulkOperation: target.isBulkOperation,
+            candidates: matchingOperations.map((candidate) => ({
+                variantType: candidate.variantType,
+                variantKey: candidate.variantKey,
+                isOperationDefault: candidate.isOperationDefault,
+                isBulkOperation: candidate.isBulkOperation,
+            })),
+        });
+    }
+    const requiresRuntimeAddressability = resourceConfig
+        ? shouldRequireCurrentContextAddressabilityForOperation({
+            operation,
+            resourceType,
+            resourceConfig,
+        })
+        : false;
+    if (resourceConfig
+        && requiresRuntimeAddressability
+        && operation.isBulkOperation !== true
+        && !isFrontendOperationAddressableForCurrentContext({
+            resourceConfig,
+            operation,
+            registry,
+            hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,
+            contextResourceIdentifiers,
+            contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+        })) {
+        throw buildEmbeddedResourceConfigurationError(`Composite resource runtime resolved operation "${target.operationIdentifier}" on resource "${resourceType}", but it is not addressable in the current context.`, {
+            resourceType,
+            operationIdentifier: target.operationIdentifier,
+        });
+    }
+    return operation;
+}
+export function useOptionalCompositeResourceContext() {
+    // Host facts come from the NEUTRAL context, so this runtime serves a resource
+    // layout as readily as a composite view. The `hostResourceType` guard below is
+    // unchanged and still fails closed — only the SOURCE of the fact widened.
+    const compositeContext = useOptionalEmbeddedResourceHostContext();
+    const { registry } = useResourceRegistry();
+    const hostResourceType = compositeContext?.hostResourceType;
+    const contextResourceIdentifiers = compositeContext?.contextResourceIdentifiers ?? EMPTY_CONTEXT_RESOURCE_IDENTIFIERS;
+    const hostResourceConfig = useMemo(() => {
+        if (!hostResourceType) {
+            return undefined;
+        }
+        const resourceConfig = registry.resourceConfigurations[hostResourceType];
+        if (!resourceConfig) {
+            throw buildEmbeddedResourceConfigurationError(`Composite resource runtime cannot resolve host resource "${hostResourceType}" from the registry.`, {
+                hostResourceType,
+            });
+        }
+        return resourceConfig;
+    }, [hostResourceType, registry.resourceConfigurations]);
+    const parentResourcesRequirements = useMemo(() => {
+        if (!hostResourceType) {
+            return [];
+        }
+        return frontendResourceUtils.buildParentResourcesRequirements(hostResourceType, contextResourceIdentifiers, registry);
+    }, [contextResourceIdentifiers, hostResourceType, registry]);
+    const hostOperationFallback = useMemo(() => {
+        if (!hostResourceConfig) {
+            return undefined;
+        }
+        return pickPreferredOperationForCoreSemanticAddressability({
+            resourceConfig: hostResourceConfig,
+            operations: hostResourceConfig.operations ?? [],
+            coreOperation: CoreResourceOperation.READ,
+            registry,
+            hasResourceId: hostResourceType
+                ? frontendResourceUtils.getResourceId(contextResourceIdentifiers[hostResourceType]).length > 0
+                : false,
+            requireFrontendAddressable: true,
+            contextResourceIdentifiers,
+            contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+        }) ?? hostResourceConfig.operations?.[0];
+    }, [contextResourceIdentifiers, hostResourceConfig, hostResourceType, registry]);
+    const resolveOperation = useCallback((target) => {
+        const targetResourceType = target.resourceType ?? hostResourceType;
+        if (!targetResourceType) {
+            throw buildEmbeddedResourceConfigurationError('Composite resource runtime is only available inside resource-scoped composite views.', {
+                target,
+            });
+        }
+        const resourceConfig = targetResourceType === hostResourceType
+            ? hostResourceConfig
+            : registry.resourceConfigurations[targetResourceType];
+        if (hasOperationIdentifier(target)) {
+            return resolveOperationOrThrow(resourceConfig, targetResourceType, target, registry, contextResourceIdentifiers);
+        }
+        const requiresRuntimeAddressability = target.operationLike === CoreResourceOperation.READ
+            || target.operationLike === CoreResourceOperation.UPDATE
+            || target.operationLike === CoreResourceOperation.DELETE;
+        const semanticOperation = target.requireAddressable || requiresRuntimeAddressability
+            ? resourceConfig
+                ? pickPreferredOperationForCoreSemanticAddressability({
+                    resourceConfig,
+                    operations: resourceConfig.operations ?? [],
+                    coreOperation: target.operationLike,
+                    registry,
+                    hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[targetResourceType]).length > 0,
+                    allowBulk: target.allowBulk,
+                    requireFrontendAddressable: true,
+                    contextResourceIdentifiers,
+                    contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+                })
+                : undefined
+            : pickPreferredOperationForCoreSemantic(resourceConfig?.operations ?? [], target.operationLike, {
+                requireAddressable: target.requireAddressable,
+                allowBulk: target.allowBulk,
+            });
+        if (!semanticOperation) {
+            throw buildEmbeddedResourceConfigurationError(`Composite resource runtime cannot resolve a preferred ${target.operationLike}-like operation on resource "${targetResourceType}".`, {
+                resourceType: targetResourceType,
+                operationLike: target.operationLike,
+                requireAddressable: target.requireAddressable,
+                allowBulk: target.allowBulk,
+            });
+        }
+        return semanticOperation;
+    }, [contextResourceIdentifiers, hostResourceConfig, hostResourceType, registry]);
+    const buildOperationContext = useCallback((target) => {
+        if (!hostResourceType) {
+            throw buildEmbeddedResourceConfigurationError('Composite resource runtime is only available inside resource-scoped composite views.', {
+                target,
+            });
+        }
+        const targetResourceType = target.resourceType ?? hostResourceType;
+        const targetOperation = resolveOperation({
+            resourceType: targetResourceType,
+            ...(hasOperationIdentifier(target)
+                ? {
+                    operationIdentifier: target.operationIdentifier,
+                    variantType: target.variantType,
+                    variantKey: target.variantKey,
+                    isOperationDefault: target.isOperationDefault,
+                    isBulkOperation: target.isBulkOperation,
+                }
+                : {
+                    operationLike: target.operationLike,
+                    requireAddressable: target.requireAddressable,
+                    allowBulk: target.allowBulk,
+                }),
+        });
+        if (targetResourceType === hostResourceType) {
+            const targetContextResourceIdentifiers = target.resourceId
+                ? {
+                    ...contextResourceIdentifiers,
+                    [hostResourceType]: target.resourceId,
+                }
+                : contextResourceIdentifiers;
+            const targetParentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(hostResourceType, targetContextResourceIdentifiers, registry, target.relationshipFieldOverrides);
+            return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+                resourceType: hostResourceType,
+                operation: targetOperation,
+                contextResourceIdentifiers: targetContextResourceIdentifiers,
+                additionalContext: target.additionalContext,
+                parentResourcesRequirements: targetParentResourcesRequirements,
+            });
+        }
+        if (!hostOperationFallback) {
+            throw buildEmbeddedResourceConfigurationError(`Composite resource runtime cannot derive related resource operations from host "${hostResourceType}" because no host operation is configured.`, {
+                hostResourceType,
+                targetResourceType,
+            });
+        }
+        const syntheticHostContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType: hostResourceType,
+            operation: hostOperationFallback,
+            contextResourceIdentifiers,
+            parentResourcesRequirements,
+        });
+        return frontendResourceUtils.deriveChildResourceContext(syntheticHostContext, {
+            resourceType: targetResourceType,
+            operationIdentifier: String(targetOperation.operationIdentifier),
+            operation: targetOperation,
+            resourceId: target.resourceId,
+            relationshipFieldOverrides: target.relationshipFieldOverrides,
+            additionalContext: target.additionalContext,
+        }, registry);
+    }, [
+        contextResourceIdentifiers,
+        hostOperationFallback,
+        hostResourceType,
+        parentResourcesRequirements,
+        registry,
+        resolveOperation,
+    ]);
+    /**
+     * Deliberately implemented by ATTEMPTING the real build rather than by
+     * re-deriving the conditions under which it succeeds. A second copy of that
+     * logic is a second thing to keep in sync, and it would answer `true` for a
+     * target the real builder rejects the moment the two drift.
+     */
+    const canBuildOperationContext = useCallback((target) => {
+        try {
+            buildOperationContext(target);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, [buildOperationContext]);
+    return useMemo(() => {
+        if (!hostResourceType || !hostResourceConfig) {
+            return null;
+        }
+        return {
+            hostResourceType,
+            hostResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[hostResourceType]),
+            hostResourceConfig,
+            contextResourceIdentifiers,
+            parentResourcesRequirements,
+            resolveOperation,
+            buildOperationContext,
+            canBuildOperationContext,
+        };
+    }, [
+        buildOperationContext,
+        canBuildOperationContext,
+        contextResourceIdentifiers,
+        hostResourceConfig,
+        hostResourceType,
+        parentResourcesRequirements,
+        resolveOperation,
+    ]);
+}
+export function useEmbeddedResourceContext() {
+    const context = useOptionalCompositeResourceContext();
+    if (!context) {
+        throw buildEmbeddedResourceConfigurationError('useEmbeddedResourceContext() must be used within a resource-scoped CompositeView.');
+    }
+    return context;
+}
+//# sourceMappingURL=useEmbeddedResourceContext.js.map

package/dist/esm/components/resources/embeds/useEmbeddedResourceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEmbeddedResourceContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/useEmbeddedResourceContext.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  ResourceOperationVariantType,\n} from '@wildo-ai/saas-models';\n\nimport { useOptionalEmbeddedResourceHostContext } from '~wildo-frontend-lib/components/resources/embeds/EmbeddedResourceHostContext';\nimport {\n  frontendResourceUtils,\n  FrontendResourceUtils,\n} from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\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';\n\n/**\n * Stable empty fallback. A nullish composite context must not mint a fresh `{}`\n * each render — `contextResourceIdentifiers` keys every memo below, so a new empty\n * object identity would recompute them all (and the returned context value) every\n * render, feeding the composite re-render loop.\n */\nconst EMPTY_CONTEXT_RESOURCE_IDENTIFIERS: FrontendResourceOperationContext['contextResourceIdentifiers'] =\n  Object.freeze({}) as FrontendResourceOperationContext['contextResourceIdentifiers'];\n\nexport interface EmbeddedResourceOperationTarget {\n  resourceType?: string;\n  resourceId?: string;\n  relationshipFieldOverrides?: Record<string, string>;\n  additionalContext?: Record<string, unknown>;\n}\n\nexport interface EmbeddedResourceOperationTarget_ByIdentifier extends EmbeddedResourceOperationTarget {\n  operationIdentifier: string;\n  variantType?: ResourceOperationVariantType;\n  variantKey?: string;\n  isOperationDefault?: boolean;\n  isBulkOperation?: boolean;\n  operationLike?: never;\n  requireAddressable?: never;\n  allowBulk?: never;\n}\n\nexport interface EmbeddedResourceOperationTarget_BySemantic extends EmbeddedResourceOperationTarget {\n  operationIdentifier?: never;\n  operationLike: CoreResourceOperation;\n  requireAddressable?: boolean;\n  allowBulk?: boolean;\n}\n\nexport type EmbeddedResourceOperationTargetSelector =\n  | EmbeddedResourceOperationTarget_ByIdentifier\n  | EmbeddedResourceOperationTarget_BySemantic;\n\nexport type EmbeddedResourceOperationTargetResolved =\n  EmbeddedResourceOperationTarget & EmbeddedResourceOperationTargetSelector;\n\nexport interface EmbeddedResourceContextValue {\n  hostResourceType: string;\n  hostResourceId?: string;\n  hostResourceConfig: AnyFrontendResourceConfiguration;\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  parentResourcesRequirements: FrontendResourceOperationContext['parentResourcesRequirements'];\n  resolveOperation: (\n    target: Pick<EmbeddedResourceOperationTargetResolved, 'resourceType'> & EmbeddedResourceOperationTargetSelector,\n  ) => FrontendResourceConfiguration_Operation;\n  buildOperationContext: (\n    target: EmbeddedResourceOperationTargetResolved,\n  ) => FrontendResourceOperationContext;\n  /**\n   * Non-throwing probe: `true` when {@link buildOperationContext} would succeed\n   * for this target, `false` when the target cannot be embedded at all.\n   *\n   * Exists because a target being un-embeddable is a NORMAL, authorable state, not\n   * an exceptional one. A resource can legitimately expose a core verb with no\n   * addressable HTTP variant — Wonder's todo recurring-occurrences declares LIST as\n   * `INTERNAL_CALL` only, deliberately — and a surface that places several children\n   * must be able to drop that one without the throw taking the whole page down with\n   * it. That is exactly the failure the automatic container already avoids by\n   * skipping a child it cannot display.\n   */\n  canBuildOperationContext: (\n    target: EmbeddedResourceOperationTargetResolved,\n  ) => boolean;\n}\n\nfunction buildEmbeddedResourceConfigurationError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      message,\n      component: 'useEmbeddedResourceContext',\n      ...context,\n    },\n  );\n}\n\nfunction hasOperationIdentifier(\n  target: EmbeddedResourceOperationTargetSelector,\n): target is EmbeddedResourceOperationTarget_ByIdentifier {\n  return typeof target.operationIdentifier === 'string';\n}\n\nfunction resolveOperationOrThrow(\n  resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  resourceType: string,\n  target: EmbeddedResourceOperationTarget_ByIdentifier,\n  registry: ReturnType<typeof useResourceRegistry>['registry'],\n  contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'],\n): FrontendResourceConfiguration_Operation {\n  const matchingOperations = (resourceConfig?.operations ?? []).filter((candidate) => {\n    if (String(candidate.operationIdentifier) !== target.operationIdentifier) {\n      return false;\n    }\n    if (target.variantType !== undefined && candidate.variantType !== target.variantType) {\n      return false;\n    }\n    if (target.variantKey !== undefined && candidate.variantKey !== target.variantKey) {\n      return false;\n    }\n    if (target.isOperationDefault !== undefined && candidate.isOperationDefault !== target.isOperationDefault) {\n      return false;\n    }\n    if (target.isBulkOperation !== undefined && candidate.isBulkOperation !== target.isBulkOperation) {\n      return false;\n    }\n    return true;\n  });\n  const defaultNonBulkOperations = matchingOperations.filter(\n    (candidate) => candidate.isOperationDefault === true && candidate.isBulkOperation !== true,\n  );\n  const operation = matchingOperations.length === 1\n    ? matchingOperations[0]\n    : target.variantType === undefined\n      && target.variantKey === undefined\n      && target.isOperationDefault === undefined\n      && target.isBulkOperation === undefined\n      && defaultNonBulkOperations.length === 1\n      ? defaultNonBulkOperations[0]\n      : undefined;\n\n  if (!operation) {\n    throw buildEmbeddedResourceConfigurationError(\n      matchingOperations.length === 0\n        ? `Composite resource runtime cannot resolve operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`\n        : `Composite resource runtime found ambiguous operation \"${target.operationIdentifier}\" on resource \"${resourceType}\".`,\n      {\n        resourceType,\n        operationIdentifier: target.operationIdentifier,\n        variantType: target.variantType,\n        variantKey: target.variantKey,\n        isOperationDefault: target.isOperationDefault,\n        isBulkOperation: target.isBulkOperation,\n        candidates: matchingOperations.map((candidate) => ({\n          variantType: candidate.variantType,\n          variantKey: candidate.variantKey,\n          isOperationDefault: candidate.isOperationDefault,\n          isBulkOperation: candidate.isBulkOperation,\n        })),\n      },\n    );\n  }\n\n  const requiresRuntimeAddressability = resourceConfig\n    ? shouldRequireCurrentContextAddressabilityForOperation({\n      operation,\n      resourceType,\n      resourceConfig,\n    })\n    : false;\n  if (\n    resourceConfig\n    && requiresRuntimeAddressability\n    && operation.isBulkOperation !== true\n    && !isFrontendOperationAddressableForCurrentContext({\n      resourceConfig,\n      operation,\n      registry,\n      hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[resourceType]).length > 0,\n      contextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        contextResourceIdentifiers,\n        registry,\n      ),\n    })\n  ) {\n    throw buildEmbeddedResourceConfigurationError(\n      `Composite resource runtime resolved operation \"${target.operationIdentifier}\" on resource \"${resourceType}\", but it is not addressable in the current context.`,\n      {\n        resourceType,\n        operationIdentifier: target.operationIdentifier,\n      },\n    );\n  }\n\n  return operation;\n}\n\nexport function useOptionalCompositeResourceContext(): EmbeddedResourceContextValue | null {\n  // Host facts come from the NEUTRAL context, so this runtime serves a resource\n  // layout as readily as a composite view. The `hostResourceType` guard below is\n  // unchanged and still fails closed — only the SOURCE of the fact widened.\n  const compositeContext = useOptionalEmbeddedResourceHostContext();\n  const { registry } = useResourceRegistry();\n\n  const hostResourceType = compositeContext?.hostResourceType;\n  const contextResourceIdentifiers = compositeContext?.contextResourceIdentifiers ?? EMPTY_CONTEXT_RESOURCE_IDENTIFIERS;\n\n  const hostResourceConfig = useMemo(() => {\n    if (!hostResourceType) {\n      return undefined;\n    }\n\n    const resourceConfig = registry.resourceConfigurations[hostResourceType];\n    if (!resourceConfig) {\n      throw buildEmbeddedResourceConfigurationError(\n        `Composite resource runtime cannot resolve host resource \"${hostResourceType}\" from the registry.`,\n        {\n          hostResourceType,\n        },\n      );\n    }\n\n    return resourceConfig;\n  }, [hostResourceType, registry.resourceConfigurations]);\n\n  const parentResourcesRequirements = useMemo(() => {\n    if (!hostResourceType) {\n      return [];\n    }\n\n    return frontendResourceUtils.buildParentResourcesRequirements(\n      hostResourceType,\n      contextResourceIdentifiers,\n      registry,\n    );\n  }, [contextResourceIdentifiers, hostResourceType, registry]);\n\n  const hostOperationFallback = useMemo(() => {\n    if (!hostResourceConfig) {\n      return undefined;\n    }\n\n    return pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig: hostResourceConfig,\n      operations: hostResourceConfig.operations ?? [],\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: hostResourceType\n        ? frontendResourceUtils.getResourceId(contextResourceIdentifiers[hostResourceType]).length > 0\n        : false,\n      requireFrontendAddressable: true,\n      contextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(\n        contextResourceIdentifiers,\n        registry,\n      ),\n    }) ?? hostResourceConfig.operations?.[0];\n  }, [contextResourceIdentifiers, hostResourceConfig, hostResourceType, registry]);\n\n  const resolveOperation = useCallback<EmbeddedResourceContextValue['resolveOperation']>((target) => {\n    const targetResourceType = target.resourceType ?? hostResourceType;\n    if (!targetResourceType) {\n      throw buildEmbeddedResourceConfigurationError(\n        'Composite resource runtime is only available inside resource-scoped composite views.',\n        {\n          target,\n        },\n      );\n    }\n\n    const resourceConfig = targetResourceType === hostResourceType\n      ? hostResourceConfig\n      : registry.resourceConfigurations[targetResourceType];\n\n    if (hasOperationIdentifier(target)) {\n      return resolveOperationOrThrow(\n        resourceConfig,\n        targetResourceType,\n        target,\n        registry,\n        contextResourceIdentifiers,\n      );\n    }\n\n    const requiresRuntimeAddressability = target.operationLike === CoreResourceOperation.READ\n      || target.operationLike === CoreResourceOperation.UPDATE\n      || target.operationLike === CoreResourceOperation.DELETE;\n    const semanticOperation = target.requireAddressable || requiresRuntimeAddressability\n      ? resourceConfig\n        ? pickPreferredOperationForCoreSemanticAddressability({\n          resourceConfig,\n          operations: resourceConfig.operations ?? [],\n          coreOperation: target.operationLike,\n          registry,\n          hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[targetResourceType]).length > 0,\n          allowBulk: target.allowBulk,\n          requireFrontendAddressable: true,\n          contextResourceIdentifiers,\n          contextualParameters: FrontendResourceUtils.buildContextualParameters(\n            contextResourceIdentifiers,\n            registry,\n          ),\n        })\n        : undefined\n      : pickPreferredOperationForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        target.operationLike,\n        {\n          requireAddressable: target.requireAddressable,\n          allowBulk: target.allowBulk,\n        },\n      );\n\n    if (!semanticOperation) {\n      throw buildEmbeddedResourceConfigurationError(\n        `Composite resource runtime cannot resolve a preferred ${target.operationLike}-like operation on resource \"${targetResourceType}\".`,\n        {\n          resourceType: targetResourceType,\n          operationLike: target.operationLike,\n          requireAddressable: target.requireAddressable,\n          allowBulk: target.allowBulk,\n        },\n      );\n    }\n\n    return semanticOperation;\n  }, [contextResourceIdentifiers, hostResourceConfig, hostResourceType, registry]);\n\n  const buildOperationContext = useCallback<EmbeddedResourceContextValue['buildOperationContext']>((target) => {\n    if (!hostResourceType) {\n      throw buildEmbeddedResourceConfigurationError(\n        'Composite resource runtime is only available inside resource-scoped composite views.',\n        {\n          target,\n        },\n      );\n    }\n\n    const targetResourceType = target.resourceType ?? hostResourceType;\n    const targetOperation = resolveOperation({\n      resourceType: targetResourceType,\n      ...(hasOperationIdentifier(target)\n        ? {\n            operationIdentifier: target.operationIdentifier,\n            variantType: target.variantType,\n            variantKey: target.variantKey,\n            isOperationDefault: target.isOperationDefault,\n            isBulkOperation: target.isBulkOperation,\n          }\n        : {\n            operationLike: target.operationLike,\n            requireAddressable: target.requireAddressable,\n            allowBulk: target.allowBulk,\n          }),\n    });\n\n    if (targetResourceType === hostResourceType) {\n      const targetContextResourceIdentifiers = target.resourceId\n        ? {\n            ...contextResourceIdentifiers,\n            [hostResourceType]: target.resourceId,\n          }\n        : contextResourceIdentifiers;\n\n      const targetParentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(\n        hostResourceType,\n        targetContextResourceIdentifiers,\n        registry,\n        target.relationshipFieldOverrides,\n      );\n\n      return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType: hostResourceType,\n        operation: targetOperation,\n        contextResourceIdentifiers: targetContextResourceIdentifiers,\n        additionalContext: target.additionalContext,\n        parentResourcesRequirements: targetParentResourcesRequirements,\n      });\n    }\n\n    if (!hostOperationFallback) {\n      throw buildEmbeddedResourceConfigurationError(\n        `Composite resource runtime cannot derive related resource operations from host \"${hostResourceType}\" because no host operation is configured.`,\n        {\n          hostResourceType,\n          targetResourceType,\n        },\n      );\n    }\n\n    const syntheticHostContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: hostResourceType,\n      operation: hostOperationFallback,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n    });\n\n    return frontendResourceUtils.deriveChildResourceContext(\n      syntheticHostContext,\n      {\n        resourceType: targetResourceType,\n        operationIdentifier: String(targetOperation.operationIdentifier),\n        operation: targetOperation,\n        resourceId: target.resourceId,\n        relationshipFieldOverrides: target.relationshipFieldOverrides,\n        additionalContext: target.additionalContext,\n      },\n      registry,\n    );\n  }, [\n    contextResourceIdentifiers,\n    hostOperationFallback,\n    hostResourceType,\n    parentResourcesRequirements,\n    registry,\n    resolveOperation,\n  ]);\n\n  /**\n   * Deliberately implemented by ATTEMPTING the real build rather than by\n   * re-deriving the conditions under which it succeeds. A second copy of that\n   * logic is a second thing to keep in sync, and it would answer `true` for a\n   * target the real builder rejects the moment the two drift.\n   */\n  const canBuildOperationContext = useCallback<EmbeddedResourceContextValue['canBuildOperationContext']>(\n    (target) => {\n      try {\n        buildOperationContext(target);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    [buildOperationContext],\n  );\n\n  return useMemo<EmbeddedResourceContextValue | null>(() => {\n    if (!hostResourceType || !hostResourceConfig) {\n      return null;\n    }\n\n    return {\n      hostResourceType,\n      hostResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[hostResourceType]),\n      hostResourceConfig,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n      resolveOperation,\n      buildOperationContext,\n      canBuildOperationContext,\n    };\n  }, [\n    buildOperationContext,\n    canBuildOperationContext,\n    contextResourceIdentifiers,\n    hostResourceConfig,\n    hostResourceType,\n    parentResourcesRequirements,\n    resolveOperation,\n  ]);\n}\n\nexport function useEmbeddedResourceContext(): EmbeddedResourceContextValue {\n  const context = useOptionalCompositeResourceContext();\n\n  if (!context) {\n    throw buildEmbeddedResourceConfigurationError(\n      'useEmbeddedResourceContext() must be used within a resource-scoped CompositeView.',\n    );\n  }\n\n  return context;\n}\n"]}

package/dist/esm/components/resources/inserted-resource-view.frontend.utils.d.ts

@@ -1,4 +1,5 @@
-import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas.js';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
+import type { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
 /**
  * Resource layouts keep semantic context as `resourceType -> id | { fieldIdentifier, resourceId }`.
  * Inserted resource-owned views need both:
@@ -7,4 +8,23 @@ import type { FrontendResourceOperationContext } from '../../core/resources/reso
  *   can still resolve non-default parent bindings end to end.
  */
 export declare function normalizeInsertedResourceViewContextResourceIdentifiers(resourceContext: FrontendResourceOperationContext): Record<string, string>;
+/**
+ * An inserted resource-owned view (chart / composite / execution) that declares a
+ * MANDATORY, non-primary-scope parent requirement can only surface truthfully when
+ * the host operation actually carries that parent's identifier — the parent id is
+ * what scopes the view's data fetch (e.g. a chart's `PARENT_RESOURCE` context
+ * filter) and its anchor bindings.
+ *
+ * Hosts reached through a parent-bound route (`…/todos/:todoId/tasks/:taskId`)
+ * satisfy this; the SAME resource reached through a scope-level route
+ * (`…/organizations/:orgId/tasks/:taskId`) does not. Rendering the view anyway
+ * would silently widen its data to the whole accessible collection — the exact
+ * failure this gate exists to prevent. Mirrors launcher-item behavior, where an
+ * item whose REQUIRED route params are unsatisfiable is omitted rather than
+ * rendered broken.
+ *
+ * Primary-scope parents (org/user/application) are intentionally exempt: they are
+ * enforced by the backend scope-lock pipeline, not by navigation context.
+ */
+export declare function areMandatoryParentRequirementsSatisfied(parentResourcesRequirements: FrontendResource_ParentResourceRequirement[] | undefined, contextResourceIdentifiers: Record<string, string>): boolean;
 //# sourceMappingURL=inserted-resource-view.frontend.utils.d.ts.map

package/dist/esm/components/resources/inserted-resource-view.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inserted-resource-view.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/inserted-resource-view.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAEtH;;;;;;GAMG;AACH,wBAAgB,uDAAuD,CACrE,eAAe,EAAE,gCAAgC,GAChD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB"}
+{"version":3,"file":"inserted-resource-view.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/inserted-resource-view.frontend.utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAEtH;;;;;;GAMG;AACH,wBAAgB,uDAAuD,CACrE,eAAe,EAAE,gCAAgC,GAChD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uCAAuC,CACrD,2BAA2B,EAAE,0CAA0C,EAAE,GAAG,SAAS,EACrF,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjD,OAAO,CAmBT"}

package/dist/esm/components/resources/inserted-resource-view.frontend.utils.js

@@ -1,3 +1,4 @@
+import { ResourceParentResourceRequirement } from '@wildo-ai/saas-models';
 import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
 /**
  * Resource layouts keep semantic context as `resourceType -> id | { fieldIdentifier, resourceId }`.
@@ -23,4 +24,40 @@ export function normalizeInsertedResourceViewContextResourceIdentifiers(resource
     }
     return normalizedContextResourceIdentifiers;
 }
-//# sourceMappingURL=inserted-resource-view.frontend.utils.js.map
+/**
+ * An inserted resource-owned view (chart / composite / execution) that declares a
+ * MANDATORY, non-primary-scope parent requirement can only surface truthfully when
+ * the host operation actually carries that parent's identifier — the parent id is
+ * what scopes the view's data fetch (e.g. a chart's `PARENT_RESOURCE` context
+ * filter) and its anchor bindings.
+ *
+ * Hosts reached through a parent-bound route (`…/todos/:todoId/tasks/:taskId`)
+ * satisfy this; the SAME resource reached through a scope-level route
+ * (`…/organizations/:orgId/tasks/:taskId`) does not. Rendering the view anyway
+ * would silently widen its data to the whole accessible collection — the exact
+ * failure this gate exists to prevent. Mirrors launcher-item behavior, where an
+ * item whose REQUIRED route params are unsatisfiable is omitted rather than
+ * rendered broken.
+ *
+ * Primary-scope parents (org/user/application) are intentionally exempt: they are
+ * enforced by the backend scope-lock pipeline, not by navigation context.
+ */
+export function areMandatoryParentRequirementsSatisfied(parentResourcesRequirements, contextResourceIdentifiers) {
+    if (!parentResourcesRequirements || parentResourcesRequirements.length === 0) {
+        return true;
+    }
+    return parentResourcesRequirements.every((requirement) => {
+        if (requirement.requirement !== ResourceParentResourceRequirement.MANDATORY) {
+            return true;
+        }
+        if (requirement.isPrimaryScope) {
+            return true;
+        }
+        const byForeignKey = requirement.foreignKeyField
+            ? contextResourceIdentifiers[requirement.foreignKeyField]
+            : undefined;
+        const byResourceType = contextResourceIdentifiers[requirement.resourceType];
+        return Boolean(byForeignKey ?? byResourceType);
+    });
+}
+//# sourceMappingURL=inserted-resource-view.frontend.utils.js.map

package/dist/esm/components/resources/inserted-resource-view.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"inserted-resource-view.frontend.utils.js","sourceRoot":"","sources":["../../../../src/components/resources/inserted-resource-view.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAGnG;;;;;;GAMG;AACH,MAAM,UAAU,uDAAuD,CACrE,eAAiD;IAEjD,MAAM,oCAAoC,GAA2B,EAAE,CAAC;IAExE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACtF,MAAM,UAAU,GAAG,qBAAqB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,oCAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAEvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,iBAAiB,IAAI,KAAK,EAAE,CAAC;YAC9E,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;YAC9C,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,oCAAoC,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oCAAoC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"inserted-resource-view.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/inserted-resource-view.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAInG;;;;;;GAMG;AACH,MAAM,UAAU,uDAAuD,CACrE,eAAiD;IAEjD,MAAM,oCAAoC,GAA2B,EAAE,CAAC;IAExE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACtF,MAAM,UAAU,GAAG,qBAAqB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,oCAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAEvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,iBAAiB,IAAI,KAAK,EAAE,CAAC;YAC9E,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;YAC9C,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,oCAAoC,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oCAAoC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uCAAuC,CACrD,2BAAqF,EACrF,0BAAkD;IAElD,IAAI,CAAC,2BAA2B,IAAI,2BAA2B,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE;QACvD,IAAI,WAAW,CAAC,WAAW,KAAK,iCAAiC,CAAC,SAAS,EAAE,CAAC;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe;YAC9C,CAAC,CAAC,0BAA0B,CAAC,WAAW,CAAC,eAAe,CAAC;YACzD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,cAAc,GAAG,0BAA0B,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { ResourceParentResourceRequirement } from '@wildo-ai/saas-models';\n\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/**\n * Resource layouts keep semantic context as `resourceType -> id | { fieldIdentifier, resourceId }`.\n * Inserted resource-owned views need both:\n * - the semantic resource slot (`TODOS -> todo-1`) so generic context survives\n * - the FK field alias (`todoId -> todo-1`) so parent-bound routes and child derivation\n *   can still resolve non-default parent bindings end to end.\n */\nexport function normalizeInsertedResourceViewContextResourceIdentifiers(\n  resourceContext: FrontendResourceOperationContext,\n): Record<string, string> {\n  const normalizedContextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(resourceContext.contextResourceIdentifiers)) {\n    const resourceId = frontendResourceUtils.getResourceId(value);\n    if (!resourceId) {\n      continue;\n    }\n\n    normalizedContextResourceIdentifiers[key] = resourceId;\n\n    if (typeof value === 'object' && value !== null && 'fieldIdentifier' in value) {\n      const fieldIdentifier = value.fieldIdentifier;\n      if (typeof fieldIdentifier === 'string' && fieldIdentifier.length > 0) {\n        normalizedContextResourceIdentifiers[fieldIdentifier] = resourceId;\n      }\n    }\n  }\n\n  return normalizedContextResourceIdentifiers;\n}\n\n/**\n * An inserted resource-owned view (chart / composite / execution) that declares a\n * MANDATORY, non-primary-scope parent requirement can only surface truthfully when\n * the host operation actually carries that parent's identifier — the parent id is\n * what scopes the view's data fetch (e.g. a chart's `PARENT_RESOURCE` context\n * filter) and its anchor bindings.\n *\n * Hosts reached through a parent-bound route (`…/todos/:todoId/tasks/:taskId`)\n * satisfy this; the SAME resource reached through a scope-level route\n * (`…/organizations/:orgId/tasks/:taskId`) does not. Rendering the view anyway\n * would silently widen its data to the whole accessible collection — the exact\n * failure this gate exists to prevent. Mirrors launcher-item behavior, where an\n * item whose REQUIRED route params are unsatisfiable is omitted rather than\n * rendered broken.\n *\n * Primary-scope parents (org/user/application) are intentionally exempt: they are\n * enforced by the backend scope-lock pipeline, not by navigation context.\n */\nexport function areMandatoryParentRequirementsSatisfied(\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirement[] | undefined,\n  contextResourceIdentifiers: Record<string, string>,\n): boolean {\n  if (!parentResourcesRequirements || parentResourcesRequirements.length === 0) {\n    return true;\n  }\n\n  return parentResourcesRequirements.every((requirement) => {\n    if (requirement.requirement !== ResourceParentResourceRequirement.MANDATORY) {\n      return true;\n    }\n    if (requirement.isPrimaryScope) {\n      return true;\n    }\n\n    const byForeignKey = requirement.foreignKeyField\n      ? contextResourceIdentifiers[requirement.foreignKeyField]\n      : undefined;\n    const byResourceType = contextResourceIdentifiers[requirement.resourceType];\n    return Boolean(byForeignKey ?? byResourceType);\n  });\n}\n"]}

package/dist/esm/components/resources/resource-operation-custom-view.contracts.d.ts

@@ -1,10 +1,10 @@
 import type React from 'react';
-import type { ResourceLayoutPreset_Action_DefaultProps } from './ResourceLayout_Action.js';
-import type { ResourceLayoutPreset_Create_DefaultProps } from './ResourceLayout_Create.js';
-import type { ResourceLayoutPreset_List_DefaultProps } from './ResourceLayout_List.js';
-import type { ResourceLayoutPreset_Read_DefaultProps } from './ResourceLayout_Read.js';
-import type { ResourceLayoutPreset_Search_DefaultProps } from './ResourceLayout_Search.js';
-import type { ResourceLayoutPreset_Update_DefaultProps } from './ResourceLayout_Update.js';
+import type { ResourceLayoutPreset_Action_DefaultProps } from './ResourceLayout_Action';
+import type { ResourceLayoutPreset_Create_DefaultProps } from './ResourceLayout_Create';
+import type { ResourceLayoutPreset_List_DefaultProps } from './ResourceLayout_List';
+import type { ResourceLayoutPreset_Read_DefaultProps } from './ResourceLayout_Read';
+import type { ResourceLayoutPreset_Search_DefaultProps } from './ResourceLayout_Search';
+import type { ResourceLayoutPreset_Update_DefaultProps } from './ResourceLayout_Update';
 export type ResourceActionCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Action_DefaultProps>;
 export type ResourceCreateCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Create_DefaultProps>;
 export type ResourceListCustomViewComponent = React.ComponentType<ResourceLayoutPreset_List_DefaultProps>;

package/dist/esm/components/resources/resource-operation-custom-view.contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-operation-custom-view.contracts.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC"}
+{"version":3,"file":"resource-operation-custom-view.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC"}

package/dist/esm/components/resources/resource-operation-custom-view.contracts.js

@@ -1 +1 @@
-//# sourceMappingURL=resource-operation-custom-view.contracts.js.map
+//# sourceMappingURL=resource-operation-custom-view.contracts.js.map

package/dist/esm/components/resources/resource-operation-custom-view.contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-operation-custom-view.contracts.js","sourceRoot":"","sources":["../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resource-operation-custom-view.contracts.js","sourceRoot":"","sources":["../../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ResourceLayoutPreset_Action_DefaultProps } from './ResourceLayout_Action';\nimport type { ResourceLayoutPreset_Create_DefaultProps } from './ResourceLayout_Create';\nimport type { ResourceLayoutPreset_List_DefaultProps } from './ResourceLayout_List';\nimport type { ResourceLayoutPreset_Read_DefaultProps } from './ResourceLayout_Read';\nimport type { ResourceLayoutPreset_Search_DefaultProps } from './ResourceLayout_Search';\nimport type { ResourceLayoutPreset_Update_DefaultProps } from './ResourceLayout_Update';\n\nexport type ResourceActionCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Action_DefaultProps>;\nexport type ResourceCreateCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Create_DefaultProps>;\nexport type ResourceListCustomViewComponent = React.ComponentType<ResourceLayoutPreset_List_DefaultProps>;\nexport type ResourceReadCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Read_DefaultProps>;\nexport type ResourceSearchCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Search_DefaultProps>;\nexport type ResourceUpdateCustomViewComponent = React.ComponentType<ResourceLayoutPreset_Update_DefaultProps>;\n"]}

package/dist/esm/components/resources/resourceLayout.utils.d.ts

@@ -1,5 +1,37 @@
-import type { AnyFrontendResourceConfiguration } from '../../core/resources/resources.frontend.schemas.js';
-import type { FilterFieldDefinition } from './ResourceLayout_FiltersControl.js';
+import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
+import type { FilterFieldDefinition } from './ResourceLayout_FiltersControl';
+/**
+ * Transport context for filter-field parsing.
+ *
+ * When provided, `parseFilterFieldDefinitions` derives two transport truths
+ * that a bare `filterFields` record cannot express:
+ *
+ * 1. **Pinned fields** — fields whose value the transport already fixes for
+ *    this operation in the current context. A user-facing filter on a pinned
+ *    field is meaningless (the constraint applies before any filter could),
+ *    so pinned fields are excluded from the returned definitions. The pinned
+ *    set is the union of:
+ *      - parameters consumed by the URL route the transport will select
+ *        (computed via `FrontendResourceUtils.selectOperationUrlInitiatorInfo`
+ *        — the same deterministic selection the HTTP client performs), and
+ *      - the resource's primary-scope field identifier (backend authorization
+ *        scope-filters the collection by it regardless of route shape, so a
+ *        user-supplied value could never widen the result set).
+ *
+ * 2. **Reference fields** — string-typed filter fields whose name resolves to
+ *    a resource type through the registry's relationship-enriched
+ *    `fieldIdentifierToResourceType` map are foreign keys. They carry
+ *    `fieldType: 'reference'` plus the resolved target so the filter UI can
+ *    render a resource-reference selector instead of a raw ID text input.
+ */
+export interface FilterFieldTransportContext {
+    registry: FrontendResourcesRegistry;
+    resourceConfig: AnyFrontendResourceConfiguration;
+    operation: FrontendResourceConfiguration_Operation;
+    contextualParameters: Record<string, string | number | string[] | undefined>;
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+}
 /**
  * Static utility class for ResourceLayout non-component logic.
  * Centralises filter field parsing and summary field extraction used across
@@ -12,12 +44,33 @@ export declare class ResourceLayoutUtils {
      * Returns only explicitly annotated fields — no config overrides, no heuristic fallbacks.
      */
     static detectSummaryFields(resourceConfig: AnyFrontendResourceConfiguration | undefined): string[];
+    /**
+     * Compute the set of filter-field names that the transport already pins for
+     * the given operation in the current context. See
+     * {@link FilterFieldTransportContext} for the semantics of each component.
+     *
+     * Returns an empty set when the operation carries no URL surface (e.g.
+     * non-URL variants) — primary-scope pinning still applies because backend
+     * authorization enforces it independently of routing.
+     */
+    private static computeTransportPinnedFieldNames;
     /**
      * Parse raw filterFields (Record) into FilterFieldDefinition[].
      * Used when reading directly from an operation object (LIST or SEARCH).
      * Skips function-typed entries (filter references) and maps each field's
      * Zod schema to a UI-friendly type.
+     *
+     * When `transportContext` is provided, the definitions are additionally:
+     * - reduced to fields the user can actually act on (transport-pinned
+     *   fields are excluded — see {@link FilterFieldTransportContext}), and
+     * - enriched with foreign-key classification (`fieldType: 'reference'` +
+     *   `referenceTargetResourceType`) so the filter UI renders reference
+     *   selectors for FK fields instead of raw ID inputs.
+     *
+     * Without `transportContext` the parse is purely structural (schema-type
+     * mapping only) — callers that have no operation/registry at hand keep the
+     * legacy behavior.
      */
-    static parseFilterFieldDefinitions(rawFilterFields: Record<string, unknown> | undefined): readonly FilterFieldDefinition[];
+    static parseFilterFieldDefinitions(rawFilterFields: Record<string, unknown> | undefined, transportContext?: FilterFieldTransportContext): readonly FilterFieldDefinition[];
 }
 //# sourceMappingURL=resourceLayout.utils.d.ts.map

package/dist/esm/components/resources/resourceLayout.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceLayout.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAG7E;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO;IAEP;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,gCAAgC,GAAG,SAAS,GAC3D,MAAM,EAAE;IA0BX;;;;;OAKG;IACH,MAAM,CAAC,2BAA2B,CAChC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACnD,SAAS,qBAAqB,EAAE;CA+CpC"}
+{"version":3,"file":"resourceLayout.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,uCAAuC,CAAC;IACnD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7E,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO;IAEP;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,gCAAgC,GAAG,SAAS,GAC3D,MAAM,EAAE;IA4CX;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAwC/C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,2BAA2B,CAChC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,gBAAgB,CAAC,EAAE,2BAA2B,GAC7C,SAAS,qBAAqB,EAAE;CAsEpC"}