chore: re-add custom file header to include tokens docs

Author: adamstankiewicz

lib/build-tokens.js

@@ -61,16 +61,16 @@ async function buildTokensCommand(commandArgs) {
         prefix: 'pgn',
         // NOTE: buildPath must end with a slash
         buildPath: buildDir.slice(-1) === '/' ? buildDir : `${buildDir}/`,
+        options: {
+          fileHeader: 'customFileHeader',
+        },
         files: [
           {
             format: 'css/custom-variables',
             destination: 'core/variables.css',
             filter: hasSourceTokensOnly ? 'isSource' : undefined,
             options: {
               outputReferences,
-              formatting: {
-                fileHeaderTimestamp: true,
-              },
             },
           },
           {
@@ -79,9 +79,6 @@ async function buildTokensCommand(commandArgs) {
             filter: hasSourceTokensOnly ? 'isSource' : undefined,
             options: {
               outputReferences,
-              formatting: {
-                fileHeaderTimestamp: true,
-              },
             },
           },
         ],
@@ -124,9 +121,6 @@ async function buildTokensCommand(commandArgs) {
               : `isThemeVariant.${themeVariant}`,
             options: {
               outputReferences,
-              formatting: {
-                fileHeaderTimestamp: true,
-              },
             },
           },
           {
@@ -135,9 +129,6 @@ async function buildTokensCommand(commandArgs) {
             filter: hasSourceTokensOnly ? 'isSource' : undefined,
             options: {
               outputReferences,
-              formatting: {
-                fileHeaderTimestamp: true,
-              },
             },
           },
         ],

styles/css/core/custom-media-breakpoints.css

@@ -1,6 +1,6 @@
 /**
- * Do not edit directly, this file was auto-generated.
- * Generated on Tue, 03 Sep 2024 13:46:25 GMT
+ * Do not edit directly, this file was auto-generated. while transforming design tokens.
+ * See <root>/tokens/README.md for more details.
  */
 
 @custom-media --pgn-size-breakpoint-min-width-xs (min-width: 0);

styles/css/core/variables.css

@@ -1,6 +1,6 @@
 /**
- * Do not edit directly, this file was auto-generated.
- * Generated on Tue, 03 Sep 2024 13:46:25 GMT
+ * Do not edit directly, this file was auto-generated. while transforming design tokens.
+ * See <root>/tokens/README.md for more details.
  */
 
 :root {

styles/css/themes/light/utility-classes.css

@@ -1,6 +1,6 @@
 /**
- * Do not edit directly, this file was auto-generated.
- * Generated on Tue, 03 Sep 2024 13:46:26 GMT
+ * Do not edit directly, this file was auto-generated. while transforming design tokens.
+ * See <root>/tokens/README.md for more details.
  */
 
 .bg-accent-a {

styles/css/themes/light/variables.css

@@ -1,6 +1,6 @@
 /**
- * Do not edit directly, this file was auto-generated.
- * Generated on Tue, 03 Sep 2024 13:46:26 GMT
+ * Do not edit directly, this file was auto-generated. while transforming design tokens.
+ * See <root>/tokens/README.md for more details.
  */
 
 :root {

tokens/style-dictionary.js

@@ -346,6 +346,17 @@ const initializeStyleDictionary = async ({ themes }) => {
     parser: ({ contents }) => toml.load(contents),
   });
 
+  /**
+   * Registers a custom fileHeader.
+   */
+  StyleDictionary.registerFileHeader({
+    name: 'customFileHeader',
+    fileHeader: (defaultMessage) => [
+      `${defaultMessage} while transforming design tokens.`,
+      'See <root>/tokens/README.md for more details.',
+    ],
+  });
+
   return StyleDictionary;
 };