structured-outputs 0.1.0-beta.1 → 0.1.0-beta.10

package/src/deps/jsr.io/@std/path/1.0.8/_common/glob_to_reg_exp.ts

@@ -0,0 +1,290 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+/**
+ * Options for {@linkcode globToRegExp}, {@linkcode joinGlobs},
+ * {@linkcode normalizeGlob} and {@linkcode expandGlob}.
+ */
+export interface GlobOptions {
+  /** Extended glob syntax.
+   * See https://www.linuxjournal.com/content/bash-extended-globbing.
+   *
+   * @default {true}
+   */
+  extended?: boolean;
+  /** Globstar syntax.
+   * See https://www.linuxjournal.com/content/globstar-new-bash-globbing-option.
+   * If false, `**` is treated like `*`.
+   *
+   * @default {true}
+   */
+  globstar?: boolean;
+  /**
+   * Whether globstar should be case-insensitive.
+   *
+   * @default {false}
+   */
+  caseInsensitive?: boolean;
+}
+
+const REG_EXP_ESCAPE_CHARS = [
+  "!",
+  "$",
+  "(",
+  ")",
+  "*",
+  "+",
+  ".",
+  "=",
+  "?",
+  "[",
+  "\\",
+  "^",
+  "{",
+  "|",
+] as const;
+const RANGE_ESCAPE_CHARS = ["-", "\\", "]"] as const;
+
+type RegExpEscapeChar = typeof REG_EXP_ESCAPE_CHARS[number];
+type RangeEscapeChar = typeof RANGE_ESCAPE_CHARS[number];
+type EscapeChar = RegExpEscapeChar | RangeEscapeChar;
+
+export interface GlobConstants {
+  sep: string;
+  sepMaybe: string;
+  seps: string[];
+  globstar: string;
+  wildcard: string;
+  escapePrefix: string;
+}
+
+export function _globToRegExp(
+  c: GlobConstants,
+  glob: string,
+  {
+    extended = true,
+    globstar: globstarOption = true,
+    // os = osType,
+    caseInsensitive = false,
+  }: GlobOptions = {},
+): RegExp {
+  if (glob === "") {
+    return /(?!)/;
+  }
+
+  // Remove trailing separators.
+  let newLength = glob.length;
+  for (; newLength > 1 && c.seps.includes(glob[newLength - 1]!); newLength--);
+  glob = glob.slice(0, newLength);
+
+  let regExpString = "";
+
+  // Terminates correctly. Trust that `j` is incremented every iteration.
+  for (let j = 0; j < glob.length;) {
+    let segment = "";
+    const groupStack: string[] = [];
+    let inRange = false;
+    let inEscape = false;
+    let endsWithSep = false;
+    let i = j;
+
+    // Terminates with `i` at the non-inclusive end of the current segment.
+    for (; i < glob.length && !c.seps.includes(glob[i]!); i++) {
+      if (inEscape) {
+        inEscape = false;
+        const escapeChars = (inRange
+          ? RANGE_ESCAPE_CHARS
+          : REG_EXP_ESCAPE_CHARS) as unknown as EscapeChar[];
+        segment += escapeChars.includes(glob[i]! as EscapeChar)
+          ? `\\${glob[i]}`
+          : glob[i];
+        continue;
+      }
+
+      if (glob[i] === c.escapePrefix) {
+        inEscape = true;
+        continue;
+      }
+
+      if (glob[i] === "[") {
+        if (!inRange) {
+          inRange = true;
+          segment += "[";
+          if (glob[i + 1] === "!") {
+            i++;
+            segment += "^";
+          } else if (glob[i + 1] === "^") {
+            i++;
+            segment += "\\^";
+          }
+          continue;
+        } else if (glob[i + 1] === ":") {
+          let k = i + 1;
+          let value = "";
+          while (glob[k + 1] !== undefined && glob[k + 1] !== ":") {
+            value += glob[k + 1];
+            k++;
+          }
+          if (glob[k + 1] === ":" && glob[k + 2] === "]") {
+            i = k + 2;
+            if (value === "alnum") segment += "\\dA-Za-z";
+            else if (value === "alpha") segment += "A-Za-z";
+            else if (value === "ascii") segment += "\x00-\x7F";
+            else if (value === "blank") segment += "\t ";
+            else if (value === "cntrl") segment += "\x00-\x1F\x7F";
+            else if (value === "digit") segment += "\\d";
+            else if (value === "graph") segment += "\x21-\x7E";
+            else if (value === "lower") segment += "a-z";
+            else if (value === "print") segment += "\x20-\x7E";
+            else if (value === "punct") {
+              segment += "!\"#$%&'()*+,\\-./:;<=>?@[\\\\\\]^_‘{|}~";
+            } else if (value === "space") segment += "\\s\v";
+            else if (value === "upper") segment += "A-Z";
+            else if (value === "word") segment += "\\w";
+            else if (value === "xdigit") segment += "\\dA-Fa-f";
+            continue;
+          }
+        }
+      }
+
+      if (glob[i] === "]" && inRange) {
+        inRange = false;
+        segment += "]";
+        continue;
+      }
+
+      if (inRange) {
+        segment += glob[i];
+        continue;
+      }
+
+      if (
+        glob[i] === ")" && groupStack.length > 0 &&
+        groupStack[groupStack.length - 1] !== "BRACE"
+      ) {
+        segment += ")";
+        const type = groupStack.pop()!;
+        if (type === "!") {
+          segment += c.wildcard;
+        } else if (type !== "@") {
+          segment += type;
+        }
+        continue;
+      }
+
+      if (
+        glob[i] === "|" && groupStack.length > 0 &&
+        groupStack[groupStack.length - 1] !== "BRACE"
+      ) {
+        segment += "|";
+        continue;
+      }
+
+      if (glob[i] === "+" && extended && glob[i + 1] === "(") {
+        i++;
+        groupStack.push("+");
+        segment += "(?:";
+        continue;
+      }
+
+      if (glob[i] === "@" && extended && glob[i + 1] === "(") {
+        i++;
+        groupStack.push("@");
+        segment += "(?:";
+        continue;
+      }
+
+      if (glob[i] === "?") {
+        if (extended && glob[i + 1] === "(") {
+          i++;
+          groupStack.push("?");
+          segment += "(?:";
+        } else {
+          segment += ".";
+        }
+        continue;
+      }
+
+      if (glob[i] === "!" && extended && glob[i + 1] === "(") {
+        i++;
+        groupStack.push("!");
+        segment += "(?!";
+        continue;
+      }
+
+      if (glob[i] === "{") {
+        groupStack.push("BRACE");
+        segment += "(?:";
+        continue;
+      }
+
+      if (glob[i] === "}" && groupStack[groupStack.length - 1] === "BRACE") {
+        groupStack.pop();
+        segment += ")";
+        continue;
+      }
+
+      if (glob[i] === "," && groupStack[groupStack.length - 1] === "BRACE") {
+        segment += "|";
+        continue;
+      }
+
+      if (glob[i] === "*") {
+        if (extended && glob[i + 1] === "(") {
+          i++;
+          groupStack.push("*");
+          segment += "(?:";
+        } else {
+          const prevChar = glob[i - 1];
+          let numStars = 1;
+          while (glob[i + 1] === "*") {
+            i++;
+            numStars++;
+          }
+          const nextChar = glob[i + 1];
+          if (
+            globstarOption && numStars === 2 &&
+            [...c.seps, undefined].includes(prevChar) &&
+            [...c.seps, undefined].includes(nextChar)
+          ) {
+            segment += c.globstar;
+            endsWithSep = true;
+          } else {
+            segment += c.wildcard;
+          }
+        }
+        continue;
+      }
+
+      segment += REG_EXP_ESCAPE_CHARS.includes(glob[i]! as RegExpEscapeChar)
+        ? `\\${glob[i]}`
+        : glob[i];
+    }
+
+    // Check for unclosed groups or a dangling backslash.
+    if (groupStack.length > 0 || inRange || inEscape) {
+      // Parse failure. Take all characters from this segment literally.
+      segment = "";
+      for (const c of glob.slice(j, i)) {
+        segment += REG_EXP_ESCAPE_CHARS.includes(c as RegExpEscapeChar)
+          ? `\\${c}`
+          : c;
+        endsWithSep = false;
+      }
+    }
+
+    regExpString += segment;
+    if (!endsWithSep) {
+      regExpString += i < glob.length ? c.sep : c.sepMaybe;
+      endsWithSep = true;
+    }
+
+    // Terminates with `i` at the start of the next segment.
+    while (c.seps.includes(glob[i]!)) i++;
+
+    j = i;
+  }
+
+  regExpString = `^${regExpString}$`;
+  return new RegExp(regExpString, caseInsensitive ? "i" : "");
+}

