keep-a-changelog 2.1.0 → 2.2.1

package/esm/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/win32.js

@@ -1,10 +1,11 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.
 import * as dntShim from "../../../../_dnt.shims.js";
 import { CHAR_BACKWARD_SLASH, CHAR_COLON, CHAR_DOT, CHAR_QUESTION_MARK, } from "./_constants.js";
 import { _format, assertPath, encodeWhitespace, isPathSeparator, isWindowsDeviceRoot, normalizeString, } from "./_util.js";
-import { assert } from "../_util/assert.js";
+import { assert } from "../_util/asserts.js";
 export const sep = "\\";
 export const delimiter = ";";
 /**
@@ -506,8 +507,8 @@ export function toNamespacedPath(path) {
     return path;
 }
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path to determine the directory path for
  */
 export function dirname(path) {
     assertPath(path);
@@ -640,33 +641,33 @@ export function basename(path, ext = "") {
             }
             else {
                 if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, remember this index in case
-                    // we need it if the extension ends up not matching
+                    // We saw the first non-path separator, mark this as the end of our
+                    // path component in case we don't match a whole suffix
                     matchedSlash = false;
                     firstNonSlashEnd = i + 1;
+                    end = firstNonSlashEnd;
                 }
                 if (extIdx >= 0) {
-                    // Try to match the explicit extension
+                    // Try to match the explicit suffix
                     if (code === ext.charCodeAt(extIdx)) {
                         if (--extIdx === -1) {
-                            // We matched the extension, so mark this as the end of our path
+                            // We matched whole suffix, so mark this as the end of our path
                             // component
                             end = i;
                         }
                     }
                     else {
-                        // Extension does not match, so our result is the entire path
-                        // component
+                        // Suffix character does not match, so bail out early
+                        // from checking rest of characters
                         extIdx = -1;
-                        end = firstNonSlashEnd;
                     }
                 }
             }
         }
+        if (end === -1)
+            return "";
         if (start === end)
             end = firstNonSlashEnd;
-        else if (end === -1)
-            end = path.length;
         return path.slice(start, end);
     }
     else {
@@ -692,8 +693,9 @@ export function basename(path, ext = "") {
     }
 }
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 export function extname(path) {
     assertPath(path);
@@ -917,7 +919,7 @@ export function parse(path) {
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./win32.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      fromFileUrl("file:///home/foo"); // "\\home\\foo"
  *      fromFileUrl("file:///C:/Users/foo"); // "C:\\Users\\foo"
  *      fromFileUrl("file://localhost/home/foo"); // "\\\\localhost\\home\\foo"
@@ -942,7 +944,7 @@ export function fromFileUrl(url) {
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./win32.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      toFileUrl("\\home\\foo"); // new URL("file:///home/foo")
  *      toFileUrl("C:\\Users\\foo"); // new URL("file:///C:/Users/foo")
  *      toFileUrl("\\\\127.0.0.1\\home\\foo"); // new URL("file://127.0.0.1/home/foo")