@graview/core 0.1.53 → 0.1.55

package/dist/theme/ground.js

@@ -0,0 +1,101 @@
+import { colorsIn, composite, contrast, hsl, rgbToHsl } from "./contrast.js";
+import { SCHEMES } from "./palettes.js";
+const AA = 4.5;
+const WHITE = { r: 255, g: 255, b: 255, a: 1 };
+const BLACK = { r: 0, g: 0, b: 0, a: 1 };
+export const hex = (color) => `#${[color.r, color.g, color.b].map((v) => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, "0")).join("")}`;
+const rgba = (color, alpha) => `rgba(${Math.round(color.r)}, ${Math.round(color.g)}, ${Math.round(color.b)}, ${alpha})`;
+const mix = (a, b, t) => ({ r: a.r + (b.r - a.r) * t, g: a.g + (b.g - a.g) * t, b: a.b + (b.b - a.b) * t, a: 1 });
+/** The two grounds a brand's `ground` says, as given; a scheme it leaves out is absent. */
+export function givenGrounds(ground) {
+    return typeof ground === "string" ? { light: ground } : { ...(ground.light ? { light: ground.light } : {}), ...(ground.dark ? { dark: ground.dark } : {}) };
+}
+/** The dark ground a light one implies: its hue, held to a ground's quiet saturation, taken down to the lightness of Graview's own. */
+export function darkGroundFor(light) {
+    const color = colorsIn(light)[0];
+    if (!color)
+        return undefined;
+    const { h, s } = rgbToHsl(color);
+    return hex(hsl(h, Math.min(s, 0.45), 0.08));
+}
+/** Daylight: a card is the ground most of the way to white, with an edge in the ground's own hue. */
+function lightOn(base, ground, color) {
+    const { h, s } = rgbToHsl(color);
+    const panel = mix(color, WHITE, 0.8);
+    return {
+        ...base,
+        ground,
+        groundDeep: hex(mix(color, BLACK, 0.04)),
+        panel: hex(panel),
+        panelMuted: hex(mix(color, WHITE, 0.55)),
+        edge: rgba(hsl(h, Math.min(s, 0.5), 0.14), 0.14),
+        bar: rgba(panel, 0.96),
+        float: hex(panel),
+    };
+}
+/** A lit control surface: a card is the ground lit a little, with a lit edge in the ground's own hue. */
+function darkOn(base, ground, color) {
+    const { h, s, l } = rgbToHsl(color);
+    const lit = (by) => hsl(h, s, Math.min(1, l + by));
+    return {
+        ...base,
+        ground,
+        groundDeep: hex(hsl(h, s, l * 0.6)),
+        // Nearly opaque, as Graview's own: a captured subtree has nothing behind it.
+        panel: rgba(lit(0.07), 0.96),
+        panelMuted: rgba(lit(0.035), 0.94),
+        edge: rgba(hsl(h, Math.min(s, 0.45), 0.75), 0.18),
+        bar: rgba(color, 0.96),
+        // No lighter than the panel: an accent derived to read on the panel reads here too.
+        float: rgba(lit(0.05), 0.98),
+    };
+}
+/**
+ * The neutral pair an app stands on: Graview's own, with each scheme's
+ * ground — and the panel, muted panel, edge, bar and floating sheet drawn
+ * from it — the brand's where it gives one. A dark ground left unsaid
+ * beside a light one is the light one's hue taken down to a ground.
+ */
+export function groundSchemes(ground) {
+    if (ground === undefined)
+        return SCHEMES;
+    const given = givenGrounds(ground);
+    const dark = given.dark ?? (given.light ? darkGroundFor(given.light) : undefined);
+    const light = given.light ? colorsIn(given.light)[0] : undefined;
+    const night = dark ? colorsIn(dark)[0] : undefined;
+    return {
+        light: light ? lightOn(SCHEMES.light, given.light, light) : SCHEMES.light,
+        dark: night ? darkOn(SCHEMES.dark, dark, night) : SCHEMES.dark,
+    };
+}
+/** The ground with one scheme's color replaced, in the form it was given. */
+export function groundWith(ground, scheme, color) {
+    if (typeof ground === "string")
+        return scheme === "light" ? color : { light: ground, dark: color };
+    return { ...ground, [scheme]: color };
+}
+/**
+ * The first of ink, muted ink and the accent that drops below 4.5:1 on a
+ * pair of schemes' grounds or on a card drawn from them, or null when each
+ * reads. In the light scheme an app's accent is drawn as given (FR-126),
+ * so it is judged as given.
+ */
+export function groundFailure(schemes, accent) {
+    for (const scheme of ["light", "dark"]) {
+        const tokens = schemes[scheme];
+        const solid = colorsIn(tokens.ground)[0];
+        const card = composite(colorsIn(tokens.panel)[0], solid);
+        const pairs = [["ink", tokens.ink], ["muted ink", tokens.inkMuted], ["the accent", scheme === "light" && accent ? accent : tokens.accent]];
+        for (const [what, value] of pairs) {
+            const text = colorsIn(value)[0];
+            const onGround = contrast(text, solid);
+            const onCard = contrast(text, card);
+            if (onGround < AA)
+                return { scheme, what, text, ground: solid, ratio: onGround };
+            if (onCard < AA)
+                return { scheme, what, text, ground: solid, card, ratio: onCard };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ground.js.map

package/dist/theme/ground.js.map

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

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** The version of @graview/* that this build is — every package shares it. Written by scripts/write-framework-version.mjs. */
-export declare const FRAMEWORK_VERSION = "0.1.53";
+export declare const FRAMEWORK_VERSION = "0.1.55";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** The version of @graview/* that this build is — every package shares it. Written by scripts/write-framework-version.mjs. */
-export const FRAMEWORK_VERSION = "0.1.53";
+export const FRAMEWORK_VERSION = "0.1.55";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graview/core",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -85,6 +85,22 @@
       "types": "./dist/catalog.d.ts",
       "default": "./dist/catalog.js"
     },
+    "./jobs": {
+      "types": "./dist/jobs.d.ts",
+      "default": "./dist/jobs.js"
+    },
+    "./friction": {
+      "types": "./dist/friction.d.ts",
+      "default": "./dist/friction.js"
+    },
+    "./learn": {
+      "types": "./dist/learn.d.ts",
+      "default": "./dist/learn.js"
+    },
+    "./compose": {
+      "types": "./dist/compose.d.ts",
+      "default": "./dist/compose.js"
+    },
     "./subscriptions": {
       "types": "./dist/subscriptions.d.ts",
       "default": "./dist/subscriptions.js"
@@ -199,7 +215,9 @@
     "./dist/field-sight.js",
     "./src/field-sight.ts",
     "./dist/publishing.js",
-    "./src/publishing.ts"
+    "./src/publishing.ts",
+    "./dist/typing.js",
+    "./src/typing.ts"
   ],
   "repository": {
     "type": "git",