@layerzerolabs/typescript-configuration 0.0.9

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@layerzerolabs/typescript-configuration",
+  "version": "0.0.9",
+  "private": false,
+  "devDependencies": {
+    "@types/node": "^22.13.13",
+    "@types/react": "^19.0.12",
+    "@types/react-dom": "^19.0.4"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,51 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Default",
+    "compilerOptions": {
+        // JavaScript Language Level Configuration
+        "lib": ["ES2022"],
+        "target": "ES2022",
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "checkJs": false,
+
+        // Module Configuration
+        "module": "CommonJS",
+        "moduleResolution": "Node",
+
+        // Source Map and Declaration Settings
+        "sourceMap": true,
+        "declaration": true,
+        "declarationMap": true,
+        "incremental": true,
+        "composite": false,
+        "inlineSources": false,
+
+        // Strict Type Checking
+        "strict": true,
+        "noImplicitAny": true,
+        "isolatedModules": false,
+        "noImplicitThis": true,
+        "useUnknownInCatchVariables": true,
+        "alwaysStrict": true,
+        "strictNullChecks": true,
+
+        // Code Quality Checks
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "forceConsistentCasingInFileNames": true,
+
+        // Module Interop Settings
+        "allowSyntheticDefaultImports": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+
+        // Decorator Support
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true,
+
+        // Development Experience
+        "preserveWatchOutput": true
+    }
+}

package/tsconfig.bundler.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Bundler",
+    /**
+     * Use this configuration for:
+     * - Packages that use bundlers (tsup, webpack, etc.)
+     * - Libraries that will be bundled before being consumed
+     *
+     * Note on module resolution:
+     * The bundler/ESNext configuration provides better compatibility with
+     * both ESM and CommonJS modules. Modern bundlers can handle both
+     * formats efficiently, making this the ideal choice for packages
+     * that will be bundled.
+     *
+     * Common indicators:
+     * - Presence of tsup.config.ts
+     * - Package is a shared library
+     *
+     * Do NOT use this for:
+     * - Direct Node.js applications without bundling
+     * - Scripts that run directly with node
+     * Use tsconfig.node.json instead for those cases
+     */
+    "extends": "./tsconfig.node.json",
+    "compilerOptions": {
+        // Modern bundler settings
+        "module": "ESNext",
+        "moduleResolution": "bundler"
+    }
+}

package/tsconfig.frontend.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Frontend Base",
+    /**
+     * Use this configuration for:
+     * - Frontend/browser-based applications and libraries
+     * - React components and UI libraries
+     * - Any code that runs in the browser
+     *
+     * Note on module resolution:
+     * We use ESNext/bundler because frontend code is always bundled
+     * and modern frontend tooling (webpack, vite, etc.) works best
+     * with this configuration.
+     */
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        // Frontend-specific module settings
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+
+        // Browser-specific settings
+        "lib": ["DOM", "DOM.Iterable", "ESNext"],
+        "target": "ESNext"
+    }
+}

package/tsconfig.next.json

@@ -0,0 +1,23 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Next.js",
+    /**
+     * Use this configuration for:
+     * - Next.js applications only
+     * - Any package that needs Next.js-specific types
+     *
+     * Note:
+     * This extends tsconfig.react.json, inheriting all React and frontend
+     * settings, while adding Next.js-specific configurations like the
+     * Next.js TypeScript plugin.
+     *
+     * For regular React applications or components that aren't using
+     * Next.js, use tsconfig.react.json instead.
+     */
+    "extends": "./tsconfig.react.json",
+    "compilerOptions": {
+        // Next.js Specific
+        "plugins": [{ "name": "next" }]
+    },
+    "include": ["next-env.d.ts", "next.config.js", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"]
+}

package/tsconfig.node.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Node",
+    /**
+     * Use this configuration for:
+     * - Direct Node.js applications and scripts
+     * - Server applications that run with node directly
+     * - CLI tools and scripts that aren't bundled
+     *
+     * Note on module resolution:
+     * We use NodeNext because it follows Node.js's native
+     * module resolution rules, which is ideal for applications
+     * that run directly with node without bundling.
+     *
+     * If your package uses a bundler (e.g., has tsup.config.ts),
+     * use tsconfig.bundler.json instead.
+     */
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        // Node-specific module settings
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+
+        // Node.js Environment
+        "types": ["node"],
+
+        // Output Configuration
+        "removeComments": true
+    }
+}

package/tsconfig.react.json

@@ -0,0 +1,27 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "React",
+    /**
+     * Use this configuration for:
+     * - React applications and components
+     * - Packages that use React's JSX syntax
+     * - UI libraries built with React
+     *
+     * Note:
+     * This extends tsconfig.frontend.json, so it inherits the bundler
+     * module resolution settings. This is appropriate since React
+     * applications are always bundled for the browser.
+     *
+     * For Next.js applications specifically, use tsconfig.next.json
+     * which adds Next.js-specific configurations.
+     */
+    "extends": "./tsconfig.frontend.json",
+    "compilerOptions": {
+        // React Specific
+        "jsx": "preserve",
+        "jsxImportSource": "react",
+
+        // Add React types
+        "types": ["react", "react-dom"]
+    }
+}