@wsxjs/wsx-tsconfig 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 WSX Framework 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,136 @@
+# @wsxjs/wsx-tsconfig
+
+Shared TypeScript configuration for WSX Framework projects.
+
+## Installation
+
+```bash
+npm install --save-dev @wsxjs/wsx-tsconfig
+```
+
+## Usage
+
+### Basic Setup
+
+Extend the base configuration in your `tsconfig.json`:
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"]
+}
+```
+
+### With Build Output
+
+If you need to emit declaration files:
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules"]
+}
+```
+
+### Development Only (No Emit)
+
+For development projects that don't need to emit files:
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.json",
+  "include": ["src/**/*"]
+}
+```
+
+## What's Included
+
+The base configuration includes:
+
+- ✅ **JSX Support**: `jsx: "react-jsx"` with `jsxImportSource: "@wsxjs/wsx-core"`
+- ✅ **Decorator Support**: `experimentalDecorators: true` and `useDefineForClassFields: false` (required for `@state` decorator)
+- ✅ **Modern ES Features**: ES2020 target with ESNext modules
+- ✅ **Type Safety**: Strict mode enabled with additional checks
+- ✅ **WSX Types**: Automatically includes `@wsxjs/wsx-core` types
+
+## Configuration Details
+
+### Required Options for @state Decorator
+
+The configuration includes these critical options for `@state` decorator support:
+
+```json
+{
+  "experimentalDecorators": true,
+  "useDefineForClassFields": false
+}
+```
+
+**Important**: Without these options, the `@state` decorator will not work correctly.
+
+## Examples
+
+### Vite Project
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["src/**/*", "src/**/*.wsx"]
+}
+```
+
+### Library Package
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules", "**/__tests__/**"]
+}
+```
+
+### Test Configuration
+
+```json
+{
+  "extends": "@wsxjs/wsx-tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "types": [
+      "@wsxjs/wsx-core",
+      "@testing-library/jest-dom",
+      "vitest/globals"
+    ]
+  },
+  "include": ["src/**/*", "src/**/*.test.ts"]
+}
+```
+
+## Related Packages
+
+- [`@wsxjs/wsx-core`](../core) - Core WSX Framework
+- [`@wsxjs/wsx-vite-plugin`](../vite-plugin) - Vite plugin (required for `@state` decorator)
+
+## License
+
+MIT
+

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@wsxjs/wsx-tsconfig",
+  "version": "0.0.9",
+  "description": "Shared TypeScript configuration for WSX Framework projects",
+  "type": "module",
+  "main": "./tsconfig.json",
+  "files": [
+    "tsconfig.json",
+    "tsconfig.base.json",
+    "README.md"
+  ],
+  "keywords": [
+    "wsx",
+    "typescript",
+    "tsconfig",
+    "web-components"
+  ],
+  "author": "WSX Framework",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wsxjs/wsxjs.git",
+    "directory": "packages/wsx-tsconfig"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "compilerOptions": {
+        "target": "ES2020",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "resolveJsonModule": true,
+        "allowImportingTsExtensions": true,
+        "isolatedModules": true,
+        "skipLibCheck": true,
+        "strict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "forceConsistentCasingInFileNames": true,
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "jsx": "react-jsx",
+        "jsxImportSource": "@wsxjs/wsx-core",
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true,
+        "useDefineForClassFields": false,
+        "types": ["@wsxjs/wsx-core"]
+    }
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "noEmit": true
+    }
+}