@wildo-ai/saas-frontend-lib 1.1.10 → 1.1.11

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

@@ -62,7 +62,8 @@ export interface EmbeddedResourceDescentBoundaryProps {
     /**
      * Identity of the descent about to be taken, as `(edge, host row)`. Callers
      * compose it — the automatic container from the relationship edge key plus the
-     * parent row id, an explicit embed from its target resource plus the host id.
+     * parent row id, an explicit embed from its target resource plus the record it addresses — or, for a
+     * collection or a CREATE, the scope it lists or creates into (`embeddedResourceDescentKey`).
      */
     descentKey: string;
     /** Per-edge override of {@link DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH}. */

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

@@ -1 +1 @@
-{"version":3,"file":"EmbeddedResourceDescent.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/EmbeddedResourceDescent.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAIlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,mHAAmH;AACnH,0GAA0G;AAC1G,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9B;AAQD,wBAAgB,0BAA0B,IAAI,4BAA4B,CAEzE;AAoBD,mHAAmH;AACnH,MAAM,WAAW,oCAAoC;IACnD;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AACD,qEAAqE;AAErE;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAA8C,EAC9C,QAAQ,GACT,EAAE,oCAAoC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAuBjE"}
+{"version":3,"file":"EmbeddedResourceDescent.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/EmbeddedResourceDescent.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAIlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,mHAAmH;AACnH,0GAA0G;AAC1G,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9B;AAQD,wBAAgB,0BAA0B,IAAI,4BAA4B,CAEzE;AAoBD,mHAAmH;AACnH,MAAM,WAAW,oCAAoC;IACnD;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AACD,qEAAqE;AAErE;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAA8C,EAC9C,QAAQ,GACT,EAAE,oCAAoC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAuBjE"}

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

@@ -1 +1 @@
-{"version":3,"file":"EmbeddedResourceDescent.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/EmbeddedResourceDescent.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,mHAAmH;AACnH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AAQrD,qEAAqE;AAErE,MAAM,aAAa,GAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,EAAU,CAAC,CAAC;AAC5E,MAAM,IAAI,GAAiC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAE/F,MAAM,8BAA8B,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAEzF,MAAM,UAAU,0BAA0B;IACxC,OAAO,UAAU,CAAC,8BAA8B,CAAC,CAAC;AACpD,CAAC;AAED,uEAAuE;AACvE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC,SAAS,WAAW,CAAC,UAAkB,EAAE,MAAyB,EAAE,KAAa,EAAE,QAAgB;IACjG,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;QAClD,OAAO;IACT,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9C,qBAAqB,CAAC,SAAS,EAAE,CAAC,IAAI,CACpC,MAAM,KAAK,OAAO;QAChB,CAAC,CAAC,iDAAiD,UAAU,wCAAwC;cACjG,iFAAiF;QACrF,CAAC,CAAC,uDAAuD,UAAU,8BAA8B;cAC7F,GAAG,KAAK,iBAAiB,QAAQ,oEAAoE;cACrG,gGAAgG,CACvG,CAAC;AACJ,CAAC;AAcD,qEAAqE;AAErE;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAAQ,GAAG,mCAAmC,EAC9C,QAAQ,GAC6B;IACrC,MAAM,MAAM,GAAG,0BAA0B,EAAE,CAAC;IAE5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE1C,MAAM,KAAK,GAAG,OAAO,CAA+B,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IAE5C,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,KAAC,8BAA8B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAClD,QAAQ,GAC+B,CAC3C,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useMemo } from 'react';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * Bounds how deep embedded resource surfaces may nest, and refuses true cycles.\n *\n * ## Why this exists at all\n *\n * Before template-owned composition, nesting was bounded only by ACCIDENT: a 1:N\n * child rendered as a LIST (which mounts no nested container) and a 1:1 child\n * rendered through the field displayer rather than a full READ surface, so\n * neither re-entered. Nothing chose that bound — it fell out of which component\n * happened to render a child.\n *\n * Template-owned composition removes the accident: an authored template may embed\n * a child with `operationLike: READ`, which mounts a full READ surface, which\n * composes ITS children, and so on. On a self-referencing edge (`Category →\n * Category`, already rendered today — `getChildDirectionRelationships` returns\n * `[...childRelationships, ...selfRelationships]`) or a mutually recursive pair,\n * that does not terminate.\n *\n * ## Why BOTH mechanisms, when either sounds sufficient\n *\n * They bound different things, and neither substitutes for the other:\n *\n * - the **depth cap** bounds hierarchy BREADTH — a legitimately deep, entirely\n *   acyclic chain (organization → unit → team → member → …) that simply should\n *   not render as one page;\n * - the **visited set** catches a genuine revisit EXACTLY, at the moment it\n *   happens, instead of letting a cycle burn `maxDepth` levels first. Those\n *   wasted levels are not free: each mounts a surface and fires a real LIST\n *   request.\n *\n * ## The key is `(edge, host row)` — not the edge alone\n *\n * Keying on the relationship edge alone would break the very feature this\n * protects. A self-referencing hierarchy traverses the SAME edge at every level\n * with DIFFERENT rows, so an edge-only set stops it at depth 1 and reports a\n * cycle that does not exist. Keyed on the edge AND the host row, a repeat means\n * the same record has been reached again by some path — which is a cycle, and\n * nothing else is.\n *\n * ## At the limit: render nothing\n *\n * Deliberate product decision. The trade accepted is that the boundary is\n * invisible to the reader — and for a 1:1 the omitted block IS the content\n * rather than a truncated list. The mitigation adds no UI: a dev-time warning\n * naming the edge and the depth reached, so an author sees the boundary during\n * development while the product stays silent. Same posture as the container's\n * existing \"authored section renders nothing\" warning.\n */\n\n/** @wildo_source:part:start saas.frontend.embedded-resource-descent facet:layer:frontend facet:family:component */\n/** Framework default. Overridable per edge; see {@link EmbeddedResourceDescentBoundaryProps.maxDepth}. */\nexport const DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH = 3;\n\nexport interface EmbeddedResourceDescentValue {\n  /** How many embedded surfaces deep the current subtree already is. Root is 0. */\n  depth: number;\n  /** `${edgeKey}::${hostRowId}` for every descent already taken on this path. */\n  visited: ReadonlySet<string>;\n}\n/** @wildo_source:part:end saas.frontend.embedded-resource-descent */\n\nconst EMPTY_VISITED: ReadonlySet<string> = Object.freeze(new Set<string>());\nconst ROOT: EmbeddedResourceDescentValue = Object.freeze({ depth: 0, visited: EMPTY_VISITED });\n\nconst EmbeddedResourceDescentContext = createContext<EmbeddedResourceDescentValue>(ROOT);\n\nexport function useEmbeddedResourceDescent(): EmbeddedResourceDescentValue {\n  return useContext(EmbeddedResourceDescentContext);\n}\n\n/** Dedup guard so one refused edge warns once, not once per render. */\nconst warnedRefusals = new Set<string>();\n\nfunction warnRefusal(descentKey: string, reason: 'depth' | 'cycle', depth: number, maxDepth: number): void {\n  if (warnedRefusals.has(`${descentKey}:${reason}`)) {\n    return;\n  }\n  warnedRefusals.add(`${descentKey}:${reason}`);\n  LoggerFrontendService.getLogger().warn(\n    reason === 'cycle'\n      ? `[embedded-resource-descent] CYCLE refused at \"${descentKey}\": this record was already reached on `\n        + 'this path, so rendering it again would not terminate. Nothing is rendered here.'\n      : `[embedded-resource-descent] DEPTH LIMIT refused at \"${descentKey}\": embedded nesting reached `\n        + `${depth} of a maximum ${maxDepth}. Nothing is rendered here. Raise the per-edge limit only if this `\n        + 'hierarchy genuinely belongs on one page — otherwise link to the child instead of embedding it.',\n  );\n}\n\n/** @wildo_source:part:start saas.frontend.embedded-resource-descent facet:layer:frontend facet:family:component */\nexport interface EmbeddedResourceDescentBoundaryProps {\n  /**\n   * Identity of the descent about to be taken, as `(edge, host row)`. Callers\n   * compose it — the automatic container from the relationship edge key plus the\n   * parent row id, an explicit embed from its target resource plus the host id.\n   */\n  descentKey: string;\n  /** Per-edge override of {@link DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH}. */\n  maxDepth?: number;\n  children: React.ReactNode;\n}\n/** @wildo_source:part:end saas.frontend.embedded-resource-descent */\n\n/**\n * Admits or refuses one level of embedded descent, and provides the incremented\n * state to whatever it admits. Refusal renders nothing.\n *\n * Deciding and providing are one component on purpose: a caller that could ask\n * \"may I?\" without also registering the descent would let the next level down\n * believe it is shallower than it is, which is the failure mode a hand-applied\n * counter always eventually has.\n */\nexport function EmbeddedResourceDescentBoundary({\n  descentKey,\n  maxDepth = DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH,\n  children,\n}: EmbeddedResourceDescentBoundaryProps): React.JSX.Element | null {\n  const parent = useEmbeddedResourceDescent();\n\n  const isCycle = parent.visited.has(descentKey);\n  const nextDepth = parent.depth + 1;\n  const exceedsDepth = nextDepth > maxDepth;\n\n  const value = useMemo<EmbeddedResourceDescentValue>(() => {\n    const visited = new Set(parent.visited);\n    visited.add(descentKey);\n    return { depth: nextDepth, visited };\n  }, [parent.visited, descentKey, nextDepth]);\n\n  if (isCycle || exceedsDepth) {\n    warnRefusal(descentKey, isCycle ? 'cycle' : 'depth', nextDepth, maxDepth);\n    return null;\n  }\n\n  return (\n    <EmbeddedResourceDescentContext.Provider value={value}>\n      {children}\n    </EmbeddedResourceDescentContext.Provider>\n  );\n}\n"]}
+{"version":3,"file":"EmbeddedResourceDescent.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/EmbeddedResourceDescent.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,mHAAmH;AACnH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AAQrD,qEAAqE;AAErE,MAAM,aAAa,GAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,EAAU,CAAC,CAAC;AAC5E,MAAM,IAAI,GAAiC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAE/F,MAAM,8BAA8B,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAEzF,MAAM,UAAU,0BAA0B;IACxC,OAAO,UAAU,CAAC,8BAA8B,CAAC,CAAC;AACpD,CAAC;AAED,uEAAuE;AACvE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC,SAAS,WAAW,CAAC,UAAkB,EAAE,MAAyB,EAAE,KAAa,EAAE,QAAgB;IACjG,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;QAClD,OAAO;IACT,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9C,qBAAqB,CAAC,SAAS,EAAE,CAAC,IAAI,CACpC,MAAM,KAAK,OAAO;QAChB,CAAC,CAAC,iDAAiD,UAAU,wCAAwC;cACjG,iFAAiF;QACrF,CAAC,CAAC,uDAAuD,UAAU,8BAA8B;cAC7F,GAAG,KAAK,iBAAiB,QAAQ,oEAAoE;cACrG,gGAAgG,CACvG,CAAC;AACJ,CAAC;AAeD,qEAAqE;AAErE;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAAQ,GAAG,mCAAmC,EAC9C,QAAQ,GAC6B;IACrC,MAAM,MAAM,GAAG,0BAA0B,EAAE,CAAC;IAE5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE1C,MAAM,KAAK,GAAG,OAAO,CAA+B,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IAE5C,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,KAAC,8BAA8B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAClD,QAAQ,GAC+B,CAC3C,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useMemo } from 'react';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * Bounds how deep embedded resource surfaces may nest, and refuses true cycles.\n *\n * ## Why this exists at all\n *\n * Before template-owned composition, nesting was bounded only by ACCIDENT: a 1:N\n * child rendered as a LIST (which mounts no nested container) and a 1:1 child\n * rendered through the field displayer rather than a full READ surface, so\n * neither re-entered. Nothing chose that bound — it fell out of which component\n * happened to render a child.\n *\n * Template-owned composition removes the accident: an authored template may embed\n * a child with `operationLike: READ`, which mounts a full READ surface, which\n * composes ITS children, and so on. On a self-referencing edge (`Category →\n * Category`, already rendered today — `getChildDirectionRelationships` returns\n * `[...childRelationships, ...selfRelationships]`) or a mutually recursive pair,\n * that does not terminate.\n *\n * ## Why BOTH mechanisms, when either sounds sufficient\n *\n * They bound different things, and neither substitutes for the other:\n *\n * - the **depth cap** bounds hierarchy BREADTH — a legitimately deep, entirely\n *   acyclic chain (organization → unit → team → member → …) that simply should\n *   not render as one page;\n * - the **visited set** catches a genuine revisit EXACTLY, at the moment it\n *   happens, instead of letting a cycle burn `maxDepth` levels first. Those\n *   wasted levels are not free: each mounts a surface and fires a real LIST\n *   request.\n *\n * ## The key is `(edge, host row)` — not the edge alone\n *\n * Keying on the relationship edge alone would break the very feature this\n * protects. A self-referencing hierarchy traverses the SAME edge at every level\n * with DIFFERENT rows, so an edge-only set stops it at depth 1 and reports a\n * cycle that does not exist. Keyed on the edge AND the host row, a repeat means\n * the same record has been reached again by some path — which is a cycle, and\n * nothing else is.\n *\n * ## At the limit: render nothing\n *\n * Deliberate product decision. The trade accepted is that the boundary is\n * invisible to the reader — and for a 1:1 the omitted block IS the content\n * rather than a truncated list. The mitigation adds no UI: a dev-time warning\n * naming the edge and the depth reached, so an author sees the boundary during\n * development while the product stays silent. Same posture as the container's\n * existing \"authored section renders nothing\" warning.\n */\n\n/** @wildo_source:part:start saas.frontend.embedded-resource-descent facet:layer:frontend facet:family:component */\n/** Framework default. Overridable per edge; see {@link EmbeddedResourceDescentBoundaryProps.maxDepth}. */\nexport const DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH = 3;\n\nexport interface EmbeddedResourceDescentValue {\n  /** How many embedded surfaces deep the current subtree already is. Root is 0. */\n  depth: number;\n  /** `${edgeKey}::${hostRowId}` for every descent already taken on this path. */\n  visited: ReadonlySet<string>;\n}\n/** @wildo_source:part:end saas.frontend.embedded-resource-descent */\n\nconst EMPTY_VISITED: ReadonlySet<string> = Object.freeze(new Set<string>());\nconst ROOT: EmbeddedResourceDescentValue = Object.freeze({ depth: 0, visited: EMPTY_VISITED });\n\nconst EmbeddedResourceDescentContext = createContext<EmbeddedResourceDescentValue>(ROOT);\n\nexport function useEmbeddedResourceDescent(): EmbeddedResourceDescentValue {\n  return useContext(EmbeddedResourceDescentContext);\n}\n\n/** Dedup guard so one refused edge warns once, not once per render. */\nconst warnedRefusals = new Set<string>();\n\nfunction warnRefusal(descentKey: string, reason: 'depth' | 'cycle', depth: number, maxDepth: number): void {\n  if (warnedRefusals.has(`${descentKey}:${reason}`)) {\n    return;\n  }\n  warnedRefusals.add(`${descentKey}:${reason}`);\n  LoggerFrontendService.getLogger().warn(\n    reason === 'cycle'\n      ? `[embedded-resource-descent] CYCLE refused at \"${descentKey}\": this record was already reached on `\n        + 'this path, so rendering it again would not terminate. Nothing is rendered here.'\n      : `[embedded-resource-descent] DEPTH LIMIT refused at \"${descentKey}\": embedded nesting reached `\n        + `${depth} of a maximum ${maxDepth}. Nothing is rendered here. Raise the per-edge limit only if this `\n        + 'hierarchy genuinely belongs on one page — otherwise link to the child instead of embedding it.',\n  );\n}\n\n/** @wildo_source:part:start saas.frontend.embedded-resource-descent facet:layer:frontend facet:family:component */\nexport interface EmbeddedResourceDescentBoundaryProps {\n  /**\n   * Identity of the descent about to be taken, as `(edge, host row)`. Callers\n   * compose it — the automatic container from the relationship edge key plus the\n   * parent row id, an explicit embed from its target resource plus the record it addresses — or, for a\n   * collection or a CREATE, the scope it lists or creates into (`embeddedResourceDescentKey`).\n   */\n  descentKey: string;\n  /** Per-edge override of {@link DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH}. */\n  maxDepth?: number;\n  children: React.ReactNode;\n}\n/** @wildo_source:part:end saas.frontend.embedded-resource-descent */\n\n/**\n * Admits or refuses one level of embedded descent, and provides the incremented\n * state to whatever it admits. Refusal renders nothing.\n *\n * Deciding and providing are one component on purpose: a caller that could ask\n * \"may I?\" without also registering the descent would let the next level down\n * believe it is shallower than it is, which is the failure mode a hand-applied\n * counter always eventually has.\n */\nexport function EmbeddedResourceDescentBoundary({\n  descentKey,\n  maxDepth = DEFAULT_MAX_EMBEDDED_RESOURCE_DEPTH,\n  children,\n}: EmbeddedResourceDescentBoundaryProps): React.JSX.Element | null {\n  const parent = useEmbeddedResourceDescent();\n\n  const isCycle = parent.visited.has(descentKey);\n  const nextDepth = parent.depth + 1;\n  const exceedsDepth = nextDepth > maxDepth;\n\n  const value = useMemo<EmbeddedResourceDescentValue>(() => {\n    const visited = new Set(parent.visited);\n    visited.add(descentKey);\n    return { depth: nextDepth, visited };\n  }, [parent.visited, descentKey, nextDepth]);\n\n  if (isCycle || exceedsDepth) {\n    warnRefusal(descentKey, isCycle ? 'cycle' : 'depth', nextDepth, maxDepth);\n    return null;\n  }\n\n  return (\n    <EmbeddedResourceDescentContext.Provider value={value}>\n      {children}\n    </EmbeddedResourceDescentContext.Provider>\n  );\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"EmbeddedResourceHostContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/EmbeddedResourceHostContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAEzH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,mEAAmE;IACnE,cAAc,EAAE,cAAc,CAAC;IAC/B,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAID,MAAM,WAAW,iCAAkC,SAAQ,gCAAgC;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,QAAQ,GACT,EAAE,iCAAiC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmBvD;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,gCAAgC,CASjF;AAED,wBAAgB,sCAAsC,IAAI,gCAAgC,GAAG,IAAI,CAEhG"}
+{"version":3,"file":"EmbeddedResourceHostContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/EmbeddedResourceHostContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAEzH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,mEAAmE;IACnE,cAAc,EAAE,cAAc,CAAC;IAC/B,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAID,MAAM,WAAW,iCAAkC,SAAQ,gCAAgC;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,QAAQ,GACT,EAAE,iCAAiC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmBvD;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,gCAAgC,CASjF;AAED,wBAAgB,sCAAsC,IAAI,gCAAgC,GAAG,IAAI,CAEhG"}

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

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

@@ -1,5 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
+import { COLLECTION_SURFACE_ATTRIBUTE } from '../../../components/resources/skeleton/DisplayLayout.js';
 import { useMemo } from 'react';
 import { CoreResourceOperation, Resources_SharedUtils, getChildDirectionRelationships, } from '@wildo-ai/saas-models';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
@@ -127,8 +128,19 @@ export function RelatedResourceSections({ targets, config, className, }) {
         // surface must not stack its own page chrome underneath it.
         _jsx(SectionHostHeadingContext.Provider, { value: true, children: _jsx(EmbedRelatedResourceOperation, { resourceType: target.resourceType, operationLike: target.operationLike ?? CoreResourceOperation.LIST, relationshipFieldOverrides: target.viaForeignKey }) })),
     })), [embeddable, tResourceHeader]);
