@aristobyte-ui/typescript-config

Centralized TypeScript configuration presets for the AristoByte UI ecosystem.
Opinionated, consistent, and production-ready.

🚀 Overview

@aristobyte-ui/typescript-config provides shared TypeScript configurations that enforce strict standards across all AristoByte UI packages.

This ensures:

- 🔒 Consistency across the monorepo ecosystem.
- ⚡ Developer Velocity by removing redundant boilerplate.
- 📦 Scalability with unified upgrades and evolving presets.
- 🧹 Clean output with correct declaration mapping for distributable packages.

📦 Installation

``bash


Install via Yarn

In your tsconfig.json, extend one of the provided presets.

Base configuration (for libraries):

`json
{
"extends": "@aristobyte-ui/typescript-config/base",
"compilerOptions": {
"outDir": "dist",
"declarationDir": "dist/types"
},
"include": ["src", "index.ts"]
}
`

React packages:

`json
{
"extends": "@aristobyte-ui/typescript-config/react",
"include": ["components", "index.ts"],
"exclude": ["dist", "node_modules"]
}
`

Next.js projects:

`json
{
"extends": "@aristobyte-ui/typescript-config/next",
"include": ["app", "pages", "components"],
"exclude": ["dist", "node_modules"]
}
`

Package-ready builds (library publishing):

`json
{
"extends": "@aristobyte-ui/typescript-config/package",
"include": ["src"],
"exclude": ["dist", "node_modules"]
}
`

Node.js tools / CLI projects:

`json
{
"extends": "@aristobyte-ui/typescript-config/node",
"include": ["src"],
"exclude": ["dist", "node_modules"]
}
`

Library preset (bundler-first projects):

`json
{
"extends": "@aristobyte-ui/typescript-config/library",
"include": ["src"],
"exclude": ["dist", "node_modules"]
}
`

Node.js tools / CLI projects:

`json
{
"extends": "@aristobyte-ui/typescript-config/node",
"include": ["src"],
"exclude": ["dist", "node_modules"]
}
`

Library preset (bundler-first projects):

`json
{
"extends": "@aristobyte-ui/typescript-config/library",
"include": ["src"],
"exclude": ["dist", "node_modules"]
}
`

📂 Presets Available

- base → Strict, modern TypeScript defaults for libraries.
- react → Extends base with React + JSX optimizations.
- next → Opinionated config optimized for Next.js projects.
- package → Publishing-friendly output with declarations and ESNext module resolution.
- node → Node.js-first config with NodeNext resolution and types.
- library → Bundler-first preset with modern lib targets.
- node → Node.js-first config with NodeNext module resolution.
- library → Bundler-first config with modern libs and declarations.

🔧 Example in a Package

package.json:

`json
{
"name": "@aristobyte-ui/button",
"version": "1.0.0",
"scripts": {
"build": "tsup"
},
"devDependencies": {
"@aristobyte-ui/typescript-config": "2.0.0",
"typescript": "^5.8.3"
}
}
`

tsconfig.json:

`json
{
"extends": "@aristobyte-ui/typescript-config/react",
"include": ["components", "index.ts"]
}
`

📊 Why This Matters

| Feature | Benefit |
| -------------------------------- | ------------------------------------- |
| strict: true | Eliminates runtime edge cases early |
| noUncheckedIndexedAccess: true | Safer array/object access |
| declaration: true | Ensures correct .d.ts output |
| jsx: react-jsx | Optimized for React 17+ and beyond |
| incremental | Faster rebuilds in monorepo workflows |
| moduleResolution: NodeNext` | Modern interoperability for ESM/CJS |

🏆 Philosophy

At AristoByte UI, we believe configuration should empower, not obstruct.
This package encapsulates our best practices into ready-to-consume presets that evolve alongside the ecosystem.

📜 License

MIT © AristoByte

🛡 Shields Showcase