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

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

@@ -1 +1 @@
-{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG,SAAS,CAc1E;yBAde,KAAK"}
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG,SAAS,CA0B1E;yBA1Be,KAAK"}

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

@@ -28,7 +28,7 @@ export function Group({ name, className, children }) {
     const displayCtx = useOptionalDisplayTemplateContext();
     const title = formCtx?.groupLabels?.[name] ??
         displayCtx?.groupLabels?.[name];
-    return (_jsxs("div", { className: className, "data-guidance-group": name, children: [title && _jsx(Subheading, { level: 3, className: "mb-element", children: title }), children] }));
+    return (_jsxs("div", { className: className, "data-guidance-group": name, children: [title && _jsx(Subheading, { level: 3, className: "col-span-full mb-element", children: title }), children] }));
 }
 Group.displayName = 'Group';
 //# sourceMappingURL=Group.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Group.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Group.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAetD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAc;IAC7D,MAAM,OAAO,GAAG,8BAA8B,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,iCAAiC,EAAE,CAAC;IAEvD,MAAM,KAAK,GACT,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC;QAC5B,UAAU,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO,CACL,eAAK,SAAS,EAAE,SAAS,yBAAuB,IAAI,aACjD,KAAK,IAAI,KAAC,UAAU,IAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAC,YAAY,YAAE,KAAK,GAAc,EAC1E,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAED,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext';\nimport { Subheading } from '../../typography/heading';\n\nexport interface GroupProps {\n  /**\n   * Structural ref — maps to i18n keys for title:\n   * - `resources.{type}.groups.{name}.title`\n   *\n   * Must match an entry in `layout.refs.groups`.\n   */\n  name: string;\n  /** Additional CSS classes for the group container. */\n  className?: string;\n  children: ReactNode;\n}\n\n/**\n * Visual grouping for form and display templates.\n *\n * Groups fields with an optional i18n title resolved from:\n *   formCtx.groupLabels → displayCtx.groupLabels\n *\n * Groups and sections are distinct concepts with separate i18n namespaces\n * (`resources.{type}.groups.{ref}.title` vs `resources.{type}.sections.{ref}.title`).\n * No cross-pollination between the two.\n *\n * @example\n * ```tsx\n * <DisplayLayout>\n *   <Group name=\"contact\" className=\"hidden md:block\">\n *     <DisplayField name=\"email\" />\n *     <DisplayField name=\"phone\" />\n *   </Group>\n * </DisplayLayout>\n * ```\n */\nexport function Group({ name, className, children }: GroupProps): ReactNode {\n  const formCtx = useOptionalFormTemplateContext();\n  const displayCtx = useOptionalDisplayTemplateContext();\n\n  const title =\n    formCtx?.groupLabels?.[name] ??\n    displayCtx?.groupLabels?.[name];\n\n  return (\n    <div className={className} data-guidance-group={name}>\n      {title && <Subheading level={3} className=\"mb-element\">{title}</Subheading>}\n      {children}\n    </div>\n  );\n}\n\nGroup.displayName = 'Group';\n"]}
+{"version":3,"file":"Group.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Group.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAetD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAc;IAC7D,MAAM,OAAO,GAAG,8BAA8B,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,iCAAiC,EAAE,CAAC;IAEvD,MAAM,KAAK,GACT,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC;QAC5B,UAAU,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO,CACL,eAAK,SAAS,EAAE,SAAS,yBAAuB,IAAI,aAajD,KAAK,IAAI,KAAC,UAAU,IAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAC,0BAA0B,YAAE,KAAK,GAAc,EACxF,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAED,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext';\nimport { Subheading } from '../../typography/heading';\n\nexport interface GroupProps {\n  /**\n   * Structural ref — maps to i18n keys for title:\n   * - `resources.{type}.groups.{name}.title`\n   *\n   * Must match an entry in `layout.refs.groups`.\n   */\n  name: string;\n  /** Additional CSS classes for the group container. */\n  className?: string;\n  children: ReactNode;\n}\n\n/**\n * Visual grouping for form and display templates.\n *\n * Groups fields with an optional i18n title resolved from:\n *   formCtx.groupLabels → displayCtx.groupLabels\n *\n * Groups and sections are distinct concepts with separate i18n namespaces\n * (`resources.{type}.groups.{ref}.title` vs `resources.{type}.sections.{ref}.title`).\n * No cross-pollination between the two.\n *\n * @example\n * ```tsx\n * <DisplayLayout>\n *   <Group name=\"contact\" className=\"hidden md:block\">\n *     <DisplayField name=\"email\" />\n *     <DisplayField name=\"phone\" />\n *   </Group>\n * </DisplayLayout>\n * ```\n */\nexport function Group({ name, className, children }: GroupProps): ReactNode {\n  const formCtx = useOptionalFormTemplateContext();\n  const displayCtx = useOptionalDisplayTemplateContext();\n\n  const title =\n    formCtx?.groupLabels?.[name] ??\n    displayCtx?.groupLabels?.[name];\n\n  return (\n    <div className={className} data-guidance-group={name}>\n      {/*\n        * `col-span-full` because `className` is where callers put the group's LAYOUT, and the heading\n        * shares that element with the fields. Under `grid grid-cols-2` the heading took the first\n        * cell and pushed every field one cell over — measured on the Wonder Todos edit template,\n        * where \"Workflow\" sat BESIDE Status instead of above it, and each field after it landed in\n        * the other column from the one its neighbours implied. Spanning the full row gives the\n        * heading its own line in any grid and does nothing at all in a flex or block layout.\n        *\n        * Not solved by moving `className` onto an inner wrapper around the fields: the documented\n        * use `className=\"hidden md:block\"` means \"hide this GROUP\", heading included, and that\n        * would start hiding the fields while leaving an orphaned heading on screen.\n        */}\n      {title && <Subheading level={3} className=\"col-span-full mb-element\">{title}</Subheading>}\n      {children}\n    </div>\n  );\n}\n\nGroup.displayName = 'Group';\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectScope.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ObjectScope.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CActF"}
+{"version":3,"file":"ObjectScope.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ObjectScope.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CActF"}

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

@@ -1,6 +1,7 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { FieldScopeProvider, useFieldScope } from './FieldScopeContext.js';
+import { declareSectionContentRole, SectionContentRole } from './SectionFieldsContext.js';
 /**
  * Establishes a `FieldScopeContext` for nested object fields.
  *
@@ -39,4 +40,6 @@ export function ObjectScope({ name, className, children }) {
     }
     return content;
 }
+// Scopes field names and adds no content of its own: a section judges its children in its place.
+declareSectionContentRole(ObjectScope, SectionContentRole.FIELD_SLOT_CONTAINER);
 //# sourceMappingURL=ObjectScope.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectScope.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ObjectScope.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAaxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAoB;IACzE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnE,MAAM,OAAO,GAAG,CACd,KAAC,kBAAkB,IAAC,UAAU,EAAE,cAAc,YAC3C,QAAQ,GACU,CACtB,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,cAAK,SAAS,EAAE,SAAS,YAAG,OAAO,GAAO,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { FieldScopeProvider, useFieldScope } from './FieldScopeContext';\n\nexport interface ObjectScopeProps {\n  /**\n   * Name of the nested object field in the parent schema.\n   * Children use relative field names that resolve against this scope.\n   */\n  name: string;\n  /** Additional CSS classes for the scope container (rendered only when provided). */\n  className?: string;\n  children: ReactNode;\n}\n\n/**\n * Establishes a `FieldScopeContext` for nested object fields.\n *\n * Children use **relative** field names that compose with the scope:\n * `<ObjectScope name=\"address\">` + `<FormField name=\"street\" />` → `\"address.street\"`\n *\n * Scopes compose naturally for deep nesting:\n * ```\n * <ObjectScope name=\"company\">\n *   <ObjectScope name=\"address\">\n *     <FormField name=\"street\" />  → \"company.address.street\"\n *   </ObjectScope>\n * </ObjectScope>\n * ```\n *\n * @example\n * ```tsx\n * <Section name=\"shipping\">\n *   <ObjectScope name=\"address\">\n *     <div className=\"grid grid-cols-2 gap-4\">\n *       <FormField name=\"street\" className=\"col-span-2\" />\n *       <FormField name=\"city\" />\n *       <FormField name=\"zipCode\" />\n *     </div>\n *     <FormField name=\"country\" />\n *   </ObjectScope>\n * </Section>\n * ```\n */\nexport function ObjectScope({ name, className, children }: ObjectScopeProps): ReactNode {\n  const { pathPrefix } = useFieldScope();\n  const composedPrefix = pathPrefix ? `${pathPrefix}.${name}` : name;\n\n  const content = (\n    <FieldScopeProvider pathPrefix={composedPrefix}>\n      {children}\n    </FieldScopeProvider>\n  );\n\n  if (className) {\n    return <div className={className}>{content}</div>;\n  }\n  return content;\n}\n"]}
