synthesisui 0.16.421 → 0.16.423

package/dist/component-codegen.js

@@ -470,8 +470,16 @@ const scaleKey = (v) => {
     const m = v.match(/^\{typography\.scale\.([a-zA-Z0-9-]+)\.fontSize\}$/);
     return m ? kebab(m[1]) : null;
 };
-/** "{color.semantic.primary}" → "var(--ds-color-semantic-primary)" - the raw
- *  scoped vars always exist, so arbitrary-property fallbacks never dangle. */
+/**
+ * "{color.semantic.primary}" → "var(--ds-color-semantic-primary)" - a grafia INTERNA, que a porta
+ * de tradução (`speak`) reescreve no nome dele ou no valor literal antes de qualquer byte ir a
+ * disco.
+ *
+ * ELA NUNCA SOBREVIVE ATÉ O ARQUIVO DELE (`INV-GERAL-13`): `speak` é a última coisa que roda em
+ * `generateComponentFiles`, e `nothing-of-ours-is-asked-for.spec.ts` reprova o texto que sair daqui
+ * com a nossa grafia dentro. Existe como forma intermediária porque é ela que carrega o caminho da
+ * referência (`color.semantic.primary`) até a folha que sabe o valor.
+ */
 const refToDsVar = (v) => v.replace(/\{([a-z0-9.-]+)\}/gi, (_, path) => {
     return `var(--ds-${path.split(".").map(kebab).join("-")})`;
 });
