@tokens-studio/tokenscript-schemas 0.0.14 → 0.1.0

package/bundled/functions/harmonize.json

@@ -0,0 +1,65 @@
+{
+  "name": "harmonize",
+  "type": "function",
+  "description": "Harmonizes a color by shifting its hue toward a source color. Inspired by Material Design 3's color harmonization algorithm. This creates visual cohesion in design systems by making colors feel related while preserving their identity. The amount parameter controls how much the hue shifts (0 = no change, 1 = full shift to source hue).",
+  "keyword": "harmonize",
+  "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 harmonize",
+            "type": "color"
+          },
+          {
+            "description": "Source color (hue target)",
+            "type": "color"
+          },
+          {
+            "description": "Amount of harmonization (0-1, default 0.5)",
+            "type": "number"
+          }
+        ],
+        "minItems": 2,
+        "maxItems": 3
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "color",
+    "description": "Harmonized color with hue shifted toward source"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// harmonize: Shift hue towards a source color for visual harmony\n// Reference: Material Design 3 Color System\n// Reference: https://m3.material.io/styles/color/dynamic-color\n//\n// Shifts the input color's hue towards a source color by a specified\n// amount, creating a harmonized palette. Uses OKLCH for perceptually\n// uniform hue interpolation via the shortest angular path.\n//\n// Parameters:\n//   color  - Color to harmonize\n//   source - Target hue source\n//   amount - Shift amount (0 = no change, 1 = match source), default 0.5\n//\n// Input:  Any color space (converted to OKLCH internally)\n// Output: OKLCH (working space)\n// To get sRGB: harmonize(color, source, 0.5).to.srgb()\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable source: Color.OKLCH = input.get(1).to.oklch();\n\n// Default harmonization amount (0.5 = 50% shift)\nvariable amount: Number = 0.5;\nif (input.length() > 2) [\n    amount = input.get(2);\n];\n\n// Get hues\nvariable color_hue: Number = color.h;\nvariable source_hue: Number = source.h;\n\n// Calculate shortest path around the hue circle\nvariable diff: Number = source_hue - color_hue;\n\n// Normalize to -180 to 180 range for shortest path\nif (diff > 180) [\n    diff = diff - 360;\n];\nif (diff < -180) [\n    diff = diff + 360;\n];\n\n// Apply harmonization: shift hue by amount * difference\nvariable new_hue: Number = color_hue + (diff * amount);\n\n// Normalize hue to 0-360\nif (new_hue < 0) [\n    new_hue = new_hue + 360;\n];\nif (new_hue >= 360) [\n    new_hue = new_hue - 360;\n];\n\n// Create result with shifted hue, preserving lightness and chroma\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = color.c;\nresult.h = new_hue;\n\nreturn result;"
+  },
+  "examples": [
+    {
+      "description": "Harmonize red toward blue",
+      "input": [
+        "#ff0000",
+        "#0000ff",
+        0.3
+      ],
+      "output": "Color with hue shifted toward blue"
+    },
+    {
+      "description": "Harmonize green toward brand color",
+      "input": [
+        "#00ff00",
+        "#6750a4"
+      ],
+      "output": "Green shifted toward purple brand"
+    }
+  ],
+  "slug": "harmonize"
+}

package/bundled/functions/hue.json

@@ -0,0 +1,54 @@
+{
+  "name": "hue",
+  "type": "function",
+  "description": "Extracts the hue angle from any color using OKLCH. Returns a value from 0 to 360 degrees representing the color's position on the hue wheel. Hue in OKLCH is perceptually uniform, meaning equal angular steps produce equally perceived hue changes. Essential for color harmony calculations and palette generation.",
+  "keyword": "hue",
+  "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 hue from",
+            "type": "color"
+          }
+        ],
+        "minItems": 1,
+        "maxItems": 1
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "number",
+    "description": "Hue angle (0-360 degrees)"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// hue: Extract hue angle from a color\n// Reference: OKLCH Color Space (Björn Ottosson)\n// Reference: https://bottosson.github.io/posts/oklab/\n//\n// Returns the H component from OKLCH, representing the\n// perceptually uniform hue angle. Range: 0-360 degrees.\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\nreturn color.h;"
+  },
+  "examples": [
+    {
+      "description": "Red has hue around 30° in OKLCH",
+      "input": [
+        "#ff0000"
+      ],
+      "output": 29
+    },
+    {
+      "description": "Cyan has hue around 195°",
+      "input": [
+        "#00ffff"
+      ],
+      "output": 195
+    }
+  ],
+  "slug": "hue"
+}

