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

package/dist/esm/components/resources/collection-create-placement.utils.js

@@ -0,0 +1,37 @@
+/**
+ * Where a collection offers "create" — the toolbar, or the empty state — decided in ONE place.
+ *
+ * One create, one place. While the collection is genuinely EMPTY and its empty state offers the
+ * first-item action, that call to action IS the create affordance: a toolbar button beside it was the
+ * same verb twice, often under two labels ("Add draft" above, "Add note" below — measured on Wonder
+ * Todos). A NARROWED listing — an inline search, or any active filter such as a status tab or a preset
+ * pill — is not empty: it matched nothing. It shows the "no matching items" message rather than the
+ * empty state (whose "none yet" would be false), and the toolbar keeps its button.
+ */
+/**
+ * Whether one filter value narrows the listing. Unset shapes — `undefined`, `null`, `''`, an empty array,
+ * an empty object — narrow nothing; anything else (a scalar, a picked set, a preset's relative range)
+ * does.
+ */
+export function isActiveFilterValue(value) {
+    if (value === undefined || value === null || value === '')
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'object')
+        return Object.keys(value).length > 0;
+    return true;
+}
+/** Whether the listing is narrowed by a search or by any active filter. */
+export function isCollectionNarrowed(args) {
+    return args.isSearchActive || Object.values(args.filterValues).some(isActiveFilterValue);
+}
+/**
+ * Whether the TOOLBAR shows the create action. `false` exactly when the empty state renders and visibly
+ * offers it; `hasLoadedOnce` keeps the button from blinking out during the initial fetch.
+ */
+export function toolbarOffersCreate(args) {
+    const emptyStateOwnsCreate = args.hasLoadedOnce && args.itemCount === 0 && !args.isNarrowed && args.emptyStateOffersCreate;
+    return !emptyStateOwnsCreate;
+}
+//# sourceMappingURL=collection-create-placement.utils.js.map

