minimaz-cli 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2025 Hans Zeller (info@zellerindustries.com)
+
+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,107 @@
+# Minimaz ⚡
+
+**Minimaz** is a minimal, zero-dependency static site builder and project initializer focused on speed, simplicity, and clean output.
+
+## 🚀 Features
+
+* 📁 Initialize projects from global templates
+* 🧩 Save, list, and delete custom templates
+* 📝 Supports HTML, CSS, JS, and TypeScript (.ts → .js)
+* 🧹 Minifies HTML, CSS, JS, and TS (compiled & minified)
+* ⚙️ Configurable with a `minimaz.config.json` file
+* ➕ Supports concatenation of additional scripts and styles
+* 🪄 Optional path replacements for asset links
+* 🪶 Lightweight and fast — ideal for small static or utility projects
+* 🔥 Usable with `minimaz` or alias `mz`
+* 🆕 Display version with `minimaz version`
+
+## 📦 Installation
+
+Run directly with `npx` without global install:
+
+```bash
+npx minimaz init my-site
+cd my-site
+npx minimaz build
+npx minimaz version
+```
+
+Or using the alias:
+
+```bash
+npx mz init my-site
+npx mz build
+npx mz version
+```
+
+## 📁 Project Structure
+
+```txt
+my-site/
+├── src/               # HTML, CSS, JS, TS files
+├── public/            # Static assets (images, fonts, etc.)
+├── dist/              # Output folder (generated)
+├── minimaz.config.json
+└── ...
+```
+
+## ⚙️ Configuration
+
+Customize your build using a `minimaz.config.json` file:
+
+```json
+{
+  "src": "src",
+  "dist": "dist",
+  "public": "public",
+  "minify": {
+    "html": true,
+    "css": true,
+    "js": true,
+    "ts": true
+  },
+  "replace": {
+    "../public/": "public/"
+  },
+  "styles": [
+    "style.css",
+    "theme.css"
+  ],
+  "scripts": [
+    "lib.js",
+    "script.js"
+  ]
+}
+```
+
+* `styles` (optional): array of `.css` files to concatenate and minify into a single `style.css`
+* `scripts` (optional): array of `.js` files to concatenate and minify into a single `script.js`
+* If omitted, fallback defaults are `style.css` and `script.js`
+
+## 🛠 Commands
+
+```bash
+minimaz init <project-name>       # Create a new project using global templates
+minimaz build                     # Build and minify the site (uses config or defaults)
+minimaz template <path>           # Save a new template from specified path (or current dir)
+minimaz template -l               # List available templates
+minimaz template -d <name>        # Delete a saved template
+minimaz help                      # Show help message
+minimaz version                   # Display Minimaz version
+```
+
+*All commands also work with the alias `mz`.*
+
+## 📂 Templates
+
+Minimaz supports global templates stored in:
+
+```bash
+~/.minimaz/templates
+```
+
+Use them to quickly initialize consistent projects across environments.
+
+## 📄 License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+import fs from 'fs-extra'
+
+import { build } from '../src/commands/build.js'
+import { init } from '../src/commands/init.js'
+import { help } from '../src/commands/help.js'
+import { template } from '../src/commands/template.js'
+
+import { log } from '../src/utils/logService.js'
+import { parseArgs } from '../src/utils/functions.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// Read version from package.json dynamically
+const pkgPath = join(__dirname, '../package.json')
+const pkgJson = await fs.readJson(pkgPath)
+const version = pkgJson.version as string
+
+async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2))
+  const cmd = (args._[0] || '').toLowerCase()
+
+  type CommandFn = () => Promise<void> | void
+
+  const commands: Record<string, CommandFn> = {
+    // Init Command
+    init: async () => {
+      await init(args._[1] || 'minimaz-project', {
+        template: args.template || args.t || 'default'
+      })
+    },
+
+    // Build Command
+    build: async () => build(),
+
+    // Help Command
+    help: () => help(),
+
+    // Template Command
+    template: async () => {
+      await template(args._[1], {
+        list: args.l || args.list,
+        delete: args.d || args.delete,
+        update: args.u || args.update
+      } as any)
+    },
+
+    // Version
+    version: () => console.log(version),
+
+    // Aliases
+    i: () => commands.init(),
+    b: () => commands.build(),
+    h: () => commands.help(),
+    t: () => commands.template(),
+    v: () => commands.version()
+  }
+
+  try {
+    if (commands[cmd]) {
+      await commands[cmd]()
+    } else {
+      log('error', `Unknown command '${cmd}'. Use 'minimaz help' to see available commands.`)
+      commands.help()
+    }
+  } catch (e: any) {
+    log(
+      'error',
+      e instanceof Error
+        ? process.env.DEBUG ? e.stack ?? e.message : e.message
+        : String(e)
+    )
+    process.exit(1)
+  }
+}
+
+main()

