{
  "id": "form-section",
  "name": "FormSection",
  "level": "molecule",
  "status": "stable",
  "purpose": "Gathers related form fields under a title and a short explanation.",
  "description": "Composes SectionHeader (when title is provided) and stacks Fields below. Renders a <section> landmark. density toggles inter-field gap; the host owns padding. Patterns consulted: Patterns/Forms · FieldAnatomy + FormDensity, Patterns/Information Architecture · SectionAnatomy.",
  "role": "surface",
  "import": "@rrios-forge/ui/molecules/form-section",
  "exports": [
    "FormSection",
    "FORM_SECTION_DENSITIES",
    "FORM_SECTION_WIDTHS",
    "formSectionFieldsVariants",
    "formSectionVariants"
  ],
  "source": "packages/ui/src/molecules/form-section",
  "axes": [
    {
      "axis": "density",
      "part": null,
      "values": [
        "compact",
        "comfortable"
      ],
      "default": null,
      "meaning": null
    },
    {
      "axis": "width",
      "part": null,
      "values": [
        "readable",
        "full"
      ],
      "default": null,
      "meaning": null
    }
  ],
  "needs": [
    {
      "need": "Group of fields",
      "answer": "`FormSection` or `InputGroup`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-005",
      "title": "Visual operational rules: surfaces, interaction, motion"
    },
    {
      "id": "ADR-006",
      "title": "Geometry and typography signature"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-formsection--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-formsection--playground",
      "frame": "/iframe.html?id=components-molecules-formsection--playground&viewMode=story"
    },
    {
      "name": "Account section",
      "id": "components-molecules-formsection--account-section",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-formsection--account-section",
      "frame": "/iframe.html?id=components-molecules-formsection--account-section&viewMode=story"
    },
    {
      "name": "Security section",
      "id": "components-molecules-formsection--security-section",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-formsection--security-section",
      "frame": "/iframe.html?id=components-molecules-formsection--security-section&viewMode=story"
    },
    {
      "name": "Compact",
      "id": "components-molecules-formsection--compact",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-formsection--compact",
      "frame": "/iframe.html?id=components-molecules-formsection--compact&viewMode=story"
    },
    {
      "name": "With action",
      "id": "components-molecules-formsection--with-action",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-formsection--with-action",
      "frame": "/iframe.html?id=components-molecules-formsection--with-action&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/form-section.stories.tsx"
}