@scriptc/compiler 0.1.7 → 0.2.0

package/dist/frontend/ts7/rpc-process.test.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { expect, test } from "vitest";
+const execFileAsync = promisify(execFile);
+test.skipIf(process.platform === "win32")("closing the owned server is quiet even when its cancellation handler writes stderr", async () => {
+    // A ready message ensures the signal handler is installed before close.
+    // Keep stdin idle, matching an API server waiting for its next request.
+    const server = `
+    process.on('SIGTERM', () => {
+      process.stderr.write('context canceled\\n');
+      process.exit(0);
+    });
+    process.stdout.write(Buffer.from([0x93, 4, 0xc4, 0, 0xc4, 0]));
+    setInterval(() => {}, 1000);
+  `;
+    const moduleUrl = new URL("./rpc-process.ts", import.meta.url).href;
+    const host = `
+    import { spawnTs7Wire } from ${JSON.stringify(moduleUrl)};
+    const wire = spawnTs7Wire(process.execPath, ['--eval', ${JSON.stringify(server)}]);
+    const ready = wire.read();
+    if (ready.kind !== 4) throw new Error('server was not ready');
+    wire.close();
+    wire.close();
+  `;
+    const result = await execFileAsync(process.execPath, ["--import", "tsx", "--input-type=module", "--eval", host], { timeout: 10_000 });
+    expect(result.stdout).toBe("");
+    expect(result.stderr).toBe("");
+});
+//# sourceMappingURL=rpc-process.test.js.map

package/dist/frontend/ts7/rpc-process.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-process.test.js","sourceRoot":"","sources":["../../../src/frontend/ts7/rpc-process.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;IACzI,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,MAAM,GAAG;;;;;;;GAOd,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,IAAI,GAAG;mCACoB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;6DACC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;;GAKhF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/frontend/ts7/rpc-wire.d.ts

@@ -0,0 +1,46 @@
+/** The pinned TypeScript 7 synchronous API uses MessagePack triples:
+ * [message kind, binary method name, binary payload]. Keep framing separate
+ * from process creation so the same client runs in Node and native scriptc. */
+export declare const TS7_REQUEST = 1;
+export declare const TS7_CALLBACK_RESPONSE = 2;
+export declare const TS7_CALLBACK_ERROR = 3;
+export declare const TS7_RESPONSE = 4;
+export declare const TS7_ERROR = 5;
+export declare const TS7_CALLBACK = 6;
+export interface Ts7WireMessage {
+    kind: number;
+    method: string;
+    payload: Uint8Array;
+}
+/** Transfers may be short. A zero-byte read denotes EOF, and a zero-byte
+ * write is an error: neither is allowed to spin the synchronous client. */
+export interface Ts7WireIo {
+    read: (buffer: Uint8Array, offset: number, length: number) => number;
+    write: (buffer: Uint8Array, offset: number, length: number) => number;
+    close: () => void;
+}
+export declare class Ts7ProtocolError extends Error {
+    constructor(message: string);
+}
+/** Own one channel's read-ahead bytes and closed state. An invalid frame
+ * poisons the stream: continuing after a malformed length or partial write
+ * would let one request consume another request's response. */
+export declare class Ts7Wire {
+    private readonly io;
+    readonly maxPayloadBytes: number;
+    readonly maxMethodBytes: number;
+    private readonly input;
+    private inputOffset;
+    private inputLength;
+    private closed;
+    constructor(io: Ts7WireIo, maxPayloadBytes?: number, maxMethodBytes?: number);
+    close(): void;
+    private ensureOpen;
+    private fail;
+    private readByte;
+    private readLength;
+    private readBytes;
+    private writeBytes;
+    read(): Ts7WireMessage;
+    write(kind: number, method: string, payload: Uint8Array): void;
+}

package/dist/frontend/ts7/rpc-wire.js

