minimaz-cli 0.1.0

package/src/commands/template.ts

@@ -0,0 +1,146 @@
+import fs from 'fs-extra'
+import os from 'os'
+import path from 'path'
+import { log } from '../utils/logService.js'
+import { askQuestion, listTemplates, getGlobalNodeModulesPath } from '../utils/functions.js'
+
+/**
+ * Handles all template-related operations:
+ * - Save current folder as a global template
+ * - Update existing templates
+ * - Delete templates
+ * - Sync templates from node_modules
+ *
+ * @param targetPath - Optional path of the folder to save as template
+ * @param options - CLI flags (--list, --delete, --update, etc.)
+ */
+export async function template(targetPath?: string, options: any = {}): Promise<void> {
+  const templatesDir: string = path.join(os.homedir(), '.minimaz', 'templates')
+  const deleteName: string | undefined = options.delete || options.d
+  const updateName: string | undefined = options.update || options.u
+
+  if (deleteName) return await deleteTemplate(templatesDir, deleteName)
+  if (options.list || options.l) return await listTemplates(templatesDir)
+
+  // --- UPDATE MODE ---
+  if (updateName !== undefined) {
+    if (typeof updateName === 'string' && updateName.trim()) {
+      return await updateSingleTemplate(templatesDir, updateName.trim())
+    } else {
+      return await updateFromNodeModules(templatesDir)
+    }
+  }
+
+  // Default action: save current folder as a template
+  await saveTemplate(templatesDir, targetPath)
+}
+
+/**
+ * Updates a single template with files from the current working directory.
+ *
+ * @param templatesDir - Global templates directory (~/.minimaz/templates)
+ * @param templateName - Name of the template to update
+ */
+async function updateSingleTemplate(templatesDir: string, templateName: string): Promise<void> {
+  const sourceDir: string = path.resolve(process.cwd())
+  const targetDir: string = path.join(templatesDir, templateName)
+
+  if (!await fs.pathExists(targetDir))
+    throw new Error(`Template '${templateName}' not found in ~/.minimaz/templates`)
+
+  const answer: string = await askQuestion(`❓ Update template '${templateName}' with current directory? (Y/N) `)
+  if (answer !== 'y' && answer !== '') {
+    log('info', 'Update cancelled.')
+    return
+  }
+
+  try {
+    await fs.copy(sourceDir, targetDir, { overwrite: true })
+    log('success', `Template '${templateName}' updated from current directory.`)
+  } catch (error: any) {
+    throw new Error(`Failed to update '${templateName}': ${error.message}`)
+  }
+}
+
+/**
+ * Updates all templates from the global node_modules/minimaz/src/templates folder.
+ * This ensures the local templates are synced with the installed package.
+ *
+ * @param templatesDir - Global templates directory (~/.minimaz/templates)
+ */
+async function updateFromNodeModules(templatesDir: string): Promise<void> {
+  const nodeModulesPath: string = path.join(getGlobalNodeModulesPath(), 'src', 'templates')
+
+  if (!await fs.pathExists(nodeModulesPath)) throw new Error(`'node_modules/minimaz/src/templates' not found.`)
+
+  const items: string[] = await fs.readdir(nodeModulesPath)
+
+  const answer: string = await askQuestion(`⚠️ Update local templates overwriting them with defaults? (Y/N): `)
+  if (answer !== 'y' && answer !== '') {
+    log('info', 'Update cancelled.')
+    return
+  }
+
+  try {
+    for (const item of items) {
+      const src: string = path.join(nodeModulesPath, item)
+      const dest: string = path.join(templatesDir, item)
+      await fs.copy(src, dest, { overwrite: true })
+      log('success', `Updated '${item}'`)
+    }
+    log('info', `✨ All templates and files updated successfully.`)
+  } catch (error: any) {
+    throw new Error(`Update failed: ${error.message}`)
+  }
+}
+
+/**
+ * Deletes a global template by name from ~/.minimaz/templates.
+ *
+ * @param dir - Global templates directory
+ * @param name - Template name to delete
+ */
+async function deleteTemplate(dir: string, name: string): Promise<void> {
+  if (!name) throw new Error('No template name specified to delete.')
+  const target: string = path.join(dir, name)
+  if (!await fs.pathExists(target)) throw new Error(`Template not found: ${name}`)
+
+  const confirm = await askQuestion(`❓ Confirm delete '${name}'? (Y/N) `)
+  if (confirm.toLowerCase() !== 'y') {
+    log('info', 'Delete cancelled.')
+    return
+  }
+
+  try {
+    await fs.remove(target)
+    log('success', `Template '${name}' deleted.`)
+  } catch (error: any) {
+    throw new Error(`Delete error: ${error.message}`)
+  }
+}
+
+/**
+ * Saves a folder (current or specified) as a new global template.
+ *
+ * @param dir - Global templates directory (~/.minimaz/templates)
+ * @param targetPath - Optional path to save as a template
+ */
+async function saveTemplate(dir: string, targetPath?: string): Promise<void> {
+  let source: string = targetPath ? path.resolve(process.cwd(), targetPath) : process.cwd()
+
+  if (!await fs.pathExists(source)) {
+    log('warn', `Path not found: ${source}`)
+    const answer: string = (await askQuestion('❓ Use current directory instead? (Y/N):\t')).trim().toLowerCase()
+    if (answer !== 'y' && answer !== '') throw new Error('Operation cancelled.')
+    source = process.cwd()
+  }
+
+  try {
+    await fs.ensureDir(dir)
+    const dest: string = path.join(dir, path.basename(source))
+    await fs.copy(source, dest)
+    log('success', `Template saved to ${dest}`)
+  } catch (error: any) {
+    throw new Error(`Failed to save template: ${error.message}`)
+  }
+}

