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

package/dist/esm/components/resources/card-action-placement.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"card-action-placement.utils.js","sourceRoot":"","sources":["../../../../src/components/resources/card-action-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAe7F;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,QAAQ,EAAE,iBAAiB,CAAC,MAAM;IAClC,UAAU,EAAE,mBAAmB,CAAC,GAAG;IACnC,WAAW,EAAE,gBAAgB,CAAC,UAAU;CACzC,CAAC;AAEF,MAAM,oBAAoB,GAAsC;IAC9D,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa;IACtC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc;IAC1C,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW;CACxC,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAC/C,YAAiC,6BAA6B;IAE9D,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,WAAW,KAAK,gBAAgB,CAAC,QAAQ,CAAC;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAEtF,oEAAoE;IACpE,IAAI,UAAU,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,KAAK,iBAAiB,CAAC,GAAG,CAAC;QACjD,OAAO;YACL,cAAc,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,iBAAiB;YAChF,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,GAAG,YAAY,cAAc;SAC5C,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,UAAU,KAAK,mBAAmB,CAAC,KAAK,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,IAAI,oBAAoB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;QACxI,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,GAAG,YAAY,WAAW;KACzC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Card action-button placement — resolves a 2-axis\n * {@link VerticalPlacement} × {@link HorizontalPlacement} anchor (+ button-set\n * {@link DisplayDirection} orientation) into the flex classes that position a\n * card's per-item action region relative to its content.\n *\n * **Why flexbox, not an absolute overlay.** A card holds a variable number of\n * action buttons and the button set can be a row or a vertical stack. Absolute\n * corner-positioning would overlap the title/body and needs per-count padding\n * guesses. Instead the 8 valid positions decompose into two robust flex modes:\n *\n * - **Side** (`horizontal` = START | END): content and actions share a row; the\n *   `vertical` axis becomes the cross-axis alignment (TOP→`items-start`,\n *   MIDDLE→`items-center`, BOTTOM→`items-end`). START flips the row so actions\n *   sit at the inline-start while content keeps reading order.\n * - **Band** (`horizontal` = MIDDLE, `vertical` = TOP | BOTTOM): content and a\n *   horizontally-centered action band stack vertically; TOP puts the band above.\n *\n * `MIDDLE × MIDDLE` is rejected at the schema layer (dead-center over content),\n * so it never reaches here — this resolver assumes a valid (non-dead-center)\n * placement. A caller that bypasses schema validation and passes MIDDLE × MIDDLE\n * gets the band-below layout (it hits the band branch), NOT the side default.\n *\n * DOM order is always [content][actions]; the `-reverse` variants flip the\n * VISUAL order so reading/tab order stays content-first.\n */\n\nimport { DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { VerticalPlacement, HorizontalPlacement } from '@wildo-ai/presets-components-models';\n// `CardActionPlacement` is inferred from `CardActionPlacementSchema` (its single\n// source of truth); this resolver and the config field can never drift.\nimport type { CardActionPlacement } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/** Resolved flex classes for the content-vs-actions layout of a card. */\nexport interface CardActionPlacementClasses {\n  /** Applied to the flex container wrapping [content][actions]. */\n  containerClass: string;\n  /** Applied to the content region. */\n  contentClass: string;\n  /** Applied to the actions region. */\n  actionsClass: string;\n}\n\n/**\n * The framework default — matches the historical card look: actions at the\n * inline-end, vertically centered, as a horizontal row.\n */\nexport const DEFAULT_CARD_ACTION_PLACEMENT: CardActionPlacement = {\n  vertical: VerticalPlacement.MIDDLE,\n  horizontal: HorizontalPlacement.END,\n  orientation: DisplayDirection.HORIZONTAL,\n};\n\nconst VERTICAL_ALIGN_CLASS: Record<VerticalPlacement, string> = {\n  [VerticalPlacement.TOP]: 'items-start',\n  [VerticalPlacement.MIDDLE]: 'items-center',\n  [VerticalPlacement.BOTTOM]: 'items-end',\n};\n\nexport function resolveCardActionPlacementClasses(\n  placement: CardActionPlacement = DEFAULT_CARD_ACTION_PLACEMENT,\n): CardActionPlacementClasses {\n  const { vertical, horizontal, orientation = DisplayDirection.HORIZONTAL } = placement;\n  const stacked = orientation === DisplayDirection.VERTICAL;\n  const actionsInner = stacked ? 'flex flex-col gap-element-sm' : 'flex gap-element-sm';\n\n  // Band mode: horizontally-centered actions above/below the content.\n  if (horizontal === HorizontalPlacement.MIDDLE) {\n    const above = vertical === VerticalPlacement.TOP;\n    return {\n      containerClass: `flex ${above ? 'flex-col-reverse' : 'flex-col'} gap-element-sm`,\n      contentClass: 'min-w-0',\n      actionsClass: `${actionsInner} self-center`,\n    };\n  }\n\n  // Side mode: actions beside the content, aligned per the vertical axis.\n  const atStart = horizontal === HorizontalPlacement.START;\n  return {\n    containerClass: `flex ${atStart ? 'flex-row-reverse' : ''} ${VERTICAL_ALIGN_CLASS[vertical]} gap-element-sm`.replace(/\\s+/g, ' ').trim(),\n    contentClass: 'min-w-0 flex-1',\n    actionsClass: `${actionsInner} shrink-0`,\n  };\n}\n"]}
+{"version":3,"file":"card-action-placement.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/card-action-placement.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAe7F;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,QAAQ,EAAE,iBAAiB,CAAC,MAAM;IAClC,UAAU,EAAE,mBAAmB,CAAC,GAAG;IACnC,WAAW,EAAE,gBAAgB,CAAC,UAAU;CACzC,CAAC;AAEF,MAAM,oBAAoB,GAAsC;IAC9D,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa;IACtC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc;IAC1C,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW;CACxC,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAC/C,YAAiC,6BAA6B;IAE9D,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,GAAG,gBAAgB,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,WAAW,KAAK,gBAAgB,CAAC,QAAQ,CAAC;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAEtF,oEAAoE;IACpE,IAAI,UAAU,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,KAAK,iBAAiB,CAAC,GAAG,CAAC;QACjD,OAAO;YACL,cAAc,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,iBAAiB;YAChF,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,GAAG,YAAY,cAAc;SAC5C,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,UAAU,KAAK,mBAAmB,CAAC,KAAK,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,IAAI,oBAAoB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;QACxI,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,GAAG,YAAY,WAAW;KACzC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Card action-button placement — resolves a 2-axis\n * {@link VerticalPlacement} × {@link HorizontalPlacement} anchor (+ button-set\n * {@link DisplayDirection} orientation) into the flex classes that position a\n * card's per-item action region relative to its content.\n *\n * **Why flexbox, not an absolute overlay.** A card holds a variable number of\n * action buttons and the button set can be a row or a vertical stack. Absolute\n * corner-positioning would overlap the title/body and needs per-count padding\n * guesses. Instead the 8 valid positions decompose into two robust flex modes:\n *\n * - **Side** (`horizontal` = START | END): content and actions share a row; the\n *   `vertical` axis becomes the cross-axis alignment (TOP→`items-start`,\n *   MIDDLE→`items-center`, BOTTOM→`items-end`). START flips the row so actions\n *   sit at the inline-start while content keeps reading order.\n * - **Band** (`horizontal` = MIDDLE, `vertical` = TOP | BOTTOM): content and a\n *   horizontally-centered action band stack vertically; TOP puts the band above.\n *\n * `MIDDLE × MIDDLE` is rejected at the schema layer (dead-center over content),\n * so it never reaches here — this resolver assumes a valid (non-dead-center)\n * placement. A caller that bypasses schema validation and passes MIDDLE × MIDDLE\n * gets the band-below layout (it hits the band branch), NOT the side default.\n *\n * DOM order is always [content][actions]; the `-reverse` variants flip the\n * VISUAL order so reading/tab order stays content-first.\n */\n\nimport { DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { VerticalPlacement, HorizontalPlacement } from '@wildo-ai/presets-components-models';\n// `CardActionPlacement` is inferred from `CardActionPlacementSchema` (its single\n// source of truth); this resolver and the config field can never drift.\nimport type { CardActionPlacement } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/** Resolved flex classes for the content-vs-actions layout of a card. */\nexport interface CardActionPlacementClasses {\n  /** Applied to the flex container wrapping [content][actions]. */\n  containerClass: string;\n  /** Applied to the content region. */\n  contentClass: string;\n  /** Applied to the actions region. */\n  actionsClass: string;\n}\n\n/**\n * The framework default — matches the historical card look: actions at the\n * inline-end, vertically centered, as a horizontal row.\n */\nexport const DEFAULT_CARD_ACTION_PLACEMENT: CardActionPlacement = {\n  vertical: VerticalPlacement.MIDDLE,\n  horizontal: HorizontalPlacement.END,\n  orientation: DisplayDirection.HORIZONTAL,\n};\n\nconst VERTICAL_ALIGN_CLASS: Record<VerticalPlacement, string> = {\n  [VerticalPlacement.TOP]: 'items-start',\n  [VerticalPlacement.MIDDLE]: 'items-center',\n  [VerticalPlacement.BOTTOM]: 'items-end',\n};\n\nexport function resolveCardActionPlacementClasses(\n  placement: CardActionPlacement = DEFAULT_CARD_ACTION_PLACEMENT,\n): CardActionPlacementClasses {\n  const { vertical, horizontal, orientation = DisplayDirection.HORIZONTAL } = placement;\n  const stacked = orientation === DisplayDirection.VERTICAL;\n  const actionsInner = stacked ? 'flex flex-col gap-element-sm' : 'flex gap-element-sm';\n\n  // Band mode: horizontally-centered actions above/below the content.\n  if (horizontal === HorizontalPlacement.MIDDLE) {\n    const above = vertical === VerticalPlacement.TOP;\n    return {\n      containerClass: `flex ${above ? 'flex-col-reverse' : 'flex-col'} gap-element-sm`,\n      contentClass: 'min-w-0',\n      actionsClass: `${actionsInner} self-center`,\n    };\n  }\n\n  // Side mode: actions beside the content, aligned per the vertical axis.\n  const atStart = horizontal === HorizontalPlacement.START;\n  return {\n    containerClass: `flex ${atStart ? 'flex-row-reverse' : ''} ${VERTICAL_ALIGN_CLASS[vertical]} gap-element-sm`.replace(/\\s+/g, ' ').trim(),\n    contentClass: 'min-w-0 flex-1',\n    actionsClass: `${actionsInner} shrink-0`,\n  };\n}\n"]}

