@revealui/core 0.0.1-pre.0

package/dist/core/gaurds/debugger/debugPageFiles.ts

@@ -0,0 +1,121 @@
+export { debugPageFiles };
+export type { PageContextDebugRouteMatches };
+
+import type { RouteMatches } from "../../router/index.js";
+
+import pc from "@brillout/picocolors";
+import type { PageConfigRuntime } from "../../../types/interfaces/page.js";
+import {
+  assert,
+  createDebugger,
+  makeFirst,
+} from "../../renderer/stream/utils.js";
+import { ClientDependency } from "../../../types/interfaces/client.js";
+import { PageFile } from "../../__internal/index.js";
+
+type PageContextDebugRouteMatches = {
+  _debugRouteMatches: "ROUTING_ERROR" | RouteMatches;
+};
+function debugPageFiles({
+  pageContext,
+  isHtmlOnly,
+  isClientRouting,
+  pageFilesLoaded,
+  pageFilesServerSide,
+  pageFilesClientSide,
+  clientEntries,
+  clientDependencies,
+}: {
+  pageContext: {
+    urlOriginal: string;
+    pageId: string;
+    _pageFilesAll: PageFile[];
+    _pageConfigs: PageConfigRuntime[];
+  } & PageContextDebugRouteMatches;
+  isHtmlOnly: boolean;
+  isClientRouting: boolean;
+  pageFilesLoaded: PageFile[];
+  pageFilesClientSide: PageFile[];
+  pageFilesServerSide: PageFile[];
+  clientEntries: string[];
+  clientDependencies: ClientDependency[];
+}): void {
+  const debug = createDebugger("reveal:pageFiles", {
+    serialization: { emptyArray: "None" },
+  });
+  const padding = "   - ";
+
+  debug("All page files:", printPageFiles(pageContext._pageFilesAll, true)); // TODO
+  debug(`URL:`, pageContext.urlOriginal);
+  debug.options({ serialization: { emptyArray: "No match" } })(
+    `Routing:`,
+    printRouteMatches(pageContext._debugRouteMatches),
+  );
+  debug(`pageId:`, pageContext.pageId);
+  debug("Page type:", isHtmlOnly ? "HTML-only" : "SSR/SPA");
+  debug(
+    `Routing type:`,
+    !isHtmlOnly && isClientRouting ? "Client Routing" : "Server Routing",
+  );
+  debug("Server-side page files:", printPageFiles(pageFilesLoaded));
+  assert(samePageFiles(pageFilesLoaded, pageFilesServerSide));
+  debug("Client-side page files:", printPageFiles(pageFilesClientSide));
+  debug("Client-side entries:", clientEntries);
+  debug("Client-side dependencies:", clientDependencies);
+
+  return;
+
+  function printRouteMatches(
+    debugRouteMatches: PageContextDebugRouteMatches["_debugRouteMatches"],
+  ) {
+    if (debugRouteMatches === "ROUTING_ERROR") {
+      return "Routing Failed";
+    }
+    if (debugRouteMatches === "CUSTOM_ROUTING") {
+      return "Custom Routing";
+    }
+    return debugRouteMatches;
+  }
+
+  function printPageFiles(
+    pageFiles: PageFile[],
+    genericPageFilesLast = false,
+  ): string {
+    if (pageFiles.length === 0) {
+      return "None";
+    }
+    return (
+      "\n" +
+      pageFiles
+        .sort((p1, p2) => p1.filePath.localeCompare(p2.filePath))
+        .sort(
+          makeFirst((p) =>
+            p.isRendererPageFile ? !genericPageFilesLast : null,
+          ),
+        )
+        .sort(
+          makeFirst((p) =>
+            p.isDefaultPageFile ? !genericPageFilesLast : null,
+          ),
+        )
+        .map((p) => p.filePath)
+        .map((s) =>
+          s.split("_default.page.").join(`${pc.blue("_default")}.page.`),
+        )
+        .map((s) => s.split("/renderer/").join(`/${pc.red("renderer")}/`))
+        .map((s) => padding + s)
+        .join("\n")
+    );
+  }
+}
+
+function samePageFiles(pageFiles1: PageFile[], pageFiles2: PageFile[]) {
+  return (
+    pageFiles1.every((p1) =>
+      pageFiles2.some((p2) => p2.filePath === p1.filePath),
+    ) &&
+    pageFiles2.every((p2) =>
+      pageFiles1.some((p1) => p1.filePath === p2.filePath),
+    )
+  );
+}

