orbital-ds 0.8.0 → 0.9.0

package/scripts/setup.mjs

@@ -0,0 +1,99 @@
+/**
+ * orbital-ds · CONEXIÓN de una app: localizar su CSS principal, poner los @import en
+ * el orden correcto (como bloque delimitado, sin tocar lo demás) e instalar paquetes
+ * con el gestor de la app. Lo usa `orbital-ds-init`.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, relative, resolve, sep } from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+export const IMPORTS_INI = '/* orbital-ds:imports:start */';
+export const IMPORTS_FIN = '/* orbital-ds:imports:end */';
+
+/** CSS principal de la app (el que importa Tailwind), o null. */
+export function detectarCssApp(cwd = process.cwd()) {
+  const candidatos = [
+    'src/index.css', 'src/styles.css', 'src/globals.css', 'src/app.css', 'src/main.css',
+    'app/globals.css', 'app/app.css', 'src/app/globals.css', 'styles/globals.css',
+  ];
+  const existentes = candidatos.map((c) => resolve(cwd, c)).filter((f) => existsSync(f));
+  return existentes.find((f) => /@import\s+['"]tailwindcss['"]/.test(readFileSync(f, 'utf8'))) ?? existentes[0] ?? null;
+}
+
+const rel = (desde, hasta) => {
+  const r = relative(dirname(desde), hasta).split(sep).join('/');
+  return r.startsWith('.') ? r : `./${r}`;
+};
+
+/**
+ * Pone (o actualiza) el bloque de imports de orbital-ds al PRINCIPIO del CSS de la app.
+ * Quita solo las líneas que el bloque ya contiene (tailwindcss, tw-animate-css, orbital-ds
+ * y el brand.css); el resto del fichero queda igual. Devuelve el nuevo contenido.
+ */
+export function bloqueImports(cssFile, { tema, brandFile, cwd = process.cwd() }) {
+  const nm = resolve(cwd, 'node_modules/orbital-ds/dist');
+  const lineas = [
+    IMPORTS_INI,
+    `@import 'orbital-ds/themes/${tema}.fonts.css'; /* fuentes del tema: lo primero */`,
+    `@import 'tailwindcss';`,
+    `@import 'tw-animate-css';`,
+    `@import 'orbital-ds/styles.css'; /* estructura */`,
+    `@import 'orbital-ds/themes/${tema}.css'; /* tema */`,
+    `@import '${rel(cssFile, brandFile)}'; /* tu marca: gana al tema */`,
+    `@source '${rel(cssFile, nm)}';`,
+    IMPORTS_FIN,
+  ];
+  return lineas.join('\n');
+}
+
+export function conectarCss(cssFile, opciones) {
+  const actual = existsSync(cssFile) ? readFileSync(cssFile, 'utf8') : '';
+  const bloque = bloqueImports(cssFile, opciones);
+  let resto = actual;
+  if (resto.includes(IMPORTS_INI) && resto.includes(IMPORTS_FIN)) {
+    resto = resto.slice(0, resto.indexOf(IMPORTS_INI)) + resto.slice(resto.indexOf(IMPORTS_FIN) + IMPORTS_FIN.length);
+  }
+  const brandBase = opciones.brandFile.split(/[\\/]/).pop();
+  resto = resto
+    .split(/\r?\n/)
+    .filter((l) => {
+      const t = l.trim();
+      if (/^@import\s+['"](tailwindcss|tw-animate-css)['"]\s*;?$/.test(t)) return false;
+      if (/^@import\s+['"]orbital-ds\/[^'"]+['"]\s*;?/.test(t)) return false;
+      if (new RegExp(`^@import\\s+['"][^'"]*${brandBase.replace('.', '\\.')}['"]`).test(t)) return false;
+      if (/^@source\s+['"][^'"]*orbital-ds[^'"]*['"]\s*;?$/.test(t)) return false;
+      return true;
+    })
+    .join('\n')
+    .replace(/^\s+/, '');
+  const nuevo = `${bloque}\n${resto ? `\n${resto}` : ''}`.replace(/\s*$/, '\n');
+  const cambia = nuevo !== actual;
+  if (cambia) writeFileSync(cssFile, nuevo);
+  return cambia ? (actual ? 'actualizado' : 'creado') : 'igual';
+}
+
+/** Gestor de paquetes de la app según su lockfile. */
+export function gestorPaquetes(cwd = process.cwd()) {
+  if (existsSync(resolve(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(resolve(cwd, 'yarn.lock'))) return 'yarn';
+  if (existsSync(resolve(cwd, 'bun.lockb')) || existsSync(resolve(cwd, 'bun.lock'))) return 'bun';
+  return 'npm';
+}
+
+export function comandoInstalar(gestor, paquetes) {
+  return gestor === 'npm' ? `npm install ${paquetes.join(' ')}` : `${gestor} add ${paquetes.join(' ')}`;
+}
+
+export function instalar(gestor, paquetes, cwd = process.cwd()) {
+  const r = spawnSync(comandoInstalar(gestor, paquetes), { cwd, shell: true, stdio: 'pipe', encoding: 'utf8' });
+  return { ok: r.status === 0, salida: `${r.stdout ?? ''}${r.stderr ?? ''}`.trim() };
+}
+
+export function yaInstalado(paquete, cwd = process.cwd()) {
+  try {
+    const p = JSON.parse(readFileSync(resolve(cwd, 'package.json'), 'utf8'));
+    return Boolean(p.dependencies?.[paquete] ?? p.devDependencies?.[paquete]);
+  } catch {
+    return false;
+  }
+}