@dalexto/lexsys-cli 0.0.3 → 0.0.4

package/README.md

@@ -5,6 +5,7 @@
 **Source of truth for:** Package role, command surface, core module boundaries
 **Full CLI reference:** [docs/reference/cli/CLI.md](../../docs/reference/cli/CLI.md)
 **Verified against:** `packages/cli/src/`
+**Last reviewed:** 2026-05-30
 
 ---
 
@@ -50,8 +51,9 @@ Installed via `npm install -g lexsys` or run directly with `pnpm exec lexsys`.
 | `lexsys init next [directory]` | Scaffold a new Next.js App Router consumer (pinned Next.js 15.3.3)          |
 | `lexsys add <component>`       | Install one or more components into the consumer project                    |
 | `lexsys update [component]`    | Update installed components; `--sync`, `--utilities`, `--styles`, `--force` |
+| `lexsys reset [component]`     | Restore components from registry templates (backup + overwrite)             |
 | `lexsys list`                  | List available registry components                                          |
-| `lexsys status`                | Show installed component versions vs registry versions                      |
+| `lexsys status`                | Show installed components and template drift vs registry                    |
 | `lexsys doctor`                | Check project health and config validity                                    |
 | `lexsys config`                | Read or modify `lexsys.config.json`                                         |
 | `lexsys registry`              | Inspect the active registry source                                          |
@@ -69,20 +71,11 @@ Installed via `npm install -g lexsys` or run directly with `pnpm exec lexsys`.
 
 ---
 
-## Core Modules
-
-| Module                      | Role                                                                        |
-| --------------------------- | --------------------------------------------------------------------------- |
-| `core/config.ts`            | Read/write `lexsys.config.json`; defines `LexsysConfig` schema and defaults |
-| `core/installer.ts`         | File copy, conflict detection, idempotent installs                          |
-| `core/registry-provider.ts` | Selects local vs remote registry source                                     |
-| `core/registry-resolver.ts` | Resolves registry items, utilities, and styles from active registry         |
-| `core/tailwind-setup.ts`    | Detects and wires Tailwind v4 CSS entrypoint                                |
-| `core/vite-scaffold.ts`     | Detects and patches Vite config for Tailwind plugin                         |
-| `core/package-manager.ts`   | Detects npm/pnpm/yarn and runs installs                                     |
-| `core/context.ts`           | Process-level `cwd` override via `--cwd` flag                               |
-| `core/flags.ts`             | Shared flag parsing utilities                                               |
-| `core/cli-error.ts`         | Typed CLI error class and top-level error handler                           |
+## Source layout
+
+Domain modules under `packages/cli/src/`: `config/`, `install/`, `registry/`,
+`commands/`, `scaffold/`, `utils/`. Command behavior and config schema:
+[docs/reference/cli/CLI.md](../../docs/reference/cli/CLI.md).
 
 ---
 

package/dist/commands/reset.d.ts

@@ -0,0 +1 @@
+export declare const runReset: (args: string[]) => Promise<void>;

package/dist/config/config.d.ts

@@ -15,7 +15,7 @@ export interface LexsysConfig {
     paths: LexsysPathsConfig;
     aliases: LexsysAliasesConfig;
     tailwind: LexsysTailwindConfig;
-    installed?: Record<string, string>;
+    installed?: string[];
     registryUrl?: string | null;
 }
 export interface LexsysTailwindConfig {

package/dist/config/installed.d.ts

@@ -0,0 +1,6 @@
+export declare const isLegacyInstalledRecord: (value: unknown) => boolean;
+export declare const normalizeInstalled: (value: unknown) => string[];
+export declare const isInstalled: (installed: string[], name: string) => boolean;
+export declare const addInstalled: (installed: string[], itemName: string) => string[];
+export declare const removeInstalled: (installed: string[], itemName: string) => string[];
+export declare const findInstalledKey: (installed: string[], name: string) => string | undefined;

package/dist/index.js

@@ -37,6 +37,38 @@ var handleCliError = (error) => {
   }
   process.exit(1);
 };
+
+// src/config/installed.ts
+var isLegacyInstalledRecord = (value) => {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+};
+var normalizeInstalled = (value) => {
+  if (Array.isArray(value)) {
+    return value.filter((entry) => typeof entry === "string");
+  }
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return Object.keys(value);
+  }
+  return [];
+};
+var isInstalled = (installed, name) => {
+  const normalized = name.toLowerCase();
+  return installed.some((entry) => entry.toLowerCase() === normalized);
+};
+var addInstalled = (installed, itemName) => {
+  if (isInstalled(installed, itemName)) {
+    return installed;
+  }
+  return [...installed, itemName];
+};
+var removeInstalled = (installed, itemName) => {
+  const normalized = itemName.toLowerCase();
+  return installed.filter((entry) => entry.toLowerCase() !== normalized);
+};
+var findInstalledKey = (installed, name) => {
+  const normalized = name.toLowerCase();
+  return installed.find((entry) => entry.toLowerCase() === normalized);
+};
 var hashContent = (content) => {
   return createHash("sha256").update(content, "utf-8").digest("hex");
 };
