@kolkrabbi/kol-component 0.109.0 → 0.111.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-component",
-  "version": "0.109.0",
+  "version": "0.111.0",
   "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/hooks/useTilt.js

@@ -3,8 +3,8 @@ import { useMotionValue, useSpring, useTransform } from 'framer-motion'
 
 /**
  * Pointer-driven 3D tilt (framer-motion springs) — the ONE tilt hook.
- * Ported from the monorepo's useBentoTiltMotion; TiltCard, BentoCard and
- * friends all compose this instead of forking their own.
+ * Ported from the monorepo's useBentoTiltMotion; the Tilt family — TiltCard,
+ * TiltBento — composes this instead of forking their own.
  *
  * Returns `{ ref, style, onMouseMove, onMouseLeave, motionValues }` —
  * spread `ref`/handlers on a `motion.div` and pass `style` to it.

package/src/index.js

@@ -116,7 +116,7 @@ export { default as Canvas, CanvasFrame, PanViewport, CANVAS_VIRTUAL_W, DEFAULT_
 export { default as EditorShell } from './utilities/EditorShell.jsx'
 export { default as GalleryCarousel } from './organisms/GalleryCarousel.jsx'
 export { default as AsciiCursor } from './utilities/AsciiCursor.jsx'
-export { default as BentoCard } from './molecules/BentoCard.jsx'
+export { default as TiltBento, default as BentoCard } from './molecules/TiltBento.jsx'
 export { default as Carousel } from './molecules/Carousel.jsx'
 /* EmblaNav — THE prev/next pair. Exported so a consumer building its own embla
  * stage reaches for it instead of re-typing the button markup, which is how the

package/src/molecules/BentoCard.jsx

@@ -1,187 +1,6 @@
-import { useEffect, useState } from 'react'
-import { motion } from 'framer-motion'
-import HlsVideo from '../atoms/HlsVideo.jsx'
-import AssetPlaceholder from '../utilities/AssetPlaceholder.jsx'
-import Button from '../atoms/Button.jsx'
-import Image from '../atoms/Image.jsx'
-import useTilt from '../hooks/useTilt.js'
-import usePrefersReducedMotion from '../hooks/usePrefersReducedMotion.js'
-
-/* taxonomy-ok: nests the same-file Media helper plus DS atoms/molecules
- * (HlsVideo, AssetPlaceholder, Button, Image) it composes — an organism. */
-
 /**
- * True on coarse-pointer (touch/no-hover) devices. Local to BentoCard, mirrors
- * TiltCard's copy; re-evaluates on device/orientation change via the
- * media-query change event (the monorepo source froze `useIsTouchDevice` in a
- * module-load const — fixed on recreate).
+ * @deprecated 2026-08-27 — `BentoCard` is `TiltBento` under its old name (the
+ * Tilt family: `TiltCard` · `TiltBento` · `useTilt`). Alias kept; drops when no
+ * repo imports it (docs/operations/01-release/04-retirements.md).
  */
