@kolkrabbi/kol-component 0.104.1 → 0.104.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-component",
-  "version": "0.104.1",
+  "version": "0.104.3",
   "description": "KOL design-system components — atoms through organisms, emitting canonical kol-* classes. Pairs with @kolkrabbi/kol-theme for styling.",
   "license": "MIT",
   "type": "module",

package/src/organisms/ContentFilters.jsx

@@ -40,10 +40,11 @@ import IconFrame from '../atoms/IconFrame.jsx'
  * Look seams — all default to the shipped values, pass nothing and nothing changes:
  * @param {string}  props.titleClassName      — header title type/ink
  * @param {boolean} props.titleUppercase      — cases the title (default false)
- * @param {string}  props.labelClassName      — filter-group label type/ink
+ * @param {string}  props.labelClassName      — filter-group label type/ink (default `kol-eyebrow text-fg-96`)
  * @param {boolean} props.labelUppercase      — cases the group label (default true)
- * groups: `{ label, key, values, stack?, className?, wrapClassName? }` — columns are equal width by default;
- * `stack: true` makes a group hug its chips; `className` / `wrapClassName` are per-group seams
+ * groups: `{ label, key, values, stack?, className?, wrapClassName? }` — THE FIRST GROUP HUGS ITS CHIPS, EVERY
+ * GROUP AFTER IT FLOWS (user law 2026-08-27, by position, never by chip count); `stack` is the explicit
+ * override; `className` / `wrapClassName` are per-group seams
  * @param {string}  props.tagVariant          — filter chip variant ('primary' grey fill)
  * @param {string}  props.tagSize             — filter chip size
  * @param {string}  props.tagActiveClassName  — chip ink, selected
@@ -104,7 +105,10 @@ const ContentFilters = ({
    * titles wrap can move to `kol-mono-14` without losing the casing. */
   titleClassName = 'kol-helper-14',
   titleUppercase = true,
-  labelClassName = 'kol-helper-12 text-fg-96',
+  /* the category label is the EYEBROW role (ContentFiltersEqualColumns, what stood —
+   * kol-fxr 2026-08-27: every section / category label in the app tier is
+   * kol-eyebrow; the role carries the uppercase) */
+  labelClassName = 'kol-eyebrow text-fg-96',
   labelUppercase = true,
   tagVariant = 'primary',
   tagSize = 'sm',
@@ -242,13 +246,15 @@ const ContentFilters = ({
     </div>
   ) : null
 
-  const renderFilterGroup = (group) => {
-    /* GROUP COLUMNS ARE EQUAL by default (ContentFiltersEqualColumns, kol-fxr
-     * 2026-08-27 — "only the first column is narrow … it's content filters
-     * everywhere"); `stack: true` is the opt-in for a group that hugs its chips.
-     * The 0.101 short-group default was a per-page ruling written into the
-     * organism — reverted. */
-    const stacked = group.stack === true
+  const renderFilterGroup = (group, index = 0) => {
+    /* THE LAW (user ruling 2026-08-27, said "for the 10th time" — ContentFiltersFirstGroupHugs):
+     * THE FIRST FILTER GROUP HUGS ITS CHIPS — IT IS NARROW. EVERY GROUP AFTER IT
+     * FLOWS ACROSS THE REST OF THE ROW. By POSITION, never by chip count. The
+     * reference is kol-website /prints: CATEGORY hugs at the left, YEAR flows
+     * beside it. Not equal columns (0.104.1, a misread — reverted), not "short
+     * groups stack" (0.101, one page's ruling — reverted). `stack` stays the
+     * explicit override; kol-fxr pins `stack: i === 0`. */
+    const stacked = group.stack ?? index === 0
     return (
     <div key={group.key} className={`flex flex-col gap-3 ${stacked ? 'shrink-0' : 'min-w-0 flex-1'} ${group.className ?? ''}`.trim()}>
       {/* THE CATEGORY LABEL IS THE ACTIVE INK — `kol-helper-12` at `text-fg-96`,
@@ -261,7 +267,7 @@ const ContentFilters = ({
         * never what anyone looked at. No inline letter-spacing: the helper ramp
         * carries its own, and the override the fork added was not in the
         * rendered path either. */}
-      <h4 className={labelClassName} style={labelUppercase ? { textTransform: 'uppercase' } : undefined}>
+      <h4 className={labelClassName} style={labelUppercase && !/\bkol-eyebrow\b/.test(labelClassName) ? { textTransform: 'uppercase' } : undefined}>
         {group.label}
       </h4>
       {/* the fluid group keeps 48px of room on its right (it ran flush to the
@@ -442,7 +448,7 @@ const ContentFilters = ({
         <div className="flex items-start justify-between gap-16">
           <div className="flex min-w-0 flex-1 items-start gap-16">
             {leadingActions}
-            {isExpanded && filterGroups.map((group) => renderFilterGroup(group))}
+            {isExpanded && filterGroups.map((group, i) => renderFilterGroup(group, i))}
             {isExpanded && activeFilters.size > 0 && (
               <button
                 type="button"