style-dictionary 4.2.0 → 4.3.1

package/lib/common/formats.js

@@ -11,9 +11,9 @@
  * and limitations under the License.
  */
 import * as prettier from 'prettier/standalone';
-import prettierPluginBabel from 'prettier/plugins/babel';
-import prettierPluginEstree from 'prettier/plugins/estree';
-import prettierPluginTypescript from 'prettier/plugins/typescript';
+import * as prettierPluginBabel from 'prettier/plugins/babel';
+import * as prettierPluginEstree from 'prettier/plugins/estree';
+import * as prettierPluginTypescript from 'prettier/plugins/typescript';
 
 import {
   fileHeader,
@@ -30,28 +30,34 @@ import {
 
 import { stripMeta as stripMetaUtil } from '../utils/stripMeta.js';
 
-import androidColors from './templates/android/colors.template.js';
-import androidDimens from './templates/android/dimens.template.js';
-import androidFontDimens from './templates/android/fontDimens.template.js';
-import androidIntegers from './templates/android/integers.template.js';
-import androidResources from './templates/android/resources.template.js';
-import androidStrings from './templates/android/strings.template.js';
-import composeObject from './templates/compose/object.kt.template.js';
-import cssFonts from './templates/css/fonts.css.template.js';
-import flutterClassDart from './templates/flutter/class.dart.template.js';
-import iosColorsH from './templates/ios/colors.h.template.js';
-import iosColorsM from './templates/ios/colors.m.template.js';
-import iosSingletonH from './templates/ios/singleton.h.template.js';
-import iosSingletonM from './templates/ios/singleton.m.template.js';
-import iosStaticH from './templates/ios/static.h.template.js';
-import iosStaticM from './templates/ios/static.m.template.js';
-import iosStringsH from './templates/ios/strings.h.template.js';
-import iosStringsM from './templates/ios/strings.m.template.js';
-import iosSwiftAny from './templates/ios-swift/any.swift.template.js';
-import scssMapDeep from './templates/scss/map-deep.template.js';
-import scssMapFlat from './templates/scss/map-flat.template.js';
+import androidColorsTemplate from './templates/android/colors.template.js';
+import androidDimensTemplate from './templates/android/dimens.template.js';
+import androidFontDimensTemplate from './templates/android/fontDimens.template.js';
+import androidIntegersTemplate from './templates/android/integers.template.js';
+import androidResourcesTemplate from './templates/android/resources.template.js';
+import androidStringsTemplate from './templates/android/strings.template.js';
+import composeObjectTemplate from './templates/compose/object.kt.template.js';
+import cssFontsTemplate from './templates/css/fonts.css.template.js';
+import flutterClassDartTemplate from './templates/flutter/class.dart.template.js';
+import iosColorsHTemplate from './templates/ios/colors.h.template.js';
+import iosColorsMTemplate from './templates/ios/colors.m.template.js';
+import iosSingletonHTemplate from './templates/ios/singleton.h.template.js';
+import iosSingletonMTemplate from './templates/ios/singleton.m.template.js';
+import iosStaticHTemplate from './templates/ios/static.h.template.js';
+import iosStaticMTemplate from './templates/ios/static.m.template.js';
+import iosStringsHTemplate from './templates/ios/strings.h.template.js';
+import iosStringsMTemplate from './templates/ios/strings.m.template.js';
+import iosSwiftAnyTemplate from './templates/ios-swift/any.swift.template.js';
+import scssMapDeepTemplate from './templates/scss/map-deep.template.js';
+import scssMapFlatTemplate from './templates/scss/map-flat.template.js';
 import macrosTemplate from './templates/ios/macros.template.js';
 import plistTemplate from './templates/ios/plist.template.js';
+import {
+  commentStyles,
+  fileHeaderCommentStyles,
+  formats as fileFormats,
+  propertyFormatNames,
+} from '../enums/index.js';
 
 /**
  * @typedef {import('../../types/Format.d.ts').Format} Format
@@ -65,6 +71,56 @@ import plistTemplate from './templates/ios/plist.template.js';
  * @typedef {import('../utils/stripMeta.js').StripMetaOptions} StripMetaOptions
  */
 
+const { none } = commentStyles;
+const { long, short, xml } = fileHeaderCommentStyles;
+const { css, sass, less, stylus } = propertyFormatNames;
+const {
+  cssVariables,
+  cssFonts,
+  scssMapFlat,
+  scssMapDeep,
+  scssVariables,
+  scssIcons,
+  lessVariables,
+  lessIcons,
+  stylusVariables,
+  javascriptEs6,
+  javascriptEsm,
+  javascriptModule,
+  javascriptModuleFlat,
+  javascriptObject,
+  javascriptUmd,
+  typescriptEs6Declarations,
+  typescriptModuleDeclarations,
+  androidResources,
+  androidColors,
+  androidDimens,
+  androidFontDimens,
+  androidIntegers,
+  androidStrings,
+  composeObject,
+  iosMacros,
+  iosPlist,
+  iosSingletonM,
+  iosSingletonH,
+  iosStaticH,
+  iosStaticM,
+  iosColorsH,
+  iosColorsM,
+  iosStringsH,
+  iosStringsM,
+  iosSwiftClassSwift,
+  iosSwiftEnumSwift,
+  iosSwiftAnySwift,
+  json,
+  jsonAsset,
+  jsonNested,
+  jsonFlat,
+  sketchPalette,
+  sketchPaletteV2,
+  flutterClassDart,
+} = fileFormats;
+
 /**
  * @namespace Formats
  */
@@ -136,7 +192,7 @@ const formats = {
    * }
    * ```
    */
-  'css/variables': async function ({ dictionary, options = {}, file }) {
+  [cssVariables]: async function ({ dictionary, options = {}, file }) {
     const selector = options.selector ? options.selector : `:root`;
     const { outputReferences, outputReferenceFallbacks, usesDtcg, formatting } = options;
     const header = await fileHeader({
@@ -148,7 +204,7 @@ const formats = {
       header +
       `${selector} {\n` +
       formattedVariables({
-        format: 'css',
+        format: css,
         dictionary,
         outputReferences,
         outputReferenceFallbacks,
@@ -174,16 +230,16 @@ const formats = {
    * )
    * ```
    */
-  'scss/map-flat': async function ({ dictionary, options, file }) {
+  [scssMapFlat]: async function ({ dictionary, options, file }) {
     const { allTokens } = dictionary;
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'long',
+      commentStyle: long,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return scssMapFlat({ allTokens, options, header });
+    return scssMapFlatTemplate({ allTokens, options, header });
   },
 
   /**
@@ -208,12 +264,12 @@ const formats = {
    * )
    * ```
    */
-  'scss/map-deep': async function ({ dictionary, options, file }) {
+  [scssMapDeep]: async function ({ dictionary, options, file }) {
     // Default the "themeable" option to true for backward compatibility.
     const { outputReferences, themeable = true, formatting, usesDtcg } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'long',
+      commentStyle: long,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
@@ -221,7 +277,7 @@ const formats = {
       '\n' +
       header +
       formattedVariables({
-        format: 'sass',
+        format: sass,
         dictionary,
         outputReferences,
         themeable,
@@ -229,7 +285,7 @@ const formats = {
         usesDtcg,
       }) +
       '\n' +
-      scssMapDeep({ dictionary, options })
+      scssMapDeepTemplate({ dictionary, options })
     );
   },
 
@@ -246,18 +302,18 @@ const formats = {
    * $color-background-alt: #eeeeee !default;
    * ```
    */
-  'scss/variables': async function ({ dictionary, options, file }) {
+  [scssVariables]: async function ({ dictionary, options, file }) {
     const { outputReferences, themeable = false, formatting, usesDtcg } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
     return (
       header +
       formattedVariables({
-        format: 'sass',
+        format: sass,
         dictionary,
         outputReferences,
         themeable,
@@ -279,11 +335,11 @@ const formats = {
    * .icon.email:before { content:$content-icon-email; }
    * ```
    */
-  'scss/icons': async function ({ dictionary, options, file, platform }) {
+  [scssIcons]: async function ({ dictionary, options, file, platform }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
@@ -301,17 +357,23 @@ const formats = {
    * \@color-background-alt: #eeeeee;
    * ```
    */
-  'less/variables': async function ({ dictionary, options, file }) {
+  [lessVariables]: async function ({ dictionary, options, file }) {
     const { outputReferences, formatting, usesDtcg } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
     return (
       header +
-      formattedVariables({ format: 'less', dictionary, outputReferences, formatting, usesDtcg }) +
+      formattedVariables({
+        format: less,
+        dictionary,
+        outputReferences,
+        formatting,
+        usesDtcg,
+      }) +
       '\n'
     );
   },
@@ -327,11 +389,11 @@ const formats = {
    * .icon.email:before { content:\@content-icon-email; }
    * ```
    */
-  'less/icons': async function ({ dictionary, options, file, platform }) {
+  [lessIcons]: async function ({ dictionary, options, file, platform }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
@@ -349,18 +411,24 @@ const formats = {
    * $color-background-alt= #eeeeee;
    * ```
    */
-  'stylus/variables': async function ({ dictionary, options, file, platform }) {
+  [stylusVariables]: async function ({ dictionary, options, file, platform }) {
     const { formatting, usesDtcg } = options;
     const outputReferences = !!platform.options?.outputReferences;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
     return (
       header +
-      formattedVariables({ format: 'stylus', dictionary, outputReferences, formatting, usesDtcg }) +
+      formattedVariables({
+        format: stylus,
+        dictionary,
+        outputReferences,
+        formatting,
+        usesDtcg,
+      }) +
       '\n'
     );
   },
@@ -383,7 +451,7 @@ const formats = {
    * }
    * ```
    */
-  'javascript/module': async function ({ dictionary, file, options }) {
+  [javascriptModule]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
@@ -407,7 +475,7 @@ const formats = {
    *}
    *```
    */
-  'javascript/module-flat': async function ({ dictionary, file, options }) {
+  [javascriptModuleFlat]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
@@ -449,7 +517,7 @@ const formats = {
    * }
    * ```
    */
-  'javascript/object': async function ({ dictionary, file, options }) {
+  [javascriptObject]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
@@ -496,7 +564,7 @@ const formats = {
    * }))
    * ```
    */
-  'javascript/umd': async function ({ dictionary, file, options }) {
+  [javascriptUmd]: async function ({ dictionary, file, options }) {
     const name = file.options?.name || '_styleDictionary';
     const { formatting } = options;
     const header = await fileHeader({
@@ -558,28 +626,25 @@ const formats = {
    * export const ColorBackgroundAlt = '#fcfcfcfc';
    * ```
    */
-  'javascript/es6': async function ({ dictionary, file, options }) {
+  [javascriptEs6]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    const content =
-      header +
-      dictionary.allTokens
-        .map(function (token) {
-          let to_ret =
-            'export const ' +
-            token.name +
-            ' = ' +
-            JSON.stringify(options.usesDtcg ? token.$value : token.value) +
-            ';';
-          if (token.comment) to_ret = to_ret.concat(' // ' + token.comment);
-          return to_ret;
-        })
-        .join('\n') +
-      '\n';
+    const content = [
+      header,
+      dictionary.allTokens.map((token) => {
+        const value = JSON.stringify(options.usesDtcg ? token.$value : token.value);
+        const comment = options.usesDtcg ? token.$description : token.comment;
+        const to_ret = `export const ${token.name} = ${value};`;
+
+        return comment ? to_ret.concat(`// ${comment}`) : to_ret;
+      }),
+    ]
+      .flat()
+      .join('\n');
     return formatJS(content);
   },
 
@@ -599,7 +664,7 @@ const formats = {
    * }
    * ```
    */
-  'javascript/esm': async function ({ dictionary, file, options }) {
+  [javascriptEsm]: async function ({ dictionary, file, options }) {
     const { formatting, minify = false } = options;
     let { tokens } = dictionary;
     tokens = stripMetaProps(
@@ -655,29 +720,30 @@ const formats = {
    * export const ColorBackgroundAlt : string;
    * ```
    */
-  'typescript/es6-declarations': async function ({ dictionary, file, options }) {
+  [typescriptEs6Declarations]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    const content =
-      header +
-      dictionary.allTokens
-        .map(function (token) {
-          let to_ret_token = '';
-          if (token.comment) to_ret_token += '/** ' + token.comment + ' */\n';
-          to_ret_token +=
-            'export const ' +
-            token.name +
-            ' : ' +
-            getTypeScriptType(options.usesDtcg ? token.$value : token.value, options) +
-            ';';
-          return to_ret_token;
-        })
-        .join('\n') +
-      '\n';
+    const content = [
+      header,
+      dictionary.allTokens.map((token) => {
+        const typescriptType = getTypeScriptType(
+          options.usesDtcg ? token.$value : token.value,
+          options,
+        );
+        const comment = options.usesDtcg ? token.$description : token.comment;
+
+        return [
+          `${comment ? `/** ${comment} */` : ''}`,
+          `export const ${token.name} : ${typescriptType};`,
+        ].join('\n');
+      }),
+    ]
+      .flat()
+      .join('');
     return formatJS(content, true);
   },
 
@@ -734,7 +800,7 @@ const formats = {
    * });
    * ```
    */
-  'typescript/module-declarations': async function ({ dictionary, file, options }) {
+  [typescriptModuleDeclarations]: async function ({ dictionary, file, options }) {
     const { moduleName = `tokens` } = options;
     /**
      * @param {Tokens} obj
@@ -812,15 +878,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *  <dimen name="size_font_base">14sp</color>
    * ```
    */
-  'android/resources': async function ({ dictionary, file, options }) {
+  [androidResources]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidResources({ dictionary, file, header, options });
+    return androidResourcesTemplate({ dictionary, file, header, options });
   },
 
   /**
@@ -830,7 +896,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * instead of this format:
    *
    * ```javascript
-   * format: 'android/resources',
+   * format: formats.androidResources,
    * filter: {
    *   attributes: { category: 'color' }
    * }
@@ -847,15 +913,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *  <color name="color_base_red_60">#ffe19d9c</color>
    * ```
    */
-  'android/colors': async function ({ dictionary, options, file }) {
+  [androidColors]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidColors({ dictionary, options, header });
+    return androidColorsTemplate({ dictionary, options, header });
   },
 
   /**
@@ -865,7 +931,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * instead of this format:
    *
    * ```javascript
-   * format: 'android/resources',
+   * format: formats.androidResources,
    * filter: {
    *   attributes: { category: 'size' }
    * }
@@ -882,15 +948,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *  <dimen name="size_padding_medium">15.00dp</dimen>
    * ```
    */
-  'android/dimens': async function ({ dictionary, options, file }) {
+  [androidDimens]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidDimens({ dictionary, options, header });
+    return androidDimensTemplate({ dictionary, options, header });
   },
 
   /**
@@ -900,7 +966,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * instead of this format:
    *
    * ```javascript
-   * format: 'android/resources',
+   * format: formats.androidResources,
    * filter: {
    *   attributes: { category: 'size' }
    * }
@@ -917,15 +983,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *  <dimen name="size_font_medium">15.00sp</dimen>
    * ```
    */
-  'android/fontDimens': async function ({ dictionary, options, file }) {
+  [androidFontDimens]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidFontDimens({ dictionary, options, header });
+    return androidFontDimensTemplate({ dictionary, options, header });
   },
 
   /**
@@ -936,7 +1002,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * instead of this format:
    *
    * ```javascript
-   * format: 'android/resources',
+   * format: formats.androidResources,
    * filter: {
    *   attributes: { category: 'time' }
    * }
@@ -954,15 +1020,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *   <integer name="time_duration_long">4000</integer>
    * ```
    */
-  'android/integers': async function ({ dictionary, options, file }) {
+  [androidIntegers]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidIntegers({ dictionary, options, header });
+    return androidIntegersTemplate({ dictionary, options, header });
   },
 
   /**
@@ -973,7 +1039,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * instead of this format:
    *
    * ```javascript
-   * format: 'android/resources',
+   * format: formats.androidResources,
    * filter: {
    *   attributes: { category: 'content' }
    * }
@@ -990,15 +1056,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *   <string name="content_icon_chevron_up">&#xE003;</string>
    * ```
    */
-  'android/strings': async function ({ dictionary, options, file }) {
+  [androidStrings]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return androidStrings({ dictionary, options, header });
+    return androidStringsTemplate({ dictionary, options, header });
   },
 
   // Compose templates
@@ -1025,7 +1091,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'compose/object': async function ({ dictionary, options, file }) {
+  [composeObject]: async function ({ dictionary, options, file }) {
     const { allTokens, tokens, unfilteredTokens } = dictionary;
     const { outputReferences, formatting, usesDtcg } = options;
     const formatProperty = createPropertyFormatter({
@@ -1033,7 +1099,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
       dictionary,
       formatting: {
         suffix: '',
-        commentStyle: 'none', // We will add the comment in the format template
+        commentStyle: /** @type {'short' | 'long' | 'none'} */ (none), // We will add the comment in the format template
         ...formatting,
       },
       usesDtcg,
@@ -1049,11 +1115,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
     options = setComposeObjectProperties(options);
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return composeObject({ allTokens: sortedTokens, options, formatProperty, header });
+    return composeObjectTemplate({ allTokens: sortedTokens, options, formatProperty, header });
   },
 
   // iOS templates
@@ -1072,11 +1138,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * #define SizeFontTiny 176.00f
    * ```
    */
-  'ios/macros': async function ({ dictionary, options, file }) {
+  [iosMacros]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
@@ -1090,11 +1156,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Fix this template and add example and usage
    */
-  'ios/plist': async function ({ dictionary, options, file }) {
+  [iosPlist]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'xml',
+      commentStyle: xml,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
@@ -1108,15 +1174,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/singleton.m': async function ({ dictionary, options, file }) {
+  [iosSingletonM]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosSingletonM({ dictionary, options, file, header });
+    return iosSingletonMTemplate({ dictionary, options, file, header });
   },
 
   /**
@@ -1126,15 +1192,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/singleton.h': async function ({ file, options }) {
+  [iosSingletonH]: async function ({ file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosSingletonH({ file, options, header });
+    return iosSingletonHTemplate({ file, options, header });
   },
 
   /**
@@ -1144,15 +1210,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/static.h': async function ({ dictionary, file, options }) {
+  [iosStaticH]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosStaticH({ dictionary, file, options, header });
+    return iosStaticHTemplate({ dictionary, file, options, header });
   },
 
   /**
@@ -1162,15 +1228,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/static.m': async function ({ dictionary, options, file }) {
+  [iosStaticM]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosStaticM({ dictionary, options, file, header });
+    return iosStaticMTemplate({ dictionary, options, file, header });
   },
 
   /**
@@ -1180,15 +1246,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind memberx
    * @todo Add example and usage
    */
-  'ios/colors.h': async function ({ dictionary, options, file }) {
+  [iosColorsH]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosColorsH({ dictionary, file, options, header });
+    return iosColorsHTemplate({ dictionary, file, options, header });
   },
 
   /**
@@ -1198,15 +1264,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/colors.m': async function ({ dictionary, options, file }) {
+  [iosColorsM]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosColorsM({ dictionary, options, file, header });
+    return iosColorsMTemplate({ dictionary, options, file, header });
   },
 
   /**
@@ -1216,15 +1282,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/strings.h': async function ({ dictionary, file, options }) {
+  [iosStringsH]: async function ({ dictionary, file, options }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosStringsH({ dictionary, file, options, header });
+    return iosStringsHTemplate({ dictionary, file, options, header });
   },
 
   /**
@@ -1234,15 +1300,15 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'ios/strings.m': async function ({ dictionary, options, file }) {
+  [iosStringsM]: async function ({ dictionary, options, file }) {
     const { formatting } = options;
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosStringsM({ dictionary, options, file, header });
+    return iosStringsMTemplate({ dictionary, options, file, header });
   },
 
   /**
@@ -1264,7 +1330,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'ios-swift/class.swift': async function ({ dictionary, options, file, platform }) {
+  [iosSwiftClassSwift]: async function ({ dictionary, options, file, platform }) {
     const { allTokens, tokens, unfilteredTokens } = dictionary;
     const { outputReferences, formatting, usesDtcg } = options;
     options = setSwiftFileProperties(options, 'class', platform.transformGroup);
@@ -1286,11 +1352,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
     }
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosSwiftAny({ allTokens: sortedTokens, file, options, formatProperty, header });
+    return iosSwiftAnyTemplate({ allTokens: sortedTokens, file, options, formatProperty, header });
   },
 
   /**
@@ -1312,7 +1378,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'ios-swift/enum.swift': async function ({ dictionary, options, file, platform }) {
+  [iosSwiftEnumSwift]: async function ({ dictionary, options, file, platform }) {
     const { allTokens, tokens, unfilteredTokens } = dictionary;
     const { outputReferences, formatting, usesDtcg } = options;
     options = setSwiftFileProperties(options, 'enum', platform.transformGroup);
@@ -1334,11 +1400,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
     }
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosSwiftAny({ allTokens: sortedTokens, file, options, formatProperty, header });
+    return iosSwiftAnyTemplate({ allTokens: sortedTokens, file, options, formatProperty, header });
   },
 
   /**
@@ -1371,7 +1437,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'ios-swift/any.swift': async function ({ dictionary, options, file, platform }) {
+  [iosSwiftAnySwift]: async function ({ dictionary, options, file, platform }) {
     const { allTokens, tokens, unfilteredTokens } = dictionary;
     const { outputReferences, formatting, usesDtcg } = options;
     options = setSwiftFileProperties(options, options.objectType, platform.transformGroup);
@@ -1393,11 +1459,11 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
     }
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return iosSwiftAny({ allTokens: sortedTokens, file, options, formatProperty, header });
+    return iosSwiftAnyTemplate({ allTokens: sortedTokens, file, options, formatProperty, header });
   },
 
   // Css templates
@@ -1409,7 +1475,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @kind member
    * @todo Add example and usage
    */
-  'css/fonts.css': ({ dictionary }) => cssFonts(dictionary.tokens),
+  [cssFonts]: ({ dictionary }) => cssFontsTemplate(dictionary.tokens),
 
   // Web templates
 
@@ -1431,7 +1497,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  json: function ({ dictionary, options }) {
+  [json]: function ({ dictionary, options }) {
     let { tokens } = dictionary;
     tokens = stripMetaProps(
       tokens,
@@ -1458,7 +1524,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'json/asset': function ({ dictionary }) {
+  [jsonAsset]: function ({ dictionary }) {
     return JSON.stringify({ asset: dictionary.tokens.asset }, null, 2);
   },
 
@@ -1477,7 +1543,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'json/nested': function ({ dictionary, options }) {
+  [jsonNested]: function ({ dictionary, options }) {
     return JSON.stringify(minifyDictionary(dictionary.tokens, options.usesDtcg), null, 2) + '\n';
   },
 
@@ -1493,7 +1559,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'json/flat': function ({ dictionary, options }) {
+  [jsonFlat]: function ({ dictionary, options }) {
     return (
       '{\n' +
       dictionary.allTokens
@@ -1526,7 +1592,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'sketch/palette': function ({ dictionary, options }) {
+  [sketchPalette]: function ({ dictionary, options }) {
     const to_ret = {
       compatibleVersion: '1.0',
       pluginVersion: '1.1',
@@ -1563,7 +1629,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * }
    * ```
    */
-  'sketch/palette/v2': function ({ dictionary, options }) {
+  [sketchPaletteV2]: function ({ dictionary, options }) {
     const to_ret = {
       compatibleVersion: '2.0',
       pluginVersion: '2.2',
@@ -1589,6 +1655,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    * @typedef {Object} flutterClassOpts
    * @property {boolean} [flutterClassOpts.showFileHeader=true] - Whether or not to include a comment that has the build date
    * @property {OutputReferences} [flutterClassOpts.outputReferences=false] - Whether or not to keep [references](/#/formats?id=references-in-output-files) (a -> b -> c) in the output.
+   * @property {String} [flutterClassOpts.className] - The name of the generated Dart Class
    * @param {FormatArgs & { options?: flutterClassOpts }} options
    * @example
    * ```dart
@@ -1602,7 +1669,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
    *     static const contentFontFamily1 = "NewJune";
    * ```
    */
-  'flutter/class.dart': async function ({ dictionary, options, file }) {
+  [flutterClassDart]: async function ({ dictionary, options, file }) {
     const { allTokens, tokens, unfilteredTokens } = dictionary;
     const { outputReferences, formatting, usesDtcg } = options;
     const formatProperty = createPropertyFormatter({
@@ -1620,18 +1687,24 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
     }
     const header = await fileHeader({
       file,
-      commentStyle: 'short',
+      commentStyle: short,
       formatting: getFormattingCloneWithoutPrefix(formatting),
       options,
     });
-    return flutterClassDart({ allTokens: sortedTokens, file, options, formatProperty, header });
+    return flutterClassDartTemplate({
+      allTokens: sortedTokens,
+      file,
+      options,
+      formatProperty,
+      header,
+    });
   },
 };
 
 // Mark which formats are nested
-formats['json/nested'].nested = true;
-formats['javascript/module'].nested = true;
-formats['javascript/object'].nested = true;
-formats['javascript/esm'].nested = true;
+formats[jsonNested].nested = true;
+formats[javascriptModule].nested = true;
+formats[javascriptObject].nested = true;
+formats[javascriptEsm].nested = true;
 
 export default formats;