@graview/core 0.1.0

package/dist/theme/kit.js.map

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

package/dist/theme/palettes.d.ts

@@ -0,0 +1,32 @@
+import type { Scheme, ThemeTokens } from "./types.js";
+/**
+ * The two the framework ships with, as DATA.
+ *
+ * They live in core rather than beside the components that read them for two
+ * reasons: `graview check` verifies a palette and must not import React to do
+ * it, and an app declaring its own brand in its domain layer needs a neutral
+ * base to build on without reaching into the UI package. A theme is a
+ * declaration, and declarations live here.
+ *
+ * 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. `checkContrast` measures every pair on both, and axe-core checks
+ * the rendered result on every run of the a11y harness.
+ */
+/** A lit control surface. */
+export declare const DARK: ThemeTokens;
+/** Daylight and paper. */
+export declare const LIGHT: ThemeTokens;
+export declare const SCHEMES: Record<Scheme, ThemeTokens>;
+//# sourceMappingURL=palettes.d.ts.map

package/dist/theme/palettes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palettes.d.ts","sourceRoot":"","sources":["../../src/theme/palettes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6BAA6B;AAC7B,eAAO,MAAM,IAAI,EAAE,WA+BlB,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,KAAK,EAAE,WAoCnB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAgC,CAAC"}

package/dist/theme/palettes.js

@@ -0,0 +1,96 @@
+/**
+ * The two the framework ships with, as DATA.
+ *
+ * They live in core rather than beside the components that read them for two
+ * reasons: `graview check` verifies a palette and must not import React to do
+ * it, and an app declaring its own brand in its domain layer needs a neutral
+ * base to build on without reaching into the UI package. A theme is a
+ * declaration, and declarations live here.
+ *
+ * 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. `checkContrast` measures every pair on both, and axe-core checks
+ * the rendered result on every run of the a11y harness.
+ */
+/** A lit control surface. */
+export const DARK = {
+    // Not black: a deep blue-green that lets the accent read as light rather
+    // than as paint.
+    ground: "#080d12",
+    groundDeep: "#04070a",
+    wash: "radial-gradient(120% 80% at 50% -10%, var(--graview-glow) 0%, transparent 60%), " +
+        "radial-gradient(90% 60% at 12% 108%, rgba(111,220,234,0.10) 0%, transparent 62%)",
+    // Nearly opaque, by necessity as much as taste: a captured subtree has
+    // nothing behind it, so `backdrop-filter` is a no-op and a translucent fill
+    // composites against transparency.
+    panel: "rgba(20, 31, 39, 0.94)",
+    panelMuted: "rgba(15, 23, 30, 0.92)",
+    panelWarning: "rgba(44, 30, 17, 0.94)",
+    edge: "rgba(126, 196, 214, 0.20)",
+    edgeBright: "rgba(126, 220, 232, 0.55)",
+    ink: "#e8f3f6",
+    inkMuted: "#9fb6bf",
+    inkFaint: "#8aa3ad",
+    accent: "#6fdcea",
+    accentDim: "rgba(111, 220, 234, 0.35)",
+    accentInk: "#06232a",
+    warn: "#f0a868",
+    glow: "rgba(111, 220, 234, 0.28)",
+    bar: "linear-gradient(rgba(10,16,21,0.92), rgba(6,10,14,0.78))",
+    float: "linear-gradient(rgba(14,22,29,0.96), rgba(8,13,18,0.97))",
+    liftLow: "0 18px 50px -26px #000, inset 0 1px 0 rgba(126,196,214,0.20)",
+    liftHigh: "0 30px 70px -30px #000",
+    tintAlpha: 0.2,
+    tintLightness: 52,
+    gridAlpha: 0.35,
+};
+/** Daylight and paper. */
+export const LIGHT = {
+    // Warm off-white rather than pure white: pure white under a full-bleed
+    // scene glares, and paper is never #fff.
+    ground: "#f6f4f0",
+    groundDeep: "#efece6",
+    wash: "radial-gradient(120% 80% at 50% -20%, rgba(255,255,255,0.9) 0%, transparent 58%), " +
+        "radial-gradient(80% 60% at 92% 104%, rgba(12,110,120,0.06) 0%, transparent 60%)",
+    panel: "#ffffff",
+    panelMuted: "#faf8f5",
+    panelWarning: "#fdf4ea",
+    edge: "rgba(24, 34, 38, 0.10)",
+    /*
+     * 0.67, not 0.42. A lit edge is not text and still owes 3:1 — an outline
+     * nobody can see is a panel with no edge — and at 0.42 over white this read
+     * at 1.93:1. Found by pointing the framework's own contrast check at the
+     * framework's own palette, which is the argument for having one.
+     */
+    edgeBright: "rgba(12, 110, 120, 0.67)",
+    ink: "#15201f",
+    // Both clear 4.5:1 on white and on the muted panel.
+    inkMuted: "#54605f",
+    inkFaint: "#67716f",
+    accent: "#0c6e78",
+    accentDim: "rgba(12, 110, 120, 0.22)",
+    accentInk: "#ffffff",
+    warn: "#9a5312",
+    glow: "rgba(12, 110, 120, 0.10)",
+    bar: "linear-gradient(rgba(255,255,255,0.96), rgba(250,248,245,0.86))",
+    float: "linear-gradient(#ffffff, #fcfbf9)",
+    // Layered, short-then-long: how something actually casts on a desk.
+    liftLow: "0 1px 2px rgba(20,30,32,0.06), 0 8px 24px -12px rgba(20,30,32,0.18)",
+    liftHigh: "0 2px 6px rgba(20,30,32,0.08), 0 28px 60px -24px rgba(20,30,32,0.28)",
+    tintAlpha: 0.16,
+    tintLightness: 46,
+    gridAlpha: 0.5,
+};
+export const SCHEMES = { dark: DARK, light: LIGHT };
+//# sourceMappingURL=palettes.js.map

