@tsc-rs/typescript 0.0.0-placeholder → 0.8.0

package/dist/api/timing.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Client-side collection of per-request timing and transfer measurements.
+ *
+ * When enabled, each request records its round-trip latency and the number of
+ * payload bytes sent and received, accumulated into running totals and a
+ * fixed-size ring buffer of the most recent requests.
+ *
+ * The server measures its own per-request processing time independently. When a
+ * timing snapshot is requested, the client fetches the server's collection via
+ * a `getServerTiming` request and folds it into the returned {@link TimingInfo},
+ * yielding per-request and total server processing time and an estimated
+ * transport overhead (round-trip minus server processing time). Normal response
+ * messages are left unchanged.
+ */
+/** Number of most-recent requests retained in the ring buffer. */
+export declare const RECENT_REQUEST_CAPACITY = 5;
+/** A single request's measured timing and transfer sample. */
+export interface RequestTiming {
+    /** The API method that was invoked. */
+    method: string;
+    /** Wall-clock round-trip time measured by the client, in milliseconds. */
+    roundTripMs: number;
+    /** Number of request payload bytes sent to the server. */
+    bytesSent: number;
+    /** Number of response payload bytes received from the server. */
+    bytesReceived: number;
+    /** Wall-clock timestamp ({@link Date.now}) captured when the request completed. */
+    timestamp: number;
+    /**
+     * Server-side processing time for this request, in milliseconds, as folded
+     * in from the server's own timing collection. Undefined when server timing
+     * for the request could not be matched.
+     */
+    serverTimeMs?: number | undefined;
+    /**
+     * Estimated transport overhead for this request, in milliseconds
+     * (`roundTripMs - serverTimeMs`, clamped to be non-negative). Present
+     * exactly when {@link serverTimeMs} is.
+     */
+    transportOverheadMs?: number | undefined;
+}
+/** Running totals accumulated across every measured request. */
+export interface TimingAccumulators {
+    /** Number of requests measured. */
+    requestCount: number;
+    /** Sum of round-trip latencies, in milliseconds. */
+    roundTripMs: number;
+    /** Sum of request payload bytes sent. */
+    bytesSent: number;
+    /** Sum of response payload bytes received. */
+    bytesReceived: number;
+    /** Sum of server-side processing time, in milliseconds. */
+    serverTimeMs: number;
+    /**
+     * Estimated total transport overhead, in milliseconds
+     * (`roundTripMs - serverTimeMs`, clamped to be non-negative).
+     */
+    transportOverheadMs: number;
+    /**
+     * Number of AST nodes materialized from binary source-file responses as the
+     * client walked the returned trees. Materialization is lazy and happens on
+     * demand, so this accrues after the originating request completes.
+     */
+    nodesMaterialized: number;
+    /**
+     * Number of source files fetched from the server (each decoded into a
+     * lazily-materialized tree).
+     */
+    sourceFilesFetched: number;
+    /**
+     * Number of AST nodes across all fetched source files that can be
+     * materialized on demand. Each fetched file contributes its full node count
+     * (excluding the pre-materialized source-file node), whether or not those
+     * nodes are ever walked. Serves as the denominator for the share of fetched
+     * nodes that end up materialized (`nodesMaterialized / nodesFetched`).
+     */
+    nodesFetched: number;
+}
+/** A point-in-time snapshot of collected timing information. */
+export interface TimingInfo {
+    /** Whether timing collection is enabled for this API instance. */
+    enabled: boolean;
+    /** Running totals across every measured request. */
+    totals: TimingAccumulators;
+    /**
+     * The most recent requests, up to {@link RECENT_REQUEST_CAPACITY}, ordered
+     * from oldest to newest.
+     */
+    recentRequests: RequestTiming[];
+}
+/** A raw measurement handed to {@link TimingCollector.record}. */
+export interface TimingSample {
+    method: string;
+    roundTripMs: number;
+    bytesSent: number;
+    bytesReceived: number;
+}
+/**
+ * A single server-side request's processing-time sample, as returned by a
+ * `getServerTiming` request. This is an internal wire shape; consumers see the
+ * folded-in {@link RequestTiming.serverTimeMs}.
+ */
+export interface ServerRequestTiming {
+    /** The API method that was handled. */
+    method: string;
+    /** Server-side processing time, in milliseconds. */
+    processingTimeMs: number;
+    /** Unix timestamp in milliseconds captured when the request completed. */
+    timestamp: number;
+}
+/** Running totals accumulated on the server across every handled request. */
+export interface ServerTimingTotals {
+    /** Total number of requests handled. */
+    requestCount: number;
+    /** Sum of server-side processing time, in milliseconds. */
+    totalProcessingTimeMs: number;
+}
+/**
+ * A snapshot of the server's own timing collection, retrieved via a
+ * `getServerTiming` request. This is an internal wire shape used to compute the
+ * server-derived fields of {@link TimingInfo}.
+ */
+export interface ServerTimingInfo {
+    /** Whether server-side timing collection is enabled. */
+    enabled: boolean;
+    /** Running totals across every request the server handled. */
+    totals: ServerTimingTotals;
+    /**
+     * The most recent requests as seen by the server, ordered from oldest to
+     * newest.
+     */
+    recentRequests: ServerRequestTiming[];
+}
+/** Returns a snapshot representing a disabled (never-collecting) timing state. */
+export declare function disabledTimingInfo(): TimingInfo;
+/** Returns a snapshot representing disabled server-side timing collection. */
+export declare function disabledServerTimingInfo(): ServerTimingInfo;
+/**
+ * Folds a server-side timing snapshot into a client-side snapshot, producing a
+ * combined {@link TimingInfo} with per-request and total server processing time
+ * plus estimated transport overhead.
+ *
+ * Recent requests are paired newest-to-newest and only matched when the method
+ * names agree, so that requests recorded by only one side (e.g. the meta
+ * requests used to fetch timing) do not misalign the two ring buffers.
+ */
+export declare function combineTimingInfo(client: TimingInfo, server: ServerTimingInfo): TimingInfo;
+/**
+ * Accumulates request timing samples into running totals and a fixed-size ring
+ * buffer of the most recent requests.
+ */
+export declare class TimingCollector {
+    private totals;
+    private ring;
+    private head;
+    /** Records a single request's measurements. */
+    record(sample: TimingSample): void;
+    /**
+     * Records a single AST node materialization. Called on demand as the consumer
+     * walks a binary source-file response's tree, so it is not tied to any one
+     * request.
+     */
+    recordMaterialization(): void;
+    /**
+     * Records a fetched source file: increments the fetched-file counter and adds
+     * the file's materializable node count to the fetched-node total, which serves
+     * as the denominator for the share of fetched nodes that end up materialized.
+     */
+    recordSourceFileFetched(materializableNodeCount: number): void;
+    /** Returns a snapshot of the collected timing information. */
+    getInfo(): TimingInfo;
+    /** Clears all accumulated totals and recent-request history. */
+    reset(): void;
+}
+//# sourceMappingURL=timing.d.ts.map

