@graview/primitives 0.1.0

package/LICENSE

@@ -0,0 +1,96 @@
+Elastic License 2.0
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set
+of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company
+makes such a claim, your patent license ends immediately for work on behalf
+of your company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not
+licensed, and your licenses will automatically terminate. If the licensor
+provides you with a notice of your violation, and you cease all violation of
+this license no later than 30 days after you receive that notice, your
+licenses will be reinstated retroactively. However, if you violate these
+terms after such reinstatement, any additional violation of these terms will
+cause your licenses to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is
+the software the licensor makes available under these terms, including any
+portion of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control
+over, are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of
+an entity, or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your
+licenses.
+
+**trademark** means trademarks, service marks, and similar rights.
+
+---
+
+Copyright 2025-2026 En Dash Consulting

package/README.md

@@ -0,0 +1,25 @@
+# @graview/primitives
+
+A rich primitive set, five lenses, the workbench and the visual system.
+
+**Primitives** — `Panel`, `Chip`, `Roster`, `Grid`, `Axis`, `Connector`,
+`Aggregate`, `Fields`. Enough that a new node kind renders sensibly at all
+three fidelities before anyone writes a view for it.
+
+**Lenses** — a timeline, a calendar, a coverage matrix, a board and a plan.
+Each binds ROLES to an app's own fields or kinds, so a lens written for one
+domain is reused by another without learning anything about it. All five are
+built from the public primitives, which makes them the worked example of the
+authoring API rather than privileged insiders. The board draws discs when
+every slot's code is three characters or fewer and tokens — a pill sized to
+the word, the occupants inside it — when any code is longer; `arrange:
+"shelf"` lays a board whose x and y are categories out as headed bands.
+
+**Workbench** — the parts of an interface that are not about the domain: what
+is selected and what can be done with it, whether the rules hold, what just
+happened and how to take it back, how to back out of a view. All derived from
+the schema, the invariants and the op log.
+
+**Visual system** — `themeCss(scheme, brand)`. Two schemes that are not
+inversions of each other: dark loses luminance, light loses contrast and gains
+haze. A brand supplies its own and `graview check` measures it.

package/dist/arrange-bar.d.ts

@@ -0,0 +1,49 @@
+import { type AnySchema, type Arrangeable, type ArrangeOption, type Arrangement, type ArrangeGraph, type Condition } from "@graview/core";
+import { type ViewState } from "@graview/layout";
+import type { CSSProperties, ReactNode } from "react";
+/**
+ * ONE CONTROL ROW FOR EVERY SURFACE THAT ARRANGES.
+ *
+ * The list page had a group-by select of its own, the todo app's own page
+ * had three, the lenses had none. The offers come from the declaration
+ * (`arrangeable`), the chosen arrangement is a string in the stop, and
+ * this draws the row between them: Sort by, Group by, the conditions as
+ * chips with a way to add one, and the words a person types. Whatever
+ * carries the arrangement — a page's search, a lens's `within` — hands the
+ * current one in and takes the next one back; nothing here holds state.
+ */
+export interface ArrangeBarProps {
+    readonly schema: AnySchema;
+    readonly graph: ArrangeGraph;
+    readonly kind: string;
+    readonly arrangement: Arrangement;
+    readonly onChange: (next: Arrangement) => void;
+    /** What the surface declines, if anything. Everything is on unless declined. */
+    readonly allow?: ArrangeOption;
+    /** Whether to draw the words box. On unless declined. */
+    readonly query?: boolean;
+    /** How many the arrangement kept, of how many there were — said beside the row when given. */
+    readonly kept?: {
+        readonly shown: number;
+        readonly of: number;
+    };
+    /** Prefix for the row's test ids: `arrange` by default. */
+    readonly testId?: string;
+    readonly style?: CSSProperties;
+}
+/** The far ends an edge condition may name, from the graph. */
+/**
+ * The far ends a menu offers to narrow by. A menu is for choosing, not for
+ * reading a catalogue: past FAR_ENDS it holds the most connected (the ones a
+ * person most likely means), and the search reaches the rest — a select of
+ * 1,177 songs was 1,177 elements in every row that offered it (docs/scale.md).
+ */
+export declare const FAR_ENDS = 40;
+/** A condition in words: "Due date before 2026-10-01", "The list it is on: Today", "Past". */
+export declare function sayCondition(schema: AnySchema, graph: ArrangeGraph, offers: Arrangeable, condition: Condition): string;
+export declare function ArrangeBar(props: ArrangeBarProps): import("react").JSX.Element | null;
+export declare function arrangementOf(view: ViewState): Arrangement;
+export declare function withArrangement(view: ViewState, arrangement: Arrangement): ViewState;
+/** A small caption for what an arrangement did, for a surface with no room for the row. */
+export declare function arrangementCaption(arrangement: Arrangement): ReactNode;
+//# sourceMappingURL=arrange-bar.d.ts.map

