npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.6 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2742) hide show

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

@@ -50,14 +50,14 @@ 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,
     });
     const [items, setItems] = useState([]);
     const [totalCount, setTotalCount] = useState(0);
     const [isLoading, setIsLoading] = useState(true);
-    const [error, setError] = useState(null);
+    const [loadFailed, setLoadFailed] = useState(false);
     const doOperationRef = useRef(doOperation);
     doOperationRef.current = doOperation;
     const limit = inlineLimit;
@@ -74,7 +74,7 @@ export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showV
         let cancelled = false;
         const fetchPreview = async () => {
             setIsLoading(true);
-            setError(null);
+            setLoadFailed(false);
             const childConfig = registry.resourceConfigurations[childResourceType];
             const contextualParameters = FrontendResourceUtils.buildContextualParameters(childContext.contextResourceIdentifiers, registry);
             const listOperation = childContext.operation
@@ -108,7 +108,7 @@ export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showV
             }
             catch {
                 if (!cancelled)
-                    setError('Failed to load preview');
+                    setLoadFailed(true);
             }
             finally {
                 if (!cancelled)
@@ -122,8 +122,8 @@ export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showV
     if (isLoading) {
         return (_jsx("div", { className: "flex items-center justify-center py-card-sm", children: _jsx(LoadingSpinner, { size: 20, className: "text-muted-foreground" }) }));
     }
-    if (error) {
-        return _jsx("p", { className: "text-sm text-destructive", children: error });
+    if (loadFailed) {
+        return _jsx("p", { className: "text-sm text-destructive", children: tComponent(FrontendComponentType.RESOURCES_LAYOUTS_CONTAINER_NESTED, 'previewLoadFailed') });
     }
     if (!isReady)
         return null;
@@ -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 CHANGED Viewed

	@@ -1 +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 [error, setError] = useState<string \| null>(null);\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 setError(null);\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) setError('Failed to load preview');\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 (error) {\n return <p className=\"text-sm text-destructive\">{error}</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"]}
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 { 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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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~~"}
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,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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"]}
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 {\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 CHANGED Viewed

@@ -21,12 +21,21 @@ export interface EmbedChartProps extends EmbeddedSurfaceProps {
     height?: string | number;
 }
 export declare function EmbedChart({ resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, className, height, }: EmbedChartProps): React.JSX.Element;
+/**
+ * @wildo_source:part:start saas.frontend.onboarding-view
+ *
+ * Places an onboarding document on a screen. Import from `@wildo-ai/saas-frontend-lib`.
+ */
 export interface EmbedOnboardingProps {
+    /** The document to show — list it on the module's `onboardingViews` too, or its progress is not saved. */
     document: OnboardingViewProps['document'];
+    /** Label namespace override, when the document is rendered as part of a larger view. Usually omitted. */
     viewRef?: string;
+    /** Save this document's progress under a registered guidance flow's ref instead of its own. Usually omitted. */
     guidanceFlowRef?: string;
     className?: string;
 }
+/** @wildo_source:part:end saas.frontend.onboarding-view */
 export declare function EmbedOnboarding({ document, viewRef, guidanceFlowRef, className, }: EmbedOnboardingProps): React.JSX.Element;
 export declare function EmbedComposite({ viewRef, className, }: EmbeddedSurfaceProps): React.JSX.Element;
 export interface EmbedExecutionProps extends EmbeddedSurfaceProps {
@@ -79,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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ResourceEmbeds.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,~~EAGL~~,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;~~AAC~~/B,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAOtH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAmB/G,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,uCAAuC,EAC7C,MAAM,8BAA8B,CAAC;AAMtC,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAoDD,wBAAgB,UAAU,CAAC,EACzB,YAAY,EACZ,OAAO,EACP,0BAA0B,EAC1B,MAAM,EACN,cAAc,EACd,SAAS,EACT,MAAM,GACP,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiBrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;~~AAED~~,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,OAAO,EACP,eAAe,EACf,SAAS,GACV,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAU1C;AAED,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,SAAS,GACV,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAyB1C;AAED,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAkCD,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,0BAA0B,EAC1B,SAAS,GACV,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAYzC;AAiED,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,gCAAgC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,+BAA+B,GAAG,+BAA+B,GACzE,uCAAuC,GACvC;IACA,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEJ,iHAAiH;AACjH,MAAM,MAAM,kCAAkC,GAAG,uCAAuC,GACpF;IACA,YAAY,EAAE,MAAM,CAAC;IACrB,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;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACJ,mEAAmE;AAEnE,wBAAgB,sBAAsB,CAAC,EACrC,eAAe,EACf,SAAS,GACV,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CASjD;AAED,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,GAAG,MAAM,EACV,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqBrD;AAED,MAAM,MAAM,mCAAmC,GAAG,IAAI,CAAC,kCAAkC,EAAE,WAAW,CAAC,CAAC;AAExG,wBAAgB,6BAA6B,CAAC,EAC5C,SAAS,EACT,GAAG,MAAM,EACV,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,~~CA6BxD~~;AAED,iHAAiH;AACjH;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,6BAA6B;IAC5C,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,gCAAgC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,YAAY,EACZ,aAAa,EACb,SAAS,GACV,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CASnD;AAED,MAAM,WAAW,+BAAgC,SAAQ,6BAA6B;CAAG;AAEzF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,YAAY,EACZ,aAAa,EACb,SAAS,GACV,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CASrD;AACD,mEAAmE;AAEnE,MAAM,WAAW,uBAAwB,SAAQ,+BAA+B;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA2B,SAAQ,+BAA+B;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,+BAA+B;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,+BAA+B;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,GAAG,MAAM,EACV,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0BzC;AAED,wBAAgB,iBAAiB,CAAC,EAChC,YAAY,EACZ,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,GAAG,MAAM,EACV,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoC5C;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,SAAS,EACT,GAAG,MAAM,EACV,EAAE,uBAAuB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6B7C;AAED,wBAAgB,qBAAqB,CAAC,EACpC,YAAY,EACZ,OAAO,EACP,SAAS,EACT,GAAG,MAAM,EACV,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4BhD"}
1	+ {"version":3,"file":"ResourceEmbeds.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ResourceEmbeds.tsx"],"names":[],"mappings":"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"}

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

@@ -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).
@@ -49,6 +50,7 @@ export function EmbedChart({ resourceType, viewRef, contextResourceIdentifiers,
             ...(contextResourceIdentifiers ?? {}),
         }, inputs: inputs, urlParamValues: urlParamValues, className: className, height: height }));
 }
+/** @wildo_source:part:end saas.frontend.onboarding-view */
 export function EmbedOnboarding({ document, viewRef, guidanceFlowRef, className, }) {
     return (_jsx("div", { className: className, children: _jsx(OnboardingView, { document: document, viewRef: viewRef, guidanceFlowRef: guidanceFlowRef }) }));
 }
@@ -106,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 });
@@ -129,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.