@cleanslate/sdk 0.1.0

package/dist/core/uint.js

@@ -0,0 +1,57 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+/*
+ * Vendored from microsoft/vscode (vs/base/common/uint.ts) for @cleanslate/sdk.
+ * Changes: see packages/cleanslate-sdk/VENDOR.md.
+ */
+export var Constants;
+(function (Constants) {
+    /**
+     * MAX SMI (SMall Integer) as defined in v8.
+     * one bit is lost for boxing/unboxing flag.
+     * one bit is lost for sign flag.
+     * See https://thibaultlaurens.github.io/javascript/2013/04/29/how-the-v8-engine-works/#tagged-values
+     */
+    Constants[Constants["MAX_SAFE_SMALL_INTEGER"] = 1073741824] = "MAX_SAFE_SMALL_INTEGER";
+    /**
+     * MIN SMI (SMall Integer) as defined in v8.
+     * one bit is lost for boxing/unboxing flag.
+     * one bit is lost for sign flag.
+     * See https://thibaultlaurens.github.io/javascript/2013/04/29/how-the-v8-engine-works/#tagged-values
+     */
+    Constants[Constants["MIN_SAFE_SMALL_INTEGER"] = -1073741824] = "MIN_SAFE_SMALL_INTEGER";
+    /**
+     * Max unsigned integer that fits on 8 bits.
+     */
+    Constants[Constants["MAX_UINT_8"] = 255] = "MAX_UINT_8";
+    /**
+     * Max unsigned integer that fits on 16 bits.
+     */
+    Constants[Constants["MAX_UINT_16"] = 65535] = "MAX_UINT_16";
+    /**
+     * Max unsigned integer that fits on 32 bits.
+     */
+    Constants[Constants["MAX_UINT_32"] = 4294967295] = "MAX_UINT_32";
+    Constants[Constants["UNICODE_SUPPLEMENTARY_PLANE_BEGIN"] = 65536] = "UNICODE_SUPPLEMENTARY_PLANE_BEGIN";
+})(Constants || (Constants = {}));
+export function toUint8(v) {
+    if (v < 0) {
+        return 0;
+    }
+    if (v > Constants.MAX_UINT_8) {
+        return Constants.MAX_UINT_8;
+    }
+    return v | 0;
+}
+export function toUint32(v) {
+    if (v < 0) {
+        return 0;
+    }
+    if (v > Constants.MAX_UINT_32) {
+        return Constants.MAX_UINT_32;
+    }
+    return v | 0;
+}
+//# sourceMappingURL=uint.js.map