package/dist/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2025 Hans Zeller (info@zellerindustries.com)
+
+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/dist/README.md

@@ -0,0 +1,103 @@
+# Minimaz ⚡
+
+**Minimaz** is a minimal, zero-dependency static site builder and project initializer focused on speed, simplicity, and clean output.
+
+## 🚀 Features
+
+- 📁 Initialize projects from global templates
+- 🧩 Save, list, and delete custom templates
+- 📝 Supports HTML, CSS, JS, and TypeScript (.ts → .js)
+- 🧹 Minifies HTML, CSS, JS, and TS (compiled & minified)
+- ⚙️ Configurable with a `minimaz.config.json` file
+- ➕ Supports concatenation of additional scripts and styles
+- 🪄 Optional path replacements for asset links
+- 🪶 Lightweight and fast — ideal for small static or utility projects
+- 🔥 Usable with `minimaz` or alias `mz`
+
+## 📦 Installation
+
+Run directly with `npx` without global install:
+
+```bash
+npx minimaz init my-site
+cd my-site
+npx minimaz build
+```
+
+Or using the alias:
+
+```bash
+npx mz init my-site
+npx mz build
+```
+
+## 📁 Project Structure
+
+```txt
+my-site/
+├── src/               # HTML, CSS, JS, TS files
+├── public/            # Static assets (images, fonts, etc.)
+├── dist/              # Output folder (generated)
+├── minimaz.config.json
+└── ...
+```
+
+## ⚙️ Configuration
+
+Customize your build using a `minimaz.config.json` file:
+
+```json
+{
+  "src": "src",
+  "dist": "dist",
+  "public": "public",
+  "minify": {
+    "html": true,
+    "css": true,
+    "js": true,
+    "ts": true
+  },
+  "replace": {
+    "../public/": "public/"
+  },
+  "styles": [
+    "style.css",
+    "theme.css"
+  ],
+  "scripts": [
+    "lib.js",
+    "script.js"
+  ]
+}
+```
+
+- `styles` (optional): array of `.css` files to concatenate and minify into a single `style.css`
+- `scripts` (optional): array of `.js` files to concatenate and minify into a single `script.js`
+- If omitted, fallback defaults are `style.css` and `script.js`
+
+## 🛠 Commands
+
+```bash
+minimaz init <project-name>       # Create a new project using global templates
+minimaz build                     # Build and minify the site (uses config or defaults)
+minimaz template <path>           # Save a new template from specified path (or current dir)
+minimaz template -l               # List available templates
+minimaz template -d <name>        # Delete a saved template
+minimaz help                      # Show help message
+```
+
+_All commands also work with the alias `mz`._
+
+## 📂 Templates
+
+Minimaz supports global templates stored in:
+
+```bash
+~/.minimaz/templates
+```
+
+Use them to quickly initialize consistent projects across environments.
+
+## 📄 License
+
+MIT

