@fusion.dev/helix-theme 0.140.0 → 0.141.0

package/README.md

@@ -20,7 +20,8 @@ document.head.append(Object.assign(document.createElement('style'), {
 
 Give it what you mean, a brand color and whatever else you have an opinion
 about, and it returns every token the system needs with the contrast
-relationships already satisfied, rather than a palette you then have to check.
+relationships already satisfied. With no brand, the theme is ink: near-black on
+a light page and near-white on a dark one.
 
 **It has to be awaited and there is no way around that.** WebAssembly
 instantiates asynchronously, so the engine is handed back from `initTheme`

package/dist/types.d.ts

@@ -83,9 +83,9 @@ export interface PairingRequest {
 export interface ThemeIntent {
     /**
      * The second emphasis. A color pins it and the relationship stands aside.
-     * Unnamed, it is the brand: a palette with one color has one, and
-     * `tone="accent"` draws in it. `{ from: 'brand', rotate: 180 }` asks for the
-     * complement.
+     * Unnamed, it is the brand, or the ink where there is no brand: a palette
+     * with one color has one, and `tone="accent"` draws in it.
+     * `{ from: 'brand', rotate: 180 }` asks for the complement.
      */
     accent?: Seed;
     /**
@@ -103,9 +103,28 @@ export interface ThemeIntent {
         light?: Color;
     };
     /**
-     * The one color most consumers care about, and the only required input.
+     * The one color most consumers care about, or one for each scheme.
+     *
+     * **Unnamed, the theme is ink**: the primary is the neutral's own near-black
+     * on a light page and near-white on a dark one, and a filled control is drawn
+     * in it with the page's color for its label. An accent related to the brand
+     * is refused without one, and an accent named as a color is the one second
+     * color an ink theme has.
+     *
+     * **A brand that already reads is kept as it is.** Where the color clears
+     * every ground it lands on, it is the primary, and where its label clears on
+     * it, it is the fill. A navy brand stays navy on a light page. A color that
+     * does not read is moved only as far as the contrast target needs.
+     *
+     * **`{ light, dark }` names the color each scheme takes**, the way
+     * `background` does, for a brand whose two faces are two colors: a navy that
+     * turns sky blue in the dark. A scheme the pair leaves out has no brand, and
+     * is ink.
      */
-    brand: Color;
+    brand?: Color | {
+        dark?: Color;
+        light?: Color;
+    };
     /**
      * How saturated the palette is, independent of which hue it is.
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-theme",
   "description": "Theme derivation engine. Computes a complete, contrast-guaranteed token set from intent inputs.",
-  "version": "0.140.0",
+  "version": "0.141.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {