@effected/tsconfig-json 0.3.3 → 0.4.1

package/PortableTsconfig.js

@@ -86,6 +86,7 @@ const PRESERVED_OPTIONS = [
 	...PRESERVED_ENUM_OPTIONS,
 	...PRESERVED_STRING_OPTIONS
 ];
+const OPT_IN_TYPES_OPTION = "types";
 /**
 * A `ResolvedTsconfig` carries a string `configPath`, an array `extendedPaths`
 * AND an object `compilerOptions`; a bare `CompilerOptions.Type` never carries
@@ -101,13 +102,17 @@ const PRESERVED_OPTIONS = [
 * is filtered, which is the safe outcome.)
 */
 const isResolvedTsconfig = (input) => typeof input.configPath === "string" && Array.isArray(input.extendedPaths) && typeof input.compilerOptions === "object" && input.compilerOptions !== null;
-const make = (input) => {
+const make = (input, options) => {
 	const source = isResolvedTsconfig(input) ? input.compilerOptions : input;
 	const compilerOptions = {};
 	for (const key of PRESERVED_OPTIONS) {
 		const value = source[key];
 		if (value !== void 0) compilerOptions[key] = value;
 	}
+	if (options?.includeTypes === true) {
+		const types = source[OPT_IN_TYPES_OPTION];
+		if (types !== void 0) compilerOptions[OPT_IN_TYPES_OPTION] = types;
+	}
 	compilerOptions.composite = false;
 	compilerOptions.noEmit = true;
 	return {
@@ -134,6 +139,19 @@ var PortableTsconfig = class {
 	* is dropped; this is an allow-list, not a deny-list, so an option this
 	* package does not yet classify never leaks onto the portable shape by
 	* accident.
+	*
+	* `types` is the one deliberate exception, and it is opt-in rather than
+	* unclassified: it is portable (package names, not paths) but carrying it
+	* makes TypeScript demand those packages be resolvable, which a virtual
+	* environment with no `node_modules` cannot satisfy. Pass
+	* {@link PortableTsconfigOptions.includeTypes} when the consumer
+	* materializes `@types`; leave it off for the permissive default. Related
+	* `typeRoots` is never carried — machine-specific,
+	* config-location-dependent directories.
+	*
+	* @param input - The resolved config, or a bare compiler-options bag.
+	* @param options - Opt-ins for options that are portable but
+	* resolution-dependent. Omitted means the strict, always-safe subset.
 	*/
 	static make = make;
 };

package/README.md

@@ -82,8 +82,13 @@ console.log(TsEnumCodec.encodeCompilerOptions({ target: "es2023", strict: true,
 
 console.log(PortableTsconfig.make(resolved).compilerOptions.noEmit);
 // true — always forced, whatever the source config declared
+
+console.log(PortableTsconfig.make(resolved, { includeTypes: true }).compilerOptions.types);
+// carries the source config's `types` package names when it declares them, omitted when absent
 ```
 
+`includeTypes` is opt-in and defaults to `false` because emitting `types` makes tsc demand those `@types` packages resolve — a hard error in a virtual environment with no `node_modules`. Pass it when your environment materializes `@types` itself; leave it off for the permissive default where TypeScript auto-includes whatever it finds.
+
 ## Synchronous loading
 
 Bundler plugin hooks and config factories often cannot await. `TsconfigLoaderSync` runs the unchanged loader pipeline synchronously over file and path operations you supply — the package still imports no `node:*` module, and Node's built-ins satisfy the operations directly:
@@ -154,7 +159,7 @@ console.log(fsMap.size);
 - `ResolvedTsconfig` — the pure merge engine behind `resolve`: per-field merge semantics, path-option absolutization against the declaring config's directory, final `${configDir}` substitution and `pathsBase` provenance, with no filesystem access at all.
 - `TsconfigDiscovery.findNearest` — the nearest `tsconfig.json` (or any filename via `options.filename`) at or above a starting directory, over `@effected/walker`; one unreadable ancestor cannot hide a config above it.
 - `TsEnumCodec` — the string↔numeric enum tables as plain data with zero `typescript` imports. `encodeCompilerOptions` returns the exported `ProgrammaticCompilerOptions` type — the numeric shape `ts.CompilerOptions` expects, so you hand it to a `ts.CompilerOptions`-shaped API without a cast — with `lib` entries in the file-name form the compiler resolves verbatim; `decodeCompilerOptions` reverses it.
-- `PortableTsconfig.make` — an allow-list projection down to machine-independent type-semantics options, with `composite: false` and `noEmit: true` forced: the slice a virtual TypeScript environment (Twoslash, API Extractor, an in-memory language service) can safely inherit.
+- `PortableTsconfig.make` — an allow-list projection down to machine-independent type-semantics options, with `composite: false` and `noEmit: true` forced: the slice a virtual TypeScript environment (Twoslash, API Extractor, an in-memory language service) can safely inherit. An optional `{ includeTypes }` argument carries the source config's `types` package names onto the portable shape too, for a caller whose virtual environment can resolve `@types` packages itself; `typeRoots` stays dropped either way, since it names machine-specific, config-location-dependent directories.
 - `JsxConfig.fromCompilerOptions` — the JSX transform a bundler can configure, projected from decoded options: `react-jsx` / `react-jsxdev` select the automatic runtime with its import source (defaulting to `react`, tsc's own default), `react` selects classic, and `preserve`, `react-native` or an absent `jsx` yield `Option.none()`.
 - Typed failures everywhere: a malformed file is a `TsconfigParseError` carrying its path, a broken chain is a `TsconfigExtendsError` with a `not-found` / `cycle` / `depth` / `empty` reason and the full resolution chain, and IO errors flow through as `PlatformError`. Nothing fails as a defect.
 

package/index.d.ts

@@ -603,6 +603,28 @@ interface PortableTsconfig {
   /** The allow-listed, forced-flag-applied compiler options. */
   readonly compilerOptions: Record<string, unknown>;
 }
+/**
+ * Options for {@link (PortableTsconfig:class).make}.
+ *
+ * @public
+ */
+interface PortableTsconfigOptions {
+  /**
+   * Carry `types` (an array of `@types` package NAMES) onto the portable
+   * shape when the source declares it. Defaults to `false`.
+   *
+   * Opt in when the consuming environment can resolve those packages — it
+   * materializes `@types` into its virtual filesystem, or type-checks against
+   * a real `node_modules`. Leaving it off keeps the permissive default, where
+   * TypeScript auto-includes whatever `@types` the environment happens to
+   * have and never errors on a missing one.
+   *
+   * `typeRoots` is NOT carried under this flag: it names filesystem
+   * directories, which are machine-specific and config-location-dependent,
+   * so they are never portable.
+   */
+  readonly includeTypes?: boolean;
+}
 /**
  * The portable-tsconfig filter: {@link (PortableTsconfig:class).make}
  * narrows a resolved or bare compiler-options object to the allow-listed,
@@ -622,8 +644,21 @@ declare class PortableTsconfig {
    * is dropped; this is an allow-list, not a deny-list, so an option this
    * package does not yet classify never leaks onto the portable shape by
    * accident.
+   *
+   * `types` is the one deliberate exception, and it is opt-in rather than
+   * unclassified: it is portable (package names, not paths) but carrying it
+   * makes TypeScript demand those packages be resolvable, which a virtual
+   * environment with no `node_modules` cannot satisfy. Pass
+   * {@link PortableTsconfigOptions.includeTypes} when the consumer
+   * materializes `@types`; leave it off for the permissive default. Related
+   * `typeRoots` is never carried — machine-specific,
+   * config-location-dependent directories.
+   *
+   * @param input - The resolved config, or a bare compiler-options bag.
+   * @param options - Opt-ins for options that are portable but
+   * resolution-dependent. Omitted means the strict, always-safe subset.
    */
-  static readonly make: (input: ResolvedTsconfig | CompilerOptions.Type) => PortableTsconfig;
+  static readonly make: (input: ResolvedTsconfig | CompilerOptions.Type, options?: PortableTsconfigOptions) => PortableTsconfig;
 }
 //#endregion
 //#region src/TsconfigDiscovery.d.ts
@@ -702,148 +737,148 @@ declare class TsconfigLoader {
     readonly [x: string]: unknown;
     readonly compilerOptions?: {
       readonly [x: string]: unknown;
-      readonly target?: "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "es5" | "es6" | "esnext" | undefined;
-      readonly module?: "amd" | "commonjs" | "es2015" | "es2020" | "es2022" | "es6" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "none" | "preserve" | "system" | "umd" | undefined;
-      readonly moduleResolution?: "bundler" | "classic" | "node" | "node10" | "node16" | "nodenext" | undefined;
-      readonly jsx?: "preserve" | "react" | "react-jsx" | "react-jsxdev" | "react-native" | undefined;
-      readonly newLine?: "crlf" | "lf" | undefined;
-      readonly moduleDetection?: "auto" | "force" | "legacy" | undefined;
-      readonly lib?: readonly ("decorators" | "decorators.legacy" | "dom" | "dom.asynciterable" | "dom.iterable" | "es2015" | "es2015.collection" | "es2015.core" | "es2015.generator" | "es2015.iterable" | "es2015.promise" | "es2015.proxy" | "es2015.reflect" | "es2015.symbol" | "es2015.symbol.wellknown" | "es2016" | "es2016.array.include" | "es2016.intl" | "es2017" | "es2017.arraybuffer" | "es2017.date" | "es2017.intl" | "es2017.object" | "es2017.sharedmemory" | "es2017.string" | "es2017.typedarrays" | "es2018" | "es2018.asyncgenerator" | "es2018.asynciterable" | "es2018.intl" | "es2018.promise" | "es2018.regexp" | "es2019" | "es2019.array" | "es2019.intl" | "es2019.object" | "es2019.string" | "es2019.symbol" | "es2020" | "es2020.bigint" | "es2020.date" | "es2020.intl" | "es2020.number" | "es2020.promise" | "es2020.sharedmemory" | "es2020.string" | "es2020.symbol.wellknown" | "es2021" | "es2021.intl" | "es2021.promise" | "es2021.string" | "es2021.weakref" | "es2022" | "es2022.array" | "es2022.error" | "es2022.intl" | "es2022.object" | "es2022.regexp" | "es2022.string" | "es2023" | "es2023.array" | "es2023.collection" | "es2023.intl" | "es2024" | "es2024.arraybuffer" | "es2024.collection" | "es2024.object" | "es2024.promise" | "es2024.regexp" | "es2024.sharedmemory" | "es2024.string" | "es2025" | "es2025.collection" | "es2025.float16" | "es2025.intl" | "es2025.iterator" | "es2025.promise" | "es2025.regexp" | "es5" | "es6" | "es7" | "esnext" | "esnext.array" | "esnext.asynciterable" | "esnext.bigint" | "esnext.collection" | "esnext.date" | "esnext.decorators" | "esnext.disposable" | "esnext.error" | "esnext.float16" | "esnext.intl" | "esnext.iterator" | "esnext.object" | "esnext.promise" | "esnext.regexp" | "esnext.sharedmemory" | "esnext.string" | "esnext.symbol" | "esnext.temporal" | "esnext.typedarrays" | "esnext.weakref" | "scripthost" | "webworker" | "webworker.asynciterable" | "webworker.importscripts" | "webworker.iterable")[] | undefined;
-      readonly ignoreDeprecations?: "5.0" | "6.0" | undefined;
-      readonly strict?: boolean | undefined;
-      readonly noImplicitAny?: boolean | undefined;
-      readonly strictNullChecks?: boolean | undefined;
-      readonly strictFunctionTypes?: boolean | undefined;
-      readonly strictBindCallApply?: boolean | undefined;
-      readonly strictPropertyInitialization?: boolean | undefined;
-      readonly strictBuiltinIteratorReturn?: boolean | undefined;
-      readonly noImplicitThis?: boolean | undefined;
-      readonly useUnknownInCatchVariables?: boolean | undefined;
-      readonly alwaysStrict?: boolean | undefined;
-      readonly noUnusedLocals?: boolean | undefined;
-      readonly noUnusedParameters?: boolean | undefined;
-      readonly exactOptionalPropertyTypes?: boolean | undefined;
-      readonly noImplicitReturns?: boolean | undefined;
-      readonly noFallthroughCasesInSwitch?: boolean | undefined;
-      readonly noUncheckedIndexedAccess?: boolean | undefined;
-      readonly noImplicitOverride?: boolean | undefined;
-      readonly noPropertyAccessFromIndexSignature?: boolean | undefined;
-      readonly allowUnusedLabels?: boolean | undefined;
-      readonly allowUnreachableCode?: boolean | undefined;
-      readonly noUncheckedSideEffectImports?: boolean | undefined;
-      readonly allowJs?: boolean | undefined;
-      readonly checkJs?: boolean | undefined;
-      readonly resolveJsonModule?: boolean | undefined;
-      readonly allowArbitraryExtensions?: boolean | undefined;
-      readonly allowImportingTsExtensions?: boolean | undefined;
-      readonly rewriteRelativeImportExtensions?: boolean | undefined;
-      readonly resolvePackageJsonExports?: boolean | undefined;
-      readonly resolvePackageJsonImports?: boolean | undefined;
-      readonly allowSyntheticDefaultImports?: boolean | undefined;
-      readonly esModuleInterop?: boolean | undefined;
-      readonly preserveSymlinks?: boolean | undefined;
-      readonly allowUmdGlobalAccess?: boolean | undefined;
-      readonly verbatimModuleSyntax?: boolean | undefined;
-      readonly isolatedModules?: boolean | undefined;
-      readonly isolatedDeclarations?: boolean | undefined;
-      readonly erasableSyntaxOnly?: boolean | undefined;
-      readonly forceConsistentCasingInFileNames?: boolean | undefined;
-      readonly declaration?: boolean | undefined;
-      readonly declarationMap?: boolean | undefined;
-      readonly emitDeclarationOnly?: boolean | undefined;
-      readonly sourceMap?: boolean | undefined;
-      readonly inlineSourceMap?: boolean | undefined;
-      readonly inlineSources?: boolean | undefined;
-      readonly removeComments?: boolean | undefined;
-      readonly importHelpers?: boolean | undefined;
-      readonly downlevelIteration?: boolean | undefined;
-      readonly emitBOM?: boolean | undefined;
-      readonly noEmit?: boolean | undefined;
-      readonly noEmitHelpers?: boolean | undefined;
-      readonly noEmitOnError?: boolean | undefined;
-      readonly preserveConstEnums?: boolean | undefined;
-      readonly stripInternal?: boolean | undefined;
-      readonly experimentalDecorators?: boolean | undefined;
-      readonly emitDecoratorMetadata?: boolean | undefined;
-      readonly useDefineForClassFields?: boolean | undefined;
-      readonly noCheck?: boolean | undefined;
-      readonly composite?: boolean | undefined;
-      readonly incremental?: boolean | undefined;
-      readonly disableSourceOfProjectReferenceRedirect?: boolean | undefined;
-      readonly disableSolutionSearching?: boolean | undefined;
-      readonly disableReferencedProjectLoad?: boolean | undefined;
-      readonly assumeChangesOnlyAffectDirectDependencies?: boolean | undefined;
-      readonly noErrorTruncation?: boolean | undefined;
-      readonly noLib?: boolean | undefined;
-      readonly noResolve?: boolean | undefined;
-      readonly skipDefaultLibCheck?: boolean | undefined;
-      readonly skipLibCheck?: boolean | undefined;
-      readonly diagnostics?: boolean | undefined;
-      readonly extendedDiagnostics?: boolean | undefined;
-      readonly listFiles?: boolean | undefined;
-      readonly listFilesOnly?: boolean | undefined;
-      readonly listEmittedFiles?: boolean | undefined;
-      readonly explainFiles?: boolean | undefined;
-      readonly traceResolution?: boolean | undefined;
-      readonly preserveWatchOutput?: boolean | undefined;
-      readonly pretty?: boolean | undefined;
-      readonly disableSizeLimit?: boolean | undefined;
-      readonly libReplacement?: boolean | undefined;
-      readonly stableTypeOrdering?: boolean | undefined;
-      readonly outFile?: string | undefined;
-      readonly outDir?: string | undefined;
-      readonly rootDir?: string | undefined;
-      readonly declarationDir?: string | undefined;
-      readonly sourceRoot?: string | undefined;
-      readonly mapRoot?: string | undefined;
-      readonly tsBuildInfoFile?: string | undefined;
-      readonly baseUrl?: string | undefined;
-      readonly generateCpuProfile?: string | undefined;
-      readonly generateTrace?: string | undefined;
-      readonly typeRoots?: readonly string[] | undefined;
-      readonly rootDirs?: readonly string[] | undefined;
-      readonly jsxFactory?: string | undefined;
-      readonly jsxFragmentFactory?: string | undefined;
-      readonly jsxImportSource?: string | undefined;
-      readonly reactNamespace?: string | undefined;
-      readonly types?: readonly string[] | undefined;
-      readonly customConditions?: readonly string[] | undefined;
-      readonly moduleSuffixes?: readonly string[] | undefined;
+      readonly target?: "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "es5" | "es6" | "esnext";
+      readonly module?: "amd" | "commonjs" | "es2015" | "es2020" | "es2022" | "es6" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "none" | "preserve" | "system" | "umd";
+      readonly moduleResolution?: "bundler" | "classic" | "node" | "node10" | "node16" | "nodenext";
+      readonly jsx?: "preserve" | "react" | "react-jsx" | "react-jsxdev" | "react-native";
+      readonly newLine?: "crlf" | "lf";
+      readonly moduleDetection?: "auto" | "force" | "legacy";
+      readonly lib?: readonly ("decorators" | "decorators.legacy" | "dom" | "dom.asynciterable" | "dom.iterable" | "es2015" | "es2015.collection" | "es2015.core" | "es2015.generator" | "es2015.iterable" | "es2015.promise" | "es2015.proxy" | "es2015.reflect" | "es2015.symbol" | "es2015.symbol.wellknown" | "es2016" | "es2016.array.include" | "es2016.intl" | "es2017" | "es2017.arraybuffer" | "es2017.date" | "es2017.intl" | "es2017.object" | "es2017.sharedmemory" | "es2017.string" | "es2017.typedarrays" | "es2018" | "es2018.asyncgenerator" | "es2018.asynciterable" | "es2018.intl" | "es2018.promise" | "es2018.regexp" | "es2019" | "es2019.array" | "es2019.intl" | "es2019.object" | "es2019.string" | "es2019.symbol" | "es2020" | "es2020.bigint" | "es2020.date" | "es2020.intl" | "es2020.number" | "es2020.promise" | "es2020.sharedmemory" | "es2020.string" | "es2020.symbol.wellknown" | "es2021" | "es2021.intl" | "es2021.promise" | "es2021.string" | "es2021.weakref" | "es2022" | "es2022.array" | "es2022.error" | "es2022.intl" | "es2022.object" | "es2022.regexp" | "es2022.string" | "es2023" | "es2023.array" | "es2023.collection" | "es2023.intl" | "es2024" | "es2024.arraybuffer" | "es2024.collection" | "es2024.object" | "es2024.promise" | "es2024.regexp" | "es2024.sharedmemory" | "es2024.string" | "es2025" | "es2025.collection" | "es2025.float16" | "es2025.intl" | "es2025.iterator" | "es2025.promise" | "es2025.regexp" | "es5" | "es6" | "es7" | "esnext" | "esnext.array" | "esnext.asynciterable" | "esnext.bigint" | "esnext.collection" | "esnext.date" | "esnext.decorators" | "esnext.disposable" | "esnext.error" | "esnext.float16" | "esnext.intl" | "esnext.iterator" | "esnext.object" | "esnext.promise" | "esnext.regexp" | "esnext.sharedmemory" | "esnext.string" | "esnext.symbol" | "esnext.temporal" | "esnext.typedarrays" | "esnext.weakref" | "scripthost" | "webworker" | "webworker.asynciterable" | "webworker.importscripts" | "webworker.iterable")[];
+      readonly ignoreDeprecations?: "5.0" | "6.0";
+      readonly strict?: boolean;
+      readonly noImplicitAny?: boolean;
+      readonly strictNullChecks?: boolean;
+      readonly strictFunctionTypes?: boolean;
+      readonly strictBindCallApply?: boolean;
+      readonly strictPropertyInitialization?: boolean;
+      readonly strictBuiltinIteratorReturn?: boolean;
+      readonly noImplicitThis?: boolean;
+      readonly useUnknownInCatchVariables?: boolean;
+      readonly alwaysStrict?: boolean;
+      readonly noUnusedLocals?: boolean;
+      readonly noUnusedParameters?: boolean;
+      readonly exactOptionalPropertyTypes?: boolean;
+      readonly noImplicitReturns?: boolean;
+      readonly noFallthroughCasesInSwitch?: boolean;
+      readonly noUncheckedIndexedAccess?: boolean;
+      readonly noImplicitOverride?: boolean;
+      readonly noPropertyAccessFromIndexSignature?: boolean;
+      readonly allowUnusedLabels?: boolean;
+      readonly allowUnreachableCode?: boolean;
+      readonly noUncheckedSideEffectImports?: boolean;
+      readonly allowJs?: boolean;
+      readonly checkJs?: boolean;
+      readonly resolveJsonModule?: boolean;
+      readonly allowArbitraryExtensions?: boolean;
+      readonly allowImportingTsExtensions?: boolean;
+      readonly rewriteRelativeImportExtensions?: boolean;
+      readonly resolvePackageJsonExports?: boolean;
+      readonly resolvePackageJsonImports?: boolean;
+      readonly allowSyntheticDefaultImports?: boolean;
+      readonly esModuleInterop?: boolean;
+      readonly preserveSymlinks?: boolean;
+      readonly allowUmdGlobalAccess?: boolean;
+      readonly verbatimModuleSyntax?: boolean;
+      readonly isolatedModules?: boolean;
+      readonly isolatedDeclarations?: boolean;
+      readonly erasableSyntaxOnly?: boolean;
+      readonly forceConsistentCasingInFileNames?: boolean;
+      readonly declaration?: boolean;
+      readonly declarationMap?: boolean;
+      readonly emitDeclarationOnly?: boolean;
+      readonly sourceMap?: boolean;
+      readonly inlineSourceMap?: boolean;
+      readonly inlineSources?: boolean;
+      readonly removeComments?: boolean;
+      readonly importHelpers?: boolean;
+      readonly downlevelIteration?: boolean;
+      readonly emitBOM?: boolean;
+      readonly noEmit?: boolean;
+      readonly noEmitHelpers?: boolean;
+      readonly noEmitOnError?: boolean;
+      readonly preserveConstEnums?: boolean;
+      readonly stripInternal?: boolean;
+      readonly experimentalDecorators?: boolean;
+      readonly emitDecoratorMetadata?: boolean;
+      readonly useDefineForClassFields?: boolean;
+      readonly noCheck?: boolean;
+      readonly composite?: boolean;
+      readonly incremental?: boolean;
+      readonly disableSourceOfProjectReferenceRedirect?: boolean;
+      readonly disableSolutionSearching?: boolean;
+      readonly disableReferencedProjectLoad?: boolean;
+      readonly assumeChangesOnlyAffectDirectDependencies?: boolean;
+      readonly noErrorTruncation?: boolean;
+      readonly noLib?: boolean;
+      readonly noResolve?: boolean;
+      readonly skipDefaultLibCheck?: boolean;
+      readonly skipLibCheck?: boolean;
+      readonly diagnostics?: boolean;
+      readonly extendedDiagnostics?: boolean;
+      readonly listFiles?: boolean;
+      readonly listFilesOnly?: boolean;
+      readonly listEmittedFiles?: boolean;
+      readonly explainFiles?: boolean;
+      readonly traceResolution?: boolean;
+      readonly preserveWatchOutput?: boolean;
+      readonly pretty?: boolean;
+      readonly disableSizeLimit?: boolean;
+      readonly libReplacement?: boolean;
+      readonly stableTypeOrdering?: boolean;
+      readonly outFile?: string;
+      readonly outDir?: string;
+      readonly rootDir?: string;
+      readonly declarationDir?: string;
+      readonly sourceRoot?: string;
+      readonly mapRoot?: string;
+      readonly tsBuildInfoFile?: string;
+      readonly baseUrl?: string;
+      readonly generateCpuProfile?: string;
+      readonly generateTrace?: string;
+      readonly typeRoots?: readonly string[];
+      readonly rootDirs?: readonly string[];
+      readonly jsxFactory?: string;
+      readonly jsxFragmentFactory?: string;
+      readonly jsxImportSource?: string;
+      readonly reactNamespace?: string;
+      readonly types?: readonly string[];
+      readonly customConditions?: readonly string[];
+      readonly moduleSuffixes?: readonly string[];
       readonly paths?: {
         readonly [x: string]: readonly string[];
-      } | undefined;
+      };
       readonly plugins?: readonly {
         readonly [x: string]: unknown;
         readonly name: string;
-      }[] | undefined;
-      readonly maxNodeModuleJsDepth?: number | undefined;
-    } | undefined;
-    readonly extends?: string | readonly string[] | undefined;
-    readonly files?: readonly string[] | undefined;
-    readonly include?: readonly string[] | undefined;
-    readonly exclude?: readonly string[] | undefined;
+      }[];
+      readonly maxNodeModuleJsDepth?: number;
+    };
+    readonly extends?: string | readonly string[];
+    readonly files?: readonly string[];
+    readonly include?: readonly string[];
+    readonly exclude?: readonly string[];
     readonly references?: readonly {
       readonly [x: string]: unknown;
       readonly path: string;
-    }[] | undefined;
+    }[];
     readonly watchOptions?: {
       readonly [x: string]: unknown;
-      readonly watchFile?: "dynamicprioritypolling" | "fixedchunksizepolling" | "fixedpollinginterval" | "prioritypollinginterval" | "usefsevents" | "usefseventsonparentdirectory" | undefined;
-      readonly watchDirectory?: "dynamicprioritypolling" | "fixedchunksizepolling" | "fixedpollinginterval" | "usefsevents" | undefined;
-      readonly fallbackPolling?: "dynamicpriority" | "fixedchunksize" | "fixedinterval" | "priorityinterval" | undefined;
-      readonly synchronousWatchDirectory?: boolean | undefined;
-      readonly excludeDirectories?: readonly string[] | undefined;
-      readonly excludeFiles?: readonly string[] | undefined;
-    } | undefined;
+      readonly watchFile?: "dynamicprioritypolling" | "fixedchunksizepolling" | "fixedpollinginterval" | "prioritypollinginterval" | "usefsevents" | "usefseventsonparentdirectory";
+      readonly watchDirectory?: "dynamicprioritypolling" | "fixedchunksizepolling" | "fixedpollinginterval" | "usefsevents";
+      readonly fallbackPolling?: "dynamicpriority" | "fixedchunksize" | "fixedinterval" | "priorityinterval";
+      readonly synchronousWatchDirectory?: boolean;
+      readonly excludeDirectories?: readonly string[];
+      readonly excludeFiles?: readonly string[];
+    };
     readonly typeAcquisition?: {
       readonly [x: string]: unknown;
-      readonly enable?: boolean | undefined;
-      readonly include?: readonly string[] | undefined;
-      readonly exclude?: readonly string[] | undefined;
-      readonly disableFilenameBasedTypeAcquisition?: boolean | undefined;
-    } | undefined;
-    readonly compileOnSave?: boolean | undefined;
-    readonly $schema?: string | undefined;
+      readonly enable?: boolean;
+      readonly include?: readonly string[];
+      readonly exclude?: readonly string[];
+      readonly disableFilenameBasedTypeAcquisition?: boolean;
+    };
+    readonly compileOnSave?: boolean;
+    readonly $schema?: string;
   }, PlatformError.PlatformError | TsconfigParseError, FileSystem.FileSystem | Path.Path>;
   /**
    * Resolve a tsconfig.json and its full `extends` chain into a
@@ -866,121 +901,121 @@ declare class TsconfigLoader {
    */
   static readonly compilerOptions: (configPath: string) => Effect.Effect<{
     readonly [x: string]: unknown;
-    readonly target?: "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "es5" | "es6" | "esnext" | undefined;
-    readonly module?: "amd" | "commonjs" | "es2015" | "es2020" | "es2022" | "es6" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "none" | "preserve" | "system" | "umd" | undefined;
-    readonly moduleResolution?: "bundler" | "classic" | "node" | "node10" | "node16" | "nodenext" | undefined;
-    readonly jsx?: "preserve" | "react" | "react-jsx" | "react-jsxdev" | "react-native" | undefined;
-    readonly newLine?: "crlf" | "lf" | undefined;
-    readonly moduleDetection?: "auto" | "force" | "legacy" | undefined;
-    readonly lib?: readonly ("decorators" | "decorators.legacy" | "dom" | "dom.asynciterable" | "dom.iterable" | "es2015" | "es2015.collection" | "es2015.core" | "es2015.generator" | "es2015.iterable" | "es2015.promise" | "es2015.proxy" | "es2015.reflect" | "es2015.symbol" | "es2015.symbol.wellknown" | "es2016" | "es2016.array.include" | "es2016.intl" | "es2017" | "es2017.arraybuffer" | "es2017.date" | "es2017.intl" | "es2017.object" | "es2017.sharedmemory" | "es2017.string" | "es2017.typedarrays" | "es2018" | "es2018.asyncgenerator" | "es2018.asynciterable" | "es2018.intl" | "es2018.promise" | "es2018.regexp" | "es2019" | "es2019.array" | "es2019.intl" | "es2019.object" | "es2019.string" | "es2019.symbol" | "es2020" | "es2020.bigint" | "es2020.date" | "es2020.intl" | "es2020.number" | "es2020.promise" | "es2020.sharedmemory" | "es2020.string" | "es2020.symbol.wellknown" | "es2021" | "es2021.intl" | "es2021.promise" | "es2021.string" | "es2021.weakref" | "es2022" | "es2022.array" | "es2022.error" | "es2022.intl" | "es2022.object" | "es2022.regexp" | "es2022.string" | "es2023" | "es2023.array" | "es2023.collection" | "es2023.intl" | "es2024" | "es2024.arraybuffer" | "es2024.collection" | "es2024.object" | "es2024.promise" | "es2024.regexp" | "es2024.sharedmemory" | "es2024.string" | "es2025" | "es2025.collection" | "es2025.float16" | "es2025.intl" | "es2025.iterator" | "es2025.promise" | "es2025.regexp" | "es5" | "es6" | "es7" | "esnext" | "esnext.array" | "esnext.asynciterable" | "esnext.bigint" | "esnext.collection" | "esnext.date" | "esnext.decorators" | "esnext.disposable" | "esnext.error" | "esnext.float16" | "esnext.intl" | "esnext.iterator" | "esnext.object" | "esnext.promise" | "esnext.regexp" | "esnext.sharedmemory" | "esnext.string" | "esnext.symbol" | "esnext.temporal" | "esnext.typedarrays" | "esnext.weakref" | "scripthost" | "webworker" | "webworker.asynciterable" | "webworker.importscripts" | "webworker.iterable")[] | undefined;
-    readonly ignoreDeprecations?: "5.0" | "6.0" | undefined;
-    readonly strict?: boolean | undefined;
-    readonly noImplicitAny?: boolean | undefined;
-    readonly strictNullChecks?: boolean | undefined;
-    readonly strictFunctionTypes?: boolean | undefined;
-    readonly strictBindCallApply?: boolean | undefined;
-    readonly strictPropertyInitialization?: boolean | undefined;
-    readonly strictBuiltinIteratorReturn?: boolean | undefined;
-    readonly noImplicitThis?: boolean | undefined;
-    readonly useUnknownInCatchVariables?: boolean | undefined;
-    readonly alwaysStrict?: boolean | undefined;
-    readonly noUnusedLocals?: boolean | undefined;
-    readonly noUnusedParameters?: boolean | undefined;
-    readonly exactOptionalPropertyTypes?: boolean | undefined;
-    readonly noImplicitReturns?: boolean | undefined;
-    readonly noFallthroughCasesInSwitch?: boolean | undefined;
-    readonly noUncheckedIndexedAccess?: boolean | undefined;
-    readonly noImplicitOverride?: boolean | undefined;
-    readonly noPropertyAccessFromIndexSignature?: boolean | undefined;
-    readonly allowUnusedLabels?: boolean | undefined;
-    readonly allowUnreachableCode?: boolean | undefined;
-    readonly noUncheckedSideEffectImports?: boolean | undefined;
-    readonly allowJs?: boolean | undefined;
-    readonly checkJs?: boolean | undefined;
-    readonly resolveJsonModule?: boolean | undefined;
-    readonly allowArbitraryExtensions?: boolean | undefined;
-    readonly allowImportingTsExtensions?: boolean | undefined;
-    readonly rewriteRelativeImportExtensions?: boolean | undefined;
-    readonly resolvePackageJsonExports?: boolean | undefined;
-    readonly resolvePackageJsonImports?: boolean | undefined;
-    readonly allowSyntheticDefaultImports?: boolean | undefined;
-    readonly esModuleInterop?: boolean | undefined;
-    readonly preserveSymlinks?: boolean | undefined;
-    readonly allowUmdGlobalAccess?: boolean | undefined;
-    readonly verbatimModuleSyntax?: boolean | undefined;
-    readonly isolatedModules?: boolean | undefined;
-    readonly isolatedDeclarations?: boolean | undefined;
-    readonly erasableSyntaxOnly?: boolean | undefined;
-    readonly forceConsistentCasingInFileNames?: boolean | undefined;
-    readonly declaration?: boolean | undefined;
-    readonly declarationMap?: boolean | undefined;
-    readonly emitDeclarationOnly?: boolean | undefined;
-    readonly sourceMap?: boolean | undefined;
-    readonly inlineSourceMap?: boolean | undefined;
-    readonly inlineSources?: boolean | undefined;
-    readonly removeComments?: boolean | undefined;
-    readonly importHelpers?: boolean | undefined;
-    readonly downlevelIteration?: boolean | undefined;
-    readonly emitBOM?: boolean | undefined;
-    readonly noEmit?: boolean | undefined;
-    readonly noEmitHelpers?: boolean | undefined;
-    readonly noEmitOnError?: boolean | undefined;
-    readonly preserveConstEnums?: boolean | undefined;
-    readonly stripInternal?: boolean | undefined;
-    readonly experimentalDecorators?: boolean | undefined;
-    readonly emitDecoratorMetadata?: boolean | undefined;
-    readonly useDefineForClassFields?: boolean | undefined;
-    readonly noCheck?: boolean | undefined;
-    readonly composite?: boolean | undefined;
-    readonly incremental?: boolean | undefined;
-    readonly disableSourceOfProjectReferenceRedirect?: boolean | undefined;
-    readonly disableSolutionSearching?: boolean | undefined;
-    readonly disableReferencedProjectLoad?: boolean | undefined;
-    readonly assumeChangesOnlyAffectDirectDependencies?: boolean | undefined;
-    readonly noErrorTruncation?: boolean | undefined;
-    readonly noLib?: boolean | undefined;
-    readonly noResolve?: boolean | undefined;
-    readonly skipDefaultLibCheck?: boolean | undefined;
-    readonly skipLibCheck?: boolean | undefined;
-    readonly diagnostics?: boolean | undefined;
-    readonly extendedDiagnostics?: boolean | undefined;
-    readonly listFiles?: boolean | undefined;
-    readonly listFilesOnly?: boolean | undefined;
-    readonly listEmittedFiles?: boolean | undefined;
-    readonly explainFiles?: boolean | undefined;
-    readonly traceResolution?: boolean | undefined;
-    readonly preserveWatchOutput?: boolean | undefined;
-    readonly pretty?: boolean | undefined;
-    readonly disableSizeLimit?: boolean | undefined;
-    readonly libReplacement?: boolean | undefined;
-    readonly stableTypeOrdering?: boolean | undefined;
-    readonly outFile?: string | undefined;
-    readonly outDir?: string | undefined;
-    readonly rootDir?: string | undefined;
-    readonly declarationDir?: string | undefined;
-    readonly sourceRoot?: string | undefined;
-    readonly mapRoot?: string | undefined;
-    readonly tsBuildInfoFile?: string | undefined;
-    readonly baseUrl?: string | undefined;
-    readonly generateCpuProfile?: string | undefined;
-    readonly generateTrace?: string | undefined;
-    readonly typeRoots?: readonly string[] | undefined;
-    readonly rootDirs?: readonly string[] | undefined;
-    readonly jsxFactory?: string | undefined;
-    readonly jsxFragmentFactory?: string | undefined;
-    readonly jsxImportSource?: string | undefined;
-    readonly reactNamespace?: string | undefined;
-    readonly types?: readonly string[] | undefined;
-    readonly customConditions?: readonly string[] | undefined;
-    readonly moduleSuffixes?: readonly string[] | undefined;
+    readonly target?: "es2015" | "es2016" | "es2017" | "es2018" | "es2019" | "es2020" | "es2021" | "es2022" | "es2023" | "es2024" | "es2025" | "es5" | "es6" | "esnext";
+    readonly module?: "amd" | "commonjs" | "es2015" | "es2020" | "es2022" | "es6" | "esnext" | "node16" | "node18" | "node20" | "nodenext" | "none" | "preserve" | "system" | "umd";
+    readonly moduleResolution?: "bundler" | "classic" | "node" | "node10" | "node16" | "nodenext";
+    readonly jsx?: "preserve" | "react" | "react-jsx" | "react-jsxdev" | "react-native";
+    readonly newLine?: "crlf" | "lf";
+    readonly moduleDetection?: "auto" | "force" | "legacy";
+    readonly lib?: readonly ("decorators" | "decorators.legacy" | "dom" | "dom.asynciterable" | "dom.iterable" | "es2015" | "es2015.collection" | "es2015.core" | "es2015.generator" | "es2015.iterable" | "es2015.promise" | "es2015.proxy" | "es2015.reflect" | "es2015.symbol" | "es2015.symbol.wellknown" | "es2016" | "es2016.array.include" | "es2016.intl" | "es2017" | "es2017.arraybuffer" | "es2017.date" | "es2017.intl" | "es2017.object" | "es2017.sharedmemory" | "es2017.string" | "es2017.typedarrays" | "es2018" | "es2018.asyncgenerator" | "es2018.asynciterable" | "es2018.intl" | "es2018.promise" | "es2018.regexp" | "es2019" | "es2019.array" | "es2019.intl" | "es2019.object" | "es2019.string" | "es2019.symbol" | "es2020" | "es2020.bigint" | "es2020.date" | "es2020.intl" | "es2020.number" | "es2020.promise" | "es2020.sharedmemory" | "es2020.string" | "es2020.symbol.wellknown" | "es2021" | "es2021.intl" | "es2021.promise" | "es2021.string" | "es2021.weakref" | "es2022" | "es2022.array" | "es2022.error" | "es2022.intl" | "es2022.object" | "es2022.regexp" | "es2022.string" | "es2023" | "es2023.array" | "es2023.collection" | "es2023.intl" | "es2024" | "es2024.arraybuffer" | "es2024.collection" | "es2024.object" | "es2024.promise" | "es2024.regexp" | "es2024.sharedmemory" | "es2024.string" | "es2025" | "es2025.collection" | "es2025.float16" | "es2025.intl" | "es2025.iterator" | "es2025.promise" | "es2025.regexp" | "es5" | "es6" | "es7" | "esnext" | "esnext.array" | "esnext.asynciterable" | "esnext.bigint" | "esnext.collection" | "esnext.date" | "esnext.decorators" | "esnext.disposable" | "esnext.error" | "esnext.float16" | "esnext.intl" | "esnext.iterator" | "esnext.object" | "esnext.promise" | "esnext.regexp" | "esnext.sharedmemory" | "esnext.string" | "esnext.symbol" | "esnext.temporal" | "esnext.typedarrays" | "esnext.weakref" | "scripthost" | "webworker" | "webworker.asynciterable" | "webworker.importscripts" | "webworker.iterable")[];
+    readonly ignoreDeprecations?: "5.0" | "6.0";
+    readonly strict?: boolean;
+    readonly noImplicitAny?: boolean;
+    readonly strictNullChecks?: boolean;
+    readonly strictFunctionTypes?: boolean;
+    readonly strictBindCallApply?: boolean;
+    readonly strictPropertyInitialization?: boolean;
+    readonly strictBuiltinIteratorReturn?: boolean;
+    readonly noImplicitThis?: boolean;
+    readonly useUnknownInCatchVariables?: boolean;
+    readonly alwaysStrict?: boolean;
+    readonly noUnusedLocals?: boolean;
+    readonly noUnusedParameters?: boolean;
+    readonly exactOptionalPropertyTypes?: boolean;
+    readonly noImplicitReturns?: boolean;
+    readonly noFallthroughCasesInSwitch?: boolean;
+    readonly noUncheckedIndexedAccess?: boolean;
+    readonly noImplicitOverride?: boolean;
+    readonly noPropertyAccessFromIndexSignature?: boolean;
+    readonly allowUnusedLabels?: boolean;
+    readonly allowUnreachableCode?: boolean;
+    readonly noUncheckedSideEffectImports?: boolean;
+    readonly allowJs?: boolean;
+    readonly checkJs?: boolean;
+    readonly resolveJsonModule?: boolean;
+    readonly allowArbitraryExtensions?: boolean;
+    readonly allowImportingTsExtensions?: boolean;
+    readonly rewriteRelativeImportExtensions?: boolean;
+    readonly resolvePackageJsonExports?: boolean;
+    readonly resolvePackageJsonImports?: boolean;
+    readonly allowSyntheticDefaultImports?: boolean;
+    readonly esModuleInterop?: boolean;
+    readonly preserveSymlinks?: boolean;
+    readonly allowUmdGlobalAccess?: boolean;
+    readonly verbatimModuleSyntax?: boolean;
+    readonly isolatedModules?: boolean;
+    readonly isolatedDeclarations?: boolean;
+    readonly erasableSyntaxOnly?: boolean;
+    readonly forceConsistentCasingInFileNames?: boolean;
+    readonly declaration?: boolean;
+    readonly declarationMap?: boolean;
+    readonly emitDeclarationOnly?: boolean;
+    readonly sourceMap?: boolean;
+    readonly inlineSourceMap?: boolean;
+    readonly inlineSources?: boolean;
+    readonly removeComments?: boolean;
+    readonly importHelpers?: boolean;
+    readonly downlevelIteration?: boolean;
+    readonly emitBOM?: boolean;
+    readonly noEmit?: boolean;
+    readonly noEmitHelpers?: boolean;
+    readonly noEmitOnError?: boolean;
+    readonly preserveConstEnums?: boolean;
+    readonly stripInternal?: boolean;
+    readonly experimentalDecorators?: boolean;
+    readonly emitDecoratorMetadata?: boolean;
+    readonly useDefineForClassFields?: boolean;
+    readonly noCheck?: boolean;
+    readonly composite?: boolean;
+    readonly incremental?: boolean;
+    readonly disableSourceOfProjectReferenceRedirect?: boolean;
+    readonly disableSolutionSearching?: boolean;
+    readonly disableReferencedProjectLoad?: boolean;
+    readonly assumeChangesOnlyAffectDirectDependencies?: boolean;
+    readonly noErrorTruncation?: boolean;
+    readonly noLib?: boolean;
+    readonly noResolve?: boolean;
+    readonly skipDefaultLibCheck?: boolean;
+    readonly skipLibCheck?: boolean;
+    readonly diagnostics?: boolean;
+    readonly extendedDiagnostics?: boolean;
+    readonly listFiles?: boolean;
+    readonly listFilesOnly?: boolean;
+    readonly listEmittedFiles?: boolean;
+    readonly explainFiles?: boolean;
+    readonly traceResolution?: boolean;
+    readonly preserveWatchOutput?: boolean;
+    readonly pretty?: boolean;
+    readonly disableSizeLimit?: boolean;
+    readonly libReplacement?: boolean;
+    readonly stableTypeOrdering?: boolean;
+    readonly outFile?: string;
+    readonly outDir?: string;
+    readonly rootDir?: string;
+    readonly declarationDir?: string;
+    readonly sourceRoot?: string;
+    readonly mapRoot?: string;
+    readonly tsBuildInfoFile?: string;
+    readonly baseUrl?: string;
+    readonly generateCpuProfile?: string;
+    readonly generateTrace?: string;
+    readonly typeRoots?: readonly string[];
+    readonly rootDirs?: readonly string[];
+    readonly jsxFactory?: string;
+    readonly jsxFragmentFactory?: string;
+    readonly jsxImportSource?: string;
+    readonly reactNamespace?: string;
+    readonly types?: readonly string[];
+    readonly customConditions?: readonly string[];
+    readonly moduleSuffixes?: readonly string[];
     readonly paths?: {
       readonly [x: string]: readonly string[];
-    } | undefined;
+    };
     readonly plugins?: readonly {
       readonly [x: string]: unknown;
       readonly name: string;
-    }[] | undefined;
-    readonly maxNodeModuleJsDepth?: number | undefined;
+    }[];
+    readonly maxNodeModuleJsDepth?: number;
   }, PlatformError.PlatformError | TsconfigExtendsError | TsconfigParseError, FileSystem.FileSystem | Path.Path>;
 }
 //#endregion
@@ -1264,5 +1299,5 @@ declare class TsEnumCodec {
   static readonly decodeCompilerOptions: (numeric: Readonly<Record<string, unknown>>) => Record<string, unknown>;
 }
 //#endregion
-export { CompilerOptions, type EnumFamily, FallbackPolling, type FindNearestOptions, Jsx, JsxConfig, Lib, Module, ModuleDetection, ModuleResolution, NewLine, PortableTsconfig, type ProgrammaticCompilerOptions, type ProgrammaticCompilerOptionsValue, Reference, ResolvedTsconfig, type SyncFileSystem, type SyncPath, Target, TsEnumCodec, TsconfigDiscovery, TsconfigExtendsError, TsconfigJson, TsconfigJsonFromString, TsconfigLoader, TsconfigLoaderSync, type TsconfigLoaderSyncOptions, TsconfigParseError, TypeAcquisition, WatchDirectory, WatchFile, WatchOptions };
+export { CompilerOptions, type EnumFamily, FallbackPolling, type FindNearestOptions, Jsx, JsxConfig, Lib, Module, ModuleDetection, ModuleResolution, NewLine, PortableTsconfig, type PortableTsconfigOptions, type ProgrammaticCompilerOptions, type ProgrammaticCompilerOptionsValue, Reference, ResolvedTsconfig, type SyncFileSystem, type SyncPath, Target, TsEnumCodec, TsconfigDiscovery, TsconfigExtendsError, TsconfigJson, TsconfigJsonFromString, TsconfigLoader, TsconfigLoaderSync, type TsconfigLoaderSyncOptions, TsconfigParseError, TypeAcquisition, WatchDirectory, WatchFile, WatchOptions };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/tsconfig-json",
-	"version": "0.3.3",
+	"version": "0.4.1",
 	"private": false,
 	"description": "Composable tsconfig.json handling for Effect: schemas, extends-chain resolution, and config discovery.",
 	"keywords": [
@@ -39,8 +39,8 @@
 		"./package.json": "./package.json"
 	},
 	"peerDependencies": {
-		"@effected/jsonc": "~0.5.1",
-		"@effected/walker": "~0.3.3",
+		"@effected/jsonc": "^0.5.2",
+		"@effected/walker": "^0.3.4",
 		"effect": "4.0.0-beta.101"
 	},
 	"engines": {