package/dist/core/gaurds/debugger/index.ts

@@ -0,0 +1,2 @@
+export * from "./createDebugger.js";
+export * from "./debugPageFiles.js";

package/dist/core/gaurds/errors/createErrorWithCleanStackTrace.ts

@@ -0,0 +1,56 @@
+export { createErrorWithCleanStackTrace };
+
+import { isNodeJS } from "../validators/isNodeJS.js";
+
+function createErrorWithCleanStackTrace(
+  errorMessage: string,
+  numberOfStackTraceLinesToRemove: number,
+) {
+  const err = new Error(errorMessage);
+  if (isNodeJS()) {
+    err.stack = clean(err.stack, numberOfStackTraceLinesToRemove);
+  }
+  return err;
+}
+
+function clean(
+  errStack: string | undefined,
+  numberOfStackTraceLinesToRemove: number,
+): string | undefined {
+  if (!errStack) {
+    return errStack;
+  }
+
+  const stackLines = splitByLine(errStack);
+
+  let linesRemoved = 0;
+
+  const stackLine__cleaned = stackLines
+    .filter((line) => {
+      // Remove internal stack traces
+      if (line.includes(" (internal/") || line.includes(" (node:internal")) {
+        return false;
+      }
+      if (
+        linesRemoved < numberOfStackTraceLinesToRemove &&
+        isStackTraceLine(line)
+      ) {
+        linesRemoved++;
+        return false;
+      }
+
+      return true;
+    })
+    .join("\n");
+
+  return stackLine__cleaned;
+}
+
+function isStackTraceLine(line: string): boolean {
+  return line.startsWith("    at ");
+}
+
+function splitByLine(str: string): string[] {
+  // https://stackoverflow.com/questions/21895233/how-in-node-to-split-string-by-newline-n
+  return str.split(/\r?\n/);
+}

package/dist/core/gaurds/errors/removeErrMsg.ts

@@ -0,0 +1,8 @@
+export { removeErrMsg };
+
+function removeErrMsg(stack: unknown): string {
+  if (typeof stack !== "string") return String(stack);
+  const [firstLine, ...stackLines] = stack.split("\n");
+  if (!firstLine!.startsWith("Error: ")) return stack;
+  return stackLines.join("\n");
+}

package/dist/core/gaurds/logger/addOnBeforeLogHook/index.ts

@@ -0,0 +1,7 @@
+import { globalObject } from "../../../globals/objects";
+
+export { addOnBeforeLogHook };
+
+function addOnBeforeLogHook(onBeforeLog: () => void) {
+  globalObject.onBeforeLog = onBeforeLog;
+}

package/dist/core/gaurds/logger/formatHintLog.ts

@@ -0,0 +1,17 @@
+import { stripAnsi } from "../../utils/string/stripAnsi.js";
+import { assert } from "../assertions/assert/index.js";
+
+export { formatHintLog };
+
+function formatHintLog(msg: string) {
+  assert(msg.length > 0);
+  const msgLength = stripAnsi(msg).length;
+  const sep = "─".repeat(msgLength);
+  return [
+    // prettier-ignore
+    // biome-ignore format:
+    `┌─${sep}─┐`,
+    `│ ${msg} │`,
+    `└─${sep}─┘`,
+  ].join("\n");
+}

package/dist/core/gaurds/logger/log404/index.spec.snapshot-1

@@ -0,0 +1,8 @@
+┌────────────────┬──────────────────┬─────────────────────────┐
+│ ROUTE          │ TYPE             │ DEFINED BY              │
+├────────────────┼──────────────────┼─────────────────────────┤
+│ /              │ Filesystem Route │ /pages/index/           │
+│ /markdown      │ Filesystem Route │ /pages/markdown/        │
+│ /star-wars     │ Filesystem Route │ /pages/star-wars/index/ │
+│ /star-wars/@id │ Filesystem Route │ /pages/star-wars/@id/   │
+└────────────────┴──────────────────┴─────────────────────────┘

package/dist/core/gaurds/logger/log404/index.spec.snapshot-2

