@wavemaker/foundation-css 11.15.1-rc.248 → 11.15.2-rc.249

package/src/token-validation/constants.js

@@ -0,0 +1,54 @@
+export const VALIDATION_RULES = {
+    STRUCTURE: "structure", // Enforces component mapping structure via schema (e.g. mapping required)
+    METADATA: "metadata", // Enforces token metadata via schema (type + attributes.subtype/description)
+    REFERENCES: "references", // Enables reference validation logic (refExists keyword)
+    OVERRIDES: "overrides" // Enables override-vs-foundation mapping validation (overrideContext keyword)
+};
+export const ERROR_TYPES = Object.freeze({
+    INVALID_REFERENCE: "reference error",
+    INVALID_FIELD: "invalid field",
+    MISSING_FIELD: "missing field",
+    INVALID_VALUE: "invalid value",
+    INVALID_STRUCTURE: "invalid structure",
+    INVALID_JSON: "invalid json",
+    BUILD_ERROR: "build error"
+});
+export const TOKEN_TYPES = Object.freeze({
+    GLOBAL: "global",
+    COMPONENT: "component"
+});
+export const VALIDATION_SCOPE = Object.freeze({
+    FOUNDATION: "foundation",
+    PROJECT: "project"
+});
+export const FOLDER_TYPE = Object.freeze({
+    WEB: "web",
+    MOBILE: "mobile"
+});
+export const TOKEN_VALUE_TYPES = ["color", "radius", "font", "space"];
+//Defines allowed properties for specific JSON paths to produce contextual error messages for invalid structure validations.
+export const ALLOWED_PROPERTIES_BY_CONTEXT = [
+    {
+        match: path => path && !path.includes("."), // component root
+        allowed: ["meta", "mapping", "appearances"]
+    },
+    {
+        match: path => path.endsWith(".attributes"),
+        allowed: ["subtype", "description"]
+    },
+    {
+        match: path => path.endsWith(".appearances"),
+        allowed: ["mapping", "states", "variantGroups"]
+    },
+    {
+        match: path => path.endsWith(".states"),
+        allowed: null // dynamic state names
+    }
+];
+export const VALUE_RELATED_KEYWORDS = new Set(["type", "enum", "const", "minimum", "maximum", "minLength", "maxLength", "pattern"]);
+export const PLATFORM = {
+    WEB: "web",
+    MOBILE: "native_mobile",
+    BOTH: "both"
+};
+//# sourceMappingURL=constants.js.map

package/src/token-validation/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"./","sources":["src/token-validation/constants.js"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW,EAAI,0EAA0E;IACpG,QAAQ,EAAE,UAAU,EAAM,6EAA6E;IACvG,UAAU,EAAE,YAAY,EAAE,yDAAyD;IACnF,SAAS,EAAE,WAAW,CAAI,8EAA8E;CACzG,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,iBAAiB;IACpC,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAG,aAAa;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,GAAG,EAAG,KAAK;IACX,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtE,4HAA4H;AAC5H,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C;QACE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB;QAC7D,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC;KAC5C;IACD;QACE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3C,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;KACpC;IACD;QACE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC5C,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC;KAChD;IACD;QACE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,sBAAsB;KACrC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpI,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAG,KAAK;IACX,MAAM,EAAG,eAAe;IACxB,IAAI,EAAG,MAAM;CACd,CAAA","sourcesContent":["export const VALIDATION_RULES = {\n  STRUCTURE: \"structure\",   // Enforces component mapping structure via schema (e.g. mapping required)\n  METADATA: \"metadata\",     // Enforces token metadata via schema (type + attributes.subtype/description)\n  REFERENCES: \"references\", // Enables reference validation logic (refExists keyword)\n  OVERRIDES: \"overrides\"    // Enables override-vs-foundation mapping validation (overrideContext keyword)\n};\n\nexport const ERROR_TYPES = Object.freeze({\n  INVALID_REFERENCE: \"reference error\",\n  INVALID_FIELD: \"invalid field\",\n  MISSING_FIELD: \"missing field\",\n  INVALID_VALUE: \"invalid value\",\n  INVALID_STRUCTURE: \"invalid structure\",\n  INVALID_JSON: \"invalid json\",\n  BUILD_ERROR : \"build error\"\n});\n\nexport const TOKEN_TYPES = Object.freeze({\n  GLOBAL: \"global\",\n  COMPONENT: \"component\"\n});\n\nexport const VALIDATION_SCOPE = Object.freeze({\n  FOUNDATION: \"foundation\",\n  PROJECT: \"project\"\n});\n\nexport const FOLDER_TYPE = Object.freeze({\n  WEB : \"web\",\n  MOBILE: \"mobile\"\n})\n\nexport const TOKEN_VALUE_TYPES = [\"color\", \"radius\", \"font\", \"space\"];\n\n//Defines allowed properties for specific JSON paths to produce contextual error messages for invalid structure validations.\nexport const ALLOWED_PROPERTIES_BY_CONTEXT = [\n  {\n    match: path => path && !path.includes(\".\"), // component root\n    allowed: [\"meta\", \"mapping\", \"appearances\"]\n  },\n  {\n    match: path => path.endsWith(\".attributes\"),\n    allowed: [\"subtype\", \"description\"]\n  },\n  {\n    match: path => path.endsWith(\".appearances\"),\n    allowed: [\"mapping\", \"states\", \"variantGroups\"]\n  },\n  {\n    match: path => path.endsWith(\".states\"),\n    allowed: null // dynamic state names\n  }\n];\n\nexport const VALUE_RELATED_KEYWORDS = new Set([\"type\", \"enum\", \"const\", \"minimum\", \"maximum\", \"minLength\", \"maxLength\", \"pattern\"]);\n\nexport const PLATFORM = {\n  WEB : \"web\",\n  MOBILE : \"native_mobile\",\n  BOTH : \"both\"\n}\n"]}

