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

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

@@ -1 +1 @@
-{"version":3,"file":"FormErrorSummarySlot.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/FormErrorSummarySlot.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAO/D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,SAAS,EAA6B;IAC3E,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAE/C,OAAO,CACL,KAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,aAAa,EAAE,wBAAwB,EAAE,GACzD,CACH,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { FormErrorSummary } from '../../form/validation-errors/FormErrorSummary';\nimport { useSlotRegistration } from './FormLayoutSlotContext';\nimport { useWizardLayoutContext } from './WizardLayoutContext';\n\nexport interface FormErrorSummarySlotProps {\n  /** Additional CSS classes for the error summary container. */\n  className?: string;\n}\n\n/**\n * Error summary placement slot.\n *\n * Renders the form's error summary (list of validation errors).\n * If omitted from the template, FormLayout can auto-inject one at the top.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <FormErrorSummarySlot className=\"mb-4\" />\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton />\n * </FormLayout>\n * ```\n */\nexport function FormErrorSummarySlot({ className }: FormErrorSummarySlotProps): ReactNode {\n  useSlotRegistration('errorSummary');\n  const wizardContext = useWizardLayoutContext();\n\n  return (\n    <FormErrorSummary\n      className={className}\n      stepFieldNames={wizardContext?.getCurrentStepFieldNames()}\n    />\n  );\n}\n"]}
+{"version":3,"file":"FormErrorSummarySlot.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/FormErrorSummarySlot.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAO/D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,SAAS,EAA6B;IAC3E,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAE/C,OAAO,CACL,KAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,aAAa,EAAE,wBAAwB,EAAE,GACzD,CACH,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { FormErrorSummary } from '../../form/validation-errors/FormErrorSummary';\nimport { useSlotRegistration } from './FormLayoutSlotContext';\nimport { useWizardLayoutContext } from './WizardLayoutContext';\n\nexport interface FormErrorSummarySlotProps {\n  /** Additional CSS classes for the error summary container. */\n  className?: string;\n}\n\n/**\n * Error summary placement slot.\n *\n * Renders the form's error summary (list of validation errors).\n * If omitted from the template, FormLayout can auto-inject one at the top.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <FormErrorSummarySlot className=\"mb-4\" />\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton />\n * </FormLayout>\n * ```\n */\nexport function FormErrorSummarySlot({ className }: FormErrorSummarySlotProps): ReactNode {\n  useSlotRegistration('errorSummary');\n  const wizardContext = useWizardLayoutContext();\n\n  return (\n    <FormErrorSummary\n      className={className}\n      stepFieldNames={wizardContext?.getCurrentStepFieldNames()}\n    />\n  );\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/FormLayout.tsx"],"names":[],"mappings":"AAEA,OAAc,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAsB9E,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C;;;;;;;;;;;;OAYG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,kBAAkB,EAAE,mBAAmB,EACvC,sBAA6B,EAC7B,kBAA8B,GAC/B,EAAE,eAAe,GAAG,SAAS,CAuF7B"}
+{"version":3,"file":"FormLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/FormLayout.tsx"],"names":[],"mappings":"AAGA,OAAc,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAyB9E,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C;;;;;;;;;;;;OAYG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,kBAAkB,EAAE,mBAAmB,EACvC,sBAA6B,EAC7B,kBAA8B,GAC/B,EAAE,eAAe,GAAG,SAAS,CA2F7B"}

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

@@ -13,6 +13,9 @@ import { useOptionalResourceFormActions } from '../../form/automated/ResourceFor
 import { ContentSectionContainer } from '../../sections/ContentSectionContainer.js';
 import { groupSectionsByAppearance, buildSectionConfigFromGroup, } from './section-consolidation.utils.js';
 import { GroupedSectionBody } from './Section.js';