-function useCoarsePointer() {
-  const [coarse, setCoarse] = useState(
-    () => typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches,
-  )
-
-  useEffect(() => {
-    const mq = window.matchMedia('(pointer: coarse)')
-    const onChange = () => setCoarse(mq.matches)
-    mq.addEventListener('change', onChange)
-    return () => mq.removeEventListener('change', onChange)
-  }, [])
-
-  return coarse
-}
-
-/**
- * Media — internal, NOT exported. Sniffs `src` by extension and renders the
- * right full-bleed media element: `.m3u8` → HlsVideo, `.mov|.mp4|.webm` →
- * autoplay <video>, any other src → the Image molecule (its own broken-asset
- * fallback), and no src → AssetPlaceholder. Positioning/fit arrive via
- * `className`; Image gets an inline height so its base `h-auto` can't beat the
- * `size-full` cover fill.
- */
-function Media({ src, poster, className }) {
-  if (!src) return <AssetPlaceholder className={className} />
-  if (/\.m3u8$/i.test(src)) return <HlsVideo src={src} poster={poster} className={className} />
-  if (/\.(mov|mp4|webm)$/i.test(src)) {
-    return (
-      <video
-        src={src}
-        poster={poster}
-        autoPlay
-        muted
-        loop
-        playsInline
-        preload="auto"
-        className={className}
-      />
-    )
-  }
-  return <Image src={src} alt="" className={className} style={{ width: '100%', height: '100%' }} />
-}
-
-/**
- * BentoCard — media hover-card for grid/bento walls. Full-bleed auto-detected
- * media (HLS / video / image / placeholder) sits behind a content stack; on a
- * fine pointer, hover reveals a darkening scrim plus subtitle / description /
- * CTA over an always-visible title. No-hover (coarse-pointer) devices show
- * everything statically and drop the media's pointer capture.
- *
- * Motion is gated: the pointer-following 3D tilt (shared `useTilt` framer
- * springs — the monorepo's forked CSS `useBentoTilt` is gone) renders only on
- * a fine pointer with motion allowed; reduced-motion, coarse pointer, or
- * `enableTilt={false}` all fall back to a static card, and reduced-motion also
- * drops the reveal's opacity transition.
- *
- * Zero CMS coupling — flat props. The CTA is a DS Button link (`<a href>`, no
- * router import): `http*`/`mailto` open a new tab; any other href is a
- * same-tab anchor whose `onNavigate(event)` seam lets an SPA intercept
- * (preventDefault + its router) — wired capture-phase so it fires before the
- * default navigation. Title/subtitle/description render exactly as authored;
- * no casing transforms (author strings in their final case at the call site).
- *
- * @param {string}    src            media source; type auto-detected by extension
- * @param {string}    poster         poster frame for HLS/video
- * @param {ReactNode} title          always-visible heading
- * @param {ReactNode} subtitle       hover-revealed line
- * @param {ReactNode} description    hover-revealed paragraph
- * @param {string}    href           CTA target; `http*`/`mailto` → new-tab anchor, else same-tab (onNavigate seam)
- * @param {Function}  onNavigate     (event) => void — same-tab CTA click seam (SPA intercept)
- * @param {ReactNode} buttonLabel    CTA label (no default — author it)
- * @param {ReactNode} bodyContent    extra content injected into the stack
- * @param {number}    overlayOpacity scrim darkness % over the media, 0 disables (default 60)
- * @param {boolean}   alignRight     right-align the card (ms-auto) vs fill (size-full)
- * @param {boolean}   enableTilt     master tilt switch (default true)
- * @param {string}    titleClassName title classes
- * @param {string}    contentClassName inner content-box classes
- * @param {string}    imageClassName media fit/position classes
- * @param {string}    contentStackClassName stack layout classes
- * @param {string}    className      extra classes on the root
- */
-export default function BentoCard({
-  src,
-  poster,
-  title,
-  subtitle,
-  description,
-  href,
-  onNavigate,
-  buttonLabel,
-  bodyContent = null,
-  overlayOpacity = 60,
-  alignRight = false,
-  enableTilt = true,
-  titleClassName = 'kol-sans-heading-01 text-absolute-white',
-  contentClassName = 'max-w-[384px]',
-  imageClassName = 'object-cover object-center',
-  contentStackClassName = 'relative z-20 h-full flex flex-col justify-start items-start gap-4 p-6 md:p-8',
-  className = '',
-  ...rest
-}) {
-  const reduced = usePrefersReducedMotion()
-  const coarse = useCoarsePointer()
-  const tilt = useTilt()
-
-  const tiltOff = !enableTilt || reduced || coarse
-  const Component = tiltOff ? 'div' : motion.div
-  const rootStyle = {
-    ...(tiltOff ? {} : tilt.style),
-    backfaceVisibility: 'hidden',
-    WebkitBackfaceVisibility: 'hidden',
-  }
-  const tiltHandlers = tiltOff
-    ? {}
-    : { ref: tilt.ref, onMouseMove: tilt.onMouseMove, onMouseLeave: tilt.onMouseLeave }
-
-  // Reveal choreography. Coarse (no-hover) devices show everything statically;
-  // fine pointers reveal on group-hover. The opacity transition is motion, so
-  // reduced-motion drops it (content still reveals, just without the fade).
-  const fade = reduced ? '' : 'transition-opacity duration-300'
-  const revealClass = `${coarse ? 'opacity-100' : 'opacity-0 group-hover:opacity-100'} ${fade}`.trim()
-
-  const mediaClass =
-    `absolute left-0 top-0 size-full rounded overflow-hidden ${imageClassName} ${coarse ? 'pointer-events-none' : ''}`.trim()
-
-  const isExternal = href && (href.startsWith('http') || href.startsWith('mailto'))
-
-  return (
-    <Component
-      className={`relative group ${alignRight ? 'ms-auto' : 'size-full'} ${className}`.trim()}
-      {...tiltHandlers}
-      {...rest}
-      style={{ ...rootStyle, ...rest.style }}
-    >
-      <Media src={src} poster={poster} className={mediaClass} />
-
-      <div className="relative z-10 flex size-full h-full flex-col justify-start items-start text-auto">
-        <div className={`relative z-10 ${contentClassName} w-full h-full self-stretch`}>
-          {overlayOpacity > 0 && (
-            <div
-              className={`absolute -inset-1 rounded ${coarse ? 'opacity-60' : 'opacity-0 group-hover:opacity-100'} ${fade} pointer-events-none`.trim()}
-              style={{ backgroundColor: `rgba(0, 0, 0, ${overlayOpacity / 100})` }}
-            />
-          )}
-          <div className={contentStackClassName}>
-            {title && <h3 className={titleClassName}>{title}</h3>}
-            {subtitle && <p className={`kol-mono-text text-absolute-white ${revealClass}`}>{subtitle}</p>}
-            {description && <p className={`kol-mono-12 text-absolute-white pb-6 ${revealClass}`}>{description}</p>}
-            {bodyContent}
-            {href && (
-              <div className={revealClass}>
-                <Button
-                  href={href}
-                  variant="primary"
-                  size="sm"
-                  {...(isExternal
-                    ? { target: '_blank', rel: 'noreferrer noopener' }
-                    : { onClickCapture: onNavigate })}
-                >
-                  {buttonLabel}
-                </Button>
-              </div>
-            )}
-          </div>
-        </div>
-      </div>
-    </Component>
-  )
-}
+export { default } from './TiltBento.jsx'