package/dist/api/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/api/timing.ts"],"names":[],"mappings":"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"}

package/dist/api/timing.js

@@ -0,0 +1,149 @@
+/**
+ * Client-side collection of per-request timing and transfer measurements.
+ *
+ * When enabled, each request records its round-trip latency and the number of
+ * payload bytes sent and received, accumulated into running totals and a
+ * fixed-size ring buffer of the most recent requests.
+ *
+ * The server measures its own per-request processing time independently. When a
+ * timing snapshot is requested, the client fetches the server's collection via
+ * a `getServerTiming` request and folds it into the returned {@link TimingInfo},
+ * yielding per-request and total server processing time and an estimated
+ * transport overhead (round-trip minus server processing time). Normal response
+ * messages are left unchanged.
+ */
+/** Number of most-recent requests retained in the ring buffer. */
+export const RECENT_REQUEST_CAPACITY = 5;
+function emptyAccumulators() {
+    return {
+        requestCount: 0,
+        roundTripMs: 0,
+        bytesSent: 0,
+        bytesReceived: 0,
+        serverTimeMs: 0,
+        transportOverheadMs: 0,
+        nodesMaterialized: 0,
+        sourceFilesFetched: 0,
+        nodesFetched: 0,
+    };
+}
+/** Returns a snapshot representing a disabled (never-collecting) timing state. */
+export function disabledTimingInfo() {
+    return {
+        enabled: false,
+        totals: emptyAccumulators(),
+        recentRequests: [],
+    };
+}
+/** Returns a snapshot representing disabled server-side timing collection. */
+export function disabledServerTimingInfo() {
+    return {
+        enabled: false,
+        totals: { requestCount: 0, totalProcessingTimeMs: 0 },
+        recentRequests: [],
+    };
+}
+/**
+ * Folds a server-side timing snapshot into a client-side snapshot, producing a
+ * combined {@link TimingInfo} with per-request and total server processing time
+ * plus estimated transport overhead.
+ *
+ * Recent requests are paired newest-to-newest and only matched when the method
+ * names agree, so that requests recorded by only one side (e.g. the meta
+ * requests used to fetch timing) do not misalign the two ring buffers.
+ */
+export function combineTimingInfo(client, server) {
+    if (!client.enabled) {
+        return client;
+    }
+    const serverTimeMs = server.totals.totalProcessingTimeMs;
+    const totals = {
+        ...client.totals,
+        serverTimeMs,
+        transportOverheadMs: Math.max(0, client.totals.roundTripMs - serverTimeMs),
+    };
+    const recentRequests = client.recentRequests.map(r => ({ ...r }));
+    const serverRecent = server.recentRequests;
+    const pairs = Math.min(recentRequests.length, serverRecent.length);
+    for (let i = 1; i <= pairs; i++) {
+        const c = recentRequests[recentRequests.length - i];
+        const s = serverRecent[serverRecent.length - i];
+        if (c.method === s.method) {
+            c.serverTimeMs = s.processingTimeMs;
+            c.transportOverheadMs = Math.max(0, c.roundTripMs - s.processingTimeMs);
+        }
+    }
+    return {
+        enabled: true,
+        totals,
+        recentRequests,
+    };
+}
+/**
+ * Accumulates request timing samples into running totals and a fixed-size ring
+ * buffer of the most recent requests.
+ */
+export class TimingCollector {
+    totals = emptyAccumulators();
+    // Ring buffer of the most recent requests. `ring` grows to at most
+    // RECENT_REQUEST_CAPACITY; once full, `head` marks the oldest entry.
+    ring = [];
+    head = 0;
+    /** Records a single request's measurements. */
+    record(sample) {
+        this.totals.requestCount++;
+        this.totals.roundTripMs += sample.roundTripMs;
+        this.totals.bytesSent += sample.bytesSent;
+        this.totals.bytesReceived += sample.bytesReceived;
+        const entry = {
+            method: sample.method,
+            roundTripMs: sample.roundTripMs,
+            bytesSent: sample.bytesSent,
+            bytesReceived: sample.bytesReceived,
+            timestamp: Date.now(),
+        };
+        if (this.ring.length < RECENT_REQUEST_CAPACITY) {
+            this.ring.push(entry);
+        }
+        else {
+            this.ring[this.head] = entry;
+            this.head = (this.head + 1) % RECENT_REQUEST_CAPACITY;
+        }
+    }
+    /**
+     * Records a single AST node materialization. Called on demand as the consumer
+     * walks a binary source-file response's tree, so it is not tied to any one
+     * request.
+     */
+    recordMaterialization() {
+        this.totals.nodesMaterialized++;
+    }
+    /**
+     * Records a fetched source file: increments the fetched-file counter and adds
+     * the file's materializable node count to the fetched-node total, which serves
+     * as the denominator for the share of fetched nodes that end up materialized.
+     */
+    recordSourceFileFetched(materializableNodeCount) {
+        this.totals.sourceFilesFetched++;
+        this.totals.nodesFetched += materializableNodeCount;
+    }
+    /** Returns a snapshot of the collected timing information. */
+    getInfo() {
+        const recentRequests = [];
+        for (let i = 0; i < this.ring.length; i++) {
+            recentRequests.push(this.ring[(this.head + i) % this.ring.length]);
+        }
+        return {
+            enabled: true,
+            totals: { ...this.totals },
+            recentRequests,
+        };
+    }
+    /** Clears all accumulated totals and recent-request history. */
+    reset() {
+        this.totals = emptyAccumulators();
+        this.ring = [];
+        this.head = 0;
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/api/timing.js.map

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

package/dist/api/typedPaths.d.ts

@@ -0,0 +1,3 @@
+export type { PathKey, RootedDirectoryPath, RootedFilePath, RootedPath } from "../ast/index.ts";
+export { canonicalize, CaseSensitivity, isCaseInsensitive, isCaseSensitive, pathKey, rootedDirectoryPathFromPath, rootedFilePathFromPath, rootedPathFromNormalized, toRootedDirectoryPath, toRootedFilePath, toRootedPath, tryPathKeyFromCanonical, tryRootedPathFromNormalized } from "./path.ts";
+//# sourceMappingURL=typedPaths.d.ts.map

package/dist/api/typedPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedPaths.d.ts","sourceRoot":"","sources":["../../src/api/typedPaths.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/api/typedPaths.js

@@ -0,0 +1,2 @@
+export { canonicalize, CaseSensitivity, isCaseInsensitive, isCaseSensitive, pathKey, rootedDirectoryPathFromPath, rootedFilePathFromPath, rootedPathFromNormalized, toRootedDirectoryPath, toRootedFilePath, toRootedPath, tryPathKeyFromCanonical, tryRootedPathFromNormalized } from "./path.js";
+//# sourceMappingURL=typedPaths.js.map

package/dist/api/typedPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedPaths.js","sourceRoot":"","sources":["../../src/api/typedPaths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/api/userPreferences.generated.d.ts

@@ -0,0 +1,195 @@
+export interface CodeLensUserPreferences {
+    implementationsCodeLensEnabled?: boolean | undefined;
+    implementationsCodeLensShowOnAllClassMethods?: boolean | undefined;
+    implementationsCodeLensShowOnInterfaceMethods?: boolean | undefined;
+    referencesCodeLensEnabled?: boolean | undefined;
+    referencesCodeLensShowOnAllFunctions?: boolean | undefined;
+}
+/**
+ * CompletionPreferences contains preferences used while producing completions.
+ */
+export interface CompletionPreferences {
+    /**
+     * Unless this option is `false`, member completion lists triggered with `.` will include entries
+     * on potentially-null and potentially-undefined values, with insertion text to replace
+     * preceding `.` tokens with `?.`.
+     */
+    includeAutomaticOptionalChainCompletions?: boolean | undefined;
+    /**
+     * Enables auto-import-style completions on partially-typed import statements. E.g., allows
+     * `import write|` to be completed to `import { writeResult } from "./utils.js"`.
+     */
+    includeCompletionsForImportStatements?: boolean | undefined;
+    /**
+     * If enabled, TypeScript will search through all external modules' exports and add them to the completions list.
+     * This affects lone identifier completions but not completions on the right hand side of `obj.`.
+     */
+    includeCompletionsForModuleExports?: boolean | undefined;
+    /**
+     * If enabled, completions for class members (e.g. methods and properties) will include
+     * a whole declaration for the member.
+     */
+    includeCompletionsWithClassMemberSnippets?: boolean | undefined;
+    /**
+     * If enabled, object literal methods will have a method declaration completion entry in addition
+     * to the regular completion entry containing just the method name.
+     */
+    includeCompletionsWithObjectLiteralMethodSnippets?: boolean | undefined;
+    jsxAttributeCompletionStyle?: "auto" | "braces" | "none" | undefined;
+}
+export interface EditorSettings {
+    baseIndentSize?: number | undefined;
+    convertTabsToSpaces?: boolean | undefined;
+    indentSize?: number | undefined;
+    indentStyle?: "none" | "block" | "smart" | undefined;
+    newLineCharacter?: string | undefined;
+    tabSize?: number | undefined;
+    trimTrailingWhitespace?: boolean | undefined;
+}
+export interface FormatCodeSettings extends EditorSettings {
+    indentMultiLineObjectLiteralBeginningOnBlankLine?: boolean | undefined;
+    indentSwitchCase?: boolean | undefined;
+    insertSpaceAfterCommaDelimiter?: boolean | undefined;
+    insertSpaceAfterConstructor?: boolean | undefined;
+    insertSpaceAfterFunctionKeywordForAnonymousFunctions?: boolean | undefined;
+    insertSpaceAfterKeywordsInControlFlowStatements?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingEmptyBraces?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis?: boolean | undefined;
+    insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces?: boolean | undefined;
+    insertSpaceAfterSemicolonInForStatements?: boolean | undefined;
+    insertSpaceAfterTypeAssertion?: boolean | undefined;
+    insertSpaceBeforeAndAfterBinaryOperators?: boolean | undefined;
+    insertSpaceBeforeFunctionParenthesis?: boolean | undefined;
+    insertSpaceBeforeTypeAnnotation?: boolean | undefined;
+    placeOpenBraceOnNewLineForControlBlocks?: boolean | undefined;
+    placeOpenBraceOnNewLineForFunctions?: boolean | undefined;
+    semicolons?: "ignore" | "insert" | "remove" | undefined;
+}
+export interface InlayHintsPreferences {
+    includeInlayEnumMemberValueHints?: boolean | undefined;
+    includeInlayFunctionLikeReturnTypeHints?: boolean | undefined;
+    includeInlayFunctionParameterTypeHints?: boolean | undefined;
+    includeInlayParameterNameHints?: "none" | "literals" | "all" | undefined;
+    includeInlayParameterNameHintsWhenArgumentMatchesName?: boolean | undefined;
+    includeInlayPropertyDeclarationTypeHints?: boolean | undefined;
+    includeInlayVariableTypeHints?: boolean | undefined;
+    includeInlayVariableTypeHintsWhenTypeMatchesName?: boolean | undefined;
+}
+/**
+ * UserPreferences represents TypeScript language service preferences.
+ */
+export interface UserPreferences extends FormatCodeSettings, CompletionPreferences, InlayHintsPreferences, CodeLensUserPreferences {
+    allowRenameOfImportPath?: boolean | undefined;
+    allowTextChangesInNewFiles?: boolean | undefined;
+    autoClosingTags?: boolean | undefined;
+    autoImportEntrypointDirectorySearch?: boolean | undefined;
+    autoImportFileExcludePatterns?: string[] | undefined;
+    autoImportSpecifierExcludeRegexes?: string[] | undefined;
+    /**
+     * AutomaticTypeAcquisitionEnabled is the unified setting from tsserver.automaticTypeAcquisition.enabled under the js/ts section.
+     * When set, it takes precedence over DisableAutomaticTypeAcquisition.
+     */
+    automaticTypeAcquisitionEnabled?: boolean | undefined;
+    completeJSDocs?: boolean | undefined;
+    /**
+     * CustomConfigFileName specifies a custom config file name to use before defaulting to tsconfig.json/jsconfig.json.
+     */
+    customConfigFileName?: string | undefined;
+    /**
+     * DisableAutomaticTypeAcquisition is the deprecated setting from typescript.disableAutomaticTypeAcquisition.
+     */
+    disableAutomaticTypeAcquisition?: boolean | undefined;
+    disableLineTextInReferences?: boolean | undefined;
+    disableSuggestions?: boolean | undefined;
+    displayPartsForJSDoc?: boolean | undefined;
+    excludeLibrarySymbolsInNavTo?: boolean | undefined;
+    formatEnabled?: boolean | undefined;
+    generateReturnInDocTemplate?: boolean | undefined;
+    /**
+     * Determines whether we import `foo/index.ts` as "foo", "foo/index", or "foo/index.js"
+     */
+    importModuleSpecifierEnding?: "auto" | "minimal" | "index" | "js" | undefined;
+    importModuleSpecifierPreference?: "shortest" | "project-relative" | "relative" | "non-relative" | undefined;
+    lazyConfiguredProjectsFromExternalProject?: boolean | undefined;
+    locale?: string | undefined;
+    /**
+     * A positive integer indicating the maximum length of a hover text before it is truncated.
+     *
+     * Default: `500`
+     */
+    maximumHoverLength?: number | undefined;
+    /**
+     * Indicates whether accents and other diacritic marks are considered unequal for the purpose of sorting.
+     *
+     * This preference is ignored if organizeImportsCollation is not `unicode`.
+     *
+     * Default: `true`
+     */
+    organizeImportsAccentCollation?: boolean | undefined;
+    /**
+     * Indicates whether upper case or lower case should sort first.
+     *
+     * This permission is ignored if:
+     * 	- organizeImportsCollation is not `unicode`
+     * 	- organizeImportsIgnoreCase is `true`
+     * 	- organizeImportsIgnoreCase is `auto` and the auto-detected case sensitivity is case-insensitive.
+     *
+     * Default: `false`
+     */
+    organizeImportsCaseFirst?: "default" | "lower" | "upper" | undefined;
+    /**
+     * Indicates whether imports should be organized via an "ordinal" (binary) comparison using the numeric value of their
+     * code points, or via "unicode" natural sorting. This implementation is locale-agnostic and approximates the practical
+     * import-sorting behavior rather than the full Unicode Collation Algorithm.
+     *
+     * Default: Ordinal
+     */
+    organizeImportsCollation?: "ordinal" | "unicode" | undefined;
+    /**
+     * Indicates whether imports should be organized in a case-insensitive manner.
+     *
+     * If unspecified, case sensitivity is detected.
+     */
+    organizeImportsIgnoreCase?: boolean | undefined;
+    /**
+     * Indicates the locale to use for "unicode" collation in legacy clients. This is accepted for compatibility, but
+     * currently ignored because organize-import sorting is deterministic and locale-agnostic.
+     *
+     * This preference is ignored if organizeImportsCollation is not `unicode`.
+     *
+     * Default: `"en"`
+     */
+    organizeImportsLocale?: string | undefined;
+    /**
+     * Indicates whether numeric collation should be used for digit sequences in strings. When `true`, will collate
+     * strings such that `a1z < a2z < a100z`. When `false`, will collate strings such that `a1z < a100z < a2z`.
+     *
+     * This preference is ignored if organizeImportsCollation is not `unicode`.
+     *
+     * Default: `false`
+     */
+    organizeImportsNumericCollation?: boolean | undefined;
+    /**
+     * Indicates which deterministic preset should be used to sort imports.
+     * "auto" detects the existing ordinal case sensitivity where possible.
+     */
+    organizeImportsSort?: "auto" | "ordinal" | "ordinalIgnoreCase" | "natural" | "naturalIgnoreCase" | undefined;
+    /**
+     * Indicates where named type-only imports should sort. "inline" sorts named imports without regard to if the import is type-only.
+     *
+     * Default: `auto`, which defaults to `last`
+     */
+    organizeImportsTypeOrder?: "auto" | "last" | "inline" | "first" | undefined;
+    preferGoToSourceDefinition?: boolean | undefined;
+    preferTypeOnlyAutoImports?: boolean | undefined;
+    providePrefixAndSuffixTextForRename?: boolean | undefined;
+    provideRefactorNotApplicableReason?: boolean | undefined;
+    quotePreference?: "auto" | "double" | "single" | undefined;
+    reportStyleChecksAsWarnings?: boolean | undefined;
+    validateEnabled?: boolean | undefined;
+    workspaceSymbolsScope?: "allOpenProjects" | "currentProject" | undefined;
+}
+//# sourceMappingURL=userPreferences.generated.d.ts.map

package/dist/api/userPreferences.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPreferences.generated.d.ts","sourceRoot":"","sources":["../../src/api/userPreferences.generated.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACpC,8BAA8B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrD,4CAA4C,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnE,6CAA6C,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpE,yBAAyB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,oCAAoC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,wCAAwC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/D;;;OAGG;IACH,qCAAqC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzD;;;OAGG;IACH,yCAAyC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChE;;;OAGG;IACH,iDAAiD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxE,2BAA2B,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACtD,gDAAgD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvE,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,8BAA8B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrD,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD,oDAAoD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3E,+CAA+C,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtE,kDAAkD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzE,0DAA0D,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjF,qDAAqD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5E,uDAAuD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9E,0DAA0D,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjF,2DAA2D,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClF,wCAAwC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/D,6BAA6B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpD,wCAAwC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/D,oCAAoC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3D,+BAA+B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD,uCAAuC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9D,mCAAmC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1D,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB;IAClC,gCAAgC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvD,uCAAuC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9D,sCAAsC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7D,8BAA8B,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IACzE,qDAAqD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5E,wCAAwC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/D,6BAA6B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpD,gDAAgD,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,uBAAuB;IAC9H,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjD,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,mCAAmC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1D,6BAA6B,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrD,iCAAiC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD;;;OAGG;IACH,+BAA+B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;OAEG;IACH,+BAA+B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnD,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9E,+BAA+B,CAAC,EAAE,UAAU,GAAG,kBAAkB,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5G,yCAAyC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC;;;;;;OAMG;IACH,8BAA8B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrD;;;;;;;;;OASG;IACH,wBAAwB,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrE;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C;;;;;;;OAOG;IACH,+BAA+B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7G;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5E,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjD,yBAAyB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,mCAAmC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1D,kCAAkC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzD,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,qBAAqB,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC5E"}

package/dist/api/userPreferences.generated.js

@@ -0,0 +1,3 @@
+// Code generated by gen-preferences from tools/userPreferences.schema.json; DO NOT EDIT.
+export {};
+//# sourceMappingURL=userPreferences.generated.js.map

package/dist/api/userPreferences.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPreferences.generated.js","sourceRoot":"","sources":["../../src/api/userPreferences.generated.ts"],"names":[],"mappings":"AAAA,yFAAyF"}