package/bundled/functions/hue_difference.json

@@ -0,0 +1,27 @@
+{
+  "name": "Hue Difference",
+  "type": "function",
+  "description": "Calculates the angular difference between two color hues. Returns the shortest path around the hue circle (0-180°). Useful for determining how different two colors are in terms of hue alone, ignoring lightness and chroma.",
+  "keyword": "hue_difference",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Hue Difference\n// Calculates angular hue difference using shortest path\n//\n// The hue circle wraps at 360°, so we need to find\n// the shortest angular distance between two hues.\n//\n// Examples:\n//   hue_diff(350°, 10°) = 20° (not 340°)\n//   hue_diff(0°, 180°) = 180° (maximum difference)\n//   hue_diff(90°, 90°) = 0° (same hue)\n//\n// Returns value in range [0, 180]\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// Get hue values\nvariable h1: Number = color1.h;\nvariable h2: Number = color2.h;\n\n// Normalize to 0-360\nif (h1 < 0) [ h1 = h1 + 360; ];\nif (h1 >= 360) [ h1 = h1 - 360; ];\nif (h2 < 0) [ h2 = h2 + 360; ];\nif (h2 >= 360) [ h2 = h2 - 360; ];\n\n// Calculate raw difference\nvariable diff: Number = h1 - h2;\n\n// Make positive\nif (diff < 0) [\n    diff = 0 - diff;\n];\n\n// Take shortest path around circle\nif (diff > 180) [\n    diff = 360 - diff;\n];\n\nreturn diff;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "slug": "hue_difference"
+}

package/bundled/functions/in_gamut.json

@@ -0,0 +1,27 @@
+{
+  "name": "In Gamut",
+  "type": "function",
+  "description": "Checks if a color is within the sRGB gamut. Returns true if all RGB components are in [0,1] range, false otherwise. Useful for checking if colors from wider gamuts (P3, OKLab) can be displayed on standard monitors.",
+  "keyword": "in_gamut",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "Color to check"
+      },
+      "epsilon": {
+        "type": "number",
+        "description": "Tolerance for near-gamut colors (default 0.000075)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// In Gamut Check\n// Checks if a color is within the sRGB gamut\n// Reference: Color.js inGamut implementation\n//\n// sRGB gamut is defined by all RGB components being in [0, 1]\n// This is critical for determining if colors can be displayed\n// on standard monitors without clipping.\n//\n// An epsilon tolerance is used to handle floating-point precision\n// issues near the gamut boundary.\n\nvariable input: List = {input};\nvariable color: Color.SRGB = input.get(0).to.srgb();\n\n// Default epsilon from Color.js\nvariable epsilon: Number = 0.000075;\nif (input.length() > 1) [\n    epsilon = input.get(1);\n];\n\n// Get RGB values\nvariable r: Number = color.r;\nvariable g: Number = color.g;\nvariable b: Number = color.b;\n\n// Check if within gamut bounds with epsilon tolerance\nvariable min_bound: Number = 0 - epsilon;\nvariable max_bound: Number = 1 + epsilon;\n\n// All channels must be within bounds\nvariable r_in: Boolean = r >= min_bound;\nif (r_in) [ r_in = r <= max_bound; ];\n\nvariable g_in: Boolean = g >= min_bound;\nif (g_in) [ g_in = g <= max_bound; ];\n\nvariable b_in: Boolean = b >= min_bound;\nif (b_in) [ b_in = b <= max_bound; ];\n\n// Return true only if all channels are in gamut\nvariable result: Boolean = false;\nif (r_in) [\n    if (g_in) [\n        if (b_in) [\n            result = true;\n        ];\n    ];\n];\n\nreturn result;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
+  ],
+  "slug": "in_gamut"
+}

