origam 2.13.0 → 2.14.1

package/dist/src/utils/Commons/color.util.d.ts

@@ -3,15 +3,38 @@ import type { TBgFgRole, TColor, TColorType, THex, THSLA, THSVA, TIntent, TLAB,
  * Recognise any string the CSS engine treats as a colour:
  *   - hex (`#abc`, `#aabbcc`, `#aabbccdd`)
  *   - functional notation (`rgb()`, `rgba()`, `hsl()`, `hsla()`,
- *     `hwb()`, `lab()`, `lch()`, `oklab()`, `oklch()`, `color()`)
+ *     `hwb()`, `lab()`, `lch()`, `oklab()`, `oklch()`, `color()`,
+ *     `color-mix()`)
  *   - CSS variable (`var(--…)`)
  *   - one of the 148 named colours OR a CSS-wide keyword
  *     (`transparent`, `currentColor`, `inherit`, …)
+ *
+ * `color-mix` was added ADR-005 (Kbd pilot): it is a real CSS `<color>`
+ * function (e.g. `color-mix(in srgb, currentColor 8%, transparent)`, the
+ * literal value the pre-migration `OrigamKbd` `tonal` variant SCSS used for
+ * its background). Before this fix the alternation only recognised bare
+ * `color(...)` (CSS Color() Level 4), so `color-mix(...)` silently fell
+ * through — NOT a regression risk: no caller could have been relying on a
+ * `color-mix(...)` string being silently dropped as "expected" behaviour.
+ * `useElevation`'s equivalent custom-value detector
+ * (`CUSTOM_BOX_SHADOW_REGEX`) already listed `color-mix` — this brings
+ * `isCssColor` in line with it.
  */
 export declare function isCssColor(color?: string | null | false): boolean;
 /**
  * Is parsable color.
  *
+ * @description
+ * A CSS colour is "parsable" when `parseColor()` (below) can actually
+ * compute its RGBA components in JS — used to gate the auto-contrast
+ * (`getForeground`) path. `var(--…)` references are excluded because their
+ * final value is only known to the browser. `color-mix(...)` is excluded
+ * for the same reason PLUS one more: its operands are frequently
+ * `currentColor` or another `var(--…)`, which have no static value at all
+ * — `parseColor` has no case for the `color-mix` function and would throw.
+ * `isCssColor` recognising `color-mix` (so it still renders verbatim via
+ * the "custom value" style channel) does NOT make it parsable.
+ *
  * @param color …
  * @returns …
  */

package/dist/src/utils/Commons/color.util.js

@@ -33,10 +33,10 @@ import {
 import { chunk, clamp, has, int, padEnd } from "./commons.util.js";
 import { consoleWarn } from "./console.util.js";
 export function isCssColor(color) {
-  return !!color && (/^(#|var\(--|(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\()/i.test(color) || CSS_NAMED_COLORS.has(color.toLowerCase()));
+  return !!color && (/^(#|var\(--|(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color-mix|color)\()/i.test(color) || CSS_NAMED_COLORS.has(color.toLowerCase()));
 }
 export function isParsableColor(color) {
-  return isCssColor(color) && !/^((rgb|hsl)a?\()?var\(--/.test(color);
+  return isCssColor(color) && !/^((rgb|hsl)a?\()?var\(--/.test(color) && !/^color-mix\(/i.test(color);
 }
 export function parseColor(color) {
   if (typeof color === "number") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "origam",
-  "version": "2.13.0",
+  "version": "2.14.1",
   "type": "module",
   "description": "origam — a Vue 3 design system with multi-theme design tokens, CSS-first components and TypeScript types.",
   "keywords": [
@@ -106,7 +106,13 @@
     "styles:build": "sass src/assets/scss/main.scss src/assets/css/main.css --no-source-map --style=compressed",
     "tokens:watch": "node scripts/build-tokens.mjs --watch",
     "tokens:lint": "node scripts/build-tokens.mjs --dry-run --strict",
-    "prepublishOnly": "pnpm run build"
+    "guards": "node scripts/guards/run-all.mjs",
+    "guards:declarations": "node scripts/guards/no-declarations-in-vue.mjs",
+    "guards:variant-css": "node scripts/guards/no-variant-css.mjs",
+    "guards:instance-types": "node scripts/guards/instance-types.mjs",
+    "guards:naming": "node scripts/guards/file-naming.mjs",
+    "prepublishOnly": "pnpm run build",
+    "prepack": "node -e \"require('fs').copyFileSync('../../CHANGELOG.md','CHANGELOG.md')\""
   },
   "dependencies": {
     "@mdi/font": "^7.4.47",
@@ -135,7 +141,7 @@
     "@tokens-studio/sd-transforms": "^2.0.3",
     "@types/node": "^26.1.0",
     "@vitejs/plugin-vue": "^6.0.7",
-    "sass": "^1.89.2",
+    "sass": "^1.102.0",
     "style-dictionary": "^5.5.0",
     "ts-transformer-keys": "^0.4.4",
     "typescript": "^6.0.3",