@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/components/views/composite-view/composite-view.utils.js

@@ -0,0 +1,165 @@
+import { CompositeViewDefinitionSchema, CompositeView_HeightDisplayMode, CompositeView_NodeType } from '../../../core/config/composite-view.schemas.js';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import { FrontendView_ScopeMode } from '../../../core/config/views-frontend.schemas.js';
+/**
+ * Save the current state of a GridStack instance to a CompositeViewDefinition
+ * Transforms GridStack nodes (with 'id') back to CompositeViewNode format (with 'ref')
+ */
+export function saveCompositeView(grid) {
+    const rawData = grid.save(true); // includes nested children
+    const rawNodes = Array.isArray(rawData) ? rawData : [];
+    // Transform GridStack nodes back to our format
+    const children = rawNodes.map(transformNodeFromGridStack);
+    // Detect mode from cellHeight
+    const mode = grid.opts.cellHeight === 'auto'
+        ? CompositeView_HeightDisplayMode.AUTO_HEIGHT
+        : CompositeView_HeightDisplayMode.FIXED_HEIGHT;
+    return CompositeViewDefinitionSchema.parse({
+        scope: FrontendView_ScopeMode.APPLICATION,
+        ref: 'composite-view',
+        isAddressable: false,
+        options: {
+            column: grid.opts.column || 12,
+            margin: grid.opts.margin || 4,
+            float: !!grid.opts.float,
+            mode,
+            rtl: !!grid.opts.rtl,
+        },
+        children,
+    });
+}
+/**
+ * Transform GridStack node back to CompositeViewNode format
+ * Maps 'id' back to 'ref'
+ */
+function transformNodeFromGridStack(node) {
+    const { id, x, y, w, h, children, ...rest } = node;
+    const result = {
+        ref: id,
+        ...rest,
+    };
+    // Only include position/size if defined
+    if (x !== undefined)
+        result.x = x;
+    if (y !== undefined)
+        result.y = y;
+    if (w !== undefined)
+        result.w = w;
+    if (h !== undefined)
+        result.h = h;
+    // Transform nested children
+    if (children && children.length > 0) {
+        result.children = children.map(transformNodeFromGridStack);
+    }
+    return result;
+}
+/**
+ * Load a CompositeViewDefinition into a GridStack instance
+ * Transforms CompositeViewNodes (with 'ref') to GridStack format (with 'id')
+ */
+export function loadCompositeView(grid, doc, breakpoint) {
+    const parsed = CompositeViewDefinitionSchema.parse(doc);
+    // Clear existing grid
+    grid.removeAll(false);
+    // Transform and load new children
+    if (parsed.children && parsed.children.length > 0) {
+        const gridStackNodes = parsed.children.map(node => transformNodeToGridStack(node, breakpoint));
+        grid.load(gridStackNodes);
+    }
+}
+/**
+ * Transform CompositeViewNode to GridStack node format
+ * Maps 'ref' to 'id' and handles responsive positioning
+ * @internal Exported for use by CompositeView component
+ */
+export function transformNodeToGridStack(node, breakpoint) {
+    const { ref, x, y, w, h, children, ...rest } = node;
+    // Extract values for current breakpoint
+    const xValue = extractValueForBreakpoint(x, breakpoint, 0);
+    const yValue = extractValueForBreakpoint(y, breakpoint, 0);
+    const wValue = extractValueForBreakpoint(w, breakpoint, 4);
+    const hValue = extractValueForBreakpoint(h, breakpoint, undefined);
+    return {
+        id: ref,
+        x: xValue,
+        y: yValue,
+        w: wValue,
+        h: hValue,
+        ...rest,
+        children: children?.map(child => transformNodeToGridStack(child, breakpoint)),
+    };
+}
+/**
+ * Resolve the semantic runtime content for a composite node from the raw node
+ * shape used in authored dashboard configs.
+ */
+export function resolveCompositeViewNodeContent(node) {
+    const raw = node;
+    const type = raw['type'] ?? raw['nodeType'];
+    if (typeof type !== 'string' || !Object.values(CompositeView_NodeType).includes(type)) {
+        return undefined;
+    }
+    if (type === CompositeView_NodeType.ONBOARDING) {
+        const viewRef = raw['viewRef'] ?? raw['onboardingViewRef'];
+        return typeof viewRef === 'string'
+            ? { kind: CompositeView_NodeType.ONBOARDING, viewRef }
+            : undefined;
+    }
+    if (type === CompositeView_NodeType.CHART) {
+        const viewRef = raw['chartRef'] ?? raw['viewRef'];
+        return typeof viewRef === 'string'
+            ? { kind: CompositeView_NodeType.CHART, viewRef }
+            : undefined;
+    }
+    return undefined;
+}
+/**
+ * Extract value for current breakpoint from either a fixed value or breakpoint map
+ */
+function extractValueForBreakpoint(value, breakpoint, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    // If it's a plain value, return it
+    if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean') {
+        return value;
+    }
+    // If it's a breakpoint map, extract value for current breakpoint
+    if (typeof value === 'object' && breakpoint) {
+        const map = value;
+        // Try current breakpoint, then fallback to desktop, then default
+        return map[breakpoint] ?? map[ViewportBreakpoint.DESKTOP] ?? defaultValue;
+    }
+    return defaultValue;
+}
+/**
+ * Serialize a CompositeViewDefinition to JSON string
+ */
+export function serializeCompositeView(doc) {
+    return JSON.stringify(doc, null, 2);
+}
+/**
+ * Deserialize a JSON string to a CompositeViewDefinition
+ */
+export function deserializeCompositeView(json) {
+    const data = JSON.parse(json);
+    return CompositeViewDefinitionSchema.parse(data);
+}
+/**
+ * Create an empty CompositeViewDefinition with default options
+ */
+export function createEmptyCompositeView(mode = CompositeView_HeightDisplayMode.FIXED_HEIGHT) {
+    return CompositeViewDefinitionSchema.parse({
+        scope: FrontendView_ScopeMode.APPLICATION,
+        ref: 'composite-view',
+        isAddressable: false,
+        options: {
+            column: 12,
+            margin: 4,
+            float: false,
+            mode,
+            rtl: false,
+        },
+        children: [],
+    });
+}
+//# sourceMappingURL=composite-view.utils.js.map

