@kolkrabbi/kol-component 0.232.0 → 0.234.0

package/src/utilities/AsciiCursor.jsx

@@ -495,7 +495,7 @@ function AsciiCursorOverlay({ hideCursor }) {
 }
 
 /**
- * AsciiCursor — full-viewport decorative overlay that shadows the pointer
+ * AsciiCursor — An ASCII crosshair that follows the pointer. full-viewport decorative overlay that shadows the pointer
  * with an ASCII crosshair (diamond variant over interactive elements) and
  * layers ambient effects on top of the page: drifting cursor stars,
  * click-triggered ASCII fireworks, and a right-click Space Invader that

package/src/utilities/AssetGrid.jsx

@@ -1,5 +1,5 @@
 /**
- * AssetGrid — thin responsive N-column grid for tiling asset figures
+ * AssetGrid — A responsive grid for asset figures. thin responsive N-column grid for tiling asset figures
  * (swatches, placeholders, spec cards). Fixed 2/3/4-column layout that
  * collapses to 2 columns under the md breakpoint and to 1 column under
  * 480px, all via Tailwind responsive utilities — no CSS of its own.

package/src/utilities/ButtonGroup.jsx

@@ -1,5 +1,5 @@
 /**
- * ButtonGroup — responsive layout wrapper for a group of Buttons: stacked
+ * ButtonGroup — Lay out a group of buttons. responsive layout wrapper for a group of Buttons: stacked
  * full-width on mobile, horizontal row from `sm` up, aligned left / center /
  * right. Pure layout — children compose at the call site and render as-is
  * (nothing is cloned, no props injected); all button behavior lives on each

package/src/utilities/CropOverlay.jsx

@@ -2,7 +2,7 @@ import { useContext, useEffect, useState } from 'react'
 import { CanvasZoomContext } from '../hooks/canvasZoom.js'
 
 /**
- * CropOverlay — crop-mode chrome for a photo layer with an explicit crop
+ * CropOverlay — Crop handles over a photo layer. crop-mode chrome for a photo layer with an explicit crop
  * window ({imgX,imgY,imgW,imgH} — the image's draw rect in frame-local px).
  *
  *   • drag inside the frame  → pan the image within the frame (clamped)

package/src/utilities/CurveOverlay.jsx

@@ -81,7 +81,7 @@ function Handle({ cx, cy, role }) {
 }
 
 /**
- * CurveOverlay — SVG easing/curve visualizer laid absolutely over a frame:
+ * CurveOverlay — An easing curve drawn over a frame. SVG easing/curve visualizer laid absolutely over a frame:
  * a dashed accent curve with endpoint dots, and — in `curve="custom"`
  * mode — a two-handle cubic-bezier editor (Figma/After-Effects style)
  * with tangent lines back to the anchored endpoints.

package/src/utilities/ErrorBoundary.jsx

@@ -2,7 +2,7 @@ import { Component } from 'react'
 import Button from '../atoms/Button.jsx'
 
 /**
- * ErrorBoundary — class error boundary (boundaries can't be hooks). Catches
+ * ErrorBoundary — Catches a crash and shows a fallback. class error boundary (boundaries can't be hooks). Catches
  * render errors in its subtree and swaps in a centered full-screen fallback
  * ("Something went wrong") with two recovery actions: retry in place and go
  * home. A dev-only error/stack panel renders on Vite dev builds

package/src/utilities/ExitPreview.jsx

@@ -1,5 +1,5 @@
 /**
- * ExitPreview — the escape hatch out of a preview surface, worn as a fixed
+ * ExitPreview — A pill to leave a preview. the escape hatch out of a preview surface, worn as a fixed
  * pill. Router-AGNOSTIC by the same seam kol-shell uses for navigation: it
  * renders a plain `<a>` unless the consumer hands it its router's link.
  *

package/src/utilities/FullscreenOverlay.jsx

@@ -3,7 +3,7 @@ import { pushLayer, popLayer, isTopLayer } from './layerStack.js'
 import CloseButton from '../atoms/CloseButton.jsx'
 
 /**
- * FullscreenOverlay — the scrim + centred sheet every overlay in the repo
+ * FullscreenOverlay — The scrim and sheet every overlay wears. the scrim + centred sheet every overlay in the repo
  * wears. Owns dismissal (Escape, backdrop, close button), scroll lock and
  * stacking; the consumer supplies the panel.
  *

package/src/utilities/OverlayGlassPanel.jsx

@@ -1,5 +1,5 @@
 /**
- * OverlayGlassPanel — the KOL frosted-glass content card that floats over
+ * OverlayGlassPanel — A frosted panel over media. the KOL frosted-glass content card that floats over
  * hero/carousel media: translucent surface-primary (color-mix) + a 1px
  * backdrop blur, children stacked vertically. Extracted from 4 identical
  * inline copies in the monorepo (StudioHero, StudioAboutCard,

package/src/utilities/Popover.jsx

@@ -240,7 +240,7 @@ function TooltipOn({
 }
 
 /**
- * PopoverPanel — renders the floater into a portal with default panel chrome.
+ * PopoverPanel — A floating panel in a portal. renders the floater into a portal with default panel chrome.
  *
  * Props:
  *   popover         — the value returned from `usePopover`

package/src/utilities/ProsePreview.jsx

@@ -1,5 +1,5 @@
 /**
- * ProsePreview — a full rich-text specimen: one `.kol-prose` block exercising
+ * ProsePreview — Every long-form prose element in one view. a full rich-text specimen: one `.kol-prose` block exercising
  * every long-form element — H1–H4 ladder, section lede, body paragraph,
  * blockquote, indented passage, code block, pullout, and unordered/ordered
  * lists — so the KOL prose stylesheet can be reviewed end-to-end in one view.

package/src/utilities/TiltCard.jsx

@@ -4,7 +4,7 @@ import usePrefersReducedMotion from '../hooks/usePrefersReducedMotion.js'
 import useCoarsePointer from '../hooks/useCoarsePointer.js'
 
 /**
- * TiltCard — self-contained image card with a spring-based 3D tilt that
+ * TiltCard — An image card that tilts toward the pointer. self-contained image card with a spring-based 3D tilt that
  * follows the pointer (via the shared useTilt hook). On coarse-pointer
  * devices or when the user prefers reduced motion it renders a plain,
  * tilt-free card — no springs, no listeners.

package/src/utilities/TransparentX.jsx

@@ -1,5 +1,5 @@
 /**
- * TransparentX — diagonal stroke indicator for transparent / disabled / unused
+ * TransparentX — A slash marking an empty slot. diagonal stroke indicator for transparent / disabled / unused
  * slots. Universal "no value" affordance.
  *
  * Renders absolute-positioned to fill its parent. Parent must be `position: