create-template-project 1.5.9 → 1.5.11

package/dist/config/dependencies.json

@@ -45,7 +45,7 @@
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
-			"version": "7.2.0",
+			"version": "7.2.1",
 			"description": "Generate a changelog from git metadata."
 		},
 		"husky": {
@@ -53,7 +53,7 @@
 			"description": "Modern native git hooks made easy."
 		},
 		"oxlint": {
-			"version": "1.70.0",
+			"version": "1.71.0",
 			"description": "A JavaScript linter written in Rust."
 		},
 		"oxlint-tsgolint": {
@@ -61,7 +61,7 @@
 			"description": "TypeScript-specific rules for oxlint."
 		},
 		"oxfmt": {
-			"version": "0.55.0",
+			"version": "0.56.0",
 			"description": "High performance JavaScript / TypeScript formatter."
 		},
 		"typescript": {

package/dist/index.js

@@ -1937,6 +1937,9 @@ var main = async () => {
 		const options = await parseArgs();
 		const isProgress = options.progress;
 		if (isProgress) intro("create-template-project");
+		debug("*".repeat(60));
+		debug(`* TEMPLATE: ${options.template}`);
+		debug("*".repeat(60));
 		debug("Arguments parsed: %O", options);
 		debug("Generating project");
 		await generateProject(options);

package/dist/templates/base/files/AGENTS.md

@@ -45,8 +45,13 @@ A modern project built with {{projectName}}, emphasizing type safety, performanc
 - **Extensions:** Always use `.js` extensions in relative imports (e.g., `import { main } from './lib.js';`) to comply with ESM requirements in Node.js, even though source files are `.ts`.
 - **Built-ins:** Use the `node:` prefix for built-in modules (e.g., `import path from 'node:path';`).
 
-### Formatting
+### Linting & Formatting Configuration
 
+This project uses a layered configuration approach:
+
+- **`oxc.config.ts`** — Managed source of truth for `oxlint` and `oxfmt` defaults. **Do not edit this file**; it is overwritten during template updates.
+- **`oxlint.config.ts`** — User-customizable linting overrides. Preserved across updates. Use this to add or relax lint rules for your project.
+- **`oxfmt.config.ts`** — User-customizable formatting overrides. Preserved across updates. Use this to adjust formatting preferences.
 - **Tooling:** oxfmt is enforced via `pnpm run lint`.
 - **Indentation:** Tabs are used for indentation.
 - **Quotes:** Single quotes for strings, except when double quotes prevent escaping.

package/dist/templates/base/files/README.md

@@ -42,7 +42,7 @@ This project is built using **Vite 8** for high-performance development and bund
 - **Vite 8**: Modern, ultra-fast development and build tool.
 - **Vitest**: Vite-native testing framework with browser support.
 - **Playwright**: Reliable E2E and browser automation.
-- **oxlint**: Extremely fast JavaScript/TypeScript linter.
-- **oxfmt**: High performance JavaScript / TypeScript formatter.
+- **oxlint**: Extremely fast JavaScript/TypeScript linter. Default rules live in `oxc.config.ts` (managed); customize overrides in `oxlint.config.ts`.
+- **oxfmt**: High performance JavaScript / TypeScript formatter. Default settings live in `oxc.config.ts` (managed); customize overrides in `oxfmt.config.ts`.
 - **Husky & Commitlint**: Ensuring high-quality commit messages.
 - **Conventional Changelog**: Automated changelog generation.

package/dist/templates/base/files/_oxc.config.ts

@@ -1,3 +1,19 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════
+ * DO NOT EDIT THIS FILE — IT IS MANAGED AND WILL BE OVERWRITTEN ON UPDATES.
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * This file is the source of truth for the default `oxlint` and `oxfmt`
+ * configuration. It is automatically regenerated when the template is
+ * updated — any manual changes will be lost.
+ *
+ * To customize linting rules, edit `oxlint.config.ts`.
+ * To customize formatting settings, edit `oxfmt.config.ts`.
+ *
+ * Those two files are preserved across template updates and are designed
+ * to receive user overrides.
+ */
+
 import {defineConfig} from 'oxlint';
 import {configs as regexpConfigs} from 'eslint-plugin-regexp';
 
@@ -143,12 +159,17 @@ export const linter = defineConfig({
 		'jest/valid-describe-callback': 'off',
 		'jest/valid-expect': 'off',
 		'jest/valid-title': 'off',
+		'jsdoc/require-param': 'error',
+		'jsdoc/require-param-type': 'off',
+		'jsdoc/require-returns': 'warn',
+		'jsdoc/require-returns-type': 'off',
 		'oxc/no-async-await': 'off',
 		'oxc/no-map-spread': 'off', // TODO: consider enabling
 		'oxc/no-optional-chaining': 'off',
 		'oxc/no-rest-spread-properties': 'off',
 		'unicorn/escape-case': 'off',
 		'unicorn/filename-case': 'off', // TODO: consider enabling
+		'unicorn/max-nested-calls': ['warn', {'max': 5}],
 		'unicorn/no-array-reduce': 'off', // TODO: consider enabling
 		'unicorn/no-array-sort': 'off', // TODO: consider enabling
 		'unicorn/no-hex-escape': 'off',
@@ -159,6 +180,7 @@ export const linter = defineConfig({
 		'unicorn/no-process-exit': 'off', // TODO: consider enabling
 		'unicorn/no-typeof-undefined': 'off', // TODO: consider enabling
 		'unicorn/prefer-module': 'off', // TODO: consider enabling
+		'unicorn/prefer-number-coercion': 'off', // TODO: consider enabling
 		'react/jsx-filename-extension': ['error', {extensions: ['.tsx']}],
 		'react/jsx-max-depth': ['error', {max: 5}],
 		'react/jsx-no-literals': 'off',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-template-project",
-  "version": "1.5.9",
+  "version": "1.5.11",
   "private": false,
   "description": "An ultra-modular, type-safe Node.js CLI tool used to scaffold new project templates (CLI, Webpage, Webapp, Fullstack) with best-practice configurations pre-installed.",
   "keywords": [
@@ -65,12 +65,12 @@
     "@types/debug": "4.1.13",
     "@types/node": "26.0.0",
     "@vitest/coverage-v8": "4.1.9",
-    "conventional-changelog": "7.2.0",
+    "conventional-changelog": "7.2.1",
     "conventional-changelog-angular": "8.3.1",
     "eslint-plugin-regexp": "3.1.0",
     "husky": "9.1.7",
-    "oxfmt": "0.55.0",
-    "oxlint": "1.70.0",
+    "oxfmt": "0.56.0",
+    "oxlint": "1.71.0",
     "oxlint-tsgolint": "0.23.0",
     "release-it": "20.2.0",
     "rimraf": "6.1.3",