@@ -98,7 +130,7 @@ var defaultConfig = {
   paths: defaultPathsConfig,
   aliases: defaultAliasesConfig,
   tailwind: defaultTailwindConfig,
-  installed: {},
+  installed: [],
   registryUrl: null
 };
 var getConfigPath = () => {
@@ -111,7 +143,7 @@ var loadConfig = async () => {
   }
   const content = await readFile(configPath, "utf-8");
   const parsed = JSON.parse(content);
-  return {
+  const config = {
     ...defaultConfig,
     ...parsed,
     paths: {
@@ -125,8 +157,13 @@ var loadConfig = async () => {
     tailwind: {
       ...defaultTailwindConfig,
       ...parsed.tailwind
-    }
+    },
+    installed: normalizeInstalled(parsed.installed)
   };
+  if (isLegacyInstalledRecord(parsed.installed)) {
+    await saveConfig(config);
+  }
+  return config;
 };
 var saveConfig = async (config) => {
   const configPath = getConfigPath();
@@ -738,7 +775,7 @@ var isRegistryItem = (value) => {
     return false;
   }
   const item = value;
-  return typeof item.name === "string" && typeof item.canonicalName === "string" && typeof item.version === "string" && typeof item.type === "string" && typeof item.category === "string" && Array.isArray(item.aliases) && isStringArray(item.files) && isStringArray(item.dependencies) && isStringArray(item.registryDependencies) && isStringArray(item.utilities) && isStringArray(item.styles) && typeof item.target === "string";
+  return typeof item.name === "string" && typeof item.canonicalName === "string" && typeof item.type === "string" && typeof item.category === "string" && Array.isArray(item.aliases) && isStringArray(item.files) && isStringArray(item.dependencies) && isStringArray(item.registryDependencies) && isStringArray(item.utilities) && isStringArray(item.styles) && typeof item.target === "string";
 };
 var findInvalidRegistryItemIndex = (items) => {
   return items.findIndex((item) => {
@@ -1106,7 +1143,7 @@ var runAdd = async (args2) => {
     console.log("Dry run: no files or dependencies will be changed.\n");
     console.log("Components:");
     for (const item of resolvedItems) {
-      console.log(`- ${item.canonicalName} v${item.version}`);
+      console.log(`- ${item.canonicalName}`);
     }
     console.log("\nDependencies:");
     for (const dependency of dependencies) {
@@ -1145,11 +1182,9 @@ var runAdd = async (args2) => {
     }
     console.log("");
   }
-  const installed = {
-    ...config.installed ?? {}
-  };
+  let installed = [...config.installed ?? []];
   for (const item of successfullyInstalled) {
-    installed[item.name] = item.version;
+    installed = addInstalled(installed, item.name);
   }
   await saveConfig({
     ...config,
@@ -1253,13 +1288,13 @@ var runDoctor = async (options = {}) => {
   if (registryFailed && options.noFallback) {
     return;
   }
-  const installed = config.installed ?? {};
-  if (Object.keys(installed).length) {
+  const installed = config.installed ?? [];
+  if (installed.length) {
     console.log("\nTracked components:");
-    for (const [name, version] of Object.entries(installed)) {
+    for (const name of installed) {
       const item = await findItem(name);
       if (!item) {
-        console.log(`\xD7 ${name} v${version} (missing from registry)`);
+        console.log(`\xD7 ${name} (missing from registry)`);
         continue;
       }
       const componentPath = join(
@@ -1268,9 +1303,7 @@ var runDoctor = async (options = {}) => {
       );
       const exists = await fileExists(componentPath);
       const layer = getInstallLayer(item) ?? "unknown";
-      console.log(
-        `${exists ? "\u2713" : "\xD7"} ${item.canonicalName} v${version} (${layer})`
-      );
+      console.log(`${exists ? "\u2713" : "\xD7"} ${item.canonicalName} (${layer})`);
     }
   }
 };
@@ -1324,7 +1357,7 @@ Options
   --all, -a           Update all tracked components
   --styles, -S        Update generated token/theme CSS files
   --utilities, -u     Update shared utility files
-  --sync              Refresh tracked components even when versions match
+  --sync              Refresh tracked components even when templates already match
   --dry-run, -d       Preview update without writing files
   --force, -f         Write conflicted updates after creating backups
   --yes, -y           Auto-confirm safe prompts
@@ -1363,6 +1396,24 @@ Usage
 Options
   --no-fallback       Fail instead of falling back to local registry
   --help, -h          Show this help
+`,
+  reset: `
+Usage
+  lexsys reset [component...]
+
+Options
+  --dry-run, -d       Preview reset without writing files
+  --with-deps, -w     Also reset installed registry dependencies in the closure
+  --no-fallback       Fail instead of falling back to local registry
+  --cwd, -C <path>    Run from a different project directory
+  --help, -h          Show this help
+
+  Run without arguments for guided reset picker.
+
+Examples
+  lexsys reset button
+  lexsys reset sidebar --with-deps
+  lexsys reset button --dry-run
 `,
   uninstall: `
 Usage
@@ -1445,6 +1496,7 @@ Scaffold
 Components
   add <component...>        Install components into your project       [alias: a]
   update [component...]     Update installed components                [alias: up]
+  reset [component...]      Restore components from registry templates
   uninstall [component...]  Remove installed components                [alias: rm]
 
 Inspect
@@ -2387,7 +2439,6 @@ var runList = async (options = {}) => {
       const simplified = registryItems3.map((item) => ({
         name: item.name,
         canonicalName: item.canonicalName,
-        version: item.version,
         category: item.category,
         layer: getInstallLayer(item)
       }));
@@ -2409,9 +2460,7 @@ var runList = async (options = {}) => {
       }
       console.log(`${layerLabels[layer] ?? layer}:`);
       for (const item of items) {
-        console.log(
-          `- ${item.canonicalName} v${item.version} (${item.category})`
-        );
+        console.log(`- ${item.canonicalName} (${item.category})`);
       }
       console.log("");
     }
@@ -2435,7 +2484,7 @@ var printRegistrySummary = (result) => {
   for (const item of result.items) {
     const remoteFileCount = item.remoteFiles?.length ?? 0;
     console.log(
-      `- ${item.canonicalName} v${item.version} (${item.type}/${item.category}, remote files: ${remoteFileCount})`
+      `- ${item.canonicalName} (${item.type}/${item.category}, remote files: ${remoteFileCount})`
     );
   }
 };
@@ -2521,12 +2570,43 @@ var runRegistry = async (options = {}) => {
     process.exitCode = 1;
   }
 };
+var getComponentDriftStatus = async (name) => {
+  const item = await findItem(name);
+  if (!item) {
+    return "missing";
+  }
+  const hasDrift = await itemHasTemplateDrift(item);
+  return hasDrift ? "drift" : "in-sync";
+};
+var itemHasTemplateDrift = async (item) => {
+  const config = await loadConfig();
+  const installTarget = resolveItemInstallTarget(config, item);
+  for (const file of item.files) {
+    const fileName = file.split("/").at(-1);
+    if (!fileName) {
+      return true;
+    }
+    const targetPath = join(getCwd(), installTarget, fileName);
+    if (!await fileExists(targetPath)) {
+      return true;
+    }
+    const preparedContent = prepareInstalledFileContent(
+      await readFile(getRegistryTemplatePath(file), "utf-8"),
+      item
+    );
+    const targetContent = await readFile(targetPath, "utf-8");
+    if (!hashesAreEqual(preparedContent, targetContent)) {
+      return true;
+    }
+  }
+  return false;
+};
 
 // src/commands/status.ts
 var runStatus = async (options = {}) => {
   const config = await loadConfig();
-  const installed = config.installed ?? {};
-  if (!Object.keys(installed).length) {
+  const installed = config.installed ?? [];
+  if (!installed.length) {
     console.log("No Lexsys components are currently tracked.");
     return;
   }
@@ -2541,14 +2621,15 @@ var runStatus = async (options = {}) => {
     return;
   }
   console.log("Installed Lexsys components:\n");
-  for (const [name, installedVersion] of Object.entries(installed)) {
+  for (const name of installed) {
     const item = await findItem(name);
     if (!item) {
-      console.log(`- ${name} v${installedVersion} (missing from registry)`);
+      console.log(`- ${name} (missing from registry)`);
       continue;
     }
-    const status = item.version === installedVersion ? "up to date" : `update available: v${installedVersion} \u2192 v${item.version}`;
-    console.log(`- ${item.canonicalName} v${installedVersion} (${status})`);
+    const driftStatus = await getComponentDriftStatus(name);
+    const status = driftStatus === "drift" ? "out of sync with registry" : "up to date with registry";
+    console.log(`- ${item.canonicalName} (${status})`);
   }
 };
 
@@ -2573,7 +2654,7 @@ var computeRegistryClosure = (rootNames, items) => {
   return closure;
 };
 var findOrphanInstalledItems = (removedTargetNames, remainingInstalled, items) => {
-  const remainingNames = Object.keys(remainingInstalled);
+  const remainingNames = remainingInstalled;
   const removedDependencyNames = /* @__PURE__ */ new Set();
   for (const removedName of removedTargetNames) {
     const closure = computeRegistryClosure([removedName], items);
@@ -2592,17 +2673,263 @@ var findOrphanInstalledItems = (removedTargetNames, remainingInstalled, items) =
     )
   ).filter((item) => Boolean(item)).filter((item) => removedDependencyNames.has(item.name));
 };
+var checkItemFiles = async (name) => {
+  const item = await findItem(name);
+  const config = await loadConfig();
+  if (!item) {
+    console.log(`Component "${name}" no longer exists in the registry.`);
+    return;
+  }
+  const installTarget = resolveItemInstallTarget(config, item);
+  console.log(`File check for ${item.canonicalName}:`);
+  for (const file of item.files) {
+    const fileName = file.split("/").at(-1);
+    if (!fileName) {
+      console.log(`- invalid registry file path: ${file}`);
+      continue;
+    }
+    const targetPath = join(getCwd(), installTarget, fileName);
+    if (!await fileExists(targetPath)) {
+      console.log(`- missing: ${targetPath}`);
+      continue;
+    }
+    const preparedContent = prepareInstalledFileContent(
+      await readFile(getRegistryTemplatePath(file), "utf-8"),
+      item
+    );
+    const targetContent = await readFile(targetPath, "utf-8");
+    if (hashesAreEqual(preparedContent, targetContent)) {
+      console.log(`- identical: ${targetPath}`);
+      continue;
+    }
+    console.log(`- conflict: ${targetPath}`);
+  }
+};
+var applyItemOverwrite = async (name, force) => {
+  const item = await findItem(name);
+  const config = await loadConfig();
+  if (!item) {
+    console.log(`Component "${name}" no longer exists in the registry.`);
+    return false;
+  }
+  const installTarget = resolveItemInstallTarget(config, item);
+  let hasConflict = false;
+  console.log(`Applying update for ${item.canonicalName}:`);
+  for (const file of item.files) {
+    const sourcePath = getRegistryTemplatePath(file);
+    const fileName = file.split("/").at(-1);
+    if (!fileName) {
+      console.log(`- invalid registry file path: ${file}`);
+      hasConflict = true;
+      continue;
+    }
+    const targetPath = join(getCwd(), installTarget, fileName);
+    const preparedContent = prepareInstalledFileContent(
+      await readFile(sourcePath, "utf-8"),
+      item
+    );
+    await mkdir(dirname(targetPath), { recursive: true });
+    if (!await fileExists(targetPath)) {
+      await writeFile(targetPath, preparedContent, "utf-8");
+      console.log(`- restored missing file: ${targetPath}`);
+      continue;
+    }
+    const targetContent = await readFile(targetPath, "utf-8");
+    if (hashesAreEqual(preparedContent, targetContent)) {
+      console.log(`- identical: ${targetPath}`);
+      continue;
+    }
+    if (force) {
+      const backupPath = await createBackupFile(targetPath);
+      if (backupPath) {
+        console.log(`- backup created: ${backupPath}`);
+      }
+      await writeFile(targetPath, preparedContent, "utf-8");
+      console.log(`- force updated file: ${targetPath}`);
+      continue;
+    }
+    hasConflict = true;
+    console.log(`- conflict (user modified): ${targetPath}`);
+  }
+  if (hasConflict) {
+    console.log(
+      "Update finished with conflicts. Review conflicted files before retrying."
+    );
+    return false;
+  }
+  console.log(`\u2714 ${item.canonicalName} updated successfully`);
+  return true;
+};
+var checkItemUpdate = async (name, dryRun, force, sync = false) => {
+  const item = await findItem(name);
+  if (!item) {
+    console.log(`Component "${name}" no longer exists in the registry.`);
+    return false;
+  }
+  const driftStatus = await getComponentDriftStatus(name);
+  if (driftStatus === "missing") {
+    console.log(`Component "${name}" no longer exists in the registry.`);
+    return false;
+  }
+  const hasDrift = driftStatus === "drift";
+  if (!sync && !hasDrift) {
+    console.log(`${item.canonicalName} is up to date with the registry.`);
+    return false;
+  }
+  if (sync && !hasDrift) {
+    console.log(
+      `${item.canonicalName} template sync (already matches registry)`
+    );
+  } else {
+    console.log(`${item.canonicalName} can be updated from registry templates`);
+  }
+  if (dryRun) {
+    console.log("\nChanged file candidates:");
+    for (const file of item.files) {
+      console.log(`~ ${file}`);
+    }
+    console.log("\nDry run: no files will be changed.");
+    console.log("Update plan:");
+    if (force) {
+      console.log(
+        "- Force mode requested: conflicted files require backup before overwrite"
+      );
+      console.log(
+        "- Dry run: backups would be created before forced overwrites"
+      );
+    }
+    console.log(`- Check installed files for ${item.canonicalName}`);
+    console.log("- Compare existing files with registry templates");
+    console.log("- Report conflicts before writing changes");
+    console.log("- Never overwrite user-modified files silently");
+    await checkItemFiles(name);
+    return false;
+  }
+  return await applyItemOverwrite(name, force);
+};
+var resetItem = async (name, dryRun) => {
+  const item = await findItem(name);
+  if (!item) {
+    console.log(`Component "${name}" no longer exists in the registry.`);
+    return false;
+  }
+  const hasDrift = await itemHasTemplateDrift(item);
+  if (!hasDrift) {
+    console.log(`${item.canonicalName} already matches registry templates.`);
+    return false;
+  }
+  if (dryRun) {
+    console.log(`Reset plan for ${item.canonicalName}:`);
+    console.log("- Backups would be created before overwriting changed files");
+    console.log("- Files would be restored from registry templates");
+    for (const file of item.files) {
+      console.log(`~ ${file}`);
+    }
+    console.log("\nDry run: no files will be changed.");
+    await checkItemFiles(name);
+    return false;
+  }
+  return await applyItemOverwrite(name, true);
+};
 
-// src/commands/uninstall.ts
-var normalizeInstalledKey = (name) => {
-  return name.toLowerCase();
+// src/commands/reset.ts
+var resolveInstalledKey = async (name, installed) => {
+  const direct = findInstalledKey(installed, name);
+  if (direct) {
+    return direct;
+  }
+  const item = await findItem(name);
+  if (!item) {
+    return void 0;
+  }
+  return findInstalledKey(installed, item.name);
+};
+var runReset = async (args2) => {
+  const dryRun = hasFlag(args2, "--dry-run", "-d");
+  const withDeps = hasFlag(args2, "--with-deps", "-w");
+  const noFallback = hasFlag(args2, "--no-fallback");
+  const targetArgs = removeFlagsWithValues(
+    removeFlags(args2, [
+      "--dry-run",
+      "-d",
+      "--with-deps",
+      "-w",
+      "--no-fallback"
+    ]),
+    ["--cwd", "-C"]
+  );
+  const config = await loadConfig();
+  const installed = [...config.installed ?? []];
+  if (!installed.length) {
+    console.log("No components installed.");
+    return;
+  }
+  try {
+    await getRegistryProviderResult({
+      fallback: !noFallback
+    });
+  } catch (error) {
+    console.log("Failed to resolve registry.");
+    console.log(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+    return;
+  }
+  if (!targetArgs.length) {
+    const selected = await promptMultiselect(
+      "Select components to reset",
+      installed.map((name) => ({ title: name, value: name })),
+      { min: 1 }
+    );
+    if (!selected.length) return;
+    targetArgs.push(...selected);
+  }
+  const resetNames = /* @__PURE__ */ new Set();
+  for (const name of targetArgs) {
+    const installedKey = await resolveInstalledKey(name, installed);
+    if (!installedKey) {
+      console.log(`Component "${name}" is not tracked as installed.`);
+      continue;
+    }
+    resetNames.add(installedKey);
+  }
+  if (!resetNames.size) {
+    console.log("No installed components matched the request.");
+    return;
+  }
+  if (withDeps) {
+    const allItems = await getRegistryItems({ fallback: !noFallback });
+    for (const rootName of [...resetNames]) {
+      const closure = computeRegistryClosure([rootName], allItems);
+      for (const dependencyName of closure) {
+        if (isInstalled(installed, dependencyName)) {
+          resetNames.add(dependencyName);
+        }
+      }
+    }
+  }
+  const resetItems = await resolveRegistryItems([...resetNames], {
+    fallback: !noFallback
+  });
+  if (dryRun) {
+    console.log("Dry run: no files will be changed.\n");
+    console.log("Components:");
+    for (const item of resetItems) {
+      console.log(`- ${item.canonicalName}`);
+    }
+    console.log("");
+  }
+  for (const item of resetItems) {
+    await resetItem(item.name, dryRun);
+    console.log("");
+  }
 };
+
+// src/commands/uninstall.ts
 var resolveInstalledItems = async (installed) => {
-  const names = Object.keys(installed);
-  if (!names.length) {
+  if (!installed.length) {
     return [];
   }
-  return resolveRegistryItems(names);
+  return resolveRegistryItems(installed);
 };
 var collectOrphanedSharedResources = (removedItems, remainingItems) => {
   const removedUtilities = collectUtilities(removedItems);
@@ -2618,14 +2945,6 @@ var collectOrphanedSharedResources = (removedItems, remainingItems) => {
     })
   };
 };
-var removeInstalledKey = (installed, itemName) => {
-  const installedKey = Object.keys(installed).find((key) => {
-    return normalizeInstalledKey(key) === normalizeInstalledKey(itemName);
-  });
-  if (installedKey) {
-    delete installed[installedKey];
-  }
-};
 var runUninstall = async (args2) => {
   const dryRun = hasFlag(args2, "--dry-run", "-d");
   const withDeps = hasFlag(args2, "--with-deps", "-w");
@@ -2642,7 +2961,7 @@ var runUninstall = async (args2) => {
   );
   if (!targetArgs.length) {
     const preConfig = await loadConfig();
-    const installedNames = Object.keys(preConfig.installed ?? {});
+    const installedNames = preConfig.installed ?? [];
     if (installedNames.length === 0) {
       console.log("No components installed.");
       return;
@@ -2656,7 +2975,7 @@ var runUninstall = async (args2) => {
     targetArgs.push(...selected);
   }
   const config = await loadConfig();
-  const installed = config.installed ?? {};
+  const installed = [...config.installed ?? []];
   const resolvedTargets = [];
   const notTracked = [];
   for (const name of targetArgs) {
@@ -2665,10 +2984,7 @@ var runUninstall = async (args2) => {
       console.log(`Component "${name}" not found in registry.`);
       continue;
     }
-    const installedKey = Object.keys(installed).find((key) => {
-      return normalizeInstalledKey(key) === normalizeInstalledKey(item.name);
-    });
-    if (!installedKey) {
+    if (!isInstalled(installed, item.name)) {
       notTracked.push(name);
       console.log(`Component "${name}" is not tracked as installed.`);
       continue;
@@ -2681,10 +2997,11 @@ var runUninstall = async (args2) => {
     }
     return;
   }
-  const remainingInstalled = { ...installed };
-  for (const item of resolvedTargets) {
-    removeInstalledKey(remainingInstalled, item.name);
-  }
+  const remainingInstalled = installed.filter((entry) => {
+    return !resolvedTargets.some((item) => {
+      return findInstalledKey([entry], item.name) !== void 0;
+    });
+  });
   const allItems = await getRegistryItems({ fallback: !noFallback });
   const orphanItems = withDeps ? findOrphanInstalledItems(
     resolvedTargets.map((item) => item.name),
@@ -2706,9 +3023,7 @@ var runUninstall = async (args2) => {
     console.log("Dry run: no files will be removed.\n");
     console.log("Components:");
     for (const item of resolvedTargets) {
-      console.log(
-        `- ${item.canonicalName} v${installed[item.name] ?? "unknown"}`
-      );
+      console.log(`- ${item.canonicalName}`);
     }
     if (withDeps && orphanItems.length) {
       console.log("\nOrphan registry items (--with-deps):");
@@ -2724,10 +3039,12 @@ var runUninstall = async (args2) => {
         console.log(`- ${item.canonicalName}`);
       }
     }
-    const postOrphanRemaining = { ...remainingInstalled };
-    for (const item of withDeps ? orphanItems : []) {
-      removeInstalledKey(postOrphanRemaining, item.name);
-    }
+    const postOrphanRemaining = remainingInstalled.filter((entry) => {
+      if (!withDeps) {
+        return true;
+      }
+      return !orphanItems.some((item) => isInstalled([entry], item.name));
+    });
     const dryRunOrphans = collectOrphanedSharedResources(
       allRemovalTargets,
       await resolveInstalledItems(postOrphanRemaining)
@@ -2761,11 +3078,11 @@ var runUninstall = async (args2) => {
     }
     console.log("");
   }
-  const postUninstallInstalled = { ...installed };
+  let updatedInstalled = [...installed];
   for (const item of successfullyUninstalled) {
-    removeInstalledKey(postUninstallInstalled, item.name);
+    updatedInstalled = removeInstalled(updatedInstalled, item.name);
   }
-  const remainingItems = await resolveInstalledItems(postUninstallInstalled);
+  const remainingItems = await resolveInstalledItems(updatedInstalled);
   const orphanedResources = collectOrphanedSharedResources(
     successfullyUninstalled,
     remainingItems
@@ -2785,12 +3102,6 @@ var runUninstall = async (args2) => {
   }
   const utilitiesResult = await uninstallUtilities(resolvedUtilities, config);
   const stylesResult = await uninstallStyles(resolvedStyles, config);
-  const updatedInstalled = {
-    ...installed
-  };
-  for (const item of successfullyUninstalled) {
-    removeInstalledKey(updatedInstalled, item.name);
-  }
   await saveConfig({
     ...config,
     installed: updatedInstalled
@@ -2810,172 +3121,18 @@ var runUninstall = async (args2) => {
   }
 };
 
-// src/utils/version.ts
-var compareVersions = (a, b) => {
-  const pa = a.split(".").map(Number);
-  const pb = b.split(".").map(Number);
-  const length = Math.max(pa.length, pb.length);
-  for (let i = 0; i < length; i++) {
-    const va = pa[i] ?? 0;
-    const vb = pb[i] ?? 0;
-    if (va > vb) return 1;
-    if (va < vb) return -1;
-  }
-  return 0;
-};
-var isUpdateAvailable = (installed, latest) => {
-  return compareVersions(latest, installed) === 1;
-};
-
-// src/install/update-engine.ts
-var checkItemFiles = async (name) => {
-  const item = await findItem(name);
-  const config = await loadConfig();
-  if (!item) {
-    console.log(`Component "${name}" no longer exists in the registry.`);
-    return;
-  }
-  const installTarget = resolveItemInstallTarget(config, item);
-  console.log(`File check for ${item.canonicalName}:`);
-  for (const file of item.files) {
-    const fileName = file.split("/").at(-1);
-    if (!fileName) {
-      console.log(`- invalid registry file path: ${file}`);
-      continue;
-    }
-    const targetPath = join(getCwd(), installTarget, fileName);
-    if (!await fileExists(targetPath)) {
-      console.log(`- missing: ${targetPath}`);
-      continue;
-    }
-    const preparedContent = prepareInstalledFileContent(
-      await readFile(getRegistryTemplatePath(file), "utf-8"),
-      item
-    );
-    const targetContent = await readFile(targetPath, "utf-8");
-    if (hashesAreEqual(preparedContent, targetContent)) {
-      console.log(`- identical: ${targetPath}`);
-      continue;
-    }
-    console.log(`- conflict: ${targetPath}`);
-  }
-};
-var applySafeItemUpdate = async (name, force) => {
-  const item = await findItem(name);
-  const config = await loadConfig();
-  if (!item) {
-    console.log(`Component "${name}" no longer exists in the registry.`);
-    return false;
-  }
-  const installTarget = resolveItemInstallTarget(config, item);
-  let hasConflict = false;
-  console.log(`Applying update for ${item.canonicalName}:`);
-  for (const file of item.files) {
-    const sourcePath = getRegistryTemplatePath(file);
-    const fileName = file.split("/").at(-1);
-    if (!fileName) {
-      console.log(`- invalid registry file path: ${file}`);
-      hasConflict = true;
-      continue;
-    }
-    const targetPath = join(getCwd(), installTarget, fileName);
-    const preparedContent = prepareInstalledFileContent(
-      await readFile(sourcePath, "utf-8"),
-      item
-    );
-    await mkdir(dirname(targetPath), { recursive: true });
-    if (!await fileExists(targetPath)) {
-      await writeFile(targetPath, preparedContent, "utf-8");
-      console.log(`- restored missing file: ${targetPath}`);
-      continue;
-    }
-    const targetContent = await readFile(targetPath, "utf-8");
-    if (hashesAreEqual(preparedContent, targetContent)) {
-      console.log(`- identical: ${targetPath}`);
-      continue;
-    }
-    if (force) {
-      const backupPath = await createBackupFile(targetPath);
-      if (backupPath) {
-        console.log(`- backup created: ${backupPath}`);
-      }
-      await writeFile(targetPath, preparedContent, "utf-8");
-      console.log(`- force updated file: ${targetPath}`);
-      continue;
-    }
-    hasConflict = true;
-    console.log(`- conflict (user modified): ${targetPath}`);
-  }
-  if (hasConflict) {
-    console.log(
-      "Update finished with conflicts. Installed version was not changed."
-    );
-    return false;
-  }
-  console.log(
-    `\u2714 ${item.canonicalName} updated successfully to v${item.version}`
-  );
-  return true;
-};
-var checkItemUpdate = async (name, installedVersion, dryRun, force, sync = false) => {
-  const item = await findItem(name);
-  if (!item) {
-    console.log(`Component "${name}" no longer exists in the registry.`);
-    return false;
-  }
-  const versionUpdateAvailable = isUpdateAvailable(
-    installedVersion,
-    item.version
-  );
-  if (!sync && !versionUpdateAvailable) {
-    console.log(`${item.canonicalName} is up to date (v${installedVersion}).`);
-    return false;
-  }
-  if (sync && !versionUpdateAvailable) {
-    console.log(
-      `${item.canonicalName} template sync (installed v${installedVersion}, registry v${item.version})`
-    );
-  } else {
-    console.log(
-      `${item.canonicalName} can be updated: v${installedVersion} \u2192 v${item.version}`
-    );
-  }
-  if (dryRun) {
-    console.log("\nChanged file candidates:");
-    for (const file of item.files) {
-      console.log(`~ ${file}`);
-    }
-    console.log("\nDry run: no files will be changed.");
-    console.log("Update plan:");
-    if (force) {
-      console.log(
-        "- Force mode requested: conflicted files require backup before overwrite"
-      );
-      console.log(
-        "- Dry run: backups would be created before forced overwrites"
-      );
-    }
-    console.log(`- Check installed files for ${item.canonicalName}`);
-    console.log("- Compare existing files with registry templates");
-    console.log("- Report conflicts before writing changes");
-    console.log("- Never overwrite user-modified files silently");
-    await checkItemFiles(name);
-    return false;
-  }
-  return await applySafeItemUpdate(name, force);
-};
-
 // src/commands/update.ts
 var styleUpdateNames = ["theme"];
-var resolveInstalledKey = async (name, installed) => {
-  if (installed[name]) {
-    return name;
+var resolveInstalledKey2 = async (name, installed) => {
+  const direct = findInstalledKey(installed, name);
+  if (direct) {
+    return direct;
   }
   const item = await findItem(name);
   if (!item) {
     return void 0;
   }
-  return installed[item.name] ? item.name : void 0;
+  return findInstalledKey(installed, item.name);
 };
 var runStylesUpdate = async (config, dryRun) => {
   const styles = resolveRegistryStyles(styleUpdateNames);
@@ -3002,9 +3159,7 @@ Tailwind CSS entrypoint: ${config.tailwind.css}`);
   }
 };
 var runUtilitiesUpdate = async (config, installed, dryRun, force) => {
-  const installedItems = (await Promise.all(
-    Object.keys(installed).map(async (name) => findItem(name))
-  )).filter((item) => Boolean(item));
+  const installedItems = (await Promise.all(installed.map(async (name) => findItem(name)))).filter((item) => Boolean(item));
   const utilityNames = collectUtilities(installedItems);
   if (!utilityNames.length) {
     console.log("No shared utilities are tracked for installed components.");
@@ -3029,26 +3184,18 @@ var runUtilitiesUpdate = async (config, installed, dryRun, force) => {
     );
   }
 };
-var runComponentUpdates = async (config, installed, targetNames, dryRun, force, sync) => {
-  let changed = false;
-  if (!Object.keys(installed).length) {
+var runComponentUpdates = async (installed, targetNames, dryRun, force, sync) => {
+  if (!installed.length) {
     console.log("No Lexsys components are currently tracked.");
-    return false;
+    return;
   }
   console.log("Checking installed Lexsys components:\n");
   for (const name of targetNames) {
-    const version = installed[name];
-    if (!version) {
+    if (!isInstalled(installed, name)) {
       continue;
     }
-    const didUpdate = await checkItemUpdate(name, version, dryRun, force, sync);
-    const item = await findItem(name);
-    if (didUpdate && item) {
-      installed[name] = item.version;
-      changed = true;
-    }
+    await checkItemUpdate(name, dryRun, force, sync);
   }
-  return changed;
 };
 var runUpdate = async (args2) => {
   const dryRun = hasFlag(args2, "--dry-run", "-d");
@@ -3076,7 +3223,7 @@ var runUpdate = async (args2) => {
     "-a"
   ]);
   const config = await loadConfig();
-  const installed = { ...config.installed ?? {} };
+  const installed = [...config.installed ?? []];
   try {
     await getRegistryProviderResult({
       fallback: !noFallback
@@ -3088,19 +3235,18 @@ var runUpdate = async (args2) => {
     return;
   }
   if (!updateAll && !stylesFlag && !utilitiesFlag && targetArgs.length === 0) {
-    const installedNames = Object.keys(installed);
-    if (installedNames.length === 0) {
+    if (installed.length === 0) {
       console.log(
         "No components installed. Run `lexsys add <component>` first."
       );
       return;
     }
     if (yes) {
-      targetArgs.push(...installedNames);
+      targetArgs.push(...installed);
     } else {
       const selected = await promptMultiselect(
         "Select components to update",
-        installedNames.map((name) => ({ title: name, value: name })),
+        installed.map((name) => ({ title: name, value: name })),
         { min: 1 }
       );
       if (!selected.length) return;
@@ -3127,42 +3273,18 @@ var runUpdate = async (args2) => {
   if (!shouldUpdateComponents) {
     return;
   }
-  let changed = false;
   if (updateAll) {
-    changed = await runComponentUpdates(
-      config,
-      installed,
-      Object.keys(installed),
-      dryRun,
-      force,
-      sync
-    );
+    await runComponentUpdates(installed, installed, dryRun, force, sync);
   } else {
     for (const name of targetArgs) {
-      const installedKey = await resolveInstalledKey(name, installed);
+      const installedKey = await resolveInstalledKey2(name, installed);
       if (!installedKey) {
         console.log(`Component "${name}" is not tracked as installed.`);
         continue;
       }
-      const didUpdateOne = await runComponentUpdates(
-        config,
-        installed,
-        [installedKey],
-        dryRun,
-        force,
-        sync
-      );
-      if (didUpdateOne) {
-        changed = true;
-      }
+      await runComponentUpdates(installed, [installedKey], dryRun, force, sync);
     }
   }
-  if (changed) {
-    await saveConfig({
-      ...config,
-      installed
-    });
-  }
 };
 var cliDistDir = dirname(fileURLToPath(import.meta.url));
 var packageJsonPath = join(cliDistDir, "..", "package.json");
@@ -3269,6 +3391,14 @@ try {
     });
     process.exit(0);
   }
+  if (command === "reset") {
+    if (hasFlag(args, "--help", "-h")) {
+      runHelpFor("reset");
+      process.exit(0);
+    }
+    await runReset(args);
+    process.exit(0);
+  }
   if (command === "uninstall" || command === "rm") {
     if (hasFlag(args, "--help", "-h")) {
       runHelpFor("uninstall");

package/dist/install/component-drift.d.ts

@@ -0,0 +1,4 @@
+import type { RegistryItem } from "@dalexto/lexsys-registry";
+export type ComponentDriftStatus = "missing" | "in-sync" | "drift";
+export declare const getComponentDriftStatus: (name: string) => Promise<ComponentDriftStatus>;
+export declare const itemHasTemplateDrift: (item: RegistryItem) => Promise<boolean>;

package/dist/install/update-engine.d.ts

@@ -1,2 +1,4 @@
 export declare const checkItemFiles: (name: string) => Promise<void>;
-export declare const checkItemUpdate: (name: string, installedVersion: string, dryRun: boolean, force: boolean, sync?: boolean) => Promise<boolean>;
+export declare const applyItemOverwrite: (name: string, force: boolean) => Promise<boolean>;
+export declare const checkItemUpdate: (name: string, dryRun: boolean, force: boolean, sync?: boolean) => Promise<boolean>;
+export declare const resetItem: (name: string, dryRun: boolean) => Promise<boolean>;

package/dist/registry/closure.d.ts

@@ -1,3 +1,3 @@
 import type { RegistryItem } from "@dalexto/lexsys-registry";
 export declare const computeRegistryClosure: (rootNames: string[], items: RegistryItem[]) => Set<string>;
-export declare const findOrphanInstalledItems: (removedTargetNames: string[], remainingInstalled: Record<string, string>, items: RegistryItem[]) => RegistryItem[];
+export declare const findOrphanInstalledItems: (removedTargetNames: string[], remainingInstalled: string[], items: RegistryItem[]) => RegistryItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalexto/lexsys-cli",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Registry-first CLI that installs Lexsys React UI components into your project",
   "type": "module",
   "license": "MIT",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "prompts": "^2.4.2",
-    "@dalexto/lexsys-registry": "0.0.3"
+    "@dalexto/lexsys-registry": "0.0.4"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/dist/utils/version.d.ts

@@ -1,2 +0,0 @@
-export declare const compareVersions: (a: string, b: string) => number;
-export declare const isUpdateAvailable: (installed: string, latest: string) => boolean;