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

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

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

@@ -1,4 +1,4 @@
-import { createContext, useContext, useEffect, useState, useSyncExternalStore } from 'react';
+import { Children, Fragment, createContext, isValidElement, useContext, useEffect, useLayoutEffect, useState, useSyncExternalStore } from 'react';
 export const SectionFieldsContext = createContext(null);
 /**
  * Builds the identity-stable registry backing `SectionFieldsContext`.
@@ -26,11 +26,23 @@ export function useSectionFieldsRegistry() {
     const [registry] = useState(() => {
         /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */
         let registeredFields = [];
+        // One entry per MOUNTED SLOT, keyed by that slot's own token rather than by field name: the same
+        // field placed twice is two slots, which may even disagree (one given a schema the other lacks), and
+        // one copy unmounting must not erase or overwrite the other's answer.
+        const slotPresence = new Map();
+        let showsNoField = false;
         const listeners = new Set();
         const notify = () => {
             for (const listener of listeners)
                 listener();
         };
+        const recomputePresence = () => {
+            const next = slotPresence.size > 0 && ![...slotPresence.values()].some(Boolean);
+            if (next === showsNoField)
+                return;
+            showsNoField = next;
+            notify();
+        };
         return {
             registerField: (name) => {
                 if (registeredFields.includes(name))
@@ -45,6 +57,16 @@ export function useSectionFieldsRegistry() {
                 notify();
             },
             getRegisteredFields: () => registeredFields,
+            reportSlotPresence: (slot, present) => {
+                slotPresence.set(slot, present);
+                recomputePresence();
+            },
+            clearSlotPresence: (slot) => {
+                if (!slotPresence.delete(slot))
+                    return;
+                recomputePresence();
+            },
+            showsNoField: () => showsNoField,
             subscribeToRegisteredFields: (listener) => {
                 listeners.add(listener);
                 return () => {
@@ -86,4 +108,138 @@ export function useRegisteredSectionFields() {
     const ctx = useContext(SectionFieldsContext);
     return useSyncExternalStore(ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing, ctx ? ctx.getRegisteredFields : () => EMPTY_REGISTERED_FIELDS);
 }
+/**
+ * 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 function useSectionFieldPresence(present) {
+    // Two effects on purpose. The CLEAR runs only when the slot leaves this registry (unmount, or the
+    // section provider changing), so a slot whose `present` flips is updated in place rather than deleted
+    // and re-added; either way the section settles before paint. The REPORT runs on every change of
+    // `present`, and after a provider change it reports into the new registry.
+    const ctx = useContext(SectionFieldsContext);
+    const [slot] = useState(() => ({}));
+    useLayoutEffect(() => () => {
+        ctx?.clearSlotPresence(slot);
+    }, [ctx, slot]);
+    useLayoutEffect(() => {
+        ctx?.reportSlotPresence(slot, present);
+    }, [ctx, slot, present]);
+}
+/**
+ * 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 function useSectionShowsNoField(registry) {
+    const [showsNoField, setShowsNoField] = useState(false);
+    useLayoutEffect(() => {
+        const update = () => setShowsNoField(registry.showsNoField());
+        update();
+        return registry.subscribeToRegisteredFields(update);
+    }, [registry]);
+    return showsNoField;
+}
+/**
+ * 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 var SectionContentRole;
+(function (SectionContentRole) {
+    /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */
+    SectionContentRole["FIELD_SLOT"] = "field_slot";
+    /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */
+    SectionContentRole["FIELD_SLOT_CONTAINER"] = "field_slot_container";
+})(SectionContentRole || (SectionContentRole = {}));
+const SECTION_CONTENT_ROLE = Symbol.for('wildo.sectionContentRole');
+/** The role a component declared, if any (read by the placement report as well as the hide decision). */
+export function sectionContentRoleOf(type) {
+    return (type !== null && (typeof type === 'function' || typeof type === 'object'))
+        ? type[SECTION_CONTENT_ROLE]
+        : undefined;
+}
+/** Declares what a component is to `holdsOnlyFieldSlots`. */
+export function declareSectionContentRole(component, role) {
+    Object.defineProperty(component, SECTION_CONTENT_ROLE, { value: role, enumerable: false });
+}
+/** What a subtree amounts to for `holdsOnlyFieldSlots`. */
+var SectionSubtreeKind;
+(function (SectionSubtreeKind) {
+    /** At least one field slot, and nothing else. */
+    SectionSubtreeKind["FIELD_SLOTS"] = "field_slots";
+    /** Nothing at all: no slot and no content (a falsy branch, an empty container). */
+    SectionSubtreeKind["NOTHING"] = "nothing";
+    /** Something a field-presence count cannot see: text, a component, a childless or custom element. */
+    SectionSubtreeKind["CONTENT"] = "content";
+})(SectionSubtreeKind || (SectionSubtreeKind = {}));
+function classifySectionSubtree(nodes, pathPrefix, placed) {
+    let sawFieldSlot = false;
+    for (const node of Children.toArray(nodes)) {
+        if (!isValidElement(node))
+            return SectionSubtreeKind.CONTENT;
+        const props = node.props;
+        let kind;
+        if (node.type === Fragment) {
+            kind = classifySectionSubtree(props.children, pathPrefix, placed);
+        }
+        else if (typeof node.type === 'string') {
+            // A plain element is a WRAPPER only when it wraps field slots (a layout `<div className="grid">`).
+            // Anything else is content: a childless element (an image, a rule, a spacer), one whose only child
+            // is a falsy branch (it may be drawn by CSS), and a custom element (it may render shadow content).
+            kind = !node.type.includes('-') && classifySectionSubtree(props.children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS
+                ? SectionSubtreeKind.FIELD_SLOTS
+                : SectionSubtreeKind.CONTENT;
+        }
+        else {
+            const role = node.type[SECTION_CONTENT_ROLE];
+            const name = typeof props.name === 'string' ? props.name : undefined;
+            const scopedPath = name ? (pathPrefix ? `${pathPrefix}.${name}` : name) : pathPrefix;
+            if (role === SectionContentRole.FIELD_SLOT) {
+                placed.push({ path: scopedPath, hasOwnSchema: props.schema !== undefined });
+                kind = SectionSubtreeKind.FIELD_SLOTS;
+            }
+            else if (role === SectionContentRole.FIELD_SLOT_CONTAINER) {
+                // A declared container holding nothing adds nothing, even an `ObjectScope` given a `className`
+                // (which renders a styled div). Unlike a bare styled div it scopes names rather than decorating,
+                // and when a section's slots are all absent the whole frame hides anyway.
+                kind = classifySectionSubtree(props.children, scopedPath, placed);
+            }
+            else {
+                kind = SectionSubtreeKind.CONTENT;
+            }
+        }
+        if (kind === SectionSubtreeKind.CONTENT)
+            return SectionSubtreeKind.CONTENT;
+        if (kind === SectionSubtreeKind.FIELD_SLOTS)
+            sawFieldSlot = true;
+    }
+    return sawFieldSlot ? SectionSubtreeKind.FIELD_SLOTS : SectionSubtreeKind.NOTHING;
+}
+/**
+ * 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 function holdsOnlyFieldSlots(children) {
+    return classifySectionSubtree(children, '', []) === SectionSubtreeKind.FIELD_SLOTS;
+}
+/**
+ * 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 function listPlacedFieldSlots(children, pathPrefix = '') {
+    const placed = [];
+    return classifySectionSubtree(children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS ? placed : null;
+}
 //# sourceMappingURL=SectionFieldsContext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SectionFieldsContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AA+B7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAA8B,EAAE;QAC1D,2FAA2F;QAC3F,IAAI,gBAAgB,GAAa,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;QACxC,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,EAAE,CAAC;QAC/C,CAAC,CAAC;QACF,OAAO;YACL,aAAa,EAAE,CAAC,IAAY,EAAQ,EAAE;gBACpC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAC5C,gBAAgB,GAAG,CAAC,GAAG,gBAAgB,EAAE,IAAI,CAAC,CAAC;gBAC/C,MAAM,EAAE,CAAC;YACX,CAAC;YACD,eAAe,EAAE,CAAC,IAAY,EAAQ,EAAE;gBACtC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAC7C,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;gBAC1E,MAAM,EAAE,CAAC;YACX,CAAC;YACD,mBAAmB,EAAE,GAAa,EAAE,CAAC,gBAAgB;YACrD,2BAA2B,EAAE,CAAC,QAAoB,EAAgB,EAAE;gBAClE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,GAAG,EAAE;oBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,uBAAuB,GAAa,EAAE,CAAC;AAC7C,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,OAAO,oBAAoB,CACzB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAC1D,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAa,EAAE,CAAC,uBAAuB,CACxE,CAAC;AACJ,CAAC","sourcesContent":["import { createContext, useContext, useEffect, useState, useSyncExternalStore } from 'react';\n\n/**\n * Registry contract a form-hosted section exposes to its descendants.\n *\n * IDENTITY CONTRACT: providers MUST keep the context value identity-stable for\n * the lifetime of the section (see `useSectionFieldsRegistry`). Every\n * `FormField` registers itself through an effect that depends on this value;\n * a value whose identity tracks the registry contents re-fires every field's\n * registration effect on each mutation (unregister + register → new contents\n * → new value → …), which loops until React throws \"Maximum update depth\n * exceeded\" (recovered 2026-06-10 on the Wonder Todos todoLists create form).\n */\nexport interface SectionFieldsContextValue {\n  registerField: (name: string) => void;\n  unregisterField: (name: string) => void;\n  /**\n   * Current registered field names (insertion-ordered, deduplicated).\n   * Returns the live immutable snapshot — a new array identity is produced\n   * only when the contents actually change, so it is safe to use as a\n   * `useSyncExternalStore` snapshot.\n   */\n  getRegisteredFields: () => string[];\n  /**\n   * Subscribe to registry mutations. Returns the unsubscribe function.\n   * Render-reactive consumers should prefer `useRegisteredSectionFields`\n   * over wiring this manually.\n   */\n  subscribeToRegisteredFields: (listener: () => void) => () => void;\n}\n\nexport const SectionFieldsContext = createContext<SectionFieldsContextValue | null>(null);\n\n/**\n * Builds the identity-stable registry backing `SectionFieldsContext`.\n * Used by both section form hosts (`Section` solo modes and\n * `GroupedSectionBody` for grouped container panels) — keep them on this\n * single implementation so the identity contract cannot drift between hosts.\n *\n * Why the registry lives OUTSIDE React state: registrations arrive from\n * descendant effects. If the registered names were `useState` data baked into\n * the provider value (e.g. a `useMemo` with the names in its deps), every\n * registration would change the value identity, re-fire every field's\n * registration effect (cleanup unregister + register), change the state\n * again, and re-render forever — register/unregister pairs always transition\n * through fresh array identities, so any state-derived value loops by\n * construction. Instead the store is created once per section; mutations swap\n * an immutable snapshot and notify subscribers, so registry churn re-renders\n * only the components that opted in via `useRegisteredSectionFields` — never\n * the provider, never the registrants.\n *\n * Same family as the `WizardStep` field registry (stable mutable container),\n * extended with subscription because section save buttons render from the\n * registry contents (disabled-when-empty) and need to observe changes.\n */\nexport function useSectionFieldsRegistry(): SectionFieldsContextValue {\n  const [registry] = useState((): SectionFieldsContextValue => {\n    /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */\n    let registeredFields: string[] = [];\n    const listeners = new Set<() => void>();\n    const notify = (): void => {\n      for (const listener of listeners) listener();\n    };\n    return {\n      registerField: (name: string): void => {\n        if (registeredFields.includes(name)) return;\n        registeredFields = [...registeredFields, name];\n        notify();\n      },\n      unregisterField: (name: string): void => {\n        if (!registeredFields.includes(name)) return;\n        registeredFields = registeredFields.filter((current) => current !== name);\n        notify();\n      },\n      getRegisteredFields: (): string[] => registeredFields,\n      subscribeToRegisteredFields: (listener: () => void): (() => void) => {\n        listeners.add(listener);\n        return () => {\n          listeners.delete(listener);\n        };\n      },\n    };\n  });\n  return registry;\n}\n\n/**\n * Hook for `FormField` to register with the enclosing saveable section so the\n * section save action can validate and submit only the fields it actually\n * owns. No-op outside a section provider.\n *\n * Depends on the context value identity on purpose (React contract: re-bind\n * if the provider genuinely changes). This is safe only because providers\n * honor the identity contract documented on `SectionFieldsContextValue` —\n * the effect then runs once per field mount.\n */\nexport function useSectionFieldRegistration(fieldName: string): void {\n  const ctx = useContext(SectionFieldsContext);\n  useEffect(() => {\n    ctx?.registerField(fieldName);\n    return () => {\n      ctx?.unregisterField(fieldName);\n    };\n  }, [ctx, fieldName]);\n}\n\nconst EMPTY_REGISTERED_FIELDS: string[] = [];\nconst subscribeToNothing = (): (() => void) => () => {};\n\n/**\n * Render-reactive view of the enclosing section's registered field names.\n * Re-renders the caller when fields register/unregister (e.g. conditionally\n * shown fields), without ever invalidating the provider value. Returns a\n * stable empty array outside any section provider.\n */\nexport function useRegisteredSectionFields(): string[] {\n  const ctx = useContext(SectionFieldsContext);\n  return useSyncExternalStore(\n    ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing,\n    ctx ? ctx.getRegisteredFields : (): string[] => EMPTY_REGISTERED_FIELDS,\n  );\n}\n"]}
+{"version":3,"file":"SectionFieldsContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Children, Fragment, createContext, isValidElement, useContext, useEffect, useLayoutEffect, useState, useSyncExternalStore, type ReactNode } from 'react';\n\n/**\n * Registry contract a form-hosted section exposes to its descendants.\n *\n * IDENTITY CONTRACT: providers MUST keep the context value identity-stable for\n * the lifetime of the section (see `useSectionFieldsRegistry`). Every\n * `FormField` registers itself through an effect that depends on this value;\n * a value whose identity tracks the registry contents re-fires every field's\n * registration effect on each mutation (unregister + register → new contents\n * → new value → …), which loops until React throws \"Maximum update depth\n * exceeded\" (recovered 2026-06-10 on the Wonder Todos todoLists create form).\n */\nexport interface SectionFieldsContextValue {\n  registerField: (name: string) => void;\n  unregisterField: (name: string) => void;\n  /**\n   * Current registered field names (insertion-ordered, deduplicated).\n   * Returns the live immutable snapshot — a new array identity is produced\n   * only when the contents actually change, so it is safe to use as a\n   * `useSyncExternalStore` snapshot.\n   */\n  getRegisteredFields: () => string[];\n  /**\n   * Subscribe to registry mutations. Returns the unsubscribe function.\n   * Render-reactive consumers should prefer `useRegisteredSectionFields`\n   * over wiring this manually.\n   */\n  subscribeToRegisteredFields: (listener: () => void) => () => void;\n  /**\n   * Records whether a field this section declares actually RENDERS a control here — its field is in\n   * the operation's schema and not hidden by a condition. A template places its `FormField` slots\n   * unconditionally and lets the operation's schema decide (a slot whose field the schema lacks\n   * renders nothing), so a section can declare fields and show none of them.\n   */\n  reportSlotPresence: (slot: object, present: boolean) => void;\n  clearSlotPresence: (slot: object) => void;\n  /**\n   * True when fields reported here and NONE of them renders. Measured on Wonder Todos, \"Reset to\n   * defaults\" showed the preferences template's four section cards, every one empty. This is a fact\n   * about FIELDS only: a section also holding other content (text, a custom control, a nested section)\n   * is not empty because of it — `Section` combines it with `holdsOnlyFieldSlots`. Notifies through\n   * `subscribeToRegisteredFields`.\n   */\n  showsNoField: () => boolean;\n}\n\nexport const SectionFieldsContext = createContext<SectionFieldsContextValue | null>(null);\n\n/**\n * Builds the identity-stable registry backing `SectionFieldsContext`.\n * Used by both section form hosts (`Section` solo modes and\n * `GroupedSectionBody` for grouped container panels) — keep them on this\n * single implementation so the identity contract cannot drift between hosts.\n *\n * Why the registry lives OUTSIDE React state: registrations arrive from\n * descendant effects. If the registered names were `useState` data baked into\n * the provider value (e.g. a `useMemo` with the names in its deps), every\n * registration would change the value identity, re-fire every field's\n * registration effect (cleanup unregister + register), change the state\n * again, and re-render forever — register/unregister pairs always transition\n * through fresh array identities, so any state-derived value loops by\n * construction. Instead the store is created once per section; mutations swap\n * an immutable snapshot and notify subscribers, so registry churn re-renders\n * only the components that opted in via `useRegisteredSectionFields` — never\n * the provider, never the registrants.\n *\n * Same family as the `WizardStep` field registry (stable mutable container),\n * extended with subscription because section save buttons render from the\n * registry contents (disabled-when-empty) and need to observe changes.\n */\nexport function useSectionFieldsRegistry(): SectionFieldsContextValue {\n  const [registry] = useState((): SectionFieldsContextValue => {\n    /** Immutable snapshot — swapped (never mutated) so subscribers can compare by identity. */\n    let registeredFields: string[] = [];\n    // One entry per MOUNTED SLOT, keyed by that slot's own token rather than by field name: the same\n    // field placed twice is two slots, which may even disagree (one given a schema the other lacks), and\n    // one copy unmounting must not erase or overwrite the other's answer.\n    const slotPresence = new Map<object, boolean>();\n    let showsNoField = false;\n    const listeners = new Set<() => void>();\n    const notify = (): void => {\n      for (const listener of listeners) listener();\n    };\n    const recomputePresence = (): void => {\n      const next = slotPresence.size > 0 && ![...slotPresence.values()].some(Boolean);\n      if (next === showsNoField) return;\n      showsNoField = next;\n      notify();\n    };\n    return {\n      registerField: (name: string): void => {\n        if (registeredFields.includes(name)) return;\n        registeredFields = [...registeredFields, name];\n        notify();\n      },\n      unregisterField: (name: string): void => {\n        if (!registeredFields.includes(name)) return;\n        registeredFields = registeredFields.filter((current) => current !== name);\n        notify();\n      },\n      getRegisteredFields: (): string[] => registeredFields,\n      reportSlotPresence: (slot: object, present: boolean): void => {\n        slotPresence.set(slot, present);\n        recomputePresence();\n      },\n      clearSlotPresence: (slot: object): void => {\n        if (!slotPresence.delete(slot)) return;\n        recomputePresence();\n      },\n      showsNoField: (): boolean => showsNoField,\n      subscribeToRegisteredFields: (listener: () => void): (() => void) => {\n        listeners.add(listener);\n        return () => {\n          listeners.delete(listener);\n        };\n      },\n    };\n  });\n  return registry;\n}\n\n/**\n * Hook for `FormField` to register with the enclosing saveable section so the\n * section save action can validate and submit only the fields it actually\n * owns. No-op outside a section provider.\n *\n * Depends on the context value identity on purpose (React contract: re-bind\n * if the provider genuinely changes). This is safe only because providers\n * honor the identity contract documented on `SectionFieldsContextValue` —\n * the effect then runs once per field mount.\n */\nexport function useSectionFieldRegistration(fieldName: string): void {\n  const ctx = useContext(SectionFieldsContext);\n  useEffect(() => {\n    ctx?.registerField(fieldName);\n    return () => {\n      ctx?.unregisterField(fieldName);\n    };\n  }, [ctx, fieldName]);\n}\n\nconst EMPTY_REGISTERED_FIELDS: string[] = [];\nconst subscribeToNothing = (): (() => void) => () => {};\n\n/**\n * Render-reactive view of the enclosing section's registered field names.\n * Re-renders the caller when fields register/unregister (e.g. conditionally\n * shown fields), without ever invalidating the provider value. Returns a\n * stable empty array outside any section provider.\n */\nexport function useRegisteredSectionFields(): string[] {\n  const ctx = useContext(SectionFieldsContext);\n  return useSyncExternalStore(\n    ctx ? ctx.subscribeToRegisteredFields : subscribeToNothing,\n    ctx ? ctx.getRegisteredFields : (): string[] => EMPTY_REGISTERED_FIELDS,\n  );\n}\n\n/**\n * Hook for `FormField` to tell its section whether it renders a control. A LAYOUT effect, so the\n * section knows before the browser paints and an empty section never flashes on screen.\n */\nexport function useSectionFieldPresence(present: boolean): void {\n  // Two effects on purpose. The CLEAR runs only when the slot leaves this registry (unmount, or the\n  // section provider changing), so a slot whose `present` flips is updated in place rather than deleted\n  // and re-added; either way the section settles before paint. The REPORT runs on every change of\n  // `present`, and after a provider change it reports into the new registry.\n  const ctx = useContext(SectionFieldsContext);\n  const [slot] = useState(() => ({}));\n  useLayoutEffect(() => () => {\n    ctx?.clearSlotPresence(slot);\n  }, [ctx, slot]);\n  useLayoutEffect(() => {\n    ctx?.reportSlotPresence(slot, present);\n  }, [ctx, slot, present]);\n}\n\n/**\n * Whether the section this registry backs has fields and shows none of them.\n *\n * Read in a LAYOUT effect rather than through `useSyncExternalStore`: the fields report in their own\n * layout effects, which run before their section's, so the section settles before the browser paints.\n * A store subscription is attached in a passive effect, after paint, and would let an empty frame show\n * for a frame on the first mount and on every keyed remount of the form.\n */\nexport function useSectionShowsNoField(registry: SectionFieldsContextValue): boolean {\n  const [showsNoField, setShowsNoField] = useState(false);\n  useLayoutEffect(() => {\n    const update = (): void => setShowsNoField(registry.showsNoField());\n    update();\n    return registry.subscribeToRegisteredFields(update);\n  }, [registry]);\n  return showsNoField;\n}\n\n/**\n * What a component is to a section deciding whether it holds anything besides field slots.\n *\n * A section may hide when none of its fields renders only if fields are ALL it holds: text, a custom\n * control or a nested section beside them is content of its own, which a field-presence count cannot see.\n * Plain elements that wrap field slots (a layout `div`) are looked through. Components opt in by declaring\n * their role; any undeclared component counts as other content, so an unknown component can only keep a\n * section visible, never hide one. The role API is deliberately NOT exported from the package: an\n * application's own wrapper component keeps its section visible, which is the safe answer, and an author\n * who wants hiding places slots directly, in a plain element, or in `ObjectScope`.\n */\nexport enum SectionContentRole {\n  /** A slot that renders one field's control, or nothing when the operation's schema lacks it. */\n  FIELD_SLOT = 'field_slot',\n  /** A wrapper whose children are judged in its place (it scopes field names and adds no content). */\n  FIELD_SLOT_CONTAINER = 'field_slot_container',\n}\n\nconst SECTION_CONTENT_ROLE = Symbol.for('wildo.sectionContentRole');\n\n/** The role a component declared, if any (read by the placement report as well as the hide decision). */\nexport function sectionContentRoleOf(type: unknown): SectionContentRole | undefined {\n  return (type !== null && (typeof type === 'function' || typeof type === 'object'))\n    ? (type as { [SECTION_CONTENT_ROLE]?: SectionContentRole })[SECTION_CONTENT_ROLE]\n    : undefined;\n}\n\n/** Declares what a component is to `holdsOnlyFieldSlots`. */\nexport function declareSectionContentRole(component: object, role: SectionContentRole): void {\n  Object.defineProperty(component, SECTION_CONTENT_ROLE, { value: role, enumerable: false });\n}\n\n/** What a subtree amounts to for `holdsOnlyFieldSlots`. */\nenum SectionSubtreeKind {\n  /** At least one field slot, and nothing else. */\n  FIELD_SLOTS = 'field_slots',\n  /** Nothing at all: no slot and no content (a falsy branch, an empty container). */\n  NOTHING = 'nothing',\n  /** Something a field-presence count cannot see: text, a component, a childless or custom element. */\n  CONTENT = 'content',\n}\n\n/** Where a field slot writes, as `FormField` resolves it: the enclosing scopes' names joined to its own. */\nexport interface PlacedFieldSlot {\n  path: string;\n  /** The slot was handed its own schema, so the form's schema does not decide whether it renders. */\n  hasOwnSchema: boolean;\n}\n\nfunction classifySectionSubtree(nodes: ReactNode, pathPrefix: string, placed: PlacedFieldSlot[]): SectionSubtreeKind {\n  let sawFieldSlot = false;\n  for (const node of Children.toArray(nodes)) {\n    if (!isValidElement(node)) return SectionSubtreeKind.CONTENT;\n    const props = node.props as { children?: ReactNode; name?: unknown; schema?: unknown };\n    let kind: SectionSubtreeKind;\n    if (node.type === Fragment) {\n      kind = classifySectionSubtree(props.children, pathPrefix, placed);\n    } else if (typeof node.type === 'string') {\n      // A plain element is a WRAPPER only when it wraps field slots (a layout `<div className=\"grid\">`).\n      // Anything else is content: a childless element (an image, a rule, a spacer), one whose only child\n      // is a falsy branch (it may be drawn by CSS), and a custom element (it may render shadow content).\n      kind = !node.type.includes('-') && classifySectionSubtree(props.children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS\n        ? SectionSubtreeKind.FIELD_SLOTS\n        : SectionSubtreeKind.CONTENT;\n    } else {\n      const role = (node.type as { [SECTION_CONTENT_ROLE]?: SectionContentRole })[SECTION_CONTENT_ROLE];\n      const name = typeof props.name === 'string' ? props.name : undefined;\n      const scopedPath = name ? (pathPrefix ? `${pathPrefix}.${name}` : name) : pathPrefix;\n      if (role === SectionContentRole.FIELD_SLOT) {\n        placed.push({ path: scopedPath, hasOwnSchema: props.schema !== undefined });\n        kind = SectionSubtreeKind.FIELD_SLOTS;\n      } else if (role === SectionContentRole.FIELD_SLOT_CONTAINER) {\n        // A declared container holding nothing adds nothing, even an `ObjectScope` given a `className`\n        // (which renders a styled div). Unlike a bare styled div it scopes names rather than decorating,\n        // and when a section's slots are all absent the whole frame hides anyway.\n        kind = classifySectionSubtree(props.children, scopedPath, placed);\n      } else {\n        kind = SectionSubtreeKind.CONTENT;\n      }\n    }\n    if (kind === SectionSubtreeKind.CONTENT) return SectionSubtreeKind.CONTENT;\n    if (kind === SectionSubtreeKind.FIELD_SLOTS) sawFieldSlot = true;\n  }\n  return sawFieldSlot ? SectionSubtreeKind.FIELD_SLOTS : SectionSubtreeKind.NOTHING;\n}\n\n/**\n * True when `children` holds at least one field slot and nothing else. Fragments and declared containers\n * are looked through, and so is a plain element that wraps field slots.\n */\nexport function holdsOnlyFieldSlots(children: ReactNode): boolean {\n  return classifySectionSubtree(children, '', []) === SectionSubtreeKind.FIELD_SLOTS;\n}\n\n/**\n * The field slots `children` places, or `null` when it holds anything besides field slots. Paths are\n * resolved the way `FormField` resolves them (scope names joined to the slot's `name`), starting from\n * `pathPrefix`. Read STATICALLY, from the elements, so a host can decide about a section whose content\n * is not mounted — an inactive tab's panel is not.\n */\nexport function listPlacedFieldSlots(children: ReactNode, pathPrefix = ''): PlacedFieldSlot[] | null {\n  const placed: PlacedFieldSlot[] = [];\n  return classifySectionSubtree(children, pathPrefix, placed) === SectionSubtreeKind.FIELD_SLOTS ? placed : null;\n}\n"]}

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

@@ -22,6 +22,12 @@ export interface WizardLayoutProps {
  * Children must be `<WizardStep>` components. Non-WizardStep children are
  * silently filtered out.
  *
+ * Under a resource form (a create or edit dialog or page) the wizard OWNS the form's footer: it claims it
+ * (`claimFooter`) and renders the host's Cancel, draft-save and operation-named submit inside its own
+ * navigation row — the submit on the last step only. Otherwise the host appended its own Cancel/Create row
+ * under the wizard's Previous/Next, so "Create" on step 1 submitted without the later steps ever being seen,
+ * and the last step offered two submit buttons.
+ *
  * @example
  * ```tsx
  * <FormLayout>

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

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