create-tateru-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel Sitek
+
+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,30 @@
+# Create Tateru CLI project
+
+Simplest way to create a new project using [tateru-cli](https://github.com/danielsitek/tateru-cli).
+
+## Usage
+
+```sh
+npm create tateru-cli@latest
+```
+
+You can also specify project name and template via additional command line options.
+
+```sh
+npm create tateru-cli@latest -- --template gulp-vanilla
+```
+
+```sh
+npm create tateru-cli@latest -- --template gulp-vanilla project-name
+```
+
+You can use `.` for the name of the project to be created in the current directory.
+
+Currently supported templates include:
+
+-   `gulp-vanilla`
+
+## Notes
+
+-   If the destination directory is not empty, the script will exit with an error.
+-   Ensure the template name is valid; otherwise, the script will notify you.

package/lib/cli/cli.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = commands;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const DEFAULT_TEMPLATE_NAME = 'gulp-vanilla';
+const DEFAULT_DIRECTORY = 'tateru-cli-starter';
+const HELP_MESSAGE = `
+Create a new Tateru CLI project with ease.
+
+Usage:
+  npx create-tateru-cli [OPTIONS] [ARGS] [DIRECTORY]
+
+Options:
+  -t, --template NAME       Set build environment (dev or prod). Default is dev.
+  -h, --help                Display help and usage details.
+  -V, --version             Display Tateru CLI version.
+
+Available templates:
+  gulp-vanilla              Basic template with gulp workflow.
+`;
+/**
+ * Prints the help message.
+ */
+function printHelp() {
+    console.log(HELP_MESSAGE);
+}
+/**
+ * Parses command-line arguments and returns options.
+ * If --help or --version is provided, it prints output and exits the process.
+ *
+ * @param basePath The base path of the project. Used to locale package.json file.
+ */
+function commands(basePath) {
+    return new Promise((resolve, reject) => {
+        const args = process.argv.slice(2);
+        const options = {
+            template: DEFAULT_TEMPLATE_NAME,
+            directory: DEFAULT_DIRECTORY,
+        };
+        // Get package.json data
+        const packageJsonPath = node_path_1.default.resolve(basePath, 'package.json');
+        const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf-8'));
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            switch (arg) {
+                case '--help':
+                case '-h':
+                    printHelp();
+                    resolve(null);
+                    break;
+                case '--version':
+                case '-V':
+                    console.log(packageJson.version);
+                    resolve(null);
+                    break;
+                case '--template':
+                case '-t':
+                    if (args[i + 1] && !args[i + 1].startsWith('-')) {
+                        options.template = args[i + 1] || DEFAULT_TEMPLATE_NAME;
+                        i++;
+                    }
+                    else {
+                        console.error('Error: Missing value for --template.');
+                        reject();
+                    }
+                    break;
+                default:
+                    if (arg.startsWith('-')) {
+                        console.error(`Error: Unknown option "${arg}"\n`);
+                        console.log(`Run "npm create tateru-cli@latest -- --help" to see available options.\n`);
+                        reject();
+                    }
+                    if (!arg.startsWith('-')) {
+                        options.directory = arg;
+                    }
+                    break;
+            }
+        }
+        resolve(options);
+    });
+}

package/lib/index.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const cli_1 = require("./cli/cli");
+const promises_2 = __importDefault(require("node:readline/promises"));
+const getTemplatePath = (template) => {
+    return node_path_1.default.resolve(__dirname, '..', 'templates', `template-${template}`);
+};
+const getDestinationPath = (directory) => {
+    return node_path_1.default.resolve(process.cwd(), directory);
+};
+const validateInputs = (template, directory) => {
+    if (!template) {
+        throw new Error('Error: Template name is required.');
+    }
+    if (!directory) {
+        throw new Error('Error: Destination directory is required.');
+    }
+};
+const ensureDirectoryEmpty = (directory) => __awaiter(void 0, void 0, void 0, function* () {
+    if ((0, node_fs_1.existsSync)(directory)) {
+        const files = yield (0, promises_1.readdir)(directory);
+        if (files.length > 0) {
+            const rl = promises_2.default.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            const answer = yield rl.question(`Warning: Destination directory "${directory}" is not empty. Do you want to continue? (y/N): `);
+            rl.close();
+            if (answer.toLowerCase() !== 'y') {
+                throw new Error('Operation aborted.');
+            }
+        }
+    }
+    else {
+        yield (0, promises_1.mkdir)(directory, { recursive: true });
+    }
+});
+const copyTemplate = (templatePath, destinationPath) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield (0, promises_1.cp)(templatePath, destinationPath, { recursive: true });
+    }
+    catch (error) {
+        throw new Error([
+            'Error copying template:',
+            error.message,
+        ].toString());
+    }
+});
+const beginMessage = (template, directory) => {
+    return `
+Copying template "${template}" to destination "${directory}"...
+`;
+};
+const doneMessage = (directory) => {
+    return `
+Done. Template successfully copied. Now run:
+
+cd ${directory}
+npm install
+npm start
+`;
+};
+const init = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const result = yield (0, cli_1.commands)(node_path_1.default.resolve(__dirname, '..'));
+        if (!result) {
+            process.exit(0);
+            return;
+        }
+        const { template, directory } = result;
+        validateInputs(template, directory);
+        console.log(beginMessage(template, directory));
+        const templatePath = getTemplatePath(template);
+        const destinationPath = getDestinationPath(directory);
+        if (!(0, node_fs_1.existsSync)(templatePath)) {
+            throw new Error(`Error: Template "${template}" not found.`);
+        }
+        yield ensureDirectoryEmpty(destinationPath);
+        yield copyTemplate(templatePath, destinationPath);
+        console.log(doneMessage(directory));
+    }
+    catch (error) {
+        console.error('Unexpected error:', error.message);
+        process.exit(1);
+    }
+});
+init();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "create-tateru-cli",
+  "description": "Create basic Tateru CLI project from template files",
+  "version": "0.1.0",
+  "bin": {
+    "create-tateru-cli": "./lib/index.js"
+  },
+  "files": [
+    "lib",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf lib",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "tateru-cli",
+    "static-site-generator",
+    "static-site",
+    "create-tateru-cli"
+  ],
+  "author": {
+    "name": "Daniel Sitek",
+    "email": "dan.sitek@gmail.com",
+    "url": "https://danielsitek.cz"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "devDependencies": {
+    "@types/node": "20.11",
+    "typescript": "^5.8.2"
+  },
+  "homepage": "https://github.com/danielsitek/tateru-create-tateru-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danielsitek/tateru-create-tateru-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danielsitek/tateru-create-tateru-cli/issues"
+  }
+}