package/dist/arrange-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange-bar.d.ts","sourceRoot":"","sources":["../src/arrange-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAgED,+DAA+D;AAC/D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,KAAK,CAAC;AAsB3B,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAgBtH;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,sCAsKhD;AAoFD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAQ1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,SAAS,CAKpF;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAOtE"}

package/dist/arrange-bar.js

@@ -0,0 +1,264 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { arrangeAllows, arrangeable, formatArrangement, labelOf, parseArrangement, } from "@graview/core";
+import { withWithin } from "@graview/layout";
+/*
+ * NOTHING HERE MAY WIDEN THE PAGE. A select is as wide as its longest
+ * option, and at a reader's own text size — 32px root on a 390px phone —
+ * "as declared (due date)" alone pushed the tasks page sideways. Every
+ * control caps at the row's width and the row wraps; a long option is cut
+ * inside its box rather than carried outside it.
+ */
+const control = {
+    font: "inherit",
+    fontSize: "0.875rem",
+    minHeight: 32,
+    minWidth: 0,
+    maxWidth: "100%",
+    padding: "4px 8px",
+    borderRadius: 8,
+    border: "1px solid var(--graview-edge)",
+    background: "var(--graview-panel)",
+    color: "var(--graview-ink)",
+    textOverflow: "ellipsis",
+};
+/*
+ * A SELECT THAT KEEPS ITS FLOOR IN EVERY ENGINE. WebKit draws a native
+ * select at its own height and ignores `min-height`: at phone width every
+ * arrange bar's select was 22 pixels tall in WebKit and 32 elsewhere —
+ * under the 24 a target needs, measured by a check that had only ever run
+ * in Chromium (the third walk's lesson, in the fifth). With the native
+ * appearance off the floor holds, and the chevron is drawn in the text's
+ * colour the way the places menu draws it.
+ */
+const choice = {
+    ...control,
+    appearance: "none",
+    WebkitAppearance: "none",
+    paddingRight: 24,
+    backgroundImage: "linear-gradient(45deg, transparent 50%, currentColor 50%), linear-gradient(135deg, currentColor 50%, transparent 50%)",
+    backgroundPosition: "calc(100% - 13px) 55%, calc(100% - 9px) 55%",
+    backgroundSize: "4px 4px, 4px 4px",
+    backgroundRepeat: "no-repeat",
+};
+const label = {
+    display: "inline-flex",
+    alignItems: "center",
+    flexWrap: "wrap",
+    gap: 6,
+    minWidth: 0,
+    maxWidth: "100%",
+    fontSize: "0.875rem",
+    color: "var(--graview-ink-muted)",
+};
+const chip = {
+    display: "inline-flex",
+    alignItems: "center",
+    gap: 6,
+    minHeight: 28,
+    padding: "0 2px 0 10px",
+    borderRadius: 999,
+    border: "1px solid var(--graview-edge)",
+    background: "var(--graview-panel)",
+    color: "var(--graview-ink)",
+    fontSize: "0.8125rem",
+};
+/** The far ends an edge condition may name, from the graph. */
+/**
+ * The far ends a menu offers to narrow by. A menu is for choosing, not for
+ * reading a catalogue: past FAR_ENDS it holds the most connected (the ones a
+ * person most likely means), and the search reaches the rest — a select of
+ * 1,177 songs was 1,177 elements in every row that offered it (docs/scale.md).
+ */
+export const FAR_ENDS = 40;
+function farEndsOf(schema, graph, offer) {
+    const kinds = offer.far ?? [];
+    const seen = new Map();
+    const wanted = new Set(kinds);
+    for (const node of graph.allNodes()) {
+        if (!wanted.has(node.kind))
+            continue;
+        seen.set(node.id, labelOf(schema.tryDefinition(node.kind), node));
+    }
+    const ends = [...seen.entries()].map(([id, text]) => ({ id, label: text }));
+    const kept = ends.length <= FAR_ENDS
+        ? ends
+        : ends
+            .map((end) => ({ end, ties: graph.out(end.id).length + graph.in(end.id).length }))
+            .sort((a, b) => b.ties - a.ties || a.end.label.localeCompare(b.end.label))
+            .slice(0, FAR_ENDS)
+            .map((entry) => entry.end);
+    return kept.sort((a, b) => a.label.localeCompare(b.label));
+}
+/** A condition in words: "Due date before 2026-10-01", "The list it is on: Today", "Past". */
+export function sayCondition(schema, graph, offers, condition) {
+    const offer = offers.filters.find((candidate) => candidate.key === condition.key);
+    if (!offer)
+        return `${condition.key}: ${condition.value}`;
+    if (offer.about === "is")
+        return condition.value.charAt(0).toUpperCase() + condition.value.slice(1);
+    if (offer.about === "edge") {
+        if (condition.value === "*")
+            return `${offer.label}: anything`;
+        if (condition.value === "none")
+            return `${offer.label}: nothing`;
+        const node = graph.getNode(condition.value);
+        return `${offer.label}: ${node ? labelOf(schema.tryDefinition(node.kind), node) : condition.value}`;
+    }
+    if (offer.type === "date") {
+        const [op, date] = condition.value.split(":");
+        return `${offer.label} ${op} ${date ?? ""}`.trim();
+    }
+    if (offer.type === "boolean")
+        return `${offer.label}: ${condition.value === "true" ? "yes" : "no"}`;
+    return `${offer.label}: ${condition.value}`;
+}
+/** What each bar last sent, by its test id and kind (see `ArrangeBar`). */
+const SENT = new Map();
+export function ArrangeBar(props) {
+    const { schema, graph, kind, arrangement: given, onChange } = props;
+    const offers = arrangeable(schema, kind);
+    const id = props.testId ?? "arrange";
+    const sorts = arrangeAllows(props.allow, "sort");
+    const groups = arrangeAllows(props.allow, "group");
+    const filters = arrangeAllows(props.allow, "filter");
+    const words = props.query !== false;
+    if (!sorts && !groups && !filters && !words)
+        return null;
+    /*
+     * TWO CHANGES BEFORE ONE RENDER ARE TWO CHANGES. The bar merged each change
+     * onto the arrangement it was drawn with, and the arrangement comes back
+     * through the address or the view a render later — so a grouping chosen
+     * and a word typed before the page redrew sent the word on top of the old
+     * grouping, and the grouping was lost (on a slow phone, every time). The
+     * bar merges onto what it last sent while what comes back is its own echo,
+     * and follows what comes back once something else changed it.
+     */
+    const said = (one) => JSON.stringify(formatArrangement(one));
+    /*
+     * Kept per bar, not per mount: a busy page redrew the bar between a choice
+     * and the next keystroke, and a bar that forgot what it had sent took the
+     * stale arrangement back. For a moment after its own change it trusts what
+     * it sent; after that, what comes back is either its echo or news.
+     */
+    const memory = `${id}|${kind}`;
+    const sent = { current: SENT.get(memory) ?? { words: new Set(), latest: null, at: 0 } };
+    SENT.set(memory, sent.current);
+    if (sent.current.latest && Date.now() - sent.current.at > 1500 && !sent.current.words.has(said(given))) {
+        sent.current = { words: new Set(), latest: null, at: 0 };
+        SENT.set(memory, sent.current);
+    }
+    // What the controls show: what the bar last sent while what comes back is its echo.
+    const arrangement = sent.current.latest ?? given;
+    const set = (patch) => {
+        // What the bar last sent, read now — not the arrangement this render was drawn with.
+        const next = { ...(sent.current.latest ?? given), ...patch };
+        for (const key of Object.keys(next))
+            if (next[key] === undefined)
+                delete next[key];
+        sent.current.latest = next;
+        sent.current.at = Date.now();
+        sent.current.words.add(said(next));
+        onChange(next);
+    };
+    const conditions = arrangement.filter ?? [];
+    const without = (at) => {
+        const rest = conditions.filter((_, index) => index !== at);
+        set({ filter: rest.length > 0 ? rest : undefined });
+    };
+    const add = (condition) => set({ filter: [...conditions.filter((c) => !(c.key === condition.key && c.value === condition.value)), condition] });
+    return (_jsxs("div", { "data-testid": `${id}-bar`, role: "group", "aria-label": "Arrange", style: { display: "flex", flexWrap: "wrap", alignItems: "center", gap: "8px 14px", minWidth: 0, maxWidth: "100%", ...props.style }, children: [words ? (_jsxs("label", { style: label, children: [_jsx("span", { className: "graview-visually-hidden", style: { position: "absolute", width: 1, height: 1, overflow: "hidden", clip: "rect(0 0 0 0)" }, children: "Find" }), _jsx("input", { type: "search", "data-testid": `${id}-query`, value: arrangement.query ?? "", placeholder: "Find\u2026", onChange: (event) => set({ query: event.target.value.length > 0 ? event.target.value : undefined }), style: { ...control, width: "min(100%, 220px)" } })] })) : null, sorts && offers.sorts.length > 1 ? (_jsxs("label", { style: label, children: ["Sort by", _jsxs("select", { "data-testid": `${id}-sort`, value: arrangement.sort?.by ?? "", onChange: (event) => set({
+                            sort: event.target.value ? { by: event.target.value, direction: arrangement.sort?.direction ?? "asc" } : undefined,
+                        }), style: { ...choice, maxWidth: "min(100%, 60vw)" }, children: [_jsx("option", { value: "", children: offers.natural ? `as declared (${offers.sorts.find((o) => o.key === offers.natural.by)?.label.toLowerCase() ?? offers.natural.by})` : "as they come" }), offers.sorts.map((offer) => (_jsx("option", { value: offer.key, children: offer.label }, offer.key)))] }), arrangement.sort ? (_jsx("button", { type: "button", "data-testid": `${id}-direction`, "aria-label": arrangement.sort.direction === "asc" ? "Ascending; press for descending" : "Descending; press for ascending", title: arrangement.sort.direction === "asc" ? "Ascending" : "Descending", onClick: () => set({ sort: { by: arrangement.sort.by, direction: arrangement.sort.direction === "asc" ? "desc" : "asc" } }), style: { ...control, minWidth: 32, cursor: "pointer" }, children: arrangement.sort.direction === "asc" ? "↑" : "↓" })) : null] })) : null, groups && offers.groups.length > 0 ? (_jsxs("label", { style: label, children: ["Group by", _jsxs("select", { "data-testid": `${id}-group`, value: arrangement.group?.by ?? "", onChange: (event) => set({ group: event.target.value ? { by: event.target.value } : undefined }), style: { ...choice, maxWidth: "min(100%, 60vw)" }, children: [_jsx("option", { value: "", children: "nothing" }), offers.groups.map((offer) => (_jsx("option", { value: offer.key, children: offer.label }, offer.key)))] }), arrangement.group && offers.groups.find((offer) => offer.key === arrangement.group.by)?.buckets ? (_jsxs("select", { "data-testid": `${id}-bucket`, "aria-label": "How wide a group is", value: arrangement.group.bucket ?? "day", onChange: (event) => set({ group: { by: arrangement.group.by, bucket: event.target.value } }), style: choice, children: [_jsx("option", { value: "day", children: "by day" }), _jsx("option", { value: "week", children: "by week" }), _jsx("option", { value: "month", children: "by month" }), _jsx("option", { value: "year", children: "by year" }), _jsx("option", { value: "decade", children: "by decade" })] })) : null] })) : null, filters && offers.filters.length > 0 ? (_jsx(AddCondition, { schema: schema, graph: graph, offers: offers, testId: id, onAdd: add })) : null, filters
+                ? conditions.map((condition, at) => (_jsxs("span", { style: chip, "data-testid": `${id}-condition`, children: [sayCondition(schema, graph, offers, condition), _jsx("button", { type: "button", "aria-label": `Remove: ${sayCondition(schema, graph, offers, condition)}`, onClick: () => without(at), 
+                            // A control big enough to hit: 24px is the floor the face is held to, and a bare "×" glyph is 16 by 13.
+                            style: { font: "inherit", border: 0, background: "transparent", color: "inherit", cursor: "pointer", padding: 0, lineHeight: 1, minWidth: 24, minHeight: 24, display: "inline-flex", alignItems: "center", justifyContent: "center", borderRadius: 999 }, children: "\u00D7" })] }, `${condition.key}:${condition.value}`)))
+                : null, props.kept && props.kept.shown !== props.kept.of ? (_jsxs("span", { "data-testid": `${id}-kept`, style: { ...label, marginLeft: "auto" }, children: [props.kept.shown, " of ", props.kept.of] })) : null] }));
+}
+/**
+ * "Add a condition": one select naming the offer, then — for what needs a
+ * value — a second control for it. Two presses, and the chip appears.
+ */
+function AddCondition({ schema, graph, offers, testId, onAdd, }) {
+    /*
+     * Every offer's values are known up front — a choice's options, `is`'s
+     * words, an edge's far ends, a boolean's yes and no — so the whole set is
+     * one grouped select and one press adds a chip. A date wants typing, so
+     * it is listed as three entries that ask for the date when chosen.
+     */
+    const entries = [];
+    for (const offer of offers.filters) {
+        if (offer.about === "is") {
+            for (const word of offer.options ?? [])
+                entries.push({ value: `is:${word}`, label: word, group: offer.label, condition: { key: "is", value: word } });
+        }
+        else if (offer.about === "edge") {
+            entries.push({ value: `${offer.key}:*`, label: "anything", group: offer.label, condition: { key: offer.key, value: "*" } });
+            entries.push({ value: `${offer.key}:none`, label: "nothing", group: offer.label, condition: { key: offer.key, value: "none" } });
+            for (const end of farEndsOf(schema, graph, offer))
+                entries.push({ value: `${offer.key}:${end.id}`, label: end.label, group: offer.label, condition: { key: offer.key, value: end.id } });
+        }
+        else if (offer.type === "date") {
+            for (const op of ["before", "after", "on"])
+                entries.push({ value: `${offer.key}:${op}`, label: `${op}…`, group: offer.label, ask: { key: offer.key, op, label: offer.label } });
+        }
+        else if (offer.type === "boolean") {
+            entries.push({ value: `${offer.key}:true`, label: "yes", group: offer.label, condition: { key: offer.key, value: "true" } });
+            entries.push({ value: `${offer.key}:false`, label: "no", group: offer.label, condition: { key: offer.key, value: "false" } });
+        }
+        else {
+            for (const option of offer.options ?? [])
+                entries.push({ value: `${offer.key}:${option}`, label: option, group: offer.label, condition: { key: offer.key, value: option } });
+        }
+    }
+    const groups = [...new Set(entries.map((entry) => entry.group))];
+    return (_jsxs("label", { style: label, children: ["Only", _jsxs("select", { "data-testid": `${testId}-add`, value: "", onChange: (event) => {
+                    const entry = entries.find((candidate) => candidate.value === event.target.value);
+                    if (!entry)
+                        return;
+                    if (entry.condition)
+                        onAdd(entry.condition);
+                    else if (entry.ask) {
+                        const date = typeof window !== "undefined" ? window.prompt(`${entry.ask.label} ${entry.ask.op} which day? (YYYY-MM-DD)`) : null;
+                        if (date && /^\d{4}-\d{2}-\d{2}$/.test(date))
+                            onAdd({ key: entry.ask.key, value: `${entry.ask.op}:${date}` });
+                    }
+                }, style: choice, children: [_jsx("option", { value: "", children: "only\u2026" }), groups.map((group) => (_jsx("optgroup", { label: group, children: entries
+                            .filter((entry) => entry.group === group)
+                            .map((entry) => (_jsx("option", { value: entry.value, children: entry.label }, entry.value))) }, group)))] })] }));
+}
+/*
+ * THE STOP CARRIES IT. A lens reads its arrangement out of `view.within`
+ * and writes the next one back with these; `in.sort`, `in.filter`,
+ * `in.group` and `in.q` are the fragment's spelling of the same words a
+ * page puts in its search.
+ */
+export function arrangementOf(view) {
+    const within = view.within ?? {};
+    return parseArrangement({
+        ...(within["sort"] ? { sort: within["sort"] } : {}),
+        ...(within["filter"] ? { filter: within["filter"] } : {}),
+        ...(within["group"] ? { group: within["group"] } : {}),
+        ...(within["q"] ? { q: within["q"] } : {}),
+    });
+}
+export function withArrangement(view, arrangement) {
+    const words = formatArrangement(arrangement);
+    let next = view;
+    for (const key of ["sort", "filter", "group", "q"])
+        next = withWithin(next, key, words[key] ?? null);
+    return next;
+}
+/** A small caption for what an arrangement did, for a surface with no room for the row. */
+export function arrangementCaption(arrangement) {
+    const parts = [];
+    if (arrangement.query)
+        parts.push(`“${arrangement.query}”`);
+    if (arrangement.filter?.length)
+        parts.push(`${arrangement.filter.length} condition${arrangement.filter.length === 1 ? "" : "s"}`);
+    if (arrangement.group)
+        parts.push(`by ${arrangement.group.by}`);
+    if (arrangement.sort)
+        parts.push(`sorted by ${arrangement.sort.by}`);
+    return parts.length > 0 ? parts.join(" · ") : null;
+}
+//# sourceMappingURL=arrange-bar.js.map

