@terrazzo/token-tools 0.7.3 → 0.8.0

package/dist/index.d.ts

@@ -1,6 +1,70 @@
-export * from './color.js';
-export * from './id.js';
-export * from './string.js';
-export * from './transform.js';
-export * from './types.js';
+import { AliasToken, AliasValue, BooleanToken, BooleanTokenNormalized, BooleanValue, BorderToken, BorderTokenNormalized, BorderValue, BorderValueNormalized, ColorSpace, ColorToken, ColorTokenNormalized, ColorValue, ColorValueNormalized, CubicBezierToken, CubicBezierTokenNormalized, CubicBezierValue, DimensionToken, DimensionTokenNormalized, DimensionValue, DurationToken, DurationTokenNormalized, DurationValue, FontFamilyToken, FontFamilyTokenNormalized, FontFamilyValue, FontFamilyValueNormalized, FontWeightToken, FontWeightTokenNormalized, FontWeightValue, FontWeightValueNormalized, GradientStop, GradientStopNormalized, GradientToken, GradientTokenNormalized, GradientValue, GradientValueNormalized, Group, GroupCore, GroupOrToken, LinkToken, LinkTokenNormalized, LinkValue, ModeMap, NumberToken, NumberTokenNormalized, NumberValue, ShadowToken, ShadowTokenNormalized, ShadowValue, ShadowValueNormalized, StringToken, StringTokenNormalized, StringValue, StrokeStyleToken, StrokeStyleTokenNormalized, StrokeStyleValue, StrokeStyleValueExpanded, Token, TokenCore, TokenMode, TokenNormalized, TokenNormalizedCore, TokenNormalizedSet, TokensSet, TransitionToken, TransitionTokenNormalized, TransitionValue, TransitionValueNormalized, TypographyToken, TypographyTokenNormalized, TypographyValue, TypographyValueNormalized } from "./types-C68LbU3N.js";
+import "culori/css";
+import { Color } from "culori/fn";
+
+//#region src/color.d.ts
+declare const CULORI_TO_CSS: Record<Extract<Color['mode'], 'a98' | 'lab' | 'lch' | 'oklab' | 'oklch' | 'hsl' | 'hsv' | 'hwb' | 'lrgb' | 'p3' | 'prophoto' | 'rec2020' | 'rgb' | 'xyz50' | 'xyz65'>, ColorSpace>;
+declare const CSS_TO_CULORI: {
+  readonly a98: "a98";
+  readonly 'display-p3': "p3";
+  readonly hsl: "hsl";
+  readonly hsv: "hsv";
+  readonly hwb: "hwb";
+  readonly lab: "lab";
+  readonly lch: "lch";
+  readonly oklab: "oklab";
+  readonly oklch: "oklch";
+  readonly 'prophoto-rgb': "prophoto";
+  readonly rec2020: "rec2020";
+  readonly srgb: "rgb";
+  readonly 'srgb-linear': "lrgb";
+  readonly 'xyz-d50': "xyz50";
+  readonly 'xyz-d65': "xyz65";
+};
+/** Parse any color */
+declare function parseColor(color: string): ColorValueNormalized;
+/** Convert a color token to a Culori color */
+declare function tokenToCulori(value: ColorValueNormalized): Color | undefined;
+//# sourceMappingURL=color.d.ts.map
+//#endregion
+//#region src/id.d.ts
+/** Is this token an alias of another? */
+declare function isAlias(value: string): boolean;
+/** Match token against globs */
+declare function isTokenMatch(tokenID: string, globPatterns: string[]): boolean;
+/** Same as isTokenMatch but returns the matching pattern */
+declare function getTokenMatch(tokenId: string, globPatterns: string[]): string | undefined;
+/** Make an alias */
+declare function makeAlias(input: string): string;
+/** Parse an alias */
+declare function parseAlias(input: string): string;
+/** split a token ID into a local ID and group ID */
+declare function splitID(id: string): {
+  local: string;
+  group?: string;
+};
+//# sourceMappingURL=id.d.ts.map
+//#endregion
+//#region src/string.d.ts
+/** Pad string lengths */
+declare function padStr(input: string, length: number, alignment?: 'left' | 'center' | 'right'): string;
+/** Pluralize strings */
+declare function pluralize<T = string>(count: number, singular: T, plural: T): T;
+/** Turn a string into kebab-case */
+declare function kebabCase(str: string): string;
+//# sourceMappingURL=string.d.ts.map
+//#endregion
+//#region src/transform.d.ts
+interface CustomTransformOptions {
+  /** Token $type */
+  $type: string;
+}
+/** Give a user pertinent feedback if they override a transform incorrectly */
+declare function validateCustomTransform(value: unknown, {
+  $type
+}: CustomTransformOptions): void;
+//# sourceMappingURL=transform.d.ts.map
+
+//#endregion
+export { AliasToken, AliasValue, BooleanToken, BooleanTokenNormalized, BooleanValue, BorderToken, BorderTokenNormalized, BorderValue, BorderValueNormalized, CSS_TO_CULORI, CULORI_TO_CSS, ColorSpace, ColorToken, ColorTokenNormalized, ColorValue, ColorValueNormalized, CubicBezierToken, CubicBezierTokenNormalized, CubicBezierValue, CustomTransformOptions, DimensionToken, DimensionTokenNormalized, DimensionValue, DurationToken, DurationTokenNormalized, DurationValue, FontFamilyToken, FontFamilyTokenNormalized, FontFamilyValue, FontFamilyValueNormalized, FontWeightToken, FontWeightTokenNormalized, FontWeightValue, FontWeightValueNormalized, GradientStop, GradientStopNormalized, GradientToken, GradientTokenNormalized, GradientValue, GradientValueNormalized, Group, GroupCore, GroupOrToken, LinkToken, LinkTokenNormalized, LinkValue, ModeMap, NumberToken, NumberTokenNormalized, NumberValue, ShadowToken, ShadowTokenNormalized, ShadowValue, ShadowValueNormalized, StringToken, StringTokenNormalized, StringValue, StrokeStyleToken, StrokeStyleTokenNormalized, StrokeStyleValue, StrokeStyleValueExpanded, Token, TokenCore, TokenMode, TokenNormalized, TokenNormalizedCore, TokenNormalizedSet, TokensSet, TransitionToken, TransitionTokenNormalized, TransitionValue, TransitionValueNormalized, TypographyToken, TypographyTokenNormalized, TypographyValue, TypographyValueNormalized, getTokenMatch, isAlias, isTokenMatch, kebabCase, makeAlias, padStr, parseAlias, parseColor, pluralize, splitID, tokenToCulori, validateCustomTransform };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/color.ts","../src/id.ts","../src/string.ts","../src/transform.ts"],"sourcesContent":[],"mappings":";;;;;cAMa,eAAe,OAC1B,QACE,wJAiBF;cAmBW;EAtCA,SAAA,GAAA,EAAA,KAoCH;EAAA,SAAA,YAAA,EAAA,IAAA;EAAA,SAlCN,GAAA,EAAA,KAAA;EAAK,SADP,GAAA,EAAA,KAAA;EAAO,SAkBP,GAAA,EAAA,KAAA;EAAU,SAnBgB,GAAA,EAAA,KAAA;EAAM,SAAA,GAAA,EAAA,KAAA;EAsCrB,SAAA,KAAA,EAgBH,OAAA;EAGM,SAAA,KAAU,EAAA,OAAA;EA8DV,SAAA,cAAa,EAAA,UAAA;EAAA,SAAA,OAAA,EAAA,SAAA;EAAA,SAAQ,IAAA,EAAA,KAAA;EAAoB,SAAG,aAAA,EAAA,MAAA;EAAK,SAAA,SAAA,EAAA,OAAA;;;;ACxHjD,iBD0DA,UAAA,CC1DO,KAAA,EAAA,MAAA,CAAA,ED0DoB,oBC1DpB;AAKvB;AAKgB,iBD8GA,aAAA,CC9Ga,KAAA,ED8GQ,oBC9GR,CAAA,ED8G+B,KC9G/B,GAAA,SAAA;AAS7B;;;;iBAnBgB,OAAA;;iBAKA,YAAA;;ADJH,iBCSG,aAAA,CD2BN,OAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,CAAA,EAAA,MAAA,GAAA,SAAA;;AAlCN,iBCgBY,SAAA,CDhBZ,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;AAiBF,iBCIc,UAAA,CDJd,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;AAnBgC,iBCsClB,OAAA,CDtCkB,EAAA,EAAA,MAAA,CAAA,EAAA;EAsCrB,KAAA,EAAA,MAAA;EAmBG,KAAA,CAAA,EAAA,MAAU;AA8D1B,CAAA;;;;;iBE5HgB,MAAA;;iBAuBA,+CAA+C,WAAW,IAAI;;AFlBjE,iBEuBG,SAAA,CFaN,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;;UG1CO,sBAAA;;;;;AHMJ,iBGAG,uBAAA,CHoCN,KAAA,EAAA,OAAA,EAAA;EAAA;AAAA,CAAA,EGpCyD,sBHoCzD,CAAA,EAAA,IAAA"}

