@projitect/blueprint-tsconfig 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kapil Easwar
+
+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/dist/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@projitect/blueprint-tsconfig",
+    "version": "1.0.0",
+    "description": "TypeScript tsconfig.json scaffolding blueprint for projitect — strict defaults, owned mode.",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/projitect/projitect.git",
+        "directory": "packages/blueprint-tsconfig"
+    },
+    "license": "MIT",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "!**/*.tsbuildinfo"
+    ],
+    "scripts": {
+        "build": "tsc --build",
+        "build:clean": "tsc --build --clean",
+        "tc": "tsc --build"
+    },
+    "devDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "@projitect/test-kit": "workspace:*",
+        "effect": "4.0.0-rc.111",
+        "typescript": "5.9.3"
+    },
+    "peerDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "effect": "4.0.0-rc.111"
+    },
+    "engines": {
+        "node": ">=22.12.0"
+    },
+    "projitect": {
+        "type": "blueprint",
+        "import": "import { tsconfig } from \"@projitect/blueprint-tsconfig\"",
+        "call": "tsconfig()"
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @projitect/blueprint-tsconfig
+ *
+ * One owned-mode blueprint that scaffolds `tsconfig.json` with strict defaults. Designed for the
+ * common Node-library / Node-app shape; toggle `dom` for browser code and `jsx` for React/JSX.
+ *
+ * Owned mode means projitect rewrites `tsconfig.json` from scratch on every `pjt remodel` —
+ * the user can't accidentally drift it. If a project needs overrides projitect can't model
+ * (e.g. `compilerOptions.paths`), the answer is: configure projitect's options here, then
+ * compose a second TS config file (`tsconfig.local.json`) that extends this one and adds the
+ * overrides. Don't hand-edit the owned file. Project `references` are the exception: TypeScript
+ * never inherits them through `extends`, so declare them with the `references` option here.
+ */
+import type { Blueprint } from "@projitect/core";
+export interface TsconfigOptions {
+    /**
+     * Strict family of compiler flags. Defaults to `true` (`strict`, `noUncheckedIndexedAccess`,
+     * `noImplicitOverride`, `noFallthroughCasesInSwitch`, `noPropertyAccessFromIndexSignature`,
+     * `exactOptionalPropertyTypes`). Pass `false` to ship the loose defaults TS gives a new
+     * project — useful when adopting projitect on a legacy codebase where flipping strict mode
+     * at once isn't feasible.
+     */
+    readonly strict?: boolean;
+    /** ECMAScript target. Defaults to `"ES2023"`. */
+    readonly target?: string;
+    /** Module system. Defaults to `"NodeNext"` (with matching `moduleResolution`). */
+    readonly module?: "NodeNext" | "ESNext" | "Node16" | "CommonJS";
+    /**
+     * `lib` entries. Defaults to `["ES2023"]` (matches `target`). Use `dom: true` instead of
+     * adding `"DOM"` here — the helper handles the right pairing.
+     */
+    readonly lib?: readonly string[];
+    /**
+     * Include `"DOM"` + `"DOM.Iterable"` in `lib`. Defaults to `false` (Node-only). Flip to `true`
+     * for browser code.
+     */
+    readonly dom?: boolean;
+    /**
+     * JSX transform. `null` (default) emits no `jsx` field. `"react-jsx"` is the modern automatic
+     * runtime; `"react"` is the classic transform; `"preserve"` keeps JSX as-is for downstream
+     * tooling (Vite, etc.).
+     */
+    readonly jsx?: "react" | "react-jsx" | "preserve" | null;
+    /**
+     * Source root. Defaults to `"./src"`. The generated config derives `include` from this
+     * (`${rootDir}/...all files...`) and sets `exclude` to `["node_modules", outDir]`.
+     */
+    readonly rootDir?: string;
+    /**
+     * Output directory. Defaults to `"./dist"`.
+     */
+    readonly outDir?: string;
+    /**
+     * Paths to referenced projects (a directory or a tsconfig file), emitted in the given order as
+     * top-level `references: [{ path }]` entries. Paths are kept exactly as written. Each referenced
+     * project must set `composite: true` in its own tsconfig. Omitted or empty emits no
+     * `references` key.
+     */
+    readonly references?: readonly string[];
+    /**
+     * Type-check only. Defaults to `false`. When `true` the config emits `noEmit: true` and leaves
+     * out the emit settings (`rootDir`, `outDir`, `declaration`, `declarationMap`, `sourceMap`),
+     * for projects whose bundler or framework does the emitting.
+     */
+    readonly noEmit?: boolean;
+    /** Emit `allowJs: true`. Defaults to `false` (no `allowJs` field). */
+    readonly allowJs?: boolean;
+    /** Emit `incremental: true`. Defaults to `false` (no `incremental` field). */
+    readonly incremental?: boolean;
+    /**
+     * TypeScript language service plugin names, emitted as `compilerOptions.plugins: [{ name }]` in
+     * the given order. Omitted or empty emits no `plugins` key.
+     */
+    readonly plugins?: readonly string[];
+    /**
+     * Extra `include` entries, appended after the glob derived from `rootDir` and kept exactly as
+     * written (e.g. generated type directories).
+     */
+    readonly include?: readonly string[];
+}
+/**
+ * Build the tsconfig blueprint. Returns an owned-mode blueprint that emits a single operation
+ * writing `tsconfig.json` with the rendered content.
+ */
+export declare const tsconfig: (options?: TsconfigOptions) => Blueprint.Blueprint;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAQhD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAS,eAAoB,KAAG,SAAS,CAAC,SAO/D,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,99 @@
+/**
+ * @projitect/blueprint-tsconfig
+ *
+ * One owned-mode blueprint that scaffolds `tsconfig.json` with strict defaults. Designed for the
+ * common Node-library / Node-app shape; toggle `dom` for browser code and `jsx` for React/JSX.
+ *
+ * Owned mode means projitect rewrites `tsconfig.json` from scratch on every `pjt remodel` —
+ * the user can't accidentally drift it. If a project needs overrides projitect can't model
+ * (e.g. `compilerOptions.paths`), the answer is: configure projitect's options here, then
+ * compose a second TS config file (`tsconfig.local.json`) that extends this one and adds the
+ * overrides. Don't hand-edit the owned file. Project `references` are the exception: TypeScript
+ * never inherits them through `extends`, so declare them with the `references` option here.
+ */
+import { ownFile } from "@projitect/blueprint";
+import { Array } from "effect";
+import manifest from "../package.json" with { type: "json" };
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` without a hand-edited constant. JSON import keeps this runtime-pure.
+const PACKAGE_VERSION = manifest.version;
+/**
+ * Build the tsconfig blueprint. Returns an owned-mode blueprint that emits a single operation
+ * writing `tsconfig.json` with the rendered content.
+ */
+export const tsconfig = (options = {}) => ownFile({
+    id: "pjt:tsconfig",
+    version: PACKAGE_VERSION,
+    description: "TypeScript tsconfig.json with strict defaults",
+    path: "tsconfig.json",
+    content: renderTsconfig(options),
+});
+const renderTsconfig = (options) => {
+    const strict = options.strict ?? true;
+    const target = options.target ?? "ES2023";
+    const module_ = options.module ?? "NodeNext";
+    const baseLib = options.lib ?? [target];
+    const lib = options.dom === true ? [...baseLib, "DOM", "DOM.Iterable"] : baseLib;
+    const rootDir = options.rootDir ?? "./src";
+    const outDir = options.outDir ?? "./dist";
+    const jsx = options.jsx ?? null;
+    const references = options.references ?? [];
+    const noEmit = options.noEmit ?? false;
+    const plugins = options.plugins ?? [];
+    const config = {
+        compilerOptions: {
+            target,
+            module: module_,
+            moduleResolution: moduleResolutionFor(module_),
+            lib,
+            ...(jsx !== null && { jsx }),
+            ...(noEmit ? { noEmit } : { rootDir, outDir }),
+            ...(options.allowJs === true && { allowJs: true }),
+            ...(options.incremental === true && { incremental: true }),
+            ...(Array.isReadonlyArrayNonEmpty(plugins) && {
+                plugins: plugins.map((name) => ({ name })),
+            }),
+            // Always-on hygiene flags. These don't toggle with `strict` — they're the table stakes
+            // every modern TS project should have.
+            esModuleInterop: true,
+            forceConsistentCasingInFileNames: true,
+            skipLibCheck: true,
+            isolatedModules: true,
+            resolveJsonModule: true,
+            ...(!noEmit && { declaration: true, declarationMap: true, sourceMap: true }),
+            ...(strict && {
+                strict: true,
+                noImplicitOverride: true,
+                noFallthroughCasesInSwitch: true,
+                noUncheckedIndexedAccess: true,
+                noPropertyAccessFromIndexSignature: true,
+                exactOptionalPropertyTypes: true,
+            }),
+        },
+        include: [`${stripDot(rootDir)}/**/*`, ...(options.include ?? [])],
+        exclude: noEmit ? ["node_modules"] : ["node_modules", stripDot(outDir)],
+        ...(Array.isReadonlyArrayNonEmpty(references) && {
+            references: references.map((path) => ({ path })),
+        }),
+    };
+    return `${JSON.stringify(config, null, 2)}\n`;
+};
+const moduleResolutionFor = (m) => {
+    switch (m) {
+        case "NodeNext":
+        case "Node16": {
+            return m;
+        }
+        case "ESNext": {
+            return "Bundler";
+        }
+        case "CommonJS": {
+            return "Node";
+        }
+        default: {
+            return "NodeNext";
+        }
+    }
+};
+const stripDot = (p) => (p.startsWith("./") ? p.slice(2) : p);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@projitect/blueprint-tsconfig",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "TypeScript tsconfig.json scaffolding blueprint for projitect — strict defaults, owned mode.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/projitect/projitect.git",
+    "directory": "packages/blueprint-tsconfig"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.tsbuildinfo"
+  ],
+  "devDependencies": {
+    "effect": "4.0.0-rc.111",
+    "typescript": "5.9.3",
+    "@projitect/blueprint": "1.0.0",
+    "@projitect/core": "1.0.0",
+    "@projitect/test-kit": "1.0.0"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-rc.111",
+    "@projitect/blueprint": "1.0.0",
+    "@projitect/core": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "projitect": {
+    "type": "blueprint",
+    "import": "import { tsconfig } from \"@projitect/blueprint-tsconfig\"",
+    "call": "tsconfig()"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:clean": "tsc --build --clean",
+    "tc": "tsc --build"
+  }
 }

package/src/index.ts

@@ -0,0 +1,175 @@
+/**
+ * @projitect/blueprint-tsconfig
+ *
+ * One owned-mode blueprint that scaffolds `tsconfig.json` with strict defaults. Designed for the
+ * common Node-library / Node-app shape; toggle `dom` for browser code and `jsx` for React/JSX.
+ *
+ * Owned mode means projitect rewrites `tsconfig.json` from scratch on every `pjt remodel` —
+ * the user can't accidentally drift it. If a project needs overrides projitect can't model
+ * (e.g. `compilerOptions.paths`), the answer is: configure projitect's options here, then
+ * compose a second TS config file (`tsconfig.local.json`) that extends this one and adds the
+ * overrides. Don't hand-edit the owned file. Project `references` are the exception: TypeScript
+ * never inherits them through `extends`, so declare them with the `references` option here.
+ */
+
+import { ownFile } from "@projitect/blueprint"
+import type { Blueprint } from "@projitect/core"
+import { Array } from "effect"
+import manifest from "../package.json" with { type: "json" }
+
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` without a hand-edited constant. JSON import keeps this runtime-pure.
+const PACKAGE_VERSION = manifest.version
+
+export interface TsconfigOptions {
+  /**
+   * Strict family of compiler flags. Defaults to `true` (`strict`, `noUncheckedIndexedAccess`,
+   * `noImplicitOverride`, `noFallthroughCasesInSwitch`, `noPropertyAccessFromIndexSignature`,
+   * `exactOptionalPropertyTypes`). Pass `false` to ship the loose defaults TS gives a new
+   * project — useful when adopting projitect on a legacy codebase where flipping strict mode
+   * at once isn't feasible.
+   */
+  readonly strict?: boolean
+  /** ECMAScript target. Defaults to `"ES2023"`. */
+  readonly target?: string
+  /** Module system. Defaults to `"NodeNext"` (with matching `moduleResolution`). */
+  readonly module?: "NodeNext" | "ESNext" | "Node16" | "CommonJS"
+  /**
+   * `lib` entries. Defaults to `["ES2023"]` (matches `target`). Use `dom: true` instead of
+   * adding `"DOM"` here — the helper handles the right pairing.
+   */
+  readonly lib?: readonly string[]
+  /**
+   * Include `"DOM"` + `"DOM.Iterable"` in `lib`. Defaults to `false` (Node-only). Flip to `true`
+   * for browser code.
+   */
+  readonly dom?: boolean
+  /**
+   * JSX transform. `null` (default) emits no `jsx` field. `"react-jsx"` is the modern automatic
+   * runtime; `"react"` is the classic transform; `"preserve"` keeps JSX as-is for downstream
+   * tooling (Vite, etc.).
+   */
+  readonly jsx?: "react" | "react-jsx" | "preserve" | null
+  /**
+   * Source root. Defaults to `"./src"`. The generated config derives `include` from this
+   * (`${rootDir}/...all files...`) and sets `exclude` to `["node_modules", outDir]`.
+   */
+  readonly rootDir?: string
+  /**
+   * Output directory. Defaults to `"./dist"`.
+   */
+  readonly outDir?: string
+  /**
+   * Paths to referenced projects (a directory or a tsconfig file), emitted in the given order as
+   * top-level `references: [{ path }]` entries. Paths are kept exactly as written. Each referenced
+   * project must set `composite: true` in its own tsconfig. Omitted or empty emits no
+   * `references` key.
+   */
+  readonly references?: readonly string[]
+  /**
+   * Type-check only. Defaults to `false`. When `true` the config emits `noEmit: true` and leaves
+   * out the emit settings (`rootDir`, `outDir`, `declaration`, `declarationMap`, `sourceMap`),
+   * for projects whose bundler or framework does the emitting.
+   */
+  readonly noEmit?: boolean
+  /** Emit `allowJs: true`. Defaults to `false` (no `allowJs` field). */
+  readonly allowJs?: boolean
+  /** Emit `incremental: true`. Defaults to `false` (no `incremental` field). */
+  readonly incremental?: boolean
+  /**
+   * TypeScript language service plugin names, emitted as `compilerOptions.plugins: [{ name }]` in
+   * the given order. Omitted or empty emits no `plugins` key.
+   */
+  readonly plugins?: readonly string[]
+  /**
+   * Extra `include` entries, appended after the glob derived from `rootDir` and kept exactly as
+   * written (e.g. generated type directories).
+   */
+  readonly include?: readonly string[]
+}
+
+/**
+ * Build the tsconfig blueprint. Returns an owned-mode blueprint that emits a single operation
+ * writing `tsconfig.json` with the rendered content.
+ */
+export const tsconfig = (options: TsconfigOptions = {}): Blueprint.Blueprint =>
+  ownFile({
+    id: "pjt:tsconfig",
+    version: PACKAGE_VERSION,
+    description: "TypeScript tsconfig.json with strict defaults",
+    path: "tsconfig.json",
+    content: renderTsconfig(options),
+  })
+
+const renderTsconfig = (options: TsconfigOptions): string => {
+  const strict = options.strict ?? true
+  const target = options.target ?? "ES2023"
+  const module_ = options.module ?? "NodeNext"
+  const baseLib = options.lib ?? [target]
+  const lib = options.dom === true ? [...baseLib, "DOM", "DOM.Iterable"] : baseLib
+  const rootDir = options.rootDir ?? "./src"
+  const outDir = options.outDir ?? "./dist"
+  const jsx = options.jsx ?? null
+  const references = options.references ?? []
+  const noEmit = options.noEmit ?? false
+  const plugins = options.plugins ?? []
+
+  const config: Record<string, unknown> = {
+    compilerOptions: {
+      target,
+      module: module_,
+      moduleResolution: moduleResolutionFor(module_),
+      lib,
+      ...(jsx !== null && { jsx }),
+      ...(noEmit ? { noEmit } : { rootDir, outDir }),
+      ...(options.allowJs === true && { allowJs: true }),
+      ...(options.incremental === true && { incremental: true }),
+      ...(Array.isReadonlyArrayNonEmpty(plugins) && {
+        plugins: plugins.map((name) => ({ name })),
+      }),
+      // Always-on hygiene flags. These don't toggle with `strict` — they're the table stakes
+      // every modern TS project should have.
+      esModuleInterop: true,
+      forceConsistentCasingInFileNames: true,
+      skipLibCheck: true,
+      isolatedModules: true,
+      resolveJsonModule: true,
+      ...(!noEmit && { declaration: true, declarationMap: true, sourceMap: true }),
+      ...(strict && {
+        strict: true,
+        noImplicitOverride: true,
+        noFallthroughCasesInSwitch: true,
+        noUncheckedIndexedAccess: true,
+        noPropertyAccessFromIndexSignature: true,
+        exactOptionalPropertyTypes: true,
+      }),
+    },
+    include: [`${stripDot(rootDir)}/**/*`, ...(options.include ?? [])],
+    exclude: noEmit ? ["node_modules"] : ["node_modules", stripDot(outDir)],
+    ...(Array.isReadonlyArrayNonEmpty(references) && {
+      references: references.map((path) => ({ path })),
+    }),
+  }
+
+  return `${JSON.stringify(config, null, 2)}\n`
+}
+
+const moduleResolutionFor = (m: TsconfigOptions["module"]): string => {
+  switch (m) {
+    case "NodeNext":
+    case "Node16": {
+      return m
+    }
+    case "ESNext": {
+      return "Bundler"
+    }
+    case "CommonJS": {
+      return "Node"
+    }
+    default: {
+      return "NodeNext"
+    }
+  }
+}
+
+const stripDot = (p: string): string => (p.startsWith("./") ? p.slice(2) : p)

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.