@sia-ui/cli 0.5.0 → 0.6.0

package/dist/styles.mjs

@@ -0,0 +1,111 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { empreinte } from "./lock.mjs";
+
+/**
+ * La feuille commune, suivie comme un composant.
+ *
+ * Copiée une fois par `init`, puis plus rien ne la touchait : les composants
+ * se mettaient à jour sans elle. Or un composant peut dépendre d'une règle
+ * nouvelle de la feuille — le reset `box-sizing` en est un — et
+ * l'utilisateur recevait le composant sans ce qui le fait tenir.
+ *
+ * Son empreinte à la copie est notée dans le verrou (`styles`). Non
+ * retouchée, elle suit le registre ; retouchée, elle n'est remplacée que sur
+ * demande (`update --force`). Elle est lue à la même source que les
+ * composants : copie embarquée ou registre HTTP.
+ */
+
+async function lire(chemin) {
+  try {
+    return await readFile(chemin);
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+}
+
+/**
+ * L'état de la feuille du projet.
+ *
+ * `absente`, `à jour`, `en retard` (non retouchée, le registre a plus
+ * récent), `modifiée` (retouchée depuis la copie), ou `non suivie` (copiée
+ * par une CLI qui ne notait pas son empreinte, et différente de l'actuelle).
+ */
+export async function etatStyles({ cwd, config, lock, lireStyles }) {
+  const cible = join(cwd, config.styles);
+  const contenu = await lireStyles();
+  const actuelle = { contenu, empreinte: empreinte(contenu) };
+  const presente = await lire(cible);
+
+  if (presente === null) return { etat: "absente", cible, actuelle };
+
+  const locale = empreinte(presente);
+  if (locale === actuelle.empreinte) return { etat: "à jour", cible, actuelle };
+
+  const notee = lock.styles?.hash;
+  if (!notee) return { etat: "non suivie", cible, actuelle };
+  return {
+    etat: locale === notee ? "en retard" : "modifiée",
+    cible,
+    actuelle,
+  };
+}
+
+const RAISON = {
+  modifiée: "modifiée localement",
+  "non suivie": "copiée avant le suivi des versions",
+};
+
+/**
+ * Met la feuille à jour selon ce que la commande autorise, et le dit.
+ *
+ * - `creer` — `init` : seulement si elle est absente.
+ * - `sur` — `add` : absente ou en retard ; jamais une feuille retouchée.
+ * - `forcer` — `update --force` : même retouchée.
+ *
+ * Complète le verrou (`styles`) sans l'écrire : l'appelant l'écrit une fois,
+ * avec le reste. `dryRun` annonce sans rien toucher.
+ */
+export async function synchroniserStyles(
+  { cwd, config, lock, lireStyles },
+  { mode = "sur", dryRun = false } = {},
+) {
+  const { etat, cible, actuelle } = await etatStyles({
+    cwd,
+    config,
+    lock,
+    lireStyles,
+  });
+
+  const noter = () => {
+    if (!dryRun) lock.styles = { file: config.styles, hash: actuelle.empreinte };
+  };
+
+  if (etat === "à jour") {
+    noter();
+    return { etat, action: "rien" };
+  }
+
+  const ecrire =
+    etat === "absente" ||
+    (mode !== "creer" && etat === "en retard") ||
+    mode === "forcer";
+
+  if (ecrire) {
+    if (!dryRun) {
+      await mkdir(dirname(cible), { recursive: true });
+      await writeFile(cible, actuelle.contenu);
+    }
+    noter();
+    console.log(`${etat === "absente" ? "add   " : "update"} ${config.styles}`);
+    return { etat, action: "écrite" };
+  }
+
+  console.log(
+    mode === "creer"
+      ? `skip   ${config.styles} (déjà présente — sia-ui update pour la mettre à jour)`
+      : `keep   ${config.styles} (${RAISON[etat]} — sia-ui update --force pour la remplacer)`,
+  );
+  return { etat, action: "gardée" };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia-ui/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Install SIA UI components progressively into an application.",
   "keywords": [
     "sia-ui",
@@ -39,10 +39,10 @@
     "react-dom": "^19.2.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16",
-    "@sia-ui/headless": "0.5.0",
-    "@sia-ui/react": "0.5.0",
-    "@sia-ui/tokens": "0.5.0",
-    "@sia-ui/utils": "0.5.0"
+    "@sia-ui/headless": "0.6.0",
+    "@sia-ui/react": "0.6.0",
+    "@sia-ui/utils": "0.6.0",
+    "@sia-ui/tokens": "0.6.0"
   },
   "scripts": {
     "build": "node scripts/build.mjs",