package/src/deps/jsr.io/@std/path/1.0.8/_common/normalize.ts

@@ -0,0 +1,9 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { assertPath } from "./assert_path.js";
+
+export function assertArg(path: string) {
+  assertPath(path);
+  if (path.length === 0) return ".";
+}

package/src/deps/jsr.io/@std/path/1.0.8/_common/normalize_string.ts

@@ -0,0 +1,74 @@
+// Copyright 2018-2024 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 { CHAR_DOT, CHAR_FORWARD_SLASH } from "./constants.js";
+
+// Resolves . and .. elements in a path with directory names
+export function normalizeString(
+  path: string,
+  allowAboveRoot: boolean,
+  separator: string,
+  isPathSeparator: (code: number) => boolean,
+): string {
+  let res = "";
+  let lastSegmentLength = 0;
+  let lastSlash = -1;
+  let dots = 0;
+  let code: number | undefined;
+  for (let i = 0; i <= path.length; ++i) {
+    if (i < path.length) code = path.charCodeAt(i);
+    else if (isPathSeparator(code!)) break;
+    else code = CHAR_FORWARD_SLASH;
+
+    if (isPathSeparator(code!)) {
+      if (lastSlash === i - 1 || dots === 1) {
+        // NOOP
+      } else if (lastSlash !== i - 1 && dots === 2) {
+        if (
+          res.length < 2 ||
+          lastSegmentLength !== 2 ||
+          res.charCodeAt(res.length - 1) !== CHAR_DOT ||
+          res.charCodeAt(res.length - 2) !== CHAR_DOT
+        ) {
+          if (res.length > 2) {
+            const lastSlashIndex = res.lastIndexOf(separator);
+            if (lastSlashIndex === -1) {
+              res = "";
+              lastSegmentLength = 0;
+            } else {
+              res = res.slice(0, lastSlashIndex);
+              lastSegmentLength = res.length - 1 - res.lastIndexOf(separator);
+            }
+            lastSlash = i;
+            dots = 0;
+            continue;
+          } else if (res.length === 2 || res.length === 1) {
+            res = "";
+            lastSegmentLength = 0;
+            lastSlash = i;
+            dots = 0;
+            continue;
+          }
+        }
+        if (allowAboveRoot) {
+          if (res.length > 0) res += `${separator}..`;
+          else res = "..";
+          lastSegmentLength = 2;
+        }
+      } else {
+        if (res.length > 0) res += separator + path.slice(lastSlash + 1, i);
+        else res = path.slice(lastSlash + 1, i);
+        lastSegmentLength = i - lastSlash - 1;
+      }
+      lastSlash = i;
+      dots = 0;
+    } else if (code === CHAR_DOT && dots !== -1) {
+      ++dots;
+    } else {
+      dots = -1;
+    }
+  }
+  return res;
+}

