@wavemaker-ai/foundation-css 1.0.0-rc.647469

package/src/token-validation/validator-utils/common/constants.js

@@ -0,0 +1,281 @@
+// Base validation rule configurations shared across platforms
+//TODO segregation of units
+const WEB_SIZES = [
+    // Absolute Lengths
+    "px", "cm", "mm", "Q", "in", "pc", "pt",
+    // Font-Relative (Local)
+    "em", "ex", "ch", "cap", "ic", "lh",
+    // Font-Relative (Root)
+    "rem", "rex", "rch", "rcap", "ric", "rlh",
+    // Standard Viewport
+    "vw", "vh", "vi", "vb", "vmin", "vmax",
+    // Small Viewport (UA UI expanded)
+    "svw", "svh", "svi", "svb", "svmin", "svmax",
+    // Large Viewport (UA UI retracted)
+    "lvw", "lvh", "lvi", "lvb", "lvmin", "lvmax",
+    // Dynamic Viewport (UA UI changes)
+    "dvw", "dvh", "dvi", "dvb", "dvmin", "dvmax",
+    // Container Query Units
+    "cqw", "cqh", "cqi", "cqb", "cqmin", "cqmax",
+    // Percentage & Layout
+    "%", "fr"
+];
+const MOBILE_SIZES = ['px', 'vh', 'vw'];
+export const BASE_SUBTYPE_CONFIGS = {
+    "border-style": {
+        type: "allowed-list",
+        native_mobile: {
+            allowed: ["solid", "dashed", "dotted"]
+        },
+        web: {
+            allowed: ["none", "hidden", "dotted", "dashed", "solid", "double", "groove", "ridge", "inset", "outset"]
+        }
+    },
+    "border-width": {
+        type: "multi-size",
+        allowMultiValue: true,
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true,
+            allowedKeywords: []
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true,
+            allowedKeywords: ["thin", "medium", "thick"]
+        }
+    },
+    // "box-shadow": {
+    //     type: "custom",
+    //     customDescription: {
+    //         native_mobile: '[inset] <x> <y> [blur≥0] [spread] [color] — px or 0; color: #hex, rgb(), rgba(), named; comma-separate multiple shadows',
+    //         web: '[inset] <x> <y> [blur≥0] [spread] [color] — CSS units or 0; color: #hex, rgb(), rgba(), hsl(), hsla(), named; "none" also valid'
+    //     }
+    // },
+    // "elevation": {
+    //     type: "custom",
+    //     customDescription: {
+    //         native_mobile: '[inset] <x> <y> [blur≥0] [spread] [color] — px or 0; color: #hex, rgb(), rgba(), named; comma-separate multiple shadows',
+    //         web: '[inset] <x> <y> [blur≥0] [spread] [color] — CSS units or 0; color: #hex, rgb(), rgba(), hsl(), hsla(), named; "none" also valid'
+    //     }
+    // },
+    "font-family": {
+        type: "custom",
+        customDescription: {
+            native_mobile: "only one font name",
+            web: "valid font family name or comma-separated font stack"
+        },
+        native_mobile: {
+            allowMultipleFonts: false,
+            separator: null,
+            maxFonts: 1,
+            allowGenericFallbacks: false
+        },
+        web: {
+            allowMultipleFonts: true,
+            separator: ",",
+            maxFonts: null,
+            allowGenericFallbacks: true
+        }
+    },
+    "font-size": {
+        type: "size",
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true,
+            allowedKeywords: []
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true,
+            allowedKeywords: ["xx-small", "x-small", "small", "medium", "large", "x-large", "xx-large", "smaller", "larger"]
+        }
+    },
+    "font-weight": {
+        type: "range-with-keywords",
+        range: [100, 900],
+        stepSize: 100,
+        native_mobile: {
+            keywords: ["normal", "bold"]
+        },
+        web: {
+            keywords: ["normal", "bold", "bolder", "lighter"]
+        }
+    },
+    "icon-size": {
+        type: "size",
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true
+        }
+    },
+    "letter-spacing": {
+        type: "size",
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true,
+            allowNegative: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true,
+            allowedKeywords: ['normal'],
+            allowNegative: true
+        }
+    },
+    "line-height": {
+        type: "size",
+        customDescription: {
+            native_mobile: "line height should be in px or unitless, greater than font-size for mobile"
+        },
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true,
+            allowedKeywords: ['normal']
+        }
+    },
+    "opacity": {
+        type: "range",
+        min: 0,
+        max: 1,
+        percentMin: 0,
+        percentMax: 100
+    },
+    "radius": {
+        type: "multi-size",
+        allowMultiValue: true,
+        allowPercent: true,
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true
+        }
+    },
+    "space": {
+        type: "multi-size",
+        allowMultiValue: true,
+        allowAuto: true,
+        allowPercent: true,
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true
+        }
+    },
+    "margin": {
+        type: "multi-size",
+        allowMultiValue: true,
+        allowAuto: true,
+        allowNegative: true,
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true
+        }
+    },
+    "spacer": {
+        type: "size",
+        native_mobile: {
+            allowedUnits: MOBILE_SIZES,
+            allowUnitless: true
+        },
+        web: {
+            allowedUnits: WEB_SIZES,
+            allowUnitless: true
+        }
+    }
+};
+/**
+ * Generate platform-specific rule configuration
+ * @param {string} subtype - The subtype name
+ * @param {string} platform - Platform ('native_mobile' or 'web')
+ * @returns {Object} Platform-specific rule configuration
+ */
+export function getPlatformRule(subtype, platform) {
+    const baseConfig = BASE_SUBTYPE_CONFIGS[subtype];
+    if (!baseConfig)
+        return null;
+    // Merge base config with platform-specific overrides
+    const platformConfig = baseConfig[platform] || {};
+    const rule = { ...baseConfig, ...platformConfig };
+    // Handle platform-specific custom descriptions
+    if (rule.customDescription && typeof rule.customDescription === 'object') {
+        rule.customDescription = rule.customDescription[platform] || rule.customDescription;
+    }
+    // Remove platform-specific sections from the final rule
+    delete rule.native_mobile;
+    delete rule.web;
+    delete rule.validator;
+    return rule;
+}
+/**
+ * Generate platform-specific validation rules from BASE_SUBTYPE_CONFIGS.
+ * @param {string} platform - 'native_mobile' or 'web'
+ * @param {Object} validators - Validator functions (see COMMON_VALIDATORS in utils.js)
+ * @returns {Object} Rules indexed by subtype, each with a .validate function
+ */
+export function generatePlatformRules(platform, validators) {
+    const rules = {};
+    Object.keys(BASE_SUBTYPE_CONFIGS).forEach(subtype => {
+        const rule = getPlatformRule(subtype, platform);
+        if (!rule)
+            return;
+        rule.validate = resolveRuleValidator(rule.type, subtype, platform, validators);
+        rules[subtype] = rule;
+    });
+    return rules;
+}
+/**
+ * Resolve an executable validator function from rule type + subtype.
+ */
+export function resolveRuleValidator(type, subtype, platform, validators) {
+    const platformDefaults = {
+        native_mobile: MOBILE_SIZES,
+        web: WEB_SIZES
+    };
+    const defaultUnits = platformDefaults[platform];
+    switch (type) {
+        case "allowed-list":
+            return (value, rule) => validators.validateFromAllowedList(value, rule.allowed);
+        case "size":
+            return (value, rule) => validators.validatePlatformSizeValue(value, rule, defaultUnits);
+        case "multi-size":
+            return (value, rule) => validators.validatePlatformSpaceValue(value, rule, defaultUnits);
+        case "string":
+            return validators.validateFontFamily;
+        case "range":
+            return validators.validateOpacity;
+        case "range-with-keywords":
+            return platform === 'native_mobile'
+                ? (value, rule) => validators.validateFontWeight(value, rule, true)
+                : validators.validateFontWeight;
+        case "custom":
+            if (subtype === "font-family") {
+                return (value, rule) => validators.validateFontFamily(value, rule);
+            }
+            if (subtype === "box-shadow" || subtype === "elevation") {
+                return validators.validateBoxShadow;
+            }
+            return null;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=constants.js.map

package/src/token-validation/validator-utils/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"./","sources":["src/token-validation/validator-utils/common/constants.js"],"names":[],"mappings":"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","sourcesContent":["\n// Base validation rule configurations shared across platforms\n\n//TODO segregation of units\nconst WEB_SIZES = [\n  // Absolute Lengths\n  \"px\", \"cm\", \"mm\", \"Q\", \"in\", \"pc\", \"pt\",\n\n  // Font-Relative (Local)\n  \"em\", \"ex\", \"ch\", \"cap\", \"ic\", \"lh\",\n\n  // Font-Relative (Root)\n  \"rem\", \"rex\", \"rch\", \"rcap\", \"ric\", \"rlh\",\n\n  // Standard Viewport\n  \"vw\", \"vh\", \"vi\", \"vb\", \"vmin\", \"vmax\",\n\n  // Small Viewport (UA UI expanded)\n  \"svw\", \"svh\", \"svi\", \"svb\", \"svmin\", \"svmax\",\n\n  // Large Viewport (UA UI retracted)\n  \"lvw\", \"lvh\", \"lvi\", \"lvb\", \"lvmin\", \"lvmax\",\n\n  // Dynamic Viewport (UA UI changes)\n  \"dvw\", \"dvh\", \"dvi\", \"dvb\", \"dvmin\", \"dvmax\",\n\n  // Container Query Units\n  \"cqw\", \"cqh\", \"cqi\", \"cqb\", \"cqmin\", \"cqmax\",\n\n  // Percentage & Layout\n  \"%\", \"fr\"\n];\nconst MOBILE_SIZES = ['px', 'vh', 'vw'];\n\nexport const BASE_SUBTYPE_CONFIGS = {\n    \"border-style\": {\n        type: \"allowed-list\",\n        native_mobile: {\n            allowed: [\"solid\", \"dashed\", \"dotted\"]\n        },\n        web: {\n            allowed: [\"none\", \"hidden\", \"dotted\", \"dashed\", \"solid\", \"double\", \"groove\", \"ridge\", \"inset\", \"outset\"]\n        }\n    },\n    \n    \"border-width\": {\n        type: \"multi-size\",\n        allowMultiValue: true,\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true,\n            allowedKeywords: []\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true,\n            allowedKeywords: [\"thin\", \"medium\", \"thick\"]\n        }\n    },\n    \n    // \"box-shadow\": {\n    //     type: \"custom\",\n    //     customDescription: {\n    //         native_mobile: '[inset] <x> <y> [blur≥0] [spread] [color] — px or 0; color: #hex, rgb(), rgba(), named; comma-separate multiple shadows',\n    //         web: '[inset] <x> <y> [blur≥0] [spread] [color] — CSS units or 0; color: #hex, rgb(), rgba(), hsl(), hsla(), named; \"none\" also valid'\n    //     }\n    // },\n\n    // \"elevation\": {\n    //     type: \"custom\",\n    //     customDescription: {\n    //         native_mobile: '[inset] <x> <y> [blur≥0] [spread] [color] — px or 0; color: #hex, rgb(), rgba(), named; comma-separate multiple shadows',\n    //         web: '[inset] <x> <y> [blur≥0] [spread] [color] — CSS units or 0; color: #hex, rgb(), rgba(), hsl(), hsla(), named; \"none\" also valid'\n    //     }\n    // },\n        \n    \"font-family\": {\n        type: \"custom\",\n        customDescription: {\n            native_mobile: \"only one font name\",\n            web: \"valid font family name or comma-separated font stack\"\n        },\n        native_mobile: {\n            allowMultipleFonts: false,\n            separator: null,\n            maxFonts: 1,\n            allowGenericFallbacks: false\n        },\n        web: {\n            allowMultipleFonts: true,\n            separator: \",\",\n            maxFonts: null,\n            allowGenericFallbacks: true\n        }\n    },\n    \n    \"font-size\": {\n        type: \"size\",\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true,\n            allowedKeywords: []\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true,\n            allowedKeywords: [\"xx-small\", \"x-small\", \"small\", \"medium\", \"large\", \"x-large\", \"xx-large\", \"smaller\", \"larger\"]\n        }\n    },\n    \n    \"font-weight\": {\n        type: \"range-with-keywords\",\n        range: [100, 900],\n        stepSize: 100,\n        native_mobile: {\n            keywords: [\"normal\", \"bold\"]\n        },\n        web: {\n            keywords: [\"normal\", \"bold\", \"bolder\", \"lighter\"]\n        }\n    },\n    \n    \"icon-size\": {\n        type: \"size\",\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true\n        }\n    },\n    \n    \"letter-spacing\": {\n        type: \"size\",\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true,\n            allowNegative: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true,\n            allowedKeywords: ['normal'],\n            allowNegative: true\n        }\n    },\n    \n    \"line-height\": {\n        type: \"size\",\n        customDescription:{\n            native_mobile: \"line height should be in px or unitless, greater than font-size for mobile\"\n        },\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true,\n            allowedKeywords: ['normal']\n        }\n    },\n    \n    \"opacity\": {\n        type: \"range\",\n        min: 0,\n        max: 1,\n        percentMin: 0,\n        percentMax: 100\n    },\n    \n    \"radius\": {\n        type: \"multi-size\",\n        allowMultiValue: true,\n        allowPercent: true,\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true\n        }\n    },\n    \n    \"space\": {\n        type: \"multi-size\",\n        allowMultiValue: true,\n        allowAuto: true,\n        allowPercent: true,\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true\n        }\n    },\n    \n    \"margin\": {\n        type: \"multi-size\",\n        allowMultiValue: true,\n        allowAuto: true,\n        allowNegative: true,\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true\n        }\n    },\n    \n    \"spacer\": {\n        type: \"size\",\n        native_mobile: {\n            allowedUnits: MOBILE_SIZES,\n            allowUnitless: true\n        },\n        web: {\n            allowedUnits: WEB_SIZES,\n            allowUnitless: true\n        }\n    }\n};\n\n\n/**\n * Generate platform-specific rule configuration\n * @param {string} subtype - The subtype name\n * @param {string} platform - Platform ('native_mobile' or 'web')\n * @returns {Object} Platform-specific rule configuration\n */\nexport function getPlatformRule(subtype, platform) {\n    const baseConfig = BASE_SUBTYPE_CONFIGS[subtype];\n    if (!baseConfig) return null;\n    \n    // Merge base config with platform-specific overrides\n    const platformConfig = baseConfig[platform] || {};\n    const rule = { ...baseConfig, ...platformConfig };\n    \n    // Handle platform-specific custom descriptions\n    if (rule.customDescription && typeof rule.customDescription === 'object') {\n        rule.customDescription = rule.customDescription[platform] || rule.customDescription;\n    }\n    \n    // Remove platform-specific sections from the final rule\n    delete rule.native_mobile;\n    delete rule.web;\n    delete rule.validator;\n    \n    return rule;\n}\n\n/**\n * Generate platform-specific validation rules from BASE_SUBTYPE_CONFIGS.\n * @param {string} platform - 'native_mobile' or 'web'\n * @param {Object} validators - Validator functions (see COMMON_VALIDATORS in utils.js)\n * @returns {Object} Rules indexed by subtype, each with a .validate function\n */\nexport function generatePlatformRules(platform, validators) {\n    const rules = {};\n    Object.keys(BASE_SUBTYPE_CONFIGS).forEach(subtype => {\n        const rule = getPlatformRule(subtype, platform);\n        if (!rule) return;\n        rule.validate = resolveRuleValidator(rule.type, subtype, platform, validators);\n        rules[subtype] = rule;\n    });\n    return rules;\n}\n\n/**\n * Resolve an executable validator function from rule type + subtype.\n */\nexport function resolveRuleValidator(type, subtype, platform, validators) {\n    const platformDefaults = {\n        native_mobile: MOBILE_SIZES,\n        web: WEB_SIZES\n    };\n    const defaultUnits = platformDefaults[platform];\n\n    switch (type) {\n        case \"allowed-list\":\n            return (value, rule) => validators.validateFromAllowedList(value, rule.allowed);\n        case \"size\":\n            return (value, rule) => validators.validatePlatformSizeValue(value, rule, defaultUnits);\n        case \"multi-size\":\n            return (value, rule) => validators.validatePlatformSpaceValue(value, rule, defaultUnits);\n        case \"string\":\n            return validators.validateFontFamily;\n        case \"range\":\n            return validators.validateOpacity;\n        case \"range-with-keywords\":\n            return platform === 'native_mobile'\n                ? (value, rule) => validators.validateFontWeight(value, rule, true)\n                : validators.validateFontWeight;\n        case \"custom\":\n            if (subtype === \"font-family\") {\n                return (value, rule) => validators.validateFontFamily(value, rule);\n            }\n            if (subtype === \"box-shadow\" || subtype === \"elevation\") {\n                return validators.validateBoxShadow;\n            }\n            return null;\n        default:\n            return null;\n    }\n}"]}

package/src/token-validation/validator-utils/common/primitives.d.ts

@@ -0,0 +1,14 @@
+export function isPx(v: any): boolean;
+export function isRem(v: any): boolean;
+export function isEm(v: any): boolean;
+export function isUnitlessNumber(v: any): boolean;
+export function isNonNegativeUnitlessNumber(v: any): boolean;
+export function isPercent(v: any): boolean;
+export function isHex(v: any): boolean;
+export function isRgb(v: any): boolean;
+export function isRgba(v: any): boolean;
+export function isHsl(v: any): boolean;
+export function isHsla(v: any): boolean;
+export function isNamedColor(v: any): boolean;
+export function isMobileColor(v: any): boolean;
+export function isWebColor(v: any): boolean;

package/src/token-validation/validator-utils/common/primitives.js

@@ -0,0 +1,35 @@
+// ─── Numeric / Unit helpers ──────────────────────────────────────────────────
+/** "12px", "-4px" */
+export const isPx = (v) => /^-?[\d.]+px$/.test(v);
+/** "1.5rem" */
+export const isRem = (v) => /^-?[\d.]+rem$/.test(v);
+/** "1em" */
+export const isEm = (v) => /^-?[\d.]+em$/.test(v);
+/** Plain number string with no unit: "12", "1.5", NOT "-3" for unsigned contexts */
+export const isUnitlessNumber = (v) => /^-?[\d.]+$/.test(v) && !isNaN(Number(v));
+/** Non-negative unitless number only */
+export const isNonNegativeUnitlessNumber = (v) => isUnitlessNumber(v) && Number(v) >= 0;
+/** "50%" */
+export const isPercent = (v) => /^[\d.]+%$/.test(v);
+// ─── Color helpers ───────────────────────────────────────────────────────────
+/** #RGB, #RGBA, #RRGGBB, #RRGGBBAA */
+export const isHex = (v) => /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(v);
+/** rgb(...) */
+export const isRgb = (v) => /^rgb\(\s*[\d.]+%?\s*,\s*[\d.]+%?\s*,\s*[\d.]+%?\s*\)$/.test(v);
+/** rgba(...) */
+export const isRgba = (v) => /^rgba\(\s*[\d.]+%?\s*,\s*[\d.]+%?\s*,\s*[\d.]+%?\s*,\s*[\d.]+%?\s*\)$/.test(v);
+/** hsl(...) */
+export const isHsl = (v) => /^hsl\(\s*[\d.]+\s*,\s*[\d.]+%\s*,\s*[\d.]+%\s*\)$/.test(v);
+/** hsla(...) */
+export const isHsla = (v) => /^hsla\(\s*[\d.]+\s*,\s*[\d.]+%\s*,\s*[\d.]+%\s*,\s*[\d.]+\s*\)$/.test(v);
+/**
+ * Named color regex: 3-20 alphabetic characters only
+ * Matches: "red", "blue", "transparent" (but not "foobar123" or "red-blue")
+ */
+const NAMED_COLOR = /^[a-zA-Z]{3,20}$/;
+export const isNamedColor = (v) => NAMED_COLOR.test(v);
+/** Any color valid for css-to-react-native: #hex, rgb(), rgba(), named */
+export const isMobileColor = (v) => isHex(v) || isRgb(v) || isRgba(v) || isNamedColor(v);
+/** Any color valid in CSS (superset of mobile) */
+export const isWebColor = (v) => isHex(v) || isRgb(v) || isRgba(v) || isHsl(v) || isHsla(v) || isNamedColor(v);
+//# sourceMappingURL=primitives.js.map

package/src/token-validation/validator-utils/common/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"./","sources":["src/token-validation/validator-utils/common/primitives.js"],"names":[],"mappings":"AAEA,gFAAgF;AAEhF,qBAAqB;AACrB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAElD,eAAe;AACf,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpD,YAAY;AACZ,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAElD,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,wCAAwC;AACxC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,EAAE,EAAE,CAC7C,gBAAgB,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1C,YAAY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpD,gFAAgF;AAEhF,sCAAsC;AACtC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CACvB,kEAAkE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE/E,eAAe;AACf,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CACvB,uDAAuD,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpE,gBAAgB;AAChB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CACxB,uEAAuE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpF,eAAe;AACf,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CACvB,mDAAmD,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhE,gBAAgB;AAChB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CACxB,iEAAiE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,GAAG,kBAAkB,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEvD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,EAAE,CAC/B,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;AAEzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,EAAE,CAC5B,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC","sourcesContent":["\n\n// ─── Numeric / Unit helpers ──────────────────────────────────────────────────\n\n/** \"12px\", \"-4px\" */\nexport const isPx = (v) => /^-?[\\d.]+px$/.test(v);\n\n/** \"1.5rem\" */\nexport const isRem = (v) => /^-?[\\d.]+rem$/.test(v);\n\n/** \"1em\" */\nexport const isEm = (v) => /^-?[\\d.]+em$/.test(v);\n\n/** Plain number string with no unit: \"12\", \"1.5\", NOT \"-3\" for unsigned contexts */\nexport const isUnitlessNumber = (v) => /^-?[\\d.]+$/.test(v) && !isNaN(Number(v));\n\n/** Non-negative unitless number only */\nexport const isNonNegativeUnitlessNumber = (v) =>\n    isUnitlessNumber(v) && Number(v) >= 0;\n\n/** \"50%\" */\nexport const isPercent = (v) => /^[\\d.]+%$/.test(v);\n\n// ─── Color helpers ───────────────────────────────────────────────────────────\n\n/** #RGB, #RGBA, #RRGGBB, #RRGGBBAA */\nexport const isHex = (v) =>\n    /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(v);\n\n/** rgb(...) */\nexport const isRgb = (v) =>\n    /^rgb\\(\\s*[\\d.]+%?\\s*,\\s*[\\d.]+%?\\s*,\\s*[\\d.]+%?\\s*\\)$/.test(v);\n\n/** rgba(...) */\nexport const isRgba = (v) =>\n    /^rgba\\(\\s*[\\d.]+%?\\s*,\\s*[\\d.]+%?\\s*,\\s*[\\d.]+%?\\s*,\\s*[\\d.]+%?\\s*\\)$/.test(v);\n\n/** hsl(...) */\nexport const isHsl = (v) =>\n    /^hsl\\(\\s*[\\d.]+\\s*,\\s*[\\d.]+%\\s*,\\s*[\\d.]+%\\s*\\)$/.test(v);\n\n/** hsla(...) */\nexport const isHsla = (v) =>\n    /^hsla\\(\\s*[\\d.]+\\s*,\\s*[\\d.]+%\\s*,\\s*[\\d.]+%\\s*,\\s*[\\d.]+\\s*\\)$/.test(v);\n\n/**\n * Named color regex: 3-20 alphabetic characters only\n * Matches: \"red\", \"blue\", \"transparent\" (but not \"foobar123\" or \"red-blue\")\n */\nconst NAMED_COLOR = /^[a-zA-Z]{3,20}$/;\nexport const isNamedColor = (v) => NAMED_COLOR.test(v);\n\n/** Any color valid for css-to-react-native: #hex, rgb(), rgba(), named */\nexport const isMobileColor = (v) =>\n    isHex(v) || isRgb(v) || isRgba(v) || isNamedColor(v);\n\n/** Any color valid in CSS (superset of mobile) */\nexport const isWebColor = (v) =>\n    isHex(v) || isRgb(v) || isRgba(v) || isHsl(v) || isHsla(v) || isNamedColor(v);\n"]}