package/templates/template-gulp-vanilla/.babelrc

@@ -0,0 +1,12 @@
+{
+  "presets": [
+    [
+      "@babel/preset-env",
+      {
+        "targets": {
+          "node": "current"
+        }
+      }
+    ]
+  ]
+}

package/templates/template-gulp-vanilla/.editorconfig

@@ -0,0 +1,23 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{js,jsx,ts,tsx,vue}]
+indent_size = 2
+quote_type = single
+
+[*.{json,yml,babelrc}]
+indent_size = 2
+
+[*.{twig,html,svg}]
+indent_size = 4
+
+[*.{scss,css}]
+indent_size = 4

package/templates/template-gulp-vanilla/.eslintignore

@@ -0,0 +1,2 @@
+node_modules/**/*
+dist/**/*

package/templates/template-gulp-vanilla/.eslintrc.js

@@ -0,0 +1,19 @@
+module.exports = {
+  'env': {
+    'browser': true,
+    'es6': true,
+    'node': true,
+  },
+  'globals': {
+    'Atomics': 'readonly',
+    'SharedArrayBuffer': 'readonly',
+  },
+  'parserOptions': {
+    'ecmaVersion': 2018,
+    'sourceType': 'module',
+  },
+  'rules': {
+    quotes: ['error', 'single', { 'allowTemplateLiterals': true }],
+    indent: ['error', 2],
+  }
+};

package/templates/template-gulp-vanilla/.gitattributes

@@ -0,0 +1,12 @@
+# Set default behaviour to automatically normalize line endings.
+* text=auto
+
+# Force bash scripts to always use lf line endings so that if a repo is accessed
+# in Unix via a file share from Windows, the scripts will work.
+*.sh text eol=lf
+
+*.js    eol=lf
+*.jsx   eol=lf
+*.json  eol=lf
+*.ts    eol=lf
+*.vue   eol=lf

package/templates/template-gulp-vanilla/.gitlab-ci.yml

@@ -0,0 +1,43 @@
+image: node:14
+
+stages:
+  - setup
+  - build
+  - deploy
+
+cache:
+  key: ${CI_COMMIT_REF_SLUG}
+  paths:
+    - node_modules
+
+# Setup Stage
+setup:
+  stage: setup
+  script:
+    - npm ci
+  only:
+    - master
+    - merge_requests
+
+# Build Stage
+build:website:
+  stage: build
+  artifacts:
+    name: "build-website-{$CI_COMMIT_REF_SLUG}-{$CI_COMMIT_SHORT_SHA}"
+    paths:
+      - dist
+  script:
+    - npm run build:prod
+  only:
+    - master
+    - merge_requests
+
+# Deploy Stage
+deploy:production:
+  stage: deploy
+  environment:
+    name: production
+  only:
+    - master
+  script:
+    - echo "Deploy to Production"

package/templates/template-gulp-vanilla/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Daniel Sitek
+
+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/templates/template-gulp-vanilla/README.md

@@ -0,0 +1 @@
+# tateru-starter

package/templates/template-gulp-vanilla/gulpfile.js

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * @link https://github.com/gulpjs/gulp/tree/master/docs/recipes
+ */
+
+const { ENV_DEVELOPMENT, ENV_PRODUCTION } = require('./tasks/helpers/config');
+const { parallel, series } = require('gulp');
+const clean = require('./tasks/clean');
+const css = require('./tasks/css');
+const images = require('./tasks/images');
+const minifyCss = require('./tasks/minify-css');
+const publicAssets = require('./tasks/public-assets');
+const tateru = require('./tasks/tateru');
+const watch = require('./tasks/watch');
+const webpack = require('./tasks/webpack');
+
+process.env.NODE_ENV = ENV_DEVELOPMENT;
+
+const js = function js(cb) {
+  return series(
+    webpack,
+  )(cb);
+}
+
+const templates = function templates(cb) {
+  return series(
+    publicAssets,
+    tateru,
+  )(cb);
+}
+
+const build = function build(cb) {
+  return series(
+    clean,
+    parallel(
+      css,
+      images,
+      js,
+      templates,
+    ),
+  )(cb);
+}
+
+const dev = function dev(cb) {
+  process.env.NODE_ENV = ENV_DEVELOPMENT;
+
+  return series(
+    build,
+    watch,
+  )(cb);
+};
+
+const prod = function prod(cb) {
+  process.env.NODE_ENV = ENV_PRODUCTION;
+
+  return series(
+    build,
+    minifyCss,
+  )(cb);
+};
+
+module.exports = {
+  build,
+  clean,
+  css,
+  default: dev,
+  images,
+  js,
+  prod,
+  publicAssets,
+  templates,
+  watch,
+}