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

package/dist/esm/components/resources/embeds/ResourceEmbeds.d.ts

@@ -0,0 +1,117 @@
+import React from 'react';
+import { type ChartInputValues } from '@wildo-ai/saas-models';
+import type { FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas';
+import type { OnboardingViewProps } from '../../../components/views/onboarding-view/OnboardingView';
+import { type EmbeddedResourceOperationTarget, type EmbeddedResourceOperationTargetSelector } from './useEmbeddedResourceContext';
+interface EmbeddedSurfaceProps {
+    viewRef: string;
+    className?: string;
+}
+export interface EmbedChartProps extends EmbeddedSurfaceProps {
+    resourceType: string;
+    contextResourceIdentifiers?: Record<string, string>;
+    inputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+    /**
+     * Explicit chart canvas height (`ChartView` default is 400). Needed because
+     * `ChartView` sizes its ECharts canvas by this prop, not by its wrapper — a
+     * height utility on the embed's `className` cannot shrink the chart. Pass a
+     * number (px) or a CSS length for compact dashboard tiles.
+     */
+    height?: string | number;
+}
+export declare function EmbedChart({ resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, className, height, }: EmbedChartProps): React.JSX.Element;
+export interface EmbedOnboardingProps {
+    document: OnboardingViewProps['document'];
+    viewRef?: string;
+    guidanceFlowRef?: string;
+    className?: string;
+}
+export declare function EmbedOnboarding({ document, viewRef, guidanceFlowRef, className, }: EmbedOnboardingProps): React.JSX.Element;
+export declare function EmbedComposite({ viewRef, className, }: EmbeddedSurfaceProps): React.JSX.Element;
+export interface EmbedExecutionProps extends EmbeddedSurfaceProps {
+    contextResourceIdentifiers?: Record<string, string>;
+}
+export declare function EmbedExecution({ viewRef, contextResourceIdentifiers, className, }: EmbedExecutionProps): React.JSX.Element;
+export interface EmbedResourceOperationProps {
+    resourceContext: FrontendResourceOperationContext;
+    className?: string;
+}
+export type EmbedHostResourceOperationProps = EmbeddedResourceOperationTarget & EmbeddedResourceOperationTargetSelector & {
+    className?: string;
+};
+/** @wildo_source:part:start saas.frontend.related-resource-embeds facet:layer:frontend facet:family:component */
+export type EmbedRelatedResourceOperationProps = EmbeddedResourceOperationTargetSelector & {
+    resourceType: string;
+    resourceId?: string;
+    relationshipFieldOverrides?: Record<string, string>;
+    additionalContext?: Record<string, unknown>;
+    className?: string;
+};
+/** @wildo_source:part:end saas.frontend.related-resource-embeds */
+export declare function EmbedResourceOperation({ resourceContext, className, }: EmbedResourceOperationProps): React.JSX.Element;
+export declare function EmbedHostResourceOperation({ className, ...target }: EmbedHostResourceOperationProps): React.JSX.Element;
+export type EmbedRelatedResourceOperationTarget = Omit<EmbedRelatedResourceOperationProps, 'className'>;
+export declare function EmbedRelatedResourceOperation({ className, ...target }: EmbedRelatedResourceOperationProps): React.JSX.Element;
+/** @wildo_source:part:start saas.frontend.related-resource-embeds facet:layer:frontend facet:family:component */
+/**
+ * Which EDGE to embed, when the host has more than one relationship to the same
+ * target resource — two lists of todos, an assignee and a reviewer both pointing
+ * at users. Keyed by the HOST resource type, valued with the foreign-key field
+ * that identifies the edge.
+ *
+ * `resourceType` alone is ambiguous in that case, and the ambiguity is silent:
+ * the resolver picks an edge and renders a plausible-looking wrong collection.
+ */
+export type EmbedRelatedResourceEdgeSelector = Record<string, string>;
+export interface EmbedRelatedResourceListProps {
+    /** Target child resource type. */
+    resourceType: string;
+    /** Disambiguates WHICH edge when the host has several to this target. */
+    viaForeignKey?: EmbedRelatedResourceEdgeSelector;
+    className?: string;
+}
+/**
+ * Embed a related resource's LIST — the common case, spelled directly.
+ *
+ * A pure delegation to {@link EmbedRelatedResourceOperation}: no resolution,
+ * addressability or context logic lives here. The operation embed stays the one
+ * place that code exists, so a shortcut can never drift from it.
+ */
+export declare function EmbedRelatedResourceList({ resourceType, viaForeignKey, className, }: EmbedRelatedResourceListProps): React.JSX.Element;
+export interface EmbedRelatedResourceSearchProps extends EmbedRelatedResourceListProps {
+}
+/**
+ * Embed a related resource's SEARCH surface. Same delegation contract as
+ * {@link EmbedRelatedResourceList} — only the semantic operation differs.
+ */
+export declare function EmbedRelatedResourceSearch({ resourceType, viaForeignKey, className, }: EmbedRelatedResourceSearchProps): React.JSX.Element;
+/** @wildo_source:part:end saas.frontend.related-resource-embeds */
+export interface EmbedHostExecutionProps extends EmbeddedResourceOperationTarget {
+    viewRef: string;
+    className?: string;
+}
+export interface EmbedRelatedExecutionProps extends EmbeddedResourceOperationTarget {
+    resourceType: string;
+    viewRef: string;
+    className?: string;
+}
+export interface EmbedHostChartProps extends EmbeddedResourceOperationTarget {
+    viewRef: string;
+    inputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+    className?: string;
+}
+export interface EmbedRelatedChartProps extends EmbeddedResourceOperationTarget {
+    resourceType: string;
+    viewRef: string;
+    inputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+    className?: string;
+}
+export declare function EmbedHostChart({ viewRef, inputs, urlParamValues, className, ...target }: EmbedHostChartProps): React.JSX.Element;
+export declare function EmbedRelatedChart({ resourceType, viewRef, inputs, urlParamValues, className, ...target }: EmbedRelatedChartProps): React.JSX.Element;
+export declare function EmbedHostExecution({ viewRef, className, ...target }: EmbedHostExecutionProps): React.JSX.Element;
+export declare function EmbedRelatedExecution({ resourceType, viewRef, className, ...target }: EmbedRelatedExecutionProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=ResourceEmbeds.d.ts.map

package/dist/esm/components/resources/embeds/ResourceEmbeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceEmbeds.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,202 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { CoreResourceOperation, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+// ChartView MUST come from the `.lazy` wrapper — a static import of the real
+// module merges the whole ECharts payload into the entry chunk (Rollup merges
+// a module that is both statically and dynamically imported; no warning).
+import { ChartView } from '../../../components/views/chart-view/ChartView.lazy.js';
+import { ExecutionView } from '../../../components/views/execution-view/ExecutionView.js';
+import { OnboardingView } from '../../../components/views/onboarding-view/OnboardingView.js';
+import { ResourceOperationSurface } from '../../../components/resources/ResourceOperationSurface.js';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { buildResourceInsertedExecutionIdentity } from '../../../core/config/execution-view.schemas.js';
+import { buildResolvedInsertedChartDescriptor, buildResourceInsertedChartIdentity, } from '../../../core/config/chart-view.frontend.schemas.js';
+import { FeatureRouteGuard } from '../../../core/features/FeatureRouteGuard.js';
+import { SectionHostHeadingContext } from '../../../components/resources/skeleton/SectionHostHeadingContext.js';
+import { EmbeddedResourceDescentBoundary } from './EmbeddedResourceDescent.js';
+import { useRegisterComposedChild } from './ComposedChildrenRegistry.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { CompositeView } from '../../../components/views/composite-view/CompositeView.js';
+import { useEmbeddedResourceHostContext, useOptionalEmbeddedResourceHostContext, } from '../../../components/resources/embeds/EmbeddedResourceHostContext.js';
+import { useEmbeddedResourceContext, } from './useEmbeddedResourceContext.js';
+import { useHostRecordDerivedParentContext, mergeDerivedParentIdentifiers, } from '../../../components/views/composite-view/useHostRecordDerivedParentContext.js';
+function EmbeddedChartRenderer(params) {
+    const { registry } = useResourceRegistry();
+    const chartView = registry.resourceConfigurations[params.resourceType]
+        ?.frontendConfiguration
+        ?.chartViews
+        ?.find((candidate) => candidate.ref === params.viewRef);
+    if (!chartView) {
+        throw buildResourceEmbedConfigurationError(`Composite chart runtime cannot resolve chart view "${params.viewRef}" on resource "${params.resourceType}".`, {
+            resourceType: params.resourceType,
+            viewRef: params.viewRef,
+        });
+    }
+    const identity = buildResourceInsertedChartIdentity(params.resourceType, { ref: params.viewRef });
+    return (_jsx("div", { className: params.className, children: _jsx(FeatureRouteGuard, { requiredFeatures: chartView.chartDefinition.requiredFeatures, children: _jsx(ChartView, { viewRef: identity.insertedViewRef, viewDefinition: chartView, runtimeDescriptor: buildResolvedInsertedChartDescriptor({
+                    identity,
+                    chartView,
+                    contextResourceIdentifiers: params.contextResourceIdentifiers ?? {},
+                }), contextResourceIdentifiers: params.contextResourceIdentifiers, inputs: params.inputs, urlParamValues: params.urlParamValues, ...(params.height != null ? { height: params.height } : {}), 
+                // Embedded composite tile → a data-fetch failure degrades locally in the
+                // card, no page-level toast (per-widget error isolation).
+                localErrorOnly: true }) }) }));
+}
+export function EmbedChart({ resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, className, height, }) {
+    const compositeContext = useEmbeddedResourceHostContext();
+    return (_jsx(EmbeddedChartRenderer, { resourceType: resourceType, viewRef: viewRef, contextResourceIdentifiers: {
+            ...(compositeContext.contextResourceIdentifiers ?? {}),
+            ...(contextResourceIdentifiers ?? {}),
+        }, inputs: inputs, urlParamValues: urlParamValues, className: className, height: height }));
+}
+export function EmbedOnboarding({ document, viewRef, guidanceFlowRef, className, }) {
+    return (_jsx("div", { className: className, children: _jsx(OnboardingView, { document: document, viewRef: viewRef, guidanceFlowRef: guidanceFlowRef }) }));
+}
+export function EmbedComposite({ viewRef, className, }) {
+    // The host record this composite hangs off — used to key the descent, so the
+    // SAME composite over a different record still nests while a genuine revisit
+    // is refused. Optional context: a composite embedded outside a resource host
+    // keys on the view alone, which still catches direct self-embedding.
+    const host = useOptionalEmbeddedResourceHostContext();
+    const hostRow = host?.hostResourceType
+        ? host.contextResourceIdentifiers?.[host.hostResourceType] ?? 'no-row'
+        : 'no-host';
+    return (_jsx("div", { className: className, children: _jsx(EmbeddedResourceDescentBoundary, { descentKey: `composite:${viewRef}::${hostRow}`, children: _jsx(CompositeView, { viewRef: viewRef }) }) }));
+}
+function renderEmbeddedExecution(viewRef, navigationZone, contextResourceIdentifiers, className) {
+    return (_jsx("div", { className: className, children: _jsx(EmbeddedResourceDescentBoundary, { descentKey: `execution:${viewRef}::${Object.values(contextResourceIdentifiers ?? {}).join(',') || 'no-row'}`, children: _jsx(ExecutionView, { viewRef: viewRef, navigationZone: navigationZone, contextResourceIdentifiers: contextResourceIdentifiers }) }) }));
+}
+export function EmbedExecution({ viewRef, contextResourceIdentifiers, className, }) {
+    const compositeContext = useEmbeddedResourceHostContext();
+    return renderEmbeddedExecution(viewRef, compositeContext.navigationZone, {
+        ...(compositeContext.contextResourceIdentifiers ?? {}),
+        ...(contextResourceIdentifiers ?? {}),
+    }, className);
+}
+function buildResourceEmbedConfigurationError(message, context) {
+    return FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+        message,
+        component: 'ResourceEmbeds',
+        ...context,
+    });
+}
+function renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className) {
+    return (_jsx("div", { className: className, children: _jsx(EmbeddedResourceDescentBoundary, { descentKey: `embed:${resourceContext.resourceType}::${FrontendResourceUtils.getInstance().getResourceId(resourceContext.contextResourceIdentifiers?.[resourceContext.resourceType]) || 'no-row'}`, children: _jsx(SectionHostHeadingContext.Provider, { value: true, children: _jsx(ResourceOperationSurface, { resourceContext: resourceContext, navigationZone: navigationZone, navigationInitiator: navigationInitiator }) }) }) }));
+}
+/** @wildo_source:part:end saas.frontend.related-resource-embeds */
+export function EmbedResourceOperation({ resourceContext, className, }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
+}
+export function EmbedHostResourceOperation({ className, ...target }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const resourceContext = useMemo(() => compositeResourceContext.buildOperationContext(target), 
+    // Keyed by the target's *value*, not the fresh-every-render rest-object identity.
+    // buildOperationContext clones resource configs to assemble the context; calling it
+    // inline each render churns those clones (the 603-config heap growth) and hands a new
+    // `resourceContext` identity to the operation surface, re-firing its context-keyed
+    // effects — the composite re-render loop. Recomputes only on a real target / context change.
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`
+    [compositeResourceContext, JSON.stringify(target)]);
+    return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
+}
+export function EmbedRelatedResourceOperation({ className, ...target }) {
+    // D1 — claim this child for the template that placed it, so the host's
+    // automatic composition skips it instead of rendering a second copy below.
+    // A no-op outside a registry host, so composite views are unaffected.
+    useRegisterComposedChild(target.resourceType);
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const resourceContext = useMemo(() => {
+        if (!target.resourceType) {
+            throw buildResourceEmbedConfigurationError('EmbedRelatedResourceOperation() requires a target resourceType.', { target });
+        }
+        return compositeResourceContext.buildOperationContext(target);
+    }, 
+    // Keyed by target value, not the fresh rest-object identity — see EmbedHostResourceOperation.
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`
+    [compositeResourceContext, JSON.stringify(target)]);
+    return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
+}
+/**
+ * Embed a related resource's LIST — the common case, spelled directly.
+ *
+ * A pure delegation to {@link EmbedRelatedResourceOperation}: no resolution,
+ * addressability or context logic lives here. The operation embed stays the one
+ * place that code exists, so a shortcut can never drift from it.
+ */
+export function EmbedRelatedResourceList({ resourceType, viaForeignKey, className, }) {
+    return (_jsx(EmbedRelatedResourceOperation, { resourceType: resourceType, operationLike: CoreResourceOperation.LIST, relationshipFieldOverrides: viaForeignKey, className: className }));
+}
+/**
+ * Embed a related resource's SEARCH surface. Same delegation contract as
+ * {@link EmbedRelatedResourceList} — only the semantic operation differs.
+ */
+export function EmbedRelatedResourceSearch({ resourceType, viaForeignKey, className, }) {
+    return (_jsx(EmbedRelatedResourceOperation, { resourceType: resourceType, operationLike: CoreResourceOperation.SEARCH, relationshipFieldOverrides: viaForeignKey, className: className }));
+}
+export function EmbedHostChart({ viewRef, inputs, urlParamValues, className, ...target }) {
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const resourceContext = compositeResourceContext.buildOperationContext({
+        ...target,
+        operationLike: CoreResourceOperation.READ,
+    });
+    // D2: a host-owned chart may require the host's PARENT scope (e.g. a
+    // `todo-task-status` chart mandating `todos` when the host is a `task`). Derive
+    // the parent id off the host record and merge it UNDER the URL context so the
+    // chart's `parentResourcesRequirements` resolve.
+    const derivedParents = useHostRecordDerivedParentContext(compositeResourceContext);
+    return (_jsx(EmbeddedChartRenderer, { resourceType: compositeResourceContext.hostResourceType, viewRef: viewRef, contextResourceIdentifiers: mergeDerivedParentIdentifiers(FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers), derivedParents), inputs: inputs, urlParamValues: urlParamValues, className: className }));
+}
+export function EmbedRelatedChart({ resourceType, viewRef, inputs, urlParamValues, className, ...target }) {
+    if (!resourceType) {
+        throw buildResourceEmbedConfigurationError('EmbedRelatedChart() requires a target resourceType.', { target });
+    }
+    const compositeResourceContext = useEmbeddedResourceContext();
+    // A RELATED chart aggregates a COLLECTION of `resourceType` scoped by the host
+    // record (e.g. the tasks of the current todo) — there is no single addressable
+    // related-record id, so it must resolve a collection operation (LIST), NOT READ.
+    // Resolving READ here required an addressable related id that never exists in a
+    // host→related context and threw a composite configuration error (caught by
+    // SurfaceErrorBoundary, degrading the surface). The host context (the parent
+    // record's id) is still threaded into the related context via
+    // `deriveChildResourceContext`, so the chart stays scoped to the host record.
+    // (`EmbedHostChart` keeps READ: the host IS a single addressable record.)
+    const resourceContext = compositeResourceContext.buildOperationContext({
+        ...target,
+        resourceType,
+        operationLike: CoreResourceOperation.LIST,
+    });
+    return (_jsx(EmbeddedChartRenderer, { resourceType: resourceType, viewRef: viewRef, contextResourceIdentifiers: FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers), inputs: inputs, urlParamValues: urlParamValues, className: className }));
+}
+export function EmbedHostExecution({ viewRef, className, ...target }) {
+    const { navigationZone } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const resourceContext = compositeResourceContext.buildOperationContext({
+        ...target,
+        operationLike: CoreResourceOperation.READ,
+    });
+    // D2: a host-owned execution may anchor on the host's PARENT (e.g. a
+    // `task-workspace` execution binding `todoId` when the host is a `task`). Derive
+    // the parent id off the host record so the anchor resolves instead of "No anchor
+    // resolved". Merged UNDER the URL context (URL ids win).
+    const derivedParents = useHostRecordDerivedParentContext(compositeResourceContext);
+    const insertedIdentity = buildResourceInsertedExecutionIdentity(compositeResourceContext.hostResourceType, { ref: viewRef });
+    return renderEmbeddedExecution(insertedIdentity.insertedViewRef, navigationZone, mergeDerivedParentIdentifiers(FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers), derivedParents), className);
+}
+export function EmbedRelatedExecution({ resourceType, viewRef, className, ...target }) {
+    const { navigationZone } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    if (!resourceType) {
+        throw buildResourceEmbedConfigurationError('EmbedRelatedExecution() requires a target resourceType.', { target: { resourceType, viewRef, ...target } });
+    }
+    const resourceContext = compositeResourceContext.buildOperationContext({
+        ...target,
+        resourceType,
+        operationLike: CoreResourceOperation.READ,
+    });
+    const insertedIdentity = buildResourceInsertedExecutionIdentity(resourceType, { ref: viewRef });
+    return renderEmbeddedExecution(insertedIdentity.insertedViewRef, navigationZone, FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers), className);
+}
+//# sourceMappingURL=ResourceEmbeds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceEmbeds.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,uBAAuB,CAAC;AAE/B,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,gEAAgE,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,mEAAmE,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,qEAAqE,CAAC;AAErG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,sCAAsC,EAAE,MAAM,wDAAwD,CAAC;AAChH,OAAO,EACL,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,mEAAmE,CAAC;AAClG,OAAO,EACL,8BAA8B,EAC9B,sCAAsC,GACvC,MAAM,6EAA6E,CAAC;AACrF,OAAO,EACL,0BAA0B,GAG3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,uFAAuF,CAAC;AAqB/F,SAAS,qBAAqB,CAAC,MAQ9B;IACC,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC;QACpE,EAAE,qBAAqB;QACvB,EAAE,UAAU;QACZ,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,oCAAoC,CACxC,sDAAsD,MAAM,CAAC,OAAO,kBAAkB,MAAM,CAAC,YAAY,IAAI,EAC7G;YACE,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,kCAAkC,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAElG,OAAO,CACL,cAAK,SAAS,EAAE,MAAM,CAAC,SAAS,YAC9B,KAAC,iBAAiB,IAAC,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC,gBAAgB,YAC7E,KAAC,SAAS,IACR,OAAO,EAAE,QAAQ,CAAC,eAAe,EACjC,cAAc,EAAE,SAAS,EACzB,iBAAiB,EAAE,oCAAoC,CAAC;oBACtD,QAAQ;oBACR,SAAS;oBACT,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;iBACpE,CAAC,EACF,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,EAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,cAAc,EAAE,MAAM,CAAC,cAAc,KACjC,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,yEAAyE;gBACzE,0DAA0D;gBAC1D,cAAc,SACd,GACgB,GAChB,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EACzB,YAAY,EACZ,OAAO,EACP,0BAA0B,EAC1B,MAAM,EACN,cAAc,EACd,SAAS,EACT,MAAM,GACU;IAChB,MAAM,gBAAgB,GAAG,8BAA8B,EAAE,CAAC;IAE1D,OAAO,CACL,KAAC,qBAAqB,IACpB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,0BAA0B,EAAE;YAC1B,GAAG,CAAC,gBAAgB,CAAC,0BAA0B,IAAI,EAAE,CAAC;YACtD,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC;SACtC,EACD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACd,CACH,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,OAAO,EACP,eAAe,EACf,SAAS,GACY;IACrB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YACvB,KAAC,cAAc,IACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,GAChC,GACE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,OAAO,EACP,SAAS,GACY;IACrB,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,IAAI,GAAG,sCAAsC,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,EAAE,gBAAgB;QACpC,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,QAAQ;QACtE,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YASvB,KAAC,+BAA+B,IAAC,UAAU,EAAE,aAAa,OAAO,KAAK,OAAO,EAAE,YAC7E,KAAC,aAAa,IAAC,OAAO,EAAE,OAAO,GAAI,GACH,GAC9B,CACP,CAAC;AACJ,CAAC;AAMD,SAAS,uBAAuB,CAC9B,OAAe,EACf,cAAmF,EACnF,0BAAmD,EACnD,SAAkB;IAElB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YAYvB,KAAC,+BAA+B,IAC9B,UAAU,EAAE,aAAa,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,YAE5G,KAAC,aAAa,IACZ,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,cAAc,EAC9B,0BAA0B,EAAE,0BAA0B,GACtD,GAC8B,GAC9B,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,OAAO,EACP,0BAA0B,EAC1B,SAAS,GACW;IACpB,MAAM,gBAAgB,GAAG,8BAA8B,EAAE,CAAC;IAE1D,OAAO,uBAAuB,CAC5B,OAAO,EACP,gBAAgB,CAAC,cAAc,EAC/B;QACE,GAAG,CAAC,gBAAgB,CAAC,0BAA0B,IAAI,EAAE,CAAC;QACtD,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC;KACtC,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAS,oCAAoC,CAC3C,OAAe,EACf,OAAiC;IAEjC,OAAO,qBAAqB,CAAC,uBAAuB,CAClD,2BAA2B,CAAC,aAAa,EACzC;QACE,OAAO;QACP,SAAS,EAAE,gBAAgB;QAC3B,GAAG,OAAO;KACX,CACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,eAAiD,EACjD,cAAmF,EACnF,mBAA6F,EAC7F,SAAkB;IAElB,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,YAyBvB,KAAC,+BAA+B,IAC9B,UAAU,EAAE,SAAS,eAAe,CAAC,YAAY,KAAK,qBAAqB,CAAC,WAAW,EAAE,CAAC,aAAa,CACrG,eAAe,CAAC,0BAA0B,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,CAC3E,IAAI,QAAQ,EAAE,YAEf,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAC7C,KAAC,wBAAwB,IACvB,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,mBAAmB,GACxC,GACiC,GACL,GAC9B,CACP,CAAC;AACJ,CAAC;AAsBD,mEAAmE;AAEnE,MAAM,UAAU,sBAAsB,CAAC,EACrC,eAAe,EACf,SAAS,GACmB;IAC5B,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,GAAG,8BAA8B,EAAE,CAAC;IAEjF,OAAO,+BAA+B,CACpC,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,EACzC,SAAS,EACT,GAAG,MAAM,EACuB;IAChC,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,GAAG,8BAA8B,EAAE,CAAC;IACjF,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAE9D,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,MAAM,CAAC;IAC5D,kFAAkF;IAClF,oFAAoF;IACpF,sFAAsF;IACtF,mFAAmF;IACnF,6FAA6F;IAC7F,wGAAwG;IACxG,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CACnD,CAAC;IAEF,OAAO,+BAA+B,CACpC,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,SAAS,CACV,CAAC;AACJ,CAAC;AAID,MAAM,UAAU,6BAA6B,CAAC,EAC5C,SAAS,EACT,GAAG,MAAM,EAC0B;IACnC,uEAAuE;IACvE,2EAA2E;IAC3E,sEAAsE;IACtE,wBAAwB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,GAAG,8BAA8B,EAAE,CAAC;IACjF,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAE9D,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE;QACH,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,oCAAoC,CACxC,iEAAiE,EACjE,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;QACD,OAAO,wBAAwB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IACD,8FAA8F;IAC9F,wGAAwG;IACxG,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CACnD,CAAC;IAEF,OAAO,+BAA+B,CACpC,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,SAAS,CACV,CAAC;AACJ,CAAC;AAsBD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,YAAY,EACZ,aAAa,EACb,SAAS,GACqB;IAC9B,OAAO,CACL,KAAC,6BAA6B,IAC5B,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,qBAAqB,CAAC,IAAI,EACzC,0BAA0B,EAAE,aAAa,EACzC,SAAS,EAAE,SAAS,GACpB,CACH,CAAC;AACJ,CAAC;AAID;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,YAAY,EACZ,aAAa,EACb,SAAS,GACuB;IAChC,OAAO,CACL,KAAC,6BAA6B,IAC5B,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,qBAAqB,CAAC,MAAM,EAC3C,0BAA0B,EAAE,aAAa,EACzC,SAAS,EAAE,SAAS,GACpB,CACH,CAAC;AACJ,CAAC;AA6BD,MAAM,UAAU,cAAc,CAAC,EAC7B,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,GAAG,MAAM,EACW;IACpB,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAC9D,MAAM,eAAe,GAAG,wBAAwB,CAAC,qBAAqB,CAAC;QACrE,GAAG,MAAM;QACT,aAAa,EAAE,qBAAqB,CAAC,IAAI;KAC1C,CAAC,CAAC;IAEH,qEAAqE;IACrE,gFAAgF;IAChF,8EAA8E;IAC9E,iDAAiD;IACjD,MAAM,cAAc,GAAG,iCAAiC,CAAC,wBAAwB,CAAC,CAAC;IAEnF,OAAO,CACL,KAAC,qBAAqB,IACpB,YAAY,EAAE,wBAAwB,CAAC,gBAAgB,EACvD,OAAO,EAAE,OAAO,EAChB,0BAA0B,EAAE,6BAA6B,CACvD,qBAAqB,CAAC,yBAAyB,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAC3F,cAAc,CACf,EACD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,GACpB,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAChC,YAAY,EACZ,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,GAAG,MAAM,EACc;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,oCAAoC,CACxC,qDAAqD,EACrD,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;IAED,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAC9D,+EAA+E;IAC/E,+EAA+E;IAC/E,iFAAiF;IACjF,gFAAgF;IAChF,4EAA4E;IAC5E,6EAA6E;IAC7E,8DAA8D;IAC9D,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,eAAe,GAAG,wBAAwB,CAAC,qBAAqB,CAAC;QACrE,GAAG,MAAM;QACT,YAAY;QACZ,aAAa,EAAE,qBAAqB,CAAC,IAAI;KAC1C,CAAC,CAAC;IAEH,OAAO,CACL,KAAC,qBAAqB,IACpB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,0BAA0B,EAAE,qBAAqB,CAAC,yBAAyB,CACzE,eAAe,CAAC,0BAA0B,CAC3C,EACD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,GACpB,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,SAAS,EACT,GAAG,MAAM,EACe;IACxB,MAAM,EAAE,cAAc,EAAE,GAAG,8BAA8B,EAAE,CAAC;IAC5D,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAE9D,MAAM,eAAe,GAAG,wBAAwB,CAAC,qBAAqB,CAAC;QACrE,GAAG,MAAM;QACT,aAAa,EAAE,qBAAqB,CAAC,IAAI;KAC1C,CAAC,CAAC;IAEH,qEAAqE;IACrE,iFAAiF;IACjF,iFAAiF;IACjF,yDAAyD;IACzD,MAAM,cAAc,GAAG,iCAAiC,CAAC,wBAAwB,CAAC,CAAC;IAEnF,MAAM,gBAAgB,GAAG,sCAAsC,CAC7D,wBAAwB,CAAC,gBAAgB,EACzC,EAAE,GAAG,EAAE,OAAO,EAAE,CACjB,CAAC;IAEF,OAAO,uBAAuB,CAC5B,gBAAgB,CAAC,eAAe,EAChC,cAAc,EACd,6BAA6B,CAC3B,qBAAqB,CAAC,yBAAyB,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAC3F,cAAc,CACf,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EACpC,YAAY,EACZ,OAAO,EACP,SAAS,EACT,GAAG,MAAM,EACkB;IAC3B,MAAM,EAAE,cAAc,EAAE,GAAG,8BAA8B,EAAE,CAAC;IAC5D,MAAM,wBAAwB,GAAG,0BAA0B,EAAE,CAAC;IAE9D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,oCAAoC,CACxC,yDAAyD,EACzD,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,wBAAwB,CAAC,qBAAqB,CAAC;QACrE,GAAG,MAAM;QACT,YAAY;QACZ,aAAa,EAAE,qBAAqB,CAAC,IAAI;KAC1C,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,sCAAsC,CAC7D,YAAY,EACZ,EAAE,GAAG,EAAE,OAAO,EAAE,CACjB,CAAC;IAEF,OAAO,uBAAuB,CAC5B,gBAAgB,CAAC,eAAe,EAChC,cAAc,EACd,qBAAqB,CAAC,yBAAyB,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAC3F,SAAS,CACV,CAAC;AACJ,CAAC","sourcesContent":["import React, { useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  ErrorCustomMessageReference,\n  type ChartInputValues,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n// ChartView MUST come from the `.lazy` wrapper — a static import of the real\n// module merges the whole ECharts payload into the entry chunk (Rollup merges\n// a module that is both statically and dynamically imported; no warning).\nimport { ChartView } from '~wildo-frontend-lib/components/views/chart-view/ChartView.lazy';\nimport { ExecutionView } from '~wildo-frontend-lib/components/views/execution-view/ExecutionView';\nimport { OnboardingView } from '~wildo-frontend-lib/components/views/onboarding-view/OnboardingView';\nimport type { OnboardingViewProps } from '~wildo-frontend-lib/components/views/onboarding-view/OnboardingView';\nimport { ResourceOperationSurface } from '~wildo-frontend-lib/components/resources/ResourceOperationSurface';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { buildResourceInsertedExecutionIdentity } from '~wildo-frontend-lib/core/config/execution-view.schemas';\nimport {\n  buildResolvedInsertedChartDescriptor,\n  buildResourceInsertedChartIdentity,\n} from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\nimport { FeatureRouteGuard } from '~wildo-frontend-lib/core/features/FeatureRouteGuard';\nimport { SectionHostHeadingContext } from '~wildo-frontend-lib/components/resources/skeleton/SectionHostHeadingContext';\nimport { EmbeddedResourceDescentBoundary } from './EmbeddedResourceDescent';\nimport { useRegisterComposedChild } from './ComposedChildrenRegistry';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\n\nimport { CompositeView } from '~wildo-frontend-lib/components/views/composite-view/CompositeView';\nimport {\n  useEmbeddedResourceHostContext,\n  useOptionalEmbeddedResourceHostContext,\n} from '~wildo-frontend-lib/components/resources/embeds/EmbeddedResourceHostContext';\nimport {\n  useEmbeddedResourceContext,\n  type EmbeddedResourceOperationTarget,\n  type EmbeddedResourceOperationTargetSelector,\n} from './useEmbeddedResourceContext';\nimport {\n  useHostRecordDerivedParentContext,\n  mergeDerivedParentIdentifiers,\n} from '~wildo-frontend-lib/components/views/composite-view/useHostRecordDerivedParentContext';\n\ninterface EmbeddedSurfaceProps {\n  viewRef: string;\n  className?: string;\n}\n\nexport interface EmbedChartProps extends EmbeddedSurfaceProps {\n  resourceType: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  inputs?: ChartInputValues;\n  urlParamValues?: Record<string, string>;\n  /**\n   * Explicit chart canvas height (`ChartView` default is 400). Needed because\n   * `ChartView` sizes its ECharts canvas by this prop, not by its wrapper — a\n   * height utility on the embed's `className` cannot shrink the chart. Pass a\n   * number (px) or a CSS length for compact dashboard tiles.\n   */\n  height?: string | number;\n}\n\nfunction EmbeddedChartRenderer(params: {\n  resourceType: string;\n  viewRef: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  inputs?: ChartInputValues;\n  urlParamValues?: Record<string, string>;\n  className?: string;\n  height?: string | number;\n}): React.JSX.Element {\n  const { registry } = useResourceRegistry();\n  const chartView = registry.resourceConfigurations[params.resourceType]\n    ?.frontendConfiguration\n    ?.chartViews\n    ?.find((candidate) => candidate.ref === params.viewRef);\n  if (!chartView) {\n    throw buildResourceEmbedConfigurationError(\n      `Composite chart runtime cannot resolve chart view \"${params.viewRef}\" on resource \"${params.resourceType}\".`,\n      {\n        resourceType: params.resourceType,\n        viewRef: params.viewRef,\n      },\n    );\n  }\n\n  const identity = buildResourceInsertedChartIdentity(params.resourceType, { ref: params.viewRef });\n\n  return (\n    <div className={params.className}>\n      <FeatureRouteGuard requiredFeatures={chartView.chartDefinition.requiredFeatures}>\n        <ChartView\n          viewRef={identity.insertedViewRef}\n          viewDefinition={chartView}\n          runtimeDescriptor={buildResolvedInsertedChartDescriptor({\n            identity,\n            chartView,\n            contextResourceIdentifiers: params.contextResourceIdentifiers ?? {},\n          })}\n          contextResourceIdentifiers={params.contextResourceIdentifiers}\n          inputs={params.inputs}\n          urlParamValues={params.urlParamValues}\n          {...(params.height != null ? { height: params.height } : {})}\n          // Embedded composite tile → a data-fetch failure degrades locally in the\n          // card, no page-level toast (per-widget error isolation).\n          localErrorOnly\n        />\n      </FeatureRouteGuard>\n    </div>\n  );\n}\n\nexport function EmbedChart({\n  resourceType,\n  viewRef,\n  contextResourceIdentifiers,\n  inputs,\n  urlParamValues,\n  className,\n  height,\n}: EmbedChartProps): React.JSX.Element {\n  const compositeContext = useEmbeddedResourceHostContext();\n\n  return (\n    <EmbeddedChartRenderer\n      resourceType={resourceType}\n      viewRef={viewRef}\n      contextResourceIdentifiers={{\n        ...(compositeContext.contextResourceIdentifiers ?? {}),\n        ...(contextResourceIdentifiers ?? {}),\n      }}\n      inputs={inputs}\n      urlParamValues={urlParamValues}\n      className={className}\n      height={height}\n    />\n  );\n}\n\nexport interface EmbedOnboardingProps {\n  document: OnboardingViewProps['document'];\n  viewRef?: string;\n  guidanceFlowRef?: string;\n  className?: string;\n}\n\nexport function EmbedOnboarding({\n  document,\n  viewRef,\n  guidanceFlowRef,\n  className,\n}: EmbedOnboardingProps): React.JSX.Element {\n  return (\n    <div className={className}>\n      <OnboardingView\n        document={document}\n        viewRef={viewRef}\n        guidanceFlowRef={guidanceFlowRef}\n      />\n    </div>\n  );\n}\n\nexport function EmbedComposite({\n  viewRef,\n  className,\n}: EmbeddedSurfaceProps): React.JSX.Element {\n  // The host record this composite hangs off — used to key the descent, so the\n  // SAME composite over a different record still nests while a genuine revisit\n  // is refused. Optional context: a composite embedded outside a resource host\n  // keys on the view alone, which still catches direct self-embedding.\n  const host = useOptionalEmbeddedResourceHostContext();\n  const hostRow = host?.hostResourceType\n    ? host.contextResourceIdentifiers?.[host.hostResourceType] ?? 'no-row'\n    : 'no-host';\n\n  return (\n    <div className={className}>\n      {/*\n        D9 — a composite view is the THIRD descent path, and the one most likely\n        to recurse in practice: composites in this repository already embed\n        `EmbedHostResourceOperation` with `operationLike: READ`, which mounts a\n        full record surface that composes its own children. A composite that\n        reaches itself again — directly, or through a second composite that links\n        back — has no resource embed in the loop to stop it.\n      */}\n      <EmbeddedResourceDescentBoundary descentKey={`composite:${viewRef}::${hostRow}`}>\n        <CompositeView viewRef={viewRef} />\n      </EmbeddedResourceDescentBoundary>\n    </div>\n  );\n}\n\nexport interface EmbedExecutionProps extends EmbeddedSurfaceProps {\n  contextResourceIdentifiers?: Record<string, string>;\n}\n\nfunction renderEmbeddedExecution(\n  viewRef: string,\n  navigationZone: ReturnType<typeof useEmbeddedResourceHostContext>['navigationZone'],\n  contextResourceIdentifiers?: Record<string, string>,\n  className?: string,\n): React.JSX.Element {\n  return (\n    <div className={className}>\n      {/*\n        D9 — an execution view is a DESCENT PATH in its own right, and closing it\n        is not redundant with bounding resource embeds. A resource-operation embed\n        inside an execution view is already bounded, so a mixed chain terminates;\n        but an execution view that embeds ITSELF (`EmbedHostExecution` with its own\n        `viewRef`) recurses with no resource embed anywhere in the loop, so nothing\n        else would ever stop it.\n        Keyed on `(viewRef, host row)` for the same reason resource descents are:\n        the same view over a DIFFERENT record is legitimate nesting, the same view\n        over the same record is a cycle.\n      */}\n      <EmbeddedResourceDescentBoundary\n        descentKey={`execution:${viewRef}::${Object.values(contextResourceIdentifiers ?? {}).join(',') || 'no-row'}`}\n      >\n        <ExecutionView\n          viewRef={viewRef}\n          navigationZone={navigationZone}\n          contextResourceIdentifiers={contextResourceIdentifiers}\n        />\n      </EmbeddedResourceDescentBoundary>\n    </div>\n  );\n}\n\nexport function EmbedExecution({\n  viewRef,\n  contextResourceIdentifiers,\n  className,\n}: EmbedExecutionProps): React.JSX.Element {\n  const compositeContext = useEmbeddedResourceHostContext();\n\n  return renderEmbeddedExecution(\n    viewRef,\n    compositeContext.navigationZone,\n    {\n      ...(compositeContext.contextResourceIdentifiers ?? {}),\n      ...(contextResourceIdentifiers ?? {}),\n    },\n    className,\n  );\n}\n\nfunction buildResourceEmbedConfigurationError(\n  message: string,\n  context?: Record<string, unknown>,\n): Error {\n  return FrontendResourceUtils.buildConfigurationError(\n    ErrorCustomMessageReference.CONFIGURATION,\n    {\n      message,\n      component: 'ResourceEmbeds',\n      ...context,\n    },\n  );\n}\n\nfunction renderEmbeddedResourceOperation(\n  resourceContext: FrontendResourceOperationContext,\n  navigationZone: ReturnType<typeof useEmbeddedResourceHostContext>['navigationZone'],\n  navigationInitiator: ReturnType<typeof useEmbeddedResourceHostContext>['navigationInitiator'],\n  className?: string,\n): React.JSX.Element {\n  return (\n    <div className={className}>\n      {/*\n        D7 — the HOST owns the framing, the embed never brings its own.\n        `SectionHostHeadingContext` makes the embedded surface suppress its generic\n        resource heading (and the page chrome that trails it), so a child placed in\n        a template renders as CONTENT rather than as a second page inside the first.\n        Without it an embed dropped straight into a display flow stacks its own\n        heading, description, parent breadcrumb and back-arrow under the host's —\n        the exact defect that had to be fixed in the nested container, arriving\n        again through this door because the embed suppressed nothing.\n        It is set unconditionally rather than only inside a titled <Section>: an\n        author who placed the child decided where it goes, and a surface that\n        injects a page header into someone else's flow depending on its ancestors\n        is the context-dependent behaviour that made the original defect so hard\n        to see. A record-specific `displayLabel` is data, not a duplicate heading,\n        and is never suppressed by this context.\n      */}\n      {/*\n        D9 — every embedded surface is one level of DESCENT and must be bounded.\n        An embed may mount a full READ surface, which composes its own children,\n        which may embed again; on a self-referencing or mutually-recursive edge\n        that does not terminate. The key is `(target resource, host row)` so a\n        legitimate hierarchy over distinct rows keeps descending while a genuine\n        revisit of the same record is refused at the moment it happens.\n      */}\n      <EmbeddedResourceDescentBoundary\n        descentKey={`embed:${resourceContext.resourceType}::${FrontendResourceUtils.getInstance().getResourceId(\n          resourceContext.contextResourceIdentifiers?.[resourceContext.resourceType],\n        ) || 'no-row'}`}\n      >\n        <SectionHostHeadingContext.Provider value={true}>\n          <ResourceOperationSurface\n            resourceContext={resourceContext}\n            navigationZone={navigationZone}\n            navigationInitiator={navigationInitiator}\n          />\n        </SectionHostHeadingContext.Provider>\n      </EmbeddedResourceDescentBoundary>\n    </div>\n  );\n}\n\nexport interface EmbedResourceOperationProps {\n  resourceContext: FrontendResourceOperationContext;\n  className?: string;\n}\n\nexport type EmbedHostResourceOperationProps = EmbeddedResourceOperationTarget\n  & EmbeddedResourceOperationTargetSelector\n  & {\n    className?: string;\n  };\n\n/** @wildo_source:part:start saas.frontend.related-resource-embeds facet:layer:frontend facet:family:component */\nexport type EmbedRelatedResourceOperationProps = EmbeddedResourceOperationTargetSelector\n  & {\n    resourceType: string;\n    resourceId?: string;\n    relationshipFieldOverrides?: Record<string, string>;\n    additionalContext?: Record<string, unknown>;\n    className?: string;\n  };\n/** @wildo_source:part:end saas.frontend.related-resource-embeds */\n\nexport function EmbedResourceOperation({\n  resourceContext,\n  className,\n}: EmbedResourceOperationProps): React.JSX.Element {\n  const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();\n\n  return renderEmbeddedResourceOperation(\n    resourceContext,\n    navigationZone,\n    navigationInitiator,\n    className,\n  );\n}\n\nexport function EmbedHostResourceOperation({\n  className,\n  ...target\n}: EmbedHostResourceOperationProps): React.JSX.Element {\n  const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n\n  const resourceContext = useMemo(\n    () => compositeResourceContext.buildOperationContext(target),\n    // Keyed by the target's *value*, not the fresh-every-render rest-object identity.\n    // buildOperationContext clones resource configs to assemble the context; calling it\n    // inline each render churns those clones (the 603-config heap growth) and hands a new\n    // `resourceContext` identity to the operation surface, re-firing its context-keyed\n    // effects — the composite re-render loop. Recomputes only on a real target / context change.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`\n    [compositeResourceContext, JSON.stringify(target)],\n  );\n\n  return renderEmbeddedResourceOperation(\n    resourceContext,\n    navigationZone,\n    navigationInitiator,\n    className,\n  );\n}\n\nexport type EmbedRelatedResourceOperationTarget = Omit<EmbedRelatedResourceOperationProps, 'className'>;\n\nexport function EmbedRelatedResourceOperation({\n  className,\n  ...target\n}: EmbedRelatedResourceOperationProps): React.JSX.Element {\n  // D1 — claim this child for the template that placed it, so the host's\n  // automatic composition skips it instead of rendering a second copy below.\n  // A no-op outside a registry host, so composite views are unaffected.\n  useRegisterComposedChild(target.resourceType);\n  const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n\n  const resourceContext = useMemo(\n    () => {\n      if (!target.resourceType) {\n        throw buildResourceEmbedConfigurationError(\n          'EmbedRelatedResourceOperation() requires a target resourceType.',\n          { target },\n        );\n      }\n      return compositeResourceContext.buildOperationContext(target);\n    },\n    // Keyed by target value, not the fresh rest-object identity — see EmbedHostResourceOperation.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`\n    [compositeResourceContext, JSON.stringify(target)],\n  );\n\n  return renderEmbeddedResourceOperation(\n    resourceContext,\n    navigationZone,\n    navigationInitiator,\n    className,\n  );\n}\n\n/** @wildo_source:part:start saas.frontend.related-resource-embeds facet:layer:frontend facet:family:component */\n/**\n * Which EDGE to embed, when the host has more than one relationship to the same\n * target resource — two lists of todos, an assignee and a reviewer both pointing\n * at users. Keyed by the HOST resource type, valued with the foreign-key field\n * that identifies the edge.\n *\n * `resourceType` alone is ambiguous in that case, and the ambiguity is silent:\n * the resolver picks an edge and renders a plausible-looking wrong collection.\n */\nexport type EmbedRelatedResourceEdgeSelector = Record<string, string>;\n\nexport interface EmbedRelatedResourceListProps {\n  /** Target child resource type. */\n  resourceType: string;\n  /** Disambiguates WHICH edge when the host has several to this target. */\n  viaForeignKey?: EmbedRelatedResourceEdgeSelector;\n  className?: string;\n}\n\n/**\n * Embed a related resource's LIST — the common case, spelled directly.\n *\n * A pure delegation to {@link EmbedRelatedResourceOperation}: no resolution,\n * addressability or context logic lives here. The operation embed stays the one\n * place that code exists, so a shortcut can never drift from it.\n */\nexport function EmbedRelatedResourceList({\n  resourceType,\n  viaForeignKey,\n  className,\n}: EmbedRelatedResourceListProps): React.JSX.Element {\n  return (\n    <EmbedRelatedResourceOperation\n      resourceType={resourceType}\n      operationLike={CoreResourceOperation.LIST}\n      relationshipFieldOverrides={viaForeignKey}\n      className={className}\n    />\n  );\n}\n\nexport interface EmbedRelatedResourceSearchProps extends EmbedRelatedResourceListProps {}\n\n/**\n * Embed a related resource's SEARCH surface. Same delegation contract as\n * {@link EmbedRelatedResourceList} — only the semantic operation differs.\n */\nexport function EmbedRelatedResourceSearch({\n  resourceType,\n  viaForeignKey,\n  className,\n}: EmbedRelatedResourceSearchProps): React.JSX.Element {\n  return (\n    <EmbedRelatedResourceOperation\n      resourceType={resourceType}\n      operationLike={CoreResourceOperation.SEARCH}\n      relationshipFieldOverrides={viaForeignKey}\n      className={className}\n    />\n  );\n}\n/** @wildo_source:part:end saas.frontend.related-resource-embeds */\n\nexport interface EmbedHostExecutionProps extends EmbeddedResourceOperationTarget {\n  viewRef: string;\n  className?: string;\n}\n\nexport interface EmbedRelatedExecutionProps extends EmbeddedResourceOperationTarget {\n  resourceType: string;\n  viewRef: string;\n  className?: string;\n}\n\nexport interface EmbedHostChartProps extends EmbeddedResourceOperationTarget {\n  viewRef: string;\n  inputs?: ChartInputValues;\n  urlParamValues?: Record<string, string>;\n  className?: string;\n}\n\nexport interface EmbedRelatedChartProps extends EmbeddedResourceOperationTarget {\n  resourceType: string;\n  viewRef: string;\n  inputs?: ChartInputValues;\n  urlParamValues?: Record<string, string>;\n  className?: string;\n}\n\nexport function EmbedHostChart({\n  viewRef,\n  inputs,\n  urlParamValues,\n  className,\n  ...target\n}: EmbedHostChartProps): React.JSX.Element {\n  const compositeResourceContext = useEmbeddedResourceContext();\n  const resourceContext = compositeResourceContext.buildOperationContext({\n    ...target,\n    operationLike: CoreResourceOperation.READ,\n  });\n\n  // D2: a host-owned chart may require the host's PARENT scope (e.g. a\n  // `todo-task-status` chart mandating `todos` when the host is a `task`). Derive\n  // the parent id off the host record and merge it UNDER the URL context so the\n  // chart's `parentResourcesRequirements` resolve.\n  const derivedParents = useHostRecordDerivedParentContext(compositeResourceContext);\n\n  return (\n    <EmbeddedChartRenderer\n      resourceType={compositeResourceContext.hostResourceType}\n      viewRef={viewRef}\n      contextResourceIdentifiers={mergeDerivedParentIdentifiers(\n        FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers),\n        derivedParents,\n      )}\n      inputs={inputs}\n      urlParamValues={urlParamValues}\n      className={className}\n    />\n  );\n}\n\nexport function EmbedRelatedChart({\n  resourceType,\n  viewRef,\n  inputs,\n  urlParamValues,\n  className,\n  ...target\n}: EmbedRelatedChartProps): React.JSX.Element {\n  if (!resourceType) {\n    throw buildResourceEmbedConfigurationError(\n      'EmbedRelatedChart() requires a target resourceType.',\n      { target },\n    );\n  }\n\n  const compositeResourceContext = useEmbeddedResourceContext();\n  // A RELATED chart aggregates a COLLECTION of `resourceType` scoped by the host\n  // record (e.g. the tasks of the current todo) — there is no single addressable\n  // related-record id, so it must resolve a collection operation (LIST), NOT READ.\n  // Resolving READ here required an addressable related id that never exists in a\n  // host→related context and threw a composite configuration error (caught by\n  // SurfaceErrorBoundary, degrading the surface). The host context (the parent\n  // record's id) is still threaded into the related context via\n  // `deriveChildResourceContext`, so the chart stays scoped to the host record.\n  // (`EmbedHostChart` keeps READ: the host IS a single addressable record.)\n  const resourceContext = compositeResourceContext.buildOperationContext({\n    ...target,\n    resourceType,\n    operationLike: CoreResourceOperation.LIST,\n  });\n\n  return (\n    <EmbeddedChartRenderer\n      resourceType={resourceType}\n      viewRef={viewRef}\n      contextResourceIdentifiers={FrontendResourceUtils.flattenContextIdentifiers(\n        resourceContext.contextResourceIdentifiers,\n      )}\n      inputs={inputs}\n      urlParamValues={urlParamValues}\n      className={className}\n    />\n  );\n}\n\nexport function EmbedHostExecution({\n  viewRef,\n  className,\n  ...target\n}: EmbedHostExecutionProps): React.JSX.Element {\n  const { navigationZone } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n\n  const resourceContext = compositeResourceContext.buildOperationContext({\n    ...target,\n    operationLike: CoreResourceOperation.READ,\n  });\n\n  // D2: a host-owned execution may anchor on the host's PARENT (e.g. a\n  // `task-workspace` execution binding `todoId` when the host is a `task`). Derive\n  // the parent id off the host record so the anchor resolves instead of \"No anchor\n  // resolved\". Merged UNDER the URL context (URL ids win).\n  const derivedParents = useHostRecordDerivedParentContext(compositeResourceContext);\n\n  const insertedIdentity = buildResourceInsertedExecutionIdentity(\n    compositeResourceContext.hostResourceType,\n    { ref: viewRef },\n  );\n\n  return renderEmbeddedExecution(\n    insertedIdentity.insertedViewRef,\n    navigationZone,\n    mergeDerivedParentIdentifiers(\n      FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers),\n      derivedParents,\n    ),\n    className,\n  );\n}\n\nexport function EmbedRelatedExecution({\n  resourceType,\n  viewRef,\n  className,\n  ...target\n}: EmbedRelatedExecutionProps): React.JSX.Element {\n  const { navigationZone } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n\n  if (!resourceType) {\n    throw buildResourceEmbedConfigurationError(\n      'EmbedRelatedExecution() requires a target resourceType.',\n      { target: { resourceType, viewRef, ...target } },\n    );\n  }\n\n  const resourceContext = compositeResourceContext.buildOperationContext({\n    ...target,\n    resourceType,\n    operationLike: CoreResourceOperation.READ,\n  });\n\n  const insertedIdentity = buildResourceInsertedExecutionIdentity(\n    resourceType,\n    { ref: viewRef },\n  );\n\n  return renderEmbeddedExecution(\n    insertedIdentity.insertedViewRef,\n    navigationZone,\n    FrontendResourceUtils.flattenContextIdentifiers(resourceContext.contextResourceIdentifiers),\n    className,\n  );\n}\n"]}

