@nutin/cli 1.3.0 → 2.0.0

package/lib/src/context-builder.mjs

@@ -1,35 +0,0 @@
-import { getCiCommand } from './package-manager.mjs';
-import { packageVersion } from './version.mjs';
-
-export const defaults = {
-  projectName: 'my-nutin-app',
-  packageManager: 'npm',
-  stylinNutin: true,
-  template: true,
-  i18n: false,
-  deployHelper: false,
-  testinNutin: false,
-  transition: false
-};
-
-export class ContextBuilder {
-	buildContext(answers) { 
-    const version = packageVersion;
-    const ciCommand = getCiCommand(answers.packageManager);
-
-    return {
-      projectName: answers.projectName,
-      packageManager: answers.packageManager,
-      
-      template: answers.template ?? defaults.template,
-      stylinNutin: answers.stylinNutin ?? defaults.stylinNutin,
-      i18n: answers.i18n ?? defaults.i18n,
-      deployHelper: answers.deployHelper ?? defaults.deployHelper,
-      testinNutin: answers.testinNutin ?? defaults.testinNutin,
-      transition: answers.transition ?? defaults.transition,
-
-      ciCommand: ciCommand,
-      version: version
-    };
-  }
-}

package/lib/src/file-generator.mjs

@@ -1,109 +0,0 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-import * as fsExtra from 'fs-extra';
-import { TemplateCompiler } from './template-compiler.mjs';
-import { print } from './print.mjs';
-
-const fs = fsExtra.default;
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const BINARY_EXTENSIONS = new Set([
-  '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.svg',
-  '.ico', '.woff', '.woff2', '.ttf', '.otf', '.eot',
-  '.mp4', '.webm', '.mp3', '.wav', '.ogg',
-  '.pdf', '.zip', '.tar', '.gz'
-]);
-
-export class FileGenerator {
-  constructor() {
-    this.compiler = new TemplateCompiler();
-  }
-
-  async generateProjectFromTemplates(projectPath, context) {
-    const templateDir = this.getTemplateDirectory();
-    
-    print.section('📝 Processing templates...');
-    await this.processTemplateDirectory(templateDir, projectPath, context);
-    
-    await this.processFeatureTemplates(projectPath, context);
-  }
-
-  getTemplateDirectory() {
-    return path.join(__dirname, '..', '..', 'templates', 'base');
-  }
-
-  async processTemplateDirectory(templateDir, outputDir, context) {
-    if (!(await fs.pathExists(templateDir))) {
-      throw new Error(`Template directory not found: ${templateDir}`);
-    }
-
-    const entries = await fs.readdir(templateDir, { withFileTypes: true });
-    
-    for (const entry of entries) {
-      if (entry.name === '.DS_Store') continue;
-      
-      const templatePath = path.join(templateDir, entry.name);
-      
-      if (entry.isDirectory()) {
-        const outputPath = path.join(outputDir, entry.name);
-        await fs.ensureDir(outputPath);
-        await this.processTemplateDirectory(templatePath, outputPath, context);
-      } else {
-        await this.processTemplateFile(templatePath, outputDir, entry.name, context);
-      }
-    }
-  }
-
-  async processFeatureTemplates(projectPath, context) {
-    const featuresDir = path.join(__dirname, '..', '..', 'templates', 'features');
-    
-    if (!(await fs.pathExists(featuresDir))) {
-      return;
-    }
-
-    const features = [ 'template', 'i18n', 'stylinNutin', 'testinNutin', 'deployHelper' ];
-    
-    for (const feature of features) {
-      if (context[feature]) {
-        const featureTemplateDir = path.join(featuresDir, feature);
-        
-        if (await fs.pathExists(featureTemplateDir)) {
-          print.info(`  🔧 Adding ${feature} feature...`);
-          await this.processTemplateDirectory(featureTemplateDir, projectPath, context);
-        }
-      }
-    }
-  }
-
-  async processTemplateFile(templatePath, outputDir, fileName, context) {
-    if (fileName.includes("test.js") && !(context.testinNutin)) {
-      return;
-    }
-
-    const fileExt = path.extname(fileName).toLowerCase();
-    
-    if (BINARY_EXTENSIONS.has(fileExt)) {
-      const outputPath = path.join(outputDir, fileName);
-      await fs.copy(templatePath, outputPath);
-      // print.info(`📄 Copied: ${fileName}`);
-    } else if (fileName.endsWith('.hbs')) {
-
-      const outputFileName = fileName.replace('.hbs', '');
-      const outputPath = path.join(outputDir, outputFileName);
-      
-      try {
-        const compiledContent = await this.compiler.compileFile(templatePath, context);
-        await fs.writeFile(outputPath, compiledContent);
-        // print.info(`📝 Generated: ${outputFileName}`);
-      } catch (error) {
-        print.boldError(`❌ Failed to process template: ${fileName}`);
-        throw error;
-      }
-    } else {
-      const outputPath = path.join(outputDir, fileName);
-      await fs.copy(templatePath, outputPath);
-      // print.info(`📄 Copied: ${fileName}`);
-    }
-  }
-}

