@gesslar/uglier 0.5.1 → 0.7.0

package/README.md

@@ -2,7 +2,10 @@
 
 **Opinionated, composable ESLint flat config for people who like their code readable.**
 
-A flexible ESLint configuration system built on [flat config](https://eslint.org/docs/latest/use/configure/configuration-files) that lets you mix and match stylistic rules, JSDoc enforcement, and environment presets.
+A flexible ESLint configuration system built on
+[flat config](https://eslint.org/docs/latest/use/configure/configuration-files)
+that lets you mix and match stylistic rules, JSDoc enforcement, and environment
+presets.
 
 ## Monotribe
 
@@ -30,14 +33,16 @@ kthx
 ## Quick Start
 
 ```bash
-# Install and set up in one command
+# Install dependencies and generate config in one command
+npx @gesslar/uglier install
 npx @gesslar/uglier init node
 
 # Or for React projects
+npx @gesslar/uglier install
 npx @gesslar/uglier init react
 
-# Or just install without config generation
-npx @gesslar/uglier
+# Forgot to add React later? No problem!
+npx @gesslar/uglier add react
 ```
 
 This automatically installs `@gesslar/uglier`, `eslint`, and all dependencies.
@@ -156,8 +161,8 @@ Run `npx @gesslar/uglier --help` to see all available configs with descriptions.
 ## Commands
 
 ```bash
-# Install dependencies only
-npx @gesslar/uglier
+# Install dependencies
+npx @gesslar/uglier install
 
 # Generate config for specific targets
 npx @gesslar/uglier init node
@@ -165,13 +170,22 @@ npx @gesslar/uglier init web
 npx @gesslar/uglier init react
 npx @gesslar/uglier init node web  # Multiple targets
 
+# Add config blocks to existing eslint.config.js
+npx @gesslar/uglier add react
+npx @gesslar/uglier add tauri vscode-extension  # Multiple targets
+
+# Remove config blocks from existing eslint.config.js
+npx @gesslar/uglier remove react
+npx @gesslar/uglier remove web tauri  # Multiple targets
+# Note: Also removes any overrides for removed targets
+
 # Show available configs
 npx @gesslar/uglier --help
 
 # Works with any package manager
-pnpx @gesslar/uglier init node  # pnpm
-yarn dlx @gesslar/uglier init node  # yarn
-bunx @gesslar/uglier init node  # bun
+pnpx @gesslar/uglier install  # pnpm
+yarn dlx @gesslar/uglier install  # yarn
+bunx @gesslar/uglier install  # bun
 ```
 
 ## Manual Installation
@@ -194,6 +208,19 @@ bun add -d @gesslar/uglier eslint
 
 Note: `@stylistic/eslint-plugin`, `eslint-plugin-jsdoc`, and `globals` are bundled as dependencies.
 
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Run linter
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+```
+
 ## Philosophy
 
 This config enforces:

package/bin/cli.js

@@ -0,0 +1,631 @@
+/**
+ * @file cli.js - Core CLI functions for @gesslar/uglier
+ */
+
+import {execSync} from "child_process"
+import {
+  FileObject,
+  VDirectoryObject,
+  Sass
+} from "@gesslar/toolkit"
+import c from "@gesslar/colours"
+import {detectAgent} from "@skarab/detect-package-manager"
+
+// Use VDirectoryObject to ensure we never accidentally venture outside project
+// Cap at project root - this becomes our sandbox boundary
+const PROJECT_ROOT = VDirectoryObject.fromCwd()
+const SRC_DIR = PROJECT_ROOT.getDirectory("src")
+const PACKAGE_NAME = "@gesslar/uglier"
+
+// Only peer dependencies need to be installed separately
+// (all other dependencies come bundled with the package)
+const PEER_DEPS = [
+  "eslint"
+]
+
+/**
+ * Parse targets from config file's with array
+ *
+ * @param {string} content - File content
+ * @returns {string[]} Array of target names
+ */
+function parseTargetsFromConfig(content) {
+  // Match the entire with array, being careful not to stop at nested brackets
+  const withMatch = content.match(/with:\s*\[([\s\S]*?)\n\s*\]/m)
+
+  if(!withMatch) {
+    return []
+  }
+
+  // Extract all quoted strings that appear at the start of lines (config names)
+  const targets = []
+  const lines = withMatch[1].split("\n")
+
+  for(const line of lines) {
+    // Match either single or double quoted strings at start of line
+    const match = line.match(/^\s*(['"])([^'"]+)\1/)
+
+    if(match) {
+      targets.push(match[2])
+    }
+  }
+
+  return targets
+}
+
+/**
+ * Get install command for detected package manager
+ *
+ * @returns {Promise<{manager: string, installCmd: string}>} Package manager info
+ */
+export async function getPackageManagerInfo() {
+  const agent = await detectAgent()
+  const manager = agent?.name || "npm"
+
+  const commands = {
+    npm: "npm i -D",
+    pnpm: "pnpm i -D",
+    yarn: "yarn add -D",
+    bun: "bun add -d"
+  }
+
+  return {
+    manager,
+    installCmd: commands[manager] || commands.npm
+  }
+}
+
+/**
+ * Get the appropriate eslint run command for the detected package manager
+ *
+ * @returns {Promise<string>} ESLint command (e.g., "pnpm eslint .")
+ */
+async function getEslintCommand() {
+  const {manager} = await getPackageManagerInfo()
+
+  const commands = {
+    npm: "npx eslint .",
+    pnpm: "pnpm eslint .",
+    yarn: "yarn eslint .",
+    bun: "bunx eslint ."
+  }
+
+  return commands[manager] || commands.npm
+}
+
+/**
+ * Execute a command and return output
+ *
+ * @param {string} cmd - Command to execute
+ * @returns {string} Command output
+ * @throws {Sass} Enhanced error with command context
+ */
+export function exec(cmd) {
+  try {
+    return execSync(cmd, {encoding: "utf8", stdio: "pipe"})
+  } catch(error) {
+    const err = new Sass(`Failed to execute command: ${cmd}`, {cause: error})
+    err.addTrace("Command execution failed")
+    console.error(err.report())
+    process.exit(1)
+  }
+}
+
+/**
+ * Get available configs from the source file
+ *
+ * @returns {Promise<Array<{name: string, description: string, files: string}>|null>} Available configs
+ */
+export async function getAvailableConfigs() {
+  try {
+    // Try to read from installed package or local source
+    const cwd = VDirectoryObject.fromCwd()
+    const installedDir = cwd.getDirectory(`node_modules/${PACKAGE_NAME}/src`)
+    const localSource = new FileObject("uglier.js", SRC_DIR)
+    const installedSource = new FileObject("uglier.js", installedDir)
+
+    let uglierFile = null
+
+    if(await localSource.exists) {
+      uglierFile = localSource
+    } else if(await installedSource.exists) {
+      uglierFile = installedSource
+    }
+
+    if(!uglierFile) {
+      return null
+    }
+
+    const source = await uglierFile.read()
+
+    // Extract config names, descriptions, and default files
+    const configs = []
+    // Match individual config blocks within CONFIGS object
+    const configBlockRegex = /\/\*\*\s*\n\s*\*\s*([^\n@*]+?)\s*\n(?:\s*\*[^\n]*\n)*?\s*\*\/\s*\n\s*["']([^"']+)["']:\s*\([^)]*\)\s*=>\s*\{[^}]*?files\s*=\s*(\[[^\]]+\])/g
+    let match
+
+    while((match = configBlockRegex.exec(source)) !== null) {
+      configs.push({
+        name: match[2],
+        description: match[1].trim(),
+        files: match[3]
+      })
+    }
+
+    return configs
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Check if a package is already installed
+ *
+ * @param {string} packageName - Name of package to check
+ * @returns {Promise<boolean>} True if installed
+ */
+export async function isInstalled(packageName) {
+  try {
+    const cwd = VDirectoryObject.fromCwd()
+    const packageJsonFile = new FileObject("package.json", cwd)
+
+    if(!(await packageJsonFile.exists)) {
+      console.warn(c`No {<B}package.json{B>} found. Please initialize your project first.`)
+      process.exit(1)
+    }
+
+    const packageJson = await packageJsonFile.loadData("json")
+    const allDeps = {
+      ...packageJson.dependencies,
+      ...packageJson.devDependencies,
+      ...packageJson.peerDependencies
+    }
+
+    return packageName in allDeps
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Main installation routine
+ */
+export async function install() {
+  console.log(c`Installing {<B}${PACKAGE_NAME}{B>}...`)
+  console.log()
+
+  const toInstall = []
+
+  // Check if main package is already installed
+  if(!(await isInstalled(PACKAGE_NAME))) {
+    toInstall.push(PACKAGE_NAME)
+  } else {
+    console.log(c`{F070}✓{/} {<B}${PACKAGE_NAME}{B>} already installed`)
+  }
+
+  // Check peer dependencies
+  for(const dep of PEER_DEPS) {
+    if(!(await isInstalled(dep))) {
+      toInstall.push(dep)
+    } else {
+      console.log(c`{F070}✓{/} {<B}${dep}{B>} already installed`)
+    }
+  }
+
+  // Install missing packages
+  if(toInstall.length > 0) {
+    console.log(c`\n{F027} Installing:{/} ${toInstall.map(p => c`{F172}${p}{/}`).join(", ")}`)
+
+    const {manager, installCmd} = await getPackageManagerInfo()
+    const fullCmd = `${installCmd} ${toInstall.join(" ")}`
+
+    console.log(c`{F244}Using package manager: ${manager}{/}`)
+    console.log(c`{F244}Running: ${fullCmd}{/}`)
+    exec(fullCmd)
+
+    console.log()
+    console.log(c`{F070}✓{/} Installation successful.`)
+  }
+
+  console.log()
+  console.log(c`{F039}For detailed setup and configuration options, visit:{/}`)
+  console.log(c`https://github.com/gesslar/uglier#readme`)
+}
+
+/**
+ * Generate eslint.config.js file
+ *
+ * @param {string[]} targets - Target environments (node, web, react, etc.)
+ * @returns {Promise<boolean>} True if successful
+ */
+export async function generateConfig(targets = []) {
+  const cwd = VDirectoryObject.fromCwd()
+  const configFile = cwd.getFile("eslint.config.js")
+
+  if(await configFile.exists) {
+    console.log(c`{F214}Error:{/} {<B}eslint.config.js{B>} already exists`)
+    console.log(c`Use {<B}npx @gesslar/uglier add <targets>{B>} to add config blocks to it`)
+
+    return false
+  }
+
+  // Get available configs dynamically
+  const configs = await getAvailableConfigs()
+  const environmentTargets = configs
+    ? configs.filter(c => !c.name.startsWith("lints-") && c.name !== "languageOptions" && !c.name.endsWith("-override"))
+      .map(c => c.name)
+    : ["node", "web", "react", "tauri", "vscode-extension"]
+
+  // If no targets specified, show error with available options
+  if(targets.length === 0) {
+    console.log(c`{F214}Error:{/} No targets specified`)
+    console.log()
+    console.log(c`Available targets: ${environmentTargets.map(t => c`{F172}${t}{/}`).join(", ")}`)
+    console.log()
+    console.log(c`{F244}Example: npx @gesslar/uglier init ${environmentTargets[0] || "node"}{/}`)
+
+    return false
+  }
+
+  // Validate targets
+  const validTargets = environmentTargets
+  const invalidTargets = targets.filter(t => !validTargets.includes(t))
+
+  if(invalidTargets.length > 0) {
+    console.log(c`{F214}Error:{/} Invalid targets: {F172}${invalidTargets.join(", ")}{/}`)
+    console.log(c`Valid targets: {F070}${validTargets.join(", ")}{/}`)
+
+    return false
+  }
+
+  // Build the config with comments
+  const withArray = ["lints-js", "lints-jsdoc", ...targets]
+
+  // Get file patterns dynamically from source
+  const allConfigs = await getAvailableConfigs()
+  const filePatterns = {}
+
+  if(allConfigs) {
+    for(const config of allConfigs) {
+      filePatterns[config.name] = config.files
+    }
+  }
+
+  // Build the with array with comments
+  const withLines = withArray.map(target => {
+    const pattern = filePatterns[target] || "[]"
+
+    return `      "${target}", // default files: ${pattern}`
+  }).join("\n")
+
+  const configContent = `import uglify from "@gesslar/uglier"
+
+export default [
+  ...uglify({
+    with: [
+${withLines}
+    ]
+  })
+]
+`
+
+  await configFile.write(configContent)
+
+  console.log(c`{F070}✓{/} Created {<B}eslint.config.js{B>}`)
+  console.log()
+  console.log(c`{F039}Configuration includes:{/}`)
+
+  for(const target of withArray) {
+    console.log(c`  {F070}•{/} ${target}`)
+  }
+
+  const eslintCmd = await getEslintCommand()
+
+  console.log()
+  console.log(c`{F244}Run {<B}${eslintCmd}{B>} to lint your project{/}`)
+
+  return true
+}
+
+/**
+ * Add config blocks to existing eslint.config.js
+ *
+ * @param {string[]} targets - Target environments to add (node, web, react, etc.)
+ * @returns {Promise<boolean>} True if successful
+ */
+export async function addToConfig(targets = []) {
+  const cwd = VDirectoryObject.fromCwd()
+  const configFile = cwd.getFile("eslint.config.js")
+
+  if(!(await configFile.exists)) {
+    console.log(c`{F214}Error:{/} {<B}eslint.config.js{B>} not found`)
+    console.log(c`Use {<B}npx @gesslar/uglier init <targets>{B>} to create one first`)
+
+    return false
+  }
+
+  // Get available configs dynamically
+  const configs = await getAvailableConfigs()
+  const environmentTargets = configs
+    ? configs.filter(c => !c.name.startsWith("lints-") && c.name !== "languageOptions" && !c.name.endsWith("-override"))
+      .map(c => c.name)
+    : ["node", "web", "react", "tauri", "vscode-extension"]
+
+  // If no targets specified, show error with available options
+  if(targets.length === 0) {
+    console.log(c`{F214}Error:{/} No targets specified`)
+    console.log()
+    console.log(c`Available targets: ${environmentTargets.map(t => c`{F172}${t}{/}`).join(", ")}`)
+    console.log()
+    console.log(c`{F244}Example: npx @gesslar/uglier add react{/}`)
+
+    return false
+  }
+
+  // Validate targets
+  const validTargets = environmentTargets
+  const invalidTargets = targets.filter(t => !validTargets.includes(t))
+
+  if(invalidTargets.length > 0) {
+    console.log(c`{F214}Error:{/} Invalid targets: {F172}${invalidTargets.join(", ")}{/}`)
+    console.log(c`Valid targets: {F070}${validTargets.join(", ")}{/}`)
+
+    return false
+  }
+
+  // Read existing config
+  const existingContent = await configFile.read()
+
+  // Parse the with array from the existing config
+  const withMatch = existingContent.match(/with:\s*\[([\s\S]*?)\]/m)
+  const existingTargets = parseTargetsFromConfig(existingContent)
+
+  if(existingTargets.length === 0 || !withMatch) {
+    console.log(c`{F214}Error:{/} Could not parse existing config`)
+    console.log(c`The config file may have a non-standard format`)
+
+    return false
+  }
+
+  // Find which targets are new
+  const newTargets = targets.filter(t => !existingTargets.includes(t))
+
+  if(newTargets.length === 0) {
+    console.log(c`{F214}Warning:{/} All specified targets already exist in config`)
+    console.log()
+    console.log(c`Current targets: ${existingTargets.map(t => c`{F070}${t}{/}`).join(", ")}`)
+
+    return false
+  }
+
+  // Get file patterns for new targets
+  const allConfigs = await getAvailableConfigs()
+  const filePatterns = {}
+
+  if(allConfigs) {
+    for(const config of allConfigs) {
+      filePatterns[config.name] = config.files
+    }
+  }
+
+  // Build new lines to add
+  const newLines = newTargets.map(target => {
+    const pattern = filePatterns[target] || "[]"
+
+    return `      "${target}", // default files: ${pattern}`
+  })
+
+  // Find the position to insert (before the closing bracket)
+  const withArrayContent = withMatch[1]
+  const lastCommaPos = withArrayContent.lastIndexOf(",")
+
+  // Build the replacement with new targets added
+  let newWithContent
+
+  if(lastCommaPos === -1) {
+    // No existing targets or only one without trailing comma
+    newWithContent = withArrayContent.trim() + ",\n" + newLines.join("\n")
+  } else {
+    newWithContent = withArrayContent + "\n" + newLines.join("\n")
+  }
+
+  const newContent = existingContent.replace(
+    /with:\s*\[([\s\S]*?)\]/m,
+    `with: [\n${newWithContent}\n    ]`
+  )
+
+  await configFile.write(newContent)
+
+  console.log(c`{F070}✓{/} Added config blocks to {<B}eslint.config.js{B>}`)
+  console.log()
+  console.log(c`{F039}Added targets:{/}`)
+
+  for(const target of newTargets) {
+    console.log(c`  {F070}•{/} ${target}`)
+  }
+
+  const eslintCmd = await getEslintCommand()
+
+  console.log()
+  console.log(c`{F244}Run {<B}${eslintCmd}{B>} to lint your project{/}`)
+
+  return true
+}
+
+/**
+ * Remove config blocks from existing eslint.config.js
+ *
+ * @param {string[]} targets - Target environments to remove (node, web, react, etc.)
+ * @returns {Promise<{success: boolean, removedTargets: string[], removedOverrides: string[]}>} Result info
+ */
+export async function removeFromConfig(targets = []) {
+  const cwd = VDirectoryObject.fromCwd()
+  const configFile = cwd.getFile("eslint.config.js")
+
+  if(!(await configFile.exists)) {
+    console.log(c`{F214}Error:{/} {<B}eslint.config.js{B>} not found`)
+    console.log(c`Use {<B}npx @gesslar/uglier init <targets>{B>} to create one first`)
+
+    return {success: false, removedTargets: [], removedOverrides: []}
+  }
+
+  // Get available configs dynamically
+  const configs = await getAvailableConfigs()
+  const environmentTargets = configs
+    ? configs.filter(c => !c.name.startsWith("lints-") && c.name !== "languageOptions" && !c.name.endsWith("-override"))
+      .map(c => c.name)
+    : ["node", "web", "react", "tauri", "vscode-extension"]
+
+  // If no targets specified, show error with available options
+  if(targets.length === 0) {
+    console.log(c`{F214}Error:{/} No targets specified`)
+    console.log()
+    console.log(c`Available targets: ${environmentTargets.map(t => c`{F172}${t}{/}`).join(", ")}`)
+    console.log()
+    console.log(c`{F244}Example: npx @gesslar/uglier remove react{/}`)
+
+    return {success: false, removedTargets: [], removedOverrides: []}
+  }
+
+  // Read existing config
+  const existingContent = await configFile.read()
+
+  // Parse the with array from the existing config
+  const existingTargets = parseTargetsFromConfig(existingContent)
+
+  if(existingTargets.length === 0) {
+    console.log(c`{F214}Error:{/} Could not parse existing config`)
+    console.log(c`The config file may have a non-standard format`)
+
+    return {success: false, removedTargets: [], removedOverrides: []}
+  }
+
+  // Find which targets exist and can be removed
+  const targetsToRemove = targets.filter(t => existingTargets.includes(t))
+  const notFoundTargets = targets.filter(t => !existingTargets.includes(t))
+
+  if(notFoundTargets.length > 0) {
+    console.log(c`{F214}Warning:{/} These targets are not in the config: {F172}${notFoundTargets.join(", ")}{/}`)
+  }
+
+  if(targetsToRemove.length === 0) {
+    console.log(c`{F214}Error:{/} None of the specified targets exist in config`)
+    console.log()
+    console.log(c`Current targets: ${existingTargets.map(t => c`{F070}${t}{/}`).join(", ")}`)
+
+    return {success: false, removedTargets: [], removedOverrides: []}
+  }
+
+  // Build new with array content without the removed targets
+  const remainingTargets = existingTargets.filter(
+    t => !targetsToRemove.includes(t)
+  )
+
+  if(remainingTargets.length === 0) {
+    console.log(c`{F214}Error:{/} Cannot remove all targets from config`)
+    console.log(c`At least one target must remain`)
+
+    return {success: false, removedTargets: [], removedOverrides: []}
+  }
+
+  // Get file patterns for remaining targets
+  const allConfigs = await getAvailableConfigs()
+  const filePatterns = {}
+
+  if(allConfigs) {
+    for(const config of allConfigs) {
+      filePatterns[config.name] = config.files
+    }
+  }
+
+  // Build new lines for remaining targets
+  const newLines = remainingTargets.map(target => {
+    const pattern = filePatterns[target] || "[]"
+
+    return `      "${target}", // default files: ${pattern}`
+  })
+
+  let newContent = existingContent.replace(
+    /with:\s*\[([\s\S]*?)\n\s*\]/m,
+    `with: [\n${newLines.join("\n")}\n    ]`
+  )
+
+  // Check for and remove overrides for removed targets
+  const removedOverrides = []
+  const overridesMatch = existingContent.match(/overrides:\s*\{([\s\S]*?)\n\s*\}/m)
+
+  if(overridesMatch) {
+    for(const target of targetsToRemove) {
+      // Match override block for this target
+      const overridePattern = new RegExp(`\\s*["']${target}["']:\\s*\\{[^}]*\\},?`, "g")
+
+      if(overridePattern.test(newContent)) {
+        removedOverrides.push(target)
+        newContent = newContent.replace(overridePattern, "")
+      }
+    }
+
+    // Clean up empty overrides object or trailing commas
+    newContent = newContent.replace(/overrides:\s*\{\s*,?\s*\}/m, "")
+    newContent = newContent.replace(/,(\s*)\}/g, "$1}")
+  }
+
+  await configFile.write(newContent)
+
+  console.log(c`{F070}✓{/} Removed config blocks from {<B}eslint.config.js{B>}`)
+  console.log()
+  console.log(c`{F039}Removed targets:{/}`)
+
+  for(const target of targetsToRemove) {
+    console.log(c`  {F070}•{/} ${target}`)
+  }
+
+  if(removedOverrides.length > 0) {
+    console.log()
+    console.log(c`{F039}Also removed overrides for:{/}`)
+
+    for(const target of removedOverrides) {
+      console.log(c`  {F070}•{/} ${target}`)
+    }
+  }
+
+  const eslintCmd = await getEslintCommand()
+
+  console.log()
+  console.log(c`{F244}Run {<B}${eslintCmd}{B>} to lint your project{/}`)
+
+  return {success: true, removedTargets: targetsToRemove, removedOverrides}
+}
+
+/**
+ * Show help information
+ */
+export async function showHelp() {
+  console.log(c`{F027}@gesslar/uglier{/} - Composable ESLint flat config`)
+
+  console.log()
+  console.log("Usage:")
+  console.log()
+  console.log(c`  {<B}npx @gesslar/uglier install{B>}           Install package and dependencies`)
+  console.log(c`  {<B}npx @gesslar/uglier init <targets>{B>}    Generate eslint.config.js with targets`)
+  console.log(c`  {<B}npx @gesslar/uglier add <targets>{B>}     Add config blocks to existing eslint.config.js`)
+  console.log(c`  {<B}npx @gesslar/uglier remove <targets>{B>}  Remove config blocks from existing eslint.config.js`)
+  console.log(c`  {<B}npx @gesslar/uglier --help{B>}            Show this help`)
+  console.log()
+
+  const configs = await getAvailableConfigs()
+
+  if(configs && configs.length > 0) {
+    console.log(c`Available config blocks:`)
+    console.log()
+
+    for(const {name, description} of configs) {
+      console.log(c`  {<B}${name.padEnd(20)}{B>} ${description}`)
+    }
+  } else {
+    console.log("Install the package to see available config blocks.\n")
+  }
+
+  console.log()
+  console.log(`Documentation at https://github.com/gesslar/uglier.`)
+}