package/dist/esm/components/resources/collection-card-layout.utils.d.ts

@@ -24,6 +24,43 @@
 import type { CSSProperties } from 'react';
 /** LIST container: bordered box with `divide-y` rows (the classic stacked list). */
 export declare const CARDS_LIST_CONTAINER_CLASS = "border border-border rounded-lg divide-y divide-border list-none m-0 p-0";
+/**
+ * ── The cards-mode SELECTION RAIL geometry, authored ONCE ──
+ *
+ * A collection's select-all checkbox and its per-row checkboxes must sit in the same column, and
+ * until these constants existed they could not: the row's leading rail was written inline in
+ * `ResourceListItemRenderer` while the select-all lived in the toolbar's own flex row, several
+ * unrelated controls to its right. Measured on the Wonder Todos todo list, the two were ~200px
+ * apart, so the header checkbox read as belonging to the toolbar rather than to the list it
+ * commands — and in TABLE mode it was a SECOND select-all beside the table header's own.
+ *
+ * Alignment here is not a styling preference, it is what makes the control legible: a checkbox
+ * above a column of checkboxes means "all of these", and the same checkbox anywhere else means
+ * nothing in particular. Two copies of the inset would drift on the first padding change, so the
+ * row and the header read the same three constants.
+ */
+/** The row's own padding box. Anything that must share a row's horizontal inset uses {@link CARD_ROW_PADDING_INLINE_CLASS}. */
+export declare const CARD_ROW_PADDING_CLASS = "p-card";
+/** The horizontal half of {@link CARD_ROW_PADDING_CLASS} — for a header rail that must be vertically compact. */
+export declare const CARD_ROW_PADDING_INLINE_CLASS = "px-card";
+/** The leading-rail flex: selection slot, then the row body. */
+export declare const CARD_SELECTION_RAIL_CLASS = "flex items-start gap-element-sm";
+/** The selection slot itself — the checkbox's cell in the rail. */
+export declare const CARD_SELECTION_SLOT_CLASS = "shrink-0";
+/**
+ * Wrapper class for the cards-mode selection HEADER rail, which sits ABOVE the cards region.
+ *
+ * One answer for both arrangements, and the transparent border is the whole of it: a row's content
+ * box is inset by a 1px border in EITHER case — the bordered `<ul>` in LIST, each cell's own border
+ * in GRID — so a rail with no border would land its checkbox exactly 1px left of the column it
+ * heads. Wearing the same border invisibly is cheaper than two branches and cannot be got wrong
+ * when a third arrangement appears.
+ *
+ * Above the region rather than inside it because the select-all is PAGE-wide: a temporally-grouped
+ * cards view renders one `<ul>` per day bucket, and a rail inside them would be one select-all per
+ * bucket claiming to command the page.
+ */
+export declare const CARDS_SELECTION_RAIL_CLASS = "border border-transparent rounded-lg";
 /** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */
 export declare const CARDS_GRID_CELL_CLASS = "border border-border rounded-lg overflow-hidden";
 /**

package/dist/esm/components/resources/collection-card-layout.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-card-layout.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,6EACqC,CAAC;AAE7E,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,oDAAoD,CAAC;AAKvF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAO5F"}
+{"version":3,"file":"collection-card-layout.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,6EACqC,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AAEH,+HAA+H;AAC/H,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,iHAAiH;AACjH,eAAO,MAAM,6BAA6B,YAAY,CAAC;AAEvD,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAE3E,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,yCAAyC,CAAC;AAEjF,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,oDAAoD,CAAC;AAKvF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAO5F"}

package/dist/esm/components/resources/collection-card-layout.utils.js

@@ -29,6 +29,43 @@ import { cn } from '../../core/ui/cn.js';
 const CARD_GRID_MIN_TRACK = '15rem';
 /** LIST container: bordered box with `divide-y` rows (the classic stacked list). */
 export const CARDS_LIST_CONTAINER_CLASS = 'border border-border rounded-lg divide-y divide-border list-none m-0 p-0';
+/**
+ * ── The cards-mode SELECTION RAIL geometry, authored ONCE ──
+ *
+ * A collection's select-all checkbox and its per-row checkboxes must sit in the same column, and
+ * until these constants existed they could not: the row's leading rail was written inline in
+ * `ResourceListItemRenderer` while the select-all lived in the toolbar's own flex row, several
+ * unrelated controls to its right. Measured on the Wonder Todos todo list, the two were ~200px
+ * apart, so the header checkbox read as belonging to the toolbar rather than to the list it
+ * commands — and in TABLE mode it was a SECOND select-all beside the table header's own.
+ *
+ * Alignment here is not a styling preference, it is what makes the control legible: a checkbox
+ * above a column of checkboxes means "all of these", and the same checkbox anywhere else means
+ * nothing in particular. Two copies of the inset would drift on the first padding change, so the
+ * row and the header read the same three constants.
+ */
+/** The row's own padding box. Anything that must share a row's horizontal inset uses {@link CARD_ROW_PADDING_INLINE_CLASS}. */
+export const CARD_ROW_PADDING_CLASS = 'p-card';
+/** The horizontal half of {@link CARD_ROW_PADDING_CLASS} — for a header rail that must be vertically compact. */
+export const CARD_ROW_PADDING_INLINE_CLASS = 'px-card';
+/** The leading-rail flex: selection slot, then the row body. */
+export const CARD_SELECTION_RAIL_CLASS = 'flex items-start gap-element-sm';
+/** The selection slot itself — the checkbox's cell in the rail. */
+export const CARD_SELECTION_SLOT_CLASS = 'shrink-0';
+/**
+ * Wrapper class for the cards-mode selection HEADER rail, which sits ABOVE the cards region.
+ *
+ * One answer for both arrangements, and the transparent border is the whole of it: a row's content
+ * box is inset by a 1px border in EITHER case — the bordered `<ul>` in LIST, each cell's own border
+ * in GRID — so a rail with no border would land its checkbox exactly 1px left of the column it
+ * heads. Wearing the same border invisibly is cheaper than two branches and cannot be got wrong
+ * when a third arrangement appears.
+ *
+ * Above the region rather than inside it because the select-all is PAGE-wide: a temporally-grouped
+ * cards view renders one `<ul>` per day bucket, and a rail inside them would be one select-all per
+ * bucket claiming to command the page.
+ */
+export const CARDS_SELECTION_RAIL_CLASS = 'border border-transparent rounded-lg';
 /** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */
 export const CARDS_GRID_CELL_CLASS = 'border border-border rounded-lg overflow-hidden';
 /** GRID container base classes (column tracks come from {@link resolveCardsGridStyle}). */

