@hegemonart/get-design-done 1.33.6 → 1.34.1

package/scripts/lib/design-tokens/flutter.cjs

@@ -0,0 +1,128 @@
+/**
+ * design-tokens/flutter.cjs — Flutter (Dart) theme emitter + re-extractor
+ * (Phase 34.1 Plan 01).
+ *
+ * Consumes the canonical Phase-23 token map ({ tokens: Record<string,string> })
+ * and emits a deterministic Dart theme source string: a `GDDTheme` constants
+ * class plus a `themeData()` builder wiring `ColorScheme` + `TextTheme` into a
+ * `ThemeData` — per the PRECISION CONTRACT in reference/native-platforms.md.
+ *
+ * Precision contract:
+ *   COLOR      hex -> Color(0xAARRGGBB). 8-bit channels EXACT; #RGB expands;
+ *              alpha 0xFF when absent.
+ *   DIMENSION  Npx -> logical-px double (`16` -> `16.0`); NOT rounded.
+ *   TYPOGRAPHY strings -> Dart string literal, pass-through.
+ *   NON-MAPPABLE var()/calc()/gradient/rem/em -> verbatim comment, EXCLUDED.
+ *
+ * Each emitted token line carries a `// token: <original-key>` marker so the
+ * symmetric `reextractFlutter(source)` recovers the exact canonical key+value.
+ * Pure: no fs, no network, no Date, no process.env, no child_process (D-10).
+ */
+
+'use strict';
+
+const {
+  TOKEN_MARKER,
+  NONMAPPABLE_MARKER,
+  readTokens,
+  sortedEntries,
+  classify,
+  parseHexChannels,
+  channelsToArgbLiteral,
+  argbLiteralToChannels,
+  channelsToHex,
+  pxToDouble,
+  swiftIdent,
+} = require('./_native-shared.cjs');
+
+/**
+ * Emit a Flutter / Dart theme source string from a token set.
+ *
+ * @param {{tokens: Record<string,string>}|Record<string,string>} tokenSet
+ * @returns {string}
+ */
+function emitFlutter(tokenSet) {
+  const tokens = readTokens(tokenSet);
+  const entries = sortedEntries(tokens);
+  const lines = [];
+  lines.push('// Generated by get-design-done — Flutter theme tokens.');
+  lines.push('// See reference/native-platforms.md (token-bridge precision contract).');
+  lines.push("import 'package:flutter/material.dart';");
+  lines.push('');
+  lines.push('class GDDTheme {');
+
+  for (const [key, value] of entries) {
+    const kind = classify(key, value);
+    const ident = swiftIdent(key);
+    if (kind === 'color') {
+      const { r, g, b, a, hadAlpha } = parseHexChannels(value);
+      lines.push(
+        `  static const ${ident} = Color(${channelsToArgbLiteral({ r, g, b, a })}); ${TOKEN_MARKER}${key} hadAlpha=${hadAlpha ? 1 : 0}`,
+      );
+    } else if (kind === 'dimension') {
+      lines.push(
+        `  static const ${ident} = ${pxToDouble(value)}; ${TOKEN_MARKER}${key}`,
+      );
+    } else if (kind === 'typography') {
+      lines.push(
+        `  static const ${ident} = ${JSON.stringify(value)}; ${TOKEN_MARKER}${key}`,
+      );
+    } else {
+      lines.push(`  ${NONMAPPABLE_MARKER}${key} = ${value}`);
+    }
+  }
+
+  // ThemeData builder wiring ColorScheme + TextTheme (MaterialTheme analog).
+  lines.push('');
+  lines.push('  static ThemeData themeData() => ThemeData(');
+  lines.push('        colorScheme: ColorScheme.fromSeed(seedColor: GDDTheme.colorPrimary),');
+  lines.push('        textTheme: const TextTheme(),');
+  lines.push('      );');
+  lines.push('}');
+  lines.push('');
+  return lines.join('\n');
+}
+
+const FLUTTER_COLOR_RE = new RegExp(
+  String.raw`static const \w+ = Color\((0x[0-9a-fA-F]{8})\);\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)\s+hadAlpha=([01])`,
+);
+const FLUTTER_DIM_RE = new RegExp(
+  String.raw`static const \w+ = (\d+(?:\.\d+)?);\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)`,
+);
+const FLUTTER_STR_RE = new RegExp(
+  String.raw`static const \w+ = ("(?:[^"\\]|\\.)*");\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)`,
+);
+
+/**
+ * Recover the canonical token map from an emitted Flutter source string.
+ * Non-mappable lines + the ThemeData builder lines are NOT recovered.
+ *
+ * @param {string} source
+ * @returns {{tokens: Record<string,string>}}
+ */
+function reextractFlutter(source) {
+  /** @type {Record<string,string>} */
+  const tokens = {};
+  for (const line of String(source).split(/\r?\n/)) {
+    if (line.includes(NONMAPPABLE_MARKER)) continue;
+    let m;
+    if ((m = FLUTTER_COLOR_RE.exec(line))) {
+      const ch = argbLiteralToChannels(m[1]);
+      tokens[m[2]] = channelsToHex(ch.r, ch.g, ch.b, ch.a, m[3] === '1');
+    } else if ((m = FLUTTER_DIM_RE.exec(line))) {
+      // Recover canonical Npx: a logical-px double `16.0` -> `16px`.
+      tokens[m[2]] = `${parseFloat(m[1])}px`;
+    } else if ((m = FLUTTER_STR_RE.exec(line))) {
+      tokens[m[2]] = JSON.parse(m[1]);
+    }
+  }
+  return { tokens };
+}
+
+module.exports = { emitFlutter, reextractFlutter };