package/dist/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{fileURLToPath as n}from"url";import{dirname as r,join as s}from"path";import m from"fs-extra";import{build as p}from"../src/commands/build.js";import{init as c}from"../src/commands/init.js";import{help as l}from"../src/commands/help.js";import{template as d}from"../src/commands/template.js";import{log as a}from"../src/utils/logService.js";import{parseArgs as f}from"../src/utils/functions.js";const g=n(import.meta.url),u=r(g),v=s(u,"../package.json"),h=await m.readJson(v),y=h.version;async function _(){const e=f(process.argv.slice(2)),i=(e._[0]||"").toLowerCase(),o={init:async()=>{await c(e._[1]||"minimaz-project",{template:e.template||e.t||"default"})},build:async()=>p(),help:()=>l(),template:async()=>{await d(e._[1],{list:e.l||e.list,delete:e.d||e.delete,update:e.u||e.update})},version:()=>console.log(y),i:()=>o.init(),b:()=>o.build(),h:()=>o.help(),t:()=>o.template()};try{o[i]?await o[i]():(a("error",`Unknown command '${i}'. Use 'minimaz help' to see available commands.`),o.help())}catch(t){a("error",t instanceof Error?process.env.DEBUG?t.stack??t.message:t.message:String(t)),process.exit(1)}}_();

package/dist/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "minimaz-cli",
+  "version": "0.1.0",
+  "description": "Minimal project initializer and builder CLI",
+  "author": "MrZeller",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zeller-dev/minimaz-cli.git"
+  },
+  "keywords": [
+    "cli",
+    "minimal",
+    "build",
+    "init",
+    "project",
+    "starter"
+  ],
+  "homepage": "https://github.com/zeller-dev/minimaz-cli#readme",
+  "bugs": {
+    "url": "https://github.com/zeller-dev/minimaz-cli/issues"
+  },
+  "dependencies": {
+    "clean-css": "^5.3.3",
+    "fs-extra": "^11.3.0",
+    "html-minifier-terser": "^7.2.0",
+    "terser": "^5.44.0"
+  },
+  "postinstall": "node ./dist/src/utils/postInstall.js",
+  "bin": {
+    "minimaz": "./bin/cli.js",
+    "mz": "./bin/cli.js"
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "minimaz-cli",
+  "version": "0.1.0",
+  "description": "Minimal project initializer and builder CLI",
+  "author": "MrZeller",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "dev": "node --loader ts-node/esm bin/cli.ts",
+    "build": "node builder.js",
+    "postinstall:dev": "node --loader ts-node/esm ./src/utils/postInstall.ts",
+    "postinstall:prod": "node ./dist/src/utils/postInstall.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zeller-dev/minimaz-cli.git"
+  },
+  "bin": {
+    "minimaz": "./dist/bin/cli.js",
+    "mz": "./dist/bin/cli.js"
+  },
+  "keywords": [
+    "cli",
+    "minimal",
+    "build",
+    "init",
+    "project",
+    "starter"
+  ],
+  "homepage": "https://github.com/zeller-dev/minimaz-cli#readme",
+  "bugs": {
+    "url": "https://github.com/zeller-dev/minimaz-cli/issues"
+  },
+  "dependencies": {
+    "clean-css": "^5.3.3",
+    "fs-extra": "^11.3.0",
+    "html-minifier-terser": "^7.2.0",
+    "terser": "^5.44.0"
+  },
+  "devDependencies": {
+    "@types/clean-css": "^4.2.11",
+    "@types/fs-extra": "^11.0.4",
+    "@types/html-minifier-terser": "^7.0.2",
+    "@types/node": "^24.7.2",
+    "esbuild": "^0.25.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "postinstall": "node ./dist/src/utils/postInstall.js"
+}

package/src/commands/build.ts

