@kolkrabbi/kol-component 0.164.0 → 0.165.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kolkrabbi/kol-component",
3
- "version": "0.164.0",
3
+ "version": "0.165.0",
4
4
  "description": "KOL design-system components — atoms through organisms, emitting canonical kol-* classes. Pairs with @kolkrabbi/kol-theme for styling.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -94,11 +94,15 @@ const COL_ICON = { image: 'image', video: 'video', audio: 'file', playlist: 'vid
94
94
 
95
95
  /* ColumnBrowserChromeCorrections (kol-r2b2 2026-08-28, four user rulings measured live on admin.):
96
96
  * every column keeps its right edge, the last included — without it the browser reads as an
97
- * open-sided container when the columns do not fill the box (Finder closes it); a column's ONLY
98
- * row keeps its bottom hairline (`only:`) its last row is also its first, and a missing
99
- * hairline beside neighbours that show one reads as a defect; and ONE ink for folders and files
100
- * the `bg-fg-04` fill alone marks selection ("why is folder full opacity but not files?").
101
- * `muted` stays a prop for other callers; the file rows no longer pass it.
97
+ * open-sided container when the columns do not fill the box (Finder closes it); and ONE ink for
98
+ * folders and files the fill alone marks selection ("why is folder full opacity but not
99
+ * files?"). `muted` stays a prop for other callers; the file rows no longer pass it.
100
+ * NO ROW DIVIDERS (BrowsePageRulingsAndSeams, kol-r2b2 2026-09-02): the `border-b last:border-b-0
101
+ * only:border-b` utilities and their inline `borderColor` are gone. The row is a PILL now — a
102
+ * constant 4px inset on every row so selecting never shifts the layout, radius-sm on the fill —
103
+ * and a hairline under a rounded pill draws the box the pill is trying not to be. The shape lives
104
+ * in kol-components-molecules.css with the fill, not as utilities racing it (ARCHITECTURE §5);
105
+ * this supersedes the `only:` hairline half of the 08-28 corrections, by the same repo's ruling.
102
106
  * STATE CLASSES (ColumnBrowserSeams, kol-r2b2 2026-08-28): `is-selected` / `is-cursor` on the row,
103
107
  * and the fill LIVES IN THE THEME now (kol-components-molecules.css) instead of a `bg-fg-04`
104
108
  * utility — the only hook a consumer had for "selected" was that utility, and a restyle that
@@ -111,11 +115,10 @@ function Row({ icon, label, active, cursor = false, trailing, onClick, muted = f
111
115
  /* Row metrics are the DS Table's (kol-components-organisms.css .kol-table-cell-*):
112
116
  * 12px 16px padding, mono 12, an oq-08 hairline between rows, none after the last. */
113
117
  /* `cursor` = the keyboard row, drawn with the hover fill so ↑/↓ always shows where you are. */