package/src/deps/jsr.io/@std/path/1.0.8/_common/relative.ts

@@ -0,0 +1,10 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { assertPath } from "./assert_path.js";
+
+export function assertArgs(from: string, to: string) {
+  assertPath(from);
+  assertPath(to);
+  if (from === to) return "";
+}

package/src/deps/jsr.io/@std/path/1.0.8/_common/strip_trailing_separators.ts

@@ -0,0 +1,25 @@
+// Copyright 2018-2024 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.
+
+export function stripTrailingSeparators(
+  segment: string,
+  isSep: (char: number) => boolean,
+): string {
+  if (segment.length <= 1) {
+    return segment;
+  }
+
+  let end = segment.length;
+
+  for (let i = segment.length - 1; i > 0; i--) {
+    if (isSep(segment.charCodeAt(i))) {
+      end = i;
+    } else {
+      break;
+    }
+  }
+
+  return segment.slice(0, end);
+}

package/src/deps/jsr.io/@std/path/1.0.8/_common/to_file_url.ts

@@ -0,0 +1,17 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+const WHITESPACE_ENCODINGS: Record<string, string> = {
+  "\u0009": "%09",
+  "\u000A": "%0A",
+  "\u000B": "%0B",
+  "\u000C": "%0C",
+  "\u000D": "%0D",
+  "\u0020": "%20",
+};
+
+export function encodeWhitespace(string: string): string {
+  return string.replaceAll(/[\s]/g, (c) => {
+    return WHITESPACE_ENCODINGS[c] ?? c;
+  });
+}

