@kznlabs/labsui 0.1.10 → 0.1.11

package/README.md

@@ -60,7 +60,9 @@ Run it again any time: existing files are kept.
 Resolves dependencies through the registry (`data-table` brings `table`,
 `checkbox`, `pagination`, …), writes each file under your alias folder and
 installs the npm packages it imports. Existing files are kept unless you pass
-`--overwrite`. If your alias isn't `@/`, imports are rewritten to match.
+`--overwrite`; a kept dependency whose code differs from this version is
+named, with the `labsui update` that brings it level, since the new item may
+need it. If your alias isn't `@/`, imports are rewritten to match.
 Components that live once in the root layout (`toast`, `confirm`) print the
 line to add there. A mistyped name gets a suggestion: `buton` suggests `button`.
 
@@ -109,16 +111,18 @@ changes. `labsui.json` records which labsui version wrote each item, and
 The base comes from JSR, which keeps every release's files. Offline, with a
 hosted registry, or for items installed before versions were recorded,
 edited files are left as they are. `labsui diff` lists installed items that
-differ from this version; `labsui diff dialog` prints the patch from this
-version's file to yours.
+differ from this version, marking those that differ only in blank lines or
+indentation; `labsui diff dialog` prints the patch from this version's file
+to yours, or says `dialog` isn't installed.
 
 ### `doctor`
 
 Checks the setup and prints a fix for each problem: React 19 and Tailwind v4,
 the path alias and `labsui.json`, the stylesheet import, `MotionProvider` and
 the theme script, `<Toaster />` and `<Confirmer />` mounted when installed,
-missing npm packages or files. It also lists installed items that differ from
-this version, your edits or an older install. Exits with 1 when something is
+missing npm packages, and files your installed components import but the
+project lacks. It also lists installed items that differ from this version,
+your edits or an older install. Exits with 1 when something is
 broken, so it can run in CI.
 
 It reads your code, not a framework's conventions: it works the same in any

package/dist/index.js

@@ -5,7 +5,7 @@ import { resolve as resolve2 } from "node:path";
 import { parseArgs } from "node:util";
 
 // src/commands/add.ts
