@kelpie/ui 0.1.0

package/dist/pages/handbook/HandbookPage.js

@@ -0,0 +1,197 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DndContext, DragOverlay, PointerSensor, closestCenter, useSensor, useSensors, } from '@dnd-kit/core';
+import { SortableContext, useSortable, verticalListSortingStrategy } from '@dnd-kit/sortable';
+import { CSS } from '@dnd-kit/utilities';
+import { useEffect, useMemo, useState } from 'react';
+import { Link, useNavigate, useParams } from 'react-router';
+import { useCreateHandbookPage, useDeleteHandbookPage, useHandbookPages, useUpdateHandbookPage, } from '../../api/resources/handbookPages.js';
+import { useMembers } from '../../api/resources/members.js';
+import { AgentTasks } from '../../components/AgentTasks.js';
+import { MarkdownView } from '../../components/MarkdownView.js';
+import { ErrorPanel, LoadingPanel } from '../../components/QueryState.js';
+import { formatDateTime } from '../../lib/dates.js';
+import { INDENT, descendantIds, flattenTree, landingMoves, projectDrop } from './tree.js';
+/**
+ * The handbook: a draggable tree of pages beside the one being read.
+ *
+ * Ported from the mockup, where the tree was local state and every edit was lost
+ * on navigation. The shapes are the same; what changed is where they live. A
+ * drop sends one PATCH naming the new parent and position, and the server
+ * renumbers both sibling sets, so the page never computes a `sort_order` for
+ * anything it did not drag.
+ */
+const NEW_PAGE_TITLE = 'Untitled page';
+export function HandbookLayout() {
+    const { pageId } = useParams();
+    const navigate = useNavigate();
+    const pages = useHandbookPages();
+    const members = useMembers();
+    const createPage = useCreateHandbookPage();
+    const updatePage = useUpdateHandbookPage();
+    const deletePage = useDeleteHandbookPage();
+    const [activeId, setActiveId] = useState(null);
+    const [overId, setOverId] = useState(null);
+    const [offsetX, setOffsetX] = useState(0);
+    const flat = useMemo(() => flattenTree(pages.records), [pages.records]);
+    const active = pages.records.find((page) => page.id === (pageId ?? flat[0]?.id));
+    const dragging = flat.find((item) => item.id === activeId);
+    const liveDepth = activeId !== null && overId !== null
+        ? projectDrop(flat, pages.records, activeId, overId, offsetX).depth
+        : dragging?.depth;
+    const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 6 } }));
+    useEffect(() => {
+        const first = flat[0];
+        if (pageId === undefined && first !== undefined) {
+            void navigate(`/handbook/${first.id}`, { replace: true });
+        }
+    }, [pageId, flat, navigate]);
+    async function addPage(parentId) {
+        const page = await createPage.runAsync({
+            title: NEW_PAGE_TITLE,
+            body: `# ${NEW_PAGE_TITLE}\n\nStart writing…\n`,
+            parentId,
+        });
+        await navigate(`/handbook/${page.id}`);
+    }
+    /**
+     * Deletes a page and everything under it, after saying how much that is.
+     *
+     * The count comes from the tree already on screen. It is the same cascade the
+     * API performs, named before it happens rather than reported after.
+     */
+    async function removePage(page) {
+        const nested = descendantIds(pages.records, page.id).size;
+        const confirmed = window.confirm(nested > 0
+            ? `Delete this page and ${String(nested)} nested page${nested > 1 ? 's' : ''}?`
+            : 'Delete this page?');
+        if (!confirmed) {
+            return;
+        }
+        const doomed = new Set([page.id, ...descendantIds(pages.records, page.id)]);
+        await deletePage.runAsync(page.id);
+        if (pageId !== undefined && doomed.has(pageId)) {
+            const fallback = flat.find((item) => !doomed.has(item.id));
+            await navigate(fallback === undefined ? '/handbook' : `/handbook/${fallback.id}`);
+        }
+    }
+    function clearDrag() {
+        setActiveId(null);
+        setOverId(null);
+        setOffsetX(0);
+    }
+    function onDragStart(event) {
+        setActiveId(String(event.active.id));
+        setOverId(String(event.active.id));
+        setOffsetX(0);
+    }
+    function onDragMove(event) {
+        setOffsetX(event.delta.x);
+        if (event.over !== null) {
+            setOverId(String(event.over.id));
+        }
+    }
+    /**
+     * A drop is projected even when it landed on the row it started from.
+     *
+     * The mockup bailed on that case, which made an indent-in-place impossible:
+     * dragging a page straight left to lift it out of its parent did nothing,
+     * because with no vertical movement the nearest row is the dragged one. What
+     * decides whether to write is whether the landing differs from where the page
+     * already is, not which row the pointer happened to finish over.
+     */
+    function onDragEnd(event) {
+        const dragId = activeId;
+        const dropId = event.over === null ? null : String(event.over.id);
+        const movedBy = offsetX;
+        clearDrag();
+        if (dragId === null || dropId === null) {
+            return;
+        }
+        const landing = projectDrop(flat, pages.records, dragId, dropId, movedBy);
+        if (!landingMoves(pages.records, dragId, landing)) {
+            return;
+        }
+        updatePage.run({
+            id: dragId,
+            changes: { parentId: landing.parentId, sortOrder: landing.insertIndex },
+        });
+    }
+    if (pages.isLoading) {
+        return _jsx(LoadingPanel, { label: "Loading the handbook\u2026" });
+    }
+    if (pages.error !== null) {
+        return _jsx(ErrorPanel, { error: pages.error });
+    }
+    return (_jsxs("div", { className: "animate-fade-in flex min-h-[calc(100vh-8rem)] gap-0 overflow-hidden rounded-md border border-border", children: [_jsxs("aside", { className: "flex w-[260px] shrink-0 flex-col border-r border-border bg-surface", children: [_jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-border px-3 py-3", children: [_jsxs("div", { children: [_jsx("div", { className: "text-[13px] font-semibold text-ink", children: "Handbook" }), _jsx("div", { className: "text-[11px] text-ink-faint", children: "Drag to reorder \u00B7 indent to nest" })] }), _jsx("button", { type: "button", disabled: createPage.isPending, onClick: () => {
+                                    void addPage(null);
+                                }, className: "rounded-md bg-accent px-2 py-1 text-[11px] font-semibold text-accent-fg transition hover:bg-accent-hover disabled:opacity-50", children: "New" })] }), _jsxs("nav", { className: "flex-1 overflow-y-auto p-2", children: [_jsxs(DndContext, { sensors: sensors, collisionDetection: closestCenter, onDragStart: onDragStart, onDragMove: onDragMove, onDragEnd: onDragEnd, onDragCancel: clearDrag, children: [_jsx(SortableContext, { items: flat.map((item) => item.id), strategy: verticalListSortingStrategy, children: _jsx("ul", { className: "flex flex-col gap-0.5", children: flat.map((item) => (_jsx(SortableTreeItem, { item: item, depth: item.id === activeId && liveDepth !== undefined ? liveDepth : item.depth, selected: item.id === active?.id, onAddChild: () => {
+                                                    void addPage(item.id);
+                                                }, onDelete: () => {
+                                                    void removePage(item.page);
+                                                } }, item.id))) }) }), _jsx(DragOverlay, { dropAnimation: null, children: dragging === undefined ? null : (_jsx("div", { className: "rounded-md border border-accent bg-surface-raised px-2.5 py-1.5 text-[13px] font-medium text-ink", style: { marginLeft: (liveDepth ?? dragging.depth) * INDENT }, children: dragging.page.title })) })] }), flat.length === 0 && (_jsx("p", { className: "px-2 py-6 text-center text-[12px] text-ink-faint", children: "No pages yet." })), pages.hasMore && (_jsx("p", { className: "px-2 py-3 text-center text-[11px] text-ink-faint", children: "This handbook has more pages than one request returns, so the tree below is incomplete." }))] })] }), _jsx("div", { className: "min-w-0 flex-1", children: active === undefined ? (_jsx("div", { className: "flex h-full items-center justify-center text-[13px] text-ink-faint", children: "No handbook pages yet." })) : (_jsx(HandbookEditor, { page: active, authorName: active.updatedBy === null ? undefined : members.nameById.get(active.updatedBy), isSaving: updatePage.isPending, error: updatePage.error ?? deletePage.error, onSave: (changes) => {
+                        updatePage.run({ id: active.id, changes });
+                    }, onAddChild: () => {
+                        void addPage(active.id);
+                    }, onDelete: () => {
+                        void removePage(active);
+                    } }, active.id)) })] }));
+}
+function SortableTreeItem({ item, depth, selected, onAddChild, onDelete, }) {
+    const { attributes, listeners, setNodeRef, transform, transition, isDragging } = useSortable({
+        id: item.id,
+    });
+    return (_jsx("li", { ref: setNodeRef, style: {
+            transform: CSS.Transform.toString(transform),
+            transition,
+            marginLeft: depth * INDENT,
+            opacity: isDragging ? 0.35 : 1,
+        }, className: "group relative", children: _jsxs("div", { className: [
+                'flex items-center gap-0.5 rounded-md pr-1 transition-colors',
+                selected
+                    ? 'bg-accent-soft text-accent-hover'
+                    : 'text-ink-muted hover:bg-surface-raised hover:text-ink',
+            ].join(' '), children: [_jsx("button", { type: "button", className: "cursor-grab touch-none px-1 py-1.5 text-[10px] text-ink-faint active:cursor-grabbing", "aria-label": `Drag ${item.page.title} to reorder`, ...attributes, ...listeners, children: "\u22EE\u22EE" }), _jsx(Link, { to: `/handbook/${item.id}`, className: [
+                        'min-w-0 flex-1 truncate py-1.5 pr-1 text-[13px]',
+                        selected ? 'font-medium' : '',
+                    ].join(' '), children: item.page.title }), _jsx("button", { type: "button", title: "Add subpage", onClick: (event) => {
+                        event.preventDefault();
+                        onAddChild();
+                    }, className: "hidden rounded px-1 py-0.5 text-[12px] font-medium text-ink-faint group-hover:inline hover:bg-surface hover:text-accent", children: "+" }), _jsx("button", { type: "button", title: "Delete", onClick: (event) => {
+                        event.preventDefault();
+                        onDelete();
+                    }, className: "hidden rounded px-1 py-0.5 text-[11px] font-medium text-ink-faint group-hover:inline hover:bg-danger-soft hover:text-danger", children: "\u00D7" })] }) }));
+}
+/**
+ * One page: read as rendered markdown, edited as its source.
+ *
+ * A rename sends the title and nothing else about the address. The slug is the
+ * handle agent tasks name a page by, so the API leaves it where it is unless it
+ * is set on purpose, and this editor never sets it.
+ */
+function HandbookEditor({ page, authorName, isSaving, error, onSave, onAddChild, onDelete, }) {
+    const [editing, setEditing] = useState(false);
+    const [title, setTitle] = useState(page.title);
+    const [body, setBody] = useState(page.body);
+    useEffect(() => {
+        setTitle(page.title);
+        setBody(page.body);
+        setEditing(false);
+    }, [page.id, page.title, page.body]);
+    function save() {
+        const trimmed = title.trim();
+        onSave({ title: trimmed.length === 0 ? NEW_PAGE_TITLE : trimmed, body });
+        setEditing(false);
+    }
+    return (_jsxs("div", { className: "flex h-full flex-col", children: [_jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3 border-b border-border px-5 py-3", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [editing ? (_jsx("input", { value: title, "aria-label": "Page title", onChange: (event) => {
+                                    setTitle(event.target.value);
+                                }, className: "w-full min-w-[200px] rounded-md border border-border bg-surface px-2.5 py-1.5 text-[15px] font-semibold outline-none focus:border-accent" })) : (_jsx("h1", { className: "text-[18px] font-semibold tracking-tight text-ink", children: page.title })), _jsxs("div", { className: "mt-1 text-[11px] text-ink-faint", children: ["Updated ", formatDateTime(page.updatedAt), authorName === undefined ? '' : ` · ${authorName}`] })] }), _jsx("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: editing ? (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: () => {
+                                        setTitle(page.title);
+                                        setBody(page.body);
+                                        setEditing(false);
+                                    }, className: "rounded-md px-2.5 py-1.5 text-[12px] font-medium text-ink-muted hover:text-ink", children: "Cancel" }), _jsx("button", { type: "button", disabled: isSaving, onClick: save, className: "rounded-md bg-accent px-3 py-1.5 text-[12px] font-semibold text-accent-fg transition hover:bg-accent-hover disabled:opacity-50", children: "Save" })] })) : (_jsxs(_Fragment, { children: [_jsx(AgentTasks, { targetType: "handbook", targetId: page.id, targetLabel: page.title }), _jsx("button", { type: "button", onClick: onAddChild, className: "rounded-md border border-border px-2.5 py-1.5 text-[12px] font-medium text-ink-muted transition hover:border-accent hover:text-accent-hover", children: "Add subpage" }), _jsx("button", { type: "button", onClick: onDelete, className: "rounded-md border border-border px-2.5 py-1.5 text-[12px] font-medium text-danger transition hover:border-danger hover:bg-danger-soft", children: "Delete" }), _jsx("button", { type: "button", onClick: () => {
+                                        setEditing(true);
+                                    }, className: "rounded-md border border-border px-3 py-1.5 text-[12px] font-semibold text-ink transition hover:border-accent hover:text-accent-hover", children: "Edit" })] })) })] }), _jsxs("div", { className: "flex-1 overflow-y-auto p-5", children: [error !== null && (_jsx("div", { className: "mb-4 max-w-3xl", children: _jsx(ErrorPanel, { error: error }) })), editing ? (_jsx("textarea", { value: body, "aria-label": "Page body", onChange: (event) => {
+                            setBody(event.target.value);
+                        }, className: "min-h-[480px] w-full resize-y rounded-md border border-border bg-surface p-4 font-mono text-[13px] leading-relaxed outline-none focus:border-accent focus:ring-2 focus:ring-accent/20", spellCheck: true })) : (_jsx("div", { className: "animate-slide-in max-w-3xl", children: _jsx(MarkdownView, { source: page.body }) }))] })] }));
+}
+//# sourceMappingURL=HandbookPage.js.map