package/scripts/lib/design-tokens/index.cjs

@@ -17,6 +17,12 @@ const { readJsConst } = require('./js-const.cjs');
 const { readTailwind } = require('./tailwind.cjs');
 const { readFigma } = require('./figma.cjs');
 
+// Phase 34.1 — native theme emitters (token-bridge, D-02: extend the engine,
+// do not fork a native IR). See reference/native-platforms.md.
+const { emitSwift, reextractSwift } = require('./swift.cjs');
+const { emitCompose, reextractCompose } = require('./compose.cjs');
+const { emitFlutter, reextractFlutter } = require('./flutter.cjs');
+
 /**
  * @typedef {Object} TokenSet
  * @property {Object<string, string>} tokens
@@ -97,4 +103,11 @@ module.exports = {
   readJsConst,
   readTailwind,
   readFigma,
+  // Phase 34.1 native token-bridge emitters + symmetric re-extractors.
+  emitSwift,
+  emitCompose,
+  emitFlutter,
+  reextractSwift,
+  reextractCompose,
+  reextractFlutter,
 };

package/scripts/lib/design-tokens/swift.cjs

@@ -0,0 +1,122 @@
+/**
+ * design-tokens/swift.cjs — SwiftUI theme emitter + re-extractor
+ * (Phase 34.1 Plan 01).
+ *
+ * Consumes the canonical Phase-23 token map ({ tokens: Record<string,string> })
+ * and emits a deterministic SwiftUI theme source string: an `enum GDDTheme`
+ * exposing static `Color` / `CGFloat` (pt) / `String` constants per the
+ * PRECISION CONTRACT in reference/native-platforms.md.
+ *
+ * Precision contract (the round-trip's definition of "identity preserved"):
+ *   COLOR      hex #RGB/#RRGGBB/#RRGGBBAA -> Color(red:G/255 ...). 8-bit
+ *              channels EXACT (numerator-over-255 form avoids float drift);
+ *              #RGB expands to #RRGGBB; alpha opaque (255) when absent.
+ *   DIMENSION  Npx -> CGFloat integer points (round-half-up).
+ *   TYPOGRAPHY font-family / strings -> String literal, pass-through.
+ *   NON-MAPPABLE var()/calc()/gradient/rem/em -> verbatim trailing comment,
+ *              EXCLUDED from the round-trip identity set.
+ *
+ * Each emitted token line carries a `// token: <original-key>` marker so the
+ * symmetric `reextractSwift(source)` recovers the exact canonical key + value.
+ * Pure: no fs, no network, no Date, no process.env, no child_process (D-10).
+ */
+
+'use strict';
+
+const {
+  TOKEN_MARKER,
+  NONMAPPABLE_MARKER,
+  readTokens,
+  sortedEntries,
+  classify,
+  parseHexChannels,
+  channelsToHex,
+  pxToInt,
+  swiftIdent,
+} = require('./_native-shared.cjs');
+
+/**
+ * Emit a SwiftUI theme source string from a token set.
+ *
+ * @param {{tokens: Record<string,string>}|Record<string,string>} tokenSet
+ * @returns {string}
+ */
+function emitSwift(tokenSet) {
+  const tokens = readTokens(tokenSet);
+  const lines = [];
+  lines.push('// Generated by get-design-done — SwiftUI theme tokens.');
+  lines.push('// See reference/native-platforms.md (token-bridge precision contract).');
+  lines.push('import SwiftUI');
+  lines.push('');
+  lines.push('enum GDDTheme {');
+  for (const [key, value] of sortedEntries(tokens)) {
+    const ident = swiftIdent(key);
+    const kind = classify(key, value);
+    if (kind === 'color') {
+      const { r, g, b, a, hadAlpha } = parseHexChannels(value);
+      const alphaSlot = hadAlpha
+        ? `, opacity: ${a}.0/255.0`
+        : `, opacity: 255.0/255.0`;
+      lines.push(
+        `    static let ${ident} = Color(red: ${r}.0/255.0, green: ${g}.0/255.0, blue: ${b}.0/255.0${alphaSlot}) ${TOKEN_MARKER}${key} hadAlpha=${hadAlpha ? 1 : 0}`,
+      );
+    } else if (kind === 'dimension') {
+      lines.push(
+        `    static let ${ident}: CGFloat = ${pxToInt(value)} ${TOKEN_MARKER}${key}`,
+      );
+    } else if (kind === 'typography') {
+      lines.push(
+        `    static let ${ident} = ${JSON.stringify(value)} ${TOKEN_MARKER}${key}`,
+      );
+    } else {
+      // non-mappable — verbatim, excluded from identity set
+      lines.push(`    ${NONMAPPABLE_MARKER}${key} = ${value}`);
+    }
+  }
+  lines.push('}');
+  lines.push('');
+  return lines.join('\n');
+}
+
+const SWIFT_COLOR_RE = new RegExp(
+  String.raw`Color\(red:\s*(\d+)\.0/255\.0,\s*green:\s*(\d+)\.0/255\.0,\s*blue:\s*(\d+)\.0/255\.0,\s*opacity:\s*(\d+)\.0/255\.0\)\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)\s+hadAlpha=([01])`,
+);
+const SWIFT_DIM_RE = new RegExp(
+  String.raw`:\s*CGFloat\s*=\s*(\d+)\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)`,
+);
+const SWIFT_STR_RE = new RegExp(
+  String.raw`static let \w+ = ("(?:[^"\\]|\\.)*")\s*` +
+    TOKEN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    String.raw`(\S+)`,
+);
+
+/**
+ * Recover the canonical token map from an emitted SwiftUI source string.
+ * Non-mappable lines (NONMAPPABLE_MARKER) are intentionally NOT recovered.
+ *
+ * @param {string} source
+ * @returns {{tokens: Record<string,string>}}
+ */
+function reextractSwift(source) {
+  /** @type {Record<string,string>} */
+  const tokens = {};
+  for (const line of String(source).split(/\r?\n/)) {
+    if (line.includes(NONMAPPABLE_MARKER)) continue;
+    let m;
+    if ((m = SWIFT_COLOR_RE.exec(line))) {
+      const [, r, g, b, a, key, hadAlpha] = m;
+      tokens[key] = channelsToHex(+r, +g, +b, +a, hadAlpha === '1');
+    } else if ((m = SWIFT_DIM_RE.exec(line))) {
+      tokens[m[2]] = `${m[1]}px`;
+    } else if ((m = SWIFT_STR_RE.exec(line))) {
+      tokens[m[2]] = JSON.parse(m[1]);
+    }
+  }
+  return { tokens };
+}
+
+module.exports = { emitSwift, reextractSwift };