@fusion.dev/helix-theme 0.111.1 → 0.112.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import type { DerivedTheme, Oklch, ThemeIntent } from './types.js';
-export type { Color, DerivedTheme, DerivedToken, Oklch, Pairing, PairingRequest, Relation, Seed, StatusSeed, ThemeIntent, } from './types.js';
+import type { DerivedModes, DerivedTheme, Oklch, ThemeIntent } from './types.js';
+export type { Color, DerivedModes, DerivedTheme, DerivedToken, Oklch, Pairing, PairingRequest, Relation, Seed, StatusSeed, ThemeIntent, } from './types.js';
 /** A loaded engine. */
 export interface ThemeEngine {
     /**
@@ -11,6 +11,18 @@ export interface ThemeEngine {
      * outside the range it is meaningful in.
      */
     derive(intent: ThemeIntent, selectors?: readonly string[]): DerivedTheme;
+    /**
+     * Derives a theme in both modes, and renders them as one block under each
+     * selector asked for, every color a `light-dark()` pair, which is how the
+     * shipped stylesheet writes its tokens. The intent's `scheme` is set aside.
+     *
+     * For a site with both modes, which otherwise derived twice and merged the
+     * blocks by hand. Each mode's theme comes back too, so a finding in either is
+     * still read.
+     *
+     * @throws when the engine refuses the intent in either mode.
+     */
+    deriveModes(intent: ThemeIntent, selectors?: readonly string[]): DerivedModes;
     /**
      * Reads a hex color into its OKLCH components.
      *

package/dist/index.js

@@ -1,8 +1,9 @@
-import initWasm, { derive, hexToOklch as readHex } from '../wasm/fusion_helix_theme.js';
+import initWasm, { derive, deriveModes, hexToOklch as readHex } from '../wasm/fusion_helix_theme.js';
 let loading;
 export function initTheme(source) {
     loading ??= initWasm({ module_or_path: source }).then(() => ({
         derive: (intent, selectors = []) => JSON.parse(derive(JSON.stringify(intent), JSON.stringify(selectors))),
+        deriveModes: (intent, selectors = []) => JSON.parse(deriveModes(JSON.stringify(intent), JSON.stringify(selectors))),
         hexToOklch: (hex) => JSON.parse(readHex(hex)),
     }));
     return loading;

package/dist/types.d.ts

@@ -108,9 +108,14 @@ export interface ThemeIntent {
         scale?: number;
     };
     /**
-     * Target contrast for body text. 4.5 is WCAG AA, 7 is AAA. The European
-     * Accessibility Act points at WCAG 2.1 AA, so 4.5 is the figure with legal
-     * weight and is the default.
+     * The least contrast any text may have. 4.5 is WCAG AA, 7 is AAA. The
+     * European Accessibility Act points at WCAG 2.1 AA, so 4.5 is the figure with
+     * legal weight and is the default.
+     *
+     * A floor, which the muted ink is solved to and every other text ink is
+     * measured against. Body text, `color-foreground`, is the strongest ink the
+     * neutral has whatever the target: black on a light page and white on a dark
+     * one, as the shipped stylesheet writes it.
      */
     contrastTarget?: number;
     /**
@@ -299,6 +304,20 @@ export interface ThemeIntent {
      */
     tokens?: Record<string, Color>;
 }
+/** One intent derived in both modes, from `deriveModes`. */
+export interface DerivedModes {
+    /**
+     * One block per selector asked for, each color a `light-dark()` pair. A
+     * value that is not a color and differs by mode, such as a floating
+     * surface's edge, is set by the rules after the block, for the operating
+     * system's dark mode and for `[data-color-mode]` on or inside the selector.
+     */
+    css: Record<string, string>;
+    /** The dark theme, with its own findings. Its `css` is empty. */
+    dark: DerivedTheme;
+    /** The light theme, with its own findings. Its `css` is empty. */
+    light: DerivedTheme;
+}
 /** A derived token, carrying the check that produced it. */
 export interface DerivedToken {
     /**

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.111.1",
+  "version": "0.112.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {

package/wasm/fusion_helix_theme.d.ts

@@ -21,6 +21,21 @@
  */
 export function derive(intent: string, selectors: string): string;
 
+/**
+ * Derives a theme in both modes, and renders them as one block under every
+ * selector asked for, each color a `light-dark()` pair.
+ *
+ * The intent's own `scheme` is set aside, since both are derived. The result
+ * carries each mode's report, `light` and `dark`, so a finding in either is
+ * still read, and `css` keyed by selector.
+ *
+ * # Errors
+ *
+ * When either argument is not the JSON it should be, or when the engine refuses
+ * the intent in either mode.
+ */
+export function deriveModes(intent: string, selectors: string): string;
+
 /**
  * Reads a hex color into its OKLCH components, as JSON.
  *
@@ -40,6 +55,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly derive: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly deriveModes: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hexToOklch: (a: number, b: number) => [number, number, number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;

package/wasm/fusion_helix_theme.js

@@ -44,6 +44,45 @@ export function derive(intent, selectors) {
     }
 }
 
+/**
+ * Derives a theme in both modes, and renders them as one block under every
+ * selector asked for, each color a `light-dark()` pair.
+ *
+ * The intent's own `scheme` is set aside, since both are derived. The result
+ * carries each mode's report, `light` and `dark`, so a finding in either is
+ * still read, and `css` keyed by selector.
+ *
+ * # Errors
+ *
+ * When either argument is not the JSON it should be, or when the engine refuses
+ * the intent in either mode.
+ * @param {string} intent
+ * @param {string} selectors
+ * @returns {string}
+ */
+export function deriveModes(intent, selectors) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(intent, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(selectors, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.deriveModes(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
 /**
  * Reads a hex color into its OKLCH components, as JSON.
  *

package/wasm/fusion_helix_theme_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const derive: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const deriveModes: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const hexToOklch: (a: number, b: number) => [number, number, number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;