@corsa-bind/napi 1.13.2 → 1.14.1

package/README.md

@@ -30,6 +30,7 @@ bun run ./main.ts
 
 - native JS bindings for the `corsa` API and LSP surface
 - an ESM TypeScript wrapper under `dist/`
+- an `@corsa-bind/napi/orchestrator` subpath for workflow-level JS helpers
 - no bundled Corsa executable
 
 ## Runtime requirement
@@ -45,6 +46,10 @@ and `closeAsync` for production Node services and editor integrations. The
 older synchronous methods remain available for short scripts and latency-bounded
 tooling, but they run on the JavaScript call path.
 
+The root entry point intentionally stays close to the upstream binding surface.
+Workflow strategies such as checker query coalescing live under
+`@corsa-bind/napi/orchestrator`.
+
 ## Development
 
 ```bash
@@ -54,5 +59,5 @@ vp test run --config ./vite.config.ts src/bindings/nodejs/corsa_node/ts/**/*.tes
 ```
 
 Repository-level executable examples live under [`examples/`](../../examples/README.md),
-including mock-client, virtual-document, distributed-orchestrator, and
+including mock-client, virtual-document, and
 real-Corsa snapshot samples.

package/dist/checker_batch.d.mts

@@ -0,0 +1,22 @@
+import { CheckerBatchRequest, CheckerBatchResponse } from "./types.mjs";
+//#region checker_batch.d.ts
+interface CheckerBatchCapableClient {
+  callJson<T>(method: string, params?: unknown): T;
+}
+interface AsyncCheckerBatchCapableClient {
+  callJsonAsync<T>(method: string, params?: unknown): Promise<T>;
+}
+/**
+ * Sends multiple raw checker endpoint calls through upstream `batchRequests`.
+ *
+ * This keeps the original typed primitives available while giving hot paths a
+ * single transport round trip for relation-heavy workflows.
+ */
+declare function batchCheckerRequests(client: CheckerBatchCapableClient, requests: readonly CheckerBatchRequest[]): CheckerBatchResponse[];
+/**
+ * Async counterpart of {@link batchCheckerRequests}.
+ */
+declare function batchCheckerRequestsAsync(client: AsyncCheckerBatchCapableClient, requests: readonly CheckerBatchRequest[]): Promise<CheckerBatchResponse[]>;
+//#endregion
+export { AsyncCheckerBatchCapableClient, CheckerBatchCapableClient, batchCheckerRequests, batchCheckerRequestsAsync };
+//# sourceMappingURL=checker_batch.d.mts.map

package/dist/checker_batch.mjs

@@ -0,0 +1,43 @@
+//#region checker_batch.ts
+/**
+* Sends multiple raw checker endpoint calls through upstream `batchRequests`.
+*
+* This keeps the original typed primitives available while giving hot paths a
+* single transport round trip for relation-heavy workflows.
+*/
+function batchCheckerRequests(client, requests) {
+	if (requests.length === 0) return [];
+	return normalizeCheckerBatchResponses(client.callJson("batchRequests", { requests: requests.map(normalizeCheckerBatchRequest) }), requests.length);
+}
+/**
+* Async counterpart of {@link batchCheckerRequests}.
+*/
+async function batchCheckerRequestsAsync(client, requests) {
+	if (requests.length === 0) return [];
+	return normalizeCheckerBatchResponses(await client.callJsonAsync("batchRequests", { requests: requests.map(normalizeCheckerBatchRequest) }), requests.length);
+}
+function normalizeCheckerBatchRequest(request) {
+	if (request.params === void 0) return { method: request.method };
+	return {
+		method: request.method,
+		params: request.params
+	};
+}
+function normalizeCheckerBatchResponses(response, expectedLength) {
+	if (typeof response !== "object" || response === null) throw new Error("batchRequests returned a malformed response");
+	const responses = response.responses;
+	if (!Array.isArray(responses)) throw new Error("batchRequests returned a malformed response list");
+	if (responses.length !== expectedLength) throw new Error(`batchRequests returned ${responses.length} responses for ${expectedLength} requests`);
+	return responses.map((item, index) => {
+		if (typeof item !== "object" || item === null) throw new Error(`batchRequests response ${index} is not an object`);
+		const record = item;
+		const normalized = { method: typeof record.method === "string" ? record.method : "" };
+		if (typeof record.error === "string" && record.error.length > 0) normalized.error = record.error;
+		if ("result" in record) normalized.result = record.result;
+		return normalized;
+	});
+}
+//#endregion
+export { batchCheckerRequests, batchCheckerRequestsAsync };
+
+//# sourceMappingURL=checker_batch.mjs.map

package/dist/checker_batch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker_batch.mjs","names":[],"sources":["../ts/checker_batch.ts"],"sourcesContent":["import type { CheckerBatchRequest, CheckerBatchResponse } from \"./types\";\n\nexport interface CheckerBatchCapableClient {\n  callJson<T>(method: string, params?: unknown): T;\n}\n\nexport interface AsyncCheckerBatchCapableClient {\n  callJsonAsync<T>(method: string, params?: unknown): Promise<T>;\n}\n\n/**\n * Sends multiple raw checker endpoint calls through upstream `batchRequests`.\n *\n * This keeps the original typed primitives available while giving hot paths a\n * single transport round trip for relation-heavy workflows.\n */\nexport function batchCheckerRequests(\n  client: CheckerBatchCapableClient,\n  requests: readonly CheckerBatchRequest[],\n): CheckerBatchResponse[] {\n  if (requests.length === 0) {\n    return [];\n  }\n  const response = client.callJson<{ responses: unknown }>(\"batchRequests\", {\n    requests: requests.map(normalizeCheckerBatchRequest),\n  });\n  return normalizeCheckerBatchResponses(response, requests.length);\n}\n\n/**\n * Async counterpart of {@link batchCheckerRequests}.\n */\nexport async function batchCheckerRequestsAsync(\n  client: AsyncCheckerBatchCapableClient,\n  requests: readonly CheckerBatchRequest[],\n): Promise<CheckerBatchResponse[]> {\n  if (requests.length === 0) {\n    return [];\n  }\n  const response = await client.callJsonAsync<{ responses: unknown }>(\"batchRequests\", {\n    requests: requests.map(normalizeCheckerBatchRequest),\n  });\n  return normalizeCheckerBatchResponses(response, requests.length);\n}\n\nfunction normalizeCheckerBatchRequest(request: CheckerBatchRequest): CheckerBatchRequest {\n  if (request.params === undefined) {\n    return { method: request.method };\n  }\n  return { method: request.method, params: request.params };\n}\n\nfunction normalizeCheckerBatchResponses(\n  response: { responses?: unknown },\n  expectedLength: number,\n): CheckerBatchResponse[] {\n  if (typeof response !== \"object\" || response === null) {\n    throw new Error(\"batchRequests returned a malformed response\");\n  }\n  const responses = response.responses;\n  if (!Array.isArray(responses)) {\n    throw new Error(\"batchRequests returned a malformed response list\");\n  }\n  if (responses.length !== expectedLength) {\n    throw new Error(\n      `batchRequests returned ${responses.length} responses for ${expectedLength} requests`,\n    );\n  }\n  return responses.map((item, index) => {\n    if (typeof item !== \"object\" || item === null) {\n      throw new Error(`batchRequests response ${index} is not an object`);\n    }\n    const record = item as Record<string, unknown>;\n    const method = typeof record.method === \"string\" ? record.method : \"\";\n    const normalized: CheckerBatchResponse = { method };\n    if (typeof record.error === \"string\" && record.error.length > 0) {\n      normalized.error = record.error;\n    }\n    if (\"result\" in record) {\n      normalized.result = record.result;\n    }\n    return normalized;\n  });\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,qBACd,QACA,UACwB;CACxB,IAAI,SAAS,WAAW,GACtB,OAAO,CAAC;CAKV,OAAO,+BAHU,OAAO,SAAiC,iBAAiB,EACxE,UAAU,SAAS,IAAI,4BAA4B,EACrD,CAC6C,GAAG,SAAS,MAAM;AACjE;;;;AAKA,eAAsB,0BACpB,QACA,UACiC;CACjC,IAAI,SAAS,WAAW,GACtB,OAAO,CAAC;CAKV,OAAO,+BAA+B,MAHf,OAAO,cAAsC,iBAAiB,EACnF,UAAU,SAAS,IAAI,4BAA4B,EACrD,CAAC,GAC+C,SAAS,MAAM;AACjE;AAEA,SAAS,6BAA6B,SAAmD;CACvF,IAAI,QAAQ,WAAW,KAAA,GACrB,OAAO,EAAE,QAAQ,QAAQ,OAAO;CAElC,OAAO;EAAE,QAAQ,QAAQ;EAAQ,QAAQ,QAAQ;CAAO;AAC1D;AAEA,SAAS,+BACP,UACA,gBACwB;CACxB,IAAI,OAAO,aAAa,YAAY,aAAa,MAC/C,MAAM,IAAI,MAAM,6CAA6C;CAE/D,MAAM,YAAY,SAAS;CAC3B,IAAI,CAAC,MAAM,QAAQ,SAAS,GAC1B,MAAM,IAAI,MAAM,kDAAkD;CAEpE,IAAI,UAAU,WAAW,gBACvB,MAAM,IAAI,MACR,0BAA0B,UAAU,OAAO,iBAAiB,eAAe,UAC7E;CAEF,OAAO,UAAU,KAAK,MAAM,UAAU;EACpC,IAAI,OAAO,SAAS,YAAY,SAAS,MACvC,MAAM,IAAI,MAAM,0BAA0B,MAAM,kBAAkB;EAEpE,MAAM,SAAS;EAEf,MAAM,aAAmC,EAAE,QAD5B,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,GACjB;EAClD,IAAI,OAAO,OAAO,UAAU,YAAY,OAAO,MAAM,SAAS,GAC5D,WAAW,QAAQ,OAAO;EAE5B,IAAI,YAAY,QACd,WAAW,SAAS,OAAO;EAE7B,OAAO;CACT,CAAC;AACH"}

