feat: Add helpers and parser

packages/tokens/scripts/scripts/build-tokens/src/build/outputs/swift/helpers.ts

@@ -0,0 +1,31 @@
+import { AUTO_GENERATED_FILE_HEADER } from '../../constants/auto-generated-file-header.ts';
+
+export const VARIABLE_PREFIX = 'esds';
+
+export const T1_DIRECTORY_NAME = 't1-primitive';
+export const T2_DIRECTORY_NAME = 't2-semantic';
+export const T3_DIRECTORY_NAME = 't3-component';
+
+export const DESIGN_TOKEN_TIERS = [T1_DIRECTORY_NAME, T2_DIRECTORY_NAME, T3_DIRECTORY_NAME];
+
+export const AUTOGENERATED_SWIFT_HEADER = ['//', `// ${AUTO_GENERATED_FILE_HEADER}`, '//'];
+
+export function segmentKebabCase(segment: string): string {
+  return (
+    segment
+      // replace white-spaces with single dash
+      .replace(/\s+/g, '-')
+      // convert camelCase/PascalCase to dash-case
+      .replace(
+        /[A-Z]/g,
+        (letter: string, offset: number): string =>
+          `${offset > 0 ? '-' : ''}${letter.toLowerCase()}`,
+      )
+      // remove starting and ending dashes
+      .replace(/^-+|-+$/g, '')
+      // remove consecutive dashes
+      .replace(/--+/g, '-')
+      // remove all non-alphanumeric or dash characters
+      .replace(/[^a-z0-9-]/g, '')
+  );
+}

packages/tokens/scripts/scripts/build-tokens/src/build/outputs/swift/parser.ts

@@ -0,0 +1,23 @@
+/**
+ * Custom parser that moves root-level $type into each top-level group.
+ * This prevents SD5's merge from losing per-file $type when multiple
+ * source files define different $type at their root level.
+ */
+export const fixTypeInheritanceParser = {
+  name: 'esds/fix-type-inheritance',
+  pattern: /\.tokens\.json$/,
+  parser: ({ contents }: { filePath: string; contents: string }) => {
+    const data = JSON.parse(contents);
+    const rootType = data['$type'];
+    if (rootType) {
+      delete data['$type'];
+      for (const [key, val] of Object.entries(data)) {
+        if (key.startsWith('$')) continue;
+        if (val && typeof val === 'object' && !(val as any)['$type']) {
+          (val as any)['$type'] = rootType;
+        }
+      }
+    }
+    return data;
+  },
+};

packages/tokens/scripts/scripts/build-tokens/src/build/outputs/swift/transforms.ts

@@ -0,0 +1,16 @@
+import type { Transform, TransformedToken } from 'style-dictionary/types';
+import { segmentKebabCase } from './helpers.ts';
+
+/**
+ * Name transform that replicates the exact naming logic from the custom DTCG framework.
+ */
+export const nameTransform: Transform = {
+  name: 'esds/name',
+  type: 'name',
+  transform: (token: TransformedToken): string => {
+    return token.path
+      .map(segmentKebabCase)
+      .filter((s: string) => s !== '' && s !== '-')
+      .join('-');
+  },
+};