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

package/dist/esm/core/execution/execution-participation.utils.js

@@ -0,0 +1,355 @@
+import { ErrorCustomMessageReference, Resources_SharedUtils, isOneToOneCardinality, } from '@wildo-ai/saas-models';
+import { ExecutionViewAnchorBindingSource, ExecutionParticipationSource, } from '../../core/config/execution-view.schemas.js';
+import { FrontendResourceUtils, frontendResourceUtils, } from '../../core/resources/frontend-resource.utils.js';
+export var ExecutionParticipationValueShape;
+(function (ExecutionParticipationValueShape) {
+    ExecutionParticipationValueShape["SINGLE"] = "single";
+    ExecutionParticipationValueShape["ARRAY"] = "array";
+})(ExecutionParticipationValueShape || (ExecutionParticipationValueShape = {}));
+function getRequirementBindingKey(requirement) {
+    return requirement.foreignKeyField ?? requirement.resourceType;
+}
+function resolveRequirementByBindingKey(params) {
+    const matches = (params.requirements ?? []).filter((requirement) => getRequirementBindingKey(requirement) === params.bindingKey);
+    return matches.length === 1 ? matches[0] : undefined;
+}
+function getCandidateRelationships(currentResourceType, registry) {
+    const resourceRelationships = registry.resourceConfigurations[currentResourceType]
+        ?.resourceRelationships;
+    if (!resourceRelationships) {
+        return [];
+    }
+    const ensureCompiledRelationship = (relationship, allResourceFieldIdentifiers) => Resources_SharedUtils.ensureCompiledRelationship.call(Resources_SharedUtils, relationship, allResourceFieldIdentifiers);
+    return [
+        ...resourceRelationships.parentRelationships,
+        ...resourceRelationships.childRelationships,
+        ...resourceRelationships.selfRelationships,
+    ].map((relationship) => ensureCompiledRelationship(relationship, registry.allResourceFieldIdentifiers));
+}
+function resolveRequirementParticipation(params) {
+    const requirement = resolveRequirementByBindingKey({
+        bindingKey: params.bindingKey,
+        requirements: params.requirements,
+    });
+    if (!requirement) {
+        return undefined;
+    }
+    return {
+        ref: params.ref,
+        source: params.source,
+        requirement,
+        contextValue: params.contextResourceIdentifiers?.[params.bindingKey],
+    };
+}
+function resolveRelationshipProjectionParticipation(params) {
+    const currentResourceType = getExecutionParticipationResourceType(params.sourceParticipation);
+    if (currentResourceType === params.definition.targetResourceType) {
+        return undefined;
+    }
+    const candidates = getCandidateRelationships(currentResourceType, params.registry)
+        .filter((relationship) => {
+        const relationshipTouchesTarget = (relationship.resourceType1 === params.definition.targetResourceType
+            || relationship.resourceType2 === params.definition.targetResourceType);
+        if (!relationshipTouchesTarget) {
+            return false;
+        }
+        if (params.definition.foreignKeyField
+            && Resources_SharedUtils.tryResolveRelationshipForeignKeyIdentity(relationship, params.registry.allResourceFieldIdentifiers)?.fieldIdentifier !== params.definition.foreignKeyField) {
+            return false;
+        }
+        const parentResourceData = relationship.resourceType1 === currentResourceType
+            ? params.sourceResourceData
+            : undefined;
+        return Resources_SharedUtils.isRelationshipActiveForParent(relationship, parentResourceData, {
+            onMissingParentResource: 'exclude',
+            onConditionError: 'exclude',
+        });
+    });
+    if (candidates.length !== 1) {
+        return undefined;
+    }
+    return {
+        ref: params.ref,
+        source: ExecutionParticipationSource.RELATIONSHIP_PROJECTION,
+        fromParticipationRef: params.definition.fromParticipationRef,
+        relationship: candidates[0],
+        currentResourceType,
+    };
+}
+/**
+ * Resolve authored execution participations into thin runtime handles.
+ *
+ * Important design constraints:
+ * - anchor/requirement participations preserve the original context value shape
+ * - relationship projections keep compiled relationship handles instead of
+ *   copying semantics/FK metadata into the public runtime type
+ * - ambiguous matches fail closed rather than choosing one edge implicitly
+ */
+export function resolveExecutionParticipations(params) {
+    const definitions = params.viewDefinition.participations ?? {};
+    const resolvedParticipations = new Map();
+    const resolvingRefs = new Set();
+    const resolveParticipation = (ref) => {
+        const existingParticipation = resolvedParticipations.get(ref);
+        if (existingParticipation) {
+            return existingParticipation;
+        }
+        const definition = definitions[ref];
+        if (!definition || resolvingRefs.has(ref)) {
+            return undefined;
+        }
+        resolvingRefs.add(ref);
+        let resolvedParticipation;
+        switch (definition.source) {
+            case ExecutionParticipationSource.ANCHOR: {
+                if (params.anchor) {
+                    const contextValue = params.explicitContextResourceIdentifiers?.[params.anchor.bindingKey];
+                    if (contextValue) {
+                        const requirements = params.viewDefinition.anchor?.source
+                            === ExecutionViewAnchorBindingSource.PARENT_RESOURCE_REQUIREMENT
+                            ? params.viewDefinition.parentResourcesRequirements
+                            : params.viewDefinition.additionalResourceRequirements;
+                        resolvedParticipation = {
+                            ref,
+                            source: ExecutionParticipationSource.ANCHOR,
+                            resourceType: params.anchor.mainResourceType,
+                            bindingKey: params.anchor.bindingKey,
+                            requirement: resolveRequirementByBindingKey({
+                                bindingKey: params.anchor.bindingKey,
+                                requirements,
+                            }),
+                            contextValue,
+                        };
+                    }
+                }
+                break;
+            }
+            case ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT: {
+                resolvedParticipation = resolveRequirementParticipation({
+                    ref,
+                    source: ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT,
+                    bindingKey: definition.bindingKey,
+                    requirements: params.viewDefinition.parentResourcesRequirements,
+                    contextResourceIdentifiers: params.contextResourceIdentifiers,
+                });
+                break;
+            }
+            case ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT: {
+                resolvedParticipation = resolveRequirementParticipation({
+                    ref,
+                    source: ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT,
+                    bindingKey: definition.bindingKey,
+                    requirements: params.viewDefinition.additionalResourceRequirements,
+                    contextResourceIdentifiers: params.contextResourceIdentifiers,
+                });
+                break;
+            }
+            case ExecutionParticipationSource.RELATIONSHIP_PROJECTION: {
+                const sourceParticipation = resolveParticipation(definition.fromParticipationRef);
+                if (sourceParticipation) {
+                    resolvedParticipation = resolveRelationshipProjectionParticipation({
+                        ref,
+                        definition,
+                        sourceParticipation,
+                        sourceResourceData: params.sourceResourceDataByParticipationRef?.[definition.fromParticipationRef],
+                        registry: params.registry,
+                    });
+                }
+                break;
+            }
+        }
+        resolvingRefs.delete(ref);
+        if (resolvedParticipation) {
+            resolvedParticipations.set(ref, resolvedParticipation);
+        }
+        return resolvedParticipation;
+    };
+    for (const ref of Object.keys(definitions)) {
+        resolveParticipation(ref);
+    }
+    return Object.fromEntries(resolvedParticipations.entries());
+}
+export function getExecutionParticipationContextValue(participation) {
+    if (participation.source === ExecutionParticipationSource.ANCHOR
+        || participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT
+        || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT) {
+        return participation.contextValue;
+    }
+    return undefined;
+}
+export function getExecutionParticipationResourceType(participation) {
+    if (participation.source === ExecutionParticipationSource.ANCHOR) {
+        return participation.resourceType;
+    }
+    if (participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT
+        || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT) {
+        return participation.requirement.resourceType;
+    }
+    if (participation.source === ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {
+        const relationship = participation.relationship;
+        return relationship.resourceType1 === participation.currentResourceType
+            ? relationship.resourceType2
+            : relationship.resourceType1;
+    }
+    throw new Error('Unknown execution participation source');
+}
+export function getExecutionParticipationResourceId(participation) {
+    const contextValue = getExecutionParticipationContextValue(participation);
+    const resourceId = frontendResourceUtils.getResourceId(contextValue);
+    return resourceId.length > 0 ? resourceId : undefined;
+}
+export function getExecutionParticipationRequirement(participation) {
+    if (participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT
+        || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT) {
+        return participation.requirement;
+    }
+    return undefined;
+}
+export function getExecutionParticipationRelationship(participation) {
+    return participation.source === ExecutionParticipationSource.RELATIONSHIP_PROJECTION
+        ? participation.relationship
+        : undefined;
+}
+export function getExecutionParticipationRelationshipSemantics(participation) {
+    const relationship = getExecutionParticipationRelationship(participation);
+    return relationship
+        ? Resources_SharedUtils.getResolvedRelationshipSemantics(relationship)
+        : undefined;
+}
+export function getExecutionParticipationForeignKeyIdentity(participation, allResourceFieldIdentifiers) {
+    const relationship = getExecutionParticipationRelationship(participation);
+    return relationship
+        ? Resources_SharedUtils.tryResolveRelationshipForeignKeyIdentity(relationship, allResourceFieldIdentifiers)
+        : undefined;
+}
+export function getExecutionParticipationEdgeKey(participation, registry) {
+    if (participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT
+        || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT) {
+        return participation.requirement.relationshipEdgeKey;
+    }
+    if (participation.source !== ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {
+        return undefined;
+    }
+    const foreignKeyIdentity = getExecutionParticipationForeignKeyIdentity(participation, registry.allResourceFieldIdentifiers);
+    return FrontendResourceUtils.buildRelationshipEdgeKey({
+        parentResourceType: participation.relationship.resourceType1,
+        childResourceType: participation.relationship.resourceType2,
+        foreignKeyField: foreignKeyIdentity?.fieldIdentifier ?? participation.relationship.foreignKeyField,
+    });
+}
+export function getExecutionParticipationValueShape(participation) {
+    if (participation.source !== ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {
+        return ExecutionParticipationValueShape.SINGLE;
+    }
+    const targetCardinality = participation.relationship.resourceType1 === participation.currentResourceType
+        ? participation.relationship.cardinality2
+        : participation.relationship.cardinality1;
+    return isOneToOneCardinality(targetCardinality)
+        ? ExecutionParticipationValueShape.SINGLE
+        : ExecutionParticipationValueShape.ARRAY;
+}
+/**
+ * Build the canonical resource-context slot for one resolved execution participation.
+ *
+ * This is the resource-context analogue of
+ * `buildExecutionParticipationContextualParameters()`: it preserves the semantic
+ * `resourceType -> id | { fieldIdentifier, resourceId }` shape used across the
+ * frontend runtime so execution consumers can embed ordinary resource surfaces
+ * without hand-authoring alias metadata.
+ */
+export function buildExecutionParticipationContextIdentifier(params) {
+    const contextValue = getExecutionParticipationContextValue(params.participation);
+    if (!contextValue) {
+        return undefined;
+    }
+    const resourceId = frontendResourceUtils.getResourceId(contextValue);
+    if (!resourceId) {
+        return undefined;
+    }
+    const resourceType = getExecutionParticipationResourceType(params.participation);
+    const defaultFieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, params.registry);
+    const explicitFieldIdentifier = frontendResourceUtils.getFieldIdentifier(contextValue);
+    const requirementFieldIdentifier = params.participation.source === ExecutionParticipationSource.ANCHOR
+        ? params.participation.requirement?.foreignKeyField
+        : getExecutionParticipationRequirement(params.participation)?.foreignKeyField;
+    const fieldIdentifier = explicitFieldIdentifier ?? requirementFieldIdentifier;
+    if (fieldIdentifier && fieldIdentifier !== defaultFieldIdentifier) {
+        return {
+            fieldIdentifier,
+            resourceId,
+        };
+    }
+    return resourceId;
+}
+/**
+ * Build transport-ready contextual parameters from selected participations.
+ *
+ * Unlike ordinary `contextResourceIdentifiers`, execution participations are
+ * addressed by authored refs rather than by resource-type keys. This bridge keeps
+ * the same physical output contract (`fieldIdentifier -> id`) while resolving the
+ * appropriate field identifier from each participation's canonical requirement or
+ * registry metadata.
+ */
+export function buildExecutionParticipationContextualParameters(params) {
+    const contextualParameters = {};
+    for (const ref of params.participationRefs) {
+        const participation = params.participations[ref];
+        if (!participation) {
+            throw FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+                component: 'buildExecutionParticipationContextualParameters',
+                message: `Unknown execution participation ref "${ref}".`,
+                participationRef: ref,
+            });
+        }
+        const contextIdentifier = buildExecutionParticipationContextIdentifier({
+            participation,
+            registry: params.registry,
+        });
+        if (!contextIdentifier) {
+            continue;
+        }
+        const resourceId = frontendResourceUtils.getResourceId(contextIdentifier);
+        if (!resourceId) {
+            continue;
+        }
+        const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(contextIdentifier)
+            ?? FrontendResourceUtils.getResourceFieldIdentifierForType(getExecutionParticipationResourceType(participation), params.registry);
+        const existingValue = contextualParameters[fieldIdentifier];
+        if (existingValue !== undefined && existingValue !== resourceId) {
+            throw FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+                component: 'buildExecutionParticipationContextualParameters',
+                message: `Execution participations resolved conflicting contextual values for "${fieldIdentifier}".`,
+                fieldIdentifier,
+                previousValue: existingValue,
+                nextValue: resourceId,
+                participationRef: ref,
+            });
+        }
+        contextualParameters[fieldIdentifier] = resourceId;
+    }
+    return contextualParameters;
+}
+/**
+ * Pure builder for an `ExecutionParticipationHandle`.
+ *
+ * This is intentionally hook-free so it can be composed inside `useMemo(...)`
+ * call sites without forcing a dedicated custom hook per consumer.
+ */
+export function buildExecutionParticipationHandle(params) {
+    return {
+        participation: params.participation,
+        resourceType: getExecutionParticipationResourceType(params.participation),
+        resourceId: getExecutionParticipationResourceId(params.participation),
+        valueShape: getExecutionParticipationValueShape(params.participation),
+        contextValue: getExecutionParticipationContextValue(params.participation),
+        contextIdentifier: buildExecutionParticipationContextIdentifier({
+            participation: params.participation,
+            registry: params.registry,
+        }),
+        requirement: getExecutionParticipationRequirement(params.participation),
+        relationship: getExecutionParticipationRelationshipSemantics(params.participation),
+        rawRelationship: getExecutionParticipationRelationship(params.participation),
+        edgeKey: getExecutionParticipationEdgeKey(params.participation, params.registry),
+    };
+}
+//# sourceMappingURL=execution-participation.utils.js.map

