@pyreon/typescript provides shared TypeScript configuration presets for Pyreon projects. It includes three presets covering the common project types: a base configuration, an application configuration, and a library configuration.

Installation

npm install @pyreon/typescript

bun add @pyreon/typescript

pnpm add @pyreon/typescript

yarn add @pyreon/typescript

Presets

Base (@pyreon/typescript/base)

The foundation configuration that all other presets extend. Includes strict TypeScript settings and Pyreon-specific JSX configuration.

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

Key settings:

App (@pyreon/typescript/app)

For application projects (SPAs, SSR apps, examples). Extends the base preset and adds noEmit: true since applications are bundled by Vite, not compiled directly by tsc.

{
  "extends": "@pyreon/typescript/app"
}

Additional settings over base:

This is the recommended preset for Pyreon applications and examples. Since noEmit is enabled, you can include non-source files like vite.config.ts without needing a separate rootDir configuration.

Lib (@pyreon/typescript/lib)

For library packages that need to emit declaration files. Extends the base preset and enables declaration output.

{
  "extends": "@pyreon/typescript/lib"
}

Additional settings over base:

Usage

Application Project

For a Pyreon SPA or SSR application:

{
  "extends": "@pyreon/typescript/app",
  "include": ["src"],
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "~/*": ["./src/*"]
    }
  }
}

Library Package

For a reusable Pyreon library:

{
  "extends": "@pyreon/typescript/lib",
  "include": ["src"],
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src"
  }
}

Monorepo Root

For a monorepo root tsconfig.json that references workspace packages:

{
  "extends": "@pyreon/typescript/base",
  "compilerOptions": {
    "customConditions": ["bun"]
  },
  "references": [{ "path": "packages/my-app" }, { "path": "packages/my-lib" }]
}

JSX Configuration

All three presets configure JSX automatically:

• jsx: "react-jsx" -- uses the automatic JSX transform, so you do not need to import h or jsx manually in every file.

• jsxImportSource: "@pyreon/core" -- JSX factory functions are imported from @pyreon/core/jsx-runtime.

When using the @pyreon/vite-plugin, the Vite plugin also configures esbuild with these same settings. The TypeScript preset ensures that tsc --noEmit (typecheck) and your IDE both understand the JSX configuration.

exactOptionalPropertyTypes

The base preset enables exactOptionalPropertyTypes. This means optional properties must be explicitly typed with | undefined when assigned from expressions that may return undefined:

interface Config {
  name?: string
}

function getConfig(): Config {
  const value = maybeGetName() // returns string | undefined
  return {
    name: value, // OK -- value is string | undefined, name is optional
  }
}

This catches bugs where undefined is accidentally assigned to a property that accepts string but not undefined.

TypeScript 6 Support

@pyreon/typescript is compatible with TypeScript 6. The preset settings use stable compiler options that work across TypeScript 5.x and 6.x.

Exports Summary