@kolkrabbi/kol-component 0.227.0 → 0.229.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-component",
-  "version": "0.227.0",
+  "version": "0.229.0",
   "description": "KOL design-system components — atoms through organisms, emitting canonical kol-* classes. Pairs with @kolkrabbi/kol-theme for styling.",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,9 @@
     "@floating-ui/react": "^0.27.19",
     "embla-carousel-react": "^8.6.0",
     "pdfjs-dist": "^6.3.289",
-    "react-syntax-highlighter": "^16.1.1"
+    "react-syntax-highlighter": "^16.1.1",
+    "@kolkrabbi/kol-markdown": "^0.1.1",
+    "@kolkrabbi/kol-search": "^0.2.0"
   },
   "peerDependencies": {
     "@kolkrabbi/kol-icons": ">=0.22.0",

package/src/atoms/Button.jsx

@@ -81,8 +81,14 @@ const Button = ({
    * grey) or its own bundle (nav · danger · accent); `nav` is ghost's chrome
    * rung, oq-80 ink + aria-current — it had lived in the theme with no
    * component able to emit it, the direct cause of the four-container header. */
+  /* An UNKNOWN variant is a typo, not a request for the inverted fill — it fell back to
+   * `kol-btn-secondary` (the text colour as fill) until 2026-09-29, so a misspelt variant
+   * shipped inverted. It now stamps nothing, like an unset variant: the wrapper's tone,
+   * else primary — and says so in dev. */
   const KNOWN = ['primary', 'secondary', 'accent', 'outline', 'ghost', 'nav', 'danger', 'grey']
-  const variantClass = !resolvedVariant ? '' : KNOWN.includes(resolvedVariant) ? `kol-btn-${resolvedVariant}` : 'kol-btn-secondary'
+  const known = !resolvedVariant || KNOWN.includes(resolvedVariant)
+  if (!known && import.meta.env.DEV) console.warn(`Button: unknown variant "${resolvedVariant}" — rendering the inherited tone (primary)`)
+  const variantClass = resolvedVariant && known ? `kol-btn-${resolvedVariant}` : ''
 
   // Add size class — pairs the padding rule with its mono type class.
   const sizeClass = size === 'sm'

package/src/atoms/Input.jsx

@@ -158,8 +158,9 @@ export default function Input({
    * or <label> at the same kol-mono-N — Chromium computes input height
    * from the font's ascender+descender (font-metric), not strictly from
    * CSS line-height. Result: kol-control-sm ends up 26.5px instead of 26.
-   * h-4 / h-[18px] / h-[22px] match the kol-mono-12 / -14 / -16 line-heights. */
-  const heightCls = size === 'xs' ? 'h-3' : size === 'sm' ? 'h-4' : size === 'md' ? 'h-[18px]' : 'h-[22px]'
+   * h-4 / h-[18px] / h-[22px] match the kol-mono-12 / -14 / -16 line-heights; on touch every size is
+   * the 16 / 22 rung (D5, 2026-09-29 — see SearchInput) */
+  const heightCls = `${size === 'xs' ? 'h-3' : size === 'sm' ? 'h-4' : size === 'md' ? 'h-[18px]' : 'h-[22px]'} pointer-coarse:h-[22px]`
 
   const inputCls = [
     'min-w-0 bg-transparent border-none outline-none text-auto',

package/src/index.js

@@ -116,6 +116,8 @@ export { default as PropertyInput } from './molecules/PropertyInput.jsx'
 export { default as ShapeDropdown } from './molecules/ShapeDropdown.jsx'
 export { default as ShellDrawer } from './molecules/ShellDrawer.jsx'
 export { default as ShellSearchOverlay } from './organisms/ShellSearchOverlay.jsx'
+/* the keymap sheet — moved in from kol-shell 2026-09-28 so the workshop shell and the apps open ONE sheet on S */
+export { default as ShortcutsOverlay } from './organisms/ShortcutsOverlay.jsx'
 export { default as Slider } from './molecules/Slider.jsx'
 export { default as SpecList } from './molecules/SpecList.jsx'
 export { default as SpectrumControls, HueStrip, SBSquare, WheelTriangle } from './organisms/SpectrumControls.jsx'
@@ -150,6 +152,7 @@ export { default as EmblaNav } from './molecules/EmblaNav.jsx'
 export { default as MobileTabBar, TABBAR_H } from './molecules/MobileTabBar.jsx'
 export { default as ContentFilters } from './organisms/ContentFilters.jsx'
 export { default as PageHeader } from './molecules/PageHeader.jsx'
+export { MastheadContext, MASTHEADS, useMasthead, mastheadTitleClass } from './utilities/masthead.js'
 export { default as ErrorBoundary } from './utilities/ErrorBoundary.jsx'
 export { default as FeatureSplit } from './organisms/FeatureSplit.jsx'
 export { default as FeaturedCarousel } from './organisms/FeaturedCarousel.jsx'
@@ -188,7 +191,7 @@ export { default as RowMenuButton } from './molecules/RowMenuButton.jsx'
 export { default as DocPage } from './molecules/DocPage.jsx'
 export { default as DocFrontmatter } from './molecules/DocFrontmatter.jsx'
 export { default as ProfileCard } from './molecules/ProfileCard.jsx'
-export { parseFrontmatter, splitFrontmatter, joinFrontmatter } from './utilities/frontmatter.js'
+export { parseFrontmatter, splitFrontmatter, joinFrontmatter } from '@kolkrabbi/kol-markdown'
 export { readDraft, writeDraft, clearDraft, listDrafts, moveDrafts, DRAFTS_EVENT } from './utilities/localDrafts.js'
 export { readCover } from './utilities/id3.js'
 export { kindOf, extOf, isSystemFile, KINDS, KIND_LABEL, DEFAULT_KINDS, isSegment, groupSegments, groupVariants, posterFor, partition } from './utilities/mediaKinds.js'

package/src/molecules/KindPreview.jsx

@@ -7,7 +7,7 @@ import FileIcon from '../atoms/FileIcon.jsx'
 import PdfPage, { PdfDocument } from './PdfPage.jsx'
 import { kindOf as defaultKindOf, extOf as defaultExtOf, KIND_LABEL } from '../utilities/mediaKinds.js'
 import markdownToHtml from '../utilities/markdownToHtml.js'
-import { parseFrontmatter } from '../utilities/frontmatter.js'
+import { parseFrontmatter } from '@kolkrabbi/kol-markdown'
 import DocPage from './DocPage.jsx'
 
 /* taxonomy-ok: molecule — nests the DS media atoms + CodeBlock (relative). */

package/src/molecules/LabeledControl.jsx

@@ -48,19 +48,22 @@ export default function LabeledControl({
     /* `'auto'`: the label is the yielding cell — flex-1, truncating — and the
      * control hugs. The control still carries min-w-0 + overflow-hidden so a
      * combo wider than the whole column CLIPS at the column edge rather than
-     * painting over the neighbour (the invariant: no cell outside its column). */
+     * painting over the neighbour (the invariant: no cell outside its column).
+     * BELOW `sm` IT STACKS (apps review, 2026-09-29): the yielding label yielded to
+     * nothing on a phone — a sentence-long combo took the whole row and the label
+     * showed as "C" or not at all. Label on its line, the value under it. */
     const labelAuto = labelWidth === 'auto'
     return (
-      <div className={`flex items-center gap-3 ${className}`}>
+      <div className={`flex ${labelAuto ? 'flex-col items-start gap-1 sm:flex-row sm:items-center sm:gap-3' : 'items-center gap-3'} ${className}`}>
         {showLabel && (
           <span
-            className={`kol-helper-10 tracking-widest text-meta ${labelAuto ? 'flex-1 min-w-0 truncate' : 'shrink-0'}`}
+            className={`kol-helper-10 tracking-widest text-meta ${labelAuto ? 'max-w-full min-w-0 truncate sm:flex-1' : 'shrink-0'}`}
             style={labelAuto ? undefined : { width: labelWidth }}
           >
             {labelInner}
           </span>
         )}
-        <div className={labelAuto ? 'min-w-0 overflow-hidden' : 'flex-1 min-w-0'}>{children}</div>
+        <div className={labelAuto ? 'min-w-0 max-w-full sm:overflow-hidden' : 'flex-1 min-w-0'}>{children}</div>
       </div>
     )
   }

package/src/molecules/MenuItem.jsx

@@ -19,6 +19,9 @@ import { PopoverPanel, usePopover } from '../utilities/Popover.jsx'
  * `Dropdown` molecule instead — MenuItem is for action menus / popovers
  * that hold arbitrary children.
  */
+/* the ladder's tokens, so the touch rung (D5, 2026-09-29) grows the trigger with its row */
+const TRIGGER_H = { xs: 'var(--kol-ctl-xs)', sm: 'var(--kol-ctl-sm)', md: 'var(--kol-ctl-md)', lg: 'var(--kol-ctl-lg)' }
+
 export function MenuItem({
   label,
   children,
@@ -33,6 +36,10 @@ export function MenuItem({
    * an affordance; neither reference draws one (ColumnBrowserMobileViews item
    * 15, kol-r2b2 2026-09-04). Default keeps every existing call-site. */
   caret = true,
+  /* THE TRIGGER IS ON THE LADDER (apps review 2026-09-29). It was a fixed `h-8` — 32px whatever sat
+   * beside it, so media's phone `···` stood 32 next to a 26 `sm` search field. `size` pins it to the
+   * control heights (01-foundations/09-sizes: 22 · 26 · 32 · 40); `md` is the 32 it always was. */
+  size = 'md',
 }) {
   const [open, setOpen] = useState(defaultOpen)
   const popover = usePopover({
@@ -51,7 +58,8 @@ export function MenuItem({
         ref={popover.refs.setReference}
         {...popover.getReferenceProps()}
         type="button"
-        className={`kol-menu-btn kol-helper-12 px-3 h-8 inline-flex items-center gap-2 rounded text-body hover:text-emphasis transition-colors ${buttonClassName}`}
+        className={`kol-menu-btn kol-helper-12 px-3 inline-flex items-center gap-2 rounded text-body hover:text-emphasis transition-colors ${buttonClassName}`}
+        style={{ height: TRIGGER_H[size] ?? TRIGGER_H.md }}
       >
         <span>{label}</span>
         {caret && (

package/src/molecules/Modal.jsx

@@ -119,7 +119,7 @@ function ModalView({ state, closeWith }) {
           />
         )}
         <div className="flex gap-2 justify-end">
-          {state.kind !== 'alert' && <Button variant="secondary" size="sm" onClick={cancel}>{state.cancelLabel ?? 'Cancel'}</Button>}
+          {state.kind !== 'alert' && <Button size="sm" onClick={cancel}>{state.cancelLabel ?? 'Cancel'}</Button>}
           <Button variant="primary"   size="sm" onClick={submit}>{state.okLabel ?? 'OK'}</Button>
         </div>
       </div>

package/src/molecules/PageHeader.jsx

@@ -1,4 +1,5 @@
 import SectionText from './SectionText.jsx'
+import { TITLE_ROLES, useMasthead } from '../utilities/masthead.js'
 /**
  * PageHeader — the page's masthead: an optional eyebrow, the title, and a
  * sub-line.
@@ -62,19 +63,25 @@ import SectionText from './SectionText.jsx'
  *                    with an `!important` on the margin — a DS text role re-implemented outside.
  * @param {string}    subtitleMaxWidth  the lede's measure (e.g. '800px' or '60ch'), a prop
  *                    instead of a consumer selector reaching inside
+ * @param {'display'|'mono'} masthead  the APP's masthead (utilities/masthead.js, 2026-09-29): inside
+ *                    a Shell it comes from `AppShell masthead` and WINS over `voice`/`size`, and
+ *                    `display` drops the subtitle — one app, one header. Outside a Shell, unset =
+ *                    the props as given, so no site page moves.
  * The bottom rhythm is `--kol-page-header-mb` (default 40px): inline, as before, but through a
  * variable a consumer can re-point where an inline literal could only be `!important`-ed.
  */
 /* the title role per size and voice — the one thing PageHeader knows that the
- * base does not, because the base's ladder is the SECTION scale */
-const TITLE = {
-  sans: { sm: 'kol-sans-heading-03', md: 'kol-sans-display-03', lg: 'kol-sans-display-02' },
-  mono: { sm: 'kol-mono-heading-03', md: 'kol-mono-display-03', lg: 'kol-mono-display-02' },
-}
+ * base does not, because the base's ladder is the SECTION scale. Lives in
+ * utilities/masthead.js since 2026-09-29 so a tool's own title reads the same table. */
+const TITLE = TITLE_ROLES
 /* the ONE thing the registers disagree about */
 const LEDE = { app: 'kol-mono-14', site: 'kol-sans-body-01' }
 
-export default function PageHeader({ eyebrow, title, subtitle, actions, subtitleMaxWidth, size = 'md', voice = 'sans', register = 'app', titleClass, className = '' }) {
+export default function PageHeader({ eyebrow, title, subtitle: ownSubtitle, actions, subtitleMaxWidth, size: ownSize = 'md', voice: ownVoice = 'sans', register = 'app', titleClass, masthead, className = '' }) {
+  const m = useMasthead(masthead)
+  const voice = m ? m.voice : ownVoice
+  const size = m ? m.size : ownSize
+  const subtitle = m && !m.subtitle ? undefined : ownSubtitle
   const roles = TITLE[voice] ?? TITLE.sans
   return (
     /* the block owns its own rhythm — margins inline, never in a shared type
@@ -83,7 +90,7 @@ export default function PageHeader({ eyebrow, title, subtitle, actions, subtitle
       eyebrow={eyebrow}
       headline={title}
       headlineAs="h1"
-      headlineClass={`text-fg-96 ${titleClass ?? roles[size] ?? roles.md}`}
+      headlineClass={`text-fg-96 ${titleClass ?? roles[size] ?? roles.md}${m?.upper ? ' uppercase' : ''}`}
       body={subtitle}
       bodyClass={`text-oq-64 ${LEDE[register] ?? LEDE.app} min-w-0`}
       actions={actions}

package/src/molecules/SearchInput.jsx

@@ -103,8 +103,9 @@ export default function SearchInput({
     if (expanding && isOpen) inputRef.current?.focus()
   }, [expanding, isOpen])
 
-  /* the pinned squares, 01-foundations/09-sizes.md — 22 · 26 · 32 · 40 */
-  const square = { sm: 28, md: 32, lg: 36 }[size] ?? 32
+  /* the pinned squares, 01-foundations/09-sizes.md — 22 · 26 · 32 · 40, read from the theme's
+   * `--kol-ctl-*` so the touch rung (D5, 2026-09-29) grows them with every other control */
+  const square = `var(--kol-ctl-${['xs', 'sm', 'md', 'lg'].includes(size) ? size : 'md'})`
   /* THE OPEN FIELD'S HEIGHT IS ITS OWN KNOB, defaulting to the square.
    *
    * /work's pill is `h-9` open AND closed, sitting level with a 36px toggle —
@@ -209,8 +210,10 @@ export default function SearchInput({
 
   /* Same height pin as Input: Chromium sizes an <input> from font metrics,
    * not CSS line-height, so without this the shell lands ~0.5px tall.
-   * h-4 / h-[18px] match the kol-mono-12 / -14 line-heights. */
-  const heightCls = size === 'sm' ? 'h-4' : 'h-[18px]'
+   * h-4 / h-[18px] match the kol-mono-12 / -14 line-heights. On TOUCH the input types 16 / 22 (the
+   * touch rung, D5 2026-09-29), and this utility out-ranked the theme's coarse rule — 16px text in a
+   * 16px line in a 26px box; `pointer-coarse:` carries the 22 so the box grows with its row. */
+  const heightCls = `${size === 'sm' ? 'h-4' : 'h-[18px]'} pointer-coarse:h-[22px]`
 
   const inputCls = [
     'min-w-0 flex-1 bg-transparent border-none outline-none text-auto',

package/src/organisms/ContentFilters.jsx

@@ -7,6 +7,7 @@ import { glyphSize } from '../hooks/glyphLadders.js'
 import SearchInput from '../molecules/SearchInput.jsx'
 import IconFrame from '../atoms/IconFrame.jsx'
 import { Tooltip } from '../utilities/Popover.jsx'
+import { filterItems } from '../utilities/searchItems.js'
 
 /**
  * ContentFilters — universal filter component for content grids.
@@ -214,16 +215,8 @@ const ContentFilters = ({
   }
 
   const filteredItems = useMemo(() => {
-    let result = items
-    if (searchText) {
-      const q = searchText.toLowerCase()
-      result = result.filter((item) =>
-        searchKeys.some((key) => {
-          const val = item[key]
-          return val && String(val).toLowerCase().includes(q)
-        }),
-      )
-    }
+    /* the KOL engine, not a private substring match (apps review 2026-09-29) — utilities/searchItems */
+    let result = filterItems(items, searchText, { keys: searchKeys })
     if (activeFilters.size === 0) return result
     return result.filter((item) => {
       let matches = true

package/src/organisms/DocumentEditor.jsx

@@ -7,7 +7,7 @@ import ViewToggle from '../atoms/ViewToggle.jsx'
 import QuickLookFrame from '../molecules/QuickLookFrame.jsx'
 import KindPreview from '../molecules/KindPreview.jsx'
 import FullscreenOverlay from '../utilities/FullscreenOverlay.jsx'
-import { splitFrontmatter, joinFrontmatter } from '../utilities/frontmatter.js'
+import { splitFrontmatter, joinFrontmatter } from '@kolkrabbi/kol-markdown'
 import { readDraft, writeDraft, clearDraft } from '../utilities/localDrafts.js'
 
 /**
@@ -32,7 +32,8 @@ import { readDraft, writeDraft, clearDraft } from '../utilities/localDrafts.js'
  * @param {string}   name            the file's name (edit) or a starting name (new)
  * @param {string}   kind            markdown · text · json · yaml · code · svg (edit); new picks it
  * @param {string}   text            the saved text; `null` while it loads
- * @param {number}   savedAt         epoch ms of the saved file — a draft older than this is ignored
+ * @param {number}   savedAt         epoch ms of the saved file — a draft older than this is ignored; `null` = never
+ *                                    saved (a blank note, 2026-09-29) and the status says so instead of "Saved"
  * @param {Object}   draft           `{ bucket, key }` — where the draft lives; omit for no drafts
  * @param {Function} onSave          `(text) => Promise` — edit mode
  * @param {Function} onCreate        `({ name, text }) => Promise` — new mode; the name carries the extension
@@ -42,7 +43,7 @@ import { readDraft, writeDraft, clearDraft } from '../utilities/localDrafts.js'
  * @param {Function} onPickAsset     `() => Promise<{ name, url, contentType } | null>` — a consumer's own picker instead
  * @param {Function} onClose
  * @param {boolean}  inline          render IN the page, filling its container, instead of over it (the notes
- *                                   page, media-shell 2026-09-26: the editor is the page's content there,
+ *                                   page, media-hub 2026-09-26: the editor is the page's content there,
  *                                   not a window over a list). No scrim, no Escape-to-close; the X still closes
  */
 const TYPES = [
@@ -94,10 +95,10 @@ export default function DocumentEditor({
     }
     if (text == null) return
     const d = draft ? readDraft(draft.bucket, draft.key) : null
-    const useDraft = d && d.at > savedAt && d.text !== text
+    const useDraft = d && d.at > (savedAt ?? 0) && d.text !== text
     setBase(text)
     setValue(useDraft ? d.text : text); latest.current = useDraft ? d.text : text
-    setStatus(useDraft ? 'Draft restored — not saved to the file' : 'Saved')
+    setStatus(useDraft ? 'Draft restored — not saved to the file' : savedAt === null ? 'Not saved yet' : 'Saved')
     if (d && !useDraft && draft) clearDraft(draft.bucket, draft.key)
   }, [text]) // eslint-disable-line react-hooks/exhaustive-deps
 
@@ -110,7 +111,7 @@ export default function DocumentEditor({
   useEffect(() => () => flush(), []) // eslint-disable-line react-hooks/exhaustive-deps
   const change = (next) => {
     setValue(next); latest.current = next
-    setStatus(isNew ? 'Not created yet' : next === base ? 'Saved' : 'Edited — not saved')
+    setStatus(isNew ? 'Not created yet' : next === base ? (savedAt === null ? 'Not saved yet' : 'Saved') : 'Edited — not saved')
     clearTimeout(timer.current)
     timer.current = setTimeout(flush, DRAFT_PAUSE)
   }
@@ -197,7 +198,7 @@ export default function DocumentEditor({
             <ViewToggle variant="text" viewMode={view} onViewChange={setView} options={views} />
             {md && (onPickAsset || assets?.length > 0) && <Button variant="nav" size="sm" iconLeft="image" onClick={attach} aria-pressed={picking}>Attach</Button>}
             {!isNew && value !== base && value != null && <Button variant="nav" size="sm" onClick={revert}>Revert</Button>}
-            <Button variant="secondary" size="sm" onClick={save} disabled={!dirty}>{isNew ? 'Create' : 'Save'}</Button>
+            <Button size="sm" onClick={save} disabled={!dirty}>{isNew ? 'Create' : 'Save'}</Button>
           </span>
         )}>
         {/* the window's own caps, inline — Tailwind does not generate arbitrary values from package source */}
@@ -229,7 +230,7 @@ export default function DocumentEditor({
                 )}
                 {value == null
                   ? <p className="kol-mono-12 text-fg-48">Loading…</p>
-                  : <Textarea variant="filled" size="md" rows={18} axis="vertical" className="w-full flex-1 kol-mono-12"
+                  : <Textarea variant="filled" size="sm" rows={18} axis="vertical" className="w-full flex-1"
                       value={md ? parts.body : value} onChange={(e) => (md ? setBody(e.target.value) : change(e.target.value))}
                       spellCheck={kind === 'markdown' || kind === 'text'} aria-label="Document text"
                       placeholder={md ? 'Write in markdown — # heading, **bold**, - list' : ''} />}

package/src/organisms/MediaLibrary.jsx

@@ -16,6 +16,7 @@ import MediaViewer from './MediaViewer.jsx'
 import { MediaLibraryBrowse, MediaLibraryLibrary } from './MediaLibraryPages.jsx'
 import MediaLibraryExplorer from './MediaLibraryExplorer.jsx'
 import { SettingsChipRow, chipCls } from './SettingsPanel.jsx'
+import { filterMedia } from '../utilities/mediaSearch.js'
 
 /**
  * MediaLibrary — a browser over an object bucket, in two views over one
@@ -343,10 +344,7 @@ export function MediaLibraryProvider({
     const kindCounts = files.reduce((acc, o) => { acc[o.kind] = (acc[o.kind] || 0) + 1; return acc }, {})
     const kindsPresent = Object.keys(kindCounts).sort().map((k) => ({ value: k, label: KIND_LABEL[k] ?? k, count: kindCounts[k] }))
 
-    const q = search.trim().toLowerCase()
-    const filtered = files.filter(
-      (o) => (kinds.size === 0 || kinds.has(o.kind)) && (!q || o.displayKey.toLowerCase().includes(q)),
-    )
+    const filtered = filterMedia(files.filter((o) => kinds.size === 0 || kinds.has(o.kind)), search, { nameOf: (o) => o.displayKey })
     const sorted = sortFiles(filtered, sort)
 
     const page = pageSize || Infinity
@@ -783,7 +781,7 @@ function LibraryViewer({ index, onIndexChange, onClose, onPick }) {
       actions={(item, i) => (
         <>
           {onPick && <Button size="sm" onClick={() => onPick(viewable[i])}>Use</Button>}
-          <Button variant="secondary" size="sm" onClick={() => copy(item.url)}>
+          <Button size="sm" onClick={() => copy(item.url)}>
             {copied === item.url ? 'Copied' : 'Copy URL'}
           </Button>
         </>

package/src/organisms/MediaLibraryExplorer.jsx

@@ -29,7 +29,10 @@ import useMediaQuery from '../hooks/useMediaQuery.js'
  *                              Ignored while typing and with ⌘ / Ctrl / ⌥ held
  * @param {boolean}  phoneTabs  below 768 the surface is three tabs — Browse · Files · Kinds (Kinds only
  *                              with `onKinds`); a tab picks the view, Kinds opens the overview and leaves
- *                              the surface where it was
+ *                              the surface where it was. OFF in the apps since 2026-09-29 (the `···` menu
+ *                              carries view, sort and File formats, as the Files app does); KEPT for a
+ *                              phone-first consumer whose browse surfaces are destinations of their own —
+ *                              a repo that routes Browse and Files as pages wants them one tap apart
  * @param {Function} onKinds    opens the app's file-formats overview (K, the Kinds tab)
  */
 const TABS = [
@@ -88,6 +91,7 @@ export default function MediaLibraryExplorer({ view, onViewChange, defaultView,
     <MediaLibraryBrowse
       {...pageProps}
       {...tabProps}
+      onKinds={onKinds}
       view={current}
       onViewChange={setView}
     />

package/src/organisms/MediaLibraryPages.jsx

@@ -18,6 +18,8 @@ import ContentRow from '../molecules/ContentRow.jsx'
 import SortControls from '../molecules/SortControls.jsx'
 import SearchInput from '../molecules/SearchInput.jsx'
 import MobileTabBar, { TABBAR_H } from '../molecules/MobileTabBar.jsx'
+import { filterMedia, rankMedia } from '../utilities/mediaSearch.js'
+import { useMasthead, mastheadTitleClass } from '../utilities/masthead.js'
 import { MenuItem, MenuDropdownItem, MenuDropdownDivider } from '../molecules/MenuItem.jsx'
 import { Tooltip } from '../utilities/Popover.jsx'
 import ContextMenu, { useContextMenu } from '../utilities/ContextMenu.jsx'
@@ -34,7 +36,7 @@ import { useModal } from '../molecules/Modal.jsx'
 import ContentFilters from './ContentFilters.jsx'
 import DocumentEditor from './DocumentEditor.jsx'
 import { listDrafts, moveDrafts, DRAFTS_EVENT } from '../utilities/localDrafts.js'
-import { parseFrontmatter } from '../utilities/frontmatter.js'
+import { parseFrontmatter } from '@kolkrabbi/kol-markdown'
 import ShellSearchOverlay from './ShellSearchOverlay.jsx'
 import ColumnBrowser, { isFileDrag, Preview as ColumnPreview, SelectionPreview } from './ColumnBrowser.jsx'
 import SettingsPanel, { SettingsSwitch, SettingsChoice, SettingsMulti, SettingsFooter } from './SettingsPanel.jsx'
@@ -116,6 +118,7 @@ export const SETTINGS_BASE = {
   filters: false, // the filter bar above the body; off until asked for
   rowColumns: false, // row view's Date/Size columns + their header; off, a row is just its name
   rowColumnWidths: { ...ROW_COL_DEFAULTS }, // px, dragged on the header's own dividers
+  countLine: 'auto', // 'auto' | 'on' | 'off' — the `N folders · N files · size` line under the body; auto = on at a desk, off on a phone or a touch device (apps review 2026-09-29)
 }
 
 /* THE FOUR VIEWS (the merge, user 2026-09-22: "they both just display files"). Columns and rows
@@ -684,7 +687,7 @@ export function MediaInspector({ files, index, onClose, onPrev, onNext, mediaUrl
   )
 }
 
-/* THE DISPLAY SETTINGS AS DATA (media-shell, user 2026-09-26: "missing settings sidebar? … or are
+/* THE DISPLAY SETTINGS AS DATA (media-hub, user 2026-09-26: "missing settings sidebar? … or are
  * we saying the shell has settings different from media?"). The rows were hard-wired JSX inside this
  * drawer, so an app page could not show them and a second settings system grew beside it. Now ONE
  * builder: this drawer renders it, and an app renders the same rows on its settings page and its own
@@ -730,6 +733,8 @@ export function mediaSettingsSections({ settings, onChange, profile }) {
         render: () => <SettingsChoice options={SORT_OPTIONS} value={settings.sortBy} onChange={(v) => set({ sortBy: v })} /> },
       { label: 'Direction', align: 'fill',
         render: () => <SettingsChoice options={[{ value: 'asc', label: '↓ Asc' }, { value: 'desc', label: '↑ Desc' }]} value={settings.sortDir} onChange={(v) => set({ sortDir: v })} /> },
+      { label: 'Count line', align: 'fill',
+        render: () => <SettingsChoice options={[{ value: 'auto', label: 'Auto' }, { value: 'on', label: 'On' }, { value: 'off', label: 'Off' }]} value={settings.countLine ?? 'auto'} onChange={(v) => set({ countLine: v })} /> },
     ] },
   ]
 }
@@ -873,6 +878,8 @@ function TrashPanel({ trash, onClose, run, confirm }) {
 }
 
 function LibraryHeader({ title, buckets, bucketId, appRoot, onBucket, bucketMeta, writable, headerActions, onSettings, onTrash, onHome, headerTrailing }) {
+  /* the app's masthead voice when a Shell sets one (2026-09-29), else the display voice as before */
+  const titleCls = mastheadTitleClass(useMasthead(), 'kol-sans-display-03')
   /* ONE BUCKET, NO DROPDOWN (user 2026-09-22) — a picker with one thing in it chooses nothing. */
   const options = buckets.length > 1 ? [{ value: 'all', label: `${title} · all` }, ...buckets.map((b) => ({ value: b.id, label: b.label }))] : []
   /* THE WORDMARK IS THE HOME BUTTON when `onHome` is given (user 2026-09-21: "it should reload,
@@ -883,10 +890,10 @@ function LibraryHeader({ title, buckets, bucketId, appRoot, onBucket, bucketMeta
     <header className="flex items-baseline justify-between gap-4">
       {onHome ? (
         <button type="button" onClick={onHome}
-          className="kol-sans-display-03 min-w-0 truncate text-left cursor-pointer transition-opacity hover:opacity-64"
+          className={`${titleCls} min-w-0 truncate text-left cursor-pointer transition-opacity hover:opacity-64`}
           aria-label={`${title} — back to the top`}>{title}</button>
       ) : (
-        <h1 className="kol-sans-display-03 min-w-0 truncate">{title}</h1>
+        <h1 className={`${titleCls} min-w-0 truncate`}>{title}</h1>
       )}
       <div className="flex items-center gap-2 min-w-0">
         {options.length > 0 && <Dropdown className="min-w-0 max-w-[45vw] md:w-48 md:max-w-none" value={appRoot ? 'all' : bucketId} onChange={onBucket} options={options} />}
@@ -918,7 +925,7 @@ function LibraryHeader({ title, buckets, bucketId, appRoot, onBucket, bucketMeta
   )
 }
 
-/* `columnHeight: 'fill'` — THE BROWSER TAKES WHAT IS LEFT OF THE WINDOW (media-shell, user 2026-09-26:
+/* `columnHeight: 'fill'` — THE BROWSER TAKES WHAT IS LEFT OF THE WINDOW (media-hub, user 2026-09-26:
  * "why isnt the browser in media shell using available height like media does?"). apps/media had it
  * as a hand-measured `calc(100dvh - 212px)` — its header, gaps and padding, counted once — so the same
  * tool one shell over got the 528 base. Measured instead: the window, less the view's own top, less
@@ -1043,6 +1050,14 @@ export function MediaLibraryBrowse({
    * the consumer's — a repo whose surfaces are routes wires its router here.
    * No tabs, no pill, and the page is exactly what it was. */
   tabs, activeTab, onTabChange,
+  /* `onKinds` — opens the app's file-formats overview. Given, the phone's `···` menu carries it
+   * under view and sort (apps review 2026-09-29: the Files app keeps everything in its `…`, and
+   * the Kinds tab was the only reason the phone had a tab bar). */
+  onKinds,
+  /* `onOpenSettings` — the gear HANDS OVER to the host (apps review 2026-09-29: three settings in
+   * media-hub, "two too many"). Given, the gear calls it and this page opens no drawer of its own —
+   * inside a Hub the Hub's Settings is the one place. Absent, the gear opens the drawer as always. */
+  onOpenSettings,
   /* `bucketLevel` — keep title → bucket → folders with ONE bucket (kol-client-olina 2026-09-23).
    * Absent, a one-bucket consumer collapses the level as ruled 2026-09-03. */
   bucketLevel = false,
@@ -1230,7 +1245,7 @@ export function MediaLibraryBrowse({
     const tooBig = (o.size ?? 0) > EDIT_CAP
     return (
       <div className="flex items-center gap-3">
-        <Button variant="secondary" size="sm" iconLeft="edit" disabled={tooBig} onClick={() => openEditor(o)}>Edit</Button>
+        <Button size="sm" iconLeft="edit" disabled={tooBig} onClick={() => openEditor(o)}>Edit</Button>
         {tooBig && <span className="kol-mono-12 text-fg-48">Over 1 MB — too large to edit here</span>}
         {!tooBig && draftKeys.has(o.key) && <span className="kol-mono-12 text-fg-48">Unsaved draft</span>}
       </div>
@@ -1755,6 +1770,10 @@ export function MediaLibraryBrowse({
    * stack there; the row view had no phone form and drew the desktop list and its preview pane
    * squeezed into 390 — 35px of rows with no names. Same query, same breakpoint as the columns. */
   const phone = useMediaQuery('(max-width: 767px)')
+  /* THE COUNT LINE'S AUTO (apps review 2026-09-29): a desk reads it, a phone spends a line on it */
+  const coarse = useMediaQuery('(pointer: coarse)')
+  const countLine = settings.countLine ?? 'auto'
+  const showCount = countLine === 'on' || (countLine === 'auto' && !phone && !coarse)
   const setView = (v) => {
     onViewChange?.(v)
     setSettings({
@@ -1816,13 +1835,13 @@ export function MediaLibraryBrowse({
    * when a file under it matches and ColumnBrowser's own partition does the
    * rest. One view, rather than a flat results list nobody asked for. Sort
    * orders the files the way the wall already sorts its own. */
-  const q = query.trim().toLowerCase()
+  const q = query.trim()
   /* SEGMENTS HIDE WHEN FOLDED, in every view (user 2026-09-23: *"we can just by default hide the
    * segments, if they serve no practical purpose"*). A `.ts` chunk cannot play on its own — its
    * stream's `.m3u8` beside it is the thing you open. The fold used to reach only the grid, so the
    * columns and rows listed every chunk. */
   const listed = useMemo(() => (settings.foldSegments ? objects.filter((o) => !isSegment(o.key)) : objects), [objects, settings.foldSegments])
-  const searched = useMemo(() => (q ? listed.filter((o) => o.key.toLowerCase().includes(q)) : listed), [listed, q])
+  const searched = useMemo(() => filterMedia(listed, q), [listed, q])
   const sortedObjects = useMemo(
     () => sortObjects(searched, settings.sortBy, settings.sortDir),
     [searched, settings.sortBy, settings.sortDir],
@@ -2205,10 +2224,7 @@ export function MediaLibraryBrowse({
   /* The palette's own ruling (2026-08-01) is that Enter COMMITS the query rather than navigating
    * to whatever happened to be first — so `onExpand` is where a committed query lands, and here
    * that means the top hit. Arrow-then-Enter and a click go through `onSelect`, same jump. */
-  const searchResults = (searchQuery.trim()
-    ? objects.filter((o) => o.key.toLowerCase().includes(searchQuery.trim().toLowerCase()))
-    : objects
-  ).slice(0, 50).map((o) => ({
+  const searchResults = rankMedia(objects, searchQuery, { limit: 50 }).map((o) => ({
     id: o.key,
     label: o.key.split('/').pop(),
     hint: o.key.slice(0, o.key.lastIndexOf('/') + 1) || 'the bucket root',
@@ -2230,7 +2246,7 @@ export function MediaLibraryBrowse({
     if (isSystemFile(o.key)) return false
     if ((q.tags ?? []).some((t) => !(o.tags ?? []).includes(t))) return false
     if ((q.kinds ?? []).length && !q.kinds.includes(kindOf(o))) return false
-    if (q.text && !o.key.toLowerCase().includes(q.text.toLowerCase())) return false
+    if (q.text && !filterMedia([o], q.text).length) return false
     return true
   }).map((o) => ({ ...o, kind: kindOf(o), poster: posterFor(o.key, keySet), displayKey: o.key })) : null
   const body = (filtered) => (smartMatches
@@ -2244,7 +2260,7 @@ export function MediaLibraryBrowse({
       <LibraryHeader title={title} buckets={buckets} bucketId={bucketMeta.id} appRoot={atTitleRoot} bucketMeta={bucketMeta} writable={writable} headerActions={headerActions} headerTrailing={headerTrailing} onTrash={trash ? () => setTrashOpen(true) : undefined}
         onHome={goTitleRoot}
         onBucket={(v) => { if (v === 'all') goTitleRoot(); else { setAppRoot(false); switchBucket(v) } }}
-        onSettings={() => setSettingsOpen(true)} />
+        onSettings={onOpenSettings ?? (() => setSettingsOpen(true))} />
 
       {/* THE BANNER SLOT — anything that must sit directly under the header and above the body.
         * The upload drop zone is why it exists: a consumer rendering it AFTER the page put it
@@ -2368,6 +2384,7 @@ export function MediaLibraryBrowse({
             label={<Icon name="more" size={16} />}
             caret={false}
             align="end"
+            size="sm"
             buttonClassName="shrink-0 px-2"
           >
             {({ close }) => (
@@ -2403,6 +2420,12 @@ export function MediaLibraryBrowse({
                     {opt.label}
                   </MenuDropdownItem>
                 ))}
+                {onKinds && (
+                  <>
+                    <MenuDropdownDivider />
+                    <MenuDropdownItem onClick={() => { onKinds(); close() }} shortcut="K">File formats</MenuDropdownItem>
+                  </>
+                )}
               </div>
             )}
           </MenuItem>
@@ -2486,7 +2509,7 @@ export function MediaLibraryBrowse({
           * slider at its right end, bare: no glyph, no readout (Finder's). */}
         {atTitleRoot && !single ? (
           <div className="flex items-center justify-between gap-4 h-4">
-          <p className="kol-mono-12 text-fg-48">
+          <p className="kol-mono-12 text-fg-48" hidden={!showCount}>
             {atTop ? '1 folder' : `${bucketList.length} ${bucketList.length === 1 ? 'bucket' : 'buckets'}`}
             {folderTree && ` · ${Object.values(folderTree).reduce((n, t) => n + (t.files ?? 0), 0)} files · ${formatSize(Object.values(folderTree).reduce((n, t) => n + (t.bytes ?? 0), 0))}`}
           </p>
@@ -2496,12 +2519,12 @@ export function MediaLibraryBrowse({
           /* ONE LINE'S HEIGHT, like the other views' count line — the slider is 24px tall and made
            * this row 8px taller than the fill budget, so the page scrolled by that much */
           <div className="flex items-center justify-between gap-4 h-4">
-            <p className="kol-mono-12 text-fg-48">
+            <p className="kol-mono-12 text-fg-48" hidden={!showCount}>
               {!settings.flat && folders.length > 0 && `${folders.length} folder${folders.length > 1 ? 's' : ''} · `}{wallFiles.length} {wallFiles.length === 1 ? 'file' : 'files'} · {formatSize(wallFiles.reduce((n, o) => n + (o.size ?? 0), 0))}
             </p>
             {sizeSlider}
           </div>
-        ) : (
+        ) : showCount && (
           <p className="kol-mono-12 text-fg-48">
             {folders.length > 0 && `${folders.length} folder${folders.length > 1 ? 's' : ''} · `}
             {rawFiles.length} {rawFiles.length === 1 ? 'file' : 'files'} · {formatSize(totalBytes)}

package/src/organisms/SettingsPanel.jsx

@@ -196,14 +196,17 @@ export const chipCls = (on) => `${CHIP_CLS} ${on ? 'kol-control--filled' : 'text
  * @param {Array|Set} selected
  * @param {Function} onToggle (value) => void
  * @param {string} noun      the trigger's noun (default 'kinds')
+ * @param {string} variant   passed to the Dropdown like `SettingsChoice`'s — unset inherits the page's
+ *                           tone. It was hard-coded `primary` until 2026-09-29, so on a sunken settings
+ *                           page it was the one lighter dropdown in the section.
  */
-export function SettingsMulti({ options = [], selected = [], onToggle, noun = 'kinds', tone = 'default', size = 'sm', className = '' }) {
+export function SettingsMulti({ options = [], selected = [], onToggle, noun = 'kinds', tone = 'default', size = 'sm', variant, className = '' }) {
   const on = selected instanceof Set ? selected : new Set(selected)
   const opts = [
     { value: '__summary', label: `${on.size} of ${options.length} ${noun}` },
     ...options.map((o) => ({ value: o.value, label: `${on.has(o.value) ? '✓ ' : ''}${o.label ?? String(o.value)}` })),
   ]
-  return <Dropdown size={size} variant="primary" tone={tone} value="__summary" options={opts} onChange={(v) => (v === '__summary' ? null : onToggle?.(v))} className={`w-full ${className}`.trim()} />
+  return <Dropdown size={size} variant={variant} tone={tone} value="__summary" options={opts} onChange={(v) => (v === '__summary' ? null : onToggle?.(v))} className={`w-full ${className}`.trim()} />
 }
 
 /**

package/src/organisms/ShellSearchOverlay.jsx

@@ -10,7 +10,21 @@ import Tag from '../atoms/Tag.jsx'
  * @param {string} label full row label
  * @param {string} query current query (empty / no match → plain label)
  */
-export function HighlightMatch({ label, query }) {
+export function HighlightMatch({ label, query, ranges }) {
+  /* An engine that already knows where it matched (kol-search's `highlights`)
+   * passes `ranges` — every hit, not just the first slice of the raw query. */
+  if (Array.isArray(ranges)) {
+    if (!ranges.length) return <span>{label}</span>
+    const out = []
+    let at = 0
+    ranges.forEach(([s, e], i) => {
+      if (s > at) out.push(<span key={`t${i}`}>{label.slice(at, s)}</span>)
+      out.push(<span key={`m${i}`} className="text-fg underline decoration-2 underline-offset-[3px]">{label.slice(s, e)}</span>)
+      at = e
+    })
+    if (at < label.length) out.push(<span key="rest">{label.slice(at)}</span>)
+    return <>{out}</>
+  }
   const idx = query ? label.toLowerCase().indexOf(query.toLowerCase()) : -1
   if (idx === -1) return <span>{label}</span>
   return (
@@ -47,6 +61,10 @@ export function HighlightMatch({ label, query }) {
  * @param {Function} onQueryChange (string) => void — input change
  * @param {Function} onSelect      (item) => void — row click / Enter; consumer navigates
  * @param {string}   placeholder   input placeholder
+ * @param {string}   [enterLabel]  what Enter does when no row is picked — shown as
+ *                                 the panel's last line, so Enter is never a surprise
+ *                                 (e.g. `All results for “q”`). Rows may carry
+ *                                 `highlights` ([start, end] ranges) from the engine.
  */
 export default function ShellSearchOverlay({
   open,
@@ -65,6 +83,7 @@ export default function ShellSearchOverlay({
   onQueryChange,
   onSelect,
   placeholder = 'Search…',
+  enterLabel,
 }) {
   const panelRef = useRef(null)
   const listRef = useRef(null)
@@ -210,12 +229,12 @@ export default function ShellSearchOverlay({
                 onClick={() => select(item)}
                 onMouseEnter={() => { setActiveIndex(i); setNavigated(true) }}
                 className={`flex items-center gap-2 px-4 py-1.5 cursor-pointer kol-mono-14 transition-colors ${
-                  i === active ? 'bg-fg-08 text-fg' : 'text-fg-64'
+                  i === active ? 'bg-fg-08 text-fg' : 'text-fg-80'
                 }`}
               >
                 <span className="flex flex-col min-w-0">
                   <span className="truncate">
-                    <HighlightMatch label={item.label} query={query} />
+                    <HighlightMatch label={item.label} query={query} ranges={item.highlights} />
                   </span>
                   {item.hint && (
                     <span className="kol-mono-12 text-fg-48 truncate">{item.hint}</span>
@@ -228,6 +247,12 @@ export default function ShellSearchOverlay({
             ))}
           </ul>
         )}
+        {!expanded && enterLabel && query && (
+          <p className="flex items-center gap-2 border-t border-fg-08 px-4 py-2 kol-helper-12 text-fg-64">
+            <kbd className="kol-helper-12 rounded-[var(--kol-radius-sm)] bg-fg-08 px-1.5 py-0.5 text-fg">↵</kbd>
+            {enterLabel}
+          </p>
+        )}
       </div>
     </div>
   )

package/src/organisms/ShortcutsOverlay.jsx

@@ -0,0 +1,104 @@
+import { useEffect } from 'react'
+import SettingsSections from './SettingsSections.jsx'
+
+/**
+ * ShortcutsOverlay — the keyboard-shortcut sheet: blurred scrim, centred
+ * panel, a 2-col grid (label · keys), Esc / backdrop-click close.
+ * Ported from the shared cut (mirror's, "copied from kol-monitor").
+ *
+ * `shortcuts` is a prop — feed the SAME array your settings page renders
+ * (both repos hand-maintained the list twice and both pairs drifted).
+ * Stacks at `--kol-z-modal`, above the rail's sticky tier.
+ *
+ * TWO FORMS, DETECTED ON SHAPE (ShortcutsOverlaySections, kol-fxr 2026-08-15):
+ *
+ *   flat       `[{ label, keys }]`                  — one grid, as shipped
+ *   sectioned  `[{ section, items: [{label,keys}] }]` — headings between groups
+ *
+ * The flat form renders EXACTLY as it did before, so no existing caller moves.
+ * The sectioned form exists because a real keymap is grouped — kol-fxr's is
+ * Edit · Selection · Layer · Tools · View, and its `shortcutsBySection()`
+ * already emits this shape — and flattening it to adopt this component would
+ * have lost the grouping. That consumer kept a 99-line local overlay instead,
+ * which is the duplication this component exists to end.
+ *
+ * ONE COMPONENT WITH THE SETTINGS PAGE AND THE DRAWER (user, 2026-09-03:
+ * *"align it more to the settings sidebar"* → *"lets normalise a component
+ * they can grab"*). This sheet and `SettingsShortcuts` render the SAME keymap
+ * array and had drifted into two anatomies — a bespoke two-column grid with a
+ * plain `text-fg-32` heading and hand-rolled `<span>` pairs here, against
+ * eyebrow sections over `SettingsRow`s there, down to the combo being `fg-96`
+ * in one and `fg-32` in the other. Both go through `SettingsSections` now, the
+ * same call the settings page and the settings drawer use, so a shortcut reads
+ * identically wherever it is shown and a change to the row lands in all of
+ * them. The FRAME stays each one's own: a scrim and a centred sheet here, a
+ * six-column grid on the page, a right-anchored drawer over the thing you are
+ * looking at.
+ *
+ * `keys` is a DISPLAY STRING and is never bound — this component shows a
+ * keymap, it does not own one. Formatting a combo (⌘⇧Z) is the consumer's,
+ * next to wherever the binding actually lives.
+ *
+ * @param {Array} props.shortcuts - `[{ label, combo }]` or `[{ section, items: [{ id, label, combo }] }]` — the same array `SettingsShortcuts` takes (ShellHomeSystemMonitorGaps, kol-monitor 2026-08-27: the overlay read `keys` while the settings block read `combo`; `combo` is the name, `keys` is tolerated for a release)
+ * @param {Function} props.onClose
+ */
+
+const isSectioned = (list) => Array.isArray(list?.[0]?.items)
+
+/* A shortcut as a settings ROW: the label on the left, the combo as the row's
+ * value. `labelWidth="auto"` makes the label yield and the combo hug. A combo
+ * holds on one line from `sm` up; below it, it wraps under its label (LabeledControl stacks) — media's
+ * combos are sentences ("Drag from empty space (rows: …"), and held on one line
+ * they pushed the sheet past both edges of a phone (apps review, 2026-09-29). */
+const toRow = ({ label, combo, keys }) => ({
+  label,
+  align: 'fill',
+  labelWidth: 'auto',
+  value: <span className="text-fg-32 kol-helper-12 sm:whitespace-nowrap">{combo ?? keys}</span>,
+})
+
+export default function ShortcutsOverlay({ shortcuts = [], onClose }) {
+  useEffect(() => {
+    const onKey = (e) => { if (e.key === 'Escape') onClose?.() }
+    window.addEventListener('keydown', onKey)
+    return () => window.removeEventListener('keydown', onKey)
+  }, [onClose])
+
+  const sectioned = isSectioned(shortcuts)
+
+  return (
+    <div
+      onClick={onClose}
+      /* THE scrim (overlay-scrim-outliers, kol-client-olina 2026-09-03; user: "we
+         removed the blur and put just color on the background … we missed this").
+         This drew its own — an 8 % inverse wash plus a 2px blur — after the
+         2026-09-01 no-blur ruling and the one-tint-48 class. */
+      className="fixed inset-0 select-none kol-overlay-scrim"
+      style={{ display: 'grid', placeItems: 'center', zIndex: 'var(--kol-z-modal)' }}
+    >
+      {/* `bg-oq-04`, not `bg-surface-primary` (user, 2026-09-03: *"this is too
+          bright"*). Over a near-black editor canvas the raised page surface
+          reads as a lit slab, and an `fg-16` stroke on top of it was the
+          brightest edge on screen. The OPAQUE ramp is right here: the sheet
+          must not let the canvas through, and `oq-04` is a 4 % lift off the
+          ground rather than a surface from the page's own ladder — so the
+          panel separates from the scrimmed canvas without a stroke. */}
+      <div
+        /* THE SHEET FITS THE WINDOW (editor review #4, 2026-09-27): a long keymap — the design
+         * editor's is six sections — ran past both edges of the viewport with no way to reach the
+         * rest. Capped to the window less a margin, scrolling inside. */
+        className="kol-shortcuts-panel text-fg-64 kol-helper-12 bg-oq-04 flex flex-col gap-6 overflow-y-auto"
+        /* and the window's WIDTH too (apps review, 2026-09-29): nothing capped it, so the widest
+         * row set the sheet's width and a phone showed its middle third */
+        style={{ padding: 24, borderRadius: 4, maxHeight: 'calc(100dvh - 48px)', maxWidth: 'calc(100vw - 32px)' }}
+        onClick={(e) => e.stopPropagation()}
+      >
+        <SettingsSections
+          sections={sectioned
+            ? shortcuts.map(({ section, items = [] }) => ({ label: section, rowGap: 1, rows: items.map(toRow) }))
+            : [{ rowGap: 1, rows: shortcuts.map(toRow) }]}
+        />
+      </div>
+    </div>
+  )
+}

package/src/utilities/ErrorBoundary.jsx

@@ -61,7 +61,7 @@ export default class ErrorBoundary extends Component {
 
           <div className="flex gap-4 justify-center flex-wrap">
             <Button variant="primary" onClick={this.handleReset}>Try again</Button>
-            <Button variant="secondary" href={this.props.homeHref ?? '/'}>Go home</Button>
+            <Button href={this.props.homeHref ?? '/'}>Go home</Button>
           </div>
         </div>
       </div>

package/src/utilities/masthead.js

@@ -0,0 +1,39 @@
+import { createContext, useContext } from 'react'
+
+/**
+ * masthead — ONE APP, ONE MASTHEAD (apps review 2026-09-29, ruling D3). media-hub wore MEDIA in the
+ * display voice on Browse and a mono title + description on its Hub pages: two headers in one app,
+ * because each page picked its own. The voice is now the app's, set ONCE on the Shell
+ * (`AppShell masthead`) and read by every page inside it — `PageHeader` (and so `CatalogPage`,
+ * `HubHome`, `SettingsScaffold`) and the media tool's own title.
+ *
+ *   display   the default — "uppercase sans like media" (the user, 2026-09-29): the display voice,
+ *             UPPERCASE as a role (03-typography § Casing — case rides the call site, not the class),
+ *             no description line
+ *   mono      the Hub's older look — a mono title with its description under it
+ *
+ * Outside a Shell there is no context and every header renders exactly as its props say, so a
+ * site page is untouched. A page may still pass `masthead` itself (a Catalog with no Shell).
+ */
+export const MASTHEADS = {
+  display: { voice: 'sans', size: 'md', subtitle: false, upper: true },
+  mono: { voice: 'mono', size: 'sm', subtitle: true, upper: false },
+}
+
+/* the title role per voice and size — PageHeader's ladder, here so a tool's own title reads it too */
+export const TITLE_ROLES = {
+  sans: { sm: 'kol-sans-heading-03', md: 'kol-sans-display-03', lg: 'kol-sans-display-02' },
+  mono: { sm: 'kol-mono-heading-03', md: 'kol-mono-display-03', lg: 'kol-mono-display-02' },
+}
+
+export const MastheadContext = createContext(null)
+
+/** the masthead in effect — the page's own `masthead` prop, else the Shell's, else null */
+export function useMasthead(own) {
+  const shell = useContext(MastheadContext)
+  const name = own ?? shell
+  return name && MASTHEADS[name] ? { name, ...MASTHEADS[name] } : null
+}
+
+/** the title class a masthead gives — for a tool that draws its own title (media's LibraryHeader) */
+export const mastheadTitleClass = (m, fallback) => (m ? `${TITLE_ROLES[m.voice][m.size]}${m.upper ? ' uppercase' : ''}` : fallback)

package/src/utilities/mediaSearch.js

@@ -0,0 +1,41 @@
+/**
+ * mediaSearch — the media library's search, on the KOL engine (`@kolkrabbi/kol-search`).
+ *
+ * Four places in the media pages each ran their own `key.toLowerCase().includes(q)` — the browse
+ * filter, the ⌘K palette, the smart-folder text match, the picker's filter (apps review,
+ * 2026-09-29). One helper now, so the media search speaks the same language as every other KOL
+ * search: several words must ALL match, `-word` must not, `"a phrase"`, `tag:x` / `#x`,
+ * `kind:image` / `is:video`, `after:2026-09-01`. A plain substring still finds what it found.
+ *
+ * An object becomes an engine item: its file name is the title (ranked first), the whole key is a
+ * keyword (so a folder name in the path still matches), its tags and kind are facets, its upload
+ * date the date.
+ */
+import { createIndex, search } from '@kolkrabbi/kol-search'
+import { kindOf } from './mediaKinds.js'
+
+const toItem = (o, nameOf) => ({
+  id: o.key,
+  title: nameOf ? nameOf(o) : o.key.slice(o.key.lastIndexOf('/') + 1) || o.key,
+  keywords: [o.key],
+  tags: o.tags ?? [],
+  kind: o.kind ?? kindOf(o),
+  date: o.uploaded ? String(o.uploaded).slice(0, 10) : undefined,
+  o,
+})
+
+/** ranked hits, best first — the palette's order. `nameOf(o)` overrides the title (a display key). */
+export function rankMedia(objects, query, { nameOf, limit } = {}) {
+  const q = String(query ?? '').trim()
+  if (!q) return limit ? objects.slice(0, limit) : objects
+  const index = createIndex(objects.map((o) => toItem(o, nameOf)), { facets: ['kind', 'tags'], smart: ['kind'] })
+  return search(index, q, { limit }).results.map((r) => r.item.o)
+}
+
+/** the matches in their ORIGINAL order — for views that sort on their own afterwards. */
+export function filterMedia(objects, query, opts) {
+  const q = String(query ?? '').trim()
+  if (!q) return objects
+  const hit = new Set(rankMedia(objects, q, opts))
+  return objects.filter((o) => hit.has(o))
+}

package/src/utilities/searchItems.js

@@ -0,0 +1,30 @@
+/**
+ * searchItems — any list of objects, searched by the KOL engine (`@kolkrabbi/kol-search`).
+ *
+ * `ContentFilters` ran `String(item[key]).toLowerCase().includes(q)` over its `searchKeys` — one more
+ * private engine (apps review 2026-09-29: *"one engine with tiers not endless individual engines each
+ * slightly different"*). Through this, every catalog searches the same way: several words must ALL
+ * match, `-word` must not, `"a phrase"`, `tag:x` / `#x` against the item's `tags`. A single word still
+ * finds everything the substring found.
+ *
+ * The FIRST search key is the title (ranked highest); the rest are keywords. The items come back in
+ * THEIR order — a catalog sorts itself.
+ */
+import { createIndex, search } from '@kolkrabbi/kol-search'
+
+const list = (v) => (Array.isArray(v) ? v : v == null || v === '' ? [] : [v])
+
+export function filterItems(items, query, { keys = ['title'] } = {}) {
+  const q = String(query ?? '').trim()
+  if (!q) return items
+  const [first, ...rest] = keys
+  const index = createIndex(items.map((item, i) => ({
+    id: i,
+    title: String(item[first] ?? ''),
+    keywords: rest.flatMap((k) => list(item[k])).map(String),
+    tags: list(item.tags).map(String),
+    item,
+  })), { facets: ['tags'], smart: [] })
+  const hit = new Set(search(index, q).results.map((r) => r.item.item))
+  return items.filter((it) => hit.has(it))
+}

package/src/utilities/frontmatter.js

@@ -1,76 +0,0 @@
-/**
- * parseFrontmatter — the workshop engine's handrolled YAML-subset parser,
- * verbatim (`packages/workshop/src/engine/frontmatter.js`; DocPageAndKindShowcase,
- * kol-r2b2 2026-08-27): `key: value`, block lists (`  - item`), inline `[a, b]`
- * tags. Keys are lowercased. No gray-matter / js-yaml.
- */
-export function parseFrontmatter(raw) {
-  const metadata = {}
-  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)
-  if (!match) return metadata
-  const lines = match[1].split(/\r?\n/)
-  for (let i = 0; i < lines.length; i++) {
-    const kv = lines[i].match(/^([A-Za-z][A-Za-z0-9 -]*):\s*(.*)$/)
-    if (!kv) continue
-    const key = kv[1].toLowerCase()
-    const value = kv[2].trim()
-    if (!value) {
-      const items = []
-      while (i + 1 < lines.length && lines[i + 1].match(/^\s+-\s+/)) { i++; items.push(lines[i].replace(/^\s+-\s+/, '').trim()) }
-      metadata[key] = items.length ? items : ''
-    } else {
-      metadata[key] = value
-    }
-  }
-  if (typeof metadata.tags === 'string' && metadata.tags.startsWith('[')) {
-    metadata.tags = metadata.tags.slice(1, -1).split(',').map((t) => t.trim()).filter(Boolean)
-  }
-  return metadata
-}
-
-/**
- * splitFrontmatter / joinFrontmatter — the EDITOR's pair (DocumentEditor, 2026-09-26). Where
- * `parseFrontmatter` reads for display (keys lowercased, lists flattened), these round-trip a file:
- * keys keep their case and their order, a list stays a list, and the body is untouched — so opening
- * and saving a document without touching the form changes nothing but what was edited.
- *
- * `fields` is `[[key, value]]`, value a string or an array of strings.
- */
-const unquote = (v) => {
-  if (v.length > 1 && v.startsWith('"') && v.endsWith('"')) { try { return JSON.parse(v) } catch { return v.slice(1, -1) } }
-  if (v.length > 1 && v.startsWith("'") && v.endsWith("'")) return v.slice(1, -1).replace(/''/g, "'")
-  return v
-}
-
-export function splitFrontmatter(raw = '') {
-  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/)
-  if (!match) return { has: false, fields: [], body: raw }
-  const fields = []
-  const lines = match[1].split(/\r?\n/)
-  for (let i = 0; i < lines.length; i++) {
-    const kv = lines[i].match(/^([A-Za-z_][\w -]*):\s*(.*)$/)
-    if (!kv) continue
-    let value = kv[2].trim()
-    if (!value) {
-      const items = []
-      while (i + 1 < lines.length && /^\s+-\s+/.test(lines[i + 1])) { i++; items.push(lines[i].replace(/^\s+-\s+/, '').trim()) }
-      value = items.length ? items : ''
-    } else if (value.startsWith('[') && value.endsWith(']')) {
-      value = value.slice(1, -1).split(',').map((t) => unquote(t.trim())).filter(Boolean)
-    } else {
-      value = unquote(value)
-    }
-    fields.push([kv[1], value])
-  }
-  return { has: true, fields, body: raw.slice(match[0].length) }
-}
-
-/* bare when YAML reads it back as the same string; quoted otherwise (a colon, a leading #, quotes) */
-const yamlScalar = (v) => (/^[\w./@+-][\w ./@+,-]*$/.test(v) || v === '' ? v : JSON.stringify(v))
-
-export function joinFrontmatter(fields, body = '') {
-  const rows = fields.filter(([key]) => String(key).trim())
-  if (!rows.length) return body
-  const yaml = rows.map(([key, v]) => (Array.isArray(v) ? `${key}: [${v.map(yamlScalar).join(', ')}]` : `${key}: ${yamlScalar(String(v ?? ''))}`)).join('\n')
-  return `---\n${yaml}\n---\n${body.startsWith('\n') ? body.slice(1) : body}`
-}