@hutusi/amytis 1.5.5

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@hutusi/amytis",
+  "version": "1.5.5",
+  "description": "A high-performance digital garden and blog engine with Next.js 16 and Tailwind CSS v4",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hutusi/amytis.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hutusi/amytis/issues"
+  },
+  "homepage": "https://github.com/hutusi/amytis#readme",
+  "private": false,
+  "packageManager": "bun@1.3.4",
+  "scripts": {
+    "dev": "next dev",
+    "build": "bun scripts/copy-assets.ts && next build && next-image-export-optimizer",
+    "build:dev": "bun scripts/copy-assets.ts && next build",
+    "validate": "bun run lint && bun run test && bun run build:dev",
+    "clean": "rm -rf .next out public/posts public/books public/flows",
+    "new": "bun scripts/new-post.ts",
+    "new-weekly": "bun scripts/new-post.ts --series ai-nexus-weekly --md --folder --prefix weekly",
+    "new-series": "bun scripts/new-series.ts",
+    "new-from-pdf": "bun scripts/new-from-pdf.ts",
+    "new-from-images": "bun scripts/new-from-images.ts",
+    "new-flow": "bun scripts/new-flow.ts",
+    "series-draft": "bun scripts/series-draft.ts",
+    "start": "next start",
+    "lint": "eslint",
+    "test": "bun test",
+    "test:unit": "bun test src",
+    "test:int": "bun test tests/integration",
+    "test:e2e": "bun test tests/e2e"
+  },
+  "dependencies": {
+    "@giscus/react": "^3.1.0",
+    "@tailwindcss/typography": "^0.5.19",
+    "fuse.js": "^7.1.0",
+    "github-slugger": "^2.0.0",
+    "gray-matter": "^4.0.3",
+    "image-size": "^2.0.2",
+    "mermaid": "^11.12.3",
+    "next": "16.1.6",
+    "next-image-export-optimizer": "^1.20.1",
+    "next-themes": "^0.4.6",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-markdown": "^10.1.0",
+    "react-syntax-highlighter": "^16.1.0",
+    "rehype-katex": "^7.0.1",
+    "rehype-raw": "^7.0.0",
+    "rehype-slug": "^6.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "unist-util-visit": "^5.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/bun": "^1.3.9",
+    "@types/image-size": "^0.8.0",
+    "@types/node": "^24.10.13",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "babel-plugin-react-compiler": "1.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "16.1.6",
+    "pdf-to-img": "^5.0.0",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3"
+  },
+  "ignoreScripts": [
+    "sharp",
+    "unrs-resolver"
+  ],
+  "trustedDependencies": [
+    "sharp",
+    "unrs-resolver"
+  ]
+}

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/icon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- Letter A structure -->
+  <path d="M16 4 L7 28" />
+  <path d="M16 4 L25 28" />
+  <!-- Crossbar / Leaf stem -->
+  <path d="M11.5 18 H 20.5" />
+  <!-- Leaf accent -->
+  <path d="M20.5 18 Q 26 14 26 8 Q 23 12 20.5 18" fill="#059669" stroke="none" />
+</svg>

package/public/logo.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 140 32" fill="none">
+  <!-- Icon Part -->
+  <g>
+    <path d="M16 4 L7 28" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+    <path d="M16 4 L25 28" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+    <path d="M11.5 18 H 20.5" stroke="#059669" stroke-width="2" stroke-linecap="round" />
+    <path d="M20.5 18 Q 26 14 26 8 Q 23 12 20.5 18" fill="#059669" />
+  </g>
+  <!-- Text Part -->
+  <text x="36" y="24" font-family="serif" font-size="22" font-weight="bold" fill="#1c1917" letter-spacing="0.5">Amytis</text>
+</svg>

package/public/next-image-export-optimizer-hashes.json