-    if (!isReady || sections.length === 0)
+    if (sections.length === 0)
         return null;
-    return _jsx(ContentSectionContainer, { sections: sections, config: config, className: className });
+    /*
+     * A block of related COLLECTIONS is a collection surface itself, so a record body holding it takes the page's width
+     * (`DisplayLayout`'s derived width). Marked here rather than only inside each list: from the first paint (the lists
+     * render once their labels load), and whichever tab is open, so switching to a tab that holds no list cannot flip
+     * the width of the page around it.
+     */
+    const holdsCollection = embeddable.some((target) => {
+        const operationLike = target.operationLike ?? CoreResourceOperation.LIST;
+        return operationLike === CoreResourceOperation.LIST || operationLike === CoreResourceOperation.SEARCH;
+    });
+    const container = isReady ? _jsx(ContentSectionContainer, { sections: sections, config: config, className: className }) : null;
+    return holdsCollection ? _jsx("div", { [COLLECTION_SURFACE_ATTRIBUTE]: true, children: container }) : container;
 }
 //# sourceMappingURL=RelatedResourceSections.js.map

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 {\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"]}
+{"version":3,"file":"RelatedResourceSections.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/RelatedResourceSections.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { COLLECTION_SURFACE_ATTRIBUTE } from '~wildo-frontend-lib/components/resources/skeleton/DisplayLayout';\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 (sections.length === 0) return null;\n\n  /*\n   * A block of related COLLECTIONS is a collection surface itself, so a record body holding it takes the page's width\n   * (`DisplayLayout`'s derived width). Marked here rather than only inside each list: from the first paint (the lists\n   * render once their labels load), and whichever tab is open, so switching to a tab that holds no list cannot flip\n   * the width of the page around it.\n   */\n  const holdsCollection = embeddable.some((target) => {\n    const operationLike = target.operationLike ?? CoreResourceOperation.LIST;\n    return operationLike === CoreResourceOperation.LIST || operationLike === CoreResourceOperation.SEARCH;\n  });\n  const container = isReady ? <ContentSectionContainer sections={sections} config={config} className={className} /> : null;\n  return holdsCollection ? <div {...{ [COLLECTION_SURFACE_ATTRIBUTE]: true }}>{container}</div> : container;\n}\n"]}

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