-import { existsSync as existsSync3, mkdirSync, realpathSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, realpathSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { basename, dirname, isAbsolute, join as join3, relative as relative2, resolve } from "node:path";
 
 // src/install.ts
@@ -62,6 +62,16 @@ function installDeps(cwd, deps, opts) {
   return true;
 }
 
+// src/lines.ts
+var lines = (text) => text.replace(/\r\n/g, `
+`).replace(/\n$/, "").split(`
+`);
+function sameCode(a, b) {
+  const strip = (text) => lines(text).map((line) => line.trim()).filter(Boolean).join(`
+`);
+  return strip(a) === strip(b);
+}
+
 // src/project.ts
 import { existsSync as existsSync2, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { join as join2, relative } from "node:path";
@@ -17811,7 +17821,7 @@ async function fetchAllItems(source) {
 // jsr.json
 var jsr_default = {
   name: "@kznlabs/labsui",
-  version: "0.1.10",
+  version: "0.1.11",
   license: "MIT",
   exports: "./src/index.ts",
   publish: {
@@ -17861,6 +17871,7 @@ async function add(cwd, config, names, opts) {
     fresh: [],
     written: [],
     kept: [],
+    outdated: [],
     packages: [],
     mounts: [],
     dryRun: opts.dryRun
@@ -17897,6 +17908,8 @@ function writeItem(item, base, cwd, config, opts, result, named) {
     if (existsSync3(target) && !opts.overwrite) {
       if (named)
         result.kept.push(shown);
+      else if (!result.outdated.includes(item.name) && !sameCode(readFileSync2(target, "utf8"), rewriteAlias(file.content, config.alias)))
+        result.outdated.push(item.name);
       continue;
     }
     if (!opts.dryRun) {
@@ -17918,6 +17931,8 @@ ${fileList(result.written)}`);
   if (result.kept.length)
     console.log(`${yellow("•")} Kept ${result.kept.length} existing file(s) (--overwrite replaces them):
 ${fileList(result.kept)}`);
+  if (result.outdated.length)
+    console.log(`${yellow("•")} Kept dependencies that differ from this version (older or edited): ${result.outdated.join(", ")}. The new items may need this version: ${bold(`labsui update ${result.outdated.join(" ")}`)}`);
   if (result.installCommand)
     console.log(`${yellow("•")} Install these yourself: ${bold(result.installCommand)}`);
   else if (result.packages.length)
@@ -17932,16 +17947,8 @@ ${bold("Mount once")} in the root layout, inside <MotionProvider>:`);
 }
 
 // src/commands/diff.ts
-import { existsSync as existsSync4, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
 import { relative as relative3 } from "node:path";
-var lines = (text) => text.replace(/\r\n/g, `
-`).replace(/\n$/, "").split(`
-`);
-function sameCode(a, b) {
-  const strip = (text) => lines(text).map((line) => line.trim()).filter(Boolean).join(`
-`);
-  return strip(a) === strip(b);
-}
 function matches(a, b) {
   const out = new Int32Array(a.length).fill(-1);
   let i = 0;
@@ -18016,9 +18023,8 @@ function unifiedDiff(from, to, fromName, toName, context = 3) {
   return out.join(`
 `);
 }
-async function installedItems(config, base) {
-  const all = await fetchAllItems(config.registry);
-  return all.flatMap((item) => {
+async function installedItems(config, base, all) {
+  return (all ?? await fetchAllItems(config.registry)).flatMap((item) => {
     const files = item.files.map((file) => safeTarget(base, file.target ?? file.path));
     return files.some((file) => existsSync4(file)) ? [{ item, files }] : [];
   });
@@ -18026,8 +18032,12 @@ async function installedItems(config, base) {
 async function diff(cwd, config, names, version) {
   const base = projectBase(cwd, config);
   const wanted = new Set(names.map(itemName));
-  const installed = await installedItems(config, base);
-  const out = [];
+  const all = await fetchAllItems(config.registry);
+  const unknown = [...wanted].filter((name) => !all.some((item) => item.name === name));
+  if (unknown.length)
+    throw new CliError(`Unknown item(s): ${unknown.join(", ")}. Search finds the names.`);
+  const installed = await installedItems(config, base, all);
+  const out = [...wanted].filter((name) => !installed.some(({ item }) => item.name === name)).map((name) => ({ name, installed: false, files: [] }));
   for (const { item, files } of installed) {
     if (wanted.size && !wanted.has(item.name))
       continue;
@@ -18038,7 +18048,7 @@ async function diff(cwd, config, names, version) {
         return;
       const shown = relative3(cwd, local).replaceAll("\\", "/");
       const theirs = rewriteAlias(file.content, config.alias);
-      const yours = readFileSync2(local, "utf8");
+      const yours = readFileSync3(local, "utf8");
       const patch = unifiedDiff(theirs, yours, `labsui@${version}/${file.path}`, shown);
       if (!patch)
         return;
@@ -18053,14 +18063,16 @@ async function diff(cwd, config, names, version) {
       });
     });
     if (changed.length)
-      out.push({ name: item.name, files: changed });
+      out.push({ name: item.name, installed: true, files: changed });
   }
   return out;
 }
 function printDiff(items, full) {
   if (!items.length)
     return console.log(`${green("✓")} Installed items match this labsui version.`);
-  for (const item of items)
+  for (const item of items) {
+    if (!item.installed)
+      console.log(`  ${item.name.padEnd(24)} ${dim(`not installed (labsui add ${item.name})`)}`);
     for (const file of item.files) {
       if (!full) {
         console.log(`  ${item.name.padEnd(24)} ${green(`+${file.added}`)} ${red(`-${file.removed}`)}  ${dim(file.path)}${file.formatting ? dim("  (formatting only)") : ""}`);
@@ -18070,13 +18082,14 @@ function printDiff(items, full) {
 `))
         console.log(line.startsWith("+") ? green(line) : line.startsWith("-") ? red(line) : line.startsWith("@@") ? dim(line) : line);
     }
+  }
   if (!full)
     console.log(`
 ${dim("labsui diff <name> shows the changes; add <name> --overwrite takes this version.")}`);
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync2 } from "node:fs";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2 } from "node:fs";
 import { join as join4, relative as relative4 } from "node:path";
 
 // src/merge.ts
@@ -18196,13 +18209,13 @@ async function doctor(cwd, registryFlag) {
   else {
     const css = findCss(cwd, config.root);
     const shown = css && relative4(cwd, css).replaceAll("\\", "/");
-    if (css && readFileSync3(css, "utf8").includes("labsui.css"))
+    if (css && readFileSync4(css, "utf8").includes("labsui.css"))
       add("styles", "pass", `${shown} imports labsui.css`);
     else
       add("styles", "fail", css ? `${shown} does not import labsui.css.` : "No stylesheet imports Tailwind.", 'Run npx @kznlabs/labsui init, or add @import "<path>/styles/labsui.css"; after @import "tailwindcss".');
   }
   const sources = sourceFiles(cwd === base ? cwd : base).concat(cwd === base ? [] : sourceFiles(join4(cwd, "app"))).filter((file) => !owned.has(file));
-  const texts = sources.map((source) => readFileSync3(source, "utf8"));
+  const texts = sources.map((source) => readFileSync4(source, "utf8"));
   const used = (needle) => texts.some((text) => text.includes(needle));
   for (const [needle, label, fix] of [
     [
@@ -18235,18 +18248,23 @@ async function doctor(cwd, registryFlag) {
     add("packages", "fail", `Missing npm packages: ${missing.map(packageName).join(", ")}`, installCommand(cwd, missing).join(" "));
   else if (items.length)
     add("packages", "pass", "npm packages installed");
-  const names = new Set(items.map(({ item }) => item.name));
-  const broken = items.flatMap(({ item }) => (item.registryDependencies ?? []).map((dependency) => dependency.split("/").pop()?.replace(/\.json$/, "") ?? dependency).filter((dependency) => !names.has(dependency)).map((dependency) => `${item.name} → ${dependency}`));
+  const alias = config.alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const local = new RegExp(`from "(?:${alias}((?:components|lib)/[\\w/-]+)|\\./([\\w-]+))"`, "g");
+  const resolves = (path) => [".ts", ".tsx"].some((ext) => existsSync5(path + ext));
+  const broken = items.flatMap(({ item, files }) => files.filter((file) => existsSync5(file)).flatMap((file) => [...readFileSync4(file, "utf8").matchAll(local)].flatMap(([, fromAlias, sibling]) => {
+    const path = fromAlias ? join4(base, fromAlias) : join4(file, "..", sibling ?? "");
+    return resolves(path) ? [] : [`${item.name} → ${path.split(/[\\/]/).pop()}`];
+  })));
   if (broken.length)
     add("files", "fail", `Missing files: ${broken.join(", ")}`, `npx @kznlabs/labsui add ${[...new Set(broken.map((line) => line.split(" → ")[1]))].join(" ")}`);
-  const unresolved = items.flatMap(({ files }) => files).filter((file) => existsSync5(file) && hasConflictMarkers(readFileSync3(file, "utf8"))).map((file) => relative4(cwd, file).replaceAll("\\", "/"));
+  const unresolved = items.flatMap(({ files }) => files).filter((file) => existsSync5(file) && hasConflictMarkers(readFileSync4(file, "utf8"))).map((file) => relative4(cwd, file).replaceAll("\\", "/"));
   if (unresolved.length)
     add("merge", "fail", `Unresolved update conflicts in ${unresolved.join(", ")}`, "Pick between the <<<<<<< yours and >>>>>>> labsui sides, then delete the markers.");
   const drift = (code) => items.filter(({ item, files }) => item.files.some((file, i) => {
     const local = files[i];
     if (!local || !existsSync5(local))
       return false;
-    const yours = readFileSync3(local, "utf8");
+    const yours = readFileSync4(local, "utf8");
     const theirs = rewriteAlias(file.content, config.alias);
     const norm = (text) => text.replace(/\r\n/g, `
 `).trimEnd();
@@ -18281,7 +18299,7 @@ ${result.ok ? green(bold("Setup OK")) : red(bold(`${fails} problem(s)`))}${warns
 }
 
 // src/commands/init.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
 import { dirname as dirname2, join as join5, relative as relative5 } from "node:path";
 function missingPeers(cwd, warnings) {
   const pkg = readPackage(cwd);
@@ -18304,7 +18322,7 @@ function wireStylesheet(cwd, root, opts, warnings) {
   let spec = relative5(dirname2(css), join5(cwd, root, "styles/labsui.css")).replaceAll("\\", "/");
   if (!spec.startsWith("."))
     spec = `./${spec}`;
-  const text = readFileSync4(css, "utf8");
+  const text = readFileSync5(css, "utf8");
   const clashes = [
     ...new Set([
       ...text.matchAll(/(--(?:background|foreground|primary|border|radius))\s*:|(font-family)\s*:/g)
@@ -18475,7 +18493,7 @@ ${dim(`labsui view ${hits[0]?.name} shows props and an example.`)}`);
 }
 
 // src/commands/update.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname3, relative as relative6 } from "node:path";
 var jsrBase = async (version) => {
   try {
@@ -18505,7 +18523,7 @@ async function update(cwd, config, names, opts, loadBase = jsrBase) {
   for (const { item, files } of installed) {
     const shown = (file) => relative6(cwd, file).replaceAll("\\", "/");
     const next = item.files.map((file) => norm(rewriteAlias(file.content, config.alias)));
-    const local = files.map((file) => existsSync6(file) ? norm(readFileSync5(file, "utf8")) : undefined);
+    const local = files.map((file) => existsSync6(file) ? norm(readFileSync6(file, "utf8")) : undefined);
     if (local.every((line, i) => line === next[i])) {
       items.push({ name: item.name, status: "current", files: [], conflicts: 0 });
       continue;
@@ -18783,7 +18801,7 @@ var TOOLS = [
   {
     name: "add",
     title: "Add labsUI items",
-    description: "Install labsUI items into the project: copies each item and everything it imports, then installs their npm packages. Existing files are kept, never overwritten. Returns the files written, the packages installed and anything to mount once in the root layout. Needs init first; dryRun previews. To bring installed items to a newer version, use update instead.",
+    description: "Install labsUI items into the project: copies each item and everything it imports, then installs their npm packages. Existing files are kept, never overwritten. Returns the files written, the packages installed, dependencies kept that differ from this version (call update on them) and anything to mount once in the root layout. Needs init first; dryRun previews. To bring installed items to a newer version, use update instead.",
     inputSchema: {
       type: "object",
       properties: { names, dryRun },
@@ -18804,7 +18822,7 @@ var TOOLS = [
   {
     name: "diff",
     title: "Diff installed labsUI items",
-    description: "Compare installed labsUI items with this labsUI version. Returns a unified patch per changed file, from the registry file to the project file (+ lines exist only in the project), with formatting: true when only blank lines or indentation differ; matching items are left out, and when nothing differs it says so. Use it to see local edits before update. Needs init.",
+    description: "Compare installed labsUI items with this labsUI version. Returns a unified patch per changed file, from the registry file to the project file (+ lines exist only in the project), with formatting: true when only blank lines or indentation differ; matching items are left out, a named item that isn't installed comes back with installed: false, and when nothing differs it says so. Use it to see local edits before update. Needs init.",
     inputSchema: {
       type: "object",
       properties: { names: installed }
@@ -18866,6 +18884,9 @@ async function callTool(ctx, name, args) {
       const lines = [
         `${added.dryRun ? "Would write" : "Wrote"} ${added.written.length} file(s)${added.written.length ? `: ${added.written.join(", ")}` : ""}.`,
         ...added.kept.length ? [`Kept existing: ${added.kept.join(", ")}.`] : [],
+        ...added.outdated.length ? [
+          `Dependencies already here differ from this version (older or edited): ${added.outdated.join(", ")}. The new items may not compile against them; call update with these names.`
+        ] : [],
         ...added.installCommand ? [`Install: ${added.installCommand}`] : added.packages.length ? [`Installed ${added.packages.join(", ")}.`] : [],
         ...added.mounts.map((mount) => `Mount once in the root layout, inside <MotionProvider>: ${mount.tag} from "${mount.from}".`)
       ];
@@ -18890,9 +18911,9 @@ async function callTool(ctx, name, args) {
       if (!config)
         throw new CliError("labsUI is not set up here. Call the init tool first.");
       const items = await diff(ctx.cwd, { ...config, ...ctx.registry && { registry: ctx.registry } }, list(args.names), ctx.version);
-      const body = items.length ? items.flatMap((i) => i.files.map((file) => `\`\`\`diff
+      const body = items.length ? items.flatMap((i) => i.installed ? i.files.map((file) => `\`\`\`diff
 ${file.patch}
-\`\`\``)).join(`
+\`\`\``) : [`${i.name} is not installed; add installs it.`]).join(`
 
 `) : "Installed items match this labsui version.";
       return text(body, { items });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kznlabs/labsui",
-	"version": "0.1.10",
+	"version": "0.1.11",
 	"description": "Add labsUI components to your React + Tailwind v4 project: clean primitives you own, with smooth spring motion.",
 	"type": "module",
 	"mcpName": "io.github.kznlabs/labsui",