package/src/templates/default/minimaz.config.json

@@ -0,0 +1,26 @@
+{
+    "src": "src",
+    "dist": "dist",
+    "public": "public",
+    "minify": {
+        "html": true,
+        "css": true,
+        "js": true,
+        "ts": true
+    },
+    "replace": {
+        "../public/": "public/"
+    },
+    "styles": [
+        "style.css",
+        "style-2.css"
+    ],
+    "scripts": [
+        "script.js",
+        "script-2.js"
+    ],
+    "folders": {
+        "src": "",
+        "public": "public"
+    }
+}

package/src/templates/default/src/index.html

@@ -0,0 +1,80 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Welcome to Minimaz</title>
+  <link rel="stylesheet" href="style.css" />
+  <link rel="icon" href="../public/favicon.ico" type="image/x-icon" />
+</head>
+<body>
+  <header>
+    <nav>
+      <a class="btn active" href="#">Home</a>
+      <a class="btn" href="pages/about.html">About</a>
+      <a class="btn" href="https://github.com/zeller-dev/minimaz" target="_blank">GitHub</a>
+    </nav>
+  </header>
+
+  <main class="container">
+    <h1>🚀 Welcome to Minimaz</h1>
+    <p><strong>Minimaz</strong> is a minimal static site builder designed for speed and simplicity. It helps you:</p>
+    <ul>
+      <li>💡 Organize your files with a simple structure</li>
+      <li>⚙️ Automatically build and minify HTML, CSS, JS, and TS</li>
+      <li>🔄 Customize file inclusion order using <code>minimaz.config.json</code></li>
+    </ul>
+
+    <h2>🔧 Getting Started</h2>
+    <p>Install and use Minimaz with the following commands:</p>
+    <pre><code># 🔨 Initialize a new project
+npx minimaz init my-site
+
+# 🏗️ Build the site
+npx minimaz build
+
+# 📦 Save template or list/delete existing ones
+npx minimaz template &lt;path&gt; [--list|-l] [--delete|-d]
+
+# 💬 Show help guide
+npx minimaz help</code></pre>
+
+    <h2>📁 Project Structure</h2>
+    <pre><code>my-site/
+├── src/                  # Source files (HTML, CSS, JS, TS)
+├── public/               # Static assets (images, fonts, etc.)
+├── dist/                 # Output directory (auto-generated)
+└── minimaz.config.json   # Configuration file</code></pre>
+
+    <h2>⚙️ Configuration</h2>
+    <pre><code>{
+  "src": "src",
+  "dist": "dist",
+  "public": "public",
+  "minify": { "html": true, "css": true, "js": true, "ts": true },
+  "replace": { "../public/": "public/" },
+  "styles": [ "reset.css", "style.css", "theme.css" ],
+  "scripts": [ "libs/jquery.js", "utils.js", "script.js" ]
+}</code></pre>
+
+    <h2>📤 Production</h2>
+    <p>The final output will be generated in the <code>dist/</code> folder, ready for deployment.</p>
+
+    <h2>❓ Available Commands</h2>
+    <ul>
+      <li><code>init</code> / <code>i</code> – Initialize a new project</li>
+      <li><code>build</code> / <code>b</code> – Build and minify the project</li>
+      <li><code>help</code> / <code>h</code> – Show the help message</li>
+      <li><code>template</code> / <code>t</code> – Manage templates (with <code>--list</code> and <code>--delete</code> options)</li>
+    </ul>
+
+    <p>You're ready to build fast and clean static websites. Happy coding! 🛠️</p>
+  </main>
+
+  <footer>
+    <p>&copy; 2025 Minimaz. All rights reserved.</p>
+  </footer>
+
+  <script src="script.js"></script>
+</body>
+</html>