package/dist/esm/components/resources/collection-create-placement.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-create-placement.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/collection-create-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,IAAwE;IAC3G,OAAO,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,sBAAsB,CAAC;IAC3H,OAAO,CAAC,oBAAoB,CAAC;AAC/B,CAAC","sourcesContent":["/**\n * Where a collection offers \"create\" — the toolbar, or the empty state — decided in ONE place.\n *\n * One create, one place. While the collection is genuinely EMPTY and its empty state offers the\n * first-item action, that call to action IS the create affordance: a toolbar button beside it was the\n * same verb twice, often under two labels (\"Add draft\" above, \"Add note\" below — measured on Wonder\n * Todos). A NARROWED listing — an inline search, or any active filter such as a status tab or a preset\n * pill — is not empty: it matched nothing. It shows the \"no matching items\" message rather than the\n * empty state (whose \"none yet\" would be false), and the toolbar keeps its button.\n */\n\n/**\n * Whether one filter value narrows the listing. Unset shapes — `undefined`, `null`, `''`, an empty array,\n * an empty object — narrow nothing; anything else (a scalar, a picked set, a preset's relative range)\n * does.\n */\nexport function isActiveFilterValue(value: unknown): boolean {\n  if (value === undefined || value === null || value === '') return false;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') return Object.keys(value as Record<string, unknown>).length > 0;\n  return true;\n}\n\n/** Whether the listing is narrowed by a search or by any active filter. */\nexport function isCollectionNarrowed(args: { isSearchActive: boolean; filterValues: Record<string, unknown> }): boolean {\n  return args.isSearchActive || Object.values(args.filterValues).some(isActiveFilterValue);\n}\n\n/**\n * Whether the TOOLBAR shows the create action. `false` exactly when the empty state renders and visibly\n * offers it; `hasLoadedOnce` keeps the button from blinking out during the initial fetch.\n */\nexport function toolbarOffersCreate(args: {\n  hasLoadedOnce: boolean;\n  itemCount: number;\n  isNarrowed: boolean;\n  emptyStateOffersCreate: boolean;\n}): boolean {\n  const emptyStateOwnsCreate = args.hasLoadedOnce && args.itemCount === 0 && !args.isNarrowed && args.emptyStateOffersCreate;\n  return !emptyStateOwnsCreate;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"RelatedResourcePreview.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourcePreview.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAA+C,MAAM,OAAO,CAAC;AASpE,OAAO,EAAE,qBAAqB,EAAyB,MAAM,4DAA4D,CAAC;AAa1H,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,kCAAkC;IACjD,4EAA4E;IAC5E,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;IAClF,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,eAAe,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,SAAS,GACV,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAwK/D;AAED,kHAAkH;AAClH,MAAM,WAAW,2BAA2B;IAC1C,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,aAAa,CAAC,EAAE,gCAAgC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,oEAAoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,YAAY,EACZ,KAAK,EACL,eAAsB,EACtB,aAAa,EACb,SAAS,GACV,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAwCxD"}
+{"version":3,"file":"RelatedResourcePreview.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourcePreview.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAA+C,MAAM,OAAO,CAAC;AASpE,OAAO,EAAE,qBAAqB,EAAyB,MAAM,4DAA4D,CAAC;AAa1H,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,kCAAkC;IACjD,4EAA4E;IAC5E,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;IAClF,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,eAAe,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,SAAS,GACV,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA4K/D;AAED,kHAAkH;AAClH,MAAM,WAAW,2BAA2B;IAC1C,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,aAAa,CAAC,EAAE,gCAAgC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,oEAAoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,YAAY,EACZ,KAAK,EACL,eAAsB,EACtB,aAAa,EACb,SAAS,GACV,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAwCxD"}

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

@@ -50,7 +50,7 @@ import { useRegisterComposedChild } from './ComposedChildrenRegistry.js';
  */
 export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showViewAllLink, childResourceType, onViewAll, }) {
     const { registry, doOperation } = useResourceRegistry();
-    const { tComponent, isReady } = useI18n({
+    const { t: tChildLabel, formatDate, formatDateTime, tComponent, isReady } = useI18n({
         component: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,
         resource: childContext.resourceType,
     });
@@ -159,10 +159,14 @@ export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showV
     });
     return (_jsxs("div", { className: "space-y-xs", children: [_jsx("ul", { className: "space-y-xs", children: items.map((item, idx) => {
                     const id = item._id ?? item.id ?? idx;
+                    /* The translator reaches the label callback, as in every other caller (see ResourceListItemRenderer). */
                     const label = FrontendResourceUtils.computeFrontendResourceLabel({
                         resourceType: childResourceType,
                         registry,
                         currentObject: item,
+                        t: tChildLabel,
+                        formatDate,
+                        formatDateTime,
                     }) ?? String(id);
                     return (_jsx("li", { className: "text-sm px-sm py-xs rounded-radius border border-border bg-card", children: label }, id));
                 }) }), showViewAllLink && hasMore && (_jsx(Button, { variant: ButtonVariants_Variant.LINK, size: ButtonSize.SM, className: "px-0", onClick: onViewAll, children: viewAllLabel }))] }));

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

@@ -1 +1 @@
-{"version":3,"file":"RelatedResourcePreview.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourcePreview.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\n/**\n * A compact PREVIEW of a related collection — a few rows plus a \"view all\" link,\n * instead of the full list surface with its toolbar, filters and pagination.\n *\n * ## Why this is its own component rather than a mode on the embed\n *\n * A preview and an embedded LIST are different things: one summarises, the other\n * is the collection. Folding them into one component behind a `limit` prop is how\n * the configuration surface this migration removes got started — a single knob\n * that quietly changes what a thing IS rather than how it looks.\n *\n * ## It was unreachable before this\n *\n * The behaviour below is moved verbatim out of the automatic children container,\n * where it was selected by an `inParentView.inlineLimit` config key that NOTHING\n * in the repository authored — measured 2026-08-20, zero occurrences across the\n * engine presets and every example app, while a sibling key in the same files was\n * authored four times. So this is a second dark capability in the same component\n * as the one that motivated this workstream: real, working, and reachable by no\n * one. Exposing it as a component a template can place is what makes it usable.\n */\n\nimport React, { useEffect, useMemo, useRef, useState } from 'react';\n\nimport { CoreResourceOperation, ResourcesConfig_OperationPathUtils, type Resources_PaginatedResult } from '@wildo-ai/saas-models';\nimport { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';\n\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { isListOperationAddressableForChildContext } from './child-operation-addressability.utils';\nimport { CoreResourceOperation as CoreOp } from '@wildo-ai/saas-models';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { NavigationContentType } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { useEmbeddedResourceHostContext } from './EmbeddedResourceHostContext';\nimport { useEmbeddedResourceContext } from './useEmbeddedResourceContext';\nimport { useRegisterComposedChild } from './ComposedChildrenRegistry';\nimport { type EmbedRelatedResourceEdgeSelector } from './ResourceEmbeds';\n\nexport interface RelatedResourcePreviewSurfaceProps {\n  /** Resolved child context (target resource + parent-scoped identifiers). */\n  childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>;\n  /** Rows to show. `0` renders only the \"view all\" affordance. */\n  inlineLimit: number;\n  /** Whether to offer the \"view all\" link when more rows exist. */\n  showViewAllLink: boolean;\n  /** Child resource type, used to compute each row's display label. */\n  childResourceType: string;\n  /** Invoked when the reader asks for the full collection. */\n  onViewAll: () => void;\n}\n\n/**\n * Lightweight inline preview for 1:N / N:N children when `inlineLimit` is set.\n *\n * Fetches `limit` items via the child's LIST operation, renders them as a\n * compact vertical list of resource display names, and optionally shows a\n * \"View all (N total)\" link that navigates to the full list.\n *\n * This avoids mounting the full `ResourceLayout_List` (with search, sort,\n * filter, pagination) when the relationship is configured for a quick preview.\n */\nexport function RelatedResourcePreviewSurface({\n  childContext,\n  inlineLimit,\n  showViewAllLink,\n  childResourceType,\n  onViewAll,\n}: RelatedResourcePreviewSurfaceProps): React.JSX.Element | null {\n  const { registry, doOperation } = useResourceRegistry();\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n    resource: childContext.resourceType,\n  });\n  const [items, setItems] = useState<Record<string, unknown>[]>([]);\n  const [totalCount, setTotalCount] = useState(0);\n  const [isLoading, setIsLoading] = useState(true);\n  const [loadFailed, setLoadFailed] = useState(false);\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const limit = inlineLimit;\n\n  // Stable key for the child context — prevents re-fetches when the parent\n  // re-renders and `deriveChildResourceContext` returns a new object ref\n  // with identical content.\n  const contextIdKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(childContext.contextResourceIdentifiers),\n    [childContext.contextResourceIdentifiers],\n  );\n\n  useEffect(() => {\n    // inlineLimit: 0 means \"show no items, just the View All link\"\n    if (limit === 0) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n\n    const fetchPreview = async () => {\n      setIsLoading(true);\n      setLoadFailed(false);\n\n      const childConfig = registry.resourceConfigurations[childResourceType];\n      const contextualParameters = FrontendResourceUtils.buildContextualParameters(childContext.contextResourceIdentifiers, registry);\n      const listOperation = childContext.operation\n        && resolveEffectiveCoreOperationFromOperation(childContext.operation) === CoreResourceOperation.LIST\n        ? childContext.operation\n        : childConfig\n        ? pickPreferredOperationForCoreSemantic(\n          (childConfig.operations ?? []).filter((candidate) =>\n            isListOperationAddressableForChildContext(\n              candidate,\n              childContext,\n              contextualParameters,\n            )\n          ),\n          CoreResourceOperation.LIST,\n        )\n        : undefined;\n      if (!listOperation) {\n        setIsLoading(false);\n        return;\n      }\n\n      const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(listOperation);\n\n      try {\n        const result = await doOperationRef.current(operationPathKey, {\n          contextualParameters,\n          queryParameters: { page: 1, limit },\n          parentResourcesRequirements: childContext.parentResourcesRequirements,\n        });\n\n        if (cancelled) return;\n\n        if (result && typeof result === 'object' && 'data' in result && 'pagination' in result) {\n          const paginated = result as Resources_PaginatedResult<Record<string, unknown>>;\n          setItems(paginated.data);\n          setTotalCount(paginated.pagination.total);\n        } else if (Array.isArray(result)) {\n          setItems(result);\n          setTotalCount(result.length);\n        }\n      } catch {\n        if (!cancelled) setLoadFailed(true);\n      } finally {\n        if (!cancelled) setIsLoading(false);\n      }\n    };\n\n    fetchPreview();\n    return () => { cancelled = true; };\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [childResourceType, limit, registry, contextIdKey]);\n\n  if (isLoading) {\n    return (\n      <div className=\"flex items-center justify-center py-card-sm\">\n        <LoadingSpinner size={20} className=\"text-muted-foreground\" />\n      </div>\n    );\n  }\n\n  if (loadFailed) {\n    return <p className=\"text-sm text-destructive\">{tComponent(FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED, 'previewLoadFailed')}</p>;\n  }\n\n  if (!isReady) return null;\n\n  // inlineLimit: 0 → skip items, render only the \"View all\" quick-link\n  if (limit === 0) {\n    if (!showViewAllLink) return null;\n    const viewAllLabel = resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n      key: 'viewAll',\n    });\n    return (\n      <Button variant={ButtonVariants_Variant.LINK} size={ButtonSize.SM} className=\"px-0\" onClick={onViewAll}>\n        {viewAllLabel}\n      </Button>\n    );\n  }\n\n  if (items.length === 0) {\n    const emptyStateLabel = resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n      key: 'emptyState',\n    });\n    return <p className=\"text-sm text-muted-foreground\">{emptyStateLabel}</p>;\n  }\n\n  const hasMore = totalCount > limit;\n  // `viewAllWithCount` rather than `viewAll` + a hardcoded \" (N)\": the count has\n  // to sit INSIDE the translated string, because languages disagree on where a\n  // number goes and how it is bracketed. The count-free `viewAll` is used by the\n  // `limit === 0` branch above, where no total has been fetched.\n  const viewAllLabel = resolveComponentLabel({\n    tComponent,\n    componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n    key: 'viewAllWithCount',\n    params: { total: totalCount },\n  });\n\n  return (\n    <div className=\"space-y-xs\">\n      <ul className=\"space-y-xs\">\n        {items.map((item, idx) => {\n          const id = (item as any)._id ?? (item as any).id ?? idx;\n          const label = FrontendResourceUtils.computeFrontendResourceLabel({\n            resourceType: childResourceType,\n            registry,\n            currentObject: item,\n          }) ?? String(id);\n          return (\n            <li key={id} className=\"text-sm px-sm py-xs rounded-radius border border-border bg-card\">\n              {label}\n            </li>\n          );\n        })}\n      </ul>\n      {showViewAllLink && hasMore && (\n        <Button\n          variant={ButtonVariants_Variant.LINK}\n          size={ButtonSize.SM}\n          className=\"px-0\"\n          onClick={onViewAll}\n        >\n          {viewAllLabel}\n        </Button>\n      )}\n    </div>\n  );\n}\n\n/** @wildo_source:part:start saas.frontend.related-resource-preview facet:layer:frontend facet:family:component */\nexport interface RelatedResourcePreviewProps {\n  /** Child resource type to preview. */\n  resourceType: string;\n  /** Rows to show. `0` renders only the \"view all\" affordance. */\n  limit: number;\n  /** Offer a \"view all\" link when more rows exist. Defaults to `true`. */\n  showViewAllLink?: boolean;\n  /** Disambiguates WHICH edge when the host has several to this target. */\n  viaForeignKey?: EmbedRelatedResourceEdgeSelector;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.related-resource-preview */\n\n/**\n * Template-facing preview: a few rows of a related collection plus a \"view all\".\n *\n * ## Why this wrapper has to exist\n *\n * The preview behaviour was previously reachable ONLY through the automatic\n * container, selected by an `inParentView.inlineLimit` key that nothing in the\n * repository ever authored — one of the two dark capabilities that motivated this\n * whole migration. Deleting that config without giving the preview a door a\n * template can open would make it dark a THIRD time, this time by our own hand.\n *\n * It derives the child context from the HOST, exactly as the operation embed does,\n * so an author never passes an id — the record DTO exposes `_id`, never the\n * context key, so an id-taking API would be unusable from a display template.\n *\n * It registers placement, so using it makes the template own the child region.\n */\nexport function RelatedResourcePreview({\n  resourceType,\n  limit,\n  showViewAllLink = true,\n  viaForeignKey,\n  className,\n}: RelatedResourcePreviewProps): React.JSX.Element | null {\n  useRegisterComposedChild(resourceType);\n  const { buildOperationContext } = useEmbeddedResourceContext();\n  const { navigationZone } = useEmbeddedResourceHostContext();\n  const { navigate } = useNavigationController();\n\n  const childContext = useMemo(\n    () => buildOperationContext({\n      resourceType,\n      operationLike: CoreOp.LIST,\n      relationshipFieldOverrides: viaForeignKey,\n    }),\n    // Keyed by VALUE, not by the fresh-every-render selector object identity —\n    // rebuilding the context each render clones resource configs and re-fires the\n    // effects keyed on its identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [buildOperationContext, resourceType, JSON.stringify(viaForeignKey ?? null)],\n  );\n\n  return (\n    <div className={className}>\n      <RelatedResourcePreviewSurface\n        childContext={childContext as never}\n        inlineLimit={limit}\n        showViewAllLink={showViewAllLink}\n        childResourceType={resourceType}\n        // Same navigation shape the automatic container uses for its own\n        // \"view all\": route to the child's LIST as a resource-operation content,\n        // carrying the host's zone as the initiator so the target lands where the\n        // reader expects rather than replacing the record they came from.\n        onViewAll={() => navigate({\n          content: {\n            contentType: NavigationContentType.RESOURCE_OPERATION,\n            resourceContext: childContext,\n          },\n          initiator: { sourceZone: navigationZone },\n        } as never)}\n      />\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"RelatedResourcePreview.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourcePreview.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\n/**\n * A compact PREVIEW of a related collection — a few rows plus a \"view all\" link,\n * instead of the full list surface with its toolbar, filters and pagination.\n *\n * ## Why this is its own component rather than a mode on the embed\n *\n * A preview and an embedded LIST are different things: one summarises, the other\n * is the collection. Folding them into one component behind a `limit` prop is how\n * the configuration surface this migration removes got started — a single knob\n * that quietly changes what a thing IS rather than how it looks.\n *\n * ## It was unreachable before this\n *\n * The behaviour below is moved verbatim out of the automatic children container,\n * where it was selected by an `inParentView.inlineLimit` config key that NOTHING\n * in the repository authored — measured 2026-08-20, zero occurrences across the\n * engine presets and every example app, while a sibling key in the same files was\n * authored four times. So this is a second dark capability in the same component\n * as the one that motivated this workstream: real, working, and reachable by no\n * one. Exposing it as a component a template can place is what makes it usable.\n */\n\nimport React, { useEffect, useMemo, useRef, useState } from 'react';\n\nimport { CoreResourceOperation, ResourcesConfig_OperationPathUtils, type Resources_PaginatedResult } from '@wildo-ai/saas-models';\nimport { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';\n\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport {\n  pickPreferredOperationForCoreSemantic,\n  resolveEffectiveCoreOperationFromOperation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { isListOperationAddressableForChildContext } from './child-operation-addressability.utils';\nimport { CoreResourceOperation as CoreOp } from '@wildo-ai/saas-models';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { NavigationContentType } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { useEmbeddedResourceHostContext } from './EmbeddedResourceHostContext';\nimport { useEmbeddedResourceContext } from './useEmbeddedResourceContext';\nimport { useRegisterComposedChild } from './ComposedChildrenRegistry';\nimport { type EmbedRelatedResourceEdgeSelector } from './ResourceEmbeds';\n\nexport interface RelatedResourcePreviewSurfaceProps {\n  /** Resolved child context (target resource + parent-scoped identifiers). */\n  childContext: ReturnType<typeof frontendResourceUtils.deriveChildResourceContext>;\n  /** Rows to show. `0` renders only the \"view all\" affordance. */\n  inlineLimit: number;\n  /** Whether to offer the \"view all\" link when more rows exist. */\n  showViewAllLink: boolean;\n  /** Child resource type, used to compute each row's display label. */\n  childResourceType: string;\n  /** Invoked when the reader asks for the full collection. */\n  onViewAll: () => void;\n}\n\n/**\n * Lightweight inline preview for 1:N / N:N children when `inlineLimit` is set.\n *\n * Fetches `limit` items via the child's LIST operation, renders them as a\n * compact vertical list of resource display names, and optionally shows a\n * \"View all (N total)\" link that navigates to the full list.\n *\n * This avoids mounting the full `ResourceLayout_List` (with search, sort,\n * filter, pagination) when the relationship is configured for a quick preview.\n */\nexport function RelatedResourcePreviewSurface({\n  childContext,\n  inlineLimit,\n  showViewAllLink,\n  childResourceType,\n  onViewAll,\n}: RelatedResourcePreviewSurfaceProps): React.JSX.Element | null {\n  const { registry, doOperation } = useResourceRegistry();\n  const { t: tChildLabel, formatDate, formatDateTime, tComponent, isReady } = useI18n({\n    component: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n    resource: childContext.resourceType,\n  });\n  const [items, setItems] = useState<Record<string, unknown>[]>([]);\n  const [totalCount, setTotalCount] = useState(0);\n  const [isLoading, setIsLoading] = useState(true);\n  const [loadFailed, setLoadFailed] = useState(false);\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const limit = inlineLimit;\n\n  // Stable key for the child context — prevents re-fetches when the parent\n  // re-renders and `deriveChildResourceContext` returns a new object ref\n  // with identical content.\n  const contextIdKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(childContext.contextResourceIdentifiers),\n    [childContext.contextResourceIdentifiers],\n  );\n\n  useEffect(() => {\n    // inlineLimit: 0 means \"show no items, just the View All link\"\n    if (limit === 0) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n\n    const fetchPreview = async () => {\n      setIsLoading(true);\n      setLoadFailed(false);\n\n      const childConfig = registry.resourceConfigurations[childResourceType];\n      const contextualParameters = FrontendResourceUtils.buildContextualParameters(childContext.contextResourceIdentifiers, registry);\n      const listOperation = childContext.operation\n        && resolveEffectiveCoreOperationFromOperation(childContext.operation) === CoreResourceOperation.LIST\n        ? childContext.operation\n        : childConfig\n        ? pickPreferredOperationForCoreSemantic(\n          (childConfig.operations ?? []).filter((candidate) =>\n            isListOperationAddressableForChildContext(\n              candidate,\n              childContext,\n              contextualParameters,\n            )\n          ),\n          CoreResourceOperation.LIST,\n        )\n        : undefined;\n      if (!listOperation) {\n        setIsLoading(false);\n        return;\n      }\n\n      const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(listOperation);\n\n      try {\n        const result = await doOperationRef.current(operationPathKey, {\n          contextualParameters,\n          queryParameters: { page: 1, limit },\n          parentResourcesRequirements: childContext.parentResourcesRequirements,\n        });\n\n        if (cancelled) return;\n\n        if (result && typeof result === 'object' && 'data' in result && 'pagination' in result) {\n          const paginated = result as Resources_PaginatedResult<Record<string, unknown>>;\n          setItems(paginated.data);\n          setTotalCount(paginated.pagination.total);\n        } else if (Array.isArray(result)) {\n          setItems(result);\n          setTotalCount(result.length);\n        }\n      } catch {\n        if (!cancelled) setLoadFailed(true);\n      } finally {\n        if (!cancelled) setIsLoading(false);\n      }\n    };\n\n    fetchPreview();\n    return () => { cancelled = true; };\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [childResourceType, limit, registry, contextIdKey]);\n\n  if (isLoading) {\n    return (\n      <div className=\"flex items-center justify-center py-card-sm\">\n        <LoadingSpinner size={20} className=\"text-muted-foreground\" />\n      </div>\n    );\n  }\n\n  if (loadFailed) {\n    return <p className=\"text-sm text-destructive\">{tComponent(FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED, 'previewLoadFailed')}</p>;\n  }\n\n  if (!isReady) return null;\n\n  // inlineLimit: 0 → skip items, render only the \"View all\" quick-link\n  if (limit === 0) {\n    if (!showViewAllLink) return null;\n    const viewAllLabel = resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n      key: 'viewAll',\n    });\n    return (\n      <Button variant={ButtonVariants_Variant.LINK} size={ButtonSize.SM} className=\"px-0\" onClick={onViewAll}>\n        {viewAllLabel}\n      </Button>\n    );\n  }\n\n  if (items.length === 0) {\n    const emptyStateLabel = resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n      key: 'emptyState',\n    });\n    return <p className=\"text-sm text-muted-foreground\">{emptyStateLabel}</p>;\n  }\n\n  const hasMore = totalCount > limit;\n  // `viewAllWithCount` rather than `viewAll` + a hardcoded \" (N)\": the count has\n  // to sit INSIDE the translated string, because languages disagree on where a\n  // number goes and how it is bracketed. The count-free `viewAll` is used by the\n  // `limit === 0` branch above, where no total has been fetched.\n  const viewAllLabel = resolveComponentLabel({\n    tComponent,\n    componentType: FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED,\n    key: 'viewAllWithCount',\n    params: { total: totalCount },\n  });\n\n  return (\n    <div className=\"space-y-xs\">\n      <ul className=\"space-y-xs\">\n        {items.map((item, idx) => {\n          const id = (item as any)._id ?? (item as any).id ?? idx;\n          /* The translator reaches the label callback, as in every other caller (see ResourceListItemRenderer). */\n          const label = FrontendResourceUtils.computeFrontendResourceLabel({\n            resourceType: childResourceType,\n            registry,\n            currentObject: item,\n            t: tChildLabel,\n            formatDate,\n            formatDateTime,\n          }) ?? String(id);\n          return (\n            <li key={id} className=\"text-sm px-sm py-xs rounded-radius border border-border bg-card\">\n              {label}\n            </li>\n          );\n        })}\n      </ul>\n      {showViewAllLink && hasMore && (\n        <Button\n          variant={ButtonVariants_Variant.LINK}\n          size={ButtonSize.SM}\n          className=\"px-0\"\n          onClick={onViewAll}\n        >\n          {viewAllLabel}\n        </Button>\n      )}\n    </div>\n  );\n}\n\n/** @wildo_source:part:start saas.frontend.related-resource-preview facet:layer:frontend facet:family:component */\nexport interface RelatedResourcePreviewProps {\n  /** Child resource type to preview. */\n  resourceType: string;\n  /** Rows to show. `0` renders only the \"view all\" affordance. */\n  limit: number;\n  /** Offer a \"view all\" link when more rows exist. Defaults to `true`. */\n  showViewAllLink?: boolean;\n  /** Disambiguates WHICH edge when the host has several to this target. */\n  viaForeignKey?: EmbedRelatedResourceEdgeSelector;\n  className?: string;\n}\n/** @wildo_source:part:end saas.frontend.related-resource-preview */\n\n/**\n * Template-facing preview: a few rows of a related collection plus a \"view all\".\n *\n * ## Why this wrapper has to exist\n *\n * The preview behaviour was previously reachable ONLY through the automatic\n * container, selected by an `inParentView.inlineLimit` key that nothing in the\n * repository ever authored — one of the two dark capabilities that motivated this\n * whole migration. Deleting that config without giving the preview a door a\n * template can open would make it dark a THIRD time, this time by our own hand.\n *\n * It derives the child context from the HOST, exactly as the operation embed does,\n * so an author never passes an id — the record DTO exposes `_id`, never the\n * context key, so an id-taking API would be unusable from a display template.\n *\n * It registers placement, so using it makes the template own the child region.\n */\nexport function RelatedResourcePreview({\n  resourceType,\n  limit,\n  showViewAllLink = true,\n  viaForeignKey,\n  className,\n}: RelatedResourcePreviewProps): React.JSX.Element | null {\n  useRegisterComposedChild(resourceType);\n  const { buildOperationContext } = useEmbeddedResourceContext();\n  const { navigationZone } = useEmbeddedResourceHostContext();\n  const { navigate } = useNavigationController();\n\n  const childContext = useMemo(\n    () => buildOperationContext({\n      resourceType,\n      operationLike: CoreOp.LIST,\n      relationshipFieldOverrides: viaForeignKey,\n    }),\n    // Keyed by VALUE, not by the fresh-every-render selector object identity —\n    // rebuilding the context each render clones resource configs and re-fires the\n    // effects keyed on its identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [buildOperationContext, resourceType, JSON.stringify(viaForeignKey ?? null)],\n  );\n\n  return (\n    <div className={className}>\n      <RelatedResourcePreviewSurface\n        childContext={childContext as never}\n        inlineLimit={limit}\n        showViewAllLink={showViewAllLink}\n        childResourceType={resourceType}\n        // Same navigation shape the automatic container uses for its own\n        // \"view all\": route to the child's LIST as a resource-operation content,\n        // carrying the host's zone as the initiator so the target lands where the\n        // reader expects rather than replacing the record they came from.\n        onViewAll={() => navigate({\n          content: {\n            contentType: NavigationContentType.RESOURCE_OPERATION,\n            resourceContext: childContext,\n          },\n          initiator: { sourceZone: navigationZone },\n        } as never)}\n      />\n    </div>\n  );\n}\n"]}

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

@@ -38,7 +38,14 @@ export interface RelatedResourceSectionTarget {
     operationLike?: CoreResourceOperation;
 }
 export interface RelatedResourceSectionsProps {
-    /** Children to place, in render order. Order here replaces the old `orderIndex`. */
+    /**
+     * Children to place, in render order. Order here replaces the old `orderIndex`.
+     *
+     * A target whose every edge from the host carries a relationship `discriminator` or `condition` the
+     * DISPLAYED row does not satisfy is omitted, silently, exactly as automatic composition omits it: a
+     * recurring todo's occurrences section appears only on a recurring todo. Inside a display template a
+     * constrained target waits for the row to load; with no display template there is no row to judge.
+     */
     targets: ReadonlyArray<RelatedResourceSectionTarget | string>;
     /** How the sections arrange — the real section vocabulary, not a serializable subset. */
     config: SectionConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"RelatedResourceSections.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourceSections.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAMhG,OAAO,EAAiC,KAAK,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAKxG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,mHAAmH;AACnH,MAAM,WAAW,4BAA4B;IAC3C,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,gCAAgC,CAAC;IACjD,wEAAwE;IACxE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,oFAAoF;IACpF,OAAO,EAAE,aAAa,CAAC,4BAA4B,GAAG,MAAM,CAAC,CAAC;IAC9D,yFAAyF;IACzF,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqBD,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE,4BAA4B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+EzD"}
+{"version":3,"file":"RelatedResourceSections.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourceSections.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EACL,qBAAqB,EAItB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAMhG,OAAO,EAAiC,KAAK,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAMxG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,mHAAmH;AACnH,MAAM,WAAW,4BAA4B;IAC3C,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,gCAAgC,CAAC;IACjD,wEAAwE;IACxE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;OAOG;IACH,OAAO,EAAE,aAAa,CAAC,4BAA4B,GAAG,MAAM,CAAC,CAAC;IAC9D,yFAAyF;IACzF,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8DD,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE,4BAA4B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA8FzD"}

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.