formalconf 2.0.19 → 2.0.20

package/README.md

@@ -295,6 +295,11 @@ bun run theme <name>:<variant>  # Apply a theme (e.g., catppuccin:dark, tokyo-ni
 bun run theme --install-templates  # Install/update default templates
 bun run theme --template-status    # Check template versions
 bun run theme --migrate <name>     # Migrate legacy theme to JSON format
+bun run template update --all   # Update all templates (persists mode metadata)
+bun run template list           # List installed templates with their type
+bun run template check          # Check for available template updates
+bun run template lock <name>    # Lock a template from updates
+bun run template unlock <name>  # Unlock a template for updates
 bun run typecheck               # Run TypeScript type checking
 ```
 
@@ -303,10 +308,11 @@ bun run typecheck               # Run TypeScript type checking
 ```
 src/
 ├── cli/              # Entry points (run directly with bun)
-│   ├── formalconf.tsx    # Main TUI app
-│   ├── config-manager.ts # Stow operations
-│   ├── pkg-sync.ts       # Homebrew/MAS sync
-│   └── set-theme.ts      # Theme switching
+│   ├── formalconf.tsx       # Main TUI app
+│   ├── config-manager.ts    # Stow operations
+│   ├── pkg-sync.ts          # Homebrew/MAS sync
+│   ├── set-theme.ts         # Theme switching
+│   └── template-manager.ts  # Template management
 ├── components/       # Ink React components
 │   ├── layout/           # Layout primitives (Panel, Breadcrumb, Footer)
 │   └── ui/               # UI elements (StatusIndicator, Divider)

package/dist/formalconf.js

@@ -4181,7 +4181,8 @@ async function installTemplate(templateName) {
   manifest.templates[templateName] = {
     version: bundledMeta.version,
     installedAt: new Date().toISOString(),
-    customOverride: false
+    customOverride: false,
+    mode: bundledMeta.mode
   };
   await saveTemplatesManifest(manifest);
 }
@@ -4191,11 +4192,32 @@ async function installAllTemplates() {
     await installTemplate(name);
   }
 }
