@tiveor/scg 0.2.0 → 0.5.0

package/dist/index.js

@@ -0,0 +1,373 @@
+import {
+  FileHelper,
+  Scaffold,
+  StringHelper,
+  TEMPLATE_HANDLERS,
+  TemplateBuilder
+} from "./chunk-XKYTW4HW.js";
+
+// src/command_helper.ts
+import { exec } from "child_process";
+var FORBIDDEN_PATTERNS = [
+  /[;&|`$]/,
+  // shell metacharacters
+  /\$\(/,
+  // command substitution
+  />\s*\//,
+  // redirect to absolute path
+  /\.\.\//
+  // path traversal
+];
+var CommandHelper = class _CommandHelper {
+  /**
+   * Executes one or more shell commands in the given directory.
+   * Multiple commands are joined with `&&` (sequential execution).
+   *
+   * @param directory - Working directory for command execution
+   * @param command - One or more command strings to execute
+   * @returns A promise resolving to the command's stdout (or stderr if stdout is empty)
+   * @throws If the directory is empty, no commands are provided, or a command matches a forbidden pattern
+   *
+   * @example
+   * ```typescript
+   * const output = await CommandHelper.run('.', 'echo hello');
+   * // => "hello\n"
+   *
+   * const result = await CommandHelper.run('.', 'git add .', 'git status');
+   * ```
+   */
+  static run(directory, ...command) {
+    if (!directory) {
+      return Promise.reject(new Error("directory is required"));
+    }
+    if (command.length === 0) {
+      return Promise.reject(new Error("at least one command is required"));
+    }
+    for (const cmd of command) {
+      for (const pattern of FORBIDDEN_PATTERNS) {
+        if (pattern.test(cmd)) {
+          return Promise.reject(
+            new Error(
+              `potentially unsafe command rejected: "${cmd}" matches forbidden pattern ${pattern}`
+            )
+          );
+        }
+      }
+    }
+    return new Promise((resolve, reject) => {
+      const cmd = command.join(" && ");
+      exec(
+        cmd,
+        { cwd: directory, maxBuffer: 1024 * 1024 * 100 },
+        (err, stdout, stderr) => {
+          if (err) {
+            reject(err);
+            return;
+          }
+          if (stderr) {
+            resolve(stderr);
+            return;
+          }
+          resolve(stdout);
+        }
+      );
+    });
+  }
+  /**
+   * Executes commands and returns the output with newlines stripped.
+   *
+   * @param folder - Working directory for command execution
+   * @param command - One or more command strings to execute
+   * @returns A promise resolving to the cleaned output (no newlines)
+   *
+   * @example
+   * ```typescript
+   * const version = await CommandHelper.runClean('.', 'node --version');
+   * // => "v20.10.0"
+   * ```
+   */
+  static runClean(folder, ...command) {
+    return _CommandHelper.run(folder, ...command).then((result) => {
+      return result ? result.replace(/\r?\n|\r/g, "") : "";
+    });
+  }
+};
+
+// src/param_helper.ts
+var ParamHelper = class {
+  /**
+   * Appends a custom parameter string to `process.argv`.
+   *
+   * @param customParam - The parameter to add (e.g., `'--env=production'`)
+   */
+  static addCustomParam(customParam) {
+    process.argv.push(customParam);
+  }
+  /**
+   * Retrieves the command-line argument at the given index.
+   *
+   * @param index - Zero-based index into `process.argv`
+   * @returns The argument at the given index, or `''` if out of bounds
+   */
+  static getCommandByIndex(index) {
+    return process.argv.length > index ? process.argv[index] : "";
+  }
+  /**
+   * Parses all `--key=value` parameters from `process.argv` into an object.
+   * Surrounding quotes on values are stripped automatically.
+   *
+   * @returns An object mapping parameter names to their string values
+   *
+   * @example
+   * ```typescript
+   * // node script.js --name=Alice --port=3000
+   * ParamHelper.getParams();
+   * // => { name: "Alice", port: "3000" }
+   * ```
+   */
+  static getParams() {
+    const paramsObj = {};
+    process.argv.slice(2).forEach((element) => {
+      const matches = element.match("--([a-zA-Z0-9]+)=(.*)");
+      if (matches) {
+        paramsObj[matches[1]] = matches[2].replace(/^['"]/, "").replace(/['"]$/, "");
+      }
+    });
+    return paramsObj;
+  }
+};
+
+// src/pipeline.ts
+import fs from "fs";
+import path from "path";
+var Pipeline = class {
+  content = null;
+  contentPromise = null;
+  transforms = [];
+  /**
+   * Sets the pipeline content from a raw string.
+   *
+   * @param source - The string content
+   * @returns This pipeline instance for chaining
+   */
+  fromString(source) {
+    this.content = source;
+    this.contentPromise = null;
+    return this;
+  }
+  /**
+   * Sets the pipeline content by reading a file synchronously.
+   *
+   * @param filePath - Path to the file to read
+   * @returns This pipeline instance for chaining
+   */
+  fromFile(filePath) {
+    this.content = fs.readFileSync(filePath, "utf8");
+    this.contentPromise = null;
+    return this;
+  }
+  /**
+   * Sets the pipeline content by rendering a template file.
+   * If no engine is specified, it is auto-detected from the file extension.
+   *
+   * @param templatePath - Path to the template file
+   * @param data - Data to pass to the template
+   * @param engine - Template engine name (auto-detected if omitted)
+   * @param options - Optional engine-specific options
+   * @returns This pipeline instance for chaining
+   */
+  fromTemplate(templatePath, data, engine, options) {
+    const ext = engine ?? extToEngine(templatePath);
+    const builder = new TemplateBuilder(ext);
+    this.contentPromise = builder.renderFile(templatePath, data, options);
+    this.content = null;
+    return this;
+  }
+  /**
+   * Sets the pipeline content by rendering a template from a source string.
+   *
+   * @param source - The template source string
+   * @param data - Data to pass to the template
+   * @param engine - The template engine name
+   * @param options - Optional engine-specific options
+   * @returns This pipeline instance for chaining
+   */
+  fromTemplateString(source, data, engine, options) {
+    const builder = new TemplateBuilder(engine);
+    this.contentPromise = builder.render(source, data, options);
+    this.content = null;
+    return this;
+  }
+  /**
+   * Adds a transformation function to the pipeline.
+   * Transforms are executed sequentially in the order they are added.
+   *
+   * @param fn - A sync or async function that receives and returns a string
+   * @returns This pipeline instance for chaining
+   */
+  transform(fn) {
+    this.transforms.push(fn);
+    return this;
+  }
+  /**
+   * Executes the pipeline: resolves the content and applies all transforms.
+   *
+   * @returns A promise resolving to the final transformed string
+   * @throws If no content source has been set
+   */
+  async execute() {
+    let result;
+    if (this.contentPromise) {
+      result = await this.contentPromise;
+    } else if (this.content !== null) {
+      result = this.content;
+    } else {
+      throw new Error(
+        "Pipeline has no content. Call fromString(), fromFile(), or fromTemplate() first."
+      );
+    }
+    for (const fn of this.transforms) {
+      result = await fn(result);
+    }
+    return result;
+  }
+  /**
+   * Executes the pipeline and writes the result to a file.
+   * Creates parent directories automatically if they don't exist.
+   *
+   * @param filePath - Path to the output file
+   * @returns A promise resolving to the written content
+   */
+  async writeTo(filePath) {
+    const result = await this.execute();
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, result, "utf8");
+    return result;
+  }
+};
+function extToEngine(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  switch (ext) {
+    case ".ejs":
+      return "EJS";
+    case ".hbs":
+    case ".handlebars":
+      return "HANDLEBARS";
+    case ".pug":
+    case ".jade":
+      return "PUG";
+    default:
+      return "HANDLEBARS";
+  }
+}
+
+// src/watcher.ts
+import fs2 from "fs";
+import path2 from "path";
+var Watcher = class {
+  options;
+  abortController = null;
+  /**
+   * Creates a new Watcher instance.
+   *
+   * @param options - Watcher configuration
+   */
+  constructor(options) {
+    this.options = {
+      extensions: [".ejs", ".hbs", ".handlebars", ".pug"],
+      ...options
+    };
+  }
+  /**
+   * Starts watching the template directory for changes.
+   * Does nothing if the watcher is already running.
+   */
+  start() {
+    if (this.abortController) {
+      return;
+    }
+    this.abortController = new AbortController();
+    const { signal } = this.abortController;
+    if (!fs2.existsSync(this.options.outputDir)) {
+      fs2.mkdirSync(this.options.outputDir, { recursive: true });
+    }
+    try {
+      const watcher = fs2.watch(this.options.templateDir, {
+        recursive: true,
+        signal
+      });
+      watcher.on("change", (_eventType, filename) => {
+        if (!filename) return;
+        const filePath = path2.join(
+          this.options.templateDir,
+          filename.toString()
+        );
+        this.handleChange(filePath);
+      });
+      watcher.on("error", (err) => {
+        if (err.code !== "ABORT_ERR") {
+          this.options.onError?.(err, "");
+        }
+      });
+    } catch {
+    }
+  }
+  /**
+   * Stops watching for changes and cleans up resources.
+   */
+  stop() {
+    if (this.abortController) {
+      this.abortController.abort();
+      this.abortController = null;
+    }
+  }
+  /**
+   * Whether the watcher is currently active.
+   */
+  get isRunning() {
+    return this.abortController !== null;
+  }
+  async handleChange(filePath) {
+    const ext = path2.extname(filePath).toLowerCase();
+    if (!this.options.extensions.includes(ext)) {
+      return;
+    }
+    if (!fs2.existsSync(filePath)) {
+      return;
+    }
+    try {
+      const builder = new TemplateBuilder(this.options.engine);
+      const content = await builder.renderFile(
+        filePath,
+        this.options.variables,
+        {}
+      );
+      const relativePath = path2.relative(this.options.templateDir, filePath);
+      const outputName = relativePath.replace(ext, ".html");
+      const outputPath = path2.join(this.options.outputDir, outputName);
+      const outputDir = path2.dirname(outputPath);
+      if (!fs2.existsSync(outputDir)) {
+        fs2.mkdirSync(outputDir, { recursive: true });
+      }
+      fs2.writeFileSync(outputPath, content, "utf8");
+      this.options.onRebuild?.(outputPath);
+    } catch (error) {
+      this.options.onError?.(error, filePath);
+    }
+  }
+};
+export {
+  CommandHelper,
+  FileHelper,
+  ParamHelper,
+  Pipeline,
+  Scaffold,
+  StringHelper,
+  TEMPLATE_HANDLERS,
+  TemplateBuilder,
+  Watcher
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/command_helper.ts","../src/param_helper.ts","../src/pipeline.ts","../src/watcher.ts"],"sourcesContent":["import { exec } from 'child_process';\n\n/** @internal Patterns that indicate potentially unsafe shell commands. */\nconst FORBIDDEN_PATTERNS = [\n  /[;&|`$]/, // shell metacharacters\n  /\\$\\(/, // command substitution\n  />\\s*\\//, // redirect to absolute path\n  /\\.\\.\\// // path traversal\n];\n\n/**\n * Utility class for executing shell commands as promises with input sanitization.\n *\n * Commands are validated against a set of forbidden patterns (shell metacharacters,\n * command substitution, path traversal) before execution.\n *\n * @example\n * ```typescript\n * const output = await CommandHelper.run('.', 'echo hello');\n * const version = await CommandHelper.runClean('.', 'node --version');\n * ```\n */\nexport class CommandHelper {\n  /**\n   * Executes one or more shell commands in the given directory.\n   * Multiple commands are joined with `&&` (sequential execution).\n   *\n   * @param directory - Working directory for command execution\n   * @param command - One or more command strings to execute\n   * @returns A promise resolving to the command's stdout (or stderr if stdout is empty)\n   * @throws If the directory is empty, no commands are provided, or a command matches a forbidden pattern\n   *\n   * @example\n   * ```typescript\n   * const output = await CommandHelper.run('.', 'echo hello');\n   * // => \"hello\\n\"\n   *\n   * const result = await CommandHelper.run('.', 'git add .', 'git status');\n   * ```\n   */\n  static run(directory: string, ...command: string[]): Promise<string> {\n    if (!directory) {\n      return Promise.reject(new Error('directory is required'));\n    }\n    if (command.length === 0) {\n      return Promise.reject(new Error('at least one command is required'));\n    }\n\n    for (const cmd of command) {\n      for (const pattern of FORBIDDEN_PATTERNS) {\n        if (pattern.test(cmd)) {\n          return Promise.reject(\n            new Error(\n              `potentially unsafe command rejected: \"${cmd}\" matches forbidden pattern ${pattern}`\n            )\n          );\n        }\n      }\n    }\n\n    return new Promise((resolve, reject) => {\n      const cmd = command.join(' && ');\n      exec(\n        cmd,\n        { cwd: directory, maxBuffer: 1024 * 1024 * 100 },\n        (err, stdout, stderr) => {\n          if (err) {\n            reject(err);\n            return;\n          }\n\n          if (stderr) {\n            resolve(stderr);\n            return;\n          }\n\n          resolve(stdout);\n        }\n      );\n    });\n  }\n\n  /**\n   * Executes commands and returns the output with newlines stripped.\n   *\n   * @param folder - Working directory for command execution\n   * @param command - One or more command strings to execute\n   * @returns A promise resolving to the cleaned output (no newlines)\n   *\n   * @example\n   * ```typescript\n   * const version = await CommandHelper.runClean('.', 'node --version');\n   * // => \"v20.10.0\"\n   * ```\n   */\n  static runClean(folder: string, ...command: string[]): Promise<string> {\n    return CommandHelper.run(folder, ...command).then((result) => {\n      return result ? result.replace(/\\r?\\n|\\r/g, '') : '';\n    });\n  }\n}\n","/**\n * Utility class for parsing CLI parameters from `process.argv`.\n *\n * @example\n * ```typescript\n * // node script.js --name=Alice --port=3000\n * const params = ParamHelper.getParams();\n * // => { name: \"Alice\", port: \"3000\" }\n * ```\n */\nexport class ParamHelper {\n  /**\n   * Appends a custom parameter string to `process.argv`.\n   *\n   * @param customParam - The parameter to add (e.g., `'--env=production'`)\n   */\n  static addCustomParam(customParam: string): void {\n    process.argv.push(customParam);\n  }\n\n  /**\n   * Retrieves the command-line argument at the given index.\n   *\n   * @param index - Zero-based index into `process.argv`\n   * @returns The argument at the given index, or `''` if out of bounds\n   */\n  static getCommandByIndex(index: number): string {\n    return process.argv.length > index ? process.argv[index] : '';\n  }\n\n  /**\n   * Parses all `--key=value` parameters from `process.argv` into an object.\n   * Surrounding quotes on values are stripped automatically.\n   *\n   * @returns An object mapping parameter names to their string values\n   *\n   * @example\n   * ```typescript\n   * // node script.js --name=Alice --port=3000\n   * ParamHelper.getParams();\n   * // => { name: \"Alice\", port: \"3000\" }\n   * ```\n   */\n  static getParams(): Record<string, string> {\n    const paramsObj: Record<string, string> = {};\n    process.argv.slice(2).forEach((element) => {\n      const matches = element.match('--([a-zA-Z0-9]+)=(.*)');\n      if (matches) {\n        paramsObj[matches[1]] = matches[2]\n          .replace(/^['\"]/, '')\n          .replace(/['\"]$/, '');\n      }\n    });\n    return paramsObj;\n  }\n}\n","import fs from 'fs';\nimport path from 'path';\nimport { TemplateBuilder } from './template_builder.js';\nimport { type TemplateHandler } from './template_handlers.js';\n\n/** A function that transforms a string, optionally returning a promise. */\nexport type TransformFn = (content: string) => string | Promise<string>;\n\n/**\n * Chainable pipeline for composing template rendering and string transformations.\n *\n * Supports multiple input sources (string, file, template) and sequential\n * transforms before writing the result to a file or returning it.\n *\n * @example\n * ```typescript\n * const result = await new Pipeline()\n *   .fromTemplate('component.ejs', { name: 'Button' }, 'EJS')\n *   .transform((content) => content.toUpperCase())\n *   .writeTo('src/components/Button.tsx');\n * ```\n */\nexport class Pipeline {\n  private content: string | null = null;\n  private contentPromise: Promise<string> | null = null;\n  private transforms: TransformFn[] = [];\n\n  /**\n   * Sets the pipeline content from a raw string.\n   *\n   * @param source - The string content\n   * @returns This pipeline instance for chaining\n   */\n  fromString(source: string): Pipeline {\n    this.content = source;\n    this.contentPromise = null;\n    return this;\n  }\n\n  /**\n   * Sets the pipeline content by reading a file synchronously.\n   *\n   * @param filePath - Path to the file to read\n   * @returns This pipeline instance for chaining\n   */\n  fromFile(filePath: string): Pipeline {\n    this.content = fs.readFileSync(filePath, 'utf8');\n    this.contentPromise = null;\n    return this;\n  }\n\n  /**\n   * Sets the pipeline content by rendering a template file.\n   * If no engine is specified, it is auto-detected from the file extension.\n   *\n   * @param templatePath - Path to the template file\n   * @param data - Data to pass to the template\n   * @param engine - Template engine name (auto-detected if omitted)\n   * @param options - Optional engine-specific options\n   * @returns This pipeline instance for chaining\n   */\n  fromTemplate(\n    templatePath: string,\n    data: Record<string, unknown>,\n    engine?: TemplateHandler | string,\n    options?: Record<string, unknown>\n  ): Pipeline {\n    const ext = engine ?? extToEngine(templatePath);\n    const builder = new TemplateBuilder(ext);\n    this.contentPromise = builder.renderFile(templatePath, data, options);\n    this.content = null;\n    return this;\n  }\n\n  /**\n   * Sets the pipeline content by rendering a template from a source string.\n   *\n   * @param source - The template source string\n   * @param data - Data to pass to the template\n   * @param engine - The template engine name\n   * @param options - Optional engine-specific options\n   * @returns This pipeline instance for chaining\n   */\n  fromTemplateString(\n    source: string,\n    data: Record<string, unknown>,\n    engine: TemplateHandler | string,\n    options?: Record<string, unknown>\n  ): Pipeline {\n    const builder = new TemplateBuilder(engine);\n    this.contentPromise = builder.render(source, data, options);\n    this.content = null;\n    return this;\n  }\n\n  /**\n   * Adds a transformation function to the pipeline.\n   * Transforms are executed sequentially in the order they are added.\n   *\n   * @param fn - A sync or async function that receives and returns a string\n   * @returns This pipeline instance for chaining\n   */\n  transform(fn: TransformFn): Pipeline {\n    this.transforms.push(fn);\n    return this;\n  }\n\n  /**\n   * Executes the pipeline: resolves the content and applies all transforms.\n   *\n   * @returns A promise resolving to the final transformed string\n   * @throws If no content source has been set\n   */\n  async execute(): Promise<string> {\n    let result: string;\n\n    if (this.contentPromise) {\n      result = await this.contentPromise;\n    } else if (this.content !== null) {\n      result = this.content;\n    } else {\n      throw new Error(\n        'Pipeline has no content. Call fromString(), fromFile(), or fromTemplate() first.'\n      );\n    }\n\n    for (const fn of this.transforms) {\n      result = await fn(result);\n    }\n\n    return result;\n  }\n\n  /**\n   * Executes the pipeline and writes the result to a file.\n   * Creates parent directories automatically if they don't exist.\n   *\n   * @param filePath - Path to the output file\n   * @returns A promise resolving to the written content\n   */\n  async writeTo(filePath: string): Promise<string> {\n    const result = await this.execute();\n    const dir = path.dirname(filePath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n    fs.writeFileSync(filePath, result, 'utf8');\n    return result;\n  }\n}\n\n/** @internal Maps file extensions to engine names. */\nfunction extToEngine(filePath: string): string {\n  const ext = path.extname(filePath).toLowerCase();\n  switch (ext) {\n    case '.ejs':\n      return 'EJS';\n    case '.hbs':\n    case '.handlebars':\n      return 'HANDLEBARS';\n    case '.pug':\n    case '.jade':\n      return 'PUG';\n    default:\n      return 'HANDLEBARS';\n  }\n}\n","import fs from 'fs';\nimport path from 'path';\nimport { TemplateBuilder } from './template_builder.js';\n\n/** Configuration options for the file watcher. */\nexport interface WatcherOptions {\n  /** Directory containing template files to watch. */\n  templateDir: string;\n  /** Directory where rendered output files are written. */\n  outputDir: string;\n  /** Template engine to use for rendering (e.g., `'EJS'`, `'HANDLEBARS'`, `'PUG'`). */\n  engine: string;\n  /** Variables to pass to the template engine during rendering. */\n  variables: Record<string, unknown>;\n  /** File extensions to watch (defaults to `['.ejs', '.hbs', '.handlebars', '.pug']`). */\n  extensions?: string[];\n  /** Callback invoked after a file is successfully rebuilt. */\n  onRebuild?: (file: string) => void;\n  /** Callback invoked when a rebuild error occurs. */\n  onError?: (error: Error, file: string) => void;\n}\n\n/**\n * Watches a template directory and automatically re-renders templates when they change.\n *\n * Uses `fs.watch()` with `AbortController` for clean start/stop lifecycle.\n *\n * @example\n * ```typescript\n * const watcher = new Watcher({\n *   templateDir: './templates',\n *   outputDir: './generated',\n *   engine: 'EJS',\n *   variables: { project: 'MyApp' },\n *   onRebuild: (file) => console.log(`Rebuilt: ${file}`),\n *   onError: (err, file) => console.error(`Error in ${file}: ${err.message}`),\n * });\n *\n * watcher.start();\n * // Later: watcher.stop();\n * ```\n */\nexport class Watcher {\n  private options: WatcherOptions;\n  private abortController: AbortController | null = null;\n\n  /**\n   * Creates a new Watcher instance.\n   *\n   * @param options - Watcher configuration\n   */\n  constructor(options: WatcherOptions) {\n    this.options = {\n      extensions: ['.ejs', '.hbs', '.handlebars', '.pug'],\n      ...options\n    };\n  }\n\n  /**\n   * Starts watching the template directory for changes.\n   * Does nothing if the watcher is already running.\n   */\n  start(): void {\n    if (this.abortController) {\n      return;\n    }\n\n    this.abortController = new AbortController();\n    const { signal } = this.abortController;\n\n    if (!fs.existsSync(this.options.outputDir)) {\n      fs.mkdirSync(this.options.outputDir, { recursive: true });\n    }\n\n    try {\n      const watcher = fs.watch(this.options.templateDir, {\n        recursive: true,\n        signal\n      });\n\n      watcher.on('change', (_eventType, filename) => {\n        if (!filename) return;\n        const filePath = path.join(\n          this.options.templateDir,\n          filename.toString()\n        );\n        this.handleChange(filePath);\n      });\n\n      watcher.on('error', (err) => {\n        if ((err as NodeJS.ErrnoException).code !== 'ABORT_ERR') {\n          this.options.onError?.(err, '');\n        }\n      });\n    } catch {\n      // fs.watch not available\n    }\n  }\n\n  /**\n   * Stops watching for changes and cleans up resources.\n   */\n  stop(): void {\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n  }\n\n  /**\n   * Whether the watcher is currently active.\n   */\n  get isRunning(): boolean {\n    return this.abortController !== null;\n  }\n\n  private async handleChange(filePath: string): Promise<void> {\n    const ext = path.extname(filePath).toLowerCase();\n    if (!this.options.extensions!.includes(ext)) {\n      return;\n    }\n\n    if (!fs.existsSync(filePath)) {\n      return;\n    }\n\n    try {\n      const builder = new TemplateBuilder(this.options.engine);\n      const content = await builder.renderFile(\n        filePath,\n        this.options.variables,\n        {}\n      );\n\n      const relativePath = path.relative(this.options.templateDir, filePath);\n      const outputName = relativePath.replace(ext, '.html');\n      const outputPath = path.join(this.options.outputDir, outputName);\n\n      const outputDir = path.dirname(outputPath);\n      if (!fs.existsSync(outputDir)) {\n        fs.mkdirSync(outputDir, { recursive: true });\n      }\n\n      fs.writeFileSync(outputPath, content, 'utf8');\n      this.options.onRebuild?.(outputPath);\n    } catch (error) {\n      this.options.onError?.(error as Error, filePath);\n    }\n  }\n}\n"],"mappings":"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","names":["fs","path","fs","path"]}

package/package.json

@@ -1,14 +1,45 @@
 {
   "name": "@tiveor/scg",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "Simple Code Generator - A utility library for code generation and template processing",
-  "main": "index.js",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "bin": {
+    "scg": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
   "scripts": {
-    "test": "mocha ./test",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'test/**/*.ts'",
+    "docs": "typedoc",
+    "prepublishOnly": "npm run build",
     "example": "node example/index.js"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "keywords": [
     "code-generator",
@@ -18,7 +49,8 @@
     "handlebars",
     "pug",
     "file-helper",
-    "string-helper"
+    "string-helper",
+    "typescript"
   ],
   "repository": {
     "type": "git",
@@ -31,8 +63,19 @@
   },
   "homepage": "https://github.com/tiveor/scg#readme",
   "devDependencies": {
-    "mocha": "^8.3.0",
-    "prettier": "^2.2.1"
+    "@eslint/js": "^9.39.2",
+    "@types/ejs": "^3.1.5",
+    "@types/node": "^25.2.3",
+    "@types/pug": "^2.0.10",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
+    "eslint": "^9.39.2",
+    "prettier": "^2.8.8",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.16",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "ejs": "^3.1.6",

package/templates/express-route/controller.ejs

@@ -0,0 +1,35 @@
+import { Request, Response, NextFunction } from 'express';
+import { <%= name %>Service } from './<%= name %>.service';
+
+const service = new <%= name %>Service();
+
+export async function getAll(req: Request, res: Response, next: NextFunction) {
+  try {
+    const items = await service.findAll();
+    res.json(items);
+  } catch (error) {
+    next(error);
+  }
+}
+
+export async function getById(req: Request, res: Response, next: NextFunction) {
+  try {
+    const item = await service.findById(req.params.id);
+    if (!item) {
+      res.status(404).json({ message: '<%= name %> not found' });
+      return;
+    }
+    res.json(item);
+  } catch (error) {
+    next(error);
+  }
+}
+
+export async function create(req: Request, res: Response, next: NextFunction) {
+  try {
+    const item = await service.create(req.body);
+    res.status(201).json(item);
+  } catch (error) {
+    next(error);
+  }
+}

package/templates/express-route/routes.ejs

@@ -0,0 +1,10 @@
+import { Router } from 'express';
+import { getAll, getById, create } from './<%= name %>.controller';
+
+const router = Router();
+
+router.get('/', getAll);
+router.get('/:id', getById);
+router.post('/', create);
+
+export default router;

package/templates/express-route/scaffold.json

@@ -0,0 +1,13 @@
+{
+  "engine": "EJS",
+  "templateDir": "./templates/express-route",
+  "outputDir": "./src/routes/{{name}}",
+  "variables": {
+    "name": "User"
+  },
+  "structure": [
+    { "template": "routes.ejs", "output": "{{name}}.routes.ts" },
+    { "template": "controller.ejs", "output": "{{name}}.controller.ts" },
+    { "template": "service.ejs", "output": "{{name}}.service.ts" }
+  ]
+}

package/templates/express-route/service.ejs

@@ -0,0 +1,16 @@
+export class <%= name %>Service {
+  async findAll(): Promise<unknown[]> {
+    // TODO: Implement data fetching
+    return [];
+  }
+
+  async findById(id: string): Promise<unknown | null> {
+    // TODO: Implement find by id
+    return null;
+  }
+
+  async create(data: unknown): Promise<unknown> {
+    // TODO: Implement create
+    return data;
+  }
+}

package/templates/github-action/scaffold.json

@@ -0,0 +1,12 @@
+{
+  "engine": "EJS",
+  "templateDir": "./templates/github-action",
+  "outputDir": "./.github/workflows",
+  "variables": {
+    "name": "CI",
+    "branch": "main"
+  },
+  "structure": [
+    { "template": "workflow.ejs", "output": "{{name}}.yml" }
+  ]
+}

package/templates/github-action/workflow.ejs

@@ -0,0 +1,33 @@
+name: <%= name %>
+
+on:
+  push:
+    branches: [<%= branch %>]
+  pull_request:
+    branches: [<%= branch %>]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Test
+        run: npm test
+
+      - name: Build
+        run: npm run build

package/templates/react-component/component.ejs

@@ -0,0 +1,25 @@
+import React from 'react';
+<% if (style === 'module') { %>
+import styles from './<%= name %>.module.css';
+<% } %>
+
+export interface <%= name %>Props {
+  className?: string;
+  children?: React.ReactNode;
+}
+
+export const <%= name %>: React.FC<<%= name %>Props> = ({ className, children }) => {
+<% if (style === 'module') { %>
+  return (
+    <div className={`${styles.root} ${className ?? ''}`}>
+      {children}
+    </div>
+  );
+<% } else { %>
+  return (
+    <div className={className}>
+      {children}
+    </div>
+  );
+<% } %>
+};

package/templates/react-component/index.ejs

@@ -0,0 +1,2 @@
+export { <%= name %> } from './<%= name %>';
+export type { <%= name %>Props } from './<%= name %>';

package/templates/react-component/scaffold.json

@@ -0,0 +1,15 @@
+{
+  "engine": "EJS",
+  "templateDir": "./templates/react-component",
+  "outputDir": "./src/components/{{name}}",
+  "variables": {
+    "name": "MyComponent",
+    "style": "module"
+  },
+  "structure": [
+    { "template": "component.ejs", "output": "{{name}}.tsx" },
+    { "template": "test.ejs", "output": "{{name}}.test.tsx" },
+    { "template": "styles.ejs", "output": "{{name}}.module.css" },
+    { "template": "index.ejs", "output": "index.ts" }
+  ]
+}

package/templates/react-component/styles.ejs

@@ -0,0 +1,4 @@
+.root {
+  display: flex;
+  flex-direction: column;
+}