package/package.json

@@ -3,10 +3,9 @@
   "description": "Composable ESLint flat config blocks for stylistic, JSDoc, and environment presets.",
   "author": {
     "name": "gesslar",
-    "email": "bmw@gesslar.dev",
     "url": "https://gesslar.dev"
   },
-  "version": "0.5.1",
+  "version": "0.7.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gesslar/uglier.git"
@@ -15,7 +14,7 @@
   "main": "src/uglier.js",
   "exports": "./src/uglier.js",
   "bin": {
-    "uglier": "./bin/install.js"
+    "uglier": "./src/install.js"
   },
   "files": [
     "src",
@@ -42,21 +41,22 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@gesslar/colours": "^0.5.0",
-    "@gesslar/toolkit": "^3.6.3",
+    "@gesslar/colours": "^0.7.1",
+    "@gesslar/toolkit": "^3.17.0",
     "@skarab/detect-package-manager": "^1.0.0",
     "@stylistic/eslint-plugin": "^5.6.1",
     "eslint-plugin-jsdoc": "^61.5.0",
-    "globals": "^16.5.0"
+    "globals": "^17.0.0"
   },
   "devDependencies": {
-    "@gesslar/uglier": "^0.4.0",
+    "@gesslar/uglier": "^0.5.1",
     "eslint": "^9.39.2"
   },
   "scripts": {
+    "test": "node --test tests/unit/*.test.js",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
-    "update": "pnpm up --latest --recursive",
+    "update": "pnpm self-update && pnpx npm-check-updates -u && pnpm install",
     "submit": "pnpm publish --access public --//registry.npmjs.org/:_authToken=\"${NPM_ACCESS_TOKEN}\"",
     "pr": "gt submit -p --ai",
     "patch": "pnpm version patch",

package/src/install.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+/**
+ * @file install.js - Auto-installer and config generator for @gesslar/uglier
+ *
+ * @description
+ * This script can be run via `npx @gesslar/uglier` to automatically install
+ * the package and its peer dependencies to the current project.
+ *
+ * Commands:
+ * - npx @gesslar/uglier install           - Install package and dependencies
+ * - npx @gesslar/uglier init <targets>    - Generate eslint.config.js with targets
+ * - npx @gesslar/uglier add <targets>     - Add config blocks to existing eslint.config.js
+ * - npx @gesslar/uglier remove <targets>  - Remove config blocks from existing eslint.config.js
+ * - npx @gesslar/uglier --help            - Show help
+ *
+ * Installation does:
+ * 1. Install @gesslar/uglier as a dev dependency
+ * 2. Install eslint as a peer dependency (if not present)
+ *
+ * Note: All other dependencies (@stylistic/eslint-plugin, eslint-plugin-jsdoc, globals)
+ * are bundled with the package and don't need to be installed separately.
+ */
+
+import c from "@gesslar/colours"
+import {
+  install,
+  generateConfig,
+  addToConfig,
+  removeFromConfig,
+  showHelp
+} from "../bin/cli.js"
+
+// Parse command line arguments and run
+const args = process.argv.slice(2)
+
+if(args.includes("--help") || args.includes("-h")) {
+  await showHelp()
+} else if(args[0] === "install") {
+  await install()
+} else if(args[0] === "init") {
+  const targets = args.slice(1)
+
+  await generateConfig(targets)
+} else if(args[0] === "add") {
+  const targets = args.slice(1)
+
+  await addToConfig(targets)
+} else if(args[0] === "remove") {
+  const targets = args.slice(1)
+
+  await removeFromConfig(targets)
+} else {
+  // No command or unknown command - show help
+  console.log(c`{F214}Error:{/} Unknown command or no command specified`)
+  console.log()
+  await showHelp()
+}

package/bin/install.js

@@ -1,334 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @file install.js - Auto-installer and config generator for @gesslar/uglier
- *
- * @description
- * This script can be run via `npx @gesslar/uglier` to automatically install
- * the package and its peer dependencies to the current project.
- *
- * Commands:
- * - npx @gesslar/uglier           - Install package and dependencies
- * - npx @gesslar/uglier init      - Generate eslint.config.js with prompts
- * - npx @gesslar/uglier init node - Generate eslint.config.js for Node.js
- * - npx @gesslar/uglier --help    - Show help
- *
- * Installation does:
- * 1. Install @gesslar/uglier as a dev dependency
- * 2. Install eslint as a peer dependency (if not present)
- *
- * Note: All other dependencies (@stylistic/eslint-plugin, eslint-plugin-jsdoc, globals)
- * are bundled with the package and don't need to be installed separately.
- */
-
-import {execSync} from "child_process"
-import {dirname} from "path"
-import {fileURLToPath} from "url"
-import {FileObject, DirectoryObject} from "@gesslar/toolkit"
-import c from "@gesslar/colours"
-import {detectAgent} from "@skarab/detect-package-manager"
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-
-const PACKAGE_NAME = "@gesslar/uglier"
-
-// Only peer dependencies need to be installed separately
-// (all other dependencies come bundled with the package)
-const PEER_DEPS = [
-  "eslint"
-]
-
-/**
- * Get install command for detected package manager
- *
- * @returns {Promise<{manager: string, installCmd: string}>} Package manager info
- */
-async function getPackageManagerInfo() {
-  const agent = await detectAgent()
-  const manager = agent?.name || "npm"
-
-  const commands = {
-    npm: "npm i -D",
-    pnpm: "pnpm i -D",
-    yarn: "yarn add -D",
-    bun: "bun add -d"
-  }
-
-  return {
-    manager,
-    installCmd: commands[manager] || commands.npm
-  }
-}
-
-/**
- * Execute a command and return output
- *
- * @param {string} cmd - Command to execute
- * @returns {string} Command output
- */
-function exec(cmd) {
-  try {
-    return execSync(cmd, {encoding: "utf8", stdio: "pipe"})
-  } catch(error) {
-    console.error(`Error executing: ${cmd}`)
-    console.error(error.message)
-    process.exit(1)
-  }
-}
-
-/**
- * Get available configs from the source file
- *
- * @returns {Promise<Array<{name: string, description: string, files: string}>|null>} Available configs
- */
-async function getAvailableConfigs() {
-  try {
-    // Try to read from installed package or local source
-    const localDir = new DirectoryObject(`${__dirname}/../src`)
-    const installedDir = new DirectoryObject(`${process.cwd()}/node_modules/${PACKAGE_NAME}/src`)
-
-    const localSource = new FileObject("uglier.js", localDir)
-    const installedSource = new FileObject("uglier.js", installedDir)
-
-    let uglierFile = null
-
-    if(await localSource.exists) {
-      uglierFile = localSource
-    } else if(await installedSource.exists) {
-      uglierFile = installedSource
-    }
-
-    if(!uglierFile) {
-      return null
-    }
-
-    const source = await uglierFile.read()
-
-    // Extract config names, descriptions, and default files
-    const configs = []
-    // Match individual config blocks within CONFIGS object
-    const configBlockRegex = /\/\*\*\s*\n\s*\*\s*([^\n@*]+?)\s*\n(?:\s*\*[^\n]*\n)*?\s*\*\/\s*\n\s*["']([^"']+)["']:\s*\([^)]*\)\s*=>\s*\{[^}]*?files\s*=\s*(\[[^\]]+\])/g
-    let match
-
-    while((match = configBlockRegex.exec(source)) !== null) {
-      configs.push({
-        name: match[2],
-        description: match[1].trim(),
-        files: match[3]
-      })
-    }
-
-    return configs
-  } catch {
-    return null
-  }
-}
-
-/**
- * Show help information
- */
-async function showHelp() {
-  console.log(c`{F027}@gesslar/uglier{/} - Composable ESLint flat config`)
-
-  console.log()
-  console.log("Usage:")
-  console.log()
-  console.log(c`  {<B}npx @gesslar/uglier{B>}                Install package and dependencies`)
-  console.log(c`  {<B}npx @gesslar/uglier init{B>}           Generate eslint.config.js interactively`)
-  console.log(c`  {<B}npx @gesslar/uglier init <targets>{B>} Generate eslint.config.js with targets`)
-  console.log(c`  {<B}npx @gesslar/uglier --help{B>}         Show this help`)
-  console.log()
-
-  const configs = await getAvailableConfigs()
-
-  if(configs && configs.length > 0) {
-    console.log(c`Available config blocks:`)
-    console.log()
-
-    for(const {name, description} of configs) {
-      console.log(c`  {<B}${name.padEnd(20)}{B>} ${description}`)
-    }
-  } else {
-    console.log("Install the package to see available config blocks.\n")
-  }
-
-  console.log()
-  console.log(`Documentation at https://github.com/gesslar/uglier.`)
-}
-
-/**
- * Check if a package is already installed
- *
- * @param {string} packageName - Name of package to check
- * @returns {Promise<boolean>} True if installed
- */
-async function isInstalled(packageName) {
-  try {
-    const packageJsonFile = new FileObject("package.json", process.cwd())
-
-    if(!(await packageJsonFile.exists)) {
-      console.warn(c`No {<B}package.json{B>} found. Please initialize your project first.`)
-      process.exit(1)
-    }
-
-    const packageJson = await packageJsonFile.loadData("json")
-    const allDeps = {
-      ...packageJson.dependencies,
-      ...packageJson.devDependencies,
-      ...packageJson.peerDependencies
-    }
-
-    return packageName in allDeps
-  } catch {
-    return false
-  }
-}
-
-/**
- * Main installation routine
- */
-async function install() {
-  console.log(c`Installing {<B}${PACKAGE_NAME}{B>}...`)
-  console.log()
-
-  const toInstall = []
-
-  // Check if main package is already installed
-  if(!(await isInstalled(PACKAGE_NAME))) {
-    toInstall.push(PACKAGE_NAME)
-  } else {
-    console.log(c`{F070}✓{/} {<B}${PACKAGE_NAME}{B>} already installed`)
-  }
-
-  // Check peer dependencies
-  for(const dep of PEER_DEPS) {
-    if(!(await isInstalled(dep))) {
-      toInstall.push(dep)
-    } else {
-      console.log(c`{F070}✓{/} {<B}${dep}{B>} already installed`)
-    }
-  }
-
-  // Install missing packages
-  if(toInstall.length > 0) {
-    console.log(c`\n{F027} Installing:{/} ${toInstall.map(p => c`{F172}${p}{/}`).join(", ")}`)
-
-    const {manager, installCmd} = await getPackageManagerInfo()
-    const fullCmd = `${installCmd} ${toInstall.join(" ")}`
-
-    console.log(c`{F244}Using package manager: ${manager}{/}`)
-    console.log(c`{F244}Running: ${fullCmd}{/}`)
-    exec(fullCmd)
-
-    console.log()
-    console.log(c`{F070}✓{/} Installation successful.`)
-  }
-
-  console.log()
-  console.log(c`{F039}For detailed setup and configuration options, visit:{/}`)
-  console.log(c`https://github.com/gesslar/uglier#readme`)
-}
-
-/**
- * Generate eslint.config.js file
- *
- * @param {string[]} targets - Target environments (node, web, react, etc.)
- */
-async function generateConfig(targets = []) {
-  const configFile = new FileObject("eslint.config.js", process.cwd())
-
-  if(await configFile.exists) {
-    console.log(c`{F214}Warning:{/} {<B}eslint.config.js{B>} already exists`)
-    console.log(c`Delete it first or edit it manually`)
-
-    return
-  }
-
-  // Get available configs dynamically
-  const configs = await getAvailableConfigs()
-  const environmentTargets = configs
-    ? configs.filter(c => !c.name.startsWith("lints-") && c.name !== "languageOptions" && !c.name.endsWith("-override"))
-      .map(c => c.name)
-    : ["node", "web", "react", "tauri", "vscode-extension"]
-
-  // If no targets specified, make it interactive
-  if(targets.length === 0) {
-    console.log(c`{F027}Choose your target environments:{/}`)
-    console.log()
-    console.log(c`Available targets: ${environmentTargets.map(t => c`{F172}${t}{/}`).join(", ")}`)
-    console.log()
-    console.log(c`{F244}Example: npx @gesslar/uglier init ${environmentTargets[0] || "node"}{/}`)
-
-    return
-  }
-
-  // Validate targets
-  const validTargets = environmentTargets
-  const invalidTargets = targets.filter(t => !validTargets.includes(t))
-
-  if(invalidTargets.length > 0) {
-    console.log(c`{F214}Error:{/} Invalid targets: {F172}${invalidTargets.join(", ")}{/}`)
-    console.log(c`Valid targets: {F070}${validTargets.join(", ")}{/}`)
-
-    return
-  }
-
-  // Build the config with comments
-  const withArray = ["lints-js", "lints-jsdoc", ...targets]
-
-  // Get file patterns dynamically from source
-  const allConfigs = await getAvailableConfigs()
-  const filePatterns = {}
-
-  if(allConfigs) {
-    for(const config of allConfigs) {
-      filePatterns[config.name] = config.files
-    }
-  }
-
-  // Build the with array with comments
-  const withLines = withArray.map(target => {
-    const pattern = filePatterns[target] || "[]"
-
-    return `      "${target}", // default files: ${pattern}`
-  }).join("\n")
-
-  const configContent = `import uglify from "@gesslar/uglier"
-
-export default [
-  ...uglify({
-    with: [
-${withLines}
-    ]
-  })
-]
-`
-
-  await configFile.write(configContent)
-
-  console.log(c`{F070}✓{/} Created {<B}eslint.config.js{B>}`)
-  console.log()
-  console.log(c`{F039}Configuration includes:{/}`)
-
-  for(const target of withArray) {
-    console.log(c`  {F070}•{/} ${target}`)
-  }
-
-  console.log()
-  console.log(c`{F244}Run {<B}npx eslint .{B>} to lint your project{/}`)
-}
-
-// Parse command line arguments and run
-const args = process.argv.slice(2)
-
-if(args.includes("--help") || args.includes("-h")) {
-  await showHelp()
-} else if(args[0] === "init") {
-  const targets = args.slice(1)
-
-  await install()
-  await generateConfig(targets)
-} else {
-  await install()
-}