@graview/pages 0.1.0

package/dist/page-shell.js

@@ -0,0 +1,171 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { LadderSetting, useMarkup } from "@graview/primitives";
+import { Link, useLocation, useNavigate, useSearchParams } from "react-router-dom";
+import { useEffect, useRef, useState } from "react";
+import { kindMap } from "./facts.js";
+import { kindOfSlug, pluralSlug } from "./registry.js";
+import { StartFreshLink, useStoreTick } from "./page-context.js";
+import { placesOf } from "./page-places.js";
+import { usePlacedOnTheFace } from "./face-placed.js";
+import { DISPLAY, WIDE, column, liveKinds, plain, pluralOf, quiet } from "./page-typography.js";
+/**
+ * The shell: the installation's masthead, one row of navigation, the way to
+ * the scene. The pictures are the home, so they are not also a row of the
+ * nav — the row is the kinds, the map and the standing, and on a phone it
+ * scrolls sideways inside itself rather than wrapping to three rows over
+ * the page.
+ */
+export function DefaultShell({ context, children, }) {
+    const { store, brand, sceneHref = "/", invariantContext } = context;
+    useStoreTick(store);
+    const logo = useMarkup(brand?.logo);
+    const location = useLocation();
+    const problems = store.violations(invariantContext).length;
+    const current = (path) => path === "/"
+        ? location.pathname === "/" || location.pathname === "/places" || location.pathname.startsWith("/places/")
+        : location.pathname === path || location.pathname.startsWith(`${path}/`);
+    const navLink = (path) => ({
+        ...plain,
+        fontSize: "0.9375rem",
+        padding: "8px 0",
+        flexShrink: 0,
+        color: current(path) ? "var(--graview-ink)" : "var(--graview-ink-muted)",
+        borderBottom: current(path) ? "2px solid var(--graview-accent)" : "2px solid transparent",
+    });
+    const tab = (path, label, extra) => (_jsx(Link, { to: path, style: { ...navLink(path), ...extra }, ...(current(path) ? { "aria-current": "page" } : {}), children: label }, path));
+    return (_jsxs("div", { style: {
+            minHeight: "100vh",
+            display: "flex",
+            flexDirection: "column",
+            background: "var(--graview-ground)",
+            color: "var(--graview-ink)",
+            fontFamily: "var(--graview-font-body, system-ui)",
+            fontSize: "1.0625rem",
+            lineHeight: 1.6,
+        }, children: [_jsx("header", { style: { borderBottom: "1px solid var(--graview-edge)", background: "var(--graview-bar)" }, children: _jsxs("div", { style: {
+                        maxWidth: WIDE,
+                        margin: "0 auto",
+                        padding: "14px 20px 0",
+                        display: "flex",
+                        flexDirection: "column",
+                        gap: 2,
+                    }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 14, flexWrap: "wrap" }, children: [_jsxs(Link, { to: "/", "data-testid": "masthead", style: {
+                                        ...plain,
+                                        display: "inline-flex",
+                                        alignItems: "center",
+                                        gap: 10,
+                                        fontFamily: DISPLAY,
+                                        fontSize: "1.3125rem",
+                                        fontWeight: 600,
+                                        letterSpacing: "-0.01em",
+                                        minHeight: 32,
+                                    }, children: [brand?.logo ? (_jsx("span", { "aria-hidden": "true", style: { display: "inline-flex", color: "var(--graview-accent)" }, 
+                                            // The logo is the brand's own markup, declared by the
+                                            // installation — not supplied by a user.
+                                            dangerouslySetInnerHTML: logo })) : null, brand?.name ?? "Graview"] }), _jsx(PageFind, { context: context }), _jsx("a", { href: sceneHref, style: { ...plain, ...quiet, whiteSpace: "nowrap" }, title: "The same thing, as a scene", children: "Open the scene \u2197" })] }), _jsxs("nav", { "aria-label": "Pages", "data-testid": "shell-nav", style: {
+                                display: "flex",
+                                gap: 18,
+                                alignItems: "baseline",
+                                overflowX: "auto",
+                                whiteSpace: "nowrap",
+                                scrollbarWidth: "thin",
+                                minWidth: 0,
+                            }, children: [tab("/", placesOf(context).length > 0 ? "Pictures" : "Home"), liveKinds(store, context.principal).map((kind) => tab(`/${pluralSlug(store.schema, kind)}`, pluralOf(store, kind))), kindMap(store).relations.length > 0 ? tab("/map", "Map") : null, tab("/problems", _jsxs(_Fragment, { children: ["Problems", problems > 0 ? (_jsx("span", { "data-testid": "problems-count", style: {
+                                                fontSize: "0.8125rem",
+                                                lineHeight: 1,
+                                                padding: "3px 7px",
+                                                borderRadius: 999,
+                                                color: "var(--graview-warn)",
+                                                border: "1px solid var(--graview-warn)",
+                                            }, children: problems })) : null] }), 
+                                // At the end of the row, set apart from the sections: the standing.
+                                { display: "inline-flex", alignItems: "center", gap: 6, marginLeft: "auto" })] })] }) }), _jsx("div", { style: { flex: 1 }, children: children }), _jsx("footer", { style: {
+                    borderTop: "1px solid var(--graview-edge)",
+                    padding: "18px 20px 28px",
+                    ...quiet,
+                    fontSize: "0.875rem",
+                }, children: _jsxs("div", { style: { maxWidth: WIDE, margin: "0 auto", display: "flex", gap: 14, flexWrap: "wrap", alignItems: "center" }, children: [_jsx("span", { children: brand?.name ?? "Graview" }), context.views ? _jsx(LadderSetting, {}) : null, context.remembers ? (_jsxs("span", { "data-testid": "remembered", style: { marginLeft: "auto" }, children: ["Remembered in this browser \u00B7 ", _jsx(StartFreshLink, {})] })) : null] }) })] }));
+}
+/**
+ * A page's outer element: <main> when the face owns the document, a plain
+ * section when it is embedded in a page that has its own — `main` allows no
+ * other role, so the tag itself has to change.
+ */
+export function PageMain({ context, style, children, ...rest }) {
+    // Somebody above owns the landmark: the host page, or the app's own shell.
+    const Tag = (context.embedded || context.framed ? "section" : "main");
+    return (_jsx(Tag, { style: { ...column, ...style }, ...rest, children: children }));
+}
+/**
+ * THE NAV'S FIND BOX. On a kind's list it narrows that list — `?q=` is the
+ * list's own word — and anywhere else it goes to `/search`. Typing is an
+ * adjustment of the page you are on, so each keystroke replaces the address
+ * rather than piling up history; the first keystroke away from a list or
+ * the search page is the one step Back undoes.
+ *
+ * Exported for a shell an app draws itself. `narrowsLists: false` is for an
+ * app whose own list pages already carry a box for their words: then this
+ * one always goes to `/search`, and a list never has two.
+ *
+ * Placed by a shell, it is THE face's Find box: the face's root sees it and
+ * draws no second one above the shell (face-controls.tsx).
+ */
+export function PageFind({ context, narrowsLists = true, }) {
+    usePlacedOnTheFace("find");
+    const location = useLocation();
+    const navigate = useNavigate();
+    const [params, setParams] = useSearchParams();
+    const segments = location.pathname.split("/").filter(Boolean);
+    const onList = narrowsLists && segments.length === 1 && kindOfSlug(context.store.schema, segments[0]) !== undefined;
+    const onSearch = location.pathname === "/search";
+    const addressed = onList || onSearch ? (params.get("q") ?? "") : "";
+    const [typed, setTyped] = useState(addressed);
+    /*
+     * Back, a link, or the list's own row changed the words: the box follows
+     * the address. But not its own words coming back: each keystroke writes the
+     * address, and an address that caught up after the next key was taken for
+     * a change and written over the box — a key typed quickly on a slow phone
+     * was lost ("digital" searched as "dgtl"). Words the box handed over are
+     * its own echo.
+     */
+    const handed = useRef(new Set([addressed]));
+    useEffect(() => {
+        if (handed.current.has(addressed))
+            return;
+        handed.current = new Set([addressed]);
+        setTyped(addressed);
+    }, [addressed]);
+    const go = (words) => {
+        setTyped(words);
+        handed.current.add(words);
+        if (onList) {
+            const next = new URLSearchParams(params);
+            if (words.trim())
+                next.set("q", words);
+            else
+                next.delete("q");
+            setParams(next, { replace: true });
+            return;
+        }
+        const to = words.trim() ? `/search?${new URLSearchParams({ q: words }).toString()}` : "/search";
+        navigate(to, { replace: onSearch });
+    };
+    return (_jsx("form", { role: "search", "aria-label": onList ? "Narrow this list" : "Find anything", style: { marginLeft: "auto", display: "flex", minWidth: 0, flex: "0 1 16rem" }, onSubmit: (event) => {
+            event.preventDefault();
+            // Enter from a list widens the look to everything the words find.
+            if (onList && typed.trim())
+                navigate(`/search?${new URLSearchParams({ q: typed }).toString()}`);
+        }, children: _jsx("input", { type: "search", "data-testid": "nav-find", value: typed, onChange: (event) => go(event.target.value), placeholder: onList ? "Narrow…" : "Find…", "aria-label": onList ? "Narrow this list" : "Find anything", style: {
+                width: "100%",
+                minWidth: 0,
+                minHeight: 32,
+                padding: "4px 10px",
+                font: "inherit",
+                fontSize: "0.9375rem",
+                color: "var(--graview-ink)",
+                background: "var(--graview-ground)",
+                border: "1px solid var(--graview-edge)",
+                borderRadius: 8,
+            } }) }));
+}
+//# sourceMappingURL=page-shell.js.map