package/src/templates/default/src/pages/about.html

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Welcome to Minimaz</title>
+    <link rel="stylesheet" href="../style.css" />
+    <link rel="shortcut icon" href="../../public/favicon.ico" type="image/x-icon">
+
+</head>
+
+<body>
+    <header>
+        <nav>
+            <a class='btn' href="../index.html">Home</a>
+            <a class='btn active' href="pages/about.html">About</a>
+            <a class='btn' target="_blank" href="https://github.com/zeller-dev/minimaz">GitHub</a>
+        </nav>
+    </header>
+    <div class="container">
+        <h1>About Minimaz</h1>
+        <p><strong>Minimaz</strong> is a minimal build tool that helps you quickly scaffold and minify HTML, CSS, and
+            JavaScript projects.</p>
+
+        <h2>Features</h2>
+        <ul>
+            <li>Zero-config HTML/CSS/JS minification</li>
+            <li>Folder structure based on <code>src</code>, <code>public</code>, and <code>dist</code></li>
+            <li>Simple CLI with <code>init</code>, <code>build</code>, and <code>help</code> commands</li>
+        </ul>
+
+        <h2>Getting Started</h2>
+        <pre><code>$ minimaz init my-project
+$ cd my-project
+$ minimaz build</code></pre>
+
+        <p>Learn more or contribute on <a href="#">GitHub</a>.</p>
+    </div>
+    <footer>
+        <p>&copy; 2023 Minimaz. All rights reserved.</p>
+    </footer>
+    <script src="../script.js"></script>
+</body>
+
+</html>

package/src/templates/default/src/script.js

@@ -0,0 +1 @@
+console.log('Minimaz is ready!')

package/src/templates/default/src/style.css