@@ -531,25 +539,28 @@ function remToTwScale(value) {
     return Number.isInteger(n) && n >= 0 && n <= 96 ? String(n) : null;
 }
 /**
- * O UTILITÁRIO NOMEADO SÓ VALE QUANDO A FOLHA INSTALADA O DECLARA - e é isso que decide o VALOR.
+ * O UTILITÁRIO NOMEADO SÓ VALE QUANDO O `@theme` **DELE** O DECLARA - e é isso que decide o VALOR.
  *
  * `rounded-lg` existe em qualquer projeto com Tailwind, então a classe nunca "falta". O que muda é
- * de quem é o valor: quando o `theme.css` que caiu na pasta dele declara `--radius-lg`, a classe
- * pinta o raio DO SISTEMA; quando não declara, ela pinta o default do Tailwind - e o componente
- * mente em silêncio, que é pior que uma classe morta, porque nada na tela parece faltar.
+ * de quem é o valor: quando o `@theme` do projeto dele declara `--radius-lg`, a classe pinta o raio
+ * DELE, e a decisão continua sendo dele; quando não declara, ela pinta o default do Tailwind - e o
+ * componente mente em silêncio, que é pior que uma classe morta, porque nada na tela parece faltar.
  *
- * A folha não declara por dois motivos, os dois legítimos: a redefinição roubaria uma classe que o
- * app dele já usa (`INV-VOLTA-13`, o alinhamento), ou o compilador não faz ponte para um nome que
- * não está em `meta.ownedNames` (o `--font-body` do codelevel). Nos dois casos a resposta certa é a
- * mesma: emitir o valor arbitrário com `var(--ds-*)`, que resolve sempre dentro de `[data-ds]`.
+ * A PERGUNTA ERA SOBRE A NOSSA FOLHA ATÉ 11/09, e era a última dependência de runtime que o código
+ * entregue carregava. `rounded-lg` escrito porque o NOSSO `theme.css` declara `--radius-lg` só pinta
+ * o sistema num app que importa aquele arquivo - e `INV-GERAL-13` diz que nenhum app dele importa. O
+ * componente saía com a aparência certa na nossa cabeça e o raio do Tailwind na tela dele.
  *
- * MEDIDO em 07/09 sobre TODOS os componentes das duas populações:
+ * QUANDO ELE NÃO DECLARA, a resposta é o valor arbitrário - e a porta de tradução o resolve no nome
+ * dele ou no literal, nunca numa variável nossa.
  *
- *     codelevel, repo real   58 de 110 utilitários de token (53%) não carregavam o valor dele
+ * MEDIDO em 07/09 sobre TODOS os componentes das duas populações, com a folha NOSSA respondendo:
+ *
+ *     codelevel, repo real   58 de 110 utilitários de token (53%) já caíam no arbitrário
  *     ember, app novo        34 de 241 (14%)
  *
- * `null` é projeto sem folha instalada - `refit` e `generate` já dizem que nada pinta sem o `add`,
- * e ali o nome legível não custa nada.
+ * `null` é "ninguém mediu" - `refit` e `generate` já dizem que nada pinta sem o `add`, e ali o nome
+ * legível não custa nada.
  */
 const minted = (themeVars, cssVar) => themeVars === null || themeVars.has(cssVar);
 /** One declaration → Tailwind classes (pretty when mappable, arbitrary-property
@@ -890,15 +901,27 @@ function variantOwnedProps(variants, axis) {
     return [...props];
 }
 // ── Emission ─────────────────────────────────────────────────────────────────
+/**
+ * O CABEÇALHO DO ARQUIVO DELE - e as duas linhas de setup saíram dele em 11/09.
+ *
+ * O QUE ELAS DIZIAM, dentro de TODO `.tsx` que a plataforma escreve no repositório dele:
+ * *"Global setup (once per app): import _synthesisui/ds/<slug>/tokens.css"* e *"put data-ds=<slug>
+ * on a root element"*. Era a instrução que o produto promete não dar, escrita no lugar onde ela
+ * sobrevive a qualquer conserto do terminal - e ela ficava lá, num arquivo dele, para todo agente
+ * e toda pessoa lerem depois (`INV-GERAL-13`).
+ *
+ * E ELA FAZIA UM SEGUNDO ESTRAGO, medido em 10/09: `readWiring` procurava essas mesmas strings no
+ * repositório para responder *"este projeto carrega o sistema?"*, então a partir do primeiro
+ * componente que NÓS escrevemos ela respondia `imported: true` sobre um projeto que não importa
+ * nada. Um comentário nosso nunca provou nada sobre o projeto dele.
+ *
+ * O que fica é a PROCEDÊNCIA - quem escreveu, de qual sistema, em que versão. Ela não pede nada; ela
+ * responde a pergunta de quem abre o arquivo daqui a seis meses.
+ */
 function header(slug, name, version, mode) {
-    const setup = mode === "tailwind"
-        ? `import _synthesisui/ds/${slug}/theme.css (Tailwind adapter) + tokens.css`
-        : `import _synthesisui/ds/${slug}/tokens.css`;
     return [
         `// Generated by SynthesisUI - "${name}" from the "${slug}" design system (v${version}).`,
-        `// On-system by construction: every style resolves to the DS tokens.`,
-        `// Global setup (once per app): ${setup}`,
-        `// and put data-ds="${slug}" on a root element (e.g. <body data-ds="${slug}">).`,
+        `// Every value here is a name YOUR code declares, or the value itself - nothing to import.`,
         ...(mode === "tailwind" ? [OVERRIDE_WARNING] : []),
     ].join("\n");
 }
