@hiliosai/typescript

Shared TypeScript configurations for Hilios projects.

Installation

npm install --save-dev @hiliosai/typescript typescript
# or
bun add --dev @hiliosai/typescript typescript

Available Configurations

Base Configuration

For general TypeScript projects:

{
  "extends": "@hiliosai/typescript/base"
}

Node.js Configuration

For Node.js/Bun backend services:

{
  "extends": "@hiliosai/typescript/node"
}

Next.js Configuration

For Next.js applications:

{
  "extends": "@hiliosai/typescript/nextjs"
}

Usage Examples

Backend Service (Node.js/Bun)

// tsconfig.json
{
  "extends": "@hiliosai/typescript/node",
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

Frontend Application (Next.js)

// tsconfig.json
{
  "extends": "@hiliosai/typescript/nextjs",
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": [
    "next-env.d.ts",
    "**/*.ts",
    "**/*.tsx",
    ".next/types/**/*.ts"
  ],
  "exclude": ["node_modules"]
}

Library Package

// tsconfig.json
{
  "extends": "@hiliosai/typescript/base",
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src",
    "declaration": true,
    "declarationMap": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "**/*.test.ts"]
}

Configuration Details

Base Configuration

• Strict TypeScript settings
• ES2022 target and module resolution
• Path mapping support
• Source maps enabled
• Declaration files generation

Node.js Configuration

• Extends base configuration
• Node.js specific lib includes
• CommonJS and ESM module support
• Optimized for server environments

Next.js Configuration

• Extends base configuration
• React JSX support
• Next.js specific settings
• Incremental compilation
• App directory support

Scripts

Add these scripts to your package.json:

{
  "scripts": {
    "typecheck": "tsc --noEmit",
    "build": "tsc",
    "dev": "tsc --watch"
  }
}

Requirements

• TypeScript 5.0+
• Node.js 18+ or Bun 1.0+

License

MIT