package/dist/esm/components/resources/collection-card-layout.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-card-layout.utils.js","sourceRoot":"","sources":["../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GACrC,0EAA0E,CAAC;AAE7E,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iDAAiD,CAAC;AAEvF,2FAA2F;AAC3F,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA2B;IACpE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,0BAA0B,CAAC;IAC7D,OAAO,EAAE,CAAC,0BAA0B,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,gCAAgC,CAAC,GAAG,CAAC;IACzE,OAAO;QACL,mBAAmB,EAAE,gCAAgC,mBAAmB,KAAK,MAAM,UAAU;KAC9F,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Cards-mode collection layout — resolves the `<ul>` container className (and,\n * for GRID, an inline `grid-template-columns`) for the two CARDS arrangements\n * (see `CardLayoutStyle`):\n *\n * - **LIST**: one bordered container whose rows are separated by `divide-y`.\n * - **GRID**: a responsive N-column grid; the shared `divide-y` border is\n *   dropped, so each card CELL owns its own border (the host adds it on the\n *   `<li>`). `columns` is the wide TARGET; the grid steps DOWN to fewer columns\n *   as space narrows.\n *\n * **Container-responsive, not viewport-responsive.** The column count is an\n * intrinsic `repeat(auto-fill, minmax(max(<minCard>, <target>), 1fr))` track\n * spec that reacts to the GRID's OWN available width — so a cards grid embedded\n * in a narrow pane (split view, composite panel, sidebar) collapses correctly\n * even on a wide viewport. This needs no `@container` ancestor and no media\n * breakpoints. Emitted as an inline style (not a Tailwind class) because the\n * track formula is parameterised by N and the design-token gap, and because\n * `cn`/twMerge cannot reason about design-token utilities anyway.\n *\n * Shared by `ResourceLayout_List` and `ResourceLayout_Search` so the two card\n * surfaces can never drift.\n */\n\nimport type { CSSProperties } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n/**\n * Minimum card track width before a column is dropped (~240px). Below this, the\n * grid fits fewer columns than the authored target; at/above it, up to N.\n */\nconst CARD_GRID_MIN_TRACK = '15rem';\n\n/** LIST container: bordered box with `divide-y` rows (the classic stacked list). */\nexport const CARDS_LIST_CONTAINER_CLASS =\n  'border border-border rounded-lg divide-y divide-border list-none m-0 p-0';\n\n/** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */\nexport const CARDS_GRID_CELL_CLASS = 'border border-border rounded-lg overflow-hidden';\n\n/** GRID container base classes (column tracks come from {@link resolveCardsGridStyle}). */\nconst CARDS_GRID_CONTAINER_CLASS = 'grid gap-element list-none m-0 p-0';\n\n/**\n * Container `<ul>` className. Pass the target column count for a GRID, or\n * `undefined` for the single-column LIST. Pair a GRID with\n * {@link resolveCardsGridStyle} for the column tracks.\n */\nexport function resolveCardsContainerClass(columns: number | undefined): string {\n  if (columns === undefined) return CARDS_LIST_CONTAINER_CLASS;\n  return cn(CARDS_GRID_CONTAINER_CLASS);\n}\n\n/**\n * Inline `grid-template-columns` for a GRID, or `undefined` for LIST.\n *\n * `repeat(auto-fill, minmax(max(<minCard>, (100% − (N−1)·gap) / N), 1fr))`:\n * - On WIDE space `(100% − gaps)/N ≥ <minCard>`, so the track min is the target\n *   share → exactly N columns (caps at the authored count).\n * - On NARROW space `(100% − gaps)/N < <minCard>`, so the track min is the\n *   absolute `<minCard>` → `auto-fill` fits fewer than N → the grid steps down.\n * Reacts to the `<ul>`'s own width, so embedded narrow hosts collapse without a\n * viewport breakpoint or `@container` wrapper.\n */\nexport function resolveCardsGridStyle(columns: number | undefined): CSSProperties | undefined {\n  if (columns === undefined) return undefined;\n  const n = Math.min(Math.max(Math.trunc(columns), 1), 6);\n  const target = `calc((100% - ${n - 1} * var(--spacing-element)) / ${n})`;\n  return {\n    gridTemplateColumns: `repeat(auto-fill, minmax(max(${CARD_GRID_MIN_TRACK}, ${target}), 1fr))`,\n  };\n}\n"]}
+{"version":3,"file":"collection-card-layout.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/collection-card-layout.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GACrC,0EAA0E,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AAEH,+HAA+H;AAC/H,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAE/C,iHAAiH;AACjH,MAAM,CAAC,MAAM,6BAA6B,GAAG,SAAS,CAAC;AAEvD,gEAAgE;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AAE3E,mEAAmE;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AAEjF,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iDAAiD,CAAC;AAEvF,2FAA2F;AAC3F,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA2B;IACpE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,0BAA0B,CAAC;IAC7D,OAAO,EAAE,CAAC,0BAA0B,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,gCAAgC,CAAC,GAAG,CAAC;IACzE,OAAO;QACL,mBAAmB,EAAE,gCAAgC,mBAAmB,KAAK,MAAM,UAAU;KAC9F,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Cards-mode collection layout — resolves the `<ul>` container className (and,\n * for GRID, an inline `grid-template-columns`) for the two CARDS arrangements\n * (see `CardLayoutStyle`):\n *\n * - **LIST**: one bordered container whose rows are separated by `divide-y`.\n * - **GRID**: a responsive N-column grid; the shared `divide-y` border is\n *   dropped, so each card CELL owns its own border (the host adds it on the\n *   `<li>`). `columns` is the wide TARGET; the grid steps DOWN to fewer columns\n *   as space narrows.\n *\n * **Container-responsive, not viewport-responsive.** The column count is an\n * intrinsic `repeat(auto-fill, minmax(max(<minCard>, <target>), 1fr))` track\n * spec that reacts to the GRID's OWN available width — so a cards grid embedded\n * in a narrow pane (split view, composite panel, sidebar) collapses correctly\n * even on a wide viewport. This needs no `@container` ancestor and no media\n * breakpoints. Emitted as an inline style (not a Tailwind class) because the\n * track formula is parameterised by N and the design-token gap, and because\n * `cn`/twMerge cannot reason about design-token utilities anyway.\n *\n * Shared by `ResourceLayout_List` and `ResourceLayout_Search` so the two card\n * surfaces can never drift.\n */\n\nimport type { CSSProperties } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n/**\n * Minimum card track width before a column is dropped (~240px). Below this, the\n * grid fits fewer columns than the authored target; at/above it, up to N.\n */\nconst CARD_GRID_MIN_TRACK = '15rem';\n\n/** LIST container: bordered box with `divide-y` rows (the classic stacked list). */\nexport const CARDS_LIST_CONTAINER_CLASS =\n  'border border-border rounded-lg divide-y divide-border list-none m-0 p-0';\n\n/**\n * ── The cards-mode SELECTION RAIL geometry, authored ONCE ──\n *\n * A collection's select-all checkbox and its per-row checkboxes must sit in the same column, and\n * until these constants existed they could not: the row's leading rail was written inline in\n * `ResourceListItemRenderer` while the select-all lived in the toolbar's own flex row, several\n * unrelated controls to its right. Measured on the Wonder Todos todo list, the two were ~200px\n * apart, so the header checkbox read as belonging to the toolbar rather than to the list it\n * commands — and in TABLE mode it was a SECOND select-all beside the table header's own.\n *\n * Alignment here is not a styling preference, it is what makes the control legible: a checkbox\n * above a column of checkboxes means \"all of these\", and the same checkbox anywhere else means\n * nothing in particular. Two copies of the inset would drift on the first padding change, so the\n * row and the header read the same three constants.\n */\n\n/** The row's own padding box. Anything that must share a row's horizontal inset uses {@link CARD_ROW_PADDING_INLINE_CLASS}. */\nexport const CARD_ROW_PADDING_CLASS = 'p-card';\n\n/** The horizontal half of {@link CARD_ROW_PADDING_CLASS} — for a header rail that must be vertically compact. */\nexport const CARD_ROW_PADDING_INLINE_CLASS = 'px-card';\n\n/** The leading-rail flex: selection slot, then the row body. */\nexport const CARD_SELECTION_RAIL_CLASS = 'flex items-start gap-element-sm';\n\n/** The selection slot itself — the checkbox's cell in the rail. */\nexport const CARD_SELECTION_SLOT_CLASS = 'shrink-0';\n\n/**\n * Wrapper class for the cards-mode selection HEADER rail, which sits ABOVE the cards region.\n *\n * One answer for both arrangements, and the transparent border is the whole of it: a row's content\n * box is inset by a 1px border in EITHER case — the bordered `<ul>` in LIST, each cell's own border\n * in GRID — so a rail with no border would land its checkbox exactly 1px left of the column it\n * heads. Wearing the same border invisibly is cheaper than two branches and cannot be got wrong\n * when a third arrangement appears.\n *\n * Above the region rather than inside it because the select-all is PAGE-wide: a temporally-grouped\n * cards view renders one `<ul>` per day bucket, and a rail inside them would be one select-all per\n * bucket claiming to command the page.\n */\nexport const CARDS_SELECTION_RAIL_CLASS = 'border border-transparent rounded-lg';\n\n/** GRID cell border applied to each `<li>` (the shared border is gone in grid mode). */\nexport const CARDS_GRID_CELL_CLASS = 'border border-border rounded-lg overflow-hidden';\n\n/** GRID container base classes (column tracks come from {@link resolveCardsGridStyle}). */\nconst CARDS_GRID_CONTAINER_CLASS = 'grid gap-element list-none m-0 p-0';\n\n/**\n * Container `<ul>` className. Pass the target column count for a GRID, or\n * `undefined` for the single-column LIST. Pair a GRID with\n * {@link resolveCardsGridStyle} for the column tracks.\n */\nexport function resolveCardsContainerClass(columns: number | undefined): string {\n  if (columns === undefined) return CARDS_LIST_CONTAINER_CLASS;\n  return cn(CARDS_GRID_CONTAINER_CLASS);\n}\n\n/**\n * Inline `grid-template-columns` for a GRID, or `undefined` for LIST.\n *\n * `repeat(auto-fill, minmax(max(<minCard>, (100% − (N−1)·gap) / N), 1fr))`:\n * - On WIDE space `(100% − gaps)/N ≥ <minCard>`, so the track min is the target\n *   share → exactly N columns (caps at the authored count).\n * - On NARROW space `(100% − gaps)/N < <minCard>`, so the track min is the\n *   absolute `<minCard>` → `auto-fill` fits fewer than N → the grid steps down.\n * Reacts to the `<ul>`'s own width, so embedded narrow hosts collapse without a\n * viewport breakpoint or `@container` wrapper.\n */\nexport function resolveCardsGridStyle(columns: number | undefined): CSSProperties | undefined {\n  if (columns === undefined) return undefined;\n  const n = Math.min(Math.max(Math.trunc(columns), 1), 6);\n  const target = `calc((100% - ${n - 1} * var(--spacing-element)) / ${n})`;\n  return {\n    gridTemplateColumns: `repeat(auto-fill, minmax(max(${CARD_GRID_MIN_TRACK}, ${target}), 1fr))`,\n  };\n}\n"]}