package/lib/src/json-generator.mjs

@@ -1,31 +0,0 @@
-import path from 'path';
-import * as fsExtra from 'fs-extra';
-import { generatePackageJson, generateTsconfigJson } from './package-manager.mjs';
-
-const fs = fsExtra.default;
-
-export class JsonGenerator {
-  async generateJsonFiles(projectPath, context) {
-    await generatePackageJson(projectPath, context);
-    await generateTsconfigJson(projectPath, context);
-    this.generateConfigFiles(projectPath, context);
-  }
-
-  async generateConfigFiles(projectPath, context) {
-    const configPath = path.join(projectPath, 'config');
-    
-    if (context.i18n) {
-      await fs.ensureDir(configPath); 
-      await this.generateLanguageConfig(configPath);
-    }
-  }
-
-  async generateLanguageConfig(configPath) {
-    const languages = {
-      "languages": [ "en" ],
-      "defaultLanguage": "en"
-    };
-
-    await fs.writeJSON(path.join(configPath, 'languages.json'), languages, { spaces: 2 });    
-  }
-}

package/lib/src/package-manager.mjs

@@ -1,139 +0,0 @@
-import { promiseExec } from './utils.mjs';
-import { print } from './print.mjs';
-import * as fsExtra from 'fs-extra';
-import * as path from 'path';
-
-const fs = fsExtra.default;
-
-export async function installDependencies(projectPath, packageManager) {
-  print.section(`📦 Installing dependencies with ${packageManager}...`);
-  
-  const installCommand = getInstallCommand(packageManager);
-  await promiseExec(installCommand, { cwd: projectPath });
-}
-
-export function getCiCommand(packageManager) {
-  switch (packageManager) {
-    case 'yarn':
-      return 'yarn install --frozen-lockfile';
-    case 'pnpm':
-      return 'pnpm install --frozen-lockfile';
-    case 'bun':
-      return 'bun install --frozen-lockfile'
-    default:
-      return 'npm ci';
-  }
-}
-
-function getInstallCommand(packageManager) {
-  switch (packageManager) {
-    case 'yarn':
-      return 'yarn install';
-    case 'pnpm':
-      return 'pnpm install';
-    case 'bun':
-      return 'bun install'
-    default:
-      return 'npm install';
-  }
-}
-
-function getScripts(context) {
-  const { testinNutin, packageManager, projectName, deployHelper } = context;
-
-  const baseScripts = {
-    "build": "node tools/builder/builder.js",
-    "build:prod": "NODE_ENV=production node tools/builder/builder.js",
-    "serve:only": "node tools/dev/serve.js",
-    "serve": `${packageManager} run build && ${packageManager} run serve:only`,
-    "dev": "node tools/dev/dev-serve.js",
-    "generate": "node tools/generator/generator.js"
-  };
-
-  const deployHelperScripts = {
-    "docker:build": `docker build -t ${projectName} -f tools/deployment/Dockerfile .`,
-    "docker:run": `docker run -p 9090:9090 ${projectName}:latest`,
-    "patch": `${packageManager} version patch -m 'CI/CD: Bump version to %s'`,
-    "minor": `${packageManager} version minor -m 'CI/CD: Bump version to %s'`,
-    "major": `${packageManager} version major -m 'CI/CD: Bump version to %s'`
-  }
-
-  const testinNutinScripts = {
-    "test": "node testin-nutin/runner.js",
-    "test:rebuild": `${packageManager} run build && ${packageManager} run test`,
-    "test:watch": `${packageManager} run build && node testin-nutin/watch-tests.js`
-  }
-
-  let scripts = { ...baseScripts };
-
-  if (testinNutin) scripts = { ...scripts, ...testinNutinScripts };
-  if (deployHelper) scripts = { ...scripts, ...deployHelperScripts };
-
-  return scripts;
-}
-
-export async function generatePackageJson(projectPath, context) {
-  const { testinNutin, projectName } = context;
-
-  const devDependencies = {
-    "chokidar": "^4.0.3",
-    "esbuild": "^0.25.12",
-    "html-minifier-terser": "^7.2.0",
-    "live-server": "^1.2.2",
-    "sass": "^1.89.0",
-    "typescript": "^5.8.3",
-    ...(testinNutin && {
-      "jsdom": "^26.1.0",
-    })
-  };
-
-  const scripts = getScripts(context);
-
-  const packageJson = {
-    "name": projectName,
-    "version": "0.1.0",
-    "type": "module",
-    ...(testinNutin && {
-      "imports": {
-        "#root/*.js": "./*.js"
-      }
-    }),
-    scripts,
-    devDependencies,
-    ...(testinNutin && {
-      "engines": {
-        "node": ">=20.19.0"
-      }
-    })
-  };
-  
-  await fs.writeJSON(path.join(projectPath, 'package.json'), packageJson, { spaces: 2 });
-}
-
-export async function generateTsconfigJson(projectPath, context) {
-  const tsconfig = {
-      "compilerOptions": {
-      "baseUrl": "./",
-      "paths": {},
-      "target": "ESNext",
-      "module": "NodeNext",
-      "moduleResolution": "NodeNext",
-      "rootDir": "src",
-      "outDir": "dist-build/src",
-      "strict": true,
-      "skipLibCheck": true,
-      "forceConsistentCasingInFileNames": true,
-      "noUncheckedIndexedAccess": true,
-      "esModuleInterop": true,
-      "allowSyntheticDefaultImports": true,
-      "lib": ["es2022", "DOM"],
-      "removeComments": true,
-      "resolveJsonModule": true,
-      "typeRoots": ["src/types", "node_modules/@types"]
-    },
-    "include": ["src/app", "src/core", "src/libs"],
-    "exclude": ["node_modules"]
-  };
-  
-  await fs.writeJSON(path.join(projectPath, 'tsconfig.json'), tsconfig, { spaces: 2 });
-}

