orbital-ds 0.5.0 → 0.6.2

package/scripts/init.mjs

@@ -1,55 +1,89 @@
-#!/usr/bin/env node
-/**
- * orbital-ds-init — crea el fichero de MARCA de una app.
- *
- *   pnpm exec orbital-ds-init            # crea src/brand.css si no existe
- *   pnpm exec orbital-ds-init --out app/brand.css
- *
- * NUNCA sobrescribe un fichero existente. Ese fichero es de la app: ninguna
- * actualización de orbital-ds lo toca, y se importa DESPUÉS del tema para que gane.
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const contract = JSON.parse(readFileSync(resolve(ROOT, 'contract.json'), 'utf8'));
-
-const outIdx = process.argv.indexOf('--out');
-const out = resolve(outIdx > -1 && process.argv[outIdx + 1] ? process.argv[outIdx + 1] : 'src/brand.css');
-
-if (existsSync(out)) {
-  console.log(`Ya existe ${out}: no se toca (es de tu app).`);
-  process.exit(0);
-}
-
-const lines = contract.brand.tokens.map(
-  (t) => `  /* --${t.name}: ${t.example}; */  /* ${t.about} */`,
-);
-
-const css = `/*
- * MARCA de la app — fichero TUYO.
- *
- * Ninguna actualización de orbital-ds lo toca. Se importa DESPUÉS del tema, así que
- * lo que pongas aquí gana. Si no defines nada, se aplica el valor estándar del tema.
- *
- * Estas variables son el grupo estable de «lo que una marca suele cambiar»: renombrar
- * o quitar una de ellas es una versión MAYOR de orbital-ds, con aviso previo.
- * Descomenta solo lo que necesites y cambia el valor.
- *
- * Cambia el color principal TODO junto: primary, ring, link, brand, sidebar-primary y
- * chart-1 deben ir a la par (y comprueba el contraste del texto sobre ellos).
- */
-:root {
-${lines.join('\n')}
-}
-
-/* Piel oscura: solo si tu marca necesita valores distintos en oscuro. */
-.dark {
-  /* --primary: ...; */
-}
-`;
-
-mkdirSync(dirname(out), { recursive: true });
-writeFileSync(out, css);
-console.log(`Creado ${out}.\n\nImpórtalo DESPUÉS del tema, en el CSS de tu app:\n\n  @import 'orbital-ds/themes/<tema>.css';\n  @import './brand.css';\n`);
+#!/usr/bin/env node
+/**
+ * orbital-ds-init — crea el fichero de MARCA de una app.
+ *
+ *   pnpm exec orbital-ds-init            # crea src/brand.css si no existe
+ *   pnpm exec orbital-ds-init --out app/brand.css
+ *
+ * NUNCA sobrescribe un fichero existente. Ese fichero es de la app: ninguna
+ * actualización de orbital-ds lo toca, y se importa DESPUÉS del tema para que gane.
+ *
+ * DESIGN.md: orbital-ds NO lo crea. Si la app ya tiene uno (`./DESIGN.md` o
+ * `--design ruta`), añade —o actualiza— solo un bloque delimitado por marcas
+ * `<!-- orbital-ds:start -->` … `<!-- orbital-ds:end -->`; el resto no se toca.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const contract = JSON.parse(readFileSync(resolve(ROOT, 'contract.json'), 'utf8'));
+
+const outIdx = process.argv.indexOf('--out');
+const out = resolve(outIdx > -1 && process.argv[outIdx + 1] ? process.argv[outIdx + 1] : 'src/brand.css');
+
+const brandExiste = existsSync(out);
+if (brandExiste) console.log(`Ya existe ${out}: no se toca (es de tu app).`);
+
+if (!brandExiste) {
+const lines = contract.brand.tokens.map(
+  (t) => `  /* --${t.name}: ${t.example}; */  /* ${t.about} */`,
+);
+
+const css = `/*
+ * MARCA de la app — fichero TUYO.
+ *
+ * Ninguna actualización de orbital-ds lo toca. Se importa DESPUÉS del tema, así que
+ * lo que pongas aquí gana. Si no defines nada, se aplica el valor estándar del tema.
+ *
+ * Estas variables son el grupo estable de «lo que una marca suele cambiar»: renombrar
+ * o quitar una de ellas es una versión MAYOR de orbital-ds, con aviso previo.
+ * Descomenta solo lo que necesites y cambia el valor.
+ *
+ * Cambia el color principal TODO junto: primary, ring, link, brand, sidebar-primary y
+ * chart-1 deben ir a la par (y comprueba el contraste del texto sobre ellos).
+ */
+:root {
+${lines.join('\n')}
+}
+
+/* Piel oscura: solo si tu marca necesita valores distintos en oscuro. */
+.dark {
+  /* --primary: ...; */
+}
+`;
+
+mkdirSync(dirname(out), { recursive: true });
+writeFileSync(out, css);
+console.log(`Creado ${out}.\n\nImpórtalo DESPUÉS del tema, en el CSS de tu app:\n\n  @import 'orbital-ds/themes/<tema>.css';\n  @import './brand.css';\n`);
+}
+
+// ── DESIGN.md de la app: bloque adicional, nunca el fichero entero ───────────────
+const designIdx = process.argv.indexOf('--design');
+const design = resolve(designIdx > -1 && process.argv[designIdx + 1] ? process.argv[designIdx + 1] : 'DESIGN.md');
+if (existsSync(design)) {
+  const INI = '<!-- orbital-ds:start -->';
+  const FIN = '<!-- orbital-ds:end -->';
+  const bloque = `${INI}
+## Sistema de diseño (orbital-ds)
+
+Bloque gestionado por \`orbital-ds-init\`; lo de fuera de las marcas es de la app y no se toca.
+
+- Reglas de uso: \`node_modules/orbital-ds/AGENTS.md\`
+- Contrato de tokens: \`orbital-ds/contract.json\` · componentes: \`orbital-ds/components.manifest.json\`
+- Cada tema trae su guía (\`orbital-ds/themes/<tema>.guide.md\`) y su ficha (\`<tema>.meta.json\`).
+- La marca de la app va en \`brand.css\` (importado después del tema), nunca editando el paquete.
+- Comprobación: \`pnpm exec orbital-ds-doctor\`
+${FIN}`;
+  const actual = readFileSync(design, 'utf8');
+  let nuevo;
+  if (actual.includes(INI) && actual.includes(FIN)) {
+    nuevo = actual.slice(0, actual.indexOf(INI)) + bloque + actual.slice(actual.indexOf(FIN) + FIN.length);
+  } else {
+    nuevo = `${actual.replace(/\s*$/, '')}\n\n${bloque}\n`;
+  }
+  if (nuevo !== actual) {
+    writeFileSync(design, nuevo);
+    console.log(`Actualizado el bloque de orbital-ds en ${design} (el resto no se toca).`);
+  } else console.log(`${design}: el bloque de orbital-ds ya está al día.`);
+}