fix(docs): update sf-grid-cols-1 description to reflect no container context

Split the CSS block comment so .sf-grid-cols-1 has its own section
accurately describing it as a plain single-column grid with no
container: inline-size declaration. The previous shared comment with
the multi-column CQ-responsive variants was stale and incorrectly
implied a container ancestor was required.

Regenerated api-index, classes, registry, and configurator sync.

Addresses CodeRabbit review: docs/api-index.md line 969.

https://claude.ai/code/session_01ATnXgvc7vf945stc5VDAvz

Author: claude

core/layout.css

@@ -444,6 +444,18 @@
     min-height:          100dvh;
   }
 
+  /* -- Single-column grid --------------------------------------
+     Plain single-column grid. No container context — it never
+     needs CQ breakpoints (there's only one column). Use when you
+     want consistent gap spacing without affecting container queries
+     on child elements.
+     ---------------------------------------------------------- */
+
+  .sf-grid-cols-1 {
+    display: grid;
+    gap:     var(--sf-grid-gap);
+  }
+
   /* -- Fixed column grids (container-query responsive) ---------
      Responsive fixed-column grids with no media queries.
 
@@ -454,11 +466,6 @@
      Wrap in .sf-container (or any element with container-type: inline-size).
      ---------------------------------------------------------- */
 
-  .sf-grid-cols-1 {
-    display: grid;
-    gap:     var(--sf-grid-gap);
-  }
-
   .sf-grid-cols-2, .sf-grid-cols-3, .sf-grid-cols-4, .sf-grid-cols-6 {
     display:   grid;
     gap:       var(--sf-grid-gap);

dist/badge-essential.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "label": "essential",
-  "message": "54.8 kB gzip",
+  "message": "54.9 kB gzip",
   "color": "brightgreen",
   "namedLogo": "css3"
 }

docs/api-index.json

@@ -27273,8 +27273,8 @@
       "kind": "layout",
       "category": "Layout primitives",
       "area": "layout",
-      "group": "Fixed column grids (container-query responsive)",
-      "description": "Responsive fixed-column grids with no media queries. IMPORTANT: These classes use anonymous @container queries, so they react to the nearest ancestor that has a container context (container-type: inline-size). Without a container ancestor the queries never match and the grid…",
+      "group": "Single-column grid",
+      "description": "Plain single-column grid. No container context — it never needs CQ breakpoints (there's only one column). Use when you want consistent gap spacing without affecting container queries on child elements.",
       "isVariant": false,
       "baseClass": null,
       "optional": false,

docs/api-index.md

@@ -966,7 +966,7 @@ and a short description. The machine-readable companion (with all columns) is
 | `.sf-grid--s` | PUBLIC | layout | Grid (auto) | Auto-fill CSS grid with no breakpoints. .sf-grid--fit switches to auto-fit. Fixed-column variants live in .sf-grid-cols-N. auto-fill: empty tracks preserved, last item doesn't stretch. auto-fit (.sf-grid--fit): empty tracks collapsed, items stretch. Override:… |
 | `.sf-grid--xl` | PUBLIC | layout | Grid (auto) | Auto-fill CSS grid with no breakpoints. .sf-grid--fit switches to auto-fit. Fixed-column variants live in .sf-grid-cols-N. auto-fill: empty tracks preserved, last item doesn't stretch. auto-fit (.sf-grid--fit): empty tracks collapsed, items stretch. Override:… |
 | `.sf-grid--xs` | PUBLIC | layout | Grid (auto) | Auto-fill CSS grid with no breakpoints. .sf-grid--fit switches to auto-fit. Fixed-column variants live in .sf-grid-cols-N. auto-fill: empty tracks preserved, last item doesn't stretch. auto-fit (.sf-grid--fit): empty tracks collapsed, items stretch. Override:… |
-| `.sf-grid-cols-1` | PUBLIC | layout | Fixed column grids (container-query responsive) | Responsive fixed-column grids with no media queries. IMPORTANT: These classes use anonymous @container queries, so they react to the nearest ancestor that has a container context (container-type: inline-size). Without a container ancestor the queries never match and the grid… |
+| `.sf-grid-cols-1` | PUBLIC | layout | Single-column grid | Plain single-column grid. No container context — it never needs CQ breakpoints (there's only one column). Use when you want consistent gap spacing without affecting container queries on child elements. |
 | `.sf-grid-cols-1-2` | PUBLIC | layout | Ratio grids | Two-column ratio grids, container-query responsive. |
 | `.sf-grid-cols-1-3` | PUBLIC | layout | Ratio grids | Two-column ratio grids, container-query responsive. |
 | `.sf-grid-cols-2` | PUBLIC | layout | Fixed column grids (container-query responsive) | Responsive fixed-column grids with no media queries. IMPORTANT: These classes use anonymous @container queries, so they react to the nearest ancestor that has a container context (container-type: inline-size). Without a container ancestor the queries never match and the grid… |