package/bundled/functions/interpolate.json

@@ -0,0 +1,66 @@
+{
+  "name": "interpolate",
+  "type": "function",
+  "description": "Interpolates between two colors at a given position in perceptual OKLCH space. Position of 0 returns the first color, 1 returns the second color, 0.5 returns the midpoint. Uses shortest-path hue interpolation for natural color transitions.",
+  "keyword": "interpolate",
+  "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": "Start color",
+            "type": "color"
+          },
+          {
+            "description": "End color",
+            "type": "color"
+          },
+          {
+            "description": "Position (0-1, default 0.5)",
+            "type": "number"
+          }
+        ],
+        "minItems": 2,
+        "maxItems": 3
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "color",
+    "description": "Interpolated color"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// interpolate: Blend between two colors in perceptual space\n// Reference: CSS Color Level 4 Color Interpolation\n// Reference: https://www.w3.org/TR/css-color-4/#interpolation\n//\n// Performs linear interpolation in OKLCH space with shortest-path\n// hue interpolation. OKLCH provides perceptually uniform results.\n//\n// Parameters:\n//   start - First color (t=0)\n//   end   - Second color (t=1)\n//   t     - Interpolation factor [0, 1], default 0.5\n//\n// Input:  Any color space (converted to OKLCH internally)\n// Output: OKLCH (working space)\n// To get sRGB: interpolate(start, end, 0.5).to.srgb()\n\nvariable input: List = {input};\nvariable start: Color.OKLCH = input.get(0).to.oklch();\nvariable end: Color.OKLCH = input.get(1).to.oklch();\n\n// Default to midpoint\nvariable t: Number = 0.5;\nif (input.length() > 2) [\n    t = input.get(2);\n];\n\n// Clamp t to valid range\nif (t < 0) [ t = 0; ];\nif (t > 1) [ t = 1; ];\n\n// Interpolate lightness and chroma linearly\nvariable result_l: Number = start.l + (end.l - start.l) * t;\nvariable result_c: Number = start.c + (end.c - start.c) * t;\n\n// Interpolate hue using shortest path\nvariable h1: Number = start.h;\nvariable h2: Number = end.h;\nvariable delta_h: Number = h2 - h1;\n\n// Normalize to shortest path around the circle\nif (delta_h > 180) [\n    delta_h = delta_h - 360;\n];\nif (delta_h < -180) [\n    delta_h = delta_h + 360;\n];\n\nvariable result_h: Number = h1 + delta_h * t;\n\n// Normalize result hue to 0-360\nif (result_h < 0) [ result_h = result_h + 360; ];\nif (result_h >= 360) [ result_h = result_h - 360; ];\n\n// Create result\nvariable result: Color.OKLCH;\nresult.l = result_l;\nresult.c = result_c;\nresult.h = result_h;\n\nreturn result;"
+  },
+  "examples": [
+    {
+      "description": "Midpoint between red and blue",
+      "input": [
+        "#ff0000",
+        "#0000ff",
+        0.5
+      ],
+      "output": "Purple-ish color in OKLCH"
+    },
+    {
+      "description": "Quarter way from black to white",
+      "input": [
+        "#000000",
+        "#ffffff",
+        0.25
+      ],
+      "output": "Dark gray"
+    }
+  ],
+  "slug": "interpolate"
+}

package/bundled/functions/invert.json