package/src/token-validation/validator-utils/common/utils.d.ts

@@ -0,0 +1,192 @@
+export function generateAllowedListDescription(allowed: any): string;
+/**
+ * Generate description for numeric ranges
+ * @param {number} min - Minimum value
+ * @param {number} max - Maximum value
+ * @param {string} [unit] - Optional unit suffix
+ * @returns {string} Description like "number between 0 and 1"
+ */
+export function generateRangeDescription(min: number, max: number, unit?: string): string;
+/**
+ * Generate description for platform-specific units
+ * @param {string[]} units - Array of supported units
+ * @returns {string} Description of supported units
+ */
+export function generateUnitsDescription(units: string[]): string;
+/**
+ * Validate value against an allowed list
+ * @param {string} value - Value to validate
+ * @param {string[]} allowed - Array of allowed values
+ * @returns {{ valid: boolean }}
+ */
+export function validateFromAllowedList(value: string, allowed: string[]): {
+    valid: boolean;
+};
+/**
+ * Validate numeric value within a range
+ * @param {string|number} value - Value to validate
+ * @param {number} min - Minimum allowed value
+ * @param {number} max - Maximum allowed value
+ * @returns {{ valid: boolean }}
+ */
+export function validateNumericRange(value: string | number, min: number, max: number): {
+    valid: boolean;
+};
+/**
+ * Validate non-empty string values
+ * @param {string} value - Value to validate
+ * @returns {{ valid: boolean }}
+ */
+export function validateNonEmptyString(value: string): {
+    valid: boolean;
+};
+/**
+ * Validate numeric range with optional keyword support
+ * @param {string|number} value - Value to validate
+ * @param {Object} rule - Rule configuration containing range and keywords
+ * @param {boolean} [caseInsensitive=false] - Match keywords case-insensitively
+ * @returns {{ valid: boolean }}
+ */
+export function validateRangeWithKeywords(value: string | number, rule: any, caseInsensitive?: boolean): {
+    valid: boolean;
+};
+/**
+ * Build size validation options from rule configuration
+ * @param {Object} rule - Rule config
+ * @param {Object} defaults - Default options for a platform
+ * @returns {Object} Final validation options
+ */
+export function buildSizeOptions(rule?: any, defaults?: any): any;
+/**
+ * Validate size values with platform-specific unit support
+ * @param {string} value - Value to validate
+ * @param {Object} options - Validation options
+ * @param {boolean} [options.allowNegative=false] - Allow negative values
+ * @param {boolean} [options.allowUnitless=true] - Allow unitless numbers
+ * @param {boolean} [options.allowPercent=false] - Allow percentage values
+ * @param {string[]} [options.allowedUnits=['px']] - Allowed CSS units
+ * @param {string[]} [options.allowedKeywords=[]] - Allowed keyword values
+ * @returns {{ valid: boolean }}
+ */
+export function validateSizeValue(value: string, options?: {
+    allowNegative?: boolean | undefined;
+    allowUnitless?: boolean | undefined;
+    allowPercent?: boolean | undefined;
+    allowedUnits?: string[] | undefined;
+    allowedKeywords?: string[] | undefined;
+}): {
+    valid: boolean;
+};
+/**
+ * Validate space-separated multi-value strings
+ * @param {string} value - Space-separated values
+ * @param {Function} validator - Function to validate each individual value
+ * @param {Object} [validatorOptions] - Options to pass to validator
+ * @returns {{ valid: boolean }}
+ */
+export function validateMultiValue(value: string, validator: Function, validatorOptions?: any): {
+    valid: boolean;
+};
+/**
+ * Create standardized error response
+ * @param {string} subtype - Token subtype
+ * @param {string} value - Invalid value
+ * @param {string} expectedFormat - Expected format description
+ * @param {string} platform - Platform identifier
+ * @returns {{ valid: false, errorObject: Object }}
+ */
+export function createErrorResponse(subtype: string, value: string, expectedFormat: string, platform: string): {
+    valid: false;
+    errorObject: any;
+};
+export function createSuccessResponse(): {
+    valid: boolean;
+};
+export function validateFontFamily(value: any, config?: {}): {
+    valid: boolean;
+};
+/**
+ * Common validator for font weight - validates range with keywords
+ * @param {string} value - Value to validate
+ * @param {Object} rule - Rule configuration with range and keywords
+ * @param {boolean} [requireMultipleOf100] - Whether to require multiples of 100
+ * @returns {{ valid: boolean }} Validation result
+ */
+export function validateFontWeight(value: string, rule: any, requireMultipleOf100?: boolean): {
+    valid: boolean;
+};
+/**
+ * Common validator for opacity - validates numeric range
+ * @param {string} value - Value to validate
+ * @param {Object} rule - Rule configuration with min/max
+ * @returns {{ valid: boolean }} Validation result
+ */
+export function validateOpacity(value: string, rule: any): {
+    valid: boolean;
+};
+/**
+ * Platform-specific size value validator
+ * @param {string} value - Value to validate
+ * @param {Object} rule - Rule configuration
+ * @param {string[]} defaultUnits - Default allowed units for platform
+ * @returns {{ valid: boolean }} Validation result
+ */
+export function validatePlatformSizeValue(value: string, rule?: any, defaultUnits?: string[]): {
+    valid: boolean;
+};
+/**
+ * Platform-specific space value validator (supports multi-value)
+ * @param {string} value - Value to validate
+ * @param {Object} rule - Rule configuration
+ * @param {string[]} defaultUnits - Default allowed units for platform
+ * @returns {{ valid: boolean }} Validation result
+ */
+export function validatePlatformSpaceValue(value: string, rule?: any, defaultUnits?: string[]): {
+    valid: boolean;
+};
+/**
+ * Get description for a rule, using customDescription if available or generating dynamically
+ * @param {Object} rule - Rule configuration
+ * @returns {string} Description for the rule
+ */
+export function getRuleDescription(rule: any): string;
+/** Split "a, rgba(1,2,3), b" by commas NOT inside parentheses */
+export function splitByTopLevelComma(value: any): string[];
+/**
+ * Extract a color token from a shadow string.
+ * Handles function-form colors (rgb, rgba, hsl, hsla) which may contain
+ * internal commas and spaces, as well as hex (#rrggbb) and named colors.
+ *
+ * @param {string} s - Shadow string after stripping inset keyword
+ * @returns {{ color: string|null, remainder: string }}
+ */
+export function extractColor(s: string): {
+    color: string | null;
+    remainder: string;
+};
+/**
+ * Validate a box-shadow / elevation value.
+ * Shared by all platforms — callers supply the color validator and allowed length units.
+ *
+ * @param {string} value
+ * @param {Object} options
+ * @param {boolean}  [options.allowNone=false]    - Accept the keyword "none"
+ * @param {Function} options.colorValidator       - (color: string) => boolean
+ * @param {string[]} options.lengthUnits          - e.g. ["px"] or ["px","rem","em"]
+ * @returns {{ valid: boolean }}
+ */
+export function validateShadowValue(value: string, { allowNone, colorValidator, lengthUnits }: {
+    allowNone?: boolean | undefined;
+    colorValidator: Function;
+    lengthUnits: string[];
+}): {
+    valid: boolean;
+};
+export namespace COMMON_VALIDATORS {
+    export { validateFromAllowedList };
+    export { validatePlatformSizeValue };
+    export { validatePlatformSpaceValue };
+    export { validateFontFamily };
+    export { validateOpacity };
+    export { validateFontWeight };
+}