package/dist/page-shell.js.map

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

package/dist/page-typography.d.ts

@@ -0,0 +1,54 @@
+import { type AnyNodeDefinition, type AnySchema, type Brand, type Operation, type Principal, type Store, nameOfAuthor } from "@graview/core";
+export declare const DISPLAY = "var(--graview-font-display, var(--graview-font-body, system-ui))";
+export declare const column: React.CSSProperties;
+export declare const WIDE = 1160;
+export declare const wide: React.CSSProperties;
+export declare const h1: React.CSSProperties;
+export declare const h2: React.CSSProperties;
+export declare const eyebrow: React.CSSProperties;
+export declare const lede: React.CSSProperties;
+export declare const quiet: React.CSSProperties;
+export declare const rule: React.CSSProperties;
+export declare const link: React.CSSProperties;
+export declare const plain: React.CSSProperties;
+export declare const button: React.CSSProperties;
+/** The kind's own colour, as a small mark — the thread the scene wears too. */
+/**
+ * The mark beside a kind's name — its FIGURE where it has one, and the dot
+ * it has always had where it does not.
+ *
+ * One component in `@graview/primitives`, so the routed face, the scene and
+ * the relation key draw the same thing from the same declaration. A second
+ * rendering here would be a second place for a kind's picture to be wrong.
+ */
+export declare function KindMark({ kind, brand, size, schema, }: {
+    kind: string;
+    brand?: Brand;
+    size?: number;
+    schema?: AnySchema;
+}): import("react").JSX.Element;
+/**
+ * The kinds on the far end of a connections group, in their own plurals:
+ * "Owners" over an item's assignment, "Items" over the owner's.
+ */
+export declare function listed<S extends AnySchema>(store: Store<S>, group: {
+    readonly targets: readonly {
+        readonly kind: string;
+    }[];
+    readonly edgeKind: string;
+}): string;
+/** Words for who did something, from the op's own author. */
+/** Who did an op, as the person at the keyboard reads it: "you" only for their own work. */
+export declare function whoDid(op: Operation, principal?: Principal, where?: Parameters<typeof nameOfAuthor>[1]): string;
+/** A node's own one-line facts, for a list line or a front-page glance. */
+export declare function glance(node: Record<string, unknown>, definition: AnyNodeDefinition | undefined, said: string): string;
+/** The plural, as declared. */
+export declare const pluralOf: <S extends AnySchema>(store: Store<S>, kind: string) => string;
+/**
+ * The kinds this face lists: not a disabled module's, and not an administered
+ * module's unless the seat administers it — a gardener's pages never have a
+ * People section, the coordinator's always do.
+ */
+export declare const liveKinds: <S extends AnySchema>(store: Store<S>, principal?: Principal) => readonly string[];
+export declare const capitalise: (text: string) => string;
+//# sourceMappingURL=page-typography.d.ts.map