package/lib/src/print.mjs

@@ -1,31 +0,0 @@
-export const chalk = {
-  green: (s) => `\x1b[32m${s}\x1b[0m`,
-  red: (s) => `\x1b[31m${s}\x1b[0m`,
-  blue: (s) => `\x1b[34m${s}\x1b[0m`,
-  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
-  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
-  purple: (s) => `\x1b[35m${s}\x1b[0m`,
-  gray: (s) => `\x1b[90m${s}\x1b[0m`,
-  boldGreen: (s) => `\x1b[1;32m${s}\x1b[0m`,
-  boldRed: (s) => `\x1b[1;31m${s}\x1b[0m`,
-  boldBlue: (s) => `\x1b[1;34m${s}\x1b[0m`,
-  boldYellow: (s) => `\x1b[1;33m${s}\x1b[0m`,
-  boldCyan: (s) => `\x1b[1;36m${s}\x1b[0m`,
-  boldPurple: (s) => `\x1b[1;35m${s}\x1b[0m`,
-};
-
-export const print = {
-	head: (s) => console.log(`${chalk.purple(s)}`),  
-	boldHead : (s) => console.log(`${chalk.boldPurple(s)}`),
-	section: (s) => console.log(`${chalk.yellow(s)}`),
-	boldSection: (s) => console.log(`${chalk.boldYellow(s)}`),
-	info: (s) => console.log(`${chalk.green(s)}`),
-  boldInfo: (s) => console.log(`${chalk.boldGreen(s)}`),
-	success: (s) => console.log(`${chalk.cyan(s)}`),
-	boldSuccess: (s) => console.log(`${chalk.boldCyan(s)}`),
-	error: (s) => console.error(`${chalk.red(s)}`),
-	boldError: (s) => console.error(`${chalk.boldRed(s)}`),
-  grayError: (s) => console.error(`${chalk.gray(s)}`),
-  blue: (s) => console.log(`${chalk.blue(s)}`),
-  boldBlue: (s) => console.log(`${chalk.boldBlue(s)}`),
-}

package/lib/src/prompts.mjs