package/dist/esm/components/resources/collection-view-mode.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-view-mode.frontend.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/collection-view-mode.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAQtG;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAMxF;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAEvF;AAED,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,EAAE,qBAAqB,CAAC;IAChC,6DAA6D;IAC7D,WAAW,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,iBAAiB,CAWvG"}
+{"version":3,"file":"collection-view-mode.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/collection-view-mode.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAQtG;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAMxF;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAEvF;AAED,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,EAAE,qBAAqB,CAAC;IAChC,6DAA6D;IAC7D,WAAW,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,iBAAiB,CAWvG"}

package/dist/esm/components/resources/collection-view-mode.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-view-mode.frontend.js","sourceRoot":"","sources":["../../../../src/components/resources/collection-view-mode.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAEtG,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAE/D,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,OAAO,GAAG,wBAAwB,GAAG,YAAY,EAAE,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,GAAG,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,KAAK,qBAAqB,CAAC,KAAK,IAAI,GAAG,KAAK,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAC/E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,IAA2B;IAC/E,mBAAmB,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,WAAkC;IAClF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAC3C,GAAG,EAAE,CAAC,qBAAqB,CAAC,YAAY,CAAC,IAAI,WAAW,CACzD,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,IAA2B,EAAQ,EAAE;QACpE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Collection view-mode state — the runtime \"cards vs table\" display choice for a\n * resource collection view.\n *\n * The DEFAULT mode for a resource comes from its LIST/SEARCH operation's\n * `collectionDisplayConfig.displayMode` (authored in the resource UI behavior),\n * falling back to its registered preset seed. The user's toggle OVERRIDES that\n * default and PERSISTS per resource type, so a chosen display sticks across\n * navigations and reloads while the config still seeds the first view.\n *\n * The display vocabulary is `CollectionDisplayMode` (CARDS|TABLE), owned by the\n * frontend core schema (`resources.frontend.schemas.ts`) — these persistence\n * helpers are the runtime side of that vocabulary.\n *\n * Persistence goes through the framework's single storage abstraction\n * (`getLocalStorageItem`/`setLocalStorageItem`), which fails closed when storage\n * is unavailable (e.g. the companion's Node introspection render) — so reads fall\n * back to the supplied default and the hook never throws off-browser.\n */\n\nimport { useCallback, useState } from 'react';\nimport {\n  getLocalStorageItem,\n  setLocalStorageItem,\n} from '~wildo-frontend-lib/core/commons/local-storage.frontend.schemas';\nimport { CollectionDisplayMode } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nconst VIEW_MODE_STORAGE_PREFIX = 'wildo-collection-view-mode:';\n\nfunction viewModeStorageKey(resourceType: string): string {\n  return `${VIEW_MODE_STORAGE_PREFIX}${resourceType}`;\n}\n\n/**\n * The persisted display mode for a resource type, or `null` when none is stored\n * (first visit) or storage is unavailable. Validated against the enum so a\n * tampered/legacy value never leaks through.\n */\nexport function readPersistedViewMode(resourceType: string): CollectionDisplayMode | null {\n  const raw = getLocalStorageItem(viewModeStorageKey(resourceType));\n  if (raw === CollectionDisplayMode.CARDS || raw === CollectionDisplayMode.TABLE) {\n    return raw;\n  }\n  return null;\n}\n\n/** Persist the user's display-mode choice for a resource type. */\nexport function persistViewMode(resourceType: string, mode: CollectionDisplayMode): void {\n  setLocalStorageItem(viewModeStorageKey(resourceType), mode);\n}\n\nexport interface UseViewModeResult {\n  /** The active display mode (persisted choice if any, else the seeded default). */\n  viewMode: CollectionDisplayMode;\n  /** Set + persist the display mode for this resource type. */\n  setViewMode: (mode: CollectionDisplayMode) => void;\n}\n\n/**\n * Display-mode state for a collection: seeds from the persisted choice (falling\n * back to the config-derived `defaultMode`) and persists on change.\n *\n * `resourceType` is stable per mounted collection, so the lazy initializer reads\n * storage exactly once.\n */\nexport function useViewMode(resourceType: string, defaultMode: CollectionDisplayMode): UseViewModeResult {\n  const [viewMode, setViewModeState] = useState<CollectionDisplayMode>(\n    () => readPersistedViewMode(resourceType) ?? defaultMode,\n  );\n\n  const setViewMode = useCallback((mode: CollectionDisplayMode): void => {\n    setViewModeState(mode);\n    persistViewMode(resourceType, mode);\n  }, [resourceType]);\n\n  return { viewMode, setViewMode };\n}\n"]}
+{"version":3,"file":"collection-view-mode.frontend.js","sourceRoot":"","sources":["../../../../../src/components/resources/collection-view-mode.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAEtG,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAE/D,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,OAAO,GAAG,wBAAwB,GAAG,YAAY,EAAE,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,GAAG,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,KAAK,qBAAqB,CAAC,KAAK,IAAI,GAAG,KAAK,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAC/E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,IAA2B;IAC/E,mBAAmB,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,WAAkC;IAClF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAC3C,GAAG,EAAE,CAAC,qBAAqB,CAAC,YAAY,CAAC,IAAI,WAAW,CACzD,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,IAA2B,EAAQ,EAAE;QACpE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Collection view-mode state — the runtime \"cards vs table\" display choice for a\n * resource collection view.\n *\n * The DEFAULT mode for a resource comes from its LIST/SEARCH operation's\n * `collectionDisplayConfig.displayMode` (authored in the resource UI behavior),\n * falling back to its registered preset seed. The user's toggle OVERRIDES that\n * default and PERSISTS per resource type, so a chosen display sticks across\n * navigations and reloads while the config still seeds the first view.\n *\n * The display vocabulary is `CollectionDisplayMode` (CARDS|TABLE), owned by the\n * frontend core schema (`resources.frontend.schemas.ts`) — these persistence\n * helpers are the runtime side of that vocabulary.\n *\n * Persistence goes through the framework's single storage abstraction\n * (`getLocalStorageItem`/`setLocalStorageItem`), which fails closed when storage\n * is unavailable (e.g. the companion's Node introspection render) — so reads fall\n * back to the supplied default and the hook never throws off-browser.\n */\n\nimport { useCallback, useState } from 'react';\nimport {\n  getLocalStorageItem,\n  setLocalStorageItem,\n} from '~wildo-frontend-lib/core/commons/local-storage.frontend.schemas';\nimport { CollectionDisplayMode } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nconst VIEW_MODE_STORAGE_PREFIX = 'wildo-collection-view-mode:';\n\nfunction viewModeStorageKey(resourceType: string): string {\n  return `${VIEW_MODE_STORAGE_PREFIX}${resourceType}`;\n}\n\n/**\n * The persisted display mode for a resource type, or `null` when none is stored\n * (first visit) or storage is unavailable. Validated against the enum so a\n * tampered/legacy value never leaks through.\n */\nexport function readPersistedViewMode(resourceType: string): CollectionDisplayMode | null {\n  const raw = getLocalStorageItem(viewModeStorageKey(resourceType));\n  if (raw === CollectionDisplayMode.CARDS || raw === CollectionDisplayMode.TABLE) {\n    return raw;\n  }\n  return null;\n}\n\n/** Persist the user's display-mode choice for a resource type. */\nexport function persistViewMode(resourceType: string, mode: CollectionDisplayMode): void {\n  setLocalStorageItem(viewModeStorageKey(resourceType), mode);\n}\n\nexport interface UseViewModeResult {\n  /** The active display mode (persisted choice if any, else the seeded default). */\n  viewMode: CollectionDisplayMode;\n  /** Set + persist the display mode for this resource type. */\n  setViewMode: (mode: CollectionDisplayMode) => void;\n}\n\n/**\n * Display-mode state for a collection: seeds from the persisted choice (falling\n * back to the config-derived `defaultMode`) and persists on change.\n *\n * `resourceType` is stable per mounted collection, so the lazy initializer reads\n * storage exactly once.\n */\nexport function useViewMode(resourceType: string, defaultMode: CollectionDisplayMode): UseViewModeResult {\n  const [viewMode, setViewModeState] = useState<CollectionDisplayMode>(\n    () => readPersistedViewMode(resourceType) ?? defaultMode,\n  );\n\n  const setViewMode = useCallback((mode: CollectionDisplayMode): void => {\n    setViewModeState(mode);\n    persistViewMode(resourceType, mode);\n  }, [resourceType]);\n\n  return { viewMode, setViewMode };\n}\n"]}