package/src/molecules/ContentMedia.jsx

@@ -78,8 +78,12 @@ const FIT = {
   /* a consumer WRAPPER div fills the frame as an img/video does (ColumnBrowser round, 2026-08-27 — kol-r2b2's wrapped thumb fell back to the image's intrinsic size) */
   cover:   '[&>img]:h-full [&>img]:w-full [&>img]:object-cover [&>video]:h-full [&>video]:w-full [&>video]:object-cover [&>div]:h-full [&>div]:w-full',
   /* GridCard's previewFit, verbatim: `img { max-width: none; transform: scale(.5 | .3); transform-origin: top left }` */
-  natural: '[&>img]:max-w-none [&>img]:scale-50 [&>img]:origin-top-left',
-  compact: '[&>img]:max-w-none [&>img]:scale-[.3] [&>img]:origin-top-left',
+  /* the ANCHOR is the consumer's (ContentMediaFocusBinding, kol-monitor 2026-08-27 — user: "make it
+   * so that the focus can be set per repo"): `--kol-media-focus`, bound once on a consumer's :root,
+   * pins the fit AND the hover zoom (kol-theme `.kol-media-zoom`, same token) — the two share
+   * `transform-origin`. Unset = today's values: top left here, center on the zoom. */
+  natural: '[&>img]:max-w-none [&>img]:scale-50 [&>img]:origin-[var(--kol-media-focus,top_left)]',
+  compact: '[&>img]:max-w-none [&>img]:scale-[.3] [&>img]:origin-[var(--kol-media-focus,top_left)]',
 }
 
 /* the fade: the child <img> is cloned with loading="lazy" and `kol-media-fade`,

package/src/molecules/TiltBento.jsx

@@ -0,0 +1,191 @@
+import { useEffect, useState } from 'react'
+import { motion } from 'framer-motion'
+import HlsVideo from '../atoms/HlsVideo.jsx'
+import AssetPlaceholder from '../utilities/AssetPlaceholder.jsx'
+import Button from '../atoms/Button.jsx'
+import Image from '../atoms/Image.jsx'
+import useTilt from '../hooks/useTilt.js'
+import usePrefersReducedMotion from '../hooks/usePrefersReducedMotion.js'
+
+/* taxonomy-ok: nests the same-file Media helper plus DS atoms/molecules
+ * (HlsVideo, AssetPlaceholder, Button, Image) it composes — an organism. */
+
+/**
+ * True on coarse-pointer (touch/no-hover) devices. Local to TiltBento, mirrors
+ * TiltCard's copy; re-evaluates on device/orientation change via the
+ * media-query change event (the monorepo source froze `useIsTouchDevice` in a
+ * module-load const — fixed on recreate).
+ */
+function useCoarsePointer() {
+  const [coarse, setCoarse] = useState(
+    () => typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches,
+  )
+
+  useEffect(() => {
+    const mq = window.matchMedia('(pointer: coarse)')
+    const onChange = () => setCoarse(mq.matches)
+    mq.addEventListener('change', onChange)
+    return () => mq.removeEventListener('change', onChange)
+  }, [])
+
+  return coarse
+}
+
+/**
+ * Media — internal, NOT exported. Sniffs `src` by extension and renders the
+ * right full-bleed media element: `.m3u8` → HlsVideo, `.mov|.mp4|.webm` →
+ * autoplay <video>, any other src → the Image molecule (its own broken-asset
+ * fallback), and no src → AssetPlaceholder. Positioning/fit arrive via
+ * `className`; Image gets an inline height so its base `h-auto` can't beat the
+ * `size-full` cover fill.
+ */
+function Media({ src, poster, className }) {
+  if (!src) return <AssetPlaceholder className={className} />
+  if (/\.m3u8$/i.test(src)) return <HlsVideo src={src} poster={poster} className={className} />
+  if (/\.(mov|mp4|webm)$/i.test(src)) {
+    return (
+      <video
+        src={src}
+        poster={poster}
+        autoPlay
+        muted
+        loop
+        playsInline
+        preload="auto"
+        className={className}
+      />
+    )
+  }
+  return <Image src={src} alt="" className={className} style={{ width: '100%', height: '100%' }} />
+}
+
+/**
+ * TiltBento — media hover-card for grid/bento walls, the Tilt family's composed
+ * tile (was `BentoCard` until 2026-08-27, user ruling: the three tilting things
+ * in the estate are ONE prefix family — `TiltCard` the bare frame, `TiltBento`
+ * this tile, `useTilt` the one hook; `BentoCard` is the alias on the retirement
+ * ledger). Full-bleed auto-detected
+ * media (HLS / video / image / placeholder) sits behind a content stack; on a
+ * fine pointer, hover reveals a darkening scrim plus subtitle / description /
+ * CTA over an always-visible title. No-hover (coarse-pointer) devices show
+ * everything statically and drop the media's pointer capture.
+ *
+ * Motion is gated: the pointer-following 3D tilt (shared `useTilt` framer
+ * springs — the monorepo's forked CSS `useBentoTilt` is gone) renders only on
+ * a fine pointer with motion allowed; reduced-motion, coarse pointer, or
+ * `enableTilt={false}` all fall back to a static card, and reduced-motion also
+ * drops the reveal's opacity transition.
+ *
+ * Zero CMS coupling — flat props. The CTA is a DS Button link (`<a href>`, no
+ * router import): `http*`/`mailto` open a new tab; any other href is a
+ * same-tab anchor whose `onNavigate(event)` seam lets an SPA intercept
+ * (preventDefault + its router) — wired capture-phase so it fires before the
+ * default navigation. Title/subtitle/description render exactly as authored;
+ * no casing transforms (author strings in their final case at the call site).
+ *
+ * @param {string}    src            media source; type auto-detected by extension
+ * @param {string}    poster         poster frame for HLS/video
+ * @param {ReactNode} title          always-visible heading
+ * @param {ReactNode} subtitle       hover-revealed line
+ * @param {ReactNode} description    hover-revealed paragraph
+ * @param {string}    href           CTA target; `http*`/`mailto` → new-tab anchor, else same-tab (onNavigate seam)
+ * @param {Function}  onNavigate     (event) => void — same-tab CTA click seam (SPA intercept)
+ * @param {ReactNode} buttonLabel    CTA label (no default — author it)
+ * @param {ReactNode} bodyContent    extra content injected into the stack
+ * @param {number}    overlayOpacity scrim darkness % over the media, 0 disables (default 60)
+ * @param {boolean}   alignRight     right-align the card (ms-auto) vs fill (size-full)
+ * @param {boolean}   enableTilt     master tilt switch (default true)
+ * @param {string}    titleClassName title classes
+ * @param {string}    contentClassName inner content-box classes
+ * @param {string}    imageClassName media fit/position classes
+ * @param {string}    contentStackClassName stack layout classes
+ * @param {string}    className      extra classes on the root
+ */
+export default function TiltBento({
+  src,
+  poster,
+  title,
+  subtitle,
+  description,
+  href,
+  onNavigate,
+  buttonLabel,
+  bodyContent = null,
+  overlayOpacity = 60,
+  alignRight = false,
+  enableTilt = true,
+  titleClassName = 'kol-sans-heading-01 text-absolute-white',
+  contentClassName = 'max-w-[384px]',
+  imageClassName = 'object-cover object-center',
+  contentStackClassName = 'relative z-20 h-full flex flex-col justify-start items-start gap-4 p-6 md:p-8',
+  className = '',
+  ...rest
+}) {
+  const reduced = usePrefersReducedMotion()
+  const coarse = useCoarsePointer()
+  const tilt = useTilt()
+
+  const tiltOff = !enableTilt || reduced || coarse
+  const Component = tiltOff ? 'div' : motion.div
+  const rootStyle = {
+    ...(tiltOff ? {} : tilt.style),
+    backfaceVisibility: 'hidden',
+    WebkitBackfaceVisibility: 'hidden',
+  }
+  const tiltHandlers = tiltOff
+    ? {}
+    : { ref: tilt.ref, onMouseMove: tilt.onMouseMove, onMouseLeave: tilt.onMouseLeave }
+
+  // Reveal choreography. Coarse (no-hover) devices show everything statically;
+  // fine pointers reveal on group-hover. The opacity transition is motion, so
+  // reduced-motion drops it (content still reveals, just without the fade).
+  const fade = reduced ? '' : 'transition-opacity duration-300'
+  const revealClass = `${coarse ? 'opacity-100' : 'opacity-0 group-hover:opacity-100'} ${fade}`.trim()
+
+  const mediaClass =
+    `absolute left-0 top-0 size-full rounded overflow-hidden ${imageClassName} ${coarse ? 'pointer-events-none' : ''}`.trim()
+
+  const isExternal = href && (href.startsWith('http') || href.startsWith('mailto'))
+
+  return (
+    <Component
+      className={`relative group ${alignRight ? 'ms-auto' : 'size-full'} ${className}`.trim()}
+      {...tiltHandlers}
+      {...rest}
+      style={{ ...rootStyle, ...rest.style }}
+    >
+      <Media src={src} poster={poster} className={mediaClass} />
+
+      <div className="relative z-10 flex size-full h-full flex-col justify-start items-start text-auto">
+        <div className={`relative z-10 ${contentClassName} w-full h-full self-stretch`}>
+          {overlayOpacity > 0 && (
+            <div
+              className={`absolute -inset-1 rounded ${coarse ? 'opacity-60' : 'opacity-0 group-hover:opacity-100'} ${fade} pointer-events-none`.trim()}
+              style={{ backgroundColor: `rgba(0, 0, 0, ${overlayOpacity / 100})` }}
+            />
+          )}
+          <div className={contentStackClassName}>
+            {title && <h3 className={titleClassName}>{title}</h3>}
+            {subtitle && <p className={`kol-mono-text text-absolute-white ${revealClass}`}>{subtitle}</p>}
+            {description && <p className={`kol-mono-12 text-absolute-white pb-6 ${revealClass}`}>{description}</p>}
+            {bodyContent}
+            {href && (
+              <div className={revealClass}>
+                <Button
+                  href={href}
+                  variant="primary"
+                  size="sm"
+                  {...(isExternal
+                    ? { target: '_blank', rel: 'noreferrer noopener' }
+                    : { onClickCapture: onNavigate })}
+                >
+                  {buttonLabel}
+                </Button>
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+    </Component>
+  )
+}

package/src/organisms/ContentFilters.jsx

@@ -42,8 +42,10 @@ import IconFrame from '../atoms/IconFrame.jsx'
  * @param {boolean} props.titleUppercase      — cases the title (default false)
  * @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? }` — 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
+ * groups: `{ label, key, values, stack?, className?, wrapClassName? }` — THE FIRST GROUP IS ONE CATALOG COLUMN
+ * WIDE (`(row − 120px) / 6`, the `1fr` of `repeat(6, 1fr)` gap 24 — a fraction, never a px; `.kol-filters-first`,
+ * kol-theme ≥0.73.0), EVERY GROUP AFTER IT FLOWS (user law 2026-08-27, by position, never by chip count —
+ * the hug's width overruled the same day: "nope not hug, fix a size"); `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
@@ -247,16 +249,22 @@ const ContentFilters = ({
   ) : null
 
   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`. */
+    /* THE LAW (user ruling 2026-08-27, said "for the 10th time" — ContentFiltersFirstGroupHugs,
+     * its WIDTH overruled the same day — ContentFiltersFirstGroupFixedWidth, kol-monitor: "nope
+     * not hug, fix a size … if columns, maybe just use one?"): THE FIRST FILTER GROUP IS ONE
+     * CATALOG COLUMN WIDE — `.kol-filters-first` (kol-theme): `(100cqw − 120px) / 6`, the `1fr`
+     * of the catalog's `repeat(6, 1fr)` gap 24, measured on the header row as a container so
+     * the count/strip beside the groups never narrows it. It sits over the first card; EVERY
+     * GROUP AFTER IT FLOWS across the rest of the row, starting over the second. By POSITION,
+     * never by chip count. A page without a 6-column catalog gets the same fraction of its row.
+     * Not a hug (0.104.3 — the column was 78px on one surface and 92 on the next), not equal
+     * columns (0.104.1), not "short groups stack" (0.101). `stack` stays the explicit override
+     * (`stack: false` on the first makes it flow); `group.className` still wins on width — the
+     * rule sits in the components layer. */
     const stacked = group.stack ?? index === 0
+    const first = index === 0 && stacked
     return (
-    <div key={group.key} className={`flex flex-col gap-3 ${stacked ? 'shrink-0' : 'min-w-0 flex-1'} ${group.className ?? ''}`.trim()}>
+    <div key={group.key} className={`flex flex-col gap-3 ${first ? 'kol-filters-first' : 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`,
         * the same full opacity a SELECTED layout item wears (user ruling
         * 2026-08-15: "TAGS and other categories are ACTIVE state full opacity").
@@ -445,7 +453,7 @@ const ContentFilters = ({
         * the whole row on `isExpanded` hid the strip until you opened filters,
         * which is not a state anyone would guess at. */}
       {(isExpanded || (layoutPlacement === 'below' && layoutStrip) || leadingActions || belowActions) && (
-        <div className="flex items-start justify-between gap-16">
+        <div className="kol-filters-row flex items-start justify-between gap-16">
           <div className="flex min-w-0 flex-1 items-start gap-16">
             {leadingActions}
             {isExpanded && filterGroups.map((group, i) => renderFilterGroup(group, i))}