@tokens-studio/tokenscript-schemas 0.0.13 → 0.1.0

package/bundled/functions/chroma.json

@@ -0,0 +1,54 @@
+{
+  "name": "chroma",
+  "type": "function",
+  "description": "Extracts the chroma (colorfulness/saturation) value from any color using OKLCH. Returns a value from 0 (gray) to approximately 0.4 (most saturated colors). Chroma in OKLCH represents the colorfulness independent of lightness - higher values mean more vivid colors. Essential for creating consistent color scales and checking color vibrancy.",
+  "keyword": "chroma",
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "schema": {
+    "type": "object",
+    "properties": {
+      "input": {
+        "type": "array",
+        "items": [
+          {
+            "description": "Color to extract chroma from",
+            "type": "color"
+          }
+        ],
+        "minItems": 1,
+        "maxItems": 1
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "number",
+    "description": "Chroma value (0 to ~0.4)"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// chroma: Extract chroma (colorfulness) from a color\n// Reference: OKLCH Color Space (Björn Ottosson)\n// Reference: https://bottosson.github.io/posts/oklab/\n//\n// Returns the C component from OKLCH, which represents\n// colorfulness/saturation. Range: 0 (gray) to ~0.4 (most vivid).\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\nreturn color.c;"
+  },
+  "examples": [
+    {
+      "description": "Gray has chroma 0",
+      "input": [
+        "#808080"
+      ],
+      "output": 0
+    },
+    {
+      "description": "Saturated red has high chroma",
+      "input": [
+        "#ff0000"
+      ],
+      "output": 0.26
+    }
+  ],
+  "slug": "chroma"
+}

package/bundled/functions/clamp_chroma.json

@@ -0,0 +1,66 @@
+{
+  "name": "clamp_chroma",
+  "type": "function",
+  "description": "Constrains a color's chroma (saturation) to a specified range while preserving hue and lightness. Useful for ensuring colors stay within brand guidelines or design constraints. Uses OKLCH for perceptually uniform clamping.",
+  "keyword": "clamp_chroma",
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "schema": {
+    "type": "object",
+    "properties": {
+      "input": {
+        "type": "array",
+        "items": [
+          {
+            "description": "Color to clamp",
+            "type": "color"
+          },
+          {
+            "description": "Minimum chroma (0+)",
+            "type": "number"
+          },
+          {
+            "description": "Maximum chroma (typically 0-0.4)",
+            "type": "number"
+          }
+        ],
+        "minItems": 3,
+        "maxItems": 3
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "color",
+    "description": "Color with clamped chroma"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// clamp_chroma: Constrain chroma to a range\n// Preserves hue and lightness\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable min_c: Number = input.get(1);\nvariable max_c: Number = input.get(2);\n\n// Clamp chroma\nvariable new_c: Number = color.c;\nif (new_c < min_c) [ new_c = min_c; ];\nif (new_c > max_c) [ new_c = max_c; ];\n\n// Create result\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = new_c;\nresult.h = color.h;\n\nreturn result;"
+  },
+  "examples": [
+    {
+      "description": "Limit maximum saturation",
+      "input": [
+        "#ff0000",
+        0,
+        0.15
+      ],
+      "output": "Muted red with chroma 0.15"
+    },
+    {
+      "description": "Ensure minimum saturation",
+      "input": [
+        "#808080",
+        0.05,
+        0.3
+      ],
+      "output": "Slightly colored gray"
+    }
+  ],
+  "slug": "clamp_chroma"
+}

package/bundled/functions/clamp_lightness.json

@@ -0,0 +1,66 @@
+{
+  "name": "clamp_lightness",
+  "type": "function",
+  "description": "Constrains a color's lightness to a specified range while preserving hue and chroma. Useful for ensuring colors stay within readable/accessible bounds. Uses OKLCH for perceptually uniform clamping.",
+  "keyword": "clamp_lightness",
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "schema": {
+    "type": "object",
+    "properties": {
+      "input": {
+        "type": "array",
+        "items": [
+          {
+            "description": "Color to clamp",
+            "type": "color"
+          },
+          {
+            "description": "Minimum lightness (0-1)",
+            "type": "number"
+          },
+          {
+            "description": "Maximum lightness (0-1)",
+            "type": "number"
+          }
+        ],
+        "minItems": 3,
+        "maxItems": 3
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "color",
+    "description": "Color with clamped lightness"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// clamp_lightness: Constrain lightness to a range\n// Preserves hue and chroma\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable min_l: Number = input.get(1);\nvariable max_l: Number = input.get(2);\n\n// Clamp lightness\nvariable new_l: Number = color.l;\nif (new_l < min_l) [ new_l = min_l; ];\nif (new_l > max_l) [ new_l = max_l; ];\n\n// Create result\nvariable result: Color.OKLCH;\nresult.l = new_l;\nresult.c = color.c;\nresult.h = color.h;\n\nreturn result;"
+  },
+  "examples": [
+    {
+      "description": "Clamp too-dark color to minimum",
+      "input": [
+        "#111111",
+        0.3,
+        0.9
+      ],
+      "output": "Color with lightness 0.3"
+    },
+    {
+      "description": "Clamp too-light color to maximum",
+      "input": [
+        "#ffffff",
+        0.2,
+        0.8
+      ],
+      "output": "Color with lightness 0.8"
+    }
+  ],
+  "slug": "clamp_lightness"
+}

package/bundled/functions/clamp_to_gamut.json

@@ -0,0 +1,23 @@
+{
+  "name": "Clamp to Gamut",
+  "type": "function",
+  "description": "Clips a color to the sRGB gamut by clamping each RGB channel to [0,1]. This is a simple but lossy approach - for perceptually better results, consider using gamut mapping algorithms that reduce chroma first.",
+  "keyword": "clamp_to_gamut",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "Color to clamp"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Clamp to Gamut (Simple Clipping)\n// Clips out-of-gamut sRGB values to [0, 1] range\n// Reference: Color.js toGamut with method=\"clip\"\n//\n// This is the simplest gamut mapping approach:\n// - Fast and deterministic\n// - Preserves hue when only one channel clips\n// - Can cause hue shifts when multiple channels clip\n// - May lose saturation detail\n//\n// For perceptually better results, use toGamut() which\n// reduces chroma in OKLCH before clipping.\n\nvariable input: List = {input};\nvariable color: Color.SRGB = input.get(0).to.srgb();\n\n// Get RGB values\nvariable r: Number = color.r;\nvariable g: Number = color.g;\nvariable b: Number = color.b;\n\n// Clamp R\nif (r < 0) [ r = 0; ];\nif (r > 1) [ r = 1; ];\n\n// Clamp G\nif (g < 0) [ g = 0; ];\nif (g > 1) [ g = 1; ];\n\n// Clamp B\nif (b < 0) [ b = 0; ];\nif (b > 1) [ b = 1; ];\n\n// Create clamped result\nvariable result: Color.SRGB;\nresult.r = r;\nresult.g = g;\nresult.b = b;\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "clamp_to_gamut"
+}

package/bundled/functions/complement.json

@@ -0,0 +1,24 @@
+{
+  "name": "Complement",
+  "type": "function",
+  "description": "Returns the complementary color by rotating hue 180° in OKLCH space.",
+  "keyword": "complement",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to find the complement of"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Get the complementary color by rotating hue 180° in OKLCH\n// Preserves lightness and chroma for perceptually balanced results\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Rotate hue by 180°\nvariable new_h: Number = color.h + 180;\nif (new_h >= 360) [ new_h = new_h - 360; ];\n\n// Create complementary color\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = color.c;\nresult.h = new_h;\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "complement"
+}

package/bundled/functions/contrast_ratio.json

@@ -0,0 +1,27 @@
+{
+  "name": "Contrast Ratio",
+  "type": "function",
+  "description": "Calculates the WCAG 2.1 contrast ratio between two colors. Returns a value from 1 (no contrast) to 21 (black/white). WCAG AA requires 4.5:1 for normal text, 3:1 for large text.",
+  "keyword": "contrast_ratio",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color (e.g., background)"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color (e.g., foreground)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Calculate WCAG 2.1 contrast ratio between two colors\n//\n// Returns: 1.0 (identical) to 21.0 (black vs white)\n//\n// WCAG Guidelines:\n//   - AA Normal text: ≥ 4.5:1\n//   - AA Large text:  ≥ 3.0:1\n//   - AAA Normal text: ≥ 7.0:1\n//   - AAA Large text:  ≥ 4.5:1\n//\n// Algorithm:\n// 1. Convert to linear RGB\n// 2. Calculate relative luminance: L = 0.2126*R + 0.7152*G + 0.0722*B\n// 3. Contrast ratio: (L_lighter + 0.05) / (L_darker + 0.05)\n\nvariable input: List = {input};\nvariable color1: Color.LinearSRGB = input.get(0).to.linearsrgb();\nvariable color2: Color.LinearSRGB = input.get(1).to.linearsrgb();\n\n// Calculate relative luminance for each color\nvariable lum1: Number = 0.2126 * color1.r + 0.7152 * color1.g + 0.0722 * color1.b;\nvariable lum2: Number = 0.2126 * color2.r + 0.7152 * color2.g + 0.0722 * color2.b;\n\n// Determine lighter and darker\nvariable lighter: Number = lum1;\nvariable darker: Number = lum2;\nif (lum2 > lum1) [\n    lighter = lum2;\n    darker = lum1;\n];\n\n// Calculate contrast ratio\nvariable ratio: Number = (lighter + 0.05) / (darker + 0.05);\n\nreturn ratio;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-linear-color/0/"
+  ],
+  "slug": "contrast_ratio"
+}

package/bundled/functions/cooler.json

@@ -0,0 +1,52 @@
+{
+  "name": "cooler",
+  "type": "function",
+  "description": "Shifts a color's hue towards cool colors (blue, ~260° in OKLCH). The amount parameter controls how much to shift, from 0 (no change) to 1 (fully cool). Preserves lightness and chroma.",
+  "keyword": "cooler",
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "schema": {
+    "type": "object",
+    "properties": {
+      "input": {
+        "type": "array",
+        "items": [
+          {
+            "description": "Color to cool",
+            "type": "color"
+          },
+          {
+            "description": "Amount to shift (0-1), default 0.25",
+            "type": "number"
+          }
+        ],
+        "minItems": 1,
+        "maxItems": 2
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "color",
+    "description": "Color shifted towards cool hues"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// cooler: Shift hue towards cool colors\n//\n// Cool colors are centered around blue (~260° in OKLCH).\n// The function interpolates the hue towards this target via\n// the shortest angular path on the hue wheel.\n//\n// Parameters:\n//   color  - Input color\n//   amount - Shift amount (0 = no change, 1 = fully cool), default 0.25\n//\n// Preserves lightness and chroma.\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable amount: Number = 0.25;\n\nif (input.length() > 1) [\n    amount = input.get(1);\n];\n\n// Cool hue target (blue in OKLCH is around 260°)\nvariable cool_hue: Number = 260;\n\n// Calculate shortest path hue difference\nvariable hue_diff: Number = cool_hue - color.h;\n\n// Wrap to shortest path\nif (hue_diff > 180) [ hue_diff = hue_diff - 360; ];\nif (hue_diff < -180) [ hue_diff = hue_diff + 360; ];\n\n// Apply interpolation\nvariable new_hue: Number = color.h + (hue_diff * amount);\n\n// Normalize to 0-360\nif (new_hue < 0) [ new_hue = new_hue + 360; ];\nif (new_hue >= 360) [ new_hue = new_hue - 360; ];\n\n// Create result\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = color.c;\nresult.h = new_hue;\n\nreturn result;"
+  },
+  "examples": [
+    {
+      "description": "Make orange cooler",
+      "input": [
+        "#ff6600",
+        0.5
+      ],
+      "output": "Orange shifted towards neutral"
+    }
+  ],
+  "slug": "cooler"
+}

package/bundled/functions/darken.json

@@ -0,0 +1,28 @@
+{
+  "name": "Darken",
+  "type": "function",
+  "description": "Makes a color darker by decreasing its lightness in OKLab space. Amount is 0-1 where 0.25 = 25% darker.",
+  "keyword": "darken",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to darken"
+      },
+      "amount": {
+        "type": "number",
+        "description": "Amount to darken (0-1). Default is 0.25"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// darken: Decrease lightness proportionally towards black\n// Amount: 0-1 where 0.25 means 25% closer to black\n//\n// Algorithm: L' = L * (1 - amount)\n// This ensures we approach black (L=0) proportionally.\n//\n// Input:  Any color space (converted to OKLab internally)\n// Output: OKLCH (working space)\n// To get sRGB: darken(color, 0.25).to.srgb()\n\nvariable input: List = {input};\nvariable color: Color.OKLab = input.get(0).to.oklab();\n\n// Default amount is 0.25 (25%)\nvariable amount: Number = 0.25;\nif (input.length() > 1) [\n    amount = input.get(1);\n];\n\n// Calculate new lightness (move toward 0)\nvariable current_l: Number = color.l;\nvariable new_l: Number = current_l * (1 - amount);\n\n// Clamp to valid range\nif (new_l < 0) [ new_l = 0; ];\n\n// Create output in OKLab, return as OKLCH (working space)\nvariable result: Color.OKLab;\nresult.l = new_l;\nresult.a = color.a;\nresult.b = color.b;\n\nreturn result.to.oklch();"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklab-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "darken"
+}

package/bundled/functions/delta_e_2000.json

@@ -0,0 +1,40 @@
+{
+  "name": "Delta E 2000",
+  "type": "function",
+  "description": "Calculates perceptual color difference using CIEDE2000 (ΔE00), the CIE-recommended color difference formula. More accurate than CIE76 for small differences. Industry standard for color quality control. Uses parametric weighting factors kL, kC, kH (all default to 1).",
+  "keyword": "delta_e_2000",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color (reference)"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color (sample)"
+      },
+      "kL": {
+        "type": "number",
+        "description": "Lightness weight (default 1)"
+      },
+      "kC": {
+        "type": "number",
+        "description": "Chroma weight (default 1)"
+      },
+      "kH": {
+        "type": "number",
+        "description": "Hue weight (default 1)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// CIEDE2000 Color Difference Formula (ΔE00)\n// Reference: CIE 142-2001 (Technical Report)\n// Reference: Color.js deltaE2000 implementation\n// Reference: Sharma, Wu, Dalal \"The CIEDE2000 Color-Difference Formula\" (2005)\n//\n// This is the CIE-recommended color difference formula, providing\n// better correlation with visual perception than CIE76 or CIE94.\n//\n// Parametric factors (kL, kC, kH):\n// - All default to 1.0 for reference conditions\n// - kL can be increased for lightness texture/noise\n// - kC can be increased for chroma noise\n//\n// Interpretation (approximate):\n//   0.0        - Identical colors\n//   < 1.0      - Not perceptible by human eye\n//   1.0 - 2.0  - Perceptible through close observation\n//   2.0 - 10.0 - Perceptible at a glance\n//   > 10.0     - Colors are obviously different\n\nvariable input: List = {input};\n\n// Convert both colors to CIE Lab\nvariable color1: Color.Lab = input.get(0).to.lab();\nvariable color2: Color.Lab = input.get(1).to.lab();\n\n// Get parametric weighting factors (default to 1)\nvariable k_l: Number = 1;\nvariable k_c: Number = 1;\nvariable k_h: Number = 1;\nif (input.length() > 2) [ k_l = input.get(2); ];\nif (input.length() > 3) [ k_c = input.get(3); ];\nif (input.length() > 4) [ k_h = input.get(4); ];\n\n// Constants\nvariable pi: Number = pi();\nvariable r2d: Number = 180 / pi;\nvariable d2r: Number = pi / 180;\nvariable g_factor: Number = 6103515625; // 25^7\nvariable e: Number = 2.718281828459045; // Euler's number\n\n// Get Lab values\nvariable l1: Number = color1.l;\nvariable a1: Number = color1.a;\nvariable b1: Number = color1.b;\n\nvariable l2: Number = color2.l;\nvariable a2: Number = color2.a;\nvariable b2: Number = color2.b;\n\n// Calculate C* (chroma) for both colors\nvariable c1: Number = sqrt(a1 * a1 + b1 * b1);\nvariable c2: Number = sqrt(a2 * a2 + b2 * b2);\n\n// Ensure non-negative chroma\nif (c1 < 0) [ c1 = 0; ];\nif (c2 < 0) [ c2 = 0; ];\n\n// Mean chroma\nvariable c_bar: Number = (c1 + c2) / 2;\n\n// Calculate G (a-axis asymmetry factor)\nvariable c7: Number = c_bar * c_bar * c_bar * c_bar * c_bar * c_bar * c_bar;\nvariable g: Number = 0.5 * (1 - sqrt(c7 / (c7 + g_factor)));\n\n// Scale a* values by asymmetry factor\nvariable a_prime1: Number = (1 + g) * a1;\nvariable a_prime2: Number = (1 + g) * a2;\n\n// Calculate C' from scaled a' and original b\nvariable c_prime1: Number = sqrt(a_prime1 * a_prime1 + b1 * b1);\nvariable c_prime2: Number = sqrt(a_prime2 * a_prime2 + b2 * b2);\n\n// Calculate h' (hue angles in degrees)\nvariable h1: Number = 0;\nif (a_prime1 != 0) [ h1 = atan2(b1, a_prime1); ];\nif (b1 != 0) [ h1 = atan2(b1, a_prime1); ];\nif (a_prime1 == 0) [\n    if (b1 == 0) [ h1 = 0; ] else [ h1 = atan2(b1, a_prime1); ];\n];\nh1 = h1 * r2d;\nif (h1 < 0) [ h1 = h1 + 360; ];\n\nvariable h2: Number = 0;\nif (a_prime2 != 0) [ h2 = atan2(b2, a_prime2); ];\nif (b2 != 0) [ h2 = atan2(b2, a_prime2); ];\nif (a_prime2 == 0) [\n    if (b2 == 0) [ h2 = 0; ] else [ h2 = atan2(b2, a_prime2); ];\n];\nh2 = h2 * r2d;\nif (h2 < 0) [ h2 = h2 + 360; ];\n\n// Lightness and Chroma differences\nvariable delta_l: Number = l2 - l1;\nvariable delta_c: Number = c_prime2 - c_prime1;\n\n// Hue difference (getting the sign correct)\nvariable h_diff: Number = h2 - h1;\nvariable h_sum: Number = h1 + h2;\nvariable h_abs: Number = h_diff;\nif (h_abs < 0) [ h_abs = 0 - h_abs; ];\n\nvariable delta_h: Number = 0;\nvariable c_product: Number = c_prime1 * c_prime2;\n\nif (c_product == 0) [\n    delta_h = 0;\n] else [\n    if (h_abs <= 180) [\n        delta_h = h_diff;\n    ] else [\n        if (h_diff > 180) [\n            delta_h = h_diff - 360;\n        ] else [\n            if (h_diff < -180) [\n                delta_h = h_diff + 360;\n            ] else [\n                delta_h = h_diff;\n            ];\n        ];\n    ];\n];\n\n// Weighted hue difference (ΔH')\nvariable delta_h_prime: Number = 2 * sqrt(c_prime2 * c_prime1) * sin(delta_h * d2r / 2);\n\n// Mean lightness and chroma\nvariable l_bar: Number = (l1 + l2) / 2;\nvariable c_bar_prime: Number = (c_prime1 + c_prime2) / 2;\nvariable c_bar_prime7: Number = c_bar_prime * c_bar_prime * c_bar_prime * c_bar_prime * c_bar_prime * c_bar_prime * c_bar_prime;\n\n// Mean hue (handling the 0/360 wraparound)\nvariable h_bar: Number = 0;\nif (c_product == 0) [\n    h_bar = h_sum;\n] else [\n    if (h_abs <= 180) [\n        h_bar = h_sum / 2;\n    ] else [\n        if (h_sum < 360) [\n            h_bar = (h_sum + 360) / 2;\n        ] else [\n            h_bar = (h_sum - 360) / 2;\n        ];\n    ];\n];\n\n// SL - Lightness crispening factor (assumes L=50 background)\nvariable l_bar_minus_50: Number = l_bar - 50;\nvariable l_sq: Number = l_bar_minus_50 * l_bar_minus_50;\nvariable s_l: Number = 1 + (0.015 * l_sq) / sqrt(20 + l_sq);\n\n// SC - Chroma factor\nvariable s_c: Number = 1 + 0.045 * c_bar_prime;\n\n// T - Cross term for blue non-linearity\nvariable t: Number = 1;\nt = t - 0.17 * cos((h_bar - 30) * d2r);\nt = t + 0.24 * cos(2 * h_bar * d2r);\nt = t + 0.32 * cos((3 * h_bar + 6) * d2r);\nt = t - 0.20 * cos((4 * h_bar - 63) * d2r);\n\n// SH - Hue factor\nvariable s_h: Number = 1 + 0.015 * c_bar_prime * t;\n\n// RT - Hue rotation term (for blue region 225-315 degrees)\nvariable h_bar_minus_275: Number = h_bar - 275;\nvariable exp_arg: Number = -1 * (h_bar_minus_275 / 25) * (h_bar_minus_275 / 25);\nvariable delta_theta: Number = 30 * pow(e, exp_arg);\nvariable r_c: Number = 2 * sqrt(c_bar_prime7 / (c_bar_prime7 + g_factor));\nvariable r_t: Number = -1 * sin(2 * delta_theta * d2r) * r_c;\n\n// Calculate final ΔE00\nvariable term_l: Number = delta_l / (k_l * s_l);\nvariable term_c: Number = delta_c / (k_c * s_c);\nvariable term_h: Number = delta_h_prime / (k_h * s_h);\n\nvariable de: Number = term_l * term_l + term_c * term_c + term_h * term_h;\nde = de + r_t * (delta_c / (k_c * s_c)) * (delta_h_prime / (k_h * s_h));\n\nvariable result: Number = sqrt(de);\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/lab-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/lch-color/0/"
+  ],
+  "slug": "delta_e_2000"
+}

package/bundled/functions/delta_e_76.json

@@ -0,0 +1,27 @@
+{
+  "name": "Delta E 76",
+  "type": "function",
+  "description": "Calculates color difference using CIE76 formula (ΔE*ab). Simple Euclidean distance in CIE Lab space. Less accurate than Delta E 2000 for small differences, but faster and adequate for many applications. Formula: sqrt((L1-L2)² + (a1-a2)² + (b1-b2)²).",
+  "keyword": "delta_e_76",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color (reference)"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color (sample)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Delta E 76 (CIE76 Color Difference)\n// Reference: CIE Publication 15.2 (1986)\n// Reference: ASTM E308 Standard\n//\n// The original CIE color difference formula from 1976.\n// Simple Euclidean distance in CIE Lab space.\n//\n// Formula: ΔE*ab = sqrt((L1-L2)² + (a1-a2)² + (b1-b2)²)\n//\n// Interpretation:\n//   0 - 1:     Not perceptible by human eye\n//   1 - 2:     Perceptible through close observation\n//   2 - 10:    Perceptible at a glance\n//   11 - 49:   Colors are more similar than opposite\n//   100+:      Colors are exact opposite\n//\n// Limitations:\n// - Lab is not perfectly perceptually uniform\n// - Overestimates differences for saturated colors\n// - Use Delta E 2000 for critical color matching\n\nvariable input: List = {input};\nvariable color1: Color.Lab = input.get(0).to.lab();\nvariable color2: Color.Lab = input.get(1).to.lab();\n\n// Get Lab components\nvariable l1: Number = color1.l;\nvariable a1: Number = color1.a;\nvariable b1: Number = color1.b;\n\nvariable l2: Number = color2.l;\nvariable a2: Number = color2.a;\nvariable b2: Number = color2.b;\n\n// Calculate differences\nvariable delta_l: Number = l1 - l2;\nvariable delta_a: Number = a1 - a2;\nvariable delta_b: Number = b1 - b2;\n\n// Euclidean distance\nvariable sum_squares: Number = delta_l * delta_l + delta_a * delta_a + delta_b * delta_b;\nvariable result: Number = sqrt(sum_squares);\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/lab-color/0/"
+  ],
+  "slug": "delta_e_76"
+}

package/bundled/functions/delta_e_ok.json

@@ -0,0 +1,27 @@
+{
+  "name": "Delta E OK",
+  "type": "function",
+  "description": "Calculates perceptual color difference using the OKLab color space (ΔE_OK). This is the Euclidean distance in OKLab space, providing excellent perceptual uniformity. Values: 0 = identical, <0.02 = imperceptible, <0.05 = very close, <0.1 = noticeable, >0.5 = very different.",
+  "keyword": "delta_e_ok",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color (reference)"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color (sample)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Delta E OK (ΔE_OK)\n// Perceptual color difference in OKLab space\n// Reference: Björn Ottosson's OKLab specification\n// Reference: Color.js deltaEOK implementation\n//\n// This is simply the Euclidean distance in OKLab space.\n// OKLab is designed to be perceptually uniform, making this\n// a reliable measure of perceived color difference.\n//\n// Interpretation:\n//   0.00       - Identical colors\n//   < 0.02     - Imperceptible difference (JND threshold)\n//   < 0.05     - Very close colors\n//   < 0.1      - Noticeable but small difference\n//   0.1 - 0.5  - Moderate difference\n//   > 0.5      - Very different colors\n//\n// Formula: sqrt((L1-L2)² + (a1-a2)² + (b1-b2)²)\n\nvariable input: List = {input};\nvariable color1: Color.OKLab = input.get(0).to.oklab();\nvariable color2: Color.OKLab = input.get(1).to.oklab();\n\n// Get OKLab components\nvariable l1: Number = color1.l;\nvariable a1: Number = color1.a;\nvariable b1: Number = color1.b;\n\nvariable l2: Number = color2.l;\nvariable a2: Number = color2.a;\nvariable b2: Number = color2.b;\n\n// Calculate differences\nvariable delta_l: Number = l1 - l2;\nvariable delta_a: Number = a1 - a2;\nvariable delta_b: Number = b1 - b2;\n\n// Calculate Euclidean distance (sqrt of sum of squares)\nvariable sum_squares: Number = delta_l * delta_l + delta_a * delta_a + delta_b * delta_b;\nvariable result: Number = sqrt(sum_squares);\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklab-color/0/"
+  ],
+  "slug": "delta_e_ok"
+}

package/bundled/functions/desaturate.json

@@ -0,0 +1,28 @@
+{
+  "name": "Desaturate",
+  "type": "function",
+  "description": "Decreases color saturation by reducing chroma in OKLCH space. Amount is 0-1 where 0.25 = 25% less saturated.",
+  "keyword": "desaturate",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to desaturate"
+      },
+      "amount": {
+        "type": "number",
+        "description": "Amount to desaturate (0-1). Default is 0.25"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Desaturate a color by decreasing its OKLCH chroma\n// Amount: 0-1 where 0.25 means 25% decrease, 1.0 = full grayscale\n//\n// Algorithm: C' = C * (1 - amount)\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Default amount is 0.25 (25%)\nvariable amount: Number = 0.25;\nif (input.length() > 1) [\n    amount = input.get(1);\n];\n\n// Calculate new chroma\nvariable current_c: Number = color.c;\nvariable new_c: Number = current_c * (1 - amount);\n\n// Clamp to valid range\nif (new_c < 0) [ new_c = 0; ];\n\n// Create output in OKLCH, return as sRGB\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = new_c;\nresult.h = color.h;\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "desaturate"
+}

package/bundled/functions/distributed.json

@@ -0,0 +1,36 @@
+{
+  "name": "Distributed",
+  "type": "function",
+  "description": "Creates evenly distributed colors around the OKLCH hue wheel. Perfect for categorical data where each category needs a distinct, visually balanced color.",
+  "keyword": "distributed",
+  "input": {
+    "type": "object",
+    "properties": {
+      "count": {
+        "type": "number",
+        "description": "Number of colors to generate. Default is 6"
+      },
+      "lightness": {
+        "type": "number",
+        "description": "Lightness for all colors (0-1). Default is 0.7"
+      },
+      "chroma": {
+        "type": "number",
+        "description": "Chroma/saturation for all colors (0-0.4). Default is 0.15"
+      },
+      "start_hue": {
+        "type": "number",
+        "description": "Starting hue angle (0-360). Default is 30 (orange)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Create evenly distributed categorical colors using OKLCH\n// Colors are spaced equally around the hue wheel\n//\n// Ideal for: pie charts, bar charts, legends, category labels\n// Uses golden angle offset for better distinction with many colors\n\nvariable input: List = {input};\n\n// Default count is 6\nvariable count: Number = 6;\nif (input.length() > 0) [\n    count = input.get(0);\n];\n\n// Default lightness is 0.7 (good for both light/dark backgrounds)\nvariable lightness: Number = 0.7;\nif (input.length() > 1) [\n    lightness = input.get(1);\n];\n\n// Default chroma is 0.15 (vivid but not overwhelming)\nvariable chroma: Number = 0.15;\nif (input.length() > 2) [\n    chroma = input.get(2);\n];\n\n// Default start hue is 30 (orange - visually distinct starting point)\nvariable start_hue: Number = 30;\nif (input.length() > 3) [\n    start_hue = input.get(3);\n];\n\n// Calculate hue step (360° / count for even distribution)\nvariable hue_step: Number = 360 / count;\n\nvariable result: List;\nvariable i: Number = 0;\nvariable current_hue: Number = 0;\nvariable color: Color.OKLCH;\n\nwhile (i < count) [\n    current_hue = start_hue + i * hue_step;\n    if (current_hue >= 360) [ current_hue = current_hue - 360; ];\n    \n    color.l = lightness;\n    color.c = chroma;\n    color.h = current_hue;\n    \n    result = result, color.to.srgb();\n    i = i + 1;\n];\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "distributed"
+}

package/bundled/functions/diverging.json

@@ -0,0 +1,36 @@
+{
+  "name": "Diverging",
+  "type": "function",
+  "description": "Creates a diverging color palette for heatmaps. Goes from color1 through a neutral midpoint to color2. Perfect for data that diverges from a center value (e.g., -1 to 0 to +1).",
+  "keyword": "diverging",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "Color for negative/low end (e.g., blue)"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Color for positive/high end (e.g., red)"
+      },
+      "count": {
+        "type": "number",
+        "description": "Number of steps (should be odd for clear midpoint). Default is 9"
+      },
+      "neutral": {
+        "type": "number",
+        "description": "Lightness of neutral midpoint (0-1). Default is 0.95 (near white)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Create a diverging color palette for data visualization\n// Goes: color1 → neutral → color2\n//\n// Ideal for: heatmaps, correlation matrices, deviation from mean\n// Example: blue → white → red for temperature anomalies\n\nvariable input: List = {input};\nvariable color1: Color.OKLCH = input.get(0).to.oklch();\nvariable color2: Color.OKLCH = input.get(1).to.oklch();\n\n// Default count is 9 (gives clear midpoint at index 4)\nvariable count: Number = 9;\nif (input.length() > 2) [\n    count = input.get(2);\n];\n\n// Default neutral lightness is 0.95 (near white)\nvariable neutral_l: Number = 0.95;\nif (input.length() > 3) [\n    neutral_l = input.get(3);\n];\n\n// Calculate midpoint index\nvariable mid: Number = (count - 1) / 2;\n\nvariable result: List;\nvariable i: Number = 0;\nvariable t: Number = 0;\nvariable step_color: Color.OKLCH;\n\nwhile (i < count) [\n    if (i < mid) [\n        // First half: color1 → neutral\n        t = i / mid;\n        step_color.l = color1.l + (neutral_l - color1.l) * t;\n        step_color.c = color1.c * (1 - t);\n        step_color.h = color1.h;\n    ] else [\n        if (i == mid) [\n            // Midpoint: neutral (achromatic)\n            step_color.l = neutral_l;\n            step_color.c = 0;\n            step_color.h = 0;\n        ] else [\n            // Second half: neutral → color2\n            t = (i - mid) / mid;\n            step_color.l = neutral_l + (color2.l - neutral_l) * t;\n            step_color.c = color2.c * t;\n            step_color.h = color2.h;\n        ];\n    ];\n    \n    result = result, step_color.to.srgb();\n    i = i + 1;\n];\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "diverging"
+}

package/bundled/functions/grayscale.json

@@ -0,0 +1,24 @@
+{
+  "name": "Grayscale",
+  "type": "function",
+  "description": "Converts a color to grayscale by removing all chroma in OKLCH space. Preserves perceptual lightness.",
+  "keyword": "grayscale",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to convert to grayscale"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Convert a color to grayscale by setting OKLCH chroma to 0\n// This preserves perceptual lightness (unlike simple RGB averaging)\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Create grayscale by removing chroma\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = 0;\nresult.h = 0;\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/",
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "grayscale"
+}