style-dictionary 4.0.0-prerelease.13 → 4.0.0-prerelease.15

package/examples/advanced/assets-base64-embed/package.json

@@ -11,6 +11,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/auto-rebuild-watcher/package.json

@@ -17,6 +17,6 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "chokidar-cli": "^1.2.0",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/component-cti/package.json

@@ -15,6 +15,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/create-react-app/package.json

@@ -11,7 +11,7 @@
   },
   "devDependencies": {
     "eslint-config-react-app": "^7.0.1",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   },
   "resolutions": {
     "immer": "8.0.1",

package/examples/advanced/create-react-native-app/package.json

@@ -28,7 +28,7 @@
     "eslint-config-react-app": "^7.0.1",
     "jest": "~25.2.6",
     "react-test-renderer": "~16.13.1",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   },
   "jest": {
     "preset": "react-native"

package/examples/advanced/custom-file-header/package.json

@@ -10,6 +10,6 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/custom-filters/package.json

@@ -15,6 +15,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/custom-formats-with-templates/package.json

@@ -18,6 +18,6 @@
     "handlebars": "^4.7.7",
     "lodash": "^4.17.21",
     "pug": "^3.0.2",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/custom-parser/package.json

@@ -9,6 +9,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/custom-transforms/package.json

@@ -15,6 +15,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/font-face-rules/package.json

@@ -8,6 +8,6 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/format-helpers/package.json

@@ -10,6 +10,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/matching-build-files/package.json

@@ -16,6 +16,6 @@
   "author": "Kelly Harrop <kn.harrop@gmail.com>",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/multi-brand-multi-platform/package.json

@@ -15,6 +15,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/node-modules-as-config-and-properties/package.json

@@ -19,7 +19,7 @@
   },
   "homepage": "https://github.com/dbanksdesign/style-dictionary-node#readme",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13",
+    "style-dictionary": "4.0.0-prerelease.15",
     "tinycolor2": "^1.4.1"
   }
 }

package/examples/advanced/npm-module/package.json

@@ -16,6 +16,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/referencing_aliasing/package.json

@@ -15,6 +15,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/s3/package.json

@@ -15,6 +15,6 @@
   "devDependencies": {
     "aws-sdk": "^2.7.21",
     "fs-extra": "^1.0.0",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/tokens-deprecation/package.json

@@ -16,6 +16,6 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "lodash": "^4.17.11",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/transitive-transforms/package.json

@@ -11,6 +11,6 @@
   "license": "ISC",
   "devDependencies": {
     "chroma-js": "^2.1.0",
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/variables-in-outputs/package.json

@@ -10,6 +10,6 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13"
+    "style-dictionary": "4.0.0-prerelease.15"
   }
 }

package/examples/advanced/yaml-tokens/package.json

@@ -9,7 +9,7 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "4.0.0-prerelease.13",
+    "style-dictionary": "4.0.0-prerelease.15",
     "yaml": "^1.10.0"
   }
 }

package/lib/StyleDictionary.js

@@ -25,6 +25,8 @@ import deepExtend from './utils/deepExtend.js';
 import resolveObject from './utils/resolveObject.js';
 import getName from './utils/references/getName.js';
 import GroupMessages from './utils/groupMessages.js';
+import flattenTokens from './utils/flattenTokens.js';
+import { detectDtcgSyntax } from './utils/detectDtcgSyntax.js';
 import { preprocess } from './utils/preprocess.js';
 
 import transformObject from './transform/object.js';
@@ -34,7 +36,6 @@ import buildFiles from './buildFiles.js';
 import cleanFiles from './cleanFiles.js';
 import cleanDirs from './cleanDirs.js';
 import cleanActions from './cleanActions.js';
-import flattenTokens from './utils/flattenTokens.js';
 
 /**
  * @typedef {import('../types/Config.d.ts').Config} Config
@@ -65,7 +66,7 @@ export default class StyleDictionary extends Register {
   // Placeholder is transformed on prepublish -> see scripts/inject-version.js
   // Another option might be import pkg from './package.json' with { "type": "json" } which would work in both browser and node, but support is not there yet.
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#browser_compatibility
-  static VERSION = '4.0.0-prerelease.13';
+  static VERSION = '4.0.0-prerelease.15';
   static formatHelpers = formatHelpers;
 
   /** @returns {Config} */
