@crossbind/typescript-config 2.0.0-beta.50

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Buğra Sarı and crossbind contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @crossbind/typescript-config
+
+Shared TypeScript configuration for crossbind projects. It wires the editor
+types crossbind generates under `.crossbind/` — for C++ `.h` imports, app-local
+Rust `.rs` imports and `cargo:` crate imports — extend it once and never
+manage the wiring by hand:
+
+```jsonc
+// tsconfig.json (TS 5.5+)
+{ "extends": "@crossbind/typescript-config" }
+```
+
+```jsonc
+// already extending another config? use the array form (TS 5.0+)
+{ "extends": ["@react-native/typescript-config", "@crossbind/typescript-config"] }
+```
+
+Install it as a direct devDependency (package-name `extends` resolves through
+Node resolution, so a transitive copy is not enough under strict pnpm):
+
+```sh
+npm install -D @crossbind/typescript-config
+```
+
+## What it wires
+
+- `rootDirs` overlays your project root with `.crossbind/types/`, where crossbind
+  mirrors the declaration of every relative native import — C++ headers
+  (`import { Native } from './native/native.h'`) and app-local Rust files
+  (`import { Hull } from './native/geo_surface.rs'`) alike. Relative imports
+  are typed by path resolution, so this overlay is what keeps generated
+  `.d.ts` files out of your source folders. Each of those declarations also
+  types `initNative()`, the boot call every generated module exports.
+- `include` pulls in `.crossbind/rust-crates/types/`, the ambient
+  `declare module 'cargo:<name>'` declarations for direct crate imports.
+
+## Caveats
+
+- `include` is overridden (not merged) when your tsconfig defines its own —
+  keep `.crossbind/rust-crates/types/**/*.d.ts` in your list in that case.
+- Paths assume the default cache directory (`.crossbind`). If you override
+  `paths.cache` in `crossbind.config.js`, copy the two settings into your own
+  tsconfig with the custom path instead.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@crossbind/typescript-config",
+  "version": "2.0.0-beta.50",
+  "description": "Shared TypeScript configuration wiring the editor types crossbind generates under .crossbind/ (C++ .h and Rust .rs imports, cargo: crates) - extend it once and never manage the wiring by hand.",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/tooling/typescript-config#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "license": "MIT",
+  "keywords": [
+    "crossbind",
+    "typescript",
+    "tsconfig",
+    "rust"
+  ],
+  "files": [
+    "tsconfig.json"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+// @crossbind/typescript-config - wires the editor types crossbind generates under .crossbind/.
+// Extend from your tsconfig (TS 5.5+; array form when you already extend another config):
+//   { "extends": "@crossbind/typescript-config" }
+// ${configDir} resolves against YOUR config's directory, not this package.
+// Note: a project-defined "include" overrides the one below - keep the glob in yours then.
+{
+    "compilerOptions": {
+        "rootDirs": ["${configDir}", "${configDir}/.crossbind/types"]
+    },
+    "include": ["${configDir}/.crossbind/rust-crates/types/**/*.d.ts"]
+}