@tsrx/typescript-plugin 0.3.105 → 0.3.107

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +49 -0
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -31,6 +31,55 @@ Text, or command-line `tsc`), add this plugin to your `tsconfig.json`:
31
31
  }
32
32
  ```
33
33
 
34
+ ## Compiler selection
35
+
36
+ All TSRX targets use the `.tsrx` extension. Normally, the compiler is detected
37
+ automatically from the installed target packages and the nearest `package.json`.
38
+ To remove ambiguity when multiple target compilers are installed, or to use a
39
+ third-party compiler, select one explicitly with the top-level `tsrx.compiler`
40
+ option:
41
+
42
+ ```json
43
+ {
44
+ "tsrx": {
45
+ "compiler": "@tsrx/ripple"
46
+ },
47
+ "compilerOptions": {
48
+ "jsx": "preserve",
49
+ "jsxImportSource": "ripple",
50
+ "plugins": [
51
+ {
52
+ "name": "@tsrx/typescript-plugin"
53
+ }
54
+ ]
55
+ }
56
+ }
57
+ ```
58
+
59
+ `compiler` must be a bare package specifier, such as `@tsrx/ripple`,
60
+ `@tsrx/react`, `@tsrx/solid`, `@tsrx/preact`, `@tsrx/vue`, `octane`, or a
61
+ third-party TSRX compiler package. Package subpaths are supported; relative and
62
+ absolute paths are not.
63
+
64
+ Compiler declarations follow the active TypeScript project's explicit `tsconfig`
65
+ inheritance graph:
66
+
67
+ - `extends` chains, arrays, JSONC files, and package-based configs are supported.
68
+ - Base configs are applied first. Child configs and later `extends` entries take
69
+ precedence.
70
+ - The compiler package is resolved relative to the config that supplied the
71
+ effective declaration.
72
+ - Nested projects do not inherit from unrelated ancestor configs.
73
+ - An invalid or unresolved effective declaration prevents automatic fallback. A
74
+ valid declaration in a child config still overrides a failed lower-priority
75
+ base.
76
+
77
+ The language server, tsserver plugin, and `tsrx-tsc` use the TypeScript project's
78
+ selected config. When that project context is unavailable, resolution starts at
79
+ the nearest `tsconfig.json`. If no `tsrx.compiler` value is declared, the plugin
80
+ falls back to installed target detection, using the nearest `package.json` to
81
+ disambiguate when multiple supported compiler packages are present.
82
+
34
83
  ## What it does
35
84
 
36
85
  This plugin:
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "description": "TypeScript plugin for TSRX",
4
4
  "license": "MIT",
5
5
  "author": "Dominic Gannaway",
6
- "version": "0.3.105",
6
+ "version": "0.3.107",
7
7
  "main": "dist/index.js",
8
8
  "bin": {
9
9
  "tsrx-tsc": "./dist/tsc.js"
@@ -29,16 +29,16 @@
29
29
  "@types/estree": "^1.0.8",
30
30
  "@types/node": "^24.3.0",
31
31
  "tsdown": "^0.22.0",
32
- "@tsrx/core": "0.1.44"
32
+ "@tsrx/core": "0.1.46"
33
33
  },
34
34
  "peerDependencies": {
35
35
  "typescript": "^5.9.3",
36
36
  "octane": "*",
37
- "@tsrx/react": "0.2.44",
38
- "@tsrx/ripple": "0.1.45",
39
- "@tsrx/preact": "0.1.44",
40
- "@tsrx/solid": "0.1.44",
41
- "@tsrx/vue": "0.1.44"
37
+ "@tsrx/react": "0.2.46",
38
+ "@tsrx/ripple": "0.1.47",
39
+ "@tsrx/solid": "0.1.46",
40
+ "@tsrx/preact": "0.1.46",
41
+ "@tsrx/vue": "0.1.46"
42
42
  },
43
43
  "peerDependenciesMeta": {
44
44
  "@tsrx/react": {