cursedbelt 5.34.0 → 5.35.0

package/dist/react/file-tree/folderView.js

@@ -0,0 +1,230 @@
+export const EMPTY_FOLDER_MARKS = Object.freeze({
+    hidden: Object.freeze([]),
+    tags: Object.freeze({}),
+});
+export const EMPTY_FOLDER_VIEW = Object.freeze({
+    showHidden: false,
+    only: Object.freeze([]),
+    hide: Object.freeze([]),
+});
+/** Longest tag kept. A tag is a word or two; anything longer is a sentence in the wrong field. */
+export const MAX_TAG_CHARS = 32;
+/**
+ * The one spelling of a tag: trimmed, inner whitespace collapsed, lower-cased, capped.
+ * `null` for nothing left — the caller treats that as "no tag", never as `""`.
+ */
+export function normalizeTag(raw) {
+    const tag = raw.trim().replace(/\s+/g, ' ').toLowerCase().slice(0, MAX_TAG_CHARS).trim();
+    return tag.length > 0 ? tag : null;
+}
+function uniqueTags(list) {
+    const out = [];
+    for (const raw of list) {
+        const tag = typeof raw === 'string' ? normalizeTag(raw) : null;
+        if (tag && !out.includes(tag))
+            out.push(tag);
+    }
+    return out;
+}
+/**
+ * Read stored marks. Anything malformed reads as nothing rather than throwing — a corrupt
+ * value must cost the person their marks on that one value, never the tree.
+ */
+export function parseFolderMarks(raw) {
+    if (!raw)
+        return EMPTY_FOLDER_MARKS;
+    try {
+        const value = JSON.parse(raw);
+        const hidden = Array.isArray(value.hidden)
+            ? [...new Set(value.hidden.filter((id) => typeof id === 'string' && id !== ''))]
+            : [];
+        const tags = {};
+        if (value.tags && typeof value.tags === 'object' && !Array.isArray(value.tags)) {
+            for (const [id, list] of Object.entries(value.tags)) {
+                if (!Array.isArray(list))
+                    continue;
+                const clean = uniqueTags(list);
+                if (clean.length > 0)
+                    tags[id] = clean;
+            }
+        }
+        return { hidden, tags };
+    }
+    catch {
+        return EMPTY_FOLDER_MARKS;
+    }
+}
+/** The stored form. `null` when there is nothing to keep, so an app can forget the key. */
+export function serializeFolderMarks(marks) {
+    const tags = Object.fromEntries(Object.entries(marks.tags).filter(([, list]) => list.length > 0));
+    if (marks.hidden.length === 0 && Object.keys(tags).length === 0)
+        return null;
+    return JSON.stringify({ v: 1, hidden: marks.hidden, tags });
+}
+/** Read a device's view. Same forgiving rule as {@link parseFolderMarks}. */
+export function parseFolderViewLocal(raw) {
+    if (!raw)
+        return EMPTY_FOLDER_VIEW;
+    try {
+        const value = JSON.parse(raw);
+        return {
+            showHidden: value.showHidden === true,
+            only: Array.isArray(value.only) ? uniqueTags(value.only) : [],
+            hide: Array.isArray(value.hide) ? uniqueTags(value.hide) : [],
+        };
+    }
+    catch {
+        return EMPTY_FOLDER_VIEW;
+    }
+}
+/** Hide or unhide these ids — a new value; the input is never touched. */
+export function setHidden(marks, ids, hidden) {
+    const next = hidden
+        ? [...marks.hidden, ...ids.filter((id) => !marks.hidden.includes(id))]
+        : marks.hidden.filter((id) => !ids.includes(id));
+    return next.length === marks.hidden.length && next.every((id, i) => id === marks.hidden[i])
+        ? marks
+        : { ...marks, hidden: next };
+}
+/** Replace one folder's tags. An empty list forgets the folder entirely. */
+export function setFolderTags(marks, id, tags) {
+    const clean = uniqueTags(tags);
+    const { [id]: _old, ...rest } = marks.tags;
+    return { ...marks, tags: clean.length > 0 ? { ...rest, [id]: clean } : rest };
+}
+/** Add or take away ONE tag on one folder — the tag editor's checkbox. */
+export function toggleFolderTag(marks, id, raw) {
+    const tag = normalizeTag(raw);
+    if (!tag)
+        return marks;
+    const current = marks.tags[id] ?? [];
+    return setFolderTags(marks, id, current.includes(tag) ? current.filter((t) => t !== tag) : [...current, tag]);
+}
+/**
+ * Every tag in use. Derived, never stored: a tag no folder carries any more simply stops
+ * existing, so there is no tag list to tidy and no orphan to delete.
+ */
+export function tagCounts(marks) {
+    const counts = new Map();
+    for (const list of Object.values(marks.tags))
+        for (const tag of list)
+            counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    return [...counts]
+        .map(([tag, count]) => ({ tag, count }))
+        .sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
+}
+/** How many colours a tag dot can be — `--cbft-tag-0` … `--cbft-tag-7` in fileTree.css. */
+export const TAG_HUES = 8;
+/**
+ * A tag's colour slot, from its name — the same tag is the same colour in every app, on every
+ * device, without a colour having to be chosen or stored. FNV-1a, because it is four lines and
+ * spreads short words well.
+ */
+export function tagHue(tag) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < tag.length; i++) {
+        hash ^= tag.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0) % TAG_HUES;
+}
+/** Whether a device's view narrows the tree by tag at all. */
+export function tagFilterActive(local) {
+    return local.only.length > 0 || local.hide.length > 0;
+}
+/** Cycle one tag in the device's filter: `'only'`, `'hide'`, or `null` for neither. */
+export function setTagFilter(local, raw, mode) {
+    const tag = normalizeTag(raw);
+    if (!tag)
+        return local;
+    const only = local.only.filter((t) => t !== tag);
+    const hide = local.hide.filter((t) => t !== tag);
+    if (mode === 'only')
+        only.push(tag);
+    if (mode === 'hide')
+        hide.push(tag);
+    return { ...local, only, hide };
+}
+/**
+ * The tree this device should draw. See the header for the five rules.
+ *
+ * Returns the input array itself when nothing is marked and nothing is filtered, so a tree
+ * with no marks pays one check and no copy.
+ */
+export function applyFolderView(nodes, marks, local) {
+    const hiddenMarks = new Map();
+    const filtering = tagFilterActive(local);
+    if (marks.hidden.length === 0 && !filtering)
+        return { nodes, hiddenMarks, hiddenCount: 0 };
+    const hiddenSet = new Set(marks.hidden);
+    const only = new Set(local.only);
+    const hide = new Set(local.hide);
+    let hiddenCount = 0;
+    const carries = (id, set) => set.size > 0 && (marks.tags[id] ?? []).some((tag) => set.has(tag));
+    /**
+     * `null` = drop the node. `inHidden`: an ancestor is hidden. `matched`: an ancestor
+     * carries an "only" tag (or there is no "only" filter at all).
+     */
+    const visit = (node, depth, inHidden, matched) => {
+        const selfHidden = hiddenSet.has(node.id);
+        if (selfHidden)
+            hiddenCount++;
+        const hiddenState = selfHidden ? 'self' : inHidden ? 'inherited' : null;
+        if (hiddenState && !local.showHidden) {
+            // Still counted below it — "Show hidden folders (3)" counts nested ones too.
+            if (node.children)
+                countHidden(node.children);
+            return null;
+        }
+        if (carries(node.id, hide)) {
+            if (node.children)
+                countHidden(node.children);
+            return null;
+        }
+        const isMatch = matched || carries(node.id, only);
+        if (node.kind !== 'folder') {
+            // Rule 4: a top-level file is in no folder; a nested one follows its folder.
+            if (!isMatch && depth > 0)
+                return null;
+            if (hiddenState)
+                hiddenMarks.set(node.id, hiddenState);
+            return node;
+        }
+        let children = node.children;
+        if (node.children) {
+            const kept = [];
+            let changed = false;
+            for (const child of node.children) {
+                const out = visit(child, depth + 1, hiddenState !== null, isMatch);
+                if (out)
+                    kept.push(out);
+                if (out !== child)
+                    changed = true;
+            }
+            if (changed)
+                children = kept;
+        }
+        // Rule 3: an unmatched folder survives only as the way to a matched one.
+        if (!isMatch && (!children || children.length === 0))
+            return null;
+        if (hiddenState)
+            hiddenMarks.set(node.id, hiddenState);
+        return children === node.children ? node : { ...node, children: children ?? [] };
+    };
+    const countHidden = (list) => {
+        for (const node of list) {
+            if (hiddenSet.has(node.id))
+                hiddenCount++;
+            if (node.children)
+                countHidden(node.children);
+        }
+    };
+    const out = [];
+    for (const node of nodes) {
+        const kept = visit(node, 0, false, only.size === 0);
+        if (kept)
+            out.push(kept);
+    }
+    return { nodes: out, hiddenMarks, hiddenCount };
+}
+//# sourceMappingURL=folderView.js.map