@@ -0,0 +1,176 @@
+import fs from 'fs-extra'
+import path from 'path'
+import CleanCSS from 'clean-css'
+import { minify as minifyHtml } from 'html-minifier-terser'
+import { minify as minifyJs, MinifyOutput } from 'terser'
+
+import { loadConfig } from '../utils/loadConfig.js'
+import { log } from '../utils/logService.js'
+import { applyReplacements, getFile } from '../utils/functions.js'
+
+/**
+ * Build the project according to configuration.
+ */
+export async function build(): Promise<void> {
+  try {
+    const config: any = await loadConfig()
+    const distDir: string = path.resolve(process.cwd(), config.dist || 'dist')
+
+    // Remove previous dist folder and recreate it
+    await fs.remove(distDir)
+    await fs.ensureDir(distDir)
+
+    /**
+     * Process a single folder
+     * @param srcPathRel Relative path of the source folder
+     * @param destName Destination folder name inside dist
+     */
+    async function processFolder(srcPathRel: string, destName: any): Promise<void> {
+      const fullSrc: string = path.resolve(process.cwd(), srcPathRel)
+      const fullDest: string = path.join(distDir, destName)
+
+      if (!(await fs.pathExists(fullSrc))) {
+        log('warn', `Folder not found: ${srcPathRel}`)
+        return
+      }
+
+      const cssChunks: string[] = []
+      const jsChunks: string[] = []
+
+      // Recursive walk function to process files
+      async function walk(src: string, dest: string): Promise<void> {
+        await fs.ensureDir(dest)
+
+        for (const item of await fs.readdir(src)) {
+          const srcPath: string = path.join(src, item)
+          const destPath: string = path.join(dest, item)
+          const stat: fs.Stats = await fs.stat(srcPath)
+          const ext: string = path.extname(item).toLowerCase()
+
+          if (stat.isDirectory()) {
+            await walk(srcPath, destPath)
+            continue
+          }
+
+          try {
+            switch (ext) {
+              case '.html': {
+                let content: string = await getFile(srcPath, config.replace)
+                if (config.minify?.html) {
+                  content = await minifyHtml(content, {
+                    collapseWhitespace: true,
+                    removeComments: true,
+                    minifyJS: config.minify?.ts,
+                    minifyCSS: config.minify?.css
+                  })
+                }
+                await fs.outputFile(destPath, content)
+                break
+              }
+
+              case '.css': {
+                const content: string = await getFile(srcPath, config.replace)
+                cssChunks.push(content)
+                break
+              }
+
+              case '.js': {
+                const content: string = await getFile(srcPath, config.replace)
+                jsChunks.push(content)
+                break
+              }
+              /*
+              case '.ts': {
+                const result = await esbuild.build({
+                  entryPoints: [srcPath],
+                  bundle: false,
+                  minify: !!config.minify?.ts,
+                  platform: 'browser',
+                  format: 'esm',
+                  write: false
+                })
+                let compiled = result.outputFiles[0].text
+                compiled = applyReplacements(compiled, config.replace)
+                if (srcPathRel === config.src) jsChunks.push(compiled)
+                break
+              }
+              */
+              default:
+                await fs.copy(srcPath, destPath)
+                break
+            }
+          } catch (error: any) {
+            log('error', `Failed to process file: ${srcPath} - ${error.message}`)
+          }
+        }
+      }
+
+      await walk(fullSrc, fullDest)
+
+      // Merge CSS/JS only for the root source folder
+      if (srcPathRel === config.src) {
+        try {
+          if (config.styles?.length) {
+            for (const style of config.styles) {
+              const fullPath: string = path.resolve(process.cwd(), style)
+              if (await fs.pathExists(fullPath)) {
+                let css: string = await fs.readFile(fullPath, 'utf-8')
+                css = applyReplacements(css, config.replace)
+                cssChunks.push(css)
+              } else {
+                log('warn', `Style file not found: ${style}`)
+              }
+            }
+          }
+
+          if (config.scripts?.length) {
+            for (const script of config.scripts) {
+              const fullPath: string = path.resolve(process.cwd(), script)
+              if (await fs.pathExists(fullPath)) {
+                let js: string = await fs.readFile(fullPath, 'utf-8')
+                js = applyReplacements(js, config.replace)
+                jsChunks.push(js)
+              } else {
+                log('warn', `Script file not found: ${script}`)
+              }
+            }
+          }
+
+          // Write final CSS bundle
+          if (cssChunks.length > 0) {
+            let finalCss: string = cssChunks.join('')
+            if (config.minify?.css) finalCss = new CleanCSS().minify(finalCss).styles
+            await fs.outputFile(path.join(distDir, 'style.css'), finalCss)
+          }
+
+          // Write final JS bundle
+          if (jsChunks.length > 0) {
+            let finalJs: string = jsChunks.join('')
+            if (config.minify?.js) {
+              const minified: MinifyOutput = await minifyJs(finalJs)
+              finalJs = minified.code ?? ''
+            }
+            if (finalJs) await fs.outputFile(path.join(distDir, 'script.js'), finalJs)
+          }
+        } catch (error: any) {
+          log('error', `Failed to merge CSS/JS: ${error.message}`)
+        }
+      }
+
+      log('success', `Processed folder: ${srcPathRel} -> /${destName}`)
+    }
+
+    // Process all folders defined in configuration
+    if (config.folders && Object.keys(config.folders).length > 0) {
+      for (const [srcPathRel, destName] of Object.entries(config.folders)) {
+        await processFolder(srcPathRel, destName)
+      }
+    } else {
+      log('warn', 'No folders defined in config. Nothing to build.')
+    }
+
+    log('success', `Build completed. Output saved in /${config.dist}`)
+  } catch (error: any) {
+    log('error', `Build failed: ${error.message}`)
+  }
+}

