@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/resources/operation-semantics.frontend.utils.js

@@ -0,0 +1,167 @@
+import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';
+export const BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY = 'bulkOperationSelectionIds';
+export const RESOURCE_OPERATION_EXECUTED_DISCRIMINATOR_CONTEXT_KEY = 'resourceOperationExecutedDiscriminator';
+export function isLiteralCoreResourceOperation(operationIdentifier) {
+    return Object.values(CoreResourceOperation).includes(operationIdentifier);
+}
+export function resolveEffectiveCoreOperation(operationIdentifier, resourceOperationLike) {
+    if (resourceOperationLike && Object.values(CoreResourceOperation).includes(resourceOperationLike)) {
+        return resourceOperationLike;
+    }
+    if (Object.values(CoreResourceOperation).includes(operationIdentifier)) {
+        return operationIdentifier;
+    }
+    return undefined;
+}
+export function resolveEffectiveCoreOperationFromOperation(operation) {
+    return resolveEffectiveCoreOperation(operation.operationIdentifier, operation.resourceOperationLike);
+}
+export function matchesResourceOperationSemantic(operation, coreOperation) {
+    return resolveEffectiveCoreOperationFromOperation(operation) === coreOperation;
+}
+export function isUpdateLikeCoreOperation(coreOperation) {
+    return coreOperation === CoreResourceOperation.UPDATE
+        || coreOperation === CoreResourceOperation.UPDATE_MANY;
+}
+export function isSingleResourceUpdateLikeOperation(operation) {
+    return operation.isBulkOperation !== true
+        && isUpdateLikeCoreOperation(resolveEffectiveCoreOperationFromOperation(operation));
+}
+export function shouldEmitResourceRefreshAfterDirectOperation(operation) {
+    const effectiveOperation = resolveEffectiveCoreOperationFromOperation(operation);
+    switch (effectiveOperation) {
+        case CoreResourceOperation.CREATE:
+        case CoreResourceOperation.CREATE_MANY:
+        case CoreResourceOperation.UPDATE:
+        case CoreResourceOperation.UPDATE_MANY:
+        case CoreResourceOperation.DELETE:
+        case CoreResourceOperation.DELETE_MANY:
+            return true;
+        default:
+            return false;
+    }
+}
+export function readBulkOperationSelectionIds(additionalContext) {
+    const value = additionalContext?.[BULK_OPERATION_SELECTION_IDS_CONTEXT_KEY];
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const ids = value.filter((candidate) => typeof candidate === 'string');
+    return ids.length > 0 ? ids : undefined;
+}
+export function readResourceOperationExecutedDiscriminator(additionalContext) {
+    const value = additionalContext?.[RESOURCE_OPERATION_EXECUTED_DISCRIMINATOR_CONTEXT_KEY];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+export function mergeBulkSelectionIntoRequestData(params) {
+    if (params.operation.isBulkOperation !== true) {
+        return params.requestData;
+    }
+    const ids = readBulkOperationSelectionIds(params.additionalContext);
+    if (!ids || ids.length === 0) {
+        return params.requestData;
+    }
+    return {
+        ...(params.requestData ?? {}),
+        ids,
+    };
+}
+export function isSemanticCustomResourceOperation(operation) {
+    return !isLiteralCoreResourceOperation(operation.operationIdentifier)
+        && resolveEffectiveCoreOperationFromOperation(operation) !== undefined;
+}
+export const NON_ITEM_RESOURCE_OPERATIONS = new Set([
+    CoreResourceOperation.LIST,
+    CoreResourceOperation.SEARCH,
+    CoreResourceOperation.COUNT,
+    CoreResourceOperation.CREATE,
+    CoreResourceOperation.CREATE_MANY,
+    CoreResourceOperation.READ,
+]);
+export const NAVIGABLE_RESOURCE_OPERATIONS = new Set([
+    CoreResourceOperation.CREATE,
+    CoreResourceOperation.READ,
+    CoreResourceOperation.UPDATE,
+]);
+export function shouldTreatAsNonItemResourceOperation(operation) {
+    return isLiteralCoreResourceOperation(operation.operationIdentifier)
+        && NON_ITEM_RESOURCE_OPERATIONS.has(operation.operationIdentifier);
+}
+export function shouldNavigateResourceOperation(operation) {
+    if (isLiteralCoreResourceOperation(operation.operationIdentifier)) {
+        return NAVIGABLE_RESOURCE_OPERATIONS.has(operation.operationIdentifier);
+    }
+    return Boolean(operation.requestDto) || Boolean(operation.operationFrontendConfig?.isAddressable);
+}
+export function resolveResourceOperationLayoutKind(operation) {
+    const effectiveOperation = resolveEffectiveCoreOperationFromOperation(operation);
+    if (!effectiveOperation) {
+        return 'action';
+    }
+    switch (effectiveOperation) {
+        case CoreResourceOperation.CREATE:
+        case CoreResourceOperation.CREATE_MANY:
+            return 'create';
+        case CoreResourceOperation.LIST:
+            return 'list';
+        case CoreResourceOperation.READ:
+        case CoreResourceOperation.DELETE:
+        case CoreResourceOperation.DELETE_MANY:
+            return 'read';
+        case CoreResourceOperation.UPDATE:
+        case CoreResourceOperation.UPDATE_MANY:
+            return 'update';
+        case CoreResourceOperation.SEARCH:
+            return 'search';
+        default:
+            return 'action';
+    }
+}
+export function pickPreferredOperationForCoreSemantic(operations, coreOperation, options) {
+    const filtered = getOperationsForCoreSemantic(operations, coreOperation, options);
+    if (filtered.length === 0) {
+        return undefined;
+    }
+    const preferredVariantTypes = [
+        ResourceOperationVariantType.API_CALL,
+        ResourceOperationVariantType.API_CALL_WITH_CALLBACK,
+    ];
+    return [...filtered].sort((left, right) => {
+        const leftLiteral = left.operationIdentifier === coreOperation ? 1 : 0;
+        const rightLiteral = right.operationIdentifier === coreOperation ? 1 : 0;
+        if (leftLiteral !== rightLiteral) {
+            return rightLiteral - leftLiteral;
+        }
+        const leftPreferredVariant = preferredVariantTypes.includes(left.variantType) ? 1 : 0;
+        const rightPreferredVariant = preferredVariantTypes.includes(right.variantType) ? 1 : 0;
+        if (leftPreferredVariant !== rightPreferredVariant) {
+            return rightPreferredVariant - leftPreferredVariant;
+        }
+        const leftDefault = left.isOperationDefault ? 1 : 0;
+        const rightDefault = right.isOperationDefault ? 1 : 0;
+        if (leftDefault !== rightDefault) {
+            return rightDefault - leftDefault;
+        }
+        const leftAddressable = left.operationFrontendConfig?.isAddressable ? 1 : 0;
+        const rightAddressable = right.operationFrontendConfig?.isAddressable ? 1 : 0;
+        if (leftAddressable !== rightAddressable) {
+            return rightAddressable - leftAddressable;
+        }
+        return String(left.variantKey ?? '').localeCompare(String(right.variantKey ?? ''));
+    })[0];
+}
+export function getOperationsForCoreSemantic(operations, coreOperation, options) {
+    return operations.filter((operation) => {
+        if (!matchesResourceOperationSemantic(operation, coreOperation)) {
+            return false;
+        }
+        if (options?.requireAddressable && !operation.operationFrontendConfig?.isAddressable) {
+            return false;
+        }
+        if (options?.allowBulk !== true && operation.isBulkOperation) {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=operation-semantics.frontend.utils.js.map

package/dist/esm/core/resources/operation-semantics.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-semantics.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/resources/operation-semantics.frontend.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/resources/relationship-quick-create.frontend.utils.d.ts

@@ -0,0 +1,69 @@
+import { RelationshipNature, type ResourceType } from '@wildo-ai/saas-models';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { type NavigationZone } from '../../core/navigation/navigation.schemas.js';
+import type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+export interface QuickCreateRequestContext {
+    requestId: string;
+    sourceResourceType?: string;
+    sourceResourceId?: string;
+    sourceFieldName: string;
+    relatedResourceType: ResourceType;
+}
+export interface QuickCreateCompletionPayload {
+    requestId: string;
+    resourceType: ResourceType;
+    resourceId: string;
+    data?: Record<string, unknown>;
+}
+export interface ResolvedRelationshipQuickCreateConfig {
+    sourceKind: 'foreignKey' | 'relationshipObject';
+    relatedResourceType: ResourceType;
+    relationshipNature: RelationshipNature;
+    allowQuickCreate: boolean;
+}
+export interface UseRelationshipQuickCreateOptions {
+    sourceResourceType?: ResourceType;
+    sourceResourceId?: string;
+    sourceFieldName?: string;
+    sourceOperation?: string;
+    relatedResourceType?: ResourceType;
+    contextResourceIdentifiers?: Record<string, string | {
+        fieldIdentifier: string;
+        resourceId: string;
+    }>;
+    navigationZone?: NavigationZone;
+    operationType?: string;
+    onCreated?: (payload: QuickCreateCompletionPayload) => void | Promise<void>;
+}
+export interface UseRelationshipQuickCreateResult {
+    canQuickCreate: boolean;
+    isLaunching: boolean;
+    launchQuickCreate: () => void;
+    relatedCreateOperation?: FrontendResourceConfiguration_Operation;
+    config?: ResolvedRelationshipQuickCreateConfig;
+}
+export declare function resolveRelationshipQuickCreateConfig(params: {
+    resourceType: ResourceType;
+    fieldName: string;
+    operationType?: string;
+    relatedResourceType?: ResourceType;
+    registry: FrontendResourcesRegistry;
+}): ResolvedRelationshipQuickCreateConfig | undefined;
+export declare function resolveQuickCreateCreateOperation(params: {
+    relatedResourceType: ResourceType;
+    registry: FrontendResourcesRegistry;
+}): FrontendResourceConfiguration_Operation | undefined;
+export declare function resolveQuickCreateCreatedResourceId(params: {
+    result: unknown;
+    resourceType: ResourceType;
+    registry: FrontendResourcesRegistry;
+}): string | undefined;
+export declare function useRelationshipQuickCreate(options: UseRelationshipQuickCreateOptions): UseRelationshipQuickCreateResult;
+export declare function emitQuickCreateCompleted(params: {
+    emit: ReturnType<typeof useEventBus>['emit'];
+    resourceType: ResourceType;
+    resourceId: string;
+    requestId: string;
+    data?: Record<string, unknown>;
+}): void;
+//# sourceMappingURL=relationship-quick-create.frontend.utils.d.ts.map

package/dist/esm/core/resources/relationship-quick-create.frontend.utils.d.ts.map

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

package/dist/esm/core/resources/relationship-quick-create.frontend.utils.js

@@ -0,0 +1,171 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { NavigationTransition, } from '@wildo-ai/saas-models';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { NavigationContentType } from '../../core/navigation/navigation.schemas.js';
+import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
+import { useNavigationController } from '../../core/navigation/useNavigationController.js';
+import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { resolveRelationshipQuickCreateCreateOperation, resolveRelationshipSurfaceRuntime, } from '../../core/resources/relationship-surface-runtime.frontend.utils.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+const QUICK_CREATE_EVENT_NAME = 'relationship.quick_create.completed';
+function createQuickCreateRequestId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return `quick-create-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+export function resolveRelationshipQuickCreateConfig(params) {
+    const quickCreate = resolveRelationshipSurfaceRuntime({
+        resourceType: params.resourceType,
+        fieldName: params.fieldName,
+        operationType: params.operationType,
+        relatedResourceType: params.relatedResourceType,
+        registry: params.registry,
+    }).inlineEditSurface?.quickCreate;
+    if (!quickCreate) {
+        return undefined;
+    }
+    return {
+        sourceKind: quickCreate.sourceKind,
+        relatedResourceType: quickCreate.relatedResourceType,
+        relationshipNature: quickCreate.relationshipNature,
+        allowQuickCreate: quickCreate.allowQuickCreate,
+    };
+}
+export function resolveQuickCreateCreateOperation(params) {
+    return resolveRelationshipQuickCreateCreateOperation(params);
+}
+export function resolveQuickCreateCreatedResourceId(params) {
+    if (!params.result || typeof params.result !== 'object' || Array.isArray(params.result)) {
+        return undefined;
+    }
+    const resultRecord = params.result;
+    const configuredFieldIdentifier = params.registry.resourceConfigurations?.[params.resourceType]?.resourceFieldIdentifier
+        ?? params.registry.allResourceFieldIdentifiers?.[params.resourceType]
+        ?? '_id';
+    const rawId = resultRecord[configuredFieldIdentifier] ?? resultRecord._id;
+    return typeof rawId === 'string' && rawId !== '' ? rawId : undefined;
+}
+export function useRelationshipQuickCreate(options) {
+    const { registry } = useResourceRegistry();
+    const { on } = useEventBus();
+    const { navigate } = useNavigationController();
+    const [isLaunching, setIsLaunching] = useState(false);
+    const pendingRequestIdRef = useRef(null);
+    const config = useMemo(() => {
+        if (!options.sourceResourceType || !options.sourceFieldName) {
+            return undefined;
+        }
+        return resolveRelationshipSurfaceRuntime({
+            resourceType: options.sourceResourceType,
+            fieldName: options.sourceFieldName,
+            operationType: options.operationType,
+            relatedResourceType: options.relatedResourceType,
+            registry,
+        }).inlineEditSurface?.quickCreate;
+    }, [
+        options.sourceFieldName,
+        options.sourceResourceType,
+        options.operationType,
+        options.relatedResourceType,
+        registry,
+    ]);
+    const relatedCreateOperation = useMemo(() => {
+        if (!config) {
+            return undefined;
+        }
+        return config.relatedCreateOperation;
+    }, [config]);
+    useEffect(() => on(FrontendEvents.RESOURCE_CUSTOM_EVENT, (payload) => {
+        const data = payload.data;
+        if (!data || data.requestId !== pendingRequestIdRef.current) {
+            return;
+        }
+        pendingRequestIdRef.current = null;
+        setIsLaunching(false);
+        void options.onCreated?.(data);
+    }, (payload) => {
+        if (payload.eventName !== QUICK_CREATE_EVENT_NAME) {
+            return false;
+        }
+        const data = payload.data;
+        return data?.requestId === pendingRequestIdRef.current;
+    }), [on, options]);
+    useEffect(() => on(FrontendEvents.NAVIGATION_CLOSE, () => {
+        setIsLaunching(false);
+    }), [on]);
+    const launchQuickCreate = useCallback(() => {
+        if (!config ||
+            !config.allowQuickCreate ||
+            !relatedCreateOperation ||
+            !options.navigationZone ||
+            !options.sourceFieldName) {
+            return;
+        }
+        const requestId = createQuickCreateRequestId();
+        pendingRequestIdRef.current = requestId;
+        setIsLaunching(true);
+        const requestContext = {
+            requestId,
+            sourceResourceType: options.sourceResourceType,
+            sourceResourceId: options.sourceResourceId,
+            sourceFieldName: options.sourceFieldName,
+            relatedResourceType: config.relatedResourceType,
+        };
+        const resourceContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType: config.relatedResourceType,
+            operation: relatedCreateOperation,
+            contextResourceIdentifiers: options.contextResourceIdentifiers ?? {},
+            additionalContext: {
+                quickCreateRequest: requestContext,
+            },
+            isOperationDefault: relatedCreateOperation.isOperationDefault ?? true,
+            isBulkOperation: relatedCreateOperation.isBulkOperation ?? false,
+            variantKey: relatedCreateOperation.variantKey,
+        });
+        navigate({
+            content: {
+                contentType: NavigationContentType.RESOURCE_OPERATION,
+                resourceContext,
+            },
+            initiator: NavigationUtils.createOperationInitiator(options.navigationZone, options.sourceOperation),
+            relationshipTransition: options.navigationZone === 'overlay'
+                ? NavigationTransition.SPLIT
+                : { transition: NavigationTransition.OVERLAY, ephemeral: true },
+        });
+    }, [
+        config,
+        navigate,
+        options.contextResourceIdentifiers,
+        options.navigationZone,
+        options.sourceFieldName,
+        options.sourceOperation,
+        options.sourceResourceId,
+        options.sourceResourceType,
+        relatedCreateOperation,
+    ]);
+    return {
+        canQuickCreate: Boolean(config?.allowQuickCreate &&
+            relatedCreateOperation &&
+            options.navigationZone),
+        isLaunching,
+        launchQuickCreate,
+        relatedCreateOperation,
+        config,
+    };
+}
+export function emitQuickCreateCompleted(params) {
+    params.emit(FrontendEvents.RESOURCE_CUSTOM_EVENT, {
+        resourceType: params.resourceType,
+        resourceId: params.resourceId,
+        eventName: QUICK_CREATE_EVENT_NAME,
+        data: {
+            requestId: params.requestId,
+            resourceType: params.resourceType,
+            resourceId: params.resourceId,
+            data: params.data,
+        },
+    });
+}
+//# sourceMappingURL=relationship-quick-create.frontend.utils.js.map

package/dist/esm/core/resources/relationship-quick-create.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-quick-create.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/resources/relationship-quick-create.frontend.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/resources/relationship-surface-runtime.frontend.utils.d.ts

@@ -0,0 +1,115 @@
+import { NavigationZoneName, ParentDisplay, RelationshipNature, Resources_SharedUtils, type RelationshipDisplayInParentNavigation, type RelationshipDisplayInParentView, type ResourceRelationship, type ResourceType, type TransitionConfig } from '@wildo-ai/saas-models';
+import type { SectionConfig } from '@wildo-ai/presets-components-models';
+import type { z } from 'zod';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import type { InlineParentContext } from '../../components/resources/component-props.resources-layout.frontend.schemas.js';
+import type { NavigationInitiatorContext, NavigationZone, NavigationZoneState } from '../../core/navigation/navigation.schemas.js';
+import type { ResolvedRelationshipObjectFieldSemantics } from '../../core/resources/frontend-resource.utils.js';
+import type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+export interface RelationshipSurfaceQuickCreateDescriptor {
+    sourceKind: 'foreignKey' | 'relationshipObject';
+    relatedResourceType: ResourceType;
+    relationshipNature: RelationshipNature;
+    allowQuickCreate: boolean;
+    relatedCreateOperation?: FrontendResourceConfiguration_Operation;
+}
+export interface RelationshipWriteSurfaceDescriptor extends ResolvedRelationshipObjectFieldSemantics {
+    sourceKind: 'relationshipObject';
+    quickCreate?: RelationshipSurfaceQuickCreateDescriptor;
+}
+export interface RelationshipReadSurfaceDescriptor extends ResolvedRelationshipObjectFieldSemantics {
+    sourceKind: 'relationshipObject';
+    objectIdentity: ReturnType<typeof Resources_SharedUtils.resolveRelationshipObjectIdentityForResource>;
+}
+export interface RelationshipInlineEditSurfaceDescriptor {
+    sourceFieldName: string;
+    quickCreate?: RelationshipSurfaceQuickCreateDescriptor;
+}
+export interface RelationshipNestedReadSurfaceDescriptor {
+    relationship: ResourceRelationship;
+    childResourceType: ResourceType;
+    nestedReadConfig: NonNullable<ReturnType<typeof Resources_SharedUtils.resolveRelationshipNestedReadConfig>>;
+    foreignKeyField: string;
+    relationshipEdgeKey: string;
+    displayConfig?: RelationshipDisplayInParentView;
+    navigationConfig?: RelationshipDisplayInParentNavigation;
+    transition?: TransitionConfig;
+    contentSectionConfig: SectionConfig;
+    orderIndex: number;
+    inlineLimit?: number;
+    showViewAllLink: boolean;
+    isOneToOne: boolean;
+}
+export interface RelationshipParentReferenceDescriptor {
+    parentResourceType: string;
+    parentResourceId?: string;
+    parentDisplay: ParentDisplay;
+    showParentLink: boolean;
+}
+export interface RelationshipNavigationSurfaceDescriptor {
+    parentReference?: RelationshipParentReferenceDescriptor;
+}
+export interface RelationshipSurfaceRuntimeDescriptor {
+    writeSurface?: RelationshipWriteSurfaceDescriptor;
+    readSurface?: RelationshipReadSurfaceDescriptor;
+    inlineEditSurface?: RelationshipInlineEditSurfaceDescriptor;
+    navigationSurface?: RelationshipNavigationSurfaceDescriptor;
+}
+export interface AutomaticRelationshipDisplayShapingDescriptor {
+    hiddenFieldNames: string[];
+    inlineEditDisabledFieldNames: string[];
+}
+export interface ResolveRelationshipSurfaceRuntimeParams {
+    resourceType?: ResourceType;
+    fieldName?: string;
+    operationType?: string;
+    relatedResourceType?: ResourceType;
+    registry: FrontendResourcesRegistry;
+    inlineParentContext?: InlineParentContext;
+    navigationZone?: NavigationZone | string;
+    navigationInitiator?: NavigationInitiatorContext;
+    getZoneState?: (zone: NavigationZoneName) => NavigationZoneState | undefined;
+}
+export declare function resolveRelationshipQuickCreateCreateOperation(params: {
+    relatedResourceType: ResourceType;
+    registry: FrontendResourcesRegistry;
+}): FrontendResourceConfiguration_Operation | undefined;
+export declare function resolveRelationshipWriteSurface(params: {
+    resourceType: ResourceType;
+    fieldName: string;
+    operationType?: string;
+    registry: FrontendResourcesRegistry;
+}): RelationshipWriteSurfaceDescriptor | undefined;
+export declare function resolveRelationshipReadSurface(params: {
+    resourceType: ResourceType;
+    fieldName: string;
+    registry: FrontendResourcesRegistry;
+}): RelationshipReadSurfaceDescriptor | undefined;
+export declare function resolveRelationshipInlineEditSurface(params: {
+    resourceType: ResourceType;
+    fieldName: string;
+    operationType?: string;
+    relatedResourceType?: ResourceType;
+    registry: FrontendResourcesRegistry;
+}): RelationshipInlineEditSurfaceDescriptor | undefined;
+export declare function resolveRelationshipNestedReadSurface(params: {
+    parentResourceType: ResourceType;
+    relationship: ResourceRelationship;
+    parentData?: Record<string, unknown>;
+    registry: FrontendResourcesRegistry;
+    viewport?: ViewportBreakpoint;
+}): RelationshipNestedReadSurfaceDescriptor | undefined;
+export declare function resolveRelationshipNavigationSurface(params: {
+    inlineParentContext?: InlineParentContext;
+    navigationZone?: NavigationZone | string;
+    navigationInitiator?: NavigationInitiatorContext;
+    getZoneState?: (zone: NavigationZoneName) => NavigationZoneState | undefined;
+}): RelationshipNavigationSurfaceDescriptor | undefined;
+export declare function resolveAutomaticRelationshipDisplayShaping(params: {
+    resourceType: ResourceType;
+    schema?: z.ZodTypeAny;
+    parentData?: Record<string, unknown>;
+    registry: FrontendResourcesRegistry;
+}): AutomaticRelationshipDisplayShapingDescriptor;
+export declare function resolveRelationshipSurfaceRuntime(params: ResolveRelationshipSurfaceRuntimeParams): RelationshipSurfaceRuntimeDescriptor;
+//# sourceMappingURL=relationship-surface-runtime.frontend.utils.d.ts.map

package/dist/esm/core/resources/relationship-surface-runtime.frontend.utils.d.ts.map

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