+{"version":3,"file":"ObjectScope.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ObjectScope.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAavF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAoB;IACzE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnE,MAAM,OAAO,GAAG,CACd,KAAC,kBAAkB,IAAC,UAAU,EAAE,cAAc,YAC3C,QAAQ,GACU,CACtB,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,cAAK,SAAS,EAAE,SAAS,YAAG,OAAO,GAAO,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iGAAiG;AACjG,yBAAyB,CAAC,WAAW,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { FieldScopeProvider, useFieldScope } from './FieldScopeContext';\nimport { declareSectionContentRole, SectionContentRole } from './SectionFieldsContext';\n\nexport interface ObjectScopeProps {\n  /**\n   * Name of the nested object field in the parent schema.\n   * Children use relative field names that resolve against this scope.\n   */\n  name: string;\n  /** Additional CSS classes for the scope container (rendered only when provided). */\n  className?: string;\n  children: ReactNode;\n}\n\n/**\n * Establishes a `FieldScopeContext` for nested object fields.\n *\n * Children use **relative** field names that compose with the scope:\n * `<ObjectScope name=\"address\">` + `<FormField name=\"street\" />` → `\"address.street\"`\n *\n * Scopes compose naturally for deep nesting:\n * ```\n * <ObjectScope name=\"company\">\n *   <ObjectScope name=\"address\">\n *     <FormField name=\"street\" />  → \"company.address.street\"\n *   </ObjectScope>\n * </ObjectScope>\n * ```\n *\n * @example\n * ```tsx\n * <Section name=\"shipping\">\n *   <ObjectScope name=\"address\">\n *     <div className=\"grid grid-cols-2 gap-4\">\n *       <FormField name=\"street\" className=\"col-span-2\" />\n *       <FormField name=\"city\" />\n *       <FormField name=\"zipCode\" />\n *     </div>\n *     <FormField name=\"country\" />\n *   </ObjectScope>\n * </Section>\n * ```\n */\nexport function ObjectScope({ name, className, children }: ObjectScopeProps): ReactNode {\n  const { pathPrefix } = useFieldScope();\n  const composedPrefix = pathPrefix ? `${pathPrefix}.${name}` : name;\n\n  const content = (\n    <FieldScopeProvider pathPrefix={composedPrefix}>\n      {children}\n    </FieldScopeProvider>\n  );\n\n  if (className) {\n    return <div className={className}>{content}</div>;\n  }\n  return content;\n}\n\n// Scopes field names and adds no content of its own: a section judges its children in its place.\ndeclareSectionContentRole(ObjectScope, SectionContentRole.FIELD_SLOT_CONTAINER);\n"]}

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

