ci: add new docs publish

.github/actions/pnpm-install/action.yml

@@ -2,7 +2,7 @@ name: "pnpm install"
 description: "Run pnpm install with cache enabled"
 inputs:
   path:
-    description: Path to run pnpm install in
+    description: "Path to the directory containing the pnpm workspace"
     default: "."
 runs:
   using: "composite"

.github/workflows/pre-release-single.yml

@@ -4,14 +4,14 @@ on:
   workflow_dispatch:
     inputs:
       package:
-        description: "The published name of a single package to release"
+        description: The published name of a single package to release
         type: choice
         required: true
         options:
           - "@nanoforge-dev/utils-eslint-config"
           - "@nanoforge-dev/utils-prettier-config"
       version:
-        description: "New version for the packages"
+        description: New version for the packages
         type: string
         required: true
       dry_run:

.github/workflows/pre-release.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: "New version for the packages"
+        description: New version for the packages
         type: string
         required: true
       dry_run:

.github/workflows/release.yml

@@ -34,7 +34,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   release-single-package:
-    name: Release
+    name: Release Single
     runs-on: ubuntu-latest
     if: github.repository_owner == 'NanoForge-dev' && github.event.pull_request.merged == true && startsWith(github.head_ref, 'releases/') && !startsWith(github.head_ref, 'releases/nanoforge@')
     steps:
@@ -63,3 +63,34 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-docs:
+    name: Publish docs
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'NanoForge-dev'
+    needs: [release]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Checkout docs repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+          path: docs-dist
+          repository: nanoforge-dev/docs
+          token: ${{ secrets.ACTIONS_KEY }}
+
+      - name: Prepare
+        uses: ./.github/actions/prepare
+
+      - name: Publish docs
+        uses: ./node_modules/@nanoforge-dev/actions/actions/synchronize-docs
+        with:
+          repository: engine
+          category: engine
+          references: true

.gitignore

@@ -239,4 +239,4 @@ emsdk-cache/
 .vscode
 .tsdocs
 
-docs/api
+references/

.husky/commit-msg

@@ -1 +1 @@
-pnpm --no-install commitlint --edit "$1"
+pnpm commitlint --edit "$1"

.husky/pre-commit

@@ -1 +1 @@
-pnpm --no-install lint-staged
+pnpm lint-staged

package.json

@@ -48,7 +48,7 @@
     "typescript": "catalog:core",
     "vitest": "catalog:test"
   },
-  "packageManager": "pnpm@10.33.0",
+  "packageManager": "pnpm@11.3.0",
   "engines": {
     "node": "25"
   },

packages/asset-manager/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "asset-manager",
   "org": "nanoforge-dev",
   "packagePath": "packages/asset-manager",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/asset-manager/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/asset-manager@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/asset-manager/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/asset-manager",
+  "outputFolder": "../../references/asset-manager",
   "lint": {
     "eslint": {
       "enabled": true

packages/common/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "common",
   "org": "nanoforge-dev",
   "packagePath": "packages/common",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/common/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/common@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/common/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/common",
+  "outputFolder": "../../references/common",
   "lint": {
     "eslint": {
       "enabled": true

packages/config/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "config",
   "org": "nanoforge-dev",
   "packagePath": "packages/config",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/config/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/config@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/config/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/config",
+  "outputFolder": "../../references/config",
   "lint": {
     "eslint": {
       "enabled": true

packages/core-editor/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "core-editor",
   "org": "nanoforge-dev",
   "packagePath": "packages/core-editor",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/core-editor/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/core-editor@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/core-editor/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/core-editor",
+  "outputFolder": "../../references/core-editor",
   "lint": {
     "eslint": {
       "enabled": true

packages/core/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "core",
   "org": "nanoforge-dev",
   "packagePath": "packages/core",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/core/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/core@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/core/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/core",
+  "outputFolder": "../../references/core",
   "lint": {
     "eslint": {
       "enabled": true

packages/ecs-client/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "ecs-client",
   "org": "nanoforge-dev",
   "packagePath": "packages/ecs-client",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/ecs-client/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/ecs-client@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/ecs-client/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/ecs-client",
+  "outputFolder": "../../references/ecs-client",
   "lint": {
     "eslint": {
       "enabled": true

packages/ecs-lib/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "ecs-lib",
   "org": "nanoforge-dev",
   "packagePath": "packages/ecs-lib",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/ecs-lib/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/ecs-lib@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/ecs-lib/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/ecs-lib",
+  "outputFolder": "../../references/ecs-lib",
   "lint": {
     "eslint": {
       "enabled": true

packages/ecs-server/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "ecs-server",
   "org": "nanoforge-dev",
   "packagePath": "packages/ecs-server",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/ecs-server/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/ecs-server@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/ecs-server/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/ecs-server",
+  "outputFolder": "../../references/ecs-server",
   "lint": {
     "eslint": {
       "enabled": true

packages/graphics-2d/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "graphics-2d",
   "org": "nanoforge-dev",
   "packagePath": "packages/graphics-2d",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/graphics-2d/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/graphics-2d@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/graphics-2d/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/graphics-2d",
+  "outputFolder": "../../references/graphics-2d",
   "lint": {
     "eslint": {
       "enabled": true

packages/input/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "input",
   "org": "nanoforge-dev",
   "packagePath": "packages/input",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/input/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/input@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/input/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/input",
+  "outputFolder": "../../references/input",
   "lint": {
     "eslint": {
       "enabled": true

packages/music/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "music",
   "org": "nanoforge-dev",
   "packagePath": "packages/music",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/music/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/music@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/music/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/music",
+  "outputFolder": "../../references/music",
   "lint": {
     "eslint": {
       "enabled": true

packages/network-client/.cliff-jumperrc.json

@@ -3,5 +3,6 @@
   "name": "network-client",
   "org": "nanoforge-dev",
   "packagePath": "packages/network-client",
+  "tagTemplate": "{{new-version}}",
   "identifierBase": false
 }

packages/network-client/cliff.toml

@@ -69,7 +69,7 @@ commit_parsers = [
 ]
 filter_commits = true
 protect_breaking_commits = true
-tag_pattern = "@nanoforge-dev/network-client@[0-9]*"
+tag_pattern = "^[0-9]+"
 ignore_tags = ""
 topo_order = false
 sort_commits = "newest"

packages/network-client/mint-tsdocs.config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/mint-tsdocs/lib/schemas/config.schema.json",
   "entryPoint": "dist/index.d.cts",
-  "outputFolder": "../../docs/api/network-client",
+  "outputFolder": "../../references/network-client",
   "lint": {
     "eslint": {
       "enabled": true