@@ -1507,12 +1530,16 @@ scheme,
  */
 tongue, 
 /**
- * O QUE A FOLHA INSTALADA DECLARA NO `@theme` - `installedThemeVars(root, slug)`.
+ * O QUE O `@theme` **DELE** DECLARA - `theirThemeVars(root)`.
  *
  * OBRIGATÓRIO, pelo mesmo argumento do `scheme` e do `tongue`: o utilitário nomeado que este
- * módulo escreve só carrega o valor DO SISTEMA quando a folha que caiu na pasta dele declara a
+ * módulo escreve só carrega um valor de design quando o `@theme` do PROJETO dele declara a
  * variável. Sem essa resposta o codegen escreve `rounded-lg` e a classe pinta o default do
- * Tailwind - o componente mente sem nada faltar na tela. `null` é projeto sem folha instalada.
+ * Tailwind - o componente mente sem nada faltar na tela.
+ *
+ * ERA A NOSSA FOLHA QUE RESPONDIA ISTO, e essa era a última dependência de runtime que o código
+ * entregue ainda tinha (`INV-GERAL-13`, 11/09). `null` é "ninguém mediu", e continua significando
+ * que o nome legível não custa nada - `refit` e `generate` já dizem que nada pinta sem o `add`.
  */
 themeVars) {
     const files = [];

package/dist/copy/connect.pt-BR.js

@@ -66,6 +66,9 @@ register("pt-BR", {
     "already current": "já está em dia",
     "updated to this CLI's pipeline": "atualizada para esta versão",
     "removed - renamed to /sui-import-ds": "removida - virou /sui-import-ds",
+    /** A skill aposentada fica no repositório dele, nomeada - ver `RETIRED_SKILLS`. */
+    "retired - nothing of ours loads in your app any more": "aposentada - nada nosso carrega no seu app",
+    "it stays in your repo - yours to delete": "ela fica no seu repositório - sua para apagar",
     // ── onde o bloco de regras caiu ──
     "how to turn this repo into your system": "como transformar este repo no seu sistema",
     "rewritten for what is installed": "reescrito para o que está instalado",

package/dist/doctor/apply-fix.js

@@ -437,7 +437,7 @@ export function describeFix(result, dry) {
     const lines = [];
     if (applied.length === 0) {
         lines.push(decisions > 0
-            ? `Nothing to apply. All ${decisions} findings are values your system has no name for - those are design decisions, not fixes.`
+            ? `Nothing to apply. All ${decisions} findings are values your own code names nowhere - those are design decisions, not fixes. Name one and \`--fix\` picks it up.`
             : relative > 0
                 ? `Nothing to apply. All ${relative} findings are lengths in \`em\`, which follow the element's font size - swapping them can move the layout, so that call is yours.`
                 : /**
@@ -531,6 +531,6 @@ export function describeFix(result, dry) {
     const rewritten = new Set(applied.map((a) => `${a.file}:${a.line}`));
     const halfWritten = skipped.filter((s) => rewritten.has(`${s.file}:${s.line}`)).length;
     if (halfWritten > 0)
-        lines.push(`  ${halfWritten} of those ${halfWritten === 1 ? "sits" : "sit"} on a line this command just rewrote - a shorthand comes back with a token and a literal side by side (\`padding: 8px var(--ds-spacing-24)\`). See them by value: npx synthesisui doctor --migrate`);
+        lines.push(`  ${halfWritten} of those ${halfWritten === 1 ? "sits" : "sit"} on a line this command just rewrote - a shorthand comes back with a token and a literal side by side (\`padding: 8px var(--spacing-24)\`). See them by value: npx synthesisui doctor --migrate`);
     return lines;
 }

package/dist/doctor/scan.js

@@ -12,14 +12,40 @@
 import { utilitiesOn } from "./idiom-names.js";
 import { normalizeValue, tokenMatch } from "./tokens.js";
 /**
- * O NOME QUE SE ESCREVE NO ARQUIVO DELE - e existe uma função só para isto por um motivo.
+ * O NOME QUE SE ESCREVE NO ARQUIVO DELE - e ele é SEMPRE do vocabulário dele (`INV-GERAL-13`).
  *
  * Seis lugares decidem o que a pessoa vê ou o que o `--fix` grava: o relatório, o plano, o hook, o
  * MCP, a aplicação e a contagem. Deixar cada um lembrar de preferir `theirToken` é o padrão do
  * argumento opcional que se esquece - e o sintoma seria o pior possível: o comando aconselhando um
  * nome e o hook aconselhando outro, sobre o mesmo arquivo.
+ *
+ * O NOSSO NOME SAIU DAQUI EM 11/09, e ele era a metade que contrariava a decisão de 07/09.
+ *
+ * A regra é literal: *"tem nome no sistema DELE? SIM -> a nossa receita usa o nome dele. NÃO ->
+ * mantém HARDCODED, e a plataforma só AVISA"*. Esta função devolvia `theirToken ?? token`, e o
+ * `token` é o nome COMPILADO do sistema - a grafia `--ds-*`, que é invenção nossa. Então o comando
+ * que promete adotar o sistema trocava um literal que funciona por uma variável que só resolve com
+ * uma folha nossa carregada no app dele.
+ *
+ * MEDIDO no `codelevel` em 04/09, sobre as 216 trocas com nome esperando: **60 (28%) escreviam a
+ * nossa grafia**. Eram exatamente as que exigiam o `@import` - e para protegê-las o comando recusava
+ * as outras 156 por inteiro, cobrando a folha em troca.
+ *
+ * O valor que só o nosso lado nomeia não desaparece do relatório: ele vira AVISO, com o valor e a
+ * linha, e a decisão de batizá-lo continua sendo dele. Ver `ourNameOnly`.
  */
-export const nameToWrite = (f) => f.theirToken ?? f.token;
+export const nameToWrite = (f) => f.theirToken ?? (f.tokenIsTheirs ? f.token : null);
+/**
+ * O VALOR QUE **SÓ** O NOSSO LADO NOMEIA - o que a plataforma AVISA em vez de escrever.
+ *
+ * É a outra metade de `nameToWrite`, e ela existe para o silêncio não acontecer: um achado sem nome
+ * dele e com nome nosso some das duas listas se ninguém perguntar por ele, e sumir é
+ * indistinguível de "está tudo nomeado" para quem lê (lei 8).
+ *
+ * Quem chama DIZ o valor e onde ele está - nunca propõe o nome. É a escolha dele de 10/09 entre as
+ * duas alternativas, e a mesma que o hook já segue.
+ */
+export const ourNameOnly = (f) => !f.theirToken && !f.tokenIsTheirs && Boolean(f.token);
 /**
  * `next/og` renders JSX to a PNG on the server. There is no document, so there
  * is no `var(--ds-*)` to read: every colour in such a file MUST be a literal.
@@ -607,6 +633,8 @@ function scanCore(file, source, table) {
              * `--spacing` no vocabulário dele, e qual dos dois está certo depende de onde o literal está.
              */
             const theirs = table.aliases.get(`${kind}:${normalizeValue(literal, table.rootPx)}`);
+            /** A procedência do `token`, lida da tabela que o achou - ver `tokenIsTheirs`. */
+            const tableIsTheirs = table.source !== null && table.source !== "installed";
             findings.push({
                 kind,
                 line: at,
@@ -617,6 +645,9 @@ function scanCore(file, source, table) {
                     ? { fontRelative: true }
                     : {}),
                 ...(theirs?.writable ? { theirToken: theirs.name } : {}),
+                ...(tableIsTheirs && match?.token
+                    ? { tokenIsTheirs: true }
+                    : {}),
                 /**
                  * O NOME QUE SÓ SE DIZ - `$gray_dark` do Sass, `@brand` do Less.
                  *

package/dist/doctor/their-names.js

@@ -196,8 +196,14 @@ export function theirNames(ours, theirs) {
              * 66 delas gravadas por um `--fix --write`, e a pior na PRIMEIRA página do relatório -
              * `0.25em → --radius-xs` em 116 arquivos. Ver `FAMILY_WORDS`.
              *
-             * Recusar aqui não perde informação: sem alias, `nameToWrite` cai no NOSSO token, que é da
-             * família certa porque foi o prefixo dela que o trouxe a este laço.
+             * E DESDE 11/09 RECUSAR AQUI SIGNIFICA SILÊNCIO, não um nome nosso no lugar.
+             *
+             * Esta linha dizia que recusar não perdia informação, *"porque sem alias `nameToWrite` cai no
+             * NOSSO token"*. Ele não cai mais: a nossa grafia deixou de ser escrita no código dele
+             * (`INV-GERAL-13`), então um valor cuja categoria não fecha sai da lista de trocas em vez de
+             * sair com o nosso nome. Isso é o desfecho certo - a troca errada era escrever um token de
+             * tipo num `border-radius` -, e o valor não desaparece: ele é DITO, com o valor e a linha,
+             * pelo caminho que `ourNameOnly` alimenta.
              */
             const usable = formDecides(value)
                 ? candidates

package/dist/fonts.js

@@ -89,7 +89,7 @@ export function googleFontsHref(families) {
  */
 export const FAMILY_SEAM_PREFIX = "--ds-typography-families-";
 export function nextFontSnippet(input) {
-    const { families, slug, appDir = "app", seam, facts, declaredWeights, } = input;
+    const { families, appDir = "app", facts, declaredWeights } = input;
     /**
      * A ORDEM É DETERMINÍSTICA e os duplicados saem: isto vira uma linha de arquivo gerado, e um
      * conjunto que muda de ordem entre rodadas produz diff onde nada mudou.
@@ -219,15 +219,39 @@ export function nextFontSnippet(input) {
      * projeto dele deixaria de compilar por causa da linha que a gente mandou colar.
      */
     const emitted = roles.filter((role) => constOf(role) !== undefined);
+    /**
+     * O `data-ds` SAIU DO LAYOUT DELE EM 11/09 - `INV-GERAL-13`.
+     *
+     * O atributo existia para a NOSSA folha aplicar dentro dele, e nenhum app dele carrega a nossa
+     * folha. O que resta na linha é o que o `next/font` exige e é dele: a classe que carrega a
+     * variável de cada fonte.
+     */
     const layout = [
         `// ${appDir}/layout.tsx`,
         `import { ${[...new Set(emitted.map(constOf))].join(", ")} } from "./fonts";`,
-        `<body data-ds="${slug}" className={\`${[...new Set(emitted.map((r) => `\${${constOf(r)}.variable}`))].join(" ")}\`}>`,
+        `<body className={\`${[...new Set(emitted.map((r) => `\${${constOf(r)}.variable}`))].join(" ")}\`}>`,
     ];
+    /**
+     * O BLOCO DE CSS PASSA A ESCREVER NO VOCABULÁRIO **DELE** - o conserto de 11/09.
+     *
+     * O QUE ELE ESCREVIA: um `[data-ds="<slug>"]` com `--ds-typography-families-<role>` apontando para
+     * a fonte. Nosso escopo, nossa variável, dentro da folha dele - e só resolvia com a nossa folha
+     * carregada, que é o que `INV-GERAL-13` proíbe.
+     *
+     * O QUE ELE ESCREVE AGORA: um `@theme` com `--font-<role>`, que é o namespace de fonte do Tailwind
+     * DELE. Duas coisas acontecem de uma vez, e as duas são dele: a utility `font-<role>` passa a
+     * existir no projeto dele carregando a fonte que o `next/font` baixou, e `theirThemeVars` -
+     * o leitor que decide o utilitário nomeado no codegen - passa a ver aquele nome. Daí em diante o
+     * componente que a plataforma escreve veste `font-<role>` em vez de um literal, porque o `@theme`
+     * DELE declara o nome.
+     *
+     * Nenhuma linha aqui menciona o sistema, o slug ou uma variável nossa: é a fonte dele, ligada ao
+     * Tailwind dele.
+     */
     const css = [
-        `/* ${appDir}/globals.css - AFTER the tokens.css import */`,
-        `[data-ds="${slug}"] {`,
-        ...emitted.map((role) => `  ${seam?.[role] ?? `${FAMILY_SEAM_PREFIX}${role}`}: var(${roleVar(role)});`),
+        `/* ${appDir}/globals.css - in your own @theme */`,
+        `@theme {`,
+        ...emitted.map((role) => `  --font-${role}: var(${roleVar(role)});`),
         `}`,
     ];
     /**

package/dist/global-sheet.js

@@ -1,134 +1,23 @@
-import { readdir, readFile } from "node:fs/promises";
-import { dirname, join, posix, relative, resolve } from "node:path";
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
 import { exists } from "./agent-wiring.js";
 /**
- * A FOLHA GLOBAL QUE OS APPS DELE REALMENTE CARREGAM - e num monorepo ela quase nunca é a do app.
+ * AS PASTAS DE APP DESTE REPOSITÓRIO - e era um módulo sobre a folha global dele até 11/09.
  *
- * O QUE O CLIENTE PERCEBE SEM ISTO. O `add` manda importar os tokens em `apps/<x>/app/globals.css`.
- * MEDIDO em 01/09 no `codelevel`: os DOIS apps dele fazem `@import "@repo/ui/styles/globals.css"`, e
- * o `globals.css` do app diz, em comentário dele, *"Do not redeclare tokens or fonts here - extend in
- * styles/"*. A instrução apontava para o arquivo errado, e a convenção certa estava escrita ali do
- * lado.
+ * O QUE MORAVA AQUI: `globalSheetOf`, `sheetChainOf`, `prefixFrom` e o resolvedor de `exports` do
+ * workspace. Os quatro existiam para uma coisa - achar a folha que os apps dele realmente carregam,
+ * e contar o `../` até a raiz, para a instrução de `@import` apontar para o arquivo certo.
  *
- * Ele seguiu a instrução no arquivo CERTO - o do pacote - e o caminho relativo que a gente imprimiu
- * era o do app. Um monorepo com pacote de UI compartilhado não é exceção: é a forma comum, e a
- * instrução tem que derivar de onde o CSS dele mora em vez de assumir.
+ * Era a parte mais cuidadosa daquele texto. MEDIDO em 01/09 no `codelevel`: os dois apps dele fazem
+ * `@import "@repo/ui/styles/globals.css"`, e o `globals.css` do app diz, em comentário DELE, *"Do
+ * not redeclare tokens or fonts here"*. A instrução apontava para o arquivo errado, com o caminho
+ * relativo de outro, e o conserto foi seguir a cadeia em vez de assumir.
  *
- * ─────────────────────────────────────────────────────────────────────────
- * COMO A FOLHA REAL É ENCONTRADA, e nada aqui é palpite:
- *
- *     1. abre o `globals.css` do app
- *     2. procura `@import "<spec>"` que aponte para um CSS DENTRO deste repositório
- *     3. resolve o `<spec>`: caminho relativo, ou pacote do workspace pelo `exports`
- *     4. repete na folha encontrada, até ela não re-exportar mais
- *
- * O QUE NÃO É SEGUIDO: `tailwindcss` e qualquer coisa que não resolva para um arquivo daqui. Um
- * `@import "tailwindcss"` é a biblioteca, e mandar o cliente editá-la seria pior que a instrução que
- * isto conserta.
+ * O TEXTO INTEIRO DEIXOU DE EXISTIR (`INV-GERAL-13`): nada que a plataforma escreve no repositório
+ * dele depende de folha nossa, então não há `@import` para apontar. O que sobrevive é a única
+ * pergunta que não era sobre a nossa folha - *"quais pastas deste repositório são app?"* -, porque é
+ * onde o `fonts.ts` do `next/font` DELE entra, um por app.
  */
-/** Quantos saltos seguir antes de desistir - um ciclo de imports não pode travar um `add`. */
-const MAX_HOPS = 5;
-const IMPORT = /@import\s+["']([^"']+)["']/g;
-/** `@repo/ui/styles/globals.css` → `packages/ui/src/styles/globals.css`, pelo `exports` dele. */
-async function fromWorkspace(root, spec) {
-    for (const group of ["packages", "apps", "libs"]) {
-        let entries;
-        try {
-            const { readdir } = await import("node:fs/promises");
-            entries = await readdir(join(root, group));
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            const pkgPath = join(root, group, entry, "package.json");
-            const raw = await readFile(pkgPath, "utf8").catch(() => null);
-            if (!raw)
-                continue;
-            let pkg;
-            try {
-                pkg = JSON.parse(raw);
-            }
-            catch {
-                continue;
-            }
-            if (!pkg.name || !spec.startsWith(`${pkg.name}/`))
-                continue;
-            const sub = `./${spec.slice(pkg.name.length + 1)}`;
-            const target = pkg.exports?.[sub];
-            if (typeof target !== "string")
-                continue;
-            return posix.join(group, entry, target.replace(/^\.\//, ""));
-        }
-    }
-    return null;
-}
-/**
- * A folha onde os tokens dele devem entrar, relativa à raiz - `appSheet` quando nada a re-exporta.
- *
- * DELEGA, e não caminha: quem caminha é `sheetChainOf`. Dois caminhadores sobre a mesma cadeia é
- * como um deles para de seguir um salto que o outro segue, e ninguém descobre até um cliente
- * receber a instrução apontando para a folha errada - que é exatamente o defeito que
- * `INV-VOLTA-12` fechou.
- */
-export async function globalSheetOf(root, appSheet) {
-    const chain = await sheetChainOf(root, appSheet);
-    return chain[chain.length - 1] ?? appSheet;
-}
-/**
- * A CADEIA INTEIRA, da folha do app até a última que ninguém re-exporta - e por que ela é pública.
- *
- * O QUE O CLIENTE GANHA: a resposta "este app carrega o meu design system?" medida no app DELE, e
- * não no projeto. `readWiring` varria a raiz e devolvia "existe em algum lugar daqui": num monorepo
- * com dois apps servidos, um fiado e outro não, o fiado respondia pelo outro - e a pessoa recebia
- * "está tudo certo" sobre o app que não carrega nada.
- *
- * A pergunta dos IMPORTS não se responde varrendo pasta: ela se responde seguindo a cadeia de
- * `@import` a partir da folha daquele app, porque a folha que carrega os tokens quase nunca é a do
- * app - num monorepo é a do pacote compartilhado, e os dois apps chegam nela.
- *
- * A ordem é do app para fora, e o teto de saltos é o mesmo: um ciclo de imports não pode travar um
- * comando.
- */
-export async function sheetChainOf(root, appSheet) {
-    const chain = [];
-    let current = appSheet;
-    for (let hop = 0; hop < MAX_HOPS; hop += 1) {
-        chain.push(current);
-        const raw = await readFile(join(root, current), "utf8").catch(() => null);
-        if (!raw)
-            return chain;
-        let next = null;
-        for (const m of raw.matchAll(IMPORT)) {
-            const spec = m[1];
-            if (!spec.endsWith(".css"))
-                continue;
-            const candidate = spec.startsWith(".")
-                ? posix.normalize(posix.join(posix.dirname(current), spec))
-                : await fromWorkspace(root, spec);
-            if (!candidate)
-                continue;
-            /** Fora da raiz não é folha dele para editar - e um `..` demais sai do repositório. */
-            if (candidate.startsWith(".."))
-                continue;
-            const readable = await readFile(join(root, candidate), "utf8").catch(() => null);
-            if (readable === null)
-                continue;
-            next = candidate;
-            break;
-        }
-        /** Uma folha que aponta para si mesma encerra a cadeia em vez de gastar o teto de saltos. */
-        if (!next || next === current || chain.includes(next))
-            return chain;
-        current = next;
-    }
-    return chain;
-}
-/** O `../` que leva daquela folha até a raiz do repositório - o prefixo do `@import`. */
-export function prefixFrom(sheet) {
-    const up = relative(dirname(resolve("/r", sheet)), "/r");
-    return up === "" ? "./" : `${up.split(/[\\/]/).join("/")}/`;
-}
 /**
  * A RAIZ DE CADA APP DESTE REPOSITÓRIO - onde o escopo e a tipografia entram, um por app.
  *