@graview/primitives 0.1.0

package/dist/lens/arranging.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { admitArrangement, arrange, arrangeable, } from "@graview/core";
+import { useGraview, useNavigation } from "@graview/react";
+import { ArrangeBar, arrangementOf, withArrangement } from "../arrange-bar.js";
+const both = (a, b) => {
+    if (a === false || b === false)
+        return false;
+    const one = a === undefined || a === true ? {} : a;
+    const two = b === undefined || b === true ? {} : b;
+    return {
+        sort: one.sort !== false && two.sort !== false,
+        filter: one.filter !== false && two.filter !== false,
+        group: one.group !== false && two.group !== false,
+    };
+};
+const ARRANGEMENT_WORDS = ["sort", "filter", "group", "q"];
+export function useArranging(props, options = {}) {
+    const { store } = useGraview();
+    const { view, go } = useNavigation();
+    const all = props.nodes ?? [];
+    const subject = options.subject ?? (options.only ? all.filter(options.only) : all);
+    const rest = options.subject ? [] : options.only ? all.filter((node) => !options.only(node)) : [];
+    const kind = options.kind ?? subject[0]?.kind;
+    const allow = both(options.allow, options.lensAllows);
+    const said = ARRANGEMENT_WORDS.some((word) => view.within?.[word] !== undefined);
+    const asked = said ? arrangementOf(view) : (options.arrangedBy ?? {});
+    const offers = kind ? arrangeable(store.schema, String(kind)) : undefined;
+    const arrangement = offers ? admitArrangement(asked, offers).arrangement : {};
+    const arranged = arrange(subject, allow === false ? {} : arrangement, {
+        schema: store.schema,
+        graph: store.graph,
+        flagged: new Set(props.flagged ?? []),
+    });
+    // No row on a picture with a budget: a drive-in's thumbnail is a picture of the lens, with no controls.
+    const bar = kind && allow !== false && props.fidelity === "full" && props.budget === undefined && subject.length > 1 ? (_jsx(ArrangeBar, { schema: store.schema, graph: store.graph, kind: String(kind), arrangement: arrangement, allow: allow, query: options.query !== false, onChange: (next) => go(withArrangement(view, next)), kept: { shown: arranged.nodes.length, of: subject.length } })) : null;
+    return { nodes: [...rest, ...arranged.nodes], arranged, arrangement, bar };
+}
+//# sourceMappingURL=arranging.js.map

package/dist/lens/arranging.js.map

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

package/dist/lens/board.d.ts

