synthesisui 0.16.316 → 0.16.317

package/dist/commands/add.js

@@ -581,7 +581,7 @@ export async function add(slug, opts) {
     const families = payload.document.foundations.typography.families;
     const fontsHref = googleFontsHref(families);
     const nextFonts = projectConfig.target === "next"
-        ? nextFontSnippet(families, payload.slug, appDir)
+        ? nextFontSnippet(families, payload.slug, appDir, payload.fontSeam)
         : null;
     if (nextFonts) {
         /**
@@ -603,7 +603,7 @@ export async function add(slug, opts) {
                 continue;
             if (!(await exists(join(projectRoot, ...dir.split("/")))))
                 continue;
-            const snippet = nextFontSnippet(families, payload.slug, dir);
+            const snippet = nextFontSnippet(families, payload.slug, dir, payload.fontSeam);
             if (!snippet)
                 continue;
             const header = [

package/dist/commands/doctor.js

@@ -16,6 +16,7 @@ import { diagnose, nameToWrite, scanSource, siblingTokens, } from "../doctor/sca
 import { findSelfConflicts, forbiddenProps, isReset, propMatchesLabel, } from "../doctor/self-conflict.js";
 import { withTheirNames } from "../doctor/their-names.js";
 import { buildTable, EMPTY_TABLE, nearestToken, } from "../doctor/tokens.js";
+import { FAMILY_SEAM_PREFIX } from "../fonts.js";
 import { groupRole } from "../group-role.js";
 import { actingSlug, describeScope, measuredScope, scopePaths, } from "../measured-scope.js";
 import { body, paint, section, snippet } from "../output.js";
@@ -554,7 +555,8 @@ async function readWiring(root, slug) {
         // default face (my-test2, 27/07). What the checker checks is what gets done.
         if (src.includes("--font-ds-") && /next\/font/.test(src))
             w.fontsWritten = true;
-        if (/--ds-typography-families-\w+\s*:\s*var\(\s*--font-ds-/.test(src))
+        /** O prefixo vem da const única da costura - um literal aqui divergiria em silêncio (26/08). */
+        if (new RegExp(`${FAMILY_SEAM_PREFIX}\\w+\\s*:\\s*var\\(\\s*--font-ds-`).test(src))
             w.fontsMapped = true;
         // The bridge joins the early exit, otherwise the walk can stop before the
         // stylesheet that imports it and report a wired project as unbridged.

package/dist/fonts.js

@@ -81,7 +81,19 @@ export function googleFontsHref(families) {
  * `<link href="fonts.googleapis.com...">` stays as the framework-agnostic
  * fallback - it works everywhere but swaps visibly on cold loads.
  */
-export function nextFontSnippet(families, slug, appDir = "app") {
+/**
+ * O PREFIXO DO FALLBACK, exportado para o twin: quando o payload não traz a costura (`fontSeam`),
+ * o bloco é composto com este prefixo - e o twin-drift assere que ele é o MESMO que a plataforma
+ * batiza em `fontSeamOf`. Payload novo dispensa a convenção: o dado vence.
+ */
+export const FAMILY_SEAM_PREFIX = "--ds-typography-families-";
+export function nextFontSnippet(families, slug, appDir = "app", 
+/**
+ * A COSTURA SERVIDA PELO PAYLOAD (papel → nome do token no tokens.css) - ver `fontSeam` em
+ * `types.ts`. Presente, o bloco de mapa fala os nomes que o ARTEFATO declara, por construção;
+ * ausente (payload antigo), a composição por convenção continua valendo.
+ */
+seam) {
     /** Toda vaga que o documento tem, não só as nossas três - ver `customFontFamilies`. */
     const roles = familySlots(families).filter((role) => {
         const name = firstFamily(families[role] ?? "");
@@ -128,7 +140,7 @@ export function nextFontSnippet(families, slug, appDir = "app") {
     const css = [
         `/* ${appDir}/globals.css - AFTER the tokens.css import */`,
         `[data-ds="${slug}"] {`,
-        ...roles.map((role) => `  --ds-typography-families-${role}: var(${roleVar(role)});`),
+        ...roles.map((role) => `  ${seam?.[role] ?? `${FAMILY_SEAM_PREFIX}${role}`}: var(${roleVar(role)});`),
         `}`,
     ];
     return { fontsFile, layout, css };

package/dist/guide.js

@@ -6,7 +6,7 @@
  * famílias que o código dele declara, as três deixaram de carregar a fonte ao mesmo tempo. Este
  * arquivo já importava `nextFontSnippet` do mesmo módulo; a cópia não tinha razão de existir.
  */
-import { customFontFamilies, familySlots, nextFontSnippet } from "./fonts.js";
+import { customFontFamilies, FAMILY_SEAM_PREFIX, familySlots, nextFontSnippet, } from "./fonts.js";
 import { animationShorthand, classifyKeyframe, describeKeyframe, isFullRotation, } from "./motion.js";
 const kebab = (v) => v.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
 /**
@@ -280,7 +280,8 @@ export function buildGuide(payload) {
             .map((n) => `family=${n.replace(/ /g, "+")}:wght@400;500;600;700`)
             .join("&")}&display=swap`
         : null;
-    const nextFonts = nextFontSnippet(foundations.typography.families, slug);
+    /** A costura vem do payload quando o servidor a fala - o dado vence a convenção (T18-par). */
+    const nextFonts = nextFontSnippet(foundations.typography.families, slug, undefined, payload.fontSeam);
     const fontsSection = fontsHref
         ? `
 ## Fonts
@@ -696,7 +697,7 @@ ${hasTailwind
 - Radius → \`var(--ds-radius-<key>)\`: ${list(Object.keys(foundations.radius))}.
 - Shadow → \`var(--ds-shadow-<key>)\`: ${list(Object.keys(foundations.shadow))}.
 - Typography: families ${familySlots(foundations.typography.families)
-        .map((slot) => `\`--ds-typography-families-${slot}\` (${foundations.typography.families[slot]})`)
+        .map((slot) => `\`${payload.fontSeam?.[slot] ?? `${FAMILY_SEAM_PREFIX}${slot}`}\` (${foundations.typography.families[slot]})`)
         .join(", ")};
   weights${hasTailwind ? " (utility: `font-<key>`)" : ""}: ${list(weights)};
   scale \`--ds-typography-scale-<key>-font-size\`${hasTailwind ? " (utility: `text-<key>`)" : ""}: ${list(Object.keys(foundations.typography.scale))}.

package/dist/their-vars.js

@@ -2,6 +2,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { theirNames } from "./doctor/their-names.js";
 import { buildTable, normalizeValue, } from "./doctor/tokens.js";
+import { FAMILY_SEAM_PREFIX } from "./fonts.js";
 /**
  * A FOLHA APONTA PARA O NOME QUE O CÓDIGO DELE JÁ DÁ AO VALOR.
  *
@@ -136,7 +137,8 @@ export function pointAtTheirNames(css, theirs, resolvable) {
 const FAMILY_KIND = {
     "--ds-color-": "color",
     "--ds-shadow-": "shadow",
-    "--ds-typography-families-": "font",
+    /** A const única da costura - um literal aqui seria o stray que a varredura de 26/08 caçou. */
+    [FAMILY_SEAM_PREFIX]: "font",
     "--ds-motion-durations-": "motion",
     "--ds-motion-easings-": "motion",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.316",
+  "version": "0.16.317",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {