@mano8/astro-media-m8 1.1.0 → 2.0.0

package/dist/src/runtime/react/CategoryManager.js

@@ -0,0 +1,194 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { useCategoryTree } from "../hooks/useMediaCategories.js";
+import { ApiError, messageFromDetail } from "../errors.js";
+import { collectCategoryPaths } from "./CategoryMultiSelect.js";
+const inputClassName = "fa-media-control h-8 w-full min-w-0 rounded-lg border border-input bg-transparent px-2.5 py-1 text-base transition-colors outline-none file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40";
+const labelClassName = "fa-media-label flex items-center gap-2 pb-2 text-sm leading-none font-medium select-none";
+/**
+ * Copy for the refusals the category CRUD surface can answer (`U4`): an
+ * unknown/foreign parent, or a structural conflict — a cycle, a cross-tenant
+ * parent, a taken sibling name, or a delete blocked by existing children. The
+ * 409 case always surfaces the server's own message: those four conflicts
+ * each read as a distinct, already-human sentence
+ * ("Category has child categories; reparent or delete them first.", "That
+ * name is taken among its siblings.", …), and re-wording them here would
+ * drift from whichever one the server actually raised.
+ */
+function describeCategoryError(error) {
+    if (error instanceof ApiError) {
+        if (error.status === 404)
+            return "That parent category no longer exists. Refresh and try again.";
+        if (error.status === 403)
+            return "That parent category is not yours to use.";
+        if (error.status === 409) {
+            return messageFromDetail(error.detail) ?? "That change conflicts with the existing category tree.";
+        }
+        return messageFromDetail(error.detail) ?? error.message;
+    }
+    return error instanceof Error ? error.message : "Failed to save the category";
+}
+/** Every category as a flattened `{id, path}` option, plus a root option. */
+function parentOptions(tree) {
+    const paths = collectCategoryPaths(tree);
+    const options = [{ id: null, label: "— Root —" }];
+    for (const option of paths.values()) {
+        options.push({ id: option.id, label: option.path });
+    }
+    return options;
+}
+function findNode(nodes, id) {
+    for (const node of nodes) {
+        if (node.id === id)
+            return node;
+        const found = findNode(node.children, id);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/**
+ * One category row plus its subtree. Rename, reparent and delete are each a
+ * plain form action — no drag-and-drop (decided 2026-08-18) — so a cycle,
+ * cross-tenant parent, taken-sibling-name or has-children refusal is just the
+ * mutation's promise rejecting; the server stays the single source of truth
+ * for every structural guard, this row only surfaces what it says.
+ */
+/**
+ * The busy/error state every row mutation shares, plus the three mutations
+ * themselves. Each one reports the server's refusal through `rowError` rather
+ * than throwing on: a rejected rename, reparent or delete is a message on the
+ * row it belongs to, never a torn-down subtree.
+ */
+function useRowMutations(node, props) {
+    const [busy, setBusy] = useState(false);
+    const [rowError, setRowError] = useState(null);
+    async function guard(action) {
+        setBusy(true);
+        setRowError(null);
+        try {
+            await action();
+            return true;
+        }
+        catch (error) {
+            setRowError(describeCategoryError(error));
+            return false;
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    return {
+        busy,
+        rowError,
+        rename: (name) => guard(() => props.onRename(node.id, name)),
+        reparent: (parentId) => guard(() => props.onReparent(node.id, parentId)),
+        remove: () => guard(() => props.onDelete(node.id))
+    };
+}
+/** The row in its rename state: a single text input and its two actions. */
+function RowRenameForm({ node, busy, onSave, onCancel }) {
+    const [draftName, setDraftName] = useState(node.name);
+    const nameInputId = `fa-media-category-manager-name-${node.id}`;
+    return (_jsxs(_Fragment, { children: [_jsx("label", { className: "fa-media-category-manager-sr-label", htmlFor: nameInputId, children: `Rename ${node.name}` }), _jsx("input", { id: nameInputId, className: inputClassName, value: draftName, disabled: busy, onChange: (event) => setDraftName(event.currentTarget.value) }), _jsx("button", { type: "button", disabled: busy, onClick: () => onSave(draftName), children: "Save" }), _jsx("button", { type: "button", disabled: busy, onClick: onCancel, children: "Cancel" })] }));
+}
+/** The row at rest: name, count, and the rename/add-child/reparent/delete actions. */
+function RowActions({ node, options, busy, onStartRename, onAddChild, onReparent, onDelete }) {
+    // A node cannot be its own parent — the one cycle worth foreclosing
+    // client-side. Every deeper cycle (reparenting under a descendant) is left
+    // to the server's 409, surfaced on the row.
+    const reparentOptions = options.filter((option) => option.id !== node.id);
+    const parentSelectId = `fa-media-category-manager-parent-${node.id}`;
+    return (_jsxs(_Fragment, { children: [_jsx("span", { className: "fa-media-category-manager-name", children: node.name }), _jsx("span", { className: "fa-media-badge fa-media-category-count", children: node.total_object_count }), _jsx("button", { type: "button", disabled: busy, onClick: onStartRename, children: "Rename" }), _jsx("button", { type: "button", disabled: busy, onClick: () => onAddChild(node.id), children: "Add child" }), _jsxs("label", { className: "fa-media-category-manager-reparent-label", htmlFor: parentSelectId, children: ["Parent", _jsx("select", { id: parentSelectId, className: inputClassName, disabled: busy, value: node.parent_id ?? "", onChange: (event) => {
+                            const value = event.currentTarget.value;
+                            onReparent(value === "" ? null : Number(value));
+                        }, children: reparentOptions.map((option) => (_jsx("option", { value: option.id ?? "", children: option.label }, option.id ?? "root"))) })] }), _jsx("button", { type: "button", disabled: busy, onClick: onDelete, children: "Delete" })] }));
+}
+function CategoryManagerRow(props) {
+    const { node, depth, options, onAddChild } = props;
+    const [renaming, setRenaming] = useState(false);
+    const { busy, rowError, rename, reparent, remove } = useRowMutations(node, props);
+    // An empty or unchanged name is not a rename — leave the row as it was
+    // rather than sending the server a no-op it would have to answer.
+    async function saveRename(draft) {
+        const trimmed = draft.trim();
+        if (!trimmed || trimmed === node.name) {
+            setRenaming(false);
+            return;
+        }
+        if (await rename(trimmed))
+            setRenaming(false);
+    }
+    return (_jsxs("li", { className: "fa-media-category-manager-node", "aria-level": depth, children: [_jsx("div", { className: "fa-media-category-manager-row", children: renaming ? (_jsx(RowRenameForm, { node: node, busy: busy, onSave: (draft) => void saveRename(draft), onCancel: () => setRenaming(false) }, node.name)) : (_jsx(RowActions, { node: node, options: options, busy: busy, onStartRename: () => setRenaming(true), onAddChild: onAddChild, onReparent: (parentId) => {
+                        if (parentId !== node.parent_id)
+                            void reparent(parentId);
+                    }, onDelete: () => void remove() })) }), rowError ? (_jsx("p", { role: "alert", className: "fa-media-category-manager-error", children: rowError })) : null, node.children.length > 0 ? (_jsx("ul", { className: "fa-media-category-manager-children", children: node.children.map((child) => (_jsx(CategoryManagerRow, { ...props, node: child, depth: depth + 1 }, child.id))) })) : null] }));
+}
+/**
+ * Create/rename/reparent/delete over the caller's user category tree
+ * (`useCategoryTree`). Reparenting and deleting are plain form actions, not
+ * drag-and-drop, per the 2026-08-18 decision — this keeps the manager
+ * Sonnet-scale and sidesteps the a11y/touch surface a draggable tree would
+ * need. This component owns CRUD only; browsing/filtering the tree is `U7`'s
+ * job on `MediaLibrary`.
+ */
+export function CategoryManager() {
+    const { tree, count, loading, error, create, update, remove } = useCategoryTree();
+    const options = useMemo(() => parentOptions(tree), [tree]);
+    const createForm = useCreateForm(create);
+    const loadErrorMessage = describeLoadError(error);
+    // Rename and reparent are the same `PUT` with one half held constant, so each
+    // reads the node's current other half back out of the tree first.
+    async function rename(id, name) {
+        await update(id, { name, parent_id: findNode(tree, id)?.parent_id ?? null });
+    }
+    async function reparent(id, parentId) {
+        await update(id, { name: findNode(tree, id)?.name ?? "", parent_id: parentId });
+    }
+    return (_jsxs("section", { className: "not-content fa-media-panel", children: [_jsx("h2", { children: "Categories" }), loadErrorMessage ? _jsx("p", { role: "alert", children: loadErrorMessage }) : null, !loading && !loadErrorMessage && tree.length === 0 ? (_jsx("p", { className: "fa-media-category-hint", children: "No user categories yet. Create one below." })) : null, tree.length > 0 ? (_jsx("ul", { className: "fa-media-category-manager-tree", children: tree.map((node) => (_jsx(CategoryManagerRow, { node: node, depth: 1, options: options, onRename: rename, onReparent: reparent, onDelete: remove, onAddChild: createForm.addChildTo }, node.id))) })) : null, _jsx(CategoryCreateForm, { form: createForm, options: options, count: count })] }));
+}
+function describeLoadError(error) {
+    if (!error)
+        return null;
+    const detail = error instanceof ApiError ? messageFromDetail(error.detail) : null;
+    if (detail)
+        return detail;
+    return error instanceof Error ? error.message : "Failed to load categories";
+}
+/**
+ * The one create form the manager owns. "Add child" on a row pre-selects that
+ * row as this form's parent — one form, not a second inline one per node.
+ */
+function useCreateForm(create) {
+    const [name, setName] = useState("");
+    const [parentId, setParentId] = useState("");
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    async function submit() {
+        const trimmed = name.trim();
+        if (!trimmed)
+            return;
+        setBusy(true);
+        setError(null);
+        try {
+            await create({ name: trimmed, parent_id: parentId === "" ? null : Number(parentId) });
+            setName("");
+            setParentId("");
+        }
+        catch (failure) {
+            setError(describeCategoryError(failure));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    function addChildTo(nextParentId) {
+        setParentId(String(nextParentId));
+        setError(null);
+    }
+    return { name, setName, parentId, setParentId, busy, error, submit, addChildTo };
+}
+function CategoryCreateForm({ form, options, count }) {
+    return (_jsxs("fieldset", { className: "fa-media-category-manager-create", children: [_jsx("legend", { children: `New category (${count} total)` }), _jsxs("div", { className: "fa-media-field-control", children: [_jsx("label", { className: labelClassName, htmlFor: "fa-media-category-manager-new-name", children: "Name" }), _jsx("input", { id: "fa-media-category-manager-new-name", className: inputClassName, value: form.name, disabled: form.busy, onChange: (event) => form.setName(event.currentTarget.value) })] }), _jsxs("div", { className: "fa-media-field-control", children: [_jsx("label", { className: labelClassName, htmlFor: "fa-media-category-manager-new-parent", children: "Parent" }), _jsx("select", { id: "fa-media-category-manager-new-parent", className: inputClassName, value: form.parentId, disabled: form.busy, onChange: (event) => form.setParentId(event.currentTarget.value), children: options.map((option) => (_jsx("option", { value: option.id ?? "", children: option.label }, option.id ?? "root"))) })] }), _jsx("button", { type: "button", disabled: form.busy || !form.name.trim(), onClick: () => void form.submit(), children: form.busy ? "Creating…" : "Add category" }), form.error ? _jsx("p", { role: "alert", children: form.error }) : null] }));
+}
+//# sourceMappingURL=CategoryManager.js.map

package/dist/src/runtime/react/CategoryManager.js.map

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

package/dist/src/runtime/react/CategoryMultiSelect.d.ts

@@ -0,0 +1,73 @@
+import type { CategoryNode } from "../schemas.js";
+/**
+ * A resolved selection entry: the category id plus the slash-joined name path
+ * used as chip copy (`"Invoices / 2026"`), mirroring the server's
+ * `MediaObjectCategoryRef.path`.
+ */
+export type CategoryPathOption = {
+    id: number;
+    name: string;
+    path: string;
+};
+/**
+ * Flatten a nested tree into an id -> `{name, path}` map. Kept as a `Map` (not
+ * a plain object) so a lookup never becomes computed member access on a
+ * server-supplied key — `eslint-plugin-security`'s object-injection rule is on
+ * here, and a `Map` is the right structure for a numeric key anyway.
+ */
+export declare function collectCategoryPaths(nodes: readonly CategoryNode[], prefix?: string, into?: Map<number, CategoryPathOption>): Map<number, CategoryPathOption>;
+/**
+ * Compare two `category_ids` selections as sets, so a caller can tell "the user
+ * changed the filing" from "the user toggled one off and back on". Exported
+ * because `ObjectDetail` needs exactly this to drive its dirty state, and
+ * because `PATCH` set semantics (`U4`) make order meaningless on the wire.
+ */
+export declare function isSameCategorySelection(left: readonly number[], right: readonly number[]): boolean;
+export interface CategoryMultiSelectLabels {
+    legend: string;
+    emptyHint: string;
+    expand: (name: string) => string;
+    collapse: (name: string) => string;
+    descendantSelected: string;
+    loadError: string;
+    loading: string;
+    selected: string;
+    remove: (path: string) => string;
+    clearAll: string;
+    noneSelected: string;
+}
+export type CategoryMultiSelectViewProps = {
+    /** The currently selected user-category ids — the `category_ids` payload. */
+    value: readonly number[];
+    onChange: (next: number[]) => void;
+    tree: readonly CategoryNode[];
+    loading?: boolean;
+    error?: unknown;
+    disabled?: boolean;
+    /** Fieldset legend; the picker is optional everywhere it is used today. */
+    legend?: string;
+    /** Copy shown when the caller has no user categories yet. */
+    emptyHint?: string;
+    /**
+     * Labels for ids that are selected but absent from the tree — e.g. an object
+     * filed into a category the tree request has not resolved yet. Keeps a chip
+     * from degrading to a bare id.
+     */
+    fallbackLabels?: ReadonlyMap<number, string>;
+    /** Prefix for the generated element ids; must be unique per mounted picker. */
+    idPrefix?: string;
+    labels?: Partial<CategoryMultiSelectLabels>;
+};
+/**
+ * Presentational multi-select nested category picker: a checkbox tree plus a
+ * chip list of the current selection. Fully controlled — it holds no selection
+ * state of its own, only expand/collapse.
+ */
+export declare function CategoryMultiSelectView(props: CategoryMultiSelectViewProps): import("react").JSX.Element;
+export type CategoryMultiSelectProps = Omit<CategoryMultiSelectViewProps, "tree" | "loading" | "error">;
+/**
+ * The picker wired to `useCategoryTree()`. Use this on a page; use
+ * `CategoryMultiSelectView` when the tree is already in hand (or under test).
+ */
+export declare function CategoryMultiSelect(props: CategoryMultiSelectProps): import("react").JSX.Element;
+//# sourceMappingURL=CategoryMultiSelect.d.ts.map

package/dist/src/runtime/react/CategoryMultiSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryMultiSelect.d.ts","sourceRoot":"","sources":["../../../../src/runtime/react/CategoryMultiSelect.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,SAAK,EACX,IAAI,GAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAa,GAChD,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAOjC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAIlG;AA2BD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAsGD,MAAM,MAAM,4BAA4B,GAAG;IACzC,6EAA6E;IAC7E,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC7C,CAAC;AA6BF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAoD1E;AAyHD,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,4BAA4B,EAC5B,MAAM,GAAG,SAAS,GAAG,OAAO,CAC7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,+BAGlE"}

package/dist/src/runtime/react/CategoryMultiSelect.js

@@ -0,0 +1,179 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { useCategoryTree } from "../hooks/useMediaCategories.js";
+import { ApiError, messageFromDetail } from "../errors.js";
+const labelClassName = "fa-media-label flex items-center gap-2 text-sm leading-none font-medium select-none";
+/**
+ * Flatten a nested tree into an id -> `{name, path}` map. Kept as a `Map` (not
+ * a plain object) so a lookup never becomes computed member access on a
+ * server-supplied key — `eslint-plugin-security`'s object-injection rule is on
+ * here, and a `Map` is the right structure for a numeric key anyway.
+ */
+export function collectCategoryPaths(nodes, prefix = "", into = new Map()) {
+    for (const node of nodes) {
+        const path = prefix ? `${prefix} / ${node.name}` : node.name;
+        into.set(node.id, { id: node.id, name: node.name, path });
+        collectCategoryPaths(node.children, path, into);
+    }
+    return into;
+}
+/**
+ * Compare two `category_ids` selections as sets, so a caller can tell "the user
+ * changed the filing" from "the user toggled one off and back on". Exported
+ * because `ObjectDetail` needs exactly this to drive its dirty state, and
+ * because `PATCH` set semantics (`U4`) make order meaningless on the wire.
+ */
+export function isSameCategorySelection(left, right) {
+    if (left.length !== right.length)
+        return false;
+    const seen = new Set(right);
+    return left.every((id) => seen.has(id));
+}
+function hasSelectedDescendant(nodes, selected) {
+    return nodes.some((node) => selected.has(node.id) || hasSelectedDescendant(node.children, selected));
+}
+const DEFAULT_LABELS = {
+    legend: "User categories (optional)",
+    emptyHint: "No user categories yet. Create one from the category manager to file media here.",
+    expand: (name) => `Expand ${name}`,
+    collapse: (name) => `Collapse ${name}`,
+    descendantSelected: "A category below this one is selected",
+    loadError: "Failed to load categories",
+    loading: "Loading categories…",
+    selected: "Selected categories",
+    remove: (path) => `Remove ${path}`,
+    clearAll: "Clear all",
+    noneSelected: "No user categories selected."
+};
+/**
+ * One tree row plus its subtree.
+ *
+ * The picker is a **form control**, not the navigation tree `U6`/`U7` own, so
+ * it is built from native checkboxes inside nested lists rather than
+ * `role="tree"` + roving tabindex: a native checkbox already carries focus,
+ * keyboard toggling and checked-state announcements, and layering a
+ * single-selection tree pattern over it would take those away. Nesting and
+ * depth stay conveyable through plain nested `<ul>`s plus `aria-level` — the
+ * list role is left implicit on purpose, since an explicit `role="group"` on
+ * the `<ul>` would cost its `<li>` children the `listitem` role that
+ * `aria-level` is defined against.
+ *
+ * Selection does **not** cascade to children. The server stores an explicit set
+ * of assignments (`U4` set semantics), so checking "Invoices" must not silently
+ * file the object into "Invoices / 2026"; a collapsed-or-not branch holding a
+ * selected descendant is marked with a dot instead.
+ */
+function BranchToggle({ node, ctx, groupId }) {
+    if (node.children.length === 0) {
+        return _jsx("span", { className: "fa-media-category-toggle-spacer", "aria-hidden": "true" });
+    }
+    const isCollapsed = ctx.collapsed.has(node.id);
+    return (_jsx("button", { type: "button", className: "fa-media-category-toggle", "aria-expanded": !isCollapsed, "aria-controls": groupId, "aria-label": isCollapsed ? ctx.labels.expand(node.name) : ctx.labels.collapse(node.name), onClick: () => ctx.onToggleCollapsed(node.id), children: isCollapsed ? "▸" : "▾" }));
+}
+function BranchCheckbox({ node, ctx }) {
+    const inputId = `${ctx.idPrefix}-node-${node.id}`;
+    const descendantSelected = node.children.length > 0 &&
+        !ctx.selected.has(node.id) &&
+        hasSelectedDescendant(node.children, ctx.selected);
+    return (_jsxs("label", { className: labelClassName, htmlFor: inputId, children: [_jsx("input", { id: inputId, type: "checkbox", checked: ctx.selected.has(node.id), disabled: ctx.disabled, onChange: () => ctx.onToggleSelected(node.id) }), _jsx("span", { className: "fa-media-category-name", children: node.name }), descendantSelected ? (_jsx("span", { className: "fa-media-category-marker", title: ctx.labels.descendantSelected, children: "•" })) : null, _jsx("span", { className: "fa-media-badge fa-media-category-count", children: node.total_object_count })] }));
+}
+function CategoryBranch({ node, depth, ctx }) {
+    const hasChildren = node.children.length > 0;
+    const groupId = `${ctx.idPrefix}-group-${node.id}`;
+    return (_jsxs("li", { className: "fa-media-category-node", "aria-level": depth, children: [_jsxs("div", { className: "fa-media-category-row", children: [_jsx(BranchToggle, { node: node, ctx: ctx, groupId: groupId }), _jsx(BranchCheckbox, { node: node, ctx: ctx })] }), hasChildren && !ctx.collapsed.has(node.id) ? (_jsx("ul", { id: groupId, className: "fa-media-category-children", children: node.children.map((child) => (_jsx(CategoryBranch, { node: child, depth: depth + 1, ctx: ctx }, child.id))) })) : null] }));
+}
+/**
+ * The picker's only local state: which branches are collapsed. Selection stays
+ * the caller's — `toggleSelected` reports the next set rather than storing it —
+ * so the control remains fully controlled (`U4` set semantics).
+ */
+function usePickerState(value, onChange) {
+    const [collapsed, setCollapsed] = useState(() => new Set());
+    const selected = useMemo(() => new Set(value), [value]);
+    const toggleSelected = useCallback((id) => {
+        onChange(value.includes(id) ? value.filter((current) => current !== id) : [...value, id]);
+    }, [onChange, value]);
+    const toggleCollapsed = useCallback((id) => {
+        setCollapsed((previous) => {
+            const next = new Set(previous);
+            if (!next.delete(id))
+                next.add(id);
+            return next;
+        });
+    }, []);
+    return { collapsed, selected, toggleSelected, toggleCollapsed };
+}
+/**
+ * Presentational multi-select nested category picker: a checkbox tree plus a
+ * chip list of the current selection. Fully controlled — it holds no selection
+ * state of its own, only expand/collapse.
+ */
+export function CategoryMultiSelectView(props) {
+    const { value, onChange, tree, loading = false, error = null, disabled = false, legend, emptyHint, fallbackLabels, idPrefix = "fa-media-categories", labels: labelOverrides } = props;
+    const labels = { ...DEFAULT_LABELS, ...labelOverrides };
+    const { collapsed, selected, toggleSelected, toggleCollapsed } = usePickerState(value, onChange);
+    const paths = useMemo(() => collectCategoryPaths(tree), [tree]);
+    const chips = resolveChips(value, paths, fallbackLabels);
+    const errorMessage = resolveErrorMessage(error, labels.loadError);
+    const ctx = {
+        idPrefix,
+        selected,
+        collapsed,
+        disabled,
+        onToggleSelected: toggleSelected,
+        onToggleCollapsed: toggleCollapsed,
+        labels
+    };
+    return (_jsxs("fieldset", { className: "fa-media-category-picker", children: [_jsx("legend", { children: legend ?? labels.legend }), _jsx(CategoryPickerStatus, { errorMessage: errorMessage, loading: loading, isEmpty: tree.length === 0, emptyHint: emptyHint ?? labels.emptyHint, loadingLabel: labels.loading }), _jsx(CategoryTreeList, { tree: tree, ctx: ctx }), _jsx(CategorySelection, { chips: chips, labels: labels, disabled: disabled, onRemove: toggleSelected, onClear: () => onChange([]) })] }));
+}
+/** The root list. Renders nothing at all when the account has no categories. */
+function CategoryTreeList({ tree, ctx }) {
+    if (tree.length === 0)
+        return null;
+    return (_jsx("ul", { className: "fa-media-category-tree", children: tree.map((node) => (_jsx(CategoryBranch, { node: node, depth: 1, ctx: ctx }, node.id))) }));
+}
+/**
+ * The picker's three mutually informative status lines: a load error, the
+ * first-load hint while the tree is still resolving, and the "nothing to pick
+ * from" hint. The empty hint stays suppressed while an error is showing, so a
+ * failed request never reads as an empty account.
+ */
+function CategoryPickerStatus({ errorMessage, loading, isEmpty, emptyHint, loadingLabel }) {
+    return (_jsxs(_Fragment, { children: [errorMessage ? (_jsx("p", { role: "alert", className: "fa-media-category-error", children: errorMessage })) : null, loading && isEmpty ? _jsx("p", { className: "fa-media-category-hint", children: loadingLabel }) : null, !loading && !errorMessage && isEmpty ? (_jsx("p", { className: "fa-media-category-hint", children: emptyHint })) : null] }));
+}
+/**
+ * Resolve each selected id to its chip copy: the tree's slash-joined path when
+ * the tree holds it, the caller's fallback label when it does not, and `#id` as
+ * the last resort so a chip never renders empty.
+ */
+function resolveChips(value, paths, fallbackLabels) {
+    return value.map((id) => {
+        const known = paths.get(id);
+        if (known)
+            return known;
+        const fallback = fallbackLabels?.get(id) ?? `#${id}`;
+        return { id, name: fallback, path: fallback };
+    });
+}
+function resolveErrorMessage(error, loadError) {
+    if (!error)
+        return null;
+    const detail = error instanceof ApiError ? messageFromDetail(error.detail) : null;
+    return detail ?? (error instanceof Error ? error.message : loadError);
+}
+/** The chip list of the current selection, plus its clear-all action. */
+function CategorySelection({ chips, labels, disabled, onRemove, onClear }) {
+    if (chips.length === 0) {
+        return (_jsx("div", { className: "fa-media-category-selection", children: _jsx("p", { className: "fa-media-category-hint", children: labels.noneSelected }) }));
+    }
+    return (_jsxs("div", { className: "fa-media-category-selection", children: [_jsx("ul", { className: "fa-media-category-chips", "aria-label": labels.selected, children: chips.map((chip) => (_jsxs("li", { className: "fa-media-badge fa-media-category-chip", children: [_jsx("span", { children: chip.path }), _jsx("button", { type: "button", className: "fa-media-category-chip-remove", "aria-label": labels.remove(chip.path), disabled: disabled, onClick: () => onRemove(chip.id), children: "×" })] }, chip.id))) }), _jsx("button", { type: "button", className: "fa-media-category-clear", disabled: disabled, onClick: onClear, children: labels.clearAll })] }));
+}
+/**
+ * The picker wired to `useCategoryTree()`. Use this on a page; use
+ * `CategoryMultiSelectView` when the tree is already in hand (or under test).
+ */
+export function CategoryMultiSelect(props) {
+    const { tree, loading, error } = useCategoryTree();
+    return _jsx(CategoryMultiSelectView, { ...props, tree: tree, loading: loading, error: error });
+}
+//# sourceMappingURL=CategoryMultiSelect.js.map

package/dist/src/runtime/react/CategoryMultiSelect.js.map

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

package/dist/src/runtime/react/MediaCategoryTreePane.d.ts

@@ -0,0 +1,22 @@
+import type { CategoryBranchSelection } from "./categoryBranch.js";
+import type { MediaLibraryLabels } from "./mediaLibraryLabels.js";
+/**
+ * The left pane of the tree view: the caller's nested user categories with
+ * their counts.
+ *
+ * `useCategoryTree()` lives **here** rather than in `MediaLibrary` so the
+ * category request is only issued once the user actually opens the tree view —
+ * the list/grid/masonry views must not pay for a fetch they never render.
+ *
+ * The a11y contract matches `astro-ui-m8`'s `tree-view` registry block so the
+ * runtime pane and the registry skin do not diverge: `role="tree"` /
+ * `role="group"` / `role="treeitem"`, `aria-level`, `aria-selected`,
+ * `aria-expanded` on parents, a roving tabindex holding exactly one tab stop,
+ * and ArrowUp/ArrowDown/Home/End/ArrowRight/ArrowLeft/Enter/Space.
+ */
+export declare function MediaCategoryTreePane({ selection, onSelect, labels }: {
+    selection: CategoryBranchSelection;
+    onSelect: (selection: CategoryBranchSelection) => void;
+    labels: MediaLibraryLabels["tree"];
+}): import("react").JSX.Element;
+//# sourceMappingURL=MediaCategoryTreePane.d.ts.map

package/dist/src/runtime/react/MediaCategoryTreePane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaCategoryTreePane.d.ts","sourceRoot":"","sources":["../../../../src/runtime/react/MediaCategoryTreePane.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAsOlE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,QAAQ,EACR,MAAM,EACP,EAAE;IACD,SAAS,EAAE,uBAAuB,CAAC;IACnC,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACvD,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACpC,+BA6JA"}