@@ -0,0 +1,146 @@
+import { type AnySchema, type ArrangeOption, type Arrangement, type NodeOfSchema } from "@graview/core";
+import { type ViewProps } from "@graview/react";
+import { type ReactElement } from "react";
+/**
+ * The board lens: things arranged where the DOMAIN says they go.
+ *
+ * The third picture, and the first one whose geometry the framework does not
+ * own. A timeline places by time; a matrix places by two sets; a board places
+ * by coordinates the app declares on its own nodes — a formation on a pitch,
+ * desks in an office, a stage plot, seats at a table, bays in a warehouse.
+ *
+ * That distinction matters more than it looks. Everywhere else, layout is a
+ * pure function of (focus, relation, graph) and the framework decides where
+ * things sit. Here the arrangement is DATA: a left back is at the left back's
+ * place because the position node says so, and moving it is an ordinary
+ * mutation rather than a change to the layout engine.
+ *
+ * A slot with nothing in it is the point. On a pitch it is the hole in the
+ * team; on a seating plan it is the empty chair. That reads instantly in an
+ * arrangement and not at all in a list.
+ */
+export declare const BOARD_REQUIRED_ROLES: readonly ["slots", "x", "y", "fill"];
+export interface BoardOptions {
+    /** Kind whose nodes are the slots. */
+    readonly slots: string;
+    /** Fields on a slot holding its place, each 0..1 across the board. */
+    readonly x: string;
+    readonly y: string;
+    /** Edge kind between a slot and whatever occupies it. */
+    readonly fill: string;
+    /**
+     * Which end of that edge is the slot. A seating plan says the seat is
+     * "taken-by" a guest; a garden says a planting "grows-in" a plot. Both are
+     * one edge from slot to occupant, read from opposite ends, and a lens that
+     * only knew one of them would make a domain redraw its edges to fit.
+     */
+    readonly fillFrom?: "slot" | "occupant";
+    /**
+     * Field holding a short code for the slot, e.g. "LB".
+     *
+     * WHAT THE CODE IS DECIDES WHAT THE MARK IS. A board whose every code is
+     * three characters or fewer — "GK", "LB", "7" — draws discs, the pitch's
+     * own idiom. Any code longer than that is a WORD, and a word does not fit
+     * in a 34-pixel circle however the circle is drawn: "Outbound" spilled
+     * past its ring and "Prop-fin" wrapped at the hyphen inside it. So a board
+     * of words draws tokens — a pill sized to its code, the occupants inside
+     * it — and it decides once, for the whole board, because a picture that
+     * mixed discs and pills would be two pictures. Unbound, the code is the
+     * slot's label, which is nearly always a word.
+     */
+    readonly slotCode?: string;
+    /** Bands drawn behind the slots, in the same 0..1 space. */
+    readonly zones?: readonly {
+        readonly label: string;
+        readonly from: number;
+        readonly to: number;
+    }[];
+    /** Width divided by height. A pitch is taller than it is wide, seen this way. */
+    readonly aspect?: number;
+    /** What an empty slot is called, in the app's words. */
+    readonly emptyLabel?: string;
+    /**
+     * What a chip click selects. Default `"occupant"`: a sole-filled slot's
+     * disc is that person (lineup / pitch). `"slot"` always selects the slot
+     * itself — Load map wants the component, not the sole owner.
+     */
+    readonly pickTarget?: "slot" | "occupant";
+    /**
+     * Whether the occupants may be sorted and filtered from the picture.
+     * On unless declined; a board has no place to GROUP, so that part is
+     * never offered. `arrangedBy` is what it opens arranged by.
+     */
+    readonly arranging?: ArrangeOption;
+    readonly arrangedBy?: Arrangement;
+    /**
+     * HOW THE SLOTS ARE LAID OUT. Default `"exact"`: each slot at the point
+     * its x and y name, which is a pitch, a seating plan, a warehouse floor —
+     * an arrangement whose geometry means something. `"shelf"`: the x and y
+     * are CATEGORIES, not coordinates — a load map whose rows are "still
+     * owns", "shared", "handoff" — so each zone becomes a band with its name
+     * as a heading, and its slots flow into rows in the domain's order, sized
+     * to what they hold. Nothing on a shelf can overlap anything, which on a
+     * load map with shared seats is the difference between a picture and a
+     * collision. The order is still the domain's; only the pixels are not.
+     */
+    readonly arrange?: "exact" | "shelf";
+}
+export interface BoardSlot {
+    readonly id: string;
+    readonly code: string;
+    readonly label: string;
+    readonly x: number;
+    readonly y: number;
+    /**
+     * Whoever is in it — none, one, or several. A plot with two plantings
+     * showed one and listed the other as "not in", which was a picture
+     * stating something untrue: the second planting was in the ground.
+     */
+    readonly occupants: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+}
+export interface BoardState {
+    readonly slots: readonly BoardSlot[];
+    /** Slots with nothing in them. The reason the lens exists. */
+    readonly empty: readonly string[];
+    /** Candidates not placed in any slot — the bench. */
+    readonly spare: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+}
+export declare class BoardBindingError extends Error {
+    readonly hint: string;
+    constructor(message: string, hint: string);
+}
+/**
+ * Reads the arrangement out of the graph. Pure and exported, so a test can
+ * assert on the holes rather than on the drawing of them.
+ */
+export declare function buildBoard<S extends AnySchema>(nodes: readonly NodeOfSchema<S>[], edges: readonly {
+    kind: string;
+    from: string;
+    to: string;
+}[], options: BoardOptions, schema?: S): BoardState;
+export interface BoardViewProps<S extends AnySchema> extends ViewProps<S> {
+    readonly options: BoardOptions;
+    readonly schema?: S;
+    /** The occupants to draw, in the order to draw them. Everyone, when unsaid. */
+    readonly occupants?: readonly string[];
+}
+export declare function BoardView<S extends AnySchema>({ nodes, occupants, label, fidelity, mode, options, schema, implicated, flagged, }: BoardViewProps<S>): import("react").JSX.Element;
+export interface BoardLens<S extends AnySchema> {
+    readonly name: "board";
+    readonly requiredRoles: readonly string[];
+    readonly options: BoardOptions;
+    View(props: ViewProps<S>): ReactElement | null;
+    build(nodes: readonly NodeOfSchema<S>[], edges: readonly {
+        kind: string;
+        from: string;
+        to: string;
+    }[], schema?: S): BoardState;
+}
+export declare function createBoardLens<S extends AnySchema>(options: BoardOptions): BoardLens<S>;
+//# sourceMappingURL=board.d.ts.map

package/dist/lens/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/lens/board.tsx"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAIvE;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,oBAAoB,sCAAuC,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACxC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnG,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAtC,OAAO,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM;CAInD;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAC5C,KAAK,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EACjC,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAC5D,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,CAAC,GACT,UAAU,CAyEZ;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,EAC7C,KAAK,EACL,SAAS,EACT,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,MAAM,EACN,UAAe,EACf,OAAY,GACb,EAAE,cAAc,CAAC,CAAC,CAAC,+BA+xBnB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,SAAS;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAC/C,KAAK,CACH,KAAK,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EACjC,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,EAC5D,MAAM,CAAC,EAAE,CAAC,GACT,UAAU,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,CA2ExF"}