@daz4126/swifty 2.11.0 → 3.0.0

package/README.md

@@ -15,13 +15,21 @@ Swifty uses convention over configuration to make it super simple to build blazi
 - **RSS feed generation** for blogs and content folders
 - **Draft mode** for work-in-progress pages (visible in dev, hidden in production)
 - **Scheduled publishing** via future dates in front matter
-- **Optional [Turbo](https://turbo.hotwired.dev/)** for SPA-like transitions
+- **Contact forms** via third-party services (Formspree, Netlify Forms, etc.)
+- **Pagination** for folders with many pages
+- **Data files** - Load JSON/YAML data and use in templates
+- **Open Graph tags** - Auto-generated social sharing meta tags
+- **Word count & reading time** - Auto-calculated for blog posts
+- **Previous/next navigation** - Auto-generated links between sibling pages
+- **[Eta templating](https://eta.js.org/)** - Full JavaScript in templates with EJS syntax
+- **Idiomorph navigation** with optional intent prefetching for SPA-like transitions
 
 ## Quickstart
 
 ```bash
-npm install @daz4126/swifty
-npx swifty init
+npm install -g @daz4126/swifty
+swifty my-site
+cd my-site
 npx swifty start
 ```
 
@@ -34,6 +42,7 @@ your-site/
 ├── pages/          # Markdown content (folder structure = URLs)
 ├── layouts/        # HTML layout templates
 ├── partials/       # Reusable content snippets
+├── data/           # JSON/YAML data files
 ├── css/            # Stylesheets (auto-injected)
 ├── js/             # JavaScript (auto-injected)
 ├── images/         # Images (auto-optimized to WebP)
@@ -44,16 +53,18 @@ your-site/
 ## Commands
 
 ```bash
-npx swifty init             # Create new project structure
+npx swifty my-site          # Create new site in my-site/ folder
 npx swifty build            # Build static site to dist/ (for production)
 npx swifty start            # Build, watch, and serve at localhost:3000 (for development)
 npx swifty build --out dir  # Build to custom output directory
+npx swifty deploy "message" # Build, git add, commit, and push (message optional)
 ```
 
 ### Development vs Production
 
 - **`swifty start`** - For development. Includes live reload (auto-refreshes browser on file changes) and file watching with incremental builds for CSS/JS/images.
 - **`swifty build`** - For production deployment. Produces clean output without any development scripts.
+- **`swifty deploy "message"`** - Builds the site and commits/pushes to git in one command.
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daz4126/swifty",
-  "version": "2.11.0",
+  "version": "3.0.0",
   "main": "index.js",
   "type": "module",
   "bin": {
@@ -26,6 +26,7 @@
   "description": "Super Speedy Static Site Generator",
   "dependencies": {
     "chokidar": "^4.0.0",
+    "eta": "^4.5.0",
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
     "highlight.js": "^11.11.1",
@@ -33,7 +34,7 @@
     "livereload": "^0.10.3",
     "marked": "^14.1.3",
     "marked-highlight": "^2.2.1",
-    "serve": "^14.2.4",
+    "serve": "^14.2.5",
     "sharp": "^0.33.5"
   },
   "devDependencies": {

package/src/assets.js

@@ -2,7 +2,13 @@ import fs from "fs/promises";
 import fsExtra from "fs-extra";
 import path from "path";
 import sharp from "sharp";
+import { fileURLToPath } from "url";
 import { dirs, defaultConfig } from "./config.js";
+import { mapLimit } from "./concurrency.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const clientAssetsDir = path.join(__dirname, "client");
 
 // Get file modification timestamp for cache busting
 const getFileMtime = async (filePath) => {
@@ -13,7 +19,54 @@ const getFileMtime = async (filePath) => {
 const validExtensions = {
   css: [".css"],
   js: [".js"],
-  images: [".png", ".jpg", ".jpeg", ".gif", ".svg", " .webp"],
+  images: [".png", ".jpg", ".jpeg", ".gif", ".svg", ".webp"],
+};
+
+const optimizableImageExtensions = [".jpg", ".jpeg", ".png"];
+
+const getBuildConcurrency = () => defaultConfig.build_concurrency || 16;
+const navigationEnabled = () => defaultConfig.morphing !== false;
+
+const isDestinationFresh = async (source, destination) => {
+  try {
+    const [sourceStats, destinationStats] = await Promise.all([
+      fs.stat(source),
+      fs.stat(destination),
+    ]);
+    return destinationStats.mtimeMs >= sourceStats.mtimeMs;
+  } catch (err) {
+    return false;
+  }
+};
+
+const copyIfStale = async (source, destination) => {
+  if (await isDestinationFresh(source, destination)) {
+    return false;
+  }
+
+  await fsExtra.copy(source, destination);
+  return true;
+};
+
+const optimizeImageToWebp = async (source, destination) => {
+  if (await isDestinationFresh(source, destination)) {
+    return false;
+  }
+
+  const image = sharp(source);
+  const metadata = await image.metadata();
+  const originalWidth = metadata.width || 0;
+  const maxWidth = defaultConfig.max_image_width || 800;
+  const imageQuality = defaultConfig.image_quality || 80;
+  const resizeOptions =
+    originalWidth > 0 ? { width: Math.min(originalWidth, maxWidth) } : {};
+
+  await image
+    .resize(resizeOptions)
+    .toFormat("webp", { quality: imageQuality })
+    .toFile(destination);
+
+  return true;
 };
 
 const ensureAndCopy = async (source, destination, validExts) => {
@@ -33,6 +86,29 @@ const ensureAndCopy = async (source, destination, validExts) => {
     console.log(`No ${path.basename(source)} found in ${source}`);
   }
 };
+
+const copyNavigationAssets = async (outputDir = dirs.dist) => {
+  if (!navigationEnabled()) return;
+  if (!(await fsExtra.pathExists(clientAssetsDir))) return;
+
+  const destination = path.join(outputDir, "swifty");
+  await fsExtra.ensureDir(destination);
+
+  const files = await fs.readdir(clientAssetsDir);
+  await mapLimit(
+    files,
+    async (file) => {
+      const sourcePath = path.join(clientAssetsDir, file);
+      const destinationPath = path.join(destination, file);
+      const copied = await copyIfStale(sourcePath, destinationPath);
+      if (copied) {
+        console.log(`Copied Swifty navigation asset ${file}`);
+      }
+    },
+    getBuildConcurrency(),
+  );
+};
+
 const copyAssets = async (outputDir = dirs.dist) => {
   await ensureAndCopy(
     dirs.css,
@@ -40,47 +116,48 @@ const copyAssets = async (outputDir = dirs.dist) => {
     validExtensions.css,
   );
   await ensureAndCopy(dirs.js, path.join(outputDir, "js"), validExtensions.js);
-  await ensureAndCopy(
-    dirs.images,
-    path.join(outputDir, "images"),
-    validExtensions.images,
-  );
+  await copyNavigationAssets(outputDir);
 };
 async function optimizeImages(outputDir = dirs.dist) {
   try {
-    const IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png"];
-    const images_folder = path.join(outputDir, "images");
-    const files = await fs.readdir(images_folder);
-
-    await Promise.all(
-      files.map(async (file) => {
-        const filePath = path.join(images_folder, file);
+    if (!(await fsExtra.pathExists(dirs.images))) {
+      console.log(`No ${path.basename(dirs.images)} found in ${dirs.images}`);
+      return;
+    }
+
+    const imagesFolder = path.join(outputDir, "images");
+    await fsExtra.ensureDir(imagesFolder);
+
+    const files = await fs.readdir(dirs.images);
+
+    await mapLimit(
+      files.filter((file) =>
+        validExtensions.images.includes(path.extname(file).toLowerCase()),
+      ),
+      async (file) => {
+        const filePath = path.join(dirs.images, file);
         const ext = path.extname(file).toLowerCase();
 
-        if (!IMAGE_EXTENSIONS.includes(ext)) return;
+        if (!optimizableImageExtensions.includes(ext)) {
+          const destination = path.join(imagesFolder, file);
+          const copied = await copyIfStale(filePath, destination);
+          if (copied) {
+            console.log(`Copied ${file}`);
+          }
+          return;
+        }
 
         const optimizedPath = path.join(
-          images_folder,
+          imagesFolder,
           `${path.basename(file, ext)}.webp`,
         );
 
-        if (filePath !== optimizedPath) {
-          const image = sharp(filePath);
-          const metadata = await image.metadata();
-          const originalWidth = metadata.width || 0;
-          const maxWidth = defaultConfig.max_image_size || 800;
-          const resizeWidth = Math.min(originalWidth, maxWidth);
-
-          await image
-            .resize({ width: resizeWidth })
-            .toFormat("webp", { quality: 80 })
-            .toFile(optimizedPath);
-
-          await fs.unlink(filePath);
-
+        const optimized = await optimizeImageToWebp(filePath, optimizedPath);
+        if (optimized) {
           console.log(`Optimized ${file} -> ${optimizedPath}`);
         }
-      }),
+      },
+      getBuildConcurrency(),
     );
   } catch (error) {
     console.error("Error optimizing images:", error);
@@ -148,7 +225,6 @@ const copySingleAsset = async (filePath, outputDir = dirs.dist) => {
 
 // Process a single image
 const optimizeSingleImage = async (filePath, outputDir = dirs.dist) => {
-  const IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png"];
   const filename = path.basename(filePath);
   const ext = path.extname(filePath).toLowerCase();
   const imagesFolder = path.join(outputDir, "images");
@@ -156,26 +232,20 @@ const optimizeSingleImage = async (filePath, outputDir = dirs.dist) => {
   await fsExtra.ensureDir(imagesFolder);
 
   // For non-optimizable images (svg, webp, gif), just copy
-  if (!IMAGE_EXTENSIONS.includes(ext)) {
-    await fsExtra.copy(filePath, path.join(imagesFolder, filename));
-    console.log(`Copied ${filename}`);
+  if (!optimizableImageExtensions.includes(ext)) {
+    const copied = await copyIfStale(filePath, path.join(imagesFolder, filename));
+    if (copied) {
+      console.log(`Copied ${filename}`);
+    }
     return true;
   }
 
   // Optimize jpg/jpeg/png to webp
   const optimizedPath = path.join(imagesFolder, `${path.basename(filename, ext)}.webp`);
-  const image = sharp(filePath);
-  const metadata = await image.metadata();
-  const originalWidth = metadata.width || 0;
-  const maxWidth = defaultConfig.max_image_size || 800;
-  const resizeWidth = Math.min(originalWidth, maxWidth);
-
-  await image
-    .resize({ width: resizeWidth })
-    .toFormat("webp", { quality: 80 })
-    .toFile(optimizedPath);
-
-  console.log(`Optimized ${filename} -> ${path.basename(optimizedPath)}`);
+  const optimized = await optimizeImageToWebp(filePath, optimizedPath);
+  if (optimized) {
+    console.log(`Optimized ${filename} -> ${path.basename(optimizedPath)}`);
+  }
   return true;
 };
 

package/src/build.js

@@ -1,13 +1,69 @@
 import { copyAssets, optimizeImages } from "./assets.js";
 import { generatePages, createPages, addLinks } from "./pages.js";
 import { generateRssFeeds } from "./rss.js";
+import { generateSeoFiles } from "./sitemap.js";
 import { dirs } from "./config.js";
 
-export default async function build(outputDir) {
+export default async function build(outputDir = dirs.dist) {
+  const startTime = performance.now();
+  console.log("🚀 Starting build...");
+  
+  const copyStart = performance.now();
   await copyAssets(outputDir);
+  const copyTime = performance.now() - copyStart;
+  console.log(`📁 Assets copied in ${(copyTime / 1000).toFixed(2)}s`);
+  
+  const imageStart = performance.now();
   await optimizeImages(outputDir);
+  const imageTime = performance.now() - imageStart;
+  console.log(`🖼️  Images optimized in ${(imageTime / 1000).toFixed(2)}s`);
+  
+  const pagesStart = performance.now();
   const pages = await generatePages(dirs.pages);
+  const pagesTime = performance.now() - pagesStart;
+  console.log(`📄 Pages generated in ${(pagesTime / 1000).toFixed(2)}s`);
+  
+  const linksStart = performance.now();
   await addLinks(pages);
+  const linksTime = performance.now() - linksStart;
+  console.log(`🔗 Links added in ${(linksTime / 1000).toFixed(2)}s`);
+  
+  const createStart = performance.now();
   await createPages(pages, outputDir);
+  const createTime = performance.now() - createStart;
+  console.log(`✨ Pages created in ${(createTime / 1000).toFixed(2)}s`);
+  
+  const rssStart = performance.now();
   await generateRssFeeds(pages, outputDir);
+  const rssTime = performance.now() - rssStart;
+  console.log(`📡 RSS feeds generated in ${(rssTime / 1000).toFixed(2)}s`);
+
+  const seoStart = performance.now();
+  await generateSeoFiles(pages, outputDir);
+  const seoTime = performance.now() - seoStart;
+  console.log(`🧭 SEO files generated in ${(seoTime / 1000).toFixed(2)}s`);
+  
+  const totalTime = performance.now() - startTime;
+  console.log(`\n✅ Build completed in ${(totalTime / 1000).toFixed(2)}s`);
+  
+  // Performance summary
+  const stages = [
+    { name: "Assets", time: copyTime },
+    { name: "Images", time: imageTime },
+    { name: "Pages", time: pagesTime },
+    { name: "Links", time: linksTime },
+    { name: "Create", time: createTime },
+    { name: "RSS", time: rssTime },
+    { name: "SEO", time: seoTime }
+  ];
+  
+  const slowest = stages.sort((a, b) => b.time - a.time)[0];
+  if (slowest.time > totalTime * 0.3) {
+    console.log(`⚠️  Slowest stage: ${slowest.name} (${(slowest.time / 1000).toFixed(2)}s)`);
+  }
+  
+  // Force output to appear
+  if (process.stdout.isTTY) {
+    process.stdout.write('\n');
+  }
 }

package/src/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { spawn } from "child_process";
+import { spawn, execSync } from "child_process";
 
 const args = process.argv.slice(2);
 let outDir = "dist"; // default
@@ -14,13 +14,22 @@ if (outIndex !== -1 && args[outIndex + 1]) {
 // Pass outDir as an environment variable too (optional, still useful)
 process.env.OUT_DIR = outDir;
 
+const reservedCommands = ["build", "start", "watch", "deploy"];
+
 async function main() {
   const command = args[0];
 
+  // No arguments - show usage
+  if (!command) {
+    console.log(`Usage:`);
+    console.log(`  swifty <sitename>              Create a new site in <sitename> folder`);
+    console.log(`  swifty build [--out folder]    Build the site`);
+    console.log(`  swifty start [--out folder]    Build and serve with live reload`);
+    console.log(`  swifty deploy ["message"]      Build, commit, and push to git`);
+    return;
+  }
+
   switch (command) {
-    case "init":
-      await import("./init.js");
-      break;
     case "build": {
       const build = await import("./build.js");
       if (typeof build.default === "function") {
@@ -54,9 +63,44 @@ async function main() {
       }
       break;
     }
-    default:
-      console.log(`Unknown command: ${command}`);
-      console.log(`Usage: swifty [init|build|start|watch] [--out folder]`);
+    case "deploy": {
+      const commitMessage = args[1] || "Deploying latest build";
+
+      // Build the site
+      const build = await import("./build.js");
+      if (typeof build.default === "function") {
+        await build.default(outDir);
+      }
+
+      // Git operations
+      try {
+        console.log("Adding files to git...");
+        execSync("git add .", { stdio: "inherit" });
+
+        console.log("Committing changes...");
+        execSync(`git commit -m "${commitMessage.replace(/"/g, '\\"')}"`, {
+          stdio: "inherit",
+        });
+
+        console.log("Pushing to remote...");
+        execSync("git push", { stdio: "inherit" });
+
+        console.log("Deployed successfully!");
+      } catch (error) {
+        console.error("Deploy failed:", error.message);
+        process.exit(1);
+      }
+      break;
+    }
+    default: {
+      // Treat as sitename for new project creation
+      const sitename = command;
+      const init = await import("./init.js");
+      if (typeof init.default === "function") {
+        await init.default(sitename);
+      }
+      break;
+    }
   }
 }
 

package/src/client/IDIOMORPH-LICENSE.txt

@@ -0,0 +1,13 @@
+Zero-Clause BSD
+=============
+
+Permission to use, copy, modify, and/or distribute this software for
+any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
+DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.