@@ -1,123 +0,0 @@
-import inquirer from 'inquirer';
-import { defaults } from './context-builder.mjs';
-
-export async function promptUser(initialName, cliOptions = {}) {
-
-  let projectName = initialName;
-  if (!projectName) {
-    const nameAnswer = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'projectName',
-        message: 'Project name:',
-        default: defaults.projectName,
-        validate: validateProjectName
-      }
-    ]);
-    projectName = nameAnswer.projectName;
-  }
-
-  let packageManager = cliOptions.packageManager;
-  if (!packageManager) {
-    const pmAnswer = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'packageManager',
-        message: 'Package manager:',
-        choices: ['npm', 'yarn', 'pnpm', 'bun'],
-        default: defaults.packageManager
-      }
-    ]);
-    packageManager = pmAnswer.packageManager;
-  }
-
-  if (cliOptions.defaults) {
-    return {
-      projectName,
-      packageManager,
-      stylinNutin: cliOptions.stylinNutin,
-      template: cliOptions.template,
-      i18n: cliOptions.i18n,
-      deployHelper: cliOptions.deployHelper,
-      testinNutin: cliOptions.testinNutin,
-      transition: cliOptions.transitions
-    };
-  }
-
-  const questions = [];
-
-  if (cliOptions.stylinNutin === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'stylinNutin',
-      message: 'Use built-in SCSS utility classes ?',
-      default: defaults.stylinNutin
-    });
-  }
-
-  if (cliOptions.template === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'template',
-      message: 'Use external templates ?',
-      default: defaults.template
-    });
-  }
-
-  if (cliOptions.i18n === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'i18n',
-      message: 'Use i18n with json-based content ?',
-      default: defaults.i18n
-    });
-  }
-
-  if (cliOptions.deployHelper === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'deployHelper',
-      message: 'Use Docker & deployment helpers ?',
-      default: defaults.deployHelper
-    });
-  }
-
-  if (cliOptions.testinNutin === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'testinNutin',
-      message: 'Use testin-nutin toolkit?',
-      default: defaults.testinNutin
-    });
-  }
-
-  if (cliOptions.transition === undefined) {
-    questions.push({
-      type: 'confirm',
-      name: 'transition',
-      message: 'Use animated view transitions?',
-      default: defaults.transition
-    });
-  }
-
-  const answers = questions.length > 0 ? await inquirer.prompt(questions) : {};
-
-  return {
-    projectName,
-    packageManager,
-    template: cliOptions.template ?? answers.template,
-    stylinNutin: cliOptions.stylinNutin ?? answers.stylinNutin,
-    i18n: cliOptions.i18n ?? answers.i18n,
-    deployHelper: cliOptions.deployHelper ?? answers.deployHelper,
-    transition: cliOptions.transition ?? answers.transition,
-    testinNutin: cliOptions.testinNutin ?? answers.testinNutin
-  };
-}
-
-function validateProjectName(input) {
-  if (!input.trim()) return 'Project name is required';
-  if (!/^[a-z0-9-_]+$/.test(input)) {
-    return 'Use only lowercase letters, numbers, hyphens, and underscores';
-  }
-  return true;
-}

package/lib/src/utils.mjs

@@ -1,18 +0,0 @@
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { print } from './print.mjs';
-
-export const promiseExec = promisify(exec);
-
-export function displaySuccessMessage(answers) {
-  const { projectName, packageManager, deployHelper } = answers;
-  print.boldSuccess('\n🎉 Your project is ready!');
-  print.boldInfo(`Documentation on https://www.nutin.org`);
-
-  if (packageManager === 'pnpm' || packageManager === 'bun') {
-    if (deployHelper) print.boldError(`You'll need to modify the Dockerfile to support ${packageManager}`)
-  }
-
-  print.info('Next steps:');
-  print.info(`  cd ${projectName} && ${packageManager} run serve\n`);
-}

package/lib/src/version.mjs

@@ -1 +0,0 @@
-export const packageVersion = '1.3.0';

package/templates/base/builder.config.js.hbs

