@tokens-studio/tokenscript-schemas 0.1.2 → 0.1.3

package/src/bundler/schema-dependency-resolver.ts

@@ -10,7 +10,7 @@ import type {
   SchemaSpecification,
 } from "@/bundler/types.js";
 import { extractSchemaName, parseSchemaUri } from "@/utils/schema-uri";
-import { bundleSchemaFromDirectory } from "./bundle-schema.js";
+import { buildSchemaFromDirectory } from "./build-schema.js";
 
 export interface SchemaReference {
   slug: string;
@@ -181,7 +181,7 @@ export async function collectRequiredSchemas(
         schemasDir || process.env.SCHEMAS_DIR || join(process.cwd(), "src/schemas");
       const schemaDir = join(resolvedSchemasDir, categoryDir, slug);
 
-      spec = await bundleSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : undefined);
+      spec = await buildSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : undefined);
     } catch (error) {
       log.warn(`Failed to load schema ${slug} (${effectiveType}):`, error);
       return;
@@ -275,7 +275,7 @@ export async function collectDependencyTree(
     const schemaDir = join(resolvedSchemasDir, categoryDir, schema.slug);
 
     try {
-      const spec = await bundleSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : undefined);
+      const spec = await buildSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : undefined);
       const requirements = extractRequirements(spec, extractOptions);
 
       // Extract just the slugs from URIs

package/src/bundler/selective-bundler.ts

@@ -5,7 +5,7 @@
 
 import { access } from "node:fs/promises";
 import { join } from "node:path";
-import { bundleSchemaFromDirectory } from "./bundle-schema.js";
+import { buildSchemaFromDirectory } from "./build-schema.js";
 import {
   collectDependencyTree,
   collectRequiredSchemasForList,
@@ -124,7 +124,7 @@ export async function bundleSelectiveSchemas(
   // Bundle type schemas
   for (const typeSlug of deps.types) {
     const schemaDir = join(schemasDir, "types", typeSlug);
-    const bundled = await bundleSchemaFromDirectory(schemaDir, { baseUrl });
+    const bundled = await buildSchemaFromDirectory(schemaDir, { baseUrl });
 
     if (bundled.type === "color") {
       const uri = `${baseUrl}/api/v1/core/${typeSlug}/0/`;
@@ -138,7 +138,7 @@ export async function bundleSelectiveSchemas(
   // Bundle function schemas
   for (const funcSlug of deps.functions) {
     const schemaDir = join(schemasDir, "functions", funcSlug);
-    const bundled = await bundleSchemaFromDirectory(schemaDir, { baseUrl });
+    const bundled = await buildSchemaFromDirectory(schemaDir, { baseUrl });
 
     if (bundled.type === "function") {
       const uri = `${baseUrl}/api/v1/function/${funcSlug}/0/`;

package/src/cli/commands/bundle.test.ts

@@ -1,4 +1,6 @@
-import { describe, expect, it, vi } from "vitest";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
 import { expandPresetSchemas } from "@/bundler/presets/index.js";
 import { bundleSchemas } from "./bundle.js";
 
@@ -88,4 +90,96 @@ describe("Bundle Command", () => {
       warnSpy.mockRestore();
     });
   });
+
+  describe("Custom Schema Directory", () => {
+    const customSchemasDir = join(process.cwd(), "test-custom-schemas");
+    const customTypeDir = join(customSchemasDir, "types", "custom-color");
+
+    beforeAll(async () => {
+      // Create custom schema directory structure
+      await mkdir(customTypeDir, { recursive: true });
+
+      // Create a custom schema.json
+      const schemaJson = {
+        name: "CustomColor",
+        type: "color" as const,
+        description: "A custom color type for testing",
+        slug: "custom-color",
+        schema: {
+          type: "object" as const,
+          properties: {
+            x: { type: "number" as const },
+            y: { type: "number" as const },
+          },
+          required: ["x", "y"],
+          additionalProperties: false,
+        },
+        initializers: [
+          {
+            keyword: "customcolor",
+            script: {
+              type: "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
+              script: "./custom-initializer.tokenscript",
+            },
+          },
+        ],
+        conversions: [] as any[],
+      };
+
+      await writeFile(
+        join(customTypeDir, "schema.json"),
+        JSON.stringify(schemaJson, null, 2),
+        "utf-8",
+      );
+
+      // Create a custom initializer script
+      const initializerScript = `
+variable x_val: Number = args.get(0);
+variable y_val: Number = args.get(1);
+variable result: Color.CustomColor = (x: x_val, y: y_val);
+result
+      `.trim();
+
+      await writeFile(join(customTypeDir, "custom-initializer.tokenscript"), initializerScript);
+    });
+
+    afterAll(async () => {
+      // Clean up custom schemas directory
+      try {
+        await rm(customSchemasDir, { recursive: true, force: true });
+      } catch {
+        // Ignore if directory doesn't exist
+      }
+    });
+
+    it("should bundle schemas from custom directory", async () => {
+      const result = await bundleSchemas(["type:custom-color"], customSchemasDir);
+
+      expect(result.output).toContain("SCHEMAS");
+      expect(result.output).toContain("custom-color");
+      expect(result.metadata.requestedSchemas).toEqual(["type:custom-color"]);
+      expect(result.metadata.resolvedDependencies).toContain("custom-color");
+    });
+
+    it("should include custom schema in output", async () => {
+      const result = await bundleSchemas(["custom-color"], customSchemasDir);
+
+      // Verify the output contains the custom schema definition
+      expect(result.output).toContain("CustomColor");
+      expect(result.output).toContain("customcolor");
+      expect(result.output).toContain("A custom color type for testing");
+    });
+
+    it("should use custom directory metadata in output", async () => {
+      const cliArgs = ["type:custom-color", "--schemas-dir", customSchemasDir];
+      const result = await bundleSchemas(["type:custom-color"], customSchemasDir, cliArgs);
+
+      expect(result.metadata.generatedBy).toContain("--schemas-dir");
+      expect(result.metadata.generatedBy).toContain(customSchemasDir);
+    });
+
+    it("should fail gracefully when schema not found in custom directory", async () => {
+      await expect(bundleSchemas(["type:nonexistent-schema"], customSchemasDir)).rejects.toThrow();
+    });
+  });
 });

package/src/cli/commands/bundle.ts

@@ -20,6 +20,7 @@ export interface BundleOptions {
   config?: string;
   output?: string;
   dryRun?: boolean;
+  schemasDir?: string; // Comma-separated list of custom schema directories
 }
 
 /**
@@ -227,11 +228,20 @@ export async function handleBundleCommand(
     if (options.dryRun) {
       cliArgs.push("--dry-run");
     }
+    if (options.schemasDir) {
+      cliArgs.push("--schemas-dir", options.schemasDir);
+    }
+
+    // Use custom schema directory if provided
+    const customSchemasDir = options.schemasDir;
+    if (customSchemasDir) {
+      log.info(`Using custom schema directory: ${customSchemasDir}`);
+    }
 
     // Bundle schemas
     const { output, metadata, dependencyTree } = await bundleSchemas(
       configSchemas,
-      undefined,
+      customSchemasDir,
       cliArgs,
     );
 

package/src/cli/index.ts

@@ -22,6 +22,7 @@ cli
   .option("-c, --config <path>", "Path to config file")
   .option("-o, --output <path>", "Output file path", { default: "./tokenscript-schemas.js" })
   .option("-d, --dry-run", "Preview what would be bundled without writing")
+  .option("-s, --schemas-dir <path>", "Custom schema directory (overrides default)")
   .action(async (schemas: string[], options: BundleOptions) => {
     try {
       await handleBundleCommand(schemas, options);

package/bundled/functions/adjust_chroma.json

@@ -1,60 +0,0 @@
-{
-  "name": "adjust_chroma",
-  "type": "function",
-  "description": "Adjusts a color's chroma by a relative amount. Positive values increase saturation, negative values decrease it. Unlike set_chroma which sets an absolute value, adjust_chroma adds to the current chroma. Result is clamped to valid range [0, ~0.4].",
-  "keyword": "adjust_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 adjust",
-            "type": "color"
-          },
-          {
-            "description": "Amount to adjust chroma (+/-)",
-            "type": "number"
-          }
-        ],
-        "minItems": 2,
-        "maxItems": 2
-      }
-    },
-    "required": [
-      "input"
-    ]
-  },
-  "returns": {
-    "type": "color",
-    "description": "Color with adjusted chroma"
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// adjust_chroma: Adjust chroma by a relative amount\n//\n// Modifies the chroma (colorfulness) of a color by adding the\n// specified amount. Positive values increase saturation,\n// negative values decrease it. Result is clamped to [0, ∞).\n//\n// Uses OKLCH for perceptually uniform results.\n// Preserves lightness and hue.\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable amount: Number = input.get(1);\n\n// Calculate new chroma\nvariable new_c: Number = color.c + amount;\n\n// Clamp to valid range (chroma cannot be negative)\nif (new_c < 0) [ new_c = 0; ];\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": "Increase saturation",
-      "input": [
-        "#808080",
-        0.1
-      ],
-      "output": "More saturated color"
-    },
-    {
-      "description": "Decrease saturation",
-      "input": [
-        "#ff6600",
-        -0.1
-      ],
-      "output": "Less saturated orange"
-    }
-  ],
-  "slug": "adjust_chroma"
-}

package/bundled/functions/adjust_hue.json

@@ -1,60 +0,0 @@
-{
-  "name": "adjust_hue",
-  "type": "function",
-  "description": "Adjusts a color's hue by a relative amount in degrees. Positive values rotate clockwise, negative values counter-clockwise. Unlike set_hue which sets an absolute value, adjust_hue adds to the current hue. Uses OKLCH for perceptually uniform hue rotation.",
-  "keyword": "adjust_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 adjust",
-            "type": "color"
-          },
-          {
-            "description": "Degrees to rotate hue (+ or -)",
-            "type": "number"
-          }
-        ],
-        "minItems": 2,
-        "maxItems": 2
-      }
-    },
-    "required": [
-      "input"
-    ]
-  },
-  "returns": {
-    "type": "color",
-    "description": "Color with adjusted hue"
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// adjust_hue: Rotate hue by a relative angle\n//\n// Adds the specified degrees to the color's hue, wrapping\n// around the 360° color wheel. Positive values rotate clockwise,\n// negative values rotate counter-clockwise.\n//\n// Uses OKLCH for perceptually uniform hue rotation.\n// Preserves lightness and chroma.\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable degrees: Number = input.get(1);\n\n// Calculate new hue\nvariable new_h: Number = color.h + degrees;\n\n// Normalize to 0-360\nwhile (new_h < 0) [\n    new_h = new_h + 360;\n];\nwhile (new_h >= 360) [\n    new_h = new_h - 360;\n];\n\n// Create result\nvariable result: Color.OKLCH;\nresult.l = color.l;\nresult.c = color.c;\nresult.h = new_h;\n\nreturn result;"
-  },
-  "examples": [
-    {
-      "description": "Shift red toward orange",
-      "input": [
-        "#ff0000",
-        30
-      ],
-      "output": "Orange color"
-    },
-    {
-      "description": "Shift blue toward green",
-      "input": [
-        "#0000ff",
-        -60
-      ],
-      "output": "Cyan color"
-    }
-  ],
-  "slug": "adjust_hue"
-}

package/bundled/functions/adjust_lightness.json

@@ -1,60 +0,0 @@
-{
-  "name": "adjust_lightness",
-  "type": "function",
-  "description": "Adjusts a color's lightness by a relative amount. Positive values make it lighter, negative values make it darker. Unlike set_lightness which sets an absolute value, adjust_lightness adds to the current lightness. Result is clamped to valid range [0, 1].",
-  "keyword": "adjust_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 adjust",
-            "type": "color"
-          },
-          {
-            "description": "Amount to adjust lightness (+/-)",
-            "type": "number"
-          }
-        ],
-        "minItems": 2,
-        "maxItems": 2
-      }
-    },
-    "required": [
-      "input"
-    ]
-  },
-  "returns": {
-    "type": "color",
-    "description": "Color with adjusted lightness"
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// adjust_lightness: Adjust lightness by a relative amount\n//\n// Modifies the lightness of a color by adding the specified\n// amount. Positive values lighten, negative values darken.\n// Result is clamped to [0, 1].\n//\n// Preserves hue and chroma.\n//\n// Input:  Any color space (converted to OKLCH internally)\n// Output: OKLCH (working space)\n// To get sRGB: adjust_lightness(color, 0.2).to.srgb()\n\nvariable input: List = {input};\nvariable color: Color.OKLCH = input.get(0).to.oklch();\nvariable amount: Number = input.get(1);\n\n// Calculate new lightness\nvariable new_l: Number = color.l + amount;\n\n// Clamp to valid range\nif (new_l < 0) [ new_l = 0; ];\nif (new_l > 1) [ new_l = 1; ];\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": "Lighten a color",
-      "input": [
-        "#808080",
-        0.2
-      ],
-      "output": "Lighter gray"
-    },
-    {
-      "description": "Darken a color",
-      "input": [
-        "#808080",
-        -0.3
-      ],
-      "output": "Darker gray"
-    }
-  ],
-  "slug": "adjust_lightness"
-}

package/bundled/functions/adjust_to_contrast.json

@@ -1,67 +0,0 @@
-{
-  "name": "adjust_to_contrast",
-  "type": "function",
-  "description": "Adjusts a foreground color's lightness to achieve a target WCAG contrast ratio against a background. Preserves hue and chroma while finding the optimal lightness. Uses binary search in OKLCH space for perceptually even adjustments. If target contrast cannot be achieved (e.g., trying to get 21:1 with mid-gray), returns the best possible result.",
-  "keyword": "adjust_to_contrast",
-  "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/",
-    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/xyz-d65-color/0/"
-  ],
-  "schema": {
-    "type": "object",
-    "properties": {
-      "input": {
-        "type": "array",
-        "items": [
-          {
-            "description": "Foreground color to adjust",
-            "type": "color"
-          },
-          {
-            "description": "Background color (fixed)",
-            "type": "color"
-          },
-          {
-            "description": "Target contrast ratio (default 4.5 for WCAG AA)",
-            "type": "number"
-          }
-        ],
-        "minItems": 2,
-        "maxItems": 3
-      }
-    },
-    "required": [
-      "input"
-    ]
-  },
-  "returns": {
-    "type": "color",
-    "description": "Adjusted foreground color meeting the target contrast"
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// adjust_to_contrast: Adjust foreground to meet target WCAG contrast ratio\n// Reference: WCAG 2.1 Contrast Ratio Definition\n// Reference: https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio\n//\n// Modifies the foreground color's lightness (in OKLCH) to achieve\n// the specified contrast ratio against the background, while\n// preserving hue and chroma.\n//\n// Parameters:\n//   foreground   - Color to adjust\n//   background   - Reference background color\n//   target_ratio - Minimum contrast ratio (default: 4.5 for WCAG AA)\n//\n// Uses binary search in OKLCH lightness for convergence.\n//\n// Input:  Any color space (converted to OKLCH internally)\n// Output: OKLCH (working space)\n// To get sRGB: adjust_to_contrast(fg, bg, 4.5).to.srgb()\n\nvariable input: List = {input};\nvariable foreground: Color.OKLCH = input.get(0).to.oklch();\nvariable bg_xyz: Color.XYZD65 = input.get(1).to.xyzd65();\n\n// Default to WCAG AA for normal text\nvariable target_ratio: Number = 4.5;\nif (input.length() > 2) [\n    target_ratio = input.get(2);\n];\n\n// Get background luminance\nvariable bg_lum: Number = bg_xyz.y;\n\n// Determine if we need to go lighter or darker\n// Test with current foreground\nvariable test_oklch: Color.OKLCH;\ntest_oklch.l = foreground.l;\ntest_oklch.c = foreground.c;\ntest_oklch.h = foreground.h;\n\nvariable test_xyz: Color.XYZD65 = test_oklch.to.srgb().to.xyzd65();\nvariable fg_lum: Number = test_xyz.y;\n\n// Calculate current contrast\nvariable l1: Number = fg_lum;\nvariable l2: Number = bg_lum;\nif (l2 > l1) [\n    l1 = bg_lum;\n    l2 = fg_lum;\n];\nvariable current_ratio: Number = (l1 + 0.05) / (l2 + 0.05);\n\n// If already meets target, return as-is (in OKLCH working space)\nif (current_ratio >= target_ratio) [\n    return foreground;\n];\n\n// Determine direction: if background is dark, we need lighter foreground and vice versa\nvariable search_min: Number = 0;\nvariable search_max: Number = 1;\n\n// Binary search for correct lightness\nvariable epsilon: Number = 0.001;\nvariable iterations: Number = 0;\nvariable max_iterations: Number = 30;\nvariable best_l: Number = foreground.l;\nvariable best_ratio: Number = current_ratio;\n\nvariable diff: Number = search_max - search_min;\nvariable mid_l: Number = 0.5;\nvariable test_ratio: Number = 1;\n\nwhile (diff > epsilon) [\n    if (iterations >= max_iterations) [\n        diff = 0;  // Force exit\n    ];\n    mid_l = (search_min + search_max) / 2;\n    \n    // Test this lightness\n    test_oklch.l = mid_l;\n    test_oklch.c = foreground.c;\n    test_oklch.h = foreground.h;\n    \n    // Convert to get luminance\n    test_xyz = test_oklch.to.srgb().to.xyzd65();\n    fg_lum = test_xyz.y;\n    \n    // Calculate contrast\n    l1 = fg_lum;\n    l2 = bg_lum;\n    if (l2 > l1) [\n        l1 = bg_lum;\n        l2 = fg_lum;\n    ];\n    test_ratio = (l1 + 0.05) / (l2 + 0.05);\n    \n    // Track best result\n    if (test_ratio >= target_ratio) [\n        // This lightness works, but can we get closer to original?\n        // If background is dark (low lum), we want darker foreground closer to original\n        // If background is light (high lum), we want lighter foreground closer to original\n        if (bg_lum < 0.18) [\n            // Dark background: search lower (darker)\n            search_max = mid_l;\n        ] else [\n            // Light background: search higher (lighter)\n            search_min = mid_l;\n        ];\n        best_l = mid_l;\n        best_ratio = test_ratio;\n    ] else [\n        // Not enough contrast, need more separation\n        if (bg_lum < 0.18) [\n            // Dark background: need lighter foreground\n            search_min = mid_l;\n        ] else [\n            // Light background: need darker foreground\n            search_max = mid_l;\n        ];\n    ];\n    \n    iterations = iterations + 1;\n    diff = search_max - search_min;\n];\n\n// Apply best lightness found, return in OKLCH working space\nvariable result: Color.OKLCH;\nresult.l = best_l;\nresult.c = foreground.c;\nresult.h = foreground.h;\n\nreturn result;"
-  },
-  "examples": [
-    {
-      "description": "Adjust light gray to meet AA on white",
-      "input": [
-        "#cccccc",
-        "#ffffff",
-        4.5
-      ],
-      "output": "Darkened gray meeting 4.5:1"
-    },
-    {
-      "description": "Adjust brand color for accessibility",
-      "input": [
-        "#6750a4",
-        "#ffffff",
-        4.5
-      ],
-      "output": "Adjusted purple meeting 4.5:1"
-    }
-  ],
-  "slug": "adjust_to_contrast"
-}

package/bundled/functions/alpha_blend.json

@@ -1,31 +0,0 @@
-{
-  "name": "Alpha Blend",
-  "type": "function",
-  "description": "Performs Porter-Duff 'over' compositing to blend a foreground color over a background color using the foreground's alpha. Formula: result = fg × α + bg × (1-α). Standard alpha compositing used in CSS and graphics software.",
-  "keyword": "alpha_blend",
-  "input": {
-    "type": "object",
-    "properties": {
-      "foreground": {
-        "type": "color",
-        "description": "Foreground (top) color"
-      },
-      "background": {
-        "type": "color",
-        "description": "Background (bottom) color"
-      },
-      "alpha": {
-        "type": "number",
-        "description": "Opacity of foreground (0-1, default: 0.5)"
-      }
-    }
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// Alpha Blend (Porter-Duff Over Compositing)\n// Reference: Porter & Duff \"Compositing Digital Images\" (1984)\n// Reference: W3C CSS Color Level 4 - Alpha Compositing\n//\n// Formula: result = foreground × α + background × (1 - α)\n// \n// This is the standard \"over\" operation:\n// - α = 0: result is entirely background\n// - α = 1: result is entirely foreground\n// - 0 < α < 1: blend of both colors\n//\n// Used in:\n// - CSS opacity and rgba\n// - Semi-transparent overlays\n// - Gradient stops\n// - Glass/frosted effects\n\nvariable input: List = {input};\nvariable fg: Color.SRGB = input.get(0).to.srgb();\nvariable bg: Color.SRGB = input.get(1).to.srgb();\n\n// Default alpha is 0.5 (50% opacity)\nvariable alpha: Number = 0.5;\nif (input.length() > 2) [\n    alpha = input.get(2);\n];\n\n// Clamp alpha to valid range\nif (alpha < 0) [ alpha = 0; ];\nif (alpha > 1) [ alpha = 1; ];\n\n// Porter-Duff \"over\" compositing\nvariable inv_alpha: Number = 1 - alpha;\n\nvariable r: Number = fg.r * alpha + bg.r * inv_alpha;\nvariable g: Number = fg.g * alpha + bg.g * inv_alpha;\nvariable b: Number = fg.b * alpha + bg.b * inv_alpha;\n\n// Create 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": "alpha_blend"
-}

package/bundled/functions/alpha_scale.json

@@ -1,27 +0,0 @@
-{
-  "name": "Alpha Scale",
-  "type": "function",
-  "description": "Generates transparency variants of a color. Returns colors with progressively lower opacity. Perfect for overlays, shadows, and layered UI elements.",
-  "keyword": "alpha_scale",
-  "input": {
-    "type": "object",
-    "properties": {
-      "color": {
-        "type": "color",
-        "description": "Base color"
-      },
-      "count": {
-        "type": "number",
-        "description": "Number of alpha steps. Default is 10"
-      }
-    }
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// Generate alpha/transparency scale\n// Returns colors from 100% opacity down to nearly transparent\n//\n// Default 10 steps: 100%, 90%, 80%, 70%, 60%, 50%, 40%, 30%, 20%, 10%\n// Useful for: overlays, shadows, backgrounds, hover states\n\nvariable input: List = {input};\nvariable base: Color.SRGB = input.get(0).to.srgb();\n\nvariable count: Number = 10;\nif (input.length() > 1) [\n    count = input.get(1);\n];\n\nvariable result: List;\nvariable i: Number = 0;\nvariable step_alpha: Number = 0;\nvariable step_color: Color.SRGB;\n\nwhile (i < count) [\n    // Alpha from 1.0 down to 0.1\n    step_alpha = 1 - (i / count);\n    \n    // Create color with alpha\n    // Note: This creates the color value; actual alpha handling\n    // depends on how the consuming system processes the output\n    step_color.r = base.r;\n    step_color.g = base.g;\n    step_color.b = base.b;\n    \n    // Store alpha as 4th value (RGBA convention)\n    // Use .to.srgb() to create a new color instance for each step\n    result = result, step_color.to.srgb(), step_alpha;\n    i = i + 1;\n];\n\nreturn result;"
-  },
-  "requirements": [
-    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
-  ],
-  "slug": "alpha_scale"
-}

package/bundled/functions/analogous.json

@@ -1,32 +0,0 @@
-{
-  "name": "Analogous",
-  "type": "function",
-  "description": "Generates analogous colors - hues adjacent on the color wheel. Creates harmonious, low-contrast palettes. Perfect for backgrounds and subtle variations.",
-  "keyword": "analogous",
-  "input": {
-    "type": "object",
-    "properties": {
-      "color": {
-        "type": "color",
-        "description": "Base color"
-      },
-      "count": {
-        "type": "number",
-        "description": "Number of colors (odd recommended). Default is 5"
-      },
-      "spread": {
-        "type": "number",
-        "description": "Total angle spread in degrees. Default is 60"
-      }
-    }
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// Generate analogous colors (adjacent hues)\n// Colors are spread evenly around the base hue\n//\n// Use case: Harmonious, subtle palettes\n// Example: 5 colors with 60° spread = -30°, -15°, 0°, +15°, +30°\n\nvariable input: List = {input};\nvariable base: Color.OKLCH = input.get(0).to.oklch();\n\nvariable count: Number = 5;\nif (input.length() > 1) [\n    count = input.get(1);\n];\n\nvariable spread: Number = 60;\nif (input.length() > 2) [\n    spread = input.get(2);\n];\n\n// Calculate step size and starting offset\nvariable step: Number = spread / (count - 1);\nvariable start_offset: Number = 0 - spread / 2;\n\nvariable result: List;\nvariable i: Number = 0;\nvariable hue_offset: Number = 0;\nvariable new_hue: Number = 0;\nvariable color: Color.OKLCH;\n\nwhile (i < count) [\n    hue_offset = start_offset + i * step;\n    new_hue = base.h + hue_offset;\n    \n    // Normalize hue to 0-360\n    if (new_hue < 0) [ new_hue = new_hue + 360; ];\n    if (new_hue >= 360) [ new_hue = new_hue - 360; ];\n    \n    color.l = base.l;\n    color.c = base.c;\n    color.h = new_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": "analogous"
-}

package/bundled/functions/apca_contrast.json

@@ -1,27 +0,0 @@
-{
-  "name": "APCA Contrast",
-  "type": "function",
-  "description": "Calculates APCA (Accessible Perceptual Contrast Algorithm) contrast between text and background colors. APCA is part of WCAG 3.0 draft and provides perceptually uniform contrast values. Returns Lc value from -108 to +106. Positive = light text on dark, negative = dark text on light. |Lc| ≥ 60 recommended for body text.",
-  "keyword": "apca_contrast",
-  "input": {
-    "type": "object",
-    "properties": {
-      "text": {
-        "type": "color",
-        "description": "Text/foreground color"
-      },
-      "background": {
-        "type": "color",
-        "description": "Background color"
-      }
-    }
-  },
-  "script": {
-    "type": "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/tokenscript/0/",
-    "script": "// APCA Contrast (Accessible Perceptual Contrast Algorithm)\n// Version: APCA 0.0.98G (W3C/WCAG 3.0 Draft)\n// Reference: https://github.com/Myndex/apca-w3\n// Reference: https://www.w3.org/TR/wcag-3.0/#visual-contrast-of-text\n//\n// Returns Lc (Lightness contrast) value:\n//   - Range: approximately -108 to +106\n//   - Positive values: light text on dark background\n//   - Negative values: dark text on light background\n//   - |Lc| >= 75: Preferred for body text\n//   - |Lc| >= 60: Minimum for body text\n//   - |Lc| >= 45: Minimum for large text (≥24px)\n//   - |Lc| >= 30: Minimum for non-text elements\n//\n// Algorithm:\n// 1. Convert to sRGB and linearize with simple 2.4 gamma\n// 2. Calculate screen luminance Y with sRGB coefficients\n// 3. Apply soft black clamp for flare compensation\n// 4. Calculate contrast with asymmetric formula (BoW vs WoB)\n// 5. Apply low clip and offset\n\nvariable input: List = {input};\nvariable text: Color.SRGB = input.get(0).to.srgb();\nvariable bg: Color.SRGB = input.get(1).to.srgb();\n\n// APCA Constants (from specification)\n// Exponents\nvariable norm_bg: Number = 0.56;\nvariable norm_txt: Number = 0.57;\nvariable rev_txt: Number = 0.62;\nvariable rev_bg: Number = 0.65;\n\n// Soft black clamp constants\nvariable blk_thrs: Number = 0.022;\nvariable blk_clmp: Number = 1.414;\n\n// Low clip (noise gate)\nvariable lo_clip: Number = 0.1;\nvariable delta_y_min: Number = 0.0005;\n\n// Scalers and offset\nvariable scale_bow: Number = 1.14;\nvariable scale_wob: Number = 1.14;\nvariable lo_offset: Number = 0.027;\n\n// Linearize sRGB with simple 2.4 gamma (NOT full sRGB transfer function)\n// This is per APCA specification which uses simplified gamma\nvariable text_r: Number = text.r;\nvariable text_g: Number = text.g;\nvariable text_b: Number = text.b;\nvariable bg_r: Number = bg.r;\nvariable bg_g: Number = bg.g;\nvariable bg_b: Number = bg.b;\n\n// Handle negative values (out of gamut)\nif (text_r < 0) [ text_r = 0 - text_r; ];\nif (text_g < 0) [ text_g = 0 - text_g; ];\nif (text_b < 0) [ text_b = 0 - text_b; ];\nif (bg_r < 0) [ bg_r = 0 - bg_r; ];\nif (bg_g < 0) [ bg_g = 0 - bg_g; ];\nif (bg_b < 0) [ bg_b = 0 - bg_b; ];\n\n// Linearize with 2.4 gamma\nvariable lin_text_r: Number = pow(text_r, 2.4);\nvariable lin_text_g: Number = pow(text_g, 2.4);\nvariable lin_text_b: Number = pow(text_b, 2.4);\nvariable lin_bg_r: Number = pow(bg_r, 2.4);\nvariable lin_bg_g: Number = pow(bg_g, 2.4);\nvariable lin_bg_b: Number = pow(bg_b, 2.4);\n\n// Calculate screen luminance Y using sRGB coefficients\n// Coefficients from Myndex/APCA spec (via Lindbloom)\nvariable y_text: Number = 0.2126729 * lin_text_r + 0.7151522 * lin_text_g + 0.0721750 * lin_text_b;\nvariable y_bg: Number = 0.2126729 * lin_bg_r + 0.7151522 * lin_bg_g + 0.0721750 * lin_bg_b;\n\n// Soft clamp for flare (low luminance adjustment)\n// If Y >= threshold, use Y as-is\n// Otherwise: Y + (threshold - Y)^1.414\nvariable y_txt_clamped: Number = y_text;\nvariable y_bg_clamped: Number = y_bg;\n\nif (y_text < blk_thrs) [\n    variable diff_txt: Number = blk_thrs - y_text;\n    y_txt_clamped = y_text + pow(diff_txt, blk_clmp);\n];\n\nif (y_bg < blk_thrs) [\n    variable diff_bg: Number = blk_thrs - y_bg;\n    y_bg_clamped = y_bg + pow(diff_bg, blk_clmp);\n];\n\n// Determine polarity: BoW (dark on light) or WoB (light on dark)\nvariable sapc: Number = 0;\nvariable s_contrast: Number = 0;\n\n// Noise gate check\nvariable y_diff: Number = y_bg_clamped - y_txt_clamped;\nif (y_diff < 0) [ y_diff = 0 - y_diff; ];\n\n// Negative lo_clip for comparison (avoid parsing issues)\nvariable neg_lo_clip: Number = 0 - lo_clip;\n\nif (y_diff >= delta_y_min) [\n    if (y_bg_clamped > y_txt_clamped) [\n        // BoW: Dark text on light background (returns POSITIVE per APCA spec)\n        s_contrast = pow(y_bg_clamped, norm_bg) - pow(y_txt_clamped, norm_txt);\n        sapc = s_contrast * scale_bow;\n        \n        if (sapc < lo_clip) [\n            sapc = 0;\n        ] else [\n            sapc = sapc - lo_offset;\n        ];\n    ] else [\n        // WoB: Light text on dark background (returns NEGATIVE per APCA spec)\n        s_contrast = pow(y_bg_clamped, rev_bg) - pow(y_txt_clamped, rev_txt);\n        sapc = s_contrast * scale_wob;\n        \n        if (sapc > neg_lo_clip) [\n            sapc = 0;\n        ] else [\n            sapc = sapc + lo_offset;\n        ];\n    ];\n];\n\n// Return Lc * 100 (standard APCA output format)\nreturn sapc * 100;"
-  },
-  "requirements": [
-    "https://schema.tokenscript.dev.gcp.tokens.studio/api/v1/core/srgb-color/0/"
-  ],
-  "slug": "apca_contrast"
-}