@servicetitan/stylelint-config 40.1.0 → 40.2.0

package/dist/use-tokens/values.js

@@ -37,34 +37,71 @@ _export(exports, {
         return zIndexes;
     }
 });
-const _core = require("@servicetitan/tokens/core");
 const _color = /*#__PURE__*/ _interop_require_default(require("color"));
-const _fs = /*#__PURE__*/ _interop_require_default(require("fs"));
+const _loadtokens = require("./load-tokens");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
     };
 }
-const toCamelCase = (str)=>str.replace(/(-[a-z])/g, ([, letter])=>letter.toUpperCase());
-const toSnakeCase = (str)=>str.replace(/([A-Z]|[a-z][0-9])/g, ([letter, digit])=>digit === undefined ? `-${letter.toLowerCase()}` : `${letter}-${digit}`);
-const aliases = _fs.default.readFileSync(require.resolve('@servicetitan/tokens/core/tokens.less'), 'utf8').split('\n').filter((row)=>row.startsWith('@') && row.endsWith('(alias)')).map((row)=>toCamelCase(row.split(':')[0].slice(1)));
-function getValues(condition, transformer) {
-    return Object.entries(_core.tokens).filter(([variable])=>!aliases.includes(variable) && condition(variable)).reduce((result, [variable, value])=>{
-        var _ref;
-        return {
-            ...result,
-            [(_ref = transformer === null || transformer === void 0 ? void 0 : transformer(value)) !== null && _ref !== void 0 ? _ref : value]: toSnakeCase(variable)
-        };
-    }, {});
+const tokens = (0, _loadtokens.loadTokens)();
+const colors = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^color/,
+    [_loadtokens.ANVIL2_SOURCE]: /^color-/
+}, (value)=>new _color.default(value).hexa());
+const typescales = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^typescale/,
+    [_loadtokens.ANVIL2_SOURCE]: /^font-size-/
+});
+const borderRadiuses = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^border-radius/,
+    [_loadtokens.ANVIL2_SOURCE]: /^radius-/
+});
+const spacings = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^spacing/,
+    [_loadtokens.ANVIL2_SOURCE]: /^size-/
+});
+const fontWeights = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^font-weight/,
+    [_loadtokens.ANVIL2_SOURCE]: /^font-weight-/
+});
+const opacities = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^opacity/
+});
+const zIndexes = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /^z-index/
+});
+const lineHeights = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /-line-height$/,
+    [_loadtokens.ANVIL2_SOURCE]: /^font-line-height-/
+});
+const fontFamilies = getValues({
+    [_loadtokens.DESIGN_SYSTEM_SOURCE]: /-font-family$/,
+    [_loadtokens.ANVIL2_SOURCE]: /^font-family-/
+}, (value)=>value.replace(/'/g, "'"));
+function getValues(patterns, transformer) {
+    return tokens.reduce((result, token)=>{
+        var _result_get;
+        var _patterns_token_source;
+        if (!((_patterns_token_source = patterns[token.source]) === null || _patterns_token_source === void 0 ? void 0 : _patterns_token_source.test(token.name))) {
+            return result;
+        }
+        /*
+         * A token the transformer can't normalize, such as an oklch() color, can never match a
+         * literal, so it's skipped rather than failing every lint run.
+         */ let value;
+        try {
+            var _ref;
+            value = (_ref = transformer === null || transformer === void 0 ? void 0 : transformer(token.value)) !== null && _ref !== void 0 ? _ref : token.value;
+        } catch (unused) {
+            return result;
+        }
+        /* Within a source, the last token with a given value wins. */ const matches = ((_result_get = result.get(value)) !== null && _result_get !== void 0 ? _result_get : []).filter(({ source })=>source !== token.source);
+        return result.set(value, [
+            ...matches,
+            token
+        ]);
+    }, new Map());
 }
-const colors = getValues((variable)=>variable.startsWith('color'), (value)=>new _color.default(value).hex());
-const typescales = getValues((variable)=>variable.startsWith('typescale'));
-const borderRadiuses = getValues((variable)=>variable.startsWith('borderRadius'));
-const spacings = getValues((variable)=>variable.startsWith('spacing'));
-const fontWeights = getValues((variable)=>variable.startsWith('fontWeight'));
-const opacities = getValues((variable)=>variable.startsWith('opacity'));
-const zIndexes = getValues((variable)=>variable.startsWith('zIndex'));
-const lineHeights = getValues((variable)=>variable.endsWith('LineHeight'));
-const fontFamilies = getValues((variable)=>variable.endsWith('FontFamily'), (value)=>value.replace(/'/g, "'"));
 
 //# sourceMappingURL=values.js.map

package/dist/use-tokens/values.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/use-tokens/values.ts"],"sourcesContent":["import { tokens } from '@servicetitan/tokens/core';\nimport Color from 'color';\nimport fs from 'fs';\n\nconst toCamelCase = (str: string) => str.replace(/(-[a-z])/g, ([, letter]) => letter.toUpperCase());\nconst toSnakeCase = (str: string) =>\n    str.replace(/([A-Z]|[a-z][0-9])/g, ([letter, digit]) =>\n        digit === undefined ? `-${letter.toLowerCase()}` : `${letter}-${digit}`\n    );\n\nconst aliases = fs\n    .readFileSync(require.resolve('@servicetitan/tokens/core/tokens.less'), 'utf8')\n    .split('\\n')\n    .filter(row => row.startsWith('@') && row.endsWith('(alias)'))\n    .map(row => toCamelCase(row.split(':')[0].slice(1)));\n\nfunction getValues(\n    condition: (variable: string) => boolean,\n    transformer?: (value: string) => string\n) {\n    return Object.entries(tokens)\n        .filter(([variable]) => !aliases.includes(variable) && condition(variable))\n        .reduce<Record<string, string>>(\n            (result, [variable, value]) => ({\n                ...result,\n                [transformer?.(value) ?? value]: toSnakeCase(variable),\n            }),\n            {}\n        );\n}\n\nexport const colors = getValues(\n    variable => variable.startsWith('color'),\n    value => new Color(value).hex()\n);\nexport const typescales = getValues(variable => variable.startsWith('typescale'));\nexport const borderRadiuses = getValues(variable => variable.startsWith('borderRadius'));\nexport const spacings = getValues(variable => variable.startsWith('spacing'));\nexport const fontWeights = getValues(variable => variable.startsWith('fontWeight'));\nexport const opacities = getValues(variable => variable.startsWith('opacity'));\nexport const zIndexes = getValues(variable => variable.startsWith('zIndex'));\nexport const lineHeights = getValues(variable => variable.endsWith('LineHeight'));\nexport const fontFamilies = getValues(\n    variable => variable.endsWith('FontFamily'),\n    value => value.replace(/&#x27;/g, \"'\")\n);\n"],"names":["borderRadiuses","colors","fontFamilies","fontWeights","lineHeights","opacities","spacings","typescales","zIndexes","toCamelCase","str","replace","letter","toUpperCase","toSnakeCase","digit","undefined","toLowerCase","aliases","fs","readFileSync","require","resolve","split","filter","row","startsWith","endsWith","map","slice","getValues","condition","transformer","Object","entries","tokens","variable","includes","reduce","result","value","Color","hex"],"mappings":";;;;;;;;;;;QAoCaA;eAAAA;;QALAC;eAAAA;;QAWAC;eAAAA;;QAJAC;eAAAA;;QAGAC;eAAAA;;QAFAC;eAAAA;;QAFAC;eAAAA;;QAFAC;eAAAA;;QAKAC;eAAAA;;;sBAxCU;8DACL;2DACH;;;;;;AAEf,MAAMC,cAAc,CAACC,MAAgBA,IAAIC,OAAO,CAAC,aAAa,CAAC,GAAGC,OAAO,GAAKA,OAAOC,WAAW;AAChG,MAAMC,cAAc,CAACJ,MACjBA,IAAIC,OAAO,CAAC,uBAAuB,CAAC,CAACC,QAAQG,MAAM,GAC/CA,UAAUC,YAAY,CAAC,CAAC,EAAEJ,OAAOK,WAAW,IAAI,GAAG,GAAGL,OAAO,CAAC,EAAEG,OAAO;AAG/E,MAAMG,UAAUC,WAAE,CACbC,YAAY,CAACC,QAAQC,OAAO,CAAC,0CAA0C,QACvEC,KAAK,CAAC,MACNC,MAAM,CAACC,CAAAA,MAAOA,IAAIC,UAAU,CAAC,QAAQD,IAAIE,QAAQ,CAAC,YAClDC,GAAG,CAACH,CAAAA,MAAOhB,YAAYgB,IAAIF,KAAK,CAAC,IAAI,CAAC,EAAE,CAACM,KAAK,CAAC;AAEpD,SAASC,UACLC,SAAwC,EACxCC,WAAuC;IAEvC,OAAOC,OAAOC,OAAO,CAACC,YAAM,EACvBX,MAAM,CAAC,CAAC,CAACY,SAAS,GAAK,CAAClB,QAAQmB,QAAQ,CAACD,aAAaL,UAAUK,WAChEE,MAAM,CACH,CAACC,QAAQ,CAACH,UAAUI,MAAM;;eAAM;YAC5B,GAAGD,MAAM;YACT,SAACP,wBAAAA,kCAAAA,YAAcQ,6CAAUA,MAAM,EAAE1B,YAAYsB;QACjD;OACA,CAAC;AAEb;AAEO,MAAMnC,SAAS6B,UAClBM,CAAAA,WAAYA,SAASV,UAAU,CAAC,UAChCc,CAAAA,QAAS,IAAIC,cAAK,CAACD,OAAOE,GAAG;AAE1B,MAAMnC,aAAauB,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AAC7D,MAAM1B,iBAAiB8B,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AACjE,MAAMpB,WAAWwB,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AAC3D,MAAMvB,cAAc2B,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AAC9D,MAAMrB,YAAYyB,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AAC5D,MAAMlB,WAAWsB,UAAUM,CAAAA,WAAYA,SAASV,UAAU,CAAC;AAC3D,MAAMtB,cAAc0B,UAAUM,CAAAA,WAAYA,SAAST,QAAQ,CAAC;AAC5D,MAAMzB,eAAe4B,UACxBM,CAAAA,WAAYA,SAAST,QAAQ,CAAC,eAC9Ba,CAAAA,QAASA,MAAM7B,OAAO,CAAC,WAAW"}
+{"version":3,"sources":["../../src/use-tokens/values.ts"],"sourcesContent":["import Color from 'color';\nimport { ANVIL2_SOURCE, DESIGN_SYSTEM_SOURCE, Token, TokenSource, loadTokens } from './load-tokens';\n\n/* Maps a literal value to the tokens that hold it, at most one per source. */\nexport type TokenCollection = Map<string, Token[]>;\n\nconst tokens = loadTokens();\n\nexport const colors = getValues(\n    { [DESIGN_SYSTEM_SOURCE]: /^color/, [ANVIL2_SOURCE]: /^color-/ },\n    value => new Color(value).hexa()\n);\nexport const typescales = getValues({\n    [DESIGN_SYSTEM_SOURCE]: /^typescale/,\n    [ANVIL2_SOURCE]: /^font-size-/,\n});\nexport const borderRadiuses = getValues({\n    [DESIGN_SYSTEM_SOURCE]: /^border-radius/,\n    [ANVIL2_SOURCE]: /^radius-/,\n});\nexport const spacings = getValues({\n    [DESIGN_SYSTEM_SOURCE]: /^spacing/,\n    [ANVIL2_SOURCE]: /^size-/,\n});\nexport const fontWeights = getValues({\n    [DESIGN_SYSTEM_SOURCE]: /^font-weight/,\n    [ANVIL2_SOURCE]: /^font-weight-/,\n});\nexport const opacities = getValues({ [DESIGN_SYSTEM_SOURCE]: /^opacity/ });\nexport const zIndexes = getValues({ [DESIGN_SYSTEM_SOURCE]: /^z-index/ });\nexport const lineHeights = getValues({\n    [DESIGN_SYSTEM_SOURCE]: /-line-height$/,\n    [ANVIL2_SOURCE]: /^font-line-height-/,\n});\nexport const fontFamilies = getValues(\n    { [DESIGN_SYSTEM_SOURCE]: /-font-family$/, [ANVIL2_SOURCE]: /^font-family-/ },\n    value => value.replace(/&#x27;/g, \"'\")\n);\n\nfunction getValues(\n    patterns: Partial<Record<TokenSource, RegExp>>,\n    transformer?: (value: string) => string\n) {\n    return tokens.reduce<TokenCollection>((result, token) => {\n        if (!patterns[token.source]?.test(token.name)) {\n            return result;\n        }\n\n        /*\n         * A token the transformer can't normalize, such as an oklch() color, can never match a\n         * literal, so it's skipped rather than failing every lint run.\n         */\n        let value: string;\n        try {\n            value = transformer?.(token.value) ?? token.value;\n        } catch {\n            return result;\n        }\n\n        /* Within a source, the last token with a given value wins. */\n        const matches = (result.get(value) ?? []).filter(({ source }) => source !== token.source);\n        return result.set(value, [...matches, token]);\n    }, new Map());\n}\n"],"names":["borderRadiuses","colors","fontFamilies","fontWeights","lineHeights","opacities","spacings","typescales","zIndexes","tokens","loadTokens","getValues","DESIGN_SYSTEM_SOURCE","ANVIL2_SOURCE","value","Color","hexa","replace","patterns","transformer","reduce","result","token","source","test","name","matches","get","filter","set","Map"],"mappings":";;;;;;;;;;;QAgBaA;eAAAA;;QARAC;eAAAA;;QA0BAC;eAAAA;;QAVAC;eAAAA;;QAMAC;eAAAA;;QAFAC;eAAAA;;QARAC;eAAAA;;QARAC;eAAAA;;QAiBAC;eAAAA;;;8DA7BK;4BACkE;;;;;;AAKpF,MAAMC,SAASC,IAAAA,sBAAU;AAElB,MAAMT,SAASU,UAClB;IAAE,CAACC,gCAAoB,CAAC,EAAE;IAAU,CAACC,yBAAa,CAAC,EAAE;AAAU,GAC/DC,CAAAA,QAAS,IAAIC,cAAK,CAACD,OAAOE,IAAI;AAE3B,MAAMT,aAAaI,UAAU;IAChC,CAACC,gCAAoB,CAAC,EAAE;IACxB,CAACC,yBAAa,CAAC,EAAE;AACrB;AACO,MAAMb,iBAAiBW,UAAU;IACpC,CAACC,gCAAoB,CAAC,EAAE;IACxB,CAACC,yBAAa,CAAC,EAAE;AACrB;AACO,MAAMP,WAAWK,UAAU;IAC9B,CAACC,gCAAoB,CAAC,EAAE;IACxB,CAACC,yBAAa,CAAC,EAAE;AACrB;AACO,MAAMV,cAAcQ,UAAU;IACjC,CAACC,gCAAoB,CAAC,EAAE;IACxB,CAACC,yBAAa,CAAC,EAAE;AACrB;AACO,MAAMR,YAAYM,UAAU;IAAE,CAACC,gCAAoB,CAAC,EAAE;AAAW;AACjE,MAAMJ,WAAWG,UAAU;IAAE,CAACC,gCAAoB,CAAC,EAAE;AAAW;AAChE,MAAMR,cAAcO,UAAU;IACjC,CAACC,gCAAoB,CAAC,EAAE;IACxB,CAACC,yBAAa,CAAC,EAAE;AACrB;AACO,MAAMX,eAAeS,UACxB;IAAE,CAACC,gCAAoB,CAAC,EAAE;IAAiB,CAACC,yBAAa,CAAC,EAAE;AAAgB,GAC5EC,CAAAA,QAASA,MAAMG,OAAO,CAAC,WAAW;AAGtC,SAASN,UACLO,QAA8C,EAC9CC,WAAuC;IAEvC,OAAOV,OAAOW,MAAM,CAAkB,CAACC,QAAQC;YAiB1BD;YAhBZH;QAAL,IAAI,GAACA,yBAAAA,QAAQ,CAACI,MAAMC,MAAM,CAAC,cAAtBL,6CAAAA,uBAAwBM,IAAI,CAACF,MAAMG,IAAI,IAAG;YAC3C,OAAOJ;QACX;QAEA;;;SAGC,GACD,IAAIP;QACJ,IAAI;;YACAA,gBAAQK,wBAAAA,kCAAAA,YAAcG,MAAMR,KAAK,wCAAKQ,MAAMR,KAAK;QACrD,EAAE,eAAM;YACJ,OAAOO;QACX;QAEA,4DAA4D,GAC5D,MAAMK,UAAU,EAACL,cAAAA,OAAOM,GAAG,CAACb,oBAAXO,yBAAAA,cAAqB,EAAE,EAAEO,MAAM,CAAC,CAAC,EAAEL,MAAM,EAAE,GAAKA,WAAWD,MAAMC,MAAM;QACxF,OAAOF,OAAOQ,GAAG,CAACf,OAAO;eAAIY;YAASJ;SAAM;IAChD,GAAG,IAAIQ;AACX"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/stylelint-config",
-    "version": "40.1.0",
+    "version": "40.2.0",
     "description": "Core Stylelint rule sets for ServiceTitan web projects",
     "homepage": "https://docs.st.dev/docs/frontend/uikit/eslint-config",
     "repository": {
@@ -17,22 +17,30 @@
     ],
     "dependencies": {
         "color": "~5.0.3",
-        "lodash": "^4.18.1",
         "stylelint-config-standard": "~40.0.0",
         "stylelint-config-standard-less": "^4.1.0",
         "stylelint-config-standard-scss": "^17.0.0",
         "stylelint-prettier": "~5.0.3"
     },
     "devDependencies": {
+        "@servicetitan/anvil2": "^3.16.1",
         "@servicetitan/tokens": "~12.9.0",
-        "@types/lodash": "~4.17.23",
-        "stylelint": "~17.15.0"
+        "stylelint": "~17.16.0"
     },
     "peerDependencies": {
+        "@servicetitan/anvil2": ">=1.9.0",
         "@servicetitan/tokens": ">=12",
         "postcss": ">=8",
         "stylelint": ">=16"
     },
+    "peerDependenciesMeta": {
+        "@servicetitan/anvil2": {
+            "optional": true
+        },
+        "@servicetitan/tokens": {
+            "optional": true
+        }
+    },
     "publishConfig": {
         "access": "public"
     },

package/src/__tests__/function-url-no-absolute.test.ts

@@ -0,0 +1,84 @@
+import postcss from 'postcss';
+
+/*
+ * Stylelint is ESM-only, and Jest can only load ESM-only packages on Node 24.9+ with
+ * --experimental-vm-modules, so the rule runs directly against a postcss tree with stylelint's
+ * plugin utilities replaced.
+ */
+jest.mock('stylelint', () => ({
+    createPlugin: (ruleName: string, rule: unknown) => ({ ruleName, rule }),
+    utils: {
+        ruleMessages: (_ruleName: string, messages: unknown) => messages,
+        validateOptions: () => mockValidOptions,
+        report: mockReport,
+    },
+}));
+
+const mockReport = jest.fn();
+let mockValidOptions: boolean;
+
+/*
+ * The rule reads stylelint's utilities when it loads, so it's required after the mocks they
+ * reference are initialized. A static import would be hoisted above them.
+ */
+const { rule } = require('../function-url-no-absolute');
+
+describe(`[stylelint-config] ${rule.ruleName} rule`, () => {
+    let declaration: string;
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockValidOptions = true;
+        declaration = 'background: url(/assets/image.png)';
+    });
+
+    const subject = () => {
+        rule(true, {}, {})(postcss.parse(`a { ${declaration} }`), {});
+        return mockReport.mock.calls.map(([report]) => report);
+    };
+
+    test('reports the absolute url', () => {
+        expect(subject()).toEqual([
+            expect.objectContaining({
+                message: 'Unexpected absolute url',
+                index: declaration.indexOf('/assets'),
+                endIndex: declaration.indexOf(')'),
+            }),
+        ]);
+    });
+
+    describe.each([
+        ['double quotes', 'background: url("/assets/image.png")'],
+        ['single quotes', "background: url('/assets/image.png')"],
+        ['spaces and quotes', 'background: url( "/assets/image.png" )'],
+        ['an uppercase function name', 'background: URL(/assets/image.png)'],
+    ])('with %s', (_description, value) => {
+        beforeEach(() => (declaration = value));
+
+        test('reports the absolute url', () => {
+            expect(subject()).toHaveLength(1);
+        });
+    });
+
+    describe.each([
+        ['a relative url', 'background: url(./assets/image.png)'],
+        ['a protocol-relative url', 'background: url(//cdn.example.com/image.png)'],
+        ['a full url', 'background: url(https://cdn.example.com/image.png)'],
+        ['a data url', 'background: url(data:image/png;base64,AAAA)'],
+        ['no url', 'color: red'],
+    ])('with %s', (_description, value) => {
+        beforeEach(() => (declaration = value));
+
+        test('reports nothing', () => {
+            expect(subject()).toEqual([]);
+        });
+    });
+
+    describe('with invalid options', () => {
+        beforeEach(() => (mockValidOptions = false));
+
+        test('reports nothing', () => {
+            expect(subject()).toEqual([]);
+        });
+    });
+});

package/src/function-url-no-absolute.ts

@@ -1,4 +1,3 @@
-import trim from 'lodash/trim';
 import { Rule, createPlugin, utils } from 'stylelint';
 
 const functionArgumentsSearch = (
@@ -28,7 +27,7 @@ const plugin: Rule = actual => {
 
         root.walkDecls(decl => {
             functionArgumentsSearch(decl.toString().toLowerCase(), 'url', (args, index) => {
-                const url = trim(args, ' \'"');
+                const url = args.replace(/(^[ '"]+)|([ '"]+$)/g, '');
 
                 if (!isAbsoluteUrl(url)) {
                     return;

package/src/use-tokens/__tests__/load-tokens.test.ts

@@ -0,0 +1,135 @@
+import { fs, vol } from 'memfs';
+import type { Token } from '../load-tokens';
+
+jest.mock('fs', () => fs);
+jest.mock('@servicetitan/tokens/core', () => ({
+    tokens: mockInstalled(mockDesignSystemTokens),
+}));
+jest.mock('@servicetitan/anvil2/token', () => {
+    if (mockAnvil2Error) {
+        throw mockAnvil2Error;
+    }
+    return { core: { primitive: mockInstalled(mockAnvil2Primitives) } };
+});
+jest.mock('@servicetitan/anvil2/package.json', () => {
+    if (mockAnvil2Version === undefined) {
+        throw Object.assign(new Error('Package subpath not exported'), {
+            code: 'ERR_PACKAGE_PATH_NOT_EXPORTED',
+        });
+    }
+    return { version: mockAnvil2Version };
+});
+
+let mockDesignSystemTokens: Record<string, string> | undefined;
+let mockAnvil2Primitives: Record<string, { value: string }> | undefined;
+let mockAnvil2Error: Error | undefined;
+let mockAnvil2Version: string | undefined;
+
+function mockInstalled<T>(exports: T | undefined) {
+    if (!exports) {
+        throw Object.assign(new Error('Cannot find module'), { code: 'MODULE_NOT_FOUND' });
+    }
+    return exports;
+}
+
+describe('[stylelint-config] loadTokens', () => {
+    const designSystemLessPath = require.resolve('@servicetitan/tokens/core/tokens.less');
+    const value = '#0265dc';
+
+    beforeEach(() => {
+        jest.resetModules();
+        mockDesignSystemTokens = undefined;
+        mockAnvil2Primitives = undefined;
+        mockAnvil2Error = undefined;
+        mockAnvil2Version = '3.15.0';
+        vol.reset();
+        vol.fromJSON({ [designSystemLessPath]: '' });
+    });
+
+    const subject = (): Token[] => require('../load-tokens').loadTokens();
+
+    function itReturnsNoTokens() {
+        test('returns no tokens', () => {
+            expect(subject()).toEqual([]);
+        });
+    }
+
+    itReturnsNoTokens();
+
+    describe('with @servicetitan/tokens', () => {
+        beforeEach(() => (mockDesignSystemTokens = { colorBlue500: value }));
+
+        test('returns its tokens', () => {
+            expect(subject()).toEqual([
+                {
+                    name: 'color-blue-500',
+                    customProperty: '--color-blue-500',
+                    source: '@servicetitan/tokens',
+                    value,
+                },
+            ]);
+        });
+
+        describe('with an alias', () => {
+            beforeEach(() => {
+                mockDesignSystemTokens!.colorPrimary = value;
+                vol.fromJSON({
+                    [designSystemLessPath]: '@color-primary: @color-blue-500; // (alias)',
+                });
+            });
+
+            test('excludes the alias', () => {
+                expect(subject().map(({ name }) => name)).toEqual(['color-blue-500']);
+            });
+        });
+    });
+
+    describe('with @servicetitan/anvil2', () => {
+        beforeEach(() => (mockAnvil2Primitives = { ColorBlue600: { value } }));
+
+        test('returns its primitive tokens', () => {
+            expect(subject()).toEqual([
+                {
+                    name: 'color-blue-600',
+                    customProperty: '--a2-color-blue-600',
+                    source: '@servicetitan/anvil2',
+                    value,
+                },
+            ]);
+        });
+
+        describe('when version is earlier than 3', () => {
+            beforeEach(() => (mockAnvil2Version = '2.9.6'));
+
+            test('omits the "a2" prefix', () => {
+                expect(subject()[0].customProperty).toBe('--color-blue-600');
+            });
+        });
+
+        describe('when version cannot be determined', () => {
+            beforeEach(() => (mockAnvil2Version = undefined));
+
+            test('adds the "a2" prefix', () => {
+                expect(subject()[0].customProperty).toBe('--a2-color-blue-600');
+            });
+        });
+
+        describe('without the token export', () => {
+            beforeEach(() => {
+                mockAnvil2Error = Object.assign(new Error('Package subpath not exported'), {
+                    code: 'ERR_PACKAGE_PATH_NOT_EXPORTED',
+                });
+            });
+
+            itReturnsNoTokens();
+        });
+
+        describe('when the package fails to load', () => {
+            beforeEach(() => (mockAnvil2Error = new Error('Unexpected token')));
+
+            test('throws the error', () => {
+                expect(subject).toThrow(mockAnvil2Error);
+            });
+        });
+    });
+});