@@ -1,35 +0,0 @@
-export default {
-	esbuild: {
-    bundle: true,
-    minify: true,
-    sourcemap: false,
-    platform: 'browser',
-    format: 'esm',
-    target: ['es2015'],
-    legalComments: 'none',
-    loader: {
-      '.json': 'json',
-    },
-    define: {
-      'process.env.NODE_ENV': '"production"',
-    },
-	},
-  sass: {
-    paths: [ 
-      'base', 
-      'core',
-{{#if stylinNutin}}
-      'components',
-      'views',
-{{/if}}
-    ], // in styles/
-  },
-{{#if deployHelper}}
-  compression: {
-    gzip: true,
-    // BROTLI OPTIONAL
-    // brotli: false,
-  },
-{{/if}}
-	verbose: false,
-}

package/templates/base/src/app/components/common/anchor/anchor.component.ts.hbs

@@ -1,32 +0,0 @@
-import { AnchorManager, Component, IAnchorConfig } from '../../../../core/index.js';
-
-/**
- * ```typescript
- * interface IAnchorConfig {
-  // prefix href with '#' for internal anchor
-  href: string;
-  target?: string;
-  textContent?: string;
-{{#if i18n}}
-  i18nKey?: string;
-{{/if}}
-  className?: string;
-  style?: string;
-  // use regular pipe syntax for arguments / chaining
-  pipes?: string;
-  tagName?: keyof HTMLElementTagNameMap;
-}
-```
-*/
-export class AnchorComponent extends Component<HTMLAnchorElement, IAnchorConfig> {
-
-  constructor(mountTarget: HTMLElement, config: IAnchorConfig) {
-    super({
-      mountTarget,
-      tagName: config.tagName,
-      config,
-      normalizeKeys: ['style', 'pipes', 'className']
-    });
-    new AnchorManager(config, this.element);
-  }
-}

package/templates/base/src/app/components/common/button/button.component.ts.hbs

@@ -1,40 +0,0 @@
-import { BaseButton, Component } from '../../../../core/index.js';
-
-/**
- * ```typescript
- interface IAttributesConfig {
-  {{#if i18n}}
-  i18nKey?: string;
-  {{/if}}
-  textContent?: string;
-  className?: string;
-  style?: string;
-// use regular pipe syntax for arguments / chaining
-  pipes?: string;
-}
-
-interface BaseButton extends IAttributesConfig {
-  callback: () => void;
-}
-
-interface ButtonContainerOptions {
-  containerClassName?: string;
-  containerStyles?: string;
-}
-  ```
- * Note : To ensure 'this' is bound properly
- * ```typescript
- // Will handle 'this' inside doStuff
- * { callback: () => this.doStuff() }
- * // Will still work, but won't handle 'this' inside doStuff
- * { callback: this.doStuff }
- * ```
-*/
-export class ButtonComponent extends Component<HTMLButtonElement> {
-  constructor(mountTarget: HTMLElement, button: BaseButton) {
-    super({
-      mountTarget,
-      props: { buttons: [button] }
-    });
-  }
-}

package/templates/base/src/app/dom.test.js.hbs

@@ -1,13 +0,0 @@
-describe('App container', () => {
-  it('should be defined', () => {
-    const appContainer = document.getElementById('app');
-    expect(appContainer).toBeDefined();
-  });
-  it('should have title', () => {
-    expect(document.title).toEqual('{{projectName}}');
-  });
-  it('should have meta description', () => {
-    const desc = document.querySelector('meta[name="description"]').content;
-    expect(desc).toEqual('{{projectName}}');
-  });
-});

package/templates/base/src/app/services/example/example.service.ts.hbs

@@ -1,18 +0,0 @@
-import { Service } from "../../../core/index.js";
-
-export class Example extends Service<Example> {
-  constructor() {
-    super();
-    this.registerCallback();
-  }
-
-  protected registerCallback(): void { 
-    console.debug('No cleanup callbacks registered for service: Example')
-  }
-
-  protected onDestroy(): void {
-    this.dispose();
-  }
-}
-
-export const exampleService = Example.getInstance();

package/templates/base/src/app/views/home/home.view.test.js.hbs

@@ -1,26 +0,0 @@
-import { HomeView } from '#root/dist/src/app/views/index.js';
-
-let view;
-
-describe('HomeView', () => {
-	beforeAll(() => {
-		view = new HomeView();
-	});
-
-	it('should be defined', () => {
-		expect(view).toBeDefined();
-	});
-	{{#if i18n}}
-	it('should have title with i18n key', () => {
-		const h1 = view.element.querySelector('h1');
-		expect(h1).toBeDefined();
-		expect(h1.textContent).toBe('home.title');		
-	});
-	{{else}}
-	it('should have title', () => {
-		const h1 = view.element.querySelector('h1');
-		expect(h1).toBeDefined();
-		expect(h1.textContent).toBe('{{projectName}}');		
-	});
-	{{/if}}
-})

package/templates/base/src/core/services/store/store.test.js.hbs

@@ -1,8 +0,0 @@
-import { AppStore } from '#root/dist/src/core/services/index.js'
-
-describe('store', () => {
-  it('should set & get values properly', () => {
-    AppStore.set('foo', 123);
-    expect(AppStore.get('foo')).toBe(123)
-  });
-})