114
- className={`kol-column-browser-row flex items-center gap-2 px-4 py-3 border-b last:border-b-0 only:border-b cursor-pointer transition-colors${
118
+ className={`kol-column-browser-row flex items-center gap-2 px-4 py-3 cursor-pointer transition-colors${
115
119
  active ? ' is-selected' : ''}${cursor ? ' is-cursor' : ''} ${
116
120
  active || cursor || !muted ? 'text-fg-default' : 'text-fg-48'
117
121
  }`}
118
- style={{ borderColor: 'var(--kol-oq-08)' }}
119
122
  onClick={onClick}
120
123
  >
121
124
  <span className="w-5 shrink-0 flex items-center justify-center text-fg-48">
@@ -223,13 +223,13 @@ function MediaInspector({ files, index, onClose, onPrev, onNext, mediaUrl, downl
223
223
  /* Display settings for the ACTIVE bucket — kol-r2b2's drawer wiring on the DS
224
224
  * organism (the composition the user locked 2026-08-27). Every control sets a
225
225
  * default, never a gate. */
226
- function MediaSettings({ bucketMeta, settings, onChange, onReset, onClose, profile }) {
226
+ function MediaSettings({ bucketMeta, settings, onChange, onReset, onClose, profile, settingsFooter }) {
227
227
  const set = (patch) => onChange({ ...settings, ...patch })
228
228
  const toggleKind = (k) => set({ kinds: settings.kinds.includes(k) ? settings.kinds.filter((x) => x !== k) : [...settings.kinds, k] })
229
229
  const noVariants = profile.variantSets === 0
230
230
  const noSegments = profile.segments === 0
231
231
  return (
232
- <SettingsPanel variant="drawer" title="Display settings" onClose={onClose} footer={<SettingsFooter onReset={onReset} />}>
232
+ <SettingsPanel variant="drawer" title="Display settings" onClose={onClose} footer={<SettingsFooter onReset={onReset}>{settingsFooter}</SettingsFooter>}>
233
233
  <LabeledControlSection label="Structure" rowGap={1} divided>
234
234
  <SettingsRow label="Columns" hint="Finder-style columns instead of folder rows">
235
235
  <SettingsSwitch label="Columns" on={(settings.folderView ?? 'rows') === 'columns'} onChange={(v) => set({ folderView: v ? 'columns' : 'rows' })} />
@@ -299,7 +299,7 @@ const profileOf = (objects, rawFiles, systemCount) => ({
299
299
  /* ══ BROWSE — folder / files ═══════════════════════════════════════════════ */
300
300
  export function MediaLibraryBrowse({
301
301
  client, title = 'MEDIA', bucket, onBucketChange, prefix: prefixProp, onPrefix, defaults, settings: settingsProp, onSettingsChange,
302
- folderTree, headerActions, refreshKey, onOpen, autoFocus = false, className = '',
302
+ folderTree, headerActions, refreshKey, onOpen, autoFocus = false, settingsFooter, className = '',
303
303
  }) {
304
304
  const [ownPrefix, setOwnPrefix] = useState('')
305
305
  const prefix = prefixProp ?? ownPrefix
@@ -399,7 +399,7 @@ export function MediaLibraryBrowse({
399
399
  onNext={() => setQuickLook((q) => ({ ...q, index: (q.index + 1) % q.files.length }))} />
400
400
  )}
401
401
  {settingsOpen && (
402
- <MediaSettings bucketMeta={bucketMeta} settings={settings} profile={profile} onChange={setSettings} onReset={() => setSettings(null)} onClose={() => setSettingsOpen(false)} />
402
+ <MediaSettings bucketMeta={bucketMeta} settings={settings} profile={profile} onChange={setSettings} onReset={() => setSettings(null)} onClose={() => setSettingsOpen(false)} settingsFooter={settingsFooter} />
403
403
  )}
404
404
 
405
405
  {folderView === 'columns' ? (
@@ -468,7 +468,7 @@ export function MediaLibraryBrowse({
468
468
  /* ══ LIBRARY — the content-filters wall ═══════════════════════════════════ */
469
469
  export function MediaLibraryLibrary({
470
470
  client, title = 'MEDIA', bucket, onBucketChange, prefix = '', defaults, settings: settingsProp, onSettingsChange,
471
- headerActions, refreshKey, header = true, stats = true, className = '',
471
+ headerActions, refreshKey, header = true, stats = true, settingsFooter, className = '',
472
472
  }) {
473
473
  const [ownBucket, setOwnBucket] = useState(bucket)
474
474
  const bucketId = bucket ?? ownBucket
@@ -633,7 +633,7 @@ export function MediaLibraryLibrary({
633
633
  onBucket={(v) => { if (v === 'all') return; if (bucket == null) setOwnBucket(v); onBucketChange?.(v) }} onSettings={() => setSettingsOpen(true)} />
634
634
  )}
635
635
  {settingsOpen && (
636
- <MediaSettings bucketMeta={bucketMeta} settings={settings} profile={profile} onChange={setSettings} onReset={() => setSettings(null)} onClose={() => setSettingsOpen(false)} />
636
+ <MediaSettings bucketMeta={bucketMeta} settings={settings} profile={profile} onChange={setSettings} onReset={() => setSettings(null)} onClose={() => setSettingsOpen(false)} settingsFooter={settingsFooter} />
637
637
  )}
638
638
 
639
639
  {/* `stats={false}` (ColumnBrowserSeams, kol-r2b2 2026-08-28) — beside `header={false}`: a browse
@@ -238,12 +238,23 @@ export function SettingsChipRow({ options = [], selected = [], onToggle, allChip
238
238
 
239
239
  /** SettingsFooter — a Divider, then one `IconFrame refresh` (primary · sm) at the
240
240
  * right = reset to defaults (SettingsPanelApproved, 2026-08-27). No status word,
241
- * no text button. `customised` is accepted for compatibility and unused. */
242
- export function SettingsFooter({ onReset, resetLabel = 'Reset to defaults' }) {
241
+ * no text button. `customised` is accepted for compatibility and unused.
242
+ *
243
+ * `children` ride the SAME row, before reset (BrowsePageRulingsAndSeams,
244
+ * kol-r2b2 2026-09-02): a consumer wanting one more control in that footer had
245
+ * no way in, so kol-r2b2 ran a `MutationObserver` on `document.body` watching
246
+ * for `[aria-label="Reset to defaults"]` and portalled a theme chip into its
247
+ * parent — a copy string in a `querySelector`, watching the whole document, to
248
+ * place one button. The slot is the seam that ends it.
249
+ *
250
+ * `gap-2` on the row (user 2026-08-28): `flex justify-end` with no gap is right
251
+ * for one control and wrong for two — the chip and the reset icon touched. */
252
+ export function SettingsFooter({ onReset, resetLabel = 'Reset to defaults', children }) {
243
253
  return (
244
254
  <div className="flex flex-col gap-4">
245
255
  <Divider />
246
- <div className="flex justify-end">
256
+ <div className="flex justify-end items-center gap-2">
257
+ {children}
247
258
  {onReset && <IconFrame name="refresh" variant="primary" size="sm" onClick={onReset} title={resetLabel} aria-label={resetLabel} />}
248
259
  </div>
249
260
  </div>