@terrazzo/token-tools 0.0.0

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @module @cobalt-ui/core
+ * @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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/string.d.ts

@@ -0,0 +1,4 @@
+/** Pad string lengths */
+export declare function padStr(input: string, length: number, alignment?: 'left' | 'center' | 'right'): string;
+/** Pluralize strings */
+export declare function pluralize<T = string>(count: number, singular: T, plural: T): T;

package/dist/string.js

@@ -0,0 +1,26 @@
+/** Pad string lengths */
+export function padStr(input, length, alignment = 'left') {
+    const d = Math.min(length || 0, 1000) - // guard against NaNs and Infinity
+        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 */
+export function pluralize(count, singular, plural) {
+    return count === 1 ? singular : plural;
+}
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,MAAc,EAAE,YAAyC,MAAM;IACnG,MAAM,CAAC,GACL,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,kCAAkC;QAChE,KAAK,CAAC,MAAM,CAAC;IACf,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;YACpC,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;gBACvB,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAa,KAAa,EAAE,QAAW,EAAE,MAAS;IACzE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@terrazzo/token-tools",
+  "description": "Various utilities for token types",
+  "version": "0.0.0",
+  "author": {
+    "name": "Drew Powers",
+    "email": "drew@pow.rs"
+  },
+  "keywords": [
+    "design tokens",
+    "design tokens community group",
+    "design tokens format module",
+    "dtcg",
+    "cli",
+    "w3c design tokens",
+    "design system",
+    "typescript",
+    "sass",
+    "css",
+    "style tokens",
+    "style system",
+    "linting",
+    "lint"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./css": "./dist/css/index.js",
+    "./*": "./*"
+  },
+  "dependencies": {
+    "@types/culori": "^2.1.0",
+    "culori": "^4.0.1",
+    "scule": "^1.3.0",
+    "wildcard-match": "^5.1.3"
+  },
+  "scripts": {
+    "build": "pnpm run build:clean && pnpm run build:ts && pnpm run build:license",
+    "build:clean": "del dist",
+    "build:ts": "tsc -p tsconfig.build.json",
+    "build:license": "node ../../scripts/inject-license.js @cobalt-ui/core dist/index.js",
+    "dev": "pnpm run --parallel \"/^dev:.*/\"",
+    "lint": "biome check .",
+    "dev:ts": "tsc -p tsconfig.build.json --watch",
+    "test": "pnpm run \"/^test:.*/\"",
+    "test:js": "vitest run",
+    "test:ts": "tsc --noEmit"
+  }
+}

package/src/color.ts

@@ -0,0 +1,128 @@
+import 'culori/css';
+import { type Color, parse } from 'culori/fn';
+
+export interface ColorValueNormalized {
+  /** Colorspace (default: `srgb`) @see https://www.w3.org/TR/css-color-4/#predefined */
+  colorSpace: ColorSpace;
+  /** Color channels. Will be normalized to 1 unless the colorspace prevents it (e.g. XYZ, LAB) */
+  channels: [number, number, number];
+  /** Alpha channel, normalized from 0 – 1 */
+  alpha: number;
+}
+
+export type ColorSpace =
+  | 'a98'
+  | 'display-p3'
+  | 'hsb'
+  | 'hsl'
+  | 'hsv'
+  | 'hwb'
+  | 'lab'
+  | 'lch'
+  | 'oklab'
+  | 'oklch'
+  | 'prophoto-rgb'
+  | 'rec2020'
+  | 'srgb-linear'
+  | 'srgb'
+  | 'xyz-d50'
+  | 'xyz-d65';
+
+export const CULORI_TO_CSS: Record<
+  Extract<
+    Color['mode'],
+    | 'a98'
+    | 'lab'
+    | 'lch'
+    | 'oklab'
+    | 'oklch'
+    | 'hsl'
+    | 'hsv'
+    | 'hwb'
+    | 'lrgb'
+    | 'p3'
+    | 'prophoto'
+    | 'rec2020'
+    | 'rgb'
+    | 'xyz50'
+    | 'xyz65'
+  >,
+  ColorSpace
+> = {
+  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',
+};
+
+export const CSS_TO_CULORI: Record<string, string> = {};
+for (const k in CULORI_TO_CSS) {
+  CSS_TO_CULORI[CULORI_TO_CSS[k as keyof typeof CULORI_TO_CSS]] = k;
+}
+
+/** Parse any color */
+export function parseColor(color: string): ColorValueNormalized {
+  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 as keyof typeof CULORI_TO_CSS];
+  let channels: [number, number, number] = [0, 0, 0];
+  switch (result.mode) {
+    case 'a98':
+    case 'rec2020':
+    case 'p3':
+    case 'prophoto':
+    case 'lrgb':
+    case 'rgb': {
+      channels = [result.r, result.g, result.b];
+      break;
+    }
+    case 'hsl': {
+      channels = [result.h ?? 0, result.s, result.l];
+      break;
+    }
+    case 'hsv': {
+      channels = [result.h ?? 0, result.s, result.v];
+      break;
+    }
+    case 'hwb': {
+      channels = [result.h ?? 0, result.w, result.b];
+      break;
+    }
+    case 'lab':
+    case 'oklab': {
+      channels = [result.l, result.a, result.b];
+      break;
+    }
+    case 'lch':
+    case 'oklch': {
+      channels = [result.l, result.c, result.h ?? 0];
+      break;
+    }
+    case 'xyz50':
+    case 'xyz65': {
+      channels = [result.x, result.y, result.z];
+      break;
+    }
+  }
+  return {
+    colorSpace,
+    channels,
+    alpha: result.alpha ?? 1,
+  };
+}