@@ -0,0 +1,9 @@
+┌───────────────────────────────────────────────────────────────────────┬──────────────────┬─────────────────────────────────────────┐
+│ ROUTE                                                                 │ TYPE             │ DEFINED BY                              │
+├───────────────────────────────────────────────────────────────────────┼──────────────────┼─────────────────────────────────────────┤
+│ /                                                                     │ Filesystem Route │ /pages/index/                           │
+│ /markdown                                                             │ Filesystem Route │ /pages/markdown/                        │
+│ /star-wars                                                            │ Filesystem Route │ /pages/star-wars/index/                 │
+│ /star-wars/@id                                                        │ Filesystem Route │ /pages/star-wars/@id/                   │
+│ function route(pageContext) { if (pageContext.urlPathname === "/he... │ Route Function   │ /pages/hello/+route.ts > export default │
+└───────────────────────────────────────────────────────────────────────┴──────────────────┴─────────────────────────────────────────┘

package/dist/core/gaurds/logger/log404/index.spec.ts

@@ -0,0 +1,78 @@
+import { assert, describe, expect, it } from "vitest";
+
+import { getRoutesInfo } from "../log404/index.js";
+import { stripAnsi } from "../../../utils/string/stripAnsi.js";
+import { PageRoutes } from "../../../router/loadPageRoutes.js";
+
+describe("getRoutesInfo()", () => {
+  it("table layout - basic", () => {
+    const table = getRoutesInfo(pageRoutes1);
+    assert(table);
+    /*/
+    console.log(table)
+    /*/
+    expect(stripAnsi(table)).toMatchFileSnapshot("./index.spec.snapshot-1");
+    //*/
+  });
+  it("table layout - with Route Function", () => {
+    const table = getRoutesInfo(pageRoutes2);
+    assert(table);
+    /*/
+    console.log(table)
+    /*/
+    expect(stripAnsi(table)).toMatchFileSnapshot("./index.spec.snapshot-2");
+    //*/
+  });
+});
+
+const routeFunction = {
+  pageId: "/pages/hello",
+  comesFromV1PageConfig: true,
+  routeDefinedAtString: "/pages/hello/+route.ts > export default",
+  routeType: "FUNCTION",
+  routeFunction: function route(pageContext: { urlPathname: string }) {
+    if (
+      pageContext.urlPathname === "/hello" ||
+      pageContext.urlPathname === "/hello/"
+    ) {
+      const name = "anonymous";
+      return { routeParams: { name } };
+    }
+    // ...
+  },
+} as const;
+const pageRoutes1 = [
+  {
+    pageId: "/pages/index",
+    routeFilesystemDefinedBy: "/pages/index/",
+    comesFromV1PageConfig: true,
+    routeString: "/",
+    routeDefinedAtString: null,
+    routeType: "FILESYSTEM",
+  },
+  {
+    pageId: "/pages/markdown",
+    routeFilesystemDefinedBy: "/pages/markdown/",
+    comesFromV1PageConfig: true,
+    routeString: "/markdown",
+    routeDefinedAtString: null,
+    routeType: "FILESYSTEM",
+  },
+  {
+    pageId: "/pages/star-wars/@id",
+    routeFilesystemDefinedBy: "/pages/star-wars/@id/",
+    comesFromV1PageConfig: true,
+    routeString: "/star-wars/@id",
+    routeDefinedAtString: null,
+    routeType: "FILESYSTEM",
+  },
+  {
+    pageId: "/pages/star-wars/index",
+    routeFilesystemDefinedBy: "/pages/star-wars/index/",
+    comesFromV1PageConfig: true,
+    routeString: "/star-wars",
+    routeDefinedAtString: null,
+    routeType: "FILESYSTEM",
+  },
+] satisfies PageRoutes;
+const pageRoutes2 = [routeFunction, ...pageRoutes1] satisfies PageRoutes;

package/dist/core/gaurds/logger/log404/index.ts

@@ -0,0 +1,208 @@
+export { log404 }
+
+// Exported for ./index.spec.ts
+export { getRoutesInfo }
+
+import pc from "@brillout/picocolors"
+
+import { getGlobalContext } from "../../../globals/contexts/index.js"
+import { getTerminalWidth } from "../../../processing/getters/getTerminWidth.js"
+import type { PageRoutes } from "../../../router/index.js"
+import { noRouteMatch } from "../../../router/noRouteMatch.js"
+import { truncateString } from "../../../router/utils.js"
+import { assert, compareString } from "../../../utils/index.js"
+import { stripAnsi } from "../../../utils/string/stripAnsi.js"
+import { assertUsage } from "../../assertions/assertUsage/index.js"
+import { assertWarning } from "../../assertions/assertWarning/base.js"
+
+async function log404(pageContext: {
+  urlPathname: string
+  errorWhileRendering: null | Error
+  isClientSideNavigation: boolean
+  _pageRoutes: PageRoutes
+}) {
+  const { urlPathname } = pageContext
+
+  const pageRoutes = pageContext._pageRoutes
+  assertUsage(
+    pageRoutes.length > 0,
+    "No page found. Create at least one /pages/some-page/+Page.js file."
+  )
+  const globalContext = getGlobalContext()
+  if (
+    !globalContext.isProduction &&
+    !isFileRequest(urlPathname) &&
+    !pageContext.isClientSideNavigation
+  ) {
+    const routesInfo = getRoutesInfo(pageRoutes)
+    let msg = `URL ${pc.cyan(urlPathname)} ${noRouteMatch}`
+    const outro =
+      "See https://reveal.dev/routing for more information about routing."
+    if (!routesInfo) {
+      msg = `${msg}. ${pc.dim(outro)}`
+    } else {
+      msg = `${msg}:\n${routesInfo}\n${outro}`
+    }
+    assertWarning(false, msg, { onlyOnce: false })
+  }
+}
+function getRoutesInfo(pageRoutes: PageRoutes): string | null {
+  const entries = pageRoutes
+    .map((pageRoute) => {
+      let routeStr: string
+      let routeTypeSrc: "Route String" | "Route Function" | "Filesystem Route"
+      let routeDefinedBy: string
+      if (pageRoute.routeType === "FILESYSTEM") {
+        assert(pageRoute.routeFilesystemDefinedBy)
+        routeDefinedBy = pageRoute.routeFilesystemDefinedBy
+      } else {
+        assert(pageRoute.routeDefinedAtString)
+        routeDefinedBy = pageRoute.routeDefinedAtString
+      }
+      if (pageRoute.routeType === "STRING") {
+        routeStr = pageRoute.routeString
+        routeTypeSrc = "Route String"
+      } else if (pageRoute.routeType === "FUNCTION") {
+        routeStr = String(pageRoute.routeFunction)
+        routeTypeSrc = "Route Function"
+      } else {
+        routeStr = pageRoute.routeString
+        routeTypeSrc = "Filesystem Route"
+      }
+      assert(routeStr && routeTypeSrc && routeDefinedBy)
+      return { routeStr, routeTypeSrc, routeDefinedBy }
+    })
+    .sort((e1, e2) => {
+      if (
+        e1.routeTypeSrc !== "Route Function" &&
+        e2.routeTypeSrc === "Route Function"
+      ) {
+        return -1
+      }
+      if (
+        e1.routeTypeSrc === "Route Function" &&
+        e2.routeTypeSrc !== "Route Function"
+      ) {
+        return 1
+      }
+      return compareString(e1.routeStr, e2.routeStr)
+    })
+
+  const linesContent = [
+    {
+      routeStr: "ROUTE",
+      routeTypeSrc: "TYPE" as const,
+      routeDefinedBy: "DEFINED BY",
+    },
+    ...entries,
+  ]
+
+  const terminalWidth = getTerminalWidth() || 134
+
+  let width2 = Math.max(
+    ...linesContent.map(({ routeTypeSrc }) => stripAnsi(routeTypeSrc).length)
+  )
+  let width3 = Math.max(
+    ...linesContent.map(
+      ({ routeDefinedBy }) => stripAnsi(routeDefinedBy).length
+    )
+  )
+
+  const width1_max =
+    terminalWidth -
+    width3 -
+    width2 -
+    // Total width of table border & padding
+    10
+  if (width1_max < 10) return null
+  linesContent.forEach((lineContent) => {
+    let { routeStr } = lineContent
+    if (lineContent.routeTypeSrc === "Route Function") {
+      routeStr = truncateRouteFunction(routeStr, width1_max)
+      assert(stripAnsi(routeStr).length <= width1_max)
+    }
+    lineContent.routeStr = routeStr
+  })
+  let width1 = Math.max(
+    ...linesContent.map(({ routeStr }) => stripAnsi(routeStr).length)
+  )
+  if (width1 > width1_max) return null
+
+  let lines = linesContent.map(
+    ({ routeStr, routeTypeSrc, routeDefinedBy }, i) => {
+      let cell1 = padEnd(
+        routeStr,
+        width1 + (stripAnsi(routeStr).length - stripAnsi(routeStr).length)
+      )
+      let cell2 = padEnd(routeTypeSrc, width2)
+      let cell3 = padEnd(routeDefinedBy, width3)
+      const isHeader = i === 0
+      if (isHeader) {
+        cell1 = pc.dim(cell1)
+        cell2 = pc.dim(cell2)
+        cell3 = pc.dim(cell3)
+      }
+      let line = [cell1, cell2, cell3].join(pc.dim(" │ "))
+      line = pc.dim("│ ") + line + pc.dim(" │")
+      return line
+    }
+  )
+
+  width1 = width1 + 2
+  width2 = width2 + 2
+  width3 = width3 + 2
+
+  // https://en.wikipedia.org/wiki/Box-drawing_character
+  lines = [
+    pc.dim(
+      `┌${"─".repeat(width1)}┬${"─".repeat(width2)}┬${"─".repeat(width3)}┐`
+    ),
+    lines[0]!,
+    pc.dim(
+      `├${"─".repeat(width1)}┼${"─".repeat(width2)}┼${"─".repeat(width3)}┤`
+    ),
+    ...lines.slice(1),
+    pc.dim(
+      `└${"─".repeat(width1)}┴${"─".repeat(width2)}┴${"─".repeat(width3)}┘`
+    ),
+  ]
+
+  lines.forEach((line) => {
+    assert(stripAnsi(line).length <= terminalWidth)
+  })
+
+  return lines.join("\n")
+}
+
+function truncateRouteFunction(routeStr: string, lenMax: number) {
+  routeStr = stripAnsi(routeStr)
+  routeStr = removeNonAscii(routeStr)
+  routeStr = routeStr.split(/\s/).filter(Boolean).join(" ")
+  routeStr = truncateString(routeStr, lenMax)
+  return routeStr
+}
+
+/** Same as String.prototype.padEnd but with stripAnsi() */
+function padEnd(str: string, width: number): string {
+  const padWidth = Math.max(0, width - stripAnsi(str).length)
+  return str + "".padEnd(padWidth, " ")
+}
+
+function removeNonAscii(str: string) {
+  // https://stackoverflow.com/questions/20856197/remove-non-ascii-character-in-string/20856346#20856346
+  return str.replace(/[^\x00-\x7F]/g, "")
+}
+
+function isFileRequest(urlPathname: string) {
+  assert(urlPathname.startsWith("/"))
+  const paths = urlPathname.split("/")
+  const lastPath = paths[paths.length - 1]
+  assert(typeof lastPath === "string")
+  const parts = lastPath.split(".")
+  if (parts.length < 2) {
+    return false
+  }
+  const fileExtension = parts[parts.length - 1]
+  assert(typeof fileExtension === "string")
+  return /^[a-z0-9]+$/.test(fileExtension)
+}

package/dist/core/gaurds/logger/logErrorHint/errors.ts

@@ -0,0 +1,17 @@
+// https://github.com/revealjs/reveal/discussions/571#discussioncomment-6137618
+export const errror_cannot_use_import_outside_of_module = `
+import{useRunner as e}from"react-runner";export*from"react-runner";import t,{useState as r,useEffect as n,Fragment as a,useCallback as l,useRef as o,useMemo as c,createContext as s,useContext as i}from"react";import p from"react-simple-code-editor";import m,{Prism as u}from"prism-react-renderer";function g(){return g=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(e[n]=r[n])}return e},g.apply(this,arguments)}function y(e,t){if(null==e)return{};var r,n,a={},l=Object.keys(e);for(n=0;n<l.length;n++)t.indexOf(r=l[n])>=0||(a[r]=e[r]);return a}const d=["initialCode","transformCode"],h=t=>{let{initialCode:a="",transformCode:l}=t,o=y(t,d);const[c,s]=r(a),{element:i,error:p}=e(g({code:l?l(c):c},o));return n(()=>{s(a)},[a]),{element:i,error:p,code:c,onChange:s}},f={plain:{color:"#ffffff",backgroundColor:"#282c34"},styles:[{types:["comment","block-comment","prolog","doctype","cdata"],style:{color:"#b2b2b2"}},{types:["property","number","function-name","constant","symbol","deleted"],style:{color:"#5a9bcf"}},{types:["boolean"],style:{color:"#ff8b50"}},{types:["tag"],style:{color:"#fc929e"}},{types:["string","attr-value"],style:{color:"#8dc891"}},{types:["punctuation"],style:{color:"#88c6Be"}},{types:["selector","char","builtin","inserted"],style:{color:"#d8dee9"}},{types:["function"],style:{color:"#79b6f2"}},{types:["operator","entity","url","variable"],style:{color:"#d7deea"}},{types:["keyword"],style:{color:"#c5a5c5"}},{types:["atrule","class-name"],style:{color:"#fac863"}},{types:["important"],style:{fontWeight:"400"}},{types:["bold"],style:{fontWeight:"700"}},{types:["italic"],style:{fontStyle:"italic"}},{types:["entity"],style:{cursor:"help"}},{types:["namespace"],style:{opacity:.7}}]},b=["children","language","theme","Prism","padding","noWrapper","noWrap","className","style"],C=e=>{let{children:r,language:n="jsx",theme:l=f,Prism:o=u,padding:c=10,noWrapper:s,noWrap:i,className:p,style:d}=e,h=y(e,b);/*#__PURE__*/return t.createElement(m,{code:r||"",language:n,Prism:o,theme:l},({className:e,style:r,tokens:n,getLineProps:l,getTokenProps:o})=>{const m=n.map((e,r)=>/*#__PURE__*/t.createElement(a,{key:r},/*#__PURE__*/t.createElement("span",l({line:e}),e.map((e,r)=>/*#__PURE__*/t.createElement("span",o({token:e,key:r})))),"\\n"));return s?m:/*#__PURE__*/t.createElement("pre",g({className:p?:e,style:g({},r,{margin:0,padding:c,whiteSpace:i?"pre":"pre-wrap"},d)},h),m)})},v=["defaultValue","value","language","theme","Prism","highlight","padding","onChange"],E=e=>{let{defaultValue:n,value:a,language:s="jsx",theme:i=f,Prism:m,highlight:u,padding:d=10,onChange:h}=e,b=y(e,v);const[E,P]=r(n||""),k=void 0!==a,W=l(e=>/*#__PURE__*/t.createElement(C,{language:s,theme:i,Prism:m,noWrapper:!0},e),[s,i,m]),j=o(h);j.current=h;const x=l(e=>{k||P(e),null==j.current||j.current(e)},[k]),O=c(()=>g({},i.plain,b.style),[i.plain,b.style]);/*#__PURE__*/return t.createElement(p,g({},b,{highlight:u||W,padding:d,value:k?a:E,onValueChange:x,style:O}))},P=s({}),k=()=>i(P),W=["children","code","language","theme"],j=e=>{let{children:r,code:n="",language:a="jsx",theme:l=f}=e,o=y(e,W);const{element:c,error:s,code:i,onChange:p}=h(g({initialCode:n},o));/*#__PURE__*/return t.createElement(P.Provider,{value:{element:c,error:s,code:i,onChange:p,language:a,theme:l}},r)},x=e=>{const{code:r,language:n,theme:a,onChange:l}=k();/*#__PURE__*/return t.createElement(E,g({value:r,language:n,theme:a,onChange:l},e))},O=["Component"],w=e=>{let{Component:r="div"}=e,n=y(e,O);const{element:a}=k();/*#__PURE__*/return t.createElement(r,n,a)},N=e=>{const{error:r}=k();return r?/*#__PURE__*/t.createElement("pre",e,r):/*#__PURE__*/t.createElement(t.Fragment,null)};export{C as CodeBlock,E as CodeEditor,P as LiveContext,x as LiveEditor,N as LiveError,w as LivePreview,j as LiveProvider,f as defaultTheme,k as useLiveContext,h as useLiveRunner};
+^^^^^^
+
+    SyntaxError: Cannot use import statement outside a module
+        at Object.compileFunction (node:vm:360:18)
+        at wrapSafe (node:internal/modules/cjs/loader:1084:15)
+        at Module._compile (node:internal/modules/cjs/loader:1119:27)
+        at Object.Module._extensions..js (node:internal/modules/cjs/loader:1209:10)
+        at Module.load (node:internal/modules/cjs/loader:1033:32)
+        at Function.Module._load (node:internal/modules/cjs/loader:868:12)
+        at ModuleWrap.<anonymous> (node:internal/modules/translators:169:29)
+        at ModuleJob.run (node:internal/modules/module_job:193:25)
+        at processTicksAndRejections (node:internal/process/task_queues:96:5)
+        at async Promise.allSettled (index 0)
+`