package/dist/arrange-bar.js.map

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

package/dist/chat.d.ts

@@ -0,0 +1,46 @@
+import type { AnySchema } from "@graview/core";
+import { type Responder, type ToolCall } from "@graview/tools";
+/**
+ * A SEAT YOU CAN TALK TO.
+ *
+ * The agent seat runs a turn when pressed; the providers whisper into the
+ * inspector; nothing let a person ASK. This panel does — and it earns no
+ * new trust to do it: every answer comes from a Responder (the graph's own
+ * deterministic one by default, a model through the one-function seam when
+ * the host supplies it), and every proposal is an ordinary validated call,
+ * applied through the same runtime a seat uses, attributed to `chat` in
+ * the log, previewer-visible, undoable. Words in, the usual paths out.
+ *
+ * The conversation itself — turns, outcomes, the thread, the header and the
+ * field — is `seat.tsx`, shared with the studio's declaration seat; what is
+ * this panel's own is what a proposal does here: apply to the graph.
+ */
+export interface ChatPanelProps<S extends AnySchema> {
+    /**
+     * Drawn INSIDE something that already frames it — the companion rail —
+     * rather than as a pill on the bar with a panel hanging off it: no
+     * trigger, no float, no border of its own, and always open, because the
+     * rail is what opens and closes.
+     */
+    readonly inside?: boolean;
+    /** How the seat answers. Defaults to the graph's own responder. */
+    readonly respond?: Responder<S>;
+    /**
+     * Where a pick goes — a thing the words found, pressed. The scene focuses
+     * and selects it; a face with no scene to move (the pages' drawer) goes
+     * to the record's page instead.
+     */
+    readonly onPick?: (id: string) => void;
+    /**
+     * GROUNDED QUESTIONS, OFFERED BEFORE ANYBODY TYPES. A panel showing an
+     * empty field asks the person to guess what it can answer; these are
+     * questions the graph's own responder can answer about what is in front
+     * of them, and pressing one asks it.
+     */
+    readonly offer?: readonly string[];
+    /** Feeds the app's activity rail, like any other seat. */
+    readonly onCall?: (call: ToolCall) => void;
+    readonly testId?: string;
+}
+export declare function ChatPanel<S extends AnySchema>({ inside, offer, respond, onCall, onPick, testId, }: ChatPanelProps<S>): import("react").JSX.Element;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAUL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAOxB;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,SAAS;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,EAC7C,MAAc,EACd,KAAK,EACL,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAe,GAChB,EAAE,cAAc,CAAC,CAAC,CAAC,+BAuhBnB"}