@@ -14,7 +14,7 @@
   },
   "script": {
     "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "variable input: List = {input};\n\nvariable rgb_color: Color.Rgb = input.get(0).to.rgb();\n\nvariable inverted_r: Number = 255 - rgb_color.r;\nvariable inverted_g: Number = 255 - rgb_color.g;\nvariable inverted_b: Number = 255 - rgb_color.b;\n\nvariable inverted_color: Color.Rgb = rgb(inverted_r, inverted_g, inverted_b);\nreturn inverted_color;"
+    "script": "// Invert Color Function\n// Returns the inverse/negative of a color by subtracting each RGB channel from 255\n//\n// Algorithm:\n//   R' = 255 - R\n//   G' = 255 - G  \n//   B' = 255 - B\n//\n// Use cases:\n//   - Creating negative images\n//   - High contrast accessibility variants\n//   - Artistic color effects\n//\n// Input: Any color (converted to RGB internally)\n// Output: Color.Rgb with inverted channels\n\nvariable input: List = {input};\n\n// Convert input to RGB (0-255 range)\nvariable rgb_color: Color.Rgb = input.get(0).to.rgb();\n\n// Invert each channel by subtracting from 255\nvariable inverted_r: Number = 255 - rgb_color.r;\nvariable inverted_g: Number = 255 - rgb_color.g;\nvariable inverted_b: Number = 255 - rgb_color.b;\n\n// Create and return the inverted color\nvariable inverted_color: Color.Rgb = rgb(inverted_r, inverted_g, inverted_b);\nreturn inverted_color;"
   },
   "requirements": [
     "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/rgb-color/0/"

package/bundled/functions/is_cool.json

@@ -0,0 +1,23 @@
+{
+  "name": "Is Cool",
+  "type": "function",
+  "description": "Checks if a color is perceptually cool. Cool colors have hues in the green-blue-purple range (roughly 130-320° in OKLCH). Returns true for cool colors (green, cyan, blue, purple), false for warm colors. Achromatic colors are considered neutral/cool.",
+  "keyword": "is_cool",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "Color to check"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Is Cool Color\n// Determines if a color is perceptually cool\n//\n// Cool colors are associated with:\n// - Water, ice, sky\n// - Calm, professional, trustworthy feelings\n// - Receding visual perception (appear further away)\n//\n// OKLCH hue ranges:\n// - Cool: 130-320° (yellow-green through purple)\n// - Includes: green, cyan, blue, purple\n//\n// Achromatic colors (low chroma) are considered cool/neutral\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Get hue and chroma\nvariable h: Number = color.h;\nvariable c: Number = color.c;\n\n// Achromatic colors (very low chroma) are considered cool/neutral\nif (c < 0.02) [\n    return true;\n];\n\n// Normalize hue to 0-360\nif (h < 0) [ h = h + 360; ];\nif (h >= 360) [ h = h - 360; ];\n\n// Cool hue range: 130-320° (green through purple)\nvariable is_cool: Boolean = false;\n\nif (h > 130) [\n    if (h < 320) [\n        is_cool = true;\n    ];\n];\n\nreturn is_cool;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "slug": "is_cool"
+}

package/bundled/functions/is_dark.json

@@ -0,0 +1,27 @@
+{
+  "name": "Is Dark",
+  "type": "function",
+  "description": "Returns true if a color is perceptually dark (lightness <= threshold). Uses OKLCH lightness for perceptual accuracy. Default threshold is 0.6.",
+  "keyword": "is_dark",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to check"
+      },
+      "threshold": {
+        "type": "number",
+        "description": "Lightness threshold (0-1). Default is 0.6"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Check if a color is perceptually dark\n// Uses OKLCH lightness for accurate perception matching\n//\n// Returns: true if L <= threshold, false otherwise\n// Default threshold: 0.6 (slightly above middle)\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\nvariable threshold: Number = 0.6;\nif (input.length() > 1) [\n    threshold = input.get(1);\n];\n\nreturn color.l <= threshold;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "slug": "is_dark"
+}

package/bundled/functions/is_light.json

@@ -0,0 +1,27 @@
+{
+  "name": "Is Light",
+  "type": "function",
+  "description": "Returns true if a color is perceptually light (lightness > threshold). Uses OKLCH lightness for perceptual accuracy. Default threshold is 0.6.",
+  "keyword": "is_light",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to check"
+      },
+      "threshold": {
+        "type": "number",
+        "description": "Lightness threshold (0-1). Default is 0.6"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Check if a color is perceptually light\n// Uses OKLCH lightness for accurate perception matching\n//\n// Returns: true if L > threshold, false otherwise\n// Default threshold: 0.6 (slightly above middle)\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\nvariable threshold: Number = 0.6;\nif (input.length() > 1) [\n    threshold = input.get(1);\n];\n\nreturn color.l > threshold;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "slug": "is_light"
+}

package/bundled/functions/is_neutral.json

@@ -0,0 +1,65 @@
+{
+  "name": "is_neutral",
+  "type": "function",
+  "description": "Determines if a color is achromatic (neutral/gray). Uses OKLCH chroma value - colors with very low chroma are considered neutral regardless of their hue. Default threshold of 0.02 allows for near-neutral colors that appear gray to human observers.",
+  "keyword": "is_neutral",
+  "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 test",
+            "type": "color"
+          },
+          {
+            "description": "Chroma threshold (default 0.02). Lower = stricter.",
+            "type": "number"
+          }
+        ],
+        "minItems": 1,
+        "maxItems": 2
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "boolean",
+    "description": "True if color is achromatic/neutral"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// is_neutral: Check if a color is achromatic (gray)\n// Uses OKLCH chroma - low chroma means neutral\n// Threshold of 0.02 allows for near-neutral colors\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Default chroma threshold\nvariable threshold: Number = 0.02;\nif (input.length() > 1) [\n    threshold = input.get(1);\n];\n\n// Color is neutral if chroma is below threshold\nreturn color.c < threshold;"
+  },
+  "examples": [
+    {
+      "description": "Pure gray is neutral",
+      "input": [
+        "#808080"
+      ],
+      "output": true
+    },
+    {
+      "description": "Pure red is not neutral",
+      "input": [
+        "#ff0000"
+      ],
+      "output": false
+    },
+    {
+      "description": "Desaturated color may be neutral",
+      "input": [
+        "#7a7a7c"
+      ],
+      "output": true
+    }
+  ],
+  "slug": "is_neutral"
+}