package/src/commands/help.ts

@@ -0,0 +1,33 @@
+/**
+ * Displays CLI usage information for Minimaz.
+ * Lists all available commands and their options.
+ *
+ * Example:
+ *   minimaz init my-site -t default
+ *   minimaz build
+ *   minimaz template --list
+ */
+export function help(): void {
+  console.log([
+    'Usage:',
+    '',
+    '\tminimaz init | i <project-name>',
+    '\t\tCreate a new project (default: "minimaz-site")',
+    '\t\tOptions:',
+    '\t\t\t--template | -t <template-name>\tUse a global template (default: "default")',
+    '',
+    '\tminimaz build | b',
+    '\t\tBuild and minify files into the dist folder',
+    '',
+    '\tminimaz template | t [path]',
+    '\t\tSave current folder as a template (no path = current folder)',
+    '\t\tOptions:',
+    '\t\t\t--list | -l\tList available global templates',
+    '\t\t\t--delete | -d <template-name>\tDelete a global template',
+    '',
+    '\tminimaz help | h',
+    '\t\tShow this help message'
+  ].join('\n'));
+}
+
+// @TODO add help for each command

package/src/commands/init.ts

@@ -0,0 +1,56 @@
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+import { log } from '../utils/logService.js'
+import { createGlobalDir } from '../utils/functions.js'
+
+/**
+ * Initializes a new Minimaz project by copying a predefined template
+ * from the user's global Minimaz directory (~/.minimaz/templates).
+ *
+ * @param projectName - The name of the project folder to create.
+ * @param options - Optional settings (e.g. { template: 'landing' }).
+ *
+ * Process:
+ * 1. Ensures the global `.minimaz` directory exists.
+ * 2. Locates the chosen template inside `.minimaz/templates`.
+ * 3. Copies the template files to the new project folder.
+ * 4. Adds `.gitignore` if available.
+ * 5. Logs actions and errors.
+ */
+export async function init(projectName: string, options: any = {}): Promise<void> {
+  const minimazDir: string = path.join(os.homedir(), '.minimaz')
+
+  // Step 1: Create global folder if missing
+  if (!await fs.pathExists(minimazDir)) {
+    log('info', `Global folder '${minimazDir}' not found. Creating...`)
+    await createGlobalDir()
+  }
+
+  // Step 2: Determine paths
+  const templateDir: string = path.join(minimazDir, 'templates', options.template || 'default')
+  const targetDir: string = path.resolve(process.cwd(), projectName)
+
+  // Step 3: Validate template existence
+  if (!await fs.pathExists(templateDir))
+    throw new Error(`Template '${options.template}' not found.`)
+
+  try {
+    // Step 4: Copy template files to target directory
+    await fs.copy(templateDir, targetDir)
+
+    // Step 5: Copy .gitignore if available at the parent level
+    const gitignoreSrc: string = path.join(templateDir, '..', 'gitignore')
+    const gitignoreDest: string = path.join(targetDir, '.gitignore')
+    if (await fs.pathExists(gitignoreSrc)) {
+      await fs.copy(gitignoreSrc, gitignoreDest)
+      log('info', `.gitignore added to project.`)
+    }
+
+    // Step 6: Confirm success
+    log('success', `Project '${projectName}' created using template '${options.template}'.`)
+  } catch (error: any) {
+    // Step 7: Handle any failure during copy
+    throw new Error(`Failed to create project: ${error.message}`)
+  }
+}