@tsc-rs/typescript 0.0.0-placeholder → 0.8.0

package/dist/api/path.d.ts

@@ -0,0 +1,149 @@
+import { CaseSensitivity } from "#enums/caseSensitivity";
+import type { PathKey, RootedDirectoryPath, RootedFilePath, RootedPath } from "../ast/index.ts";
+export { CaseSensitivity } from "#enums/caseSensitivity";
+/**
+ * Returns length of the root part of a path or URL (i.e. length of "/", "x:/", "//server/share/, file:///user/files").
+ *
+ * For example:
+ * ```ts
+ * getRootLength("a") === 0                   // ""
+ * getRootLength("/") === 1                   // "/"
+ * getRootLength("c:") === 2                  // "c:"
+ * getRootLength("c:d") === 0                 // ""
+ * getRootLength("c:/") === 3                 // "c:/"
+ * getRootLength("c:\\") === 3                // "c:\\"
+ * getRootLength("//server") === 7            // "//server"
+ * getRootLength("//server/share") === 8      // "//server/"
+ * getRootLength("\\\\server") === 7          // "\\\\server"
+ * getRootLength("\\\\server\\share") === 8   // "\\\\server\\"
+ * getRootLength("file:///path") === 8        // "file:///"
+ * getRootLength("file:///c:") === 10         // "file:///c:"
+ * getRootLength("file:///c:d") === 8         // "file:///"
+ * getRootLength("file:///c:/path") === 11    // "file:///c:/"
+ * getRootLength("file://server") === 13      // "file://server"
+ * getRootLength("file://server/path") === 14 // "file://server/"
+ * getRootLength("http://server") === 13      // "http://server"
+ * getRootLength("http://server/path") === 14 // "http://server/"
+ * getRootLength("^/untitled/ts-nul-authority/Untitled-1") === 2 // "^/"
+ * ```
+ *
+ * @internal
+ */
+export declare function getRootLength(path: string): number;
+export declare function getPathComponents(path: string): string[];
+/**
+ * Determines whether a path has a trailing separator (`/` or `\\`).
+ */
+export declare function hasTrailingDirectorySeparator(path: string): boolean;
+/**
+ * Removes a trailing directory separator from a path, if it does not already have one.
+ */
+export declare function removeTrailingDirectorySeparator(path: string): string;
+/**
+ * Adds a trailing directory separator to a path, if it does not already have one.
+ */
+export declare function ensureTrailingDirectorySeparator(path: string): string;
+/**
+ * Normalize path separators, converting `\\` into `/`.
+ */
+export declare function normalizeSlashes(path: string): string;
+/**
+ * Combines paths. If a path is absolute, it replaces any previous path. Relative paths are not simplified.
+ */
+export declare function combinePaths(path: string, ...paths: (string | undefined)[]): string;
+/**
+ * Returns the normalized absolute path, resolving `.` and `..` segments.
+ */
+export declare function getNormalizedAbsolutePath(path: string, currentDirectory: string | undefined): string;
+/**
+ * Normalizes a path, resolving `.` and `..` segments and converting backslashes to forward slashes.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Determines whether a path is an absolute disk path (e.g. starts with `/`, or a DOS path
+ * like `c:`, `c:\\` or `c:/`).
+ */
+export declare function isRootedDiskPath(path: string): boolean;
+export declare function convertToRelativePath(absoluteOrRelativePath: string, basePath: string, getCanonicalFileName: (path: string) => string): string;
+/**
+ * Returns the canonical key for an already rooted, normalized path under
+ * caseSensitivity.
+ */
+export declare function pathKey(path: RootedPath, caseSensitivity: CaseSensitivity): PathKey;
+/**
+ * Validates a canonical path key received from a trusted producer without
+ * applying case sensitivity again.
+ */
+export declare function tryPathKeyFromCanonical(path: string): PathKey | undefined;
+/**
+ * Resolves path against currentDirectory and normalizes it.
+ */
+export declare function toRootedPath(path: string, currentDirectory: RootedDirectoryPath | undefined): RootedPath;
+/**
+ * Validates a path that is already rooted and normalized without changing it.
+ */
+export declare function rootedPathFromNormalized(path: string): RootedPath;
+/**
+ * Attempts to validate a path that is already rooted and normalized without
+ * changing it.
+ */
+export declare function tryRootedPathFromNormalized(path: string): RootedPath | undefined;
+/**
+ * Resolves fileName against currentDirectory, normalizes it, and gives it file
+ * intent.
+ */
+export declare function toRootedFilePath(fileName: string, currentDirectory: RootedDirectoryPath | undefined): RootedFilePath;
+/**
+ * Resolves directory against currentDirectory, normalizes it, and gives it
+ * directory intent.
+ */
+export declare function toRootedDirectoryPath(directory: string, currentDirectory: RootedDirectoryPath | undefined): RootedDirectoryPath;
+/**
+ * Gives a RootedPath file intent without changing it.
+ */
+export declare function rootedFilePathFromPath(path: RootedPath): RootedFilePath;
+/**
+ * Gives a RootedPath directory intent without changing it.
+ */
+export declare function rootedDirectoryPathFromPath(path: RootedPath): RootedDirectoryPath;
+/**
+ * Applies caseSensitivity to text used for path comparison or keys.
+ */
+export declare function canonicalize(text: string, caseSensitivity: CaseSensitivity): string;
+export declare function isCaseSensitive(caseSensitivity: CaseSensitivity): boolean;
+export declare function isCaseInsensitive(caseSensitivity: CaseSensitivity): boolean;
+/**
+ * Returns true if the path refers to a bundled library file.
+ */
+export declare function isBundled(path: string): boolean;
+/**
+ * Returns true if the file name represents a dynamic/virtual file
+ * that doesn't exist on disk (e.g., untitled files with paths like "^/untitled/...").
+ */
+export declare function isDynamicFileName(fileName: string): boolean;
+/**
+ * Splits a Windows volume (e.g., "c:") from the rest of the path.
+ * Returns [volume, rest, ok] where ok is true if a volume was found.
+ */
+export declare function splitVolumePath(path: string): [volume: string, rest: string, ok: boolean];
+/**
+ * Converts a file name to a document URI.
+ *
+ * @example
+ * fileNameToDocumentURI("/path/to/file.ts") === "file:///path/to/file.ts"
+ * fileNameToDocumentURI("c:/path/to/file.ts") === "file:///c%3A/path/to/file.ts"
+ * fileNameToDocumentURI("^/untitled/ts-nul-authority/Untitled-1") === "untitled:Untitled-1"
+ * fileNameToDocumentURI("^/vscode-vfs/github/microsoft/TypeScript/file.ts") === "vscode-vfs://github/microsoft/TypeScript/file.ts"
+ */
+export declare function fileNameToDocumentURI(fileName: string): string;
+/**
+ * Converts a document URI to a file name.
+ *
+ * @example
+ * documentURIToFileName("file:///path/to/file.ts") === "/path/to/file.ts"
+ * documentURIToFileName("file:///c%3A/path/to/file.ts") === "c:/path/to/file.ts"
+ * documentURIToFileName("untitled:Untitled-1") === "^/untitled/ts-nul-authority/Untitled-1"
+ * documentURIToFileName("vscode-vfs://github/microsoft/TypeScript/file.ts") === "^/vscode-vfs/github/microsoft/TypeScript/file.ts"
+ */
+export declare function documentURIToFileName(uri: string): string;
+//# sourceMappingURL=path.d.ts.map

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

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