@vitavision/config-ts 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,48 @@
+# @vitavision/config-ts
+
+Shared TypeScript compiler options and a tsdown library preset for the `@vitavision/*`
+frontends.
+
+```bash
+bun add -d @vitavision/config-ts typescript@^7.0.2
+```
+
+## App
+
+```jsonc
+// tsconfig.json
+{
+  "extends": "@vitavision/config-ts/tsconfig.json",
+  "include": ["src"]
+}
+```
+
+The options:
+- **Strictness:** `strict`, `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`, `noUnusedLocals` / `noUnusedParameters`, `noFallthroughCasesInSwitch`.
+- **Modules:** `verbatimModuleSyntax`, `isolatedModules`, `moduleResolution: "bundler"`, `jsx: "react-jsx"`.
+- **Emit:** `noEmit`, because the bundler builds.
+
+## Library in a monorepo
+
+`tsconfig.lib.json` adds `declaration` and the `@vitavision/source` custom condition. With
+that condition, a sibling package that maps it to its `src/` in `exports` typechecks without
+a prior build.
+
+```jsonc
+{ "extends": "@vitavision/config-ts/tsconfig.lib.json", "include": ["src"] }
+```
+
+```ts
+// tsdown.config.ts (needs tsdown 0.23.0)
+import { library } from "@vitavision/config-ts/tsdown";
+
+export default library(); // ESM + declarations from src/index.ts; pass overrides to change it
+```
+
+With TypeScript 7, tsdown emits the declarations with the native compiler (its `tsgo`
+generator) and logs that this path is experimental. It reads the options from
+`tsconfig.json`, so put declaration options there rather than in `dts` overrides.
+
+## License
+
+MIT OR Apache-2.0.

package/package.json

@@ -1,19 +1,40 @@
 {
   "name": "@vitavision/config-ts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared TypeScript compiler options and tsdown library preset for vitavision frontends.",
   "license": "MIT OR Apache-2.0",
-  "repository": { "type": "git", "url": "git+https://github.com/VitalyVorobyev/lab-ui.git", "directory": "packages/config/ts" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VitalyVorobyev/lab-ui.git",
+    "directory": "packages/config/ts"
+  },
   "type": "module",
   "sideEffects": false,
-  "files": ["tsconfig.json", "tsconfig.lib.json", "tsdown.js", "tsdown.d.ts"],
+  "files": [
+    "tsconfig.json",
+    "tsconfig.lib.json",
+    "tsdown.js",
+    "tsdown.d.ts"
+  ],
   "exports": {
     "./tsconfig.json": "./tsconfig.json",
     "./tsconfig.lib.json": "./tsconfig.lib.json",
-    "./tsdown": { "types": "./tsdown.d.ts", "default": "./tsdown.js" },
+    "./tsdown": {
+      "types": "./tsdown.d.ts",
+      "default": "./tsdown.js"
+    },
     "./package.json": "./package.json"
   },
-  "publishConfig": { "access": "public" },
-  "peerDependencies": { "typescript": "^6.0.3", "tsdown": "0.23.0" },
-  "peerDependenciesMeta": { "tsdown": { "optional": true } }
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "typescript": "^7.0.2",
+    "tsdown": "0.23.0"
+  },
+  "peerDependenciesMeta": {
+    "tsdown": {
+      "optional": true
+    }
+  }
 }

package/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  // The compiler options every vitavision frontend shares (PLAN §3, ADR-0002).
+  // The compiler options every vitavision frontend shares.
   // An app extends this and adds its own `include`; a library extends tsconfig.lib.json.
   "compilerOptions": {
     "target": "ES2022",