package/dist/esm/components/resources/embeds/child-operation-addressability.utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Whether a child resource's LIST operation can actually be ADDRESSED from the
+ * parent context currently in hand.
+ *
+ * Shared by the automatic children container and the related-resource preview:
+ * both must answer the same question before rendering anything, and answering it
+ * twice in two places is how the two surfaces would drift into disagreeing about
+ * which children are reachable.
+ *
+ * Lives in its own module rather than in either consumer so neither imports the
+ * other — the container renders the preview, so a helper owned by the preview
+ * would make that dependency circular.
+ */
+import type { FrontendResourceConfiguration_Operation } from '../../../core/resources/resources.frontend.schemas';
+import { type ResourceConfiguration_Operation_UrlInitiatorInfo } from '@wildo-ai/saas-models';
+import { frontendResourceUtils } from '../../../core/resources/frontend-resource.utils';
+type OperationWithInitiatorInfos = FrontendResourceConfiguration_Operation & {
+    initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[];
+};
+export declare function getContextIdentifierValue(contextResourceIdentifiers: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>['contextResourceIdentifiers'], key: string | undefined): string | undefined;
+export declare function isListOperationAddressableForChildContext(operation: OperationWithInitiatorInfos, childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>, contextualParameters: Record<string, string | number>): boolean;
+export declare function pickAddressableChildListOperation(params: {
+    operations: readonly FrontendResourceConfiguration_Operation[];
+    childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>;
+    contextualParameters: Record<string, string | number>;
+}): FrontendResourceConfiguration_Operation | undefined;
+export {};
+//# sourceMappingURL=child-operation-addressability.utils.d.ts.map