package/bundled/functions/is_warm.json

@@ -0,0 +1,23 @@
+{
+  "name": "Is Warm",
+  "type": "function",
+  "description": "Checks if a color is perceptually warm. Uses OKLCH color space where warm colors have hues in the red-yellow range (roughly 0-130° and 320-360°). Returns true for warm colors (red, orange, yellow), false for cool colors (green, cyan, blue, purple). Achromatic colors are considered neutral/cool.",
+  "keyword": "is_warm",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "Color to check"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Is Warm Color\n// Determines if a color is perceptually warm or cool\n//\n// Color Temperature Psychology:\n// - Warm colors: Red, orange, yellow (associated with fire, sun)\n// - Cool colors: Blue, green, purple (associated with water, ice)\n//\n// Hue ranges (in OKLCH/HSL degrees):\n// - Warm: roughly 0-90° (red through yellow) and 330-360° (red-magenta)\n// - Cool: roughly 90-330° (yellow-green through purple)\n//\n// Achromatic colors (low chroma) are considered neutral\n// and return false (lean towards cool for safety in accessibility)\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\n// Get hue and chroma\nvariable h: Number = color.h;\nvariable c: Number = color.c;\n\n// Achromatic colors (very low chroma) are neutral\n// Return false (cool) for these\nif (c < 0.02) [\n    return false;\n];\n\n// Normalize hue to 0-360\nif (h < 0) [ h = h + 360; ];\nif (h >= 360) [ h = h - 360; ];\n\n// OKLCH Warm hue ranges:\n// In OKLCH, hue angles differ from HSL:\n// - Red: ~29°\n// - Orange: ~53°\n// - Yellow: ~110°\n// - Yellow-green: ~130°\n// - Green: ~145°\n// - Cyan: ~195°\n// - Blue: ~265°\n// - Purple: ~300°\n// - Magenta: ~330°\n//\n// Warm colors: 0-130° (red through yellow-green) and 320-360° (magenta-red)\nvariable is_warm: Boolean = false;\n\n// Check 0-130 range (red through yellow to yellow-green)\nif (h >= 0) [\n    if (h <= 130) [\n        is_warm = true;\n    ];\n];\n\n// Check 320-360 range (magenta-red)\nif (h >= 320) [\n    if (h <= 360) [\n        is_warm = true;\n    ];\n];\n\nreturn is_warm;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/oklch-color/0/"
+  ],
+  "slug": "is_warm"
+}