package/dist/index.js

@@ -1,30 +1,56 @@
-/**
- * @module @terrazzo/token-tools
- * @license MIT License
- * 
- * Copyright (c) 2021 Drew Powers
- * 
- * 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.
- */
-export * from './color.js';
-export * from './id.js';
-export * from './string.js';
-export * from './transform.js';
-export * from './types.js';
+import { CSS_TO_CULORI, CULORI_TO_CSS, kebabCase, padStr, parseColor, pluralize, tokenToCulori } from "./string-BZ5Le1WD.js";
+import wcmatch from "wildcard-match";
+
+//#region src/id.ts
+const ALIAS_RE = /^\{([^}]+)\}$/;
+/** Is this token an alias of another? */
+function isAlias(value) {
+	return ALIAS_RE.test(value);
+}
+/** Match token against globs */
+function isTokenMatch(tokenID, globPatterns) {
+	return wcmatch(globPatterns)(tokenID);
+}
+/** Same as isTokenMatch but returns the matching pattern */
+function getTokenMatch(tokenId, globPatterns) {
+	for (const pattern of globPatterns) if (wcmatch(pattern)(tokenId)) return pattern;
+}
+/** Make an alias */
+function makeAlias(input) {
+	return input.replace(/^\{?([^}]+)\}?$/, "{$1}");
+}
+/** Parse an alias */
+function parseAlias(input) {
+	if (input.includes("#")) throw new Error("Mode aliases (# character) are no longer supported as of v0.6.0. Alias the root token instead, and apply modes in plugins.");
+	const match = input.match(ALIAS_RE);
+	if (!match) return input;
+	return match[1] ?? match[0];
+}
+/** split a token ID into a local ID and group ID */
+function splitID(id) {
+	const lastSeparatorI = id.lastIndexOf(".");
+	if (lastSeparatorI === -1) return { local: id };
+	return {
+		local: id.substring(lastSeparatorI + 1),
+		group: id.substring(0, lastSeparatorI)
+	};
+}
+
+//#endregion
+//#region src/transform.ts
+/** Give a user pertinent feedback if they override a transform incorrectly */
+function validateCustomTransform(value, { $type }) {
+	if (value) {
+		if (typeof value !== "string" && typeof value !== "object" || Array.isArray(value)) throw new Error(`transform(): expected string or Object of strings, received ${Array.isArray(value) ? "Array" : typeof value}`);
+		switch ($type) {
+			case "typography": {
+				if (typeof value !== "object") throw new Error("transform(): typography tokens must be an object of keys");
+				break;
+			}
+		}
+	}
+}
+
+//#endregion
+export { CSS_TO_CULORI, CULORI_TO_CSS, getTokenMatch, isAlias, isTokenMatch, kebabCase, makeAlias, padStr, parseAlias, parseColor, pluralize, splitID, tokenToCulori, validateCustomTransform };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","names":["value: string","tokenID: string","globPatterns: string[]","tokenId: string","input: string","id: string","value: unknown"],"sources":["../src/id.ts","../src/transform.ts"],"sourcesContent":["import wcmatch from 'wildcard-match';\n\nconst ALIAS_RE = /^\\{([^}]+)\\}$/;\n\n/** Is this token an alias of another? */\nexport function isAlias(value: string): boolean {\n  return ALIAS_RE.test(value);\n}\n\n/** Match token against globs */\nexport function isTokenMatch(tokenID: string, globPatterns: string[]): boolean {\n  return wcmatch(globPatterns)(tokenID);\n}\n\n/** Same as isTokenMatch but returns the matching pattern */\nexport function getTokenMatch(tokenId: string, globPatterns: string[]): string | undefined {\n  for (const pattern of globPatterns) {\n    if (wcmatch(pattern)(tokenId)) {\n      return pattern;\n    }\n  }\n}\n\n/** Make an alias */\nexport function makeAlias(input: string): string {\n  return input.replace(/^\\{?([^}]+)\\}?$/, '{$1}');\n}\n\n/** Parse an alias */\nexport function parseAlias(input: string): string {\n  // TODO: deprecate in future\n  if (input.includes('#')) {\n    throw new Error(\n      'Mode aliases (# character) are no longer supported as of v0.6.0. Alias the root token instead, and apply modes in plugins.',\n    );\n  }\n  const match = input.match(ALIAS_RE);\n  if (!match) {\n    return input;\n  }\n  return match[1] ?? match[0];\n}\n\n/** split a token ID into a local ID and group ID */\nexport function splitID(id: string): { local: string; group?: string } {\n  const lastSeparatorI = id.lastIndexOf('.');\n  if (lastSeparatorI === -1) {\n    return { local: id };\n  }\n  return {\n    local: id.substring(lastSeparatorI + 1),\n    group: id.substring(0, lastSeparatorI),\n  };\n}\n","export interface CustomTransformOptions {\n  /** Token $type */\n  $type: string;\n}\n\n/** Give a user pertinent feedback if they override a transform incorrectly */\nexport function validateCustomTransform(value: unknown, { $type }: CustomTransformOptions) {\n  if (value) {\n    if ((typeof value !== 'string' && typeof value !== 'object') || Array.isArray(value)) {\n      throw new Error(\n        `transform(): expected string or Object of strings, received ${Array.isArray(value) ? 'Array' : typeof value}`,\n      );\n    }\n    switch ($type) {\n      case 'typography': {\n        if (typeof value !== 'object') {\n          throw new Error('transform(): typography tokens must be an object of keys');\n        }\n        break;\n      }\n    }\n  }\n}\n"],"mappings":";;;;AAEA,MAAM,WAAW;;AAGjB,SAAgB,QAAQA,OAAwB;AAC9C,QAAO,SAAS,KAAK,MAAM;AAC5B;;AAGD,SAAgB,aAAaC,SAAiBC,cAAiC;AAC7E,QAAO,QAAQ,aAAa,CAAC,QAAQ;AACtC;;AAGD,SAAgB,cAAcC,SAAiBD,cAA4C;AACzF,MAAK,MAAM,WAAW,aACpB,KAAI,QAAQ,QAAQ,CAAC,QAAQ,CAC3B,QAAO;AAGZ;;AAGD,SAAgB,UAAUE,OAAuB;AAC/C,QAAO,MAAM,QAAQ,mBAAmB,OAAO;AAChD;;AAGD,SAAgB,WAAWA,OAAuB;AAEhD,KAAI,MAAM,SAAS,IAAI,CACrB,OAAM,IAAI,MACR;CAGJ,MAAM,QAAQ,MAAM,MAAM,SAAS;AACnC,MAAK,MACH,QAAO;AAET,QAAO,MAAM,MAAM,MAAM;AAC1B;;AAGD,SAAgB,QAAQC,IAA+C;CACrE,MAAM,iBAAiB,GAAG,YAAY,IAAI;AAC1C,KAAI,mBAAmB,GACrB,QAAO,EAAE,OAAO,GAAI;AAEtB,QAAO;EACL,OAAO,GAAG,UAAU,iBAAiB,EAAE;EACvC,OAAO,GAAG,UAAU,GAAG,eAAe;CACvC;AACF;;;;;AC/CD,SAAgB,wBAAwBC,OAAgB,EAAE,OAA+B,EAAE;AACzF,KAAI,OAAO;AACT,aAAY,UAAU,mBAAmB,UAAU,YAAa,MAAM,QAAQ,MAAM,CAClF,OAAM,IAAI,OACP,8DAA8D,MAAM,QAAQ,MAAM,GAAG,iBAAiB,MAAM;AAGjH,UAAQ,OAAR;GACE,KAAK,cAAc;AACjB,eAAW,UAAU,SACnB,OAAM,IAAI,MAAM;AAElB;GACD;EACF;CACF;AACF"}

package/dist/js.d.ts

@@ -0,0 +1,23 @@
+import { TokenNormalized } from "./types-C68LbU3N.js";
+
+//#region src/js/index.d.ts
+interface TransformJSValueOptions {
+  mode: string;
+  /** indent space count */
+  indent?: number;
+  /** initial indent level */
+  startingIndent?: number;
+}
+/**
+ * Convert token value to a JS string via acorn/astring.
+ */
+declare function transformJSValue<T extends TokenNormalized>(token: T, {
+  mode,
+  indent,
+  startingIndent
+}: TransformJSValueOptions): string | undefined;
+//# sourceMappingURL=index.d.ts.map
+
+//#endregion
+export { TransformJSValueOptions, transformJSValue };
+//# sourceMappingURL=js.d.ts.map

package/dist/js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.d.ts","names":[],"sources":["../src/js/index.ts"],"sourcesContent":[],"mappings":";;;UAEiB,uBAAA;;EAAA;EAWD,MAAA,CAAA,EAAA,MAAA;EAAgB;EAAA,cAAW,CAAA,EAAA,MAAA;;;;;AAEC,iBAF5B,gBAE4B,CAAA,UAFD,eAEC,CAAA,CAAA,KAAA,EADnC,CACmC,EAAA;EAAA,IAAA;EAAA,MAAA;EAAA;AAAA,CAAA,EAAA,uBAAA,CAAA,EAAA,MAAA,GAAA,SAAA;AAAuB"}

package/dist/js.js

@@ -0,0 +1,13 @@
+//#region src/js/index.ts
+/**
+* Convert token value to a JS string via acorn/astring.
+*/
+function transformJSValue(token, { mode, indent = 2, startingIndent = 0 }) {
+	if (!(mode in token.mode)) return;
+	const indentStart = startingIndent > 0 ? " ".repeat(startingIndent ?? 2) : "";
+	return JSON.stringify(token.mode[mode].$value, void 0, indent).replace(/\n/g, `\n${indentStart}`);
+}
+
+//#endregion
+export { transformJSValue };
+//# sourceMappingURL=js.js.map

package/dist/js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.js","names":["token: T"],"sources":["../src/js/index.ts"],"sourcesContent":["import type { TokenNormalized } from '../types.js';\n\nexport interface TransformJSValueOptions {\n  mode: string;\n  /** indent space count */\n  indent?: number;\n  /** initial indent level */\n  startingIndent?: number;\n}\n\n/**\n * Convert token value to a JS string via acorn/astring.\n */\nexport function transformJSValue<T extends TokenNormalized>(\n  token: T,\n  { mode, indent = 2, startingIndent = 0 }: TransformJSValueOptions,\n) {\n  if (!(mode in token.mode)) {\n    return;\n  }\n  const indentStart = startingIndent > 0 ? ' '.repeat(startingIndent ?? 2) : '';\n\n  // note: since tokens are JSON-serializable to begin with, using\n  // JSON.stringify generates the same output as an AST parser/generator would\n  // but faster and without the added overhead (even acorn/astring leave object\n  // keys quoted).\n\n  // TODO: use @biomejs/js-api when it’s stable for pretty formatting\n\n  return JSON.stringify(token.mode[mode]!.$value, undefined, indent).replace(/\\n/g, `\\n${indentStart}`);\n}\n"],"mappings":";;;;AAaA,SAAgB,iBACdA,OACA,EAAE,MAAM,SAAS,GAAG,iBAAiB,GAA4B,EACjE;AACA,OAAM,QAAQ,MAAM,MAClB;CAEF,MAAM,cAAc,iBAAiB,IAAI,IAAI,OAAO,kBAAkB,EAAE,GAAG;AAS3E,QAAO,KAAK,UAAU,MAAM,KAAK,MAAO,gBAAmB,OAAO,CAAC,QAAQ,QAAQ,IAAI,YAAY,EAAE;AACtG"}

package/dist/string-BZ5Le1WD.js

@@ -0,0 +1,259 @@
+import "culori/css";
+import { formatHex, parse } from "culori/fn";
+
+//#region src/color.ts
+const HEX_RE = /^#?([0-9a-f]{8}|[0-9a-f]{6}|[0-9a-f]{4}|[0-9a-f]{3})$/i;
+const CULORI_TO_CSS = {
+	a98: "a98",
+	hsl: "hsl",
+	hsv: "hsv",
+	hwb: "hwb",
+	lab: "lab",
+	lch: "lch",
+	lrgb: "srgb-linear",
+	oklab: "oklab",
+	oklch: "oklch",
+	p3: "display-p3",
+	prophoto: "prophoto-rgb",
+	rec2020: "rec2020",
+	rgb: "srgb",
+	xyz50: "xyz-d50",
+	xyz65: "xyz-d65"
+};
+const CSS_TO_CULORI = {
+	a98: "a98",
+	"display-p3": "p3",
+	hsl: "hsl",
+	hsv: "hsv",
+	hwb: "hwb",
+	lab: "lab",
+	lch: "lch",
+	oklab: "oklab",
+	oklch: "oklch",
+	"prophoto-rgb": "prophoto",
+	rec2020: "rec2020",
+	srgb: "rgb",
+	"srgb-linear": "lrgb",
+	"xyz-d50": "xyz50",
+	"xyz-d65": "xyz65"
+};
+/** Parse any color */
+function parseColor(color) {
+	const result = parse(color);
+	if (!result) throw new Error(`Unable to parse color "${color}"`);
+	if (!(result.mode in CULORI_TO_CSS)) throw new Error(`Unsupported color space: ${result.mode}`);
+	const colorSpace = CULORI_TO_CSS[result.mode];
+	let components = [
+		0,
+		0,
+		0
+	];
+	switch (result.mode) {
+		case "a98":
+		case "rec2020":
+		case "p3":
+		case "prophoto":
+		case "lrgb":
+		case "rgb": {
+			components = [
+				result.r,
+				result.g,
+				result.b
+			];
+			break;
+		}
+		case "hsl": {
+			components = [
+				result.h ?? 0,
+				result.s,
+				result.l
+			];
+			break;
+		}
+		case "hsv": {
+			components = [
+				result.h ?? 0,
+				result.s,
+				result.v
+			];
+			break;
+		}
+		case "hwb": {
+			components = [
+				result.h ?? 0,
+				result.w,
+				result.b
+			];
+			break;
+		}
+		case "lab":
+		case "oklab": {
+			components = [
+				result.l,
+				result.a,
+				result.b
+			];
+			break;
+		}
+		case "lch":
+		case "oklch": {
+			components = [
+				result.l,
+				result.c,
+				result.h ?? 0
+			];
+			break;
+		}
+		case "xyz50":
+		case "xyz65": {
+			components = [
+				result.x,
+				result.y,
+				result.z
+			];
+			break;
+		}
+	}
+	const value = {
+		colorSpace,
+		components,
+		alpha: result.alpha ?? 1
+	};
+	if (HEX_RE.test(color)) value.hex = formatHex(result);
+	return value;
+}
+/** Convert a color token to a Culori color */
+function tokenToCulori(value) {
+	switch (value.colorSpace) {
+		case "a98":
+		case "display-p3":
+		case "prophoto-rgb":
+		case "rec2020":
+		case "srgb":
+		case "srgb-linear": {
+			const [r, g, b] = value.components;
+			return {
+				mode: CSS_TO_CULORI[value.colorSpace] || value.colorSpace,
+				r,
+				g,
+				b,
+				alpha: value.alpha
+			};
+		}
+		case "hsl": {
+			const [h, s, l] = value.components;
+			return {
+				mode: "hsl",
+				h,
+				s,
+				l,
+				alpha: value.alpha
+			};
+		}
+		case "hsv": {
+			const [h, s, v] = value.components;
+			return {
+				mode: "hsv",
+				h,
+				s,
+				v,
+				alpha: value.alpha
+			};
+		}
+		case "hwb": {
+			const [h, w, b] = value.components;
+			return {
+				mode: "hwb",
+				h,
+				w,
+				b,
+				alpha: value.alpha
+			};
+		}
+		case "lab":
+		case "oklab": {
+			const [l, a, b] = value.components;
+			return {
+				mode: value.colorSpace,
+				l,
+				a,
+				b,
+				alpha: value.alpha
+			};
+		}
+		case "lch":
+		case "oklch": {
+			const [l, c, h] = value.components;
+			return {
+				mode: value.colorSpace,
+				l,
+				c,
+				h,
+				alpha: value.alpha
+			};
+		}
+		case "xyz-d50": {
+			const [x, y, z] = value.components;
+			return {
+				mode: "xyz50",
+				x,
+				y,
+				z,
+				alpha: value.alpha
+			};
+		}
+		case "xyz-d65": {
+			const [x, y, z] = value.components;
+			return {
+				mode: "xyz65",
+				x,
+				y,
+				z,
+				alpha: value.alpha
+			};
+		}
+	}
+}
+
+//#endregion
+//#region src/string.ts
+/** Pad string lengths */
+function padStr(input, length, alignment = "left") {
+	const d = Math.min(length || 0, 1e3) - input.length;
+	if (d > 0) switch (alignment) {
+		case "left": return `${input}${" ".repeat(d)}`;
+		case "right": return `${" ".repeat(d)}${input}`;
+		case "center": {
+			const left = Math.floor(d / 2);
+			const right = d - left;
+			return `${" ".repeat(left)}${input}${" ".repeat(right)}`;
+		}
+	}
+	return input;
+}
+/** Pluralize strings */
+function pluralize(count, singular, plural) {
+	return count === 1 ? singular : plural;
+}
+/** Turn a string into kebab-case */
+function kebabCase(str) {
+	let output = "";
+	for (const c of str.split("")) {
+		if (c === ".") {
+			output += "-";
+			continue;
+		}
+		let isFirstUppercase = true;
+		if (isFirstUppercase && /\p{Uppercase_Letter}/u.test(c)) {
+			output += `-${c.toLocaleLowerCase()}`;
+			isFirstUppercase = false;
+			continue;
+		} else isFirstUppercase = true;
+		output += c;
+	}
+	return output;
+}
+
+//#endregion
+export { CSS_TO_CULORI, CULORI_TO_CSS, kebabCase, padStr, parseColor, pluralize, tokenToCulori };
+//# sourceMappingURL=string-BZ5Le1WD.js.map

package/dist/string-BZ5Le1WD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-BZ5Le1WD.js","names":["CULORI_TO_CSS: Record<\n  Extract<\n    Color['mode'],\n    | 'a98'\n    | 'lab'\n    | 'lch'\n    | 'oklab'\n    | 'oklch'\n    | 'hsl'\n    | 'hsv'\n    | 'hwb'\n    | 'lrgb'\n    | 'p3'\n    | 'prophoto'\n    | 'rec2020'\n    | 'rgb'\n    | 'xyz50'\n    | 'xyz65'\n  >,\n  ColorSpace\n>","color: string","components: [number, number, number]","value: ColorValueNormalized","input: string","length: number","alignment: 'left' | 'center' | 'right'","count: number","singular: T","plural: T","str: string"],"sources":["../src/color.ts","../src/string.ts"],"sourcesContent":["import 'culori/css';\nimport { type Color, formatHex, parse } from 'culori/fn';\nimport type { ColorSpace, ColorValueNormalized } from './types.js';\n\nconst HEX_RE = /^#?([0-9a-f]{8}|[0-9a-f]{6}|[0-9a-f]{4}|[0-9a-f]{3})$/i;\n\nexport const CULORI_TO_CSS: Record<\n  Extract<\n    Color['mode'],\n    | 'a98'\n    | 'lab'\n    | 'lch'\n    | 'oklab'\n    | 'oklch'\n    | 'hsl'\n    | 'hsv'\n    | 'hwb'\n    | 'lrgb'\n    | 'p3'\n    | 'prophoto'\n    | 'rec2020'\n    | 'rgb'\n    | 'xyz50'\n    | 'xyz65'\n  >,\n  ColorSpace\n> = {\n  a98: 'a98',\n  hsl: 'hsl',\n  hsv: 'hsv',\n  hwb: 'hwb',\n  lab: 'lab',\n  lch: 'lch',\n  lrgb: 'srgb-linear',\n  oklab: 'oklab',\n  oklch: 'oklch',\n  p3: 'display-p3',\n  prophoto: 'prophoto-rgb',\n  rec2020: 'rec2020',\n  rgb: 'srgb',\n  xyz50: 'xyz-d50',\n  xyz65: 'xyz-d65',\n} as const;\n\nexport const CSS_TO_CULORI = {\n  a98: 'a98',\n  'display-p3': 'p3',\n  hsl: 'hsl',\n  hsv: 'hsv',\n  hwb: 'hwb',\n  lab: 'lab',\n  lch: 'lch',\n  oklab: 'oklab',\n  oklch: 'oklch',\n  'prophoto-rgb': 'prophoto',\n  rec2020: 'rec2020',\n  srgb: 'rgb',\n  'srgb-linear': 'lrgb',\n  'xyz-d50': 'xyz50',\n  'xyz-d65': 'xyz65',\n} as const;\n\n/** Parse any color */\nexport function parseColor(color: string): ColorValueNormalized {\n  const result = parse(color);\n  if (!result) {\n    throw new Error(`Unable to parse color \"${color}\"`);\n  }\n  if (!(result.mode in CULORI_TO_CSS)) {\n    throw new Error(`Unsupported color space: ${result.mode}`);\n  }\n  const colorSpace = CULORI_TO_CSS[result.mode as keyof typeof CULORI_TO_CSS]!;\n  let components: [number, number, number] = [0, 0, 0];\n  switch (result.mode) {\n    case 'a98':\n    case 'rec2020':\n    case 'p3':\n    case 'prophoto':\n    case 'lrgb':\n    case 'rgb': {\n      components = [result.r, result.g, result.b];\n      break;\n    }\n    case 'hsl': {\n      components = [result.h ?? 0, result.s, result.l];\n      break;\n    }\n    case 'hsv': {\n      components = [result.h ?? 0, result.s, result.v];\n      break;\n    }\n    case 'hwb': {\n      components = [result.h ?? 0, result.w, result.b];\n      break;\n    }\n    case 'lab':\n    case 'oklab': {\n      components = [result.l, result.a, result.b];\n      break;\n    }\n    case 'lch':\n    case 'oklch': {\n      components = [result.l, result.c, result.h ?? 0];\n      break;\n    }\n    case 'xyz50':\n    case 'xyz65': {\n      components = [result.x, result.y, result.z];\n      break;\n    }\n  }\n  const value: ColorValueNormalized = {\n    colorSpace,\n    components,\n    alpha: result.alpha ?? 1,\n  };\n  if (HEX_RE.test(color)) {\n    // Note: this intentionally does NOT include alpha; it’s already in alpha.\n    // Always use formatHex (not formatHex8).\n    value.hex = formatHex(result);\n  }\n  return value;\n}\n\n/** Convert a color token to a Culori color */\nexport function tokenToCulori(value: ColorValueNormalized): Color | undefined {\n  switch (value.colorSpace) {\n    case 'a98':\n    case 'display-p3':\n    case 'prophoto-rgb':\n    case 'rec2020':\n    case 'srgb':\n    case 'srgb-linear': {\n      const [r, g, b] = value.components;\n      return {\n        mode: CSS_TO_CULORI[value.colorSpace] || value.colorSpace,\n        r,\n        g,\n        b,\n        alpha: value.alpha,\n      } as Color;\n    }\n    case 'hsl': {\n      const [h, s, l] = value.components;\n      return { mode: 'hsl', h, s, l, alpha: value.alpha };\n    }\n    case 'hsv': {\n      const [h, s, v] = value.components;\n      return { mode: 'hsv', h, s, v, alpha: value.alpha };\n    }\n    case 'hwb': {\n      const [h, w, b] = value.components;\n      return { mode: 'hwb', h, w, b, alpha: value.alpha };\n    }\n    case 'lab':\n    case 'oklab': {\n      const [l, a, b] = value.components;\n      return { mode: value.colorSpace, l, a, b, alpha: value.alpha };\n    }\n    case 'lch':\n    case 'oklch': {\n      const [l, c, h] = value.components;\n      return { mode: value.colorSpace, l, c, h, alpha: value.alpha };\n    }\n    case 'xyz-d50': {\n      const [x, y, z] = value.components;\n      return { mode: 'xyz50', x, y, z, alpha: value.alpha };\n    }\n    case 'xyz-d65': {\n      const [x, y, z] = value.components;\n      return { mode: 'xyz65', x, y, z, alpha: value.alpha };\n    }\n  }\n}\n","/** Pad string lengths */\nexport function padStr(input: string, length: number, alignment: 'left' | 'center' | 'right' = 'left'): string {\n  const d =\n    Math.min(length || 0, 1000) - // guard against NaNs and Infinity\n    input.length;\n  if (d > 0) {\n    switch (alignment) {\n      case 'left': {\n        return `${input}${' '.repeat(d)}`;\n      }\n      case 'right': {\n        return `${' '.repeat(d)}${input}`;\n      }\n      case 'center': {\n        const left = Math.floor(d / 2);\n        const right = d - left;\n        return `${' '.repeat(left)}${input}${' '.repeat(right)}`;\n      }\n    }\n  }\n  return input;\n}\n\n/** Pluralize strings */\nexport function pluralize<T = string>(count: number, singular: T, plural: T): T {\n  return count === 1 ? singular : plural;\n}\n\n/** Turn a string into kebab-case */\nexport function kebabCase(str: string): string {\n  let output = '';\n  for (const c of str.split('')) {\n    if (c === '.') {\n      output += '-';\n      continue;\n    }\n    let isFirstUppercase = true;\n    if (isFirstUppercase && /\\p{Uppercase_Letter}/u.test(c)) {\n      output += `-${c.toLocaleLowerCase()}`;\n      isFirstUppercase = false; // don’t break apart multiple consecutive uppercase letters\n      continue;\n    } else {\n      isFirstUppercase = true; // reset\n    }\n\n    output += c;\n  }\n  return output;\n}\n"],"mappings":"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"}