package/dist/page-typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-typography.d.ts","sourceRoot":"","sources":["../src/page-typography.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,KAAK,EACV,YAAY,EACb,MAAM,eAAe,CAAC;AASvB,eAAO,MAAM,OAAO,qEAAqE,CAAC;AAC1F,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,aAmB1B,CAAC;AAQF,eAAO,MAAM,IAAI,OAAO,CAAC;AACzB,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,aAA6C,CAAC;AACvE,eAAO,MAAM,EAAE,EAAE,KAAK,CAAC,aAQtB,CAAC;AACF,eAAO,MAAM,EAAE,EAAE,KAAK,CAAC,aAOtB,CAAC;AACF,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,aAM3B,CAAC;AACF,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,aAMxB,CAAC;AACF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,aAA4E,CAAC;AACvG,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,aAA8E,CAAC;AAExG,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,aAOxB,CAAC;AAUF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,aAMzB,CAAC;AACF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,aAS1B,CAAC;AAEF,+EAA+E;AAC/E;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAS,EACT,MAAM,GACP,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,+BAIA;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,EACxC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3F,MAAM,CAOR;AAED,6DAA6D;AAC7D,4FAA4F;AAC5F,wBAAgB,MAAM,CACpB,EAAE,EAAE,SAAS,EACb,SAAS,CAAC,EAAE,SAAS,EACrB,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,GACzC,MAAM,CAMR;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED,+BAA+B;AAC/B,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,MACtB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,SAAS,KAAG,SAAS,MAAM,EAKtG,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAAsD,CAAC"}