package/dist/theme/palettes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palettes.js","sourceRoot":"","sources":["../../src/theme/palettes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,yEAAyE;IACzE,iBAAiB;IACjB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IACrB,IAAI,EACF,kFAAkF;QAClF,kFAAkF;IACpF,uEAAuE;IACvE,4EAA4E;IAC5E,mCAAmC;IACnC,KAAK,EAAE,wBAAwB;IAC/B,UAAU,EAAE,wBAAwB;IACpC,YAAY,EAAE,wBAAwB;IACtC,IAAI,EAAE,2BAA2B;IACjC,UAAU,EAAE,2BAA2B;IACvC,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,2BAA2B;IACtC,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,2BAA2B;IACjC,GAAG,EAAE,0DAA0D;IAC/D,KAAK,EAAE,0DAA0D;IACjE,OAAO,EAAE,8DAA8D;IACvE,QAAQ,EAAE,wBAAwB;IAClC,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAgB;IAChC,uEAAuE;IACvE,yCAAyC;IACzC,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IACrB,IAAI,EACF,oFAAoF;QACpF,iFAAiF;IACnF,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,IAAI,EAAE,wBAAwB;IAC9B;;;;;OAKG;IACH,UAAU,EAAE,0BAA0B;IACtC,GAAG,EAAE,SAAS;IACd,oDAAoD;IACpD,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,0BAA0B;IACrC,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,0BAA0B;IAChC,GAAG,EAAE,iEAAiE;IACtE,KAAK,EAAE,mCAAmC;IAC1C,oEAAoE;IACpE,OAAO,EAAE,qEAAqE;IAC9E,QAAQ,EAAE,sEAAsE;IAChF,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,GAAG;CACf,CAAC;AAGF,MAAM,CAAC,MAAM,OAAO,GAAgC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC"}

package/dist/theme/types.d.ts

