feat(nx): update to Nx 22

.codex/config.toml

@@ -0,0 +1,8 @@
+approval_policy = "on-request"
+sandbox_mode = "workspace-write"
+
+[sandbox_workspace_write]
+network_access = true
+# Nx's startLocalRegistry helper shells out to `npm config set/delete ... --ws=false`,
+# which temporarily writes the local registry auth token to the user npm config at ~/.npmrc.
+writable_roots = ["~/.npmrc"]

.gitignore

@@ -42,4 +42,6 @@ Thumbs.db
 .env
 
 .nx/cache
-.nx/workspace-data
+.nx/workspace-data
+.claude/worktrees
+.claude/settings.local.json

AGENTS.md

@@ -18,3 +18,7 @@ If a tradeoff is required, choose correctness and robustness over short-term con
 ## Maintainability
 
 Long-term maintainability is a core priority. If you add new functionality, first check if there is shared logic that can be extracted to a separate module. Duplicate logic across multiple files is a code smell and should be avoided. Don't be afraid to change existing code. Don't take shortcuts by just adding local logic to solve a problem. If you are not sure, research to find a good solution. 
+
+## Technology Stack
+
+- Use npm

docs/.vitepress/config.mts

@@ -1,10 +1,20 @@
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
 import { defineConfig } from 'vitepress';
 import {
   injectReferenceOptions,
   validateReferenceDocs,
-} from '../../tools/docs/src/lib/reference-docs';
+} from '../../tools/docs';
+
+const jsonataGrammar = JSON.parse(
+  readFileSync(
+    fileURLToPath(
+      new URL('./grammars/jsonata.tmLanguage.json', import.meta.url)
+    ),
+    'utf-8'
+  )
+);
 
 const base = '/nx-forge/';
 const workspaceRoot = fileURLToPath(new URL('../..', import.meta.url));
@@ -37,6 +47,15 @@ export default defineConfig({
     ],
   ],
   cleanUrls: true,
+  markdown: {
+    languages: [
+      {
+        name: 'jsonata',
+        scopeName: 'source.jsonata',
+        ...jsonataGrammar,
+      },
+    ],
+  },
   vite: {
     plugins: [
       {

docs/.vitepress/grammars/jsonata.tmLanguage.json

@@ -0,0 +1,224 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "scopeName": "source.jsonata",
+  "foldingStartMarker": "\\{\\s*$",
+  "foldingStopMarker": "^\\s*\\}",
+  "patterns": [
+    {
+      "include": "#value"
+    }
+  ],
+  "repository": {
+    "expression": {
+      "name": "meta.selector.jsonata",
+      "patterns": [
+        {
+          "match": "(\\$|\\.)",
+          "name": "keyword.other.selector.jsonata"
+        },
+        {
+          "match": "(\\+|-|\\*|/|&)",
+          "name": "keyword.other.math.jsonata"
+        }
+      ]
+    },
+    "array": {
+      "begin": "\\[",
+      "beginCaptures": {
+        "0": {
+          "name": "punctuation.definition.array.begin.jsonata"
+        }
+      },
+      "end": "\\]",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.definition.array.end.jsonata"
+        }
+      },
+      "name": "meta.structure.array.jsonata",
+      "patterns": [
+        {
+          "include": "#value"
+        },
+        {
+          "match": ",",
+          "name": "punctuation.separator.array.jsonata"
+        },
+        {
+          "match": "[^\\s\\]]",
+          "name": "invalid.illegal.expected-array-separator.jsonata"
+        }
+      ]
+    },
+    "comments": {
+      "patterns": [
+        {
+          "begin": "/\\*\\*(?!/)",
+          "captures": {
+            "0": {
+              "name": "punctuation.definition.comment.jsonata"
+            }
+          },
+          "end": "\\*/",
+          "name": "comment.block.documentation.jsonata"
+        },
+        {
+          "begin": "/\\*",
+          "captures": {
+            "0": {
+              "name": "punctuation.definition.comment.jsonata"
+            }
+          },
+          "end": "\\*/",
+          "name": "comment.block.jsonata"
+        },
+        {
+          "captures": {
+            "1": {
+              "name": "punctuation.definition.comment.jsonata"
+            }
+          },
+          "match": "(//).*$\\n?",
+          "name": "comment.line.double-slash.js"
+        }
+      ]
+    },
+    "constant": {
+      "match": "\\b(?:true|false|null)\\b",
+      "name": "constant.language.jsonata"
+    },
+    "number": {
+      "match": "(?x)        # turn on extended mode\n  -?        # an optional minus\n  (?:\n    0       # a zero\n    |       # ...or...\n    [1-9]   # a 1-9 character\n    \\d*     # followed by zero or more digits\n  )\n  (?:\n    (?:\n      \\.    # a period\n      \\d+   # followed by one or more digits\n    )?\n    (?:\n      [eE]  # an e character\n      [+-]? # followed by an option +/-\n      \\d+   # followed by one or more digits\n    )?      # make exponent optional\n  )?        # make decimal portion optional",
+      "name": "constant.numeric.jsonata"
+    },
+    "object": {
+      "begin": "\\{",
+      "beginCaptures": {
+        "0": {
+          "name": "punctuation.definition.dictionary.begin.jsonata"
+        }
+      },
+      "end": "\\}",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.definition.dictionary.end.jsonata"
+        }
+      },
+      "name": "meta.structure.dictionary.jsonata",
+      "patterns": [
+        {
+          "comment": "the JSON object key",
+          "include": "#objectkey"
+        },
+        {
+          "include": "#comments"
+        },
+        {
+          "begin": ":",
+          "beginCaptures": {
+            "0": {
+              "name": "punctuation.separator.dictionary.key-value.jsonata"
+            }
+          },
+          "end": "(,)|(?=\\})",
+          "endCaptures": {
+            "1": {
+              "name": "punctuation.separator.dictionary.pair.jsonata"
+            }
+          },
+          "name": "meta.structure.dictionary.value.jsonata",
+          "patterns": [
+            {
+              "comment": "the JSON object value",
+              "include": "#value"
+            }
+          ]
+        },
+        {
+          "match": "[^\\s\\}]",
+          "name": "invalid.illegal.expected-dictionary-separator.jsonata"
+        }
+      ]
+    },
+    "string": {
+      "begin": "\"",
+      "beginCaptures": {
+        "0": {
+          "name": "punctuation.definition.string.begin.jsonata"
+        }
+      },
+      "end": "\"",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.definition.string.end.jsonata"
+        }
+      },
+      "name": "string.quoted.double.jsonata",
+      "patterns": [
+        {
+          "include": "#stringcontent"
+        }
+      ]
+    },
+    "objectkey": {
+      "begin": "\"",
+      "beginCaptures": {
+        "0": {
+          "name": "punctuation.support.type.property-name.begin.jsonata"
+        }
+      },
+      "end": "\"",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.support.type.property-name.end.jsonata"
+        }
+      },
+      "name": "string.jsonata support.type.property-name.jsonata",
+      "patterns": [
+        {
+          "include": "#stringcontent"
+        },
+        {
+          "include": "#expression"
+        }
+      ]
+    },
+    "stringcontent": {
+      "patterns": [
+        {
+          "match": "(?x)                # turn on extended mode\n  \\\\                # a literal backslash\n  (?:               # ...followed by...\n    [\"\\\\/bfnrt]     # one of these characters\n    |               # ...or...\n    u               # a u\n    [0-9a-fA-F]{4}) # and four hex digits",
+          "name": "constant.character.escape.jsonata"
+        },
+        {
+          "match": "\\\\.",
+          "name": "invalid.illegal.unrecognized-string-escape.jsonata"
+        }
+      ]
+    },
+    "value": {
+      "patterns": [
+        {
+          "include": "#comments"
+        },
+        {
+          "include": "#constant"
+        },
+        {
+          "include": "#number"
+        },
+        {
+          "include": "#string"
+        },
+        {
+          "include": "#array"
+        },
+        {
+          "include": "#object"
+        },
+        {
+          "include": "#expression"
+        }
+      ]
+    }
+  }
+}