package/dist/page-typography.js

@@ -0,0 +1,166 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { KindFigure } from "@graview/primitives";
+import { humaniseField, readableFields, nameOfAuthor, } from "@graview/core";
+/*
+ * A reading column, a real scale. The scene's chrome is set at 14px because
+ * it is chrome; a page is read, so it gets the size a page gets. Headings
+ * take the brand's display face through the token the theme already sets —
+ * as a variable, never a `font` shorthand, which would silently beat it.
+ */
+export const DISPLAY = "var(--graview-font-display, var(--graview-font-body, system-ui))";
+export const column = {
+    maxWidth: 760,
+    margin: "0 auto",
+    padding: "40px 20px 96px",
+    display: "grid",
+    /*
+     * A TRACK THAT MAY BE NARROWER THAN WHAT IS IN IT.
+     *
+     * An `auto` track is at least the min-content width of its item, and a
+     * grid item's own `min-width: auto` is the same measure — so a section
+     * whose min-content the engine puts above the column's width pushes the
+     * whole page sideways. The engines do not agree on that measure: at a
+     * 32px root on a 390 screen, WebKit and Firefox made the list page's
+     * header 388 in a 350 track and the document scrolled two ways, while
+     * Chromium fitted it. `minmax(0, 1fr)` says the column is the width it
+     * was given, and what is inside it wraps.
+     */
+    gridTemplateColumns: "minmax(0, 1fr)",
+    gap: 40,
+};
+/*
+ * TWO WIDTHS, ONE FACE. A page that is READ keeps the 760 measure above; a
+ * page that is LOOKED AT — the home's gallery, a picture at full width, the
+ * shell that frames both — takes the room a desk has. The pictures were the
+ * one thing on the face that was the app's own, and at 288 pixels in a 760
+ * column they were the smallest thing on it.
+ */
+export const WIDE = 1160;
+export const wide = { ...column, maxWidth: WIDE };
+export const h1 = {
+    margin: 0,
+    fontFamily: DISPLAY,
+    fontSize: "clamp(30px, 4.6vw, 40px)",
+    lineHeight: 1.12,
+    fontWeight: 600,
+    letterSpacing: "-0.012em",
+    overflowWrap: "anywhere",
+};
+export const h2 = {
+    margin: 0,
+    fontFamily: DISPLAY,
+    fontSize: "1.4375rem",
+    lineHeight: 1.25,
+    fontWeight: 600,
+    letterSpacing: "-0.006em",
+};
+export const eyebrow = {
+    margin: 0,
+    fontSize: "0.8125rem",
+    letterSpacing: "0.14em",
+    textTransform: "uppercase",
+    color: "var(--graview-ink-muted)",
+};
+export const lede = {
+    margin: 0,
+    fontSize: "1.1875rem",
+    lineHeight: 1.5,
+    color: "var(--graview-ink-muted)",
+    maxWidth: "58ch",
+};
+export const quiet = { color: "var(--graview-ink-muted)", fontSize: "0.9375rem" };
+export const rule = { borderTop: "1px solid var(--graview-edge)", paddingTop: 24 };
+// A link is a target: tall enough for a fingertip without leaving the line.
+export const link = {
+    color: "inherit",
+    textDecorationColor: "var(--graview-edge-bright)",
+    textUnderlineOffset: 3,
+    display: "inline-flex",
+    alignItems: "center",
+    minHeight: 24,
+};
+/*
+ * An UNDERLINED link is a target and an undecorated one is the same target.
+ *
+ * `link` carried the 24px minimum and `plain` — the same thing without the
+ * underline, used on the record page's eyebrow, the list's rows and the
+ * masthead — did not, so the framework's own record page had a 19-pixel
+ * control on it. One site had already patched the minimum back in by hand,
+ * which is the style telling you where it should have lived.
+ */
+export const plain = {
+    color: "inherit",
+    textDecoration: "none",
+    display: "inline-flex",
+    alignItems: "center",
+    minHeight: 24,
+};
+export const button = {
+    font: "inherit",
+    fontSize: "0.9375rem",
+    padding: "8px 14px",
+    borderRadius: "var(--graview-radius-sm, 8px)",
+    border: "1px solid var(--graview-edge-bright)",
+    background: "var(--graview-panel)",
+    color: "var(--graview-ink)",
+    cursor: "pointer",
+};
+/** The kind's own colour, as a small mark — the thread the scene wears too. */
+/**
+ * The mark beside a kind's name — its FIGURE where it has one, and the dot
+ * it has always had where it does not.
+ *
+ * One component in `@graview/primitives`, so the routed face, the scene and
+ * the relation key draw the same thing from the same declaration. A second
+ * rendering here would be a second place for a kind's picture to be wrong.
+ */
+export function KindMark({ kind, brand, size = 10, schema, }) {
+    // A figure wants more room than a dot: the dot is the figure's own inner
+    // circle, so passing the dot's size straight through would draw a stamp.
+    return _jsx(KindFigure, { kind: kind, ...(schema ? { schema } : {}), ...(brand ? { brand } : {}), size: Math.round(size * 1.6) });
+}
+/**
+ * The kinds on the far end of a connections group, in their own plurals:
+ * "Owners" over an item's assignment, "Items" over the owner's.
+ */
+export function listed(store, group) {
+    const kinds = [...new Set(group.targets.map((target) => target.kind))];
+    const said = kinds.map((kind) => {
+        const definition = store.schema.tryDefinition(kind);
+        return definition?.plural ?? humaniseField(kind);
+    });
+    return said.length > 0 ? said.join(" and ") : humaniseField(group.edgeKind);
+}
+/** Words for who did something, from the op's own author. */
+/** Who did an op, as the person at the keyboard reads it: "you" only for their own work. */
+export function whoDid(op, principal, where) {
+    if (op.author.kind === "human" && (op.author.id === undefined || principal?.id === undefined || op.author.id === principal.id))
+        return "you";
+    // By name where the graph or the seats have one — never an id a person was not offered.
+    if (where)
+        return nameOfAuthor(op.author, where);
+    if (op.author.kind === "agent")
+        return op.author.id ?? "an agent";
+    return op.author.id ?? op.author.kind;
+}
+/** A node's own one-line facts, for a list line or a front-page glance. */
+export function glance(node, definition, said) {
+    // A bare number says nothing on its own — "12 · 8" is not a sentence —
+    // so each fact is read the way it stands alone, the same words a card uses.
+    return readableFields(node, definition, { limit: 3, said: [said], glance: true })
+        .map((field) => field.alone)
+        .join(" · ");
+}
+/** The plural, as declared. */
+export const pluralOf = (store, kind) => store.schema.tryDefinition(kind)?.plural ?? `${kind}s`;
+/**
+ * The kinds this face lists: not a disabled module's, and not an administered
+ * module's unless the seat administers it — a gardener's pages never have a
+ * People section, the coordinator's always do.
+ */
+export const liveKinds = (store, principal) => {
+    const kept = store.kindsKeptFrom(principal);
+    return store.schema.kinds.filter((kind) => !store.modules.disabledKinds.has(kind) && !kept.has(kind));
+};
+export const capitalise = (text) => text.charAt(0).toUpperCase() + text.slice(1);
+//# sourceMappingURL=page-typography.js.map

