aplance-ui 1.5.2 → 1.6.0

package/README.md

@@ -4,7 +4,7 @@ A source-first React UI CLI by Aplance Technologies. `aplance-ui` scaffolds comp
 
 ## Install & init
 
-Inside an existing React project (Vite + React, Next.js, TanStack Start, Astro, or Electron-Vite):
+Inside an existing React 19 project (Vite + React, Next.js, TanStack Start, Astro, or Electron-Vite), on Node.js 20.12 or newer:
 
 ```bash
 npx aplance-ui init

package/dist/api.d.ts

@@ -176,4 +176,5 @@ interface ListCommandOptions {
 }
 declare const runList: (opts: ListCommandOptions) => void;
 
-export { type AddCommandOptions, CSS_CONFIG_PLACEMENTS, type ComponentsConfig, type CssConfigPlacement, type FrameworkTemplate, type InitCommandOptions, type InstallMeta, type ListCommandOptions, type LoadedRegistry, type Registry, type RegistryUnit, type ResolvedPaths, SUPPORTED_TEMPLATES, type ThemeDescriptor, type ThemeRegistry, allUnitsInOrder, configExists, findColor, findRadius, findSpacing, loadConfig, loadRegistry, makeDefaultConfig, resolvePaths, resolveUnits, runAdd, runInit, runList };
+export { CSS_CONFIG_PLACEMENTS, SUPPORTED_TEMPLATES, allUnitsInOrder, configExists, findColor, findRadius, findSpacing, loadConfig, loadRegistry, makeDefaultConfig, resolvePaths, resolveUnits, runAdd, runInit, runList };
+export type { AddCommandOptions, ComponentsConfig, CssConfigPlacement, FrameworkTemplate, InitCommandOptions, InstallMeta, ListCommandOptions, LoadedRegistry, Registry, RegistryUnit, ResolvedPaths, ThemeDescriptor, ThemeRegistry };

package/dist/api.js

@@ -180,10 +180,11 @@ var applyFileOps = async (ops, opts) => {
         ensureDir(op.target);
         writeFileSync(op.target, op.content);
       } catch (err) {
-        const cause = err instanceof Error ? err.message : String(err);
+        const reason = err instanceof Error ? err.message : String(err);
         throw new Error(
-          `Failed to write ${rel}: ${cause}
-${written} file(s) were already written before this failure. Fix the underlying issue (permissions? disk space?) and re-run - identical files will be detected as unchanged and skipped.`
+          `Failed to write ${rel}: ${reason}
+${written} file(s) were already written before this failure. Fix the underlying issue (permissions? disk space?) and re-run - identical files will be detected as unchanged and skipped.`,
+          { cause: err }
         );
       }
       logger.ok(`wrote  ${rel}`);
@@ -1111,18 +1112,18 @@ var firstExisting = (cwd, names) => {
 var readDeclaredDeps = (packageJsonPath) => {
   try {
     const pkg = JSON.parse(readFileSync7(packageJsonPath, "utf8"));
-    return /* @__PURE__ */ new Set([
-      ...Object.keys(pkg.dependencies ?? {}),
-      ...Object.keys(pkg.devDependencies ?? {}),
-      ...Object.keys(pkg.peerDependencies ?? {})
+    return new Map([
+      ...Object.entries(pkg.peerDependencies ?? {}),
+      ...Object.entries(pkg.devDependencies ?? {}),
+      ...Object.entries(pkg.dependencies ?? {})
     ]);
   } catch {
-    return /* @__PURE__ */ new Set();
+    return /* @__PURE__ */ new Map();
   }
 };
 var detectProject = (cwd) => {
   const packageJsonPath = existsSync6(join6(cwd, "package.json")) ? join6(cwd, "package.json") : null;
-  const declaredDeps = packageJsonPath ? readDeclaredDeps(packageJsonPath) : /* @__PURE__ */ new Set();
+  const declaredDeps = packageJsonPath ? readDeclaredDeps(packageJsonPath) : /* @__PURE__ */ new Map();
   const viteConfigPath = firstExisting(cwd, VITE_CONFIG_NAMES);
   const nextConfigPath = firstExisting(cwd, NEXT_CONFIG_NAMES);
   const astroConfigPath = firstExisting(cwd, ASTRO_CONFIG_NAMES);
@@ -1393,35 +1394,84 @@ var detectPackageManager = (cwd) => {
   if (existsSync8(join8(cwd, "package-lock.json"))) return "npm";
   return "npm";
 };
-var computeDependencyPlan = (input) => {
-  const { registry, units, cfg, project } = input;
-  const meta = registry.installMeta;
-  const dependencies = { ...meta.baseDependencies };
-  const devDependencies = { ...meta.baseDevDependencies };
-  if (cfg.utilities.enabled) {
-    Object.assign(devDependencies, meta.utilitiesDevDependencies);
+var leadingMajor = (spec) => {
+  const value = spec.trim();
+  if (value.includes("||") || value.includes(":") || /\s-\s/.test(value)) {
+    return null;
   }
+  const match = /^(?:\^|~|>=|=|v)?\s*(\d+)(?:[.\s]|$)/.exec(value);
+  return match ? Number(match[1]) : null;
+};
+var isOlderMajor = (declared, required) => {
+  const have = leadingMajor(declared);
+  const need = leadingMajor(required);
+  return have !== null && need !== null && have < need;
+};
+var unitDependencies = (meta, units) => {
+  const deps = {};
   for (const unit of units) {
     for (const pkg of unit.externalDeps) {
-      if (pkg in dependencies) continue;
       const version = meta.packageVersions[pkg];
-      if (!version) continue;
-      dependencies[pkg] = version;
+      if (version) deps[pkg] = version;
     }
   }
-  const skipped = [];
-  const filter = (bag) => {
-    for (const name of Object.keys(bag)) {
-      if (project.declaredDeps.has(name)) {
-        skipped.push({ name, reason: "already-declared" });
-        delete bag[name];
+  return deps;
+};
+var settleDeclared = (bags, meta, project) => {
+  const toolchain = /* @__PURE__ */ new Set([
+    ...Object.keys(meta.baseDependencies),
+    ...Object.keys(meta.baseDevDependencies),
+    ...Object.keys(meta.utilitiesDevDependencies)
+  ]);
+  const settled = {
+    skipped: [],
+    upgraded: [],
+    outdated: []
+  };
+  for (const bag of bags) {
+    for (const [name, required] of Object.entries(bag)) {
+      const declared = project.declaredDeps.get(name);
+      if (declared === void 0) continue;
+      if (!isOlderMajor(declared, required)) {
+        settled.skipped.push({ name, reason: "already-declared" });
+      } else if (toolchain.has(name)) {
+        settled.outdated.push({ name, declared, required });
+      } else {
+        settled.upgraded.push({ name, from: declared, to: required });
+        continue;
       }
+      delete bag[name];
     }
+  }
+  return settled;
+};
+var computeDependencyPlan = (input) => {
+  const { registry, units, cfg, project } = input;
+  const meta = registry.installMeta;
+  const dependencies = { ...meta.baseDependencies };
+  for (const [name, range] of Object.entries(unitDependencies(meta, units))) {
+    if (!(name in dependencies)) dependencies[name] = range;
+  }
+  const devDependencies = {
+    ...meta.baseDevDependencies,
+    ...cfg.utilities.enabled ? meta.utilitiesDevDependencies : {}
+  };
+  return {
+    dependencies,
+    devDependencies,
+    ...settleDeclared([dependencies, devDependencies], meta, project)
+  };
+};
+var computeUnitDependencyPlan = (input) => {
+  const meta = input.registry.installMeta;
+  const dependencies = unitDependencies(meta, input.units);
+  return {
+    dependencies,
+    devDependencies: {},
+    ...settleDeclared([dependencies], meta, input.project)
   };
-  filter(dependencies);
-  filter(devDependencies);
-  return { dependencies, devDependencies, skipped };
 };
+var quoteArg = (arg) => /^[\w@./:=+-]+$/.test(arg) ? arg : `"${arg}"`;
 var buildInstallCommands = (pm, plan) => {
   const commands = [];
   const runtimeSpecs = Object.entries(plan.dependencies).map(
@@ -1432,20 +1482,13 @@ var buildInstallCommands = (pm, plan) => {
   );
   const runtimeArgs = installArgs(pm, runtimeSpecs, false);
   const devArgs = installArgs(pm, devSpecs, true);
-  if (runtimeSpecs.length > 0) {
-    commands.push({
-      bin: pm,
-      args: runtimeArgs,
-      label: `${pm} ${runtimeArgs.join(" ")}`
-    });
-  }
-  if (devSpecs.length > 0) {
-    commands.push({
-      bin: pm,
-      args: devArgs,
-      label: `${pm} ${devArgs.join(" ")}`
-    });
-  }
+  const command = (args) => ({
+    bin: pm,
+    args,
+    label: [pm, ...args].map(quoteArg).join(" ")
+  });
+  if (runtimeSpecs.length > 0) commands.push(command(runtimeArgs));
+  if (devSpecs.length > 0) commands.push(command(devArgs));
   return commands;
 };
 var installArgs = (pm, specs, dev) => {
@@ -1470,12 +1513,12 @@ var runInstall = async (commands, opts) => {
   for (const cmd of commands) {
     opts.onCommand?.(cmd);
     await new Promise((resolve, reject) => {
-      const child = spawn(cmd.bin, cmd.args, {
+      const spawnOptions = {
         cwd: opts.cwd,
         stdio: "inherit",
-        env: { ...process.env, ...opts.env },
-        shell: process.platform === "win32"
-      });
+        env: { ...process.env, ...opts.env }
+      };
+      const child = process.platform === "win32" ? spawn(cmd.label, { ...spawnOptions, shell: true }) : spawn(cmd.bin, cmd.args, spawnOptions);
       child.on("error", reject);
       child.on("close", (code) => {
         if (code === 0) resolve();
@@ -1491,7 +1534,11 @@ var runInstall = async (commands, opts) => {
 };
 var describePlan = (plan) => {
   const lines = [];
-  const rows = (bag) => Object.entries(bag).sort(([a], [b]) => a.localeCompare(b)).map(([name, v]) => `  ${name} ${v}`);
+  const upgradedFrom = new Map(plan.upgraded.map((u) => [u.name, u.from]));
+  const rows = (bag) => Object.entries(bag).sort(([a], [b]) => a.localeCompare(b)).map(([name, v]) => {
+    const from = upgradedFrom.get(name);
+    return `  ${name} ${v}${from ? ` (upgrades ${from})` : ""}`;
+  });
   if (Object.keys(plan.dependencies).length) {
     lines.push("dependencies:");
     lines.push(...rows(plan.dependencies));
@@ -1506,6 +1553,13 @@ var describePlan = (plan) => {
     lines.push("already declared (kept as-is):");
     lines.push(...plan.skipped.map((s) => `  ${s.name}`));
   }
+  if (plan.outdated.length) {
+    if (lines.length) lines.push("");
+    lines.push("older major kept as-is (upgrade when you can):");
+    lines.push(
+      ...plan.outdated.map((o) => `  ${o.name} ${o.declared} (scaffold expects ${o.required})`)
+    );
+  }
   if (!lines.length) lines.push("nothing to install - all deps already declared.");
   return lines.join("\n");
 };
@@ -1825,7 +1879,7 @@ var runInit = async (opts) => {
 ${snippet.content.split("\n").map((l) => "    " + l).join("\n")}`);
   }
   steps.push(
-    `${pc4.cyan(String(stepIdx++))}  ${pc4.bold("Add more components anytime")}
+    `${pc4.cyan(String(stepIdx))}  ${pc4.bold("Add more components anytime")}
     npx aplance-ui add <name>     ${pc4.dim("# e.g. button modal tooltip")}
     npx aplance-ui add             ${pc4.dim("# interactive multi-select")}
     npx aplance-ui list            ${pc4.dim("# see everything available")}`
@@ -1885,7 +1939,7 @@ var runAdd = async (opts) => {
   });
   const summary = `${result.written} written \xB7 ${result.skipped} skipped \xB7 ${result.unchanged} unchanged`;
   const project = detectProject(opts.cwd);
-  const plan = computeRuntimePlan(registry, units, project);
+  const plan = computeUnitDependencyPlan({ registry, units, project });
   const pm = opts.packageManager ?? detectPackageManager(opts.cwd);
   const installCommands = buildInstallCommands(pm, plan);
   const hasWork = installCommands.length > 0;
@@ -1943,25 +1997,6 @@ var runAdd = async (opts) => {
   logger.info(summary);
   goodbye(`Added ${units.length} unit${units.length === 1 ? "" : "s"}.`);
 };
-var computeRuntimePlan = (registry, units, project) => {
-  const dependencies = {};
-  const skipped = [];
-  const meta = registry.installMeta;
-  for (const unit of units) {
-    for (const pkg of unit.externalDeps) {
-      const version = meta.packageVersions[pkg];
-      if (!version) continue;
-      if (project.declaredDeps.has(pkg)) {
-        if (!skipped.some((entry) => entry.name === pkg)) {
-          skipped.push({ name: pkg, reason: "already-declared" });
-        }
-        continue;
-      }
-      dependencies[pkg] = version;
-    }
-  }
-  return { dependencies, devDependencies: {}, skipped };
-};
 var pickUnits = async (all) => multiselect2({
   message: `Select units to add ${pc5.dim("(space to toggle, enter to confirm)")}`,
   options: groupedUnitOptions(all),