package/dist/pages/handbook/HandbookPage.js.map

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

package/dist/pages/handbook/tree.d.ts

@@ -0,0 +1,62 @@
+import type { HandbookPage } from '@kelpie/schemas';
+/**
+ * The sidebar tree: how a flat list of pages becomes an indented list, and where
+ * a drag would put the page being dragged.
+ *
+ * Ported from the mockup's `HandbookPage.tsx`, extracted into its own module
+ * because the projection is the only genuinely intricate part of the page and it
+ * is pure: flat list in, landing spot out. The page turns that landing spot into
+ * one PATCH and lets the server renumber the siblings.
+ */
+/** Pixels of indent per level. The drag reads horizontal movement in these units. */
+export declare const INDENT = 14;
+export interface FlatItem {
+    readonly id: string;
+    readonly page: HandbookPage;
+    readonly depth: number;
+}
+/** Where a dragged page would land: a new parent, and a position among that parent's children. */
+export interface Projection {
+    readonly parentId: string | null;
+    readonly depth: number;
+    readonly insertIndex: number;
+}
+/**
+ * One parent's children, in sidebar order.
+ *
+ * Title breaks a tie, which the mockup did and the API makes unnecessary: the
+ * server keeps a sibling set contiguous from 0. It stays because the tie is
+ * real for the moment an optimistic update holds two pages at one position.
+ */
+export declare function childrenOf(pages: readonly HandbookPage[], parentId: string | null): HandbookPage[];
+/**
+ * The tree as the list of rows the sidebar renders, parents before their children.
+ *
+ * A page whose parent is missing is left out. That happens for the moment
+ * between deleting a page and the list refetching, and floating its orphaned
+ * subpages to the top level would read as though somebody had moved them there.
+ */
+export declare function flattenTree(pages: readonly HandbookPage[]): FlatItem[];
+/** Every page under this one, at any depth: the subtree a delete takes and a drag may not enter. */
+export declare function descendantIds(pages: readonly HandbookPage[], rootId: string): Set<string>;
+/**
+ * Where a drag would land the page.
+ *
+ * @param offsetX How far the pointer has moved horizontally. Divided by `INDENT`
+ *   it is the change in nesting depth, which is how one gesture reorders and
+ *   re-nests at once.
+ * @returns The landing spot, clamped to a legal one. A drop onto the page's own
+ *   subtree, or past the depth cap, resolves to where the page already is rather
+ *   than to a request the server would refuse.
+ */
+export declare function projectDrop(flat: readonly FlatItem[], pages: readonly HandbookPage[], activeId: string, overId: string, offsetX: number): Projection;
+/**
+ * Whether a landing actually moves the page.
+ *
+ * Every activated drag ends somewhere, including one that ended where it
+ * started. Without this a nudge past the 6px activation distance would send a
+ * PATCH, and the optimistic cache write behind it would make the sidebar jump
+ * for a gesture that asked for nothing.
+ */
+export declare function landingMoves(pages: readonly HandbookPage[], pageId: string, landing: Projection): boolean;
+//# sourceMappingURL=tree.d.ts.map

