@compact-design/core 0.1.0 → 0.2.0

package/dist/generated-schema.d.ts

@@ -462,7 +462,7 @@ declare const _default: {
             readonly required: readonly ["type"];
             readonly properties: {
                 readonly type: {
-                    readonly enum: readonly ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"];
+                    readonly enum: readonly ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR", "NOISE", "TEXTURE", "GLASS", "SHADER"];
                 };
                 readonly color: {
                     readonly oneOf: readonly [{
@@ -489,7 +489,94 @@ declare const _default: {
                 readonly blendMode: {
                     readonly type: "string";
                 };
+                readonly showShadowBehindNode: {
+                    readonly type: "boolean";
+                };
+                readonly blurType: {
+                    readonly enum: readonly ["NORMAL", "PROGRESSIVE"];
+                };
+                readonly startRadius: {
+                    readonly $ref: "#/$defs/nonNegativeNumber";
+                };
+                readonly startOffset: {
+                    readonly $ref: "#/$defs/vector";
+                };
+                readonly endOffset: {
+                    readonly $ref: "#/$defs/vector";
+                };
+                readonly noiseType: {
+                    readonly enum: readonly ["MONOTONE", "DUOTONE", "MULTITONE"];
+                };
+                readonly noiseSize: {
+                    readonly $ref: "#/$defs/nonNegativeNumber";
+                };
+                readonly density: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly secondaryColor: {
+                    readonly oneOf: readonly [{
+                        readonly $ref: "#/$defs/hexColor";
+                    }, {
+                        readonly $ref: "#/$defs/color";
+                    }];
+                };
+                readonly opacity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly clipToShape: {
+                    readonly type: "boolean";
+                };
+                readonly lightIntensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly lightAngle: {
+                    readonly type: "number";
+                };
+                readonly refraction: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly depth: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                };
+                readonly dispersion: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly properties: {
+                    readonly type: "object";
+                    readonly description: "SHADER property assignments keyed by Figma property-definition id. Values pass through verbatim (numbers, booleans, strings, colors, points, gradients, or variable aliases).";
+                    readonly additionalProperties: {
+                        readonly type: readonly ["boolean", "string", "number", "object"];
+                    };
+                };
             };
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "SHADER";
+                        };
+                    };
+                    readonly required: readonly ["type"];
+                };
+                readonly then: {
+                    readonly required: readonly ["id"];
+                };
+            }];
         };
         readonly shadow: {
             readonly type: "object";
@@ -873,7 +960,7 @@ declare const _default: {
             readonly required: readonly ["data"];
             readonly properties: {
                 readonly windingRule: {
-                    readonly enum: readonly ["NONZERO", "EVENODD"];
+                    readonly enum: readonly ["NONZERO", "EVENODD", "NONE"];
                 };
                 readonly data: {
                     readonly type: "string";
@@ -1187,7 +1274,7 @@ declare const _default: {
                     };
                 };
                 readonly overflowDirection: {
-                    readonly enum: readonly ["NONE", "HORIZONTAL_SCROLLING", "VERTICAL_SCROLLING", "HORIZONTAL_AND_VERTICAL_SCROLLING"];
+                    readonly enum: readonly ["NONE", "HORIZONTAL", "VERTICAL", "BOTH", "HORIZONTAL_SCROLLING", "VERTICAL_SCROLLING", "HORIZONTAL_AND_VERTICAL_SCROLLING"];
                 };
                 readonly numberOfFixedChildren: {
                     readonly type: "integer";

package/dist/index.cjs

@@ -7314,15 +7314,85 @@ function effects(raw) {
   values.push(...raw.effects || []);
   return values.map(effect);
 }
+function resolveColor(value) {
+  return hexColor(value) || (typeof value === "object" && value ? value : void 0);
+}
 function effect(value) {
   if (!value || typeof value !== "object") return value;
+  const type = String(value.type || "DROP_SHADOW").toUpperCase();
+  const visible = value.visible !== false;
+  if (type === "DROP_SHADOW" || type === "INNER_SHADOW") {
+    return {
+      type,
+      color: resolveColor(value.color),
+      offset: value.offset || { x: 0, y: 4 },
+      radius: value.blur ?? value.radius ?? 8,
+      spread: value.spread || 0,
+      visible,
+      ...value.blendMode ? { blendMode: value.blendMode } : {},
+      ...type === "DROP_SHADOW" && typeof value.showShadowBehindNode === "boolean" ? { showShadowBehindNode: value.showShadowBehindNode } : {}
+    };
+  }
+  if (type === "LAYER_BLUR" || type === "BACKGROUND_BLUR") {
+    return {
+      type,
+      radius: value.blur ?? value.radius ?? 8,
+      visible,
+      ...value.blurType ? { blurType: value.blurType } : {},
+      ...value.startRadius !== void 0 ? { startRadius: value.startRadius } : {},
+      ...value.startOffset ? { startOffset: value.startOffset } : {},
+      ...value.endOffset ? { endOffset: value.endOffset } : {}
+    };
+  }
+  if (type === "NOISE") {
+    return {
+      type,
+      color: resolveColor(value.color),
+      visible,
+      ...value.blendMode ? { blendMode: value.blendMode } : {},
+      noiseType: value.noiseType || "MONOTONE",
+      noiseSize: value.noiseSize ?? 1,
+      density: value.density ?? 1,
+      ...value.secondaryColor !== void 0 ? { secondaryColor: resolveColor(value.secondaryColor) } : {},
+      ...value.opacity !== void 0 ? { opacity: value.opacity } : {}
+    };
+  }
+  if (type === "TEXTURE") {
+    return {
+      type,
+      visible,
+      noiseSize: value.noiseSize ?? 1,
+      radius: value.blur ?? value.radius ?? 0,
+      clipToShape: value.clipToShape !== false
+    };
+  }
+  if (type === "GLASS") {
+    return {
+      type,
+      visible,
+      lightIntensity: value.lightIntensity ?? 0.5,
+      lightAngle: value.lightAngle ?? -45,
+      refraction: value.refraction ?? 0.5,
+      depth: value.depth ?? 1,
+      dispersion: value.dispersion ?? 0.1,
+      radius: value.blur ?? value.radius ?? 0
+    };
+  }
+  if (type === "SHADER") {
+    return {
+      type,
+      id: typeof value.id === "string" ? value.id : "",
+      visible,
+      ...value.properties && typeof value.properties === "object" && !Array.isArray(value.properties) ? { properties: value.properties } : {}
+    };
+  }
   return {
-    type: String(value.type || "DROP_SHADOW").toUpperCase(),
-    color: hexColor(value.color) || (typeof value.color === "object" ? value.color : void 0),
+    type,
+    color: resolveColor(value.color),
     offset: value.offset || { x: 0, y: 4 },
     radius: value.blur ?? value.radius ?? 8,
     spread: value.spread || 0,
-    visible: value.visible !== false
+    visible
   };
 }
 var passthrough = [
@@ -7399,6 +7469,9 @@ function normalizeNode(node, parent, path) {
   if (typeof raw.overflowDirection === "string") {
     const overflowDirections = {
       NONE: "NONE",
+      HORIZONTAL: "HORIZONTAL",
+      VERTICAL: "VERTICAL",
+      BOTH: "BOTH",
       HORIZONTAL_SCROLLING: "HORIZONTAL",
       VERTICAL_SCROLLING: "VERTICAL",
       HORIZONTAL_AND_VERTICAL_SCROLLING: "BOTH"
@@ -7528,6 +7601,8 @@ function normalizeDocument(value) {
         children: canvas.nodes || []
       }, { x: 0, y: 0 }, `canvas-${index}`);
       root.properties.breakpoint = canvas.breakpoint;
+      if (canvas.variableModes) root.properties.variableModes = canvas.variableModes;
+      if (canvas.bindings) root.properties.bindings = canvas.bindings;
       return root;
     }),
     styles: normalizeStyles(source.styles),
@@ -7866,15 +7941,43 @@ var generated_schema_default = {
       "additionalProperties": false,
       "required": ["type"],
       "properties": {
-        "type": { "enum": ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"] },
+        "type": { "enum": ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR", "NOISE", "TEXTURE", "GLASS", "SHADER"] },
         "color": { "oneOf": [{ "$ref": "#/$defs/hexColor" }, { "$ref": "#/$defs/color" }] },
         "offset": { "$ref": "#/$defs/vector" },
         "blur": { "$ref": "#/$defs/nonNegativeNumber" },
         "radius": { "$ref": "#/$defs/nonNegativeNumber" },
         "spread": { "type": "number" },
         "visible": { "type": "boolean" },
-        "blendMode": { "type": "string" }
-      }
+        "blendMode": { "type": "string" },
+        "showShadowBehindNode": { "type": "boolean" },
+        "blurType": { "enum": ["NORMAL", "PROGRESSIVE"] },
+        "startRadius": { "$ref": "#/$defs/nonNegativeNumber" },
+        "startOffset": { "$ref": "#/$defs/vector" },
+        "endOffset": { "$ref": "#/$defs/vector" },
+        "noiseType": { "enum": ["MONOTONE", "DUOTONE", "MULTITONE"] },
+        "noiseSize": { "$ref": "#/$defs/nonNegativeNumber" },
+        "density": { "type": "number", "minimum": 0, "maximum": 1 },
+        "secondaryColor": { "oneOf": [{ "$ref": "#/$defs/hexColor" }, { "$ref": "#/$defs/color" }] },
+        "opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "clipToShape": { "type": "boolean" },
+        "lightIntensity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "lightAngle": { "type": "number" },
+        "refraction": { "type": "number", "minimum": 0, "maximum": 1 },
+        "depth": { "type": "number", "minimum": 1 },
+        "dispersion": { "type": "number", "minimum": 0, "maximum": 1 },
+        "id": { "type": "string", "minLength": 1 },
+        "properties": {
+          "type": "object",
+          "description": "SHADER property assignments keyed by Figma property-definition id. Values pass through verbatim (numbers, booleans, strings, colors, points, gradients, or variable aliases).",
+          "additionalProperties": { "type": ["boolean", "string", "number", "object"] }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "SHADER" } }, "required": ["type"] },
+          "then": { "required": ["id"] }
+        }
+      ]
     },
     "shadow": {
       "type": "object",
@@ -8180,7 +8283,7 @@ var generated_schema_default = {
       "additionalProperties": false,
       "required": ["data"],
       "properties": {
-        "windingRule": { "enum": ["NONZERO", "EVENODD"] },
+        "windingRule": { "enum": ["NONZERO", "EVENODD", "NONE"] },
         "data": { "type": "string", "minLength": 1 }
       }
     },
@@ -8338,6 +8441,9 @@ var generated_schema_default = {
         "overflowDirection": {
           "enum": [
             "NONE",
+            "HORIZONTAL",
+            "VERTICAL",
+            "BOTH",
             "HORIZONTAL_SCROLLING",
             "VERTICAL_SCROLLING",
             "HORIZONTAL_AND_VERTICAL_SCROLLING"
@@ -8702,6 +8808,7 @@ function validateDocument(document) {
     if (node.type === "SVG" && typeof props.svg !== "string") add(`${path}.svg`, "SVG requires markup");
     if (node.type === "VECTOR" && !Array.isArray(props.vectorPaths)) add(`${path}.vectorPaths`, "VECTOR requires vectorPaths");
     if (node.type === "INSTANCE" && typeof props.componentId !== "string") add(`${path}.componentId`, "INSTANCE requires componentId");
+    if (node.type === "BOOLEAN_OPERATION" && (typeof props.operation !== "string" || !["UNION", "SUBTRACT", "INTERSECT", "EXCLUDE"].includes(props.operation))) add(`${path}.operation`, "BOOLEAN_OPERATION requires operation UNION, SUBTRACT, INTERSECT, or EXCLUDE");
     if (node.type === "COMPONENT_SET" && (!node.children.length || node.children.some((child) => child.type !== "COMPONENT"))) add(`${path}.children`, "COMPONENT_SET requires COMPONENT children");
     if (node.type === "COMPONENT_SET" && props.variantAxes) {
       for (const [axis, options] of Object.entries(props.variantAxes)) if (!axis || !Array.isArray(options) || !options.length || options.some((option) => typeof option !== "string")) add(`${path}.variantAxes.${axis}`, "must be a non-empty string array");
@@ -8720,13 +8827,29 @@ function validateDocument(document) {
     node.children.forEach((child, index) => references(child, `${path}.children[${index}]`));
   }
   document.nodes.forEach((node, index) => references(node, `nodes[${index}]`));
+  const styleKeys = /* @__PURE__ */ new Map();
+  for (const style of document.styles || []) {
+    if (typeof style.id === "string" && style.id) styleKeys.set(style.id, style.type);
+    if (typeof style.name === "string" && style.name) styleKeys.set(style.name, style.type);
+  }
+  const variableKeys = /* @__PURE__ */ new Set();
+  const collectionNames = /* @__PURE__ */ new Set();
+  const modesByCollection = /* @__PURE__ */ new Map();
   for (const [collectionIndex, collection] of (document.variables || []).entries()) {
     const modes = Array.isArray(collection.modes) && collection.modes.length ? collection.modes : [];
     if (collection.modes !== void 0 && (!modes.length || modes.some((mode) => typeof mode !== "string"))) add(`variables[${collectionIndex}].modes`, "must be a non-empty array of mode names");
+    if (typeof collection.name === "string" && collection.name) {
+      collectionNames.add(collection.name);
+      if (collection.modes !== void 0 && modes.length && modes.every((mode) => typeof mode === "string")) {
+        modesByCollection.set(collection.name, modes);
+      }
+    }
     for (const [variableIndex, variable] of (collection.items || []).entries()) {
       const path = `variables[${collectionIndex}].items[${variableIndex}]`;
       if (!variable.name || typeof variable.name !== "string") add(`${path}.name`, "must be a non-empty string");
       if (!["COLOR", "FLOAT", "STRING", "BOOLEAN"].includes(variable.type)) add(`${path}.type`, "must be COLOR, FLOAT, STRING, or BOOLEAN");
+      if (typeof variable.id === "string" && variable.id) variableKeys.add(variable.id);
+      if (typeof variable.name === "string" && variable.name) variableKeys.add(variable.name);
       const values = variable.values || (variable.value !== void 0 ? { default: variable.value } : {});
       if (!Object.keys(values).length) add(`${path}`, "requires value or values");
       if (variable.values && modes.length) {
@@ -8741,6 +8864,54 @@ function validateDocument(document) {
       }
     }
   }
+  function tokenReferences(node, path) {
+    const bindings = node.properties.bindings;
+    if (bindings) {
+      for (const [field, key] of Object.entries(bindings)) {
+        if (typeof key !== "string" || !key) {
+          add(`${path}.bindings.${field}`, "must be a non-empty variable id or name");
+          continue;
+        }
+        if (!variableKeys.has(key)) add(`${path}.bindings.${field}`, `variable '${key}' is not defined in this document`);
+      }
+    }
+    const variableModes = node.properties.variableModes;
+    if (variableModes) {
+      for (const [collectionName, modeName] of Object.entries(variableModes)) {
+        if (!collectionNames.has(collectionName)) {
+          add(`${path}.variableModes.${collectionName}`, `variable collection '${collectionName}' is not defined in this document`);
+          continue;
+        }
+        if (typeof modeName !== "string" || !modeName) {
+          add(`${path}.variableModes.${collectionName}`, "must be a non-empty mode name");
+          continue;
+        }
+        const declared = modesByCollection.get(collectionName);
+        if (declared && !declared.includes(modeName)) add(`${path}.variableModes.${collectionName}`, `mode '${modeName}' is not declared on collection '${collectionName}'`);
+      }
+    }
+    const styleRefs = node.properties.styleRefs;
+    if (styleRefs) {
+      for (const [field, key] of Object.entries(styleRefs)) {
+        if (typeof key !== "string" || !key) {
+          add(`${path}.styleRefs.${field}`, "must be a non-empty style id or name");
+          continue;
+        }
+        const styleType = styleKeys.get(key);
+        if (!styleType) {
+          add(`${path}.styleRefs.${field}`, `style '${key}' is not defined in this document`);
+          continue;
+        }
+        if ((field === "fill" || field === "stroke") && styleType !== "PAINT") {
+          add(`${path}.styleRefs.${field}`, `style '${key}' has type ${styleType} but ${field} requires PAINT`);
+        } else if (field === "text" && styleType !== "TEXT") {
+          add(`${path}.styleRefs.${field}`, `style '${key}' has type ${styleType} but text requires TEXT`);
+        }
+      }
+    }
+    node.children.forEach((child, index) => tokenReferences(child, `${path}.children[${index}]`));
+  }
+  document.nodes.forEach((node, index) => tokenReferences(node, `nodes[${index}]`));
   return errors;
 }
 

package/dist/index.js

@@ -7293,15 +7293,85 @@ function effects(raw) {
   values.push(...raw.effects || []);
   return values.map(effect);
 }
+function resolveColor(value) {
+  return hexColor(value) || (typeof value === "object" && value ? value : void 0);
+}
 function effect(value) {
   if (!value || typeof value !== "object") return value;
+  const type = String(value.type || "DROP_SHADOW").toUpperCase();
+  const visible = value.visible !== false;
+  if (type === "DROP_SHADOW" || type === "INNER_SHADOW") {
+    return {
+      type,
+      color: resolveColor(value.color),
+      offset: value.offset || { x: 0, y: 4 },
+      radius: value.blur ?? value.radius ?? 8,
+      spread: value.spread || 0,
+      visible,
+      ...value.blendMode ? { blendMode: value.blendMode } : {},
+      ...type === "DROP_SHADOW" && typeof value.showShadowBehindNode === "boolean" ? { showShadowBehindNode: value.showShadowBehindNode } : {}
+    };
+  }
+  if (type === "LAYER_BLUR" || type === "BACKGROUND_BLUR") {
+    return {
+      type,
+      radius: value.blur ?? value.radius ?? 8,
+      visible,
+      ...value.blurType ? { blurType: value.blurType } : {},
+      ...value.startRadius !== void 0 ? { startRadius: value.startRadius } : {},
+      ...value.startOffset ? { startOffset: value.startOffset } : {},
+      ...value.endOffset ? { endOffset: value.endOffset } : {}
+    };
+  }
+  if (type === "NOISE") {
+    return {
+      type,
+      color: resolveColor(value.color),
+      visible,
+      ...value.blendMode ? { blendMode: value.blendMode } : {},
+      noiseType: value.noiseType || "MONOTONE",
+      noiseSize: value.noiseSize ?? 1,
+      density: value.density ?? 1,
+      ...value.secondaryColor !== void 0 ? { secondaryColor: resolveColor(value.secondaryColor) } : {},
+      ...value.opacity !== void 0 ? { opacity: value.opacity } : {}
+    };
+  }
+  if (type === "TEXTURE") {
+    return {
+      type,
+      visible,
+      noiseSize: value.noiseSize ?? 1,
+      radius: value.blur ?? value.radius ?? 0,
+      clipToShape: value.clipToShape !== false
+    };
+  }
+  if (type === "GLASS") {
+    return {
+      type,
+      visible,
+      lightIntensity: value.lightIntensity ?? 0.5,
+      lightAngle: value.lightAngle ?? -45,
+      refraction: value.refraction ?? 0.5,
+      depth: value.depth ?? 1,
+      dispersion: value.dispersion ?? 0.1,
+      radius: value.blur ?? value.radius ?? 0
+    };
+  }
+  if (type === "SHADER") {
+    return {
+      type,
+      id: typeof value.id === "string" ? value.id : "",
+      visible,
+      ...value.properties && typeof value.properties === "object" && !Array.isArray(value.properties) ? { properties: value.properties } : {}
+    };
+  }
   return {
-    type: String(value.type || "DROP_SHADOW").toUpperCase(),
-    color: hexColor(value.color) || (typeof value.color === "object" ? value.color : void 0),
+    type,
+    color: resolveColor(value.color),
     offset: value.offset || { x: 0, y: 4 },
     radius: value.blur ?? value.radius ?? 8,
     spread: value.spread || 0,
-    visible: value.visible !== false
+    visible
   };
 }
 var passthrough = [
@@ -7378,6 +7448,9 @@ function normalizeNode(node, parent, path) {
   if (typeof raw.overflowDirection === "string") {
     const overflowDirections = {
       NONE: "NONE",
+      HORIZONTAL: "HORIZONTAL",
+      VERTICAL: "VERTICAL",
+      BOTH: "BOTH",
       HORIZONTAL_SCROLLING: "HORIZONTAL",
       VERTICAL_SCROLLING: "VERTICAL",
       HORIZONTAL_AND_VERTICAL_SCROLLING: "BOTH"
@@ -7507,6 +7580,8 @@ function normalizeDocument(value) {
         children: canvas.nodes || []
       }, { x: 0, y: 0 }, `canvas-${index}`);
       root.properties.breakpoint = canvas.breakpoint;
+      if (canvas.variableModes) root.properties.variableModes = canvas.variableModes;
+      if (canvas.bindings) root.properties.bindings = canvas.bindings;
       return root;
     }),
     styles: normalizeStyles(source.styles),
@@ -7845,15 +7920,43 @@ var generated_schema_default = {
       "additionalProperties": false,
       "required": ["type"],
       "properties": {
-        "type": { "enum": ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"] },
+        "type": { "enum": ["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR", "NOISE", "TEXTURE", "GLASS", "SHADER"] },
         "color": { "oneOf": [{ "$ref": "#/$defs/hexColor" }, { "$ref": "#/$defs/color" }] },
         "offset": { "$ref": "#/$defs/vector" },
         "blur": { "$ref": "#/$defs/nonNegativeNumber" },
         "radius": { "$ref": "#/$defs/nonNegativeNumber" },
         "spread": { "type": "number" },
         "visible": { "type": "boolean" },
-        "blendMode": { "type": "string" }
-      }
+        "blendMode": { "type": "string" },
+        "showShadowBehindNode": { "type": "boolean" },
+        "blurType": { "enum": ["NORMAL", "PROGRESSIVE"] },
+        "startRadius": { "$ref": "#/$defs/nonNegativeNumber" },
+        "startOffset": { "$ref": "#/$defs/vector" },
+        "endOffset": { "$ref": "#/$defs/vector" },
+        "noiseType": { "enum": ["MONOTONE", "DUOTONE", "MULTITONE"] },
+        "noiseSize": { "$ref": "#/$defs/nonNegativeNumber" },
+        "density": { "type": "number", "minimum": 0, "maximum": 1 },
+        "secondaryColor": { "oneOf": [{ "$ref": "#/$defs/hexColor" }, { "$ref": "#/$defs/color" }] },
+        "opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "clipToShape": { "type": "boolean" },
+        "lightIntensity": { "type": "number", "minimum": 0, "maximum": 1 },
+        "lightAngle": { "type": "number" },
+        "refraction": { "type": "number", "minimum": 0, "maximum": 1 },
+        "depth": { "type": "number", "minimum": 1 },
+        "dispersion": { "type": "number", "minimum": 0, "maximum": 1 },
+        "id": { "type": "string", "minLength": 1 },
+        "properties": {
+          "type": "object",
+          "description": "SHADER property assignments keyed by Figma property-definition id. Values pass through verbatim (numbers, booleans, strings, colors, points, gradients, or variable aliases).",
+          "additionalProperties": { "type": ["boolean", "string", "number", "object"] }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "SHADER" } }, "required": ["type"] },
+          "then": { "required": ["id"] }
+        }
+      ]
     },
     "shadow": {
       "type": "object",
@@ -8159,7 +8262,7 @@ var generated_schema_default = {
       "additionalProperties": false,
       "required": ["data"],
       "properties": {
-        "windingRule": { "enum": ["NONZERO", "EVENODD"] },
+        "windingRule": { "enum": ["NONZERO", "EVENODD", "NONE"] },
         "data": { "type": "string", "minLength": 1 }
       }
     },
@@ -8317,6 +8420,9 @@ var generated_schema_default = {
         "overflowDirection": {
           "enum": [
             "NONE",
+            "HORIZONTAL",
+            "VERTICAL",
+            "BOTH",
             "HORIZONTAL_SCROLLING",
             "VERTICAL_SCROLLING",
             "HORIZONTAL_AND_VERTICAL_SCROLLING"
@@ -8681,6 +8787,7 @@ function validateDocument(document) {
     if (node.type === "SVG" && typeof props.svg !== "string") add(`${path}.svg`, "SVG requires markup");
     if (node.type === "VECTOR" && !Array.isArray(props.vectorPaths)) add(`${path}.vectorPaths`, "VECTOR requires vectorPaths");
     if (node.type === "INSTANCE" && typeof props.componentId !== "string") add(`${path}.componentId`, "INSTANCE requires componentId");
+    if (node.type === "BOOLEAN_OPERATION" && (typeof props.operation !== "string" || !["UNION", "SUBTRACT", "INTERSECT", "EXCLUDE"].includes(props.operation))) add(`${path}.operation`, "BOOLEAN_OPERATION requires operation UNION, SUBTRACT, INTERSECT, or EXCLUDE");
     if (node.type === "COMPONENT_SET" && (!node.children.length || node.children.some((child) => child.type !== "COMPONENT"))) add(`${path}.children`, "COMPONENT_SET requires COMPONENT children");
     if (node.type === "COMPONENT_SET" && props.variantAxes) {
       for (const [axis, options] of Object.entries(props.variantAxes)) if (!axis || !Array.isArray(options) || !options.length || options.some((option) => typeof option !== "string")) add(`${path}.variantAxes.${axis}`, "must be a non-empty string array");
@@ -8699,13 +8806,29 @@ function validateDocument(document) {
     node.children.forEach((child, index) => references(child, `${path}.children[${index}]`));
   }
   document.nodes.forEach((node, index) => references(node, `nodes[${index}]`));
+  const styleKeys = /* @__PURE__ */ new Map();
+  for (const style of document.styles || []) {
+    if (typeof style.id === "string" && style.id) styleKeys.set(style.id, style.type);
+    if (typeof style.name === "string" && style.name) styleKeys.set(style.name, style.type);
+  }
+  const variableKeys = /* @__PURE__ */ new Set();
+  const collectionNames = /* @__PURE__ */ new Set();
+  const modesByCollection = /* @__PURE__ */ new Map();
   for (const [collectionIndex, collection] of (document.variables || []).entries()) {
     const modes = Array.isArray(collection.modes) && collection.modes.length ? collection.modes : [];
     if (collection.modes !== void 0 && (!modes.length || modes.some((mode) => typeof mode !== "string"))) add(`variables[${collectionIndex}].modes`, "must be a non-empty array of mode names");
+    if (typeof collection.name === "string" && collection.name) {
+      collectionNames.add(collection.name);
+      if (collection.modes !== void 0 && modes.length && modes.every((mode) => typeof mode === "string")) {
+        modesByCollection.set(collection.name, modes);
+      }
+    }
     for (const [variableIndex, variable] of (collection.items || []).entries()) {
       const path = `variables[${collectionIndex}].items[${variableIndex}]`;
       if (!variable.name || typeof variable.name !== "string") add(`${path}.name`, "must be a non-empty string");
       if (!["COLOR", "FLOAT", "STRING", "BOOLEAN"].includes(variable.type)) add(`${path}.type`, "must be COLOR, FLOAT, STRING, or BOOLEAN");
+      if (typeof variable.id === "string" && variable.id) variableKeys.add(variable.id);
+      if (typeof variable.name === "string" && variable.name) variableKeys.add(variable.name);
       const values = variable.values || (variable.value !== void 0 ? { default: variable.value } : {});
       if (!Object.keys(values).length) add(`${path}`, "requires value or values");
       if (variable.values && modes.length) {
@@ -8720,6 +8843,54 @@ function validateDocument(document) {
       }
     }
   }
+  function tokenReferences(node, path) {
+    const bindings = node.properties.bindings;
+    if (bindings) {
+      for (const [field, key] of Object.entries(bindings)) {
+        if (typeof key !== "string" || !key) {
+          add(`${path}.bindings.${field}`, "must be a non-empty variable id or name");
+          continue;
+        }
+        if (!variableKeys.has(key)) add(`${path}.bindings.${field}`, `variable '${key}' is not defined in this document`);
+      }
+    }
+    const variableModes = node.properties.variableModes;
+    if (variableModes) {
+      for (const [collectionName, modeName] of Object.entries(variableModes)) {
+        if (!collectionNames.has(collectionName)) {
+          add(`${path}.variableModes.${collectionName}`, `variable collection '${collectionName}' is not defined in this document`);
+          continue;
+        }
+        if (typeof modeName !== "string" || !modeName) {
+          add(`${path}.variableModes.${collectionName}`, "must be a non-empty mode name");
+          continue;
+        }
+        const declared = modesByCollection.get(collectionName);
+        if (declared && !declared.includes(modeName)) add(`${path}.variableModes.${collectionName}`, `mode '${modeName}' is not declared on collection '${collectionName}'`);
+      }
+    }
+    const styleRefs = node.properties.styleRefs;
+    if (styleRefs) {
+      for (const [field, key] of Object.entries(styleRefs)) {
+        if (typeof key !== "string" || !key) {
+          add(`${path}.styleRefs.${field}`, "must be a non-empty style id or name");
+          continue;
+        }
+        const styleType = styleKeys.get(key);
+        if (!styleType) {
+          add(`${path}.styleRefs.${field}`, `style '${key}' is not defined in this document`);
+          continue;
+        }
+        if ((field === "fill" || field === "stroke") && styleType !== "PAINT") {
+          add(`${path}.styleRefs.${field}`, `style '${key}' has type ${styleType} but ${field} requires PAINT`);
+        } else if (field === "text" && styleType !== "TEXT") {
+          add(`${path}.styleRefs.${field}`, `style '${key}' has type ${styleType} but text requires TEXT`);
+        }
+      }
+    }
+    node.children.forEach((child, index) => tokenReferences(child, `${path}.children[${index}]`));
+  }
+  document.nodes.forEach((node, index) => tokenReferences(node, `nodes[${index}]`));
   return errors;
 }
 

package/dist/types.d.ts

@@ -11,7 +11,7 @@ export interface LetterSpacing {
     value: number;
 }
 export interface VectorPath {
-    windingRule: "NONZERO" | "EVENODD";
+    windingRule: "NONZERO" | "EVENODD" | "NONE";
     data: string;
 }
 export interface VariableAlias {
@@ -80,6 +80,26 @@ export interface DesignEffect {
     spread?: number;
     visible?: boolean;
     blendMode?: string;
+    showShadowBehindNode?: boolean;
+    blurType?: string;
+    startRadius?: number;
+    startOffset?: DesignPoint;
+    endOffset?: DesignPoint;
+    noiseType?: string;
+    noiseSize?: number;
+    density?: number;
+    secondaryColor?: DesignColor;
+    opacity?: number;
+    clipToShape?: boolean;
+    lightIntensity?: number;
+    lightAngle?: number;
+    refraction?: number;
+    depth?: number;
+    dispersion?: number;
+    /** SHADER only: Figma shader id (from listAvailableShaders / importShaderById). */
+    id?: string;
+    /** SHADER only: property assignments keyed by property-definition id, passed through verbatim. */
+    properties?: Record<string, JsonValue>;
 }
 export interface DesignStyles {
     fills: DesignPaint[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compact-design/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Reusable parser, normalizer, validator, patch engine, and linter for Compact Design JSON.",
   "license": "MPL-2.0",
   "type": "module",