From e86709f5932832aa3c355563bf361251072b1507 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20M=C3=BCller?= Date: Thu, 10 Sep 2026 22:43:46 +0000 Subject: [PATCH] :memo: Sweep doc and formatter drift README named --experimental-strip-types, which was renamed to --strip-types. Document the current flag only. The extension recommendations list is unchanged, but the VSCode section undercounted it and now matches extensions.json. The per-language formatter blocks in .vscode/settings.json stay (they keep a user's local formatter settings from overriding the project's) and gain the JSX/TSX language ids to match what oxfmt and the lefthook glob cover. --- .vscode/settings.json | 8 ++++++++ README.md | 6 +++--- backlog.tasks | 6 +++--- 3 files changed, 14 insertions(+), 6 deletions(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index 0fdc747..4473f94 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -3,10 +3,18 @@ "editor.defaultFormatter": "oxc.oxc-vscode", "editor.formatOnSave": true }, + "[typescriptreact]": { + "editor.defaultFormatter": "oxc.oxc-vscode", + "editor.formatOnSave": true + }, "[javascript]": { "editor.defaultFormatter": "oxc.oxc-vscode", "editor.formatOnSave": true }, + "[javascriptreact]": { + "editor.defaultFormatter": "oxc.oxc-vscode", + "editor.formatOnSave": true + }, "[json]": { "editor.defaultFormatter": "oxc.oxc-vscode", "editor.formatOnSave": true diff --git a/README.md b/README.md index 361a6f2..8f33985 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ What each tier runs, when it fires and what it costs: ### Tooling - **TypeScript 7** — type checker and build (`tsc`). -- **node --test** + `--experimental-strip-types` — test runner (Node 22.6+, flag dropped on Node 24). +- **node --test** + `--strip-types` — test runner. - **c8** — code coverage for `test:ci`. - **oxlint** — Rust-based linter, with type-aware rules powered by **oxlint-tsgolint** (typescript-go). - **oxfmt** — Rust-based formatter (Prettier-compatible). Formats JS/TS, JSON/JSONC, YAML, Markdown, MDX, and more; built-in `package.json` key sorting replaces `sort-package-json`. @@ -55,9 +55,9 @@ The choice and configuration of each tool above is the result of deliberate trad ## VSCode integration -- Recommended extensions: see `.vscode/extensions.json` (oxc, cspell). +- Recommended extensions: see `.vscode/extensions.json` (oxc, cspell, TypeScript native-preview, EditorConfig, todo-tasks). - TypeScript 7 is used via the `typescriptteam.native-preview` extension. -- oxc extension provides oxlint squiggles and oxfmt format-on-save. +- oxc extension provides oxlint squiggles and oxfmt format-on-save; `.vscode/settings.json` pins it per language so a user's local `[language]` formatter settings cannot override the project's choice. ## Contributing diff --git a/backlog.tasks b/backlog.tasks index 12f97cf..954409e 100644 --- a/backlog.tasks +++ b/backlog.tasks @@ -48,9 +48,9 @@ Setup: ☐ Resolve sourcemap sources for consumers - `dist/*.map` `sources` are `../src/*.ts`, but `src` is not in `files`, so debuggers get missing sources ☐ Ship `src`, or disable `sourceMap`/`declarationMap` for the published artifact -☐ Sweep doc/formatter drift before v1.0 - ☐ README says `--experimental-strip-types`; scripts use `--strip-types` - ☐ `.vscode/settings.json` bundles `[markdown]`/`[yaml]` oxfmt formatters separately from `.oxfmtrc.json`'s `ignorePatterns` — align +✔ Sweep doc/formatter drift before v1.0 @done + ✔ README says `--experimental-strip-types`; scripts use `--strip-types` @done + ✔ `.vscode/settings.json` bundles `[markdown]`/`[yaml]` oxfmt formatters separately from `.oxfmtrc.json`'s `ignorePatterns` — align @done ✔ Document branching model @done ✔ Describe branching model: when to branch, base branch, naming @done ✔ Clarify release workflow: who pushes `main`, CI as post-merge gate, drop PR usage @done (9/8/2026, 2:54:32 PM)