@primer/primitives 11.4.0 → 11.4.1-rc.0499d5a6

package/dist/build/schemas/colorToken.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { colorHexValue } from './colorHexValue.js';
+import { colorW3cValue } from './colorW3cValue.js';
 import { referenceValue } from './referenceValue.js';
 import { alphaValue } from './alphaValue.js';
 import { baseToken } from './baseToken.js';
@@ -8,10 +9,10 @@ import { scopes } from './scopes.js';
 import { tokenType } from './tokenType.js';
 import { llmExtension } from './llmExtension.js';
 const baseColorToken = baseToken.extend({
-    $value: z.union([colorHexValue, referenceValue]),
+    $value: z.union([colorHexValue, colorW3cValue, referenceValue]),
     alpha: alphaValue.optional().nullable(),
 });
-const override = z.union([colorHexValue, referenceValue, baseColorToken.partial()]).optional();
+const override = z.union([colorHexValue, colorW3cValue, referenceValue, baseColorToken.partial()]).optional();
 export const colorToken = baseColorToken
     .extend({
     $type: tokenType('color'),

package/dist/build/schemas/colorW3cValue.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/**
+ * W3C DTCG color value schema
+ * @see https://www.designtokens.org/tr/drafts/color/#color-type
+ */
+export declare const colorW3cValue: z.ZodObject<{
+    colorSpace: z.ZodEnum<{
+        "display-p3": "display-p3";
+        srgb: "srgb";
+        rec2020: "rec2020";
+        "srgb-linear": "srgb-linear";
+        hsl: "hsl";
+        hwb: "hwb";
+        lab: "lab";
+        lch: "lch";
+        oklab: "oklab";
+        oklch: "oklch";
+        "a98-rgb": "a98-rgb";
+        "prophoto-rgb": "prophoto-rgb";
+        xyz: "xyz";
+        "xyz-d50": "xyz-d50";
+        "xyz-d65": "xyz-d65";
+    }>;
+    components: z.ZodTuple<[z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>], null>;
+    alpha: z.ZodOptional<z.ZodNumber>;
+    hex: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ColorW3cValue = z.infer<typeof colorW3cValue>;

package/dist/build/schemas/colorW3cValue.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * W3C DTCG color spaces
+ * @see https://www.designtokens.org/tr/drafts/color/#supported-color-spaces
+ */
+const colorSpace = z.enum([
+    'srgb',
+    'srgb-linear',
+    'hsl',
+    'hwb',
+    'lab',
+    'lch',
+    'oklab',
+    'oklch',
+    'display-p3',
+    'a98-rgb',
+    'prophoto-rgb',
+    'rec2020',
+    'xyz',
+    'xyz-d50',
+    'xyz-d65',
+]);
+/**
+ * A color component: a number, or the 'none' keyword for missing components.
+ * @see https://www.designtokens.org/tr/drafts/color/#the-none-keyword
+ */
+const colorComponent = z.union([z.number(), z.literal('none')]);
+/**
+ * W3C DTCG color value schema
+ * @see https://www.designtokens.org/tr/drafts/color/#color-type
+ */
+export const colorW3cValue = z
+    .object({
+    colorSpace: colorSpace,
+    components: z.tuple([colorComponent, colorComponent, colorComponent]),
+    alpha: z.number().min(0).max(1).optional(),
+    hex: z
+        .string()
+        .regex(/^#[0-9a-fA-F]{6}$/)
+        .optional(),
+})
+    .strict();

package/dist/build/schemas/cubicBezierToken.d.ts

@@ -3,7 +3,7 @@ export declare const cubicBezierToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
     $value: z.ZodUnion<readonly [z.ZodArray<z.ZodNumber>, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.llm': z.ZodOptional<z.ZodObject<{
             usage: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/build/schemas/dimensionToken.d.ts

@@ -2,8 +2,15 @@ import { z } from 'zod';
 export declare const dimensionToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
-    $value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"0">, z.ZodLiteral<0>]>, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $value: z.ZodUnion<readonly [z.ZodObject<{
+        value: z.ZodNumber;
+        unit: z.ZodEnum<{
+            em: "em";
+            px: "px";
+            rem: "rem";
+        }>;
+    }, z.core.$strict>, z.ZodString]>;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.figma': z.ZodOptional<z.ZodObject<{
             collection: z.ZodString;

package/dist/build/schemas/dimensionValue.d.ts

@@ -1,2 +1,13 @@
 import { z } from 'zod';
-export declare const dimensionValue: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"0">, z.ZodLiteral<0>]>;
+/**
+ * W3C DTCG dimension value format
+ * @link https://www.designtokens.org/tr/drafts/format/#dimension
+ */
+export declare const dimensionValue: z.ZodObject<{
+    value: z.ZodNumber;
+    unit: z.ZodEnum<{
+        em: "em";
+        px: "px";
+        rem: "rem";
+    }>;
+}, z.core.$strict>;

package/dist/build/schemas/dimensionValue.js

@@ -1,14 +1,11 @@
 import { z } from 'zod';
-import { schemaErrorMessage } from '../utilities/index.js';
-export const dimensionValue = z.union([
-    z.string().superRefine((dim, ctx) => {
-        if (!/(^-?[0-9]+\.?[0-9]*(px|rem)$|^-?[0-9]+\.?[0-9]*em$)/.test(dim)) {
-            ctx.addIssue({
-                code: 'custom',
-                message: schemaErrorMessage(`Invalid dimension: "${dim}"`, `Dimension must be a string with a unit (px, rem or em) or 0`),
-            });
-        }
-    }),
-    z.literal('0'),
-    z.literal(0),
-]);
+/**
+ * W3C DTCG dimension value format
+ * @link https://www.designtokens.org/tr/drafts/format/#dimension
+ */
+export const dimensionValue = z
+    .object({
+    value: z.number(),
+    unit: z.enum(['px', 'rem', 'em']),
+})
+    .strict();

package/dist/build/schemas/durationToken.d.ts

@@ -2,8 +2,14 @@ import { z } from 'zod';
 export declare const durationToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
-    $value: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $value: z.ZodUnion<readonly [z.ZodObject<{
+        value: z.ZodNumber;
+        unit: z.ZodEnum<{
+            s: "s";
+            ms: "ms";
+        }>;
+    }, z.core.$strict>, z.ZodString]>;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.llm': z.ZodOptional<z.ZodObject<{
             usage: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/build/schemas/durationValue.d.ts

@@ -1,2 +1,12 @@
 import { z } from 'zod';
-export declare const durationValue: z.ZodString;
+/**
+ * W3C DTCG duration value format
+ * @see https://www.designtokens.org/tr/2025.10/format/#duration
+ */
+export declare const durationValue: z.ZodObject<{
+    value: z.ZodNumber;
+    unit: z.ZodEnum<{
+        s: "s";
+        ms: "ms";
+    }>;
+}, z.core.$strict>;

package/dist/build/schemas/durationValue.js

@@ -1,10 +1,20 @@
 import { z } from 'zod';
 import { schemaErrorMessage } from '../utilities/index.js';
-export const durationValue = z.string().superRefine((duration, ctx) => {
-    if (!/^[0-9]+ms$/.test(duration)) {
+/**
+ * W3C DTCG duration value format
+ * @see https://www.designtokens.org/tr/2025.10/format/#duration
+ */
+export const durationValue = z
+    .object({
+    value: z.number(),
+    unit: z.enum(['ms', 's']),
+})
+    .strict()
+    .superRefine((duration, ctx) => {
+    if (typeof duration.value !== 'number') {
         ctx.addIssue({
             code: 'custom',
-            message: schemaErrorMessage(`Invalid duration: "${duration}"`, `A duration must be a string with an "ms"`),
+            message: schemaErrorMessage(`Invalid duration value: "${duration.value}"`, `Duration value must be a number`),
         });
     }
 });

package/dist/build/schemas/fontFamilyToken.d.ts

@@ -3,7 +3,7 @@ export declare const fontFamilyToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
     $value: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.figma': z.ZodObject<{
             collection: z.ZodOptional<z.ZodString>;

package/dist/build/schemas/fontWeightToken.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 export declare const fontWeightToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.figma': z.ZodObject<{

package/dist/build/schemas/gradientToken.d.ts

@@ -3,10 +3,31 @@ export declare const gradientToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
     $value: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
-        color: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        color: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            colorSpace: z.ZodEnum<{
+                "display-p3": "display-p3";
+                srgb: "srgb";
+                rec2020: "rec2020";
+                "srgb-linear": "srgb-linear";
+                hsl: "hsl";
+                hwb: "hwb";
+                lab: "lab";
+                lch: "lch";
+                oklab: "oklab";
+                oklch: "oklch";
+                "a98-rgb": "a98-rgb";
+                "prophoto-rgb": "prophoto-rgb";
+                xyz: "xyz";
+                "xyz-d50": "xyz-d50";
+                "xyz-d65": "xyz-d65";
+            }>;
+            components: z.ZodTuple<[z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"none">]>], null>;
+            alpha: z.ZodOptional<z.ZodNumber>;
+            hex: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodString]>;
         position: z.ZodNumber;
     }, z.core.$strip>>, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.gradient': z.ZodObject<{
             angle: z.ZodOptional<z.ZodNumber>;

package/dist/build/schemas/gradientToken.js

@@ -3,13 +3,14 @@ import { baseToken } from './baseToken.js';
 import { referenceValue } from './referenceValue.js';
 import { tokenType } from './tokenType.js';
 import { colorHexValue } from './colorHexValue.js';
+import { colorW3cValue } from './colorW3cValue.js';
 import { llmExtension } from './llmExtension.js';
 export const gradientToken = baseToken
     .extend({
     $value: z.union([
         z
             .array(z.object({
-            color: z.union([colorHexValue, referenceValue]),
+            color: z.union([colorHexValue, colorW3cValue, referenceValue]),
             position: z.number().min(0).max(1),
         }))
             .min(2),

package/dist/build/schemas/numberToken.d.ts

@@ -3,7 +3,7 @@ export declare const numberToken: z.ZodObject<{
     $description: z.ZodOptional<z.ZodString>;
     $deprecated: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
     $value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
-    $type: z.ZodLiteral<"string" | "number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "dimension" | "duration" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange">;
+    $type: z.ZodLiteral<"number" | "border" | "color" | "fontFamily" | "fontWeight" | "transition" | "duration" | "dimension" | "gradient" | "shadow" | "typography" | "cubicBezier" | "custom-viewportRange" | "custom-string">;
     $extensions: z.ZodOptional<z.ZodObject<{
         'org.primer.data': z.ZodOptional<z.ZodObject<{
             fontSize: z.ZodOptional<z.ZodNumber>;