@revealui/core 0.0.1-pre.0

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

@@ -0,0 +1,196 @@
+export { logErrorHint }
+// For ./logErrorHint/getErrorHint.spec.ts
+export { getErrorHint }
+
+import pc from "@brillout/picocolors"
+import { assert } from "../assertions/assert"
+import { isObject } from "../validators/isObject"
+import { formatHintLog } from "./formatHintLog"
+
+const hintDefault =
+  "The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"
+const hintLinkPrefix = "To fix this error, see "
+
+type Errors = {
+  errMsg: string | RegExp
+  link?: string
+  shouldMentionNodeModules?: false
+}
+const errorsMisc: Errors[] = [
+  {
+    errMsg: "jsxDEV is not a function",
+    link: "https://github.com/revealjs/reveal/issues/1469#issuecomment-1919518096",
+    shouldMentionNodeModules: false,
+  },
+  {
+    // ```
+    // Error [RollupError]: Could not resolve "../dist/client/assets.json" from "renderer/+onRenderHtml.tsx"
+    // ```
+    errMsg: "assets.json",
+    link: "https://reveal.dev/getGlobalContext",
+    shouldMentionNodeModules: false,
+  },
+]
+const errorsReact: Errors[] = [
+  {
+    errMsg:
+      "Element type is invalid: expected a string (for built-in components) or a class/function (for composite components)",
+    link: "https://reveal.dev/broken-npm-package#react-invalid-component",
+    // The stack trace can be user-land while the import is coming from node_modules
+    shouldMentionNodeModules: false,
+  },
+  {
+    // React's "Invalid hook call.", see https://github.com/revealjs/reveal/discussions/1637#discussioncomment-9424712
+    errMsg: "Cannot read properties of null (reading 'useContext')",
+  },
+]
+const errorsCjsEsm_withPreciseLink: Errors[] = [
+  {
+    // `SyntaxError: Named export '${exportName}' not found. The requested module '${packageName}' is a CommonJS module, which may not support all module.exports as named exports.`
+    errMsg: /Named export.*not found/i,
+    link: "https://reveal.dev/broken-npm-package#named-export-not-found",
+    // It seems that this always points to an npm package import.
+    shouldMentionNodeModules: false,
+  },
+]
+const errorsCjsEsm: Errors[] = [
+  { errMsg: "ERR_UNSUPPORTED_DIR_IMPORT" },
+  { errMsg: "ERR_REQUIRE_ESM" },
+  { errMsg: "Must use import" },
+
+  { errMsg: /Cannot find \S+ '(\S+)' imported from (\S+)/ },
+
+  { errMsg: "ERR_UNKNOWN_FILE_EXTENSION" },
+  { errMsg: /Unknown file extension "\S+" for (\S+)/ },
+
+  // `SyntaxError: Cannot use import statement outside a module`.
+  {
+    errMsg: "Cannot use import statement",
+    // Since user code is always ESM, this error must always originate from an npm package.
+    shouldMentionNodeModules: false,
+  },
+
+  { errMsg: "is not exported" },
+
+  { errMsg: "Cannot read properties of undefined" },
+  { errMsg: ".default is not" },
+
+  // Using CJS inside ESM modules.
+  { errMsg: "require is not a function" },
+  { errMsg: "exports is not defined" },
+  { errMsg: "module is not defined" },
+  { errMsg: "window is not defined" },
+  { errMsg: "not defined in ES" },
+  { errMsg: "Unexpected token 'export'" },
+]
+
+function logErrorHint(error: unknown): void {
+  /* Collect errors for ./logErrorHint.spec.ts
+  collectError(error)
+  //*/
+  const hint = getErrorHint(error)
+  if (hint) logHint(hint)
+}
+function getErrorHint(error: unknown): null | string {
+  {
+    const knownErr = isKnownError(error)
+    if (knownErr) {
+      if (knownErr.link) {
+        return hintLinkPrefix + knownErr.link
+      } else {
+        return hintDefault
+      }
+    }
+  }
+
+  return null
+}
+function logHint(hint: string) {
+  hint = formatHintLog(hint)
+  hint = pc.bold(hint)
+  console.error(hint)
+}
+
+function isKnownError(error: unknown) {
+  const anywhere = getAnywhere(error)
+  const knownErr = [
+    //
+    ...errorsMisc,
+    ...errorsReact,
+    ...errorsCjsEsm_withPreciseLink,
+    ...errorsCjsEsm,
+  ].find((knownErorr) => {
+    if (!includesLowercase(anywhere, knownErorr.errMsg)) return false
+    if (
+      knownErorr.shouldMentionNodeModules !== false &&
+      !includesLowercase(anywhere, "node_modules")
+    )
+      return false
+    return true
+  })
+  if (!knownErr) return false
+  return knownErr
+}
+
+function includesLowercase(str: string, substr: string | RegExp): boolean {
+  if (substr instanceof RegExp) {
+    let { flags } = substr
+    if (!flags.includes("i")) flags += "i"
+    const regex = new RegExp(substr.source, flags)
+    return regex.test(str)
+  }
+  if (typeof substr === "string") {
+    return str.toLowerCase().includes(substr.toLowerCase())
+  }
+  assert(false)
+}
+
+function getAnywhere(error: unknown): string {
+  const code = getErrCode(error)
+  const message = getErrMessage(error)
+  const stack = getErrStack(error)
+  const anywhere = [code, message, stack].filter(Boolean).join("\n")
+  return anywhere
+}
+function getErrMessage(err: unknown): null | string {
+  if (!isObject(err)) return null
+  if (!err.message) return null
+  if (typeof err.message !== "string") return null
+  return err.message
+}
+function getErrCode(err: unknown): null | string {
+  if (!isObject(err)) return null
+  if (!err.code) return null
+  if (typeof err.code !== "string") return null
+  return err.code
+}
+function getErrStack(err: unknown): null | string {
+  if (!isObject(err)) return null
+  if (!err.stack) return null
+  if (typeof err.stack !== "string") return null
+  return err.stack
+}
+
+function collectError(err: any) {
+  console.log(
+    [
+      "{",
+      `  message: ${JSON.stringify(err.message)},`,
+      `  code: ${JSON.stringify(err.code)},`,
+      "  stack: `\n" + err.stack + "\n`",
+      "}",
+    ].join("\n")
+  )
+  /* For reproductions using older vite-plugin-ssr versions, do one of the following.
+      - If upon pre-rendering:https: //github.com/brillout/repro_node-syntax-error#error-catched-by-vite-plugin-ssr
+      - Inject the logger inside `catch` in node_modules/vite-plugin-ssr/dist/node/runtime/renderPage.js
+      - Inject the following inside `configResolved(config_)` at node_modules/vite-plugin-ssr/dist/cjs/node/plugin/plugins/devConfig/index.js
+        ```js
+        config_.logger.error = (msg, options) => {
+          const { error } = options;
+          if (error) return;
+          console.log(...);
+        };
+        ```
+  */
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errBabelReact.ts

@@ -0,0 +1,16 @@
+export const errBabelReact = {
+  code: "BABEL_PARSE_ERROR",
+  reasonCode: "UnexpectedToken",
+  loc: { line: 7, column: 20, index: 208 },
+  pos: 208,
+  plugin: "vite:react-babel",
+  id: "/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx",
+  pluginCode:
+    "import React from 'react'\nimport logoUrl from './logo.svg'\nimport { PageContextProvider } from './usePageContext'\nimport { Link } from './Link'\nimport type { PageContext } from './types'\n\nexport { Layout }}\n\nfunction Layout({ pageContext, children }: { pageContext: PageContext; children: React.ReactNode }) {\n  return (\n    <React.StrictMode>\n      <PageContextProvider pageContext={pageContext}>\n        <Layout>\n          <Sidebar>\n            <Logo />\n            <Link href=\"/\">Welcome</Link>\n            <Link href=\"/markdown\">Markdown</Link>\n            <Link href=\"/star-wars\">Data Fetching</Link>\n            <Link href=\"/hello\">Routing</Link>\n          </Sidebar>\n          <Content>{children}</Content>\n        </Layout>\n      </PageContextProvider>\n    </React.StrictMode>\n  )\n}\n\nfunction Layout({ children }: { children: React.ReactNode }) {\n  return (\n    <div\n      style={{\n        display: 'flex',\n        maxWidth: 900,\n        margin: 'auto'\n      }}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction Sidebar({ children }: { children: React.ReactNode }) {\n  return (\n    <div\n      id=\"sidebar\"\n      style={{\n        padding: 20,\n        flexShrink: 0,\n        display: 'flex',\n        flexDirection: 'column',\n        lineHeight: '1.8em',\n        borderRight: '2px solid #eee'\n      }}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction Content({ children }: { children: React.ReactNode }) {\n  return (\n    <div id=\"page-container\">\n      <div\n        id=\"page-content\"\n        style={{\n          padding: 20,\n          paddingBottom: 50,\n          minHeight: '100vh.js'\n        }}\n      >\n        {children}\n      </div>\n    </div>\n  )\n}\n\nfunction Logo() {\n  return (\n    <div\n      style={{\n        marginTop: 20,\n        marginBottom: 10\n      }}\n    >\n      <a href=\"/\">\n        <img src={logoUrl} height={64} width={64} />\n      </a>\n    </div>\n  )\n}\n",
+  frame:
+    "5  |  import type { PageContext } from './types.js'\n6  |  \n7  |  export { Layout }}\n   |                      ^\n8  |  \n9  |  function Layout({ pageContext, children }: { pageContext: PageContext; children: React.ReactNode }) {",
+  message:
+    "/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx: Unexpected token (7:20)\n\n\u001b[0m \u001b[90m  5 |\u001b[39m \u001b[36mimport\u001b[39m type { \u001b[33mPageContext\u001b[39m } \u001b[36mfrom\u001b[39m \u001b[32m'./types'\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  6 |\u001b[39m\u001b[0m\n\u001b[0m\u001b[31m\u001b[1m>\u001b[22m\u001b[39m\u001b[90m  7 |\u001b[39m \u001b[36mexport\u001b[39m { \u001b[33mLayout\u001b[39m }}\u001b[0m\n\u001b[0m \u001b[90m    |\u001b[39m                     \u001b[31m\u001b[1m^\u001b[22m\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  8 |\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  9 |\u001b[39m \u001b[36mfunction\u001b[39m \u001b[33mLayout\u001b[39m({ pageContext\u001b[33m,\u001b[39m children }\u001b[33m:\u001b[39m { pageContext\u001b[33m:\u001b[39m \u001b[33mPageContext\u001b[39m\u001b[33m;\u001b[39m children\u001b[33m:\u001b[39m \u001b[33mReact\u001b[39m\u001b[33m.\u001b[39m\u001b[33mReactNode\u001b[39m }) {\u001b[0m\n\u001b[0m \u001b[90m 10 |\u001b[39m   \u001b[36mreturn\u001b[39m (\u001b[0m",
+  stack:
+    "SyntaxError: /home/rom/code/reveal/examples/react-full/renderer/Layout.tsx: Unexpected token (7:20)\n\n\u001b[0m \u001b[90m  5 |\u001b[39m \u001b[36mimport\u001b[39m type { \u001b[33mPageContext\u001b[39m } \u001b[36mfrom\u001b[39m \u001b[32m'./types'\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  6 |\u001b[39m\u001b[0m\n\u001b[0m\u001b[31m\u001b[1m>\u001b[22m\u001b[39m\u001b[90m  7 |\u001b[39m \u001b[36mexport\u001b[39m { \u001b[33mLayout\u001b[39m }}\u001b[0m\n\u001b[0m \u001b[90m    |\u001b[39m                     \u001b[31m\u001b[1m^\u001b[22m\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  8 |\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m  9 |\u001b[39m \u001b[36mfunction\u001b[39m \u001b[33mLayout\u001b[39m({ pageContext\u001b[33m,\u001b[39m children }\u001b[33m:\u001b[39m { pageContext\u001b[33m:\u001b[39m \u001b[33mPageContext\u001b[39m\u001b[33m;\u001b[39m children\u001b[33m:\u001b[39m \u001b[33mReact\u001b[39m\u001b[33m.\u001b[39m\u001b[33mReactNode\u001b[39m }) {\u001b[0m\n\u001b[0m \u001b[90m 10 |\u001b[39m   \u001b[36mreturn\u001b[39m (\u001b[0m\n    at instantiate (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error/credentials.ts:62:21)\n    at toParseError (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error.ts:60:12)\n    at TypeScriptParserMixin.raise (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/tokenizer/index.ts:1490:19)\n    at TypeScriptParserMixin.unexpected (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/tokenizer/index.ts:1531:16)\n    at TypeScriptParserMixin.parseExprAtom (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:1347:16)\n    at TypeScriptParserMixin.parseExprAtom (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/jsx/index.ts:574:22)\n    at TypeScriptParserMixin.parseExprSubscripts (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:718:23)\n    at TypeScriptParserMixin.parseUpdate (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:695:21)\n    at TypeScriptParserMixin.parseMaybeUnary (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:657:23)\n    at TypeScriptParserMixin.parseMaybeUnary (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3552:20)\n    at TypeScriptParserMixin.parseMaybeUnaryOrPrivate (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:395:14)\n    at TypeScriptParserMixin.parseExprOps (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:407:23)\n    at TypeScriptParserMixin.parseMaybeConditional (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:362:23)\n    at TypeScriptParserMixin.parseMaybeAssign (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:302:21)\n    at TypeScriptParserMixin.parseMaybeAssign (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3429:22)\n    at TypeScriptParserMixin.parseExpressionBase (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:225:23)\n    at callback (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:216:39)\n    at TypeScriptParserMixin.allowInAnd (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:3072:16)\n    at TypeScriptParserMixin.parseExpression (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:216:17)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:628:23)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:2887:20)\n    at TypeScriptParserMixin.parseStatementLike (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:417:17)\n    at TypeScriptParserMixin.parseModuleItem (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:354:17)\n    at TypeScriptParserMixin.parseBlockOrModuleBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1359:16)\n    at TypeScriptParserMixin.parseBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1333:10)\n    at TypeScriptParserMixin.parseProgram (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:226:10)\n    at TypeScriptParserMixin.parseTopLevel (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:208:25)\n    at TypeScriptParserMixin.parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/index.ts:45:10)\n    at TypeScriptParserMixin.parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3997:20)\n    at parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/index.ts:67:38)\n    at parser (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/parser/index.ts:28:19)\n    at parser.next (<anonymous>)\n    at normalizeFile (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transformation/normalize-file.ts:51:24)\n    at normalizeFile.next (<anonymous>)\n    at run (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transformation/index.ts:38:36)\n    at run.next (<anonymous>)\n    at transform (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transform.ts:29:20)\n    at transform.next (<anonymous>)\n    at step (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:261:32)\n    at /home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:273:13\n    at async.call.result.err.err (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:223:11)\n    at cb (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:189:28)\n    at /home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/gensync-utils/async.ts:90:7\n    at /home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:113:33\n    at step (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:287:14)\n    at /home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:273:13\n    at async.call.result.err.err (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:223:11)",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errBabelSolid.ts

@@ -0,0 +1,16 @@
+export const errBabelSolid = {
+  code: "BABEL_PARSE_ERROR",
+  reasonCode: "InvalidLhs",
+  loc: { line: 17, column: 6, index: 455 },
+  pos: 455,
+  plugin: "solid",
+  id: "/home/rom/code/reveal/examples/solid-spa/renderer/_default.page.client.tsx?extractExportNames&lang.tsx",
+  pluginCode:
+    "export { render }\n\nimport { render as renderSolid } from 'solid-js/web'\nimport type { PageContextClient } from './types'\n\n/**\n * A function that disposes previously rendered pages.\n *\n * If the function is not executed, each route change will\n * append a page to the DOM without clearing (disposing)\n * the previous one.\n */\nlet disposePreviousPage: () => void\n\nasync function render(pageContext: PageContextClient) {\n  const { Page } = pageContext\n  if (1 = 1) {}\n  if (disposePreviousPage) {\n    disposePreviousPage()\n  }\n\n  // render the page and save the dispose function of that page\n  disposePreviousPage = renderSolid(() => <Page />, document.getElementById('root.js'))\n}\n",
+  frame:
+    "15 |  async function render(pageContext: PageContextClient) {\n16 |    const { Page } = pageContext\n17 |    if (1 = 1) {}\n   |        ^\n18 |    if (disposePreviousPage) {\n19 |      disposePreviousPage()",
+  message:
+    "/home/rom/code/reveal/examples/solid-spa/renderer/_default.page.client.tsx: Invalid left-hand side in assignment expression. (17:6)\n\n\u001b[0m \u001b[90m 15 |\u001b[39m \u001b[36masync\u001b[39m \u001b[36mfunction\u001b[39m render(pageContext\u001b[33m:\u001b[39m \u001b[33mPageContextClient\u001b[39m) {\u001b[0m\n\u001b[0m \u001b[90m 16 |\u001b[39m   \u001b[36mconst\u001b[39m { \u001b[33mPage\u001b[39m } \u001b[33m=\u001b[39m pageContext\u001b[0m\n\u001b[0m\u001b[31m\u001b[1m>\u001b[22m\u001b[39m\u001b[90m 17 |\u001b[39m   \u001b[36mif\u001b[39m (\u001b[35m1\u001b[39m \u001b[33m=\u001b[39m \u001b[35m1\u001b[39m) {}\u001b[0m\n\u001b[0m \u001b[90m    |\u001b[39m       \u001b[31m\u001b[1m^\u001b[22m\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m 18 |\u001b[39m   \u001b[36mif\u001b[39m (disposePreviousPage) {\u001b[0m\n\u001b[0m \u001b[90m 19 |\u001b[39m     disposePreviousPage()\u001b[0m\n\u001b[0m \u001b[90m 20 |\u001b[39m   }\u001b[0m",
+  stack:
+    "SyntaxError: /home/rom/code/reveal/examples/solid-spa/renderer/_default.page.client.tsx: Invalid left-hand side in assignment expression. (17:6)\n\n\u001b[0m \u001b[90m 15 |\u001b[39m \u001b[36masync\u001b[39m \u001b[36mfunction\u001b[39m render(pageContext\u001b[33m:\u001b[39m \u001b[33mPageContextClient\u001b[39m) {\u001b[0m\n\u001b[0m \u001b[90m 16 |\u001b[39m   \u001b[36mconst\u001b[39m { \u001b[33mPage\u001b[39m } \u001b[33m=\u001b[39m pageContext\u001b[0m\n\u001b[0m\u001b[31m\u001b[1m>\u001b[22m\u001b[39m\u001b[90m 17 |\u001b[39m   \u001b[36mif\u001b[39m (\u001b[35m1\u001b[39m \u001b[33m=\u001b[39m \u001b[35m1\u001b[39m) {}\u001b[0m\n\u001b[0m \u001b[90m    |\u001b[39m       \u001b[31m\u001b[1m^\u001b[22m\u001b[39m\u001b[0m\n\u001b[0m \u001b[90m 18 |\u001b[39m   \u001b[36mif\u001b[39m (disposePreviousPage) {\u001b[0m\n\u001b[0m \u001b[90m 19 |\u001b[39m     disposePreviousPage()\u001b[0m\n\u001b[0m \u001b[90m 20 |\u001b[39m   }\u001b[0m\n    at instantiate (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error/credentials.ts:62:21)\n    at toParseError (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error.ts:60:12)\n    at TypeScriptParserMixin.raise (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/tokenizer/index.ts:1490:19)\n    at TypeScriptParserMixin.checkLVal (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/lval.ts:646:12)\n    at TypeScriptParserMixin.parseMaybeAssign (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:341:12)\n    at TypeScriptParserMixin.parseMaybeAssign (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3429:22)\n    at TypeScriptParserMixin.parseExpressionBase (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:225:23)\n    at callback (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:216:39)\n    at TypeScriptParserMixin.allowInAnd (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:3072:16)\n    at TypeScriptParserMixin.parseExpression (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:216:17)\n    at TypeScriptParserMixin.parseHeaderExpression (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:854:22)\n    at TypeScriptParserMixin.parseIfStatement (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1008:22)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:476:21)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:2887:20)\n    at TypeScriptParserMixin.parseStatementLike (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:417:17)\n    at TypeScriptParserMixin.parseStatementListItem (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:366:17)\n    at TypeScriptParserMixin.parseBlockOrModuleBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1360:16)\n    at TypeScriptParserMixin.parseBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1333:10)\n    at TypeScriptParserMixin.parseBlock (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1301:10)\n    at TypeScriptParserMixin.parseFunctionBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:2552:24)\n    at TypeScriptParserMixin.parseFunctionBodyAndFinish (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:2523:10)\n    at TypeScriptParserMixin.parseFunctionBodyAndFinish (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:2414:20)\n    at callback (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1600:12)\n    at TypeScriptParserMixin.withSmartMixTopicForbiddingContext (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/expression.ts:3051:14)\n    at TypeScriptParserMixin.parseFunction (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1598:10)\n    at TypeScriptParserMixin.parseFunctionStatement (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:997:17)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:613:23)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:2887:20)\n    at TypeScriptParserMixin.parseStatementLike (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:417:17)\n    at TypeScriptParserMixin.parseModuleItem (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:354:17)\n    at TypeScriptParserMixin.parseBlockOrModuleBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1359:16)\n    at TypeScriptParserMixin.parseBlockBody (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1333:10)\n    at TypeScriptParserMixin.parseProgram (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:226:10)\n    at TypeScriptParserMixin.parseTopLevel (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:208:25)\n    at TypeScriptParserMixin.parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/index.ts:45:10)\n    at TypeScriptParserMixin.parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3997:20)\n    at parse (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/index.ts:67:38)\n    at parser (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/parser/index.ts:28:19)\n    at parser.next (<anonymous>)\n    at normalizeFile (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transformation/normalize-file.ts:51:24)\n    at normalizeFile.next (<anonymous>)\n    at run (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transformation/index.ts:38:36)\n    at run.next (<anonymous>)\n    at transform (/home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/transform.ts:29:20)\n    at transform.next (<anonymous>)\n    at step (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:261:32)\n    at /home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:273:13\n    at async.call.result.err.err (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:223:11)\n    at cb (/home/rom/code/reveal/node_modules/.pnpm/gensync@1.0.0-beta.2/node_modules/gensync/index.js:189:28)\n    at /home/rom/code/reveal/node_modules/.pnpm/@babel+core@7.21.8/node_modules/@babel/core/src/gensync-utils/async.ts:90:7",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errEsbuild.ts

@@ -0,0 +1,39 @@
+export const errEsbuild = {
+  errors: [
+    {
+      id: "",
+      location: {
+        column: 20,
+        file: "/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx",
+        length: 1,
+        line: 7,
+        lineText: "export { Layout }}",
+        namespace: "",
+        suggestion: "",
+      },
+      notes: [],
+      pluginName: "",
+      text: 'Unexpected "}"',
+    },
+  ],
+  warnings: [],
+  frame:
+    "\n\u001b[33mUnexpected \"}\"\u001b[39m\n5  |  import type { PageContext } from './types'\n6  |  \n7  |  export { Layout }}\n   |                      ^\n8  |  \n9  |  function Layout({ pageContext, children }: { pageContext: PageContext; children: React.ReactNode }) {\n",
+  loc: {
+    column: 20,
+    file: "/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx",
+    length: 1,
+    line: 7,
+    lineText: "export { Layout }}",
+    namespace: "",
+    suggestion: "",
+  },
+  plugin: "vite:esbuild",
+  id: "/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx",
+  pluginCode:
+    "import React from 'react'\nimport logoUrl from './logo.svg'\nimport { PageContextProvider } from './usePageContext'\nimport { Link } from './Link'\nimport type { PageContext } from './types'\n\nexport { Layout }}\n\nfunction Layout({ pageContext, children }: { pageContext: PageContext; children: React.ReactNode }) {\n  return (\n    <React.StrictMode>\n      <PageContextProvider pageContext={pageContext}>\n        <Layout>\n          <Sidebar>\n            <Logo />\n            <Link href=\"/\">Welcome</Link>\n            <Link href=\"/markdown\">Markdown</Link>\n            <Link href=\"/star-wars\">Data Fetching</Link>\n            <Link href=\"/hello\">Routing</Link>\n          </Sidebar>\n          <Content>{children}</Content>\n        </Layout>\n      </PageContextProvider>\n    </React.StrictMode>\n  )\n}\n\nfunction Layout({ children }: { children: React.ReactNode }) {\n  return (\n    <div\n      style={{\n        display: 'flex',\n        maxWidth: 900,\n        margin: 'auto'\n      }}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction Sidebar({ children }: { children: React.ReactNode }) {\n  return (\n    <div\n      id=\"sidebar\"\n      style={{\n        padding: 20,\n        flexShrink: 0,\n        display: 'flex',\n        flexDirection: 'column',\n        lineHeight: '1.8em',\n        borderRight: '2px solid #eee'\n      }}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction Content({ children }: { children: React.ReactNode }) {\n  return (\n    <div id=\"page-container\">\n      <div\n        id=\"page-content\"\n        style={{\n          padding: 20,\n          paddingBottom: 50,\n          minHeight: '100vh.js'\n        }}\n      >\n        {children}\n      </div>\n    </div>\n  )\n}\n\nfunction Logo() {\n  return (\n    <div\n      style={{\n        marginTop: 20,\n        marginBottom: 10\n      }}\n    >\n      <a href=\"/\">\n        <img src={logoUrl} height={64} width={64} />\n      </a>\n    </div>\n  )\n}\n",
+  message:
+    'Transform failed with 1 error:\n/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx:7:20: ERROR: Unexpected "}"',
+  stack:
+    'Error: Transform failed with 1 error:\n/home/rom/code/reveal/examples/react-full/renderer/Layout.tsx:7:20: ERROR: Unexpected "}"\n    at failureErrorWithLog (/home/rom/code/reveal/node_modules/.pnpm/esbuild@0.17.18/node_modules/esbuild/lib/main.js:1636:15)\n    at /home/rom/code/reveal/node_modules/.pnpm/esbuild@0.17.18/node_modules/esbuild/lib/main.js:837:29\n    at responseCallbacks.<computed> (/home/rom/code/reveal/node_modules/.pnpm/esbuild@0.17.18/node_modules/esbuild/lib/main.js:697:9)\n    at handleIncomingPacket (/home/rom/code/reveal/node_modules/.pnpm/esbuild@0.17.18/node_modules/esbuild/lib/main.js:752:9)\n    at Socket.readFromStdout (/home/rom/code/reveal/node_modules/.pnpm/esbuild@0.17.18/node_modules/esbuild/lib/main.js:673:7)\n    at Socket.emit (node:events:513:28)\n    at addChunk (node:internal/streams/readable:324:12)\n    at readableAddChunk (node:internal/streams/readable:297:9)\n    at Socket.Readable.push (node:internal/streams/readable:234:10)\n    at Pipe.onStreamRead (node:internal/stream_base_commons:190:23)',
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errMdx1.ts

@@ -0,0 +1,24 @@
+export const errMdx1 = {
+  name: "5:5-5:6",
+  message: "Unexpected closing slash `/` in tag, expected an open tag first",
+  reason: "Unexpected closing slash `/` in tag, expected an open tag first",
+  line: 5,
+  column: 5,
+  position: {
+    start: { line: 5, column: 5, offset: 109, _index: 6, _bufferIndex: 4 },
+    end: { line: 5, column: 6, offset: 110, _index: 6, _bufferIndex: 5 },
+  },
+  source: "mdast-util-mdx-jsx",
+  ruleId: "unexpected-closing-slash",
+  plugin: "@mdx-js/rollup",
+  id: "/home/rom/code/reveal/docs/pages/dynamic-import.page.server.mdx",
+  pluginCode:
+    "import { Link, Note } from '@brillout/docpress'\n\nPage moved to <Link href=\"/ClientOnly\" />.\n\n   </Note>\n\n\nexport const headings = [];\n",
+  loc: {
+    file: "/home/rom/code/reveal/docs/pages/dynamic-import.page.server.mdx",
+    start: { line: 5, column: 5, offset: 109, _index: 6, _bufferIndex: 4 },
+    end: { line: 5, column: 6, offset: 110, _index: 6, _bufferIndex: 5 },
+  },
+  frame: "",
+  stack: "",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errMdx2.ts

@@ -0,0 +1,83 @@
+export const errMdx2 = {
+  reason: "Unexpected closing slash `/` in tag, expected an open tag first",
+  line: 23,
+  column: 450,
+  position: {
+    start: {
+      line: 23,
+      column: 450,
+      offset: 1967,
+      _index: 0,
+      _bufferIndex: 444,
+    },
+    end: {
+      line: 23,
+      column: 451,
+      offset: 1968,
+      _index: 0,
+      _bufferIndex: 445,
+    },
+  },
+  source: "mdast-util-mdx-jsx",
+  ruleId: "unexpected-closing-slash",
+  plugin: "@mdx-js/rollup",
+  id: "/home/rom/code/reveal/docs/pages/abort/+Page.mdx",
+  pluginCode:
+    "import { Link } from '@brillout/docpress'\n" +
+    "\n" +
+    'By using <Link href="/render" text={<code>throw render()</code>}></Link> or <Link href="/redirect" text={<code>throw redirect()</code>}></Link> you abort the rendering of the current page and render something else instead.\n' +
+    "\n" +
+    `<h2 id="throw-redirect-vs-throw-render"><code>{'throw redirect()'}</code>{' VS '}<code>{'throw render()'}</code></h2>\n` +
+    "\n" +
+    "While `throw redirect()` changes the URL, `throw render()` preserves it:\n" +
+    " - If a user goes to `/admin` and `throw redirect('/login')` is called, then the user will see the new URL `/login` in the browser's address bar.\n" +
+    " - If a user goes to `/admin` and `throw render('/login')` is called, then the user keeps seeing the same URL `/admin` in the browser's address bar.\n" +
+    "\n" +
+    "In general, we recommend using `throw render('/login')` instead of `throw redirect('/login')` as it preserves the URL and, therefore, the user's intention. We further explain this techniue at <Link href=\"/auth#login-flow\" />.\n" +
+    "\n" +
+    "\n" +
+    `<h2 id="debug">{'Debug'}</h2>\n` +
+    "\n" +
+    "If `throw redirect()` or `throw render()` doesn't work:\n" +
+    " - **Make sure `throw redirect()` / `throw render()` isn't intercepted.**  \n" +
+    "   In developement, check your server logs for the following log. If this log is missing then it means that reveal didn't catch the `throw redirect()` / `throw render()` exception: some other code is intercepting it preventing reveal from catching it.\n" +
+    "   ```\n" +
+    "   10:00:00 AM [reveal][request(42)] throw redirect('/some-url') intercepted while\n" +
+    "   rendering /some-other-url\n" +
+    "   ```\n" +
+    '   > Most notably, using `throw redirect()` / `throw render()` inside a UI component usually doesn\'t work because most <Link href="/ui-framework">UI framework</Link> will intercept the execption and thus reveal won\'t be able to catch it. Instead, consider using `throw redirect()` / `throw render()` in a reveal hook such as <Link href="/guard">guard()</Link> or <Link href="/data">data()</Link>, or consider using <Link href="/navigate" />`navigate()`</Link>.\n' +
+    " - **Make sure to use `throw redirect()` / `throw render()` within a reveal hook.**  \n" +
+    "   If you use `throw redirect()` / `throw render()` outside of reveal hooks, for example in some server middleware code then reveal won't be able to intercept it.\n" +
+    "\n" +
+    "If `throw redirect()` doesn't work:\n" +
+    " - **Make sure to add `pageContext.httpResponse.headers` to the HTTP response.**  \n" +
+    "   If you've embedded reveal into your server using <Link text={<code>renderPage()</code>} href=\"/renderPage\" />, then insepct whether `pageContext.httpResponse.headers` contains the `Location` header and double check that you're correctly adding all the headers defined by `pageContext.httpResponse.headers` to the HTTP response.\n" +
+    "\n" +
+    "\n" +
+    `<h2 id="see-also">{'See also'}</h2>\n` +
+    "\n" +
+    ' - <Link href="/redirect" />\n' +
+    ' - <Link href="/render" />\n' +
+    ' - <Link href="/navigate" />\n' +
+    "\n" +
+    "\n" +
+    'export const headings = [{"headingId":"throw-redirect-vs-throw-render","headingLevel":2,"title":"`throw redirect()` VS `throw render()`"}, {"headingId":"debug","headingLevel":2,"title":"Debug"}, {"headingId":"see-also","headingLevel":2,"title":"See also"}];\n',
+  loc: {
+    file: "/home/rom/code/reveal/docs/pages/abort/+Page.mdx",
+    start: {
+      line: 23,
+      column: 450,
+      offset: 1967,
+      _index: 0,
+      _bufferIndex: 444,
+    },
+    end: {
+      line: 23,
+      column: 451,
+      offset: 1968,
+      _index: 0,
+      _bufferIndex: 445,
+    },
+  },
+  frame: "",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errPostcss.ts

@@ -0,0 +1,33 @@
+export const errPostcss = {
+  name: "CssSyntaxError",
+  reason: "Unexpected }",
+  file: "/home/rom/code/reveal/examples/react-full/renderer/css/links.css",
+  source:
+    "a {\n  text-decoration: none;\n}}\n#sidebar a {\n  padding: 2px 10px;\n  margin-left: -10px;\n}\n#sidebar a.is-active {\n  background-color: #eee;\n}\n",
+  line: 3,
+  column: 2,
+  endLine: 3,
+  endColumn: 3,
+  input: {
+    line: 3,
+    column: 2,
+    endLine: 3,
+    endColumn: 3,
+    source:
+      "a {\n  text-decoration: none;\n}}\n#sidebar a {\n  padding: 2px 10px;\n  margin-left: -10px;\n}\n#sidebar a.is-active {\n  background-color: #eee;\n}\n",
+    url: "file:///home/rom/code/reveal/examples/react-full/renderer/css/links.css",
+    file: "/home/rom/code/reveal/examples/react-full/renderer/css/links.css",
+  },
+  plugin: "vite:css",
+  code: "@import './reset.css';\n@import './links.css';\n@import './code.css';\n@import './page-transition-loading-animation.css';\n",
+  loc: { column: 2, line: 3 },
+  id: "/home/rom/code/reveal/examples/react-full/renderer/css/links.css",
+  pluginCode:
+    "@import './reset.css';\n@import './links.css';\n@import './code.css';\n@import './page-transition-loading-animation.css';\n",
+  frame:
+    "1  |  @import './reset.css';\n2  |  @import './links.css';\n3  |  @import './code.css';\n   |    ^\n4  |  @import './page-transition-loading-animation.css';\n5  |  ",
+  message:
+    "[postcss] postcss-import: /home/rom/code/reveal/examples/react-full/renderer/css/links.css:3:2: Unexpected }",
+  stack:
+    "CssSyntaxError: [postcss] postcss-import: /home/rom/code/reveal/examples/react-full/renderer/css/links.css:3:2: Unexpected }\n    at Input.error (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/input.js:148:16)\n    at Parser.unexpectedClose (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:548:22)\n    at Parser.end (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:379:12)\n    at Parser.parse (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:56:16)\n    at parse (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parse.js:11:12)\n    at new LazyResult (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/lazy-result.js:133:16)\n    at Processor.process (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/processor.js:28:14)\n    at runPostcss (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-5673ffe5.js:287:6)\n    at processContent (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-5673ffe5.js:281:10)\n    at file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-5673ffe5.js:867:20\n    at async Promise.allSettled (index 0)\n    at LazyResult.runAsync (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/lazy-result.js:396:11)\n    at compileCSS (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-934dbc7c.js:38483:25)\n    at TransformContext.transform (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-934dbc7c.js:37919:56)\n    at Object.transform (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-934dbc7c.js:42884:30)\n    at loadAndTransform (file:///home/rom/code/reveal/node_modules/.pnpm/vite@4.3.5_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-934dbc7c.js:53350:29)",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errSwc.ts

@@ -0,0 +1,20 @@
+export const errSwc = {
+  stack:
+    "Error: \n  \u001b[38;2;255;30;30m×\u001b[0m Expected ';', '}' or <eof>\n   ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/hello/+Page.tsx\u001b[0m:1:1]\n \u001b[2m1\u001b[0m │ export default Page\n \u001b[2m2\u001b[0m │ \n \u001b[2m3\u001b[0m │ impeort React from 'react'\n   · \u001b[38;2;246;87;248m───┬───\u001b[0m\u001b[38;2;30;201;212m ─────\u001b[0m\n   ·    \u001b[38;2;246;87;248m╰── \u001b[38;2;246;87;248mThis is the expression part of an expression statement\u001b[0m\u001b[0m\n \u001b[2m4\u001b[0m │ \n \u001b[2m5\u001b[0m │ function Page({ name }: { name: string }) {\n \u001b[2m6\u001b[0m │   return (\n   ╰────\n\n\nCaused by:\n    Syntax Error",
+  code: "GenericFailure",
+  line: "1",
+  column: "1",
+  plugin: "vite:react-swc",
+  id: "/home/rom/code/reveal/examples/react-full/pages/hello/+Page.tsx",
+  pluginCode:
+    'export default Page\n\nimpeort React from \'react\'\n\nfunction Page({ name }: { name: string }) {\n  return (\n    <>\n      <h1>Hello</h1>\n      <p>\n        Hi <b>{name}</b>.\n      </p>\n      <ul>\n        <li>\n          <a href="/hello/eli">/hello/eli</a>\n        </li>\n        <li>\n          <a href="/hello/jon">/hello/jon</a>\n        </li>\n      </ul>\n      <p>\n        Parameterized routes can be defined by exporting a route string in <code>*.page.route.js</code>.\n      </p>\n    </>\n  )\n}\n',
+  loc: {
+    file: "/home/rom/code/reveal/examples/react-full/pages/hello/+Page.tsx",
+    line: "1",
+    column: "1",
+  },
+  frame:
+    "1  |  /home/rom/code/reveal/examples/react-full/pages/hello/+Page.tsx\n   |   ^",
+  message:
+    "\n  \u001b[38;2;255;30;30m×\u001b[0m Expected ';', '}' or <eof>\n   ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/hello/+Page.tsx\u001b[0m:1:1]\n \u001b[2m1\u001b[0m │ export default Page\n \u001b[2m2\u001b[0m │ \n \u001b[2m3\u001b[0m │ impeort React from 'react'\n   · \u001b[38;2;246;87;248m───┬───\u001b[0m\u001b[38;2;30;201;212m ─────\u001b[0m\n   ·    \u001b[38;2;246;87;248m╰── \u001b[38;2;246;87;248mThis is the expression part of an expression statement\u001b[0m\u001b[0m\n \u001b[2m4\u001b[0m │ \n \u001b[2m5\u001b[0m │ function Page({ name }: { name: string }) {\n \u001b[2m6\u001b[0m │   return (\n   ╰────\n\n\nCaused by:\n    Syntax Error",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errSwcBig.ts

@@ -0,0 +1,19 @@
+export const errSwcBig = {
+  code: "GenericFailure",
+  line: "6",
+  column: "1",
+  plugin: "vite:react-swc",
+  id: "/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx",
+  pluginCode:
+    "export default Page\n\nimport React from 'react'\nimport { navigate } from 'reveal/client/router'\nimport { Counter } from '../../components/Counter'\n\nfunction Page() {\n  return (\n    <>\n      <h1>\n        Welcome to reveal\n      <h1>\n      This page is:\n      <ul>\n        <li>Rendered to HTML.</li>\n        <li>\n          Interactive. <Counter />\n        </li>\n      </ul>\n      <p>\n        <button\n          onClick={() => {\n            const randomIndex = Math.floor(Math.random() * 3)\n            navigate(['/markdown', '/star-wars', '/hello/alice.js'][randomIndex])\n          }}\n        >\n          Random Page\n        </button>\n      </p>\n    </>\n  )\n}\n",
+  loc: {
+    file: "/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx",
+    line: "6",
+    column: "1",
+  },
+  frame: "",
+  message:
+    "\n  \u001b[38;2;255;30;30m×\u001b[0m Expression expected\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:6:1]\n \u001b[2m 6\u001b[0m │ \n \u001b[2m 7\u001b[0m │ function Page() {\n \u001b[2m 8\u001b[0m │   return (\n \u001b[2m 9\u001b[0m │     <>\n    · \u001b[38;2;246;87;248m     ─\u001b[0m\n \u001b[2m10\u001b[0m │       <h1>\n \u001b[2m11\u001b[0m │         Welcome to reveal\n \u001b[2m12\u001b[0m │       <h1>\n    ╰────\n\n  \u001b[38;2;255;30;30m×\u001b[0m Unexpected token. Did you mean `{'}'}` or `&rbrace;`?\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:29:1]\n \u001b[2m29\u001b[0m │       </p>\n \u001b[2m30\u001b[0m │     </>\n \u001b[2m31\u001b[0m │   )\n \u001b[2m32\u001b[0m │ }\n    · \u001b[38;2;246;87;248m▲\u001b[0m\n    ╰────\n\n  \u001b[38;2;255;30;30m×\u001b[0m Unterminated JSX contents\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:27:1]\n \u001b[2m27\u001b[0m │               Random Page\n \u001b[2m28\u001b[0m │             </button>\n \u001b[2m29\u001b[0m │           </p>\n \u001b[2m30\u001b[0m │ \u001b[38;2;246;87;248m╭\u001b[0m\u001b[38;2;246;87;248m─\u001b[0m\u001b[38;2;246;87;248m▶\u001b[0m     </>\n \u001b[2m31\u001b[0m │ \u001b[38;2;246;87;248m│\u001b[0m     )\n \u001b[2m32\u001b[0m │ \u001b[38;2;246;87;248m╰\u001b[0m\u001b[38;2;246;87;248m─\u001b[0m\u001b[38;2;246;87;248m▶\u001b[0m }\n    ╰────\n\n\nCaused by:\n    Syntax Error",
+  stack:
+    "Error: \n  \u001b[38;2;255;30;30m×\u001b[0m Expression expected\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:6:1]\n \u001b[2m 6\u001b[0m │ \n \u001b[2m 7\u001b[0m │ function Page() {\n \u001b[2m 8\u001b[0m │   return (\n \u001b[2m 9\u001b[0m │     <>\n    · \u001b[38;2;246;87;248m     ─\u001b[0m\n \u001b[2m10\u001b[0m │       <h1>\n \u001b[2m11\u001b[0m │         Welcome to reveal\n \u001b[2m12\u001b[0m │       <h1>\n    ╰────\n\n  \u001b[38;2;255;30;30m×\u001b[0m Unexpected token. Did you mean `{'}'}` or `&rbrace;`?\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:29:1]\n \u001b[2m29\u001b[0m │       </p>\n \u001b[2m30\u001b[0m │     </>\n \u001b[2m31\u001b[0m │   )\n \u001b[2m32\u001b[0m │ }\n    · \u001b[38;2;246;87;248m▲\u001b[0m\n    ╰────\n\n  \u001b[38;2;255;30;30m×\u001b[0m Unterminated JSX contents\n    ╭─[\u001b[38;2;92;157;255;1;4m/home/rom/code/reveal/examples/react-full/pages/index/+Page.tsx\u001b[0m:27:1]\n \u001b[2m27\u001b[0m │               Random Page\n \u001b[2m28\u001b[0m │             </button>\n \u001b[2m29\u001b[0m │           </p>\n \u001b[2m30\u001b[0m │ \u001b[38;2;246;87;248m╭\u001b[0m\u001b[38;2;246;87;248m─\u001b[0m\u001b[38;2;246;87;248m▶\u001b[0m     </>\n \u001b[2m31\u001b[0m │ \u001b[38;2;246;87;248m│\u001b[0m     )\n \u001b[2m32\u001b[0m │ \u001b[38;2;246;87;248m╰\u001b[0m\u001b[38;2;246;87;248m─\u001b[0m\u001b[38;2;246;87;248m▶\u001b[0m }\n    ╰────\n\n\nCaused by:\n    Syntax Error",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errVueCss.ts

@@ -0,0 +1,36 @@
+export const errVueCss = {
+  name: "CssSyntaxError",
+  reason: "Unexpected }",
+  file: "/home/rom/code/reveal/examples/vue-full/renderer/Layout.vue",
+  source:
+    "\n.layout {\n  display: flex;\n  max-width: 900px;\n  margin: auto;\n}}\n.content {\n  padding: 20px;\n  padding-bottom: 50px;\n  min-height: 100vh;\n}\n.navigation {\n  padding: 20px;\n  flex-shrink: 0;\n  display: flex;\n  flex-direction: column;\n  line-height: 1.8em;\n  border-right: 2px solid #eee;\n}\n.logo {\n  margin-top: 20px;\n  margin-bottom: 10px;\n}\n.content {\n  transition: opacity 0.1s ease-in;\n}\n.content.page-transition {\n  opacity: 0;\n}\n",
+  line: 6,
+  column: 2,
+  endLine: 6,
+  endColumn: 3,
+  input: {
+    line: 6,
+    column: 2,
+    endLine: 6,
+    endColumn: 3,
+    source:
+      "\n.layout {\n  display: flex;\n  max-width: 900px;\n  margin: auto;\n}}\n.content {\n  padding: 20px;\n  padding-bottom: 50px;\n  min-height: 100vh;\n}\n.navigation {\n  padding: 20px;\n  flex-shrink: 0;\n  display: flex;\n  flex-direction: column;\n  line-height: 1.8em;\n  border-right: 2px solid #eee;\n}\n.logo {\n  margin-top: 20px;\n  margin-bottom: 10px;\n}\n.content {\n  transition: opacity 0.1s ease-in;\n}\n.content.page-transition {\n  opacity: 0;\n}\n",
+    url: "file:///home/rom/code/reveal/examples/vue-full/renderer/Layout.vue",
+    file: "/home/rom/code/reveal/examples/vue-full/renderer/Layout.vue",
+  },
+  loc: {
+    file: "/home/rom/code/reveal/examples/vue-full/renderer/Layout.vue",
+    line: 45,
+    column: 2,
+  },
+  id: "/home/rom/code/reveal/examples/vue-full/renderer/Layout.vue",
+  plugin: "vite:vue",
+  pluginCode:
+    "\n.layout {\n  display: flex;\n  max-width: 900px;\n  margin: auto;\n}}\n.content {\n  padding: 20px;\n  padding-bottom: 50px;\n  min-height: 100vh;\n}\n.navigation {\n  padding: 20px;\n  flex-shrink: 0;\n  display: flex;\n  flex-direction: column;\n  line-height: 1.8em;\n  border-right: 2px solid #eee;\n}\n.logo {\n  margin-top: 20px;\n  margin-bottom: 10px;\n}\n.content {\n  transition: opacity 0.1s ease-in;\n}\n.content.page-transition {\n  opacity: 0;\n}\n",
+  frame:
+    "43 |    margin: auto;\n44 |  }}\n45 |  .content {\n   |    ^\n46 |    padding: 20px;\n47 |    padding-bottom: 50px;",
+  message:
+    "/home/rom/code/reveal/examples/vue-full/renderer/Layout.vue:6:2: Unexpected }",
+  stack:
+    "CssSyntaxError: /home/rom/code/reveal/examples/vue-full/renderer/Layout.vue:6:2: Unexpected }\n    at Input.error (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/input.js:148:16)\n    at Parser.unexpectedClose (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:548:22)\n    at Parser.end (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:379:12)\n    at Parser.parse (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parser.js:56:16)\n    at parse (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/parse.js:11:12)\n    at new LazyResult (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/lazy-result.js:133:16)\n    at Processor.process (/home/rom/code/reveal/node_modules/.pnpm/postcss@8.4.23/node_modules/postcss/lib/processor.js:28:14)\n    at doCompileStyle (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-sfc@3.2.33/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:17246:45)\n    at Object.compileStyleAsync (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-sfc@3.2.33/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:17188:12)\n    at transformStyle (/home/rom/code/reveal/node_modules/.pnpm/@vitejs+plugin-vue@4.2.1_vite@4.3.5_vue@3.2.33/node_modules/@vitejs/plugin-vue/dist/index.cjs:2622:41)",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errVueHtml.ts

@@ -0,0 +1,17 @@
+export const errVueHtml = {
+  id: "/home/rom/code/reveal/examples/vue-full/pages/index/+Page.vue",
+  plugin: "vite:vue",
+  message: "Element is missing end tag.",
+  name: "SyntaxError",
+  stack:
+    "SyntaxError: Element is missing end tag.\n    at createCompilerError (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:19:19)\n    at emitError (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:1594:29)\n    at parseElement (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:1146:9)\n    at parseChildren (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:937:28)\n    at parseElement (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:1125:22)\n    at parseChildren (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:937:28)\n    at parseElement (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:1125:22)\n    at parseChildren (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:937:28)\n    at Object.baseParse (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-core@3.2.33/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js:852:23)\n    at Object.parse (/home/rom/code/reveal/node_modules/.pnpm/@vue+compiler-dom@3.2.33/node_modules/@vue/compiler-dom/dist/compiler-dom.cjs.js:3077:25)",
+  loc: {
+    file: "/home/rom/code/reveal/examples/vue-full/pages/index/+Page.vue",
+    line: 2,
+    column: 46,
+  },
+  pluginCode:
+    "<template>\n  <h1>Welcome to reveal<h1>\n  This page is:\n  <ul>\n    <li>Rendered to HTML.</li>\n    <li>Interactive. <Counter /></li>\n  </ul>\n  <p>\n    <button @click=\"randomNavigation\">Random Page</button>\n  </p>\n</template>\n\n<script lang=\"ts\" setup>\nimport Counter from '../../components/Counter.vue'\nimport { navigate } from 'reveal/client/router'\n\nconst randomNavigation = () => {\n  const randomIndex = Math.floor(Math.random() * 3)\n  navigate(['/markdown', '/star-wars', '/hello/alice.js'][randomIndex])\n}\n</script>\n",
+  frame:
+    "1  |  <template>\n2  |    <h1>Welcome to reveal<h1>\n   |                                                ^\n3  |    This page is:\n4  |    <ul>",
+}

package/dist/core/gaurds/logger/loggerNotProd/errorWithCodeSnippet/fixture-errors/errVueJavascript.ts

@@ -0,0 +1,16 @@
+export const errVueJavascript = {
+  code: "BABEL_PARSER_SYNTAX_ERROR",
+  reasonCode: "MissingSemicolon",
+  loc: { line: 2, column: 7, index: 8 },
+  pos: 8,
+  plugin: "vite:vue",
+  id: "/home/rom/code/reveal/examples/vue-full/pages/index/+Page.vue",
+  pluginCode:
+    "<template>\n  <h1>Welcome to reveal</h1>\n  This page is:\n  <ul>\n    <li>Rendered to HTML.</li>\n    <li>Interactive. <Counter /></li>\n  </ul>\n  <p>\n    <button @click=\"randomNavigation\">Random Page</button>\n  </p>\n</template>\n\n<script lang=\"ts\" setup>\nimeport Counter from '../../components/Counter.vue'\nimport { navigate } from 'reveal/client/router'\n\nconst randomNavigation = () => {\n  const randomIndex = Math.floor(Math.random() * 3)\n  navigate(['/markdown', '/star-wars', '/hello/alice.js'][randomIndex])\n}\n</script>\n",
+  frame:
+    "1  |  <template>\n   |          ^\n2  |    <h1>Welcome to reveal</h1>\n3  |    This page is:",
+  message:
+    "[@vue/compiler-sfc] Missing semicolon. (2:7)\n\n/home/rom/code/reveal/examples/vue-full/pages/index/+Page.vue\n12 |  \n13 |  <script lang=\"ts\" setup>\n14 |  imeport Counter from '../../components/Counter.vue'\n   |         ^\n15 |  import { navigate } from 'reveal/client/router.js'\n16 |  ",
+  stack:
+    "SyntaxError: [@vue/compiler-sfc] Missing semicolon. (2:7)\n\n/home/rom/code/reveal/examples/vue-full/pages/index/+Page.vue\n12 |  \n13 |  <script lang=\"ts\" setup>\n14 |  imeport Counter from '../../components/Counter.vue'\n   |         ^\n15 |  import { navigate } from 'reveal/client/router.js'\n16 |  \n    at instantiate (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error/credentials.ts:62:21)\n    at toParseError (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parse-error.ts:60:12)\n    at TypeScriptParserMixin.raise (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/tokenizer/index.ts:1490:19)\n    at TypeScriptParserMixin.semicolon (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/util.ts:138:10)\n    at TypeScriptParserMixin.parseExpressionStatement (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:1279:10)\n    at TypeScriptParserMixin.parseExpressionStatement (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:3044:28)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:643:19)\n    at TypeScriptParserMixin.parseStatementContent (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/plugins/typescript/index.ts:2887:20)\n    at TypeScriptParserMixin.parseStatementLike (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:417:17)\n    at TypeScriptParserMixin.parseModuleItem (/home/rom/code/reveal/node_modules/.pnpm/@babel+parser@7.21.8/node_modules/@babel/parser/src/parser/statement.ts:354:17)",
+}