@@ -0,0 +1,195 @@
+/** The pinned TypeScript 7 synchronous API uses MessagePack triples:
+ * [message kind, binary method name, binary payload]. Keep framing separate
+ * from process creation so the same client runs in Node and native scriptc. */
+export const TS7_REQUEST = 1;
+export const TS7_CALLBACK_RESPONSE = 2;
+export const TS7_CALLBACK_ERROR = 3;
+export const TS7_RESPONSE = 4;
+export const TS7_ERROR = 5;
+export const TS7_CALLBACK = 6;
+export class Ts7ProtocolError extends Error {
+    constructor(message) {
+        super(`TypeScript API protocol: ${message}`);
+        this.name = "Ts7ProtocolError";
+    }
+}
+function binHeaderSize(length) {
+    return length < 256 ? 2 : length < 65536 ? 3 : 5;
+}
+function writeBinHeader(buffer, offset, length) {
+    if (length < 256) {
+        buffer[offset++] = 0xc4;
+        buffer[offset++] = length;
+    }
+    else if (length < 65536) {
+        buffer[offset++] = 0xc5;
+        buffer[offset++] = length >>> 8;
+        buffer[offset++] = length;
+    }
+    else {
+        buffer[offset++] = 0xc6;
+        buffer[offset++] = length >>> 24;
+        buffer[offset++] = length >>> 16;
+        buffer[offset++] = length >>> 8;
+        buffer[offset++] = length;
+    }
+    return offset;
+}
+/** Own one channel's read-ahead bytes and closed state. An invalid frame
+ * poisons the stream: continuing after a malformed length or partial write
+ * would let one request consume another request's response. */
+export class Ts7Wire {
+    io;
+    maxPayloadBytes;
+    maxMethodBytes;
+    input = new Uint8Array(65536);
+    inputOffset = 0;
+    inputLength = 0;
+    closed = false;
+    constructor(io, maxPayloadBytes = 512 * 1024 * 1024, maxMethodBytes = 65536) {
+        this.io = io;
+        this.maxPayloadBytes = maxPayloadBytes;
+        this.maxMethodBytes = maxMethodBytes;
+        if (!Number.isSafeInteger(maxPayloadBytes) || maxPayloadBytes < 0 || maxPayloadBytes > 0xffffffff ||
+            !Number.isSafeInteger(maxMethodBytes) || maxMethodBytes < 0 || maxMethodBytes > 0xffffffff) {
+            throw new RangeError("TypeScript API frame limits must be unsigned 32-bit lengths");
+        }
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.inputOffset = 0;
+        this.inputLength = 0;
+        this.io.close();
+    }
+    ensureOpen() {
+        if (this.closed)
+            throw new Ts7ProtocolError("channel is closed");
+    }
+    fail(message) {
+        // Preserve the protocol failure if cleanup also fails.
+        try {
+            this.close();
+        }
+        catch { /* cleanup cannot repair framing */ }
+        throw new Ts7ProtocolError(message);
+    }
+    readByte() {
+        if (this.inputOffset === this.inputLength) {
+            const count = this.io.read(this.input, 0, this.input.length);
+            if (!Number.isSafeInteger(count) || count < 0 || count > this.input.length) {
+                this.fail("invalid read count");
+            }
+            if (count === 0)
+                this.fail("unexpected end of stream");
+            this.inputOffset = 0;
+            this.inputLength = count;
+        }
+        return this.input[this.inputOffset++];
+    }
+    readLength(limit, label) {
+        const marker = this.readByte();
+        let length = 0;
+        if (marker === 0xc4) {
+            length = this.readByte();
+        }
+        else if (marker === 0xc5) {
+            length = this.readByte() * 256 + this.readByte();
+        }
+        else if (marker === 0xc6) {
+            // Arithmetic keeps the unsigned upper half positive.
+            length = this.readByte() * 16777216 + this.readByte() * 65536 + this.readByte() * 256 + this.readByte();
+        }
+        else {
+            this.fail(`expected binary ${label}, got marker ${marker}`);
+        }
+        if (length > limit)
+            this.fail(`${label} exceeds ${limit} bytes`);
+        return length;
+    }
+    readBytes(length) {
+        const result = new Uint8Array(length);
+        let offset = 0;
+        while (offset < length) {
+            const buffered = this.inputLength - this.inputOffset;
+            if (buffered > 0) {
+                const take = Math.min(buffered, length - offset);
+                result.set(this.input.subarray(this.inputOffset, this.inputOffset + take), offset);
+                this.inputOffset += take;
+                offset += take;
+            }
+            else if (length - offset >= this.input.length) {
+                const count = this.io.read(result, offset, length - offset);
+                if (!Number.isSafeInteger(count) || count < 0 || count > length - offset)
+                    this.fail("invalid read count");
+                if (count === 0)
+                    this.fail("unexpected end of stream");
+                offset += count;
+            }
+            else {
+                result[offset++] = this.readByte();
+            }
+        }
+        return result;
+    }
+    writeBytes(bytes) {
+        let offset = 0;
+        while (offset < bytes.length) {
+            const count = this.io.write(bytes, offset, bytes.length - offset);
+            if (!Number.isSafeInteger(count) || count <= 0 || count > bytes.length - offset)
+                this.fail("invalid write count");
+            offset += count;
+        }
+    }
+    read() {
+        this.ensureOpen();
+        try {
+            const marker = this.readByte();
+            if (marker !== 0x93)
+                this.fail(`expected three-element tuple, got marker ${marker}`);
+            let kind = this.readByte();
+            if (kind === 0xcc)
+                kind = this.readByte();
+            if (kind < TS7_REQUEST || kind > TS7_CALLBACK)
+                this.fail(`invalid message kind ${kind}`);
+            const name = this.readBytes(this.readLength(this.maxMethodBytes, "method"));
+            const payload = this.readBytes(this.readLength(this.maxPayloadBytes, "payload"));
+            return { kind, method: Buffer.from(name).toString("utf8"), payload };
+        }
+        catch (error) {
+            try {
+                this.close();
+            }
+            catch { /* preserve the original read failure */ }
+            throw error;
+        }
+    }
+    write(kind, method, payload) {
+        this.ensureOpen();
+        if (!Number.isInteger(kind) || kind < TS7_REQUEST || kind > TS7_CALLBACK)
+            throw new Ts7ProtocolError(`invalid message kind ${kind}`);
+        const name = Buffer.from(method, "utf8");
+        if (name.length > this.maxMethodBytes || payload.length > this.maxPayloadBytes)
+            throw new Ts7ProtocolError("outgoing frame exceeds channel limits");
+        const header = new Uint8Array(2 + binHeaderSize(name.length) + name.length + binHeaderSize(payload.length));
+        header[0] = 0x93;
+        header[1] = kind;
+        let offset = writeBinHeader(header, 2, name.length);
+        header.set(name, offset);
+        offset += name.length;
+        writeBinHeader(header, offset, payload.length);
+        try {
+            this.writeBytes(header);
+            this.writeBytes(payload);
+        }
+        catch (error) {
+            try {
+                this.close();
+            }
+            catch { /* preserve the original write failure */ }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=rpc-wire.js.map

package/dist/frontend/ts7/rpc-wire.js.map

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

package/dist/frontend/ts7/rpc-wire.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/frontend/ts7/rpc-wire.test.js

@@ -0,0 +1,168 @@
+import { describe, expect, test } from "vitest";
+import { Ts7ProtocolError, Ts7Wire } from "./rpc-wire.js";
+function memory(bytes = new Uint8Array(), readSize = Infinity, writeSize = Infinity) {
+    let position = 0;
+    let closes = 0;
+    const output = [];
+    const io = {
+        read(buffer, offset, length) {
+            const size = Math.min(length, readSize, bytes.length - position);
+            buffer.set(bytes.subarray(position, position + size), offset);
+            position += size;
+            return size;
+        },
+        write(buffer, offset, length) {
+            const size = Math.min(length, writeSize);
+            output.push(...buffer.subarray(offset, offset + size));
+            return size;
+        },
+        close() { closes++; },
+    };
+    return { io, output, closes: () => closes };
+}
+// These are protocol bytes, independent of the production encoder.
+const echo = Uint8Array.from([0x93, 4, 0xc4, 4, 101, 99, 104, 111, 0xc4, 3, 0, 128, 255]);
+describe("TypeScript MessagePack wire framing", () => {
+    test.each([1, 2, 3, 7, 65536])("decodes fragmented reads of %i bytes", (readSize) => {
+        const io = memory(echo, readSize);
+        const wire = new Ts7Wire(io.io);
+        expect(wire.read()).toEqual({ kind: 4, method: "echo", payload: Uint8Array.from([0, 128, 255]) });
+        expect(io.closes()).toBe(0);
+    });
+    test.each([1, 2, 7, 65536])("completes short writes of %i bytes", (writeSize) => {
+        const io = memory(undefined, Infinity, writeSize);
+        new Ts7Wire(io.io).write(4, "echo", Uint8Array.from([0, 128, 255]));
+        expect(Uint8Array.from(io.output)).toEqual(echo);
+    });
+    test("retains read-ahead bytes for the next message", () => {
+        const both = new Uint8Array(echo.length * 2);
+        both.set(echo);
+        both.set(echo, echo.length);
+        const io = memory(both);
+        const wire = new Ts7Wire(io.io);
+        expect(wire.read().method).toBe("echo");
+        expect(wire.read().payload).toEqual(Uint8Array.from([0, 128, 255]));
+        expect(() => wire.read()).toThrow("unexpected end of stream");
+        expect(io.closes()).toBe(1);
+    });
+    test("accepts uint8 message kind encoding and an empty method/payload", () => {
+        const io = memory(Uint8Array.from([0x93, 0xcc, 6, 0xc4, 0, 0xc4, 0]));
+        expect(new Ts7Wire(io.io).read()).toEqual({ kind: 6, method: "", payload: new Uint8Array() });
+    });
+    test.each([
+        [0, [0xc4, 0]], [255, [0xc4, 255]], [256, [0xc5, 1, 0]],
+        [65535, [0xc5, 255, 255]], [65536, [0xc6, 0, 1, 0, 0]],
+        [140000, [0xc6, 0, 2, 34, 224]],
+    ])("encodes and decodes bin length %i", (length, header) => {
+        const bytes = new Uint8Array(length);
+        for (let i = 0; i < length; i++)
+            bytes[i] = i % 256;
+        const written = memory(undefined, Infinity, 4096);
+        new Ts7Wire(written.io).write(1, "x", bytes);
+        expect(written.output.slice(0, 5 + header.length)).toEqual([0x93, 1, 0xc4, 1, 120, ...header]);
+        expect(written.output.slice(5 + header.length)).toEqual(Array.from(bytes));
+        const reader = memory(Uint8Array.from(written.output), 32769);
+        expect(new Ts7Wire(reader.io).read()).toEqual({ kind: 1, method: "x", payload: bytes });
+    });
+    test("method lengths count UTF8 bytes and use bin16/bin32", () => {
+        for (const name of ["é".repeat(128), "x".repeat(65536), "\uFEFF方法🌍"]) {
+            const written = memory(undefined, Infinity, 4096);
+            new Ts7Wire(written.io).write(6, name, new Uint8Array());
+            const encoded = Buffer.from(name);
+            const headerSize = encoded.length < 256 ? 2 : encoded.length < 65536 ? 3 : 5;
+            expect(written.output[2]).toBe(headerSize === 2 ? 0xc4 : headerSize === 3 ? 0xc5 : 0xc6);
+            expect(written.output.slice(2 + headerSize, 2 + headerSize + encoded.length)).toEqual(Array.from(encoded));
+            expect(new Ts7Wire(memory(Uint8Array.from(written.output), 257).io).read().method).toBe(name);
+        }
+    });
+    test.each([
+        [[0x92], "three-element tuple"],
+        [[0x93, 0], "message kind"],
+        [[0x93, 7], "message kind"],
+        [[0x93, 0xff], "message kind"],
+        [[0x93, 0xcd], "message kind"],
+        [[0x93, 4, 0xa0], "binary method"],
+        [[0x93, 4, 0xc4, 0, 0xc0], "binary payload"],
+    ])("rejects malformed frame %j", (bytes, message) => {
+        const io = memory(Uint8Array.from(bytes));
+        const wire = new Ts7Wire(io.io);
+        expect(() => wire.read()).toThrow(message);
+        expect(() => wire.read()).toThrow("closed");
+        wire.close();
+        expect(io.closes()).toBe(1);
+    });
+    test("rejects every truncated prefix of a frame and closes once", () => {
+        for (let end = 0; end < echo.length; end++) {
+            const io = memory(echo.subarray(0, end), 1);
+            const wire = new Ts7Wire(io.io);
+            expect(() => wire.read(), `prefix ${end}`).toThrow("end of stream");
+            wire.close();
+            expect(io.closes()).toBe(1);
+        }
+    });
+    test("checks incoming limits before allocating, including unsigned bin32", () => {
+        for (const prefix of [
+            [0x93, 4, 0xc6, 0x80, 0, 0, 0],
+            [0x93, 4, 0xc4, 0, 0xc6, 0xff, 0xff, 0xff, 0xff],
+            [0x93, 4, 0xc4, 0, 0xc4, 5],
+        ]) {
+            const io = memory(Uint8Array.from(prefix));
+            expect(() => new Ts7Wire(io.io, 4, 4).read()).toThrow("exceeds");
+            expect(io.closes()).toBe(1);
+        }
+    });
+    test("outgoing validation does not write or poison the wire", () => {
+        const io = memory();
+        const wire = new Ts7Wire(io.io, 3, 4);
+        expect(() => wire.write(4, "large", new Uint8Array())).toThrow("limits");
+        expect(() => wire.write(4, "echo", new Uint8Array(4))).toThrow("limits");
+        for (const kind of [0, 7, -1, 1.5, NaN, Infinity]) {
+            expect(() => wire.write(kind, "", new Uint8Array())).toThrow("message kind");
+        }
+        expect(io.output).toEqual([]);
+        expect(io.closes()).toBe(0);
+        wire.write(4, "echo", Uint8Array.from([0, 128, 255]));
+        expect(io.output).toEqual(Array.from(echo));
+    });
+    test.each([-1, 1.5, NaN, Infinity, 0x100000000])("rejects invalid frame limit %s", (limit) => {
+        expect(() => new Ts7Wire(memory().io, limit)).toThrow(RangeError);
+        expect(() => new Ts7Wire(memory().io, 1, limit)).toThrow(RangeError);
+    });
+    test.each([-1, 0.5, NaN, Infinity, 65537])("rejects invalid read count %s", (count) => {
+        const io = memory();
+        io.io.read = () => count;
+        expect(() => new Ts7Wire(io.io).read()).toThrow("invalid read count");
+        expect(io.closes()).toBe(1);
+    });
+    test.each([-1, 0, 0.5, NaN, Infinity, 1000])("rejects invalid write count %s", (count) => {
+        const io = memory();
+        io.io.write = () => count;
+        expect(() => new Ts7Wire(io.io).write(1, "echo", new Uint8Array())).toThrow("invalid write count");
+        expect(io.closes()).toBe(1);
+    });
+    test("a failed cleanup does not replace the framing or I/O error", () => {
+        const failure = new Error("read failed");
+        const io = memory();
+        io.io.read = () => { throw failure; };
+        io.io.close = () => { throw new Error("cleanup failed"); };
+        const wire = new Ts7Wire(io.io);
+        expect(() => wire.read()).toThrow(failure);
+        expect(() => wire.read()).toThrow(Ts7ProtocolError);
+        expect(() => wire.close()).not.toThrow();
+    });
+    test("a partial write failure makes further writes impossible", () => {
+        const io = memory();
+        let writes = 0;
+        io.io.write = () => {
+            if (++writes === 1)
+                return 1;
+            throw new Error("pipe gone");
+        };
+        const wire = new Ts7Wire(io.io);
+        expect(() => wire.write(1, "echo", new Uint8Array())).toThrow("pipe gone");
+        expect(() => wire.write(1, "echo", new Uint8Array())).toThrow("closed");
+        expect(writes).toBe(2);
+        expect(io.closes()).toBe(1);
+    });
+});
+//# sourceMappingURL=rpc-wire.test.js.map

package/dist/frontend/ts7/rpc-wire.test.js.map

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

package/dist/frontend/ts7/semantic-checker.d.ts

@@ -0,0 +1,137 @@
+import { AstNode } from "./ast-node.js";
+import { SemanticNodeHandle, SemanticProject, SemanticSignature, SemanticSymbol, SemanticType, type SemanticDocument } from "./semantic-model.js";
+export interface SemanticIndexInfo {
+    keyType: SemanticType;
+    valueType: SemanticType;
+    isReadonly: boolean;
+    declaration: SemanticNodeHandle | undefined;
+}
+export interface SemanticTypePredicate {
+    kind: number;
+    parameterIndex: number;
+    parameterName: string | undefined;
+    type: SemanticType | undefined;
+}
+export interface SemanticReferencedSymbol {
+    definition: SemanticNodeHandle;
+    symbol: SemanticSymbol | undefined;
+    references: SemanticNodeHandle[];
+}
+export interface SemanticSignatureUsage {
+    name: SemanticNodeHandle;
+    call: SemanticNodeHandle | undefined;
+}
+export interface SemanticJsDocTag {
+    name: string;
+    text?: string;
+}
+export interface SemanticCompletionOptions {
+    triggerCharacter?: string;
+    includeSymbol?: boolean;
+}
+export interface SemanticCompletion {
+    name: string;
+    kind: number | undefined;
+    sortText: string | undefined;
+    insertText: string | undefined;
+    filterText: string | undefined;
+    detail: string | undefined;
+    labelDetails: {
+        detail?: string;
+        description?: string;
+    } | undefined;
+    symbol: SemanticSymbol | undefined;
+}
+/** The pinned checker's request surface over native objects. Every query
+ * converges on the same snapshot/project registries, including batch and
+ * lazy-object queries. No SDK object is constructed or consulted here. */
+export declare class SemanticChecker {
+    readonly project: SemanticProject;
+    private wellKnown;
+    constructor(project: SemanticProject);
+    private type;
+    private symbol;
+    private signature;
+    private types;
+    private symbols;
+    private optionalTypes;
+    private optionalSymbols;
+    getTypeAtLocation(node: AstNode): SemanticType | undefined;
+    getTypeAtLocation(nodes: readonly AstNode[]): (SemanticType | undefined)[];
+    getSymbolAtLocation(node: AstNode): SemanticSymbol | undefined;
+    getSymbolAtLocation(nodes: readonly AstNode[]): (SemanticSymbol | undefined)[];
+    getTypeAtPosition(file: SemanticDocument, position: number): SemanticType | undefined;
+    getTypeAtPosition(file: SemanticDocument, positions: readonly number[]): (SemanticType | undefined)[];
+    getSymbolAtPosition(file: SemanticDocument, position: number): SemanticSymbol | undefined;
+    getSymbolAtPosition(file: SemanticDocument, positions: readonly number[]): (SemanticSymbol | undefined)[];
+    getTypeOfSymbol(symbol: SemanticSymbol): SemanticType | undefined;
+    getTypeOfSymbol(symbols: readonly SemanticSymbol[]): (SemanticType | undefined)[];
+    getDeclaredTypeOfSymbol(symbol: SemanticSymbol): SemanticType;
+    getTypeOfSymbolAtLocation(symbol: SemanticSymbol, node: AstNode): SemanticType;
+    getContextualType(node: AstNode): SemanticType | undefined;
+    getTypeFromTypeNode(node: AstNode): SemanticType | undefined;
+    getShorthandAssignmentValueSymbol(node: AstNode): SemanticSymbol | undefined;
+    getExportSpecifierLocalTargetSymbol(node: AstNode): SemanticSymbol | undefined;
+    getResolvedSignature(node: AstNode): SemanticSignature | undefined;
+    getSignatureFromDeclaration(node: AstNode): SemanticSignature | undefined;
+    getReturnTypeOfSignature(signature: SemanticSignature): SemanticType | undefined;
+    getRestTypeOfSignature(signature: SemanticSignature): SemanticType | undefined;
+    getParameterType(signature: SemanticSignature, index: number): SemanticType | undefined;
+    getBaseTypeOfLiteralType(type: SemanticType): SemanticType | undefined;
+    getNonNullableType(type: SemanticType): SemanticType | undefined;
+    getWidenedType(type: SemanticType): SemanticType | undefined;
+    getApparentType(type: SemanticType): SemanticType | undefined;
+    getConstraintOfTypeParameter(type: SemanticType): SemanticType | undefined;
+    getBaseConstraintOfType(type: SemanticType): SemanticType | undefined;
+    getBaseTypes(type: SemanticType): SemanticType[];
+    getTypeArguments(type: SemanticType): SemanticType[];
+    getPropertiesOfType(type: SemanticType): SemanticSymbol[];
+    getPropertyOfType(type: SemanticType, name: string): SemanticSymbol | undefined;
+    getExportsOfModule(symbol: SemanticSymbol): SemanticSymbol[];
+    getMemberInModuleExports(symbol: SemanticSymbol, name: string): SemanticSymbol | undefined;
+    getImmediateAliasedSymbol(symbol: SemanticSymbol): SemanticSymbol | undefined;
+    getAliasedSymbol(symbol: SemanticSymbol): SemanticSymbol;
+    resolveName(name: string, meaning: number, location?: AstNode | {
+        document: SemanticDocument;
+        position: number;
+    }, excludeGlobals?: boolean): SemanticSymbol | undefined;
+    getResolvedSymbol(node: AstNode): SemanticSymbol | undefined;
+    private intrinsic;
+    getAnyType(): SemanticType;
+    getStringType(): SemanticType;
+    getNumberType(): SemanticType;
+    getBooleanType(): SemanticType;
+    getVoidType(): SemanticType;
+    getUndefinedType(): SemanticType;
+    getNullType(): SemanticType;
+    getNeverType(): SemanticType;
+    getUnknownType(): SemanticType;
+    getBigIntType(): SemanticType;
+    getESSymbolType(): SemanticType;
+    typeToString(type: SemanticType, enclosingDeclaration?: AstNode, flags?: number): string;
+    isContextSensitive(node: AstNode): boolean;
+    isArrayType(type: SemanticType): boolean;
+    isArrayLikeType(type: SemanticType): boolean;
+    isTupleType(type: SemanticType): boolean;
+    isTypeAssignableTo(source: SemanticType, target: SemanticType): boolean;
+    getConstantValue(node: AstNode): string | number | undefined;
+    getSignaturesOfType(type: SemanticType, kind: number): SemanticSignature[];
+    getTypePredicateOfSignature(signature: SemanticSignature): SemanticTypePredicate | undefined;
+    getIndexInfosOfType(type: SemanticType): SemanticIndexInfo[];
+    private getWellKnownSymbols;
+    isUnknownSymbol(symbol: SemanticSymbol): boolean;
+    isUndefinedSymbol(symbol: SemanticSymbol): boolean;
+    isArgumentsSymbol(symbol: SemanticSymbol): boolean;
+    getReferencesToSymbolInFile(file: SemanticDocument, symbol: SemanticSymbol): SemanticNodeHandle[];
+    getReferencedSymbolsForNode(node: AstNode, position: number): SemanticReferencedSymbol[];
+    getSignatureUsage(node: AstNode): SemanticSignatureUsage[];
+    getJsDocTagsOfSymbol(symbol: SemanticSymbol): SemanticJsDocTag[];
+    getDocumentationCommentOfSymbol(symbol: SemanticSymbol): string;
+    getCompletionsAtPosition(file: SemanticDocument, position: number, options?: SemanticCompletionOptions): {
+        isIncomplete: boolean;
+        entries: SemanticCompletion[];
+    } | undefined;
+    typeToTypeNode(type: SemanticType, enclosingDeclaration?: AstNode, flags?: number): AstNode | undefined;
+    signatureToSignatureDeclaration(signature: SemanticSignature, kind: number, enclosingDeclaration?: AstNode, flags?: number): AstNode | undefined;
+    dispose(): void;
+}