package/dist/pages/handbook/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/pages/handbook/tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;;;;GAQG;AAEH,qFAAqF;AACrF,eAAO,MAAM,MAAM,KAAK,CAAA;AAExB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,YAAY,EAAE,CAMhB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,EAAE,CAatE;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAazF;AAkFD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,UAAU,CAyCZ;AA2ED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GAClB,OAAO,CAiBT"}

package/dist/pages/handbook/tree.js

@@ -0,0 +1,222 @@
+import { MAX_HANDBOOK_DEPTH } from '@kelpie/schemas';
+/**
+ * The sidebar tree: how a flat list of pages becomes an indented list, and where
+ * a drag would put the page being dragged.
+ *
+ * Ported from the mockup's `HandbookPage.tsx`, extracted into its own module
+ * because the projection is the only genuinely intricate part of the page and it
+ * is pure: flat list in, landing spot out. The page turns that landing spot into
+ * one PATCH and lets the server renumber the siblings.
+ */
+/** Pixels of indent per level. The drag reads horizontal movement in these units. */
+export const INDENT = 14;
+/**
+ * One parent's children, in sidebar order.
+ *
+ * Title breaks a tie, which the mockup did and the API makes unnecessary: the
+ * server keeps a sibling set contiguous from 0. It stays because the tie is
+ * real for the moment an optimistic update holds two pages at one position.
+ */
+export function childrenOf(pages, parentId) {
+    return pages
+        .filter((page) => page.parentId === parentId)
+        .sort((left, right) => left.sortOrder - right.sortOrder || left.title.localeCompare(right.title));
+}
+/**
+ * The tree as the list of rows the sidebar renders, parents before their children.
+ *
+ * A page whose parent is missing is left out. That happens for the moment
+ * between deleting a page and the list refetching, and floating its orphaned
+ * subpages to the top level would read as though somebody had moved them there.
+ */
+export function flattenTree(pages) {
+    const rows = [];
+    function walk(parentId, depth) {
+        for (const page of childrenOf(pages, parentId)) {
+            rows.push({ id: page.id, page, depth });
+            walk(page.id, depth + 1);
+        }
+    }
+    walk(null, 0);
+    return rows;
+}
+/** Every page under this one, at any depth: the subtree a delete takes and a drag may not enter. */
+export function descendantIds(pages, rootId) {
+    const found = new Set();
+    function walk(parentId) {
+        for (const child of childrenOf(pages, parentId)) {
+            found.add(child.id);
+            walk(child.id);
+        }
+    }
+    walk(rootId);
+    return found;
+}
+/**
+ * The nearest row above and below the drop target, skipping the page being
+ * dragged and everything under it.
+ *
+ * Those rows are what bound the depth: a page can be at most one level deeper
+ * than the row above it, and no shallower than the row below, or it would adopt
+ * that row's subtree by sitting above it at a lower indent.
+ */
+function neighbours(flat, activeIndex, overIndex, skip) {
+    const passes = (item) => !skip.has(item.id);
+    const movingDown = activeIndex < overIndex;
+    let previous;
+    let next;
+    for (let index = overIndex - (movingDown ? 0 : 1); index >= 0; index -= 1) {
+        const item = flat[index];
+        if (item !== undefined && passes(item)) {
+            previous = item;
+            break;
+        }
+    }
+    for (let index = overIndex + (movingDown ? 1 : 0); index < flat.length; index += 1) {
+        const item = flat[index];
+        if (item !== undefined && passes(item)) {
+            next = item;
+            break;
+        }
+    }
+    return { previous, next };
+}
+/** The parent a page sits under at `depth`, given the row above it. */
+function parentAtDepth(flat, pages, previous, depth) {
+    if (depth === previous.depth) {
+        return previous.page.parentId;
+    }
+    if (depth > previous.depth) {
+        return previous.id;
+    }
+    // Shallower than the row above: walk up its ancestors to the one that sits at
+    // the level being dropped into.
+    let cursor = previous.page;
+    while (cursor !== undefined) {
+        const row = flat.find((item) => item.id === cursor?.id);
+        if (row !== undefined && row.depth === depth - 1) {
+            return cursor.id;
+        }
+        if (row !== undefined && row.depth < depth) {
+            return cursor.parentId;
+        }
+        cursor =
+            cursor.parentId === null
+                ? undefined
+                : pages.find((page) => page.id === cursor?.parentId);
+    }
+    return null;
+}
+/**
+ * Where a drag would land the page.
+ *
+ * @param offsetX How far the pointer has moved horizontally. Divided by `INDENT`
+ *   it is the change in nesting depth, which is how one gesture reorders and
+ *   re-nests at once.
+ * @returns The landing spot, clamped to a legal one. A drop onto the page's own
+ *   subtree, or past the depth cap, resolves to where the page already is rather
+ *   than to a request the server would refuse.
+ */
+export function projectDrop(flat, pages, activeId, overId, offsetX) {
+    const active = flat.find((item) => item.id === activeId);
+    const over = flat.find((item) => item.id === overId);
+    if (active === undefined || over === undefined) {
+        return { parentId: null, depth: 0, insertIndex: 0 };
+    }
+    const doomed = descendantIds(pages, activeId);
+    const skip = new Set([activeId, ...doomed]);
+    const activeIndex = flat.findIndex((item) => item.id === activeId);
+    const overIndex = flat.findIndex((item) => item.id === overId);
+    const { previous, next } = neighbours(flat, activeIndex, overIndex, skip);
+    const requested = Math.round((active.depth * INDENT + offsetX) / INDENT);
+    const ceiling = previous === undefined ? 0 : Math.min(MAX_HANDBOOK_DEPTH, previous.depth + 1);
+    const floor = next?.depth ?? 0;
+    const depth = Math.max(floor, Math.min(ceiling, Math.max(0, requested)));
+    const proposed = depth === 0 || previous === undefined ? null : parentAtDepth(flat, pages, previous, depth);
+    // A projection can still name the page itself or one of its own subpages.
+    // Leaving it where it is beats sending a move the API would answer 422 to.
+    const refused = proposed === activeId || (proposed !== null && doomed.has(proposed));
+    const parentId = refused ? active.page.parentId : proposed;
+    const siblings = childrenOf(pages, parentId).filter((page) => page.id !== activeId);
+    return {
+        parentId,
+        depth: refused ? active.depth : depth,
+        insertIndex: insertionFor(siblings, {
+            pages,
+            activeId,
+            over,
+            previous,
+            parentId,
+            activeIndex,
+            overIndex,
+        }),
+    };
+}
+/**
+ * The row above the drop, or whichever of its ancestors is a child of `parentId`.
+ *
+ * The row immediately above is often deeper than where the page is landing: drop
+ * a top-level page below a nested one and the nearest row is a grandchild of the
+ * sibling it should follow. Walking up finds the sibling it can actually be
+ * measured against.
+ */
+function landmarkUnder(pages, from, parentId) {
+    let cursor = from;
+    while (cursor !== undefined) {
+        if (cursor.parentId === parentId) {
+            return cursor.id;
+        }
+        const above = cursor.parentId;
+        cursor = above === null ? undefined : pages.find((page) => page.id === above);
+    }
+    return undefined;
+}
+/** The position among the new siblings, 0-based, which is what `sort_order` means to the API. */
+function insertionFor(siblings, context) {
+    const { pages, activeId, over, previous, parentId, activeIndex, overIndex } = context;
+    // Dropped onto the page that is becoming the parent, or dropped straight below
+    // it: either way the page lands as its first child.
+    if (over.id === parentId || previous?.id === parentId) {
+        return 0;
+    }
+    // A drop onto the dragged row itself is an indent in place. The row dropped on
+    // is the one moving, so it cannot also be the landmark; `siblings` has it
+    // filtered out and asking it for a position would answer "the end".
+    if (over.id !== activeId && over.page.parentId === parentId) {
+        const index = siblings.findIndex((page) => page.id === over.id);
+        if (index < 0) {
+            return siblings.length;
+        }
+        // Dragging down lands after the row dropped on; dragging up lands before it.
+        return activeIndex < overIndex ? index + 1 : index;
+    }
+    if (previous === undefined) {
+        // Nothing above it in the list, so there is nowhere to land but the top.
+        return 0;
+    }
+    const landmark = landmarkUnder(pages, previous.page, parentId);
+    const index = landmark === undefined ? -1 : siblings.findIndex((page) => page.id === landmark);
+    return index < 0 ? siblings.length : index + 1;
+}
+/**
+ * Whether a landing actually moves the page.
+ *
+ * Every activated drag ends somewhere, including one that ended where it
+ * started. Without this a nudge past the 6px activation distance would send a
+ * PATCH, and the optimistic cache write behind it would make the sidebar jump
+ * for a gesture that asked for nothing.
+ */
+export function landingMoves(pages, pageId, landing) {
+    const page = pages.find((candidate) => candidate.id === pageId);
+    if (page === undefined) {
+        return false;
+    }
+    if (page.parentId !== landing.parentId) {
+        return true;
+    }
+    // `insertIndex` counts a sibling set the page has been lifted out of, so the
+    // page's own current index is the position that means "put it back".
+    return (childrenOf(pages, page.parentId).findIndex((sibling) => sibling.id === pageId) !==
+        landing.insertIndex);
+}
+//# sourceMappingURL=tree.js.map

