@nolly-cafe/distill 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 Nolly
+  
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+  
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+  
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# @nolly-cafe/distill
+
+`distill` is a zero-config, Vite-powered build and optimization CLI designed to be run anywhere, without requiring a local npm project, configuration files, or installed dependencies.
+
+It is intended for static sites, simple projects, and quick builds where you want a production-ready `dist/` output with aggressive minification and image optimization — immediately.
+
+The tool is executed via `pnpm dlx`, meaning nothing is installed permanently and no setup is required.
+
+---
+
+## Features
+
+- Zero configuration by default
+- Optional, composable configuration via CLI flags
+- No `package.json` required in the target directory
+- No local Vite installation required
+- Works with or without a `src/` directory
+- Always outputs a production-ready directory
+- HTML, JS, and CSS minification
+- Image optimization and conversion pipeline
+- Designed for ephemeral execution (`pnpm dlx`)
+
+---
+
+## Requirements
+
+- Node.js 18 or newer
+- `pnpm` (recommended)
+
+---
+
+## Usage
+
+From any directory containing a static site:
+
+```sh
+pnpm dlx @nolly-cafe/distill
+````
+
+You may also specify a path explicitly:
+
+```sh
+pnpm dlx @nolly-cafe/distill ./path/to/site
+```
+
+---
+
+## CLI options
+
+The table below documents all supported CLI parameters, their purpose, defaults, and accepted values.
+All options are optional; running `distill` with no flags uses opinionated defaults.
+| Option                    | Description                     | Default                 | Allowed values                   |
+| ------------------------- | ------------------------------- | ----------------------- | -------------------------------- |
+| `path` (positional)       | Source directory to build       | `.` (current directory) | Any valid directory path         |
+| `--out <dir>`             | Output directory                | `<source>/dist`         | Any valid directory path         |
+| `--images <dir>`          | Image source directory          | `<source>/img`          | Any valid directory path         |
+| `--images-out <dir>`      | Image output directory          | `<out>/img`             | Any valid directory path         |
+| `--no-images`             | Disable all image processing    | `false`                 | flag                             |
+| `--image-preset <preset>` | Image optimization preset       | `balanced`              | `fast`, `balanced`, `aggressive` |
+| `--no-webp`               | Disable WebP generation         | `false`                 | flag                             |
+| `--no-avif`               | Disable AVIF generation         | `false`                 | flag                             |
+| `--resize <WxH>`          | Resize images before conversion | unset                   | e.g. `1200x630`, `800x`          |
+| `--jpeg-quality <number>` | JPEG quality setting            | `75`                    | `1–100`                          |
+| `--svg-preset <preset>`   | SVG optimization level          | `safe`                  | `safe`, `aggressive`             |
+| `--about`                 | Print tool information and exit | —                       | flag                             |
+| `--help`                  | Print usage and exit            | —                       | flag                             |
+
+### Notes
+- Presets affect **only image processing**, not HTML/CSS/JS minification.
+- When both `--resize` and format conversion are enabled, resizing occurs before format generation.
+- Explicit paths always take priority over inferred defaults.
+- Unsupported image formats are copied verbatim.
+
+---
+
+## Source resolution rules
+
+* If a `src/` directory exists and no explicit path is provided, it is used as the build root
+* If a path is explicitly provided, that path is always used
+* The output directory defaults to `dist/` in the current working directory, unless overridden
+
+---
+
+## Directory example
+
+Without `src/`:
+
+```
+my-site/
+├── index.html
+├── img/
+│   ├── hero.jpg
+│   └── logo.png
+└── dist/
+     ├── index.html
+     ├── assets/
+     └── img/
+```
+
+With `src/`:
+
+```
+my-site/
+├── src/
+│   ├── index.html
+│   └── img/
+└── dist/
+```
+
+---
+
+## Image processing
+
+If an `img/` directory exists inside the source root, images are automatically processed and emitted into the output directory.
+
+### Supported formats
+
+* PNG
+* JPEG
+* GIF
+* SVG
+* WebP
+* AVIF
+
+### Default behavior
+
+* PNG, JPEG, GIF, and SVG are optimized using imagemin
+* WebP and AVIF versions are generated using sharp
+* Unsupported formats are copied verbatim
+* Output images are written to `<dist>/img`
+
+### Customization (optional)
+
+All image behavior can be controlled via flags, without configuration files:
+
+* Presets for speed vs compression
+* Format enable/disable
+* Quality tuning
+* Resize operations
+* SVG optimization modes
+
+Example:
+
+```sh
+pnpm dlx @nolly-cafe/distill ./site \
+  --image-preset aggressive \
+  --resize 1200x630 \
+  --no-avif
+```
+
+---
+
+## Commands
+
+### `--about`
+
+Prints information about the tool and exits.
+
+```sh
+pnpm dlx @nolly-cafe/distill --about
+```
+
+### `--help`
+
+Prints usage and available options.
+
+```sh
+pnpm dlx @nolly-cafe/distill --help
+```
+
+---
+
+## Philosophy
+
+`distill` is intentionally opinionated.
+
+It does not aim to replace frameworks or bundlers. It exists to solve one problem well:
+
+> “Take this folder and give me a clean, production-ready `dist/` in my current directory
+
+The internal architecture separates argument parsing, path resolution, build orchestration, and asset processing. This allows new behavior to be added as configuration rather than refactors.
+
+---
+
+## License
+
+[MIT License © 2025 NollyCafe LLC](./LICENSE)

package/bin/distfill.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import f from"process";import V from"yargs";import{hideBin as N}from"yargs/helpers";import{build as F,defineConfig as H}from"vite";import{createHtmlPlugin as M}from"vite-plugin-html";import u from"fs";import m from"path";import $ from"imagemin";import B from"imagemin-pngquant";import E from"imagemin-mozjpeg";import W from"imagemin-gifsicle";import Q from"imagemin-svgo";import C from"sharp";var y=e=>t=>`\x1B[${e}m${t}\x1B[0m`;var s={info:e=>console.log(y(36)("[distill]"),e),success:e=>console.log(y(32)("[distill]"),e),warn:e=>console.warn(y(33)("[distill]"),e),error:e=>console.error(y(31)("[distill]"),e)};var G=Q;var L=/\.(png|jpe?g|gif|svg|webp|avif|bmp|tiff?|ico)$/i;async function x(e){if(!u.existsSync(e.src)){s.warn(`image directory not found: ${e.src}`);return}const t=u.readdirSync(e.src).filter(i=>L.test(i));if(!t.length){s.warn("no images found");return}u.mkdirSync(e.out,{recursive:true});const r=[];if(e.optimize.png)r.push(B({quality:[.65,.8]}));if(e.optimize.jpeg)r.push(E({quality:e.jpegQuality}));if(e.optimize.gif)r.push(W({optimizationLevel:3}));if(e.optimize.svg){r.push(G({plugins:e.svgPreset==="aggressive"?[]:[{name:"removeViewBox",active:false}]}))}const n=t.filter(i=>/\.(png|jpe?g|gif|svg)$/i.test(i));if(n.length&&r.length){await $(n.map(i=>m.join(e.src,i)),{destination:e.out,plugins:r})}for(const i of t){const l=m.join(e.src,i);const d=m.parse(i).name;let p=C(l);if(e.resize){p=p.resize(e.resize.width,e.resize.height)}if(e.convert.webp){await p.webp({quality:e.convert.webp.quality}).toFile(m.join(e.out,`${d}.webp`))}if(e.convert.avif){await p.avif({quality:e.convert.avif.quality,effort:e.convert.avif.effort}).toFile(m.join(e.out,`${d}.avif`))}}for(const i of t){const l=m.join(e.out,i);if(!u.existsSync(l)){u.copyFileSync(m.join(e.src,i),l)}}s.success("image processing complete")}import k from"fs";import g from"path";function I(e){const{cwd:t,sourceArg:r,outArg:n,imagesArg:i,imagesOutArg:l,noImages:d,imagePreset:p="balanced",noWebp:A,noAvif:O,resize:h,svgPreset:S="safe",jpegQuality:q}=e;let c;if(r){c=g.resolve(t,r)}else{const a=g.join(t,"src");c=k.existsSync(a)?a:t}const b=n?g.resolve(t,n):g.join(t,"dist");if(d){return{sourceRoot:c,outDir:b}}const D={fast:{webp:{quality:60},avif:{quality:45,effort:3}},balanced:{webp:{quality:75},avif:{quality:50,effort:5}},aggressive:{webp:{quality:85},avif:{quality:60,effort:8}}};let w;if(h){const a=h.match(/^(\d+)?x(\d+)?$/);if(a){w={width:a[1]?Number(a[1]):void 0,height:a[2]?Number(a[2]):void 0}}}const R=i?g.resolve(t,i):g.join(c,"img");const T=l?g.resolve(t,l):g.join(b,"img");const v={...D[p]};if(A)delete v.webp;if(O)delete v.avif;return{sourceRoot:c,outDir:b,images:{enabled:true,src:R,out:T,optimize:{png:true,jpeg:true,gif:true,svg:true},jpegQuality:q??75,svgPreset:S,convert:v,resize:w}}}async function P(e){const t=I(e);const{sourceRoot:r,outDir:n,images:i}=t;s.info(`building from ${r}`);s.info(`output directory ${n}`);await F(H({base:"./",root:r,build:{outDir:n,emptyOutDir:true,assetsDir:"assets",minify:"terser"},plugins:[M({minify:true}),...i?[{name:"distill-images",apply:"build",async closeBundle(){await x(i)}}]:[]]}));if(!i){s.warn("image processing disabled")}s.success("build complete")}var j=["distill \u2014 zero-config static site distiller","","distill is a Vite-powered CLI designed for people who want production-ready","static builds without maintaining tooling, configuration files, or local","dependencies.","","It is built for ephemeral execution (pnpm dlx) and opinionated output.","","Author","  Nolly \u2014 independent developer","  https://github.com/thenolly","","Philosophy",'  "Take this folder and give me a clean, production-ready dist/ in my current directory."',"","License","  MIT License \xA9 2025 NollyCafe LLC"].join("\n");var z=["Usage:","  distill [path] [options]","","Arguments:","  path                    Source directory (defaults to current directory)","","Options:","  --out <dir>             Output directory","  --images <dir>          Image source directory","  --images-out <dir>      Image output directory","  --no-images             Disable all image processing","","Image optimization:","  --image-preset <name>   fast | balanced | aggressive","  --jpeg-quality <num>    JPEG quality (0\u2013100)","  --svg-preset <name>     safe | aggressive","  --resize <WxH>          Resize images (e.g. 1200x630)","  --no-webp               Disable WebP generation","  --no-avif               Disable AVIF generation","","Other:","  --about                 Show information about distill","  --help                  Show this help message","","Behavior:","  - Explicit path disables automatic ./src detection","  - --out always takes priority","  - Output defaults to ./dist relative to the current working directory","  - Images default to <source>/img","  - Image output defaults to <dist>/img","  - Unsupported formats are copied verbatim","","Examples:","  pnpm dlx @nolly-cafe/distill","  pnpm dlx @nolly-cafe/distill ./site","  pnpm dlx @nolly-cafe/distill ./site --out ./build","  pnpm dlx @nolly-cafe/distill ./site --image-preset aggressive","  pnpm dlx @nolly-cafe/distill ./site --resize 1200x630 --no-avif"].join("\n");var o=V(N(f.argv)).help(false).version(false).option("about",{type:"boolean"}).option("help",{type:"boolean"}).option("out",{type:"string",describe:"Output directory"}).option("images",{type:"string",describe:"Image source directory"}).option("images-out",{type:"string",describe:"Image output directory"}).option("no-images",{type:"boolean",describe:"Disable image processing"}).option("image-preset",{choices:["fast","balanced","aggressive"],describe:"Image optimization preset"}).option("no-webp",{type:"boolean",describe:"Disable WebP output"}).option("no-avif",{type:"boolean",describe:"Disable AVIF output"}).option("resize",{type:"string",describe:"Resize images (WIDTHxHEIGHT)"}).option("svg-preset",{choices:["safe","aggressive"],describe:"SVG optimization preset"}).option("jpeg-quality",{type:"number",describe:"JPEG quality (1\u2013100)"}).parseSync();if(o.help){console.log(z);f.exit(0)}if(o.about){console.log(j);f.exit(0)}P({cwd:f.cwd(),sourceArg:o._[0]?String(o._[0]):void 0,outArg:o.out,imagesArg:o.images,imagesOutArg:o["images-out"],noImages:o["no-images"],imagePreset:o["image-preset"],noWebp:o["no-webp"],noAvif:o["no-avif"],resize:o.resize,svgPreset:o["svg-preset"],jpegQuality:o["jpeg-quality"]}).catch(e=>{s.error(e instanceof Error?e.message:String(e));f.exit(1)});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@nolly-cafe/distill",
+  "description": "Zero-config, ephemeral CLI for building and optimizing static sites with Vite.",
+  "keywords": [
+    "cli",
+    "static-site",
+    "vite",
+    "build",
+    "image-optimization",
+    "pnpm-dlx",
+    "zero-config"
+  ],
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "distill": "./bin/distill.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@10.18.1",
+  "files": [
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "dependencies": {
+    "imagemin": "^9.0.1",
+    "imagemin-gifsicle": "^7.0.0",
+    "imagemin-mozjpeg": "^10.0.0",
+    "imagemin-pngquant": "^10.0.0",
+    "imagemin-svgo": "^11.0.1",
+    "imagemin-webp": "^8.0.0",
+    "sharp": "^0.34.5",
+    "terser": "^5.44.1",
+    "vite": "^7.3.0",
+    "vite-plugin-html": "^3.2.2",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@types/imagemin": "^9.0.1",
+    "@types/imagemin-gifsicle": "^7.0.4",
+    "@types/imagemin-mozjpeg": "^8.0.4",
+    "@types/imagemin-svgo": "^11.0.0",
+    "@types/imagemin-webp": "^7.0.3",
+    "@types/node": "^25.0.3",
+    "@types/yargs": "^17.0.35",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}