@@ -0,0 +1,131 @@
+import type { KitOverrides } from "./kit.js";
+/**
+ * The token contract, declared in core so it can be CHECKED.
+ *
+ * The palettes themselves live in `@graview/primitives`, which is where the
+ * components that read them live. The contract lives here for the same reason
+ * the schema does: `graview check` reads declarations, and a theme is a
+ * declaration. A custom palette can be wrong in ways nobody notices — a
+ * secondary text colour that clears 4.5:1 on a dark ground and fails badly on
+ * paper — and contrast is a property the framework can verify rather than
+ * trust.
+ */
+export type Scheme = "light" | "dark";
+export interface ThemeTokens {
+    readonly ground: string;
+    readonly groundDeep: string;
+    /** The wash behind the scene: gradients over the ground. */
+    readonly wash: string;
+    readonly panel: string;
+    readonly panelMuted: string;
+    readonly panelWarning: string;
+    readonly edge: string;
+    readonly edgeBright: string;
+    readonly ink: string;
+    readonly inkMuted: string;
+    readonly inkFaint: string;
+    readonly accent: string;
+    readonly accentDim: string;
+    readonly accentInk: string;
+    readonly warn: string;
+    readonly glow: string;
+    /** The command bar's ground. Chrome, not scene. */
+    readonly bar: string;
+    /** A surface floating over the scene — the inspector. */
+    readonly float: string;
+    /** Elevation for a panel sitting in the scene. */
+    readonly liftLow: string;
+    /** Elevation for something floating over it. */
+    readonly liftHigh: string;
+    /** How strongly a chip or span tint reads over the panel ground. */
+    readonly tintAlpha: number;
+    readonly tintLightness: number;
+    readonly gridAlpha: number;
+}
+/**
+ * Everything an installation puts its name on.
+ *
+ * Palette, wordmark and typography together, because they are one decision:
+ * a brand handing over a hex code has not given you a theme, and a brand
+ * handing over a logo without a colour has not either.
+ */
+export interface Brand {
+    /** The product name, shown where the framework shows a wordmark. */
+    readonly name: string;
+    /**
+     * A logo, as an inline SVG string or a URL.
+     *
+     * Inline is preferred and is what `currentColor` support is for: a logo
+     * that inherits the ink colour works in both schemes without two files.
+     */
+    readonly logo?: string;
+    readonly typography?: {
+        /** Applied to everything. Include a real fallback stack. */
+        readonly body?: string;
+        /** Headings and the wordmark, when they differ from the body. */
+        readonly display?: string;
+        /** Code, ids, anything that must align in columns. */
+        readonly mono?: string;
+    };
+    /**
+     * How square and how tight this product is.
+     *
+     * The third axis of an identity, and the one that was missing: with only a
+     * palette and a wordmark, four apps built on this looked like the same
+     * application four times in different colours. A bid desk is square and
+     * dense; a household planner is round and roomy. Neither is a component
+     * change — both are one number.
+     */
+    readonly shape?: {
+        /** Corner radius for a panel, in pixels. Smaller reads as more formal. */
+        readonly radius?: number;
+        /** Padding multiplier. 1 is the framework's own spacing. */
+        readonly density?: number;
+    };
+    /**
+     * A HUE PER KIND, in degrees (0–360).
+     *
+     * The default is a stable hash — fine for "each kind looks like itself",
+     * useless for "our people are warm amber and our money is green". Declared
+     * here it reaches every surface that colours by kind (chips, districts,
+     * calendars) through one lookup, and `graview check` refuses a key that
+     * names no declared kind — a silent typo would just quietly hash instead.
+     */
+    readonly accents?: Readonly<Record<string, number>>;
+    readonly schemes: Readonly<Record<Scheme, ThemeTokens>>;
+    /**
+     * The kit: what the scene draws that is not a view — connectors, captions,
+     * grid, lattice, tags, marks — as this brand wants it. Any part; the rest
+     * as shipped. See `resolveKit`.
+     */
+    readonly kit?: KitOverrides;
+    /**
+     * A FIGURE PER KIND, the way a brand already overrides a kind's hue.
+     *
+     * An installation that has its own drawing of a person, or of the thing
+     * its domain calls a plot, says so here and the declaration stays the
+     * domain's. Same rules as a declared figure, and `graview check` holds
+     * both to them.
+     */
+    readonly figures?: Readonly<Record<string, string>>;
+}
+/**
+ * One place text is drawn on a ground, and what contrast it owes there.
+ *
+ * Enumerated rather than discovered, because "which pairs carry text" is a
+ * fact about the components and not about any particular palette — a brand
+ * cannot introduce a new pairing without changing a component, and if it
+ * does, this list is where that shows up.
+ */
+export interface TextPair {
+    readonly ink: keyof ThemeTokens;
+    readonly on: keyof ThemeTokens;
+    /** What `on` composites over when it is translucent. */
+    readonly over?: keyof ThemeTokens;
+    /** WCAG AA: 4.5 for body text, 3 for large text and for meaningful edges. */
+    readonly requires: number;
+    /** Where this pairing actually happens, so a failure is findable. */
+    readonly where: string;
+}
+export declare const TEXT_PAIRS: readonly TextPair[];
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

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

