@effected/tsconfig-json 0.1.0

package/index.d.ts

@@ -0,0 +1,645 @@
+import { Effect, FileSystem, Option, Path, PlatformError, Schema } from "effect";
+//#region src/CompilerOptions.d.ts
+/**
+ * `compilerOptions.target` — the ECMAScript target. `es5` is deprecated in TS
+ * 6.0; `es3` has no literal (dead per R1.3 — a `target: "es3"` value fails
+ * decode against this schema rather than silently passing through, since
+ * `target` itself is a live, typed field).
+ *
+ * @public
+ */
+declare const Target: Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext"]>, Schema.String, never, never>;
+/**
+ * `compilerOptions.module` — the module output format. `none`, `amd`, `umd`
+ * and `system` are deprecated in TS 6.0.
+ *
+ * @public
+ */
+declare const Module: Schema.decodeTo<Schema.Literals<readonly ["none", "commonjs", "amd", "umd", "system", "es6", "es2015", "es2020", "es2022", "esnext", "node16", "node18", "node20", "nodenext", "preserve"]>, Schema.String, never, never>;
+/**
+ * `compilerOptions.moduleResolution`. `node10`, `node` and `classic` are
+ * deprecated in TS 6.0.
+ *
+ * @public
+ */
+declare const ModuleResolution: Schema.decodeTo<Schema.Literals<readonly ["node10", "node", "classic", "node16", "nodenext", "bundler"]>, Schema.String, never, never>;
+/**
+ * `compilerOptions.jsx`. There is no `none` literal — tsc's option map has
+ * only these five.
+ *
+ * @public
+ */
+declare const Jsx: Schema.decodeTo<Schema.Literals<readonly ["preserve", "react-native", "react-jsx", "react-jsxdev", "react"]>, Schema.String, never, never>;
+/** `compilerOptions.newLine`. @public */
+declare const NewLine: Schema.decodeTo<Schema.Literals<readonly ["crlf", "lf"]>, Schema.String, never, never>;
+/** `compilerOptions.moduleDetection`. @public */
+declare const ModuleDetection: Schema.decodeTo<Schema.Literals<readonly ["auto", "legacy", "force"]>, Schema.String, never, never>;
+/**
+ * `compilerOptions.lib` member values — the complete TS 6.0.3 set, lowercase
+ * canonical, per R1.2.
+ *
+ * @public
+ */
+declare const Lib: Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es7", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext", "dom", "dom.iterable", "dom.asynciterable", "webworker", "webworker.importscripts", "webworker.iterable", "webworker.asynciterable", "scripthost", "es2015.core", "es2015.collection", "es2015.generator", "es2015.iterable", "es2015.promise", "es2015.proxy", "es2015.reflect", "es2015.symbol", "es2015.symbol.wellknown", "es2016.array.include", "es2016.intl", "es2017.arraybuffer", "es2017.date", "es2017.object", "es2017.sharedmemory", "es2017.string", "es2017.intl", "es2017.typedarrays", "es2018.asyncgenerator", "es2018.asynciterable", "es2018.intl", "es2018.promise", "es2018.regexp", "es2019.array", "es2019.object", "es2019.string", "es2019.symbol", "es2019.intl", "es2020.bigint", "es2020.date", "es2020.promise", "es2020.sharedmemory", "es2020.string", "es2020.symbol.wellknown", "es2020.intl", "es2020.number", "es2021.promise", "es2021.string", "es2021.weakref", "es2021.intl", "es2022.array", "es2022.error", "es2022.intl", "es2022.object", "es2022.string", "es2022.regexp", "es2023.array", "es2023.collection", "es2023.intl", "es2024.arraybuffer", "es2024.collection", "es2024.object", "es2024.promise", "es2024.regexp", "es2024.sharedmemory", "es2024.string", "es2025.collection", "es2025.float16", "es2025.intl", "es2025.iterator", "es2025.promise", "es2025.regexp", "esnext.asynciterable", "esnext.symbol", "esnext.bigint", "esnext.weakref", "esnext.object", "esnext.regexp", "esnext.string", "esnext.float16", "esnext.iterator", "esnext.promise", "esnext.array", "esnext.collection", "esnext.date", "esnext.decorators", "esnext.disposable", "esnext.error", "esnext.intl", "esnext.sharedmemory", "esnext.temporal", "esnext.typedarrays", "decorators", "decorators.legacy"]>, Schema.String, never, never>;
+/**
+ * `compilerOptions`, decoded as every R1.3-live boolean, R1.4 string/path/
+ * array/record/number, and R1.2 enum field — each `optionalKey` — intersected
+ * with a passthrough record so unknown and dead (R1.3 dead-list) keys survive
+ * decode and re-encode untouched, per the forward-tolerance constraint.
+ *
+ * @public
+ */
+declare const CompilerOptions: Schema.StructWithRest<Schema.Struct<{
+  readonly target: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext"]>, Schema.String, never, never>>;
+  readonly module: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["none", "commonjs", "amd", "umd", "system", "es6", "es2015", "es2020", "es2022", "esnext", "node16", "node18", "node20", "nodenext", "preserve"]>, Schema.String, never, never>>;
+  readonly moduleResolution: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["node10", "node", "classic", "node16", "nodenext", "bundler"]>, Schema.String, never, never>>;
+  readonly jsx: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["preserve", "react-native", "react-jsx", "react-jsxdev", "react"]>, Schema.String, never, never>>;
+  readonly newLine: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["crlf", "lf"]>, Schema.String, never, never>>;
+  readonly moduleDetection: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["auto", "legacy", "force"]>, Schema.String, never, never>>;
+  readonly lib: Schema.optionalKey<Schema.$Array<Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es7", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext", "dom", "dom.iterable", "dom.asynciterable", "webworker", "webworker.importscripts", "webworker.iterable", "webworker.asynciterable", "scripthost", "es2015.core", "es2015.collection", "es2015.generator", "es2015.iterable", "es2015.promise", "es2015.proxy", "es2015.reflect", "es2015.symbol", "es2015.symbol.wellknown", "es2016.array.include", "es2016.intl", "es2017.arraybuffer", "es2017.date", "es2017.object", "es2017.sharedmemory", "es2017.string", "es2017.intl", "es2017.typedarrays", "es2018.asyncgenerator", "es2018.asynciterable", "es2018.intl", "es2018.promise", "es2018.regexp", "es2019.array", "es2019.object", "es2019.string", "es2019.symbol", "es2019.intl", "es2020.bigint", "es2020.date", "es2020.promise", "es2020.sharedmemory", "es2020.string", "es2020.symbol.wellknown", "es2020.intl", "es2020.number", "es2021.promise", "es2021.string", "es2021.weakref", "es2021.intl", "es2022.array", "es2022.error", "es2022.intl", "es2022.object", "es2022.string", "es2022.regexp", "es2023.array", "es2023.collection", "es2023.intl", "es2024.arraybuffer", "es2024.collection", "es2024.object", "es2024.promise", "es2024.regexp", "es2024.sharedmemory", "es2024.string", "es2025.collection", "es2025.float16", "es2025.intl", "es2025.iterator", "es2025.promise", "es2025.regexp", "esnext.asynciterable", "esnext.symbol", "esnext.bigint", "esnext.weakref", "esnext.object", "esnext.regexp", "esnext.string", "esnext.float16", "esnext.iterator", "esnext.promise", "esnext.array", "esnext.collection", "esnext.date", "esnext.decorators", "esnext.disposable", "esnext.error", "esnext.intl", "esnext.sharedmemory", "esnext.temporal", "esnext.typedarrays", "decorators", "decorators.legacy"]>, Schema.String, never, never>>>;
+  readonly ignoreDeprecations: Schema.optionalKey<Schema.Literals<readonly ["5.0", "6.0"]>>;
+  readonly strict: Schema.optionalKey<Schema.Boolean>;
+  readonly noImplicitAny: Schema.optionalKey<Schema.Boolean>;
+  readonly strictNullChecks: Schema.optionalKey<Schema.Boolean>;
+  readonly strictFunctionTypes: Schema.optionalKey<Schema.Boolean>;
+  readonly strictBindCallApply: Schema.optionalKey<Schema.Boolean>;
+  readonly strictPropertyInitialization: Schema.optionalKey<Schema.Boolean>;
+  readonly strictBuiltinIteratorReturn: Schema.optionalKey<Schema.Boolean>;
+  readonly noImplicitThis: Schema.optionalKey<Schema.Boolean>;
+  readonly useUnknownInCatchVariables: Schema.optionalKey<Schema.Boolean>;
+  /** @deprecated Deprecated in TypeScript 6.0 when set to `false`. */
+  readonly alwaysStrict: Schema.optionalKey<Schema.Boolean>;
+  readonly noUnusedLocals: Schema.optionalKey<Schema.Boolean>;
+  readonly noUnusedParameters: Schema.optionalKey<Schema.Boolean>;
+  readonly exactOptionalPropertyTypes: Schema.optionalKey<Schema.Boolean>;
+  readonly noImplicitReturns: Schema.optionalKey<Schema.Boolean>;
+  readonly noFallthroughCasesInSwitch: Schema.optionalKey<Schema.Boolean>;
+  readonly noUncheckedIndexedAccess: Schema.optionalKey<Schema.Boolean>;
+  readonly noImplicitOverride: Schema.optionalKey<Schema.Boolean>;
+  readonly noPropertyAccessFromIndexSignature: Schema.optionalKey<Schema.Boolean>;
+  readonly allowUnusedLabels: Schema.optionalKey<Schema.Boolean>;
+  readonly allowUnreachableCode: Schema.optionalKey<Schema.Boolean>;
+  readonly noUncheckedSideEffectImports: Schema.optionalKey<Schema.Boolean>;
+  readonly allowJs: Schema.optionalKey<Schema.Boolean>;
+  readonly checkJs: Schema.optionalKey<Schema.Boolean>;
+  readonly resolveJsonModule: Schema.optionalKey<Schema.Boolean>;
+  readonly allowArbitraryExtensions: Schema.optionalKey<Schema.Boolean>;
+  readonly allowImportingTsExtensions: Schema.optionalKey<Schema.Boolean>;
+  readonly rewriteRelativeImportExtensions: Schema.optionalKey<Schema.Boolean>;
+  readonly resolvePackageJsonExports: Schema.optionalKey<Schema.Boolean>;
+  readonly resolvePackageJsonImports: Schema.optionalKey<Schema.Boolean>;
+  /** @deprecated Deprecated in TypeScript 6.0 when set to `false`. */
+  readonly allowSyntheticDefaultImports: Schema.optionalKey<Schema.Boolean>;
+  /** @deprecated Deprecated in TypeScript 6.0 when set to `false`. */
+  readonly esModuleInterop: Schema.optionalKey<Schema.Boolean>;
+  readonly preserveSymlinks: Schema.optionalKey<Schema.Boolean>;
+  readonly allowUmdGlobalAccess: Schema.optionalKey<Schema.Boolean>;
+  readonly verbatimModuleSyntax: Schema.optionalKey<Schema.Boolean>;
+  readonly isolatedModules: Schema.optionalKey<Schema.Boolean>;
+  readonly isolatedDeclarations: Schema.optionalKey<Schema.Boolean>;
+  readonly erasableSyntaxOnly: Schema.optionalKey<Schema.Boolean>;
+  readonly forceConsistentCasingInFileNames: Schema.optionalKey<Schema.Boolean>;
+  readonly declaration: Schema.optionalKey<Schema.Boolean>;
+  readonly declarationMap: Schema.optionalKey<Schema.Boolean>;
+  readonly emitDeclarationOnly: Schema.optionalKey<Schema.Boolean>;
+  readonly sourceMap: Schema.optionalKey<Schema.Boolean>;
+  readonly inlineSourceMap: Schema.optionalKey<Schema.Boolean>;
+  readonly inlineSources: Schema.optionalKey<Schema.Boolean>;
+  readonly removeComments: Schema.optionalKey<Schema.Boolean>;
+  readonly importHelpers: Schema.optionalKey<Schema.Boolean>;
+  /** @deprecated Deprecated in TypeScript 6.0. */
+  readonly downlevelIteration: Schema.optionalKey<Schema.Boolean>;
+  readonly emitBOM: Schema.optionalKey<Schema.Boolean>;
+  readonly noEmit: Schema.optionalKey<Schema.Boolean>;
+  readonly noEmitHelpers: Schema.optionalKey<Schema.Boolean>;
+  readonly noEmitOnError: Schema.optionalKey<Schema.Boolean>;
+  readonly preserveConstEnums: Schema.optionalKey<Schema.Boolean>;
+  readonly stripInternal: Schema.optionalKey<Schema.Boolean>;
+  readonly experimentalDecorators: Schema.optionalKey<Schema.Boolean>;
+  readonly emitDecoratorMetadata: Schema.optionalKey<Schema.Boolean>;
+  readonly useDefineForClassFields: Schema.optionalKey<Schema.Boolean>;
+  readonly noCheck: Schema.optionalKey<Schema.Boolean>;
+  readonly composite: Schema.optionalKey<Schema.Boolean>;
+  readonly incremental: Schema.optionalKey<Schema.Boolean>;
+  readonly disableSourceOfProjectReferenceRedirect: Schema.optionalKey<Schema.Boolean>;
+  readonly disableSolutionSearching: Schema.optionalKey<Schema.Boolean>;
+  readonly disableReferencedProjectLoad: Schema.optionalKey<Schema.Boolean>;
+  readonly assumeChangesOnlyAffectDirectDependencies: Schema.optionalKey<Schema.Boolean>;
+  readonly noErrorTruncation: Schema.optionalKey<Schema.Boolean>;
+  readonly noLib: Schema.optionalKey<Schema.Boolean>;
+  readonly noResolve: Schema.optionalKey<Schema.Boolean>;
+  readonly skipDefaultLibCheck: Schema.optionalKey<Schema.Boolean>;
+  readonly skipLibCheck: Schema.optionalKey<Schema.Boolean>;
+  readonly diagnostics: Schema.optionalKey<Schema.Boolean>;
+  readonly extendedDiagnostics: Schema.optionalKey<Schema.Boolean>;
+  readonly listFiles: Schema.optionalKey<Schema.Boolean>;
+  readonly listFilesOnly: Schema.optionalKey<Schema.Boolean>;
+  readonly listEmittedFiles: Schema.optionalKey<Schema.Boolean>;
+  readonly explainFiles: Schema.optionalKey<Schema.Boolean>;
+  readonly traceResolution: Schema.optionalKey<Schema.Boolean>;
+  readonly preserveWatchOutput: Schema.optionalKey<Schema.Boolean>;
+  readonly pretty: Schema.optionalKey<Schema.Boolean>;
+  readonly disableSizeLimit: Schema.optionalKey<Schema.Boolean>;
+  readonly libReplacement: Schema.optionalKey<Schema.Boolean>;
+  readonly stableTypeOrdering: Schema.optionalKey<Schema.Boolean>;
+  /** @deprecated Deprecated in TypeScript 6.0. */
+  readonly outFile: Schema.optionalKey<Schema.String>;
+  readonly outDir: Schema.optionalKey<Schema.String>;
+  readonly rootDir: Schema.optionalKey<Schema.String>;
+  readonly declarationDir: Schema.optionalKey<Schema.String>;
+  readonly sourceRoot: Schema.optionalKey<Schema.String>;
+  readonly mapRoot: Schema.optionalKey<Schema.String>;
+  readonly tsBuildInfoFile: Schema.optionalKey<Schema.String>;
+  /** @deprecated Deprecated in TypeScript 6.0. */
+  readonly baseUrl: Schema.optionalKey<Schema.String>;
+  readonly generateCpuProfile: Schema.optionalKey<Schema.String>;
+  readonly generateTrace: Schema.optionalKey<Schema.String>;
+  readonly typeRoots: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly rootDirs: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly jsxFactory: Schema.optionalKey<Schema.String>;
+  readonly jsxFragmentFactory: Schema.optionalKey<Schema.String>;
+  readonly jsxImportSource: Schema.optionalKey<Schema.String>;
+  readonly reactNamespace: Schema.optionalKey<Schema.String>;
+  readonly types: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly customConditions: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly moduleSuffixes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly paths: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Array<Schema.String>>>;
+  readonly plugins: Schema.optionalKey<Schema.$Array<Schema.StructWithRest<Schema.Struct<{
+    readonly name: Schema.String;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>>;
+  readonly maxNodeModuleJsDepth: Schema.optionalKey<Schema.Number>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Type-only companion namespace for {@link (CompilerOptions:variable)}, exposing its
+ * decoded and encoded shapes.
+ *
+ * @public
+ */
+declare namespace CompilerOptions {
+  /**
+   * The decoded `compilerOptions` shape: every typed field optional, plus passthrough for unknown keys.
+   *
+   * @public
+   */
+  type Type = typeof CompilerOptions.Type;
+  /**
+   * The encoded (on-disk JSON) `compilerOptions` shape.
+   *
+   * @public
+   */
+  type Encoded = typeof CompilerOptions.Encoded;
+}
+//#endregion
+//#region src/TsconfigJson.d.ts
+/** `watchOptions.watchFile`. @public */
+declare const WatchFile: Schema.decodeTo<Schema.Literals<readonly ["fixedpollinginterval", "prioritypollinginterval", "dynamicprioritypolling", "fixedchunksizepolling", "usefsevents", "usefseventsonparentdirectory"]>, Schema.String, never, never>;
+/** `watchOptions.watchDirectory`. @public */
+declare const WatchDirectory: Schema.decodeTo<Schema.Literals<readonly ["usefsevents", "fixedpollinginterval", "dynamicprioritypolling", "fixedchunksizepolling"]>, Schema.String, never, never>;
+/** `watchOptions.fallbackPolling`. @public */
+declare const FallbackPolling: Schema.decodeTo<Schema.Literals<readonly ["fixedinterval", "priorityinterval", "dynamicpriority", "fixedchunksize"]>, Schema.String, never, never>;
+/**
+ * One `references[]` entry: `path` is required and non-empty; every other key
+ * is preserved verbatim (per R1.5).
+ *
+ * @public
+ */
+declare const Reference: Schema.StructWithRest<Schema.Struct<{
+  readonly path: Schema.String;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Type-only companion namespace for {@link (Reference:variable)}.
+ *
+ * @public
+ */
+declare namespace Reference {
+  /**
+   * The decoded `references[]` entry shape.
+   *
+   * @public
+   */
+  type Type = typeof Reference.Type;
+  /**
+   * The encoded (on-disk JSON) `references[]` entry shape.
+   *
+   * @public
+   */
+  type Encoded = typeof Reference.Encoded;
+}
+/**
+ * `watchOptions` — the three enum fields (R1.2), the two live booleans/arrays
+ * (R1.5), and a passthrough record (schemastore's `force` is phantom).
+ *
+ * @public
+ */
+declare const WatchOptions: Schema.StructWithRest<Schema.Struct<{
+  readonly watchFile: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["fixedpollinginterval", "prioritypollinginterval", "dynamicprioritypolling", "fixedchunksizepolling", "usefsevents", "usefseventsonparentdirectory"]>, Schema.String, never, never>>;
+  readonly watchDirectory: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["usefsevents", "fixedpollinginterval", "dynamicprioritypolling", "fixedchunksizepolling"]>, Schema.String, never, never>>;
+  readonly fallbackPolling: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["fixedinterval", "priorityinterval", "dynamicpriority", "fixedchunksize"]>, Schema.String, never, never>>;
+  readonly synchronousWatchDirectory: Schema.optionalKey<Schema.Boolean>;
+  readonly excludeDirectories: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly excludeFiles: Schema.optionalKey<Schema.$Array<Schema.String>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Type-only companion namespace for {@link (WatchOptions:variable)}.
+ *
+ * @public
+ */
+declare namespace WatchOptions {
+  /**
+   * The decoded `watchOptions` shape.
+   *
+   * @public
+   */
+  type Type = typeof WatchOptions.Type;
+  /**
+   * The encoded (on-disk JSON) `watchOptions` shape.
+   *
+   * @public
+   */
+  type Encoded = typeof WatchOptions.Encoded;
+}
+/**
+ * `typeAcquisition` — per R1.5.
+ *
+ * @public
+ */
+declare const TypeAcquisition: Schema.StructWithRest<Schema.Struct<{
+  readonly enable: Schema.optionalKey<Schema.Boolean>;
+  readonly include: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly exclude: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly disableFilenameBasedTypeAcquisition: Schema.optionalKey<Schema.Boolean>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Type-only companion namespace for {@link (TypeAcquisition:variable)}.
+ *
+ * @public
+ */
+declare namespace TypeAcquisition {
+  /**
+   * The decoded `typeAcquisition` shape.
+   *
+   * @public
+   */
+  type Type = typeof TypeAcquisition.Type;
+  /**
+   * The encoded (on-disk JSON) `typeAcquisition` shape.
+   *
+   * @public
+   */
+  type Encoded = typeof TypeAcquisition.Encoded;
+}
+/**
+ * The tsconfig.json document: every typed top-level field (R1.1) optional,
+ * plus a passthrough record so unrecognized keys (`buildOptions`, `ts-node`,
+ * …) survive decode and re-encode untouched — tsc itself silently ignores
+ * unknown top-level keys, and this schema follows suit.
+ *
+ * @public
+ */
+declare const TsconfigJson: Schema.StructWithRest<Schema.Struct<{
+  readonly compilerOptions: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
+    readonly target: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext"]>, Schema.String, never, never>>;
+    readonly module: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["none", "commonjs", "amd", "umd", "system", "es6", "es2015", "es2020", "es2022", "esnext", "node16", "node18", "node20", "nodenext", "preserve"]>, Schema.String, never, never>>;
+    readonly moduleResolution: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["node10", "node", "classic", "node16", "nodenext", "bundler"]>, Schema.String, never, never>>;
+    readonly jsx: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["preserve", "react-native", "react-jsx", "react-jsxdev", "react"]>, Schema.String, never, never>>;
+    readonly newLine: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["crlf", "lf"]>, Schema.String, never, never>>;
+    readonly moduleDetection: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["auto", "legacy", "force"]>, Schema.String, never, never>>;
+    readonly lib: Schema.optionalKey<Schema.$Array<Schema.decodeTo<Schema.Literals<readonly ["es5", "es6", "es7", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "es2024", "es2025", "esnext", "dom", "dom.iterable", "dom.asynciterable", "webworker", "webworker.importscripts", "webworker.iterable", "webworker.asynciterable", "scripthost", "es2015.core", "es2015.collection", "es2015.generator", "es2015.iterable", "es2015.promise", "es2015.proxy", "es2015.reflect", "es2015.symbol", "es2015.symbol.wellknown", "es2016.array.include", "es2016.intl", "es2017.arraybuffer", "es2017.date", "es2017.object", "es2017.sharedmemory", "es2017.string", "es2017.intl", "es2017.typedarrays", "es2018.asyncgenerator", "es2018.asynciterable", "es2018.intl", "es2018.promise", "es2018.regexp", "es2019.array", "es2019.object", "es2019.string", "es2019.symbol", "es2019.intl", "es2020.bigint", "es2020.date", "es2020.promise", "es2020.sharedmemory", "es2020.string", "es2020.symbol.wellknown", "es2020.intl", "es2020.number", "es2021.promise", "es2021.string", "es2021.weakref", "es2021.intl", "es2022.array", "es2022.error", "es2022.intl", "es2022.object", "es2022.string", "es2022.regexp", "es2023.array", "es2023.collection", "es2023.intl", "es2024.arraybuffer", "es2024.collection", "es2024.object", "es2024.promise", "es2024.regexp", "es2024.sharedmemory", "es2024.string", "es2025.collection", "es2025.float16", "es2025.intl", "es2025.iterator", "es2025.promise", "es2025.regexp", "esnext.asynciterable", "esnext.symbol", "esnext.bigint", "esnext.weakref", "esnext.object", "esnext.regexp", "esnext.string", "esnext.float16", "esnext.iterator", "esnext.promise", "esnext.array", "esnext.collection", "esnext.date", "esnext.decorators", "esnext.disposable", "esnext.error", "esnext.intl", "esnext.sharedmemory", "esnext.temporal", "esnext.typedarrays", "decorators", "decorators.legacy"]>, Schema.String, never, never>>>;
+    readonly ignoreDeprecations: Schema.optionalKey<Schema.Literals<readonly ["5.0", "6.0"]>>;
+    readonly strict: Schema.optionalKey<Schema.Boolean>;
+    readonly noImplicitAny: Schema.optionalKey<Schema.Boolean>;
+    readonly strictNullChecks: Schema.optionalKey<Schema.Boolean>;
+    readonly strictFunctionTypes: Schema.optionalKey<Schema.Boolean>;
+    readonly strictBindCallApply: Schema.optionalKey<Schema.Boolean>;
+    readonly strictPropertyInitialization: Schema.optionalKey<Schema.Boolean>;
+    readonly strictBuiltinIteratorReturn: Schema.optionalKey<Schema.Boolean>;
+    readonly noImplicitThis: Schema.optionalKey<Schema.Boolean>;
+    readonly useUnknownInCatchVariables: Schema.optionalKey<Schema.Boolean>;
+    readonly alwaysStrict: Schema.optionalKey<Schema.Boolean>;
+    readonly noUnusedLocals: Schema.optionalKey<Schema.Boolean>;
+    readonly noUnusedParameters: Schema.optionalKey<Schema.Boolean>;
+    readonly exactOptionalPropertyTypes: Schema.optionalKey<Schema.Boolean>;
+    readonly noImplicitReturns: Schema.optionalKey<Schema.Boolean>;
+    readonly noFallthroughCasesInSwitch: Schema.optionalKey<Schema.Boolean>;
+    readonly noUncheckedIndexedAccess: Schema.optionalKey<Schema.Boolean>;
+    readonly noImplicitOverride: Schema.optionalKey<Schema.Boolean>;
+    readonly noPropertyAccessFromIndexSignature: Schema.optionalKey<Schema.Boolean>;
+    readonly allowUnusedLabels: Schema.optionalKey<Schema.Boolean>;
+    readonly allowUnreachableCode: Schema.optionalKey<Schema.Boolean>;
+    readonly noUncheckedSideEffectImports: Schema.optionalKey<Schema.Boolean>;
+    readonly allowJs: Schema.optionalKey<Schema.Boolean>;
+    readonly checkJs: Schema.optionalKey<Schema.Boolean>;
+    readonly resolveJsonModule: Schema.optionalKey<Schema.Boolean>;
+    readonly allowArbitraryExtensions: Schema.optionalKey<Schema.Boolean>;
+    readonly allowImportingTsExtensions: Schema.optionalKey<Schema.Boolean>;
+    readonly rewriteRelativeImportExtensions: Schema.optionalKey<Schema.Boolean>;
+    readonly resolvePackageJsonExports: Schema.optionalKey<Schema.Boolean>;
+    readonly resolvePackageJsonImports: Schema.optionalKey<Schema.Boolean>;
+    readonly allowSyntheticDefaultImports: Schema.optionalKey<Schema.Boolean>;
+    readonly esModuleInterop: Schema.optionalKey<Schema.Boolean>;
+    readonly preserveSymlinks: Schema.optionalKey<Schema.Boolean>;
+    readonly allowUmdGlobalAccess: Schema.optionalKey<Schema.Boolean>;
+    readonly verbatimModuleSyntax: Schema.optionalKey<Schema.Boolean>;
+    readonly isolatedModules: Schema.optionalKey<Schema.Boolean>;
+    readonly isolatedDeclarations: Schema.optionalKey<Schema.Boolean>;
+    readonly erasableSyntaxOnly: Schema.optionalKey<Schema.Boolean>;
+    readonly forceConsistentCasingInFileNames: Schema.optionalKey<Schema.Boolean>;
+    readonly declaration: Schema.optionalKey<Schema.Boolean>;
+    readonly declarationMap: Schema.optionalKey<Schema.Boolean>;
+    readonly emitDeclarationOnly: Schema.optionalKey<Schema.Boolean>;
+    readonly sourceMap: Schema.optionalKey<Schema.Boolean>;
+    readonly inlineSourceMap: Schema.optionalKey<Schema.Boolean>;
+    readonly inlineSources: Schema.optionalKey<Schema.Boolean>;
+    readonly removeComments: Schema.optionalKey<Schema.Boolean>;
+    readonly importHelpers: Schema.optionalKey<Schema.Boolean>;
+    readonly downlevelIteration: Schema.optionalKey<Schema.Boolean>;
+    readonly emitBOM: Schema.optionalKey<Schema.Boolean>;
+    readonly noEmit: Schema.optionalKey<Schema.Boolean>;
+    readonly noEmitHelpers: Schema.optionalKey<Schema.Boolean>;
+    readonly noEmitOnError: Schema.optionalKey<Schema.Boolean>;
+    readonly preserveConstEnums: Schema.optionalKey<Schema.Boolean>;
+    readonly stripInternal: Schema.optionalKey<Schema.Boolean>;
+    readonly experimentalDecorators: Schema.optionalKey<Schema.Boolean>;
+    readonly emitDecoratorMetadata: Schema.optionalKey<Schema.Boolean>;
+    readonly useDefineForClassFields: Schema.optionalKey<Schema.Boolean>;
+    readonly noCheck: Schema.optionalKey<Schema.Boolean>;
+    readonly composite: Schema.optionalKey<Schema.Boolean>;
+    readonly incremental: Schema.optionalKey<Schema.Boolean>;
+    readonly disableSourceOfProjectReferenceRedirect: Schema.optionalKey<Schema.Boolean>;
+    readonly disableSolutionSearching: Schema.optionalKey<Schema.Boolean>;
+    readonly disableReferencedProjectLoad: Schema.optionalKey<Schema.Boolean>;
+    readonly assumeChangesOnlyAffectDirectDependencies: Schema.optionalKey<Schema.Boolean>;
+    readonly noErrorTruncation: Schema.optionalKey<Schema.Boolean>;
+    readonly noLib: Schema.optionalKey<Schema.Boolean>;
+    readonly noResolve: Schema.optionalKey<Schema.Boolean>;
+    readonly skipDefaultLibCheck: Schema.optionalKey<Schema.Boolean>;
+    readonly skipLibCheck: Schema.optionalKey<Schema.Boolean>;
+    readonly diagnostics: Schema.optionalKey<Schema.Boolean>;
+    readonly extendedDiagnostics: Schema.optionalKey<Schema.Boolean>;
+    readonly listFiles: Schema.optionalKey<Schema.Boolean>;
+    readonly listFilesOnly: Schema.optionalKey<Schema.Boolean>;
+    readonly listEmittedFiles: Schema.optionalKey<Schema.Boolean>;
+    readonly explainFiles: Schema.optionalKey<Schema.Boolean>;
+    readonly traceResolution: Schema.optionalKey<Schema.Boolean>;
+    readonly preserveWatchOutput: Schema.optionalKey<Schema.Boolean>;
+    readonly pretty: Schema.optionalKey<Schema.Boolean>;
+    readonly disableSizeLimit: Schema.optionalKey<Schema.Boolean>;
+    readonly libReplacement: Schema.optionalKey<Schema.Boolean>;
+    readonly stableTypeOrdering: Schema.optionalKey<Schema.Boolean>;
+    readonly outFile: Schema.optionalKey<Schema.String>;
+    readonly outDir: Schema.optionalKey<Schema.String>;
+    readonly rootDir: Schema.optionalKey<Schema.String>;
+    readonly declarationDir: Schema.optionalKey<Schema.String>;
+    readonly sourceRoot: Schema.optionalKey<Schema.String>;
+    readonly mapRoot: Schema.optionalKey<Schema.String>;
+    readonly tsBuildInfoFile: Schema.optionalKey<Schema.String>;
+    readonly baseUrl: Schema.optionalKey<Schema.String>;
+    readonly generateCpuProfile: Schema.optionalKey<Schema.String>;
+    readonly generateTrace: Schema.optionalKey<Schema.String>;
+    readonly typeRoots: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly rootDirs: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly jsxFactory: Schema.optionalKey<Schema.String>;
+    readonly jsxFragmentFactory: Schema.optionalKey<Schema.String>;
+    readonly jsxImportSource: Schema.optionalKey<Schema.String>;
+    readonly reactNamespace: Schema.optionalKey<Schema.String>;
+    readonly types: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly customConditions: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly moduleSuffixes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly paths: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Array<Schema.String>>>;
+    readonly plugins: Schema.optionalKey<Schema.$Array<Schema.StructWithRest<Schema.Struct<{
+      readonly name: Schema.String;
+    }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>>;
+    readonly maxNodeModuleJsDepth: Schema.optionalKey<Schema.Number>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
+  readonly extends: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.$Array<Schema.String>]>>;
+  readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly include: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly exclude: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly references: Schema.optionalKey<Schema.$Array<Schema.StructWithRest<Schema.Struct<{
+    readonly path: Schema.String;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>>;
+  readonly watchOptions: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
+    readonly watchFile: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["fixedpollinginterval", "prioritypollinginterval", "dynamicprioritypolling", "fixedchunksizepolling", "usefsevents", "usefseventsonparentdirectory"]>, Schema.String, never, never>>;
+    readonly watchDirectory: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["usefsevents", "fixedpollinginterval", "dynamicprioritypolling", "fixedchunksizepolling"]>, Schema.String, never, never>>;
+    readonly fallbackPolling: Schema.optionalKey<Schema.decodeTo<Schema.Literals<readonly ["fixedinterval", "priorityinterval", "dynamicpriority", "fixedchunksize"]>, Schema.String, never, never>>;
+    readonly synchronousWatchDirectory: Schema.optionalKey<Schema.Boolean>;
+    readonly excludeDirectories: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly excludeFiles: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
+  readonly typeAcquisition: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
+    readonly enable: Schema.optionalKey<Schema.Boolean>;
+    readonly include: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly exclude: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly disableFilenameBasedTypeAcquisition: Schema.optionalKey<Schema.Boolean>;
+  }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
+  readonly compileOnSave: Schema.optionalKey<Schema.Boolean>;
+  readonly $schema: Schema.optionalKey<Schema.String>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/**
+ * Type-only companion namespace for {@link (TsconfigJson:variable)}, exposing its decoded
+ * and encoded shapes plus the JSONC codec.
+ *
+ * @public
+ */
+declare namespace TsconfigJson {
+  /**
+   * The decoded tsconfig.json shape: every typed field optional, plus passthrough for unknown keys.
+   *
+   * @public
+   */
+  type Type = typeof TsconfigJson.Type;
+  /**
+   * The encoded (on-disk JSON) tsconfig.json shape.
+   *
+   * @public
+   */
+  type Encoded = typeof TsconfigJson.Encoded;
+}
+/**
+ * Decodes a JSONC-encoded tsconfig.json document straight into
+ * {@link (TsconfigJson:variable)}. Bound once at module top level —
+ * `Jsonc.schema` is schema-producing, and this is the shared instance (the
+ * house `FromString` idiom, R3.3; `TsconfigJson` is a `Schema.StructWithRest`
+ * value rather than a `Schema.Class`, so the codec is a sibling export, not a
+ * static).
+ *
+ * @public
+ */
+declare const TsconfigJsonFromString: Schema.Codec<typeof TsconfigJson.Type, string>;
+declare const TsconfigParseError_base: Schema.Class<TsconfigParseError, Schema.TaggedStruct<"TsconfigParseError", {
+  /** The file path that failed to parse, or `""` when not file-bound. */
+  readonly path: Schema.String;
+  /** The underlying decode failure. */
+  readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Raised when a tsconfig.json document fails to parse or decode. `path` is
+ * the file path when the failure is file-bound, and the empty string
+ * otherwise (e.g. decoding an in-memory string). The loader (Task 8) wraps
+ * file-bound decode failures in this error; this module only declares it.
+ *
+ * @public
+ */
+declare class TsconfigParseError extends TsconfigParseError_base {
+  get message(): string;
+}
+//#endregion
+//#region src/ResolvedTsconfig.d.ts
+/**
+ * The result of resolving a tsconfig.json's full `extends` chain: the merged
+ * compiler options and inherited settings, flattened per R2/E4, with enough
+ * provenance for the consumer (`configPath`, `extendedPaths`, and `pathsBase`,
+ * the directory of the config that declared `paths`). Unknown top-level keys
+ * survive as passthrough via the index signature.
+ *
+ * @public
+ */
+interface ResolvedTsconfig {
+  /** The own (most-derived) config's path — the last of {@link (ResolvedTsconfig:interface).extendedPaths}. */
+  readonly configPath: string;
+  /** The full resolution chain, base-most first and own config last. */
+  readonly extendedPaths: ReadonlyArray<string>;
+  /** The per-key merged compiler options (derived wins; `paths` replaced wholesale). */
+  readonly compilerOptions: CompilerOptions.Type;
+  /** The resolved `files`, if any config in the chain declared it. */
+  readonly files?: ReadonlyArray<string>;
+  /** The resolved `include`, if any config in the chain declared it. */
+  readonly include?: ReadonlyArray<string>;
+  /** The resolved `exclude`, if any config in the chain declared it. */
+  readonly exclude?: ReadonlyArray<string>;
+  /** The own config's `references` (never inherited). */
+  readonly references?: ReadonlyArray<Reference.Type>;
+  /** The per-key merged `watchOptions`. */
+  readonly watchOptions?: WatchOptions.Type;
+  /** The own config's `typeAcquisition` (never inherited). */
+  readonly typeAcquisition?: TypeAcquisition.Type;
+  /** `compileOnSave`, inherited only when own is undefined and the inherited value is truthy. */
+  readonly compileOnSave?: boolean;
+  /** The directory of the config that declared `paths` (E4), against which `paths` values resolve. */
+  readonly pathsBase?: string;
+  /** Unknown top-level keys, preserved through the merge (forward tolerance). */
+  readonly [key: string]: unknown;
+}
+/**
+ * The pure extends-merge engine: parse-time path absolutization
+ * ({@link (ResolvedTsconfig:variable).absolutize}), the per-field merge fold
+ * ({@link (ResolvedTsconfig:variable).merge}), and the `${configDir}` final
+ * phase ({@link (ResolvedTsconfig:variable).substituteConfigDir}).
+ *
+ * @public
+ */
+declare const ResolvedTsconfig: {
+  readonly absolutize: (doc: TsconfigJson.Type, configDir: string, join: (a: string, b: string) => string) => TsconfigJson.Type;
+  readonly merge: (base: ResolvedTsconfig, derived: TsconfigJson.Type, derivedPath: string) => ResolvedTsconfig;
+  readonly substituteConfigDir: (resolved: ResolvedTsconfig, finalDir: string) => ResolvedTsconfig;
+};
+//#endregion
+//#region src/PortableTsconfig.d.ts
+/**
+ * A portable, JSON-serializable tsconfig.json (compilerOptions-only), for
+ * virtual TypeScript environments that control their own file paths and emit
+ * settings externally. Carries only knowably-portable options: no absolute or
+ * machine-specific paths, and no emit or file-selection surface.
+ *
+ * @public
+ */
+interface PortableTsconfig {
+  /** The tsconfig JSON Schema URL, stamped for IDE support. */
+  readonly $schema: "https://json.schemastore.org/tsconfig";
+  /** The allow-listed, forced-flag-applied compiler options. */
+  readonly compilerOptions: Record<string, unknown>;
+}
+/**
+ * The portable-tsconfig filter: {@link (PortableTsconfig:variable).make}
+ * narrows a resolved or bare compiler-options object to the allow-listed,
+ * machine-independent subset described on {@link (PortableTsconfig:interface)}.
+ *
+ * @public
+ */
+declare const PortableTsconfig: {
+  readonly make: (input: ResolvedTsconfig | CompilerOptions.Type) => PortableTsconfig;
+};
+//#endregion
+//#region src/TsconfigDiscovery.d.ts
+/**
+ * Options for {@link TsconfigDiscovery.findNearest}.
+ *
+ * @public
+ */
+interface FindNearestOptions {
+  /** The config file name to search for. Defaults to `"tsconfig.json"`. */
+  readonly filename?: string;
+  /** Stop ascending after this directory, inclusive. */
+  readonly stopAt?: string;
+}
+/**
+ * Nearest-config upward discovery for `tsconfig.json`.
+ *
+ * @public
+ */
+declare const TsconfigDiscovery: {
+  readonly findNearest: (start: string, options?: FindNearestOptions) => Effect.Effect<Option.Option<string>, never, FileSystem.FileSystem | Path.Path>;
+};
+//#endregion
+//#region src/TsconfigLoader.d.ts
+declare const TsconfigExtendsError_base: Schema.Class<TsconfigExtendsError, Schema.TaggedStruct<"TsconfigExtendsError", {
+  /** The config whose `extends` could not be resolved. */
+  readonly path: Schema.String;
+  /** The target that failed: the spec, the re-entered path, or the refused path. */
+  readonly target: Schema.String;
+  /** Why resolution failed. */
+  readonly reason: Schema.Literals<readonly ["not-found", "cycle", "depth", "empty"]>;
+  /** The full resolution chain of normalized absolute config paths. */
+  readonly chain: Schema.$Array<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Raised when a config's `extends` chain cannot be resolved: an unresolvable
+ * target (`"not-found"`), a re-entrant chain (`"cycle"`), a chain deeper than
+ * `MAX_EXTENDS_DEPTH` (`"depth"`), or an empty target string (`"empty"`).
+ * `path` is the config whose `extends` failed, `target` is what it tried to
+ * extend (the offending spec for `"not-found"`/`"empty"`, the re-entered config
+ * path for `"cycle"`, the refused config for `"depth"`), and `chain` is the full
+ * resolution chain of normalized absolute paths.
+ *
+ * @public
+ */
+declare class TsconfigExtendsError extends TsconfigExtendsError_base {
+  get message(): string;
+}
+/**
+ * The tsconfig.json loader: {@link TsconfigLoader.load} reads and decodes one
+ * config file, {@link TsconfigLoader.resolve} runs the full load -\> extends -\>
+ * merge -\> `${configDir}` pipeline.
+ *
+ * @public
+ */
+declare const TsconfigLoader: {
+  readonly load: (configPath: string) => Effect.Effect<TsconfigJson.Type, TsconfigParseError | PlatformError.PlatformError, FileSystem.FileSystem | Path.Path>;
+  readonly resolve: (configPath: string) => Effect.Effect<ResolvedTsconfig, TsconfigParseError | TsconfigExtendsError | PlatformError.PlatformError, FileSystem.FileSystem | Path.Path>;
+};
+//#endregion
+//#region src/TsEnumCodec.d.ts
+/**
+ * The nine `compilerOptions` / `watchOptions` enum families this codec knows,
+ * per R1.6.
+ *
+ * @public
+ */
+type EnumFamily = "target" | "module" | "moduleResolution" | "jsx" | "newLine" | "moduleDetection" | "watchFile" | "watchDirectory" | "fallbackPolling";
+/**
+ * The string↔numeric enum codec for `compilerOptions` / `watchOptions`
+ * families, per R1.6. Plain data: every lookup is a synchronous map read
+ * returning `Option.Option`, never a thrown error.
+ *
+ * @public
+ */
+declare const TsEnumCodec: {
+  readonly encode: (family: EnumFamily, value: string) => Option.Option<number>;
+  readonly decode: (family: EnumFamily, value: number) => Option.Option<string>;
+  readonly normalizeLibReference: (lib: string) => string;
+  readonly encodeCompilerOptions: (options: CompilerOptions.Type) => Record<string, unknown>;
+  readonly decodeCompilerOptions: (numeric: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+};
+//#endregion
+export { CompilerOptions, type EnumFamily, FallbackPolling, type FindNearestOptions, Jsx, Lib, Module, ModuleDetection, ModuleResolution, NewLine, PortableTsconfig, Reference, ResolvedTsconfig, Target, TsEnumCodec, TsconfigDiscovery, TsconfigExtendsError, TsconfigJson, TsconfigJsonFromString, TsconfigLoader, TsconfigParseError, TypeAcquisition, WatchDirectory, WatchFile, WatchOptions };
+//# sourceMappingURL=index.d.ts.map