summaryrefslogtreecommitdiff
path: root/docs/TYPESCRIPT.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/TYPESCRIPT.txt')
-rw-r--r--docs/TYPESCRIPT.txt18
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/TYPESCRIPT.txt b/docs/TYPESCRIPT.txt
index d50ea95..7fbc5a4 100644
--- a/docs/TYPESCRIPT.txt
+++ b/docs/TYPESCRIPT.txt
@@ -40,6 +40,10 @@ SOURCE LAYOUT
tests/browser-support.ts
Checked fixture parsing and typed browser-automation helpers.
+ eslint.config.ts and tsconfig.tools.json supply the typed lint-tool checks.
+ src/app and crates/chat-server/src/app contain the private Rust CLI
+ implementations; their parser and runtime changes are recorded in LINTING.txt.
+
tsconfig.json supplies shared strict checks. The browser, worker, and
test configurations use separate DOM, WebWorker, and Node environments.
Production browser builds cannot accidentally rely on Node APIs.
@@ -53,6 +57,10 @@ DEVELOPMENT
Install Node >=22.18.0 and npm on the development machine. Root package.json
and package-lock.json pin TypeScript 7.0.2, Playwright 1.64.1, Node type
declarations, platform compiler packages, and their integrity hashes.
+ ESLint 10.14.0 and typescript-eslint 8.72.1 provide typed strict linting.
+ TypeScript 6.0.3 supplies their supported JavaScript API; the pinned native
+ TypeScript 7.0.2 alias remains the emitting compiler. Both check the sources.
+ LINTING.txt documents the advisory-driven minimatch override.
There are no npm application/runtime dependencies. TypeScript and
Playwright use the Apache License, Version 2.0; Node declarations and
undici-types use the Expat License. Original notices remain in the
@@ -63,7 +71,8 @@ DEVELOPMENT
npm run build
infra/chat/build-typescript.sh installs the locked development packages
- with lifecycle scripts disabled, checks all three configurations, and
+ with lifecycle scripts disabled, checks browser/worker/test/tool configurations,
+ typed ESLint, both compiler versions, and npm advisories, then
emits JavaScript under var/build/typescript. The npm cache stays under
.tools/npm-cache. node_modules and generated outputs are ignored by Git.
Generated scripts are readable and unminified; no bundler is needed.
@@ -72,7 +81,7 @@ DEVELOPMENT
cargo-about license generation. cargo stack release builds TypeScript
before packaging the complete production release.
- Check without installing packages or emitting output after npm run build:
+ Recheck without reinstalling packages after npm run build:
npm run check
@@ -92,8 +101,9 @@ DEVELOPMENT
.tools/librejs.xpi as documented in CHAT-APPLICATION.txt. The complete
chat test proves LibreJS is active and rejects an unlicensed control.
Run chat variants sequentially because they share the default test port.
- npm audit checks the development dependency lock separately from
- cargo-deny; it does not audit Rust, browser-delivered code, or containers.
+ npm audit checks development dependencies as part of npm run check and the
+ Cargo check/release path. It does not audit Rust, browser-delivered code, or
+ containers; cargo-deny remains the separate strict Rust dependency audit.
RELEASES, SOURCE, AND LIBREJS