package/dist/react/file-tree/folderView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderView.js","sourceRoot":"","sources":["../../../src/react/file-tree/folderView.ts"],"names":[],"mappings":"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"}

package/dist/react/file-tree/folderViewPanels.css

@@ -0,0 +1,217 @@
+/*
+ * The file tree's right-click panels — the menus' own pieces, the tag filter and the tag editor.
+ *
+ * Its own stylesheet because its own CHUNK: `FolderViewPanels.tsx` is loaded on demand (see its
+ * header), and a bundler ships a lazily imported module's CSS with it. Plain `cbft-` CSS for the
+ * reason `fileTree.css` gives in its header.
+ */
+
+/* ── The menus' own pieces (the panel and its items are the belt's `Popover` and `Menu`) ── */
+
+.cbft-menu-panel {
+	min-inline-size: 12rem;
+	max-inline-size: min(20rem, calc(100vw - 16px));
+}
+
+.cbft-fv-head {
+	display: flex;
+	align-items: baseline;
+	justify-content: space-between;
+	gap: 0.5rem;
+	padding-inline-end: 0.5rem;
+}
+
+.cbft-fv-scope {
+	font-size: 0.75rem;
+	color: var(--muted-foreground);
+	cursor: help;
+}
+
+.cbft-fv-empty {
+	margin: 0;
+	padding: 0.25rem 0.5rem 0.5rem;
+	font-size: 0.75rem;
+	line-height: 1.4;
+	color: var(--muted-foreground);
+}
+
+/* The belt's ScrollArea does the scrolling (and fades the cut edge); this only bounds it. */
+.cbft-fv-scroll {
+	max-block-size: 15rem;
+}
+
+.cbft-fv-list {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+}
+
+.cbft-fv-row {
+	display: flex;
+	align-items: center;
+	gap: 0.5rem;
+	min-block-size: 2rem;
+	padding: 0.125rem 0.25rem 0.125rem 0.5rem;
+	border-radius: var(--radius-sm, 0.375rem);
+	font-size: 0.875rem;
+}
+
+.cbft-fv-row:hover {
+	background: color-mix(in srgb, var(--muted-foreground) 8%, transparent);
+}
+
+.cbft-fv-name {
+	flex: 1 1 auto;
+	min-inline-size: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
+.cbft-fv-count {
+	flex: none;
+	font-size: 0.75rem;
+	color: var(--muted-foreground);
+	font-variant-numeric: tabular-nums;
+}
+
+/* Two toggles, joined — a segmented control in miniature. Off is quiet; on is the accent. */
+.cbft-fv-seg {
+	flex: none;
+	display: inline-flex;
+	/* A <fieldset>, so the browser's own frame comes off first. */
+	margin: 0;
+	padding: 0;
+	min-inline-size: 0;
+	border: 1px solid var(--border);
+	border-radius: var(--radius-sm, 0.375rem);
+	overflow: hidden;
+}
+
+.cbft-fv-seg button {
+	border: 0;
+	background: transparent;
+	color: var(--muted-foreground);
+	font: inherit;
+	font-size: 0.75rem;
+	padding: 0.1875rem 0.5rem;
+	min-block-size: 1.5rem;
+	cursor: pointer;
+}
+
+.cbft-fv-seg button + button {
+	border-inline-start: 1px solid var(--border);
+}
+
+.cbft-fv-seg button:hover {
+	background: color-mix(in srgb, var(--muted-foreground) 12%, transparent);
+	color: var(--foreground);
+}
+
+.cbft-fv-seg button:focus-visible {
+	outline: 2px solid var(--ring, var(--accent-solid));
+	outline-offset: -2px;
+}
+
+.cbft-fv-seg button[aria-pressed='true'] {
+	background: var(--accent-solid);
+	color: var(--accent-solid-foreground);
+}
+
+.cbft-fv-row[data-mode='hide'] .cbft-fv-name {
+	text-decoration: line-through;
+	color: var(--muted-foreground);
+}
+
+.cbft-fv-clear {
+	display: block;
+	inline-size: 100%;
+	margin-block-start: 0.25rem;
+	padding: 0.375rem 0.5rem;
+	border: 0;
+	border-radius: var(--radius-sm, 0.375rem);
+	background: transparent;
+	color: var(--accent);
+	font: inherit;
+	font-size: 0.8125rem;
+	text-align: start;
+	cursor: pointer;
+}
+
+.cbft-fv-clear:hover,
+.cbft-fv-clear:focus-visible {
+	background: color-mix(in srgb, var(--muted-foreground) 10%, transparent);
+	outline: none;
+}
+
+/* ── The tag editor — Gmail's "Label as" ─────────────────────────────────────────────── */
+
+.cbft-te {
+	display: flex;
+	flex-direction: column;
+	gap: 0.25rem;
+}
+
+.cbft-te-head {
+	padding: 0.25rem 0.5rem 0;
+	font-size: 0.8125rem;
+	font-weight: 600;
+	color: var(--foreground);
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
+.cbft-te-input {
+	/* The belt's Input draws itself; this only spaces it inside the panel. */
+	margin: 0.25rem;
+	inline-size: auto;
+}
+
+.cbft-te-scroll {
+	max-block-size: 14rem;
+}
+
+.cbft-te-option {
+	display: flex;
+	align-items: center;
+	gap: 0.5rem;
+	min-block-size: 2rem;
+	padding: 0.25rem 0.5rem;
+	border-radius: var(--radius-sm, 0.375rem);
+	font-size: 0.875rem;
+	cursor: pointer;
+}
+
+.cbft-te-option[data-active] {
+	background: color-mix(in srgb, var(--muted-foreground) 14%, transparent);
+}
+
+.cbft-te-check {
+	flex: none;
+	inline-size: 1rem;
+	text-align: center;
+	color: var(--accent);
+	font-weight: 700;
+}
+
+.cbft-te-foot {
+	margin: 0;
+	padding: 0.25rem 0.5rem 0.375rem;
+	border-block-start: 1px solid color-mix(in srgb, var(--border) 70%, transparent);
+	font-size: 0.75rem;
+	color: var(--muted-foreground);
+}
+
+/* A coarse pointer gets the 44px hit targets every other control in this tree gets. */
+@media (pointer: coarse) {
+	.cbft-fv-row,
+	.cbft-te-option {
+		min-block-size: 44px;
+	}
+
+	.cbft-fv-seg button {
+		min-block-size: 36px;
+		padding-inline: 0.75rem;
+	}
+}

package/dist/react/file-tree/index.d.ts

@@ -1,4 +1,6 @@
 export { type AccessMarkCopy, accessMarkCopy, descendantIdsOf, type DropOffer, type FileTreeAccess, type FileTreeDrop, type FileTreeNode, type FileTreeNodeKind, type FileTreeRow, filterFileTree, findFileTreeNode, flattenFileTree, matchTypeahead, parentIdOf, resolveDrop, walkFileTree, } from 'cursedbelt-core/file-tree/file-tree-model';
 export { FileTree, type FileTreeProps } from './FileTree.js';
 export { draggedIdsOf, nodesByIds, planWrap, refuseCopy, refuseWrap, type ResolveMultiDropOptions, resolveMultiDrop, selectionRange, toggleSelected, topmostSelected, type WrapPlan, wrapFolderName, } from './fileTreeSelection.js';
+export { type FileTreeMenuItem, folderTargets, folderViewMenuItems, withFolderItems, } from './FolderViewMenus.js';
+export { type FolderView, type UseFolderViewOptions, useFolderView } from './useFolderView.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/file-tree/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/file-tree/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,eAAe,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAQ7D,OAAO,EACL,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,KAAK,QAAQ,EACb,cAAc,GACf,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/file-tree/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,eAAe,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAQ7D,OAAO,EACL,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,KAAK,QAAQ,EACb,cAAc,GACf,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EACL,KAAK,gBAAgB,EACrB,aAAa,EACb,mBAAmB,EACnB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/react/file-tree/index.js

@@ -22,4 +22,13 @@ export { FileTree } from './FileTree.js';
  * header of `fileTreeSelection.ts`.
  */
 export { draggedIdsOf, nodesByIds, planWrap, refuseCopy, refuseWrap, resolveMultiDrop, selectionRange, toggleSelected, topmostSelected, wrapFolderName, } from './fileTreeSelection.js';
+/*
+ * Hidden folders and folder tags (owner, 2026-09-30) — `useFolderView({ key })` handed to the
+ * tree's `folderView` prop, and its `onContextMenu` on the app's header over the tree. The rules
+ * are DOM-free in `folderView.ts`; the menus, tag editor and strip are `FolderViewMenus.tsx`.
+ * `folderViewMenuItems` is for an app's own ⋯ menu, so it offers exactly what the right-click
+ * does; `FileTreeMenuItem` is `DropdownMenuItem`'s shape, for `rowMenu`/`backgroundMenu`.
+ */
+export { folderTargets, folderViewMenuItems, withFolderItems, } from './FolderViewMenus.js';
+export { useFolderView } from './useFolderView.js';
 //# sourceMappingURL=index.js.map

package/dist/react/file-tree/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/file-tree/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,uFAAuF;AACvF,0FAA0F;AAC1F,2CAA2C;AAC3C,EAAE;AACF,8EAA8E;AAC9E,EAAE;AACF,oFAAoF;AACpF,0FAA0F;AAC1F,yFAAyF;AACzF,0FAA0F;AAC1F,0BAA0B;AAC1B,EAAE;AACF,yEAAyE;AACzE,OAAO,EAEL,cAAc,EACd,eAAe,EAOf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAC7D;;;;;;GAMG;AACH,OAAO,EACL,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EAEV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EAEf,cAAc,GACf,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/file-tree/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,uFAAuF;AACvF,0FAA0F;AAC1F,2CAA2C;AAC3C,EAAE;AACF,8EAA8E;AAC9E,EAAE;AACF,oFAAoF;AACpF,0FAA0F;AAC1F,yFAAyF;AACzF,0FAA0F;AAC1F,0BAA0B;AAC1B,EAAE;AACF,yEAAyE;AACzE,OAAO,EAEL,cAAc,EACd,eAAe,EAOf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAC7D;;;;;;GAMG;AACH,OAAO,EACL,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EAEV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EAEf,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC;;;;;;GAMG;AACH,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA8C,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/react/file-tree/useFolderView.d.ts

@@ -0,0 +1,56 @@
+import { type FolderMarks, type FolderViewLocal, type TagCount } from './folderView.js';
+/** A point in viewport coordinates — what a context menu anchors to. */
+export interface FolderViewPoint {
+    x: number;
+    y: number;
+}
+/** Which of the tree's folder-view panels is open, if one is. */
+export type FolderViewPanel = {
+    kind: 'view';
+    at: FolderViewPoint;
+} | {
+    kind: 'tags';
+    at: FolderViewPoint | null;
+    ids: readonly string[];
+};
+export interface FolderView {
+    marks: FolderMarks;
+    local: FolderViewLocal;
+    /** Every tag in use, most-used first. */
+    tags: readonly TagCount[];
+    hide: (ids: readonly string[]) => void;
+    unhide: (ids: readonly string[]) => void;
+    /** Add or take away one tag on each folder named. */
+    toggleTag: (ids: readonly string[], tag: string) => void;
+    /** Replace one folder's tags. */
+    setTags: (id: string, tags: readonly string[]) => void;
+    setShowHidden: (show: boolean) => void;
+    /** Put one tag in this device's filter: only folders carrying it, none carrying it, or neither. */
+    filterTag: (tag: string, mode: 'only' | 'hide' | null) => void;
+    clearTagFilter: () => void;
+    /** The open panel — read by the tree, which draws it. */
+    panel: FolderViewPanel | null;
+    openViewMenu: (at: FolderViewPoint) => void;
+    /** Open the tag editor for these folders; `at` omitted anchors it to the first one's row. */
+    openTagEditor: (ids: readonly string[], at?: FolderViewPoint) => void;
+    closePanel: () => void;
+    /**
+     * For the APP's header over the tree: right-click (and ⌃-click, which macOS turns into a
+     * `contextmenu` by itself) opens the view menu at the pointer instead of the browser's.
+     */
+    onContextMenu: (event: {
+        clientX: number;
+        clientY: number;
+        preventDefault: () => void;
+    }) => void;
+}
+export interface UseFolderViewOptions {
+    /**
+     * Where the marks are remembered, and the name they are announced under. Name it per tree
+     * (`'collections:folder-marks'`) for the reason `FilterRail.resizeKey` is: two trees on one
+     * origin must not hide each other's folders.
+     */
+    key: string;
+}
+export declare function useFolderView({ key }: UseFolderViewOptions): FolderView;
+//# sourceMappingURL=useFolderView.d.ts.map

package/dist/react/file-tree/useFolderView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFolderView.d.ts","sourceRoot":"","sources":["../../../src/react/file-tree/useFolderView.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EAQpB,KAAK,QAAQ,EAGd,MAAM,iBAAiB,CAAC;AAEzB,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,iEAAiE;AACjE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,eAAe,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,yCAAyC;IACzC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IAE1B,IAAI,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IACzC,qDAAqD;IACrD,SAAS,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,iCAAiC;IACjC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAEvD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,mGAAmG;IACnG,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/D,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,yDAAyD;IACzD,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,6FAA6F;IAC7F,aAAa,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACtE,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;CAClG;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE,oBAAoB,GAAG,UAAU,CA2DvE"}

package/dist/react/file-tree/useFolderView.js

@@ -0,0 +1,79 @@
+/**
+ * `useFolderView` — hidden folders and folder tags for one {@link FileTree}, remembered.
+ *
+ *   const folderView = useFolderView({ key: 'collections:folder-marks' });
+ *   <FileTree folderView={folderView} … />
+ *   <header onContextMenu={folderView.onContextMenu}>Files</header>
+ *
+ * The arithmetic is `folderView.ts`; this is where the two halves are KEPT, and the reason it
+ * is a hook rather than two more controlled props on the tree:
+ *
+ *   · the MARKS (hidden, tags) are stored under `key` and announced on the preference bus, the
+ *     seam every synced setting in this package uses (`preferenceSync.ts`). An app that keeps
+ *     preferences on its server lists `key` once and the marks follow the person to every
+ *     device — *"The general hiding is persisted for all machines."* An app that does not still
+ *     remembers them in this browser, so the feature works before anyone wires a server.
+ *   · the VIEW (show hidden, the tag filter) is stored under `${key}:device` and is NEVER
+ *     announced — *"Hiding or showing by tag can be stored per machine, so viewing the 'home'
+ *     tag at home doesn't change my work computer."*
+ *
+ * And because the tree's header belongs to the APP (collections' `FilterRail` section, desk's
+ * explorer bar), the view menu has to be openable from outside the tree: the hook holds which
+ * menu is open, and the tree draws it. `onContextMenu` is the one handler an app puts on its
+ * header so right-click and ⌃-click there open the same menu as the tree's blank space.
+ */
+import { useCallback, useMemo, useState } from 'react';
+import { useRememberedPreference } from '../media-gallery/rememberedPreference.js';
+import { normalizeTag, parseFolderMarks, parseFolderViewLocal, serializeFolderMarks, setFolderTags, setHidden, setTagFilter, tagCounts, toggleFolderTag, } from './folderView.js';
+export function useFolderView({ key }) {
+    const [rawMarks, writeMarks] = useRememberedPreference(key);
+    const [rawLocal, writeLocal] = useRememberedPreference(`${key}:device`, { announce: false });
+    const marks = useMemo(() => parseFolderMarks(rawMarks), [rawMarks]);
+    const local = useMemo(() => parseFolderViewLocal(rawLocal), [rawLocal]);
+    const tags = useMemo(() => tagCounts(marks), [marks]);
+    const [panel, setPanel] = useState(null);
+    const saveMarks = useCallback((next) => {
+        if (next !== marks)
+            writeMarks(serializeFolderMarks(next));
+    }, [marks, writeMarks]);
+    const saveLocal = useCallback((next) => {
+        const empty = !next.showHidden && next.only.length === 0 && next.hide.length === 0;
+        writeLocal(empty ? null : JSON.stringify(next));
+    }, [writeLocal]);
+    const onContextMenu = useCallback((event) => {
+        event.preventDefault();
+        setPanel({ kind: 'view', at: { x: event.clientX, y: event.clientY } });
+    }, []);
+    return useMemo(() => ({
+        marks,
+        local,
+        tags,
+        hide: (ids) => saveMarks(setHidden(marks, ids, true)),
+        unhide: (ids) => saveMarks(setHidden(marks, ids, false)),
+        toggleTag: (ids, raw) => {
+            const tag = normalizeTag(raw);
+            if (!tag || ids.length === 0)
+                return;
+            // Several folders take the tag together: if every one already has it, it comes off
+            // all of them; otherwise it goes on the ones missing it — Finder's mixed-state rule.
+            const all = ids.every((id) => (marks.tags[id] ?? []).includes(tag));
+            let next = marks;
+            for (const id of ids) {
+                const has = (next.tags[id] ?? []).includes(tag);
+                if (all || !has)
+                    next = toggleFolderTag(next, id, tag);
+            }
+            saveMarks(next);
+        },
+        setTags: (id, list) => saveMarks(setFolderTags(marks, id, list)),
+        setShowHidden: (show) => saveLocal({ ...local, showHidden: show }),
+        filterTag: (tag, mode) => saveLocal(setTagFilter(local, tag, mode)),
+        clearTagFilter: () => saveLocal({ ...local, only: [], hide: [] }),
+        panel,
+        openViewMenu: (at) => setPanel({ kind: 'view', at }),
+        openTagEditor: (ids, at) => setPanel({ kind: 'tags', at: at ?? null, ids }),
+        closePanel: () => setPanel(null),
+        onContextMenu,
+    }), [marks, local, tags, panel, saveMarks, saveLocal, onContextMenu]);
+}
+//# sourceMappingURL=useFolderView.js.map

package/dist/react/file-tree/useFolderView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFolderView.js","sourceRoot":"","sources":["../../../src/react/file-tree/useFolderView.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAGL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,SAAS,EACT,YAAY,EAEZ,SAAS,EACT,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAqDzB,MAAM,UAAU,aAAa,CAAC,EAAE,GAAG,EAAwB;IACzD,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,uBAAuB,CAAC,GAAG,GAAG,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAEjE,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,IAAiB,EAAE,EAAE;QACpB,IAAI,IAAI,KAAK,KAAK;YAAE,UAAU,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC,EACD,CAAC,KAAK,EAAE,UAAU,CAAC,CACpB,CAAC;IACF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,IAAqB,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;QACnF,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,KAAuE,EAAE,EAAE;QAC5G,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACxD,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACtB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACrC,mFAAmF;YACnF,qFAAqF;YACrF,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACpE,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAChD,IAAI,GAAG,IAAI,CAAC,GAAG;oBAAE,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACzD,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAChE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAClE,SAAS,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnE,cAAc,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACjE,KAAK;QACL,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACpD,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC;QAC3E,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChC,aAAa;KACd,CAAC,EACF,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/react/filter-rail/FilterRail.d.ts

@@ -1,4 +1,5 @@
 import type { CSSProperties, DragEvent, ReactNode } from 'react';
+import { type HeaderContextMenuHandler } from './headerContextMenu.js';
 export interface FilterRailItem {
     /** Stable key, and the value handed to `onSelect`. */
     id: string;
@@ -115,6 +116,12 @@ export interface FilterRailSection {
     children?: ReactNode;
     /** A heading-level control, right-aligned (a "+" that opens a create dialog). */
     action?: ReactNode;
+    /**
+     * Right-click (and ⌃-click) on the section's heading — for a section holding a file tree,
+     * the tree's view menu: `useFolderView().onContextMenu`. Owner, 2026-09-30: *"a new menu that
+     * appears when I right click (or control + click) the top bar of the file tree"*.
+     */
+    onHeaderContextMenu?: HeaderContextMenuHandler;
     /**
      * A selection axis of this section's own, overriding {@link FilterRailProps.selected}.
      *