package/dist/core/uint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint.js","sourceRoot":"","sources":["../../src/core/uint.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;;GAGG;AAEH,MAAM,CAAN,IAAY,SAiCX;AAjCD,WAAY,SAAS;IACpB;;;;;OAKG;IACH,sFAAgC,CAAA;IAEhC;;;;;OAKG;IACH,uFAAmC,CAAA;IAEnC;;OAEG;IACH,uDAAgB,CAAA;IAEhB;;OAEG;IACH,2DAAmB,CAAA;IAEnB;;OAEG;IACH,gEAAwB,CAAA;IAExB,uGAA4C,CAAA;AAC7C,CAAC,EAjCW,SAAS,KAAT,SAAS,QAiCpB;AAED,MAAM,UAAU,OAAO,CAAC,CAAS;IAChC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS;IACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,WAAW,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/core/uri.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Uniform Resource Identifier (URI) http://tools.ietf.org/html/rfc3986.
+ * This class is a simple parser which creates the basic component parts
+ * (http://tools.ietf.org/html/rfc3986#section-3) with minimal validation
+ * and encoding.
+ *
+ * ```txt
+ *       foo://example.com:8042/over/there?name=ferret#nose
+ *       \_/   \______________/\_________/ \_________/ \__/
+ *        |           |            |            |        |
+ *     scheme     authority       path        query   fragment
+ *        |   _____________________|__
+ *       / \ /                        \
+ *       urn:example:animal:ferret:nose
+ * ```
+ */
+export declare class URI implements UriComponents {
+    static isUri(thing: unknown): thing is URI;
+    /**
+     * scheme is the 'http' part of 'http://www.example.com/some/path?query#fragment'.
+     * The part before the first colon.
+     */
+    readonly scheme: string;
+    /**
+     * authority is the 'www.example.com' part of 'http://www.example.com/some/path?query#fragment'.
+     * The part between the first double slashes and the next slash.
+     */
+    readonly authority: string;
+    /**
+     * path is the '/some/path' part of 'http://www.example.com/some/path?query#fragment'.
+     */
+    readonly path: string;
+    /**
+     * query is the 'query' part of 'http://www.example.com/some/path?query#fragment'.
+     */
+    readonly query: string;
+    /**
+     * fragment is the 'fragment' part of 'http://www.example.com/some/path?query#fragment'.
+     */
+    readonly fragment: string;
+    /**
+     * @internal
+     */
+    protected constructor(scheme: string, authority?: string, path?: string, query?: string, fragment?: string, _strict?: boolean);
+    /**
+     * @internal
+     */
+    protected constructor(components: UriComponents);
+    /**
+     * Returns a string representing the corresponding file system path of this URI.
+     * Will handle UNC paths, normalizes windows drive letters to lower-case, and uses the
+     * platform specific path separator.
+     *
+     * * Will *not* validate the path for invalid characters and semantics.
+     * * Will *not* look at the scheme of this URI.
+     * * The result shall *not* be used for display purposes but for accessing a file on disk.
+     *
+     *
+     * The *difference* to `URI#path` is the use of the platform specific separator and the handling
+     * of UNC paths. See the below sample of a file-uri with an authority (UNC path).
+     *
+     * ```ts
+        const u = URI.parse('file://server/c$/folder/file.txt')
+        u.authority === 'server'
+        u.path === '/shares/c$/file.txt'
+        u.fsPath === '\\server\c$\folder\file.txt'
+    ```
+     *
+     * Using `URI#path` to read a file (using fs-apis) would not be enough because parts of the path,
+     * namely the server name, would be missing. Therefore `URI#fsPath` exists - it's sugar to ease working
+     * with URIs that represent files on disk (`file` scheme).
+     */
+    get fsPath(): string;
+    with(change: {
+        scheme?: string;
+        authority?: string | null;
+        path?: string | null;
+        query?: string | null;
+        fragment?: string | null;
+    }): URI;
+    /**
+     * Creates a new URI from a string, e.g. `http://www.example.com/some/path`,
+     * `file:///usr/home`, or `scheme:with/path`.
+     *
+     * @param value A string which represents an URI (see `URI#toString`).
+     */
+    static parse(value: string, _strict?: boolean): URI;
+    /**
+     * Creates a new URI from a file system path, e.g. `c:\my\files`,
+     * `/usr/home`, or `\\server\share\some\path`.
+     *
+     * The *difference* between `URI#parse` and `URI#file` is that the latter treats the argument
+     * as path, not as stringified-uri. E.g. `URI.file(path)` is **not the same as**
+     * `URI.parse('file://' + path)` because the path might contain characters that are
+     * interpreted (# and ?). See the following sample:
+     * ```ts
+    const good = URI.file('/coding/c#/project1');
+    good.scheme === 'file';
+    good.path === '/coding/c#/project1';
+    good.fragment === '';
+    const bad = URI.parse('file://' + '/coding/c#/project1');
+    bad.scheme === 'file';
+    bad.path === '/coding/c'; // path is now broken
+    bad.fragment === '/project1';
+    ```
+     *
+     * @param path A file system path (see `URI#fsPath`)
+     */
+    static file(path: string): URI;
+    /**
+     * Creates new URI from uri components.
+     *
+     * Unless `strict` is `true` the scheme is defaults to be `file`. This function performs
+     * validation and should be used for untrusted uri components retrieved from storage,
+     * user input, command arguments etc
+     */
+    static from(components: UriComponents, strict?: boolean): URI;
+    /**
+     * Join a URI path with path fragments and normalizes the resulting path.
+     *
+     * @param uri The input URI.
+     * @param pathFragment The path fragment to add to the URI path.
+     * @returns The resulting URI.
+     */
+    static joinPath(uri: URI, ...pathFragment: string[]): URI;
+    /**
+     * Creates a string representation for this URI. It's guaranteed that calling
+     * `URI.parse` with the result of this function creates an URI which is equal
+     * to this URI.
+     *
+     * * The result shall *not* be used for display purposes but for externalization or transport.
+     * * The result will be encoded using the percentage encoding and encoding happens mostly
+     * ignore the scheme-specific encoding rules.
+     *
+     * @param skipEncoding Do not encode the result, default is `false`
+     */
+    toString(skipEncoding?: boolean): string;
+    toJSON(): UriComponents;
+    /**
+     * A helper function to revive URIs.
+     *
+     * **Note** that this function should only be used when receiving URI#toJSON generated data
+     * and that it doesn't do any validation. Use {@link URI.from} when received "untrusted"
+     * uri components such as command arguments or data from storage.
+     *
+     * @param data The URI components or URI to revive.
+     * @returns The revived URI or undefined or null.
+     */
+    static revive(data: UriComponents | URI): URI;
+    static revive(data: UriComponents | URI | undefined): URI | undefined;
+    static revive(data: UriComponents | URI | null): URI | null;
+    static revive(data: UriComponents | URI | undefined | null): URI | undefined | null;
+}
+export interface UriComponents {
+    scheme: string;
+    authority?: string;
+    path?: string;
+    query?: string;
+    fragment?: string;
+}
+export declare function isUriComponents(thing: unknown): thing is UriComponents;
+/**
+ * Compute `fsPath` for the given uri
+ */
+export declare function uriToFsPath(uri: URI, keepDriveLetterCasing: boolean): string;
+/**
+ * Mapped-type that replaces all occurrences of URI with UriComponents
+ */
+export type UriDto<T> = {
+    [K in keyof T]: T[K] extends URI ? UriComponents : UriDto<T[K]>;
+};
+//# sourceMappingURL=uri.d.ts.map

package/dist/core/uri.d.ts.map

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