@skmtc/core 0.28.7 → 0.30.1

package/script/types/Method.d.ts

@@ -5,9 +5,11 @@ import * as v from 'valibot';
  *
  * This constant array includes all HTTP methods that can be used
  * in OpenAPI path operations, as defined by the OpenAPI specification.
- * All methods are in lowercase to match OpenAPI conventions.
+ * All methods are in lowercase to match OpenAPI conventions. `query` is
+ * an OpenAPI 3.2 method; each parser tree reads its own list from
+ * `parse/v3-X/methods.ts`.
  */
-export declare const methodValues: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+export declare const methodValues: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace", "query"];
 /**
  * Array of HTTP methods excluding TRACE.
  *
@@ -23,8 +25,9 @@ export declare const method: v.UnionSchema<[
     v.LiteralSchema<'delete', undefined>,
     v.LiteralSchema<'head', undefined>,
     v.LiteralSchema<'options', undefined>,
-    v.LiteralSchema<'trace', undefined>
+    v.LiteralSchema<'trace', undefined>,
+    v.LiteralSchema<'query', undefined>
 ], undefined>;
-export type Method = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
+export type Method = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace' | 'query';
 export declare const methods: v.ArraySchema<typeof method, undefined>;
 export declare const isMethod: (arg: unknown) => arg is Method;

package/script/types/Method.js

@@ -41,7 +41,9 @@ const v = __importStar(require("valibot"));
  *
  * This constant array includes all HTTP methods that can be used
  * in OpenAPI path operations, as defined by the OpenAPI specification.
- * All methods are in lowercase to match OpenAPI conventions.
+ * All methods are in lowercase to match OpenAPI conventions. `query` is
+ * an OpenAPI 3.2 method; each parser tree reads its own list from
+ * `parse/v3-X/methods.ts`.
  */
 exports.methodValues = [
     'get',
@@ -51,7 +53,8 @@ exports.methodValues = [
     'options',
     'head',
     'patch',
-    'trace'
+    'trace',
+    'query'
 ];
 /**
  * Array of HTTP methods excluding TRACE.
@@ -59,7 +62,16 @@ exports.methodValues = [
  * This is a filtered version of {@link methodValues} that excludes the TRACE method,
  * which is sometimes excluded from API operations for security reasons.
  */
-exports.methodValuesNoTrace = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch'];
+exports.methodValuesNoTrace = [
+    'get',
+    'put',
+    'post',
+    'delete',
+    'options',
+    'head',
+    'patch',
+    'query'
+];
 exports.method = v.union([
     v.literal('get'),
     v.literal('post'),
@@ -68,7 +80,8 @@ exports.method = v.union([
     v.literal('delete'),
     v.literal('head'),
     v.literal('options'),
-    v.literal('trace')
+    v.literal('trace'),
+    v.literal('query')
 ]);
 exports.methods = v.array(exports.method);
 const isMethod = (arg) => {

package/script/types/Preview.d.ts

@@ -139,7 +139,8 @@ export declare const oasOperationSource: v.ObjectSchema<{
         v.LiteralSchema<'delete', undefined>,
         v.LiteralSchema<'head', undefined>,
         v.LiteralSchema<'options', undefined>,
-        v.LiteralSchema<'trace', undefined>
+        v.LiteralSchema<'trace', undefined>,
+        v.LiteralSchema<'query', undefined>
     ], undefined>;
     readonly variant: v.StringSchema<undefined>;
 }, undefined>;

package/script/types/Settings.js

@@ -88,13 +88,8 @@ require("../_dnt.polyfills.js");
 const Enrichments_js_1 = require("./Enrichments.js");
 const v = __importStar(require("valibot"));
 const Method_js_1 = require("./Method.js");
+const normalizeWorkspacePath_js_1 = require("../helpers/normalizeWorkspacePath.js");
 const toWorkspacePath_js_1 = require("../helpers/toWorkspacePath.js");
-/**
- * Whether a relative path contains a `..` parent-reference segment.
- * `..` is a parent reference only as a whole path segment — a
- * directory name that merely contains dots is not flagged.
- */
-const hasParentSegment = (path) => path.split(/[/\\]/).some(segment => segment === '..');
 /**
  * Valibot schema for {@link ModulePackage}.
  *
@@ -104,7 +99,7 @@ const hasParentSegment = (path) => path.split(/[/\\]/).some(segment => segment =
  * that otherwise misplaces every artifact silently.
  */
 exports.modulePackage = v.object({
-    rootPath: v.pipe(v.string(), v.check(rootPath => !hasParentSegment(rootPath), 'package rootPath must be a forward path with no ".." segments — ' +
+    rootPath: v.pipe(v.string(), v.check(rootPath => !(0, normalizeWorkspacePath_js_1.hasParentSegment)(rootPath), 'package rootPath must be a forward path with no ".." segments — ' +
         'set client.json basePath to a common ancestor of every package ' +
         'so each rootPath is written forward from it')),
     moduleName: v.optional(v.string())
@@ -211,7 +206,9 @@ exports.anchorsSettings = v.object({
     out: v.optional(v.string())
 });
 exports.clientSettings = v.object({
-    basePath: v.optional(v.string()),
+    basePath: v.optional(v.pipe(v.string(), v.check(basePath => !(0, normalizeWorkspacePath_js_1.isAbsolutePath)(basePath), 'basePath must be relative to the SKMTC root (the directory containing .skmtc/); ' +
+        'absolute paths are not supported because generated output is always written under it'), v.check(basePath => !(0, normalizeWorkspacePath_js_1.hasParentSegment)(basePath), 'basePath must be a forward path with no ".." segments — it is the on-disk anchor ' +
+        'every generated file sits below'))),
     schemaSource: v.optional(v.string()),
     packages: v.optional(exports.modulePackages),
     enrichments: v.optional(Enrichments_js_1.generatorEnrichments),
@@ -221,7 +218,8 @@ exports.clientSettings = v.object({
     inputDirs: v.optional(v.array(v.string())),
     formatter: v.optional(v.string()),
     generatedSuffix: v.optional(v.string()),
-    ejected: v.optional(v.array(v.string()))
+    ejected: v.optional(v.array(v.pipe(v.string(), v.check(normalizeWorkspacePath_js_1.isValidWorkspacePath, 'settings.ejected entries are export paths: a forward path below basePath, ' +
+        'with no ".." segment and not a Windows drive or UNC path'))))
 });
 /**
  * Valibot schema for validating SKMTC client configuration.

package/script/types/SkmtcDocument.d.ts

@@ -59,12 +59,12 @@ export declare const toGqlParsedDocument: (value: GqlDocument) => SkmtcParsedDoc
  * pipeline runs the protocol-appropriate parser before handing the
  * post-parse {@link SkmtcParsedDocument} to the generate phase.
  *
- * - `oas.value` is an `OpenAPIV3.Document`. Schema versions other than
- *   3.0 (Swagger 2, OpenAPI 3.1) are normalized to 3.0 by
- *   `@skmtc/convert` before reaching `toArtifacts`. 3.1 `webhooks` ride
- *   *on* that document as a retained member (the 3.0 base type omits
- *   `webhooks`, so it is widened here) — the parser flattens them into
- *   {@link OasDocument.webhooks}.
+ * - `oas.value` is an `OpenAPIV3.Document` carrying an OpenAPI 3.0, 3.1 or
+ *   3.2 document; each is parsed natively by its own parser tree. Swagger 2
+ *   is converted to 3.0 by `@skmtc/convert` before reaching `toArtifacts`.
+ *   3.1 and 3.2 `webhooks` ride *on* that document as a retained member
+ *   (the 3.0 base type omits `webhooks`, so it is widened here) — the
+ *   parser flattens them into {@link OasDocument.webhooks}.
  * - `gql.value` is either a raw SDL string or a pre-built
  *   `GraphQLSchema`. Strings are run through `buildSchema` inside the
  *   pipeline; pre-built `GraphQLSchema` instances are used as-is.

package/esm/deps/jsr.io/@std/path/1.1.6/extname.d.ts

@@ -1,24 +0,0 @@
-/**
- * Return the extension of the path with leading period (".").
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/extname";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(extname("C:\\home\\user\\Documents\\image.png"), ".png");
- *   assertEquals(extname(new URL("file:///C:/home/user/Documents/image.png")), ".png");
- * } else {
- *   assertEquals(extname("/home/user/Documents/image.png"), ".png");
- *   assertEquals(extname(new URL("file:///home/user/Documents/image.png")), ".png");
- * }
- * ```
- *
- * @param path Path with extension. When passed as a `URL` instance, its
- * protocol must be `file:`. For other protocols, pass the URL as a string or
- * pass its `pathname` property.
- * @returns The file extension. E.g. returns `.ts` for `file.ts`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export declare function extname(path: string | URL): string;

package/esm/deps/jsr.io/@std/path/1.1.6/extname.js

@@ -1,31 +0,0 @@
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-import { isWindows } from "../../internal/1.0.14/os.js";
-import { extname as posixExtname } from "./posix/extname.js";
-import { extname as windowsExtname } from "./windows/extname.js";
-/**
- * Return the extension of the path with leading period (".").
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/extname";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(extname("C:\\home\\user\\Documents\\image.png"), ".png");
- *   assertEquals(extname(new URL("file:///C:/home/user/Documents/image.png")), ".png");
- * } else {
- *   assertEquals(extname("/home/user/Documents/image.png"), ".png");
- *   assertEquals(extname(new URL("file:///home/user/Documents/image.png")), ".png");
- * }
- * ```
- *
- * @param path Path with extension. When passed as a `URL` instance, its
- * protocol must be `file:`. For other protocols, pass the URL as a string or
- * pass its `pathname` property.
- * @returns The file extension. E.g. returns `.ts` for `file.ts`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export function extname(path) {
-    return isWindows ? windowsExtname(path) : posixExtname(path);
-}

package/esm/deps/jsr.io/@std/path/1.1.6/normalize.d.ts

@@ -1,25 +0,0 @@
-/**
- * Normalize the path, resolving `'..'` and `'.'` segments.
- *
- * Note: Resolving these segments does not necessarily mean that all will be
- * eliminated. A `'..'` at the top-level will be preserved, and an empty path is
- * canonically `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "@std/path/normalize";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
- *   assertEquals(normalize(new URL("file:///C:/foo/bar/../baz/quux")), "C:\\foo\\baz\\quux");
- * } else {
- *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
- *   assertEquals(normalize(new URL("file:///foo/bar/../baz/quux")), "/foo/baz/quux");
- * }
- * ```
- *
- * @param path Path to be normalized
- * @returns The normalized path.
- */
-export declare function normalize(path: string | URL): string;

package/esm/deps/jsr.io/@std/path/1.1.6/normalize.js

@@ -1,32 +0,0 @@
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-import { isWindows } from "../../internal/1.0.14/os.js";
-import { normalize as posixNormalize } from "./posix/normalize.js";
-import { normalize as windowsNormalize } from "./windows/normalize.js";
-/**
- * Normalize the path, resolving `'..'` and `'.'` segments.
- *
- * Note: Resolving these segments does not necessarily mean that all will be
- * eliminated. A `'..'` at the top-level will be preserved, and an empty path is
- * canonically `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "@std/path/normalize";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
- *   assertEquals(normalize(new URL("file:///C:/foo/bar/../baz/quux")), "C:\\foo\\baz\\quux");
- * } else {
- *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
- *   assertEquals(normalize(new URL("file:///foo/bar/../baz/quux")), "/foo/baz/quux");
- * }
- * ```
- *
- * @param path Path to be normalized
- * @returns The normalized path.
- */
-export function normalize(path) {
-    return isWindows ? windowsNormalize(path) : posixNormalize(path);
-}

package/esm/deps/jsr.io/@std/path/1.1.6/windows/extname.d.ts

@@ -1,17 +0,0 @@
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/windows/extname";
- * import { assertEquals } from "@std/assert";
- *
- * assertEquals(extname("file.ts"), ".ts");
- * assertEquals(extname(new URL("file:///C:/foo/bar/baz.ext")), ".ext");
- * ```
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export declare function extname(path: string | URL): string;

package/esm/deps/jsr.io/@std/path/1.1.6/windows/extname.js

@@ -1,83 +0,0 @@
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-import { CHAR_COLON, CHAR_DOT } from "../_common/constants.js";
-import { assertPath } from "../_common/assert_path.js";
-import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
-import { fromFileUrl } from "./from_file_url.js";
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/windows/extname";
- * import { assertEquals } from "@std/assert";
- *
- * assertEquals(extname("file.ts"), ".ts");
- * assertEquals(extname(new URL("file:///C:/foo/bar/baz.ext")), ".ext");
- * ```
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export function extname(path) {
-    if (path instanceof URL) {
-        path = fromFileUrl(path);
-    }
-    assertPath(path);
-    let start = 0;
-    let startDot = -1;
-    let startPart = 0;
-    let end = -1;
-    let matchedSlash = true;
-    // Track the state of characters (if any) we see before our first dot and
-    // after any path separator we find
-    let preDotState = 0;
-    // Check for a drive letter prefix so as not to mistake the following
-    // path separator as an extra separator at the end of the path that can be
-    // disregarded
-    if (path.length >= 2 &&
-        path.charCodeAt(1) === CHAR_COLON &&
-        isWindowsDeviceRoot(path.charCodeAt(0))) {
-        start = startPart = 2;
-    }
-    for (let i = path.length - 1; i >= start; --i) {
-        const code = path.charCodeAt(i);
-        if (isPathSeparator(code)) {
-            // If we reached a path separator that was not part of a set of path
-            // separators at the end of the string, stop now
-            if (!matchedSlash) {
-                startPart = i + 1;
-                break;
-            }
-            continue;
-        }
-        if (end === -1) {
-            // We saw the first non-path separator, mark this as the end of our
-            // extension
-            matchedSlash = false;
-            end = i + 1;
-        }
-        if (code === CHAR_DOT) {
-            // If this is our first dot, mark it as the start of our extension
-            if (startDot === -1)
-                startDot = i;
-            else if (preDotState !== 1)
-                preDotState = 1;
-        }
-        else if (startDot !== -1) {
-            // We saw a non-dot and non-path separator before our dot, so we should
-            // have a good chance at having a non-empty extension
-            preDotState = -1;
-        }
-    }
-    if (startDot === -1 ||
-        end === -1 ||
-        // We saw a non-dot character immediately before the dot
-        preDotState === 0 ||
-        // The (right-most) trimmed path component is exactly '..'
-        (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)) {
-        return "";
-    }
-    return path.slice(startDot, end);
-}

package/script/deps/jsr.io/@std/path/1.1.6/extname.d.ts

@@ -1,24 +0,0 @@
-/**
- * Return the extension of the path with leading period (".").
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/extname";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(extname("C:\\home\\user\\Documents\\image.png"), ".png");
- *   assertEquals(extname(new URL("file:///C:/home/user/Documents/image.png")), ".png");
- * } else {
- *   assertEquals(extname("/home/user/Documents/image.png"), ".png");
- *   assertEquals(extname(new URL("file:///home/user/Documents/image.png")), ".png");
- * }
- * ```
- *
- * @param path Path with extension. When passed as a `URL` instance, its
- * protocol must be `file:`. For other protocols, pass the URL as a string or
- * pass its `pathname` property.
- * @returns The file extension. E.g. returns `.ts` for `file.ts`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export declare function extname(path: string | URL): string;

package/script/deps/jsr.io/@std/path/1.1.6/extname.js

@@ -1,34 +0,0 @@
-"use strict";
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extname = extname;
-const os_js_1 = require("../../internal/1.0.14/os.js");
-const extname_js_1 = require("./posix/extname.js");
-const extname_js_2 = require("./windows/extname.js");
-/**
- * Return the extension of the path with leading period (".").
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/extname";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(extname("C:\\home\\user\\Documents\\image.png"), ".png");
- *   assertEquals(extname(new URL("file:///C:/home/user/Documents/image.png")), ".png");
- * } else {
- *   assertEquals(extname("/home/user/Documents/image.png"), ".png");
- *   assertEquals(extname(new URL("file:///home/user/Documents/image.png")), ".png");
- * }
- * ```
- *
- * @param path Path with extension. When passed as a `URL` instance, its
- * protocol must be `file:`. For other protocols, pass the URL as a string or
- * pass its `pathname` property.
- * @returns The file extension. E.g. returns `.ts` for `file.ts`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-function extname(path) {
-    return os_js_1.isWindows ? (0, extname_js_2.extname)(path) : (0, extname_js_1.extname)(path);
-}

package/script/deps/jsr.io/@std/path/1.1.6/normalize.d.ts

@@ -1,25 +0,0 @@
-/**
- * Normalize the path, resolving `'..'` and `'.'` segments.
- *
- * Note: Resolving these segments does not necessarily mean that all will be
- * eliminated. A `'..'` at the top-level will be preserved, and an empty path is
- * canonically `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "@std/path/normalize";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
- *   assertEquals(normalize(new URL("file:///C:/foo/bar/../baz/quux")), "C:\\foo\\baz\\quux");
- * } else {
- *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
- *   assertEquals(normalize(new URL("file:///foo/bar/../baz/quux")), "/foo/baz/quux");
- * }
- * ```
- *
- * @param path Path to be normalized
- * @returns The normalized path.
- */
-export declare function normalize(path: string | URL): string;

package/script/deps/jsr.io/@std/path/1.1.6/normalize.js

@@ -1,35 +0,0 @@
-"use strict";
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalize = normalize;
-const os_js_1 = require("../../internal/1.0.14/os.js");
-const normalize_js_1 = require("./posix/normalize.js");
-const normalize_js_2 = require("./windows/normalize.js");
-/**
- * Normalize the path, resolving `'..'` and `'.'` segments.
- *
- * Note: Resolving these segments does not necessarily mean that all will be
- * eliminated. A `'..'` at the top-level will be preserved, and an empty path is
- * canonically `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "@std/path/normalize";
- * import { assertEquals } from "@std/assert";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
- *   assertEquals(normalize(new URL("file:///C:/foo/bar/../baz/quux")), "C:\\foo\\baz\\quux");
- * } else {
- *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
- *   assertEquals(normalize(new URL("file:///foo/bar/../baz/quux")), "/foo/baz/quux");
- * }
- * ```
- *
- * @param path Path to be normalized
- * @returns The normalized path.
- */
-function normalize(path) {
-    return os_js_1.isWindows ? (0, normalize_js_2.normalize)(path) : (0, normalize_js_1.normalize)(path);
-}

package/script/deps/jsr.io/@std/path/1.1.6/windows/extname.d.ts

@@ -1,17 +0,0 @@
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/windows/extname";
- * import { assertEquals } from "@std/assert";
- *
- * assertEquals(extname("file.ts"), ".ts");
- * assertEquals(extname(new URL("file:///C:/foo/bar/baz.ext")), ".ext");
- * ```
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-export declare function extname(path: string | URL): string;

package/script/deps/jsr.io/@std/path/1.1.6/windows/extname.js

@@ -1,86 +0,0 @@
-"use strict";
-// Copyright 2018-2026 the Deno authors. MIT license.
-// This module is browser compatible.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extname = extname;
-const constants_js_1 = require("../_common/constants.js");
-const assert_path_js_1 = require("../_common/assert_path.js");
-const _util_js_1 = require("./_util.js");
-const from_file_url_js_1 = require("./from_file_url.js");
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "@std/path/windows/extname";
- * import { assertEquals } from "@std/assert";
- *
- * assertEquals(extname("file.ts"), ".ts");
- * assertEquals(extname(new URL("file:///C:/foo/bar/baz.ext")), ".ext");
- * ```
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- * @throws {TypeError} If `path` is a `URL` instance whose protocol is not `file:`.
- */
-function extname(path) {
-    if (path instanceof URL) {
-        path = (0, from_file_url_js_1.fromFileUrl)(path);
-    }
-    (0, assert_path_js_1.assertPath)(path);
-    let start = 0;
-    let startDot = -1;
-    let startPart = 0;
-    let end = -1;
-    let matchedSlash = true;
-    // Track the state of characters (if any) we see before our first dot and
-    // after any path separator we find
-    let preDotState = 0;
-    // Check for a drive letter prefix so as not to mistake the following
-    // path separator as an extra separator at the end of the path that can be
-    // disregarded
-    if (path.length >= 2 &&
-        path.charCodeAt(1) === constants_js_1.CHAR_COLON &&
-        (0, _util_js_1.isWindowsDeviceRoot)(path.charCodeAt(0))) {
-        start = startPart = 2;
-    }
-    for (let i = path.length - 1; i >= start; --i) {
-        const code = path.charCodeAt(i);
-        if ((0, _util_js_1.isPathSeparator)(code)) {
-            // If we reached a path separator that was not part of a set of path
-            // separators at the end of the string, stop now
-            if (!matchedSlash) {
-                startPart = i + 1;
-                break;
-            }
-            continue;
-        }
-        if (end === -1) {
-            // We saw the first non-path separator, mark this as the end of our
-            // extension
-            matchedSlash = false;
-            end = i + 1;
-        }
-        if (code === constants_js_1.CHAR_DOT) {
-            // If this is our first dot, mark it as the start of our extension
-            if (startDot === -1)
-                startDot = i;
-            else if (preDotState !== 1)
-                preDotState = 1;
-        }
-        else if (startDot !== -1) {
-            // We saw a non-dot and non-path separator before our dot, so we should
-            // have a good chance at having a non-empty extension
-            preDotState = -1;
-        }
-    }
-    if (startDot === -1 ||
-        end === -1 ||
-        // We saw a non-dot character immediately before the dot
-        preDotState === 0 ||
-        // The (right-most) trimmed path component is exactly '..'
-        (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)) {
-        return "";
-    }
-    return path.slice(startDot, end);
-}