@tamagui/style-grammar 0.0.0-bootstrap.0 → 3.0.0-beta.1093.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Nate Wienert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,33 @@
-# @tamagui/style-grammar
+# `@tamagui/style-grammar`
+
+This package owns the shared parser and intermediate representation for
+Tamagui style value strings.
+
+Runtime consumers must follow the repository's
+[one-parse-per-unique-value constraint](../../../CONTRIBUTING.md#style-value-parsing-one-parse-per-unique-value).
+Cache the parsed representation and extend it with structural predicates when
+a new consumer needs more information. Do not add a second string scanner
+beside the grammar.
+
+## The one scanner
+
+`scanFlatValue.ts` is the split: one left-to-right pass that hands a handler
+index ranges and never allocates a slice. `parseValue` is built on it, and so
+are the three scanners in `@tamagui/web` (`contributeStyleString`,
+`resolveVariants`, `hasFlatModifier`). A consumer that needs a different answer
+writes a different handler, never a second pass.
+
+## The Rust LSP's tables are generated from here
+
+`code/lsp/crates/tamagui-grammar` is an editor transport for this grammar and
+never a second owner of what a modifier means, so its modifier tables and its
+conformance vectors are generated:
+
+```sh
+bun run generate:rust   # write src/generated.rs and tests/vectors.json
+bun run check:rust      # fail if what is on disk differs
+```
+
+`checks.yaml` runs `check:rust` and `cargo test --workspace` on every push. When
+you change a modifier name, an alias, a platform, or anything the parser
+decides, regenerate and commit both files with the change.

package/dist/cjs/ast/payloadShape.cjs

@@ -0,0 +1,68 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var payloadShape_exports = {};
+__export(payloadShape_exports, { validatePayloadShape: () => validatePayloadShape });
+module.exports = __toCommonJS(payloadShape_exports);
+var import_backgroundFamily = require("../shorthands/backgroundFamily.cjs");
+const listValuedLonghands = /* @__PURE__ */ new Set([
+	"boxShadow",
+	"textShadow",
+	"transform",
+	"transition",
+	"transitionProperty",
+	"animation",
+	"animationName",
+	"backgroundImage",
+	"backgroundPosition",
+	"backgroundSize",
+	"backgroundRepeat",
+	"fontFamily",
+	"fontVariant",
+	"filter",
+	"backdropFilter",
+	"willChange",
+	"quotes",
+	"textDecorationLine",
+	"containIntrinsicSize",
+	"strokeDasharray",
+	"gridTemplateColumns",
+	"gridTemplateRows",
+	"gridTemplateAreas",
+	"gridArea",
+	"gridColumn",
+	"gridRow",
+	"inset",
+	"mask",
+	"maskImage",
+	"maskPosition",
+	"maskSize"
+]);
+function validatePayloadShape(property, payload, hasBase) {
+	if (listValuedLonghands.has(property)) return null;
+	const components = (0, import_backgroundFamily.splitTopLevelComponents)(payload);
+	if (components.length <= 1) return null;
+	return {
+		code: "multi-component-single-value",
+		property,
+		payload,
+		message: `"${payload}" holds ${components.length} values but "${property}" takes one.` + (hasBase ? "" : ` A value written after a conditional joins that conditional's payload \u2014 write the base value before the first conditional.`)
+	};
+}

package/dist/cjs/ast/payloadShape.native.cjs

@@ -0,0 +1,70 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var payloadShape_exports = {};
+__export(payloadShape_exports, { validatePayloadShape: () => validatePayloadShape });
+module.exports = __toCommonJS(payloadShape_exports);
+var import_backgroundFamily = require("../shorthands/backgroundFamily.native.js");
+var listValuedLonghands = /* @__PURE__ */ new Set([
+	"boxShadow",
+	"textShadow",
+	"transform",
+	"transition",
+	"transitionProperty",
+	"animation",
+	"animationName",
+	"backgroundImage",
+	"backgroundPosition",
+	"backgroundSize",
+	"backgroundRepeat",
+	"fontFamily",
+	"fontVariant",
+	"filter",
+	"backdropFilter",
+	"willChange",
+	"quotes",
+	"textDecorationLine",
+	"containIntrinsicSize",
+	"strokeDasharray",
+	"gridTemplateColumns",
+	"gridTemplateRows",
+	"gridTemplateAreas",
+	"gridArea",
+	"gridColumn",
+	"gridRow",
+	"inset",
+	"mask",
+	"maskImage",
+	"maskPosition",
+	"maskSize"
+]);
+function validatePayloadShape(property, payload, hasBase) {
+	if (listValuedLonghands.has(property)) return null;
+	var components = (0, import_backgroundFamily.splitTopLevelComponents)(payload);
+	if (components.length <= 1) return null;
+	return {
+		code: "multi-component-single-value",
+		property,
+		payload,
+		message: `"${payload}" holds ${components.length} values but "${property}" takes one.` + (hasBase ? "" : ` A value written after a conditional joins that conditional's payload \u2014 write the base value before the first conditional.`)
+	};
+}

package/dist/cjs/ast/payloadShape.native.js

@@ -0,0 +1,72 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var payloadShape_exports = {};
+__export(payloadShape_exports, { validatePayloadShape: () => validatePayloadShape });
+module.exports = __toCommonJS(payloadShape_exports);
+var import_backgroundFamily = require("../shorthands/backgroundFamily.native.js");
+var listValuedLonghands = /* @__PURE__ */ new Set([
+	"boxShadow",
+	"textShadow",
+	"transform",
+	"transition",
+	"transitionProperty",
+	"animation",
+	"animationName",
+	"backgroundImage",
+	"backgroundPosition",
+	"backgroundSize",
+	"backgroundRepeat",
+	"fontFamily",
+	"fontVariant",
+	"filter",
+	"backdropFilter",
+	"willChange",
+	"quotes",
+	"textDecorationLine",
+	"containIntrinsicSize",
+	"strokeDasharray",
+	"gridTemplateColumns",
+	"gridTemplateRows",
+	"gridTemplateAreas",
+	"gridArea",
+	"gridColumn",
+	"gridRow",
+	"inset",
+	"mask",
+	"maskImage",
+	"maskPosition",
+	"maskSize"
+]);
+function validatePayloadShape(property, payload, hasBase) {
+	if (listValuedLonghands.has(property)) return null;
+	var components = (0, import_backgroundFamily.splitTopLevelComponents)(payload);
+	if (components.length <= 1) return null;
+	return {
+		code: "multi-component-single-value",
+		property,
+		payload,
+		message: `"${payload}" holds ${components.length} values but "${property}" takes one.` + (hasBase ? "" : ` A value written after a conditional joins that conditional's payload \u2014 write the base value before the first conditional.`)
+	};
+}
+
+//# sourceMappingURL=payloadShape.native.js.map

package/dist/cjs/ast/payloadShape.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloadShape.native.js","names":[],"sources":["cjs/ast/payloadShape.native.js"],"sourcesContent":["\"use strict\";\nvar __defProp = Object.defineProperty;\nvar __getOwnPropDesc = Object.getOwnPropertyDescriptor;\nvar __getOwnPropNames = Object.getOwnPropertyNames;\nvar __hasOwnProp = Object.prototype.hasOwnProperty;\nvar __export = (target, all) => {\n  for (var name in all)\n    __defProp(target, name, { get: all[name], enumerable: true });\n};\nvar __copyProps = (to, from, except, desc) => {\n  if (from && typeof from === \"object\" || typeof from === \"function\") {\n    for (let key of __getOwnPropNames(from))\n      if (!__hasOwnProp.call(to, key) && key !== except)\n        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });\n  }\n  return to;\n};\nvar __toCommonJS = (mod) => __copyProps(__defProp({}, \"__esModule\", { value: true }), mod);\nvar payloadShape_exports = {};\n__export(payloadShape_exports, {\n  validatePayloadShape: () => validatePayloadShape\n});\nmodule.exports = __toCommonJS(payloadShape_exports);\nvar import_backgroundFamily = require(\"../shorthands/backgroundFamily\");\nvar listValuedLonghands = /* @__PURE__ */ new Set([\n  \"boxShadow\",\n  \"textShadow\",\n  \"transform\",\n  \"transition\",\n  \"transitionProperty\",\n  \"animation\",\n  \"animationName\",\n  \"backgroundImage\",\n  \"backgroundPosition\",\n  \"backgroundSize\",\n  \"backgroundRepeat\",\n  \"fontFamily\",\n  \"fontVariant\",\n  \"filter\",\n  \"backdropFilter\",\n  \"willChange\",\n  \"quotes\",\n  \"textDecorationLine\",\n  \"containIntrinsicSize\",\n  \"strokeDasharray\",\n  \"gridTemplateColumns\",\n  \"gridTemplateRows\",\n  \"gridTemplateAreas\",\n  \"gridArea\",\n  \"gridColumn\",\n  \"gridRow\",\n  \"inset\",\n  \"mask\",\n  \"maskImage\",\n  \"maskPosition\",\n  \"maskSize\"\n]);\nfunction validatePayloadShape(property, payload, hasBase) {\n  if (listValuedLonghands.has(property)) return null;\n  var components = (0, import_backgroundFamily.splitTopLevelComponents)(payload);\n  if (components.length <= 1) return null;\n  return {\n    code: \"multi-component-single-value\",\n    property,\n    payload,\n    message: `\"${payload}\" holds ${components.length} values but \"${property}\" takes one.` + (hasBase ? \"\" : ` A value written after a conditional joins that conditional's payload \\u2014 write the base value before the first conditional.`)\n  };\n}\n//# sourceMappingURL=payloadShape.js.map\n"],"mappings":";;;AACA,IAAI,YAAY,OAAO;AACvB,IAAI,mBAAmB,OAAO;AAC9B,IAAI,oBAAoB,OAAO;AAC/B,IAAI,eAAe,OAAO,UAAU;AACpC,IAAI,YAAY,QAAQ,QAAQ;CAC9B,KAAK,IAAI,QAAQ,KACf,UAAU,QAAQ,MAAM;EAAE,KAAK,IAAI;EAAO,YAAY;CAAK,CAAC;AAChE;AACA,IAAI,eAAe,IAAI,MAAM,QAAQ,SAAS;CAC5C,IAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,SAAS,YAAY;EAClE,KAAK,IAAI,OAAO,kBAAkB,IAAI,GACpC,IAAI,CAAC,aAAa,KAAK,IAAI,GAAG,KAAK,QAAQ,QACzC,UAAU,IAAI,KAAK;GAAE,WAAW,KAAK;GAAM,YAAY,EAAE,OAAO,iBAAiB,MAAM,GAAG,MAAM,KAAK;EAAW,CAAC;CACvH;CACA,OAAO;AACT;AACA,IAAI,gBAAgB,QAAQ,YAAY,UAAU,CAAC,GAAG,cAAc,EAAE,OAAO,KAAK,CAAC,GAAG,GAAG;AACzF,IAAI,uBAAuB,CAAC;AAC5B,SAAS,sBAAsB,EAC7B,4BAA4B,qBAC9B,CAAC;AACD,OAAO,UAAU,aAAa,oBAAoB;AAClD,IAAI,0BAA0B,QAAQ,0CAAgC;AACtE,IAAI,sCAAsC,IAAI,IAAI;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,SAAS,qBAAqB,UAAU,SAAS,SAAS;CACxD,IAAI,oBAAoB,IAAI,QAAQ,GAAG,OAAO;CAC9C,IAAI,cAAc,GAAG,wBAAwB,wBAAuB,CAAE,OAAO;CAC7E,IAAI,WAAW,UAAU,GAAG,OAAO;CACnC,OAAO;EACL,MAAM;EACN;EACA;EACA,SAAS,IAAI,QAAQ,UAAU,WAAW,OAAO,eAAe,SAAS,iBAAiB,UAAU,KAAK;CAC3G;AACF"}