@@ -42,6 +42,17 @@ export interface EmbedExecutionProps extends EmbeddedSurfaceProps {
     contextResourceIdentifiers?: Record<string, string>;
 }
 export declare function EmbedExecution({ viewRef, contextResourceIdentifiers, className, }: EmbedExecutionProps): React.JSX.Element;
+/**
+ * The identity of one embedded descent: the target resource and the ROW it is about — the record an operation
+ * addresses (`getAddressedRecordId`), or, for a collection or a CREATE, the scope it lists or creates into.
+ *
+ * It used to read the type slot whatever the operation. A collection's type slot holds at most ambient scope, so
+ * a host-own LIST embedded in that host's READ (composite → READ t-1 → LIST of tasks) took the READ's own key and
+ * was refused as a CYCLE, rendering nothing (round-17 review). Keying every collection as "no row" instead would
+ * make two lists of different scopes collide, so the collection's scope is its row: its identifiers without the
+ * own-type slot, which on a collection is ambient.
+ */
+export declare function embeddedResourceDescentKey(resourceContext: FrontendResourceOperationContext): string;
 export interface EmbedResourceOperationProps {
     resourceContext: FrontendResourceOperationContext;
     className?: string;
@@ -109,7 +120,56 @@ export interface EmbedLinkedConversationsProps {
  * </ResourceLayoutPreset_Read_Default>
  */
 export declare function EmbedLinkedConversations({ className }: EmbedLinkedConversationsProps): React.JSX.Element;
-/** @wildo_source:part:end saas.frontend.linked-conversations-embed */
+export interface EmbedExecutionDecisionsProps {
+    /**
+     * The run's `executionId`, its business id. Not the row's `_id`: a decision records the run it paused by the id the
+     * runtime knows it by (`executionRef`), which is the business one.
+     */
+    executionId: string;
+    className?: string;
+}
+/**
+ * The decisions a conversational run raised and how each was answered (#2528): who decided, what they decided, what
+ * they changed and why — the scope's agent-work decisions LIST, pinned to this run through `pinnedFilters`, so the
+ * reader cannot widen it to another run, and it shows only what their roles may read (the scope's administrator).
+ *
+ * Place it on the READ surface of a `flowActorExecutions` variant; the decisions store follows the run's variant.
+ */
+export declare function EmbedExecutionDecisions({ executionId, className }: EmbedExecutionDecisionsProps): React.JSX.Element;
+/**
+ * May this viewer run the LIST of `resourceType` from the host record (#2589)? The roles the LIST declares, asked the way
+ * the shell asks of any operation it offers (`viewerMayPerformOperation`). For a host that draws a titled section around
+ * an embed: a section whose list the viewer may not read is not drawn at all, rather than as an empty heading or an
+ * error. Presentation only: the backend still decides every request.
+ */
+export declare function useViewerMayListRelatedResource(resourceType: string): boolean;
+export interface EmbedRepresentationTeamProps {
+    /** The client relationship's id, as the representing organization holds it: the `organizationRepresentations` row. */
+    organizationRepresentationId: string;
+    className?: string;
+}
+/**
+ * The team serving one client relationship (#2589): the `representativeAssignments` LIST, pinned to that relationship
+ * through `pinnedFilters`, with its assign and unassign verbs. Assigning from here names the relationship by itself: the
+ * embed's context carries the host relationship, and the assign form fills `organizationRepresentationId` from it
+ * (`resolveSemanticContextFieldValues`, pinned against the real configuration by
+ * `representation-team-assign-prefill.test.ts`); its member picker searches the organization's own members. Shown to the organization's administrators only, the roles the LIST admits; a member
+ * reading the client does not see the team.
+ */
+export declare function EmbedRepresentationTeam({ organizationRepresentationId, className }: EmbedRepresentationTeamProps): React.JSX.Element | null;
+export interface EmbedRepresentationMailboxesProps {
+    /**
+     * The relationship's id, as the representation mirrors it (`organizationRelationshipId`): a mailbox names the
+     * relationship, not the representing organization's row of it.
+     */
+    organizationRelationshipId: string;
+    className?: string;
+}
+/**
+ * The mailboxes of one client relationship (#2589): the `relationshipMailboxes` LIST, pinned to that relationship
+ * through `pinnedFilters`. Shown to a viewer the LIST admits.
+ */
+export declare function EmbedRepresentationMailboxes({ organizationRelationshipId, className }: EmbedRepresentationMailboxesProps): React.JSX.Element | null;
 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":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/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;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,0GAA0G;IAC1G,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1C,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gHAAgH;IAChH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,2DAA2D;AAE3D,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,CA2ExD;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,iJAAiJ;AACjJ,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,SAAS,EAAE,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BxG;AACD,sEAAsE;AAEtE,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"}
+{"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,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from 'react';
-import { CONVERSATION_THREAD_LINKED_RESOURCE_FILTER, CoreResourceOperation, CoreResourceType, ErrorCustomMessageReference, getChildDirectionRelationships, } from '@wildo-ai/saas-models';
+import { AGENT_WORK_DECISION_EXECUTION_FILTER, CONVERSATION_THREAD_LINKED_RESOURCE_FILTER, CoreResourceOperation, CoreResourceType, ErrorCustomMessageReference, ExecutionRefKind, RELATIONSHIP_MAILBOXES_OF_RELATIONSHIP_FILTER, REPRESENTATIVE_ASSIGNMENTS_OF_REPRESENTATION_FILTER, getChildDirectionRelationships, } from '@wildo-ai/saas-models';
+import { viewerMayPerformOperation } from '../../../core/navigation/launcher-resolution.js';
+import { useViewerEffectiveRoles } from '../../../core/navigation/launcher-runtime-availability.js';
 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
@@ -19,7 +21,7 @@ import { useRegisterComposedChild } from './ComposedChildrenRegistry.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
 import { CompositeView } from '../../../components/views/composite-view/CompositeView.js';
 import { useEmbeddedResourceHostContext, useOptionalEmbeddedResourceHostContext, } from '../../../components/resources/embeds/EmbeddedResourceHostContext.js';
-import { useEmbeddedResourceContext, } from './useEmbeddedResourceContext.js';
+import { isSelfReferencingRelatedCollectionTarget, useEmbeddedResourceContext, } from './useEmbeddedResourceContext.js';
 import { useHostRecordDerivedParentContext, mergeDerivedParentIdentifiers, } from '../../../components/views/composite-view/useHostRecordDerivedParentContext.js';
 function EmbeddedChartRenderer(params) {
     const { registry } = useResourceRegistry();
@@ -82,8 +84,26 @@ function buildResourceEmbedConfigurationError(message, context) {
         ...context,
     });
 }
+/**
+ * The identity of one embedded descent: the target resource and the ROW it is about — the record an operation
+ * addresses (`getAddressedRecordId`), or, for a collection or a CREATE, the scope it lists or creates into.
+ *
+ * It used to read the type slot whatever the operation. A collection's type slot holds at most ambient scope, so
+ * a host-own LIST embedded in that host's READ (composite → READ t-1 → LIST of tasks) took the READ's own key and
+ * was refused as a CYCLE, rendering nothing (round-17 review). Keying every collection as "no row" instead would
+ * make two lists of different scopes collide, so the collection's scope is its row: its identifiers without the
+ * own-type slot, which on a collection is ambient.
+ */
+export function embeddedResourceDescentKey(resourceContext) {
+    const recordId = FrontendResourceUtils.getInstance().getAddressedRecordId(resourceContext);
+    if (recordId)
+        return `embed:${resourceContext.resourceType}::${recordId}`;
+    const scope = Object.fromEntries(Object.entries(resourceContext.contextResourceIdentifiers ?? {})
+        .filter(([key]) => key !== resourceContext.resourceType));
+    return `embed:${resourceContext.resourceType}::scope:${FrontendResourceUtils.buildContextResourceIdentifiersKey(scope)}`;
+}
 function renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className) {
-    return (_jsx("div", { className: className, children: _jsx(EmbeddedResourceDescentBoundary, { descentKey: `embed:${resourceContext.resourceType}::${FrontendResourceUtils.getInstance().getResourceId(resourceContext.contextResourceIdentifiers?.[resourceContext.resourceType]) || 'no-row'}`, children: _jsx(SectionHostHeadingContext.Provider, { value: true, children: _jsx(ResourceOperationSurface, { resourceContext: resourceContext, navigationZone: navigationZone, navigationInitiator: navigationInitiator }) }) }) }));
+    return (_jsx("div", { className: className, children: _jsx(EmbeddedResourceDescentBoundary, { descentKey: embeddedResourceDescentKey(resourceContext), children: _jsx(SectionHostHeadingContext.Provider, { value: true, children: _jsx(ResourceOperationSurface, { resourceContext: resourceContext, navigationZone: navigationZone, navigationInitiator: navigationInitiator }) }) }) }));
 }
 /** @wildo_source:part:end saas.frontend.related-resource-embeds */
 export function EmbedResourceOperation({ resourceContext, className, }) {
@@ -111,6 +131,15 @@ export function EmbedRelatedResourceOperation({ className, ...target }) {
     const { navigationZone, navigationInitiator: hostNavigationInitiator } = useEmbeddedResourceHostContext();
     const compositeResourceContext = useEmbeddedResourceContext();
     const { registry } = useResourceRegistry();
+    const resourceContext = useMemo(() => {
+        if (!target.resourceType) {
+            throw buildResourceEmbedConfigurationError('EmbedRelatedResourceOperation() requires a target resourceType.', { target });
+        }
+        return compositeResourceContext.buildOperationContext(target);
+    }, 
+    // Keyed by target value, not the fresh rest-object identity — see EmbedHostResourceOperation.
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`
+    [compositeResourceContext, JSON.stringify(target)]);
     /*
      * The EDGE this child sits on, carried on every navigation it starts — what the automatic composition
      * (`ResourceLayout_ContainerNested`) already attaches as `sourceRelationship`.
@@ -125,10 +154,17 @@ export function EmbedRelatedResourceOperation({ className, ...target }) {
      * 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.
+     *
+     * A target of the HOST's own type sits on an edge only when it is the host's CHILDREN over a self-relationship
+     * (`isSelfReferencingRelatedCollectionTarget`, the rule the runtime builds its context by); any other same-type
+     * target is the host's own operation, and has no edge to carry.
      */
     const sourceRelationship = useMemo(() => {
         const { hostResourceType, hostResourceId, hostResourceConfig } = compositeResourceContext;
-        if (!target.resourceType || target.resourceType === hostResourceType || !hostResourceConfig?.resourceRelationships) {
+        const isOwnTypeOperation = target.resourceType === hostResourceType && !isSelfReferencingRelatedCollectionTarget({
+            target, hostResourceType, operation: resourceContext.operation, registry,
+        });
+        if (!target.resourceType || isOwnTypeOperation || !hostResourceConfig?.resourceRelationships) {
             return undefined;
         }
         const selectedForeignKey = target.relationshipFieldOverrides?.[hostResourceType];
@@ -148,20 +184,11 @@ export function EmbedRelatedResourceOperation({ className, ...target }) {
             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)]);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed by the target's value, like the context above
+    }, [compositeResourceContext, registry, resourceContext, 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 });
-        }
-        return compositeResourceContext.buildOperationContext(target);
-    }, 
-    // Keyed by target value, not the fresh rest-object identity — see EmbedHostResourceOperation.
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally keyed by JSON value of `target`
-    [compositeResourceContext, JSON.stringify(target)]);
     return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
 }
 /**
@@ -213,6 +240,115 @@ export function EmbedLinkedConversations({ className }) {
     }, [compositeResourceContext, hostResourceType, hostResourceId]);
     return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
 }
+/** @wildo_source:part:end saas.frontend.linked-conversations-embed */
+/**
+ * Where the decisions a conversational run raised are recorded: in the scope of the run they paused, so the store is a
+ * function of the run's own variant (#1599, `agentWorkDecisions`).
+ */
+const DECISIONS_OF_CONVERSATIONAL_RUN = {
+    [CoreResourceType.USER_FLOW_ACTOR_EXECUTIONS]: CoreResourceType.USER_AGENT_WORK_DECISIONS,
+    [CoreResourceType.ORGANIZATION_FLOW_ACTOR_EXECUTIONS]: CoreResourceType.ORGANIZATION_AGENT_WORK_DECISIONS,
+    [CoreResourceType.APPLICATION_FLOW_ACTOR_EXECUTIONS]: CoreResourceType.APPLICATION_AGENT_WORK_DECISIONS,
+};
+/**
+ * The decisions a conversational run raised and how each was answered (#2528): who decided, what they decided, what
+ * they changed and why — the scope's agent-work decisions LIST, pinned to this run through `pinnedFilters`, so the
+ * reader cannot widen it to another run, and it shows only what their roles may read (the scope's administrator).
+ *
+ * Place it on the READ surface of a `flowActorExecutions` variant; the decisions store follows the run's variant.
+ */
+export function EmbedExecutionDecisions({ executionId, className }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const { hostResourceType } = compositeResourceContext;
+    const resourceContext = useMemo(() => {
+        const decisionsResourceType = DECISIONS_OF_CONVERSATIONAL_RUN[hostResourceType];
+        if (!decisionsResourceType) {
+            throw buildResourceEmbedConfigurationError('EmbedExecutionDecisions() lists the decisions of a conversational RUN: place it on a flowActorExecutions READ surface.', { hostResourceType });
+        }
+        const decisions = compositeResourceContext.buildOperationContext({
+            resourceType: decisionsResourceType,
+            operationLike: CoreResourceOperation.LIST,
+            requireAddressable: false,
+        });
+        return {
+            ...decisions,
+            pinnedFilters: {
+                [AGENT_WORK_DECISION_EXECUTION_FILTER.KIND]: ExecutionRefKind.CONVERSATIONAL_EXECUTION,
+                [AGENT_WORK_DECISION_EXECUTION_FILTER.ID]: executionId,
+            },
+        };
+    }, [compositeResourceContext, hostResourceType, executionId]);
+    return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
+}
+/**
+ * May this viewer run the LIST of `resourceType` from the host record (#2589)? The roles the LIST declares, asked the way
+ * the shell asks of any operation it offers (`viewerMayPerformOperation`). For a host that draws a titled section around
+ * an embed: a section whose list the viewer may not read is not drawn at all, rather than as an empty heading or an
+ * error. Presentation only: the backend still decides every request.
+ */
+export function useViewerMayListRelatedResource(resourceType) {
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const viewer = useViewerEffectiveRoles();
+    return useMemo(() => {
+        const list = compositeResourceContext.buildOperationContext({ resourceType, operationLike: CoreResourceOperation.LIST, requireAddressable: false });
+        const operation = list.operation;
+        return viewerMayPerformOperation({ ...operation, resourceType }, viewer);
+    }, [compositeResourceContext, resourceType, viewer]);
+}
+/**
+ * One LIST pinned to the host relationship, shown only to a viewer the LIST admits (#2589).
+ *
+ * The client page is read by the firm's members as well as its administrators, and a section they cannot read must not
+ * appear as an error in the middle of the page: a list the viewer may not run is not drawn at all. Presentation only:
+ * the backend still decides every request, and the pin only narrows what the LIST returns.
+ */
+function useRepresentationPinnedList(params) {
+    const compositeResourceContext = useEmbeddedResourceContext();
+    const { hostResourceType } = compositeResourceContext;
+    const { embedName, resourceType, pinnedFilters } = params;
+    const viewerMayList = useViewerMayListRelatedResource(resourceType);
+    const pinKey = JSON.stringify(pinnedFilters);
+    return useMemo(() => {
+        if (hostResourceType !== CoreResourceType.ORGANIZATION_REPRESENTATIONS) {
+            throw buildResourceEmbedConfigurationError(`${embedName}() lists what belongs to one client relationship: place it on an organizationRepresentations READ surface.`, { hostResourceType });
+        }
+        if (!viewerMayList)
+            return null;
+        const list = compositeResourceContext.buildOperationContext({ resourceType, operationLike: CoreResourceOperation.LIST, requireAddressable: false });
+        return { ...list, pinnedFilters: JSON.parse(pinKey) };
+    }, [compositeResourceContext, hostResourceType, viewerMayList, embedName, resourceType, pinKey]);
+}
+/**
+ * The team serving one client relationship (#2589): the `representativeAssignments` LIST, pinned to that relationship
+ * through `pinnedFilters`, with its assign and unassign verbs. Assigning from here names the relationship by itself: the
+ * embed's context carries the host relationship, and the assign form fills `organizationRepresentationId` from it
+ * (`resolveSemanticContextFieldValues`, pinned against the real configuration by
+ * `representation-team-assign-prefill.test.ts`); its member picker searches the organization's own members. Shown to the organization's administrators only, the roles the LIST admits; a member
+ * reading the client does not see the team.
+ */
+export function EmbedRepresentationTeam({ organizationRepresentationId, className }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const resourceContext = useRepresentationPinnedList({
+        embedName: 'EmbedRepresentationTeam',
+        resourceType: CoreResourceType.REPRESENTATIVE_ASSIGNMENTS,
+        pinnedFilters: { [REPRESENTATIVE_ASSIGNMENTS_OF_REPRESENTATION_FILTER]: organizationRepresentationId },
+    });
+    return resourceContext ? renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className) : null;
+}
+/**
+ * The mailboxes of one client relationship (#2589): the `relationshipMailboxes` LIST, pinned to that relationship
+ * through `pinnedFilters`. Shown to a viewer the LIST admits.
+ */
+export function EmbedRepresentationMailboxes({ organizationRelationshipId, className }) {
+    const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
+    const resourceContext = useRepresentationPinnedList({
+        embedName: 'EmbedRepresentationMailboxes',
+        resourceType: CoreResourceType.RELATIONSHIP_MAILBOXES,
+        pinnedFilters: { [RELATIONSHIP_MAILBOXES_OF_RELATIONSHIP_FILTER]: organizationRelationshipId },
+    });
+    return resourceContext ? renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className) : null;
+}
 /**
  * Embed a related resource's SEARCH surface. Same delegation contract as
  * {@link EmbedRelatedResourceList} — only the semantic operation differs.