package/dist/pages/handbook/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/pages/handbook/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD;;;;;;;;GAQG;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAA;AAexB;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,KAA8B,EAC9B,QAAuB;IAEvB,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC;SAC5C,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAC3F,CAAA;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,MAAM,IAAI,GAAe,EAAE,CAAA;IAE3B,SAAS,IAAI,CAAC,QAAuB,EAAE,KAAa;QAClD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YACvC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAEb,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,KAA8B,EAAE,MAAc;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAE/B,SAAS,IAAI,CAAC,QAAgB;QAC5B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACnB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,CAAA;IAEZ,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,UAAU,CACjB,IAAyB,EACzB,WAAmB,EACnB,SAAiB,EACjB,IAAyB;IAEzB,MAAM,MAAM,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9D,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;IAE1C,IAAI,QAA8B,CAAA;IAClC,IAAI,IAA0B,CAAA;IAE9B,KAAK,IAAI,KAAK,GAAG,SAAS,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,QAAQ,GAAG,IAAI,CAAA;YACf,MAAK;QACP,CAAC;IACH,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,SAAS,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,IAAI,GAAG,IAAI,CAAA;YACX,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CACpB,IAAyB,EACzB,KAA8B,EAC9B,QAAkB,EAClB,KAAa;IAEb,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAA;IAC/B,CAAC;IAED,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,EAAE,CAAA;IACpB,CAAC;IAED,8EAA8E;IAC9E,gCAAgC;IAChC,IAAI,MAAM,GAA6B,QAAQ,CAAC,IAAI,CAAA;IAEpD,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC,CAAA;QAEvD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;YACjD,OAAO,MAAM,CAAC,EAAE,CAAA;QAClB,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,QAAQ,CAAA;QACxB,CAAC;QAED,MAAM;YACJ,MAAM,CAAC,QAAQ,KAAK,IAAI;gBACtB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC1D,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,IAAyB,EACzB,KAA8B,EAC9B,QAAgB,EAChB,MAAc,EACd,OAAe;IAEf,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAA;IAEpD,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAA;IACrD,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAA;IAC9D,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IAEzE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IAC7F,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAExE,MAAM,QAAQ,GACZ,KAAK,KAAK,CAAC,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC5F,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE1D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IAEnF,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QACrC,WAAW,EAAE,YAAY,CAAC,QAAQ,EAAE;YAClC,KAAK;YACL,QAAQ;YACR,IAAI;YACJ,QAAQ;YACR,QAAQ;YACR,WAAW;YACX,SAAS;SACV,CAAC;KACH,CAAA;AACH,CAAC;AAYD;;;;;;;GAOG;AACH,SAAS,aAAa,CACpB,KAA8B,EAC9B,IAAkB,EAClB,QAAuB;IAEvB,IAAI,MAAM,GAA6B,IAAI,CAAA;IAE3C,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,MAAM,CAAC,EAAE,CAAA;QAClB,CAAC;QAED,MAAM,KAAK,GAAkB,MAAM,CAAC,QAAQ,CAAA;QAE5C,MAAM,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,iGAAiG;AACjG,SAAS,YAAY,CAAC,QAAiC,EAAE,OAAyB;IAChF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAErF,+EAA+E;IAC/E,oDAAoD;IACpD,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,+EAA+E;IAC/E,0EAA0E;IAC1E,oEAAoE;IACpE,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAA;QAE/D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC,MAAM,CAAA;QACxB,CAAC;QAED,6EAA6E;QAC7E,OAAO,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACpD,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,yEAAyE;QACzE,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IAE9F,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA8B,EAC9B,MAAc,EACd,OAAmB;IAEnB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAA;IAE/D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,6EAA6E;IAC7E,qEAAqE;IACrE,OAAO,CACL,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC;QAC9E,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC"}

