routie dev init since i didn't adhere to any proper guidance up until now

frontend/node_modules/@apidevtools/json-schema-ref-parser/lib/parsers/binary.ts

@@ -0,0 +1,39 @@
+import type { FileInfo } from "../types/index.js";
+import type { Plugin } from "../types/index.js";
+
+const BINARY_REGEXP = /\.(jpeg|jpg|gif|png|bmp|ico)$/i;
+
+export default {
+  /**
+   * The order that this parser will run, in relation to other parsers.
+   */
+  order: 400,
+
+  /**
+   * Whether to allow "empty" files (zero bytes).
+   */
+  allowEmpty: true,
+
+  /**
+   * Determines whether this parser can parse a given file reference.
+   * Parsers that return true will be tried, in order, until one successfully parses the file.
+   * Parsers that return false will be skipped, UNLESS all parsers returned false, in which case
+   * every parser will be tried.
+   */
+  canParse(file: FileInfo) {
+    // Use this parser if the file is a Buffer, and has a known binary extension
+    return Buffer.isBuffer(file.data) && BINARY_REGEXP.test(file.url);
+  },
+
+  /**
+   * Parses the given data as a Buffer (byte array).
+   */
+  parse(file: FileInfo) {
+    if (Buffer.isBuffer(file.data)) {
+      return file.data;
+    } else {
+      // This will reject if data is anything other than a string or typed array
+      return Buffer.from(file.data);
+    }
+  },
+} as Plugin;

frontend/node_modules/@apidevtools/json-schema-ref-parser/lib/parsers/json.ts

@@ -0,0 +1,64 @@
+import { ParserError } from "../util/errors.js";
+import type { FileInfo } from "../types/index.js";
+import type { Plugin } from "../types/index.js";
+
+export default {
+  /**
+   * The order that this parser will run, in relation to other parsers.
+   */
+  order: 100,
+
+  /**
+   * Whether to allow "empty" files. This includes zero-byte files, as well as empty JSON objects.
+   */
+  allowEmpty: true,
+
+  /**
+   * Determines whether this parser can parse a given file reference.
+   * Parsers that match will be tried, in order, until one successfully parses the file.
+   * Parsers that don't match will be skipped, UNLESS none of the parsers match, in which case
+   * every parser will be tried.
+   */
+  canParse: ".json",
+
+  /**
+   * Allow JSON files with byte order marks (BOM)
+   */
+  allowBOM: true,
+
+  /**
+   * Parses the given file as JSON
+   */
+  async parse(file: FileInfo): Promise<object | undefined> {
+    let data = file.data;
+    if (Buffer.isBuffer(data)) {
+      data = data.toString();
+    }
+
+    if (typeof data === "string") {
+      if (data.trim().length === 0) {
+        return; // This mirrors the YAML behavior
+      } else {
+        try {
+          return JSON.parse(data);
+        } catch (e: any) {
+          if (this.allowBOM) {
+            try {
+              // find the first curly brace
+              const firstCurlyBrace = data.indexOf("{");
+              // remove any characters before the first curly brace
+              data = data.slice(firstCurlyBrace);
+              return JSON.parse(data);
+            } catch (e: any) {
+              throw new ParserError(e.message, file.url);
+            }
+          }
+          throw new ParserError(e.message, file.url);
+        }
+      }
+    } else {
+      // data is already a JavaScript value (object, array, number, null, NaN, etc.)
+      return data as object;
+    }
+  },
+} as Plugin;

frontend/node_modules/@apidevtools/json-schema-ref-parser/lib/parsers/text.ts

@@ -0,0 +1,46 @@
+import { ParserError } from "../util/errors.js";
+import type { FileInfo } from "../types/index.js";
+import type { Plugin } from "../types/index.js";
+
+const TEXT_REGEXP = /\.(txt|htm|html|md|xml|js|min|map|css|scss|less|svg)$/i;
+
+export default {
+  /**
+   * The order that this parser will run, in relation to other parsers.
+   */
+  order: 300,
+
+  /**
+   * Whether to allow "empty" files (zero bytes).
+   */
+  allowEmpty: true,
+
+  /**
+   * The encoding that the text is expected to be in.
+   */
+  encoding: "utf8" as BufferEncoding,
+
+  /**
+   * Determines whether this parser can parse a given file reference.
+   * Parsers that return true will be tried, in order, until one successfully parses the file.
+   * Parsers that return false will be skipped, UNLESS all parsers returned false, in which case
+   * every parser will be tried.
+   */
+  canParse(file: FileInfo) {
+    // Use this parser if the file is a string or Buffer, and has a known text-based extension
+    return (typeof file.data === "string" || Buffer.isBuffer(file.data)) && TEXT_REGEXP.test(file.url);
+  },
+
+  /**
+   * Parses the given file as text
+   */
+  parse(file: FileInfo) {
+    if (typeof file.data === "string") {
+      return file.data;
+    } else if (Buffer.isBuffer(file.data)) {
+      return file.data.toString(this.encoding);
+    } else {
+      throw new ParserError("data is not text", file.url);
+    }
+  },
+} as Plugin;

frontend/node_modules/@apidevtools/json-schema-ref-parser/lib/parsers/yaml.ts

@@ -0,0 +1,57 @@
+import { ParserError } from "../util/errors.js";
+import yaml from "js-yaml";
+import { JSON_SCHEMA } from "js-yaml";
+import type { FileInfo } from "../types/index.js";
+import type { Plugin } from "../types/index.js";
+
+export default {
+  /**
+   * The order that this parser will run, in relation to other parsers.
+   */
+  order: 200,
+
+  /**
+   * Whether to allow "empty" files. This includes zero-byte files, as well as empty JSON objects.
+   */
+  allowEmpty: true,
+
+  /**
+   * Determines whether this parser can parse a given file reference.
+   * Parsers that match will be tried, in order, until one successfully parses the file.
+   * Parsers that don't match will be skipped, UNLESS none of the parsers match, in which case
+   * every parser will be tried.
+   */
+  canParse: [".yaml", ".yml", ".json"], // JSON is valid YAML
+
+  /**
+   * Parses the given file as YAML
+   *
+   * @param file           - An object containing information about the referenced file
+   * @param file.url       - The full URL of the referenced file
+   * @param file.extension - The lowercased file extension (e.g. ".txt", ".html", etc.)
+   * @param file.data      - The file contents. This will be whatever data type was returned by the resolver
+   * @returns
+   */
+  async parse(file: FileInfo) {
+    let data = file.data;
+    if (Buffer.isBuffer(data)) {
+      data = data.toString();
+    }
+
+    if (typeof data === "string") {
+      try {
+        return yaml.load(data, { schema: JSON_SCHEMA });
+      } catch (e: any) {
+        try {
+          // fallback to non JSON_SCHEMA
+          return yaml.load(data);
+        } catch (e: any) {
+          throw new ParserError(e?.message || "Parser Error", file.url);
+        }
+      }
+    } else {
+      // data is already a JavaScript value (object, array, number, null, NaN, etc.)
+      return data;
+    }
+  },
+} as Plugin;