package/dist/theme/types.js

@@ -0,0 +1,23 @@
+export const TEXT_PAIRS = [
+    { ink: "ink", on: "panel", over: "ground", requires: 4.5, where: "body text in a panel" },
+    { ink: "ink", on: "panelMuted", over: "ground", requires: 4.5, where: "body text in a receded panel" },
+    { ink: "ink", on: "panelWarning", over: "ground", requires: 4.5, where: "body text in a flagged panel" },
+    { ink: "ink", on: "float", over: "ground", requires: 4.5, where: "the actions strip and the context menu" },
+    { ink: "ink", on: "bar", over: "ground", requires: 4.5, where: "the command bar" },
+    { ink: "inkMuted", on: "panel", over: "ground", requires: 4.5, where: "a subtitle" },
+    { ink: "inkMuted", on: "panelMuted", over: "ground", requires: 4.5, where: "a subtitle in a receded panel" },
+    { ink: "inkMuted", on: "float", over: "ground", requires: 4.5, where: "an observation in the strip" },
+    { ink: "inkFaint", on: "panel", over: "ground", requires: 4.5, where: "a field name" },
+    { ink: "inkFaint", on: "panelMuted", over: "ground", requires: 4.5, where: "a kind card's count" },
+    { ink: "inkFaint", on: "float", over: "ground", requires: 4.5, where: "a hint in the strip" },
+    { ink: "accent", on: "panel", over: "ground", requires: 4.5, where: "a selected label" },
+    { ink: "accent", on: "float", over: "ground", requires: 4.5, where: "a pending action" },
+    { ink: "accentInk", on: "accent", requires: 4.5, where: "text on a filled accent" },
+    { ink: "warn", on: "panel", over: "ground", requires: 4.5, where: "a problem count" },
+    { ink: "warn", on: "panelWarning", over: "ground", requires: 4.5, where: "a warning inside a flagged panel" },
+    { ink: "warn", on: "float", over: "ground", requires: 4.5, where: "a failed agent call" },
+    // An edge is not text, but a border that carries meaning owes 3:1 all the
+    // same — a panel outline nobody can see is a panel with no edge.
+    { ink: "edgeBright", on: "panel", over: "ground", requires: 3, where: "a lit edge" },
+];
+//# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

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

package/dist/views/types.d.ts