package/dist/cjs/ast/resolvePayload.cjs

@@ -0,0 +1,275 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var resolvePayload_exports = {};
+__export(resolvePayload_exports, {
+	resolvePayload: () => resolvePayload,
+	splitColorOpacitySuffix: () => import_colorOpacity.splitColorOpacitySuffix
+});
+module.exports = __toCommonJS(resolvePayload_exports);
+var import_valueTypes = require("./valueTypes.cjs");
+var import_colorOpacity = require("../runtime/colorOpacity.cjs");
+const reservedFolded = new Set(Array.from(import_valueTypes.reservedCssIdents, (ident) => ident.toLowerCase()));
+const noReferences = Object.freeze([]);
+const noErrors = Object.freeze([]);
+const CHAR_TAB = 9;
+const CHAR_LF = 10;
+const CHAR_FF = 12;
+const CHAR_CR = 13;
+const CHAR_SPACE = 32;
+const CHAR_PERCENT = 37;
+const CHAR_HASH = 35;
+const CHAR_DOUBLE_QUOTE = 34;
+const CHAR_SINGLE_QUOTE = 39;
+const CHAR_PAREN_OPEN = 40;
+const CHAR_PAREN_CLOSE = 41;
+const CHAR_PLUS = 43;
+const CHAR_COMMA = 44;
+const CHAR_MINUS = 45;
+const CHAR_DOT = 46;
+const CHAR_SLASH = 47;
+const CHAR_UNDERSCORE = 95;
+const CHAR_BACKSLASH = 92;
+const CHAR_E_LOWER = 101;
+const CHAR_E_UPPER = 69;
+function isWhitespace(code) {
+	return code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_FF;
+}
+function isDigit(code) {
+	return code >= 48 && code <= 57;
+}
+function isLetter(code) {
+	return code >= 97 && code <= 122 || code >= 65 && code <= 90;
+}
+function isIdentStart(code) {
+	return isLetter(code) || code === CHAR_UNDERSCORE || code === CHAR_MINUS || code === CHAR_BACKSLASH || code > 127;
+}
+function isIdentPart(code) {
+	return isIdentStart(code) || isDigit(code);
+}
+function isBoundary(code) {
+	return code === -1 || isWhitespace(code) || code === CHAR_COMMA || code === CHAR_PAREN_OPEN || code === CHAR_PAREN_CLOSE;
+}
+function resolvePayload(payload, options) {
+	const { lookup, resolveNumbers = false, onCandidate } = options;
+	const length = payload.length;
+	const segments = [];
+	let references = null;
+	let errors = null;
+	let staticStart = 0;
+	const codeAt = (index2) => index2 >= 0 && index2 < length ? payload.charCodeAt(index2) : -1;
+	const pushReference = (start, end, reference) => {
+		if (start > staticStart) segments.push(payload.slice(staticStart, start));
+		segments.push(reference);
+		(references ||= []).push(reference);
+		staticStart = end;
+	};
+	let index = 0;
+	while (index < length) {
+		const code = payload.charCodeAt(index);
+		if (code === CHAR_DOUBLE_QUOTE || code === CHAR_SINGLE_QUOTE) {
+			index++;
+			while (index < length) {
+				const inner = payload.charCodeAt(index);
+				if (inner === CHAR_BACKSLASH) index += 2;
+				else if (inner === code) {
+					index++;
+					break;
+				} else index++;
+			}
+			continue;
+		}
+		if (code === CHAR_HASH) {
+			const start = index;
+			index++;
+			while (index < length && isIdentPart(payload.charCodeAt(index))) index++;
+			onCandidate?.(start, index, payload.slice(start, index), void 0);
+			continue;
+		}
+		if (isIdentStart(code) && !(code === CHAR_MINUS && isDigit(codeAt(index + 1)))) {
+			const start = index;
+			let end = index;
+			while (end < length && isIdentPart(payload.charCodeAt(end))) {
+				end += payload.charCodeAt(end) === CHAR_BACKSLASH ? 2 : 1;
+			}
+			const name = payload.slice(start, Math.min(end, length));
+			if (codeAt(end) === CHAR_PAREN_OPEN) {
+				index = name.toLowerCase() === "url" ? skipParens(payload, end) : end + 1;
+				continue;
+			}
+			if (name.startsWith("--")) {
+				index = end;
+				continue;
+			}
+			const resolved = reservedFolded.has(name.toLowerCase()) ? void 0 : lookup(name);
+			const suffix = readOpacitySuffix(payload, end, codeAt);
+			if (suffix !== null && resolved?.kind === "color") {
+				if (suffix.percentage === null) {
+					;
+					(errors ||= []).push({
+						code: "opacity-out-of-range",
+						index: start,
+						message: `"${name}${payload.slice(end, suffix.end)}" is not an opacity suffix: it must be an integer percentage from 0 through 100`,
+						name,
+						opacity: Number(payload.slice(end + 1, suffix.end))
+					});
+					onCandidate?.(start, suffix.end, name, { ...resolved });
+					index = suffix.end;
+					continue;
+				}
+				const reference2 = suffix.percentage === 100 ? { ...resolved } : {
+					...resolved,
+					opacity: suffix.percentage
+				};
+				pushReference(start, suffix.end, reference2);
+				onCandidate?.(start, suffix.end, name, reference2);
+				index = suffix.end;
+				continue;
+			}
+			if (suffix !== null && suffix.percentage !== null) {
+				;
+				(errors ||= []).push({
+					code: "opacity-on-non-color",
+					index: start,
+					message: resolved ? `"${name}" is not a color token (kind: ${resolved.kind}), so the /${suffix.percentage} opacity suffix does not apply` : `"${name}" is not a resolved color token, so the /${suffix.percentage} opacity suffix does not apply`,
+					name,
+					opacity: suffix.percentage
+				});
+				onCandidate?.(start, end, name, resolved ? { ...resolved } : void 0);
+				index = suffix.end;
+				continue;
+			}
+			if (!resolved) {
+				onCandidate?.(start, end, name, void 0);
+				index = end;
+				continue;
+			}
+			const reference = { ...resolved };
+			pushReference(start, end, reference);
+			onCandidate?.(start, end, name, reference);
+			index = end;
+			continue;
+		}
+		if (isDigit(code) || code === CHAR_DOT || (code === CHAR_PLUS || code === CHAR_MINUS) && isDigit(codeAt(index + 1))) {
+			const start = index;
+			let end = index;
+			if (code === CHAR_PLUS || code === CHAR_MINUS) end++;
+			while (end < length) {
+				const digit = payload.charCodeAt(end);
+				if (isDigit(digit) || digit === CHAR_DOT) end++;
+				else break;
+			}
+			if (codeAt(end) === CHAR_E_LOWER || codeAt(end) === CHAR_E_UPPER) {
+				let exponent = end + 1;
+				if (codeAt(exponent) === CHAR_PLUS || codeAt(exponent) === CHAR_MINUS) exponent++;
+				if (isDigit(codeAt(exponent))) {
+					exponent++;
+					while (exponent < length && isDigit(payload.charCodeAt(exponent))) exponent++;
+					end = exponent;
+				}
+			}
+			const numberEnd = end;
+			let unitEnd = numberEnd;
+			if (codeAt(unitEnd) === CHAR_PERCENT) unitEnd++;
+			else while (unitEnd < length && isIdentPart(payload.charCodeAt(unitEnd))) unitEnd++;
+			if (unitEnd > numberEnd) {
+				index = unitEnd;
+				continue;
+			}
+			if (!resolveNumbers || !isBoundary(codeAt(start - 1)) || !isBoundary(codeAt(numberEnd))) {
+				index = numberEnd;
+				continue;
+			}
+			const name = payload.slice(start, numberEnd);
+			const resolved = lookup(name);
+			if (resolved) {
+				const reference = { ...resolved };
+				pushReference(start, numberEnd, reference);
+				onCandidate?.(start, numberEnd, name, reference);
+			} else {
+				onCandidate?.(start, numberEnd, name, void 0);
+			}
+			index = numberEnd;
+			continue;
+		}
+		index++;
+	}
+	if (staticStart < length) segments.push(payload.slice(staticStart));
+	return {
+		segments,
+		references: references ?? noReferences,
+		errors: errors ?? noErrors
+	};
+}
+function readOpacitySuffix(payload, identEnd, codeAt) {
+	if (codeAt(identEnd) !== CHAR_SLASH) return null;
+	let cursor = identEnd + 1;
+	let signed = false;
+	if (codeAt(cursor) === CHAR_MINUS || codeAt(cursor) === CHAR_PLUS) {
+		signed = true;
+		cursor++;
+	}
+	const digitsStart = cursor;
+	while (isDigit(codeAt(cursor))) cursor++;
+	if (cursor === digitsStart) return null;
+	let fractional = false;
+	if (codeAt(cursor) === CHAR_DOT && isDigit(codeAt(cursor + 1))) {
+		fractional = true;
+		cursor++;
+		while (isDigit(codeAt(cursor))) cursor++;
+	}
+	if (!isBoundary(codeAt(cursor))) return null;
+	const value = Number(payload.slice(identEnd + 1, cursor));
+	const valid = !signed && !fractional && value >= 0 && value <= 100;
+	return {
+		end: cursor,
+		percentage: valid ? value : null
+	};
+}
+function skipParens(payload, open) {
+	let depth = 0;
+	let index = open;
+	while (index < payload.length) {
+		const code = payload.charCodeAt(index);
+		if (code === CHAR_BACKSLASH) {
+			index += 2;
+			continue;
+		}
+		if (code === CHAR_DOUBLE_QUOTE || code === CHAR_SINGLE_QUOTE) {
+			index++;
+			while (index < payload.length) {
+				const inner = payload.charCodeAt(index);
+				if (inner === CHAR_BACKSLASH) index += 2;
+				else if (inner === code) {
+					index++;
+					break;
+				} else index++;
+			}
+			continue;
+		}
+		if (code === CHAR_PAREN_OPEN) depth++;
+		else if (code === CHAR_PAREN_CLOSE) {
+			depth--;
+			if (depth === 0) return index + 1;
+		}
+		index++;
+	}
+	return payload.length;
+}