[pull] master from nodeca:master

package.json

@@ -61,11 +61,11 @@
     "spec:update": "node support/get-yaml-test-suite.mjs update",
     "coverage": "npm run build && npm run spec:get && c8 --include 'dist/js-yaml.mjs' --include 'src/**' -r text -r html -r lcov node --test 'test/core/**/*.test.mjs' 'test/spec/*.test.mjs'",
     "build": "node support/build-dist.mjs",
-    "build:demo": "npm run lint && node support/build_demo.mjs",
-    "gh-demo": "npm run build:demo && gh-pages -d demo -f",
+    "demo": "npm run lint && node support/build_demo.mjs && typedoc",
+    "demo:publish": "npm run demo && gh-pages -d demo -f",
     "benchmark:deps": "npm install --prefix benchmark/extra/",
-    "prepack": "npm test && npm run build && npm run build:demo",
-    "postpublish": "npm run gh-demo"
+    "prepack": "npm test && npm run build && npm run demo",
+    "postpublish": "npm run demo:publish"
   },
   "dependencies": {
     "argparse": "^2.0.1"
@@ -82,6 +82,7 @@
     "neostandard": "^0.13.0",
     "rollup": "^4.62.2",
     "rollup-plugin-dts": "^6.4.1",
+    "typedoc": "^0.28.19",
     "typescript": "^6.0.3",
     "vite": "^8.1.2",
     "vite-plugin-node-polyfills": "^0.28.0",

typedoc.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "entryPoints": ["src/index.ts"],
+  "out": "demo/doc",
+  "includeVersion": true,
+  "markdownLinkExternal": true,
+  "sourceLinkExternal": true,
+  "sourceLinkTemplate": "https://github.com/nodeca/js-yaml/blob/{gitRevision:short}/{path}#L{line}",
+  "navigationLinks": {
+    "GitHub": "https://github.com/nodeca/js-yaml"
+  },
+  "defaultCategory": "js-yaml",
+  "categoryOrder": ["js-yaml", "*"],
+  "sort": ["source-order"],
+  "navigation": {
+    "includeCategories": true
+  }
+}