@@ -0,0 +1,89 @@
+import type { AnySchema, KindOfSchema } from "../schema/schema.js";
+/** One node, or a group of them standing in for a kind. */
+export type Cardinality = "one" | "many";
+/**
+ * How much of a node is drawn. This is the axis that keeps receded text
+ * legible: a calendar at depth switches to a denser summary view rather than
+ * scaling down into mush.
+ *
+ * - `full`    live DOM, captured every frame it moves
+ * - `summary` captured on change into a cached texture
+ * - `glyph`   painted in the shader, never captured
+ */
+export type Fidelity = "full" | "summary" | "glyph";
+export declare const FIDELITIES: readonly Fidelity[];
+/** Views form a matrix, not a list. This names one cell of it. */
+export interface ViewCell {
+    readonly cardinality: Cardinality;
+    readonly fidelity: Fidelity;
+}
+export interface ViewRegistration<V = unknown> {
+    readonly kind: string;
+    readonly cardinality: Cardinality;
+    readonly fidelity: Fidelity;
+    readonly view: V;
+    /** The place's name, when the registration gave it one. */
+    readonly title?: string;
+}
+/**
+ * What a registration may say about itself beyond the cell it fills.
+ *
+ * A `title` on a group view makes it a PLACE: a lens over the gardeners is
+ * "Who tends what", and an interface can list it, press it, and say where
+ * you are. Without a name a lens was only reachable by focusing the group
+ * it happened to be registered on, and once you had clicked into a member
+ * there was no way to know it existed, let alone get back to it.
+ */
+export interface ViewMeta {
+    readonly title?: string;
+    /**
+     * For a picture over TWO kinds — a coverage matrix of practices against
+     * concerns — the other kind. A drive-in for such a picture stands on the
+     * road between the two plots rather than on one of them.
+     */
+    readonly across?: string;
+}
+/** A named group view: somewhere to go, by name. */
+export interface Place {
+    readonly kind: string;
+    readonly title: string;
+    /** The other kind, when the picture is over two. */
+    readonly across?: string;
+    /**
+     * The short name this place answers to in a stop, from its title.
+     *
+     * A kind may have SEVERAL pictures — the week and the month are two
+     * questions about one pile of tasks — and a stop that could only say
+     * which GROUP you were looking at could not say which of them. So a place
+     * is addressable: `focus=aggregate:task&in.view=the-month`.
+     */
+    readonly as: string;
+}
+/** A place's own name in an address: its title, lower-cased and hyphenated. */
+export declare function placeSlug(title: string): string;
+export interface ViewRegistry<S extends AnySchema, V = unknown> {
+    /**
+     * Registering a view for a kind the schema never declared is a typecheck
+     * failure — `K` is constrained to the schema's kinds, so the mistake
+     * surfaces at build time rather than at render.
+     */
+    register<K extends KindOfSchema<S>>(kind: K, cell: ViewCell, view: V, meta?: ViewMeta): ViewRegistry<S, V>;
+    /** The exact cell, with no fallback. */
+    lookup(kind: string, cell: ViewCell): V | undefined;
+    /** Every named group view, in registration order. */
+    places(): readonly Place[];
+    /**
+     * The best available view for a cell: exact match, then a coarser fidelity,
+     * then the primitive fallback the caller supplies.
+     *
+     * `as` asks for one PLACE in particular — the month rather than the week
+     * over the same tasks. A name nothing was registered under falls through
+     * to the cell's own view rather than drawing nothing, because an address
+     * naming a place that has since been renamed should land you somewhere.
+     */
+    resolve(kind: string, cell: ViewCell, as?: string): ViewRegistration<V> | undefined;
+    all(): readonly ViewRegistration<V>[];
+    kindsWithViews(): readonly string[];
+}
+export declare function createViewRegistry<S extends AnySchema, V = unknown>(_schema: S): ViewRegistry<S, V>;
+//# sourceMappingURL=types.d.ts.map

package/dist/views/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/views/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnE,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAAiC,CAAC;AAE5E,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAChC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,QAAQ,GACd,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC;IACpD,qDAAqD;IACrD,MAAM,IAAI,SAAS,KAAK,EAAE,CAAC;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACpF,GAAG,IAAI,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,cAAc,IAAI,SAAS,MAAM,EAAE,CAAC;CACrC;AAiBD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO,EACjE,OAAO,EAAE,CAAC,GACT,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAoEpB"}

package/dist/views/types.js

