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

package/dist/esm/components/resources/skeleton/ResourceHeaderTitle.js

@@ -1,5 +1,5 @@
 'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * ResourceHeaderTitle — the record's page TITLE as a first-class, composable
  * element of an authored `layout.header` template.
@@ -23,18 +23,32 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *
  * ## Contract
  *
- * The header cedes the middle region to the template the moment `layout.header`
+ * The header cedes the record's identity to the template the moment `layout.header`
  * exists, so a template that never mounts `<ResourceHeaderTitle />` renders a
  * page with NO record name. That is loud in development (see the diagnostic in
  * `ResourceLayout_Header`) rather than silent.
  *
+ * ## Where the title lands (2026-09-30)
+ *
+ * The header is three lines: a bar (back, breadcrumb, a pane's own controls), the TITLE LINE (the
+ * name and the record's actions), and the FACTS line (the rest of the template: status, priority,
+ * the parent chip). A template places `<ResourceHeaderTitle />` among its facts as it always did; the
+ * header renders the title on the title line and the rest of the template on the facts line. So the
+ * name always sits beside the actions it is the subject of, and the facts never push the actions off
+ * the name's line, which is what a single wrapping row did: measured on Wonder Todos, a todo in the
+ * split pane had its title 41px above its own back arrow and actions.
+ *
  * Renders nothing when the host resolved no label (a surface that shows a
  * generic operation title rather than one record's name) — the presence of a
  * label is the single data-driven signal that there is a title to place.
  */
 import { createContext, useContext } from 'react';
+import { createPortal } from 'react-dom';
+import { TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';
 import { Skeleton } from '../../../components/feedback/skeleton.js';
 import { cn } from '../../../core/ui/cn.js';
+import { UIContext } from '../../../core/ui/UIContext.js';
+import { defaultTheme } from '../../../core/ui/themes/default.theme.js';
 const ResourceHeaderContext = createContext(null);
 /** Provides the resolved record title to an authored header template tree. */
 export function ResourceHeaderContextProvider({ value, children, }) {
@@ -48,21 +62,53 @@ export function useOptionalResourceHeaderContext() {
     return useContext(ResourceHeaderContext);
 }
 /**
- * The record's name, rendered with the page-header typography the default
- * (template-less) header uses — so authoring a header template is visually
- * neutral for the title itself and only adds what the template places around it.
+ * The name a resource page is about, set in the theme's `TypographyVariant.RESOURCE_TITLE` voice —
+ * quieter than a document heading, because it shares its line with the record's actions. Used by the
+ * header's default title and by `<ResourceHeaderTitle />`, so authoring a header template never
+ * changes how the title looks.
  *
- * ## It is an `h1`, and the level is not cosmetic
+ * ## It is a real heading, and the level is not cosmetic
  *
- * This IS the page's title — the record's name on a record page, the collection's on a listing — and
- * there is exactly one per surface, so it owns the top of the document outline. It was an `h2` until
- * 2026-09-09, which left generated screens with NO level-one heading at all: the first accessibility
- * audit ever run against a live stack reported `page-has-heading-one` on the collection listing,
- * where this element was the only heading on the page (#533).
+ * `h1` on a page: this IS the page's title — the record's name on a record page, the collection's on a
+ * listing — and there is exactly one, so it owns the top of the document outline (an `h2` there once
+ * left generated screens with no level-one heading at all, #533). `h2` under a host section that owns
+ * the heading. The level is structure; the recipe is appearance, and the two are decoupled.
+ */
+export function ResourceHeaderTitleHeading({ title, hostProvidesHeading, className, }) {
+    // `min-w-0` + truncate so a long record name shrinks rather than pushing the actions off its line.
+    const classes = cn('min-w-0 truncate', useResourceTitleVoice(), className);
+    return hostProvidesHeading
+        ? _jsx("h2", { className: classes, children: title })
+        : _jsx("h1", { className: classes, children: title });
+}
+/**
+ * The line a resource title holds while the name is on its way: one skeleton exactly one line box of
+ * the theme's `RESOURCE_TITLE` voice tall. It is set in that voice and sized in `lh`, so it matches the
+ * real title's line in every theme (text-lg by default, text-xl in cozy and editorial, text-base in
+ * dense) and the name's arrival moves nothing beneath it. A fixed height could match only one theme.
  *
- * The classes are unchanged, so nothing moves visually — `text-xl` still sets the size. A heading
- * level is the document's structure, not its appearance, and the two are deliberately decoupled here
- * exactly as the design system does elsewhere.
+ * For a custom header preset: render it where the title will land while the name is on its way.
+ * `<ResourceHeaderTitle />` already uses it, so a header TEMPLATE never needs to.
+ */
+export function ResourceHeaderTitlePlaceholder({ className }) {
+    return (_jsx("div", { className: cn('min-w-0', useResourceTitleVoice(), className), "aria-hidden": "true", "data-resource-header-title-pending": "true", children: _jsx(Skeleton, { className: "h-[1lh] w-48 max-w-full" }) }));
+}
+/**
+ * The theme's resource-title typography classes. Read defensively: a header template can be previewed
+ * outside the app's `UIProvider`, and a title must not throw there. Without a theme it takes the default
+ * theme's voice.
+ */
+function useResourceTitleVoice() {
+    const ui = useContext(UIContext);
+    const recipe = ui
+        ? ui.getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.RESOURCE_TITLE)
+        : defaultTheme.typography?.[TypographyVariant.RESOURCE_TITLE];
+    return recipe?.base;
+}
+/**
+ * The record's name, placed by an authored `layout.header` template. Inside a resource header it
+ * renders on the header's title line, beside the record's actions (see "Where the title lands"
+ * above); the rest of the template stays on the facts line below.
  */
 export function ResourceHeaderTitle({ className }) {
     const header = useOptionalResourceHeaderContext();
@@ -72,19 +118,46 @@ export function ResourceHeaderTitle({ className }) {
     if (header?.titleMountTracker)
         header.titleMountTracker.titleMounted = true;
     const title = header?.title;
-    if (!title) {
+    const element = title
+        ? _jsx(ResourceHeaderTitleHeading, { title: title, hostProvidesHeading: header?.hostProvidesHeading, className: className })
         // A name that is on its way reserves its line, so its arrival moves nothing beneath the header;
-        // a surface with no name at all still renders nothing. `h-7` is `text-xl`'s own line box.
-        return header?.titlePending
-            ? _jsx(Skeleton, { className: "h-7 w-48 max-w-full", "aria-hidden": "true", "data-resource-header-title-pending": "true" })
+        // a surface with no name at all still renders nothing.
+        : header?.titlePending
+            ? _jsx(ResourceHeaderTitlePlaceholder, {})
             : null;
+    if (!element)
+        return null;
+    // Inside a header: onto its title line. `null` = the line is attaching; render nothing for that pass.
+    if (header?.titleTarget !== undefined) {
+        return header.titleTarget ? createPortal(element, header.titleTarget) : null;
+    }
+    return element;
+}
+/**
+ * Something that belongs BEFORE the record's name on the title line — an accent swatch, a family glyph —
+ * placed by an authored `layout.header` template:
+ *
+ * ```tsx
+ * header: () => (
+ *   <div className="flex min-w-0 flex-wrap items-center gap-field">
+ *     <ResourceHeaderLeading><span className="size-3 rounded-full" style={{ background: color }} /></ResourceHeaderLeading>
+ *     <ResourceHeaderTitle />
+ *     <DisplayField name="status" hideLabel hideDescription className="w-auto" />
+ *   </div>
+ * ),
+ * ```
+ *
+ * The header lifts the title onto its title line and leaves the rest of the template on the facts line
+ * below, so an element a template puts before the title stays with the facts unless it says it leads the
+ * name. That is this: inside a header it renders just before the name; outside one (a template previewed
+ * in isolation) it renders where it is written. A resource whose glyph replaces the resource icon
+ * (`HeaderIconPlacement.TEMPLATE_OWNED`) places it here, so the title line keeps a glyph.
+ */
+export function ResourceHeaderLeading({ children }) {
+    const header = useOptionalResourceHeaderContext();
+    if (header?.leadingTarget !== undefined) {
+        return header.leadingTarget ? createPortal(children, header.leadingTarget) : null;
     }
-    return (
-    // `min-w-0` + truncate so a long record name shrinks instead of pushing the
-    // template's trailing badges out of the band. No `flex-1`: the title claims
-    // only the space it needs, which is what keeps an authored badge HUGGING the
-    // name rather than being flung to the far end of the row (the same
-    // composition lesson recorded on `SummaryTitle`).
-    header?.hostProvidesHeading ? (_jsx("h2", { className: cn('min-w-0 truncate text-xl font-semibold text-foreground', className), children: title })) : (_jsx("h1", { className: cn('min-w-0 truncate text-xl font-semibold text-foreground', className), children: title })));
+    return _jsx(_Fragment, { children: children });
 }
 //# sourceMappingURL=ResourceHeaderTitle.js.map

package/dist/esm/components/resources/skeleton/ResourceHeaderTitle.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceHeaderTitle.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAgDpD,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOrF,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAkC,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAA4B;IACzE,MAAM,MAAM,GAAG,gCAAgC,EAAE,CAAC;IAClD,0EAA0E;IAC1E,4EAA4E;IAC5E,gFAAgF;IAChF,IAAI,MAAM,EAAE,iBAAiB;QAAE,MAAM,CAAC,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gGAAgG;QAChG,0FAA0F;QAC1F,OAAO,MAAM,EAAE,YAAY;YACzB,CAAC,CAAC,KAAC,QAAQ,IAAC,SAAS,EAAC,qBAAqB,iBAAa,MAAM,wCAAoC,MAAM,GAAG;YAC3G,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,OAAO;IACL,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,mEAAmE;IACnE,kDAAkD;IAClD,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAC5B,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CAAC,CAAC,CAAC,CACF,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CACF,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * ResourceHeaderTitle — the record's page TITLE as a first-class, composable\n * element of an authored `layout.header` template.\n *\n * ## Why the header needs a template flow at all\n *\n * The READ page header owns a fixed band: back button, breadcrumb, resource\n * icon, the record's name, and the operation action cluster. Everything a\n * resource wanted to show ABOUT the record (a status badge, a visibility\n * marker, an accent colour) could previously only render in the `layout.display`\n * body BELOW that band — so the identity line said the record's name and nothing\n * else, while \"is this archived? is it public?\" sat in a separate labelled strip\n * underneath.\n *\n * `layout.header` closes that by letting the resource compose the middle of the\n * band itself. It is the same shape the SUMMARY surface already uses\n * (`SummaryLayout` / `SummaryTitle`), for the same reason recorded there: a\n * host-owned title plus a bolt-on accessory slot cannot express \"badge AFTER the\n * name\" or \"swatch BEFORE it\", whereas a template that places the title element\n * itself can express any of them with no extra config axis.\n *\n * ## Contract\n *\n * The header cedes the middle region to the template the moment `layout.header`\n * exists, so a template that never mounts `<ResourceHeaderTitle />` renders a\n * page with NO record name. That is loud in development (see the diagnostic in\n * `ResourceLayout_Header`) rather than silent.\n *\n * Renders nothing when the host resolved no label (a surface that shows a\n * generic operation title rather than one record's name) — the presence of a\n * label is the single data-driven signal that there is a title to place.\n */\n\nimport React, { createContext, useContext } from 'react';\n\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nexport interface ResourceHeaderContextValue {\n  /** Resource type key of the record whose header is rendering. */\n  resourceType: string;\n\n  /**\n   * Resolved record title (the `getFrontendResourceLabel` result, or the\n   * operation/resource title fallback), or `null` when this surface has no\n   * record-specific name to show — `<ResourceHeaderTitle />` then renders nothing.\n   */\n  title: string | null;\n\n  /**\n   * `true` while the record's name is still being fetched and nothing else stands in for it.\n   * `<ResourceHeaderTitle />` then RESERVES the title's line with a skeleton instead of rendering\n   * nothing.\n   *\n   * An empty band is a defect, not a flicker. The header withholds the label during the first fetch\n   * on purpose (it would otherwise flash `#id` and then the real name), and the title element used to\n   * render nothing meanwhile — so the band had no height and the name's arrival pushed everything\n   * beneath it down by a line. Measured 2026-09-21 in the creation workbench's actor-task modal:\n   * `mousedown` landed on a tab, the record arrived, `mouseup` one millisecond later landed on the\n   * heading, and the browser dispatched the click to their common ancestor. The tab never changed\n   * and nothing reported why.\n   */\n  titlePending?: boolean;\n\n  /**\n   * Dev-diagnostic seam: `<ResourceHeaderTitle />` flips `titleMounted` when it\n   * renders, letting the header detect an authored template that never places\n   * the title. Mutable-ref shape (not state) on purpose — the flag is read only\n   * after render and must never schedule a re-render.\n   */\n  titleMountTracker?: { titleMounted: boolean };\n\n  /**\n   * `true` when an enclosing section already renders the heading for this region (an embedded READ inside\n   * a host section). The record's name is then not the PAGE title, so `<ResourceHeaderTitle />` renders an\n   * `h2` beneath the host's heading instead of a second `h1` — the same rule the default header applies.\n   */\n  hostProvidesHeading?: boolean;\n}\n\nconst ResourceHeaderContext = createContext<ResourceHeaderContextValue | null>(null);\n\nexport interface ResourceHeaderContextProviderProps {\n  value: ResourceHeaderContextValue;\n  children: React.ReactNode;\n}\n\n/** Provides the resolved record title to an authored header template tree. */\nexport function ResourceHeaderContextProvider({\n  value,\n  children,\n}: ResourceHeaderContextProviderProps): React.JSX.Element {\n  return <ResourceHeaderContext.Provider value={value}>{children}</ResourceHeaderContext.Provider>;\n}\n\n/**\n * Read the header context, or `null` when a header template is rendered outside\n * `ResourceLayout_Header` (e.g. previewed in isolation).\n */\nexport function useOptionalResourceHeaderContext(): ResourceHeaderContextValue | null {\n  return useContext(ResourceHeaderContext);\n}\n\n// =============================================================================\n// TITLE ELEMENT\n// =============================================================================\n\n/** @wildo_source:part:start saas.frontend.resource-header-title facet:layer:frontend facet:family:resource-ui */\nexport interface ResourceHeaderTitleProps {\n  /** Extra classes merged over the default page-title styling. */\n  className?: string;\n}\n\n/**\n * The record's name, rendered with the page-header typography the default\n * (template-less) header uses — so authoring a header template is visually\n * neutral for the title itself and only adds what the template places around it.\n *\n * ## It is an `h1`, and the level is not cosmetic\n *\n * This IS the page's title — the record's name on a record page, the collection's on a listing — and\n * there is exactly one per surface, so it owns the top of the document outline. It was an `h2` until\n * 2026-09-09, which left generated screens with NO level-one heading at all: the first accessibility\n * audit ever run against a live stack reported `page-has-heading-one` on the collection listing,\n * where this element was the only heading on the page (#533).\n *\n * The classes are unchanged, so nothing moves visually — `text-xl` still sets the size. A heading\n * level is the document's structure, not its appearance, and the two are deliberately decoupled here\n * exactly as the design system does elsewhere.\n */\nexport function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): React.JSX.Element | null {\n  const header = useOptionalResourceHeaderContext();\n  // Register with the missing-title diagnostic BEFORE the empty-title early\n  // return: mounting the element discharges the template's contract even when\n  // this particular record resolves no label (data-driven, not an authoring bug).\n  if (header?.titleMountTracker) header.titleMountTracker.titleMounted = true;\n\n  const title = header?.title;\n  if (!title) {\n    // A name that is on its way reserves its line, so its arrival moves nothing beneath the header;\n    // a surface with no name at all still renders nothing. `h-7` is `text-xl`'s own line box.\n    return header?.titlePending\n      ? <Skeleton className=\"h-7 w-48 max-w-full\" aria-hidden=\"true\" data-resource-header-title-pending=\"true\" />\n      : null;\n  }\n\n  return (\n    // `min-w-0` + truncate so a long record name shrinks instead of pushing the\n    // template's trailing badges out of the band. No `flex-1`: the title claims\n    // only the space it needs, which is what keeps an authored badge HUGGING the\n    // name rather than being flung to the far end of the row (the same\n    // composition lesson recorded on `SummaryTitle`).\n    header?.hostProvidesHeading ? (\n      <h2 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h2>\n    ) : (\n      <h1 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h1>\n    )\n  );\n}\n/** @wildo_source:part:end saas.frontend.resource-header-title */\n"]}
+{"version":3,"file":"ResourceHeaderTitle.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\n/**\n * ResourceHeaderTitle — the record's page TITLE as a first-class, composable\n * element of an authored `layout.header` template.\n *\n * ## Why the header needs a template flow at all\n *\n * The READ page header owns a fixed band: back button, breadcrumb, resource\n * icon, the record's name, and the operation action cluster. Everything a\n * resource wanted to show ABOUT the record (a status badge, a visibility\n * marker, an accent colour) could previously only render in the `layout.display`\n * body BELOW that band — so the identity line said the record's name and nothing\n * else, while \"is this archived? is it public?\" sat in a separate labelled strip\n * underneath.\n *\n * `layout.header` closes that by letting the resource compose the middle of the\n * band itself. It is the same shape the SUMMARY surface already uses\n * (`SummaryLayout` / `SummaryTitle`), for the same reason recorded there: a\n * host-owned title plus a bolt-on accessory slot cannot express \"badge AFTER the\n * name\" or \"swatch BEFORE it\", whereas a template that places the title element\n * itself can express any of them with no extra config axis.\n *\n * ## Contract\n *\n * The header cedes the record's identity to the template the moment `layout.header`\n * exists, so a template that never mounts `<ResourceHeaderTitle />` renders a\n * page with NO record name. That is loud in development (see the diagnostic in\n * `ResourceLayout_Header`) rather than silent.\n *\n * ## Where the title lands (2026-09-30)\n *\n * The header is three lines: a bar (back, breadcrumb, a pane's own controls), the TITLE LINE (the\n * name and the record's actions), and the FACTS line (the rest of the template: status, priority,\n * the parent chip). A template places `<ResourceHeaderTitle />` among its facts as it always did; the\n * header renders the title on the title line and the rest of the template on the facts line. So the\n * name always sits beside the actions it is the subject of, and the facts never push the actions off\n * the name's line, which is what a single wrapping row did: measured on Wonder Todos, a todo in the\n * split pane had its title 41px above its own back arrow and actions.\n *\n * Renders nothing when the host resolved no label (a surface that shows a\n * generic operation title rather than one record's name) — the presence of a\n * label is the single data-driven signal that there is a title to place.\n */\n\nimport React, { createContext, useContext } from 'react';\nimport { createPortal } from 'react-dom';\nimport { TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';\n\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { defaultTheme } from '~wildo-frontend-lib/core/ui/themes/default.theme';\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nexport interface ResourceHeaderContextValue {\n  /** Resource type key of the record whose header is rendering. */\n  resourceType: string;\n\n  /**\n   * Resolved record title (the `getFrontendResourceLabel` result, or the\n   * operation/resource title fallback), or `null` when this surface has no\n   * record-specific name to show — `<ResourceHeaderTitle />` then renders nothing.\n   */\n  title: string | null;\n\n  /**\n   * `true` while the record's name is still being fetched and nothing else stands in for it.\n   * `<ResourceHeaderTitle />` then RESERVES the title's line with a skeleton instead of rendering\n   * nothing.\n   *\n   * An empty band is a defect, not a flicker. The header withholds the label during the first fetch\n   * on purpose (it would otherwise flash `#id` and then the real name), and the title element used to\n   * render nothing meanwhile — so the band had no height and the name's arrival pushed everything\n   * beneath it down by a line. Measured 2026-09-21 in the creation workbench's actor-task modal:\n   * `mousedown` landed on a tab, the record arrived, `mouseup` one millisecond later landed on the\n   * heading, and the browser dispatched the click to their common ancestor. The tab never changed\n   * and nothing reported why.\n   */\n  titlePending?: boolean;\n\n  /**\n   * Dev-diagnostic seam: `<ResourceHeaderTitle />` flips `titleMounted` when it\n   * renders, letting the header detect an authored template that never places\n   * the title. Mutable-ref shape (not state) on purpose — the flag is read only\n   * after render and must never schedule a re-render.\n   */\n  titleMountTracker?: { titleMounted: boolean };\n\n  /**\n   * `true` when an enclosing section already renders the heading for this region (an embedded READ inside\n   * a host section). The record's name is then not the PAGE title, so `<ResourceHeaderTitle />` renders an\n   * `h2` beneath the host's heading instead of a second `h1` — the same rule the default header applies.\n   */\n  hostProvidesHeading?: boolean;\n\n  /**\n   * The header's TITLE LINE, when the header has one: `<ResourceHeaderTitle />` renders the name THERE,\n   * beside the record's actions, instead of in the template's own flow (the facts line). `undefined`\n   * means the template's own flow (a template previewed outside a header); `null` means the line is\n   * not attached yet — the title then renders nothing for the one layout pass it takes to attach.\n   */\n  titleTarget?: HTMLElement | null;\n\n  /**\n   * The header's LEADING slot on the title line, just before the name: `<ResourceHeaderLeading>` renders\n   * there. Same `undefined` / `null` reading as {@link titleTarget}.\n   */\n  leadingTarget?: HTMLElement | null;\n}\n\nconst ResourceHeaderContext = createContext<ResourceHeaderContextValue | null>(null);\n\nexport interface ResourceHeaderContextProviderProps {\n  value: ResourceHeaderContextValue;\n  children: React.ReactNode;\n}\n\n/** Provides the resolved record title to an authored header template tree. */\nexport function ResourceHeaderContextProvider({\n  value,\n  children,\n}: ResourceHeaderContextProviderProps): React.JSX.Element {\n  return <ResourceHeaderContext.Provider value={value}>{children}</ResourceHeaderContext.Provider>;\n}\n\n/**\n * Read the header context, or `null` when a header template is rendered outside\n * `ResourceLayout_Header` (e.g. previewed in isolation).\n */\nexport function useOptionalResourceHeaderContext(): ResourceHeaderContextValue | null {\n  return useContext(ResourceHeaderContext);\n}\n\n// =============================================================================\n// TITLE ELEMENT\n// =============================================================================\n\n/** @wildo_source:part:start saas.frontend.resource-header-title facet:layer:frontend facet:family:resource-ui */\nexport interface ResourceHeaderTitleProps {\n  /** Extra classes merged over the theme's resource-title typography. */\n  className?: string;\n}\n\n/**\n * The name a resource page is about, set in the theme's `TypographyVariant.RESOURCE_TITLE` voice —\n * quieter than a document heading, because it shares its line with the record's actions. Used by the\n * header's default title and by `<ResourceHeaderTitle />`, so authoring a header template never\n * changes how the title looks.\n *\n * ## It is a real heading, and the level is not cosmetic\n *\n * `h1` on a page: this IS the page's title — the record's name on a record page, the collection's on a\n * listing — and there is exactly one, so it owns the top of the document outline (an `h2` there once\n * left generated screens with no level-one heading at all, #533). `h2` under a host section that owns\n * the heading. The level is structure; the recipe is appearance, and the two are decoupled.\n */\nexport function ResourceHeaderTitleHeading({\n  title,\n  hostProvidesHeading,\n  className,\n}: {\n  title: string;\n  hostProvidesHeading?: boolean;\n  className?: string;\n}): React.JSX.Element {\n  // `min-w-0` + truncate so a long record name shrinks rather than pushing the actions off its line.\n  const classes = cn('min-w-0 truncate', useResourceTitleVoice(), className);\n  return hostProvidesHeading\n    ? <h2 className={classes}>{title}</h2>\n    : <h1 className={classes}>{title}</h1>;\n}\n\n/**\n * The line a resource title holds while the name is on its way: one skeleton exactly one line box of\n * the theme's `RESOURCE_TITLE` voice tall. It is set in that voice and sized in `lh`, so it matches the\n * real title's line in every theme (text-lg by default, text-xl in cozy and editorial, text-base in\n * dense) and the name's arrival moves nothing beneath it. A fixed height could match only one theme.\n *\n * For a custom header preset: render it where the title will land while the name is on its way.\n * `<ResourceHeaderTitle />` already uses it, so a header TEMPLATE never needs to.\n */\nexport function ResourceHeaderTitlePlaceholder({ className }: { className?: string }): React.JSX.Element {\n  return (\n    <div className={cn('min-w-0', useResourceTitleVoice(), className)} aria-hidden=\"true\" data-resource-header-title-pending=\"true\">\n      <Skeleton className=\"h-[1lh] w-48 max-w-full\" />\n    </div>\n  );\n}\n\n/**\n * The theme's resource-title typography classes. Read defensively: a header template can be previewed\n * outside the app's `UIProvider`, and a title must not throw there. Without a theme it takes the default\n * theme's voice.\n */\nfunction useResourceTitleVoice(): string | undefined {\n  const ui = useContext(UIContext);\n  const recipe = ui\n    ? ui.getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.RESOURCE_TITLE)\n    : defaultTheme.typography?.[TypographyVariant.RESOURCE_TITLE];\n  return recipe?.base;\n}\n\n/**\n * The record's name, placed by an authored `layout.header` template. Inside a resource header it\n * renders on the header's title line, beside the record's actions (see \"Where the title lands\"\n * above); the rest of the template stays on the facts line below.\n */\nexport function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): React.JSX.Element | null {\n  const header = useOptionalResourceHeaderContext();\n  // Register with the missing-title diagnostic BEFORE the empty-title early\n  // return: mounting the element discharges the template's contract even when\n  // this particular record resolves no label (data-driven, not an authoring bug).\n  if (header?.titleMountTracker) header.titleMountTracker.titleMounted = true;\n\n  const title = header?.title;\n  const element = title\n    ? <ResourceHeaderTitleHeading title={title} hostProvidesHeading={header?.hostProvidesHeading} className={className} />\n    // A name that is on its way reserves its line, so its arrival moves nothing beneath the header;\n    // a surface with no name at all still renders nothing.\n    : header?.titlePending\n      ? <ResourceHeaderTitlePlaceholder />\n      : null;\n  if (!element) return null;\n\n  // Inside a header: onto its title line. `null` = the line is attaching; render nothing for that pass.\n  if (header?.titleTarget !== undefined) {\n    return header.titleTarget ? createPortal(element, header.titleTarget) : null;\n  }\n  return element;\n}\n/**\n * Something that belongs BEFORE the record's name on the title line — an accent swatch, a family glyph —\n * placed by an authored `layout.header` template:\n *\n * ```tsx\n * header: () => (\n *   <div className=\"flex min-w-0 flex-wrap items-center gap-field\">\n *     <ResourceHeaderLeading><span className=\"size-3 rounded-full\" style={{ background: color }} /></ResourceHeaderLeading>\n *     <ResourceHeaderTitle />\n *     <DisplayField name=\"status\" hideLabel hideDescription className=\"w-auto\" />\n *   </div>\n * ),\n * ```\n *\n * The header lifts the title onto its title line and leaves the rest of the template on the facts line\n * below, so an element a template puts before the title stays with the facts unless it says it leads the\n * name. That is this: inside a header it renders just before the name; outside one (a template previewed\n * in isolation) it renders where it is written. A resource whose glyph replaces the resource icon\n * (`HeaderIconPlacement.TEMPLATE_OWNED`) places it here, so the title line keeps a glyph.\n */\nexport function ResourceHeaderLeading({ children }: { children: React.ReactNode }): React.JSX.Element | null {\n  const header = useOptionalResourceHeaderContext();\n  if (header?.leadingTarget !== undefined) {\n    return header.leadingTarget ? createPortal(children, header.leadingTarget) : null;\n  }\n  return <>{children}</>;\n}\n/** @wildo_source:part:end saas.frontend.resource-header-title */\n"]}

package/dist/esm/components/resources/skeleton/Section.d.ts

@@ -101,8 +101,15 @@ type SectionProps_Accordion = SectionBaseProps & {
     appearance: SectionMode.ACCORDION;
     allowMultiple?: boolean;
 };
+/**
+ * Truncation over a GROUP of consecutive EXPANDABLE sections: the first `initialVisibleCount` show and
+ * one "Show more" button reveals the rest. Not a toggle — one section, or any group no larger than
+ * `initialVisibleCount`, renders fully open with no button. A single aside revealed on request is
+ * {@link SectionMode.COLLAPSIBLE} with `defaultFocus={false}` (#2197).
+ */
 type SectionProps_Expandable = SectionBaseProps & {
     appearance: SectionMode.EXPANDABLE;
+    /** Sections shown before "Show more". Read from the group's first section. @default 3 */
     initialVisibleCount?: number;
 };
 type SectionProps_Stepper = SectionBaseProps & {

package/dist/esm/components/resources/skeleton/Section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAYnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AA2B1D;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAIF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;CAClC,CAAC;AAEF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IAC3C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC;CAC/B,CAAC;AAEF,KAAK,wBAAwB,GAAG,gBAAgB,GAAG;IACjD,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC;CACrC,CAAC;AAIF,KAAK,mBAAmB,GAAG,gBAAgB,GAAG;IAC5C,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAIF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,yBAAyB,GAAG,gBAAgB,GAAG;IAClD,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IAC3C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC;CAC/B,CAAC;AAIF,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC/C,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,uBAAuB,GAAG,gBAAgB,GAAG;IAChD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAIF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,KAAK,qBAAqB,GAAG,gBAAgB,GAAG;IAC9C,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,GACxB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,yBAAyB,GACzB,kBAAkB,GAClB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;IAC7G;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAuItD;yBAvIe,OAAO;;;AA2IvB,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,eAAuB,GACxB,EAAE,uBAAuB,GAAG,SAAS,CAqCrC;AA+BD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAiD9F"}
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAanE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AA2B1D;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAIF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;CAClC,CAAC;AAEF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IAC3C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC;CAC/B,CAAC;AAEF,KAAK,wBAAwB,GAAG,gBAAgB,GAAG;IACjD,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC;CACrC,CAAC;AAIF,KAAK,mBAAmB,GAAG,gBAAgB,GAAG;IAC5C,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAIF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,yBAAyB,GAAG,gBAAgB,GAAG;IAClD,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IAC3C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC;CAC/B,CAAC;AAIF,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC/C,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,KAAK,uBAAuB,GAAG,gBAAgB,GAAG;IAChD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAIF,KAAK,oBAAoB,GAAG,gBAAgB,GAAG;IAC7C,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,KAAK,qBAAqB,GAAG,gBAAgB,GAAG;IAC9C,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,GACxB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,yBAAyB,GACzB,kBAAkB,GAClB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;IAC7G;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAuItD;yBAvIe,OAAO;;;AA2IvB,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,eAAuB,GACxB,EAAE,uBAAuB,GAAG,SAAS,CAqCrC;AA+BD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAoD9F"}

package/dist/esm/components/resources/skeleton/Section.js

@@ -6,6 +6,7 @@ import { ErrorCustomMessageReference } from '@wildo-ai/saas-models';
 import { SectionMode } from '@wildo-ai/zod-decorators';
 import { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext.js';
+import { validateFieldsAndShowErrors } from '../../form/validation-errors/validate-fields-and-show-errors.js';
 import { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext.js';
 import { FormChromeProvider } from '../../form/chromes/FormChromeContext.js';
 import { DisplayChromeProvider } from '../../data-display/chromes/DisplayChromeContext.js';
@@ -152,7 +153,7 @@ export function Section(props) {
     const content = (_jsx(SectionHostHeadingContext.Provider, { value: !!resolvedLegend, children: _jsxs(SectionFieldsContext.Provider, { value: sectionFieldsContextValue, children: [_jsx(SectionContentWithHostChrome, { hostKind: sectionHostKind, chromeMode: chromeMode, children: children }), isSaveable && _jsx(SectionSaveButton, { sectionName: name, disabled: disabled })] }) }));
     // All four solo modes (DEFAULT / CARD / GHOST / COLLAPSIBLE) are rendered by
     // the ContentSection primitive, which owns the per-mode chrome: a native
-    // <fieldset> (DEFAULT/CARD — the disabled cascade + when-orphan framing), a
+    // <fieldset> (DEFAULT/CARD — the disabled cascade carrier; a card always paints its frame), a
     // flat <div> (GHOST), or a Collapsible toggle (COLLAPSIBLE). The legend and
     // description are passed as structured props so the primitive can place the
     // legend as a fieldset <legend> or a collapsible trigger as the mode requires.
@@ -218,8 +219,8 @@ export function SectionSaveButton({ sectionName, disabled }) {
         if (registeredFieldNames.length === 0) {
             return;
         }
-        const isValid = await form.trigger(registeredFieldNames);
-        if (!isValid) {
+        // An invalid section shows its errors and brings the first on screen; it used to stop with nothing visible.
+        if (!(await validateFieldsAndShowErrors(form, registeredFieldNames))) {
             return;
         }
         setIsSaving(true);
@@ -227,6 +228,11 @@ export function SectionSaveButton({ sectionName, disabled }) {
             const formValues = form.getValues();
             await onSectionSave(sectionName, registeredFieldNames, formValues);
         }
+        catch (error) {
+            // The form's own handler reports its failures and never throws; a caller-supplied one may. Logged rather than
+            // left to escape the click handler as an unhandled rejection.
+            logger.error('[SectionSaveButton] The section save handler threw.', { sectionName, error });
+        }
         finally {
             setIsSaving(false);
         }

package/dist/esm/components/resources/skeleton/Section.js.map

@@ -1 +1 @@
-{"version":3,"file":"Section.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { useState, type ReactNode } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { ErrorCustomMessageReference } from '@wildo-ai/saas-models';\nimport { SectionMode, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport type { ResponsiveChromeMode, SoloSectionMode } from '@wildo-ai/zod-decorators';\nimport type { GapSize } from '@wildo-ai/presets-components-models';\nimport { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext';\nimport { FormChromeProvider } from '../../form/chromes/FormChromeContext';\nimport { DisplayChromeProvider } from '../../data-display/chromes/DisplayChromeContext';\nimport { ContentSection } from '../../sections/content-section';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { GroupedSectionHostKind } from './Section.shared';\nimport { toDisplayChromeMode, isSoloMode } from './section-consolidation.shared';\nimport {\n  SectionFieldsContext,\n  useRegisteredSectionFields,\n  useSectionFieldsRegistry,\n  holdsOnlyFieldSlots,\n  useSectionShowsNoField,\n} from './SectionFieldsContext';\nimport { useFieldScope } from './FieldScopeContext';\nimport { useTemplatePlacedFieldsOf } from '../../form/automated/TemplatePlacedFieldsContext';\nimport { useOptionalSectionPresentationContext } from './SectionPresentationContext';\nimport { SectionHostHeadingContext } from './SectionHostHeadingContext';\n\nconst logger = LoggerFrontendService.getLogger();\n\n/**\n * Tracks `${name}:${appearance}` keys already warned about an ungrouped\n * container-mode section, so the dev footgun warning fires once per section\n * instead of on every render.\n */\nconst warnedUngroupedContainerSections = new Set<string>();\n\n// =============================================================================\n// SECTION PROPS — Discriminated Union\n// =============================================================================\n\n/**\n * Shared properties across all `SectionProps` variants.\n */\ntype SectionBaseProps = {\n  /**\n   * Structural ref — maps to i18n keys for title/description:\n   * - `resources.{type}.sections.{name}.title`\n   * - `resources.{type}.sections.{name}.description`\n   */\n  name: string;\n  /** Additional CSS classes for the section container. */\n  className?: string;\n  /**\n   * When `true`, renders a section-level save button (form context only).\n   */\n  saveable?: boolean;\n  /**\n   * Override chrome mode for all fields within this section.\n   * Cascade: field decorator → section chromeMode → form/display chromeMode\n   * → surface policy → STACKED.\n   */\n  chromeMode?: ResponsiveChromeMode;\n  /** Whether this section is disabled. */\n  disabled?: boolean;\n  /**\n   * Suppress the section's resolved TITLE (legend) while keeping the rest of the\n   * section intact. Independent from {@link SectionBaseProps.hideDescription} —\n   * the two are separate concerns.\n   *\n   * Honored for the **solo** modes (DEFAULT / CARD / GHOST / COLLAPSIBLE), i.e.\n   * the modes a `<Section>` renders itself. Container/grouped modes (GRID / TABS\n   * / …) take their heading from the layout host and ignore this flag.\n   *\n   * Hiding the title also releases the heading-dedup signal\n   * ({@link SectionHostHeadingContext}), so an embedded resource surface is free\n   * to render its own heading again.\n   */\n  hideTitle?: boolean;\n  /**\n   * Suppress the section's resolved DESCRIPTION, independently of the title.\n   *\n   * NB: the CARD renderer nests the description inside the title heading block,\n   * so on a CARD hiding the title also hides the description; on DEFAULT / GHOST\n   * / COLLAPSIBLE the two render independently.\n   */\n  hideDescription?: boolean;\n  children: ReactNode;\n  /**\n   * Universal behavioral prop — initial focus state.\n   * - COLLAPSIBLE: whether the section starts expanded (default: true)\n   * - TABS/PILLS/VERTICAL_TABS: whether this section is the default active tab\n   * - ACCORDION: whether this section starts expanded\n   * - STEPPER: no effect (always sequential)\n   * @default true for COLLAPSIBLE, false for others\n   */\n  defaultFocus?: boolean;\n};\n\n// ─── Solo modes ───\n\ntype SectionProps_Default = SectionBaseProps & {\n  appearance?: SectionMode.DEFAULT;\n};\n\ntype SectionProps_Card = SectionBaseProps & {\n  appearance: SectionMode.CARD;\n};\n\ntype SectionProps_Ghost = SectionBaseProps & {\n  appearance: SectionMode.GHOST;\n};\n\ntype SectionProps_Collapsible = SectionBaseProps & {\n  appearance: SectionMode.COLLAPSIBLE;\n};\n\n// ─── Layout container modes ───\n\ntype SectionProps_Inline = SectionBaseProps & {\n  appearance: SectionMode.INLINE;\n  gap?: GapSize;\n};\n\ntype SectionProps_Grid = SectionBaseProps & {\n  appearance: SectionMode.GRID;\n  columns?: number | 'auto';\n  gap?: GapSize;\n  minColumnWidth?: string;\n};\n\ntype SectionProps_Columns = SectionBaseProps & {\n  appearance: SectionMode.COLUMNS;\n  columns?: number | 'auto';\n  gap?: GapSize;\n};\n\n// ─── Navigation container modes ───\n\ntype SectionProps_Tabs = SectionBaseProps & {\n  appearance: SectionMode.TABS;\n};\n\ntype SectionProps_VerticalTabs = SectionBaseProps & {\n  appearance: SectionMode.VERTICAL_TABS;\n  navWidth?: string;\n};\n\ntype SectionProps_Pills = SectionBaseProps & {\n  appearance: SectionMode.PILLS;\n};\n\n// ─── Expandable container modes ───\n\ntype SectionProps_Accordion = SectionBaseProps & {\n  appearance: SectionMode.ACCORDION;\n  allowMultiple?: boolean;\n};\n\ntype SectionProps_Expandable = SectionBaseProps & {\n  appearance: SectionMode.EXPANDABLE;\n  initialVisibleCount?: number;\n};\n\n// ─── Guided container modes ───\n\ntype SectionProps_Stepper = SectionBaseProps & {\n  appearance: SectionMode.STEPPER;\n  allowSkip?: boolean;\n  showProgress?: boolean;\n  orientation?: DisplayDirection;\n};\n\ntype SectionProps_Timeline = SectionBaseProps & {\n  appearance: SectionMode.TIMELINE;\n};\n\n/**\n * Discriminated union of all Section props.\n * TypeScript narrows mode-specific parameters based on `appearance`.\n *\n * Solo modes (DEFAULT, CARD, GHOST, COLLAPSIBLE) render the section in place.\n * Container modes (TABS, GRID, etc.) are grouped by the parent layout\n * (`FormLayout`, `DisplayLayout`, or another section-aware host such as\n * `CompositeLayout`) into a `ContentSectionContainer`.\n */\nexport type SectionProps =\n  | SectionProps_Default\n  | SectionProps_Card\n  | SectionProps_Ghost\n  | SectionProps_Collapsible\n  | SectionProps_Inline\n  | SectionProps_Grid\n  | SectionProps_Columns\n  | SectionProps_Tabs\n  | SectionProps_VerticalTabs\n  | SectionProps_Pills\n  | SectionProps_Accordion\n  | SectionProps_Expandable\n  | SectionProps_Stepper\n  | SectionProps_Timeline;\n\nexport interface GroupedSectionBodyProps {\n  hostKind: GroupedSectionHostKind;\n  sectionProps: Pick<SectionProps, 'name' | 'children' | 'chromeMode' | 'saveable' | 'className' | 'disabled'>;\n  /**\n   * Whether the grouping container renders a visible heading for this section\n   * (the `ContentSectionDescriptor.title` the layout host resolved). When true,\n   * descendants get {@link SectionHostHeadingContext} so an embedded resource\n   * surface suppresses its own generic heading/breadcrumb — mirroring what solo\n   * `<Section>` rendering does with its legend. Hosts pass `!!title`.\n   */\n  providesHeading?: boolean;\n}\n\n/**\n * Named section for form and display templates.\n *\n * The `appearance` prop determines rendering behavior:\n *\n * **Solo modes** (DEFAULT, CARD, GHOST, COLLAPSIBLE) render in place with\n * appropriate chrome (fieldset, card, collapsible wrapper).\n *\n * **Container modes** (TABS, GRID, ACCORDION, etc.) are NOT rendered directly\n * by this component — the parent layout (`FormLayout`, `DisplayLayout`, or\n * another section-aware host) introspects its children, groups sections sharing\n * the same container appearance, and renders them via\n * `ContentSectionContainer`.\n *\n * **A solo form section with nothing to show hides.** One template serves several operations, and a\n * `FormField` whose field the operation's schema lacks (or whose condition hides it) renders nothing.\n * When a section holds only field slots (`FormField`, `FormFieldArray`, fields inside `ObjectScope` or\n * inside a plain layout element such as a grid `div`) and none of them renders, the section hides its\n * frame rather than showing a heading over nothing; its children stay mounted, so a field that starts\n * rendering brings it back. A section holding anything else — text, a custom control or wrapper\n * component (the engine's `Group` included), a nested section, a custom element, or a plain element\n * with no field slot inside at that moment (a spacer `div`, an `hr`, a `div` whose only slot sits in a\n * false branch) — is never hidden this way. A GROUPED section (grid, tabs, …) is decided by its host\n * instead, from the operation's schema, because its container draws it and a tab's panel is not mounted:\n * see `groupedSectionShowsNoField` in `FormLayout`.\n *\n * Supports:\n * - **Saveable sections** (form-only, section-level partial save)\n * - **Section-level chromeMode override** (cascaded to child fields)\n * - **defaultFocus** — initial active/expanded state\n *\n * @example Solo mode (renders in place):\n * ```tsx\n * <Section name=\"billing\" appearance={SectionMode.CARD}>\n *   <DisplayField name=\"plan\" />\n * </Section>\n * ```\n *\n * @example Container mode (grouped by parent layout):\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\" appearance={SectionMode.TABS} defaultFocus>\n *     <FormField name=\"name\" />\n *   </Section>\n *   <Section name=\"advanced\" appearance={SectionMode.TABS}>\n *     <FormField name=\"config\" />\n *   </Section>\n * </FormLayout>\n * ```\n */\nexport function Section(props: SectionProps): ReactNode {\n  const {\n    name,\n    className,\n    saveable,\n    chromeMode,\n    children,\n    defaultFocus = true,\n    hideTitle = false,\n    hideDescription = false,\n  } = props;\n\n  const appearance: SectionMode = props.appearance ?? SectionMode.DEFAULT;\n\n  const formCtx = useOptionalFormTemplateContext();\n  const displayCtx = useOptionalDisplayTemplateContext();\n  const sectionPresentation = useOptionalSectionPresentationContext();\n\n  const presentationEntry = sectionPresentation?.sectionEntries?.[name];\n  const presentationTitle = presentationEntry?.icon\n    ? (\n      <>\n        <span className=\"me-element inline-flex items-center\">{presentationEntry.icon}</span>\n        {presentationEntry.title ?? ''}\n      </>\n    )\n    : presentationEntry?.title;\n\n  const legend = formCtx?.sectionLabels?.[name]\n    ?? displayCtx?.sectionLabels?.[name]\n    ?? presentationTitle;\n  const description = formCtx?.sectionDescriptions?.[name]\n    ?? displayCtx?.sectionDescriptions?.[name]\n    ?? presentationEntry?.description;\n  // Two independent hide concerns. Resolving to `undefined` flows through the\n  // whole solo-render chrome contract: no legend/description on the\n  // ContentSection primitive AND (for the title) no heading-dedup signal.\n  const resolvedLegend = hideTitle ? undefined : legend;\n  const resolvedDescription = hideDescription ? undefined : description;\n  const disabled = props.disabled ?? formCtx?.disabled;\n  const onSectionSave = formCtx?.onSectionSave;\n  const isSaveable = !!(saveable && onSectionSave);\n  const sectionHostKind = formCtx\n    ? GroupedSectionHostKind.FORM\n    : displayCtx\n      ? GroupedSectionHostKind.DISPLAY\n      : sectionPresentation\n        ? GroupedSectionHostKind.COMPOSITE\n        : GroupedSectionHostKind.DISPLAY;\n  if (sectionHostKind === GroupedSectionHostKind.COMPOSITE && chromeMode) {\n    throw FrontendResourceUtils.buildConfigurationError(\n      ErrorCustomMessageReference.CONFIGURATION,\n      {\n        component: 'Section',\n        message: 'Section chromeMode is only supported inside form/display section hosts. Composite-hosted sections must not declare chromeMode until a dedicated composite chrome contract exists.',\n        sectionName: name,\n      },\n    );\n  }\n  const sectionFieldsContextValue = useSectionFieldsRegistry();\n  const showsNoField = useSectionShowsNoField(sectionFieldsContextValue);\n  // Every slot this section holds, read from its elements: a collapsed section's fields, or an unchosen\n  // variant's, are not mounted, so they cannot report themselves (see `TemplatePlacedFieldsContext`).\n  const { pathPrefix } = useFieldScope();\n  useTemplatePlacedFieldsOf(children, pathPrefix);\n  // Only a section of nothing but field slots may hide for its fields' absence; anything else beside\n  // them (text, a custom control, a nested section) is content of its own that presence cannot see.\n  const isEmptyForThisOperation = showsNoField && holdsOnlyFieldSlots(children);\n\n  // Container modes: render children as-is. The parent layout handles grouping.\n  if (!isSoloMode(appearance)) {\n    // Footgun guard: a container-mode section (GRID/TABS/COLUMNS/…) only receives\n    // chrome (card, padding, title) when a layout HOST groups it into a\n    // ContentSectionContainer. Reaching this branch means the section escaped\n    // grouping — almost always because it was wrapped in a custom component\n    // (hiding it from the host's `groupSectionsByAppearance` scan) or rendered\n    // standalone — so it renders BARE (raw children only, no chrome). Warn so the\n    // silent \"no chrome\" outcome is visible; for a single self-contained section\n    // use a solo appearance (DEFAULT / CARD / GHOST) instead.\n    if (process.env.NODE_ENV !== 'production') {\n      const warnKey = `${name}:${appearance}`;\n      if (!warnedUngroupedContainerSections.has(warnKey)) {\n        warnedUngroupedContainerSections.add(warnKey);\n        logger.warn(\n          `[Section] container-mode section \"${name}\" (appearance=\"${appearance}\") is rendering ungrouped — no section chrome (card / padding / title), only its raw children. Container modes must be DIRECT <Section> children of a layout host (FormLayout / DisplayLayout / CompositeLayout) to be grouped. This usually means the <Section> is wrapped in a custom component or rendered standalone. Use a solo appearance (DEFAULT / CARD / GHOST) for a single self-contained section.`,\n          { sectionName: name, appearance },\n        );\n      }\n    }\n    return <>{children}</>;\n  }\n\n  // When this section renders its own heading (legend), tell descendant resource\n  // operation surfaces so an embedded list/etc. doesn't ALSO render its generic\n  // resource heading right under ours (the \"To-Do Lists\" + \"Todo Lists\" double\n  // heading). Record-specific headings (a READ view's displayLabel) are NOT\n  // suppressed — the consumer gates on the absence of a displayLabel.\n  const content = (\n    <SectionHostHeadingContext.Provider value={!!resolvedLegend}>\n      <SectionFieldsContext.Provider value={sectionFieldsContextValue}>\n        <SectionContentWithHostChrome\n          hostKind={sectionHostKind}\n          chromeMode={chromeMode}\n        >\n          {children}\n        </SectionContentWithHostChrome>\n        {isSaveable && <SectionSaveButton sectionName={name} disabled={disabled} />}\n      </SectionFieldsContext.Provider>\n    </SectionHostHeadingContext.Provider>\n  );\n\n  // All four solo modes (DEFAULT / CARD / GHOST / COLLAPSIBLE) are rendered by\n  // the ContentSection primitive, which owns the per-mode chrome: a native\n  // <fieldset> (DEFAULT/CARD — the disabled cascade + when-orphan framing), a\n  // flat <div> (GHOST), or a Collapsible toggle (COLLAPSIBLE). The legend and\n  // description are passed as structured props so the primitive can place the\n  // legend as a fieldset <legend> or a collapsible trigger as the mode requires.\n  return (\n    <ContentSection\n      appearance={appearance as SoloSectionMode}\n      legend={resolvedLegend}\n      description={resolvedDescription}\n      disabled={disabled}\n      defaultOpen={defaultFocus}\n      className={className}\n      data-guidance-section={name}\n      data-composite-section={sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined}\n      // It holds only field slots and none renders for this operation (a template serves several\n      // operations, and this one posts none of these fields): a heading over nothing. The children stay\n      // mounted, so a field whose condition turns true reports and brings the section back.\n      hidden={isEmptyForThisOperation || undefined}\n    >\n      {content}\n    </ContentSection>\n  );\n}\n\nSection.displayName = 'Section';\n\nexport function GroupedSectionBody({\n  hostKind,\n  sectionProps,\n  providesHeading = false,\n}: GroupedSectionBodyProps): ReactNode {\n  const { children, chromeMode, saveable, name, className, disabled } = sectionProps;\n  const sectionFieldsContextValue = useSectionFieldsRegistry();\n\n  let content: ReactNode = children;\n  if (hostKind === GroupedSectionHostKind.FORM) {\n    content = (\n      <SectionFieldsContext.Provider value={sectionFieldsContextValue}>\n        <SectionContentWithHostChrome hostKind={hostKind} chromeMode={chromeMode}>\n          {children}\n        </SectionContentWithHostChrome>\n        {saveable && <SectionSaveButton sectionName={name} disabled={disabled} />}\n      </SectionFieldsContext.Provider>\n    );\n  } else {\n    content = (\n      <SectionContentWithHostChrome hostKind={hostKind} chromeMode={chromeMode}>\n        {children}\n      </SectionContentWithHostChrome>\n    );\n  }\n\n  return (\n    // Same de-duplication contract as the solo-section path (see the provider\n    // around `content` in Section above): when the grouping container renders\n    // this section's title, an embedded resource surface must not stack its\n    // own generic heading + breadcrumb under it.\n    <SectionHostHeadingContext.Provider value={providesHeading}>\n      <div\n        className={className ? `space-y-field ${className}` : 'space-y-field'}\n        data-guidance-section={name}\n        data-composite-section={hostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined}\n      >\n        {content}\n      </div>\n    </SectionHostHeadingContext.Provider>\n  );\n}\n\nfunction SectionContentWithHostChrome({\n  hostKind,\n  chromeMode,\n  children,\n}: {\n  hostKind: GroupedSectionHostKind;\n  chromeMode?: SectionProps['chromeMode'];\n  children: ReactNode;\n}): ReactNode {\n  if (!chromeMode) {\n    return children;\n  }\n\n  if (hostKind === GroupedSectionHostKind.FORM) {\n    return <FormChromeProvider sectionChromeMode={chromeMode}>{children}</FormChromeProvider>;\n  }\n\n  if (hostKind === GroupedSectionHostKind.DISPLAY) {\n    return <DisplayChromeProvider sectionChromeMode={toDisplayChromeMode(chromeMode)}>{children}</DisplayChromeProvider>;\n  }\n\n  return children;\n}\n\n\n// =============================================================================\n// SectionSaveButton (extracted to avoid useFormContext crash in display templates)\n// =============================================================================\n\nexport interface SectionSaveButtonProps {\n  sectionName: string;\n  disabled?: boolean;\n}\n\n/**\n * Section-level save button — only rendered inside form contexts.\n * Extracted from Section to isolate the useFormContext() call, preventing\n * crashes when Section is used inside display templates.\n *\n * Also rendered by `GroupedSectionBody` for grouped (tabbed/accordion)\n * container section panels mounted via `GroupedSectionContent` in\n * `FormLayout.tsx`.\n */\nexport function SectionSaveButton({ sectionName, disabled }: SectionSaveButtonProps): ReactNode {\n  const form = useFormContext();\n  const ctx = useOptionalFormTemplateContext();\n  const registeredFieldNames = useRegisteredSectionFields();\n  const [isSaving, setIsSaving] = useState(false);\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  const onSectionSave = ctx?.onSectionSave;\n  if (!onSectionSave) return null;\n  if (!isReady) return null;\n\n  const handleSave = async () => {\n    if (registeredFieldNames.length === 0) {\n      return;\n    }\n\n    const isValid = await form.trigger(registeredFieldNames);\n\n    if (!isValid) {\n      return;\n    }\n\n    setIsSaving(true);\n    try {\n      const formValues = form.getValues();\n      await onSectionSave(sectionName, registeredFieldNames, formValues as Record<string, unknown>);\n    } finally {\n      setIsSaving(false);\n    }\n  };\n\n  const savingLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSaving');\n  const saveLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSave');\n\n  return (\n    <div className=\"flex justify-end pt-item\">\n      <Button\n        type=\"button\"\n        variant={ButtonVariants_Variant.SECONDARY}\n        size={ButtonSize.SM}\n        onClick={handleSave}\n        disabled={disabled || isSaving || registeredFieldNames.length === 0}\n      >\n        {isSaving ? savingLabel : saveLabel}\n      </Button>\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"Section.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { useState, type ReactNode } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { ErrorCustomMessageReference } from '@wildo-ai/saas-models';\nimport { SectionMode, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport type { ResponsiveChromeMode, SoloSectionMode } from '@wildo-ai/zod-decorators';\nimport type { GapSize } from '@wildo-ai/presets-components-models';\nimport { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { validateFieldsAndShowErrors } from '../../form/validation-errors/validate-fields-and-show-errors';\nimport { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext';\nimport { FormChromeProvider } from '../../form/chromes/FormChromeContext';\nimport { DisplayChromeProvider } from '../../data-display/chromes/DisplayChromeContext';\nimport { ContentSection } from '../../sections/content-section';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { GroupedSectionHostKind } from './Section.shared';\nimport { toDisplayChromeMode, isSoloMode } from './section-consolidation.shared';\nimport {\n  SectionFieldsContext,\n  useRegisteredSectionFields,\n  useSectionFieldsRegistry,\n  holdsOnlyFieldSlots,\n  useSectionShowsNoField,\n} from './SectionFieldsContext';\nimport { useFieldScope } from './FieldScopeContext';\nimport { useTemplatePlacedFieldsOf } from '../../form/automated/TemplatePlacedFieldsContext';\nimport { useOptionalSectionPresentationContext } from './SectionPresentationContext';\nimport { SectionHostHeadingContext } from './SectionHostHeadingContext';\n\nconst logger = LoggerFrontendService.getLogger();\n\n/**\n * Tracks `${name}:${appearance}` keys already warned about an ungrouped\n * container-mode section, so the dev footgun warning fires once per section\n * instead of on every render.\n */\nconst warnedUngroupedContainerSections = new Set<string>();\n\n// =============================================================================\n// SECTION PROPS — Discriminated Union\n// =============================================================================\n\n/**\n * Shared properties across all `SectionProps` variants.\n */\ntype SectionBaseProps = {\n  /**\n   * Structural ref — maps to i18n keys for title/description:\n   * - `resources.{type}.sections.{name}.title`\n   * - `resources.{type}.sections.{name}.description`\n   */\n  name: string;\n  /** Additional CSS classes for the section container. */\n  className?: string;\n  /**\n   * When `true`, renders a section-level save button (form context only).\n   */\n  saveable?: boolean;\n  /**\n   * Override chrome mode for all fields within this section.\n   * Cascade: field decorator → section chromeMode → form/display chromeMode\n   * → surface policy → STACKED.\n   */\n  chromeMode?: ResponsiveChromeMode;\n  /** Whether this section is disabled. */\n  disabled?: boolean;\n  /**\n   * Suppress the section's resolved TITLE (legend) while keeping the rest of the\n   * section intact. Independent from {@link SectionBaseProps.hideDescription} —\n   * the two are separate concerns.\n   *\n   * Honored for the **solo** modes (DEFAULT / CARD / GHOST / COLLAPSIBLE), i.e.\n   * the modes a `<Section>` renders itself. Container/grouped modes (GRID / TABS\n   * / …) take their heading from the layout host and ignore this flag.\n   *\n   * Hiding the title also releases the heading-dedup signal\n   * ({@link SectionHostHeadingContext}), so an embedded resource surface is free\n   * to render its own heading again.\n   */\n  hideTitle?: boolean;\n  /**\n   * Suppress the section's resolved DESCRIPTION, independently of the title.\n   *\n   * NB: the CARD renderer nests the description inside the title heading block,\n   * so on a CARD hiding the title also hides the description; on DEFAULT / GHOST\n   * / COLLAPSIBLE the two render independently.\n   */\n  hideDescription?: boolean;\n  children: ReactNode;\n  /**\n   * Universal behavioral prop — initial focus state.\n   * - COLLAPSIBLE: whether the section starts expanded (default: true)\n   * - TABS/PILLS/VERTICAL_TABS: whether this section is the default active tab\n   * - ACCORDION: whether this section starts expanded\n   * - STEPPER: no effect (always sequential)\n   * @default true for COLLAPSIBLE, false for others\n   */\n  defaultFocus?: boolean;\n};\n\n// ─── Solo modes ───\n\ntype SectionProps_Default = SectionBaseProps & {\n  appearance?: SectionMode.DEFAULT;\n};\n\ntype SectionProps_Card = SectionBaseProps & {\n  appearance: SectionMode.CARD;\n};\n\ntype SectionProps_Ghost = SectionBaseProps & {\n  appearance: SectionMode.GHOST;\n};\n\ntype SectionProps_Collapsible = SectionBaseProps & {\n  appearance: SectionMode.COLLAPSIBLE;\n};\n\n// ─── Layout container modes ───\n\ntype SectionProps_Inline = SectionBaseProps & {\n  appearance: SectionMode.INLINE;\n  gap?: GapSize;\n};\n\ntype SectionProps_Grid = SectionBaseProps & {\n  appearance: SectionMode.GRID;\n  columns?: number | 'auto';\n  gap?: GapSize;\n  minColumnWidth?: string;\n};\n\ntype SectionProps_Columns = SectionBaseProps & {\n  appearance: SectionMode.COLUMNS;\n  columns?: number | 'auto';\n  gap?: GapSize;\n};\n\n// ─── Navigation container modes ───\n\ntype SectionProps_Tabs = SectionBaseProps & {\n  appearance: SectionMode.TABS;\n};\n\ntype SectionProps_VerticalTabs = SectionBaseProps & {\n  appearance: SectionMode.VERTICAL_TABS;\n  navWidth?: string;\n};\n\ntype SectionProps_Pills = SectionBaseProps & {\n  appearance: SectionMode.PILLS;\n};\n\n// ─── Expandable container modes ───\n\ntype SectionProps_Accordion = SectionBaseProps & {\n  appearance: SectionMode.ACCORDION;\n  allowMultiple?: boolean;\n};\n\n/**\n * Truncation over a GROUP of consecutive EXPANDABLE sections: the first `initialVisibleCount` show and\n * one \"Show more\" button reveals the rest. Not a toggle — one section, or any group no larger than\n * `initialVisibleCount`, renders fully open with no button. A single aside revealed on request is\n * {@link SectionMode.COLLAPSIBLE} with `defaultFocus={false}` (#2197).\n */\ntype SectionProps_Expandable = SectionBaseProps & {\n  appearance: SectionMode.EXPANDABLE;\n  /** Sections shown before \"Show more\". Read from the group's first section. @default 3 */\n  initialVisibleCount?: number;\n};\n\n// ─── Guided container modes ───\n\ntype SectionProps_Stepper = SectionBaseProps & {\n  appearance: SectionMode.STEPPER;\n  allowSkip?: boolean;\n  showProgress?: boolean;\n  orientation?: DisplayDirection;\n};\n\ntype SectionProps_Timeline = SectionBaseProps & {\n  appearance: SectionMode.TIMELINE;\n};\n\n/**\n * Discriminated union of all Section props.\n * TypeScript narrows mode-specific parameters based on `appearance`.\n *\n * Solo modes (DEFAULT, CARD, GHOST, COLLAPSIBLE) render the section in place.\n * Container modes (TABS, GRID, etc.) are grouped by the parent layout\n * (`FormLayout`, `DisplayLayout`, or another section-aware host such as\n * `CompositeLayout`) into a `ContentSectionContainer`.\n */\nexport type SectionProps =\n  | SectionProps_Default\n  | SectionProps_Card\n  | SectionProps_Ghost\n  | SectionProps_Collapsible\n  | SectionProps_Inline\n  | SectionProps_Grid\n  | SectionProps_Columns\n  | SectionProps_Tabs\n  | SectionProps_VerticalTabs\n  | SectionProps_Pills\n  | SectionProps_Accordion\n  | SectionProps_Expandable\n  | SectionProps_Stepper\n  | SectionProps_Timeline;\n\nexport interface GroupedSectionBodyProps {\n  hostKind: GroupedSectionHostKind;\n  sectionProps: Pick<SectionProps, 'name' | 'children' | 'chromeMode' | 'saveable' | 'className' | 'disabled'>;\n  /**\n   * Whether the grouping container renders a visible heading for this section\n   * (the `ContentSectionDescriptor.title` the layout host resolved). When true,\n   * descendants get {@link SectionHostHeadingContext} so an embedded resource\n   * surface suppresses its own generic heading/breadcrumb — mirroring what solo\n   * `<Section>` rendering does with its legend. Hosts pass `!!title`.\n   */\n  providesHeading?: boolean;\n}\n\n/**\n * Named section for form and display templates.\n *\n * The `appearance` prop determines rendering behavior:\n *\n * **Solo modes** (DEFAULT, CARD, GHOST, COLLAPSIBLE) render in place with\n * appropriate chrome (fieldset, card, collapsible wrapper).\n *\n * **Container modes** (TABS, GRID, ACCORDION, etc.) are NOT rendered directly\n * by this component — the parent layout (`FormLayout`, `DisplayLayout`, or\n * another section-aware host) introspects its children, groups sections sharing\n * the same container appearance, and renders them via\n * `ContentSectionContainer`.\n *\n * **A solo form section with nothing to show hides.** One template serves several operations, and a\n * `FormField` whose field the operation's schema lacks (or whose condition hides it) renders nothing.\n * When a section holds only field slots (`FormField`, `FormFieldArray`, fields inside `ObjectScope` or\n * inside a plain layout element such as a grid `div`) and none of them renders, the section hides its\n * frame rather than showing a heading over nothing; its children stay mounted, so a field that starts\n * rendering brings it back. A section holding anything else — text, a custom control or wrapper\n * component (the engine's `Group` included), a nested section, a custom element, or a plain element\n * with no field slot inside at that moment (a spacer `div`, an `hr`, a `div` whose only slot sits in a\n * false branch) — is never hidden this way. A GROUPED section (grid, tabs, …) is decided by its host\n * instead, from the operation's schema, because its container draws it and a tab's panel is not mounted:\n * see `groupedSectionShowsNoField` in `FormLayout`.\n *\n * Supports:\n * - **Saveable sections** (form-only, section-level partial save)\n * - **Section-level chromeMode override** (cascaded to child fields)\n * - **defaultFocus** — initial active/expanded state\n *\n * @example Solo mode (renders in place):\n * ```tsx\n * <Section name=\"billing\" appearance={SectionMode.CARD}>\n *   <DisplayField name=\"plan\" />\n * </Section>\n * ```\n *\n * @example Container mode (grouped by parent layout):\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\" appearance={SectionMode.TABS} defaultFocus>\n *     <FormField name=\"name\" />\n *   </Section>\n *   <Section name=\"advanced\" appearance={SectionMode.TABS}>\n *     <FormField name=\"config\" />\n *   </Section>\n * </FormLayout>\n * ```\n */\nexport function Section(props: SectionProps): ReactNode {\n  const {\n    name,\n    className,\n    saveable,\n    chromeMode,\n    children,\n    defaultFocus = true,\n    hideTitle = false,\n    hideDescription = false,\n  } = props;\n\n  const appearance: SectionMode = props.appearance ?? SectionMode.DEFAULT;\n\n  const formCtx = useOptionalFormTemplateContext();\n  const displayCtx = useOptionalDisplayTemplateContext();\n  const sectionPresentation = useOptionalSectionPresentationContext();\n\n  const presentationEntry = sectionPresentation?.sectionEntries?.[name];\n  const presentationTitle = presentationEntry?.icon\n    ? (\n      <>\n        <span className=\"me-element inline-flex items-center\">{presentationEntry.icon}</span>\n        {presentationEntry.title ?? ''}\n      </>\n    )\n    : presentationEntry?.title;\n\n  const legend = formCtx?.sectionLabels?.[name]\n    ?? displayCtx?.sectionLabels?.[name]\n    ?? presentationTitle;\n  const description = formCtx?.sectionDescriptions?.[name]\n    ?? displayCtx?.sectionDescriptions?.[name]\n    ?? presentationEntry?.description;\n  // Two independent hide concerns. Resolving to `undefined` flows through the\n  // whole solo-render chrome contract: no legend/description on the\n  // ContentSection primitive AND (for the title) no heading-dedup signal.\n  const resolvedLegend = hideTitle ? undefined : legend;\n  const resolvedDescription = hideDescription ? undefined : description;\n  const disabled = props.disabled ?? formCtx?.disabled;\n  const onSectionSave = formCtx?.onSectionSave;\n  const isSaveable = !!(saveable && onSectionSave);\n  const sectionHostKind = formCtx\n    ? GroupedSectionHostKind.FORM\n    : displayCtx\n      ? GroupedSectionHostKind.DISPLAY\n      : sectionPresentation\n        ? GroupedSectionHostKind.COMPOSITE\n        : GroupedSectionHostKind.DISPLAY;\n  if (sectionHostKind === GroupedSectionHostKind.COMPOSITE && chromeMode) {\n    throw FrontendResourceUtils.buildConfigurationError(\n      ErrorCustomMessageReference.CONFIGURATION,\n      {\n        component: 'Section',\n        message: 'Section chromeMode is only supported inside form/display section hosts. Composite-hosted sections must not declare chromeMode until a dedicated composite chrome contract exists.',\n        sectionName: name,\n      },\n    );\n  }\n  const sectionFieldsContextValue = useSectionFieldsRegistry();\n  const showsNoField = useSectionShowsNoField(sectionFieldsContextValue);\n  // Every slot this section holds, read from its elements: a collapsed section's fields, or an unchosen\n  // variant's, are not mounted, so they cannot report themselves (see `TemplatePlacedFieldsContext`).\n  const { pathPrefix } = useFieldScope();\n  useTemplatePlacedFieldsOf(children, pathPrefix);\n  // Only a section of nothing but field slots may hide for its fields' absence; anything else beside\n  // them (text, a custom control, a nested section) is content of its own that presence cannot see.\n  const isEmptyForThisOperation = showsNoField && holdsOnlyFieldSlots(children);\n\n  // Container modes: render children as-is. The parent layout handles grouping.\n  if (!isSoloMode(appearance)) {\n    // Footgun guard: a container-mode section (GRID/TABS/COLUMNS/…) only receives\n    // chrome (card, padding, title) when a layout HOST groups it into a\n    // ContentSectionContainer. Reaching this branch means the section escaped\n    // grouping — almost always because it was wrapped in a custom component\n    // (hiding it from the host's `groupSectionsByAppearance` scan) or rendered\n    // standalone — so it renders BARE (raw children only, no chrome). Warn so the\n    // silent \"no chrome\" outcome is visible; for a single self-contained section\n    // use a solo appearance (DEFAULT / CARD / GHOST) instead.\n    if (process.env.NODE_ENV !== 'production') {\n      const warnKey = `${name}:${appearance}`;\n      if (!warnedUngroupedContainerSections.has(warnKey)) {\n        warnedUngroupedContainerSections.add(warnKey);\n        logger.warn(\n          `[Section] container-mode section \"${name}\" (appearance=\"${appearance}\") is rendering ungrouped — no section chrome (card / padding / title), only its raw children. Container modes must be DIRECT <Section> children of a layout host (FormLayout / DisplayLayout / CompositeLayout) to be grouped. This usually means the <Section> is wrapped in a custom component or rendered standalone. Use a solo appearance (DEFAULT / CARD / GHOST) for a single self-contained section.`,\n          { sectionName: name, appearance },\n        );\n      }\n    }\n    return <>{children}</>;\n  }\n\n  // When this section renders its own heading (legend), tell descendant resource\n  // operation surfaces so an embedded list/etc. doesn't ALSO render its generic\n  // resource heading right under ours (the \"To-Do Lists\" + \"Todo Lists\" double\n  // heading). Record-specific headings (a READ view's displayLabel) are NOT\n  // suppressed — the consumer gates on the absence of a displayLabel.\n  const content = (\n    <SectionHostHeadingContext.Provider value={!!resolvedLegend}>\n      <SectionFieldsContext.Provider value={sectionFieldsContextValue}>\n        <SectionContentWithHostChrome\n          hostKind={sectionHostKind}\n          chromeMode={chromeMode}\n        >\n          {children}\n        </SectionContentWithHostChrome>\n        {isSaveable && <SectionSaveButton sectionName={name} disabled={disabled} />}\n      </SectionFieldsContext.Provider>\n    </SectionHostHeadingContext.Provider>\n  );\n\n  // All four solo modes (DEFAULT / CARD / GHOST / COLLAPSIBLE) are rendered by\n  // the ContentSection primitive, which owns the per-mode chrome: a native\n  // <fieldset> (DEFAULT/CARD — the disabled cascade carrier; a card always paints its frame), a\n  // flat <div> (GHOST), or a Collapsible toggle (COLLAPSIBLE). The legend and\n  // description are passed as structured props so the primitive can place the\n  // legend as a fieldset <legend> or a collapsible trigger as the mode requires.\n  return (\n    <ContentSection\n      appearance={appearance as SoloSectionMode}\n      legend={resolvedLegend}\n      description={resolvedDescription}\n      disabled={disabled}\n      defaultOpen={defaultFocus}\n      className={className}\n      data-guidance-section={name}\n      data-composite-section={sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined}\n      // It holds only field slots and none renders for this operation (a template serves several\n      // operations, and this one posts none of these fields): a heading over nothing. The children stay\n      // mounted, so a field whose condition turns true reports and brings the section back.\n      hidden={isEmptyForThisOperation || undefined}\n    >\n      {content}\n    </ContentSection>\n  );\n}\n\nSection.displayName = 'Section';\n\nexport function GroupedSectionBody({\n  hostKind,\n  sectionProps,\n  providesHeading = false,\n}: GroupedSectionBodyProps): ReactNode {\n  const { children, chromeMode, saveable, name, className, disabled } = sectionProps;\n  const sectionFieldsContextValue = useSectionFieldsRegistry();\n\n  let content: ReactNode = children;\n  if (hostKind === GroupedSectionHostKind.FORM) {\n    content = (\n      <SectionFieldsContext.Provider value={sectionFieldsContextValue}>\n        <SectionContentWithHostChrome hostKind={hostKind} chromeMode={chromeMode}>\n          {children}\n        </SectionContentWithHostChrome>\n        {saveable && <SectionSaveButton sectionName={name} disabled={disabled} />}\n      </SectionFieldsContext.Provider>\n    );\n  } else {\n    content = (\n      <SectionContentWithHostChrome hostKind={hostKind} chromeMode={chromeMode}>\n        {children}\n      </SectionContentWithHostChrome>\n    );\n  }\n\n  return (\n    // Same de-duplication contract as the solo-section path (see the provider\n    // around `content` in Section above): when the grouping container renders\n    // this section's title, an embedded resource surface must not stack its\n    // own generic heading + breadcrumb under it.\n    <SectionHostHeadingContext.Provider value={providesHeading}>\n      <div\n        className={className ? `space-y-field ${className}` : 'space-y-field'}\n        data-guidance-section={name}\n        data-composite-section={hostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined}\n      >\n        {content}\n      </div>\n    </SectionHostHeadingContext.Provider>\n  );\n}\n\nfunction SectionContentWithHostChrome({\n  hostKind,\n  chromeMode,\n  children,\n}: {\n  hostKind: GroupedSectionHostKind;\n  chromeMode?: SectionProps['chromeMode'];\n  children: ReactNode;\n}): ReactNode {\n  if (!chromeMode) {\n    return children;\n  }\n\n  if (hostKind === GroupedSectionHostKind.FORM) {\n    return <FormChromeProvider sectionChromeMode={chromeMode}>{children}</FormChromeProvider>;\n  }\n\n  if (hostKind === GroupedSectionHostKind.DISPLAY) {\n    return <DisplayChromeProvider sectionChromeMode={toDisplayChromeMode(chromeMode)}>{children}</DisplayChromeProvider>;\n  }\n\n  return children;\n}\n\n\n// =============================================================================\n// SectionSaveButton (extracted to avoid useFormContext crash in display templates)\n// =============================================================================\n\nexport interface SectionSaveButtonProps {\n  sectionName: string;\n  disabled?: boolean;\n}\n\n/**\n * Section-level save button — only rendered inside form contexts.\n * Extracted from Section to isolate the useFormContext() call, preventing\n * crashes when Section is used inside display templates.\n *\n * Also rendered by `GroupedSectionBody` for grouped (tabbed/accordion)\n * container section panels mounted via `GroupedSectionContent` in\n * `FormLayout.tsx`.\n */\nexport function SectionSaveButton({ sectionName, disabled }: SectionSaveButtonProps): ReactNode {\n  const form = useFormContext();\n  const ctx = useOptionalFormTemplateContext();\n  const registeredFieldNames = useRegisteredSectionFields();\n  const [isSaving, setIsSaving] = useState(false);\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  const onSectionSave = ctx?.onSectionSave;\n  if (!onSectionSave) return null;\n  if (!isReady) return null;\n\n  const handleSave = async () => {\n    if (registeredFieldNames.length === 0) {\n      return;\n    }\n\n    // An invalid section shows its errors and brings the first on screen; it used to stop with nothing visible.\n    if (!(await validateFieldsAndShowErrors(form, registeredFieldNames))) {\n      return;\n    }\n\n    setIsSaving(true);\n    try {\n      const formValues = form.getValues();\n      await onSectionSave(sectionName, registeredFieldNames, formValues as Record<string, unknown>);\n    } catch (error) {\n      // The form's own handler reports its failures and never throws; a caller-supplied one may. Logged rather than\n      // left to escape the click handler as an unhandled rejection.\n      logger.error('[SectionSaveButton] The section save handler threw.', { sectionName, error });\n    } finally {\n      setIsSaving(false);\n    }\n  };\n\n  const savingLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSaving');\n  const saveLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSave');\n\n  return (\n    <div className=\"flex justify-end pt-item\">\n      <Button\n        type=\"button\"\n        variant={ButtonVariants_Variant.SECONDARY}\n        size={ButtonSize.SM}\n        onClick={handleSave}\n        disabled={disabled || isSaving || registeredFieldNames.length === 0}\n      >\n        {isSaving ? savingLabel : saveLabel}\n      </Button>\n    </div>\n  );\n}\n"]}

package/dist/esm/components/resources/skeleton/SectionPresentationContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionPresentationContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,GAAG,IAAI,CAE9F"}
+{"version":3,"file":"SectionPresentationContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,GAAG,IAAI,CAE9F"}

package/dist/esm/components/resources/skeleton/SubmitButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitButton.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAmCrH;yBAnCe,YAAY"}
+{"version":3,"file":"SubmitButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAmCrH;yBAnCe,YAAY"}

package/dist/esm/components/resources/skeleton/SummaryLayout.d.ts

@@ -54,9 +54,9 @@ export interface SummaryLayoutProps {
  * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).
  *
  * The title resolves its text from `SummaryContext` (provided by
- * `ResourceSummaryDisplayer`); on body-only surfaces with no title (inline
- * FK-field references) `<SummaryTitle />` renders nothing, so `AUTO` shows no
- * empty title slot.
+ * `ResourceSummaryDisplayer`); a host that draws the record's name itself passes
+ * none (the no-template list card, the read summary's fallback), and then
+ * `<SummaryTitle />` renders nothing, so `AUTO` shows no empty title slot.
  *
  * ## It owns its own root chrome, and the FLOW is declared rather than drawn
  *

package/dist/esm/components/resources/skeleton/SummaryLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B;;;;OAIG;IACH,IAAI,SAAS;IACb;;;;;OAKG;IACH,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,kFAAkF;IAClF,KAAK,UAAU;IACf,gGAAgG;IAChG,GAAG,QAAQ;CACZ;AAQD,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAwB,EACxB,SAAS,EACT,cAA2C,EAC3C,QAAQ,GACT,EAAE,kBAAkB,GAAG,SAAS,CAiChC"}
+{"version":3,"file":"SummaryLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B;;;;OAIG;IACH,IAAI,SAAS;IACb;;;;;OAKG;IACH,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,kFAAkF;IAClF,KAAK,UAAU;IACf,gGAAgG;IAChG,GAAG,QAAQ;CACZ;AAQD,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAwB,EACxB,SAAS,EACT,cAA2C,EAC3C,QAAQ,GACT,EAAE,kBAAkB,GAAG,SAAS,CAiChC"}

package/dist/esm/components/resources/skeleton/SummaryLayout.js

@@ -81,9 +81,9 @@ function templatePlacesItsOwnTitle(children) {
  * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).
  *
  * The title resolves its text from `SummaryContext` (provided by
- * `ResourceSummaryDisplayer`); on body-only surfaces with no title (inline
- * FK-field references) `<SummaryTitle />` renders nothing, so `AUTO` shows no
- * empty title slot.
+ * `ResourceSummaryDisplayer`); a host that draws the record's name itself passes
+ * none (the no-template list card, the read summary's fallback), and then
+ * `<SummaryTitle />` renders nothing, so `AUTO` shows no empty title slot.
  *
  * ## It owns its own root chrome, and the FLOW is declared rather than drawn
  *

package/dist/esm/components/resources/skeleton/SummaryLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryLayout.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAcX;AAdD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,sCAAa,CAAA;IACb;;;;;OAKG;IACH,0DAAiC,CAAA;AACnC,CAAC,EAdW,qBAAqB,KAArB,qBAAqB,QAchC;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,kFAAkF;IAClF,8BAAe,CAAA;IACf,gGAAgG;IAChG,0BAAW,CAAA;AACb,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,2FAA2F;AAC3F,MAAM,oBAAoB,GAAgC;IACxD,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,mCAAmC;IACxD,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,4DAA4D;CAChF,CAAC;AAgBF;;;;;;;;;;;;GAYG;AACH,SAAS,yBAAyB,CAAC,QAAmB;IACpD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAI,KAAK,CAAC,KAA8C,EAAE,QAAQ,CAAC;QAC/E,IAAI,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,MAAM,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,GAAG,WAAW,CAAC,KAAK,EACxB,SAAS,EACT,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAC3C,QAAQ,GACW;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,SAAS,GAAG,cAAc,KAAK,qBAAqB,CAAC,IAAI;WAC1D,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,CACL,KAAC,kBAAkB,IAAC,UAAU,EAAC,EAAE,YAC/B,eAAK,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aACtD,SAAS,IAAI,KAAC,YAAY,KAAG,EAC7B,QAAQ,IACL,GACa,CACtB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { Children, isValidElement } from 'react';\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport { SummaryTitle } from './SummaryTitle';\n\n/**\n * Where the primary title (`<SummaryTitle />`) is placed within a summary\n * template. The placement decision lives HERE, in the template markup that\n * governs it — not in a parallel `layout.*` config field.\n */\nexport enum SummaryTitlePlacement {\n  /**\n   * Framework places the title automatically at the top of the template, above\n   * the authored children. The zero-boilerplate, title-above-body default —\n   * matches the classic list/card summary look.\n   */\n  AUTO = 'auto',\n  /**\n   * The author owns title placement: `SummaryLayout` renders only its children,\n   * and the author drops `<SummaryTitle />` wherever it belongs (e.g. inside a\n   * `<SummaryHeader>` beside a status badge). Required whenever the title must\n   * share a line with other content.\n   */\n  TEMPLATE_OWNED = 'template-owned',\n}\n\n/**\n * How a summary's own children are arranged.\n *\n * A behavior, not a style: the caller says which of the two summaries this is, and the classes each\n * resolves to stay here where a theme can reach them.\n */\nexport enum SummaryFlow {\n  /** Title above a short body — the ordinary card, list-row and popover summary. */\n  STACK = 'stack',\n  /** One wrapping line of values — for a summary that IS its meta row, with no title above it. */\n  ROW = 'row',\n}\n\n/** The geometry each flow resolves to. Tokens, not raw steps: `gap-element` IS `gap-2`. */\nconst SUMMARY_FLOW_CLASSES: Record<SummaryFlow, string> = {\n  [SummaryFlow.STACK]: 'flex flex-col gap-element text-sm',\n  [SummaryFlow.ROW]: 'flex flex-wrap items-center gap-x-group gap-y-item text-sm',\n};\n\nexport interface SummaryLayoutProps {\n  /** How the children are arranged. Defaults to {@link SummaryFlow.STACK}. */\n  flow?: SummaryFlow;\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * Title placement. Defaults to {@link SummaryTitlePlacement.AUTO} (title\n   * rendered at the top). Switch to `TEMPLATE_OWNED` to place `<SummaryTitle />`\n   * yourself within the flow.\n   */\n  titlePlacement?: SummaryTitlePlacement;\n  children?: ReactNode;\n}\n\n/**\n * Does this template place its OWN title?\n *\n * Walks the statically-composed children for a `<SummaryTitle>` element, at any depth — the\n * documented inline-title shape nests it inside `<SummaryHeader>`, so a shallow check would miss\n * exactly the arrangement `TEMPLATE_OWNED` exists for.\n *\n * RESIDUAL, stated rather than hidden: a title rendered by a nested COMPONENT of the author's own\n * (rather than as JSX in the template) is invisible here, and that template would still double its\n * title. Every summary template in the repository composes its children inline, so the population\n * this cannot see is currently empty; a `React.Children` walk is the honest limit of what a parent\n * can know before its children render.\n */\nfunction templatePlacesItsOwnTitle(children: ReactNode): boolean {\n  let found = false;\n  Children.forEach(children, (child) => {\n    if (found || !isValidElement(child)) return;\n    if (child.type === SummaryTitle) {\n      found = true;\n      return;\n    }\n    const nested = (child.props as { children?: ReactNode } | undefined)?.children;\n    if (nested !== undefined && templatePlacesItsOwnTitle(nested)) found = true;\n  });\n  return found;\n}\n\n/**\n * Root wrapper for summary layout templates (cards, list items, FK references).\n *\n * Owns TITLE PLACEMENT for the template: under `AUTO` (default) it renders\n * `<SummaryTitle />` at the top, then the children body — so an author who just\n * wants \"title above a couple of fields\" writes nothing about the title. Under\n * `TEMPLATE_OWNED` it renders only the children, and the author composes\n * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).\n *\n * The title resolves its text from `SummaryContext` (provided by\n * `ResourceSummaryDisplayer`); on body-only surfaces with no title (inline\n * FK-field references) `<SummaryTitle />` renders nothing, so `AUTO` shows no\n * empty title slot.\n *\n * ## It owns its own root chrome, and the FLOW is declared rather than drawn\n *\n * The geometry used to be passed in by every caller, and enumerating those callers is what settled\n * the shape of this prop. Across the engine's own resource presets there are exactly two summaries:\n *\n * - **39 stacked** — `className=\"flex flex-col gap-2 text-sm\"` (22) or a bare `text-sm` (4), plus\n *   the workbench's own; a title with a short body beneath it.\n * - **13 in a single wrapping row** — `className=\"flex flex-wrap items-center gap-x-3 gap-y-1\n *   text-sm\"`; a summary that IS its meta line, with no title above it.\n *\n * So the honest default is not one geometry but a CHOICE of two, and shipping only the stack would\n * have been actively wrong: `flex-wrap` and `flex-col` are different conflict groups, so a caller\n * passing the row geometry over a `flex-col` default gets a wrapping COLUMN — thirteen surfaces\n * silently rearranged. Naming the two lets a caller say which one it is and lets the theme own what\n * each looks like.\n *\n * `SummaryFlow.ROW` is deliberately the same geometry as {@link SummaryMeta}: a summary that is only\n * a meta line and a meta line inside a stacked summary are the same thing at different levels, and\n * they should not be able to drift apart.\n *\n * Provides a root `FieldScopeContext` with empty prefix.\n *\n * @example\n * ```tsx\n * // AUTO — title rendered above the body automatically:\n * <SummaryLayout>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n *\n * // TEMPLATE_OWNED — badge on the same line as the title:\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n */\nexport function SummaryLayout({\n  flow = SummaryFlow.STACK,\n  className,\n  titlePlacement = SummaryTitlePlacement.AUTO,\n  children,\n}: SummaryLayoutProps): ReactNode {\n  /*\n   * AUTO means \"the framework places the title\". A template that places one ITSELF has already\n   * discharged that, whatever it declared — so placing a second is not a stricter reading of the\n   * contract, it is the contract contradicting itself on screen.\n   *\n   * Measured 2026-09-20 across every summary template in `engine/presets-components`, `platform/`\n   * and `examples/`: of 72 `<SummaryLayout>` blocks, **20 mount their own `<SummaryTitle>` while\n   * leaving `titlePlacement` at AUTO** — organizations, billing, identity, security, application and\n   * a Wonder app's pipeline stage. Every one of them rendered two titles. The audit trail's is the\n   * clearest to read, showing `eventType — <ISO timestamp>` and then `eventType` again on the line\n   * below; `pipeline-stage.ui-behavior.tsx` is the purest, mounting the LABEL form under AUTO so the\n   * same string printed twice verbatim.\n   *\n   * Twenty of seventy-two is not twenty authoring slips. It is a default that asks to be\n   * countermanded by a declaration nobody has a reason to remember, and the framework is the only\n   * party that can see both halves — so it is the one that should reconcile them.\n   *\n   * The author's title WINS, deliberately. `<SummaryTitle name=\"x\" />` is a statement about what the\n   * title of this card IS; the framework's automatic one is a default standing in for the absence of\n   * such a statement. When both are present, only one of them was chosen.\n   */\n  const autoTitle = titlePlacement === SummaryTitlePlacement.AUTO\n    && !templatePlacesItsOwnTitle(children);\n\n  return (\n    <FieldScopeProvider pathPrefix=\"\">\n      <div className={cn(SUMMARY_FLOW_CLASSES[flow], className)}>\n        {autoTitle && <SummaryTitle />}\n        {children}\n      </div>\n    </FieldScopeProvider>\n  );\n}\n"]}
+{"version":3,"file":"SummaryLayout.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAcX;AAdD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,sCAAa,CAAA;IACb;;;;;OAKG;IACH,0DAAiC,CAAA;AACnC,CAAC,EAdW,qBAAqB,KAArB,qBAAqB,QAchC;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,kFAAkF;IAClF,8BAAe,CAAA;IACf,gGAAgG;IAChG,0BAAW,CAAA;AACb,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,2FAA2F;AAC3F,MAAM,oBAAoB,GAAgC;IACxD,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,mCAAmC;IACxD,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,4DAA4D;CAChF,CAAC;AAgBF;;;;;;;;;;;;GAYG;AACH,SAAS,yBAAyB,CAAC,QAAmB;IACpD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAI,KAAK,CAAC,KAA8C,EAAE,QAAQ,CAAC;QAC/E,IAAI,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,MAAM,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,GAAG,WAAW,CAAC,KAAK,EACxB,SAAS,EACT,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAC3C,QAAQ,GACW;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,SAAS,GAAG,cAAc,KAAK,qBAAqB,CAAC,IAAI;WAC1D,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,CACL,KAAC,kBAAkB,IAAC,UAAU,EAAC,EAAE,YAC/B,eAAK,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aACtD,SAAS,IAAI,KAAC,YAAY,KAAG,EAC7B,QAAQ,IACL,GACa,CACtB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { Children, isValidElement } from 'react';\nimport type { ReactNode } from 'react';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport { SummaryTitle } from './SummaryTitle';\n\n/**\n * Where the primary title (`<SummaryTitle />`) is placed within a summary\n * template. The placement decision lives HERE, in the template markup that\n * governs it — not in a parallel `layout.*` config field.\n */\nexport enum SummaryTitlePlacement {\n  /**\n   * Framework places the title automatically at the top of the template, above\n   * the authored children. The zero-boilerplate, title-above-body default —\n   * matches the classic list/card summary look.\n   */\n  AUTO = 'auto',\n  /**\n   * The author owns title placement: `SummaryLayout` renders only its children,\n   * and the author drops `<SummaryTitle />` wherever it belongs (e.g. inside a\n   * `<SummaryHeader>` beside a status badge). Required whenever the title must\n   * share a line with other content.\n   */\n  TEMPLATE_OWNED = 'template-owned',\n}\n\n/**\n * How a summary's own children are arranged.\n *\n * A behavior, not a style: the caller says which of the two summaries this is, and the classes each\n * resolves to stay here where a theme can reach them.\n */\nexport enum SummaryFlow {\n  /** Title above a short body — the ordinary card, list-row and popover summary. */\n  STACK = 'stack',\n  /** One wrapping line of values — for a summary that IS its meta row, with no title above it. */\n  ROW = 'row',\n}\n\n/** The geometry each flow resolves to. Tokens, not raw steps: `gap-element` IS `gap-2`. */\nconst SUMMARY_FLOW_CLASSES: Record<SummaryFlow, string> = {\n  [SummaryFlow.STACK]: 'flex flex-col gap-element text-sm',\n  [SummaryFlow.ROW]: 'flex flex-wrap items-center gap-x-group gap-y-item text-sm',\n};\n\nexport interface SummaryLayoutProps {\n  /** How the children are arranged. Defaults to {@link SummaryFlow.STACK}. */\n  flow?: SummaryFlow;\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * Title placement. Defaults to {@link SummaryTitlePlacement.AUTO} (title\n   * rendered at the top). Switch to `TEMPLATE_OWNED` to place `<SummaryTitle />`\n   * yourself within the flow.\n   */\n  titlePlacement?: SummaryTitlePlacement;\n  children?: ReactNode;\n}\n\n/**\n * Does this template place its OWN title?\n *\n * Walks the statically-composed children for a `<SummaryTitle>` element, at any depth — the\n * documented inline-title shape nests it inside `<SummaryHeader>`, so a shallow check would miss\n * exactly the arrangement `TEMPLATE_OWNED` exists for.\n *\n * RESIDUAL, stated rather than hidden: a title rendered by a nested COMPONENT of the author's own\n * (rather than as JSX in the template) is invisible here, and that template would still double its\n * title. Every summary template in the repository composes its children inline, so the population\n * this cannot see is currently empty; a `React.Children` walk is the honest limit of what a parent\n * can know before its children render.\n */\nfunction templatePlacesItsOwnTitle(children: ReactNode): boolean {\n  let found = false;\n  Children.forEach(children, (child) => {\n    if (found || !isValidElement(child)) return;\n    if (child.type === SummaryTitle) {\n      found = true;\n      return;\n    }\n    const nested = (child.props as { children?: ReactNode } | undefined)?.children;\n    if (nested !== undefined && templatePlacesItsOwnTitle(nested)) found = true;\n  });\n  return found;\n}\n\n/**\n * Root wrapper for summary layout templates (cards, list items, FK references).\n *\n * Owns TITLE PLACEMENT for the template: under `AUTO` (default) it renders\n * `<SummaryTitle />` at the top, then the children body — so an author who just\n * wants \"title above a couple of fields\" writes nothing about the title. Under\n * `TEMPLATE_OWNED` it renders only the children, and the author composes\n * `<SummaryTitle />` into the flow (see {@link SummaryHeader}).\n *\n * The title resolves its text from `SummaryContext` (provided by\n * `ResourceSummaryDisplayer`); a host that draws the record's name itself passes\n * none (the no-template list card, the read summary's fallback), and then\n * `<SummaryTitle />` renders nothing, so `AUTO` shows no empty title slot.\n *\n * ## It owns its own root chrome, and the FLOW is declared rather than drawn\n *\n * The geometry used to be passed in by every caller, and enumerating those callers is what settled\n * the shape of this prop. Across the engine's own resource presets there are exactly two summaries:\n *\n * - **39 stacked** — `className=\"flex flex-col gap-2 text-sm\"` (22) or a bare `text-sm` (4), plus\n *   the workbench's own; a title with a short body beneath it.\n * - **13 in a single wrapping row** — `className=\"flex flex-wrap items-center gap-x-3 gap-y-1\n *   text-sm\"`; a summary that IS its meta line, with no title above it.\n *\n * So the honest default is not one geometry but a CHOICE of two, and shipping only the stack would\n * have been actively wrong: `flex-wrap` and `flex-col` are different conflict groups, so a caller\n * passing the row geometry over a `flex-col` default gets a wrapping COLUMN — thirteen surfaces\n * silently rearranged. Naming the two lets a caller say which one it is and lets the theme own what\n * each looks like.\n *\n * `SummaryFlow.ROW` is deliberately the same geometry as {@link SummaryMeta}: a summary that is only\n * a meta line and a meta line inside a stacked summary are the same thing at different levels, and\n * they should not be able to drift apart.\n *\n * Provides a root `FieldScopeContext` with empty prefix.\n *\n * @example\n * ```tsx\n * // AUTO — title rendered above the body automatically:\n * <SummaryLayout>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n *\n * // TEMPLATE_OWNED — badge on the same line as the title:\n * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n *   <SummaryHeader>\n *     <SummaryTitle />\n *     <DisplayField name=\"status\" hideLabel />\n *   </SummaryHeader>\n *   <DisplayField name=\"createdAt\" />\n * </SummaryLayout>\n * ```\n */\nexport function SummaryLayout({\n  flow = SummaryFlow.STACK,\n  className,\n  titlePlacement = SummaryTitlePlacement.AUTO,\n  children,\n}: SummaryLayoutProps): ReactNode {\n  /*\n   * AUTO means \"the framework places the title\". A template that places one ITSELF has already\n   * discharged that, whatever it declared — so placing a second is not a stricter reading of the\n   * contract, it is the contract contradicting itself on screen.\n   *\n   * Measured 2026-09-20 across every summary template in `engine/presets-components`, `platform/`\n   * and `examples/`: of 72 `<SummaryLayout>` blocks, **20 mount their own `<SummaryTitle>` while\n   * leaving `titlePlacement` at AUTO** — organizations, billing, identity, security, application and\n   * a Wonder app's pipeline stage. Every one of them rendered two titles. The audit trail's is the\n   * clearest to read, showing `eventType — <ISO timestamp>` and then `eventType` again on the line\n   * below; `pipeline-stage.ui-behavior.tsx` is the purest, mounting the LABEL form under AUTO so the\n   * same string printed twice verbatim.\n   *\n   * Twenty of seventy-two is not twenty authoring slips. It is a default that asks to be\n   * countermanded by a declaration nobody has a reason to remember, and the framework is the only\n   * party that can see both halves — so it is the one that should reconcile them.\n   *\n   * The author's title WINS, deliberately. `<SummaryTitle name=\"x\" />` is a statement about what the\n   * title of this card IS; the framework's automatic one is a default standing in for the absence of\n   * such a statement. When both are present, only one of them was chosen.\n   */\n  const autoTitle = titlePlacement === SummaryTitlePlacement.AUTO\n    && !templatePlacesItsOwnTitle(children);\n\n  return (\n    <FieldScopeProvider pathPrefix=\"\">\n      <div className={cn(SUMMARY_FLOW_CLASSES[flow], className)}>\n        {autoTitle && <SummaryTitle />}\n        {children}\n      </div>\n    </FieldScopeProvider>\n  );\n}\n"]}

package/dist/esm/components/resources/skeleton/SummaryTitle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryTitle.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,OAAO,YAAY;IACnB,mFAAmF;IACnF,KAAK,UAAU;IACf,qCAAqC;IACrC,OAAO,YAAY;IACnB,+BAA+B;IAC/B,QAAQ,aAAa;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAiC,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4DjH"}
+{"version":3,"file":"SummaryTitle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SummaryTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,2FAA2F;IAC3F,OAAO,YAAY;IACnB,mFAAmF;IACnF,KAAK,UAAU;IACf,qCAAqC;IACrC,OAAO,YAAY;IACnB,+BAA+B;IAC/B,QAAQ,aAAa;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAiC,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,SAAS,CA4DjH"}

package/dist/esm/components/resources/skeleton/WizardLayout.d.ts

@@ -16,15 +16,17 @@ export interface WizardLayoutProps {
  * Wizard container for multi-step form templates.
  *
  * Manages step state, renders a Stepper UI, navigation buttons (prev/next/submit),
- * and per-step validation. All steps remain mounted (hidden with `display: none`)
- * so that RHF retains field state across steps.
+ * and per-step validation. All steps remain mounted (the inactive ones `hidden`)
+ * so that RHF retains field state across steps; a field on a hidden step is shown
+ * on request by the error scroll (`field-reveal.ts`).
  *
- * Children must be `<WizardStep>` components. Non-WizardStep children are
- * silently filtered out.
+ * Children must be `<WizardStep>` components, directly or inside a Fragment. Other
+ * children are filtered out.
  *
  * Under a resource form (a create or edit dialog or page) the wizard OWNS the form's footer: it claims it
  * (`claimFooter`) and renders the host's Cancel, draft-save and operation-named submit inside its own
- * navigation row — the submit on the last step only. Otherwise the host appended its own Cancel/Create row
+ * navigation row: the submit on the last step when the form creates a record, and on every step when it edits one
+ * that exists (`submitOnEveryStep`). Otherwise the host appended its own Cancel/Create row
  * under the wizard's Previous/Next, so "Create" on step 1 submitted without the later steps ever being seen,
  * and the last step offered two submit buttons.
  *

package/dist/esm/components/resources/skeleton/WizardLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WizardLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/WizardLayout.tsx"],"names":[],"mappings":"AAEA,OAAc,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBvG,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,WAAe,EACf,oBAA2B,EAC3B,YAAY,EACZ,YAAY,EACZ,QAAQ,GACT,EAAE,iBAAiB,GAAG,SAAS,CAyL/B"}
+{"version":3,"file":"WizardLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/WizardLayout.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAkF,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAgC9H,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,WAAe,EACf,oBAA2B,EAC3B,YAAY,EACZ,YAAY,EACZ,QAAQ,GACT,EAAE,iBAAiB,GAAG,SAAS,CAmS/B"}