create-chanom-app 0.0.0 → 0.2.0

package/README.md

@@ -71,6 +71,7 @@ A minimal Vite + React + TS app wired to the chanom shared configs:
 - `oxlint.config.ts` / `oxfmt.config.ts` - re-exporting the [`@chanom/dev-config`](../dev-config) presets
 - `vitest.config.ts` and a sample `src/app.test.tsx`
 - `src/` - `main.tsx`, `app.tsx`, `index.css`, and type declarations
+- `.vscode/settings.json` and `.vscode/extensions.json` - editor settings that run oxfmt formatting and oxlint fixes on save through the [oxc extension](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode), which is recommended so teammates are prompted to install it
 - `index.html`, `.gitignore`, and a starter `README.md`
 
 With the **commit-hooks** topping, it also adds husky, lint-staged, and commitlint as dev dependencies plus their config files (`.husky/pre-commit`, `.husky/commit-msg`, `.lintstagedrc.json`, `.commitlintrc.json`). The hooks materialize on the first install via the generated `prepare: "husky"` script.

package/dist/index.js

@@ -39,6 +39,43 @@ function resolvePm(hints) {
 	return parsePmField(hints.packageManagerField) ?? parsePmUserAgent(hints.userAgent) ?? hints.fallback ?? "pnpm";
 }
 //#endregion
+//#region ../internal/src/domain/vscode.ts
+/** Keys VS Code reads as a per-language override, e.g. `[typescript]`. */
+const LANGUAGES = [
+	"markdown",
+	"json",
+	"typescriptreact",
+	"typescript",
+	"javascript"
+];
+const OXC_FORMATTER = "oxc.oxc-vscode";
+/** The extensions a chanom project recommends; unioned into an existing list. */
+const RECOMMENDED_EXTENSIONS = [OXC_FORMATTER];
+/**
+* The VS Code settings chanom contributes. Every value is portable across
+* projects - repo-specific entries (`cSpell.words`, `git.*`) are deliberately
+* excluded so this can be dropped into any project without carrying chanom's
+* own choices.
+*
+* `editor.formatOnSave` is false on purpose: formatting runs through the oxc
+* code action instead, so formatting and lint fixes apply in one pass rather
+* than racing each other.
+*/
+function chanomSettings(oxfmtConfigPath) {
+	return {
+		"editor.defaultFormatter": OXC_FORMATTER,
+		"editor.formatOnSave": false,
+		"editor.codeActionsOnSave": {
+			"source.format.oxc": "always",
+			"source.fixAll.oxc": "always",
+			"source.removeUnusedImports": "always"
+		},
+		"oxc.fmt.configPath": oxfmtConfigPath,
+		"oxc.typeAware": true,
+		...Object.fromEntries(LANGUAGES.map((language) => [`[${language}]`, { "editor.defaultFormatter": OXC_FORMATTER }]))
+	};
+}
+//#endregion
 //#region ../internal/src/services/command-runner.ts
 const collectText = (stream) => stream.pipe(Stream.decodeText(), Stream.mkString);
 /**
@@ -195,7 +232,7 @@ const depVersions = {
 	"@chanom/vite-config": "0.1.0"
 };
 /** This package's own version, for `--version`. */
-const pkgVersion = "0.0.0";
+const pkgVersion = "0.2.0";
 //#endregion
 //#region src/domain/args.ts
 const PACKAGE_MANAGERS = [
@@ -515,6 +552,7 @@ const TEMPLATE_FILES = [
 ];
 //#endregion
 //#region src/toppings.ts
+const asJson = (value) => JSON.stringify(value, null, 2) + "\n";
 /**
 * The always-present baseline: a minimal Vite + React + TS app wired to the
 * chanom shared configs. Its static source files ship as verbatim templates;
@@ -553,7 +591,13 @@ const baseline = {
 	},
 	viteImports: ["import react from '@vitejs/plugin-react';"],
 	vitePlugins: ["react()"],
-	files: []
+	files: [{
+		path: ".vscode/settings.json",
+		contents: asJson(chanomSettings("oxfmt.config.ts"))
+	}, {
+		path: ".vscode/extensions.json",
+		contents: asJson({ recommendations: RECOMMENDED_EXTENSIONS })
+	}]
 };
 const LINT_STAGED_CONFIG = {
 	"**/*.{js,jsx,ts,tsx,mjs,cjs,mts,cts}": ["oxlint --fix --no-error-on-unmatched-pattern"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-chanom-app",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "Scaffold a Vite + React + TypeScript app, wired to the chanom shared configs.",
   "keywords": [
     "create",