package/dist/esm/core/execution/execution-participation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-participation.utils.js","sourceRoot":"","sources":["../../../../../src/core/execution/execution-participation.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ErrorCustomMessageReference,\n  Resources_SharedUtils,\n  isOneToOneCardinality,\n  type ResourceRelationship,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\n\nimport {\n  ExecutionViewAnchorBindingSource,\n  ExecutionParticipationSource,\n  type ExecutionParticipationDefinition,\n  type ExecutionViewDefinition,\n} from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n  FrontendResourceUtils,\n  frontendResourceUtils,\n} 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 {\n  FrontendResourceOperationContext,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport type ExecutionParticipationContextValue =\n  FrontendResourceOperationContext['contextResourceIdentifiers'][string];\n\nexport enum ExecutionParticipationValueShape {\n  SINGLE = 'single',\n  ARRAY = 'array',\n}\n\nexport type ResolvedExecutionParticipation =\n  | {\n      ref: string;\n      source: ExecutionParticipationSource.ANCHOR;\n      resourceType: ResourceType;\n      bindingKey: string;\n      requirement?: FrontendResource_ParentResourceRequirement;\n      contextValue: ExecutionParticipationContextValue;\n    }\n  | {\n      ref: string;\n      source:\n        | ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n        | ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT;\n      requirement: FrontendResource_ParentResourceRequirement;\n      contextValue?: ExecutionParticipationContextValue;\n    }\n  | {\n      ref: string;\n      source: ExecutionParticipationSource.RELATIONSHIP_PROJECTION;\n      fromParticipationRef: string;\n      relationship: ResourceRelationship;\n      currentResourceType: ResourceType;\n    };\n\ninterface ResolveExecutionParticipationsParams {\n  viewDefinition: ExecutionViewDefinition;\n  registry: FrontendResourcesRegistry;\n  anchor?: {\n    mainResourceType: string;\n    mainResourceId: string;\n    bindingKey: string;\n  } | null;\n  contextResourceIdentifiers?: Record<string, ExecutionParticipationContextValue>;\n  explicitContextResourceIdentifiers?: Record<string, ExecutionParticipationContextValue>;\n  sourceResourceDataByParticipationRef?: Record<string, Record<string, unknown> | undefined>;\n}\n\nfunction getRequirementBindingKey(\n  requirement: FrontendResource_ParentResourceRequirement,\n): string {\n  return requirement.foreignKeyField ?? requirement.resourceType;\n}\n\nfunction resolveRequirementByBindingKey(params: {\n  bindingKey: string;\n  requirements?: FrontendResource_ParentResourceRequirement[];\n}): FrontendResource_ParentResourceRequirement | undefined {\n  const matches = (params.requirements ?? []).filter((requirement) =>\n    getRequirementBindingKey(requirement) === params.bindingKey\n  );\n\n  return matches.length === 1 ? matches[0] : undefined;\n}\n\nfunction getCandidateRelationships(\n  currentResourceType: ResourceType,\n  registry: FrontendResourcesRegistry,\n): ResourceRelationship[] {\n  const resourceRelationships = registry.resourceConfigurations[currentResourceType]\n    ?.resourceRelationships;\n\n  if (!resourceRelationships) {\n    return [];\n  }\n\n  const ensureCompiledRelationship = (\n    relationship: ResourceRelationship,\n    allResourceFieldIdentifiers?: Record<string, string>,\n  ): ResourceRelationship => (\n    Resources_SharedUtils.ensureCompiledRelationship as (\n      relationship: ResourceRelationship,\n      allResourceFieldIdentifiers?: Record<string, string>\n    ) => ResourceRelationship\n  ).call(Resources_SharedUtils, relationship, allResourceFieldIdentifiers);\n\n  return [\n    ...resourceRelationships.parentRelationships,\n    ...resourceRelationships.childRelationships,\n    ...resourceRelationships.selfRelationships,\n  ].map((relationship) => ensureCompiledRelationship(\n    relationship,\n    registry.allResourceFieldIdentifiers,\n  ));\n}\n\nfunction resolveRequirementParticipation(params: {\n  ref: string;\n  source:\n    | ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n    | ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT;\n  bindingKey: string;\n  requirements?: FrontendResource_ParentResourceRequirement[];\n  contextResourceIdentifiers?: Record<string, ExecutionParticipationContextValue>;\n}): ResolvedExecutionParticipation | undefined {\n  const requirement = resolveRequirementByBindingKey({\n    bindingKey: params.bindingKey,\n    requirements: params.requirements,\n  });\n\n  if (!requirement) {\n    return undefined;\n  }\n\n  return {\n    ref: params.ref,\n    source: params.source,\n    requirement,\n    contextValue: params.contextResourceIdentifiers?.[params.bindingKey],\n  };\n}\n\nfunction resolveRelationshipProjectionParticipation(params: {\n  ref: string;\n  definition: Extract<\n    ExecutionParticipationDefinition,\n    { source: ExecutionParticipationSource.RELATIONSHIP_PROJECTION }\n  >;\n  sourceParticipation: ResolvedExecutionParticipation;\n  sourceResourceData?: Record<string, unknown>;\n  registry: FrontendResourcesRegistry;\n}): ResolvedExecutionParticipation | undefined {\n  const currentResourceType = getExecutionParticipationResourceType(\n    params.sourceParticipation,\n  );\n  if (currentResourceType === params.definition.targetResourceType) {\n    return undefined;\n  }\n\n  const candidates = getCandidateRelationships(currentResourceType, params.registry)\n    .filter((relationship) => {\n      const relationshipTouchesTarget = (\n        relationship.resourceType1 === params.definition.targetResourceType\n        || relationship.resourceType2 === params.definition.targetResourceType\n      );\n      if (!relationshipTouchesTarget) {\n        return false;\n      }\n\n      if (\n        params.definition.foreignKeyField\n        && Resources_SharedUtils.tryResolveRelationshipForeignKeyIdentity(\n          relationship,\n          params.registry.allResourceFieldIdentifiers,\n        )?.fieldIdentifier !== params.definition.foreignKeyField\n      ) {\n        return false;\n      }\n\n      const parentResourceData = relationship.resourceType1 === currentResourceType\n        ? params.sourceResourceData\n        : undefined;\n\n      return Resources_SharedUtils.isRelationshipActiveForParent(\n        relationship,\n        parentResourceData,\n        {\n          onMissingParentResource: 'exclude',\n          onConditionError: 'exclude',\n        },\n      );\n    });\n\n  if (candidates.length !== 1) {\n    return undefined;\n  }\n\n  return {\n    ref: params.ref,\n    source: ExecutionParticipationSource.RELATIONSHIP_PROJECTION,\n    fromParticipationRef: params.definition.fromParticipationRef,\n    relationship: candidates[0],\n    currentResourceType,\n  };\n}\n\n/**\n * Resolve authored execution participations into thin runtime handles.\n *\n * Important design constraints:\n * - anchor/requirement participations preserve the original context value shape\n * - relationship projections keep compiled relationship handles instead of\n *   copying semantics/FK metadata into the public runtime type\n * - ambiguous matches fail closed rather than choosing one edge implicitly\n */\nexport function resolveExecutionParticipations(\n  params: ResolveExecutionParticipationsParams,\n): Record<string, ResolvedExecutionParticipation> {\n  const definitions = params.viewDefinition.participations ?? {};\n  const resolvedParticipations = new Map<string, ResolvedExecutionParticipation>();\n  const resolvingRefs = new Set<string>();\n\n  const resolveParticipation = (\n    ref: string,\n  ): ResolvedExecutionParticipation | undefined => {\n    const existingParticipation = resolvedParticipations.get(ref);\n    if (existingParticipation) {\n      return existingParticipation;\n    }\n\n    const definition = definitions[ref];\n    if (!definition || resolvingRefs.has(ref)) {\n      return undefined;\n    }\n\n    resolvingRefs.add(ref);\n\n    let resolvedParticipation: ResolvedExecutionParticipation | undefined;\n\n    switch (definition.source) {\n      case ExecutionParticipationSource.ANCHOR: {\n        if (params.anchor) {\n          const contextValue = params.explicitContextResourceIdentifiers?.[params.anchor.bindingKey];\n          if (contextValue) {\n            const requirements = params.viewDefinition.anchor?.source\n              === ExecutionViewAnchorBindingSource.PARENT_RESOURCE_REQUIREMENT\n              ? params.viewDefinition.parentResourcesRequirements\n              : params.viewDefinition.additionalResourceRequirements;\n            resolvedParticipation = {\n              ref,\n              source: ExecutionParticipationSource.ANCHOR,\n              resourceType: params.anchor.mainResourceType,\n              bindingKey: params.anchor.bindingKey,\n              requirement: resolveRequirementByBindingKey({\n                bindingKey: params.anchor.bindingKey,\n                requirements,\n              }),\n              contextValue,\n            };\n          }\n        }\n        break;\n      }\n      case ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT: {\n        resolvedParticipation = resolveRequirementParticipation({\n          ref,\n          source: ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT,\n          bindingKey: definition.bindingKey,\n          requirements: params.viewDefinition.parentResourcesRequirements,\n          contextResourceIdentifiers: params.contextResourceIdentifiers,\n        });\n        break;\n      }\n      case ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT: {\n        resolvedParticipation = resolveRequirementParticipation({\n          ref,\n          source: ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT,\n          bindingKey: definition.bindingKey,\n          requirements: params.viewDefinition.additionalResourceRequirements,\n          contextResourceIdentifiers: params.contextResourceIdentifiers,\n        });\n        break;\n      }\n      case ExecutionParticipationSource.RELATIONSHIP_PROJECTION: {\n        const sourceParticipation = resolveParticipation(definition.fromParticipationRef);\n        if (sourceParticipation) {\n          resolvedParticipation = resolveRelationshipProjectionParticipation({\n            ref,\n            definition,\n            sourceParticipation,\n            sourceResourceData: params.sourceResourceDataByParticipationRef?.[definition.fromParticipationRef],\n            registry: params.registry,\n          });\n        }\n        break;\n      }\n    }\n\n    resolvingRefs.delete(ref);\n\n    if (resolvedParticipation) {\n      resolvedParticipations.set(ref, resolvedParticipation);\n    }\n\n    return resolvedParticipation;\n  };\n\n  for (const ref of Object.keys(definitions)) {\n    resolveParticipation(ref);\n  }\n\n  return Object.fromEntries(resolvedParticipations.entries());\n}\n\nexport function getExecutionParticipationContextValue(\n  participation: ResolvedExecutionParticipation,\n): ExecutionParticipationContextValue | undefined {\n  if (\n    participation.source === ExecutionParticipationSource.ANCHOR\n    || participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n    || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT\n  ) {\n    return participation.contextValue;\n  }\n\n  return undefined;\n}\n\nexport function getExecutionParticipationResourceType(\n  participation: ResolvedExecutionParticipation,\n): ResourceType {\n  if (participation.source === ExecutionParticipationSource.ANCHOR) {\n    return participation.resourceType;\n  }\n\n  if (\n    participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n    || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT\n  ) {\n    return participation.requirement.resourceType;\n  }\n\n  if (participation.source === ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {\n    const relationship = participation.relationship;\n\n    return relationship.resourceType1 === participation.currentResourceType\n      ? relationship.resourceType2\n      : relationship.resourceType1;\n  }\n\n  throw new Error('Unknown execution participation source');\n}\n\nexport function getExecutionParticipationResourceId(\n  participation: ResolvedExecutionParticipation,\n): string | undefined {\n  const contextValue = getExecutionParticipationContextValue(participation);\n  const resourceId = frontendResourceUtils.getResourceId(contextValue);\n\n  return resourceId.length > 0 ? resourceId : undefined;\n}\n\nexport function getExecutionParticipationRequirement(\n  participation: ResolvedExecutionParticipation,\n): FrontendResource_ParentResourceRequirement | undefined {\n  if (\n    participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n    || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT\n  ) {\n    return participation.requirement;\n  }\n\n  return undefined;\n}\n\nexport function getExecutionParticipationRelationship(\n  participation: ResolvedExecutionParticipation,\n): ResourceRelationship | undefined {\n  return participation.source === ExecutionParticipationSource.RELATIONSHIP_PROJECTION\n    ? participation.relationship\n    : undefined;\n}\n\nexport function getExecutionParticipationRelationshipSemantics(\n  participation: ResolvedExecutionParticipation,\n): ReturnType<typeof Resources_SharedUtils.getResolvedRelationshipSemantics> | undefined {\n  const relationship = getExecutionParticipationRelationship(participation);\n\n  return relationship\n    ? Resources_SharedUtils.getResolvedRelationshipSemantics(relationship)\n    : undefined;\n}\n\nexport function getExecutionParticipationForeignKeyIdentity(\n  participation: ResolvedExecutionParticipation,\n  allResourceFieldIdentifiers: FrontendResourcesRegistry['allResourceFieldIdentifiers'],\n): ReturnType<typeof Resources_SharedUtils.tryResolveRelationshipForeignKeyIdentity> | undefined {\n  const relationship = getExecutionParticipationRelationship(participation);\n\n  return relationship\n    ? Resources_SharedUtils.tryResolveRelationshipForeignKeyIdentity(\n        relationship,\n        allResourceFieldIdentifiers,\n      )\n    : undefined;\n}\n\nexport function getExecutionParticipationEdgeKey(\n  participation: ResolvedExecutionParticipation,\n  registry: FrontendResourcesRegistry,\n): string | undefined {\n  if (\n    participation.source === ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT\n    || participation.source === ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT\n  ) {\n    return participation.requirement.relationshipEdgeKey;\n  }\n\n  if (participation.source !== ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {\n    return undefined;\n  }\n\n  const foreignKeyIdentity = getExecutionParticipationForeignKeyIdentity(\n    participation,\n    registry.allResourceFieldIdentifiers,\n  );\n\n  return FrontendResourceUtils.buildRelationshipEdgeKey({\n    parentResourceType: participation.relationship.resourceType1,\n    childResourceType: participation.relationship.resourceType2,\n    foreignKeyField: foreignKeyIdentity?.fieldIdentifier ?? participation.relationship.foreignKeyField,\n  });\n}\n\nexport function getExecutionParticipationValueShape(\n  participation: ResolvedExecutionParticipation,\n): ExecutionParticipationValueShape {\n  if (participation.source !== ExecutionParticipationSource.RELATIONSHIP_PROJECTION) {\n    return ExecutionParticipationValueShape.SINGLE;\n  }\n\n  const targetCardinality = participation.relationship.resourceType1 === participation.currentResourceType\n    ? participation.relationship.cardinality2\n    : participation.relationship.cardinality1;\n\n  return isOneToOneCardinality(targetCardinality)\n    ? ExecutionParticipationValueShape.SINGLE\n    : ExecutionParticipationValueShape.ARRAY;\n}\n\n/**\n * Build the canonical resource-context slot for one resolved execution participation.\n *\n * This is the resource-context analogue of\n * `buildExecutionParticipationContextualParameters()`: it preserves the semantic\n * `resourceType -> id | { fieldIdentifier, resourceId }` shape used across the\n * frontend runtime so execution consumers can embed ordinary resource surfaces\n * without hand-authoring alias metadata.\n */\nexport function buildExecutionParticipationContextIdentifier(params: {\n  participation: ResolvedExecutionParticipation;\n  registry: FrontendResourcesRegistry;\n}): FrontendResourceOperationContext['contextResourceIdentifiers'][string] | undefined {\n  const contextValue = getExecutionParticipationContextValue(params.participation);\n  if (!contextValue) {\n    return undefined;\n  }\n\n  const resourceId = frontendResourceUtils.getResourceId(contextValue);\n  if (!resourceId) {\n    return undefined;\n  }\n\n  const resourceType = getExecutionParticipationResourceType(params.participation);\n  const defaultFieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(\n    resourceType,\n    params.registry,\n  );\n  const explicitFieldIdentifier = frontendResourceUtils.getFieldIdentifier(contextValue);\n  const requirementFieldIdentifier = params.participation.source === ExecutionParticipationSource.ANCHOR\n    ? params.participation.requirement?.foreignKeyField\n    : getExecutionParticipationRequirement(params.participation)?.foreignKeyField;\n  const fieldIdentifier = explicitFieldIdentifier ?? requirementFieldIdentifier;\n\n  if (fieldIdentifier && fieldIdentifier !== defaultFieldIdentifier) {\n    return {\n      fieldIdentifier,\n      resourceId,\n    };\n  }\n\n  return resourceId;\n}\n\n/**\n * Build transport-ready contextual parameters from selected participations.\n *\n * Unlike ordinary `contextResourceIdentifiers`, execution participations are\n * addressed by authored refs rather than by resource-type keys. This bridge keeps\n * the same physical output contract (`fieldIdentifier -> id`) while resolving the\n * appropriate field identifier from each participation's canonical requirement or\n * registry metadata.\n */\nexport function buildExecutionParticipationContextualParameters(params: {\n  participationRefs: string[];\n  participations: Record<string, ResolvedExecutionParticipation>;\n  registry: FrontendResourcesRegistry;\n}): Record<string, string | number> {\n  const contextualParameters: Record<string, string | number> = {};\n\n  for (const ref of params.participationRefs) {\n    const participation = params.participations[ref];\n    if (!participation) {\n      throw FrontendResourceUtils.buildConfigurationError(\n        ErrorCustomMessageReference.CONFIGURATION,\n        {\n          component: 'buildExecutionParticipationContextualParameters',\n          message: `Unknown execution participation ref \"${ref}\".`,\n          participationRef: ref,\n        },\n      );\n    }\n\n    const contextIdentifier = buildExecutionParticipationContextIdentifier({\n      participation,\n      registry: params.registry,\n    });\n    if (!contextIdentifier) {\n      continue;\n    }\n\n    const resourceId = frontendResourceUtils.getResourceId(contextIdentifier);\n    if (!resourceId) {\n      continue;\n    }\n\n    const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(contextIdentifier)\n      ?? FrontendResourceUtils.getResourceFieldIdentifierForType(\n        getExecutionParticipationResourceType(participation),\n        params.registry,\n      );\n\n    const existingValue = contextualParameters[fieldIdentifier];\n    if (existingValue !== undefined && existingValue !== resourceId) {\n      throw FrontendResourceUtils.buildConfigurationError(\n        ErrorCustomMessageReference.CONFIGURATION,\n        {\n          component: 'buildExecutionParticipationContextualParameters',\n          message: `Execution participations resolved conflicting contextual values for \"${fieldIdentifier}\".`,\n          fieldIdentifier,\n          previousValue: existingValue,\n          nextValue: resourceId,\n          participationRef: ref,\n        },\n      );\n    }\n\n    contextualParameters[fieldIdentifier] = resourceId;\n  }\n\n  return contextualParameters;\n}\n\n/**\n * Derived, renderer-facing snapshot of a single resolved execution\n * participation.\n *\n * Bundles the main derived runtime facts (resource id, value shape, context\n * identifier, relationship, edge key) into one object so renderers do not have\n * to re-assemble the same derivations for every participation they consume.\n */\nexport interface ExecutionParticipationHandle {\n  participation: ResolvedExecutionParticipation;\n  resourceType: ResourceType;\n  resourceId?: string;\n  valueShape: ExecutionParticipationValueShape;\n  contextValue?: ExecutionParticipationContextValue;\n  contextIdentifier?: FrontendResourceOperationContext['contextResourceIdentifiers'][string];\n  requirement?: FrontendResource_ParentResourceRequirement;\n  /**\n   * Derived relationship semantics (nature, handling, direction) for\n   * relationship-projected participations. This is the renderer-facing\n   * contract; use `rawRelationship` when you need the underlying\n   * `ResourceRelationship`.\n   */\n  relationship?: ReturnType<typeof getExecutionParticipationRelationshipSemantics>;\n  /** Raw compiled `ResourceRelationship` edge. Prefer `relationship` for rendering decisions. */\n  rawRelationship?: ResourceRelationship;\n  edgeKey?: string;\n}\n\n/**\n * Pure builder for an `ExecutionParticipationHandle`.\n *\n * This is intentionally hook-free so it can be composed inside `useMemo(...)`\n * call sites without forcing a dedicated custom hook per consumer.\n */\nexport function buildExecutionParticipationHandle(params: {\n  participation: ResolvedExecutionParticipation;\n  registry: FrontendResourcesRegistry;\n}): ExecutionParticipationHandle {\n  return {\n    participation: params.participation,\n    resourceType: getExecutionParticipationResourceType(params.participation),\n    resourceId: getExecutionParticipationResourceId(params.participation),\n    valueShape: getExecutionParticipationValueShape(params.participation),\n    contextValue: getExecutionParticipationContextValue(params.participation),\n    contextIdentifier: buildExecutionParticipationContextIdentifier({\n      participation: params.participation,\n      registry: params.registry,\n    }),\n    requirement: getExecutionParticipationRequirement(params.participation),\n    relationship: getExecutionParticipationRelationshipSemantics(params.participation),\n    rawRelationship: getExecutionParticipationRelationship(params.participation),\n    edgeKey: getExecutionParticipationEdgeKey(params.participation, params.registry),\n  };\n}\n"]}