js-compute-runtime icon indicating copy to clipboard operation
js-compute-runtime copied to clipboard
verified publisher icon fastly

Fix some build issues in docs

Open harmony7 opened this issue 2 months ago • 0 comments

This PR fixes the following errors that show up in docusaurus builds.

Click for details 

npm error code EUSAGE
npm error
npm error The `npm ci` command can only install with an existing package-lock.json or
npm error npm-shrinkwrap.json with lockfileVersion >= 1. Run an install with npm@5 or
npm error later to generate a package-lock.json file, then try again.
npm error
npm error Clean install a project
npm error
npm error Usage:
npm error npm ci
npm error
npm error Options:
npm error [--install-strategy <hoisted|nested|shallow|linked>] [--legacy-bundling]
npm error [--global-style] [--omit <dev|optional|peer> [--omit <dev|optional|peer> ...]]
npm error [--include <prod|dev|optional|peer> [--include <prod|dev|optional|peer> ...]]
npm error [--strict-peer-deps] [--foreground-scripts] [--ignore-scripts] [--no-audit]
npm error [--no-bin-links] [--no-fund] [--dry-run]
npm error [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
npm error [-ws|--workspaces] [--include-workspace-root] [--install-links]
npm error
npm error aliases: clean-install, ic, install-clean, isntall-clean
npm error
npm error Run "npm help ci" for more info

[ERROR] Client bundle compiled with errors therefore further build is impossible.
Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/fastly:experimental/allowDynamicBackends.mdx"
Cause: Unexpected character `/` (U+002F) before local name, expected a character that can start a name, such as a letter, `$`, or `_` (note: to create a link in MDX, use `[text](url)`)
Details:
{
  "column": 96,
  "file": "",
  "message": "Unexpected character `/` (U+002F) before local name, expected a character that can start a name, such as a letter, `$`, or `_` (note: to create a link in MDX, use `[text](url)`)",
  "line": 50,
  "name": "50:96",
  "place": {
    "_bufferIndex": 95,
    "_index": 0,
    "line": 50,
    "column": 96,
    "offset": 2394
  },
  "reason": "Unexpected character `/` (U+002F) before local name, expected a character that can start a name, such as a letter, `$`, or `_` (note: to create a link in MDX, use `[text](url)`)",
  "ruleId": "unexpected-character",
  "source": "micromark-extension-mdx-jsx",
  "url": "https://github.com/micromark/micromark-extension-mdx-jsx#unexpected-character-at-expected-expect"
}

--------------------------

Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/globals/Math/asin.mdx"
Cause: Could not parse expression with acorn
Details:
{
  "cause": {
    "pos": 508,
    "loc": {
      "line": 24,
      "column": 153
    },
    "raisedAt": 1
  },
  "column": 154,
  "file": "",
  "message": "Could not parse expression with acorn",
  "line": 24,
  "name": "24:154",
  "place": {
    "line": 24,
    "column": 154,
    "offset": 508
  },
  "reason": "Could not parse expression with acorn",
  "ruleId": "acorn",
  "source": "micromark-extension-mdx-expression",
  "url": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn"
}

--------------------------

Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/globals/Math/atan.mdx"
Cause: Could not parse expression with acorn
Details:
{
  "cause": {
    "pos": 449,
    "loc": {
      "line": 24,
      "column": 156
    },
    "raisedAt": 1
  },
  "column": 157,
  "file": "",
  "message": "Could not parse expression with acorn",
  "line": 24,
  "name": "24:157",
  "place": {
    "line": 24,
    "column": 157,
    "offset": 449
  },
  "reason": "Could not parse expression with acorn",
  "ruleId": "acorn",
  "source": "micromark-extension-mdx-expression",
  "url": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn"
}

--------------------------

Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/globals/Math/atan2.mdx"
Cause: Could not parse expression with acorn
Details:
{
  "cause": {
    "pos": 2391,
    "loc": {
      "line": 49,
      "column": 226
    },
    "raisedAt": 1
  },
  "column": 227,
  "file": "",
  "message": "Could not parse expression with acorn",
  "line": 49,
  "name": "49:227",
  "place": {
    "line": 49,
    "column": 227,
    "offset": 2391
  },
  "reason": "Could not parse expression with acorn",
  "ruleId": "acorn",
  "source": "micromark-extension-mdx-expression",
  "url": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn"
}

--------------------------

Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/globals/Math/expm1.mdx"
Cause: Could not parse expression with acorn
Details:
{
  "cause": {
    "pos": 1324,
    "loc": {
      "line": 30,
      "column": 601
    },
    "raisedAt": 3
  },
  "column": 602,
  "file": "",
  "message": "Could not parse expression with acorn",
  "line": 30,
  "name": "30:602",
  "place": {
    "line": 30,
    "column": 602,
    "offset": 1324
  },
  "reason": "Could not parse expression with acorn",
  "ruleId": "acorn",
  "source": "micromark-extension-mdx-expression",
  "url": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn"
}

--------------------------

Error: MDX compilation failed for file "/Users/harmony7/Developer/fastly/customer-dev-tools/js-compute-runtime/documentation/versioned_docs/version-3.36.0/globals/Math/log1p.mdx"
Cause: Could not parse expression with acorn
Details:
{
  "cause": {
    "pos": 1318,
    "loc": {
      "line": 30,
      "column": 495
    },
    "raisedAt": 3
  },
  "column": 496,
  "file": "",
  "message": "Could not parse expression with acorn",
  "line": 30,
  "name": "30:496",
  "place": {
    "line": 30,
    "column": 496,
    "offset": 1318
  },
  "reason": "Could not parse expression with acorn",
  "ruleId": "acorn",
  "source": "micromark-extension-mdx-expression",
  "url": "https://github.com/micromark/micromark-extension-mdx-expression/tree/main/packages/micromark-extension-mdx-expression#could-not-parse-expression-with-acorn"
}

Fixes:

  • package-lock.json had incorrect syntax - so the whole package-lock.json file was being rejected as invalid
    • I'm guessing this might have resulted from a bad merge
  • Unexpected character / (U+002F) before local name
    • This is fixed by replacing <https://www.fastly.com/> (appears to be an incorrectly written link) with [https://www.fastly.com/](https://www.fastly.com/).
  • Could not parse expression with acorn
    • This is fixed by wrapping <annotation encoding="TeX"> bodies with String.raw

harmony7 avatar Dec 01 '25 09:12 harmony7