package/bundled/functions/lighten.json

@@ -0,0 +1,28 @@
+{
+  "name": "Lighten",
+  "type": "function",
+  "description": "Makes a color lighter by increasing its lightness in OKLab space. Amount is 0-1 where 0.25 = 25% lighter.",
+  "keyword": "lighten",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to lighten"
+      },
+      "amount": {
+        "type": "number",
+        "description": "Amount to lighten (0-1). Default is 0.25"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// lighten: Increase lightness proportionally towards white\n// Amount: 0-1 where 0.25 means 25% closer to white\n//\n// Algorithm: L' = L + (1 - L) * amount\n// This ensures we approach white (L=1) proportionally.\n//\n// Input:  Any color space (converted to OKLab internally)\n// Output: OKLCH (working space)\n// To get sRGB: lighten(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 1)\nvariable current_l: Number = color.l;\nvariable new_l: Number = current_l + (1 - current_l) * amount;\n\n// Clamp to valid range\nif (new_l > 1) [ new_l = 1; ];\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": "lighten"
+}

package/bundled/functions/lightness.json

@@ -0,0 +1,61 @@
+{
+  "name": "lightness",
+  "type": "function",
+  "description": "Extracts the perceptual lightness value from any color using OKLCH. Returns a value from 0 (black) to 1 (white). This is the 'L' in OKLCH, which is perceptually uniform - equal steps in L appear as equal steps in lightness to human vision. Essential for creating perceptually even color scales.",
+  "keyword": "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 extract lightness from",
+            "type": "color"
+          }
+        ],
+        "minItems": 1,
+        "maxItems": 1
+      }
+    },
+    "required": [
+      "input"
+    ]
+  },
+  "returns": {
+    "type": "number",
+    "description": "Perceptual lightness value (0-1)"
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// lightness: Extract perceptual lightness from a color\n// Reference: OKLCH Color Space (Björn Ottosson)\n// Reference: https://bottosson.github.io/posts/oklab/\n//\n// Returns the L component from OKLCH, which represents\n// perceptually uniform lightness. Range: 0 (black) to 1 (white).\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\n\nreturn color.l;"
+  },
+  "examples": [
+    {
+      "description": "White has lightness 1",
+      "input": [
+        "#ffffff"
+      ],
+      "output": 1
+    },
+    {
+      "description": "Black has lightness 0",
+      "input": [
+        "#000000"
+      ],
+      "output": 0
+    },
+    {
+      "description": "Mid-gray has lightness ~0.6",
+      "input": [
+        "#808080"
+      ],
+      "output": 0.6
+    }
+  ],
+  "slug": "lightness"
+}

package/bundled/functions/luminance.json

@@ -0,0 +1,23 @@
+{
+  "name": "Luminance",
+  "type": "function",
+  "description": "Returns the relative luminance of a color (0-1). Uses the WCAG formula based on linear sRGB. Useful for contrast calculations and accessibility.",
+  "keyword": "luminance",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color": {
+        "type": "color",
+        "description": "The color to measure"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Get relative luminance of a color\n// Per WCAG 2.1: L = 0.2126*R + 0.7152*G + 0.0722*B (linear RGB)\n//\n// Returns: 0 (black) to 1 (white)\n// Used for contrast calculations\n\nvariable input: List = {input};\nvariable color: Color.LinearSRGB = input.get(0).to.linearsrgb();\n\nvariable lum: Number = 0.2126 * color.r + 0.7152 * color.g + 0.0722 * color.b;\n\nreturn lum;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-linear-color/0/"
+  ],
+  "slug": "luminance"
+}

package/bundled/functions/meets_contrast.json