package/src/deps/jsr.io/@std/path/1.0.8/_os.ts

@@ -0,0 +1,12 @@
+// deno-lint-ignore-file no-explicit-any
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+// Check Deno, then the remaining runtimes (e.g. Node, Bun and the browser)
+import * as dntShim from "../../../../../_dnt.shims.js";
+
+export const isWindows: boolean =
+  (dntShim.dntGlobalThis as any).Deno?.build.os === "windows" ||
+  (dntShim.dntGlobalThis as any).navigator?.platform?.startsWith("Win") ||
+  (dntShim.dntGlobalThis as any).process?.platform?.startsWith("win") ||
+  false;

package/src/deps/jsr.io/@std/path/1.0.8/basename.ts

@@ -0,0 +1,38 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { isWindows } from "./_os.js";
+import { basename as posixBasename } from "./posix/basename.js";
+import { basename as windowsBasename } from "./windows/basename.js";
+
+/**
+ * Return the last portion of a path.
+ *
+ * The trailing directory separators are ignored, and optional suffix is
+ * removed.
+ *
+ * @example Usage
+ * ```ts
+ * import { basename } from "@std/path/basename";
+ * import { assertEquals } from "@std/assert";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(basename("C:\\user\\Documents\\image.png"), "image.png");
+ * } else {
+ *   assertEquals(basename("/home/user/Documents/image.png"), "image.png");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `basename` from `@std/path/unstable-basename`.
+ *
+ * @param path Path to extract the name from.
+ * @param suffix Suffix to remove from extracted name.
+ *
+ * @returns The basename of the path.
+ */
+export function basename(path: string, suffix = ""): string {
+  return isWindows
+    ? windowsBasename(path, suffix)
+    : posixBasename(path, suffix);
+}

package/src/deps/jsr.io/@std/path/1.0.8/common.ts

@@ -0,0 +1,35 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { common as _common } from "./_common/common.js";
+import { SEPARATOR } from "./constants.js";
+
+/**
+ * Determines the common path from a set of paths for the given OS.
+ *
+ * @param paths Paths to search for common path.
+ * @returns The common path.
+ *
+ * @example Usage
+ * ```ts
+ * import { common } from "@std/path/common";
+ * import { assertEquals } from "@std/assert";
+ *
+ * if (Deno.build.os === "windows") {
+ *   const path = common([
+ *     "C:\\deno\\std\\path\\mod.ts",
+ *     "C:\\deno\\std\\fs\\mod.ts"
+ *   ]);
+ *   assertEquals(path, "C:\\deno\\std\\");
+ * } else {
+ *   const path = common([
+ *     "./deno/std/path/mod.ts",
+ *     "./deno/std/fs/mod.ts"
+ *   ]);
+ *   assertEquals(path, "./deno/std/");
+ * }
+ * ```
+ */
+export function common(paths: string[]): string {
+  return _common(paths, SEPARATOR);
+}

package/src/deps/jsr.io/@std/path/1.0.8/constants.ts

@@ -0,0 +1,18 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+import { isWindows } from "./_os.js";
+
+/**
+ * The character used to separate entries in the PATH environment variable.
+ * On Windows, this is `;`. On all other platforms, this is `:`.
+ */
+export const DELIMITER = isWindows ? ";" as const : ":" as const;
+/**
+ * The character used to separate components of a file path.
+ * On Windows, this is `\`. On all other platforms, this is `/`.
+ */
+export const SEPARATOR = isWindows ? "\\" as const : "/" as const;
+/**
+ * A regular expression that matches one or more path separators.
+ */
+export const SEPARATOR_PATTERN = isWindows ? /[\\/]+/ : /\/+/;