package/dist/esm/components/resources/component-props.resources-layout.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-props.resources-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/component-props.resources-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACjH,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,gCAAgC,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,eAAO,MAAM,sBAAsB,2BAA2B,CAAA"}
+{"version":3,"file":"component-props.resources-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/component-props.resources-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACjH,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,gCAAgC,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,eAAO,MAAM,sBAAsB,2BAA2B,CAAA"}

package/dist/esm/components/resources/component-props.resources-layout.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-props.resources-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/components/resources/component-props.resources-layout.frontend.schemas.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAA","sourcesContent":["import type { NavigationTransition } from '@wildo-ai/saas-models';\nimport { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { NavigationZone, NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\n/**\n * Context provided to inline children when rendered within a parent view\n * by ContainerNested. Allows children to detect they're embedded inline\n * (parent is already visible above) and skip redundant parent references.\n */\nexport interface InlineParentContext {\n  /** The parent resource type (e.g., 'ORGANIZATIONS') */\n  parentResourceType: string;\n  /** The parent resource ID (from contextResourceIdentifiers) */\n  parentResourceId?: string;\n  /**\n   * When set, the child was opened via a navigation transition (not embedded inline).\n   * Undefined means the child is embedded inline (the v3 default).\n   */\n  transition?: NavigationTransition;\n}\n\nexport interface BaseResourcesLayoutProps {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  /**\n   * Set by ContainerNested when rendering inline children (embedded, no transition).\n   * When present, the child knows it's rendered within a parent view and can:\n   * - Skip showing a redundant parent reference (parent is visible above)\n   * - Access the parent resource type and ID for relationship-aware behavior\n   */\n  inlineParentContext?: InlineParentContext;\n}\n\nexport const thingsToLetModuleWorks = \"thingsToLetModuleWorks\"\n"]}
+{"version":3,"file":"component-props.resources-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/components/resources/component-props.resources-layout.frontend.schemas.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAA","sourcesContent":["import type { NavigationTransition } from '@wildo-ai/saas-models';\nimport { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { NavigationZone, NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\n/**\n * Context provided to inline children when rendered within a parent view\n * by ContainerNested. Allows children to detect they're embedded inline\n * (parent is already visible above) and skip redundant parent references.\n */\nexport interface InlineParentContext {\n  /** The parent resource type (e.g., 'ORGANIZATIONS') */\n  parentResourceType: string;\n  /** The parent resource ID (from contextResourceIdentifiers) */\n  parentResourceId?: string;\n  /**\n   * When set, the child was opened via a navigation transition (not embedded inline).\n   * Undefined means the child is embedded inline (the v3 default).\n   */\n  transition?: NavigationTransition;\n}\n\nexport interface BaseResourcesLayoutProps {\n  resourceContext: FrontendResourceOperationContext;\n  navigationZone: NavigationZone;\n  navigationInitiator?: NavigationInitiatorContext;\n  /**\n   * Set by ContainerNested when rendering inline children (embedded, no transition).\n   * When present, the child knows it's rendered within a parent view and can:\n   * - Skip showing a redundant parent reference (parent is visible above)\n   * - Access the parent resource type and ID for relationship-aware behavior\n   */\n  inlineParentContext?: InlineParentContext;\n}\n\nexport const thingsToLetModuleWorks = \"thingsToLetModuleWorks\"\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ComposedChildrenRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/ComposedChildrenRegistry.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgE,MAAM,OAAO,CAAC;AAGrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB;;;;;;;;OAQG;IACH,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAAqB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7C;AAID,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,EAC/C,QAAQ,GACT,EAAE,qCAAqC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6B3D;AAwBD,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKpF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AASD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAKrE;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC,CAGzD"}
+{"version":3,"file":"ComposedChildrenRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ComposedChildrenRegistry.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgE,MAAM,OAAO,CAAC;AAGrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB;;;;;;;;OAQG;IACH,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAAqB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7C;AAID,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,EAC/C,QAAQ,GACT,EAAE,qCAAqC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6B3D;AAwBD,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKpF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AASD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAKrE;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC,CAGzD"}

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

@@ -1 +1 @@
-{"version":3,"file":"ComposedChildrenRegistry.js","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/ComposedChildrenRegistry.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useEffect, useMemo, useRef } from 'react';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * Records whether a view TEMPLATE composed the child region itself, so the\n * automatic composition that follows stands down entirely.\n *\n * ## Whole-surface ownership, not a per-child merge\n *\n * If the template placed ANY child, it owns the child region and the automatic\n * block renders nothing. This mirrors how an authored `layout.display` REPLACES\n * the generated field template rather than being merged with it\n * (`ResourceAutomaticDisplayer`: `if (explicitDisplayTemplate) return\n * explicitDisplayTemplate;` — there is no per-field \"the framework also appends\n * the ones you did not place\", and nobody has ever wanted one).\n *\n * Children behaving differently is what would FORCE a per-edge suppression flag\n * back into the relationship: a parent placing 3 of its 33 owned children would\n * otherwise auto-compose the other 30, and the only way to stop that is a flag\n * on each edge. Whole-surface ownership is precisely what makes that\n * configuration axis unnecessary — two modes (standard, or the template), never\n * three.\n *\n * The signal is PLACEMENT, not the mere existence of a template. A field-only\n * `layout.display` — Wonder Todos' `todoLists` is exactly that — places no child\n * and must keep its standard child block. Keying on existence would silently\n * delete content from every field-only template in the repository.\n *\n * ## The handshake, and why it can work at all\n *\n * A resource READ surface renders in one pass, in order: the header, then the\n * displayer (inside which the authored `layout.display` template runs, and with\n * it any child embeds it places), and only then the automatic children\n * container. So a placement registered during the template's render is already\n * visible when the container renders in that same pass. The ordering is not\n * incidental — it is the whole mechanism, and moving the container above the\n * displayer would silently break it.\n *\n * ## Why a ref-backed set rather than state\n *\n * Registration must not schedule a re-render: the template registers DURING\n * render, and setting state there is illegal. The set is cleared at the start of\n * every host render and refilled by that render's template, so it always\n * describes the current pass rather than accumulating across passes — which is\n * what makes a child REMOVED from a template stop being suppressed.\n *\n * ## The one case that does not resolve within a single pass\n *\n * A template that places a child CONDITIONALLY on loaded record data places\n * nothing on the first pass, so the container composes that child automatically;\n * when the data arrives the host re-renders, the template registers, and the\n * container skips it. The child therefore renders automatically for the frames\n * before data lands. It self-corrects, and the container already defers\n * conditional relationships while `parentData` is undefined for the same\n * \"avoid a flash of content\" reason — but a template that wants no flicker at\n * all should place its child unconditionally and let the child's own surface\n * handle its empty state.\n */\nexport interface ComposedChildrenRegistryValue {\n  /**\n   * Child resource types placed by the template in the CURRENT render pass.\n   * Mutable by design — see the class comment on why this is a ref and not state.\n   */\n  placed: Set<string>;\n  /**\n   * Ownership CLAIMED explicitly, independently of how many children were placed.\n   *\n   * Placement alone cannot express \"this surface composes NO children\": a template\n   * that places nothing is indistinguishable from one that never decided, and the\n   * latter must keep composing automatically. Real surfaces need the distinction —\n   * an embedded application READ deliberately shows none of its nine owned\n   * children, which is what nine `hidden: true` entries used to say.\n   */\n  owned: { current: boolean };\n  /**\n   * Whether the automatic container actually COMPOSED children this pass.\n   *\n   * The handshake is render-phase — placements mutate `placed`/`owned` while they\n   * render, the container reads the answer while IT renders — so it only works\n   * because the container renders AFTER the template. That holds today\n   * (`ResourceLayout_Read` renders `{children}` immediately before\n   * `ResourceLayout_ContainerNested`) and nothing in the type system enforces it;\n   * swap those two JSX siblings and every child renders TWICE, silently.\n   *\n   * The detection is deliberately an OUTCOME, checked after commit, rather than a\n   * render-order tripwire. A first attempt marked the pass as soon as the question\n   * was asked and warned on any later placement — which fired spuriously the moment\n   * anything re-rendered WITHOUT the provider (an error boundary recovering, most\n   * visibly), because the flag was then left over from the previous pass. A\n   * diagnostic that cries wolf gets ignored, so this one asks the only question\n   * that is actually a defect: did the container compose children AND a template\n   * claim the region? That is duplication, whatever order they rendered in.\n   */\n  composedAutomatically: { current: boolean };\n}\n\nconst ComposedChildrenRegistryContext = createContext<ComposedChildrenRegistryValue | null>(null);\n\nexport interface ComposedChildrenRegistryProviderProps {\n  children: React.ReactNode;\n}\n\n/**\n * Hosts an ownership handshake for one render pass of one record surface.\n *\n * Clears the set on every render so the registry describes THIS pass. The\n * context value is identity-stable across renders (the ref wrapper), so\n * providing it costs no extra re-render of the subtree.\n */\nexport function ComposedChildrenRegistryProvider({\n  children,\n}: ComposedChildrenRegistryProviderProps): React.JSX.Element {\n  const ref = useRef<ComposedChildrenRegistryValue>({\n    placed: new Set<string>(),\n    owned: { current: false },\n    composedAutomatically: { current: false },\n  });\n  // Cleared during render, before any descendant registers — descendants render\n  // strictly after this component's body, so nothing registered this pass is lost.\n  ref.current.placed.clear();\n  ref.current.owned.current = false;\n  ref.current.composedAutomatically.current = false;\n  const value = useMemo(() => ref.current, []);\n\n  // After commit, so render ORDER is irrelevant and only the outcome is judged.\n  useEffect(() => {\n    const registry = ref.current;\n    if (!registry.composedAutomatically.current) {\n      return;\n    }\n    if (registry.owned.current || registry.placed.size > 0) {\n      warnDuplicatedChildComposition([...registry.placed]);\n    }\n  });\n\n  return (\n    <ComposedChildrenRegistryContext.Provider value={value}>\n      {children}\n    </ComposedChildrenRegistryContext.Provider>\n  );\n}\n\n/**\n * Called by an embed while it renders, to claim a child on behalf of the\n * template that placed it. A no-op outside a registry host (an embed used in a\n * composite view or a standalone preview claims nothing and suppresses nothing).\n */\n/** One warning per placed set — a mis-ordered surface re-renders freely. */\nconst warnedDuplications = new Set<string>();\n\nfunction warnDuplicatedChildComposition(placed: readonly string[]): void {\n  const key = placed.slice().sort().join(',');\n  if (warnedDuplications.has(key)) {\n    return;\n  }\n  warnedDuplications.add(key);\n  LoggerFrontendService.getLogger().warn(\n    '[composed-children] A template claimed the child region AND the automatic container composed children '\n    + `in the same pass, so children render TWICE${placed.length > 0 ? ` (placed: ${placed.join(', ')})` : ''}. `\n    + 'The handshake is render-phase, so the template must render BEFORE the container — check that the '\n    + 'surface still renders its display template above <ResourceLayout_ContainerNested>.',\n  );\n}\n\nexport function useRegisterComposedChild(childResourceType: string | undefined): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry && childResourceType) {\n    registry.placed.add(childResourceType);\n  }\n}\n\n/**\n * `true` when the template composed the child region itself, in which case the\n * automatic container renders nothing.\n *\n * `false` with no host, so a surface without the handshake composes normally —\n * the pre-existing behaviour, unchanged.\n */\nexport function useTemplateOwnsChildComposition(): boolean {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (!registry) return false;\n  return registry.owned.current || registry.placed.size > 0;\n}\n\n/**\n * Claim the child region for the template, whatever it ends up containing.\n *\n * Called by the placement primitive so that naming ZERO children is a decision\n * (\"this surface composes none\") rather than an absence of one (\"nobody said, so\n * compose them all\"). Without it, the only way to express \"no children\" is a\n * per-edge opt-out on every relationship — the configuration axis this design\n * exists to remove.\n */\nexport function useClaimChildComposition(): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry) {\n    registry.owned.current = true;\n  }\n}\n\n/**\n * Which child resource types were placed. Not used to SUPPRESS anything —\n * ownership is whole-surface — but kept because it is what makes a diagnostic\n * able to name the children a template claimed.\n */\nconst EMPTY: ReadonlySet<string> = Object.freeze(new Set<string>());\n\n/**\n * Called by the automatic container to record what it DID this pass. Paired with\n * the provider's post-commit check: \"container composed\" plus \"template claimed\"\n * is duplication, and is the only combination worth reporting.\n */\nexport function useReportAutomaticComposition(composed: boolean): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry && composed) {\n    registry.composedAutomatically.current = true;\n  }\n}\n\nexport function useComposedChildren(): ReadonlySet<string> {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  return registry?.placed ?? EMPTY;\n}\n"]}
+{"version":3,"file":"ComposedChildrenRegistry.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/ComposedChildrenRegistry.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useEffect, useMemo, useRef } from 'react';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/**\n * Records whether a view TEMPLATE composed the child region itself, so the\n * automatic composition that follows stands down entirely.\n *\n * ## Whole-surface ownership, not a per-child merge\n *\n * If the template placed ANY child, it owns the child region and the automatic\n * block renders nothing. This mirrors how an authored `layout.display` REPLACES\n * the generated field template rather than being merged with it\n * (`ResourceAutomaticDisplayer`: `if (explicitDisplayTemplate) return\n * explicitDisplayTemplate;` — there is no per-field \"the framework also appends\n * the ones you did not place\", and nobody has ever wanted one).\n *\n * Children behaving differently is what would FORCE a per-edge suppression flag\n * back into the relationship: a parent placing 3 of its 33 owned children would\n * otherwise auto-compose the other 30, and the only way to stop that is a flag\n * on each edge. Whole-surface ownership is precisely what makes that\n * configuration axis unnecessary — two modes (standard, or the template), never\n * three.\n *\n * The signal is PLACEMENT, not the mere existence of a template. A field-only\n * `layout.display` — Wonder Todos' `todoLists` is exactly that — places no child\n * and must keep its standard child block. Keying on existence would silently\n * delete content from every field-only template in the repository.\n *\n * ## The handshake, and why it can work at all\n *\n * A resource READ surface renders in one pass, in order: the header, then the\n * displayer (inside which the authored `layout.display` template runs, and with\n * it any child embeds it places), and only then the automatic children\n * container. So a placement registered during the template's render is already\n * visible when the container renders in that same pass. The ordering is not\n * incidental — it is the whole mechanism, and moving the container above the\n * displayer would silently break it.\n *\n * ## Why a ref-backed set rather than state\n *\n * Registration must not schedule a re-render: the template registers DURING\n * render, and setting state there is illegal. The set is cleared at the start of\n * every host render and refilled by that render's template, so it always\n * describes the current pass rather than accumulating across passes — which is\n * what makes a child REMOVED from a template stop being suppressed.\n *\n * ## The one case that does not resolve within a single pass\n *\n * A template that places a child CONDITIONALLY on loaded record data places\n * nothing on the first pass, so the container composes that child automatically;\n * when the data arrives the host re-renders, the template registers, and the\n * container skips it. The child therefore renders automatically for the frames\n * before data lands. It self-corrects, and the container already defers\n * conditional relationships while `parentData` is undefined for the same\n * \"avoid a flash of content\" reason — but a template that wants no flicker at\n * all should place its child unconditionally and let the child's own surface\n * handle its empty state.\n */\nexport interface ComposedChildrenRegistryValue {\n  /**\n   * Child resource types placed by the template in the CURRENT render pass.\n   * Mutable by design — see the class comment on why this is a ref and not state.\n   */\n  placed: Set<string>;\n  /**\n   * Ownership CLAIMED explicitly, independently of how many children were placed.\n   *\n   * Placement alone cannot express \"this surface composes NO children\": a template\n   * that places nothing is indistinguishable from one that never decided, and the\n   * latter must keep composing automatically. Real surfaces need the distinction —\n   * an embedded application READ deliberately shows none of its nine owned\n   * children, which is what nine `hidden: true` entries used to say.\n   */\n  owned: { current: boolean };\n  /**\n   * Whether the automatic container actually COMPOSED children this pass.\n   *\n   * The handshake is render-phase — placements mutate `placed`/`owned` while they\n   * render, the container reads the answer while IT renders — so it only works\n   * because the container renders AFTER the template. That holds today\n   * (`ResourceLayout_Read` renders `{children}` immediately before\n   * `ResourceLayout_ContainerNested`) and nothing in the type system enforces it;\n   * swap those two JSX siblings and every child renders TWICE, silently.\n   *\n   * The detection is deliberately an OUTCOME, checked after commit, rather than a\n   * render-order tripwire. A first attempt marked the pass as soon as the question\n   * was asked and warned on any later placement — which fired spuriously the moment\n   * anything re-rendered WITHOUT the provider (an error boundary recovering, most\n   * visibly), because the flag was then left over from the previous pass. A\n   * diagnostic that cries wolf gets ignored, so this one asks the only question\n   * that is actually a defect: did the container compose children AND a template\n   * claim the region? That is duplication, whatever order they rendered in.\n   */\n  composedAutomatically: { current: boolean };\n}\n\nconst ComposedChildrenRegistryContext = createContext<ComposedChildrenRegistryValue | null>(null);\n\nexport interface ComposedChildrenRegistryProviderProps {\n  children: React.ReactNode;\n}\n\n/**\n * Hosts an ownership handshake for one render pass of one record surface.\n *\n * Clears the set on every render so the registry describes THIS pass. The\n * context value is identity-stable across renders (the ref wrapper), so\n * providing it costs no extra re-render of the subtree.\n */\nexport function ComposedChildrenRegistryProvider({\n  children,\n}: ComposedChildrenRegistryProviderProps): React.JSX.Element {\n  const ref = useRef<ComposedChildrenRegistryValue>({\n    placed: new Set<string>(),\n    owned: { current: false },\n    composedAutomatically: { current: false },\n  });\n  // Cleared during render, before any descendant registers — descendants render\n  // strictly after this component's body, so nothing registered this pass is lost.\n  ref.current.placed.clear();\n  ref.current.owned.current = false;\n  ref.current.composedAutomatically.current = false;\n  const value = useMemo(() => ref.current, []);\n\n  // After commit, so render ORDER is irrelevant and only the outcome is judged.\n  useEffect(() => {\n    const registry = ref.current;\n    if (!registry.composedAutomatically.current) {\n      return;\n    }\n    if (registry.owned.current || registry.placed.size > 0) {\n      warnDuplicatedChildComposition([...registry.placed]);\n    }\n  });\n\n  return (\n    <ComposedChildrenRegistryContext.Provider value={value}>\n      {children}\n    </ComposedChildrenRegistryContext.Provider>\n  );\n}\n\n/**\n * Called by an embed while it renders, to claim a child on behalf of the\n * template that placed it. A no-op outside a registry host (an embed used in a\n * composite view or a standalone preview claims nothing and suppresses nothing).\n */\n/** One warning per placed set — a mis-ordered surface re-renders freely. */\nconst warnedDuplications = new Set<string>();\n\nfunction warnDuplicatedChildComposition(placed: readonly string[]): void {\n  const key = placed.slice().sort().join(',');\n  if (warnedDuplications.has(key)) {\n    return;\n  }\n  warnedDuplications.add(key);\n  LoggerFrontendService.getLogger().warn(\n    '[composed-children] A template claimed the child region AND the automatic container composed children '\n    + `in the same pass, so children render TWICE${placed.length > 0 ? ` (placed: ${placed.join(', ')})` : ''}. `\n    + 'The handshake is render-phase, so the template must render BEFORE the container — check that the '\n    + 'surface still renders its display template above <ResourceLayout_ContainerNested>.',\n  );\n}\n\nexport function useRegisterComposedChild(childResourceType: string | undefined): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry && childResourceType) {\n    registry.placed.add(childResourceType);\n  }\n}\n\n/**\n * `true` when the template composed the child region itself, in which case the\n * automatic container renders nothing.\n *\n * `false` with no host, so a surface without the handshake composes normally —\n * the pre-existing behaviour, unchanged.\n */\nexport function useTemplateOwnsChildComposition(): boolean {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (!registry) return false;\n  return registry.owned.current || registry.placed.size > 0;\n}\n\n/**\n * Claim the child region for the template, whatever it ends up containing.\n *\n * Called by the placement primitive so that naming ZERO children is a decision\n * (\"this surface composes none\") rather than an absence of one (\"nobody said, so\n * compose them all\"). Without it, the only way to express \"no children\" is a\n * per-edge opt-out on every relationship — the configuration axis this design\n * exists to remove.\n */\nexport function useClaimChildComposition(): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry) {\n    registry.owned.current = true;\n  }\n}\n\n/**\n * Which child resource types were placed. Not used to SUPPRESS anything —\n * ownership is whole-surface — but kept because it is what makes a diagnostic\n * able to name the children a template claimed.\n */\nconst EMPTY: ReadonlySet<string> = Object.freeze(new Set<string>());\n\n/**\n * Called by the automatic container to record what it DID this pass. Paired with\n * the provider's post-commit check: \"container composed\" plus \"template claimed\"\n * is duplication, and is the only combination worth reporting.\n */\nexport function useReportAutomaticComposition(composed: boolean): void {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  if (registry && composed) {\n    registry.composedAutomatically.current = true;\n  }\n}\n\nexport function useComposedChildren(): ReadonlySet<string> {\n  const registry = useContext(ComposedChildrenRegistryContext);\n  return registry?.placed ?? EMPTY;\n}\n"]}

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;;;;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"}

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;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"]}

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/EmbeddedResourceHostContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmbeddedResourceHostContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/embeds/EmbeddedResourceHostContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAqDlE,MAAM,2BAA2B,GAAG,aAAa,CAA0C,IAAI,CAAC,CAAC;AAMjG,MAAM,UAAU,4BAA4B,CAAC,EAC3C,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,QAAQ,GAC0B;IAClC;;;;;;;OAOG;IACH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC,EAC7F,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,cAAc,EAAE,mBAAmB,CAAC,CACpF,CAAC;IAEF,OAAO,CACL,KAAC,2BAA2B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC/C,QAAQ,GAC4B,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yGAAyG;cACvG,uGAAuG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sCAAsC;IACpD,OAAO,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACjD,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useMemo } from 'react';\n\nimport type { NavigationInitiatorContext, NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\n/**\n * The context an EMBEDDED resource surface needs from whatever is hosting it.\n *\n * This is deliberately host-NEUTRAL. Two different kinds of host provide it:\n *\n * - a **composite view**, through `CompositeViewProvider`, which layers its own\n *   composite-only concerns (`viewDefinition`, `breakpoint`) on top; and\n * - a **resource layout** — a READ/custom operation surface whose authored\n *   template places a child directly.\n *\n * ## Why it exists\n *\n * The embed family (`EmbedRelatedResourceOperation` and its siblings) resolves\n * everything it needs from the resource REGISTRY: nothing in its operation\n * resolution, addressability or context derivation is composite-specific. Only\n * its PLUMBING was — it read `useCompositeViewContext()`, which throws outside a\n * `CompositeViewProvider`, and `CompositeViewContextValue` mandates a\n * `viewDefinition` that a resource layout does not have and must not fabricate.\n *\n * Splitting that plumbing out is what lets one embed family serve composite\n * views, custom operation hosts and resource layout templates alike, instead of\n * a second family growing up beside it for the resource plane.\n *\n * ## What belongs here, and what does not\n *\n * Only facts about the HOST RECORD and the navigation the embed inherits.\n * `viewDefinition` and `breakpoint` stay on the composite context because they\n * describe a composite view, not a host record — a resource layout has neither.\n *\n * Note `parentResourcesRequirements` is deliberately absent: it is DERIVED from\n * `hostResourceType` + `contextResourceIdentifiers` against the registry, and\n * carrying it as well would create a second, drifting authority for the same fact.\n */\nexport interface EmbeddedResourceHostContextValue {\n  /**\n   * Resource type of the record the embed hangs off. Optional because a host may\n   * legitimately be app-scoped rather than resource-scoped; the embed's own\n   * `buildOperationContext` fails closed when it is absent, which is correct —\n   * a related-resource embed is meaningless without a host record.\n   */\n  hostResourceType?: string;\n  /** Context identifiers of the host record and its ancestors, keyed by resource type. */\n  contextResourceIdentifiers?: Record<string, string>;\n  /** Navigation zone the embedded surface inherits from its host. */\n  navigationZone: NavigationZone;\n  /** Initiator carried into navigations the embedded surface starts. */\n  navigationInitiator?: NavigationInitiatorContext;\n}\n\nconst EmbeddedResourceHostContext = createContext<EmbeddedResourceHostContextValue | null>(null);\n\nexport interface EmbeddedResourceHostProviderProps extends EmbeddedResourceHostContextValue {\n  children: React.ReactNode;\n}\n\nexport function EmbeddedResourceHostProvider({\n  hostResourceType,\n  contextResourceIdentifiers,\n  navigationZone,\n  navigationInitiator,\n  children,\n}: EmbeddedResourceHostProviderProps): React.JSX.Element {\n  /**\n   * IDENTITY-STABLE value. Without the memo every embedded surface under this\n   * provider receives a fresh object each render and rebuilds its\n   * `resourceContext` from it — which clones resource configs (the measured\n   * 603-config heap churn) and re-fires every effect keyed on that identity.\n   * Callers must keep `contextResourceIdentifiers` stable upstream for this to\n   * hold; `CompositeView` already memoizes its own.\n   */\n  const value = useMemo<EmbeddedResourceHostContextValue>(\n    () => ({ hostResourceType, contextResourceIdentifiers, navigationZone, navigationInitiator }),\n    [hostResourceType, contextResourceIdentifiers, navigationZone, navigationInitiator],\n  );\n\n  return (\n    <EmbeddedResourceHostContext.Provider value={value}>\n      {children}\n    </EmbeddedResourceHostContext.Provider>\n  );\n}\n\n/**\n * Throws when no host provides the context. The message names BOTH hosts on\n * purpose: the previous error said only \"must be used within a\n * CompositeViewProvider\", which sent anyone embedding from a resource layout\n * looking for a composite view they neither have nor need.\n */\nexport function useEmbeddedResourceHostContext(): EmbeddedResourceHostContextValue {\n  const context = useContext(EmbeddedResourceHostContext);\n  if (!context) {\n    throw new Error(\n      'useEmbeddedResourceHostContext must be used inside a host that provides an embedded-resource context — '\n      + 'a composite view (CompositeViewProvider) or a resource layout surface (EmbeddedResourceHostProvider).',\n    );\n  }\n  return context;\n}\n\nexport function useOptionalEmbeddedResourceHostContext(): EmbeddedResourceHostContextValue | null {\n  return useContext(EmbeddedResourceHostContext);\n}\n"]}
+{"version":3,"file":"EmbeddedResourceHostContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/embeds/EmbeddedResourceHostContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAqDlE,MAAM,2BAA2B,GAAG,aAAa,CAA0C,IAAI,CAAC,CAAC;AAMjG,MAAM,UAAU,4BAA4B,CAAC,EAC3C,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,QAAQ,GAC0B;IAClC;;;;;;;OAOG;IACH,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC,EAC7F,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,cAAc,EAAE,mBAAmB,CAAC,CACpF,CAAC;IAEF,OAAO,CACL,KAAC,2BAA2B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC/C,QAAQ,GAC4B,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yGAAyG;cACvG,uGAAuG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sCAAsC;IACpD,OAAO,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACjD,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useMemo } from 'react';\n\nimport type { NavigationInitiatorContext, NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\n/**\n * The context an EMBEDDED resource surface needs from whatever is hosting it.\n *\n * This is deliberately host-NEUTRAL. Two different kinds of host provide it:\n *\n * - a **composite view**, through `CompositeViewProvider`, which layers its own\n *   composite-only concerns (`viewDefinition`, `breakpoint`) on top; and\n * - a **resource layout** — a READ/custom operation surface whose authored\n *   template places a child directly.\n *\n * ## Why it exists\n *\n * The embed family (`EmbedRelatedResourceOperation` and its siblings) resolves\n * everything it needs from the resource REGISTRY: nothing in its operation\n * resolution, addressability or context derivation is composite-specific. Only\n * its PLUMBING was — it read `useCompositeViewContext()`, which throws outside a\n * `CompositeViewProvider`, and `CompositeViewContextValue` mandates a\n * `viewDefinition` that a resource layout does not have and must not fabricate.\n *\n * Splitting that plumbing out is what lets one embed family serve composite\n * views, custom operation hosts and resource layout templates alike, instead of\n * a second family growing up beside it for the resource plane.\n *\n * ## What belongs here, and what does not\n *\n * Only facts about the HOST RECORD and the navigation the embed inherits.\n * `viewDefinition` and `breakpoint` stay on the composite context because they\n * describe a composite view, not a host record — a resource layout has neither.\n *\n * Note `parentResourcesRequirements` is deliberately absent: it is DERIVED from\n * `hostResourceType` + `contextResourceIdentifiers` against the registry, and\n * carrying it as well would create a second, drifting authority for the same fact.\n */\nexport interface EmbeddedResourceHostContextValue {\n  /**\n   * Resource type of the record the embed hangs off. Optional because a host may\n   * legitimately be app-scoped rather than resource-scoped; the embed's own\n   * `buildOperationContext` fails closed when it is absent, which is correct —\n   * a related-resource embed is meaningless without a host record.\n   */\n  hostResourceType?: string;\n  /** Context identifiers of the host record and its ancestors, keyed by resource type. */\n  contextResourceIdentifiers?: Record<string, string>;\n  /** Navigation zone the embedded surface inherits from its host. */\n  navigationZone: NavigationZone;\n  /** Initiator carried into navigations the embedded surface starts. */\n  navigationInitiator?: NavigationInitiatorContext;\n}\n\nconst EmbeddedResourceHostContext = createContext<EmbeddedResourceHostContextValue | null>(null);\n\nexport interface EmbeddedResourceHostProviderProps extends EmbeddedResourceHostContextValue {\n  children: React.ReactNode;\n}\n\nexport function EmbeddedResourceHostProvider({\n  hostResourceType,\n  contextResourceIdentifiers,\n  navigationZone,\n  navigationInitiator,\n  children,\n}: EmbeddedResourceHostProviderProps): React.JSX.Element {\n  /**\n   * IDENTITY-STABLE value. Without the memo every embedded surface under this\n   * provider receives a fresh object each render and rebuilds its\n   * `resourceContext` from it — which clones resource configs (the measured\n   * 603-config heap churn) and re-fires every effect keyed on that identity.\n   * Callers must keep `contextResourceIdentifiers` stable upstream for this to\n   * hold; `CompositeView` already memoizes its own.\n   */\n  const value = useMemo<EmbeddedResourceHostContextValue>(\n    () => ({ hostResourceType, contextResourceIdentifiers, navigationZone, navigationInitiator }),\n    [hostResourceType, contextResourceIdentifiers, navigationZone, navigationInitiator],\n  );\n\n  return (\n    <EmbeddedResourceHostContext.Provider value={value}>\n      {children}\n    </EmbeddedResourceHostContext.Provider>\n  );\n}\n\n/**\n * Throws when no host provides the context. The message names BOTH hosts on\n * purpose: the previous error said only \"must be used within a\n * CompositeViewProvider\", which sent anyone embedding from a resource layout\n * looking for a composite view they neither have nor need.\n */\nexport function useEmbeddedResourceHostContext(): EmbeddedResourceHostContextValue {\n  const context = useContext(EmbeddedResourceHostContext);\n  if (!context) {\n    throw new Error(\n      'useEmbeddedResourceHostContext must be used inside a host that provides an embedded-resource context — '\n      + 'a composite view (CompositeViewProvider) or a resource layout surface (EmbeddedResourceHostProvider).',\n    );\n  }\n  return context;\n}\n\nexport function useOptionalEmbeddedResourceHostContext(): EmbeddedResourceHostContextValue | null {\n  return useContext(EmbeddedResourceHostContext);\n}\n"]}

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

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

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

@@ -57,7 +57,7 @@ export function RelatedResourcePreviewSurface({ childContext, inlineLimit, showV
     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;

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

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

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

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