package/dist/esm/components/views/composite-view/composite-view.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-view.utils.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/composite-view.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/views/composite-view/useCompositeResourceContext.d.ts

@@ -0,0 +1,34 @@
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas.js';
+export interface CompositeResourceOperationTarget {
+    resourceType?: string;
+    resourceId?: string;
+    relationshipFieldOverrides?: Record<string, string>;
+    additionalContext?: Record<string, unknown>;
+}
+export interface CompositeResourceOperationTarget_ByIdentifier extends CompositeResourceOperationTarget {
+    operationIdentifier: string;
+    operationLike?: never;
+    requireAddressable?: never;
+    allowBulk?: never;
+}
+export interface CompositeResourceOperationTarget_BySemantic extends CompositeResourceOperationTarget {
+    operationIdentifier?: never;
+    operationLike: CoreResourceOperation;
+    requireAddressable?: boolean;
+    allowBulk?: boolean;
+}
+export type CompositeResourceOperationTargetSelector = CompositeResourceOperationTarget_ByIdentifier | CompositeResourceOperationTarget_BySemantic;
+export type CompositeResourceOperationTargetResolved = CompositeResourceOperationTarget & CompositeResourceOperationTargetSelector;
+export interface CompositeResourceContextValue {
+    hostResourceType: string;
+    hostResourceId?: string;
+    hostResourceConfig: AnyFrontendResourceConfiguration;
+    contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];
+    parentResourcesRequirements: FrontendResourceOperationContext['parentResourcesRequirements'];
+    resolveOperation: (target: Pick<CompositeResourceOperationTargetResolved, 'resourceType'> & CompositeResourceOperationTargetSelector) => FrontendResourceConfiguration_Operation;
+    buildOperationContext: (target: CompositeResourceOperationTargetResolved) => FrontendResourceOperationContext;
+}
+export declare function useOptionalCompositeResourceContext(): CompositeResourceContextValue | null;
+export declare function useCompositeResourceContext(): CompositeResourceContextValue;
+//# sourceMappingURL=useCompositeResourceContext.d.ts.map