@@ -0,0 +1,7 @@
+{
+    "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI=",
+    "posts/advanced-markdown/images/m-p-model.png": "BdYG3Wq+FcOnoSrZeJeb6x2V-LsB-gwvms3WQJFq+Wg=",
+    "posts/part-1/images/m-p-model.png": "94OaqjvkCmDcz+Iuhw14vHXYUzYl3Y8+wwoU1CQZ6l0=",
+    "posts/part-2-rich-content/images/m-p-model.png": "Vp5bOs9N2OHHjMM2PFntkkCl1uY7DleLymwrSHbecOA=",
+    "/screenshot.png": "dGCNrjp1oMIL3NrVh1VDW0K+7Pp-cI5KH6tW4-6o9zg="
+}

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/scripts/copy-assets.ts

@@ -0,0 +1,211 @@
+import fs from 'fs';
+import path from 'path';
+import { siteConfig } from '../site.config';
+
+const srcDir = path.join(process.cwd(), 'content', 'posts');
+const seriesSrcDir = path.join(process.cwd(), 'content', 'series');
+const booksSrcDir = path.join(process.cwd(), 'content', 'books');
+const flowsSrcDir = path.join(process.cwd(), 'content', 'flows');
+const destDir = path.join(process.cwd(), 'public', 'posts');
+const booksDestDir = path.join(process.cwd(), 'public', 'books');
+const flowsDestDir = path.join(process.cwd(), 'public', 'flows');
+
+function copyRecursive(src: string, dest: string) {
+  if (!fs.existsSync(src)) return;
+  
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyRecursive(srcPath, destPath);
+    } else {
+      // Copy all files except markdown source
+      if (!entry.name.endsWith('.md') && !entry.name.endsWith('.mdx')) {
+        let shouldCopy = true;
+        if (fs.existsSync(destPath)) {
+          const srcStat = fs.statSync(srcPath);
+          const destStat = fs.statSync(destPath);
+          if (srcStat.mtimeMs <= destStat.mtimeMs) {
+            shouldCopy = false;
+          }
+        }
+
+        if (shouldCopy) {
+          fs.copyFileSync(srcPath, destPath);
+          // console.log(`Copied: ${entry.name} -> ${destPath}`);
+        }
+      }
+    }
+  }
+}
+
+function getSlugFromFilename(filename: string): string {
+  const nameWithoutExt = filename.replace(/\.mdx?$/, '');
+  const dateRegex = /^(\d{4}-\d{2}-\d{2})-(.*)$/;
+  const match = nameWithoutExt.match(dateRegex);
+
+  if (match && !siteConfig.includeDateInUrl) {
+    return match[2];
+  }
+  return nameWithoutExt;
+}
+
+function processPosts() {
+  if (fs.existsSync(srcDir)) {
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+
+    entries.forEach((entry) => {
+      if (entry.isDirectory()) {
+        const targetName = getSlugFromFilename(entry.name);
+        const srcPostDir = path.join(srcDir, entry.name);
+        const destPostDir = path.join(destDir, targetName);
+
+        console.log(`Processing Post: ${entry.name} -> ${targetName}`);
+        copyRecursive(srcPostDir, destPostDir);
+      }
+    });
+  }
+}
+
+// Check if a directory is a post folder (contains index.md or index.mdx)
+function isPostFolder(dirPath: string): boolean {
+  return fs.existsSync(path.join(dirPath, 'index.md')) ||
+         fs.existsSync(path.join(dirPath, 'index.mdx'));
+}
+
+// Check if a directory is an asset folder (not a post folder)
+function isAssetFolder(dirPath: string): boolean {
+  return !isPostFolder(dirPath);
+}
+
+function processSeries() {
+  if (!fs.existsSync(seriesSrcDir)) return;
+
+  const seriesEntries = fs.readdirSync(seriesSrcDir, { withFileTypes: true });
+
+  seriesEntries.forEach((seriesEntry) => {
+    if (seriesEntry.isDirectory()) {
+      const seriesPath = path.join(seriesSrcDir, seriesEntry.name);
+      const items = fs.readdirSync(seriesPath, { withFileTypes: true });
+
+      // First pass: identify shared asset folders at series level (folders that are NOT posts)
+      const sharedAssetFolders = items
+        .filter(item => item.isDirectory() && isAssetFolder(path.join(seriesPath, item.name)))
+        .map(item => item.name);
+
+      // Process items in series folder
+      items.forEach(item => {
+        if (item.isFile() && (item.name.endsWith('.md') || item.name.endsWith('.mdx'))) {
+          // File-based post or series index
+          const targetSlug = item.name.startsWith('index.') ? seriesEntry.name : getSlugFromFilename(item.name);
+          const destPostDir = path.join(destDir, targetSlug);
+
+          console.log(`Processing Series File: ${item.name} -> ${targetSlug}`);
+
+          // Only copy shared asset folders (like images/, assets/), not sibling post folders
+          sharedAssetFolders.forEach(folderName => {
+            const srcPath = path.join(seriesPath, folderName);
+            const destPath = path.join(destPostDir, folderName);
+            copyRecursive(srcPath, destPath);
+          });
+
+          // Copy any non-markdown files at the series root level
+          items.filter(sub => sub.isFile() && !sub.name.endsWith('.md') && !sub.name.endsWith('.mdx'))
+            .forEach(sub => {
+              const srcPath = path.join(seriesPath, sub.name);
+              const destPath = path.join(destPostDir, sub.name);
+              if (!fs.existsSync(destPostDir)) {
+                fs.mkdirSync(destPostDir, { recursive: true });
+              }
+              fs.copyFileSync(srcPath, destPath);
+            });
+
+        } else if (item.isDirectory() && isPostFolder(path.join(seriesPath, item.name))) {
+          // Folder-based post: copy only its own assets
+          const targetSlug = getSlugFromFilename(item.name);
+          const itemSrcPath = path.join(seriesPath, item.name);
+          const destPostDir = path.join(destDir, targetSlug);
+
+          console.log(`Processing Series Post Folder: ${item.name} -> ${targetSlug}`);
+
+          // Copy everything from the post folder EXCEPT markdown files
+          const subItems = fs.readdirSync(itemSrcPath, { withFileTypes: true });
+          subItems.forEach(sub => {
+            const srcPath = path.join(itemSrcPath, sub.name);
+            const destPath = path.join(destPostDir, sub.name);
+
+            if (sub.isDirectory()) {
+              copyRecursive(srcPath, destPath);
+            } else if (!sub.name.endsWith('.md') && !sub.name.endsWith('.mdx')) {
+              if (!fs.existsSync(destPostDir)) {
+                fs.mkdirSync(destPostDir, { recursive: true });
+              }
+              fs.copyFileSync(srcPath, destPath);
+            }
+          });
+        }
+      });
+    }
+  });
+}
+
+function processBooks() {
+  if (!fs.existsSync(booksSrcDir)) return;
+
+  const entries = fs.readdirSync(booksSrcDir, { withFileTypes: true });
+
+  entries.forEach((entry) => {
+    if (entry.isDirectory()) {
+      const srcBookDir = path.join(booksSrcDir, entry.name);
+      const destBookDir = path.join(booksDestDir, entry.name);
+
+      console.log(`Processing Book: ${entry.name}`);
+      copyRecursive(srcBookDir, destBookDir);
+    }
+  });
+}
+
+function processFlows() {
+  if (!fs.existsSync(flowsSrcDir)) return;
+
+  // Walk content/flows/YYYY/MM/ structure for folder-based flows with co-located assets
+  const yearDirs = fs.readdirSync(flowsSrcDir, { withFileTypes: true });
+  for (const yearEntry of yearDirs) {
+    if (!yearEntry.isDirectory() || !/^\d{4}$/.test(yearEntry.name)) continue;
+    const yearPath = path.join(flowsSrcDir, yearEntry.name);
+
+    const monthDirs = fs.readdirSync(yearPath, { withFileTypes: true });
+    for (const monthEntry of monthDirs) {
+      if (!monthEntry.isDirectory() || !/^\d{2}$/.test(monthEntry.name)) continue;
+      const monthPath = path.join(yearPath, monthEntry.name);
+
+      const dayItems = fs.readdirSync(monthPath, { withFileTypes: true });
+      for (const dayItem of dayItems) {
+        // Only process folder-based flows (DD/ directories with index.mdx)
+        if (!dayItem.isDirectory()) continue;
+        const rawName = dayItem.name;
+        if (!/^\d{2}$/.test(rawName)) continue;
+
+        const srcFlowDir = path.join(monthPath, rawName);
+        const destFlowDir = path.join(flowsDestDir, yearEntry.name, monthEntry.name, rawName);
+
+        console.log(`Processing Flow: ${yearEntry.name}/${monthEntry.name}/${rawName}`);
+        copyRecursive(srcFlowDir, destFlowDir);
+      }
+    }
+  }
+}
+
+console.log('Copying assets...');
+processPosts();
+processSeries();
+processBooks();
+processFlows();
+console.log('Assets copied successfully.');