package/dist/esm/components/resources/embeds/child-operation-addressability.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-operation-addressability.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/child-operation-addressability.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAyB,KAAK,gDAAgD,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAGnG,KAAK,2BAA2B,GAAG,uCAAuC,GAAG;IAC3E,cAAc,CAAC,EAAE,gDAAgD,EAAE,CAAC;CACrE,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,0BAA0B,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,0BAA0B,CAAC,CAAC,4BAA4B,CAAC,EAC7H,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,2BAA2B,EACtC,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,0BAA0B,CAAC,EACjF,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpD,OAAO,CAoBT;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,UAAU,EAAE,SAAS,uCAAuC,EAAE,CAAC;IAC/D,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;IAClF,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,uCAAuC,GAAG,SAAS,CAatD"}

package/dist/esm/components/resources/embeds/child-operation-addressability.utils.js

@@ -0,0 +1,31 @@
+'use client';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { frontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+export function getContextIdentifierValue(contextResourceIdentifiers, key) {
+    if (!key) {
+        return undefined;
+    }
+    const resourceId = frontendResourceUtils.getResourceId(contextResourceIdentifiers[key]);
+    return typeof resourceId === 'string' && resourceId.length > 0 ? resourceId : undefined;
+}
+export function isListOperationAddressableForChildContext(operation, childContext, contextualParameters) {
+    const initiatorInfos = operation.initiatorInfos ?? [];
+    if (initiatorInfos.length === 0) {
+        return false;
+    }
+    return initiatorInfos.some((initiatorInfo) => (initiatorInfo.parameters ?? []).every((parameter) => {
+        const candidateKeys = [
+            parameter.fieldIdentifier,
+            parameter.relationshipField,
+            parameter.resourceType,
+        ].filter((key) => typeof key === 'string' && key.length > 0);
+        return candidateKeys.some((key) => getContextIdentifierValue(childContext.contextResourceIdentifiers, key) !== undefined
+            || (contextualParameters[key] !== undefined && String(contextualParameters[key]).length > 0));
+    }));
+}
+export function pickAddressableChildListOperation(params) {
+    const addressableOperations = params.operations.filter((candidate) => isListOperationAddressableForChildContext(candidate, params.childContext, params.contextualParameters));
+    return pickPreferredOperationForCoreSemantic(addressableOperations, CoreResourceOperation.LIST);
+}
+//# sourceMappingURL=child-operation-addressability.utils.js.map

package/dist/esm/components/resources/embeds/child-operation-addressability.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-operation-addressability.utils.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/child-operation-addressability.utils.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAiBb,OAAO,EAAE,qBAAqB,EAAyD,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,EAAE,qCAAqC,EAAE,MAAM,uEAAuE,CAAC;AAM9H,MAAM,UAAU,yBAAyB,CACvC,0BAA6H,EAC7H,GAAuB;IAEvB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,aAAa,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,SAAsC,EACtC,YAAiF,EACjF,oBAAqD;IAErD,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC;IACtD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3C,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE;QACnD,MAAM,aAAa,GAAG;YACpB,SAAS,CAAC,eAAe;YACzB,SAAS,CAAC,iBAAiB;YAC3B,SAAS,CAAC,YAAY;SACvB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE5E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAChC,yBAAyB,CAAC,YAAY,CAAC,0BAA0B,EAAE,GAAG,CAAC,KAAK,SAAS;eAClF,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAC7F,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,MAIjD;IACC,MAAM,qBAAqB,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACnE,yCAAyC,CACvC,SAAwC,EACxC,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,oBAAoB,CAC5B,CACF,CAAC;IAEF,OAAO,qCAAqC,CAC1C,qBAAqB,EACrB,qBAAqB,CAAC,IAAI,CAC3B,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * Whether a child resource's LIST operation can actually be ADDRESSED from the\n * parent context currently in hand.\n *\n * Shared by the automatic children container and the related-resource preview:\n * both must answer the same question before rendering anything, and answering it\n * twice in two places is how the two surfaces would drift into disagreeing about\n * which children are reachable.\n *\n * Lives in its own module rather than in either consumer so neither imports the\n * other — the container renders the preview, so a helper owned by the preview\n * would make that dependency circular.\n */\n\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { CoreResourceOperation, type ResourceConfiguration_Operation_UrlInitiatorInfo } from '@wildo-ai/saas-models';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\ntype OperationWithInitiatorInfos = FrontendResourceConfiguration_Operation & {\n  initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[];\n};\n\nexport function getContextIdentifierValue(\n  contextResourceIdentifiers: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>['contextResourceIdentifiers'],\n  key: string | undefined,\n): string | undefined {\n  if (!key) {\n    return undefined;\n  }\n\n  const resourceId = frontendResourceUtils.getResourceId(contextResourceIdentifiers[key]);\n  return typeof resourceId === 'string' && resourceId.length > 0 ? resourceId : undefined;\n}\n\nexport function isListOperationAddressableForChildContext(\n  operation: OperationWithInitiatorInfos,\n  childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>,\n  contextualParameters: Record<string, string | number>,\n): boolean {\n  const initiatorInfos = operation.initiatorInfos ?? [];\n  if (initiatorInfos.length === 0) {\n    return false;\n  }\n\n  return initiatorInfos.some((initiatorInfo) =>\n    (initiatorInfo.parameters ?? []).every((parameter) => {\n      const candidateKeys = [\n        parameter.fieldIdentifier,\n        parameter.relationshipField,\n        parameter.resourceType,\n      ].filter((key): key is string => typeof key === 'string' && key.length > 0);\n\n      return candidateKeys.some((key) =>\n        getContextIdentifierValue(childContext.contextResourceIdentifiers, key) !== undefined\n        || (contextualParameters[key] !== undefined && String(contextualParameters[key]).length > 0)\n      );\n    })\n  );\n}\n\nexport function pickAddressableChildListOperation(params: {\n  operations: readonly FrontendResourceConfiguration_Operation[];\n  childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>;\n  contextualParameters: Record<string, string | number>;\n}): FrontendResourceConfiguration_Operation | undefined {\n  const addressableOperations = params.operations.filter((candidate) =>\n    isListOperationAddressableForChildContext(\n      candidate as OperationWithInitiatorInfos,\n      params.childContext,\n      params.contextualParameters,\n    )\n  );\n\n  return pickPreferredOperationForCoreSemantic<FrontendResourceConfiguration_Operation>(\n    addressableOperations,\n    CoreResourceOperation.LIST,\n  );\n}\n"]}

package/dist/esm/components/resources/embeds/useEmbeddedResourceContext.d.ts

@@ -0,0 +1,51 @@
+import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';
+import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourceOperationContext } from '../../../core/resources/resources.frontend.schemas';
+export interface EmbeddedResourceOperationTarget {
+    resourceType?: string;
+    resourceId?: string;
+    relationshipFieldOverrides?: Record<string, string>;
+    additionalContext?: Record<string, unknown>;
+}
+export interface EmbeddedResourceOperationTarget_ByIdentifier extends EmbeddedResourceOperationTarget {
+    operationIdentifier: string;
+    variantType?: ResourceOperationVariantType;
+    variantKey?: string;
+    isOperationDefault?: boolean;
+    isBulkOperation?: boolean;
+    operationLike?: never;
+    requireAddressable?: never;
+    allowBulk?: never;
+}
+export interface EmbeddedResourceOperationTarget_BySemantic extends EmbeddedResourceOperationTarget {
+    operationIdentifier?: never;
+    operationLike: CoreResourceOperation;
+    requireAddressable?: boolean;
+    allowBulk?: boolean;
+}
+export type EmbeddedResourceOperationTargetSelector = EmbeddedResourceOperationTarget_ByIdentifier | EmbeddedResourceOperationTarget_BySemantic;
+export type EmbeddedResourceOperationTargetResolved = EmbeddedResourceOperationTarget & EmbeddedResourceOperationTargetSelector;
+export interface EmbeddedResourceContextValue {
+    hostResourceType: string;
+    hostResourceId?: string;
+    hostResourceConfig: AnyFrontendResourceConfiguration;
+    contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];
+    parentResourcesRequirements: FrontendResourceOperationContext['parentResourcesRequirements'];
+    resolveOperation: (target: Pick<EmbeddedResourceOperationTargetResolved, 'resourceType'> & EmbeddedResourceOperationTargetSelector) => FrontendResourceConfiguration_Operation;
+    buildOperationContext: (target: EmbeddedResourceOperationTargetResolved) => FrontendResourceOperationContext;
+    /**
+     * Non-throwing probe: `true` when {@link buildOperationContext} would succeed
+     * for this target, `false` when the target cannot be embedded at all.
+     *
+     * Exists because a target being un-embeddable is a NORMAL, authorable state, not
+     * an exceptional one. A resource can legitimately expose a core verb with no
+     * addressable HTTP variant — Wonder's todo recurring-occurrences declares LIST as
+     * `INTERNAL_CALL` only, deliberately — and a surface that places several children
+     * must be able to drop that one without the throw taking the whole page down with
+     * it. That is exactly the failure the automatic container already avoids by
+     * skipping a child it cannot display.
+     */
+    canBuildOperationContext: (target: EmbeddedResourceOperationTargetResolved) => boolean;
+}
+export declare function useOptionalCompositeResourceContext(): EmbeddedResourceContextValue | null;
+export declare function useEmbeddedResourceContext(): EmbeddedResourceContextValue;
+//# sourceMappingURL=useEmbeddedResourceContext.d.ts.map