package/src/token-validation/global-token-schema.d.ts

@@ -0,0 +1,37 @@
+export default function getGlobalTokenSchema(): {
+    $schema: string;
+    type: string;
+    additionalProperties: {
+        $ref: string;
+    };
+    definitions: {
+        globalTokenNode: {
+            type: string;
+            leafMustHaveValue: boolean;
+            properties: {
+                value: {
+                    type: string;
+                    minLength: number;
+                    refExists: boolean;
+                };
+                type: {
+                    type: string;
+                    enum: string[];
+                };
+                attributes: {
+                    type: string;
+                    additionalProperties: {
+                        type: string;
+                    };
+                };
+                meta: {
+                    type: string;
+                    additionalProperties: boolean;
+                };
+            };
+            additionalProperties: {
+                $ref: string;
+            };
+        };
+    };
+};

package/src/token-validation/global-token-schema.js

@@ -0,0 +1,41 @@
+import { TOKEN_VALUE_TYPES } from "./constants.js";
+export default function getGlobalTokenSchema() {
+    return {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "additionalProperties": {
+            "$ref": "#/definitions/globalTokenNode"
+        },
+        "definitions": {
+            "globalTokenNode": {
+                "type": "object",
+                "leafMustHaveValue": true,
+                "properties": {
+                    "value": {
+                        "type": "string",
+                        "minLength": 1,
+                        "refExists": true
+                    },
+                    "type": {
+                        "type": "string",
+                        "enum": TOKEN_VALUE_TYPES
+                    },
+                    "attributes": {
+                        "type": "object",
+                        "additionalProperties": {
+                            "type": "string"
+                        }
+                    },
+                    "meta": {
+                        "type": "object",
+                        "additionalProperties": true
+                    }
+                },
+                "additionalProperties": {
+                    "$ref": "#/definitions/globalTokenNode"
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=global-token-schema.js.map

package/src/token-validation/global-token-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-token-schema.js","sourceRoot":"./","sources":["src/token-validation/global-token-schema.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,CAAC,OAAO,UAAU,oBAAoB;IAC1C,OAAO;QACL,SAAS,EAAE,yCAAyC;QACpD,MAAM,EAAE,QAAQ;QAEhB,sBAAsB,EAAE;YACtB,MAAM,EAAE,+BAA+B;SACxC;QAED,aAAa,EAAE;YACb,iBAAiB,EAAE;gBACjB,MAAM,EAAE,QAAQ;gBAChB,mBAAmB,EAAE,IAAI;gBAEzB,YAAY,EAAE;oBACZ,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;wBAChB,WAAW,EAAE,CAAC;wBACd,WAAW,EAAE,IAAI;qBAClB;oBACD,MAAM,EAAE;wBACN,MAAM,EAAE,QAAQ;wBAChB,MAAM,EAAE,iBAAiB;qBAC1B;oBAED,YAAY,EAAE;wBACZ,MAAM,EAAE,QAAQ;wBAChB,sBAAsB,EAAE;4BACtB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBAED,MAAM,EAAE;wBACN,MAAM,EAAE,QAAQ;wBAChB,sBAAsB,EAAE,IAAI;qBAC7B;iBACF;gBAED,sBAAsB,EAAE;oBACtB,MAAM,EAAE,+BAA+B;iBACxC;aACF;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { TOKEN_VALUE_TYPES } from \"./constants.js\";\n\nexport default function getGlobalTokenSchema() {\n  return {\n    \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n    \"type\": \"object\",\n\n    \"additionalProperties\": {\n      \"$ref\": \"#/definitions/globalTokenNode\"\n    },\n\n    \"definitions\": {\n      \"globalTokenNode\": {\n        \"type\": \"object\",\n        \"leafMustHaveValue\": true,\n\n        \"properties\": {\n          \"value\": {\n            \"type\": \"string\",\n            \"minLength\": 1,\n            \"refExists\": true\n          },\n          \"type\": {\n            \"type\": \"string\",\n            \"enum\": TOKEN_VALUE_TYPES\n          },\n\n          \"attributes\": {\n            \"type\": \"object\",\n            \"additionalProperties\": {\n              \"type\": \"string\"\n            }\n          },\n\n          \"meta\": {\n            \"type\": \"object\",\n            \"additionalProperties\": true\n          }\n        },\n\n        \"additionalProperties\": {\n          \"$ref\": \"#/definitions/globalTokenNode\"\n        }\n      }\n    }\n  };\n}"]}

package/src/token-validation/validate-token.d.ts

@@ -0,0 +1,72 @@
+export class TokenValidator {
+    constructor(args: any);
+    externalGlobalTokenJsons: any;
+    validationErrors: any[];
+    ajvEngine: TokenAjvEngine;
+    ajv: Ajv;
+    platform: any;
+    foundationTokensDir: string;
+    validateTokenJson({ json, validationConfig, tokenType }: {
+        json: any;
+        validationConfig?: {} | undefined;
+        tokenType: any;
+    }): void;
+    getValidationErrors(): any[];
+}
+export class TokenFolderValidator {
+    constructor(args: any);
+    validationScope: any;
+    projectOverrideDirs: any;
+    validationErrors: any[];
+    ajvEngine: TokenAjvEngine;
+    ajv: Ajv;
+    platform: any;
+    foundationTokensDir: string;
+    resolvedValidationTargets: ({
+        type: "global";
+        dir: string;
+    } | {
+        type: "component";
+        dir: string;
+    })[];
+    createAjvContext(): void;
+    isFoundation: boolean | undefined;
+    isProject: boolean | undefined;
+    resolveValidationTargets(): ({
+        type: "global";
+        dir: string;
+    } | {
+        type: "component";
+        dir: string;
+    })[];
+    validateFolder(validationConfig?: {}): void;
+    getValidationErrors(): any[];
+    resolveProjectOverrideDirs(overridesDir: any): {
+        globalDir: string | null;
+        componentsDir: string | null;
+    };
+    validateFile(filePath: any, validate: any): void;
+    parseJsonSafely(filePath: any): {
+        ok: boolean;
+        json: any;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: unknown;
+        json?: undefined;
+    };
+    traverseAndValidateJsonFiles(dir: any, validate: any, visitedSet?: Set<any>): void;
+    /**
+   * Generates a Markdown validation report summarizing all errors.
+   * Output:
+   * - Creates a README-style markdown file listing validation errors in generated folder
+   */
+    generateValidationReport(outputDir: any): void;
+}
+declare class TokenAjvEngine {
+    validatorEngine: Ajv;
+    registerCustomValidations(): void;
+    getValidatorEngine(): Ajv;
+}
+import Ajv from "ajv";
+export {};