package/scripts/new-flow.ts

@@ -0,0 +1,47 @@
+import fs from 'fs';
+import path from 'path';
+
+const args = process.argv.slice(2);
+const title = args.filter(arg => !arg.startsWith('--'))[0];
+const useMdx = args.includes('--mdx');
+
+const now = new Date();
+const year = String(now.getFullYear());
+const month = String(now.getMonth() + 1).padStart(2, '0');
+const day = String(now.getDate()).padStart(2, '0');
+const dateStr = `${year}-${month}-${day}`;
+
+const ext = useMdx ? '.mdx' : '.md';
+const dirPath = path.join(process.cwd(), 'content', 'flows', year, month);
+const targetPath = path.join(dirPath, `${day}${ext}`);
+
+// Check if today's flow already exists (either .md or .mdx)
+const altExt = useMdx ? '.md' : '.mdx';
+const altPath = path.join(dirPath, `${day}${altExt}`);
+
+if (fs.existsSync(targetPath)) {
+  console.error(`Error: Flow already exists at ${targetPath}`);
+  process.exit(1);
+}
+
+if (fs.existsSync(altPath)) {
+  console.error(`Error: Flow already exists at ${altPath}`);
+  process.exit(1);
+}
+
+// Create parent directories if needed
+if (!fs.existsSync(dirPath)) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+const flowTitle = title || dateStr;
+
+const content = `---
+title: "${flowTitle}"
+tags: []
+---
+
+`;
+
+fs.writeFileSync(targetPath, content);
+console.log(`Created new flow: ${targetPath}`);

