@graview/primitives 0.1.0

package/dist/shell.d.ts

@@ -0,0 +1,74 @@
+import type { AnySchema } from "@graview/core";
+import { type Scheme, type SceneProps } from "@graview/react";
+import type { Responder, ToolCall } from "@graview/tools";
+import { type ReactNode } from "react";
+/**
+ * The shell: everything an application's window holds that is not about
+ * its domain.
+ *
+ * The command bar — the wordmark that is the way home, the browser's own
+ * back and forward made visible, the trail, the other face, whether the
+ * rules hold, the chat, the activity and the seat, the scheme — then the
+ * scene with its key, its quick relations, the altitude control and the
+ * inspector. Three apps carried this same eighty lines each and drifted;
+ * now an app supplies a home, a sentence for when nothing is wrong, and
+ * whatever seat it wants to give an agent, and the rest is derived.
+ *
+ * Landmarks are here too, once: a heading for assistive technology (the
+ * wordmark is the visible one) and a main region around the scene.
+ */
+export interface ShellProps<S extends AnySchema> {
+    /** The view id that is "home" for the trail and for Escape; null for the whole graph. */
+    readonly home?: string | null;
+    readonly homeLabel?: string;
+    /** What Standing says when no rule is broken. */
+    readonly standing?: string;
+    /** The seat in the activity rail, given the rail's own call recorder. */
+    readonly seat?: (onCall: (call: ToolCall) => void) => ReactNode;
+    /** Anything the bar shows between the browser controls and the trail — a places switcher, say. */
+    readonly nav?: ReactNode;
+    /** Where the routed face lives; null hides the link. */
+    readonly pagesHref?: string | null;
+    /** Whether the store is remembered in this browser (the rail says so, and offers the way back). */
+    readonly remembers?: boolean;
+    /** Whether the view rides the URL. */
+    readonly syncUrl?: boolean;
+    readonly renderer?: "gpu" | "dom" | "auto";
+    readonly attachRenderer?: SceneProps["attachRenderer"];
+    readonly scheme: Scheme;
+    readonly onScheme: (scheme: Scheme) => void;
+    /**
+     * The chat seat, on by default: it answers from the graph with no key.
+     *
+     * `{ respond }` hands it the app's OWN responder. `ChatPanel` has always
+     * taken one — the agent-seat skill is about writing one — and the shell
+     * that every app uses, and that the scaffolder wires up, exposed the panel
+     * as a boolean. So an app that wrote a domain responder had no way to put
+     * it in the scene's chat: it could turn the chat off and rebuild that part
+     * of the shell, or leave the generic answer in the surface most people
+     * actually type into. A seam is only as reachable as the most convenient
+     * component sitting on top of it, and a prop the shell does not forward is
+     * in practice a prop that does not exist.
+     */
+    readonly chat?: boolean | {
+        readonly respond?: Responder<S>;
+    };
+    /**
+     * Where a person's own record lives on the routed face. Given, the
+     * profile pane links to it; absent, the pane says who you are without
+     * pretending there is somewhere to go.
+     */
+    readonly profileHref?: (userId: string) => string;
+    /**
+     * The way into the app's own declaration — `<StudioPlace app={...} />`
+     * from `@graview/studio`, which an app passes because only the app knows
+     * which declaration it is running.
+     *
+     * A slot rather than a direct import: the shell would otherwise depend on
+     * the studio, the studio already depends on the shell's own primitives,
+     * and the cycle would be real rather than a typing accident.
+     */
+    readonly studio?: ReactNode;
+}
+export declare function Shell<S extends AnySchema>({ home, homeLabel, standing, seat, nav, pagesHref, remembers, syncUrl, renderer, attachRenderer, scheme, onScheme, chat, profileHref, studio, }: ShellProps<S>): import("react").JSX.Element;
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA4D,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAyB,KAAK,SAAS,EAAU,MAAM,OAAO,CAAC;AAmBtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS;IAC7C,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,KAAK,SAAS,CAAC;IAChE,kGAAkG;IAClG,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mGAAmG;IACnG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAKD,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,EACzC,IAAW,EACX,SAAS,EACT,QAAmC,EACnC,IAAI,EACJ,GAAG,EACH,SAAoB,EACpB,SAAiB,EACjB,OAAe,EACf,QAAgB,EAChB,cAAc,EACd,MAAM,EACN,QAAQ,EACR,IAAW,EACX,WAAW,EACX,MAAM,GACP,EAAE,UAAU,CAAC,CAAC,CAAC,+BAuLf"}

