@aryacode/dsh-aryacode-polish 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.14.0] - 2026-10-28
+
+### Added
+
+- **Quick switcher.** Ctrl/⌘-K (or Cmd-K) opens a palette over everything: every session
+  in every workspace, ranked so a prefix beats a mention, arrows to walk, Enter to open,
+  Escape to dismiss. Rows show the session title and the workspace it lives in.
+- **Folded state persists.** Which workspaces and which folders are collapsed is kept
+  under `aryacode-polish:folded.v1`, so reopening the app looks like it did on the way
+  out. A storage that refuses costs the memory and nothing else.
+
 ## [0.13.1] - 2026-10-28
 
 ### Added

package/client/workspace.js

@@ -384,6 +384,121 @@ export function moveBefore(list, movingId, beforeId) {
 
 const LOOK_KEY = 'aryacode-polish:workspace-appearance.v1'
 const ORDER_KEY = 'aryacode-polish:workspace-order.v1'
+const FOLD_KEY = 'aryacode-polish:folded.v1'
+
+/** Which workspaces and folders are folded, kept so a restart looks like yesterday. */
+export function readFolded(storage) {
+  try {
+    const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+    if (!store) return { workspaces: {}, folders: {} }
+    const raw = store.getItem(FOLD_KEY)
+    if (!raw) return { workspaces: {}, folders: {} }
+    const parsed = JSON.parse(raw)
+    return {
+      workspaces: (parsed && parsed.workspaces) || {},
+      folders: (parsed && parsed.folders) || {},
+    }
+  } catch {
+    return { workspaces: {}, folders: {} }
+  }
+}
+
+export function writeFolded(state, storage) {
+  try {
+    const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+    if (!store) return
+    const clean = {
+      workspaces: (state && state.workspaces) || {},
+      folders: (state && state.folders) || {},
+    }
+    store.setItem(FOLD_KEY, JSON.stringify(clean))
+  } catch {
+    /* folding is a convenience; a store that refuses must not break the tree */
+  }
+}
+
+/**
+ * Rank the quick switcher's rows. A title that starts with the query wins over one
+ * that merely contains it, and equal kinds keep the order they arrived in — so
+ * typing "gre" puts Greeting above anything that mentions greeting later on.
+ */
+export function rankMatches(items, query, text = (item) => String(item.title || item.id || '')) {
+  const list = Array.isArray(items) ? items : []
+  const needle = String(query || '').trim().toLowerCase()
+  if (!needle) return list.slice(0, 40)
+  const scored = []
+  list.forEach((item, order) => {
+    const hay = text(item).toLowerCase()
+    const at = hay.indexOf(needle)
+    if (at === -1) return
+    scored.push({ item, rank: at === 0 ? 0 : 1, order })
+  })
+  scored.sort((a, b) => (a.rank - b.rank) || (a.order - b.order))
+  return scored.slice(0, 40).map((entry) => entry.item)
+}
+
+const SWITCHER_BACKDROP = {
+  position: 'fixed',
+  inset: 0,
+  zIndex: 1300,
+  display: 'flex',
+  alignItems: 'flex-start',
+  justifyContent: 'center',
+  paddingTop: '12vh',
+  background: 'rgba(16, 18, 22, 0.28)',
+}
+
+const SWITCHER_CARD = {
+  width: 'min(560px, calc(100vw - 32px))',
+  maxHeight: '60vh',
+  overflow: 'hidden',
+  display: 'flex',
+  flexDirection: 'column',
+  borderRadius: 'var(--dsw-radius-lg, 10px)',
+  border: '0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.12))',
+  background: 'Canvas',
+  boxShadow: 'var(--dsw-elevation-prominent, 0 8px 24px rgba(0,0,0,0.18))',
+  color: 'var(--dsw-alias-label-primary, #1b1d21)',
+}
+
+const SWITCHER_INPUT = {
+  border: 'none',
+  borderBottom: '0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.12))',
+  background: 'transparent',
+  color: 'inherit',
+  fontSize: '14px',
+  padding: '12px 14px',
+  outline: 'none',
+}
+
+const SWITCHER_LIST = {
+  overflowY: 'auto',
+  padding: '4px',
+  display: 'flex',
+  flexDirection: 'column',
+  gap: '1px',
+}
+
+const SWITCHER_ROW = {
+  display: 'flex',
+  alignItems: 'center',
+  gap: '8px',
+  padding: '7px 10px',
+  border: 'none',
+  borderRadius: 'var(--dsw-radius-sm, 6px)',
+  background: 'transparent',
+  color: 'inherit',
+  fontSize: '13px',
+  textAlign: 'left',
+  cursor: 'pointer',
+}
+
+const SWITCHER_HINT = {
+  flex: 'none',
+  color: 'var(--dsw-alias-label-quaternary, #8a8a8a)',
+  fontSize: '11px',
+  fontVariantNumeric: 'tabular-nums',
+}
 
 /**
  * A workspace whose label carries a path ("Work/Client A") files itself under
@@ -586,7 +701,7 @@ export function BetterWorkspace(props) {
   const services = props.services || {}
   const { ctx, slots } = services
   const standard = { wide: props.wide === true, expandSidebar: props.expandSidebar }
-  const [expanded, setExpanded] = React.useState({})
+  const [expanded, setExpanded] = React.useState(() => readFolded().workspaces)
   const [menu, setMenu] = React.useState(null)
   const [armed, setArmed] = React.useState(null)
   const [adding, setAdding] = React.useState(false)
@@ -597,7 +712,10 @@ export function BetterWorkspace(props) {
   const [drag, setDrag] = React.useState(null)
   const [dropping, setDropping] = React.useState(null)
   const [look, setLook] = React.useState(() => readAppearance())
-  const [folders, setFolders] = React.useState({})
+  const folded = React.useMemo(() => readFolded(), [])
+  const [folders, setFolders] = React.useState(folded.folders)
+  const [switcher, setSwitcher] = React.useState(null)
+  React.useEffect(() => { writeFolded({ workspaces: expanded, folders }) }, [expanded, folders])
   const [renaming, setRenaming] = React.useState(null)
   const commitRename = async () => {
     const draft = renaming
@@ -664,6 +782,36 @@ export function BetterWorkspace(props) {
     return () => document.removeEventListener('keydown', onShortcut)
   }, [])
 
+  React.useEffect(() => {
+    const onOpen = (event) => {
+      const key = (event.key || '').toLowerCase()
+      if (!(event.ctrlKey || event.metaKey) || key !== 'k') return
+      event.preventDefault()
+      setSwitcher((prev) => (prev ? null : { query: '', index: 0 }))
+    }
+    const onEscape = (event) => {
+      if (event.key === 'Escape') setSwitcher(null)
+    }
+    document.addEventListener('keydown', onOpen)
+    document.addEventListener('keydown', onEscape)
+    return () => {
+      document.removeEventListener('keydown', onOpen)
+      document.removeEventListener('keydown', onEscape)
+    }
+  }, [])
+
+  const switchItems = React.useMemo(() => {
+    const items = []
+    allRows.forEach((group) => {
+      const workspace = workspaceLabel(group.workspace)
+      group.sessions.forEach((row) => {
+        items.push({ id: row.id, title: row.displayTitle || row.id, workspace })
+      })
+    })
+    return items
+  }, [allRows])
+  const switchHits = switcher ? rankMatches(switchItems, switcher.query) : []
+
   const openMenu = (event, row, workspace) => {
     event.preventDefault()
     event.stopPropagation()
@@ -882,6 +1030,56 @@ export function BetterWorkspace(props) {
       null)
     : null
 
+  const switcherCard = switcher
+    ? ReactDOM.createPortal(React.createElement('div', {
+      'data-polish-switcher': 'open',
+      style: SWITCHER_BACKDROP,
+      onPointerDown: (event) => { if (event.target === event.currentTarget) setSwitcher(null) },
+    },
+    React.createElement('div', { style: SWITCHER_CARD },
+      React.createElement('input', {
+        'data-polish-switcher-input': 'true',
+        autoFocus: true,
+        value: switcher.query,
+        placeholder: 'Jump to a session…',
+        'aria-label': 'Jump to a session',
+        style: SWITCHER_INPUT,
+        onChange: (event) => setSwitcher(Object.assign({}, switcher, { query: event.target.value, index: 0 })),
+        onKeyDown: (event) => {
+          if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            if (switchHits.length === 0) return
+            event.preventDefault()
+            const step = event.key === 'ArrowDown' ? 1 : -1
+            const next = (switcher.index + step + switchHits.length) % switchHits.length
+            setSwitcher(Object.assign({}, switcher, { index: next }))
+            return
+          }
+          if (event.key === 'Enter') {
+            const hit = switchHits[switcher.index]
+            if (!hit) return
+            event.preventDefault()
+            setSwitcher(null)
+            services.openSession(hit.id)
+          }
+        },
+      }),
+      React.createElement('div', { 'data-polish-switcher-list': 'true', style: SWITCHER_LIST },
+        switchHits.length === 0
+          ? React.createElement('div', { style: Object.assign({}, SWITCHER_ROW, { cursor: 'default' }) }, 'No session matches that.')
+          : switchHits.map((hit, at) => React.createElement('button', {
+            key: hit.id,
+            type: 'button',
+            'data-polish-switcher-row': hit.id,
+            style: Object.assign({}, SWITCHER_ROW, {
+              background: at === switcher.index ? 'var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,0.06))' : 'transparent',
+            }),
+            onPointerDown: (event) => event.preventDefault(),
+            onClick: () => { setSwitcher(null); services.openSession(hit.id) },
+          },
+          React.createElement('span', { style: WS_TITLE }, hit.title),
+          React.createElement('span', { style: SWITCHER_HINT }, hit.workspace)))))), document.body)
+    : null
+
   const children = []
 
   children.push(React.createElement('div', { key: 'header', 'data-polish-ws': 'header', style: WS_HEADER },
@@ -1125,6 +1323,7 @@ export function BetterWorkspace(props) {
   shownCount < totalCount
     ? React.createElement('div', { key: 'count', style: WS_COUNT_NOTE }, String(shownCount) + ' of ' + String(totalCount) + ' sessions')
     : null,
+  switcherCard,
   sessionMenu,
   paintMenu,
   workspaceMenu)

package/docs/better-workspace.md

@@ -134,3 +134,21 @@ offers exactly one reorder verb (`insertBefore(movingId, beforeId)`), so restori
 one move per workspace that sits in the wrong slot. Ids the Host no longer has are
 filtered out first, so a preset that names a deleted workspace cannot shuffle the
 survivors into the wrong places.
+
+## Quick switcher
+
+Ctrl/⌘-K opens a palette over every session in every workspace: the list is
+`rankMatches(allSessions, query)`, which scores a title that *starts* with the query
+above one that merely mentions it and keeps arrival order inside a rank (so "gre" puts
+Greeting above later mentions). Arrows walk, Enter opens the session through
+`uiWorkspace.openSession`, Escape or a backdrop click dismisses. It is portalled to
+`document.body` with its own backdrop, so neither the sidebar's scroll container nor a
+panel's stacking context can clip it.
+
+## Folded state
+
+`expanded` (workspaces) and `folders` (title folders) are seeded from
+`aryacode-polish:folded.v1` and written back whenever either changes, so a restart looks
+like the way out. Verified across a real restart: folding `WORK` left
+`{"workspaces":{},"folders":{"Work":true}}` in storage and the folder still read `› WORK 2`
+with its workspace hidden.

package/lib/client.js

@@ -53,7 +53,7 @@ window.__ModuleLoader__.load({
     ]
     const ROW_ID = "polish"
     const ROW_KEY = "@aryacode/dsh-aryacode-polish" + '#' + ROW_ID
-    const CLIENT_VERSION = "0.13.1"
+    const CLIENT_VERSION = "0.14.0"
 
 /* html2canvas 1.4.1 — MIT, vendored from vendor/html2canvas.min.js.
  * A UMD build, so it assigns itself to globalThis; face.js reads it lazily. */
@@ -585,6 +585,121 @@ window.__ModuleLoader__.load({
 
     const LOOK_KEY = 'aryacode-polish:workspace-appearance.v1'
     const ORDER_KEY = 'aryacode-polish:workspace-order.v1'
+    const FOLD_KEY = 'aryacode-polish:folded.v1'
+
+    /** Which workspaces and folders are folded, kept so a restart looks like yesterday. */
+    function readFolded(storage) {
+      try {
+        const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+        if (!store) return { workspaces: {}, folders: {} }
+        const raw = store.getItem(FOLD_KEY)
+        if (!raw) return { workspaces: {}, folders: {} }
+        const parsed = JSON.parse(raw)
+        return {
+          workspaces: (parsed && parsed.workspaces) || {},
+          folders: (parsed && parsed.folders) || {},
+        }
+      } catch {
+        return { workspaces: {}, folders: {} }
+      }
+    }
+
+    function writeFolded(state, storage) {
+      try {
+        const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+        if (!store) return
+        const clean = {
+          workspaces: (state && state.workspaces) || {},
+          folders: (state && state.folders) || {},
+        }
+        store.setItem(FOLD_KEY, JSON.stringify(clean))
+      } catch {
+        /* folding is a convenience; a store that refuses must not break the tree */
+      }
+    }
+
+    /**
+     * Rank the quick switcher's rows. A title that starts with the query wins over one
+     * that merely contains it, and equal kinds keep the order they arrived in — so
+     * typing "gre" puts Greeting above anything that mentions greeting later on.
+     */
+    function rankMatches(items, query, text = (item) => String(item.title || item.id || '')) {
+      const list = Array.isArray(items) ? items : []
+      const needle = String(query || '').trim().toLowerCase()
+      if (!needle) return list.slice(0, 40)
+      const scored = []
+      list.forEach((item, order) => {
+        const hay = text(item).toLowerCase()
+        const at = hay.indexOf(needle)
+        if (at === -1) return
+        scored.push({ item, rank: at === 0 ? 0 : 1, order })
+      })
+      scored.sort((a, b) => (a.rank - b.rank) || (a.order - b.order))
+      return scored.slice(0, 40).map((entry) => entry.item)
+    }
+
+    const SWITCHER_BACKDROP = {
+      position: 'fixed',
+      inset: 0,
+      zIndex: 1300,
+      display: 'flex',
+      alignItems: 'flex-start',
+      justifyContent: 'center',
+      paddingTop: '12vh',
+      background: 'rgba(16, 18, 22, 0.28)',
+    }
+
+    const SWITCHER_CARD = {
+      width: 'min(560px, calc(100vw - 32px))',
+      maxHeight: '60vh',
+      overflow: 'hidden',
+      display: 'flex',
+      flexDirection: 'column',
+      borderRadius: 'var(--dsw-radius-lg, 10px)',
+      border: '0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.12))',
+      background: 'Canvas',
+      boxShadow: 'var(--dsw-elevation-prominent, 0 8px 24px rgba(0,0,0,0.18))',
+      color: 'var(--dsw-alias-label-primary, #1b1d21)',
+    }
+
+    const SWITCHER_INPUT = {
+      border: 'none',
+      borderBottom: '0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.12))',
+      background: 'transparent',
+      color: 'inherit',
+      fontSize: '14px',
+      padding: '12px 14px',
+      outline: 'none',
+    }
+
+    const SWITCHER_LIST = {
+      overflowY: 'auto',
+      padding: '4px',
+      display: 'flex',
+      flexDirection: 'column',
+      gap: '1px',
+    }
+
+    const SWITCHER_ROW = {
+      display: 'flex',
+      alignItems: 'center',
+      gap: '8px',
+      padding: '7px 10px',
+      border: 'none',
+      borderRadius: 'var(--dsw-radius-sm, 6px)',
+      background: 'transparent',
+      color: 'inherit',
+      fontSize: '13px',
+      textAlign: 'left',
+      cursor: 'pointer',
+    }
+
+    const SWITCHER_HINT = {
+      flex: 'none',
+      color: 'var(--dsw-alias-label-quaternary, #8a8a8a)',
+      fontSize: '11px',
+      fontVariantNumeric: 'tabular-nums',
+    }
 
     /**
      * A workspace whose label carries a path ("Work/Client A") files itself under
@@ -787,7 +902,7 @@ window.__ModuleLoader__.load({
       const services = props.services || {}
       const { ctx, slots } = services
       const standard = { wide: props.wide === true, expandSidebar: props.expandSidebar }
-      const [expanded, setExpanded] = React.useState({})
+      const [expanded, setExpanded] = React.useState(() => readFolded().workspaces)
       const [menu, setMenu] = React.useState(null)
       const [armed, setArmed] = React.useState(null)
       const [adding, setAdding] = React.useState(false)
@@ -798,7 +913,10 @@ window.__ModuleLoader__.load({
       const [drag, setDrag] = React.useState(null)
       const [dropping, setDropping] = React.useState(null)
       const [look, setLook] = React.useState(() => readAppearance())
-      const [folders, setFolders] = React.useState({})
+      const folded = React.useMemo(() => readFolded(), [])
+      const [folders, setFolders] = React.useState(folded.folders)
+      const [switcher, setSwitcher] = React.useState(null)
+      React.useEffect(() => { writeFolded({ workspaces: expanded, folders }) }, [expanded, folders])
       const [renaming, setRenaming] = React.useState(null)
       const commitRename = async () => {
         const draft = renaming
@@ -865,6 +983,36 @@ window.__ModuleLoader__.load({
         return () => document.removeEventListener('keydown', onShortcut)
       }, [])
 
+      React.useEffect(() => {
+        const onOpen = (event) => {
+          const key = (event.key || '').toLowerCase()
+          if (!(event.ctrlKey || event.metaKey) || key !== 'k') return
+          event.preventDefault()
+          setSwitcher((prev) => (prev ? null : { query: '', index: 0 }))
+        }
+        const onEscape = (event) => {
+          if (event.key === 'Escape') setSwitcher(null)
+        }
+        document.addEventListener('keydown', onOpen)
+        document.addEventListener('keydown', onEscape)
+        return () => {
+          document.removeEventListener('keydown', onOpen)
+          document.removeEventListener('keydown', onEscape)
+        }
+      }, [])
+
+      const switchItems = React.useMemo(() => {
+        const items = []
+        allRows.forEach((group) => {
+          const workspace = workspaceLabel(group.workspace)
+          group.sessions.forEach((row) => {
+            items.push({ id: row.id, title: row.displayTitle || row.id, workspace })
+          })
+        })
+        return items
+      }, [allRows])
+      const switchHits = switcher ? rankMatches(switchItems, switcher.query) : []
+
       const openMenu = (event, row, workspace) => {
         event.preventDefault()
         event.stopPropagation()
@@ -1083,6 +1231,56 @@ window.__ModuleLoader__.load({
           null)
         : null
 
+      const switcherCard = switcher
+        ? ReactDOM.createPortal(React.createElement('div', {
+          'data-polish-switcher': 'open',
+          style: SWITCHER_BACKDROP,
+          onPointerDown: (event) => { if (event.target === event.currentTarget) setSwitcher(null) },
+        },
+        React.createElement('div', { style: SWITCHER_CARD },
+          React.createElement('input', {
+            'data-polish-switcher-input': 'true',
+            autoFocus: true,
+            value: switcher.query,
+            placeholder: 'Jump to a session…',
+            'aria-label': 'Jump to a session',
+            style: SWITCHER_INPUT,
+            onChange: (event) => setSwitcher(Object.assign({}, switcher, { query: event.target.value, index: 0 })),
+            onKeyDown: (event) => {
+              if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+                if (switchHits.length === 0) return
+                event.preventDefault()
+                const step = event.key === 'ArrowDown' ? 1 : -1
+                const next = (switcher.index + step + switchHits.length) % switchHits.length
+                setSwitcher(Object.assign({}, switcher, { index: next }))
+                return
+              }
+              if (event.key === 'Enter') {
+                const hit = switchHits[switcher.index]
+                if (!hit) return
+                event.preventDefault()
+                setSwitcher(null)
+                services.openSession(hit.id)
+              }
+            },
+          }),
+          React.createElement('div', { 'data-polish-switcher-list': 'true', style: SWITCHER_LIST },
+            switchHits.length === 0
+              ? React.createElement('div', { style: Object.assign({}, SWITCHER_ROW, { cursor: 'default' }) }, 'No session matches that.')
+              : switchHits.map((hit, at) => React.createElement('button', {
+                key: hit.id,
+                type: 'button',
+                'data-polish-switcher-row': hit.id,
+                style: Object.assign({}, SWITCHER_ROW, {
+                  background: at === switcher.index ? 'var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,0.06))' : 'transparent',
+                }),
+                onPointerDown: (event) => event.preventDefault(),
+                onClick: () => { setSwitcher(null); services.openSession(hit.id) },
+              },
+              React.createElement('span', { style: WS_TITLE }, hit.title),
+              React.createElement('span', { style: SWITCHER_HINT }, hit.workspace)))))), document.body)
+        : null
+
       const children = []
 
       children.push(React.createElement('div', { key: 'header', 'data-polish-ws': 'header', style: WS_HEADER },
@@ -1326,6 +1524,7 @@ window.__ModuleLoader__.load({
       shownCount < totalCount
         ? React.createElement('div', { key: 'count', style: WS_COUNT_NOTE }, String(shownCount) + ' of ' + String(totalCount) + ' sessions')
         : null,
+      switcherCard,
       sessionMenu,
       paintMenu,
       workspaceMenu)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryacode/dsh-aryacode-polish",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "AryaCode Polish: one install for the small things that make AryaCode feel finished. One Plugins row, one switch per quality-of-life feature.",
   "keywords": [
     "dsh",