@es3d/es3d 1.0.0 → 1.0.1

package/src/format/ast.js

@@ -1,238 +1,238 @@
-// The ES3D abstract syntax tree.
-//
-// Every surface syntax (markup, compact, JSON, binary) produces the same tree of
-// Element / Comment nodes. Attribute values stay as raw strings in the AST so a
-// document can be round-tripped losslessly; typed values are attached by the
-// validator in `element.values` (keyed by canonical attribute name).
-
-export class Attr {
-  constructor(name, value, nameStart = -1, nameEnd = -1, valueStart = -1, valueEnd = -1, quote = '"') {
-    this.name = name;
-    this.value = value;
-    this.nameStart = nameStart;
-    this.nameEnd = nameEnd;
-    this.valueStart = valueStart;
-    this.valueEnd = valueEnd;
-    this.quote = quote;
-    /** true when the raw value contained entity references (offsets inside the value are approximate) */
-    this.decoded = false;
-    /** pre-parsed typed value supplied by a decoder (the validator then skips parsing the text) */
-    this.typed = undefined;
-  }
-}
-
-/**
- * Attribute whose typed value is known and whose text is produced on demand
- * (binary decoding of large arrays: formatting a mesh as text only to parse
- * it again would dominate the load time). Assigning a new text value drops
- * the typed value.
- */
-export class LazyAttr extends Attr {
-  constructor(name, typed, format) {
-    super(name, null);
-    this.typed = typed;
-    this.format = format;
-  }
-
-  get value() {
-    if (this._value === null) this._value = this.format();
-    return this._value;
-  }
-
-  set value(v) {
-    this._value = v;
-    if (v !== null) this.typed = undefined;
-  }
-}
-
-export class Comment {
-  constructor(text, start = -1, end = -1) {
-    this.type = 'comment';
-    this.text = text;
-    this.start = start;
-    this.end = end;
-    this.parent = null;
-  }
-}
-
-export class Element {
-  constructor(name, start = -1) {
-    this.type = 'element';
-    this.name = name;
-    /** @type {Attr[]} */
-    this.attrs = [];
-    /** @type {(Element|Comment)[]} */
-    this.children = [];
-    this.text = null;
-    this.textStart = -1;
-    this.textEnd = -1;
-    this.start = start;
-    this.end = start;
-    this.nameStart = start;
-    this.nameEnd = start;
-    this.openEnd = start;
-    this.closeStart = -1;
-    this.selfClosing = true;
-    this.uid = 0;
-    this.parent = null;
-    /** canonical name -> typed value (set by the validator) */
-    this.values = null;
-    /** canonical name -> Attr (set by the validator) */
-    this.attrIndex = null;
-  }
-
-  attr(name) {
-    for (let i = 0; i < this.attrs.length; i++) if (this.attrs[i].name === name) return this.attrs[i].value;
-    return undefined;
-  }
-
-  attrNode(name) {
-    for (let i = 0; i < this.attrs.length; i++) if (this.attrs[i].name === name) return this.attrs[i];
-    return null;
-  }
-
-  setAttr(name, value) {
-    const a = this.attrNode(name);
-    if (a) a.value = String(value);
-    else this.attrs.push(new Attr(name, String(value)));
-    return this;
-  }
-
-  removeAttr(name) {
-    const i = this.attrs.findIndex((a) => a.name === name);
-    if (i >= 0) this.attrs.splice(i, 1);
-    return this;
-  }
-
-  appendChild(node) {
-    node.parent = this;
-    this.children.push(node);
-    this.selfClosing = false;
-    return node;
-  }
-
-  get elementChildren() {
-    return this.children.filter((c) => c.type === 'element');
-  }
-
-  /** The canonical id of this element, if any. */
-  get id() {
-    return this.values && this.values.id !== undefined ? this.values.id : this.attr('id');
-  }
-}
-
-export class Document {
-  constructor({ root, syntax, source = null, leading = [], trailing = [] }) {
-    /** @type {Element} */
-    this.root = root;
-    /** 'xml' | 'compact' | 'json' | 'binary' */
-    this.syntax = syntax;
-    this.source = source;
-    /** comments before / after the root element */
-    this.leading = leading;
-    this.trailing = trailing;
-    this.lineIndex = null;
-    this.diagnostics = [];
-    /** id -> Element (set by the validator) */
-    this.ids = new Map();
-    /** uid -> Element */
-    this.byUid = new Map();
-    this.elementCount = 0;
-  }
-
-  get errors() {
-    return this.diagnostics.filter((d) => d.severity === 'error');
-  }
-
-  get warnings() {
-    return this.diagnostics.filter((d) => d.severity === 'warning');
-  }
-
-  get ok() {
-    return !this.diagnostics.some((d) => d.severity === 'error');
-  }
-}
-
-/** Depth-first pre-order traversal of elements. Return false from fn to skip children. */
-export function walk(el, fn, parent = null, depth = 0) {
-  if (fn(el, parent, depth) === false) return;
-  const kids = el.children;
-  for (let i = 0; i < kids.length; i++) {
-    const c = kids[i];
-    if (c.type === 'element') walk(c, fn, el, depth + 1);
-  }
-}
-
-/** Assign sequential uids and parent links; returns the number of elements. */
-export function indexTree(doc) {
-  let uid = 0;
-  doc.byUid.clear();
-  const visit = (el, parent) => {
-    el.uid = ++uid;
-    el.parent = parent;
-    doc.byUid.set(el.uid, el);
-    for (const c of el.children) {
-      if (c.type === 'element') visit(c, el);
-      else c.parent = el;
-    }
-  };
-  if (doc.root) visit(doc.root, null);
-  doc.elementCount = uid;
-  return uid;
-}
-
-/** Deep copy of an element subtree without source positions or typed values. */
-export function cloneElement(el, keepPositions = false) {
-  const copy = new Element(el.name, keepPositions ? el.start : -1);
-  for (const a of el.attrs) {
-    copy.attrs.push(keepPositions ? Object.assign(new Attr(a.name, a.value), a) : new Attr(a.name, a.value));
-  }
-  copy.text = el.text;
-  copy.selfClosing = el.selfClosing;
-  for (const c of el.children) {
-    if (c.type === 'element') copy.appendChild(cloneElement(c, keepPositions));
-    else copy.appendChild(new Comment(c.text));
-  }
-  copy.selfClosing = el.children.length === 0;
-  return copy;
-}
-
-/** Convenience constructor: h('box', {size: '2'}, ...children) */
-export function h(name, attrs = {}, ...children) {
-  const el = new Element(name);
-  for (const [k, v] of Object.entries(attrs)) {
-    if (v === undefined || v === null) continue;
-    el.attrs.push(new Attr(k, String(v)));
-  }
-  for (const c of children.flat()) {
-    if (c === null || c === undefined || c === false) continue;
-    if (typeof c === 'string') el.text = (el.text || '') + c;
-    else el.appendChild(c);
-  }
-  el.selfClosing = el.children.length === 0 && el.text === null;
-  return el;
-}
-
-/** Structural equality of two subtrees (names, attributes, text, element children). */
-export function treesEqual(a, b, { ignoreComments = true, attrOrder = false } = {}) {
-  if (a.name !== b.name) return false;
-  if ((a.text || '').trim() !== (b.text || '').trim()) return false;
-  if (a.attrs.length !== b.attrs.length) return false;
-  if (attrOrder) {
-    for (let i = 0; i < a.attrs.length; i++) {
-      if (a.attrs[i].name !== b.attrs[i].name || a.attrs[i].value !== b.attrs[i].value) return false;
-    }
-  } else {
-    for (const at of a.attrs) if (b.attr(at.name) !== at.value) return false;
-  }
-  const ka = ignoreComments ? a.children.filter((c) => c.type === 'element') : a.children;
-  const kb = ignoreComments ? b.children.filter((c) => c.type === 'element') : b.children;
-  if (ka.length !== kb.length) return false;
-  for (let i = 0; i < ka.length; i++) {
-    if (ka[i].type !== kb[i].type) return false;
-    if (ka[i].type === 'comment') {
-      if (ka[i].text !== kb[i].text) return false;
-    } else if (!treesEqual(ka[i], kb[i], { ignoreComments, attrOrder })) return false;
-  }
-  return true;
-}
+// The ES3D abstract syntax tree.
+//
+// Every surface syntax (markup, compact, JSON, binary) produces the same tree of
+// Element / Comment nodes. Attribute values stay as raw strings in the AST so a
+// document can be round-tripped losslessly; typed values are attached by the
+// validator in `element.values` (keyed by canonical attribute name).
+
+export class Attr {
+  constructor(name, value, nameStart = -1, nameEnd = -1, valueStart = -1, valueEnd = -1, quote = '"') {
+    this.name = name;
+    this.value = value;
+    this.nameStart = nameStart;
+    this.nameEnd = nameEnd;
+    this.valueStart = valueStart;
+    this.valueEnd = valueEnd;
+    this.quote = quote;
+    /** true when the raw value contained entity references (offsets inside the value are approximate) */
+    this.decoded = false;
+    /** pre-parsed typed value supplied by a decoder (the validator then skips parsing the text) */
+    this.typed = undefined;
+  }
+}
+
+/**
+ * Attribute whose typed value is known and whose text is produced on demand
+ * (binary decoding of large arrays: formatting a mesh as text only to parse
+ * it again would dominate the load time). Assigning a new text value drops
+ * the typed value.
+ */
+export class LazyAttr extends Attr {
+  constructor(name, typed, format) {
+    super(name, null);
+    this.typed = typed;
+    this.format = format;
+  }
+
+  get value() {
+    if (this._value === null) this._value = this.format();
+    return this._value;
+  }
+
+  set value(v) {
+    this._value = v;
+    if (v !== null) this.typed = undefined;
+  }
+}
+
+export class Comment {
+  constructor(text, start = -1, end = -1) {
+    this.type = 'comment';
+    this.text = text;
+    this.start = start;
+    this.end = end;
+    this.parent = null;
+  }
+}
+
+export class Element {
+  constructor(name, start = -1) {
+    this.type = 'element';
+    this.name = name;
+    /** @type {Attr[]} */
+    this.attrs = [];
+    /** @type {(Element|Comment)[]} */
+    this.children = [];
+    this.text = null;
+    this.textStart = -1;
+    this.textEnd = -1;
+    this.start = start;
+    this.end = start;
+    this.nameStart = start;
+    this.nameEnd = start;
+    this.openEnd = start;
+    this.closeStart = -1;
+    this.selfClosing = true;
+    this.uid = 0;
+    this.parent = null;
+    /** canonical name -> typed value (set by the validator) */
+    this.values = null;
+    /** canonical name -> Attr (set by the validator) */
+    this.attrIndex = null;
+  }
+
+  attr(name) {
+    for (let i = 0; i < this.attrs.length; i++) if (this.attrs[i].name === name) return this.attrs[i].value;
+    return undefined;
+  }
+
+  attrNode(name) {
+    for (let i = 0; i < this.attrs.length; i++) if (this.attrs[i].name === name) return this.attrs[i];
+    return null;
+  }
+
+  setAttr(name, value) {
+    const a = this.attrNode(name);
+    if (a) a.value = String(value);
+    else this.attrs.push(new Attr(name, String(value)));
+    return this;
+  }
+
+  removeAttr(name) {
+    const i = this.attrs.findIndex((a) => a.name === name);
+    if (i >= 0) this.attrs.splice(i, 1);
+    return this;
+  }
+
+  appendChild(node) {
+    node.parent = this;
+    this.children.push(node);
+    this.selfClosing = false;
+    return node;
+  }
+
+  get elementChildren() {
+    return this.children.filter((c) => c.type === 'element');
+  }
+
+  /** The canonical id of this element, if any. */
+  get id() {
+    return this.values && this.values.id !== undefined ? this.values.id : this.attr('id');
+  }
+}
+
+export class Document {
+  constructor({ root, syntax, source = null, leading = [], trailing = [] }) {
+    /** @type {Element} */
+    this.root = root;
+    /** 'xml' | 'compact' | 'json' | 'binary' */
+    this.syntax = syntax;
+    this.source = source;
+    /** comments before / after the root element */
+    this.leading = leading;
+    this.trailing = trailing;
+    this.lineIndex = null;
+    this.diagnostics = [];
+    /** id -> Element (set by the validator) */
+    this.ids = new Map();
+    /** uid -> Element */
+    this.byUid = new Map();
+    this.elementCount = 0;
+  }
+
+  get errors() {
+    return this.diagnostics.filter((d) => d.severity === 'error');
+  }
+
+  get warnings() {
+    return this.diagnostics.filter((d) => d.severity === 'warning');
+  }
+
+  get ok() {
+    return !this.diagnostics.some((d) => d.severity === 'error');
+  }
+}
+
+/** Depth-first pre-order traversal of elements. Return false from fn to skip children. */
+export function walk(el, fn, parent = null, depth = 0) {
+  if (fn(el, parent, depth) === false) return;
+  const kids = el.children;
+  for (let i = 0; i < kids.length; i++) {
+    const c = kids[i];
+    if (c.type === 'element') walk(c, fn, el, depth + 1);
+  }
+}
+
+/** Assign sequential uids and parent links; returns the number of elements. */
+export function indexTree(doc) {
+  let uid = 0;
+  doc.byUid.clear();
+  const visit = (el, parent) => {
+    el.uid = ++uid;
+    el.parent = parent;
+    doc.byUid.set(el.uid, el);
+    for (const c of el.children) {
+      if (c.type === 'element') visit(c, el);
+      else c.parent = el;
+    }
+  };
+  if (doc.root) visit(doc.root, null);
+  doc.elementCount = uid;
+  return uid;
+}
+
+/** Deep copy of an element subtree without source positions or typed values. */
+export function cloneElement(el, keepPositions = false) {
+  const copy = new Element(el.name, keepPositions ? el.start : -1);
+  for (const a of el.attrs) {
+    copy.attrs.push(keepPositions ? Object.assign(new Attr(a.name, a.value), a) : new Attr(a.name, a.value));
+  }
+  copy.text = el.text;
+  copy.selfClosing = el.selfClosing;
+  for (const c of el.children) {
+    if (c.type === 'element') copy.appendChild(cloneElement(c, keepPositions));
+    else copy.appendChild(new Comment(c.text));
+  }
+  copy.selfClosing = el.children.length === 0;
+  return copy;
+}
+
+/** Convenience constructor: h('box', {size: '2'}, ...children) */
+export function h(name, attrs = {}, ...children) {
+  const el = new Element(name);
+  for (const [k, v] of Object.entries(attrs)) {
+    if (v === undefined || v === null) continue;
+    el.attrs.push(new Attr(k, String(v)));
+  }
+  for (const c of children.flat()) {
+    if (c === null || c === undefined || c === false) continue;
+    if (typeof c === 'string') el.text = (el.text || '') + c;
+    else el.appendChild(c);
+  }
+  el.selfClosing = el.children.length === 0 && el.text === null;
+  return el;
+}
+
+/** Structural equality of two subtrees (names, attributes, text, element children). */
+export function treesEqual(a, b, { ignoreComments = true, attrOrder = false } = {}) {
+  if (a.name !== b.name) return false;
+  if ((a.text || '').trim() !== (b.text || '').trim()) return false;
+  if (a.attrs.length !== b.attrs.length) return false;
+  if (attrOrder) {
+    for (let i = 0; i < a.attrs.length; i++) {
+      if (a.attrs[i].name !== b.attrs[i].name || a.attrs[i].value !== b.attrs[i].value) return false;
+    }
+  } else {
+    for (const at of a.attrs) if (b.attr(at.name) !== at.value) return false;
+  }
+  const ka = ignoreComments ? a.children.filter((c) => c.type === 'element') : a.children;
+  const kb = ignoreComments ? b.children.filter((c) => c.type === 'element') : b.children;
+  if (ka.length !== kb.length) return false;
+  for (let i = 0; i < ka.length; i++) {
+    if (ka[i].type !== kb[i].type) return false;
+    if (ka[i].type === 'comment') {
+      if (ka[i].text !== kb[i].text) return false;
+    } else if (!treesEqual(ka[i], kb[i], { ignoreComments, attrOrder })) return false;
+  }
+  return true;
+}