package/dist/esm/components/views/composite-view/useCompositeResourceContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompositeResourceContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceContext.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACvC,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAGvE,MAAM,WAAW,gCAAgC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,6CAA8C,SAAQ,gCAAgC;IACrG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,2CAA4C,SAAQ,gCAAgC;IACnG,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,aAAa,EAAE,qBAAqB,CAAC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,wCAAwC,GAChD,6CAA6C,GAC7C,2CAA2C,CAAC;AAEhD,MAAM,MAAM,wCAAwC,GAClD,gCAAgC,GAAG,wCAAwC,CAAC;AAE9E,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,gCAAgC,CAAC;IACrD,0BAA0B,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC3F,2BAA2B,EAAE,gCAAgC,CAAC,6BAA6B,CAAC,CAAC;IAC7F,gBAAgB,EAAE,CAChB,MAAM,EAAE,IAAI,CAAC,wCAAwC,EAAE,cAAc,CAAC,GAAG,wCAAwC,KAC9G,uCAAuC,CAAC;IAC7C,qBAAqB,EAAE,CACrB,MAAM,EAAE,wCAAwC,KAC7C,gCAAgC,CAAC;CACvC;AA4CD,wBAAgB,mCAAmC,IAAI,6BAA6B,GAAG,IAAI,CA0M1F;AAED,wBAAgB,2BAA2B,IAAI,6BAA6B,CAU3E"}

package/dist/esm/components/views/composite-view/useCompositeResourceContext.js