@@ -40,6 +40,20 @@ export interface ResourceHeaderContextValue {
      * record-specific name to show — `<ResourceHeaderTitle />` then renders nothing.
      */
     title: string | null;
+    /**
+     * `true` while the record's name is still being fetched and nothing else stands in for it.
+     * `<ResourceHeaderTitle />` then RESERVES the title's line with a skeleton instead of rendering
+     * nothing.
+     *
+     * An empty band is a defect, not a flicker. The header withholds the label during the first fetch
+     * on purpose (it would otherwise flash `#id` and then the real name), and the title element used to
+     * render nothing meanwhile — so the band had no height and the name's arrival pushed everything
+     * beneath it down by a line. Measured 2026-09-21 in the creation workbench's actor-task modal:
+     * `mousedown` landed on a tab, the record arrived, `mouseup` one millisecond later landed on the
+     * heading, and the browser dispatched the click to their common ancestor. The tab never changed
+     * and nothing reported why.
+     */
+    titlePending?: boolean;
     /**
      * Dev-diagnostic seam: `<ResourceHeaderTitle />` flips `titleMounted` when it
      * renders, letting the header detect an authored template that never places
@@ -49,6 +63,12 @@ export interface ResourceHeaderContextValue {
     titleMountTracker?: {
         titleMounted: boolean;
     };
+    /**
+     * `true` when an enclosing section already renders the heading for this region (an embedded READ inside
+     * a host section). The record's name is then not the PAGE title, so `<ResourceHeaderTitle />` renders an
+     * `h2` beneath the host's heading instead of a second `h1` — the same rule the default header applies.
+     */
+    hostProvidesHeading?: boolean;
 }
 export interface ResourceHeaderContextProviderProps {
     value: ResourceHeaderContextValue;

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceHeaderTitle.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AAQzD,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAID,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,8EAA8E;AAC9E,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,0BAA0B,GAAG,IAAI,CAEpF;AAMD,iHAAiH;AACjH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAoBrG;AACD,iEAAiE"}
+{"version":3,"file":"ResourceHeaderTitle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AASzD,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;IAE9C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAID,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,8EAA8E;AAC9E,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,0BAA0B,GAAG,IAAI,CAEpF;AAMD,iHAAiH;AACjH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAgCrG;AACD,iEAAiE"}

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

@@ -33,6 +33,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * label is the single data-driven signal that there is a title to place.
  */
 import { createContext, useContext } from 'react';
+import { Skeleton } from '../../../components/feedback/skeleton.js';
 import { cn } from '../../../core/ui/cn.js';
 const ResourceHeaderContext = createContext(null);
 /** Provides the resolved record title to an authored header template tree. */
@@ -71,14 +72,19 @@ export function ResourceHeaderTitle({ className }) {
     if (header?.titleMountTracker)
         header.titleMountTracker.titleMounted = true;
     const title = header?.title;
-    if (!title)
-        return null;
+    if (!title) {
+        // 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" })
+            : 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`).
-    _jsx("h1", { className: cn('min-w-0 truncate text-xl font-semibold text-foreground', className), children: title }));
+    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 })));
 }
 //# 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,EAAE,EAAE,MAAM,gCAAgC,CAAC;AA0BpD,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;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;IACL,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,mEAAmE;IACnE,kDAAkD;IAClD,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,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 { 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   * 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\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) return null;\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    <h1 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n      {title}\n    </h1>\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":"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"]}

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

@@ -150,6 +150,18 @@ export interface GroupedSectionBodyProps {
  * the same container appearance, and renders them via
  * `ContentSectionContainer`.
  *
+ * **A solo form section with nothing to show hides.** One template serves several operations, and a
+ * `FormField` whose field the operation's schema lacks (or whose condition hides it) renders nothing.
+ * When a section holds only field slots (`FormField`, `FormFieldArray`, fields inside `ObjectScope` or
+ * inside a plain layout element such as a grid `div`) and none of them renders, the section hides its
+ * frame rather than showing a heading over nothing; its children stay mounted, so a field that starts
+ * rendering brings it back. A section holding anything else — text, a custom control or wrapper
+ * component (the engine's `Group` included), a nested section, a custom element, or a plain element
+ * with no field slot inside at that moment (a spacer `div`, an `hr`, a `div` whose only slot sits in a
+ * false branch) — is never hidden this way. A GROUPED section (grid, tabs, …) is decided by its host
+ * instead, from the operation's schema, because its container draws it and a tab's panel is not mounted:
+ * see `groupedSectionShowsNoField` in `FormLayout`.
+ *
  * Supports:
  * - **Saveable sections** (form-only, section-level partial save)
  * - **Section-level chromeMode override** (cascaded to child fields)

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;AAuB1D;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CA2HtD;yBA3He,OAAO;;;AA+HvB,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":"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"}

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

@@ -16,7 +16,9 @@ import { FrontendResourceUtils } from '../../../core/resources/frontend-resource
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 import { GroupedSectionHostKind } from './Section.shared.js';
 import { toDisplayChromeMode, isSoloMode } from './section-consolidation.shared.js';
-import { SectionFieldsContext, useRegisteredSectionFields, useSectionFieldsRegistry, } from './SectionFieldsContext.js';
+import { SectionFieldsContext, useRegisteredSectionFields, useSectionFieldsRegistry, holdsOnlyFieldSlots, useSectionShowsNoField, } from './SectionFieldsContext.js';
+import { useFieldScope } from './FieldScopeContext.js';
+import { useTemplatePlacedFieldsOf } from '../../form/automated/TemplatePlacedFieldsContext.js';
 import { useOptionalSectionPresentationContext } from './SectionPresentationContext.js';
 import { SectionHostHeadingContext } from './SectionHostHeadingContext.js';
 const logger = LoggerFrontendService.getLogger();
@@ -40,6 +42,18 @@ const warnedUngroupedContainerSections = new Set();
  * the same container appearance, and renders them via
  * `ContentSectionContainer`.
  *
+ * **A solo form section with nothing to show hides.** One template serves several operations, and a
+ * `FormField` whose field the operation's schema lacks (or whose condition hides it) renders nothing.
+ * When a section holds only field slots (`FormField`, `FormFieldArray`, fields inside `ObjectScope` or
+ * inside a plain layout element such as a grid `div`) and none of them renders, the section hides its
+ * frame rather than showing a heading over nothing; its children stay mounted, so a field that starts
+ * rendering brings it back. A section holding anything else — text, a custom control or wrapper
+ * component (the engine's `Group` included), a nested section, a custom element, or a plain element
+ * with no field slot inside at that moment (a spacer `div`, an `hr`, a `div` whose only slot sits in a
+ * false branch) — is never hidden this way. A GROUPED section (grid, tabs, …) is decided by its host
+ * instead, from the operation's schema, because its container draws it and a tab's panel is not mounted:
+ * see `groupedSectionShowsNoField` in `FormLayout`.
+ *
  * Supports:
  * - **Saveable sections** (form-only, section-level partial save)
  * - **Section-level chromeMode override** (cascaded to child fields)
@@ -103,6 +117,14 @@ export function Section(props) {
         });
     }
     const sectionFieldsContextValue = useSectionFieldsRegistry();
+    const showsNoField = useSectionShowsNoField(sectionFieldsContextValue);
+    // Every slot this section holds, read from its elements: a collapsed section's fields, or an unchosen
+    // variant's, are not mounted, so they cannot report themselves (see `TemplatePlacedFieldsContext`).
+    const { pathPrefix } = useFieldScope();
+    useTemplatePlacedFieldsOf(children, pathPrefix);
+    // Only a section of nothing but field slots may hide for its fields' absence; anything else beside
+    // them (text, a custom control, a nested section) is content of its own that presence cannot see.
+    const isEmptyForThisOperation = showsNoField && holdsOnlyFieldSlots(children);
     // Container modes: render children as-is. The parent layout handles grouping.
     if (!isSoloMode(appearance)) {
         // Footgun guard: a container-mode section (GRID/TABS/COLUMNS/…) only receives
@@ -134,7 +156,11 @@ export function Section(props) {
     // 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.
-    return (_jsx(ContentSection, { appearance: appearance, legend: resolvedLegend, description: resolvedDescription, disabled: disabled, defaultOpen: defaultFocus, className: className, "data-guidance-section": name, "data-composite-section": sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, children: content }));
+    return (_jsx(ContentSection, { appearance: appearance, legend: resolvedLegend, description: resolvedDescription, disabled: disabled, defaultOpen: defaultFocus, className: className, "data-guidance-section": name, "data-composite-section": sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, 
+        // It holds only field slots and none renders for this operation (a template serves several
+        // operations, and this one posts none of these fields): a heading over nothing. The children stay
+        // mounted, so a field whose condition turns true reports and brings the section back.
+        hidden: isEmptyForThisOperation || undefined, children: content }));
 }
 Section.displayName = 'Section';
 export function GroupedSectionBody({ hostKind, sectionProps, providesHeading = 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} from './SectionFieldsContext';\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 * 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\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    >\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 { 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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"Section.shared.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB"}
+{"version":3,"file":"Section.shared.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB"}

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

@@ -1 +1 @@
-{"version":3,"file":"Section.shared.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;AACzB,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC","sourcesContent":["export enum GroupedSectionHostKind {\n  FORM = 'form',\n  DISPLAY = 'display',\n  COMPOSITE = 'composite',\n}\n"]}
+{"version":3,"file":"Section.shared.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;AACzB,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC","sourcesContent":["export enum GroupedSectionHostKind {\n  FORM = 'form',\n  DISPLAY = 'display',\n  COMPOSITE = 'composite',\n}\n"]}

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

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 /**
  * Registry contract a form-hosted section exposes to its descendants.
  *
@@ -25,6 +26,22 @@ export interface SectionFieldsContextValue {
      * over wiring this manually.
      */
     subscribeToRegisteredFields: (listener: () => void) => () => void;
+    /**
+     * Records whether a field this section declares actually RENDERS a control here — its field is in
+     * the operation's schema and not hidden by a condition. A template places its `FormField` slots
+     * unconditionally and lets the operation's schema decide (a slot whose field the schema lacks
+     * renders nothing), so a section can declare fields and show none of them.
+     */
+    reportSlotPresence: (slot: object, present: boolean) => void;
+    clearSlotPresence: (slot: object) => void;
+    /**
+     * True when fields reported here and NONE of them renders. Measured on Wonder Todos, "Reset to
+     * defaults" showed the preferences template's four section cards, every one empty. This is a fact
+     * about FIELDS only: a section also holding other content (text, a custom control, a nested section)
+     * is not empty because of it — `Section` combines it with `holdsOnlyFieldSlots`. Notifies through
+     * `subscribeToRegisteredFields`.
+     */
+    showsNoField: () => boolean;
 }
 export declare const SectionFieldsContext: import("react").Context<SectionFieldsContextValue>;
 /**
@@ -68,4 +85,57 @@ export declare function useSectionFieldRegistration(fieldName: string): void;
  * stable empty array outside any section provider.
  */
 export declare function useRegisteredSectionFields(): string[];
+/**
+ * Hook for `FormField` to tell its section whether it renders a control. A LAYOUT effect, so the
+ * section knows before the browser paints and an empty section never flashes on screen.
+ */
+export declare function useSectionFieldPresence(present: boolean): void;
+/**
+ * Whether the section this registry backs has fields and shows none of them.
+ *
+ * Read in a LAYOUT effect rather than through `useSyncExternalStore`: the fields report in their own
+ * layout effects, which run before their section's, so the section settles before the browser paints.
+ * A store subscription is attached in a passive effect, after paint, and would let an empty frame show
+ * for a frame on the first mount and on every keyed remount of the form.
+ */
+export declare function useSectionShowsNoField(registry: SectionFieldsContextValue): boolean;
+/**
+ * What a component is to a section deciding whether it holds anything besides field slots.
+ *
+ * A section may hide when none of its fields renders only if fields are ALL it holds: text, a custom
+ * control or a nested section beside them is content of its own, which a field-presence count cannot see.
+ * Plain elements that wrap field slots (a layout `div`) are looked through. Components opt in by declaring
+ * their role; any undeclared component counts as other content, so an unknown component can only keep a
+ * section visible, never hide one. The role API is deliberately NOT exported from the package: an
+ * application's own wrapper component keeps its section visible, which is the safe answer, and an author
+ * who wants hiding places slots directly, in a plain element, or in `ObjectScope`.
+ */
+export declare enum SectionContentRole {
+    /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */
+    FIELD_SLOT = "field_slot",
+    /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */
+    FIELD_SLOT_CONTAINER = "field_slot_container"
+}
+/** The role a component declared, if any (read by the placement report as well as the hide decision). */
+export declare function sectionContentRoleOf(type: unknown): SectionContentRole | undefined;
+/** Declares what a component is to `holdsOnlyFieldSlots`. */
+export declare function declareSectionContentRole(component: object, role: SectionContentRole): void;
+/** Where a field slot writes, as `FormField` resolves it: the enclosing scopes' names joined to its own. */
+export interface PlacedFieldSlot {
+    path: string;
+    /** The slot was handed its own schema, so the form's schema does not decide whether it renders. */
+    hasOwnSchema: boolean;
+}
+/**
+ * True when `children` holds at least one field slot and nothing else. Fragments and declared containers
+ * are looked through, and so is a plain element that wraps field slots.
+ */
+export declare function holdsOnlyFieldSlots(children: ReactNode): boolean;
+/**
+ * The field slots `children` places, or `null` when it holds anything besides field slots. Paths are
+ * resolved the way `FormField` resolves them (scope names joined to the slot's `name`), starting from
+ * `pathPrefix`. Read STATICALLY, from the elements, so a host can decide about a section whose content
+ * is not mounted — an inactive tab's panel is not.
+ */
+export declare function listPlacedFieldSlots(children: ReactNode, pathPrefix?: string): PlacedFieldSlot[] | null;
 //# sourceMappingURL=SectionFieldsContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SectionFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACnE;AAED,eAAO,MAAM,oBAAoB,oDAAwD,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,IAAI,yBAAyB,CA6BpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnE;AAKD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAMrD"}
+{"version":3,"file":"SectionFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6H,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElK;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAClE;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7D,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB,oDAAwD,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,IAAI,yBAAyB,CAiDpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnE;AAKD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAMrD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAQnF;AAED;;;;;;;;;;GAUG;AACH,oBAAY,kBAAkB;IAC5B,gGAAgG;IAChG,UAAU,eAAe;IACzB,oGAAoG;IACpG,oBAAoB,yBAAyB;CAC9C;AAID,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAIlF;AAED,6DAA6D;AAC7D,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAE3F;AAYD,4GAA4G;AAC5G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,YAAY,EAAE,OAAO,CAAC;CACvB;AAuCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,SAAK,GAAG,eAAe,EAAE,GAAG,IAAI,CAGnG"}