@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

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

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from 'react';
-import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, Resources_SharedUtils, getChildDirectionRelationships, } from '@wildo-ai/saas-models';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { ContentSectionContainer } from '../../../components/sections/ContentSectionContainer.js';
 import { resolveResourceHeaderLabel } from '../../../core/i18n/component-label-resolution.utils.js';
@@ -10,8 +10,40 @@ import { SectionHostHeadingContext } from '../../../components/resources/skeleto
 import { EmbedRelatedResourceOperation } from './ResourceEmbeds.js';
 import { useClaimChildComposition } from './ComposedChildrenRegistry.js';
 import { useOptionalCompositeResourceContext } from './useEmbeddedResourceContext.js';
+import { useOptionalDisplayTemplateContext } from '../../../components/data-display/DisplayTemplateContext.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 /** @wildo_source:part:end saas.frontend.related-resource-sections */
+/**
+ * Is a placed child ruled out by the HOST ROW itself — every edge from the host to it carrying a
+ * relationship `discriminator` or `condition` the displayed row does not satisfy?
+ *
+ * The automatic composition (`ResourceLayout_ContainerNested`) has always asked this through
+ * `isRelationshipActiveForParent`; a template placing the same child did not, so a discriminated
+ * edge — Wonder Todos' recurring occurrences, which exist only for a RECURRING todo — rendered a tab
+ * on every todo, and the backend refused its LIST for the ones it does not apply to (#1787). Same
+ * predicate, same options, so the two composition paths cannot disagree about which children a row has.
+ *
+ * - `undefined` host row with no display template around the sections: nothing to judge, so no
+ *   opinion — a composite view placing children keeps the behaviour it had.
+ * - `undefined` host row INSIDE a template: the row is still loading, and a constrained edge stays out
+ *   until it arrives (`onMissingParentResource: 'exclude'`), rather than flashing a tab it may retract.
+ * - Conservative across edges: the child is ruled out only when EVERY edge to it is inactive. A target
+ *   narrowed by `viaForeignKey` to one of several edges is not judged per edge, which would need the
+ *   registry's field identifiers; no application has a discriminated edge beside a second one to the
+ *   same child, and this errs toward showing rather than hiding.
+ */
+function isPlacedChildInactiveForHostRow(params) {
+    if (!params.hostRelationships) {
+        return false;
+    }
+    const edges = getChildDirectionRelationships(params.hostRelationships).filter((relationship) => {
+        const childResourceType = relationship.resourceType1 === params.hostResourceType
+            ? relationship.resourceType2
+            : relationship.resourceType1;
+        return childResourceType === params.targetResourceType;
+    });
+    return edges.length > 0 && edges.every((relationship) => !Resources_SharedUtils.isRelationshipActiveForParent(relationship, params.hostRecord, { onMissingParentResource: 'exclude', onConditionError: 'exclude' }));
+}
 /** One warning per (host, target) — a surface re-renders freely. */
 const warnedUnembeddableTargets = new Set();
 function warnUnembeddableTarget(hostResourceType, targetResourceType) {
@@ -39,6 +71,11 @@ export function RelatedResourceSections({ targets, config, className, }) {
     // the embeds below fail as they always did.
     const embeddedContext = useOptionalCompositeResourceContext();
     const hostResourceType = embeddedContext?.hostResourceType ?? '';
+    const hostRelationships = embeddedContext?.hostResourceConfig?.resourceRelationships;
+    // The row this block sits under, when it sits inside a display template. See
+    // `isPlacedChildInactiveForHostRow` for why "no template" and "still loading" differ.
+    const displayTemplate = useOptionalDisplayTemplateContext();
+    const hostRecord = displayTemplate?.data;
     // One i18n scope for the host; each section title is resolved per child below
     // from that child's own header label, which is what keeps this free of new keys.
     const { tResourceHeader, isReady } = useI18n({
@@ -58,6 +95,16 @@ export function RelatedResourceSections({ targets, config, className, }) {
         if (!embeddedContext) {
             return true;
         }
+        // A child the host ROW rules out is omitted SILENTLY: it is a declared condition doing its job,
+        // not a misplaced target, so it earns no warning.
+        if (displayTemplate && isPlacedChildInactiveForHostRow({
+            hostResourceType,
+            hostRelationships,
+            targetResourceType: target.resourceType,
+            hostRecord,
+        })) {
+            return false;
+        }
         const ok = embeddedContext.canBuildOperationContext({
             resourceType: target.resourceType,
             operationLike: target.operationLike ?? CoreResourceOperation.LIST,
@@ -67,7 +114,7 @@ export function RelatedResourceSections({ targets, config, className, }) {
             warnUnembeddableTarget(hostResourceType, target.resourceType);
         }
         return ok;
-    }), [normalized, embeddedContext, hostResourceType]);
+    }), [normalized, embeddedContext, hostResourceType, hostRelationships, displayTemplate, hostRecord]);
     const sections = useMemo(() => embeddable.map((target) => ({
         id: target.resourceType,
         title: resolveResourceHeaderLabel({

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

@@ -1 +1 @@
-{"version":3,"file":"RelatedResourceSections.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourceSections.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { useMemo } from 'react';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { FrontendComponentType, type SectionConfig } from '@wildo-ai/presets-components-models';\n\nimport { ContentSectionContainer } from '~wildo-frontend-lib/components/sections/ContentSectionContainer';\nimport { resolveResourceHeaderLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { SectionHostHeadingContext } from '~wildo-frontend-lib/components/resources/skeleton/SectionHostHeadingContext';\nimport { EmbedRelatedResourceOperation, type EmbedRelatedResourceEdgeSelector } from './ResourceEmbeds';\nimport { useClaimChildComposition } from './ComposedChildrenRegistry';\nimport { useOptionalCompositeResourceContext } from './useEmbeddedResourceContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * The standard child block — scoped to the children a view actually wants.\n *\n * ## Why this exists rather than \"compose it yourself\"\n *\n * Placing children in a template must not be harder than letting them compose\n * automatically, or authors will keep the automatic mode and the configuration\n * axis it needed. Doing it by hand means wiring `ContentSectionContainer`,\n * resolving each child's title through i18n, and threading the heading context —\n * three chances to get it subtly wrong, per surface.\n *\n * Worse, hand-wiring invites NAMED `<Section>`s, and a named section is a\n * THREE-PLACE obligation: the JSX name, the hand-authored `layout.refs.sections`\n * manifest, and a documented slot with `textSlots` in the resource specification.\n * Miss the third and `validateStructuralSlotDescriptions` THROWS at ESM import,\n * crash-looping the companion. This component takes each section's title from the\n * CHILD RESOURCE's own header label — the same source automatic composition uses\n * — so placing children adds no refs entry, no spec slot, and no new i18n key.\n *\n * ## What it means for composition ownership\n *\n * It renders through `EmbedRelatedResourceOperation`, so it registers placement:\n * a template using it owns the child region and the automatic block stands down.\n * That is the point — \"these children, in this order\" replaces \"all owned\n * children, minus a per-edge suppression flag on each one you did not want\".\n */\n/** @wildo_source:part:start saas.frontend.related-resource-sections facet:layer:frontend facet:family:component */\nexport interface RelatedResourceSectionTarget {\n  /** Child resource type. */\n  resourceType: string;\n  /** Disambiguates WHICH edge when the host has several to this target. */\n  viaForeignKey?: EmbedRelatedResourceEdgeSelector;\n  /** Defaults to LIST — the collection case. Use READ for a 1:1 child. */\n  operationLike?: CoreResourceOperation;\n}\n\nexport interface RelatedResourceSectionsProps {\n  /** Children to place, in render order. Order here replaces the old `orderIndex`. */\n  targets: ReadonlyArray<RelatedResourceSectionTarget | string>;\n  /** How the sections arrange — the real section vocabulary, not a serializable subset. */\n  config: SectionConfig;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.related-resource-sections */\n\n/** One warning per (host, target) — a surface re-renders freely. */\nconst warnedUnembeddableTargets = new Set<string>();\n\nfunction warnUnembeddableTarget(hostResourceType: string, targetResourceType: string): void {\n  const key = `${hostResourceType}::${targetResourceType}`;\n  if (warnedUnembeddableTargets.has(key)) {\n    return;\n  }\n  warnedUnembeddableTargets.add(key);\n  LoggerFrontendService.getLogger().warn(\n    `[related-resource-sections] \"${targetResourceType}\" was placed on \"${hostResourceType}\" but cannot be `\n    + 'embedded here, so its section is omitted. The usual cause is that the target exposes no ADDRESSABLE '\n    + 'variant of the requested operation — a core verb declared REPOSITORY_ONLY or INTERNAL_CALL has no HTTP '\n    + 'surface to embed. Either give the target an addressable variant, point `operationLike` at one it does '\n    + 'expose, or stop placing it.',\n  );\n}\n\nexport function RelatedResourceSections({\n  targets,\n  config,\n  className,\n}: RelatedResourceSectionsProps): React.JSX.Element | null {\n  // Claim the region even when `targets` is empty: `targets={[]}` is how a\n  // surface says \"composes no children\", which is a different statement from a\n  // template that simply never mentioned them.\n  useClaimChildComposition();\n\n  const normalized = useMemo(\n    () => targets.map((t) => (typeof t === 'string' ? { resourceType: t } : t)),\n    [targets],\n  );\n\n  // OPTIONAL on purpose. `useEmbeddedResourceContext()` throws when there is no\n  // resource-scoped host, which would make this component a NEW crash source for\n  // any host that is not resource-scoped — the opposite of the fix. With no host\n  // there is nothing to probe a target against, so filtering is simply skipped and\n  // the embeds below fail as they always did.\n  const embeddedContext = useOptionalCompositeResourceContext();\n  const hostResourceType = embeddedContext?.hostResourceType ?? '';\n\n  // One i18n scope for the host; each section title is resolved per child below\n  // from that child's own header label, which is what keeps this free of new keys.\n  const { tResourceHeader, isReady } = useI18n({\n    component: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n  });\n\n  // Drop targets this host cannot embed, rather than letting the first one take the\n  // whole surface down. A target being un-embeddable is a NORMAL authorable state —\n  // a resource may expose a core verb with no addressable HTTP variant (Wonder's\n  // recurring occurrences declare LIST as INTERNAL_CALL only, deliberately) — and\n  // the automatic container has always simply skipped such a child. The template\n  // path threw instead, so ONE bad target rendered an error surface in place of the\n  // entire page. Same shape as F7: one undisplayable child must not crash the parent.\n  //\n  // Skipped LOUDLY, not silently: the author named this target explicitly, so a\n  // silent drop would be the \"dark capability\" failure this migration exists to end.\n  const embeddable = useMemo(\n    () => normalized.filter((target) => {\n      if (!embeddedContext) {\n        return true;\n      }\n      const ok = embeddedContext.canBuildOperationContext({\n        resourceType: target.resourceType,\n        operationLike: target.operationLike ?? CoreResourceOperation.LIST,\n        relationshipFieldOverrides: target.viaForeignKey,\n      });\n      if (!ok) {\n        warnUnembeddableTarget(hostResourceType, target.resourceType);\n      }\n      return ok;\n    }),\n    [normalized, embeddedContext, hostResourceType],\n  );\n\n  const sections = useMemo(\n    () => embeddable.map((target) => ({\n      id: target.resourceType,\n      title: resolveResourceHeaderLabel({\n        tResourceHeader,\n        resourceType: target.resourceType,\n        key: 'title',\n      }),\n      content: (\n        // The host renders the visible heading for the region, so the embedded\n        // surface must not stack its own page chrome underneath it.\n        <SectionHostHeadingContext.Provider value={true}>\n          <EmbedRelatedResourceOperation\n            resourceType={target.resourceType}\n            operationLike={target.operationLike ?? CoreResourceOperation.LIST}\n            relationshipFieldOverrides={target.viaForeignKey}\n          />\n        </SectionHostHeadingContext.Provider>\n      ),\n    })),\n    [embeddable, tResourceHeader],\n  );\n\n  if (!isReady || sections.length === 0) return null;\n\n  return <ContentSectionContainer sections={sections} config={config} className={className} />;\n}\n"]}
+{"version":3,"file":"RelatedResourceSections.js","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/RelatedResourceSections.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { useMemo } from 'react';\n\nimport {\n  CoreResourceOperation,\n  Resources_SharedUtils,\n  getChildDirectionRelationships,\n  type ResourceConfiguration_ResourceRelationships,\n} from '@wildo-ai/saas-models';\nimport { FrontendComponentType, type SectionConfig } from '@wildo-ai/presets-components-models';\n\nimport { ContentSectionContainer } from '~wildo-frontend-lib/components/sections/ContentSectionContainer';\nimport { resolveResourceHeaderLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { SectionHostHeadingContext } from '~wildo-frontend-lib/components/resources/skeleton/SectionHostHeadingContext';\nimport { EmbedRelatedResourceOperation, type EmbedRelatedResourceEdgeSelector } from './ResourceEmbeds';\nimport { useClaimChildComposition } from './ComposedChildrenRegistry';\nimport { useOptionalCompositeResourceContext } from './useEmbeddedResourceContext';\nimport { useOptionalDisplayTemplateContext } from '~wildo-frontend-lib/components/data-display/DisplayTemplateContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * The standard child block — scoped to the children a view actually wants.\n *\n * ## Why this exists rather than \"compose it yourself\"\n *\n * Placing children in a template must not be harder than letting them compose\n * automatically, or authors will keep the automatic mode and the configuration\n * axis it needed. Doing it by hand means wiring `ContentSectionContainer`,\n * resolving each child's title through i18n, and threading the heading context —\n * three chances to get it subtly wrong, per surface.\n *\n * Worse, hand-wiring invites NAMED `<Section>`s, and a named section is a\n * THREE-PLACE obligation: the JSX name, the hand-authored `layout.refs.sections`\n * manifest, and a documented slot with `textSlots` in the resource specification.\n * Miss the third and `validateStructuralSlotDescriptions` THROWS at ESM import,\n * crash-looping the companion. This component takes each section's title from the\n * CHILD RESOURCE's own header label — the same source automatic composition uses\n * — so placing children adds no refs entry, no spec slot, and no new i18n key.\n *\n * ## What it means for composition ownership\n *\n * It renders through `EmbedRelatedResourceOperation`, so it registers placement:\n * a template using it owns the child region and the automatic block stands down.\n * That is the point — \"these children, in this order\" replaces \"all owned\n * children, minus a per-edge suppression flag on each one you did not want\".\n */\n/** @wildo_source:part:start saas.frontend.related-resource-sections facet:layer:frontend facet:family:component */\nexport interface RelatedResourceSectionTarget {\n  /** Child resource type. */\n  resourceType: string;\n  /** Disambiguates WHICH edge when the host has several to this target. */\n  viaForeignKey?: EmbedRelatedResourceEdgeSelector;\n  /** Defaults to LIST — the collection case. Use READ for a 1:1 child. */\n  operationLike?: CoreResourceOperation;\n}\n\nexport interface RelatedResourceSectionsProps {\n  /**\n   * Children to place, in render order. Order here replaces the old `orderIndex`.\n   *\n   * A target whose every edge from the host carries a relationship `discriminator` or `condition` the\n   * DISPLAYED row does not satisfy is omitted, silently, exactly as automatic composition omits it: a\n   * recurring todo's occurrences section appears only on a recurring todo. Inside a display template a\n   * constrained target waits for the row to load; with no display template there is no row to judge.\n   */\n  targets: ReadonlyArray<RelatedResourceSectionTarget | string>;\n  /** How the sections arrange — the real section vocabulary, not a serializable subset. */\n  config: SectionConfig;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.related-resource-sections */\n\n/**\n * Is a placed child ruled out by the HOST ROW itself — every edge from the host to it carrying a\n * relationship `discriminator` or `condition` the displayed row does not satisfy?\n *\n * The automatic composition (`ResourceLayout_ContainerNested`) has always asked this through\n * `isRelationshipActiveForParent`; a template placing the same child did not, so a discriminated\n * edge — Wonder Todos' recurring occurrences, which exist only for a RECURRING todo — rendered a tab\n * on every todo, and the backend refused its LIST for the ones it does not apply to (#1787). Same\n * predicate, same options, so the two composition paths cannot disagree about which children a row has.\n *\n * - `undefined` host row with no display template around the sections: nothing to judge, so no\n *   opinion — a composite view placing children keeps the behaviour it had.\n * - `undefined` host row INSIDE a template: the row is still loading, and a constrained edge stays out\n *   until it arrives (`onMissingParentResource: 'exclude'`), rather than flashing a tab it may retract.\n * - Conservative across edges: the child is ruled out only when EVERY edge to it is inactive. A target\n *   narrowed by `viaForeignKey` to one of several edges is not judged per edge, which would need the\n *   registry's field identifiers; no application has a discriminated edge beside a second one to the\n *   same child, and this errs toward showing rather than hiding.\n */\nfunction isPlacedChildInactiveForHostRow(params: {\n  hostResourceType: string;\n  hostRelationships: ResourceConfiguration_ResourceRelationships | undefined;\n  targetResourceType: string;\n  hostRecord: Record<string, unknown> | undefined;\n}): boolean {\n  if (!params.hostRelationships) {\n    return false;\n  }\n  const edges = getChildDirectionRelationships(params.hostRelationships).filter((relationship) => {\n    const childResourceType = relationship.resourceType1 === params.hostResourceType\n      ? relationship.resourceType2\n      : relationship.resourceType1;\n    return childResourceType === params.targetResourceType;\n  });\n  return edges.length > 0 && edges.every((relationship) => !Resources_SharedUtils.isRelationshipActiveForParent(\n    relationship,\n    params.hostRecord,\n    { onMissingParentResource: 'exclude', onConditionError: 'exclude' },\n  ));\n}\n\n/** One warning per (host, target) — a surface re-renders freely. */\nconst warnedUnembeddableTargets = new Set<string>();\n\nfunction warnUnembeddableTarget(hostResourceType: string, targetResourceType: string): void {\n  const key = `${hostResourceType}::${targetResourceType}`;\n  if (warnedUnembeddableTargets.has(key)) {\n    return;\n  }\n  warnedUnembeddableTargets.add(key);\n  LoggerFrontendService.getLogger().warn(\n    `[related-resource-sections] \"${targetResourceType}\" was placed on \"${hostResourceType}\" but cannot be `\n    + 'embedded here, so its section is omitted. The usual cause is that the target exposes no ADDRESSABLE '\n    + 'variant of the requested operation — a core verb declared REPOSITORY_ONLY or INTERNAL_CALL has no HTTP '\n    + 'surface to embed. Either give the target an addressable variant, point `operationLike` at one it does '\n    + 'expose, or stop placing it.',\n  );\n}\n\nexport function RelatedResourceSections({\n  targets,\n  config,\n  className,\n}: RelatedResourceSectionsProps): React.JSX.Element | null {\n  // Claim the region even when `targets` is empty: `targets={[]}` is how a\n  // surface says \"composes no children\", which is a different statement from a\n  // template that simply never mentioned them.\n  useClaimChildComposition();\n\n  const normalized = useMemo(\n    () => targets.map((t) => (typeof t === 'string' ? { resourceType: t } : t)),\n    [targets],\n  );\n\n  // OPTIONAL on purpose. `useEmbeddedResourceContext()` throws when there is no\n  // resource-scoped host, which would make this component a NEW crash source for\n  // any host that is not resource-scoped — the opposite of the fix. With no host\n  // there is nothing to probe a target against, so filtering is simply skipped and\n  // the embeds below fail as they always did.\n  const embeddedContext = useOptionalCompositeResourceContext();\n  const hostResourceType = embeddedContext?.hostResourceType ?? '';\n  const hostRelationships = embeddedContext?.hostResourceConfig?.resourceRelationships;\n  // The row this block sits under, when it sits inside a display template. See\n  // `isPlacedChildInactiveForHostRow` for why \"no template\" and \"still loading\" differ.\n  const displayTemplate = useOptionalDisplayTemplateContext();\n  const hostRecord = displayTemplate?.data;\n\n  // One i18n scope for the host; each section title is resolved per child below\n  // from that child's own header label, which is what keeps this free of new keys.\n  const { tResourceHeader, isReady } = useI18n({\n    component: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n  });\n\n  // Drop targets this host cannot embed, rather than letting the first one take the\n  // whole surface down. A target being un-embeddable is a NORMAL authorable state —\n  // a resource may expose a core verb with no addressable HTTP variant (Wonder's\n  // recurring occurrences declare LIST as INTERNAL_CALL only, deliberately) — and\n  // the automatic container has always simply skipped such a child. The template\n  // path threw instead, so ONE bad target rendered an error surface in place of the\n  // entire page. Same shape as F7: one undisplayable child must not crash the parent.\n  //\n  // Skipped LOUDLY, not silently: the author named this target explicitly, so a\n  // silent drop would be the \"dark capability\" failure this migration exists to end.\n  const embeddable = useMemo(\n    () => normalized.filter((target) => {\n      if (!embeddedContext) {\n        return true;\n      }\n      // A child the host ROW rules out is omitted SILENTLY: it is a declared condition doing its job,\n      // not a misplaced target, so it earns no warning.\n      if (displayTemplate && isPlacedChildInactiveForHostRow({\n        hostResourceType,\n        hostRelationships,\n        targetResourceType: target.resourceType,\n        hostRecord,\n      })) {\n        return false;\n      }\n      const ok = embeddedContext.canBuildOperationContext({\n        resourceType: target.resourceType,\n        operationLike: target.operationLike ?? CoreResourceOperation.LIST,\n        relationshipFieldOverrides: target.viaForeignKey,\n      });\n      if (!ok) {\n        warnUnembeddableTarget(hostResourceType, target.resourceType);\n      }\n      return ok;\n    }),\n    [normalized, embeddedContext, hostResourceType, hostRelationships, displayTemplate, hostRecord],\n  );\n\n  const sections = useMemo(\n    () => embeddable.map((target) => ({\n      id: target.resourceType,\n      title: resolveResourceHeaderLabel({\n        tResourceHeader,\n        resourceType: target.resourceType,\n        key: 'title',\n      }),\n      content: (\n        // The host renders the visible heading for the region, so the embedded\n        // surface must not stack its own page chrome underneath it.\n        <SectionHostHeadingContext.Provider value={true}>\n          <EmbedRelatedResourceOperation\n            resourceType={target.resourceType}\n            operationLike={target.operationLike ?? CoreResourceOperation.LIST}\n            relationshipFieldOverrides={target.viaForeignKey}\n          />\n        </SectionHostHeadingContext.Provider>\n      ),\n    })),\n    [embeddable, tResourceHeader],\n  );\n\n  if (!isReady || sections.length === 0) return null;\n\n  return <ContentSectionContainer sections={sections} config={config} className={className} />;\n}\n"]}

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

@@ -88,6 +88,28 @@ export interface EmbedRelatedResourceListProps {
  * place that code exists, so a shortcut can never drift from it.
  */
 export declare function EmbedRelatedResourceList({ resourceType, viaForeignKey, className, }: EmbedRelatedResourceListProps): React.JSX.Element;
+/** @wildo_source:part:start saas.frontend.linked-conversations-embed facet:layer:frontend facet:family:component facet:audience:app-developer */
+export interface EmbedLinkedConversationsProps {
+    className?: string;
+}
+/**
+ * The conversations linked to the host record (#1630) — email threads an inbound channel handler tied to this
+ * record with `ctx.thread.link`, newest first. Each opens to its messages in both directions, and an organization
+ * administrator can close it.
+ *
+ * Place it in a READ template or a record composite of the resource your threads are linked to. It is the
+ * `conversationThreads` LIST, pinned to this record through `pinnedFilters`: the reader cannot widen it to another
+ * record, and it shows only what the reader's own roles may read (organization members read their organization's
+ * conversations).
+ *
+ * @example
+ * // frontend/src/modules/<slug>/resources/matters/MatterReadCustomView.tsx
+ * <ResourceLayoutPreset_Read_Default {...props}>
+ *   <Section name="conversations"><EmbedLinkedConversations /></Section>
+ * </ResourceLayoutPreset_Read_Default>
+ */
+export declare function EmbedLinkedConversations({ className }: EmbedLinkedConversationsProps): React.JSX.Element;
+/** @wildo_source:part:end saas.frontend.linked-conversations-embed */
 export interface EmbedRelatedResourceSearchProps extends EmbedRelatedResourceListProps {
 }
 /**

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

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from 'react';
-import { CoreResourceOperation, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { CONVERSATION_THREAD_LINKED_RESOURCE_FILTER, CoreResourceOperation, CoreResourceType, ErrorCustomMessageReference, getChildDirectionRelationships, } from '@wildo-ai/saas-models';
+import { resolveRelationshipNestedReadSurface } from '../../../core/resources/relationship-surface-runtime.frontend.utils.js';
 // 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).
@@ -107,8 +108,51 @@ export function EmbedRelatedResourceOperation({ className, ...target }) {
     // 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 { navigationZone, navigationInitiator: hostNavigationInitiator } = useEmbeddedResourceHostContext();
     const compositeResourceContext = useEmbeddedResourceContext();
+    const { registry } = useResourceRegistry();
+    /*
+     * The EDGE this child sits on, carried on every navigation it starts — what the automatic composition
+     * (`ResourceLayout_ContainerNested`) already attaches as `sourceRelationship`.
+     *
+     * Without it a record opened from a TEMPLATE-placed relation never learnt its parent: the READ derives
+     * its parent reference from `sourceRelationship`, so the child's declared `inChildView` presentation
+     * could not apply. Wonder Todos declares a todo read inside its list as a linked BADGE back to the
+     * list; its list page places the todos through `RelatedResourceSections`, and the badge never
+     * appeared (#1945). Placing a child yourself must not cost the child its relationship.
+     *
+     * Resolved through `resolveRelationshipNestedReadSurface`, the same predicate the automatic
+     * composition uses, so the two paths cannot disagree about which edge a child sits on. An edge the
+     * target does not single out (no match, or several with no `viaForeignKey`) attaches nothing — the
+     * behaviour before this, rather than a guess.
+     */
+    const sourceRelationship = useMemo(() => {
+        const { hostResourceType, hostResourceId, hostResourceConfig } = compositeResourceContext;
+        if (!target.resourceType || target.resourceType === hostResourceType || !hostResourceConfig?.resourceRelationships) {
+            return undefined;
+        }
+        const selectedForeignKey = target.relationshipFieldOverrides?.[hostResourceType];
+        const edges = getChildDirectionRelationships(hostResourceConfig.resourceRelationships)
+            .map((relationship) => resolveRelationshipNestedReadSurface({ parentResourceType: hostResourceType, relationship, registry }))
+            .filter((edge) => edge !== undefined)
+            .filter((edge) => edge.childResourceType === target.resourceType)
+            .filter((edge) => selectedForeignKey === undefined || edge.foreignKeyField === selectedForeignKey);
+        if (edges.length !== 1)
+            return undefined;
+        const edge = edges[0];
+        return {
+            parentResourceType: hostResourceType,
+            parentResourceId: hostResourceId || undefined,
+            childResourceType: edge.childResourceType,
+            foreignKeyField: edge.foreignKeyField,
+            relationshipEdgeKey: edge.relationshipEdgeKey,
+            inChildView: edge.inChildView,
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed by the target's value, like the context below
+    }, [compositeResourceContext, registry, JSON.stringify(target)]);
+    const navigationInitiator = useMemo(() => (sourceRelationship
+        ? { ...(hostNavigationInitiator ?? { sourceZone: navigationZone }), sourceRelationship }
+        : hostNavigationInitiator), [hostNavigationInitiator, navigationZone, sourceRelationship]);
     const resourceContext = useMemo(() => {
         if (!target.resourceType) {
             throw buildResourceEmbedConfigurationError('EmbedRelatedResourceOperation() requires a target resourceType.', { target });
@@ -130,6 +174,45 @@ export function EmbedRelatedResourceOperation({ className, ...target }) {
 export function EmbedRelatedResourceList({ resourceType, viaForeignKey, className, }) {
     return (_jsx(EmbedRelatedResourceOperation, { resourceType: resourceType, operationLike: CoreResourceOperation.LIST, relationshipFieldOverrides: viaForeignKey, className: className }));
 }
+/**
+ * The conversations linked to the host record (#1630) — email threads an inbound channel handler tied to this
+ * record with `ctx.thread.link`, newest first. Each opens to its messages in both directions, and an organization
+ * administrator can close it.
+ *
+ * Place it in a READ template or a record composite of the resource your threads are linked to. It is the
+ * `conversationThreads` LIST, pinned to this record through `pinnedFilters`: the reader cannot widen it to another
+ * record, and it shows only what the reader's own roles may read (organization members read their organization's
+ * conversations).
+ *
+ * @example
+ * // frontend/src/modules/<slug>/resources/matters/MatterReadCustomView.tsx
+ * <ResourceLayoutPreset_Read_Default {...props}>
+ *   <Section name="conversations"><EmbedLinkedConversations /></Section>
+ * </ResourceLayoutPreset_Read_Default>
+ */
+export function EmbedLinkedConversations({ className }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const { hostResourceType, hostResourceId } = compositeResourceContext;
+    const resourceContext = useMemo(() => {
+        if (!hostResourceId) {
+            throw buildResourceEmbedConfigurationError('EmbedLinkedConversations() needs a host RECORD: place it on a READ surface, where the record it lists conversations for exists.', { hostResourceType });
+        }
+        const threads = compositeResourceContext.buildOperationContext({
+            resourceType: CoreResourceType.CONVERSATION_THREADS,
+            operationLike: CoreResourceOperation.LIST,
+            requireAddressable: false,
+        });
+        return {
+            ...threads,
+            pinnedFilters: {
+                [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
+                [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
+            },
+        };
+    }, [compositeResourceContext, hostResourceType, hostResourceId]);
+    return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
+}
 /**
  * Embed a related resource's SEARCH surface. Same delegation contract as
  * {@link EmbedRelatedResourceList} — only the semantic operation differs.

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceEmbeds.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":"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","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\n/**\n * @wildo_source:part:start saas.frontend.onboarding-view\n *\n * Places an onboarding document on a screen. Import from `@wildo-ai/saas-frontend-lib`.\n */\nexport interface EmbedOnboardingProps {\n  /** The document to show — list it on the module's `onboardingViews` too, or its progress is not saved. */\n  document: OnboardingViewProps['document'];\n  /** Label namespace override, when the document is rendered as part of a larger view. Usually omitted. */\n  viewRef?: string;\n  /** Save this document's progress under a registered guidance flow's ref instead of its own. Usually omitted. */\n  guidanceFlowRef?: string;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.onboarding-view */\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"]}
+{"version":3,"file":"ResourceEmbeds.js","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useMemo } from 'react';\n\nimport {\n  CONVERSATION_THREAD_LINKED_RESOURCE_FILTER,\n  CoreResourceOperation,\n  CoreResourceType,\n  ErrorCustomMessageReference,\n  getChildDirectionRelationships,\n  type ChartInputValues,\n} from '@wildo-ai/saas-models';\nimport { resolveRelationshipNestedReadSurface } from '~wildo-frontend-lib/core/resources/relationship-surface-runtime.frontend.utils';\nimport type { NavigationSourceRelationship } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\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\n/**\n * @wildo_source:part:start saas.frontend.onboarding-view\n *\n * Places an onboarding document on a screen. Import from `@wildo-ai/saas-frontend-lib`.\n */\nexport interface EmbedOnboardingProps {\n  /** The document to show — list it on the module's `onboardingViews` too, or its progress is not saved. */\n  document: OnboardingViewProps['document'];\n  /** Label namespace override, when the document is rendered as part of a larger view. Usually omitted. */\n  viewRef?: string;\n  /** Save this document's progress under a registered guidance flow's ref instead of its own. Usually omitted. */\n  guidanceFlowRef?: string;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.onboarding-view */\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: hostNavigationInitiator } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n  const { registry } = useResourceRegistry();\n\n  /*\n   * The EDGE this child sits on, carried on every navigation it starts — what the automatic composition\n   * (`ResourceLayout_ContainerNested`) already attaches as `sourceRelationship`.\n   *\n   * Without it a record opened from a TEMPLATE-placed relation never learnt its parent: the READ derives\n   * its parent reference from `sourceRelationship`, so the child's declared `inChildView` presentation\n   * could not apply. Wonder Todos declares a todo read inside its list as a linked BADGE back to the\n   * list; its list page places the todos through `RelatedResourceSections`, and the badge never\n   * appeared (#1945). Placing a child yourself must not cost the child its relationship.\n   *\n   * Resolved through `resolveRelationshipNestedReadSurface`, the same predicate the automatic\n   * composition uses, so the two paths cannot disagree about which edge a child sits on. An edge the\n   * target does not single out (no match, or several with no `viaForeignKey`) attaches nothing — the\n   * behaviour before this, rather than a guess.\n   */\n  const sourceRelationship = useMemo<NavigationSourceRelationship | undefined>(() => {\n    const { hostResourceType, hostResourceId, hostResourceConfig } = compositeResourceContext;\n    if (!target.resourceType || target.resourceType === hostResourceType || !hostResourceConfig?.resourceRelationships) {\n      return undefined;\n    }\n    const selectedForeignKey = target.relationshipFieldOverrides?.[hostResourceType];\n    const edges = getChildDirectionRelationships(hostResourceConfig.resourceRelationships)\n      .map((relationship) => resolveRelationshipNestedReadSurface({ parentResourceType: hostResourceType, relationship, registry }))\n      .filter((edge): edge is NonNullable<typeof edge> => edge !== undefined)\n      .filter((edge) => edge.childResourceType === target.resourceType)\n      .filter((edge) => selectedForeignKey === undefined || edge.foreignKeyField === selectedForeignKey);\n    if (edges.length !== 1) return undefined;\n    const edge = edges[0]!;\n    return {\n      parentResourceType: hostResourceType,\n      parentResourceId: hostResourceId || undefined,\n      childResourceType: edge.childResourceType,\n      foreignKeyField: edge.foreignKeyField,\n      relationshipEdgeKey: edge.relationshipEdgeKey,\n      inChildView: edge.inChildView,\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed by the target's value, like the context below\n  }, [compositeResourceContext, registry, JSON.stringify(target)]);\n  const navigationInitiator = useMemo(\n    () => (sourceRelationship\n      ? { ...(hostNavigationInitiator ?? { sourceZone: navigationZone }), sourceRelationship }\n      : hostNavigationInitiator),\n    [hostNavigationInitiator, navigationZone, sourceRelationship],\n  );\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\n/** @wildo_source:part:start saas.frontend.linked-conversations-embed facet:layer:frontend facet:family:component facet:audience:app-developer */\nexport interface EmbedLinkedConversationsProps {\n  className?: string;\n}\n\n/**\n * The conversations linked to the host record (#1630) — email threads an inbound channel handler tied to this\n * record with `ctx.thread.link`, newest first. Each opens to its messages in both directions, and an organization\n * administrator can close it.\n *\n * Place it in a READ template or a record composite of the resource your threads are linked to. It is the\n * `conversationThreads` LIST, pinned to this record through `pinnedFilters`: the reader cannot widen it to another\n * record, and it shows only what the reader's own roles may read (organization members read their organization's\n * conversations).\n *\n * @example\n * // frontend/src/modules/<slug>/resources/matters/MatterReadCustomView.tsx\n * <ResourceLayoutPreset_Read_Default {...props}>\n *   <Section name=\"conversations\"><EmbedLinkedConversations /></Section>\n * </ResourceLayoutPreset_Read_Default>\n */\nexport function EmbedLinkedConversations({ className }: EmbedLinkedConversationsProps): React.JSX.Element {\n  const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();\n  const compositeResourceContext = useEmbeddedResourceContext();\n  const { hostResourceType, hostResourceId } = compositeResourceContext;\n\n  const resourceContext = useMemo((): FrontendResourceOperationContext => {\n    if (!hostResourceId) {\n      throw buildResourceEmbedConfigurationError(\n        'EmbedLinkedConversations() needs a host RECORD: place it on a READ surface, where the record it lists conversations for exists.',\n        { hostResourceType },\n      );\n    }\n    const threads = compositeResourceContext.buildOperationContext({\n      resourceType: CoreResourceType.CONVERSATION_THREADS,\n      operationLike: CoreResourceOperation.LIST,\n      requireAddressable: false,\n    });\n    return {\n      ...threads,\n      pinnedFilters: {\n        [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,\n        [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,\n      },\n    };\n  }, [compositeResourceContext, hostResourceType, hostResourceId]);\n\n  return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);\n}\n/** @wildo_source:part:end saas.frontend.linked-conversations-embed */\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.map

@@ -1 +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"}
+{"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.map

@@ -1 +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"]}
+{"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.map

@@ -1 +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"}
+{"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"}