@aryacode/dsh-aryacode-polish 0.20.0 → 0.21.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.21.2] - 2026-10-28
+
+Fixed: the folders-only density showed a zero count because it read the hidden session list instead of the real one.
+
+ - 2026-10-28
+
+Added: a folders-only density that hides session rows, and [ / ] to hop between workspaces.
+
 ## [0.20.0] - 2026-10-28
 
 Added: session flags and notes, shown on the row and on hover; the whole tree can be copied as indented text from the header.

package/client/workspace.js

@@ -371,6 +371,23 @@ export function flattenRows(rows, expanded, query) {
   return flat
 }
 
+/** Where the cursor lands when hopping to the next or previous workspace head. */
+export function jumpWorkspace(list, cursor, step) {
+  const flat = Array.isArray(list) ? list : []
+  const heads = []
+  flat.forEach((item, index) => {
+    if (item && item.kind === 'workspace') heads.push(index)
+  })
+  if (heads.length === 0) return -1
+  if (cursor === undefined || cursor < 0) return step > 0 ? heads[0] : heads[heads.length - 1]
+  if (step > 0) {
+    const after = heads.find(index => index > cursor)
+    return after === undefined ? heads[0] : after
+  }
+  const before = heads.filter(index => index < cursor)
+  return before.length === 0 ? heads[heads.length - 1] : before[before.length - 1]
+}
+
 export function moveBefore(list, movingId, beforeId) {
   const from = list.findIndex(item => item.id === movingId)
   const to = list.findIndex(item => item.id === beforeId)
@@ -522,16 +539,34 @@ export function folderNamesOf(rows, declared) {
   return seen
 }
 
-export const DENSITIES = ['comfortable', 'compact']
+export const DENSITIES = ['comfortable', 'compact', 'folders']
 
 /** Row height per density: the tree fits more rows without shrinking the text. */
 export const DENSITY_METRICS = {
-  comfortable: { row: '28px' },
-  compact: { row: '22px' },
+  comfortable: { row: '28px', sessions: true },
+  compact: { row: '22px', sessions: true },
+  folders: { row: '24px', sessions: false },
+}
+
+export const DENSITY_TITLES = {
+  comfortable: 'Use compact rows',
+  compact: 'Show folders only',
+  folders: 'Use comfortable rows',
+}
+
+export const DENSITY_GLYPHS = {
+  comfortable: '\u2263',
+  compact: '\u2261',
+  folders: '\u25a4',
 }
 
 export function densityOf(value) {
-  return value === 'compact' ? 'compact' : 'comfortable'
+  return DENSITIES.indexOf(value) >= 0 ? value : 'comfortable'
+}
+
+export function nextDensity(value) {
+  const list = DENSITIES
+  return list[(list.indexOf(densityOf(value)) + 1) % list.length]
 }
 
 export function readDensity(storage) {
@@ -1193,7 +1228,17 @@ export function BetterWorkspace(props) {
     if (item.kind === 'workspace') toggleWorkspace(item.workspaceId)
     else services.openSession(item.id)
   }
+  /** [ and ] hop between workspace heads: the fast way through a long tree. */
+  const hopWorkspace = (step) => {
+    const next = jumpWorkspace(walk, cursor, step)
+    if (next >= 0) setCursor(next)
+  }
   const onKeyDown = (event) => {
+    if (event.key === '[' || event.key === ']') {
+      event.preventDefault()
+      hopWorkspace(event.key === ']' ? 1 : -1)
+      return
+    }
     if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
       if (walk.length === 0) return
       event.preventDefault()
@@ -1667,15 +1712,15 @@ export function BetterWorkspace(props) {
       key: 'density',
       type: 'button',
       'data-polish-ws-density': densityOf(density),
-      title: densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
-      'aria-label': densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
+      title: DENSITY_TITLES[densityOf(density)],
+      'aria-label': DENSITY_TITLES[densityOf(density)],
       style: WS_ADD,
       onClick: () => {
-        const next = densityOf(density) === 'compact' ? 'comfortable' : 'compact'
+        const next = nextDensity(density)
         setDensity(next)
         writeDensity(next)
       },
-    }, densityOf(density) === 'compact' ? '≡' : '≣'),
+    }, DENSITY_GLYPHS[densityOf(density)]),
     React.createElement('button', {
       key: 'add',
       type: 'button',
@@ -1936,7 +1981,7 @@ export function BetterWorkspace(props) {
       : null)))
 
     if (open) {
-      sessions.forEach((row) => {
+      (metrics.sessions ? sessions : []).forEach((row) => {
         index += 1
         children.push(sessionRow(workspace, row, index))
       })

package/docs/better-workspace.md

@@ -239,3 +239,21 @@ session that no longer exists is simply never drawn.
 The header's `⧉` copies the whole tree as indented text — folders, workspaces, sessions, with
 `⚑` before a flagged session — through `navigator.clipboard.writeText`. It is meant for pasting
 into a prompt or an issue: "here is what I am looking at", without screenshots.
+
+## Folders only
+
+The density button walks three states, not two: comfortable, compact, and **folders only**. The
+last one keeps every folder and workspace row (with its real session count) and drops the session
+rows entirely — useful when you are navigating the shape of your work rather than a specific
+session. Nothing is lost: one more click returns to comfortable, and the mode is remembered in
+`aryacode-polish:density.v1`.
+
+One trap it exposed: the workspace count must come from the unfiltered session list. Reading the
+list the tree was about to draw made every workspace read `0` in this mode, which looked like the
+feature had eaten the sessions.
+
+## Hopping between workspaces
+
+With the tree focused, `[` and `]` move the keyboard cursor to the previous / next workspace head
+and wrap at the ends. It is a second gear next to ArrowUp/ArrowDown: arrows walk rows, brackets
+walk groups, so a long flat list of sessions stops being a scroll-and-squint exercise.

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.20.0"
+    const CLIENT_VERSION = "0.21.2"
 
 /* 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. */
@@ -572,6 +572,23 @@ window.__ModuleLoader__.load({
       return flat
     }
 
+    /** Where the cursor lands when hopping to the next or previous workspace head. */
+    function jumpWorkspace(list, cursor, step) {
+      const flat = Array.isArray(list) ? list : []
+      const heads = []
+      flat.forEach((item, index) => {
+        if (item && item.kind === 'workspace') heads.push(index)
+      })
+      if (heads.length === 0) return -1
+      if (cursor === undefined || cursor < 0) return step > 0 ? heads[0] : heads[heads.length - 1]
+      if (step > 0) {
+        const after = heads.find(index => index > cursor)
+        return after === undefined ? heads[0] : after
+      }
+      const before = heads.filter(index => index < cursor)
+      return before.length === 0 ? heads[heads.length - 1] : before[before.length - 1]
+    }
+
     function moveBefore(list, movingId, beforeId) {
       const from = list.findIndex(item => item.id === movingId)
       const to = list.findIndex(item => item.id === beforeId)
@@ -723,16 +740,34 @@ window.__ModuleLoader__.load({
       return seen
     }
 
-    const DENSITIES = ['comfortable', 'compact']
+    const DENSITIES = ['comfortable', 'compact', 'folders']
 
     /** Row height per density: the tree fits more rows without shrinking the text. */
     const DENSITY_METRICS = {
-      comfortable: { row: '28px' },
-      compact: { row: '22px' },
+      comfortable: { row: '28px', sessions: true },
+      compact: { row: '22px', sessions: true },
+      folders: { row: '24px', sessions: false },
+    }
+
+    const DENSITY_TITLES = {
+      comfortable: 'Use compact rows',
+      compact: 'Show folders only',
+      folders: 'Use comfortable rows',
+    }
+
+    const DENSITY_GLYPHS = {
+      comfortable: '\u2263',
+      compact: '\u2261',
+      folders: '\u25a4',
     }
 
     function densityOf(value) {
-      return value === 'compact' ? 'compact' : 'comfortable'
+      return DENSITIES.indexOf(value) >= 0 ? value : 'comfortable'
+    }
+
+    function nextDensity(value) {
+      const list = DENSITIES
+      return list[(list.indexOf(densityOf(value)) + 1) % list.length]
     }
 
     function readDensity(storage) {
@@ -1394,7 +1429,17 @@ window.__ModuleLoader__.load({
         if (item.kind === 'workspace') toggleWorkspace(item.workspaceId)
         else services.openSession(item.id)
       }
+      /** [ and ] hop between workspace heads: the fast way through a long tree. */
+      const hopWorkspace = (step) => {
+        const next = jumpWorkspace(walk, cursor, step)
+        if (next >= 0) setCursor(next)
+      }
       const onKeyDown = (event) => {
+        if (event.key === '[' || event.key === ']') {
+          event.preventDefault()
+          hopWorkspace(event.key === ']' ? 1 : -1)
+          return
+        }
         if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
           if (walk.length === 0) return
           event.preventDefault()
@@ -1868,15 +1913,15 @@ window.__ModuleLoader__.load({
           key: 'density',
           type: 'button',
           'data-polish-ws-density': densityOf(density),
-          title: densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
-          'aria-label': densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
+          title: DENSITY_TITLES[densityOf(density)],
+          'aria-label': DENSITY_TITLES[densityOf(density)],
           style: WS_ADD,
           onClick: () => {
-            const next = densityOf(density) === 'compact' ? 'comfortable' : 'compact'
+            const next = nextDensity(density)
             setDensity(next)
             writeDensity(next)
           },
-        }, densityOf(density) === 'compact' ? '≡' : '≣'),
+        }, DENSITY_GLYPHS[densityOf(density)]),
         React.createElement('button', {
           key: 'add',
           type: 'button',
@@ -2137,7 +2182,7 @@ window.__ModuleLoader__.load({
           : null)))
 
         if (open) {
-          sessions.forEach((row) => {
+          (metrics.sessions ? sessions : []).forEach((row) => {
             index += 1
             children.push(sessionRow(workspace, row, index))
           })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryacode/dsh-aryacode-polish",
-  "version": "0.20.0",
+  "version": "0.21.2",
   "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",