@chriswiegman/hugo-tools 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
+## 0.2.1 - 2026-07-04
+
+### Chores
+
+* Add Eslint file formatting for easier development
+* Correct all linting issues with new formatter.
+
+## 0.2.0 - 2026-05-09
+
+### Features
+
+* Rework pick-image to move images into the dated assets directory and insert references directly into content files (frontmatter images array or markdown image tag)
+
+### Chores
+
+* Update project dependencies.
+
 ## 0.1.2 - 2026-05-04
 
 ### Features

package/README.md

@@ -2,12 +2,16 @@
 
 A collection of CLI tools for Hugo bloggers. Run them directly from the root of your Hugo site via `npx` or install globally.
 
+> **Never invoke these with `node path/to/script.js`.** Every command below is registered as a proper CLI via the `bin` field in `package.json`, so once installed you run it by name (`draft`, `publish`, ...) — see [Installation](#installation) for the three ways to do that.
+
 ## Requirements
 
 - Node.js 18 or later
 
 ## Installation
 
+Whichever route you pick, you're done as soon as you can run a bare command name (`draft`, `publish`, ...) — you should never need to reference a file path under `node_modules/` directly.
+
 **Run without installing (recommended):**
 
 ```sh
@@ -27,7 +31,14 @@ npx -p @chriswiegman/hugo-tools publish content/drafts/my-post.md now
 npm install --save-dev @chriswiegman/hugo-tools
 ```
 
-Then run commands via `npx` (no `-p` flag needed once installed) or add them as scripts in your `package.json`:
+Then run commands via `npx` (no `-p` flag needed once installed):
+
+```sh
+npx draft
+npx publish content/drafts/my-post.md now
+```
+
+...or add them as scripts in your `package.json` so `npm run publish` works too:
 
 ```json
 {
@@ -196,13 +207,34 @@ Requires `extract-tags` to have been run at least once.
 
 ### `pick-image`
 
-Lists images in your `imagesDir` for the current year/month, lets you pick one, and copies the Hugo-relative path to the clipboard.
+Moves an image into your `imagesDir` under the current year/month and inserts a reference into a Hugo content file.
+
+```sh
+pick-image <image-file> [content-file]
+```
+
+**What it does:**
+
+- Moves `<image-file>` to `assets/images/YYYY/MM/<filename>` (creates the directory if needed)
+- Derives the Hugo URL path by stripping the `assets/` prefix (e.g. `/images/YYYY/MM/filename`)
+- If a `[content-file]` is given:
+  - Appends the path to the `images:` array in front matter when that field is present (replacing any placeholder `  -` entry)
+  - Otherwise appends a `![](path)` markdown tag to the end of the body
+- If no `[content-file]` is given, copies the URL path to the clipboard instead
+
+**Examples:**
 
 ```sh
-pick-image
+# Move photo.jpg and insert into the currently open draft
+pick-image ~/Downloads/photo.jpg content/drafts/my-post.md
+
+# Move photo.jpg and copy the path to the clipboard
+pick-image ~/Downloads/photo.jpg
 ```
 
-Clipboard support: macOS (`pbcopy`), Windows (`clip`), Linux (`xclip`, `xsel`, or `wl-copy` — whichever is available).
+The VS Code "Pick Image" task prompts for the image path and automatically passes the currently open file as the content target — drag the image file into the terminal prompt to fill the path.
+
+Clipboard support (no-content-file mode): macOS (`pbcopy`), Windows (`clip`), Linux (`xclip`, `xsel`, or `wl-copy` — whichever is available).
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chriswiegman/hugo-tools",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "A set of tools to make blogging easier with Hugo.",
   "keywords": [
     "hugo",
@@ -41,12 +41,13 @@
   },
   "scripts": {
     "lint": "eslint src/",
-    "test": "node --test src/book.test.mjs src/publish.test.mjs src/extract-tags.test.mjs src/draft.test.mjs"
+    "test": "node --test src/book.test.mjs src/publish.test.mjs src/extract-tags.test.mjs src/draft.test.mjs src/pick-image.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "changie": "^1.24.0",
-    "eslint": "^10.3.0",
-    "globals": "^17.6.0"
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "changie": "^1.25.0",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0"
   }
-}
+}

package/src/add-tags.js

@@ -16,128 +16,131 @@ const DATA_FILE = path.join(process.cwd(), config.vscodeDir, 'tags-categories.js
  * Display menu and get user selection
  */
 async function getSelection(prompt, options) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  return new Promise((resolve) => {
-    console.log(`\n${prompt}`);
-    options.forEach((opt, idx) => {
-      console.log(`  ${idx + 1}. ${opt}`);
-    });
-    console.log(`  0. Done/Skip`);
-
-    rl.question('\nEnter number: ', (answer) => {
-      rl.close();
-      const num = parseInt(answer, 10);
-      if (num === 0) {
-        resolve(null);
-      } else if (num > 0 && num <= options.length) {
-        resolve(options[num - 1]);
-      } else {
-        console.log('Invalid selection');
-        resolve(null);
-      }
-    });
-  });
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+	});
+
+	return new Promise((resolve) => {
+		console.log(`\n${prompt}`);
+		options.forEach((opt, idx) => {
+			console.log(`  ${idx + 1}. ${opt}`);
+		});
+		console.log('  0. Done/Skip');
+
+		rl.question('\nEnter number: ', (answer) => {
+			rl.close();
+			const num = parseInt(answer, 10);
+
+			if (num === 0) {
+				resolve(null);
+			} else if (num > 0 && num <= options.length) {
+				resolve(options[num - 1]);
+			} else {
+				console.log('Invalid selection');
+				resolve(null);
+			}
+		});
+	});
 }
 
 /**
  * Get multiple selections
  */
 async function getMultipleSelections(prompt, options) {
-  const selections = [];
-  let done = false;
-
-  while (!done) {
-    const remaining = options.filter(opt => !selections.includes(opt));
-    if (remaining.length === 0) {
-      break;
-    }
-
-    const selection = await getSelection(
-      selections.length === 0 ? prompt : `${prompt} (Selected: ${selections.join(', ')})`,
-      remaining
-    );
-
-    if (selection === null) {
-      done = true;
-    } else {
-      selections.push(selection);
-    }
-  }
-
-  return selections;
+	const selections = [];
+	let done = false;
+
+	while (!done) {
+		const remaining = options.filter((opt) => !selections.includes(opt));
+
+		if (remaining.length === 0) {
+			break;
+		}
+
+		const selection = await getSelection(
+			selections.length === 0 ? prompt : `${prompt} (Selected: ${selections.join(', ')})`,
+			remaining,
+		);
+
+		if (selection === null) {
+			done = true;
+		} else {
+			selections.push(selection);
+		}
+	}
+
+	return selections;
 }
 
 /**
  * Format frontmatter list
  */
 function formatList(items) {
-  if (items.length === 0) {
-    return '  -';
-  }
-  return items.map(item => `  - ${item}`).join('\n');
+	if (items.length === 0) {
+		return '  -';
+	}
+
+	return items.map((item) => `  - ${item}`).join('\n');
 }
 
 /**
  * Main execution
  */
 async function main() {
-  config.requireHugoSite();
-
-  console.log('=== Hugo Draft Tags & Categories Helper ===\n');
-
-  // Check if data file exists
-  if (!fs.existsSync(DATA_FILE)) {
-    console.error(`Error: Data file not found at ${DATA_FILE}`);
-    console.error('Run "extract-tags" first to generate the data file.');
-    process.exit(1);
-  }
-
-  // Load data
-  const data = JSON.parse(fs.readFileSync(DATA_FILE, 'utf8'));
-
-  console.log(`Loaded ${data.categories.length} categories and ${data.tags.length} tags`);
-  console.log(`(Generated from ${data.stats.totalFiles} posts on ${new Date(data.stats.generatedAt).toLocaleDateString()})\n`);
-
-  // Get category selection
-  const category = await getSelection(
-    'Select a category:',
-    data.categories
-  );
-
-  // Get tag selections
-  const tags = await getMultipleSelections(
-    'Select tags (you can select multiple):',
-    data.tags
-  );
-
-  // Generate output
-  console.log('\n=== Generated Frontmatter ===\n');
-
-  if (category) {
-    console.log('categories:');
-    console.log(`  - ${category}`);
-  } else {
-    console.log('categories:');
-    console.log('  -');
-  }
-
-  console.log('tags:');
-  console.log(formatList(tags));
-
-  console.log('\n=== Copy the above into your draft frontmatter ===\n');
+	config.requireHugoSite();
+
+	console.log('=== Hugo Draft Tags & Categories Helper ===\n');
+
+	// Check if data file exists
+	if (!fs.existsSync(DATA_FILE)) {
+		console.error(`Error: Data file not found at ${DATA_FILE}`);
+		console.error('Run "extract-tags" first to generate the data file.');
+		process.exit(1);
+	}
+
+	// Load data
+	const data = JSON.parse(fs.readFileSync(DATA_FILE, 'utf8'));
+
+	console.log(`Loaded ${data.categories.length} categories and ${data.tags.length} tags`);
+	console.log(`(Generated from ${data.stats.totalFiles} posts on ${new Date(data.stats.generatedAt).toLocaleDateString()})\n`);
+
+	// Get category selection
+	const category = await getSelection(
+		'Select a category:',
+		data.categories,
+	);
+
+	// Get tag selections
+	const tags = await getMultipleSelections(
+		'Select tags (you can select multiple):',
+		data.tags,
+	);
+
+	// Generate output
+	console.log('\n=== Generated Frontmatter ===\n');
+
+	if (category) {
+		console.log('categories:');
+		console.log(`  - ${category}`);
+	} else {
+		console.log('categories:');
+		console.log('  -');
+	}
+
+	console.log('tags:');
+	console.log(formatList(tags));
+
+	console.log('\n=== Copy the above into your draft frontmatter ===\n');
 }
 
 // Handle Ctrl+C gracefully
 process.on('SIGINT', () => {
-  console.log('\n\nCancelled.');
-  process.exit(0);
+	console.log('\n\nCancelled.');
+	process.exit(0);
 });
 
-main().catch(err => {
-  console.error('Error:', err);
-  process.exit(1);
+main().catch((err) => {
+	console.error('Error:', err);
+	process.exit(1);
 });