+import { listPlacedFieldSlots } from './SectionFieldsContext.js';
+import { useTemplatePlacedFieldsOf } from '../../form/automated/TemplatePlacedFieldsContext.js';
+import { AutomatedLayoutFrontendUtils } from '../../../core/automated-layout/automated-layout.frontend.utils.js';
 import { GroupedSectionHostKind } from './Section.shared.js';
 /**
  * Root wrapper for edit layout templates.
@@ -76,9 +79,33 @@ export function FormLayout({ className, children, contextFieldValues: _contextFi
         return () => cancelAnimationFrame(frame);
     }, [autoInjectSubmitButton, hostOwnsSubmitRow]);
     const formCtx = useOptionalFormTemplateContext();
+    // Every slot among this layout's children, read from the elements: a tab's panel, a later wizard step
+    // or an unchosen variant is not mounted, so its fields cannot report themselves (see
+    // `TemplatePlacedFieldsContext`). From an empty prefix: this layout resets its children's scope to "".
+    useTemplatePlacedFieldsOf(children, '');
     const renderedChildren = useMemo(() => renderGroupedChildren(children, formCtx), [children, formCtx]);
     return (_jsx(FormLayoutSlotContext.Provider, { value: slotContextValue, children: _jsx(FieldScopeProvider, { pathPrefix: "", children: _jsx("div", { className: cn('mr-auto w-full', className), style: { maxInlineSize: responsiveMaxWidthToCssValue(responsiveMaxWidth) }, "data-inline-size-tier": responsiveMaxWidth, "data-guidance-form": "", children: _jsxs(ErrorBoundary, { children: [autoSlots.errorSummary ? _jsx(FormErrorSummarySlot, { className: "mb-4" }) : null, _jsx("div", { className: "space-y-section [&>[data-chrome-mode^=settings]:has(+[data-chrome-mode^=settings])]:mb-0", children: renderedChildren }), autoSlots.submitButton ? _jsx(SubmitButton, { className: "mt-6" }) : null] }) }) }) }));
 }
+/**
+ * Whether a GROUPED section (grid, tabs, accordion, …) has nothing to show for this form's operation.
+ *
+ * One template serves several operations, and a `FormField` whose field the operation's schema lacks
+ * renders nothing. A solo `Section` hides itself from what its fields report once mounted; a grouped
+ * section cannot, because its container draws its title and panel and a tab's panel is not even mounted
+ * until it is chosen. So the host decides from the section's elements: when they are only field slots
+ * (`listPlacedFieldSlots`) and none of their paths resolves in the form's schema, the section is dropped.
+ *
+ * This reads the SCHEMA, not visibility: a field hidden by a condition is still in the schema, so its
+ * section stays. Dropping a section there would take it out of its container on a value change.
+ */
+function groupedSectionShowsNoField(children, schema) {
+    if (!schema)
+        return false;
+    const placed = listPlacedFieldSlots(children);
+    return placed !== null
+        && placed.length > 0
+        && placed.every((slot) => !slot.hasOwnSchema && AutomatedLayoutFrontendUtils.resolveFieldSchemaPath(schema, slot.path) === undefined);
+}
 /**
  * Introspects children for `<Section>` elements with container-mode `appearance`.
  * Groups sections sharing the same container mode into a `ContentSectionContainer`.
@@ -90,7 +117,12 @@ function renderGroupedChildren(children, formCtx) {
             if (item.type === 'node') {
                 return _jsx(React.Fragment, { children: item.node }, idx);
             }
-            const { group } = item;
+            // A grouped section none of whose fields this operation has is dropped from its container, and a
+            // container left with no section renders nothing (see `groupedSectionShowsNoField`).
+            const shownSections = item.group.sections.filter((el) => !groupedSectionShowsNoField(el.props.children, formCtx?.schema));
+            if (shownSections.length === 0)
+                return null;
+            const group = { ...item.group, sections: shownSections };
             const config = buildSectionConfigFromGroup(group);
             const sectionLabels = formCtx?.sectionLabels ?? {};
             const sectionDescriptions = formCtx?.sectionDescriptions ?? {};

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/FormLayout.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { useCallback, useLayoutEffect, useMemo, useRef, useState, type ReactNode } from 'react';\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport { responsiveMaxWidthToCssValue } from '../../sections/surface';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { ErrorBoundary } from '~wildo-frontend-lib/core/errors/ErrorBoundary';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport {\n  FormLayoutSlotContext,\n  type FormLayoutSlotType,\n} from './FormLayoutSlotContext';\nimport { FormErrorSummarySlot } from './FormErrorSummarySlot';\nimport { SubmitButton } from './SubmitButton';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { useOptionalResourceFormActions } from '../../form/automated/ResourceFormActionsContext';\nimport { ContentSectionContainer } from '../../sections/ContentSectionContainer';\nimport type { ContentSectionDescriptor } from '../../sections/ContentSectionContainer';\nimport {\n  groupSectionsByAppearance,\n  buildSectionConfigFromGroup,\n} from './section-consolidation.utils';\nimport { GroupedSectionBody, type SectionProps } from './Section';\nimport { GroupedSectionHostKind } from './Section.shared';\n\nexport interface FormLayoutProps {\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * How wide the form column lets its content grow, named in the framework's own vocabulary.\n   *\n   * Defaults to `'measure'` — the reading-measure cap (~42rem, themeable via `--measure-max-width`)\n   * that keeps a single-column form readable rather than stretched edge to edge. That default is the\n   * long-standing behaviour and is what almost every form wants.\n   *\n   * The prop exists so the tier is REACHABLE. It was previously a literal Tailwind class spelling the\n   * same value the `'measure'` tier already names, which meant a host could not select a different one\n   * — see {@link DisplayLayout}'s twin, where a composed template needed `'none'` and had no way to\n   * ask for it.\n   */\n  responsiveMaxWidth?: ResponsiveMaxWidth;\n  /**\n   * Context field values to inject into form state.\n   * Fields present here are hidden from rendering but populate\n   * the form state for validation and submission (e.g., parent IDs).\n   */\n  contextFieldValues?: Record<string, unknown>;\n  /**\n   * When `false`, suppresses automatic `<SubmitButton>` injection even if no\n   * submit slot is registered by children. The generated-template path sets\n   * this via `generateDefaultFormTemplate({ includeSubmitButton: false })`.\n   *\n   * Note: under `ResourceAutomatedForm`, suppression is automatic regardless\n   * of this prop — the host provides `ResourceFormActionsContext` and renders\n   * its own operation-aware submit row after the template, so developer-\n   * authored templates can use a bare `<FormLayout>` without ending up with\n   * two submit buttons. This prop only matters for standalone usage\n   * (direct `AutomatedForm` callers outside a resource form host).\n   * @default true\n   */\n  autoInjectSubmitButton?: boolean;\n  children?: ReactNode;\n}\n\ninterface AutoSlotsState {\n  errorSummary: boolean;\n  submitButton: boolean;\n}\n\n/**\n * Root wrapper for edit layout templates.\n *\n * Renders inside `<Form>` (RHF provider). Handles:\n * - Root `FieldScopeContext` with empty prefix\n * - Slot auto-detection: default error summary / submit when omitted (DT-6); no default submit under wizard,\n *   nor when a resource-form host owns the submit row (`ResourceFormActionsContext` present —\n *   `ResourceAutomatedForm` appends its operation-aware buttons after the template)\n * - Guidance marker for automated testing (DT-9)\n *\n * TODO(F-10): AutoFocus resolution — scan children for first focusable FormField and call focus().\n * Note: `contextFieldValues` are injected upstream by `AutomatedForm`; generated\n * templates hide those fields before rendering, while handwritten templates can\n * still opt into custom treatment when needed.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton />\n * </FormLayout>\n * ```\n */\nexport function FormLayout({\n  className,\n  children,\n  contextFieldValues: _contextFieldValues,\n  autoInjectSubmitButton = true,\n  responsiveMaxWidth = 'measure',\n}: FormLayoutProps): ReactNode {\n  const registeredSlots = useRef(new Set<FormLayoutSlotType>());\n  const wizardRootRegistered = useRef(false);\n  const [autoSlots, setAutoSlots] = useState<AutoSlotsState>({\n    errorSummary: false,\n    submitButton: false,\n  });\n\n  // A non-null ResourceFormActionsContext means a resource-form host\n  // (ResourceAutomatedForm) renders its own operation-aware submit row after\n  // the template — auto-injecting a generic SubmitButton here would produce a\n  // second submit button. Explicit templates authored app-side use a bare\n  // <FormLayout>, so this suppression cannot be a prop on the call site.\n  const hostOwnsSubmitRow = useOptionalResourceFormActions() !== null;\n\n  const registerSlot = useCallback((slot: FormLayoutSlotType) => {\n    registeredSlots.current.add(slot);\n  }, []);\n\n  const registerWizardRoot = useCallback(() => {\n    wizardRootRegistered.current = true;\n  }, []);\n\n  const slotContextValue = useMemo(\n    () => ({ registerSlot, registerWizardRoot }),\n    [registerSlot, registerWizardRoot],\n  );\n\n  // After children mount and register their slots, detect missing ones (next frame so layout effects have run).\n  useLayoutEffect(() => {\n    const frame = requestAnimationFrame(() => {\n      const missing: AutoSlotsState = {\n        errorSummary: !registeredSlots.current.has('errorSummary'),\n        submitButton:\n          autoInjectSubmitButton &&\n          !hostOwnsSubmitRow &&\n          !wizardRootRegistered.current &&\n          !registeredSlots.current.has('submitButton'),\n      };\n      if (missing.errorSummary || missing.submitButton) {\n        setAutoSlots(missing);\n      }\n    });\n    return () => cancelAnimationFrame(frame);\n  }, [autoInjectSubmitButton, hostOwnsSubmitRow]);\n\n  const formCtx = useOptionalFormTemplateContext();\n  const renderedChildren = useMemo(\n    () => renderGroupedChildren(children, formCtx),\n    [children, formCtx],\n  );\n\n  return (\n    <FormLayoutSlotContext.Provider value={slotContextValue}>\n      <FieldScopeProvider pathPrefix=\"\">\n        {/*\n          T4c — reading-measure cap. A single-column form column caps at\n          `--measure-max-width` (~42rem) and aligns to the LEFT of the content\n          zone, so detail/settings forms stop stretching edge-to-edge while\n          staying flush with the left-aligned resource header (no centred\n          gutter). `max-w` only engages when the container is wider than the\n          measure, so a form inside a narrow dialog / panel is unaffected.\n          Retune/opt-out via the CSS var or by overriding `className`.\n        */}\n        <div\n          className={cn('mr-auto w-full', className)}\n          style={{ maxInlineSize: responsiveMaxWidthToCssValue(responsiveMaxWidth) }}\n          data-inline-size-tier={responsiveMaxWidth}\n          data-guidance-form=\"\"\n        >\n          <ErrorBoundary>\n            {autoSlots.errorSummary ? <FormErrorSummarySlot className=\"mb-4\" /> : null}\n            {/* `space-y-section` separates stacked SECTIONS with a clear gap (see\n                DisplayLayout for the rationale). Wrapped separately from the\n                error-summary / submit slots so it never compounds their own\n                margins. Bare SETTINGS_ROW field rows are self-delimiting list\n                items (`py-card-sm` + `border-b`), so consecutive rows stack\n                FLUSH — same pairwise rule as DisplayLayout (see its comment for\n                why the attribute match must be `^=settings`, never the\n                underscore-carrying `=settings_row`). */}\n            <div className=\"space-y-section [&>[data-chrome-mode^=settings]:has(+[data-chrome-mode^=settings])]:mb-0\">{renderedChildren}</div>\n            {autoSlots.submitButton ? <SubmitButton className=\"mt-6\" /> : null}\n          </ErrorBoundary>\n        </div>\n      </FieldScopeProvider>\n    </FormLayoutSlotContext.Provider>\n  );\n}\n\n/**\n * Introspects children for `<Section>` elements with container-mode `appearance`.\n * Groups sections sharing the same container mode into a `ContentSectionContainer`.\n * Solo-mode sections and non-Section children render in place.\n */\nfunction renderGroupedChildren(\n  children: ReactNode,\n  formCtx: ReturnType<typeof useOptionalFormTemplateContext>,\n): ReactNode {\n  const grouped = groupSectionsByAppearance(children);\n\n  return (\n    <>\n      {grouped.items.map((item, idx) => {\n        if (item.type === 'node') {\n          return <React.Fragment key={idx}>{item.node}</React.Fragment>;\n        }\n\n        const { group } = item;\n        const config = buildSectionConfigFromGroup(group);\n        const sectionLabels = formCtx?.sectionLabels ?? {};\n        const sectionDescriptions = formCtx?.sectionDescriptions ?? {};\n\n        const contentSections: ContentSectionDescriptor[] = group.sections.map((el) => ({\n          id: el.props.name,\n          title: sectionLabels[el.props.name],\n          description: sectionDescriptions[el.props.name],\n          content: (\n            <GroupedSectionContent\n              sectionProps={el.props}\n              providesHeading={!!sectionLabels[el.props.name]}\n            />\n          ),\n        }));\n\n        return (\n          <ContentSectionContainer\n            key={`group-${group.mode}-${idx}`}\n            sections={contentSections}\n            config={config}\n          />\n        );\n      })}\n    </>\n  );\n}\n\n/**\n * Wraps an individual grouped section's content with section-level behaviors\n * (chromeMode, saveable) when rendered inside a container.\n */\nfunction GroupedSectionContent({\n  sectionProps,\n  providesHeading,\n}: {\n  sectionProps: Pick<SectionProps, 'name' | 'children' | 'chromeMode' | 'saveable' | 'className' | 'disabled'>;\n  providesHeading?: boolean;\n}): ReactNode {\n  return (\n    <GroupedSectionBody\n      hostKind={GroupedSectionHostKind.FORM}\n      sectionProps={sectionProps}\n      providesHeading={providesHeading}\n    />\n  );\n}\n"]}
+{"version":3,"file":"FormLayout.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/FormLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEvG,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,2EAA2E,CAAC;AACzH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AA8C1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,kBAAkB,EAAE,mBAAmB,EACvC,sBAAsB,GAAG,IAAI,EAC7B,kBAAkB,GAAG,SAAS,GACd;IAChB,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,GAAG,EAAsB,CAAC,CAAC;IAC9D,MAAM,oBAAoB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAiB;QACzD,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IAEH,mEAAmE;IACnE,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,iBAAiB,GAAG,8BAA8B,EAAE,KAAK,IAAI,CAAC;IAEpE,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,IAAwB,EAAE,EAAE;QAC5D,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,kBAAkB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC1C,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC,EAC5C,CAAC,YAAY,EAAE,kBAAkB,CAAC,CACnC,CAAC;IAEF,8GAA8G;IAC9G,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE;YACvC,MAAM,OAAO,GAAmB;gBAC9B,YAAY,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBAC1D,YAAY,EACV,sBAAsB;oBACtB,CAAC,iBAAiB;oBAClB,CAAC,oBAAoB,CAAC,OAAO;oBAC7B,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;aAC/C,CAAC;YACF,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACjD,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAG,8BAA8B,EAAE,CAAC;IACjD,sGAAsG;IACtG,qFAAqF;IACrF,uGAAuG;IACvG,yBAAyB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC9C,CAAC,QAAQ,EAAE,OAAO,CAAC,CACpB,CAAC;IAEF,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,gBAAgB,YACrD,KAAC,kBAAkB,IAAC,UAAU,EAAC,EAAE,YAU/B,cACE,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAC1C,KAAK,EAAE,EAAE,aAAa,EAAE,4BAA4B,CAAC,kBAAkB,CAAC,EAAE,2BACnD,kBAAkB,wBACtB,EAAE,YAErB,MAAC,aAAa,eACX,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,KAAC,oBAAoB,IAAC,SAAS,EAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAS1E,cAAK,SAAS,EAAC,0FAA0F,YAAE,gBAAgB,GAAO,EACjI,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,SAAS,EAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,IACpD,GACZ,GACa,GACU,CAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,0BAA0B,CAAC,QAAmB,EAAE,MAAgC;IACvF,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,MAAM,KAAK,IAAI;WACjB,MAAM,CAAC,MAAM,GAAG,CAAC;WACjB,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,4BAA4B,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;AAC1I,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,QAAmB,EACnB,OAA0D;IAE1D,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,CACL,4BACG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,KAAC,KAAK,CAAC,QAAQ,cAAY,IAAI,CAAC,IAAI,IAAf,GAAG,CAA8B,CAAC;YAChE,CAAC;YAED,iGAAiG;YACjG,qFAAqF;YACrF,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1H,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC;YACnD,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,IAAI,EAAE,CAAC;YAE/D,MAAM,eAAe,GAA+B,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9E,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;gBACjB,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBACnC,WAAW,EAAE,mBAAmB,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC/C,OAAO,EAAE,CACP,KAAC,qBAAqB,IACpB,YAAY,EAAE,EAAE,CAAC,KAAK,EACtB,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAC/C,CACH;aACF,CAAC,CAAC,CAAC;YAEJ,OAAO,CACL,KAAC,uBAAuB,IAEtB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,IAFT,SAAS,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAGjC,CACH,CAAC;QACJ,CAAC,CAAC,GACD,CACJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,EAC7B,YAAY,EACZ,eAAe,GAIhB;IACC,OAAO,CACL,KAAC,kBAAkB,IACjB,QAAQ,EAAE,sBAAsB,CAAC,IAAI,EACrC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,eAAe,GAChC,CACH,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport type { z } from 'zod';\nimport React, { useCallback, useLayoutEffect, useMemo, useRef, useState, type ReactNode } from 'react';\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport { responsiveMaxWidthToCssValue } from '../../sections/surface';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { ErrorBoundary } from '~wildo-frontend-lib/core/errors/ErrorBoundary';\nimport { FieldScopeProvider } from './FieldScopeContext';\nimport {\n  FormLayoutSlotContext,\n  type FormLayoutSlotType,\n} from './FormLayoutSlotContext';\nimport { FormErrorSummarySlot } from './FormErrorSummarySlot';\nimport { SubmitButton } from './SubmitButton';\nimport { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext';\nimport { useOptionalResourceFormActions } from '../../form/automated/ResourceFormActionsContext';\nimport { ContentSectionContainer } from '../../sections/ContentSectionContainer';\nimport type { ContentSectionDescriptor } from '../../sections/ContentSectionContainer';\nimport {\n  groupSectionsByAppearance,\n  buildSectionConfigFromGroup,\n} from './section-consolidation.utils';\nimport { GroupedSectionBody, type SectionProps } from './Section';\nimport { listPlacedFieldSlots } from './SectionFieldsContext';\nimport { useTemplatePlacedFieldsOf } from '../../form/automated/TemplatePlacedFieldsContext';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { GroupedSectionHostKind } from './Section.shared';\n\nexport interface FormLayoutProps {\n  /** Additional CSS classes for the root container. */\n  className?: string;\n  /**\n   * How wide the form column lets its content grow, named in the framework's own vocabulary.\n   *\n   * Defaults to `'measure'` — the reading-measure cap (~42rem, themeable via `--measure-max-width`)\n   * that keeps a single-column form readable rather than stretched edge to edge. That default is the\n   * long-standing behaviour and is what almost every form wants.\n   *\n   * The prop exists so the tier is REACHABLE. It was previously a literal Tailwind class spelling the\n   * same value the `'measure'` tier already names, which meant a host could not select a different one\n   * — see {@link DisplayLayout}'s twin, where a composed template needed `'none'` and had no way to\n   * ask for it.\n   */\n  responsiveMaxWidth?: ResponsiveMaxWidth;\n  /**\n   * Context field values to inject into form state.\n   * Fields present here are hidden from rendering but populate\n   * the form state for validation and submission (e.g., parent IDs).\n   */\n  contextFieldValues?: Record<string, unknown>;\n  /**\n   * When `false`, suppresses automatic `<SubmitButton>` injection even if no\n   * submit slot is registered by children. The generated-template path sets\n   * this via `generateDefaultFormTemplate({ includeSubmitButton: false })`.\n   *\n   * Note: under `ResourceAutomatedForm`, suppression is automatic regardless\n   * of this prop — the host provides `ResourceFormActionsContext` and renders\n   * its own operation-aware submit row after the template, so developer-\n   * authored templates can use a bare `<FormLayout>` without ending up with\n   * two submit buttons. This prop only matters for standalone usage\n   * (direct `AutomatedForm` callers outside a resource form host).\n   * @default true\n   */\n  autoInjectSubmitButton?: boolean;\n  children?: ReactNode;\n}\n\ninterface AutoSlotsState {\n  errorSummary: boolean;\n  submitButton: boolean;\n}\n\n/**\n * Root wrapper for edit layout templates.\n *\n * Renders inside `<Form>` (RHF provider). Handles:\n * - Root `FieldScopeContext` with empty prefix\n * - Slot auto-detection: default error summary / submit when omitted (DT-6); no default submit under wizard,\n *   nor when a resource-form host owns the submit row (`ResourceFormActionsContext` present —\n *   `ResourceAutomatedForm` appends its operation-aware buttons after the template)\n * - Guidance marker for automated testing (DT-9)\n *\n * TODO(F-10): AutoFocus resolution — scan children for first focusable FormField and call focus().\n * Note: `contextFieldValues` are injected upstream by `AutomatedForm`; generated\n * templates hide those fields before rendering, while handwritten templates can\n * still opt into custom treatment when needed.\n *\n * @example\n * ```tsx\n * <FormLayout>\n *   <Section name=\"general\">\n *     <FormField name=\"title\" />\n *   </Section>\n *   <SubmitButton />\n * </FormLayout>\n * ```\n */\nexport function FormLayout({\n  className,\n  children,\n  contextFieldValues: _contextFieldValues,\n  autoInjectSubmitButton = true,\n  responsiveMaxWidth = 'measure',\n}: FormLayoutProps): ReactNode {\n  const registeredSlots = useRef(new Set<FormLayoutSlotType>());\n  const wizardRootRegistered = useRef(false);\n  const [autoSlots, setAutoSlots] = useState<AutoSlotsState>({\n    errorSummary: false,\n    submitButton: false,\n  });\n\n  // A non-null ResourceFormActionsContext means a resource-form host\n  // (ResourceAutomatedForm) renders its own operation-aware submit row after\n  // the template — auto-injecting a generic SubmitButton here would produce a\n  // second submit button. Explicit templates authored app-side use a bare\n  // <FormLayout>, so this suppression cannot be a prop on the call site.\n  const hostOwnsSubmitRow = useOptionalResourceFormActions() !== null;\n\n  const registerSlot = useCallback((slot: FormLayoutSlotType) => {\n    registeredSlots.current.add(slot);\n  }, []);\n\n  const registerWizardRoot = useCallback(() => {\n    wizardRootRegistered.current = true;\n  }, []);\n\n  const slotContextValue = useMemo(\n    () => ({ registerSlot, registerWizardRoot }),\n    [registerSlot, registerWizardRoot],\n  );\n\n  // After children mount and register their slots, detect missing ones (next frame so layout effects have run).\n  useLayoutEffect(() => {\n    const frame = requestAnimationFrame(() => {\n      const missing: AutoSlotsState = {\n        errorSummary: !registeredSlots.current.has('errorSummary'),\n        submitButton:\n          autoInjectSubmitButton &&\n          !hostOwnsSubmitRow &&\n          !wizardRootRegistered.current &&\n          !registeredSlots.current.has('submitButton'),\n      };\n      if (missing.errorSummary || missing.submitButton) {\n        setAutoSlots(missing);\n      }\n    });\n    return () => cancelAnimationFrame(frame);\n  }, [autoInjectSubmitButton, hostOwnsSubmitRow]);\n\n  const formCtx = useOptionalFormTemplateContext();\n  // Every slot among this layout's children, read from the elements: a tab's panel, a later wizard step\n  // or an unchosen variant is not mounted, so its fields cannot report themselves (see\n  // `TemplatePlacedFieldsContext`). From an empty prefix: this layout resets its children's scope to \"\".\n  useTemplatePlacedFieldsOf(children, '');\n  const renderedChildren = useMemo(\n    () => renderGroupedChildren(children, formCtx),\n    [children, formCtx],\n  );\n\n  return (\n    <FormLayoutSlotContext.Provider value={slotContextValue}>\n      <FieldScopeProvider pathPrefix=\"\">\n        {/*\n          T4c — reading-measure cap. A single-column form column caps at\n          `--measure-max-width` (~42rem) and aligns to the LEFT of the content\n          zone, so detail/settings forms stop stretching edge-to-edge while\n          staying flush with the left-aligned resource header (no centred\n          gutter). `max-w` only engages when the container is wider than the\n          measure, so a form inside a narrow dialog / panel is unaffected.\n          Retune/opt-out via the CSS var or by overriding `className`.\n        */}\n        <div\n          className={cn('mr-auto w-full', className)}\n          style={{ maxInlineSize: responsiveMaxWidthToCssValue(responsiveMaxWidth) }}\n          data-inline-size-tier={responsiveMaxWidth}\n          data-guidance-form=\"\"\n        >\n          <ErrorBoundary>\n            {autoSlots.errorSummary ? <FormErrorSummarySlot className=\"mb-4\" /> : null}\n            {/* `space-y-section` separates stacked SECTIONS with a clear gap (see\n                DisplayLayout for the rationale). Wrapped separately from the\n                error-summary / submit slots so it never compounds their own\n                margins. Bare SETTINGS_ROW field rows are self-delimiting list\n                items (`py-card-sm` + `border-b`), so consecutive rows stack\n                FLUSH — same pairwise rule as DisplayLayout (see its comment for\n                why the attribute match must be `^=settings`, never the\n                underscore-carrying `=settings_row`). */}\n            <div className=\"space-y-section [&>[data-chrome-mode^=settings]:has(+[data-chrome-mode^=settings])]:mb-0\">{renderedChildren}</div>\n            {autoSlots.submitButton ? <SubmitButton className=\"mt-6\" /> : null}\n          </ErrorBoundary>\n        </div>\n      </FieldScopeProvider>\n    </FormLayoutSlotContext.Provider>\n  );\n}\n\n/**\n * Whether a GROUPED section (grid, tabs, accordion, …) has nothing to show for this form's operation.\n *\n * One template serves several operations, and a `FormField` whose field the operation's schema lacks\n * renders nothing. A solo `Section` hides itself from what its fields report once mounted; a grouped\n * section cannot, because its container draws its title and panel and a tab's panel is not even mounted\n * until it is chosen. So the host decides from the section's elements: when they are only field slots\n * (`listPlacedFieldSlots`) and none of their paths resolves in the form's schema, the section is dropped.\n *\n * This reads the SCHEMA, not visibility: a field hidden by a condition is still in the schema, so its\n * section stays. Dropping a section there would take it out of its container on a value change.\n */\nfunction groupedSectionShowsNoField(children: ReactNode, schema: z.ZodTypeAny | undefined): boolean {\n  if (!schema) return false;\n  const placed = listPlacedFieldSlots(children);\n  return placed !== null\n    && placed.length > 0\n    && placed.every((slot) => !slot.hasOwnSchema && AutomatedLayoutFrontendUtils.resolveFieldSchemaPath(schema, slot.path) === undefined);\n}\n\n/**\n * Introspects children for `<Section>` elements with container-mode `appearance`.\n * Groups sections sharing the same container mode into a `ContentSectionContainer`.\n * Solo-mode sections and non-Section children render in place.\n */\nfunction renderGroupedChildren(\n  children: ReactNode,\n  formCtx: ReturnType<typeof useOptionalFormTemplateContext>,\n): ReactNode {\n  const grouped = groupSectionsByAppearance(children);\n\n  return (\n    <>\n      {grouped.items.map((item, idx) => {\n        if (item.type === 'node') {\n          return <React.Fragment key={idx}>{item.node}</React.Fragment>;\n        }\n\n        // A grouped section none of whose fields this operation has is dropped from its container, and a\n        // container left with no section renders nothing (see `groupedSectionShowsNoField`).\n        const shownSections = item.group.sections.filter((el) => !groupedSectionShowsNoField(el.props.children, formCtx?.schema));\n        if (shownSections.length === 0) return null;\n        const group = { ...item.group, sections: shownSections };\n        const config = buildSectionConfigFromGroup(group);\n        const sectionLabels = formCtx?.sectionLabels ?? {};\n        const sectionDescriptions = formCtx?.sectionDescriptions ?? {};\n\n        const contentSections: ContentSectionDescriptor[] = group.sections.map((el) => ({\n          id: el.props.name,\n          title: sectionLabels[el.props.name],\n          description: sectionDescriptions[el.props.name],\n          content: (\n            <GroupedSectionContent\n              sectionProps={el.props}\n              providesHeading={!!sectionLabels[el.props.name]}\n            />\n          ),\n        }));\n\n        return (\n          <ContentSectionContainer\n            key={`group-${group.mode}-${idx}`}\n            sections={contentSections}\n            config={config}\n          />\n        );\n      })}\n    </>\n  );\n}\n\n/**\n * Wraps an individual grouped section's content with section-level behaviors\n * (chromeMode, saveable) when rendered inside a container.\n */\nfunction GroupedSectionContent({\n  sectionProps,\n  providesHeading,\n}: {\n  sectionProps: Pick<SectionProps, 'name' | 'children' | 'chromeMode' | 'saveable' | 'className' | 'disabled'>;\n  providesHeading?: boolean;\n}): ReactNode {\n  return (\n    <GroupedSectionBody\n      hostKind={GroupedSectionHostKind.FORM}\n      sectionProps={sectionProps}\n      providesHeading={providesHeading}\n    />\n  );\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayoutSlotContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/FormLayoutSlotContext.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,qBAAqB,qDAAyD,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAKlE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}
+{"version":3,"file":"FormLayoutSlotContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/FormLayoutSlotContext.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,qBAAqB,qDAAyD,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAKlE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayoutSlotContext.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/FormLayoutSlotContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAUnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,eAAe,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,eAAe,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,kBAAkB,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext, useLayoutEffect } from 'react';\n\nexport type FormLayoutSlotType = 'errorSummary' | 'submitButton';\n\nexport interface FormLayoutSlotContextValue {\n  registerSlot: (slot: FormLayoutSlotType) => void;\n  /** Set when `WizardLayout` mounts; suppresses auto-injected `SubmitButton`. */\n  registerWizardRoot: () => void;\n}\n\nexport const FormLayoutSlotContext = createContext<FormLayoutSlotContextValue | null>(null);\n\n/**\n * Hook for slot components (`FormErrorSummarySlot`, `SubmitButton`) to register their presence.\n * `FormLayout` uses this to know which slots are manually placed by the template author,\n * and auto-injects defaults for any missing slots.\n */\nexport function useSlotRegistration(slot: FormLayoutSlotType): void {\n  const ctx = useContext(FormLayoutSlotContext);\n  useLayoutEffect(() => {\n    ctx?.registerSlot(slot);\n  }, [slot, ctx]);\n}\n\n/**\n * Called by `WizardLayout` on mount so `FormLayout` does not append a default `SubmitButton`.\n */\nexport function useWizardRootRegistration(): void {\n  const ctx = useContext(FormLayoutSlotContext);\n  useLayoutEffect(() => {\n    ctx?.registerWizardRoot();\n  }, [ctx]);\n}\n"]}
+{"version":3,"file":"FormLayoutSlotContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/FormLayoutSlotContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAUnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,eAAe,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,eAAe,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,kBAAkB,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext, useLayoutEffect } from 'react';\n\nexport type FormLayoutSlotType = 'errorSummary' | 'submitButton';\n\nexport interface FormLayoutSlotContextValue {\n  registerSlot: (slot: FormLayoutSlotType) => void;\n  /** Set when `WizardLayout` mounts; suppresses auto-injected `SubmitButton`. */\n  registerWizardRoot: () => void;\n}\n\nexport const FormLayoutSlotContext = createContext<FormLayoutSlotContextValue | null>(null);\n\n/**\n * Hook for slot components (`FormErrorSummarySlot`, `SubmitButton`) to register their presence.\n * `FormLayout` uses this to know which slots are manually placed by the template author,\n * and auto-injects defaults for any missing slots.\n */\nexport function useSlotRegistration(slot: FormLayoutSlotType): void {\n  const ctx = useContext(FormLayoutSlotContext);\n  useLayoutEffect(() => {\n    ctx?.registerSlot(slot);\n  }, [slot, ctx]);\n}\n\n/**\n * Called by `WizardLayout` on mount so `FormLayout` does not append a default `SubmitButton`.\n */\nexport function useWizardRootRegistration(): void {\n  const ctx = useContext(FormLayoutSlotContext);\n  useLayoutEffect(() => {\n    ctx?.registerWizardRoot();\n  }, [ctx]);\n}\n"]}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceHeaderTitle.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAgDpD,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOrF,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAkC,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAA4B;IACzE,MAAM,MAAM,GAAG,gCAAgC,EAAE,CAAC;IAClD,0EAA0E;IAC1E,4EAA4E;IAC5E,gFAAgF;IAChF,IAAI,MAAM,EAAE,iBAAiB;QAAE,MAAM,CAAC,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gGAAgG;QAChG,0FAA0F;QAC1F,OAAO,MAAM,EAAE,YAAY;YACzB,CAAC,CAAC,KAAC,QAAQ,IAAC,SAAS,EAAC,qBAAqB,iBAAa,MAAM,wCAAoC,MAAM,GAAG;YAC3G,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,OAAO;IACL,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,mEAAmE;IACnE,kDAAkD;IAClD,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAC5B,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CAAC,CAAC,CAAC,CACF,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CACF,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * ResourceHeaderTitle — the record's page TITLE as a first-class, composable\n * element of an authored `layout.header` template.\n *\n * ## Why the header needs a template flow at all\n *\n * The READ page header owns a fixed band: back button, breadcrumb, resource\n * icon, the record's name, and the operation action cluster. Everything a\n * resource wanted to show ABOUT the record (a status badge, a visibility\n * marker, an accent colour) could previously only render in the `layout.display`\n * body BELOW that band — so the identity line said the record's name and nothing\n * else, while \"is this archived? is it public?\" sat in a separate labelled strip\n * underneath.\n *\n * `layout.header` closes that by letting the resource compose the middle of the\n * band itself. It is the same shape the SUMMARY surface already uses\n * (`SummaryLayout` / `SummaryTitle`), for the same reason recorded there: a\n * host-owned title plus a bolt-on accessory slot cannot express \"badge AFTER the\n * name\" or \"swatch BEFORE it\", whereas a template that places the title element\n * itself can express any of them with no extra config axis.\n *\n * ## Contract\n *\n * The header cedes the middle region to the template the moment `layout.header`\n * exists, so a template that never mounts `<ResourceHeaderTitle />` renders a\n * page with NO record name. That is loud in development (see the diagnostic in\n * `ResourceLayout_Header`) rather than silent.\n *\n * Renders nothing when the host resolved no label (a surface that shows a\n * generic operation title rather than one record's name) — the presence of a\n * label is the single data-driven signal that there is a title to place.\n */\n\nimport React, { createContext, useContext } from 'react';\n\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nexport interface ResourceHeaderContextValue {\n  /** Resource type key of the record whose header is rendering. */\n  resourceType: string;\n\n  /**\n   * Resolved record title (the `getFrontendResourceLabel` result, or the\n   * operation/resource title fallback), or `null` when this surface has no\n   * record-specific name to show — `<ResourceHeaderTitle />` then renders nothing.\n   */\n  title: string | null;\n\n  /**\n   * `true` while the record's name is still being fetched and nothing else stands in for it.\n   * `<ResourceHeaderTitle />` then RESERVES the title's line with a skeleton instead of rendering\n   * nothing.\n   *\n   * An empty band is a defect, not a flicker. The header withholds the label during the first fetch\n   * on purpose (it would otherwise flash `#id` and then the real name), and the title element used to\n   * render nothing meanwhile — so the band had no height and the name's arrival pushed everything\n   * beneath it down by a line. Measured 2026-09-21 in the creation workbench's actor-task modal:\n   * `mousedown` landed on a tab, the record arrived, `mouseup` one millisecond later landed on the\n   * heading, and the browser dispatched the click to their common ancestor. The tab never changed\n   * and nothing reported why.\n   */\n  titlePending?: boolean;\n\n  /**\n   * Dev-diagnostic seam: `<ResourceHeaderTitle />` flips `titleMounted` when it\n   * renders, letting the header detect an authored template that never places\n   * the title. Mutable-ref shape (not state) on purpose — the flag is read only\n   * after render and must never schedule a re-render.\n   */\n  titleMountTracker?: { titleMounted: boolean };\n\n  /**\n   * `true` when an enclosing section already renders the heading for this region (an embedded READ inside\n   * a host section). The record's name is then not the PAGE title, so `<ResourceHeaderTitle />` renders an\n   * `h2` beneath the host's heading instead of a second `h1` — the same rule the default header applies.\n   */\n  hostProvidesHeading?: boolean;\n}\n\nconst ResourceHeaderContext = createContext<ResourceHeaderContextValue | null>(null);\n\nexport interface ResourceHeaderContextProviderProps {\n  value: ResourceHeaderContextValue;\n  children: React.ReactNode;\n}\n\n/** Provides the resolved record title to an authored header template tree. */\nexport function ResourceHeaderContextProvider({\n  value,\n  children,\n}: ResourceHeaderContextProviderProps): React.JSX.Element {\n  return <ResourceHeaderContext.Provider value={value}>{children}</ResourceHeaderContext.Provider>;\n}\n\n/**\n * Read the header context, or `null` when a header template is rendered outside\n * `ResourceLayout_Header` (e.g. previewed in isolation).\n */\nexport function useOptionalResourceHeaderContext(): ResourceHeaderContextValue | null {\n  return useContext(ResourceHeaderContext);\n}\n\n// =============================================================================\n// TITLE ELEMENT\n// =============================================================================\n\n/** @wildo_source:part:start saas.frontend.resource-header-title facet:layer:frontend facet:family:resource-ui */\nexport interface ResourceHeaderTitleProps {\n  /** Extra classes merged over the default page-title styling. */\n  className?: string;\n}\n\n/**\n * The record's name, rendered with the page-header typography the default\n * (template-less) header uses — so authoring a header template is visually\n * neutral for the title itself and only adds what the template places around it.\n *\n * ## It is an `h1`, and the level is not cosmetic\n *\n * This IS the page's title — the record's name on a record page, the collection's on a listing — and\n * there is exactly one per surface, so it owns the top of the document outline. It was an `h2` until\n * 2026-09-09, which left generated screens with NO level-one heading at all: the first accessibility\n * audit ever run against a live stack reported `page-has-heading-one` on the collection listing,\n * where this element was the only heading on the page (#533).\n *\n * The classes are unchanged, so nothing moves visually — `text-xl` still sets the size. A heading\n * level is the document's structure, not its appearance, and the two are deliberately decoupled here\n * exactly as the design system does elsewhere.\n */\nexport function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): React.JSX.Element | null {\n  const header = useOptionalResourceHeaderContext();\n  // Register with the missing-title diagnostic BEFORE the empty-title early\n  // return: mounting the element discharges the template's contract even when\n  // this particular record resolves no label (data-driven, not an authoring bug).\n  if (header?.titleMountTracker) header.titleMountTracker.titleMounted = true;\n\n  const title = header?.title;\n  if (!title) {\n    // A name that is on its way reserves its line, so its arrival moves nothing beneath the header;\n    // a surface with no name at all still renders nothing. `h-7` is `text-xl`'s own line box.\n    return header?.titlePending\n      ? <Skeleton className=\"h-7 w-48 max-w-full\" aria-hidden=\"true\" data-resource-header-title-pending=\"true\" />\n      : null;\n  }\n\n  return (\n    // `min-w-0` + truncate so a long record name shrinks instead of pushing the\n    // template's trailing badges out of the band. No `flex-1`: the title claims\n    // only the space it needs, which is what keeps an authored badge HUGGING the\n    // name rather than being flung to the far end of the row (the same\n    // composition lesson recorded on `SummaryTitle`).\n    header?.hostProvidesHeading ? (\n      <h2 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h2>\n    ) : (\n      <h1 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h1>\n    )\n  );\n}\n/** @wildo_source:part:end saas.frontend.resource-header-title */\n"]}
+{"version":3,"file":"ResourceHeaderTitle.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ResourceHeaderTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAgDpD,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOrF,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAkC,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAA4B;IACzE,MAAM,MAAM,GAAG,gCAAgC,EAAE,CAAC;IAClD,0EAA0E;IAC1E,4EAA4E;IAC5E,gFAAgF;IAChF,IAAI,MAAM,EAAE,iBAAiB;QAAE,MAAM,CAAC,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gGAAgG;QAChG,0FAA0F;QAC1F,OAAO,MAAM,EAAE,YAAY;YACzB,CAAC,CAAC,KAAC,QAAQ,IAAC,SAAS,EAAC,qBAAqB,iBAAa,MAAM,wCAAoC,MAAM,GAAG;YAC3G,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,OAAO;IACL,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,mEAAmE;IACnE,kDAAkD;IAClD,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAC5B,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CAAC,CAAC,CAAC,CACF,aAAI,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,YACnF,KAAK,GACH,CACN,CACF,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * ResourceHeaderTitle — the record's page TITLE as a first-class, composable\n * element of an authored `layout.header` template.\n *\n * ## Why the header needs a template flow at all\n *\n * The READ page header owns a fixed band: back button, breadcrumb, resource\n * icon, the record's name, and the operation action cluster. Everything a\n * resource wanted to show ABOUT the record (a status badge, a visibility\n * marker, an accent colour) could previously only render in the `layout.display`\n * body BELOW that band — so the identity line said the record's name and nothing\n * else, while \"is this archived? is it public?\" sat in a separate labelled strip\n * underneath.\n *\n * `layout.header` closes that by letting the resource compose the middle of the\n * band itself. It is the same shape the SUMMARY surface already uses\n * (`SummaryLayout` / `SummaryTitle`), for the same reason recorded there: a\n * host-owned title plus a bolt-on accessory slot cannot express \"badge AFTER the\n * name\" or \"swatch BEFORE it\", whereas a template that places the title element\n * itself can express any of them with no extra config axis.\n *\n * ## Contract\n *\n * The header cedes the middle region to the template the moment `layout.header`\n * exists, so a template that never mounts `<ResourceHeaderTitle />` renders a\n * page with NO record name. That is loud in development (see the diagnostic in\n * `ResourceLayout_Header`) rather than silent.\n *\n * Renders nothing when the host resolved no label (a surface that shows a\n * generic operation title rather than one record's name) — the presence of a\n * label is the single data-driven signal that there is a title to place.\n */\n\nimport React, { createContext, useContext } from 'react';\n\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n// =============================================================================\n// CONTEXT\n// =============================================================================\n\nexport interface ResourceHeaderContextValue {\n  /** Resource type key of the record whose header is rendering. */\n  resourceType: string;\n\n  /**\n   * Resolved record title (the `getFrontendResourceLabel` result, or the\n   * operation/resource title fallback), or `null` when this surface has no\n   * record-specific name to show — `<ResourceHeaderTitle />` then renders nothing.\n   */\n  title: string | null;\n\n  /**\n   * `true` while the record's name is still being fetched and nothing else stands in for it.\n   * `<ResourceHeaderTitle />` then RESERVES the title's line with a skeleton instead of rendering\n   * nothing.\n   *\n   * An empty band is a defect, not a flicker. The header withholds the label during the first fetch\n   * on purpose (it would otherwise flash `#id` and then the real name), and the title element used to\n   * render nothing meanwhile — so the band had no height and the name's arrival pushed everything\n   * beneath it down by a line. Measured 2026-09-21 in the creation workbench's actor-task modal:\n   * `mousedown` landed on a tab, the record arrived, `mouseup` one millisecond later landed on the\n   * heading, and the browser dispatched the click to their common ancestor. The tab never changed\n   * and nothing reported why.\n   */\n  titlePending?: boolean;\n\n  /**\n   * Dev-diagnostic seam: `<ResourceHeaderTitle />` flips `titleMounted` when it\n   * renders, letting the header detect an authored template that never places\n   * the title. Mutable-ref shape (not state) on purpose — the flag is read only\n   * after render and must never schedule a re-render.\n   */\n  titleMountTracker?: { titleMounted: boolean };\n\n  /**\n   * `true` when an enclosing section already renders the heading for this region (an embedded READ inside\n   * a host section). The record's name is then not the PAGE title, so `<ResourceHeaderTitle />` renders an\n   * `h2` beneath the host's heading instead of a second `h1` — the same rule the default header applies.\n   */\n  hostProvidesHeading?: boolean;\n}\n\nconst ResourceHeaderContext = createContext<ResourceHeaderContextValue | null>(null);\n\nexport interface ResourceHeaderContextProviderProps {\n  value: ResourceHeaderContextValue;\n  children: React.ReactNode;\n}\n\n/** Provides the resolved record title to an authored header template tree. */\nexport function ResourceHeaderContextProvider({\n  value,\n  children,\n}: ResourceHeaderContextProviderProps): React.JSX.Element {\n  return <ResourceHeaderContext.Provider value={value}>{children}</ResourceHeaderContext.Provider>;\n}\n\n/**\n * Read the header context, or `null` when a header template is rendered outside\n * `ResourceLayout_Header` (e.g. previewed in isolation).\n */\nexport function useOptionalResourceHeaderContext(): ResourceHeaderContextValue | null {\n  return useContext(ResourceHeaderContext);\n}\n\n// =============================================================================\n// TITLE ELEMENT\n// =============================================================================\n\n/** @wildo_source:part:start saas.frontend.resource-header-title facet:layer:frontend facet:family:resource-ui */\nexport interface ResourceHeaderTitleProps {\n  /** Extra classes merged over the default page-title styling. */\n  className?: string;\n}\n\n/**\n * The record's name, rendered with the page-header typography the default\n * (template-less) header uses — so authoring a header template is visually\n * neutral for the title itself and only adds what the template places around it.\n *\n * ## It is an `h1`, and the level is not cosmetic\n *\n * This IS the page's title — the record's name on a record page, the collection's on a listing — and\n * there is exactly one per surface, so it owns the top of the document outline. It was an `h2` until\n * 2026-09-09, which left generated screens with NO level-one heading at all: the first accessibility\n * audit ever run against a live stack reported `page-has-heading-one` on the collection listing,\n * where this element was the only heading on the page (#533).\n *\n * The classes are unchanged, so nothing moves visually — `text-xl` still sets the size. A heading\n * level is the document's structure, not its appearance, and the two are deliberately decoupled here\n * exactly as the design system does elsewhere.\n */\nexport function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): React.JSX.Element | null {\n  const header = useOptionalResourceHeaderContext();\n  // Register with the missing-title diagnostic BEFORE the empty-title early\n  // return: mounting the element discharges the template's contract even when\n  // this particular record resolves no label (data-driven, not an authoring bug).\n  if (header?.titleMountTracker) header.titleMountTracker.titleMounted = true;\n\n  const title = header?.title;\n  if (!title) {\n    // A name that is on its way reserves its line, so its arrival moves nothing beneath the header;\n    // a surface with no name at all still renders nothing. `h-7` is `text-xl`'s own line box.\n    return header?.titlePending\n      ? <Skeleton className=\"h-7 w-48 max-w-full\" aria-hidden=\"true\" data-resource-header-title-pending=\"true\" />\n      : null;\n  }\n\n  return (\n    // `min-w-0` + truncate so a long record name shrinks instead of pushing the\n    // template's trailing badges out of the band. No `flex-1`: the title claims\n    // only the space it needs, which is what keeps an authored badge HUGGING the\n    // name rather than being flung to the far end of the row (the same\n    // composition lesson recorded on `SummaryTitle`).\n    header?.hostProvidesHeading ? (\n      <h2 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h2>\n    ) : (\n      <h1 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>\n        {title}\n      </h1>\n    )\n  );\n}\n/** @wildo_source:part:end saas.frontend.resource-header-title */\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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"}

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

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

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

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

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

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

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

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