@@ -0,0 +1,99 @@
+:root {
+  --primary-color: #338ca8;
+  --background-color: #222;
+  --foreground-color: #f5f5f5;
+  --code-bg: #333;
+  --code-text: #eeeeff;
+  font-size: 16px;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+header,
+footer {
+  background-color: var(--code-bg);
+  padding:1rem;
+}
+
+body {
+  font-family: 'Segoe UI', sans-serif;
+  margin: 0;
+  background: var(--background-color);
+  color: var(--foreground-color);
+  line-height: 1.6;
+}
+
+.container {
+  max-width: 800px;
+  margin: auto;
+  padding: 1rem;
+}
+
+h1,
+h2,
+h3 {
+  color: var(--primary-color);
+  margin-top: 2rem;
+}
+
+p {
+  margin: 1rem 0;
+}
+
+code {
+  background: var(--code-bg);
+  color: var(--code-text);
+  padding: 0.2rem 0.4rem;
+  border-radius: 4px;
+  font-family: monospace;
+}
+
+pre {
+  background: var(--code-bg);
+  color: #ddd;
+  padding: 1rem;
+  overflow-x: auto;
+  border-radius: 6px;
+  font-family: monospace;
+  border-left: 4px solid var(--primary-color);
+}
+
+a {
+  color: var(--primary-color);
+  text-decoration: none;
+}
+
+.btn {
+  transition: all 0.15s ease-in-out;
+  background-color: var(--primary-color);
+  border: none;
+  color: #fff;
+  padding: 10px 20px;
+  font-size: 1rem;
+  margin: .5rem .2rem;
+  cursor: pointer;
+  border-radius: 5px;
+  display: inline-block;
+  text-align: center;
+}
+
+.btn:hover {
+  opacity: 0.85;
+}
+
+.btn.active {
+  background-color: var(--code-bg);
+  color: #fff;
+  pointer-events: none;
+}
+
+header {
+  font-weight: 600;
+}
+
+footer p {
+  text-align: center;
+  margin: 0;
+}

package/src/templates/gitignore

@@ -0,0 +1,2 @@
+dist
+.vscode

package/src/templates/simple/minimaz.config.json

@@ -0,0 +1,26 @@
+{
+    "src": "src",
+    "dist": "dist",
+    "public": "public",
+    "minify": {
+        "html": true,
+        "css": true,
+        "js": true,
+        "ts": true
+    },
+    "replace": {
+        "../public/": "public/"
+    },
+    "styles": [
+        "style.css",
+        "style-2.css"
+    ],
+    "scripts": [
+        "script.js",
+        "script-2.js"
+    ],
+    "folders": {
+        "src": "",
+        "public": "public"
+    }
+}

package/src/templates/simple/src/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Welcome to Minimaz</title>
+  <link rel="stylesheet" href="style.css" />
+</head>
+
+<body>
+  <script src="script.js"></script>
+</body>
+
+</html>

package/src/templates/simple/src/pages/page.html

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Document</title>
+</head>
+<body>
+
+</body>
+</html>

package/src/templates/simple/src/script.js

@@ -0,0 +1 @@
+console.log('Minimaz is ready!')

package/src/utils/functions.ts

@@ -0,0 +1,161 @@
+import readline from 'readline'
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+import { log } from './logService.js'
+import { execSync } from 'child_process'
+
+// ----- Types -----
+interface Args {
+  _: string[]
+  [key: string]: string | boolean | string[]
+}
+
+// ----- Parse CLI Arguments -----
+// Converts raw process arguments into structured key-value pairs
+export function parseArgs(rawArgs: string[]): Args {
+  const args: Args = { _: [] }
+  for (let i = 0; i < rawArgs.length; i++) {
+    const arg: string = rawArgs[i]
+    if (arg.startsWith('-')) {
+      const key: string = arg.startsWith('--') ? arg.slice(2) : arg.slice(1)
+      const next: string = rawArgs[i + 1]
+      const hasValue: boolean = !!next && !next.startsWith('-')
+      args[key] = hasValue ? next : true
+      if (hasValue) i++
+    } else {
+      args._.push(arg)
+    }
+  }
+  return args
+}
+
+// ----- Ask Question from CLI -----
+// Prompts the user with a question and returns the input
+export function askQuestion(query: string): Promise<string> {
+  return new Promise(resolve => {
+    const rl: readline.Interface = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+    rl.question(query, answer => {
+      rl.close()
+      resolve(answer.trim())
+    })
+  })
+}
+
+// ----- List Templates -----
+// Displays all available global templates in the given directory
+export async function listTemplates(dir: string): Promise<void> {
+  if (!await fs.pathExists(dir)) {
+    log('info', 'No templates directory found.')
+    return
+  }
+
+  const templates: string[] = await fs.readdir(dir)
+  if (templates.length === 0) log('info', 'No global templates available.')
+  else {
+    log('info', 'Available global templates:')
+    templates.forEach(t => log('info', `- ${t}`))
+  }
+}
+
+// ----- Apply Replacements -----
+// Replaces all occurrences of keys in content with their corresponding values
+export function applyReplacements(content: string, replacements: Record<string, string> = {}): string {
+  for (const [from, to] of Object.entries(replacements)) {
+    content = content.split(from).join(to)
+  }
+  return content
+}
+
+// ----- Read File with Replacements -----
+// Reads a file and applies string replacements if provided
+export async function getFile(srcPath: string, replace?: Record<string, string>): Promise<string> {
+  try {
+    let file: string = await fs.readFile(srcPath, 'utf-8')
+    if (replace) file = applyReplacements(file, replace)
+    return file
+  } catch (error: any) {
+    log('error', `Failed to read file ${srcPath}: ${error.message}`)
+    return ''
+  }
+}
+
+// ----- Global Node Modules Path -----
+// Returns the path to global node_modules depending on the platform
+
+export function getGlobalNodeModulesPath(): string {
+  try {
+    const prefix = execSync('npm config get prefix', { encoding: 'utf-8' }).trim();
+    if (!prefix) throw new Error('Empty prefix');
+    return process.platform === 'win32'
+      ? path.join(prefix, 'node_modules', 'minimaz-cli')
+      : path.join(prefix, 'lib', 'node_modules', 'minimaz-cli');
+  } catch {
+    // fallback
+    return process.platform === 'win32'
+      ? path.join(process.env.APPDATA || '', 'npm', 'node_modules', 'minimaz-cli')
+      : '/usr/local/lib/node_modules/minimaz-cli';
+  }
+}
+
+
+// ----- Create Global Templates Folder -----
+// Creates ~/.minimaz/templates and copies default templates if folder is empty
+export async function createGlobalDir(): Promise<void> {
+  const minimazDir = path.join(os.homedir(), '.minimaz')
+  const globalTemplatesDir = path.join(minimazDir, 'templates')
+  const defaultTemplatesDir = path.join(getGlobalNodeModulesPath(), 'src', 'templates')
+  const settingsPath = path.join(minimazDir, 'settings.json')
+
+  console.log(defaultTemplatesDir)
+
+  // ----- Ensure node_modules path exists (fallback for portable setups) -----
+
+  try {
+    // ----- Ensure minimaz dir exists -----
+    await fs.ensureDir(minimazDir)
+
+    // ----- Create settings.json if missing -----
+    if (!await fs.pathExists(settingsPath)) {
+      const defaultSettings = {
+        createdAt: new Date().toISOString(),
+        templatesPath: globalTemplatesDir,
+        npmGlobalPath: getGlobalNodeModulesPath()
+      }
+      await fs.outputJson(settingsPath, defaultSettings, { spaces: 2 })
+      log('success', `Created settings.json at ${settingsPath}`)
+    }
+
+    // ----- Check if templates folder exists -----
+    const exists = await fs.pathExists(globalTemplatesDir)
+    const isEmpty = exists ? (await fs.readdir(globalTemplatesDir)).length === 0 : true
+
+    if (!exists) {
+      await fs.ensureDir(globalTemplatesDir)
+      log('success', 'Created global templates directory.')
+    }
+
+    // ----- Skip copy if not empty -----
+    if (!isEmpty) {
+      log('info', 'Global templates directory not empty. Skipping copy.')
+      return
+    }
+
+    const templates: string[] = await fs.readdir(defaultTemplatesDir)
+
+    console.log(templates)
+    // ----- Copy default templates -----
+    for (const name of await fs.readdir(defaultTemplatesDir)) {
+      await fs.copy(path.join(defaultTemplatesDir, name), path.join(globalTemplatesDir, name))
+      log('success', `Copied template '${name}'.`)
+    }
+
+    log('success', 'Default templates setup completed.')
+  } catch (error: any) {
+    log('error', `Failed to create global templates directory: ${error.message}`)
+    throw error
+  }
+}