docs/concepts/plugin-concepts.md

@@ -4,11 +4,11 @@ This page summarizes the main Nx Forge plugin concepts and ideas.
 
 ## Building Forge apps
 
-When using [the app generator](../guides/generating-a-forge-app.md) to scaffold a Forge app, you will get a Nx project with a build target and a collection of inferred targets provided by the Nx Forge plugin.
+When using [the app generator](../guides/generating-a-forge-app.md) to scaffold a Forge app, you will get an Nx project with a build target and a collection of inferred targets provided by the Nx Forge plugin.
 
-The most important thing to know is that to deploy a Forge app, you need to run the following executors to get an artifact that can be deployed to the Forge platform:
+The most important thing to know is that to deploy a Forge app, you need to run the following targets to get an artifact that can be deployed to the Forge platform:
 
-::: tip Executors to get a deployable Forge app artifact
+::: tip Targets to get a deployable Forge app artifact
 
 build -> package
 

docs/guides/adding-a-ui-kit-module.md

@@ -8,7 +8,7 @@ UI Kit support is experimental. Please try it out and let us know if you face an
 
 ## Enabling UI Kit packaging
 
-Unfortunately, UI Kit and Custom UI packaging do not work the same way. To avoid breaking any existing builds, the default packaging mechanism is currently only compatible with Custom UI. However, you can enable UI Kit compatible packaging by setting the `uiKit2Packaging` option on the [`build`](../reference/executors.md#build) or [`package`](../reference/executors.md#package) executor.
+Unfortunately, UI Kit and Custom UI packaging do not work the same way. To avoid breaking any existing builds, the default packaging mechanism is currently only compatible with Custom UI. However, you can enable UI Kit-compatible packaging by setting the `uiKit2Packaging` option on the [`package`](../reference/executors.md#package) target.
 
 ## Installing UI Kit dependencies
 

docs/guides/generating-a-forge-app.md

@@ -17,12 +17,12 @@ nx g @toolsplus/nx-forge:app <nx-forge-app-name>
 
 Refer to [the generator reference documentation](../reference/generators#application) for details on the available generator options.
 
-When the generator completes, you have a blank Forge app project. To register the new app with the Forge platform, run the following [build](../reference/executors#build), [package](../reference/executors#package), and [register](../reference/executors#register) commands in this order:
+When the generator completes, you have a blank Forge app project. To register the new app with the Forge platform, run the `build` target, then the [`package`](../reference/executors#package) and [`register`](../reference/executors#register) targets in this order:
 
 ```shell
-nx build <nx-forge-app-name>
-nx package <nx-forge-app-name>
-nx register <nx-forge-app-name> --appName="My Forge App"
+nx run <nx-forge-app-name>:build
+nx run <nx-forge-app-name>:package
+nx run <nx-forge-app-name>:register --appName="My Forge App"
 ```
 
 The register command updates the `app.id` in the manifest file to the value returned from the registration.