@@ -0,0 +1,88 @@
+export const FIDELITIES = ["full", "summary", "glyph"];
+/** A place's own name in an address: its title, lower-cased and hyphenated. */
+export function placeSlug(title) {
+    return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+const key = (kind, cell, as = "") => `${kind}|${cell.cardinality}|${cell.fidelity}|${as}`;
+/** Fidelity fallback order, coarsest-first from a given starting point. */
+function fallbacks(fidelity) {
+    switch (fidelity) {
+        case "full":
+            return ["full", "summary", "glyph"];
+        case "summary":
+            return ["summary", "full", "glyph"];
+        case "glyph":
+            return ["glyph", "summary", "full"];
+    }
+}
+export function createViewRegistry(_schema) {
+    const entries = new Map();
+    /** Every named place, in the order it was registered. */
+    const named = [];
+    const registry = {
+        register(kind, cell, view, meta) {
+            const registration = {
+                kind,
+                cardinality: cell.cardinality,
+                fidelity: cell.fidelity,
+                view,
+                ...(meta?.title ? { title: meta.title } : {}),
+            };
+            /*
+             * A titled registration fills its cell AND stands on its own.
+             *
+             * The cell is what a group draws by default and the last registration
+             * wins it, as it always has — an app replacing the framework's own
+             * view is the whole point of the registry. The named copy is what
+             * makes a SECOND picture of one group reachable: the week and the
+             * month are two questions about one pile of tasks, and before this a
+             * kind could only ever have one answer.
+             */
+            entries.set(key(kind, cell), registration);
+            if (meta?.title) {
+                const as = placeSlug(meta.title);
+                entries.set(key(kind, cell, as), registration);
+                if (cell.cardinality === "many" && !named.some((place) => place.kind === kind && place.as === as)) {
+                    named.push({ kind, title: meta.title, as, ...(meta.across ? { across: meta.across } : {}) });
+                }
+            }
+            return registry;
+        },
+        places: () => named,
+        lookup(kind, cell) {
+            return entries.get(key(kind, cell))?.view;
+        },
+        resolve(kind, cell, as) {
+            if (as) {
+                for (const fidelity of fallbacks(cell.fidelity)) {
+                    const found = entries.get(key(kind, { cardinality: cell.cardinality, fidelity }, as));
+                    if (found)
+                        return found;
+                }
+            }
+            for (const fidelity of fallbacks(cell.fidelity)) {
+                const found = entries.get(key(kind, { cardinality: cell.cardinality, fidelity }));
+                if (found)
+                    return found;
+            }
+            // A `one` view standing in for `many` is wrong; a `many` view standing
+            // in for `one` is merely dull. Only fall back in the safe direction.
+            if (cell.cardinality === "one") {
+                for (const fidelity of fallbacks(cell.fidelity)) {
+                    const found = entries.get(key(kind, { cardinality: "many", fidelity }));
+                    if (found)
+                        return found;
+                }
+            }
+            return undefined;
+        },
+        all() {
+            return [...entries.values()];
+        },
+        kindsWithViews() {
+            return [...new Set([...entries.values()].map((e) => e.kind))];
+        },
+    };
+    return registry;
+}
+//# sourceMappingURL=types.js.map

package/dist/views/types.js.map

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

package/dist/watched.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WHAT A WATCHING HARNESS IS TOLD.
+ *
+ * The browser harnesses judge every screen they reach against the rules that
+ * hold everywhere (`scripts/lib/watch.mjs`). Two of those rules need what
+ * only the store knows: which strings are the declaration's own names — an
+ * act called `close-deal`, a role called `sales-manager`, a seat called
+ * `user-lena` — so that text showing one to a person can be caught exactly
+ * rather than guessed at; and which acts a press reached that the policy
+ * then refused, which is an act offered to somebody who may not take it.
+ *
+ * A page is watched when the harness defined `globalThis.__graviewWatch`
+ * before the app ran. Anywhere else this is one property read.
+ */
+import type { Policy, Refusal } from "./permissions/types.js";
+import type { AnySchema } from "./schema/schema.js";
+/** The declaration's names, and the words it has for them. */
+export declare function tellTheWatchItsNames(schema: AnySchema, mutations: Iterable<{
+    readonly name: string;
+    readonly title?: string;
+}>, policy: Policy | undefined): void;
+/**
+ * THE STORE ITSELF, for a harness that measures whether a person got a job
+ * done (`scripts/verify-journeys.mjs`). It drives the page as a person
+ * would and reads the log afterwards to say whether the press did what it
+ * meant — the screen saying so is the claim under test, not the evidence.
+ */
+export declare function tellTheWatchOfAStore(store: unknown): void;
+/** An author's id, once it has signed something: a seat's id is a name too. */
+export declare function tellTheWatchOfAnAuthor(id: string | undefined): void;
+/** A press reached the store and the policy refused it. */
+export declare function tellTheWatchOfARefusal(refusal: Refusal, author: string | undefined): void;
+//# sourceMappingURL=watched.d.ts.map

package/dist/watched.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watched.d.ts","sourceRoot":"","sources":["../src/watched.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACvE,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI,CAuBN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAGnE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzF"}

package/dist/watched.js

@@ -0,0 +1,50 @@
+const theWatch = () => globalThis.__graviewWatch;
+/** The declaration's names, and the words it has for them. */
+export function tellTheWatchItsNames(schema, mutations, policy) {
+    const watch = theWatch();
+    if (!watch?.learn)
+        return;
+    const ids = [];
+    const words = [];
+    for (const definition of schema.definitions) {
+        ids.push(definition.kind);
+        words.push(definition.plural ?? "", definition.noun ?? "", definition.description ?? "");
+        const shape = definition.fields.shape ?? {};
+        ids.push(...Object.keys(shape));
+        for (const label of Object.values(definition.display?.labels ?? {}))
+            words.push(label);
+        for (const [name, edge] of Object.entries(definition.edges ?? {})) {
+            ids.push(name);
+            words.push(edge.description ?? "", edge.inverse ?? "");
+        }
+    }
+    for (const mutation of mutations) {
+        ids.push(mutation.name);
+        words.push(mutation.title ?? "");
+    }
+    for (const grant of policy?.grants ?? [])
+        if (grant.roles !== "*")
+            ids.push(...grant.roles);
+    ids.push(...(policy?.roles ?? []));
+    watch.learn({ ids, words: words.filter(Boolean) });
+}
+/**
+ * THE STORE ITSELF, for a harness that measures whether a person got a job
+ * done (`scripts/verify-journeys.mjs`). It drives the page as a person
+ * would and reads the log afterwards to say whether the press did what it
+ * meant — the screen saying so is the claim under test, not the evidence.
+ */
+export function tellTheWatchOfAStore(store) {
+    theWatch()?.store?.(store);
+}
+/** An author's id, once it has signed something: a seat's id is a name too. */
+export function tellTheWatchOfAnAuthor(id) {
+    if (id === undefined)
+        return;
+    theWatch()?.learn?.({ ids: [id], words: [] });
+}
+/** A press reached the store and the policy refused it. */
+export function tellTheWatchOfARefusal(refusal, author) {
+    theWatch()?.refused?.({ ...refusal, ...(author === undefined ? {} : { author }) });
+}
+//# sourceMappingURL=watched.js.map

package/dist/watched.js.map

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

package/dist/who.d.ts

@@ -0,0 +1,26 @@
+import type { Author } from "./ops/types.js";
+import type { Principal } from "./permissions/types.js";
+import type { AnySchema } from "./schema/schema.js";
+/**
+ * AN AUTHOR BY NAME. A principal's id is its user node's id where the app
+ * has an installation; where it has seats and no installation, the seat
+ * carries the name the person was offered it under. The rail said
+ * "user-lena Hometown (Again) no longer features Mara Vey" and the profile
+ * "U user-june" — ids, in two places a person reads — while the seats had
+ * been handed to the provider as "Lena, the label" and "June Arlo,
+ * producer".
+ */
+export declare function nameOfAuthor(author: Pick<Author, "kind" | "id">, where: {
+    readonly graph: {
+        getNode(id: string): ({
+            id: string;
+            kind: string;
+        } & Record<string, unknown>) | undefined;
+    };
+    readonly schema: AnySchema;
+    readonly seats?: readonly {
+        readonly label: string;
+        readonly principal: Principal;
+    }[];
+}): string;
+//# sourceMappingURL=who.d.ts.map

package/dist/who.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../src/who.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACnC,KAAK,EAAE;IACL,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IAC9G,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACvF,GACA,MAAM,CAMR"}