package/dist/pages/hiringDirectory.d.ts

@@ -0,0 +1,60 @@
+import type { Note } from '@kelpie/schemas';
+export interface RoleCandidateCounts {
+    countFor(roleId: string): number;
+    readonly isLoading: boolean;
+    /**
+     * False when these roles hold more candidacies than one page could return, so
+     * the counts are floors rather than totals. The page says so instead of
+     * printing a number it cannot stand behind.
+     */
+    readonly isComplete: boolean;
+}
+export declare function useRoleCandidateCounts(roleIds: readonly string[]): RoleCandidateCounts;
+export interface CandidateNotes {
+    /** The candidate's most recent note, or undefined when they have none. */
+    noteFor(candidateId: string): Note | undefined;
+    readonly isLoading: boolean;
+    /**
+     * False when these candidates hold more notes than one page could return.
+     *
+     * A candidate whose note is in the answer is showing their newest one: the
+     * list arrives newest first across the whole set, so a truncated page cannot
+     * hold an older note of theirs without the newer one. Only an *absent*
+     * candidate is ambiguous, and the caller says so rather than offering to
+     * write a second note over the one it did not fetch.
+     */
+    readonly isComplete: boolean;
+}
+/**
+ * The most recent note on each candidate in a pipeline.
+ *
+ * One request for the whole list rather than one per row. `?target_id=` on notes
+ * repeats to name a set, so a page rendering a note per candidate resolves them
+ * the way every other related column here does.
+ */
+export declare function useCandidateNotes(candidateIds: readonly string[]): CandidateNotes;
+export interface RoleTitles {
+    titleFor(roleId: string): string | undefined;
+    readonly isLoading: boolean;
+}
+/**
+ * Titles for the roles a person is up for.
+ *
+ * The whole first page rather than an id filter, because `/v1/roles` has no
+ * `?id=` and a workspace's open roles are few. A title missing past that page
+ * falls back to the id, which is wrong-looking rather than silently blank.
+ */
+export declare function useRoleTitles(): RoleTitles;
+export interface PersonNames {
+    nameFor(personId: string): string | undefined;
+    readonly isLoading: boolean;
+}
+/**
+ * Names for a set of people, from the directory's first page.
+ *
+ * `/v1/people` has no `?id=` filter, so this is the same compromise
+ * `RaiseKeyPeople` makes: past the first page a name is missing rather than
+ * wrong, and the caller falls back to the id instead of rendering a blank.
+ */
+export declare function usePersonNames(): PersonNames;
+//# sourceMappingURL=hiringDirectory.d.ts.map

package/dist/pages/hiringDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hiringDirectory.d.ts","sourceRoot":"","sources":["../../src/pages/hiringDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAoB3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,mBAAmB,CAkBtF;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAyBjF;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAS1C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAS5C"}