create-template-project 1.7.2 → 1.8.0

package/dist/config/dependencies.json

@@ -25,11 +25,11 @@
 			"description": "A tiny JavaScript debugging utility modelled after Node.js core debugging technique."
 		},
 		"@commitlint/cli": {
-			"version": "21.2.1",
+			"version": "21.2.2",
 			"description": "Lint commit messages to ensure they follow conventional commits."
 		},
 		"@commitlint/config-conventional": {
-			"version": "21.2.0",
+			"version": "21.2.2",
 			"description": "Shareable commitlint config enforcing conventional commits."
 		},
 		"@types/debug": {
@@ -45,11 +45,11 @@
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
-			"version": "8.1.1",
+			"version": "8.1.3",
 			"description": "Generate a changelog from git metadata."
 		},
 		"conventional-changelog-angular": {
-			"version": "9.2.1",
+			"version": "9.3.0",
 			"description": "Angular preset for conventional-changelog."
 		},
 		"husky": {
@@ -57,7 +57,7 @@
 			"description": "Modern native git hooks made easy."
 		},
 		"oxlint": {
-			"version": "1.77.0",
+			"version": "1.78.0",
 			"description": "A JavaScript linter written in Rust."
 		},
 		"oxlint-tsgolint": {
@@ -65,7 +65,7 @@
 			"description": "TypeScript-specific rules for oxlint."
 		},
 		"oxfmt": {
-			"version": "0.62.0",
+			"version": "0.63.0",
 			"description": "High performance JavaScript / TypeScript formatter."
 		},
 		"typescript": {
@@ -157,7 +157,7 @@
 			"description": "Declarative routing for React web applications."
 		},
 		"release-it": {
-			"version": "21.0.1",
+			"version": "21.0.2",
 			"description": "Interactive release-tool for Git repositories."
 		},
 		"cors": {
@@ -169,7 +169,7 @@
 			"description": "TypeScript definitions for cors."
 		},
 		"eslint-plugin-regexp": {
-			"version": "3.1.1",
+			"version": "3.2.0",
 			"description": "ESLint plugin for finding regexp mistakes and style guide violations."
 		},
 		"vitest-browser-react": {

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

@@ -40,6 +40,7 @@ export const linter = defineConfig({
 	},
 	rules: {
 		...regexpPluginRules,
+		'eslint/capitalized-comments': 'off', // TODO: consider enabling
 		'eslint/complexity': 'off', // TODO: consider enabling
 		'eslint/curly': ['error', 'all'],
 		'eslint/id-length': 'off',
@@ -49,7 +50,6 @@ export const linter = defineConfig({
 		'eslint/max-lines-per-function': 'off', // TODO: consider enabling
 		'eslint/max-params': 'off', // TODO: consider enabling
 		'eslint/max-statements': 'off', // TODO: consider enabling
-		'eslint/capitalized-comments': 'off', // TODO: consider enabling
 		'eslint/no-await-in-loop': 'warn',
 		'eslint/no-console': 'off',
 		'eslint/no-continue': 'off',
@@ -60,6 +60,7 @@ export const linter = defineConfig({
 		'eslint/no-warning-comments': 'off',
 		'eslint/no-undefined': 'off', // TODO: consider enabling
 		'eslint/no-plusplus': 'off',
+		'eslint/one-var': 'off',
 		'eslint/sort-imports': 'off',
 		'eslint/sort-keys': 'off',
 		'eslint/no-ternary': 'off',
@@ -85,62 +86,6 @@ export const linter = defineConfig({
 		'import/no-unassigned-import': ['error', {allow: ['**/*.css']}],
 		'import/prefer-default-export': 'off',
 		'import/no-default-export': 'off',
-		'jest/consistent-test-it': 'off',
-		'jest/expect-expect': 'off',
-		'jest/max-expects': 'off',
-		'jest/max-nested-describe': 'off',
-		'jest/no-alias-methods': 'off',
-		'jest/no-commented-out-tests': 'off',
-		'jest/no-conditional-expect': 'off',
-		'jest/no-conditional-in-test': 'off',
-		'jest/no-confusing-set-timeout': 'off',
-		'jest/no-deprecated-functions': 'off',
-		'jest/no-disabled-tests': 'off',
-		'jest/no-done-callback': 'off',
-		'jest/no-duplicate-hooks': 'off',
-		'jest/no-export': 'off',
-		'jest/no-focused-tests': 'off',
-		'jest/no-hooks': 'off',
-		'jest/no-identical-title': 'off',
-		'jest/no-interpolation-in-snapshots': 'off',
-		'jest/no-jasmine-globals': 'off',
-		'jest/no-large-snapshots': 'off',
-		'jest/no-mocks-import': 'off',
-		'jest/no-restricted-jest-methods': 'off',
-		'jest/no-restricted-matchers': 'off',
-		'jest/no-standalone-expect': 'off',
-		'jest/no-test-prefixes': 'off',
-		'jest/no-test-return-statement': 'off',
-		'jest/no-unneeded-async-expect-function': 'off',
-		'jest/no-untyped-mock-factory': 'off',
-		'jest/padding-around-test-blocks': 'off',
-		'jest/prefer-called-with': 'off',
-		'jest/prefer-comparison-matcher': 'off',
-		'jest/prefer-each': 'off',
-		'jest/prefer-ending-with-an-expect': 'off',
-		'jest/prefer-equality-matcher': 'off',
-		'jest/prefer-expect-assertions': 'off',
-		'jest/prefer-expect-resolves': 'off',
-		'jest/prefer-hooks-in-order': 'off',
-		'jest/prefer-hooks-on-top': 'off',
-		'jest/prefer-jest-mocked': 'off',
-		'jest/prefer-lowercase-title': 'off',
-		'jest/prefer-mock-promise-shorthand': 'off',
-		'jest/prefer-mock-return-shorthand': 'off',
-		'jest/prefer-spy-on': 'off',
-		'jest/prefer-strict-equal': 'off',
-		'jest/prefer-to-be': 'off',
-		'jest/prefer-to-contain': 'off',
-		'jest/prefer-to-have-been-called': 'off',
-		'jest/prefer-to-have-been-called-times': 'off',
-		'jest/prefer-to-have-length': 'off',
-		'jest/prefer-todo': 'off',
-		'jest/require-hook': 'off',
-		'jest/require-to-throw-message': 'off',
-		'jest/require-top-level-describe': 'off',
-		'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',

package/dist/templates/web-widget/files/src/lib/react.test.tsx

@@ -0,0 +1,39 @@
+import {act, createRef, type ComponentRef} from 'react';
+import {createRoot} from 'react-dom/client';
+import {describe, expect, it, vi} from 'vitest';
+
+import {DemoWidget} from './react.tsx';
+
+describe('DemoWidget React wrapper', () => {
+	it('preserves mount options, updates mutable props, forwards refs, and cleans up', () => {
+		const host = document.createElement('div');
+		const firstRef = createRef<ComponentRef<typeof DemoWidget>>();
+		const secondRef = vi.fn<(value: ComponentRef<typeof DemoWidget> | null) => void>();
+		const root = createRoot(host);
+
+		act(() => {
+			root.render(<DemoWidget ref={firstRef} title="Initial title" message="Initial message" />);
+		});
+
+		const instance = firstRef.current;
+		expect(instance).not.toBeNull();
+		expect(host.querySelector('.widget__title')?.textContent).toBe('Initial title');
+		expect(host.querySelector('.widget__message')?.textContent).toBe('Initial message');
+
+		act(() => {
+			root.render(<DemoWidget ref={secondRef} title="Ignored title" message="Updated message" />);
+		});
+
+		expect(firstRef.current).toBeNull();
+		expect(secondRef).toHaveBeenLastCalledWith(instance);
+		expect(host.querySelector('.widget__title')?.textContent).toBe('Initial title');
+		expect(host.querySelector('.widget__message')?.textContent).toBe('Updated message');
+
+		act(() => {
+			root.unmount();
+		});
+
+		expect(secondRef).toHaveBeenLastCalledWith(null);
+		expect(host.children).toHaveLength(0);
+	});
+});

package/dist/templates/web-widget/files/src/lib/react.tsx

@@ -17,31 +17,33 @@ const setForwardedRef = (ref: ForwardedRef<DemoWidgetInstance>, value: DemoWidge
 };
 
 export const DemoWidget = forwardRef<DemoWidgetInstance, DemoWidgetReactProps>((props, ref): ReactElement => {
-	const {message, ...mountOptions} = props;
+	const {message} = props;
+	const initialOptionsRef = useRef<DemoWidgetOptions>(props);
 	const hostRef = useRef<HTMLDivElement | null>(null);
 	const instanceRef = useRef<DemoWidgetInstance | null>(null);
 
 	useEffect(() => {
 		const host = hostRef.current;
 		if (host === null) {
-			return (): void => {
-				setForwardedRef(ref, null);
-			};
+			throw new Error('Widget host was not mounted.');
 		}
 
-		const instance = new NativeDemoWidget(host, {...mountOptions, ...(message === undefined ? {} : {message})});
+		const instance = new NativeDemoWidget(host, initialOptionsRef.current);
 		instanceRef.current = instance;
-		setForwardedRef(ref, instance);
 
 		return (): void => {
 			instanceRef.current = null;
-			setForwardedRef(ref, null);
 			instance.destroy();
 		};
-		// Mount-only options are intentionally captured once. Mutable props are synced below through native setters.
-		// oxlint-disable-next-line react-hooks/exhaustive-deps
 	}, []);
 
+	useEffect(() => {
+		setForwardedRef(ref, instanceRef.current);
+		return (): void => {
+			setForwardedRef(ref, null);
+		};
+	}, [ref]);
+
 	useEffect(() => {
 		if (message !== undefined) {
 			instanceRef.current?.setMessage(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-template-project",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "private": false,
   "description": "An ultra-modular, type-safe Node.js CLI tool used to scaffold new project templates (CLI, Webpage, Web Widget, Webapp, Fullstack) with best-practice configurations pre-installed.",
   "keywords": [
@@ -60,18 +60,18 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@commitlint/cli": "21.2.1",
-    "@commitlint/config-conventional": "21.2.0",
+    "@commitlint/cli": "21.2.2",
+    "@commitlint/config-conventional": "21.2.2",
     "@types/cli-progress": "3.11.6",
     "@types/debug": "4.1.13",
     "@types/node": "26.2.0",
     "@vitest/coverage-v8": "4.1.10",
-    "conventional-changelog": "8.1.1",
-    "conventional-changelog-angular": "9.2.1",
-    "eslint-plugin-regexp": "3.1.1",
+    "conventional-changelog": "8.1.3",
+    "conventional-changelog-angular": "9.3.0",
+    "eslint-plugin-regexp": "3.2.0",
     "husky": "9.1.7",
-    "oxfmt": "0.62.0",
-    "oxlint": "1.77.0",
+    "oxfmt": "0.63.0",
+    "oxlint": "1.78.0",
     "oxlint-tsgolint": "7.0.2001",
     "release-it": "21.0.2",
     "rimraf": "6.1.3",