@@ -147,6 +148,7 @@ export default class StyleDictionary extends Register {
     let includeTokens = {};
     /** @type {Tokens} */
     let sourceTokens = {};
+
     // Overloaded method, can accept a string as a path that points to a JS or
     // JSON file or a plain object. Potentially refactor.
     if (typeof config === 'string') {
@@ -176,9 +178,12 @@ export default class StyleDictionary extends Register {
     });
     this.options = options;
 
-    // Creating a new object and copying over the options
-    // Also keeping an options object in case
+    let { usesDtcg } = this.options;
 
+    // Try to detect DTCG if not specified by user in options
+    if (Object.entries(this.tokens).length > 0 && usesDtcg === undefined) {
+      usesDtcg = detectDtcgSyntax(this.tokens);
+    }
     // grab the inline tokens, ones either defined in the configuration object
     // or that already exist from extending another style dictionary instance
     // with `tokens` keys
@@ -188,14 +193,28 @@ export default class StyleDictionary extends Register {
     if (this.options.include) {
       if (!Array.isArray(this.options.include)) throw new Error('include must be an array');
 
-      includeTokens = await combineJSON(this.options.include, true, undefined, false, this.parsers);
+      const result = await combineJSON(
+        this.options.include,
+        true,
+        undefined,
+        false,
+        this.parsers,
+        this.options.usesDtcg,
+      );
+
+      includeTokens = result.tokens;
+      // If it wasn't known yet whether DTCG is used, combineJSON util will have auto-detected it
+      if (usesDtcg === undefined) {
+        usesDtcg = result.usesDtcg;
+      }
     }
 
     // Update tokens with current package's source
     // These highest precedence
     if (this.options.source) {
       if (!Array.isArray(this.options.source)) throw new Error('source must be an array');
-      sourceTokens = await combineJSON(
+
+      const result = await combineJSON(
         this.options.source,
         true,
         /** @param {Token} prop */
@@ -209,8 +228,15 @@ export default class StyleDictionary extends Register {
         },
         true,
         this.parsers,
+        this.options.usesDtcg,
       );
 
+      sourceTokens = result.tokens;
+      // If it wasn't known yet whether DTCG is used, combineJSON util will have auto-detected it
+      if (usesDtcg === undefined) {
+        usesDtcg = result.usesDtcg;
+      }
+
       if (GroupMessages.count(PROPERTY_VALUE_COLLISIONS) > 0) {
         const collisions = GroupMessages.flush(PROPERTY_VALUE_COLLISIONS).join('\n');
         const warn = `\n${PROPERTY_VALUE_COLLISIONS}:\n${collisions}\n\n`;
@@ -226,6 +252,7 @@ export default class StyleDictionary extends Register {
     // Merge inline, include, and source tokens
     const unprocessedTokens = deepExtend([{}, inlineTokens, includeTokens, sourceTokens]);
     this.tokens = await preprocess(unprocessedTokens, this.preprocessors);
+    this.options = { ...this.options, usesDtcg };
     this.hasInitializedResolve(null);
 
     // For chaining
@@ -306,7 +333,12 @@ export default class StyleDictionary extends Register {
       // values like "1px solid {color.border.base}" we want to
       // transform the original value (color.border.base) before
       // replacing that value in the string.
-      const transformed = transformObject(exportableResult, platformConfig, transformationContext);
+      const transformed = await transformObject(
+        exportableResult,
+        platformConfig,
+        this.options,
+        transformationContext,
+      );
 
       // referenced values, that have not (yet) been transformed should be excluded from resolving
       const ignorePathsToResolve = deferredPropValueTransforms.map((p) => getName([p, 'value']));
@@ -365,7 +397,9 @@ export default class StyleDictionary extends Register {
     // transform the original value (color.border.base) before
     // replacing that value in the string.
     const tokens = await this.exportPlatform(platform);
-    this.allTokens = /** @type {TransformedToken[]} */ (flattenTokens(tokens));
+    this.allTokens = /** @type {TransformedToken[]} */ (
+      flattenTokens(tokens, this.options.usesDtcg)
+    );
     // This is the dictionary object we pass to the file
     // building and action methods.
     return { dictionary: { tokens, allTokens: this.allTokens }, platformConfig };
@@ -377,8 +411,8 @@ export default class StyleDictionary extends Register {
    */
   async buildPlatform(platform) {
     const { dictionary, platformConfig } = await this.getPlatform(platform);
-    buildFiles(dictionary, platformConfig);
-    performActions(dictionary, platformConfig);
+    await buildFiles(dictionary, platformConfig, this.options);
+    await performActions(dictionary, platformConfig, this.options);
     // For chaining
     return this;
   }
@@ -399,9 +433,9 @@ export default class StyleDictionary extends Register {
   async cleanPlatform(platform) {
     const { dictionary, platformConfig } = await this.getPlatform(platform);
     // We clean files first, then actions, ...and then directories?
-    cleanFiles(platformConfig);
-    cleanActions(dictionary, platformConfig);
-    cleanDirs(platformConfig);
+    await cleanFiles(platformConfig);
+    await cleanActions(dictionary, platformConfig, this.options);
+    await cleanDirs(platformConfig);
     // For chaining
     return this;
   }

package/lib/buildFile.d.ts

@@ -2,6 +2,7 @@
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
  * @typedef {import('../types/DesignToken.d.ts').TransformedToken} TransformedToken
  * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  * @typedef {import('../types/File.d.ts').File} File
  */
 /**
@@ -11,9 +12,11 @@
  * @param {File} file
  * @param {PlatformConfig} platform
  * @param {Dictionary} dictionary
+ * @param {Config} options
  */
-export default function buildFile(file: File, platform: import("../types/Config.d.ts").PlatformConfig | undefined, dictionary: Dictionary): null | undefined;
+export default function buildFile(file: File, platform: import("../types/Config.d.ts").PlatformConfig | undefined, dictionary: Dictionary, options: Config): Promise<null | undefined>;
 export type Dictionary = import('../types/DesignToken.d.ts').Dictionary;
 export type TransformedToken = import('../types/DesignToken.d.ts').TransformedToken;
 export type PlatformConfig = import('../types/Config.d.ts').PlatformConfig;
+export type Config = import('../types/Config.d.ts').Config;
 export type File = import('../types/File.d.ts').File;

package/lib/buildFile.js

@@ -23,6 +23,7 @@ import createFormatArgs from './utils/createFormatArgs.js';
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
  * @typedef {import('../types/DesignToken.d.ts').TransformedToken} TransformedToken
  * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  * @typedef {import('../types/File.d.ts').File} File
  */
 
@@ -33,8 +34,9 @@ import createFormatArgs from './utils/createFormatArgs.js';
  * @param {File} file
  * @param {PlatformConfig} platform
  * @param {Dictionary} dictionary
+ * @param {Config} options
  */
-export default function buildFile(file, platform = {}, dictionary) {
+export default async function buildFile(file, platform = {}, dictionary, options) {
   const { destination, filter } = file || {};
   let { format } = file || {};
 
@@ -56,7 +58,7 @@ export default function buildFile(file, platform = {}, dictionary) {
   const dir = dirname(fullDestination);
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 
-  const filteredTokens = filterTokens(dictionary, filter);
+  const filteredTokens = await filterTokens(dictionary, filter, options);
   const filteredDictionary = Object.assign({}, dictionary, {
     tokens: filteredTokens.tokens,
     allTokens: filteredTokens.allTokens,
@@ -98,7 +100,7 @@ export default function buildFile(file, platform = {}, dictionary) {
       let collisions = nameCollisionObj[tokenName]
         .map((token) => {
           let tokenPathText = chalk.rgb(255, 69, 0)(token.path.join('.'));
-          let valueText = chalk.rgb(255, 140, 0)(token.$value ?? token.value);
+          let valueText = chalk.rgb(255, 140, 0)(options.usesDtcg ? token.$value : token.value);
           return tokenPathText + '   ' + valueText;
         })
         .join('\n        ');
@@ -112,17 +114,18 @@ export default function buildFile(file, platform = {}, dictionary) {
   });
 
   const tokenNamesCollisionCount = GroupMessages.count(PROPERTY_NAME_COLLISION_WARNINGS);
-  fs.writeFileSync(
-    fullDestination,
-    format(
-      createFormatArgs({
-        dictionary: filteredDictionary,
-        platform,
-        file,
-      }),
-    ),
+
+  const formattedContent = await format(
+    createFormatArgs({
+      dictionary: filteredDictionary,
+      platform,
+      options,
+      file,
+    }),
   );
 
+  await fs.promises.writeFile(fullDestination, formattedContent);
+
   const filteredReferencesCount = GroupMessages.count(GroupMessages.GROUP.FilteredOutputReferences);
 
   // don't show name collision warnings for nested type formats

package/lib/buildFiles.d.ts

@@ -1,6 +1,7 @@
 /**
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
- * @typedef {import('../types/Config.d.ts').PlatformConfig} Config
+ * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  */
 /**
  * Takes a platform config object and a dictionary
@@ -9,8 +10,10 @@
  * point.
  * @memberOf StyleDictionary
  * @param {Dictionary} dictionary
- * @param {Config} platform
+ * @param {PlatformConfig} platform
+ * @param {Config} options
  */
-export default function buildFiles(dictionary: Dictionary, platform: Config): void;
+export default function buildFiles(dictionary: Dictionary, platform: PlatformConfig, options: Config): Promise<(null | undefined)[] | undefined>;
 export type Dictionary = import('../types/DesignToken.d.ts').Dictionary;
-export type Config = import('../types/Config.d.ts').PlatformConfig;
+export type PlatformConfig = import('../types/Config.d.ts').PlatformConfig;
+export type Config = import('../types/Config.d.ts').Config;

package/lib/buildFiles.js

@@ -15,7 +15,8 @@ import buildFile from './buildFile.js';
 
 /**
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
- * @typedef {import('../types/Config.d.ts').PlatformConfig} Config
+ * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  */
 
 /**
@@ -25,9 +26,10 @@ import buildFile from './buildFile.js';
  * point.
  * @memberOf StyleDictionary
  * @param {Dictionary} dictionary
- * @param {Config} platform
+ * @param {PlatformConfig} platform
+ * @param {Config} options
  */
-export default function buildFiles(dictionary, platform) {
+export default async function buildFiles(dictionary, platform, options) {
   if (
     platform.buildPath &&
     platform.buildPath.slice(-1) !== '/' &&
@@ -36,11 +38,15 @@ export default function buildFiles(dictionary, platform) {
     throw new Error('Build path must end in a trailing slash or you will get weird file names.');
   }
 
-  platform.files?.forEach(function (file) {
-    if (file.format) {
-      buildFile(file, platform, dictionary);
-    } else {
-      throw new Error('Please supply a format');
-    }
-  });
+  if (platform.files) {
+    return Promise.all(
+      platform.files.map((file) => {
+        if (file.format) {
+          return buildFile(file, platform, dictionary, options);
+        } else {
+          throw new Error('Please supply a format');
+        }
+      }),
+    );
+  }
 }

package/lib/cleanActions.d.ts

@@ -1,6 +1,7 @@
 /**
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
- * @typedef {import('../types/Config.d.ts').PlatformConfig} Config
+ * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  */
 /**
  * Performs the undo of any actions defined in a platform. Pretty
@@ -10,8 +11,10 @@
  * @private
  * @memberof module:style-dictionary
  * @param {Dictionary} dictionary
- * @param {Config} platform
+ * @param {PlatformConfig} platform
+ * @param {Config} options
  */
-export default function cleanActions(dictionary: Dictionary, platform: Config): void;
+export default function cleanActions(dictionary: Dictionary, platform: PlatformConfig, options: Config): Promise<void[] | undefined>;
 export type Dictionary = import('../types/DesignToken.d.ts').Dictionary;
-export type Config = import('../types/Config.d.ts').PlatformConfig;
+export type PlatformConfig = import('../types/Config.d.ts').PlatformConfig;
+export type Config = import('../types/Config.d.ts').Config;

package/lib/cleanActions.js

@@ -13,7 +13,8 @@
 
 /**
  * @typedef {import('../types/DesignToken.d.ts').Dictionary} Dictionary
- * @typedef {import('../types/Config.d.ts').PlatformConfig} Config
+ * @typedef {import('../types/Config.d.ts').PlatformConfig} PlatformConfig
+ * @typedef {import('../types/Config.d.ts').Config} Config
  */
 
 /**
@@ -24,15 +25,17 @@
  * @private
  * @memberof module:style-dictionary
  * @param {Dictionary} dictionary
- * @param {Config} platform
+ * @param {PlatformConfig} platform
+ * @param {Config} options
  */
-export default function cleanActions(dictionary, platform) {
+export default async function cleanActions(dictionary, platform, options) {
   if (platform.actions) {
-    platform.actions.forEach(function (action) {
-      // ensure we've augmented action with the do/undo functions and that undo exists
-      if (typeof action !== 'string' && typeof action.undo === 'function') {
-        action.undo(dictionary, platform);
-      }
-    });
+    return Promise.all(
+      platform.actions.map((action) => {
+        if (typeof action !== 'string' && typeof action.undo === 'function') {
+          return action.undo(dictionary, platform, options);
+        }
+      }),
+    );
   }
 }

package/lib/cleanDir.d.ts

@@ -9,6 +9,6 @@
  * @param {File} file
  * @param {Config} [platform]
  */
-export default function cleanDir(file: File, platform?: import("../types/Config.d.ts").PlatformConfig | undefined): void;
+export default function cleanDir(file: File, platform?: import("../types/Config.d.ts").PlatformConfig | undefined): Promise<void>;
 export type Config = import('../types/Config.d.ts').PlatformConfig;
 export type File = import('../types/File.d.ts').File;

package/lib/cleanDir.js

@@ -27,7 +27,7 @@ import { fs } from 'style-dictionary/fs';
  * @param {File} file
  * @param {Config} [platform]
  */
-export default function cleanDir(file, platform = {}) {
+export default async function cleanDir(file, platform = {}) {
   let { destination } = file;
 
   if (typeof destination !== 'string') throw new Error('Please enter a valid destination');
@@ -41,10 +41,11 @@ export default function cleanDir(file, platform = {}) {
 
   while (dir) {
     if (fs.existsSync(dir)) {
-      if (fs.readdirSync(dir, 'buffer').length === 0) {
+      const dirContents = fs.readdirSync(dir, 'buffer');
+      if (dirContents.length === 0) {
         // eslint-disable-next-line no-console
         console.log(chalk.bold.red('-') + ' ' + dir);
-        fs.rmdirSync(dir);
+        fs.rmSync(dir, { recursive: true });
       } else {
         break;
       }

package/lib/cleanDirs.d.ts

@@ -9,5 +9,5 @@
  * @memberOf StyleDictionary
  * @param {Config} platform
  */
-export default function cleanDirs(platform: Config): void;
+export default function cleanDirs(platform: Config): Promise<void[] | undefined>;
 export type Config = import('../types/Config.d.ts').PlatformConfig;

package/lib/cleanDirs.js

@@ -25,17 +25,20 @@ import cleanDir from './cleanDir.js';
  * @memberOf StyleDictionary
  * @param {Config} platform
  */
-export default function cleanDirs(platform) {
+export default async function cleanDirs(platform) {
   if (platform.buildPath && platform.buildPath.slice(-1) !== '/') {
     throw new Error('Build path must end in a trailing slash or you will get weird file names.');
   }
 
-  // while neither the format or dictionary are used by clean file I'm passing them in for symmetry to buildFile
-  platform.files?.forEach((file) => {
-    if (file.format) {
-      cleanDir(file, platform);
-    } else {
-      throw new Error('Please supply a format');
-    }
-  });
+  if (platform.files) {
+    return Promise.all(
+      platform.files?.map((file) => {
+        if (file.format) {
+          return cleanDir(file, platform);
+        } else {
+          throw new Error('Please supply a format');
+        }
+      }),
+    );
+  }
 }