package/dist/page-typography.js.map

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

package/dist/pages.d.ts

@@ -0,0 +1,19 @@
+/**
+ * THE PAGES FACE: the same graph as the scene, as routed, responsive pages.
+ *
+ * Every page here is derived from the declaration — a shell, a map of the
+ * kinds, the places an app names, a home, a list per kind, a record, and
+ * the problems — so an app with no pages of its own already has all of
+ * them, and one that writes its own replaces them one at a time.
+ */
+export * from "./page-context.js";
+export * from "./page-typography.js";
+export * from "./page-shell.js";
+export * from "./page-map.js";
+export * from "./page-places.js";
+export * from "./page-home.js";
+export * from "./page-list.js";
+export * from "./page-record.js";
+export * from "./page-problems.js";
+export * from "./page-search.js";
+//# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/pages.js

@@ -0,0 +1,19 @@
+/**
+ * THE PAGES FACE: the same graph as the scene, as routed, responsive pages.
+ *
+ * Every page here is derived from the declaration — a shell, a map of the
+ * kinds, the places an app names, a home, a list per kind, a record, and
+ * the problems — so an app with no pages of its own already has all of
+ * them, and one that writes its own replaces them one at a time.
+ */
+export * from "./page-context.js";
+export * from "./page-typography.js";
+export * from "./page-shell.js";
+export * from "./page-map.js";
+export * from "./page-places.js";
+export * from "./page-home.js";
+export * from "./page-list.js";
+export * from "./page-record.js";
+export * from "./page-problems.js";
+export * from "./page-search.js";
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../src/pages.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,111 @@
+import type { AnySchema, KindOfSchema } from "@graview/core";
+import type { ComponentType, ReactNode } from "react";
+import type { PageContext } from "./page-context.js";
+import type { FaceControl } from "./face-placed.js";
+/**
+ * The frame around every route: it is handed the page as `children`.
+ *
+ * The skill says a shell "receives `{ context, children }`", and the only
+ * signature `surface` had was a page's, which has no children — so every
+ * design registered its shell with `as PageComponent<S>`, and the worked
+ * examples taught the cast.
+ */
+export type ShellComponent<S extends AnySchema> = ComponentType<{
+    readonly context: PageContext<S>;
+    readonly children: ReactNode;
+}>;
+/**
+ * The page registry, shaped like the view registry ON PURPOSE.
+ *
+ * (kind × page type) → component, defaults registered first, an app
+ * overriding per cell — an author who has registered a view already knows
+ * how to register a page, and that symmetry is the whole SDK story. The
+ * layout shell is itself a registration, so custom chrome is the same
+ * authoring move as a custom record page.
+ */
+export type PageType = "list" | "record";
+/** App-level surfaces that are not per-kind: the shell and the fixed pages. */
+export type SurfaceType = "shell" | "home" | "problems";
+/**
+ * What a shell may say it goes without: the routed face's Find box, its way
+ * back. Without this said, a shell that does not place `<PageFind>` or
+ * `<PageUndo>` gets them drawn around it.
+ */
+export interface ShellOptions {
+    readonly without?: readonly FaceControl[];
+}
+export interface PageRegistration<P = unknown> {
+    readonly kind: string;
+    readonly page: PageType;
+    readonly component: P;
+}
+/** A page the schema knows nothing about, at a path the app chose. */
+export interface RouteRegistration<P = unknown> {
+    readonly path: string;
+    readonly component: P;
+}
+export interface PageRegistry<S extends AnySchema, P = unknown> {
+    register<K extends KindOfSchema<S>>(kind: K, page: PageType, component: P): PageRegistry<S, P>;
+    surface(surface: "shell", component: ShellComponent<S>, options?: ShellOptions): PageRegistry<S, P>;
+    surface(surface: SurfaceType, component: P): PageRegistry<S, P>;
+    /**
+     * A PAGE THAT IS NOT ABOUT A KIND.
+     *
+     * The derived routes are `/`, `/problems`, `/:plural` and `/:plural/:id`,
+     * and the registry let an app REPLACE any of them. It could not ADD one —
+     * so an onboarding, a settings page, an import screen, an about, or a desk
+     * that takes photographs and proposes a survey had nowhere to live. The
+     * workaround every app reaches for is to have its shell read `useLocation`
+     * and swap its children, which works and lies to the router: `/:slug`
+     * still matches, the kind switch still runs, and the shell overrides the
+     * result.
+     *
+     * Registered routes are matched BEFORE the derived ones, so a path of the
+     * app's own is never swallowed by the list route. Rendered inside the
+     * shell like any other page.
+     */
+    route(path: string, component: P): PageRegistry<S, P>;
+    lookup(kind: string, page: PageType): P | undefined;
+    lookupSurface(surface: SurfaceType): P | undefined;
+    /** The face's own controls the shell said it goes without. */
+    without(): ReadonlySet<FaceControl>;
+    /** The app's own routes, in registration order. */
+    routes(): readonly RouteRegistration<P>[];
+    all(): readonly PageRegistration<P>[];
+}
+export declare function createPageRegistry<S extends AnySchema, P = ComponentType<never>>(schema: S): PageRegistry<S, P>;
+/**
+ * Routes derive from the schema: `/:plural` and `/:plural/:id` off the
+ * plural the declaration already carries. One slug per kind — `graview
+ * check` refuses two kinds whose plurals collide, because a route that
+ * depends on registration order is a route nobody can link to.
+ */
+export declare function pluralSlug(schema: AnySchema, kind: string): string;
+/** kind ← slug, the other direction of `pluralSlug`. */
+export declare function kindOfSlug(schema: AnySchema, slug: string): string | undefined;
+/** The routed address of one node — shared ids are what make two faces one app. */
+export declare function recordPath(schema: AnySchema, kind: string, id: string): string;
+/** The spatial stop for the same node, for the link back into the scene. */
+export declare function spatialHref(id: string): string;
+/**
+ * The spatial stop that shows one NAMED PLACE — a lens, by the name it was
+ * registered under.
+ *
+ * A page that has just drawn three areas wants to link to the map, and could
+ * only ever say "open the scene and press The grounds", because the long form
+ * of that stop needs the aggregate id of the kind behind the picture and a
+ * page has no business knowing how the layout spells one. A place's name is
+ * unique across an app, so naming it is enough: the scene looks it up and
+ * focuses the group it is a picture of.
+ *
+ * `placeSlug(title)` in `@graview/core` turns a registered title into the
+ * name to pass here.
+ */
+export declare function placeHref(as: string, sceneHref?: string): string;
+/**
+ * The routed address of one PLACE — a lens, by the name it was registered
+ * under — on this face. Namespaced under `/places/` so it can never collide
+ * with a kind's plural, whatever an app calls its pictures.
+ */
+export declare function placePath(as: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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