package/src/format/colors.js

@@ -1,93 +1,93 @@
-// Color parsing. ES3D colors are sRGB like CSS/SVG: #rgb, #rgba, #rrggbb,
-// #rrggbbaa, rgb(r,g,b), rgba(r,g,b,a) and the 148 CSS named colors.
-// Values are returned as [r, g, b, a] in 0..1 (sRGB, not linearized).
-
-const NAMED =
-  'aliceblue:f0f8ff,antiquewhite:faebd7,aqua:00ffff,aquamarine:7fffd4,azure:f0ffff,beige:f5f5dc,bisque:ffe4c4,' +
-  'black:000000,blanchedalmond:ffebcd,blue:0000ff,blueviolet:8a2be2,brown:a52a2a,burlywood:deb887,cadetblue:5f9ea0,' +
-  'chartreuse:7fff00,chocolate:d2691e,coral:ff7f50,cornflowerblue:6495ed,cornsilk:fff8dc,crimson:dc143c,cyan:00ffff,' +
-  'darkblue:00008b,darkcyan:008b8b,darkgoldenrod:b8860b,darkgray:a9a9a9,darkgreen:006400,darkgrey:a9a9a9,' +
-  'darkkhaki:bdb76b,darkmagenta:8b008b,darkolivegreen:556b2f,darkorange:ff8c00,darkorchid:9932cc,darkred:8b0000,' +
-  'darksalmon:e9967a,darkseagreen:8fbc8f,darkslateblue:483d8b,darkslategray:2f4f4f,darkslategrey:2f4f4f,' +
-  'darkturquoise:00ced1,darkviolet:9400d3,deeppink:ff1493,deepskyblue:00bfff,dimgray:696969,dimgrey:696969,' +
-  'dodgerblue:1e90ff,firebrick:b22222,floralwhite:fffaf0,forestgreen:228b22,fuchsia:ff00ff,gainsboro:dcdcdc,' +
-  'ghostwhite:f8f8ff,gold:ffd700,goldenrod:daa520,gray:808080,green:008000,greenyellow:adff2f,grey:808080,' +
-  'honeydew:f0fff0,hotpink:ff69b4,indianred:cd5c5c,indigo:4b0082,ivory:fffff0,khaki:f0e68c,lavender:e6e6fa,' +
-  'lavenderblush:fff0f5,lawngreen:7cfc00,lemonchiffon:fffacd,lightblue:add8e6,lightcoral:f08080,lightcyan:e0ffff,' +
-  'lightgoldenrodyellow:fafad2,lightgray:d3d3d3,lightgreen:90ee90,lightgrey:d3d3d3,lightpink:ffb6c1,' +
-  'lightsalmon:ffa07a,lightseagreen:20b2aa,lightskyblue:87cefa,lightslategray:778899,lightslategrey:778899,' +
-  'lightsteelblue:b0c4de,lightyellow:ffffe0,lime:00ff00,limegreen:32cd32,linen:faf0e6,magenta:ff00ff,maroon:800000,' +
-  'mediumaquamarine:66cdaa,mediumblue:0000cd,mediumorchid:ba55d3,mediumpurple:9370db,mediumseagreen:3cb371,' +
-  'mediumslateblue:7b68ee,mediumspringgreen:00fa9a,mediumturquoise:48d1cc,mediumvioletred:c71585,' +
-  'midnightblue:191970,mintcream:f5fffa,mistyrose:ffe4e1,moccasin:ffe4b5,navajowhite:ffdead,navy:000080,' +
-  'oldlace:fdf5e6,olive:808000,olivedrab:6b8e23,orange:ffa500,orangered:ff4500,orchid:da70d6,palegoldenrod:eee8aa,' +
-  'palegreen:98fb98,paleturquoise:afeeee,palevioletred:db7093,papayawhip:ffefd5,peachpuff:ffdab9,peru:cd853f,' +
-  'pink:ffc0cb,plum:dda0dd,powderblue:b0e0e6,purple:800080,rebeccapurple:663399,red:ff0000,rosybrown:bc8f8f,' +
-  'royalblue:4169e1,saddlebrown:8b4513,salmon:fa8072,sandybrown:f4a460,seagreen:2e8b57,seashell:fff5ee,' +
-  'sienna:a0522d,silver:c0c0c0,skyblue:87ceeb,slateblue:6a5acd,slategray:708090,slategrey:708090,snow:fffafa,' +
-  'springgreen:00ff7f,steelblue:4682b4,tan:d2b48c,teal:008080,thistle:d8bfd8,tomato:ff6347,turquoise:40e0d0,' +
-  'violet:ee82ee,wheat:f5deb3,white:ffffff,whitesmoke:f5f5f5,yellow:ffff00,yellowgreen:9acd32';
-
-export const NAMED_COLORS = new Map(NAMED.split(',').map((kv) => kv.split(':')));
-
-const HEX = /^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
-
-/** Parse a color; returns [r,g,b,a] (0..1 sRGB) or null when the syntax is invalid. */
-export function parseColor(str) {
-  const s = str.trim();
-  if (s[0] === '#') {
-    if (!HEX.test(s)) return null;
-    let h = s.slice(1);
-    if (h.length <= 4) h = [...h].map((c) => c + c).join('');
-    const n = h.length === 6 ? h + 'ff' : h;
-    return [0, 2, 4, 6].map((i) => parseInt(n.slice(i, i + 2), 16) / 255);
-  }
-  const lower = s.toLowerCase();
-  if (lower === 'transparent') return [0, 0, 0, 0];
-  const named = NAMED_COLORS.get(lower);
-  if (named) return parseColor('#' + named);
-  const m = /^rgba?\(\s*([^)]*)\)$/i.exec(s);
-  if (m) {
-    const parts = m[1].split(/\s*,\s*|\s+/).filter(Boolean);
-    if (parts.length !== 3 && parts.length !== 4) return null;
-    const out = [];
-    for (let i = 0; i < parts.length; i++) {
-      const p = parts[i];
-      let v;
-      if (p.endsWith('%')) v = Number(p.slice(0, -1)) / 100;
-      else v = i < 3 ? Number(p) / 255 : Number(p);
-      if (!Number.isFinite(v) || v < 0 || v > 1) return null;
-      out.push(v);
-    }
-    if (out.length === 3) out.push(1);
-    return out;
-  }
-  return null;
-}
-
-export function srgbToLinear(c) {
-  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
-}
-
-export function linearToSrgb(c) {
-  return c <= 0.0031308 ? c * 12.92 : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
-}
-
-/** [r,g,b,a] sRGB -> [r,g,b,a] linear (alpha untouched). */
-export function colorToLinear(c) {
-  return [srgbToLinear(c[0]), srgbToLinear(c[1]), srgbToLinear(c[2]), c[3]];
-}
-
-/** Canonical lowercase hex form (#rrggbb or #rrggbbaa). */
-export function colorToHex(c) {
-  const h = (v) => Math.round(Math.max(0, Math.min(1, v)) * 255).toString(16).padStart(2, '0');
-  const base = '#' + h(c[0]) + h(c[1]) + h(c[2]);
-  return c[3] !== undefined && c[3] < 1 ? base + h(c[3]) : base;
-}
-
-/** Shortest hex form (#rgb when possible). */
-export function colorToShortHex(c) {
-  const hex = colorToHex(c);
-  if (hex.length === 7 && hex[1] === hex[2] && hex[3] === hex[4] && hex[5] === hex[6]) return '#' + hex[1] + hex[3] + hex[5];
-  return hex;
-}
+// Color parsing. ES3D colors are sRGB like CSS/SVG: #rgb, #rgba, #rrggbb,
+// #rrggbbaa, rgb(r,g,b), rgba(r,g,b,a) and the 148 CSS named colors.
+// Values are returned as [r, g, b, a] in 0..1 (sRGB, not linearized).
+
+const NAMED =
+  'aliceblue:f0f8ff,antiquewhite:faebd7,aqua:00ffff,aquamarine:7fffd4,azure:f0ffff,beige:f5f5dc,bisque:ffe4c4,' +
+  'black:000000,blanchedalmond:ffebcd,blue:0000ff,blueviolet:8a2be2,brown:a52a2a,burlywood:deb887,cadetblue:5f9ea0,' +
+  'chartreuse:7fff00,chocolate:d2691e,coral:ff7f50,cornflowerblue:6495ed,cornsilk:fff8dc,crimson:dc143c,cyan:00ffff,' +
+  'darkblue:00008b,darkcyan:008b8b,darkgoldenrod:b8860b,darkgray:a9a9a9,darkgreen:006400,darkgrey:a9a9a9,' +
+  'darkkhaki:bdb76b,darkmagenta:8b008b,darkolivegreen:556b2f,darkorange:ff8c00,darkorchid:9932cc,darkred:8b0000,' +
+  'darksalmon:e9967a,darkseagreen:8fbc8f,darkslateblue:483d8b,darkslategray:2f4f4f,darkslategrey:2f4f4f,' +
+  'darkturquoise:00ced1,darkviolet:9400d3,deeppink:ff1493,deepskyblue:00bfff,dimgray:696969,dimgrey:696969,' +
+  'dodgerblue:1e90ff,firebrick:b22222,floralwhite:fffaf0,forestgreen:228b22,fuchsia:ff00ff,gainsboro:dcdcdc,' +
+  'ghostwhite:f8f8ff,gold:ffd700,goldenrod:daa520,gray:808080,green:008000,greenyellow:adff2f,grey:808080,' +
+  'honeydew:f0fff0,hotpink:ff69b4,indianred:cd5c5c,indigo:4b0082,ivory:fffff0,khaki:f0e68c,lavender:e6e6fa,' +
+  'lavenderblush:fff0f5,lawngreen:7cfc00,lemonchiffon:fffacd,lightblue:add8e6,lightcoral:f08080,lightcyan:e0ffff,' +
+  'lightgoldenrodyellow:fafad2,lightgray:d3d3d3,lightgreen:90ee90,lightgrey:d3d3d3,lightpink:ffb6c1,' +
+  'lightsalmon:ffa07a,lightseagreen:20b2aa,lightskyblue:87cefa,lightslategray:778899,lightslategrey:778899,' +
+  'lightsteelblue:b0c4de,lightyellow:ffffe0,lime:00ff00,limegreen:32cd32,linen:faf0e6,magenta:ff00ff,maroon:800000,' +
+  'mediumaquamarine:66cdaa,mediumblue:0000cd,mediumorchid:ba55d3,mediumpurple:9370db,mediumseagreen:3cb371,' +
+  'mediumslateblue:7b68ee,mediumspringgreen:00fa9a,mediumturquoise:48d1cc,mediumvioletred:c71585,' +
+  'midnightblue:191970,mintcream:f5fffa,mistyrose:ffe4e1,moccasin:ffe4b5,navajowhite:ffdead,navy:000080,' +
+  'oldlace:fdf5e6,olive:808000,olivedrab:6b8e23,orange:ffa500,orangered:ff4500,orchid:da70d6,palegoldenrod:eee8aa,' +
+  'palegreen:98fb98,paleturquoise:afeeee,palevioletred:db7093,papayawhip:ffefd5,peachpuff:ffdab9,peru:cd853f,' +
+  'pink:ffc0cb,plum:dda0dd,powderblue:b0e0e6,purple:800080,rebeccapurple:663399,red:ff0000,rosybrown:bc8f8f,' +
+  'royalblue:4169e1,saddlebrown:8b4513,salmon:fa8072,sandybrown:f4a460,seagreen:2e8b57,seashell:fff5ee,' +
+  'sienna:a0522d,silver:c0c0c0,skyblue:87ceeb,slateblue:6a5acd,slategray:708090,slategrey:708090,snow:fffafa,' +
+  'springgreen:00ff7f,steelblue:4682b4,tan:d2b48c,teal:008080,thistle:d8bfd8,tomato:ff6347,turquoise:40e0d0,' +
+  'violet:ee82ee,wheat:f5deb3,white:ffffff,whitesmoke:f5f5f5,yellow:ffff00,yellowgreen:9acd32';
+
+export const NAMED_COLORS = new Map(NAMED.split(',').map((kv) => kv.split(':')));
+
+const HEX = /^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+
+/** Parse a color; returns [r,g,b,a] (0..1 sRGB) or null when the syntax is invalid. */
+export function parseColor(str) {
+  const s = str.trim();
+  if (s[0] === '#') {
+    if (!HEX.test(s)) return null;
+    let h = s.slice(1);
+    if (h.length <= 4) h = [...h].map((c) => c + c).join('');
+    const n = h.length === 6 ? h + 'ff' : h;
+    return [0, 2, 4, 6].map((i) => parseInt(n.slice(i, i + 2), 16) / 255);
+  }
+  const lower = s.toLowerCase();
+  if (lower === 'transparent') return [0, 0, 0, 0];
+  const named = NAMED_COLORS.get(lower);
+  if (named) return parseColor('#' + named);
+  const m = /^rgba?\(\s*([^)]*)\)$/i.exec(s);
+  if (m) {
+    const parts = m[1].split(/\s*,\s*|\s+/).filter(Boolean);
+    if (parts.length !== 3 && parts.length !== 4) return null;
+    const out = [];
+    for (let i = 0; i < parts.length; i++) {
+      const p = parts[i];
+      let v;
+      if (p.endsWith('%')) v = Number(p.slice(0, -1)) / 100;
+      else v = i < 3 ? Number(p) / 255 : Number(p);
+      if (!Number.isFinite(v) || v < 0 || v > 1) return null;
+      out.push(v);
+    }
+    if (out.length === 3) out.push(1);
+    return out;
+  }
+  return null;
+}
+
+export function srgbToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+
+export function linearToSrgb(c) {
+  return c <= 0.0031308 ? c * 12.92 : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+}
+
+/** [r,g,b,a] sRGB -> [r,g,b,a] linear (alpha untouched). */
+export function colorToLinear(c) {
+  return [srgbToLinear(c[0]), srgbToLinear(c[1]), srgbToLinear(c[2]), c[3]];
+}
+
+/** Canonical lowercase hex form (#rrggbb or #rrggbbaa). */
+export function colorToHex(c) {
+  const h = (v) => Math.round(Math.max(0, Math.min(1, v)) * 255).toString(16).padStart(2, '0');
+  const base = '#' + h(c[0]) + h(c[1]) + h(c[2]);
+  return c[3] !== undefined && c[3] < 1 ? base + h(c[3]) : base;
+}
+
+/** Shortest hex form (#rgb when possible). */
+export function colorToShortHex(c) {
+  const hex = colorToHex(c);
+  if (hex.length === 7 && hex[1] === hex[2] && hex[3] === hex[4] && hex[5] === hex[6]) return '#' + hex[1] + hex[3] + hex[5];
+  return hex;
+}