package/dist/index.d.mts

@@ -1,4 +1,6 @@
-import { ApiClientOptions, ApiMode, CapabilitiesResponse, ConfigResponse, DiagnosticsCapabilities, DocumentIdentifier, EditorCapabilities, FileChangeSummary, FileChanges, FileDiagnosticsResponse, InitializeResponse, LspCapabilities, NativeLintDiagnostic, NativeLintFix, NativeLintNode, NativeLintRange, NativeLintRuleMeta, NativeLintSuggestion, NativeNodeMetadataDepth, NativeRuleBridgeRequirements, OverlayCapabilities, OverlayChanges, OverlayUpdate, ProjectDiagnosticsResponse, ProjectResponse, RuntimeCapabilities, SnapshotDiagnosticsResponse, SymbolResponse, TypeResponse, TypeTextKind, UnsafeTypeFlowInput, UpdateSnapshotParams, UpdateSnapshotResponse, VirtualChange, VirtualDocumentState } from "./types.mjs";
+import { ApiClientOptions, ApiMode, CapabilitiesResponse, CheckerBatchRequest, CheckerBatchResponse, ConfigResponse, ContentMapperDefinition, ContentMapping, DiagnosticDirectivePolicy, DiagnosticsCapabilities, DocumentIdentifier, EditorCapabilities, EncodedSourceFile, FileChangeSummary, FileChanges, FileDiagnosticsResponse, InitializeResponse, LspCapabilities, MappedDiagnosticDirective, MappedPosition, MappedRange, NativeLintDiagnostic, NativeLintFix, NativeLintNode, NativeLintRange, NativeLintRuleMeta, NativeLintSuggestion, NativeNodeMetadataDepth, NativeRuleBridgeRequirements, OverlayCapabilities, OverlayChanges, OverlayUpdate, ProjectDiagnosticsResponse, ProjectResponse, RuntimeCapabilities, SnapshotDiagnosticsResponse, SpanMapFidelity, SpanMapKind, SpanMapSegment, SymbolResponse, TextRange, TypeResponse, TypeTextKind, UnsafeTypeFlowInput, UpdateSnapshotParams, UpdateSnapshotResponse, VirtualChange, VirtualDocumentState } from "./types.mjs";
+import { AsyncCheckerBatchCapableClient, CheckerBatchCapableClient, batchCheckerRequests, batchCheckerRequestsAsync } from "./checker_batch.mjs";
+import { CheckerBatchQuery, CheckerBatchResult, CheckerBatchScope, ResolvedCheckerBatchItem } from "./orchestrator_types.mjs";
 //#region index.d.ts
 declare const binding: typeof import("../index.js");
 type CorsaApiClientConstructor = {
@@ -14,6 +16,8 @@ interface CorsaApiClient {
   updateSnapshotAsync(params?: UpdateSnapshotParams): Promise<UpdateSnapshotResponse>;
   getSourceFile(snapshot: string, project: string, file: string): Uint8Array | null;
   getSourceFileAsync(snapshot: string, project: string, file: string): Promise<Uint8Array | null>;
+  getEncodedSourceFile(snapshot: string, project: string, file: string): EncodedSourceFile | null;
+  getEncodedSourceFileAsync(snapshot: string, project: string, file: string): Promise<EncodedSourceFile | null>;
   getStringType(snapshot: string, project: string): TypeResponse;
   getStringTypeAsync(snapshot: string, project: string): Promise<TypeResponse>;
   getTypeAtPosition(snapshot: string, project: string, file: string, position: number): TypeResponse | null;
@@ -59,19 +63,6 @@ interface CorsaApiClient {
   close(): void;
   closeAsync(): Promise<void>;
 }
-type CorsaDistributedOrchestratorConstructor = {
-  new (nodeIds: string[]): CorsaDistributedOrchestrator;
-};
-interface CorsaDistributedOrchestrator {
-  campaign(nodeId: string): number;
-  leaderId(): string | null;
-  state<T>(): T | null;
-  nodeState<T>(nodeId: string): T | null;
-  document(nodeId: string, uri: string): VirtualDocumentState | null;
-  openVirtualDocument(document: VirtualDocumentState): VirtualDocumentState;
-  changeVirtualDocument(uri: string, changes: VirtualChange[]): VirtualDocumentState;
-  closeVirtualDocument(uri: string): void;
-}
 type CorsaVirtualDocumentConstructor = {
   untitled(path: string, languageId: string, text: string): CorsaVirtualDocument;
   inMemory(authority: string, path: string, languageId: string, text: string): CorsaVirtualDocument;
@@ -86,8 +77,74 @@ interface CorsaVirtualDocument {
   applyChanges(changes: VirtualChange[]): unknown[];
 }
 declare const CorsaApiClient: CorsaApiClientConstructor;
-declare const CorsaDistributedOrchestrator: CorsaDistributedOrchestratorConstructor;
 declare const CorsaVirtualDocument: CorsaVirtualDocumentConstructor;
+/**
+ * Bidirectional mapping between a mapper's virtual text and the original file.
+ *
+ * Every query takes an optional `feature` bitmask (see {@link SpanMap}); when it
+ * is omitted, all features are considered.
+ */
+interface CorsaSpanMap {
+  readonly segments: SpanMapSegment[];
+  readonly segmentCount: number;
+  virtualToOriginalPosition(position: number, feature?: number): MappedPosition;
+  virtualToOriginalSpan(pos: number, end: number, feature?: number): MappedRange;
+  originalToVirtualPositions(position: number, feature?: number): MappedPosition[];
+  originalToVirtualSpans(pos: number, end: number, feature?: number): MappedRange[];
+}
+type CorsaSpanMapConstructor = {
+  fromSegments(segments: readonly SpanMapSegment[]): CorsaSpanMap;
+};
+declare const CorsaSpanMap: CorsaSpanMapConstructor;
+/** Decodes the source-file fields of a `getSourceFile` payload. */
+declare const decodeSourceFile: (payload: Uint8Array) => EncodedSourceFile;
+/** Reports whether a `getSourceFile` payload came out of a content mapper. */
+declare const isContentMappedSourceFile: (payload: Uint8Array) => boolean;
+/** Builds the span map of a payload, or `null` when the file is not mapped. */
+declare const spanMapForSourceFile: (payload: Uint8Array) => CorsaSpanMap | null;
+/** Reads the content mappers a parsed `tsconfig` declares. */
+declare const contentMappersFromConfig: (config: unknown) => ContentMapperDefinition[];
+/**
+ * Numeric enums mirrored from upstream `spanMapKind`, `spanMapFidelity`, and
+ * `spanMapFeature`.
+ */
+declare const SpanMap: Readonly<{
+  readonly Kind: Readonly<{
+    Verbatim: 0;
+    Atom: 1;
+    Alias: 2;
+  }>;
+  readonly Fidelity: Readonly<{
+    Exact: 0;
+    Atom: 1;
+    Approximate: 2;
+    None: 3;
+  }>;
+  readonly Feature: Readonly<{
+    Hover: number;
+    SignatureHelp: number;
+    Completion: number;
+    Definition: number;
+    TypeDefinition: number;
+    Implementation: number;
+    References: number;
+    DocumentHighlights: number;
+    Rename: number;
+    CallHierarchy: number;
+    CodeActions: number;
+    Formatting: number;
+    InlayHints: number;
+    SemanticTokens: number;
+    FoldingRanges: number;
+    SelectionRanges: number;
+    LinkedEditing: number;
+    AutoInsert: number;
+    DocumentSymbols: number;
+    CodeLens: number;
+    None: 0;
+    All: number;
+  }>;
+}>;
 declare const version: () => string;
 declare const spawnCorsaApiClientAsync: (options: ApiClientOptions) => Promise<CorsaApiClient>;
 declare const isUnsafeAssignment: (input: UnsafeTypeFlowInput) => boolean;
@@ -106,6 +163,16 @@ declare const isArrayLikeTypeTexts: (typeTexts: readonly string[]) => boolean;
 declare const isStringArrayLikeTypeTexts: (typeTexts: readonly string[]) => boolean;
 declare const isPromiseLikeTypeTexts: (typeTexts: readonly string[], propertyNames?: readonly string[]) => boolean;
 declare const isErrorLikeTypeTexts: (typeTexts: readonly string[], propertyNames?: readonly string[]) => boolean;
+/**
+ * @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root
+ * export remains as a compatibility shim and warns once at runtime.
+ */
+declare function resolveCheckerBatch(client: CheckerBatchCapableClient, scope: CheckerBatchScope, queries: readonly CheckerBatchQuery[]): ResolvedCheckerBatchItem[];
+/**
+ * @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root
+ * export remains as a compatibility shim and warns once at runtime.
+ */
+declare function resolveCheckerBatchAsync(client: AsyncCheckerBatchCapableClient, scope: CheckerBatchScope, queries: readonly CheckerBatchQuery[]): Promise<ResolvedCheckerBatchItem[]>;
 declare const Utils: Readonly<{
   classifyTypeText: (text?: string) => TypeTextKind;
   splitTopLevelTypeText: (text: string, delimiter: string) => string[];
@@ -121,5 +188,5 @@ declare const Utils: Readonly<{
   isErrorLikeTypeTexts: (typeTexts: readonly string[], propertyNames?: readonly string[]) => boolean;
 }>;
 //#endregion
-export { type ApiClientOptions, type ApiMode, type CapabilitiesResponse, type ConfigResponse, CorsaApiClient, CorsaDistributedOrchestrator, CorsaVirtualDocument, type DiagnosticsCapabilities, type DocumentIdentifier, type EditorCapabilities, type FileChangeSummary, type FileChanges, type FileDiagnosticsResponse, type InitializeResponse, type LspCapabilities, type NativeLintDiagnostic, type NativeLintFix, type NativeLintNode, type NativeLintRange, type NativeLintRuleMeta, type NativeLintSuggestion, type NativeNodeMetadataDepth, type NativeRuleBridgeRequirements, type OverlayCapabilities, type OverlayChanges, type OverlayUpdate, type ProjectDiagnosticsResponse, type ProjectResponse, type RuntimeCapabilities, type SnapshotDiagnosticsResponse, type SymbolResponse, type TypeResponse, type TypeTextKind, type UnsafeTypeFlowInput, type UpdateSnapshotParams, type UpdateSnapshotResponse, Utils, type VirtualChange, type VirtualDocumentState, classifyTypeText, binding as default, isAnyLikeTypeTexts, isArrayLikeTypeTexts, isBigIntLikeTypeTexts, isErrorLikeTypeTexts, isNumberLikeTypeTexts, isPromiseLikeTypeTexts, isStringArrayLikeTypeTexts, isStringLikeTypeTexts, isUnknownLikeTypeTexts, isUnsafeAssignment, isUnsafeReturn, nativeLintRuleMetas, runNativeLintRule, spawnCorsaApiClientAsync, splitTopLevelTypeText, splitTypeText, version };
+export { type ApiClientOptions, type ApiMode, type AsyncCheckerBatchCapableClient, type CapabilitiesResponse, type CheckerBatchCapableClient, type CheckerBatchQuery, type CheckerBatchRequest, type CheckerBatchResponse, type CheckerBatchResult, type CheckerBatchScope, type ConfigResponse, type ContentMapperDefinition, type ContentMapping, CorsaApiClient, CorsaSpanMap, CorsaVirtualDocument, type DiagnosticDirectivePolicy, type DiagnosticsCapabilities, type DocumentIdentifier, type EditorCapabilities, type EncodedSourceFile, type FileChangeSummary, type FileChanges, type FileDiagnosticsResponse, type InitializeResponse, type LspCapabilities, type MappedDiagnosticDirective, type MappedPosition, type MappedRange, type NativeLintDiagnostic, type NativeLintFix, type NativeLintNode, type NativeLintRange, type NativeLintRuleMeta, type NativeLintSuggestion, type NativeNodeMetadataDepth, type NativeRuleBridgeRequirements, type OverlayCapabilities, type OverlayChanges, type OverlayUpdate, type ProjectDiagnosticsResponse, type ProjectResponse, type ResolvedCheckerBatchItem, type RuntimeCapabilities, type SnapshotDiagnosticsResponse, SpanMap, type SpanMapFidelity, type SpanMapKind, type SpanMapSegment, type SymbolResponse, type TextRange, type TypeResponse, type TypeTextKind, type UnsafeTypeFlowInput, type UpdateSnapshotParams, type UpdateSnapshotResponse, Utils, type VirtualChange, type VirtualDocumentState, batchCheckerRequests, batchCheckerRequestsAsync, classifyTypeText, contentMappersFromConfig, decodeSourceFile, binding as default, isAnyLikeTypeTexts, isArrayLikeTypeTexts, isBigIntLikeTypeTexts, isContentMappedSourceFile, isErrorLikeTypeTexts, isNumberLikeTypeTexts, isPromiseLikeTypeTexts, isStringArrayLikeTypeTexts, isStringLikeTypeTexts, isUnknownLikeTypeTexts, isUnsafeAssignment, isUnsafeReturn, nativeLintRuleMetas, resolveCheckerBatch, resolveCheckerBatchAsync, runNativeLintRule, spanMapForSourceFile, spawnCorsaApiClientAsync, splitTopLevelTypeText, splitTypeText, version };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,9 +1,60 @@
+import { batchCheckerRequests, batchCheckerRequestsAsync } from "./checker_batch.mjs";
+import { resolveCheckerBatch as resolveCheckerBatch$1, resolveCheckerBatchAsync as resolveCheckerBatchAsync$1 } from "./orchestrator.mjs";
 import * as nativeModule from "../index.js";
 //#region index.ts
 const binding = "default" in nativeModule ? nativeModule.default : nativeModule;
 const CorsaApiClient = binding.CorsaApiClient;
-const CorsaDistributedOrchestrator = binding.CorsaDistributedOrchestrator;
 const CorsaVirtualDocument = binding.CorsaVirtualDocument;
+const CorsaSpanMap = binding.CorsaSpanMap;
+/** Decodes the source-file fields of a `getSourceFile` payload. */
+const decodeSourceFile = binding.decodeSourceFile;
+/** Reports whether a `getSourceFile` payload came out of a content mapper. */
+const isContentMappedSourceFile = binding.isContentMappedSourceFile;
+/** Builds the span map of a payload, or `null` when the file is not mapped. */
+const spanMapForSourceFile = binding.spanMapForSourceFile;
+/** Reads the content mappers a parsed `tsconfig` declares. */
+const contentMappersFromConfig = binding.contentMappersFromConfig;
+/**
+* Numeric enums mirrored from upstream `spanMapKind`, `spanMapFidelity`, and
+* `spanMapFeature`.
+*/
+const SpanMap = Object.freeze({
+	Kind: Object.freeze({
+		Verbatim: 0,
+		Atom: 1,
+		Alias: 2
+	}),
+	Fidelity: Object.freeze({
+		Exact: 0,
+		Atom: 1,
+		Approximate: 2,
+		None: 3
+	}),
+	Feature: Object.freeze({
+		Hover: 1,
+		SignatureHelp: 2,
+		Completion: 4,
+		Definition: 8,
+		TypeDefinition: 16,
+		Implementation: 32,
+		References: 64,
+		DocumentHighlights: 128,
+		Rename: 256,
+		CallHierarchy: 512,
+		CodeActions: 1024,
+		Formatting: 2048,
+		InlayHints: 4096,
+		SemanticTokens: 8192,
+		FoldingRanges: 16384,
+		SelectionRanges: 32768,
+		LinkedEditing: 65536,
+		AutoInsert: 1 << 17,
+		DocumentSymbols: 1 << 18,
+		CodeLens: 1 << 19,
+		None: 0,
+		All: (1 << 20) - 1
+	})
+});
 const version = binding.version;
 const spawnCorsaApiClientAsync = binding.spawnCorsaApiClientAsync;
 const isUnsafeAssignment = binding.isUnsafeAssignment;
@@ -22,6 +73,23 @@ const isArrayLikeTypeTexts = binding.isArrayLikeTypeTexts;
 const isStringArrayLikeTypeTexts = binding.isStringArrayLikeTypeTexts;
 const isPromiseLikeTypeTexts = binding.isPromiseLikeTypeTexts;
 const isErrorLikeTypeTexts = binding.isErrorLikeTypeTexts;
+let rootCheckerBatchResolverWarningShown = false;
+/**
+* @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root
+* export remains as a compatibility shim and warns once at runtime.
+*/
+function resolveCheckerBatch(client, scope, queries) {
+	warnRootCheckerBatchResolver();
+	return resolveCheckerBatch$1(client, scope, queries);
+}
+/**
+* @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root
+* export remains as a compatibility shim and warns once at runtime.
+*/
+async function resolveCheckerBatchAsync(client, scope, queries) {
+	warnRootCheckerBatchResolver();
+	return resolveCheckerBatchAsync$1(client, scope, queries);
+}
 const Utils = Object.freeze({
 	classifyTypeText,
 	splitTopLevelTypeText,
@@ -36,7 +104,12 @@ const Utils = Object.freeze({
 	isPromiseLikeTypeTexts,
 	isErrorLikeTypeTexts
 });
+function warnRootCheckerBatchResolver() {
+	if (rootCheckerBatchResolverWarningShown) return;
+	rootCheckerBatchResolverWarningShown = true;
+	console.warn("@corsa-bind/napi: resolveCheckerBatch is a compatibility shim; import from @corsa-bind/napi/orchestrator for new code.");
+}
 //#endregion
-export { CorsaApiClient, CorsaDistributedOrchestrator, CorsaVirtualDocument, Utils, classifyTypeText, binding as default, isAnyLikeTypeTexts, isArrayLikeTypeTexts, isBigIntLikeTypeTexts, isErrorLikeTypeTexts, isNumberLikeTypeTexts, isPromiseLikeTypeTexts, isStringArrayLikeTypeTexts, isStringLikeTypeTexts, isUnknownLikeTypeTexts, isUnsafeAssignment, isUnsafeReturn, nativeLintRuleMetas, runNativeLintRule, spawnCorsaApiClientAsync, splitTopLevelTypeText, splitTypeText, version };
+export { CorsaApiClient, CorsaSpanMap, CorsaVirtualDocument, SpanMap, Utils, batchCheckerRequests, batchCheckerRequestsAsync, classifyTypeText, contentMappersFromConfig, decodeSourceFile, binding as default, isAnyLikeTypeTexts, isArrayLikeTypeTexts, isBigIntLikeTypeTexts, isContentMappedSourceFile, isErrorLikeTypeTexts, isNumberLikeTypeTexts, isPromiseLikeTypeTexts, isStringArrayLikeTypeTexts, isStringLikeTypeTexts, isUnknownLikeTypeTexts, isUnsafeAssignment, isUnsafeReturn, nativeLintRuleMetas, resolveCheckerBatch, resolveCheckerBatchAsync, runNativeLintRule, spanMapForSourceFile, spawnCorsaApiClientAsync, splitTopLevelTypeText, splitTypeText, version };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../ts/index.ts"],"sourcesContent":["import * as nativeModule from \"../index.js\";\n\nimport type {\n  ApiClientOptions,\n  ConfigResponse,\n  InitializeResponse,\n  NativeLintDiagnostic,\n  NativeLintNode,\n  NativeLintRuleMeta,\n  SymbolResponse,\n  TypeResponse,\n  TypeTextKind,\n  UnsafeTypeFlowInput,\n  UpdateSnapshotParams,\n  UpdateSnapshotResponse,\n  VirtualChange,\n  VirtualDocumentState,\n} from \"./types\";\n\nconst binding = (\n  \"default\" in nativeModule ? nativeModule.default : nativeModule\n) as typeof import(\"../index.js\");\n\ntype CorsaApiClientConstructor = {\n  spawn(options: ApiClientOptions): CorsaApiClient;\n  spawnAsync(options: ApiClientOptions): Promise<CorsaApiClient>;\n};\n\nexport interface CorsaApiClient {\n  initialize(): InitializeResponse;\n  initializeAsync(): Promise<InitializeResponse>;\n  parseConfigFile(file: string): ConfigResponse;\n  parseConfigFileAsync(file: string): Promise<ConfigResponse>;\n  updateSnapshot(params?: UpdateSnapshotParams): UpdateSnapshotResponse;\n  updateSnapshotAsync(params?: UpdateSnapshotParams): Promise<UpdateSnapshotResponse>;\n  getSourceFile(snapshot: string, project: string, file: string): Uint8Array | null;\n  getSourceFileAsync(snapshot: string, project: string, file: string): Promise<Uint8Array | null>;\n  getStringType(snapshot: string, project: string): TypeResponse;\n  getStringTypeAsync(snapshot: string, project: string): Promise<TypeResponse>;\n  getTypeAtPosition(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): TypeResponse | null;\n  getTypeAtPositionAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): Promise<TypeResponse | null>;\n  getTypesAtPositions(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Array<TypeResponse | null>;\n  getTypesAtPositionsAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Promise<Array<TypeResponse | null>>;\n  getTypeAtSourceRange(\n    snapshot: string,\n    project: string,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n    kind?: string,\n  ): TypeResponse | null;\n  getTypeAtSourceRangeAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n    kind?: string,\n  ): Promise<TypeResponse | null>;\n  getSymbolAtPosition(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): SymbolResponse | null;\n  getSymbolAtPositionAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): Promise<SymbolResponse | null>;\n  getSymbolsAtPositions(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Array<SymbolResponse | null>;\n  getSymbolsAtPositionsAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Promise<Array<SymbolResponse | null>>;\n  getAliasedSymbol(snapshot: string, project: string, symbol: string): SymbolResponse | null;\n  getAliasedSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse | null>;\n  getImmediateAliasedSymbol(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): SymbolResponse | null;\n  getImmediateAliasedSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse | null>;\n  getExportsOfModule(snapshot: string, project: string, symbol: string): SymbolResponse[];\n  getExportsOfModuleAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse[]>;\n  getSymbolOfType(snapshot: string, typeHandle: string, project?: string): SymbolResponse | null;\n  getSymbolOfTypeAsync(\n    snapshot: string,\n    typeHandle: string,\n    project?: string,\n  ): Promise<SymbolResponse | null>;\n  getTypeArguments(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags?: number,\n  ): TypeResponse[];\n  getTypeArgumentsAtSourceRange(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags: number | undefined | null,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n  ): TypeResponse[];\n  getTypeArgumentsAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags?: number,\n  ): Promise<TypeResponse[]>;\n  getTypeArgumentsAtSourceRangeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags: number | undefined | null,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n  ): Promise<TypeResponse[]>;\n  getPropertyOfType(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    name: string,\n  ): SymbolResponse | null;\n  getPropertyOfTypeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    name: string,\n  ): Promise<SymbolResponse | null>;\n  isTypeAssignableTo(snapshot: string, project: string, source: string, target: string): boolean;\n  isTypeAssignableToAsync(\n    snapshot: string,\n    project: string,\n    source: string,\n    target: string,\n  ): Promise<boolean>;\n  getConstraintOfType(snapshot: string, project: string, typeHandle: string): TypeResponse | null;\n  getConstraintOfTypeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n  ): Promise<TypeResponse | null>;\n  getTypeOfSymbol(snapshot: string, project: string, symbol: string): TypeResponse | null;\n  getTypeOfSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<TypeResponse | null>;\n  getDeclaredTypeOfSymbol(snapshot: string, project: string, symbol: string): TypeResponse | null;\n  getDeclaredTypeOfSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<TypeResponse | null>;\n  typeToString(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    location?: string,\n    flags?: number,\n  ): string;\n  typeToStringAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    location?: string,\n    flags?: number,\n  ): Promise<string>;\n  callJson<T>(method: string, params?: unknown): T;\n  callJsonAsync<T>(method: string, params?: unknown): Promise<T>;\n  callBinary(method: string, params?: unknown): Uint8Array | null;\n  callBinaryAsync(method: string, params?: unknown): Promise<Uint8Array | null>;\n  releaseHandle(handle: string): void;\n  releaseHandleAsync(handle: string): Promise<void>;\n  close(): void;\n  closeAsync(): Promise<void>;\n}\n\ntype CorsaDistributedOrchestratorConstructor = {\n  new (nodeIds: string[]): CorsaDistributedOrchestrator;\n};\n\nexport interface CorsaDistributedOrchestrator {\n  campaign(nodeId: string): number;\n  leaderId(): string | null;\n  state<T>(): T | null;\n  nodeState<T>(nodeId: string): T | null;\n  document(nodeId: string, uri: string): VirtualDocumentState | null;\n  openVirtualDocument(document: VirtualDocumentState): VirtualDocumentState;\n  changeVirtualDocument(uri: string, changes: VirtualChange[]): VirtualDocumentState;\n  closeVirtualDocument(uri: string): void;\n}\n\ntype CorsaVirtualDocumentConstructor = {\n  untitled(path: string, languageId: string, text: string): CorsaVirtualDocument;\n  inMemory(authority: string, path: string, languageId: string, text: string): CorsaVirtualDocument;\n};\n\nexport interface CorsaVirtualDocument {\n  readonly uri: string;\n  readonly languageId: string;\n  readonly version: number;\n  readonly text: string;\n  state(): VirtualDocumentState;\n  replace(text: string): void;\n  applyChanges(changes: VirtualChange[]): unknown[];\n}\n\nexport const CorsaApiClient = binding.CorsaApiClient as unknown as CorsaApiClientConstructor;\nexport const CorsaDistributedOrchestrator =\n  binding.CorsaDistributedOrchestrator as unknown as CorsaDistributedOrchestratorConstructor;\nexport const CorsaVirtualDocument =\n  binding.CorsaVirtualDocument as unknown as CorsaVirtualDocumentConstructor;\n\nexport const version = binding.version as () => string;\nexport const spawnCorsaApiClientAsync = binding.spawnCorsaApiClientAsync as (\n  options: ApiClientOptions,\n) => Promise<CorsaApiClient>;\nexport const isUnsafeAssignment = binding.isUnsafeAssignment as (\n  input: UnsafeTypeFlowInput,\n) => boolean;\nexport const isUnsafeReturn = binding.isUnsafeReturn as (input: UnsafeTypeFlowInput) => boolean;\nexport const runNativeLintRule = binding.runNativeLintRule as (\n  ruleName: string,\n  node: NativeLintNode,\n) => NativeLintDiagnostic[];\nexport const nativeLintRuleMetas = binding.nativeLintRuleMetas as () => NativeLintRuleMeta[];\nexport const classifyTypeText = binding.classifyTypeText as (text?: string) => TypeTextKind;\nexport const splitTopLevelTypeText = binding.splitTopLevelTypeText as (\n  text: string,\n  delimiter: string,\n) => string[];\nexport const splitTypeText = binding.splitTypeText as (text: string) => string[];\nexport const isStringLikeTypeTexts = binding.isStringLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isNumberLikeTypeTexts = binding.isNumberLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isBigIntLikeTypeTexts = binding.isBigIntLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isAnyLikeTypeTexts = binding.isAnyLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isUnknownLikeTypeTexts = binding.isUnknownLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isArrayLikeTypeTexts = binding.isArrayLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isStringArrayLikeTypeTexts = binding.isStringArrayLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isPromiseLikeTypeTexts = binding.isPromiseLikeTypeTexts as (\n  typeTexts: readonly string[],\n  propertyNames?: readonly string[],\n) => boolean;\nexport const isErrorLikeTypeTexts = binding.isErrorLikeTypeTexts as (\n  typeTexts: readonly string[],\n  propertyNames?: readonly string[],\n) => boolean;\n\nexport const Utils = Object.freeze({\n  classifyTypeText,\n  splitTopLevelTypeText,\n  splitTypeText,\n  isStringLikeTypeTexts,\n  isNumberLikeTypeTexts,\n  isBigIntLikeTypeTexts,\n  isAnyLikeTypeTexts,\n  isUnknownLikeTypeTexts,\n  isArrayLikeTypeTexts,\n  isStringArrayLikeTypeTexts,\n  isPromiseLikeTypeTexts,\n  isErrorLikeTypeTexts,\n});\n\nexport default binding;\nexport type * from \"./types\";\n"],"mappings":";;AAmBA,MAAM,UACJ,aAAa,eAAe,aAAa,UAAU;AA4OrD,MAAa,iBAAiB,QAAQ;AACtC,MAAa,+BACX,QAAQ;AACV,MAAa,uBACX,QAAQ;AAEV,MAAa,UAAU,QAAQ;AAC/B,MAAa,2BAA2B,QAAQ;AAGhD,MAAa,qBAAqB,QAAQ;AAG1C,MAAa,iBAAiB,QAAQ;AACtC,MAAa,oBAAoB,QAAQ;AAIzC,MAAa,sBAAsB,QAAQ;AAC3C,MAAa,mBAAmB,QAAQ;AACxC,MAAa,wBAAwB,QAAQ;AAI7C,MAAa,gBAAgB,QAAQ;AACrC,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,qBAAqB,QAAQ;AAG1C,MAAa,yBAAyB,QAAQ;AAG9C,MAAa,uBAAuB,QAAQ;AAG5C,MAAa,6BAA6B,QAAQ;AAGlD,MAAa,yBAAyB,QAAQ;AAI9C,MAAa,uBAAuB,QAAQ;AAK5C,MAAa,QAAQ,OAAO,OAAO;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC"}
+{"version":3,"file":"index.mjs","names":["resolveCheckerBatchFromOrchestrator","resolveCheckerBatchAsyncFromOrchestrator"],"sources":["../ts/index.ts"],"sourcesContent":["import * as nativeModule from \"../index.js\";\n\nimport {\n  resolveCheckerBatch as resolveCheckerBatchFromOrchestrator,\n  resolveCheckerBatchAsync as resolveCheckerBatchAsyncFromOrchestrator,\n} from \"./orchestrator\";\nimport type { AsyncCheckerBatchCapableClient, CheckerBatchCapableClient } from \"./checker_batch\";\nimport type {\n  CheckerBatchQuery,\n  CheckerBatchScope,\n  ResolvedCheckerBatchItem,\n} from \"./orchestrator_types\";\nimport type {\n  ApiClientOptions,\n  ConfigResponse,\n  ContentMapperDefinition,\n  EncodedSourceFile,\n  InitializeResponse,\n  MappedPosition,\n  MappedRange,\n  SpanMapSegment,\n  NativeLintDiagnostic,\n  NativeLintNode,\n  NativeLintRuleMeta,\n  SymbolResponse,\n  TypeResponse,\n  TypeTextKind,\n  UnsafeTypeFlowInput,\n  UpdateSnapshotParams,\n  UpdateSnapshotResponse,\n  VirtualChange,\n  VirtualDocumentState,\n} from \"./types\";\n\nconst binding = (\n  \"default\" in nativeModule ? nativeModule.default : nativeModule\n) as typeof import(\"../index.js\");\n\ntype CorsaApiClientConstructor = {\n  spawn(options: ApiClientOptions): CorsaApiClient;\n  spawnAsync(options: ApiClientOptions): Promise<CorsaApiClient>;\n};\n\nexport interface CorsaApiClient {\n  initialize(): InitializeResponse;\n  initializeAsync(): Promise<InitializeResponse>;\n  parseConfigFile(file: string): ConfigResponse;\n  parseConfigFileAsync(file: string): Promise<ConfigResponse>;\n  updateSnapshot(params?: UpdateSnapshotParams): UpdateSnapshotResponse;\n  updateSnapshotAsync(params?: UpdateSnapshotParams): Promise<UpdateSnapshotResponse>;\n  getSourceFile(snapshot: string, project: string, file: string): Uint8Array | null;\n  getSourceFileAsync(snapshot: string, project: string, file: string): Promise<Uint8Array | null>;\n  getEncodedSourceFile(snapshot: string, project: string, file: string): EncodedSourceFile | null;\n  getEncodedSourceFileAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n  ): Promise<EncodedSourceFile | null>;\n  getStringType(snapshot: string, project: string): TypeResponse;\n  getStringTypeAsync(snapshot: string, project: string): Promise<TypeResponse>;\n  getTypeAtPosition(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): TypeResponse | null;\n  getTypeAtPositionAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): Promise<TypeResponse | null>;\n  getTypesAtPositions(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Array<TypeResponse | null>;\n  getTypesAtPositionsAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Promise<Array<TypeResponse | null>>;\n  getTypeAtSourceRange(\n    snapshot: string,\n    project: string,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n    kind?: string,\n  ): TypeResponse | null;\n  getTypeAtSourceRangeAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n    kind?: string,\n  ): Promise<TypeResponse | null>;\n  getSymbolAtPosition(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): SymbolResponse | null;\n  getSymbolAtPositionAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    position: number,\n  ): Promise<SymbolResponse | null>;\n  getSymbolsAtPositions(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Array<SymbolResponse | null>;\n  getSymbolsAtPositionsAsync(\n    snapshot: string,\n    project: string,\n    file: string,\n    positions: number[],\n  ): Promise<Array<SymbolResponse | null>>;\n  getAliasedSymbol(snapshot: string, project: string, symbol: string): SymbolResponse | null;\n  getAliasedSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse | null>;\n  getImmediateAliasedSymbol(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): SymbolResponse | null;\n  getImmediateAliasedSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse | null>;\n  getExportsOfModule(snapshot: string, project: string, symbol: string): SymbolResponse[];\n  getExportsOfModuleAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<SymbolResponse[]>;\n  getSymbolOfType(snapshot: string, typeHandle: string, project?: string): SymbolResponse | null;\n  getSymbolOfTypeAsync(\n    snapshot: string,\n    typeHandle: string,\n    project?: string,\n  ): Promise<SymbolResponse | null>;\n  getTypeArguments(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags?: number,\n  ): TypeResponse[];\n  getTypeArgumentsAtSourceRange(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags: number | undefined | null,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n  ): TypeResponse[];\n  getTypeArgumentsAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags?: number,\n  ): Promise<TypeResponse[]>;\n  getTypeArgumentsAtSourceRangeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    objectFlags: number | undefined | null,\n    file: string,\n    start: number,\n    end: number,\n    sourceText: string,\n  ): Promise<TypeResponse[]>;\n  getPropertyOfType(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    name: string,\n  ): SymbolResponse | null;\n  getPropertyOfTypeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    name: string,\n  ): Promise<SymbolResponse | null>;\n  isTypeAssignableTo(snapshot: string, project: string, source: string, target: string): boolean;\n  isTypeAssignableToAsync(\n    snapshot: string,\n    project: string,\n    source: string,\n    target: string,\n  ): Promise<boolean>;\n  getConstraintOfType(snapshot: string, project: string, typeHandle: string): TypeResponse | null;\n  getConstraintOfTypeAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n  ): Promise<TypeResponse | null>;\n  getTypeOfSymbol(snapshot: string, project: string, symbol: string): TypeResponse | null;\n  getTypeOfSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<TypeResponse | null>;\n  getDeclaredTypeOfSymbol(snapshot: string, project: string, symbol: string): TypeResponse | null;\n  getDeclaredTypeOfSymbolAsync(\n    snapshot: string,\n    project: string,\n    symbol: string,\n  ): Promise<TypeResponse | null>;\n  typeToString(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    location?: string,\n    flags?: number,\n  ): string;\n  typeToStringAsync(\n    snapshot: string,\n    project: string,\n    typeHandle: string,\n    location?: string,\n    flags?: number,\n  ): Promise<string>;\n  callJson<T>(method: string, params?: unknown): T;\n  callJsonAsync<T>(method: string, params?: unknown): Promise<T>;\n  callBinary(method: string, params?: unknown): Uint8Array | null;\n  callBinaryAsync(method: string, params?: unknown): Promise<Uint8Array | null>;\n  releaseHandle(handle: string): void;\n  releaseHandleAsync(handle: string): Promise<void>;\n  close(): void;\n  closeAsync(): Promise<void>;\n}\n\ntype CorsaVirtualDocumentConstructor = {\n  untitled(path: string, languageId: string, text: string): CorsaVirtualDocument;\n  inMemory(authority: string, path: string, languageId: string, text: string): CorsaVirtualDocument;\n};\n\nexport interface CorsaVirtualDocument {\n  readonly uri: string;\n  readonly languageId: string;\n  readonly version: number;\n  readonly text: string;\n  state(): VirtualDocumentState;\n  replace(text: string): void;\n  applyChanges(changes: VirtualChange[]): unknown[];\n}\n\nexport const CorsaApiClient = binding.CorsaApiClient as unknown as CorsaApiClientConstructor;\nexport const CorsaVirtualDocument =\n  binding.CorsaVirtualDocument as unknown as CorsaVirtualDocumentConstructor;\n\n/**\n * Bidirectional mapping between a mapper's virtual text and the original file.\n *\n * Every query takes an optional `feature` bitmask (see {@link SpanMap}); when it\n * is omitted, all features are considered.\n */\nexport interface CorsaSpanMap {\n  readonly segments: SpanMapSegment[];\n  readonly segmentCount: number;\n  virtualToOriginalPosition(position: number, feature?: number): MappedPosition;\n  virtualToOriginalSpan(pos: number, end: number, feature?: number): MappedRange;\n  originalToVirtualPositions(position: number, feature?: number): MappedPosition[];\n  originalToVirtualSpans(pos: number, end: number, feature?: number): MappedRange[];\n}\n\ntype CorsaSpanMapConstructor = {\n  fromSegments(segments: readonly SpanMapSegment[]): CorsaSpanMap;\n};\n\nexport const CorsaSpanMap = binding.CorsaSpanMap as unknown as CorsaSpanMapConstructor;\n\n/** Decodes the source-file fields of a `getSourceFile` payload. */\nexport const decodeSourceFile = binding.decodeSourceFile as (\n  payload: Uint8Array,\n) => EncodedSourceFile;\n\n/** Reports whether a `getSourceFile` payload came out of a content mapper. */\nexport const isContentMappedSourceFile = binding.isContentMappedSourceFile as (\n  payload: Uint8Array,\n) => boolean;\n\n/** Builds the span map of a payload, or `null` when the file is not mapped. */\nexport const spanMapForSourceFile = binding.spanMapForSourceFile as (\n  payload: Uint8Array,\n) => CorsaSpanMap | null;\n\n/** Reads the content mappers a parsed `tsconfig` declares. */\nexport const contentMappersFromConfig = binding.contentMappersFromConfig as (\n  config: unknown,\n) => ContentMapperDefinition[];\n\n/**\n * Numeric enums mirrored from upstream `spanMapKind`, `spanMapFidelity`, and\n * `spanMapFeature`.\n */\nexport const SpanMap = Object.freeze({\n  Kind: Object.freeze({ Verbatim: 0, Atom: 1, Alias: 2 }),\n  Fidelity: Object.freeze({ Exact: 0, Atom: 1, Approximate: 2, None: 3 }),\n  Feature: Object.freeze({\n    Hover: 1 << 0,\n    SignatureHelp: 1 << 1,\n    Completion: 1 << 2,\n    Definition: 1 << 3,\n    TypeDefinition: 1 << 4,\n    Implementation: 1 << 5,\n    References: 1 << 6,\n    DocumentHighlights: 1 << 7,\n    Rename: 1 << 8,\n    CallHierarchy: 1 << 9,\n    CodeActions: 1 << 10,\n    Formatting: 1 << 11,\n    InlayHints: 1 << 12,\n    SemanticTokens: 1 << 13,\n    FoldingRanges: 1 << 14,\n    SelectionRanges: 1 << 15,\n    LinkedEditing: 1 << 16,\n    AutoInsert: 1 << 17,\n    DocumentSymbols: 1 << 18,\n    CodeLens: 1 << 19,\n    None: 0,\n    All: (1 << 20) - 1,\n  }),\n} as const);\n\nexport const version = binding.version as () => string;\nexport const spawnCorsaApiClientAsync = binding.spawnCorsaApiClientAsync as (\n  options: ApiClientOptions,\n) => Promise<CorsaApiClient>;\nexport const isUnsafeAssignment = binding.isUnsafeAssignment as (\n  input: UnsafeTypeFlowInput,\n) => boolean;\nexport const isUnsafeReturn = binding.isUnsafeReturn as (input: UnsafeTypeFlowInput) => boolean;\nexport const runNativeLintRule = binding.runNativeLintRule as (\n  ruleName: string,\n  node: NativeLintNode,\n) => NativeLintDiagnostic[];\nexport const nativeLintRuleMetas = binding.nativeLintRuleMetas as () => NativeLintRuleMeta[];\nexport const classifyTypeText = binding.classifyTypeText as (text?: string) => TypeTextKind;\nexport const splitTopLevelTypeText = binding.splitTopLevelTypeText as (\n  text: string,\n  delimiter: string,\n) => string[];\nexport const splitTypeText = binding.splitTypeText as (text: string) => string[];\nexport const isStringLikeTypeTexts = binding.isStringLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isNumberLikeTypeTexts = binding.isNumberLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isBigIntLikeTypeTexts = binding.isBigIntLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isAnyLikeTypeTexts = binding.isAnyLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isUnknownLikeTypeTexts = binding.isUnknownLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isArrayLikeTypeTexts = binding.isArrayLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isStringArrayLikeTypeTexts = binding.isStringArrayLikeTypeTexts as (\n  typeTexts: readonly string[],\n) => boolean;\nexport const isPromiseLikeTypeTexts = binding.isPromiseLikeTypeTexts as (\n  typeTexts: readonly string[],\n  propertyNames?: readonly string[],\n) => boolean;\nexport const isErrorLikeTypeTexts = binding.isErrorLikeTypeTexts as (\n  typeTexts: readonly string[],\n  propertyNames?: readonly string[],\n) => boolean;\n\nlet rootCheckerBatchResolverWarningShown = false;\n\n/**\n * @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root\n * export remains as a compatibility shim and warns once at runtime.\n */\nexport function resolveCheckerBatch(\n  client: CheckerBatchCapableClient,\n  scope: CheckerBatchScope,\n  queries: readonly CheckerBatchQuery[],\n): ResolvedCheckerBatchItem[] {\n  warnRootCheckerBatchResolver();\n  return resolveCheckerBatchFromOrchestrator(client, scope, queries);\n}\n\n/**\n * @deprecated Import from `@corsa-bind/napi/orchestrator` instead. The root\n * export remains as a compatibility shim and warns once at runtime.\n */\nexport async function resolveCheckerBatchAsync(\n  client: AsyncCheckerBatchCapableClient,\n  scope: CheckerBatchScope,\n  queries: readonly CheckerBatchQuery[],\n): Promise<ResolvedCheckerBatchItem[]> {\n  warnRootCheckerBatchResolver();\n  return resolveCheckerBatchAsyncFromOrchestrator(client, scope, queries);\n}\n\nexport const Utils = Object.freeze({\n  classifyTypeText,\n  splitTopLevelTypeText,\n  splitTypeText,\n  isStringLikeTypeTexts,\n  isNumberLikeTypeTexts,\n  isBigIntLikeTypeTexts,\n  isAnyLikeTypeTexts,\n  isUnknownLikeTypeTexts,\n  isArrayLikeTypeTexts,\n  isStringArrayLikeTypeTexts,\n  isPromiseLikeTypeTexts,\n  isErrorLikeTypeTexts,\n});\n\nexport default binding;\nexport { batchCheckerRequests, batchCheckerRequestsAsync } from \"./checker_batch\";\nexport type { AsyncCheckerBatchCapableClient, CheckerBatchCapableClient } from \"./checker_batch\";\nexport type {\n  CheckerBatchQuery,\n  CheckerBatchResult,\n  CheckerBatchScope,\n  ResolvedCheckerBatchItem,\n} from \"./orchestrator_types\";\nexport type * from \"./types\";\n\nfunction warnRootCheckerBatchResolver(): void {\n  if (rootCheckerBatchResolverWarningShown) {\n    return;\n  }\n  rootCheckerBatchResolverWarningShown = true;\n  console.warn(\n    \"@corsa-bind/napi: resolveCheckerBatch is a compatibility shim; import from @corsa-bind/napi/orchestrator for new code.\",\n  );\n}\n"],"mappings":";;;;AAkCA,MAAM,UACJ,aAAa,eAAe,aAAa,UAAU;AAmOrD,MAAa,iBAAiB,QAAQ;AACtC,MAAa,uBACX,QAAQ;AAqBV,MAAa,eAAe,QAAQ;;AAGpC,MAAa,mBAAmB,QAAQ;;AAKxC,MAAa,4BAA4B,QAAQ;;AAKjD,MAAa,uBAAuB,QAAQ;;AAK5C,MAAa,2BAA2B,QAAQ;;;;;AAQhD,MAAa,UAAU,OAAO,OAAO;CACnC,MAAM,OAAO,OAAO;EAAE,UAAU;EAAG,MAAM;EAAG,OAAO;CAAE,CAAC;CACtD,UAAU,OAAO,OAAO;EAAE,OAAO;EAAG,MAAM;EAAG,aAAa;EAAG,MAAM;CAAE,CAAC;CACtE,SAAS,OAAO,OAAO;EACrB,OAAO;EACP,eAAe;EACf,YAAY;EACZ,YAAY;EACZ,gBAAgB;EAChB,gBAAgB;EAChB,YAAY;EACZ,oBAAoB;EACpB,QAAQ;EACR,eAAe;EACf,aAAa;EACb,YAAY;EACZ,YAAY;EACZ,gBAAgB;EAChB,eAAe;EACf,iBAAiB;EACjB,eAAe;EACf,YAAY,KAAK;EACjB,iBAAiB,KAAK;EACtB,UAAU,KAAK;EACf,MAAM;EACN,MAAM,KAAK,MAAM;CACnB,CAAC;AACH,CAAU;AAEV,MAAa,UAAU,QAAQ;AAC/B,MAAa,2BAA2B,QAAQ;AAGhD,MAAa,qBAAqB,QAAQ;AAG1C,MAAa,iBAAiB,QAAQ;AACtC,MAAa,oBAAoB,QAAQ;AAIzC,MAAa,sBAAsB,QAAQ;AAC3C,MAAa,mBAAmB,QAAQ;AACxC,MAAa,wBAAwB,QAAQ;AAI7C,MAAa,gBAAgB,QAAQ;AACrC,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,wBAAwB,QAAQ;AAG7C,MAAa,qBAAqB,QAAQ;AAG1C,MAAa,yBAAyB,QAAQ;AAG9C,MAAa,uBAAuB,QAAQ;AAG5C,MAAa,6BAA6B,QAAQ;AAGlD,MAAa,yBAAyB,QAAQ;AAI9C,MAAa,uBAAuB,QAAQ;AAK5C,IAAI,uCAAuC;;;;;AAM3C,SAAgB,oBACd,QACA,OACA,SAC4B;CAC5B,6BAA6B;CAC7B,OAAOA,sBAAoC,QAAQ,OAAO,OAAO;AACnE;;;;;AAMA,eAAsB,yBACpB,QACA,OACA,SACqC;CACrC,6BAA6B;CAC7B,OAAOC,2BAAyC,QAAQ,OAAO,OAAO;AACxE;AAEA,MAAa,QAAQ,OAAO,OAAO;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAaD,SAAS,+BAAqC;CAC5C,IAAI,sCACF;CAEF,uCAAuC;CACvC,QAAQ,KACN,wHACF;AACF"}

package/dist/orchestrator.d.mts

@@ -0,0 +1,18 @@
+import { AsyncCheckerBatchCapableClient, CheckerBatchCapableClient } from "./checker_batch.mjs";
+import { CheckerBatchQuery, CheckerBatchResult, CheckerBatchScope, ResolvedCheckerBatchItem } from "./orchestrator_types.mjs";
+//#region orchestrator.d.ts
+/**
+ * Resolves common project-scoped checker lookups as one coalesced batch.
+ *
+ * Position queries are grouped per source file and symbol-type queries use
+ * `getTypesOfSymbols`, so callers can express per-node facts without writing
+ * their own N+1 loop.
+ */
+declare function resolveCheckerBatch(client: CheckerBatchCapableClient, scope: CheckerBatchScope, queries: readonly CheckerBatchQuery[]): ResolvedCheckerBatchItem[];
+/**
+ * Async counterpart of {@link resolveCheckerBatch}.
+ */
+declare function resolveCheckerBatchAsync(client: AsyncCheckerBatchCapableClient, scope: CheckerBatchScope, queries: readonly CheckerBatchQuery[]): Promise<ResolvedCheckerBatchItem[]>;
+//#endregion
+export { type CheckerBatchQuery, type CheckerBatchResult, type CheckerBatchScope, type ResolvedCheckerBatchItem, resolveCheckerBatch, resolveCheckerBatchAsync };
+//# sourceMappingURL=orchestrator.d.mts.map