@@ -0,0 +1,31 @@
+{
+  "name": "Meets Contrast",
+  "type": "function",
+  "description": "Checks if two colors meet WCAG 2.1 contrast requirements. Returns true if contrast ratio meets the specified level: 'AA' (4.5:1 for normal text, 3:1 for large text), 'AAA' (7:1 for normal text, 4.5:1 for large text), or a custom ratio.",
+  "keyword": "meets_contrast",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color"
+      },
+      "threshold": {
+        "type": "number",
+        "description": "Minimum contrast ratio required (default: 4.5 for AA)"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// Meets Contrast (WCAG 2.1 Compliance Check)\n// Reference: WCAG 2.1 Success Criteria 1.4.3 and 1.4.6\n// Reference: https://www.w3.org/TR/WCAG21/#contrast-minimum\n//\n// WCAG 2.1 Contrast Levels:\n//   - Level AA (normal text):  4.5:1\n//   - Level AA (large text):   3:1\n//   - Level AAA (normal text): 7:1\n//   - Level AAA (large text):  4.5:1\n//\n// Large text is defined as:\n//   - 14pt (18.66px) bold\n//   - 18pt (24px) regular\n//\n// Returns true if the contrast ratio meets or exceeds the threshold.\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// Default threshold is 4.5 (WCAG AA for normal text)\nvariable threshold: Number = 4.5;\nif (input.length() > 2) [\n    threshold = input.get(2);\n];\n\n// Calculate relative luminance for each color\n// Formula: L = 0.2126 * R + 0.7152 * G + 0.0722 * B\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// Ensure non-negative luminance\nif (lum1 < 0) [ lum1 = 0; ];\nif (lum2 < 0) [ lum2 = 0; ];\n\n// Determine lighter and darker luminance\nvariable lighter: Number = lum1;\nvariable darker: Number = lum2;\nif (lum2 > lum1) [\n    lighter = lum2;\n    darker = lum1;\n];\n\n// Calculate contrast ratio: (L1 + 0.05) / (L2 + 0.05)\nvariable ratio: Number = (lighter + 0.05) / (darker + 0.05);\n\n// Return whether it meets the threshold\nreturn ratio >= threshold;"
+  },
+  "requirements": [
+    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-linear-color/0/"
+  ],
+  "slug": "meets_contrast"
+}

package/bundled/functions/mix.json

@@ -0,0 +1,32 @@
+{
+  "name": "Mix",
+  "type": "function",
+  "description": "Blends two colors together in OKLCH space. Amount 0 = first color, 1 = second color, 0.5 = equal blend.",
+  "keyword": "mix",
+  "input": {
+    "type": "object",
+    "properties": {
+      "color1": {
+        "type": "color",
+        "description": "First color"
+      },
+      "color2": {
+        "type": "color",
+        "description": "Second color"
+      },
+      "amount": {
+        "type": "number",
+        "description": "Blend amount (0-1). Default is 0.5"
+      }
+    }
+  },
+  "script": {
+    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+    "script": "// mix: Blend two colors in perceptual space\n// Uses shortest hue path for natural color blending.\n//\n// Algorithm: Linear interpolation on L, C, and shortest-path H\n//\n// Input:  Any color space (converted to OKLCH internally)\n// Output: OKLCH (working space)\n// To get sRGB: mix(color1, color2, 0.5).to.srgb()\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 amount is 0.5 (50/50 blend)\nvariable amount: Number = 0.5;\nif (input.length() > 2) [\n    amount = input.get(2);\n];\n\n// Interpolate lightness and chroma linearly\nvariable new_l: Number = color1.l + (color2.l - color1.l) * amount;\nvariable new_c: Number = color1.c + (color2.c - color1.c) * amount;\n\n// Interpolate hue using shortest path\nvariable h1: Number = color1.h;\nvariable h2: Number = color2.h;\nvariable h_diff: Number = h2 - h1;\n\n// Normalize to shortest path (-180 to 180)\nif (h_diff > 180) [ h_diff = h_diff - 360; ];\nif (h_diff < -180) [ h_diff = h_diff + 360; ];\n\nvariable new_h: Number = h1 + h_diff * amount;\nif (new_h < 0) [ new_h = new_h + 360; ];\nif (new_h >= 360) [ new_h = new_h - 360; ];\n\n// Create mixed color\nvariable result: Color.OKLCH;\nresult.l = new_l;\nresult.c = new_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": "mix"
+}