+async function lockTemplate(templateName) {
+  const manifest = await loadTemplatesManifest();
+  if (!manifest.templates[templateName]) {
+    throw new Error(`Template '${templateName}' is not installed`);
+  }
+  manifest.templates[templateName].customOverride = true;
+  await saveTemplatesManifest(manifest);
+}
+async function unlockTemplate(templateName) {
+  const manifest = await loadTemplatesManifest();
+  if (!manifest.templates[templateName]) {
+    throw new Error(`Template '${templateName}' is not installed`);
+  }
+  manifest.templates[templateName].customOverride = false;
+  await saveTemplatesManifest(manifest);
+}
 async function getTemplateType(filename) {
-  const manifest = await loadBundledManifest();
-  const meta = manifest.templates[filename];
-  if (meta?.mode) {
-    return meta.mode;
+  const installed = await loadTemplatesManifest();
+  const installedMeta = installed.templates[filename];
+  if (installedMeta?.mode) {
+    return installedMeta.mode;
+  }
+  const bundled = await loadBundledManifest();
+  const bundledMeta = bundled.templates[filename];
+  if (bundledMeta?.mode) {
+    return bundledMeta.mode;
   }
   if (filename.includes("-dark.") || filename.includes("-light.")) {
     return "partial";
@@ -5410,8 +5432,136 @@ var init_set_theme = __esm(() => {
   }
 });
 
+// src/cli/template-manager.ts
+var exports_template_manager = {};
+__export(exports_template_manager, {
+  main: () => main5
+});
+import { parseArgs as parseArgs5 } from "util";
+function printHelp() {
+  console.log(`
+${colors6.cyan}Template Manager - Manage formalconf templates${colors6.reset}
+
+Usage:
+  formalconf template <command> [options]
+
+Commands:
+  ${colors6.blue}update${colors6.reset} [name]    Update templates (all if no name specified)
+  ${colors6.blue}list${colors6.reset}             List installed templates
+  ${colors6.blue}check${colors6.reset}            Check for available updates
+  ${colors6.blue}lock${colors6.reset} <name>      Lock a template from updates
+  ${colors6.blue}unlock${colors6.reset} <name>    Unlock a template for updates
+
+Options:
+  -h, --help       Show this help message
+  --all            Update all templates (with update command)
+
+Examples:
+  formalconf template update --all
+  formalconf template check
+  formalconf template lock neovim.lua.template
+`);
+}
+async function main5() {
+  const { positionals, values } = parseArgs5({
+    args: process.argv.slice(2),
+    options: {
+      help: { type: "boolean", short: "h" },
+      all: { type: "boolean" }
+    },
+    allowPositionals: true,
+    strict: false
+  });
+  const [subCommand, ...args] = positionals;
+  if (values.help || !subCommand) {
+    printHelp();
+    process.exit(0);
+  }
+  switch (subCommand) {
+    case "update":
+      await handleUpdate(args[0], values.all);
+      break;
+    case "list":
+      await handleList();
+      break;
+    case "check":
+      await handleCheck();
+      break;
+    case "lock":
+      if (!args[0]) {
+        console.error(`${colors6.red}Error: Template name required${colors6.reset}`);
+        process.exit(1);
+      }
+      await lockTemplate(args[0]);
+      console.log(`${colors6.green}Locked ${args[0]}${colors6.reset}`);
+      break;
+    case "unlock":
+      if (!args[0]) {
+        console.error(`${colors6.red}Error: Template name required${colors6.reset}`);
+        process.exit(1);
+      }
+      await unlockTemplate(args[0]);
+      console.log(`${colors6.green}Unlocked ${args[0]}${colors6.reset}`);
+      break;
+    default:
+      console.error(`${colors6.red}Unknown command: ${subCommand}${colors6.reset}`);
+      printHelp();
+      process.exit(1);
+  }
+}
+async function handleUpdate(name, all) {
+  if (all || !name) {
+    console.log(`${colors6.cyan}Updating all templates...${colors6.reset}`);
+    await installAllTemplates();
+    console.log(`${colors6.green}All templates updated${colors6.reset}`);
+  } else {
+    console.log(`${colors6.cyan}Updating ${name}...${colors6.reset}`);
+    await installTemplate(name);
+    console.log(`${colors6.green}Updated ${name}${colors6.reset}`);
+  }
+}
+async function handleList() {
+  const templates = await listInstalledTemplates();
+  console.log(`
+${colors6.cyan}Installed templates:${colors6.reset}`);
+  for (const t of templates) {
+    const typeLabel = t.type === "dual" ? colors6.blue + "dual" : t.type === "partial" ? colors6.yellow + "partial" : colors6.dim + "single";
+    console.log(`  ${colors6.blue}•${colors6.reset} ${t.name} (${typeLabel}${colors6.reset})`);
+  }
+  console.log();
+}
+async function handleCheck() {
+  const updates = await checkTemplateUpdates();
+  const available = updates.filter((u) => u.updateAvailable);
+  if (available.length === 0) {
+    console.log(`${colors6.green}All templates are up to date${colors6.reset}`);
+  } else {
+    console.log(`${colors6.yellow}Updates available:${colors6.reset}`);
+    for (const u of available) {
+      console.log(`  ${u.name}: ${u.installedVersion} -> ${u.bundledVersion}`);
+    }
+  }
+}
+var colors6, isMainModule5;
+var init_template_manager = __esm(() => {
+  init_versioning();
+  colors6 = {
+    red: "\x1B[0;31m",
+    green: "\x1B[0;32m",
+    blue: "\x1B[0;34m",
+    yellow: "\x1B[1;33m",
+    cyan: "\x1B[0;36m",
+    dim: "\x1B[2m",
+    reset: "\x1B[0m"
+  };
+  isMainModule5 = process.argv[1]?.includes("template-manager");
+  if (isMainModule5) {
+    main5().catch(console.error);
+  }
+});
+
 // src/cli/formalconf.tsx
-import { parseArgs as parseArgs5 } from "node:util";
+import { parseArgs as parseArgs6 } from "node:util";
 import { useState as useState11, useEffect as useEffect7 } from "react";
 import { render, useApp as useApp2, useInput as useInput11 } from "ink";
 import { Spinner as Spinner2 } from "@inkjs/ui";
@@ -5554,7 +5704,7 @@ function StatusIndicator({
 // package.json
 var package_default = {
   name: "formalconf",
-  version: "2.0.19",
+  version: "2.0.20",
   description: "Dotfiles management TUI for macOS and Linux - config management, package sync, and theme switching",
   type: "module",
   main: "./dist/formalconf.js",
@@ -7778,7 +7928,7 @@ function ThemeMenu({ onBack }) {
 init_paths();
 init_runtime();
 import { jsxDEV as jsxDEV20 } from "react/jsx-dev-runtime";
-function printHelp() {
+function printHelp2() {
   console.log(`
 FormalConf - Dotfiles Management TUI
 
@@ -7787,6 +7937,7 @@ Usage:
   formalconf theme <name>       Apply a theme (e.g., nord:dark)
   formalconf config <cmd>       Config management (stow, unstow, status, list)
   formalconf pkg-sync [flags]   Sync packages from pkg-config.json
+  formalconf template <cmd>     Template management (update, list, check)
 
 Options:
   -h, --help                    Show this help message
@@ -7795,6 +7946,7 @@ Examples:
   formalconf theme nord:dark
   formalconf config stow nvim
   formalconf pkg-sync --purge
+  formalconf template update --all
 `);
 }
 var BREADCRUMBS = {
@@ -7871,8 +8023,8 @@ function App() {
     ]
   }, undefined, true, undefined, this);
 }
-async function main5() {
-  const { positionals, values } = parseArgs5({
+async function main6() {
+  const { positionals, values } = parseArgs6({
     args: process.argv.slice(2),
     options: {
       help: { type: "boolean", short: "h" }
@@ -7882,36 +8034,42 @@ async function main5() {
   });
   const [subcommand] = positionals;
   if (values.help && !subcommand) {
-    printHelp();
+    printHelp2();
     process.exit(0);
   }
   if (subcommand) {
     const scriptMap = {
       theme: "set-theme",
       config: "config-manager",
-      "pkg-sync": "pkg-sync"
+      "pkg-sync": "pkg-sync",
+      template: "template-manager"
     };
     const scriptName = scriptMap[subcommand];
     if (!scriptName) {
       console.error(`Unknown subcommand: ${subcommand}`);
-      printHelp();
+      printHelp2();
       process.exit(1);
     }
     process.argv = [process.argv[0], scriptName, ...process.argv.slice(3)];
     switch (subcommand) {
       case "theme": {
-        const { main: main6 } = await Promise.resolve().then(() => (init_set_theme(), exports_set_theme));
-        await main6();
+        const { main: main7 } = await Promise.resolve().then(() => (init_set_theme(), exports_set_theme));
+        await main7();
         break;
       }
       case "config": {
-        const { main: main6 } = await Promise.resolve().then(() => (init_config_manager(), exports_config_manager));
-        await main6();
+        const { main: main7 } = await Promise.resolve().then(() => (init_config_manager(), exports_config_manager));
+        await main7();
         break;
       }
       case "pkg-sync": {
-        const { main: main6 } = await Promise.resolve().then(() => (init_pkg_sync(), exports_pkg_sync));
-        await main6();
+        const { main: main7 } = await Promise.resolve().then(() => (init_pkg_sync(), exports_pkg_sync));
+        await main7();
+        break;
+      }
+      case "template": {
+        const { main: main7 } = await Promise.resolve().then(() => (init_template_manager(), exports_template_manager));
+        await main7();
         break;
       }
     }
@@ -7919,4 +8077,4 @@ async function main5() {
   }
   render(/* @__PURE__ */ jsxDEV20(App, {}, undefined, false, undefined, this));
 }
-main5();
+main6();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formalconf",
-  "version": "2.0.19",
+  "version": "2.0.20",
   "description": "Dotfiles management TUI for macOS and Linux - config management, package sync, and theme switching",
   "type": "module",
   "main": "./dist/formalconf.js",