package/src/deps/jsr.io/@std/path/1.0.8/dirname.ts

@@ -0,0 +1,31 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { isWindows } from "./_os.js";
+import { dirname as posixDirname } from "./posix/dirname.js";
+import { dirname as windowsDirname } from "./windows/dirname.js";
+
+/**
+ * Return the directory path of a path.
+ *
+ * @example Usage
+ * ```ts
+ * import { dirname } from "@std/path/dirname";
+ * import { assertEquals } from "@std/assert";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(dirname("C:\\home\\user\\Documents\\image.png"), "C:\\home\\user\\Documents");
+ * } else {
+ *   assertEquals(dirname("/home/user/Documents/image.png"), "/home/user/Documents");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `dirname` from `@std/path/unstable-dirname`.
+ *
+ * @param path Path to extract the directory from.
+ * @returns The directory path.
+ */
+export function dirname(path: string): string {
+  return isWindows ? windowsDirname(path) : posixDirname(path);
+}

package/src/deps/jsr.io/@std/path/1.0.8/extname.ts

@@ -0,0 +1,30 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { isWindows } from "./_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");
+ * } else {
+ *   assertEquals(extname("/home/user/Documents/image.png"), ".png");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `extname` from `@std/path/unstable-extname`.
+ *
+ * @param path Path with extension.
+ * @returns The file extension. E.g. returns `.ts` for `file.ts`.
+ */
+export function extname(path: string): string {
+  return isWindows ? windowsExtname(path) : posixExtname(path);
+}

package/src/deps/jsr.io/@std/path/1.0.8/format.ts

@@ -0,0 +1,30 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { isWindows } from "./_os.js";
+import { format as posixFormat } from "./posix/format.js";
+import { format as windowsFormat } from "./windows/format.js";
+import type { ParsedPath } from "./types.js";
+
+/**
+ * Generate a path from a {@linkcode ParsedPath} object. It does the
+ * opposite of {@linkcode https://jsr.io/@std/path/doc/~/parse | parse()}.
+ *
+ * @example Usage
+ * ```ts
+ * import { format } from "@std/path/format";
+ * import { assertEquals } from "@std/assert";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(format({ dir: "C:\\path\\to", base: "script.ts" }), "C:\\path\\to\\script.ts");
+ * } else {
+ *   assertEquals(format({ dir: "/path/to/dir", base: "script.ts" }), "/path/to/dir/script.ts");
+ * }
+ * ```
+ *
+ * @param pathObject Object with path components.
+ * @returns The formatted path.
+ */
+export function format(pathObject: Partial<ParsedPath>): string {
+  return isWindows ? windowsFormat(pathObject) : posixFormat(pathObject);
+}

package/src/deps/jsr.io/@std/path/1.0.8/from_file_url.ts

@@ -0,0 +1,30 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { isWindows } from "./_os.js";
+import { fromFileUrl as posixFromFileUrl } from "./posix/from_file_url.js";
+import { fromFileUrl as windowsFromFileUrl } from "./windows/from_file_url.js";
+
+/**
+ * Converts a file URL to a path string.
+ *
+ * @example Usage
+ * ```ts
+ * import { fromFileUrl } from "@std/path/from-file-url";
+ * import { assertEquals } from "@std/assert";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
+ *   assertEquals(fromFileUrl("file:///C:/Users/foo"), "C:\\Users\\foo");
+ *   assertEquals(fromFileUrl("file://localhost/home/foo"), "\\home\\foo");
+ * } else {
+ *   assertEquals(fromFileUrl("file:///home/foo"), "/home/foo");
+ * }
+ * ```
+ *
+ * @param url The file URL to convert to a path.
+ * @returns The path string.
+ */
+export function fromFileUrl(url: string | URL): string {
+  return isWindows ? windowsFromFileUrl(url) : posixFromFileUrl(url);
+}