[api] Fix compatibility with older @types/node and exactOptionalPropertyTypes

[andrewbranch]

Fixes #4405

[Copilot]

Pull request overview

This PR addresses type-checking failures for consumers of the native-preview programmatic APIs when exactOptionalPropertyTypes: true is enabled and older @types/node versions are used, by tightening the package’s TS configuration and adjusting emitted/public API type shapes for optional properties and TextDecoder.

Changes:

• Enable exactOptionalPropertyTypes for native-preview builds and relax test-only typechecking via skipLibCheck to accommodate third-party deps.
• Update API surface typings so optional properties are compatible under exactOptionalPropertyTypes (e.g., explicitly allowing | undefined where required).
• Add a local TextDecoder type to avoid relying on newer @types/node global type declarations.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
_packages/native-preview/tsconfig.base.json	Enables exactOptionalPropertyTypes for the package.
_packages/native-preview/test/tsconfig.json	Sets skipLibCheck for the test project (workaround for tinybench).
_packages/native-preview/src/ast/ast.ts	Adjusts Node.jsDoc optional typing for exact-optional compatibility.
_packages/native-preview/src/api/sync/types.ts	Updates optional properties to explicitly include `
_packages/native-preview/src/api/sync/api.ts	Updates exported API surface and optional properties (generated sync API).
_packages/native-preview/src/api/node/node.ts	Imports TextDecoder as a type from infrastructure module.
_packages/native-preview/src/api/node/node.infrastructure.ts	Introduces a TextDecoder interface to support older @types/node.
_packages/native-preview/src/api/async/types.ts	Updates optional properties to explicitly include `
_packages/native-preview/src/api/async/api.ts	Updates optional properties to explicitly include `

Comments suppressed due to low confidence (1)

_packages/native-preview/src/api/sync/api.ts:121

• src/api/sync/api.ts is marked as auto-generated from src/api/async/api.ts (see header and scripts/generateSync.ts). Adding __String to the sync export list without making the same change in the async source means the change will be lost the next time npm run generate:sync is run. Please add/adjust the export in src/api/async/api.ts (or add a sync directive) and regenerate the sync output.

export { CompletionItemKind, DiagnosticCategory, ElementFlags, ModifierFlags, ModuleKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypePredicateKind };
export type { APIOptions, ClientSocketOptions, ClientSpawnOptions, DocumentIdentifier, DocumentPosition, LSPConnectionOptions, SourceFileMetadata };
export type { AssertsIdentifierTypePredicate, AssertsThisTypePredicate, BigIntLiteralType, BooleanLiteralType, CompletionEntry, CompletionInfo, CompletionOptions, ConditionalType, Diagnostic, FreshableType, IdentifierTypePredicate, IndexedAccessType, IndexInfo, IndexType, InterfaceType, IntersectionType, IntrinsicType, JSDocTagInfo, LiteralType, NumberLiteralType, ObjectType, StringLiteralType, StringMappingType, SubstitutionType, TemplateLiteralType, ThisTypePredicate, TupleType, Type, TypeParameter, TypePredicate, TypePredicateBase, TypeReference, UnionOrIntersectionType, UnionType };

[andrewbranch]

wtf8.ts is not part of the public API so it doesn't enter a consumer's program