@sicoti/tsconfig 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SICOTI
+
+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,331 @@
+# @sicoti/tsconfig
+
+[![npm version](https://img.shields.io/npm/v/@sicoti/tsconfig.svg?style=flat-square)](https://www.npmjs.com/package/@sicoti/tsconfig)
+[![npm downloads](https://img.shields.io/npm/dm/@sicoti/tsconfig.svg?style=flat-square)](https://www.npmjs.com/package/@sicoti/tsconfig)
+[![TypeScript](https://img.shields.io/badge/TypeScript-%3E%3D5.9-blue?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+
+> Shareable TypeScript configuration presets with strict type checking for modern projects.
+
+## ✨ Features
+
+- 🔒 **Maximum Type Safety** — Strict mode plus additional safety checks beyond `strict: true`
+- 📦 **Environment-Specific Presets** — Optimized configs for Next.js, NestJS, React libraries, and Bun
+- 🎯 **Zero Configuration** — Works out of the box with sensible defaults
+- 🔧 **Fully Extensible** — Easy to override any setting for your specific needs
+- 📚 **Well Documented** — Clear comments explaining every option
+
+## 📦 Installation
+
+```bash
+# npm
+npm install -D @sicoti/tsconfig typescript
+
+# yarn
+yarn add -D @sicoti/tsconfig typescript
+
+# pnpm
+pnpm add -D @sicoti/tsconfig typescript
+
+# bun
+bun add -D @sicoti/tsconfig typescript
+```
+
+## 🚀 Quick Start
+
+Choose the preset that matches your project type and extend it in your `tsconfig.json`:
+
+### Next.js Applications
+
+```jsonc
+{
+  "extends": "@sicoti/tsconfig/nextjs.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
+```
+
+### NestJS Applications
+
+```jsonc
+{
+  "extends": "@sicoti/tsconfig/nestjs.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+```
+
+### React Component Libraries
+
+```jsonc
+{
+  "extends": "@sicoti/tsconfig/react-library.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules"]
+}
+```
+
+### Bun Packages & CLI Tools
+
+```jsonc
+{
+  "extends": "@sicoti/tsconfig/bun.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules"]
+}
+```
+
+## 📋 Available Presets
+
+| Preset | Use Case | Key Features |
+|:-------|:---------|:-------------|
+| `nextjs.json` | Next.js apps (App Router / Pages Router) | `jsx: preserve`, `noEmit`, Next.js plugin |
+| `nestjs.json` | NestJS backend applications | Decorator metadata, source maps, DI support |
+| `react-library.json` | React component libraries | `jsx: react-jsx`, declaration files, source maps |
+| `bun.json` | Bun runtime packages & CLI tools | Declaration files, optimized for Bun bundler |
+| `base.json` | ⚠️ Internal foundation (not for direct use) | Universal strict settings |
+
+## 🔒 Strict Type Checking
+
+All presets inherit from `base.json` which enables maximum type safety:
+
+### Enabled by `strict: true`
+
+| Option | Description |
+|:-------|:------------|
+| `strictNullChecks` | Check null/undefined assignments |
+| `strictFunctionTypes` | Strict function type checking |
+| `strictBindCallApply` | Type checking for bind/call/apply |
+| `strictPropertyInitialization` | Ensure class properties are initialized |
+| `noImplicitThis` | Error on implicit 'this' types |
+| `noImplicitAny` | Error on implicit 'any' types |
+| `alwaysStrict` | Emit "use strict" in all files |
+| `useUnknownInCatchVariables` | Use 'unknown' instead of 'any' in catch |
+
+### Additional Safety Checks (Not in `strict: true`)
+
+| Option | Description |
+|:-------|:------------|
+| `noUnusedLocals` | Error on unused local variables |
+| `noUnusedParameters` | Error on unused function parameters |
+| `noImplicitReturns` | Error when not all paths return a value |
+| `noFallthroughCasesInSwitch` | Error on switch case fall-through |
+| `allowUnreachableCode` | Error on unreachable code |
+| `noUncheckedIndexedAccess` | Add `undefined` to index signature results |
+| `exactOptionalPropertyTypes` | Distinguish between `undefined` and missing |
+| `noPropertyAccessFromIndexSignature` | Require bracket notation for index access |
+| `noImplicitOverride` | Require 'override' keyword for overrides |
+| `noUncheckedSideEffectImports` | Validate side-effect imports exist |
+
+## 💡 Why These Checks Matter
+
+### `noUncheckedIndexedAccess`
+
+```typescript
+// ❌ Without: No error, crashes at runtime
+const users: User[] = [];
+const first = users[0];  // Type: User (WRONG!)
+first.name;              // 💥 Runtime error: Cannot read property 'name' of undefined
+
+// ✅ With: Compiler catches it
+const first = users[0];  // Type: User | undefined
+if (first) {
+  first.name;            // ✓ Safe access
+}
+```
+
+### `noFallthroughCasesInSwitch`
+
+```typescript
+// ❌ Without: Silent fall-through bug
+switch (action) {
+  case "login":
+    login();
+  // Oops! Falls through to logout!
+  case "logout":
+    logout();
+    break;
+}
+
+// ✅ With: TS7029 error prevents the bug
+```
+
+### `exactOptionalPropertyTypes`
+
+```typescript
+interface Config {
+  cache?: { ttl: number };
+}
+
+// ❌ Without: Both accepted but have different semantics
+setConfig({});                    // OK - cache is missing
+setConfig({ cache: undefined });  // OK - but this explicitly sets cache to undefined!
+
+// ✅ With: Explicit undefined is an error
+// TS2379: Type 'undefined' is not assignable to type '{ ttl: number }'
+```
+
+### Why `strict: true` Alone Is Not Enough
+
+Many developers assume that `"strict": true` enables all TypeScript safety checks. **This is a common misconception.** The `strict` flag only enables 8 specific checks, leaving many critical safety features disabled by default.
+
+```typescript
+// ❌ This code compiles with ONLY strict: true
+
+// 1. Unused variables? No error.
+const unusedVar = "I'm never used";
+
+// 2. Array access without bounds checking? No error.
+const users: string[] = [];
+const first = users[0];  // Type: string (but it's actually undefined!)
+first.toUpperCase();     // 💥 Runtime crash!
+
+// 3. Switch fall-through? No error.
+function handle(action: "save" | "delete") {
+  switch (action) {
+    case "save":
+      save();
+    // Oops! Falls through to delete!
+    case "delete":
+      deleteAll();  // 💥 Unintended deletion!
+  }
+}
+
+// 4. Missing return in some branches? No error.
+function getValue(condition: boolean): string {
+  if (condition) {
+    return "value";
+  }
+  // 💥 Returns undefined, but TypeScript says it returns string!
+}
+```
+
+```typescript
+// ✅ With @sicoti/tsconfig - ALL of these are caught at compile time!
+
+// 1. TS6133: 'unusedVar' is declared but never used
+const unusedVar = "I'm never used";
+
+// 2. TS18048: 'first' is possibly 'undefined'
+const users: string[] = [];
+const first = users[0];  // Type: string | undefined
+if (first) {
+  first.toUpperCase();   // ✓ Safe!
+}
+
+// 3. TS7029: Fallthrough case in switch
+function handle(action: "save" | "delete") {
+  switch (action) {
+    case "save":
+      save();
+      break;  // ✓ Required!
+    case "delete":
+      deleteAll();
+  }
+}
+
+// 4. TS7030: Not all code paths return a value
+function getValue(condition: boolean): string {
+  if (condition) {
+    return "value";
+  }
+  return "default";  // ✓ Required!
+}
+```
+
+**Bottom line:** `strict: true` is just the starting point. This package enables **10+ additional checks** that catch real bugs before they reach production.
+
+## 🏗️ Architecture
+
+```plaintext
+@sicoti/tsconfig/
+├── base.json           ← Foundation (DO NOT extend directly)
+│   ├── nextjs.json     ← Next.js applications
+│   ├── nestjs.json     ← NestJS applications  
+│   ├── bun.json        ← Bun runtime packages
+│   └── react-library.json ← React component libraries
+```
+
+### Design Philosophy
+
+**`base.json` includes:**
+
+- Universal strict type checking settings
+- Modern ES module configuration
+- Code quality checks (unused code, control flow)
+- Import safety validations
+
+**`base.json` intentionally excludes:**
+
+- `lib` (DOM, ESNext) — Varies by runtime environment
+- `jsx` settings — Only for React-based projects
+- `sourceMap`, `declaration` — Build output varies by project
+- `emitDecoratorMetadata` — Only for NestJS/decorator-based DI
+
+## 🔧 Customization
+
+You can override any setting in your project's `tsconfig.json`:
+
+```jsonc
+{
+  "extends": "@sicoti/tsconfig/nextjs.json",
+  "compilerOptions": {
+    // Override specific settings
+    "noUncheckedIndexedAccess": false,  // Disable if too strict for your codebase
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@components/*": ["./src/components/*"]
+    }
+  }
+}
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+[MIT](LICENSE) © [SICOTI Team](https://github.com/SICOTI-Peru)
+
+---
+
+<p align="center">
+  Made with ❤️ by the <a href="https://github.com/SICOTI-Peru">SICOTI Team</a>
+</p>

package/base.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "display": "Base Configuration",
+
+  /* ═══════════════════════════════════════════════════════════════════════════════════
+   * @sicoti/tsconfig - Base Configuration
+   * ═══════════════════════════════════════════════════════════════════════════════════
+   *
+   * Foundation configuration that ALL other presets extend.
+   * Contains ONLY universal settings applicable to every TypeScript project.
+   *
+   * ⚠️  INTENTIONALLY EXCLUDED (delegated to environment-specific configs):
+   *     - Source maps, declarations, emit settings → Build-target specific
+   *     - skipLibCheck → Performance optimization per environment
+   *     - lib targets (DOM, ESNext) → Varies by runtime (browser vs server)
+   *     - JSX settings → Only for React-based projects
+   *
+   * Available Presets:
+   *   base.json
+   *     ├── nextjs.json        → Next.js applications
+   *     ├── nestjs.json        → NestJS backend applications
+   *     ├── bun.json           → Bun runtime packages & CLI tools
+   *     └── react-library.json → React component libraries
+   *
+   * Reference: https://www.typescriptlang.org/tsconfig
+   * ═══════════════════════════════════════════════════════════════════════════════════ */
+
+  "compilerOptions": {
+    /* ═══════════════════════════════════════════════════════════════════════════════
+     * STRICT TYPE CHECKING
+     * ═══════════════════════════════════════════════════════════════════════════════
+     * "strict: true" enables these 8 fundamental rules:
+     *   → strictNullChecks:              Check null/undefined assignments
+     *   → strictFunctionTypes:           Strict function type checking
+     *   → strictBindCallApply:           Type checking for bind/call/apply
+     *   → strictPropertyInitialization:  Ensure class properties are initialized
+     *   → noImplicitThis:                Error on implicit 'this' types
+     *   → noImplicitAny:                 Error on implicit 'any' types
+     *   → alwaysStrict:                  Emit "use strict" in all files
+     *   → useUnknownInCatchVariables:    Use 'unknown' instead of 'any' in catch
+     * ═══════════════════════════════════════════════════════════════════════════════ */
+    "strict": true,
+
+    /* ═══════════════════════════════════════════════════════════════════════════════
+     * ADDITIONAL TYPE SAFETY (Not included in strict: true)
+     * ═══════════════════════════════════════════════════════════════════════════════ */
+
+    // ─── Unused Code Detection ───────────────────────────────────────────────────
+    "noUnusedLocals": true, // Error on unused local variables
+    "noUnusedParameters": true, // Error on unused function parameters
+
+    // ─── Control Flow Analysis ───────────────────────────────────────────────────
+    "noImplicitReturns": true, // Error when not all paths return a value
+    "noFallthroughCasesInSwitch": true, // Error on switch case fall-through
+    "allowUnreachableCode": false, // Error on unreachable code
+
+    // ─── Index Signature Safety ──────────────────────────────────────────────────
+    "noUncheckedIndexedAccess": true, // Add undefined to index signature results
+    "exactOptionalPropertyTypes": true, // Distinguish between undefined and missing
+    "noPropertyAccessFromIndexSignature": true, // Require bracket notation for index access
+
+    // ─── Class & Override Safety ─────────────────────────────────────────────────
+    "noImplicitOverride": true, // Require 'override' keyword for overrides
+
+    // ─── Import Validation ───────────────────────────────────────────────────────
+    "noUncheckedSideEffectImports": true, // Validate side-effect imports exist
+
+    /* ═══════════════════════════════════════════════════════════════════════════════
+     * MODULE SYSTEM (Universal Settings)
+     * ═══════════════════════════════════════════════════════════════════════════════ */
+    "target": "ESNext", // Emit modern JavaScript
+    "module": "ESNext", // Use ES modules
+    "moduleResolution": "bundler", // Modern bundler resolution (Vite, esbuild, etc.)
+    "moduleDetection": "force", // Treat all files as modules
+
+    // ─── Module Interoperability ─────────────────────────────────────────────────
+    "esModuleInterop": true, // Enable CommonJS/ESM interop
+    "allowSyntheticDefaultImports": true, // Allow default imports from CJS modules
+    "resolveJsonModule": true, // Allow importing JSON files
+    "isolatedModules": true, // Ensure safe transpilation by tools
+
+    /* ═══════════════════════════════════════════════════════════════════════════════
+     * CODE QUALITY & CONSISTENCY
+     * ═══════════════════════════════════════════════════════════════════════════════ */
+    "forceConsistentCasingInFileNames": true, // Enforce consistent file name casing
+    "allowImportingTsExtensions": false, // Disallow .ts/.tsx extensions in imports
+    "verbatimModuleSyntax": false // Allow flexible import/export syntax
+  }
+}

package/bun.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "display": "Bun Runtime Configuration",
+  "extends": "./base.json",
+
+  /* ═══════════════════════════════════════════════════════════════════════════════════
+   * @sicoti/tsconfig - Bun Preset
+   * ═══════════════════════════════════════════════════════════════════════════════════
+   *
+   * Optimized for Bun runtime packages, CLI tools, and utilities.
+   *
+   * Key characteristics:
+   *   - Server-side only (no DOM libs)
+   *   - Declaration files for library consumers
+   *   - Optimized for Bun's native bundler
+   *   - Incremental builds for faster development
+   *   - Relaxed unused checks for library exports
+   *
+   * ═══════════════════════════════════════════════════════════════════════════════════ */
+
+  "compilerOptions": {
+    /* ─── Runtime Environment ───────────────────────────────────────────────────── */
+    "lib": ["ESNext"], // Server-side only, no DOM
+    "target": "ESNext", // Bun supports latest ECMAScript
+
+    /* ─── Output Settings ───────────────────────────────────────────────────── */
+    "noEmit": false, // Emit compiled output
+    "declaration": true, // Generate .d.ts for consumers
+    "declarationMap": true, // Source maps for declarations
+    "skipLibCheck": true, // Skip .d.ts checking for performance
+    "incremental": true, // Faster rebuilds
+    "tsBuildInfoFile": "./.cache/tsconfig.tsbuildinfo", // Keep build artifacts out of root
+
+    /* ─── Relaxed Checks for Library Development ─────────────────────────── */
+    // Libraries may export utilities that appear unused locally
+    "noUnusedLocals": false,
+    "noUnusedParameters": false
+  }
+}

package/nestjs.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "display": "NestJS Configuration",
+  "extends": "./base.json",
+
+  /* ═══════════════════════════════════════════════════════════════════════════════════
+   * @sicoti/tsconfig - NestJS Preset
+   * ═══════════════════════════════════════════════════════════════════════════════════
+   *
+   * Optimized for NestJS applications with decorator-based dependency injection.
+   *
+   * Key characteristics:
+   *   - Server-side only (no DOM libs)
+   *   - Decorator metadata emission for DI container
+   *   - Source maps for debugging in production
+   *   - Compiled output with incremental builds
+   *   - Relaxed settings for NestJS-specific patterns
+   *
+   * ═══════════════════════════════════════════════════════════════════════════════════ */
+
+  "compilerOptions": {
+    /* ─── Runtime Environment ───────────────────────────────────────────────────── */
+    "lib": ["ESNext"], // Server-side only, no DOM
+    "target": "ESNext", // Modern Node.js supports latest features
+
+    /* ─── NestJS Decorator Support ──────────────────────────────────────────────── */
+    "emitDecoratorMetadata": true, // Required for NestJS dependency injection
+    "experimentalDecorators": true, // Enable decorator syntax
+
+    /* ─── Output Settings ───────────────────────────────────────────────────── */
+    "noEmit": false, // Emit compiled JavaScript
+    "declaration": false, // No .d.ts files needed for apps
+    "removeComments": true, // Smaller output bundles
+    "skipLibCheck": true, // Skip .d.ts checking for performance
+    "incremental": true, // Faster rebuilds
+    "tsBuildInfoFile": "./.cache/tsconfig.tsbuildinfo", // Keep build artifacts out of root
+
+    /* ─── Source Maps for Debugging ─────────────────────────────────────────────── */
+    "sourceMap": true, // Enable source maps
+    "inlineSources": true, // Include sources in source maps
+
+    /* ─── Relaxed Checks for NestJS Patterns ────────────────────────────── */
+    // NestJS decorators and DI patterns require these relaxations
+    "strictBindCallApply": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/nextjs.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "display": "Next.js Configuration",
+  "extends": "./base.json",
+
+  /* ═══════════════════════════════════════════════════════════════════════════════════
+   * @sicoti/tsconfig - Next.js Preset
+   * ═══════════════════════════════════════════════════════════════════════════════════
+   *
+   * Optimized for Next.js applications (App Router & Pages Router).
+   *
+   * Key characteristics:
+   *   - Browser + Server rendering (DOM + ESNext libs)
+   *   - JSX preserved for Next.js compiler (SWC/Turbopack)
+   *   - No emit (Next.js handles all compilation)
+   *   - Next.js language service plugin for enhanced DX
+   *   - Incremental type checking for faster builds
+   *
+   * ═══════════════════════════════════════════════════════════════════════════════════ */
+
+  "compilerOptions": {
+    /* ─── Runtime Environment ───────────────────────────────────────────────────── */
+    "lib": ["DOM", "DOM.Iterable", "ESNext"], // Browser APIs + Modern JavaScript
+    "target": "ES2017", // Compatibility target for older browsers
+
+    /* ─── JSX Handling ──────────────────────────────────────────────────────────── */
+    "jsx": "preserve", // Let Next.js/SWC handle JSX transformation
+    "allowJs": true, // Allow JavaScript files in the project
+
+    /* ─── Output Settings ───────────────────────────────────────────────────── */
+    "noEmit": true, // Next.js handles all compilation
+    "skipLibCheck": true, // Skip .d.ts checking for performance
+    "incremental": true, // Enable incremental type checking
+    "tsBuildInfoFile": "./.cache/tsconfig.tsbuildinfo", // Keep build artifacts out of root
+
+    /* ─── Next.js Plugin ────────────────────────────────────────────────────────── */
+    "plugins": [
+      {
+        "name": "next" // Enhanced autocomplete & type checking
+      }
+    ],
+
+    /* ─── Relaxed Checks for Next.js Patterns ────────────────────────────── */
+    // Allow dot notation for dynamic route params and config objects
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://www.schemastore.org/package.json",
+  "name": "@sicoti/tsconfig",
+  "version": "1.0.0",
+  "description": "Centralized, shareable TypeScript configuration presets for monorepos and multi-project setups — provides consistent, battle-tested tsconfig bases (Base, Next.js, React libraries, Bun, NestJS) to reduce duplication, enforce best practices, and simplify upgrades.",
+  "type": "module",
+  "author": "SICOTI Team <dev@sicoti.org>",
+  "contributors": [
+    {
+      "name": "Yuzu02",
+      "url": "https://github.com/Yuzu02"
+    }
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/SICOTI-Peru/tsconfig#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SICOTI-Peru/tsconfig.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SICOTI-Peru/tsconfig/issues",
+    "email": "dev@sicoti.org"
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "bun": ">=1.3.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.9.0 <6"
+  },
+  "keywords": [
+    "typescript",
+    "tsconfig",
+    "configs",
+    "sicoti",
+    "monorepo",
+    "shareable-config"
+  ],
+  "files": [
+    "base.json",
+    "nextjs.json",
+    "react-library.json",
+    "bun.json",
+    "nestjs.json",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./base.json": "./base.json",
+    "./nextjs.json": "./nextjs.json",
+    "./react-library.json": "./react-library.json",
+    "./bun.json": "./bun.json",
+    "./nestjs.json": "./nestjs.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "pack": "bun pm pack",
+    "publish:dry": "bun publish --dry-run",
+    "publish": "bun publish --access public",
+    "release": "bun run pack && bun publish --access public"
+  }
+}

package/react-library.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "display": "React Library Configuration",
+  "extends": "./base.json",
+
+  /* ═══════════════════════════════════════════════════════════════════════════════════
+   * @sicoti/tsconfig - React Library Preset
+   * ═══════════════════════════════════════════════════════════════════════════════════
+   *
+   * Optimized for React component libraries consumed by other applications.
+   *
+   * Key characteristics:
+   *   - Browser APIs (DOM libs) for component development
+   *   - React 17+ JSX runtime (automatic import)
+   *   - Declaration files & source maps for consumers
+   *   - Relaxed unused checks for flexible component exports
+   *
+   * ═══════════════════════════════════════════════════════════════════════════════════ */
+
+  "compilerOptions": {
+    /* ─── Runtime Environment ───────────────────────────────────────────────────── */
+    "lib": ["DOM", "DOM.Iterable", "ESNext"], // Browser APIs + Modern JavaScript
+    "target": "ESNext", // Modern bundlers handle transpilation
+
+    /* ─── JSX Handling ──────────────────────────────────────────────────────────── */
+    "jsx": "react-jsx", // New React 17+ JSX transform
+
+    /* ─── Output Settings ───────────────────────────────────────────────────── */
+    "noEmit": false, // Emit compiled output
+    "declaration": true, // Generate .d.ts for consumers
+    "declarationMap": true, // Source maps for declarations
+    "skipLibCheck": true, // Skip .d.ts checking for performance
+    "incremental": true, // Faster rebuilds
+    "tsBuildInfoFile": "./.cache/tsconfig.tsbuildinfo", // Keep build artifacts out of root
+
+    /* ─── Relaxed Checks for Component Libraries ────────────────────────── */
+    // Libraries may export components that appear unused locally
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}