ntk 3.9.1 → 3.10.0

package/lib/color.js

@@ -43,11 +43,19 @@ function parseHex(value) {
 }
 
 /**
- * Parse a CSS colour to premultipliable `[r, g, b, a]` floats, straight
- * alpha, or null if it is not a colour. Exported for callers that need the
- * unassociated values; use `cssColor` for anything heading to XRender.
+ * Parse a CSS colour to `[r, g, b, a]` floats in 0..1 with **straight**
+ * (unassociated) alpha, or null if it is not a colour.
+ *
+ * `cssColor` is the one to use for anything heading to XRender. This is for
+ * the places that genuinely want unassociated components:
+ *
+ *  - **OpenGL.** `glClearColor` and material colours take straight alpha;
+ *    handing them premultiplied values renders translucent colours dark.
+ *  - **Interpolating** two colours. Lerp straight, then premultiply once at
+ *    the end — a round trip back to an `rgba()` string only closes if the
+ *    components were never scaled.
  */
-export function parseCssColorStraight(value) {
+export function cssColorStraight(value) {
   if (typeof value !== 'string') return null;
   const v = value.trim();
   if (!v) return null;
@@ -73,6 +81,6 @@ function rawRgba(value) {
  * XRender, or null if `value` is not a colour.
  */
 export function cssColor(value) {
-  const straight = parseCssColorStraight(value);
+  const straight = cssColorStraight(value);
   return straight && premultiply(straight);
 }

package/lib/index.js

@@ -22,6 +22,7 @@ import SvgView from './widgets/svgview.js';
 import MarkdownView from './widgets/markdownview.js';
 import TexView, { configureTex, layoutTex, TexBox } from './widgets/tex.js';
 import { tokenize as highlightCode } from './widgets/highlight.js';
+import { cssColorStraight, premultiply } from './color.js';
 import { cssColor, cssLength } from './widgets/css.js';
 
 // rendering context modules register themselves on Drawable
@@ -135,6 +136,8 @@ export {
   configureTex,
   highlightCode,
   cssColor,
+  cssColorStraight,
+  premultiply,
   cssLength
 };
 // the yoga-layout instance ntk lays HtmlView out with — downstream layout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ntk",
-  "version": "3.9.1",
+  "version": "3.10.0",
   "description": "Desktop UI toolkit for X11 with canvas-like 2d and OpenGL rendering",
   "author": "Andrey Sidorov <sidorares@yandex.ru>",
   "license": "MIT",
@@ -55,6 +55,10 @@
     "yoga-layout": "^3.2.1"
   },
   "scripts": {
-    "test": "NTK_STRICT_COLORS=1 node --test"
+    "test": "NTK_STRICT_COLORS=1 node --test",
+    "check-release-message": "node scripts/check-release-message.mjs"
+  },
+  "devDependencies": {
+    "@conventional-commits/parser": "^0.4.1"
   }
 }