Every dev dependency moves to the newest release that has been public for at least 7 days, and that rule is now enforced rather than remembered: .npmrc sets min-release-age=7 and Dependabot gets a 7-day cooldown on both ecosystems. `npm ci` was verified to ignore the age rule for versions already in the lockfile, so it only shapes what gets locked. vitest / coverage-v8 4.1.10 -> 5.0.5 (suite passed unchanged) @biomejs/biome 2.5.5 -> 2.6.2 (exact) svelte 5.56.8 -> 5.57.2 vite-plugin-svelte 7.2.0 -> 7.3.1 svelte-check 4.7.4 -> 4.7.7 jsdom 30.0.1 -> 30.1.3 (dom-environment canary first) knip 6.29.0 -> 6.42.1 wxt 0.21.3 -> 0.21.4 (+ transitive vite 8.3.5) npm audit: 13 (7 high) -> 3 low, all one deepmerge advisory with no fixed release, inside vite-plugin-svelte's dev-time option merging; documented in docs/09 §3.1. --omit=dev stays 0. This supersedes Dependabot #19-#25. The six-entry overrides block is deleted: none of those packages is in the tree any more (WXT 0.21 dropped web-ext-run, Vite 8 bundles with rolldown), and a stale override would silently pin a package the day it came back. WXT got the built-manifest diff the 2026-08-03 decision requires: identical keys and values apart from the deliberate minimum_chrome_version, identical file inventory. Biome 2.6 began formatting Markdown and YAML, so both are excluded rather than letting a formatter reflow hand-written docs. dependabot.yml now keeps WXT out of the routine group and ignores majors of the TypeScript pair and @types/node. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.3 KiB
10 — Coding Standards
1. Size limits (review-enforced)
| Unit | Soft limit | Hard limit |
|---|---|---|
| File (.ts / .svelte) | 300 lines | 500 lines — split before merging |
| Function / method | 50 lines | 80 lines |
| Svelte component script block | 150 lines | move logic to a .svelte.ts store or core/ |
| Nesting depth | 3 | 4 |
One file = one responsibility (one format × one direction per converter file). No official industry standard exists for line counts — these are the project convention, matching prior repos.
2. TypeScript — tsconfig.json essentials
{
"extends": "./.wxt/tsconfig.json", // WXT-generated base
"compilerOptions": {
"strict": true,
"noUncheckedIndexedAccess": true,
"noImplicitOverride": true,
"exactOptionalPropertyTypes": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"noFallthroughCasesInSwitch": true,
"verbatimModuleSyntax": true,
"erasableSyntaxOnly": true
}
}
⚠️ exactOptionalPropertyTypes is deliberate but has a cost worth knowing up
front: BookmarkNode is optional-heavy (url?, addDate?, lastModified?,
toolbar?, children?), so every construction site must omit absent keys
rather than assign undefined. Build nodes with conditional spreads
(...(addDate !== undefined && { addDate })), not { addDate: undefined }.
anyis forbidden (unknown+ narrowing instead).ascasts require a// SAFETY:comment explaining why.- Named exports only in
src/lib/**(Knip-friendly, grep-friendly). Svelte components are inherently default-exported — that's the exception. - Public functions in
core/get JSDoc with@throwsdocumented. - Discriminated unions over boolean flags for state
(
{ kind: 'parsed', … } | { kind: 'error', … }).
3. Biome — biome.json (2.6.x)
{
"$schema": "https://biomejs.dev/schemas/2.6.2/schema.json",
"vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
// Svelte, CSS, Markdown and YAML are excluded on purpose — see the notes below.
"files": {
"ignoreUnknown": true,
"includes": ["**", "!**/*.svelte", "!**/*.css", "!**/*.md", "!**/*.yml", "!**/*.yaml",
"!.output", "!.wxt", "!coverage", "!tests/fixtures"]
},
"formatter": { "enabled": true, "indentStyle": "space", "indentWidth": 2, "lineWidth": 100 },
"javascript": { "formatter": { "quoteStyle": "single", "semicolons": "always", "trailingCommas": "all" } },
"linter": {
"enabled": true,
"rules": {
"preset": "recommended", // 2.5.x key; `"recommended": true` is the pre-2.5 shape
"correctness": { "noUnusedImports": "error", "noUnusedVariables": "error" },
"suspicious": { "noExplicitAny": "error", "noConsole": { "level": "error", "options": { "allow": ["warn", "error"] } } },
"style": { "noDefaultExport": "error" } // overridden off for **/*.svelte — see below
}
},
"assist": { "enabled": true, "actions": { "source": { "organizeImports": "on" } } }
}
- Biome does not lint
.sveltehere. Biome 2.x Svelte/HTML support is behindhtml.experimentalFullSupportEnabled; the portfolio precedent (switch-every-tab-hotkey) excludes.svelteand.cssinstead, and we follow it rather than putting the build on an experimental flag.svelte-checkis the authority for everything inside.svelte. - Markdown and YAML are excluded since Biome 2.6, which started formatting both. The docs and workflow files are laid out by hand (long explanatory comments, deliberate wrapping); letting a formatter own them would turn every doc edit into a reflow diff.
- There is no Biome rule that catches
{@html}.noDangerouslySetInnerHtmlis a React rule and does not apply to Svelte. The ban in09 §3is enforced by the canonical grep gate (08 §3, run asnpm run guard) and by review — not by the linter. overridesblock:noDefaultExportmust be relaxed for**/*.svelte, not justentrypoints/**— every Svelte component is a default export,src/lib/components/**included. Also relaxnoConsoleinsrc/entrypoints/**bootstrap files andwxt.config.ts.- Version-pin the
$schemaURL in lockstep with the exact@biomejs/biomeversion chosen at scaffold (01 §2); a mismatched schema silently hides renamed keys.
4. Knip — knip.json
{
"$schema": "https://unpkg.com/knip@6/schema.json",
"entry": ["src/entrypoints/**/main.ts", "src/entrypoints/**/index.html", "tests/**/*.test.ts", "scripts/*.mjs"],
"project": ["src/**/*.{ts,svelte}", "tests/**/*.ts"],
"ignoreDependencies": []
}
Knip is on v6 (01 §2). Two things v6 changed, both verified at scaffold:
- Do not set
compilers: { svelte: true }. v6 dropped Svelte from its built-in compiler list (only.mdx,.scss,.less,.styl,.tsrxremain), so the boolean shorthand leaves a literaltruewhere a function is expected and knip crashes withTypeError: compiler is not a function. v6's Svelte plugin registers the.sveltecompiler automatically wheneversvelteis a dependency — omit the key entirely. wxt.config.tsandvitest.config.tsdo not belong inentry; the wxt and vitest plugins already declare them, and listing them again is reported as a redundant-pattern hint.
Tests are in both entry and project so that a constant used only by its own
test does not read as dead code.
CI fails on any unused file, export, or dependency. Intentional keep-arounds
require an explicit "ignore" entry with a comment in the config, never
a naked suppression.
5. Naming & structure
- Files:
kebab-case.ts; Svelte components:PascalCase.svelte; runes stores:name.svelte.ts. - Functions: verbs (
parseNetscapeHtml,buildImportPlan); booleans:is/has/canprefixes; constants:SCREAMING_SNAKEinlimits.ts. - No abbreviations except
id,url,csv,html,json,i18n. - Import order (Biome-organized): node/browser std → wxt/svelte →
$libaliases → relative. No deep relative chains (../../..) — use the@/alias WXT provides.
6. Comments & docs
- Comments explain why, not what. Parser tolerance quirks (§04) must cite
the browser that produces them (
// Safari 17 emits sibling DL — see 04 §1.2). - Every
core/module starts with a 3–6 line header: purpose, inputs, guarantees. TODO(scope):only with a linked GitHub issue number.
7. Git & commits
- Conventional Commits (
feat:,fix:,docs:,refactor:,test:,chore:,ci:); scope = area (feat(import): …). - Branches:
feat/…,fix/…offmain;mainis always releasable. - PR checklist (template): verify passes · docs updated if behavior changed · i18n keys added in all 3 locales · no new permissions.
- Version bumps: semver;
package.jsonis the single source (WXT propagates to the manifest).
8. Svelte 5 conventions
- Runes only:
$state,$derived,$effect,$props. No legacy$:/stores-API in new code. - Cross-component state lives in
.svelte.tsmodules, not context, unless scoped to a subtree (tree selection uses context). $effectbodies must be small and cleanup-returning when they subscribe (bookmark event listeners pattern,03 §3).- Props are typed via
let { x }: Props = $props()with an explicitinterface Props.