package/dist/shell.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Scene, useGraview, UrlSync, useTheKeyboardLandsSomewhere } from "@graview/react";
+import { useCallback, useState, useRef } from "react";
+import { Companion } from "./companion.js";
+import { VISUALLY_HIDDEN, useWidth } from "./primitives/index.js";
+import { FindBox } from "./find.js";
+import { ShowInstallation } from "./installation.js";
+import { Profile } from "./profile.js";
+import { Places } from "./places.js";
+import { ActivityRail, BackOut, Backtrack, Inspector, OverviewButton, FollowingLine, Standing, Trail, } from "./workbench/index.js";
+import { Wordmark } from "./wordmark.js";
+/** The narrowest the Find box gets at a desk: room for a word, not a sliver. */
+const FIND_FLOOR = "6rem";
+export function Shell({ home = null, homeLabel, standing = "Everything is in order", seat, nav, pagesHref = "/pages", remembers = false, syncUrl = false, renderer = "dom", attachRenderer, scheme, onScheme, chat = true, profileHref, studio, }) {
+    const { brand } = useGraview();
+    // Below a laptop's width the standing and the profile keep their marks and
+    // give up their words; the words are their titles either way.
+    const bar = useRef(null);
+    const barWidth = useWidth(bar);
+    // An act that removes what the keyboard stood on lands it on what still stands.
+    const shell = useRef(null);
+    useTheKeyboardLandsSomewhere(shell);
+    // The standing's sentence goes first — the app's own places are worth
+    // more than "everything is in order" said in words — and the name behind
+    // the profile's mark goes at a laptop's width.
+    const quiet = barWidth !== null && barWidth < 1560;
+    const compact = barWidth !== null && barWidth < 1100;
+    /*
+     * A PHONE GETS TWO ROWS. One row that hides what it cannot hold is the
+     * failure the old bar was built against: at 390 a scaffolded app had no
+     * undo, no activity and no way back to light, painted off the edge with
+     * nothing to say so. Below a small laptop's width the bar wraps — the
+     * places as one menu on their own line — and the picture starts under it.
+     * The line is where one row stops holding the name, the places, a Find
+     * box with room to type in and the profile: at 720 a long record's name
+     * pushed the profile — the seat switcher — off the screen, so it is 920.
+     */
+    const narrow = barWidth !== null && barWidth < 920;
+    const [calls, setCalls] = useState([]);
+    const onCall = useCallback((call) => {
+        setCalls((current) => {
+            // A call that settles replaces its own "running" entry rather than
+            // stacking on it, so the rail shows twelve turns, not twelve halves.
+            const settling = call.phase !== "running" && current[0]?.name === call.name && current[0]?.at === call.at;
+            return [call, ...(settling ? current.slice(1) : current)].slice(0, 12);
+        });
+    }, []);
+    return (_jsxs("div", { ref: shell, style: { display: "flex", flexDirection: "column", height: "100vh", overflow: "hidden" }, children: [_jsxs("header", { ref: bar, 
+                /*
+                 * ONE ROW. Three regions: who this is and the way back, on the
+                 * left; the app's own places, in the middle, as one segmented
+                 * control that hands what it cannot hold to a menu rather than
+                 * wrapping; and what is true and who you are, on the right, which
+                 * shed their words before the bar sheds anything else. The bar
+                 * used to wrap into two rows of equal pills at a laptop's width,
+                 * and a bar that is two rows tall is a picture that starts lower.
+                 */
+                style: {
+                    display: "flex",
+                    alignItems: "center",
+                    flexWrap: narrow ? "wrap" : "nowrap",
+                    gap: narrow ? "6px 10px" : 14,
+                    boxSizing: "border-box",
+                    padding: narrow ? "8px 12px" : "0 16px",
+                    ...(narrow ? { minHeight: 54 } : { height: 54 }),
+                    flex: "0 0 auto",
+                    borderBottom: "1px solid var(--graview-edge)",
+                    background: "var(--graview-bar)",
+                    backdropFilter: "blur(14px)",
+                    position: "relative",
+                    zIndex: 20,
+                    // Never clipped: the profile, the standing and the activity hang
+                    // their panes from this bar, and a clip here cut them off at the
+                    // bar's foot. The places row keeps its own overflow.
+                }, children: [syncUrl ? _jsx(UrlSync, {}) : null, _jsx("h1", { style: { ...VISUALLY_HIDDEN, margin: 0 }, children: brand?.name ?? "Graview" }), _jsxs("div", { style: { display: "flex", alignItems: "center", gap: 10, minWidth: 0, ...(narrow ? { flexWrap: "wrap", flex: "1 1 auto", rowGap: 6 } : { flex: "0 0 auto" }) }, children: [_jsx(Wordmark, {}), _jsx(Backtrack, {}), pagesHref ? (
+                            // THE TWO FACES, as one switch: the scene, and the same app as pages.
+                            _jsxs("div", { role: "group", "aria-label": "Face", "data-testid": "faces", style: { display: "inline-flex", padding: 3, gap: 2, borderRadius: 999, border: "1px solid var(--graview-edge)", background: "var(--graview-panel-muted)", flex: "0 0 auto" }, children: [_jsx("span", { "aria-current": "page", style: { display: "inline-flex", alignItems: "center", minHeight: 26, padding: "2px 11px", borderRadius: 999, fontSize: "0.8125rem", fontWeight: 600, color: "var(--graview-ink)", background: "var(--graview-panel)", border: "1px solid var(--graview-edge)" }, children: "Scene" }), _jsx("a", { href: pagesHref, "data-testid": "pages-link", title: "The same app, as ordinary pages", style: { display: "inline-flex", alignItems: "center", minHeight: 26, padding: "2px 11px", borderRadius: 999, fontSize: "0.8125rem", fontWeight: 500, color: "var(--graview-ink-muted)", textDecoration: "none" }, children: "Pages" })] })) : null, nav, _jsx(Trail, { home: home, ...(homeLabel !== undefined ? { homeLabel } : {}) })] }), _jsx("div", { style: narrow ? { flex: "1 1 100%", order: 3, minWidth: 0, display: "flex" } : { flex: "1 1 auto", minWidth: 0, display: "flex", justifyContent: "center" }, children: _jsx(Places, { compact: narrow }) }), _jsx("div", { style: narrow ? { flex: "1 1 100%", order: 4, minWidth: 0, display: "flex" } : { flex: "0 1 15rem", minWidth: FIND_FLOOR, display: "flex" }, children: _jsx(FindBox, { compact: narrow }) }), _jsxs("div", { style: {
+                            display: "flex",
+                            alignItems: "center",
+                            justifyContent: "flex-end",
+                            gap: 8,
+                            flex: narrow ? "1 1 auto" : "0 0 auto",
+                            minWidth: 0,
+                        }, children: [_jsx(Standing, { clean: standing, compact: quiet }), _jsx(FollowingLine, {}), _jsx(ActivityRail, { remembers: remembers, calls: calls, seat: seat?.(onCall) }), _jsx(Profile, { scheme: scheme, onScheme: onScheme, compact: compact, ...(profileHref ? { profileHref } : {}), keeping: _jsxs(_Fragment, { children: [_jsx(ShowInstallation, {}), studio] }) })] })] }), _jsx(BackOut, { home: home }), _jsxs("main", { tabIndex: -1, style: { position: "relative", flex: "1 1 auto", minHeight: 0, containerType: "size", outline: "none" }, children: [_jsx(Scene, { renderer: renderer, ...(attachRenderer ? { attachRenderer } : {}) }), _jsx(OverviewButton, {}), _jsx(Companion, { chat: chat !== false, onCall: onCall, ...(typeof chat === "object" && chat.respond ? { respond: chat.respond } : {}) }), _jsx(Inspector, { placement: "menu" })] })] }));
+}
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The visual system.
+ *
+ * Two schemes, and they are not inversions of each other. Depth is the thing
+ * being drawn, and depth behaves differently in the two:
+ *
+ * - **Dark** is a lit control surface. Things at depth lose luminance and
+ *   dissolve into the ground; the accent reads as light, and separation comes
+ *   from glow and a lit edge.
+ * - **Light** is daylight and paper. Things at depth lose CONTRAST and gain
+ *   haze — real atmospheric perspective — and separation comes from soft
+ *   cast shadow, the way objects on a desk separate. Inverting the dark
+ *   scheme would give grey-on-grey mush, because glow does not exist in
+ *   daylight.
+ *
+ * One rule holds across both: **secondary text is a colour, never an
+ * opacity.** Opacity composites against whatever is behind and fails contrast
+ * silently. axe-core checks this on every run of `scripts/run-a11y.mjs`.
+ */
+export type { Brand, Scheme, ThemeTokens } from "@graview/core";
+import type { Brand, Scheme, ThemeTokens } from "@graview/core";
+export { DARK, LIGHT, SCHEMES } from "@graview/core";
+/**
+ * The framework's own brand, expressed as an ordinary declared one.
+ *
+ * No special case for the built-ins: `themeCss` takes a brand and this is
+ * simply the default value. That is the only way to know a third party's
+ * theme goes through the same path — if the shipped one took a shortcut, the
+ * shortcut is where a stranger's theme would break.
+ */
+export declare const GRAVIEW_BRAND: Brand;
+export declare function themeVariables(tokens: ThemeTokens): string;
+/**
+ * The stylesheet an app drops in.
+ *
+ * Everything the primitives reference is a custom property, so a host can
+ * override a single token without forking a component — and switching scheme
+ * is one `replaceSync`, not a re-render.
+ */
+export interface ThemeCssOptions {
+    /**
+     * A selector to scope the theme to — an embed's root element — instead of
+     * the document. The tokens land on that element and the ground, type and
+     * colour that `html, body` would have taken land there too, so a Graview
+     * inside somebody else's page is themed without touching their page.
+     */
+    readonly scope?: string;
+}
+export declare function themeCss(scheme?: Scheme, brand?: Brand, options?: ThemeCssOptions): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAYH,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAUhE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIrD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,KAO3B,CAAC;AA4BF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAI1D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AA0BD,wBAAgB,QAAQ,CACtB,MAAM,GAAE,MAAe,EACvB,KAAK,GAAE,KAAqB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,MAAM,CA+jDR"}