package/dist/esm/components/resources/embeds/useEmbeddedResourceContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEmbeddedResourceContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/useEmbeddedResourceContext.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EAErB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAe/B,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACvC,gCAAgC,EACjC,MAAM,+DAA+D,CAAC;AAYvE,MAAM,WAAW,+BAA+B;IAC9C,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,4CAA6C,SAAQ,+BAA+B;IACnG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,0CAA2C,SAAQ,+BAA+B;IACjG,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,uCAAuC,GAC/C,4CAA4C,GAC5C,0CAA0C,CAAC;AAE/C,MAAM,MAAM,uCAAuC,GACjD,+BAA+B,GAAG,uCAAuC,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,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,uCAAuC,EAAE,cAAc,CAAC,GAAG,uCAAuC,KAC5G,uCAAuC,CAAC;IAC7C,qBAAqB,EAAE,CACrB,MAAM,EAAE,uCAAuC,KAC5C,gCAAgC,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,wBAAwB,EAAE,CACxB,MAAM,EAAE,uCAAuC,KAC5C,OAAO,CAAC;CACd;AAqHD,wBAAgB,mCAAmC,IAAI,4BAA4B,GAAG,IAAI,CAuQzF;AAED,wBAAgB,0BAA0B,IAAI,4BAA4B,CAUzE"}