package/scripts/new-from-images.ts

@@ -0,0 +1,141 @@
+import fs from 'fs';
+import path from 'path';
+
+const args = process.argv.slice(2);
+
+// Parse arguments
+const folderPath = args.find(arg => !arg.startsWith('--'));
+const titleArgIndex = args.indexOf('--title');
+const title = titleArgIndex > -1 ? args[titleArgIndex + 1] : '';
+const sortArg = args.indexOf('--sort');
+const sortOrder = sortArg > -1 ? args[sortArg + 1] : 'name'; // name, date, or none
+const copyImages = !args.includes('--no-copy');
+
+// Supported image extensions
+const IMAGE_EXTENSIONS = ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.avif'];
+
+function isImageFile(filename: string): boolean {
+  const ext = path.extname(filename).toLowerCase();
+  return IMAGE_EXTENSIONS.includes(ext);
+}
+
+function getImageFiles(dir: string, sort: string): string[] {
+  const files = fs.readdirSync(dir)
+    .filter(f => {
+      const filePath = path.join(dir, f);
+      return fs.statSync(filePath).isFile() && isImageFile(f);
+    });
+
+  switch (sort) {
+    case 'name':
+      return files.sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
+    case 'date':
+      return files.sort((a, b) => {
+        const statA = fs.statSync(path.join(dir, a));
+        const statB = fs.statSync(path.join(dir, b));
+        return statA.mtimeMs - statB.mtimeMs;
+      });
+    case 'none':
+    default:
+      return files;
+  }
+}
+
+if (!folderPath) {
+  console.error('Please provide an image folder path.');
+  console.error('Usage: bun run new-from-images <folder> [--title "Post Title"] [--sort name|date|none] [--no-copy]');
+  console.error('');
+  console.error('Options:');
+  console.error('  --title     Custom title for the post (default: folder name)');
+  console.error('  --sort      Sort images by: name (default), date, or none');
+  console.error('  --no-copy   Reference images in place instead of copying');
+  process.exit(1);
+}
+
+if (!fs.existsSync(folderPath) || !fs.statSync(folderPath).isDirectory()) {
+  console.error(`Error: "${folderPath}" is not a valid directory.`);
+  process.exit(1);
+}
+
+// Get image files
+const imageFiles = getImageFiles(folderPath, sortOrder);
+
+if (imageFiles.length === 0) {
+  console.error(`Error: No image files found in "${folderPath}".`);
+  console.error(`Supported formats: ${IMAGE_EXTENSIONS.join(', ')}`);
+  process.exit(1);
+}
+
+console.log(`Found ${imageFiles.length} image(s) in folder.`);
+
+// Generate slug from title or folder name
+const folderName = path.basename(folderPath);
+const postTitle = title || folderName.replace(/[-_]/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+const slug = (title || folderName)
+  .toLowerCase()
+  .replace(/[^a-z0-9]+/g, '-')
+  .replace(/(^-|-$)+/g, '');
+
+const date = new Date().toISOString().split('T')[0];
+const dirName = `${date}-${slug}`;
+const dirPath = path.join(process.cwd(), 'content', 'posts', dirName);
+const imagesDir = path.join(dirPath, 'images');
+
+// Check if post already exists
+if (fs.existsSync(dirPath)) {
+  console.error(`Error: Post already exists at ${dirPath}`);
+  process.exit(1);
+}
+
+// Create directories
+fs.mkdirSync(imagesDir, { recursive: true });
+console.log(`Created directory: ${dirPath}`);
+
+// Copy or reference images
+const images: { filename: string; relativePath: string }[] = [];
+
+for (const file of imageFiles) {
+  const srcPath = path.join(folderPath, file);
+
+  if (copyImages) {
+    const destPath = path.join(imagesDir, file);
+    fs.copyFileSync(srcPath, destPath);
+    images.push({ filename: file, relativePath: `./images/${file}` });
+    console.log(`  Copied: ${file}`);
+  } else {
+    // Use absolute path from project root
+    const absoluteSrcPath = path.resolve(srcPath);
+    const relativePath = path.relative(dirPath, absoluteSrcPath);
+    images.push({ filename: file, relativePath });
+    console.log(`  Referenced: ${file}`);
+  }
+}
+
+// Generate markdown content
+const imageMarkdown = images
+  .map((img, index) => `![Image ${index + 1}](${img.relativePath})`)
+  .join('\n\n');
+
+const content = `---
+title: "${postTitle}"
+date: "${date}"
+excerpt: "A collection of ${images.length} images."
+category: "Gallery"
+tags: ["images", "gallery"]
+authors: ["Amytis"]
+layout: "post"
+draft: false
+latex: false
+---
+
+${imageMarkdown}
+`;
+
+// Write markdown file
+const targetPath = path.join(dirPath, 'index.mdx');
+fs.writeFileSync(targetPath, content);
+
+console.log(`\nCreated new post from images:`);
+console.log(`  Post: ${targetPath}`);
+console.log(`  Images: ${images.length} file(s)${copyImages ? ' (copied)' : ' (referenced)'}`);
+console.log(`\nYou can edit the post at: ${dirPath}`);

package/scripts/new-from-pdf.ts

@@ -0,0 +1,105 @@
+import fs from 'fs';
+import path from 'path';
+import { pdf } from 'pdf-to-img';
+
+const args = process.argv.slice(2);
+
+// Parse arguments
+const pdfPath = args.find(arg => arg.endsWith('.pdf') || (!arg.startsWith('--') && args.indexOf(arg) === 0));
+const titleArgIndex = args.indexOf('--title');
+const title = titleArgIndex > -1 ? args[titleArgIndex + 1] : '';
+const scaleArg = args.indexOf('--scale');
+const scale = scaleArg > -1 ? parseFloat(args[scaleArg + 1]) || 2.0 : 2.0;
+
+if (!pdfPath || !fs.existsSync(pdfPath)) {
+  console.error('Please provide a valid PDF file path.');
+  console.error('Usage: bun run new-from-pdf <pdf-file> [--title "Post Title"] [--scale 2.0]');
+  console.error('');
+  console.error('Options:');
+  console.error('  --title    Custom title for the post (default: PDF filename)');
+  console.error('  --scale    Image scale factor (default: 2.0 for good quality)');
+  process.exit(1);
+}
+
+// Generate slug from title or filename
+const pdfBasename = path.basename(pdfPath, '.pdf');
+const postTitle = title || pdfBasename.replace(/[-_]/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+const slug = (title || pdfBasename)
+  .toLowerCase()
+  .replace(/[^a-z0-9]+/g, '-')
+  .replace(/(^-|-$)+/g, '');
+
+const date = new Date().toISOString().split('T')[0];
+const dirName = `${date}-${slug}`;
+const dirPath = path.join(process.cwd(), 'content', 'posts', dirName);
+const imagesDir = path.join(dirPath, 'images');
+
+// Check if post already exists
+if (fs.existsSync(dirPath)) {
+  console.error(`Error: Post already exists at ${dirPath}`);
+  process.exit(1);
+}
+
+// Create directories
+fs.mkdirSync(imagesDir, { recursive: true });
+console.log(`Created directory: ${dirPath}`);
+
+// Convert PDF to images
+console.log(`Converting PDF (scale: ${scale})...`);
+
+const images: string[] = [];
+let pageNum = 0;
+
+try {
+  const pdfDocument = await pdf(pdfPath, { scale });
+
+  for await (const image of pdfDocument) {
+    pageNum++;
+    const filename = `page-${String(pageNum).padStart(3, '0')}.png`;
+    const imagePath = path.join(imagesDir, filename);
+
+    fs.writeFileSync(imagePath, image);
+    images.push(filename);
+    console.log(`  Generated: ${filename}`);
+  }
+} catch (error) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  console.error(`Error converting PDF: ${errorMessage}`);
+  fs.rmSync(dirPath, { recursive: true });
+  process.exit(1);
+}
+
+if (images.length === 0) {
+  console.error('Error: No images were generated from the PDF.');
+  fs.rmSync(dirPath, { recursive: true });
+  process.exit(1);
+}
+
+// Generate markdown content
+const imageMarkdown = images
+  .map((img, index) => `![Page ${index + 1}](./images/${img})`)
+  .join('\n\n');
+
+const content = `---
+title: "${postTitle}"
+date: "${date}"
+excerpt: "Content extracted from PDF document."
+category: "Document"
+tags: ["pdf", "document"]
+authors: ["Amytis"]
+layout: "post"
+draft: false
+latex: false
+---
+
+${imageMarkdown}
+`;
+
+// Write markdown file
+const targetPath = path.join(dirPath, 'index.mdx');
+fs.writeFileSync(targetPath, content);
+
+console.log(`\nCreated new post from PDF:`);
+console.log(`  Post: ${targetPath}`);
+console.log(`  Images: ${images.length} page(s)`);
+console.log(`\nYou can edit the post at: ${dirPath}`);