@@ -0,0 +1,174 @@
+import { useCallback, useMemo } from 'react';
+import { CoreResourceOperation, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { useOptionalCompositeViewContext } from './CompositeViewContext.js';
+import { frontendResourceUtils, FrontendResourceUtils, } from '../../../core/resources/frontend-resource.utils.js';
+import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+function buildCompositeResourceConfigurationError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        message,
+        component: 'useCompositeResourceContext',
+        ...context,
+    });
+}
+function hasOperationIdentifier(target) {
+    return typeof target.operationIdentifier === 'string';
+}
+function resolveOperationOrThrow(resourceConfig, resourceType, operationIdentifier) {
+    const operation = resourceConfig?.operations?.find((candidate) => String(candidate.operationIdentifier) === operationIdentifier);
+    if (!operation) {
+        throw buildCompositeResourceConfigurationError(`Composite resource runtime cannot resolve operation "${operationIdentifier}" on resource "${resourceType}".`, {
+            resourceType,
+            operationIdentifier,
+        });
+    }
+    return operation;
+}
+export function useOptionalCompositeResourceContext() {
+    const compositeContext = useOptionalCompositeViewContext();
+    const { registry } = useResourceRegistry();
+    const hostResourceType = compositeContext?.hostResourceType;
+    const contextResourceIdentifiers = compositeContext?.contextResourceIdentifiers ?? {};
+    const hostResourceConfig = useMemo(() => {
+        if (!hostResourceType) {
+            return undefined;
+        }
+        const resourceConfig = registry.resourceConfigurations[hostResourceType];
+        if (!resourceConfig) {
+            throw buildCompositeResourceConfigurationError(`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 pickPreferredOperationForCoreSemantic(hostResourceConfig.operations ?? [], CoreResourceOperation.READ) ?? hostResourceConfig.operations?.[0];
+    }, [hostResourceConfig]);
+    const resolveOperation = useCallback((target) => {
+        const targetResourceType = target.resourceType ?? hostResourceType;
+        if (!targetResourceType) {
+            throw buildCompositeResourceConfigurationError('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, String(target.operationIdentifier));
+        }
+        const semanticOperation = pickPreferredOperationForCoreSemantic(resourceConfig?.operations ?? [], target.operationLike, {
+            requireAddressable: target.requireAddressable,
+            allowBulk: target.allowBulk,
+        });
+        if (!semanticOperation) {
+            throw buildCompositeResourceConfigurationError(`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;
+    }, [hostResourceConfig, hostResourceType, registry.resourceConfigurations]);
+    const buildOperationContext = useCallback((target) => {
+        if (!hostResourceType) {
+            throw buildCompositeResourceConfigurationError('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,
+                }
+                : {
+                    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 buildCompositeResourceConfigurationError(`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),
+            resourceId: target.resourceId,
+            relationshipFieldOverrides: target.relationshipFieldOverrides,
+            additionalContext: target.additionalContext,
+        }, registry);
+    }, [
+        contextResourceIdentifiers,
+        hostOperationFallback,
+        hostResourceType,
+        parentResourcesRequirements,
+        registry,
+        resolveOperation,
+    ]);
+    return useMemo(() => {
+        if (!hostResourceType || !hostResourceConfig) {
+            return null;
+        }
+        return {
+            hostResourceType,
+            hostResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[hostResourceType]),
+            hostResourceConfig,
+            contextResourceIdentifiers,
+            parentResourcesRequirements,
+            resolveOperation,
+            buildOperationContext,
+        };
+    }, [
+        buildOperationContext,
+        contextResourceIdentifiers,
+        hostResourceConfig,
+        hostResourceType,
+        parentResourcesRequirements,
+        resolveOperation,
+    ]);
+}
+export function useCompositeResourceContext() {
+    const context = useOptionalCompositeResourceContext();
+    if (!context) {
+        throw buildCompositeResourceConfigurationError('useCompositeResourceContext() must be used within a resource-scoped CompositeView.');
+    }
+    return context;
+}
+//# sourceMappingURL=useCompositeResourceContext.js.map

package/dist/esm/components/views/composite-view/useCompositeResourceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompositeResourceContext.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceContext.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.d.ts

@@ -0,0 +1,11 @@
+import { type CompositeResourceOperationTarget, type CompositeResourceOperationTargetSelector } from './useCompositeResourceContext.js';
+import type { FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas.js';
+export type CompositeExplicitResourceOperationTarget = CompositeResourceOperationTarget & CompositeResourceOperationTargetSelector & {
+    resourceType: string;
+    contextResourceIdentifiers?: Record<string, string>;
+};
+export interface CompositeResourceOperationContextBuilderValue {
+    buildResourceOperationContext: (target: CompositeExplicitResourceOperationTarget) => FrontendResourceOperationContext;
+}
+export declare function useCompositeResourceOperationContextBuilder(): CompositeResourceOperationContextBuilderValue;
+//# sourceMappingURL=useCompositeResourceOperationContextBuilder.d.ts.map

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompositeResourceOperationContextBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,wCAAwC,EAC9C,MAAM,+BAA+B,CAAC;AAQvC,OAAO,KAAK,EAGV,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAGvE,MAAM,MAAM,wCAAwC,GAAG,gCAAgC,GACnF,wCAAwC,GACxC;IACA,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD,CAAC;AAEJ,MAAM,WAAW,6CAA6C;IAC5D,6BAA6B,EAAE,CAC7B,MAAM,EAAE,wCAAwC,KAC7C,gCAAgC,CAAC;CACvC;AA4ED,wBAAgB,2CAA2C,IAAI,6CAA6C,CAiD3G"}

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.js

@@ -0,0 +1,78 @@
+import { useCallback } from 'react';
+import { ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { useOptionalCompositeViewContext } from './CompositeViewContext.js';
+import { frontendResourceUtils, FrontendResourceUtils, } from '../../../core/resources/frontend-resource.utils.js';
+import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { ScopeUtilsService } from '../../../core/scope/scope.utils.frontend.service.js';
+import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+function buildCompositeResourceOperationBuilderError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        message,
+        component: 'useCompositeResourceOperationContextBuilder',
+        ...context,
+    });
+}
+function hasOperationIdentifier(target) {
+    return 'operationIdentifier' in target;
+}
+function resolveOperationForTarget(resourceConfig, resourceType, target) {
+    if (!resourceConfig) {
+        throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve resource "${resourceType}" from the registry.`, { resourceType });
+    }
+    if (hasOperationIdentifier(target)) {
+        const operation = resourceConfig.operations?.find((candidate) => String(candidate.operationIdentifier) === target.operationIdentifier);
+        if (!operation) {
+            throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve operation "${target.operationIdentifier}" on resource "${resourceType}".`, {
+                resourceType,
+                operationIdentifier: target.operationIdentifier,
+            });
+        }
+        return operation;
+    }
+    const semanticOperation = pickPreferredOperationForCoreSemantic(resourceConfig.operations ?? [], target.operationLike, {
+        requireAddressable: target.requireAddressable,
+        allowBulk: target.allowBulk,
+    });
+    if (!semanticOperation) {
+        throw buildCompositeResourceOperationBuilderError(`Composite resource-operation builder cannot resolve a preferred ${String(target.operationLike)}-like operation on resource "${resourceType}".`, {
+            resourceType,
+            operationLike: target.operationLike,
+            requireAddressable: target.requireAddressable,
+            allowBulk: target.allowBulk,
+        });
+    }
+    return semanticOperation;
+}
+export function useCompositeResourceOperationContextBuilder() {
+    const { registry } = useResourceRegistry();
+    const compositeContext = useOptionalCompositeViewContext();
+    const appScope = useAppScopeSafe();
+    const buildResourceOperationContext = useCallback((target) => {
+        const resourceConfig = registry.resourceConfigurations[target.resourceType];
+        const operation = resolveOperationForTarget(resourceConfig, target.resourceType, target);
+        const ambientContextResourceIdentifiers = ScopeUtilsService.mergeContextResourceIdentifiers(undefined, appScope?.buildContextResourceIdentifiers() ?? {}, target.contextResourceIdentifiers ?? compositeContext?.contextResourceIdentifiers) ?? {};
+        const contextResourceIdentifiers = target.resourceId
+            ? {
+                ...ambientContextResourceIdentifiers,
+                [target.resourceType]: target.resourceId,
+            }
+            : ambientContextResourceIdentifiers;
+        const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(target.resourceType, contextResourceIdentifiers, registry, target.relationshipFieldOverrides);
+        return frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType: target.resourceType,
+            operation,
+            contextResourceIdentifiers,
+            additionalContext: target.additionalContext,
+            parentResourcesRequirements,
+        });
+    }, [
+        appScope,
+        compositeContext?.contextResourceIdentifiers,
+        registry,
+    ]);
+    return {
+        buildResourceOperationContext,
+    };
+}
+//# sourceMappingURL=useCompositeResourceOperationContextBuilder.js.map

package/dist/esm/components/views/composite-view/useCompositeResourceOperationContextBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompositeResourceOperationContextBuilder.js","sourceRoot":"","sources":["../../../../../src/components/views/composite-view/useCompositeResourceOperationContextBuilder.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/views/execution-view/ExecutionView.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { ExecutionViewDefinition } from '../../../core/config/execution-view.schemas.js';
+import { NavigationZone } from '../../../core/navigation/navigation.schemas.js';
+export interface ExecutionViewProps {
+    /** View reference — resolved from UIContext internally. Mutually exclusive with `viewDefinition`. */
+    viewRef?: string;
+    /** Pre-resolved view definition. When provided, viewRef is ignored. */
+    viewDefinition?: ExecutionViewDefinition;
+    /**
+     * Explicit navigation-time context bindings.
+     *
+     * The execution host follows the same boundary as other custom view families:
+     * ambient primary scope stays live in AppScope, while explicit identifiers are
+     * preserved on the navigation payload and merged last.
+     */
+    contextResourceIdentifiers?: Record<string, string>;
+    navigationZone?: NavigationZone;
+}
+/**
+ * Framework-owned execution host.
+ *
+ * This component intentionally mirrors the scope-resolution model already used by
+ * `FullCustomView`, but adds a minimal execution runtime provider so later slices
+ * can grow execution-specific hooks without changing the routed host seam.
+ */
+export declare const ExecutionView: React.FC<ExecutionViewProps>;
+export default ExecutionView;
+//# sourceMappingURL=ExecutionView.d.ts.map

package/dist/esm/components/views/execution-view/ExecutionView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionView.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/execution-view/ExecutionView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAK5D,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,wDAAwD,CAAC;AAMhE,OAAO,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAOxF,MAAM,WAAW,kBAAkB;IACjC,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,uBAAuB,CAAC;IAEzC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAUD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuJtD,CAAC;AAEF,eAAe,aAAa,CAAC"}