@nocobase/plugin-flow-engine 2.3.0-beta.5 → 2.4.0-alpha.1

package/dist/externalVersion.js

@@ -8,16 +8,16 @@
  */
 
 module.exports = {
-  "@nocobase/client": "2.3.0-beta.5",
+  "@nocobase/client": "2.4.0-alpha.1",
   "lodash": "4.18.1",
-  "@nocobase/database": "2.3.0-beta.5",
-  "@nocobase/data-source-manager": "2.3.0-beta.5",
-  "@nocobase/resourcer": "2.3.0-beta.5",
-  "@nocobase/server": "2.3.0-beta.5",
-  "@nocobase/utils": "2.3.0-beta.5",
-  "@nocobase/cache": "2.3.0-beta.5",
-  "@nocobase/actions": "2.3.0-beta.5",
+  "@nocobase/database": "2.4.0-alpha.1",
+  "@nocobase/data-source-manager": "2.4.0-alpha.1",
+  "@nocobase/resourcer": "2.4.0-alpha.1",
+  "@nocobase/server": "2.4.0-alpha.1",
+  "@nocobase/utils": "2.4.0-alpha.1",
+  "@nocobase/cache": "2.4.0-alpha.1",
+  "@nocobase/actions": "2.4.0-alpha.1",
   "sequelize": "6.35.2",
   "@formily/json-schema": "2.3.7",
-  "@nocobase/ai": "2.3.0-beta.5"
+  "@nocobase/ai": "2.4.0-alpha.1"
 };

package/dist/node_modules/@ant-design/icons-svg/package.json

@@ -1 +1 @@
-{"name":"@ant-design/icons-svg","version":"4.3.1","sideEffects":false,"description":"Abstract nodes for ant design icons.","contributors":["HeskeyBaozi <hezhiyu233@foxmail.com>"],"homepage":"https://github.com/ant-design/ant-design-icons/","license":"MIT","main":"lib/index.js","module":"es/index.js","files":["lib","es","inline-svg","inline-namespaced-svg"],"repository":{"type":"git","url":"git+https://github.com/ant-design/ant-design-icons.git"},"scripts":{"g":"npm run generate","generate":"cross-env NODE_ENV=production gulp --require ts-node/register/transpile-only","type-check":"tsc --noEmit","build:es":"tsc --project tsconfig.build.json --module esnext --outDir es","build:lib":"tsc --project tsconfig.build.json --module commonjs --outDir lib","build":"cross-env NODE_ENV=production && npm run build:es && npm run build:lib","test":"cross-env NODE_ENV=test && npm run test:unit","test:unit":"jest","prepublishOnly":"npm run test && npm run g && npm run build && npm run type-check && npm run digest","digest":"node scripts/digest.js"},"bugs":{"url":"https://github.com/ant-design/ant-design-icons/issues"},"devDependencies":{"@babel/core":"^7.8.6","@babel/preset-env":"^7.8.6","@babel/preset-typescript":"^7.8.3","@rgrove/parse-xml":"^2.0.2","@types/gulp":"^4.0.6","@types/gulp-concat":"^0.0.32","@types/gulp-rename":"^0.0.33","@types/jest":"^25.1.3","@types/lodash.camelcase":"^4.3.6","@types/lodash.template":"^4.4.6","@types/lodash.upperfirst":"^4.3.6","@types/node":"^13.9.3","@types/ramda":"^0.26.43","@types/rgrove__parse-xml":"^1.1.0","@types/svgo":"^1.3.1","@types/through2":"^2.0.34","@typescript-eslint/eslint-plugin":"^2.21.0","@typescript-eslint/parser":"^2.21.0","babel-jest":"^25.1.0","cross-env":"^7.0.0","del":"^5.1.0","eslint":"^7.16.0","globby":"^11.0.0","gulp":"^4.0.2","gulp-clone":"^2.0.1","gulp-concat":"^2.6.1","gulp-header":"^2.0.9","gulp-rename":"^2.0.0","jest":"^25.1.0","lodash.camelcase":"^4.3.0","lodash.template":"^4.5.0","lodash.upperfirst":"^4.3.1","ramda":"^0.27.0","svgo":"^1.3.2","through2":"^3.0.1","ts-node":"^8.6.2","typescript":"^4.0.0","vinyl":"^2.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_lastModified":"2026-08-28T08:17:50.549Z"}
+{"name":"@ant-design/icons-svg","version":"4.3.1","sideEffects":false,"description":"Abstract nodes for ant design icons.","contributors":["HeskeyBaozi <hezhiyu233@foxmail.com>"],"homepage":"https://github.com/ant-design/ant-design-icons/","license":"MIT","main":"lib/index.js","module":"es/index.js","files":["lib","es","inline-svg","inline-namespaced-svg"],"repository":{"type":"git","url":"git+https://github.com/ant-design/ant-design-icons.git"},"scripts":{"g":"npm run generate","generate":"cross-env NODE_ENV=production gulp --require ts-node/register/transpile-only","type-check":"tsc --noEmit","build:es":"tsc --project tsconfig.build.json --module esnext --outDir es","build:lib":"tsc --project tsconfig.build.json --module commonjs --outDir lib","build":"cross-env NODE_ENV=production && npm run build:es && npm run build:lib","test":"cross-env NODE_ENV=test && npm run test:unit","test:unit":"jest","prepublishOnly":"npm run test && npm run g && npm run build && npm run type-check && npm run digest","digest":"node scripts/digest.js"},"bugs":{"url":"https://github.com/ant-design/ant-design-icons/issues"},"devDependencies":{"@babel/core":"^7.8.6","@babel/preset-env":"^7.8.6","@babel/preset-typescript":"^7.8.3","@rgrove/parse-xml":"^2.0.2","@types/gulp":"^4.0.6","@types/gulp-concat":"^0.0.32","@types/gulp-rename":"^0.0.33","@types/jest":"^25.1.3","@types/lodash.camelcase":"^4.3.6","@types/lodash.template":"^4.4.6","@types/lodash.upperfirst":"^4.3.6","@types/node":"^13.9.3","@types/ramda":"^0.26.43","@types/rgrove__parse-xml":"^1.1.0","@types/svgo":"^1.3.1","@types/through2":"^2.0.34","@typescript-eslint/eslint-plugin":"^2.21.0","@typescript-eslint/parser":"^2.21.0","babel-jest":"^25.1.0","cross-env":"^7.0.0","del":"^5.1.0","eslint":"^7.16.0","globby":"^11.0.0","gulp":"^4.0.2","gulp-clone":"^2.0.1","gulp-concat":"^2.6.1","gulp-header":"^2.0.9","gulp-rename":"^2.0.0","jest":"^25.1.0","lodash.camelcase":"^4.3.0","lodash.template":"^4.5.0","lodash.upperfirst":"^4.3.1","ramda":"^0.27.0","svgo":"^1.3.2","through2":"^3.0.1","ts-node":"^8.6.2","typescript":"^4.0.0","vinyl":"^2.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_lastModified":"2026-09-02T04:18:23.841Z"}

package/dist/node_modules/acorn/package.json

@@ -1 +1 @@
-{"name":"acorn","description":"ECMAScript parser","homepage":"https://github.com/acornjs/acorn","main":"dist/acorn.js","types":"dist/acorn.d.ts","module":"dist/acorn.mjs","exports":{".":[{"import":"./dist/acorn.mjs","require":"./dist/acorn.js","default":"./dist/acorn.js"},"./dist/acorn.js"],"./package.json":"./package.json"},"version":"8.11.2","engines":{"node":">=0.4.0"},"maintainers":[{"name":"Marijn Haverbeke","email":"marijnh@gmail.com","web":"https://marijnhaverbeke.nl"},{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"https://rreverser.com/"},{"name":"Adrian Heine","web":"http://adrianheine.de"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn.git"},"license":"MIT","scripts":{"prepare":"cd ..; npm run build:main"},"bin":{"acorn":"./bin/acorn"},"_lastModified":"2026-08-28T08:17:51.677Z"}
+{"name":"acorn","description":"ECMAScript parser","homepage":"https://github.com/acornjs/acorn","main":"dist/acorn.js","types":"dist/acorn.d.ts","module":"dist/acorn.mjs","exports":{".":[{"import":"./dist/acorn.mjs","require":"./dist/acorn.js","default":"./dist/acorn.js"},"./dist/acorn.js"],"./package.json":"./package.json"},"version":"8.11.2","engines":{"node":">=0.4.0"},"maintainers":[{"name":"Marijn Haverbeke","email":"marijnh@gmail.com","web":"https://marijnhaverbeke.nl"},{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"https://rreverser.com/"},{"name":"Adrian Heine","web":"http://adrianheine.de"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn.git"},"license":"MIT","scripts":{"prepare":"cd ..; npm run build:main"},"bin":{"acorn":"./bin/acorn"},"_lastModified":"2026-09-02T04:18:24.863Z"}

package/dist/node_modules/acorn-jsx/package.json

@@ -1 +1 @@
-{"name":"acorn-jsx","description":"Modern, fast React.js JSX parser","homepage":"https://github.com/acornjs/acorn-jsx","version":"5.3.2","maintainers":[{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"http://rreverser.com/"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn-jsx"},"license":"MIT","scripts":{"test":"node test/run.js"},"peerDependencies":{"acorn":"^6.0.0 || ^7.0.0 || ^8.0.0"},"devDependencies":{"acorn":"^8.0.1"},"_lastModified":"2026-08-28T08:17:52.141Z"}
+{"name":"acorn-jsx","description":"Modern, fast React.js JSX parser","homepage":"https://github.com/acornjs/acorn-jsx","version":"5.3.2","maintainers":[{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"http://rreverser.com/"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn-jsx"},"license":"MIT","scripts":{"test":"node test/run.js"},"peerDependencies":{"acorn":"^6.0.0 || ^7.0.0 || ^8.0.0"},"devDependencies":{"acorn":"^8.0.1"},"_lastModified":"2026-09-02T04:18:25.302Z"}

package/dist/node_modules/acorn-walk/package.json

@@ -1 +1 @@
-{"name":"acorn-walk","description":"ECMAScript (ESTree) AST walker","homepage":"https://github.com/acornjs/acorn","main":"dist/walk.js","types":"dist/walk.d.ts","module":"dist/walk.mjs","exports":{".":[{"import":"./dist/walk.mjs","require":"./dist/walk.js","default":"./dist/walk.js"},"./dist/walk.js"],"./package.json":"./package.json"},"version":"8.3.4","engines":{"node":">=0.4.0"},"dependencies":{"acorn":"^8.11.0"},"maintainers":[{"name":"Marijn Haverbeke","email":"marijnh@gmail.com","web":"https://marijnhaverbeke.nl"},{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"https://rreverser.com/"},{"name":"Adrian Heine","web":"http://adrianheine.de"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn.git"},"scripts":{"prepare":"cd ..; npm run build:walk"},"license":"MIT","_lastModified":"2026-08-28T08:17:52.259Z"}
+{"name":"acorn-walk","description":"ECMAScript (ESTree) AST walker","homepage":"https://github.com/acornjs/acorn","main":"dist/walk.js","types":"dist/walk.d.ts","module":"dist/walk.mjs","exports":{".":[{"import":"./dist/walk.mjs","require":"./dist/walk.js","default":"./dist/walk.js"},"./dist/walk.js"],"./package.json":"./package.json"},"version":"8.3.4","engines":{"node":">=0.4.0"},"dependencies":{"acorn":"^8.11.0"},"maintainers":[{"name":"Marijn Haverbeke","email":"marijnh@gmail.com","web":"https://marijnhaverbeke.nl"},{"name":"Ingvar Stepanyan","email":"me@rreverser.com","web":"https://rreverser.com/"},{"name":"Adrian Heine","web":"http://adrianheine.de"}],"repository":{"type":"git","url":"https://github.com/acornjs/acorn.git"},"scripts":{"prepare":"cd ..; npm run build:walk"},"license":"MIT","_lastModified":"2026-09-02T04:18:25.415Z"}

package/dist/node_modules/ses/package.json

@@ -1 +1 @@
-{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-08-28T08:17:51.228Z"}
+{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-09-02T04:18:24.444Z"}

package/dist/node_modules/zod/package.json

@@ -1 +1 @@
-{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-08-28T08:17:53.458Z"}
+{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-09-02T04:18:26.540Z"}

package/dist/server/flow-surfaces/navigation-targets.d.ts

@@ -12,6 +12,7 @@ export declare const DEFAULT_MOBILE_UI_LAYOUT_UID = "mobile-layout-model";
 export declare const DEFAULT_ADMIN_MULTI_PORTAL_UID = "__default_admin__";
 export declare const DEFAULT_MOBILE_MULTI_PORTAL_UID = "__default_mobile__";
 export type FlowSurfaceNavigationRequestRoles = readonly string[] | string;
+type FlowSurfacePortalRouteScopeKind = 'layout' | 'portal';
 export type FlowSurfaceResolvedMultiPortal = {
     uid: string;
     title: string;
@@ -22,6 +23,8 @@ export type FlowSurfaceResolvedMultiPortal = {
     enabled: true;
     layoutUid: string;
     layoutType?: string;
+    portalType: 'no-code';
+    routeScopeKind: FlowSurfacePortalRouteScopeKind;
 };
 export type FlowSurfaceNavigationTarget = {
     kind: 'layout' | 'portal';
@@ -56,6 +59,7 @@ export declare class FlowSurfaceNavigationTargetsService {
     hasUiLayoutCapability(): boolean;
     normalizePortalUid(value: unknown): string;
     listNavigationTargets(currentRoles?: FlowSurfaceNavigationRequestRoles, transaction?: Transaction): Promise<FlowSurfaceNavigationTargetsResult>;
+    resolveDefaultPortal(options: Omit<PortalResolveOptions, 'path'>): Promise<FlowSurfaceResolvedMultiPortal>;
     resolvePortal(portalUidValue: unknown, options: PortalResolveOptions): Promise<FlowSurfaceResolvedMultiPortal>;
     readRoutePortalUids(routeId: unknown, transaction?: Transaction): Promise<string[]>;
     assertRouteBelongsToPortal(actionName: string, routeId: unknown, portalUid: string, path: string, transaction?: Transaction): Promise<void>;
@@ -64,7 +68,10 @@ export declare class FlowSurfaceNavigationTargetsService {
         transaction?: Transaction;
     }): Promise<void>;
     private listLayoutTargets;
+    private getEnabledPortalInventory;
     private listAccessiblePortalTargets;
+    private comparePortalPriority;
+    private getPortalPriority;
     private canAccessPortal;
     private collectRouteTreeIds;
     private removeDefaultLayoutRoutePermissions;

package/dist/server/flow-surfaces/navigation-targets.js

@@ -38,7 +38,6 @@ const DEFAULT_ADMIN_UI_LAYOUT_UID = "admin-layout-model";
 const DEFAULT_MOBILE_UI_LAYOUT_UID = "mobile-layout-model";
 const DEFAULT_ADMIN_MULTI_PORTAL_UID = "__default_admin__";
 const DEFAULT_MOBILE_MULTI_PORTAL_UID = "__default_mobile__";
-const RESERVED_MULTI_PORTAL_UIDS = /* @__PURE__ */ new Set([DEFAULT_ADMIN_MULTI_PORTAL_UID, DEFAULT_MOBILE_MULTI_PORTAL_UID]);
 function readRecordField(record, field) {
   if (!record || typeof record !== "object") {
     return void 0;
@@ -60,6 +59,17 @@ function normalizeRoles(currentRoles) {
 function normalizeRelationRouteId(routeId) {
   return routeId === null || typeof routeId === "undefined" ? void 0 : routeId;
 }
+function isDefaultLayoutMultiPortalUid(uid) {
+  return uid === DEFAULT_ADMIN_MULTI_PORTAL_UID || uid === DEFAULT_MOBILE_MULTI_PORTAL_UID;
+}
+function getMultiPortalLayoutType(uiLayoutUid) {
+  if (uiLayoutUid === DEFAULT_ADMIN_UI_LAYOUT_UID) {
+    return "desktop";
+  }
+  if (uiLayoutUid === DEFAULT_MOBILE_UI_LAYOUT_UID) {
+    return "mobile";
+  }
+}
 class FlowSurfaceNavigationTargetsService {
   constructor(db) {
     this.db = db;
@@ -85,9 +95,17 @@ class FlowSurfaceNavigationTargetsService {
     return portalUid || void 0;
   }
   async listNavigationTargets(currentRoles, transaction) {
-    const layoutTargets = await this.listLayoutTargets(transaction);
+    var _a;
+    let layoutTargets = await this.listLayoutTargets(transaction);
     const multiPortal = this.hasMultiPortalCapability();
-    const portalTargets = multiPortal ? await this.listAccessiblePortalTargets(currentRoles, transaction) : [];
+    const portalInventory = multiPortal ? await this.getEnabledPortalInventory(currentRoles, transaction) : { accessible: [] };
+    const portalTargets = multiPortal ? await this.listAccessiblePortalTargets(portalInventory.accessible, transaction) : [];
+    if (multiPortal) {
+      layoutTargets = layoutTargets.map(({ default: _default, ...target }) => target);
+      if (portalInventory.accessible.length === 1 && ((_a = portalTargets[0]) == null ? void 0 : _a.uid) === readStringField(portalInventory.accessible[0], "uid")) {
+        portalTargets[0] = { ...portalTargets[0], default: true };
+      }
+    }
     return {
       version: "1",
       capabilities: {
@@ -96,6 +114,60 @@ class FlowSurfaceNavigationTargetsService {
       targets: [...layoutTargets, ...portalTargets]
     };
   }
+  async resolveDefaultPortal(options) {
+    if (!this.hasMultiPortalCapability()) {
+      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} requires the Multi-portal capability`, {
+        ruleId: "navigation-portal-unsupported",
+        path: "navigation"
+      });
+    }
+    const inventory = await this.getEnabledPortalInventory(options.currentRoles, options.transaction);
+    if (!inventory.enabled.length) {
+      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} requires an enabled portal`, {
+        ruleId: "navigation-portal-not-found",
+        path: "navigation",
+        details: {
+          uiBuilderAllowed: false,
+          adminLayoutFallbackAllowed: false,
+          agentInstruction: "Stop this Flow Surfaces write. Ask the user to create and enable a Portal before retrying; do not fall back to the Admin layout."
+        }
+      });
+    }
+    if (!inventory.accessible.length) {
+      (0, import_errors.throwForbidden)(
+        `flowSurfaces ${options.actionName} current roles cannot access an enabled portal`,
+        "FLOW_SURFACE_NAVIGATION_PORTAL_FORBIDDEN",
+        {
+          ruleId: "navigation-portal-forbidden",
+          path: "navigation"
+        }
+      );
+    }
+    if (inventory.accessible.length > 1) {
+      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} requires an explicit portal selection`, {
+        ruleId: "navigation-portal-selection-required",
+        path: "navigation",
+        details: {
+          candidates: inventory.accessible.map((portal) => {
+            const uid = readStringField(portal, "uid");
+            return {
+              uid,
+              portalName: readStringField(portal, "portalName") || null,
+              title: readStringField(portal, "title") || uid,
+              portalType: readStringField(portal, "portalType") || null
+            };
+          }),
+          uiBuilderAllowed: false,
+          adminLayoutFallbackAllowed: false,
+          agentInstruction: "Stop this Flow Surfaces write and ask the user to select one candidate before retrying; do not choose by Portal type or fall back to the Admin layout."
+        }
+      });
+    }
+    return this.resolvePortal(readStringField(inventory.accessible[0], "uid"), {
+      ...options,
+      path: "navigation"
+    });
+  }
   async resolvePortal(portalUidValue, options) {
     const portalUid = this.normalizePortalUid(portalUidValue);
     if (!portalUid) {
@@ -111,19 +183,9 @@ class FlowSurfaceNavigationTargetsService {
         details: { portalUid }
       });
     }
-    if (RESERVED_MULTI_PORTAL_UIDS.has(portalUid)) {
-      (0, import_errors.throwBadRequest)(
-        `flowSurfaces ${options.actionName} ${options.path} cannot use reserved default portal uid '${portalUid}'; use layoutUid semantics instead`,
-        {
-          ruleId: "navigation-portal-reserved",
-          path: options.path,
-          details: { portalUid }
-        }
-      );
-    }
     const portal = await this.db.getRepository("multiPortals").findOne({
       filter: { uid: portalUid },
-      fields: ["uid", "title", "icon", "routeName", "routePath", "authCheck", "enabled", "uiLayoutUid"],
+      fields: ["uid", "title", "icon", "portalType", "portalName", "routePath", "authCheck", "enabled", "uiLayoutUid"],
       transaction: options.transaction
     });
     if (!portal) {
@@ -133,6 +195,18 @@ class FlowSurfaceNavigationTargetsService {
         details: { portalUid }
       });
     }
+    const routeScopeKind = isDefaultLayoutMultiPortalUid(portalUid) ? "layout" : "portal";
+    if (routeScopeKind === "portal" && !await this.canAccessPortal(portalUid, options.currentRoles, options.transaction)) {
+      (0, import_errors.throwForbidden)(
+        `flowSurfaces ${options.actionName} current roles cannot access portal '${portalUid}'`,
+        "FLOW_SURFACE_NAVIGATION_PORTAL_FORBIDDEN",
+        {
+          ruleId: "navigation-portal-forbidden",
+          path: options.path,
+          details: { portalUid }
+        }
+      );
+    }
     if (readRecordField(portal, "enabled") !== true) {
       (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} portal '${portalUid}' is disabled`, {
         ruleId: "navigation-portal-disabled",
@@ -140,60 +214,54 @@ class FlowSurfaceNavigationTargetsService {
         details: { portalUid }
       });
     }
+    const portalType = readStringField(portal, "portalType");
+    if (portalType !== "no-code") {
+      if (portalType === "ai") {
+        (0, import_errors.throwBadRequest)(
+          `flowSurfaces ${options.actionName} cannot use UI Builder or Flow Surfaces for AI Portal '${portalUid}'; stop and implement the request in the Portal source code`,
+          {
+            ruleId: "navigation-portal-type-unsupported",
+            path: options.path,
+            details: {
+              portalUid,
+              portalType,
+              portalName: readStringField(portal, "portalName") || null,
+              expectedPortalType: "no-code",
+              uiBuilderAllowed: false,
+              adminLayoutFallbackAllowed: false,
+              implementationPath: "ai-portal-source",
+              agentInstruction: "Stop this Flow Surfaces write. Run nb portal info <portalName> -j to resolve localPath, then implement the request in that AI Portal source code. Do not retry with an Admin layout."
+            }
+          }
+        );
+      }
+      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} portal '${portalUid}' does not support no-code routes`, {
+        ruleId: "navigation-portal-type-unsupported",
+        path: options.path,
+        details: { portalUid, portalType: portalType || null }
+      });
+    }
     const layoutUid = readStringField(portal, "uiLayoutUid");
-    if (!layoutUid || !this.db.getCollection("uiLayouts")) {
-      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} portal '${portalUid}' has no available backing UI layout`, {
+    const layoutType = getMultiPortalLayoutType(layoutUid);
+    if (!layoutUid || !layoutType) {
+      (0, import_errors.throwBadRequest)(`flowSurfaces ${options.actionName} portal '${portalUid}' has an unsupported UI layout uid`, {
         ruleId: "navigation-portal-layout-not-found",
         path: options.path,
         details: { portalUid, layoutUid: layoutUid || null }
       });
     }
-    const layout = await this.db.getRepository("uiLayouts").findOne({
-      filter: { uid: layoutUid },
-      fields: ["uid", "layoutType", "enabled"],
-      transaction: options.transaction
-    });
-    if (!layout) {
-      (0, import_errors.throwBadRequest)(
-        `flowSurfaces ${options.actionName} portal '${portalUid}' backing UI layout '${layoutUid}' does not exist`,
-        {
-          ruleId: "navigation-portal-layout-not-found",
-          path: options.path,
-          details: { portalUid, layoutUid }
-        }
-      );
-    }
-    if (readRecordField(layout, "enabled") !== true) {
-      (0, import_errors.throwBadRequest)(
-        `flowSurfaces ${options.actionName} portal '${portalUid}' backing UI layout '${layoutUid}' is disabled`,
-        {
-          ruleId: "navigation-portal-layout-disabled",
-          path: options.path,
-          details: { portalUid, layoutUid }
-        }
-      );
-    }
-    if (!await this.canAccessPortal(portalUid, options.currentRoles, options.transaction)) {
-      (0, import_errors.throwForbidden)(
-        `flowSurfaces ${options.actionName} current roles cannot access portal '${portalUid}'`,
-        "FLOW_SURFACE_NAVIGATION_PORTAL_FORBIDDEN",
-        {
-          ruleId: "navigation-portal-forbidden",
-          path: options.path,
-          details: { portalUid }
-        }
-      );
-    }
     return {
       uid: portalUid,
       title: readStringField(portal, "title") || portalUid,
       icon: readStringField(portal, "icon") || null,
-      routeName: readStringField(portal, "routeName"),
+      routeName: readStringField(portal, "portalName"),
       routePath: readStringField(portal, "routePath"),
       authCheck: readRecordField(portal, "authCheck") === true,
       enabled: true,
       layoutUid,
-      layoutType: readStringField(layout, "layoutType")
+      layoutType,
+      portalType,
+      routeScopeKind
     };
   }
   async readRoutePortalUids(routeId, transaction) {
@@ -293,51 +361,53 @@ class FlowSurfaceNavigationTargetsService {
       return left.uid.localeCompare(right.uid);
     });
   }
-  async listAccessiblePortalTargets(currentRoles, transaction) {
+  async getEnabledPortalInventory(currentRoles, transaction) {
+    const records = await this.db.getRepository("multiPortals").find({
+      filter: { enabled: true },
+      fields: ["uid", "title", "icon", "portalType", "portalName", "routePath", "authCheck", "enabled", "uiLayoutUid"],
+      sort: ["uid"],
+      transaction
+    });
+    const enabled = records.filter((portal) => {
+      const uiLayoutUid = readStringField(portal, "uiLayoutUid");
+      return !!getMultiPortalLayoutType(uiLayoutUid);
+    });
+    enabled.sort(
+      (left, right) => String(readStringField(left, "uid") || "").localeCompare(String(readStringField(right, "uid") || ""))
+    );
     const roles = normalizeRoles(currentRoles);
-    let accessiblePortalUids;
-    if (!roles.includes("root")) {
-      if (!roles.length || !this.db.getCollection("rolesMultiPortals")) {
-        return [];
-      }
+    const isRoot = roles.includes("root");
+    const accessiblePortalUids = /* @__PURE__ */ new Set();
+    if (!isRoot && roles.length && this.db.getCollection("rolesMultiPortals")) {
       const grants = await this.db.getRepository("rolesMultiPortals").find({
-        fields: ["multiPortalUid"],
         filter: { roleName: roles },
+        fields: ["multiPortalUid"],
         transaction
       });
-      accessiblePortalUids = Array.from(
-        new Set(
-          grants.map((grant) => readStringField(grant, "multiPortalUid")).filter((portalUid) => !!portalUid)
-        )
-      );
-      if (!accessiblePortalUids.length) {
-        return [];
+      for (const grant of grants) {
+        const portalUid = readStringField(grant, "multiPortalUid");
+        if (portalUid) {
+          accessiblePortalUids.add(portalUid);
+        }
       }
     }
-    const accessiblePortalUidSet = accessiblePortalUids ? new Set(accessiblePortalUids) : void 0;
-    const filter = {
-      enabled: true,
-      "uid.$notIn": Array.from(RESERVED_MULTI_PORTAL_UIDS)
-    };
-    const portals = await this.db.getRepository("multiPortals").find({
-      filter,
-      fields: ["uid", "title", "icon", "routeName", "routePath", "authCheck", "enabled", "uiLayoutUid"],
-      sort: ["uid"],
-      transaction
+    const accessible = enabled.filter((portal) => {
+      const portalUid = readStringField(portal, "uid");
+      return !!portalUid && (isRoot || isDefaultLayoutMultiPortalUid(portalUid) || accessiblePortalUids.has(portalUid));
     });
+    return { enabled, accessible };
+  }
+  async listAccessiblePortalTargets(portals, _transaction) {
     const targets = [];
     for (const portal of portals) {
       const portalUid = readStringField(portal, "uid");
       const layoutUid = readStringField(portal, "uiLayoutUid");
-      if (!portalUid || accessiblePortalUidSet && !accessiblePortalUidSet.has(portalUid) || !layoutUid || !this.db.getCollection("uiLayouts")) {
+      const portalType = readStringField(portal, "portalType");
+      if (!portalUid || portalType !== "no-code") {
         continue;
       }
-      const layout = await this.db.getRepository("uiLayouts").findOne({
-        filter: { uid: layoutUid, enabled: true },
-        fields: ["layoutType"],
-        transaction
-      });
-      if (!layout) {
+      const layoutType = getMultiPortalLayoutType(layoutUid);
+      if (!layoutUid || !layoutType) {
         continue;
       }
       targets.push({
@@ -347,13 +417,31 @@ class FlowSurfaceNavigationTargetsService {
         title: readStringField(portal, "title") || portalUid,
         icon: readStringField(portal, "icon") || null,
         layoutUid,
-        layoutType: readStringField(layout, "layoutType"),
-        routeName: readStringField(portal, "routeName"),
+        layoutType,
+        routeName: readStringField(portal, "portalName"),
         routePath: readStringField(portal, "routePath"),
         authCheck: readRecordField(portal, "authCheck") === true
       });
     }
-    return targets;
+    return targets.sort((left, right) => this.comparePortalPriority(left, right));
+  }
+  comparePortalPriority(left, right) {
+    const priorityDelta = this.getPortalPriority(left) - this.getPortalPriority(right);
+    if (priorityDelta) {
+      return priorityDelta;
+    }
+    return String(readStringField(left, "uid") || "").localeCompare(String(readStringField(right, "uid") || ""));
+  }
+  getPortalPriority(portal) {
+    const uiLayout = readRecordField(portal, "uiLayout");
+    const layoutType = readStringField(portal, "layoutType") || readStringField(uiLayout, "layoutType");
+    if (readStringField(portal, "uid") === DEFAULT_ADMIN_MULTI_PORTAL_UID) {
+      return 0;
+    }
+    if (layoutType !== "mobile") {
+      return 1;
+    }
+    return 2;
   }
   async canAccessPortal(portalUid, currentRoles, transaction) {
     const roles = normalizeRoles(currentRoles);

package/dist/server/flow-surfaces/service.d.ts

@@ -96,6 +96,12 @@ export declare class FlowSurfacesService {
     private resolveDesktopRouteLayoutUidFilter;
     private assertNavigationTargetIsExclusive;
     private readDesktopRouteScope;
+    private buildDesktopRouteScopeForPortal;
+    private assertAdminLayoutCreateScope;
+    private getPortalRouteFilterUid;
+    private assertRouteBelongsToResolvedPortal;
+    private resolveDefaultDesktopRouteScope;
+    private resolveDesktopRouteMatchScope;
     private resolveRequestedDesktopRouteScope;
     private resolveExistingDesktopRouteScope;
     private attachDesktopRouteScopeToRouteAndChildren;
@@ -227,6 +233,7 @@ export declare class FlowSurfacesService {
     private dispatchPlanOnlyAction;
     private resolveApplyBlueprintReplaceTargetInfo;
     private resolveApplyBlueprintCreateNavigationGroup;
+    private resolveApplyBlueprintDefaultNavigationTarget;
     private normalizeApplyBlueprintCreateMobileNavigation;
     private assertApplyBlueprintCreateNavigationTarget;
     private resolveApplyBlueprintCreatePageIdentity;

package/dist/server/flow-surfaces/service.js

@@ -1204,6 +1204,83 @@ class FlowSurfacesService {
       layoutUids: await this.readDesktopRouteUiLayoutUids(routeId, transaction)
     };
   }
+  buildDesktopRouteScopeForPortal(portal) {
+    return {
+      portalUids: portal.routeScopeKind === "portal" ? [portal.uid] : [],
+      layoutUids: portal.routeScopeKind === "layout" ? [portal.layoutUid] : [],
+      selectedPortal: portal,
+      layoutType: portal.layoutType
+    };
+  }
+  assertAdminLayoutCreateScope(actionName, scope, path) {
+    if (!this.navigationTargets.hasMultiPortalCapability() || scope.selectedPortal || !scope.layoutUids.includes(import_navigation_targets.DEFAULT_ADMIN_UI_LAYOUT_UID)) {
+      return;
+    }
+    (0, import_errors.throwBadRequest)(`flowSurfaces ${actionName} cannot create navigation directly in the Admin layout`, {
+      ruleId: "navigation-admin-layout-not-portal-target",
+      path,
+      details: {
+        layoutUid: import_navigation_targets.DEFAULT_ADMIN_UI_LAYOUT_UID,
+        uiBuilderAllowed: false,
+        adminLayoutFallbackAllowed: false,
+        agentInstruction: "Resolve the target Portal first. For a no-code Portal, pass portalUid (navigation.portalUid in applyBlueprint); for an AI Portal, stop this Flow Surfaces write and implement the request in the Portal source code."
+      }
+    });
+  }
+  getPortalRouteFilterUid(portal) {
+    return (portal == null ? void 0 : portal.routeScopeKind) === "portal" ? portal.uid : void 0;
+  }
+  async assertRouteBelongsToResolvedPortal(actionName, route, portal, path, transaction) {
+    if (portal.routeScopeKind === "layout") {
+      await this.assertDesktopRouteBelongsToUiLayout(actionName, route, portal.layoutUid, path, transaction);
+      return;
+    }
+    await this.navigationTargets.assertRouteBelongsToPortal(
+      actionName,
+      this.readRouteField(route, "id"),
+      portal.uid,
+      path,
+      transaction
+    );
+  }
+  async resolveDefaultDesktopRouteScope(actionName, options = {}) {
+    if (this.navigationTargets.hasMultiPortalCapability()) {
+      const portal = await this.navigationTargets.resolveDefaultPortal({
+        actionName,
+        currentRoles: options.currentRoles,
+        transaction: options.transaction
+      });
+      return this.buildDesktopRouteScopeForPortal(portal);
+    }
+    const layoutUids = await this.resolveDefaultDesktopRouteUiLayoutUids(options.transaction);
+    return {
+      portalUids: [],
+      layoutUids,
+      layoutType: layoutUids.length === 1 ? await this.getDesktopRouteUiLayoutTypeByUid(layoutUids[0], options.transaction) : void 0
+    };
+  }
+  async resolveDesktopRouteMatchScope(layoutUid, portalUid, actionName, options = {}) {
+    if (portalUid) {
+      const portal = await this.navigationTargets.resolvePortal(portalUid, {
+        actionName,
+        path: "values.navigation.portalUid",
+        currentRoles: options.currentRoles,
+        transaction: options.transaction
+      });
+      return {
+        layoutUids: portal.routeScopeKind === "layout" ? [portal.layoutUid] : void 0,
+        portalUid: this.getPortalRouteFilterUid(portal)
+      };
+    }
+    if (this.normalizeDesktopRouteLayoutUidFilter(layoutUid).length) {
+      return { layoutUids: layoutUid, portalUid: void 0 };
+    }
+    const defaultScope = await this.resolveDefaultDesktopRouteScope(actionName, options);
+    return {
+      layoutUids: defaultScope.layoutUids.length ? defaultScope.layoutUids : void 0,
+      portalUid: this.getPortalRouteFilterUid(defaultScope.selectedPortal)
+    };
+  }
   async resolveRequestedDesktopRouteScope(values, parentRoute, actionName, options = {}) {
     const layoutUid = this.normalizeExplicitDesktopRouteLayoutUid(values.layoutUid);
     const portalUid = this.navigationTargets.normalizePortalUid(values.portalUid);
@@ -1219,22 +1296,19 @@ class FlowSurfacesService {
         transaction: options.transaction
       });
       if (parentRoute) {
-        await this.navigationTargets.assertRouteBelongsToPortal(
+        await this.assertRouteBelongsToResolvedPortal(
           actionName,
-          this.readRouteField(parentRoute, "id"),
-          portal.uid,
+          parentRoute,
+          portal,
           "values.parentMenuRouteId",
           options.transaction
         );
       }
-      return {
-        portalUids: [portal.uid],
-        layoutUids: [],
-        selectedPortal: portal,
-        layoutType: portal.layoutType
-      };
+      return this.buildDesktopRouteScopeForPortal(portal);
     }
     if (layoutUid) {
+      const scope2 = { portalUids: [], layoutUids: [layoutUid] };
+      this.assertAdminLayoutCreateScope(actionName, scope2, "values.layoutUid");
       await this.assertEnabledDesktopRouteUiLayoutUid(layoutUid, actionName, "values.layoutUid", options.transaction);
       if (parentRoute) {
         await this.assertDesktopRouteBelongsToUiLayout(
@@ -1246,8 +1320,7 @@ class FlowSurfacesService {
         );
       }
       return {
-        portalUids: [],
-        layoutUids: [layoutUid],
+        ...scope2,
         layoutType: await this.getDesktopRouteUiLayoutTypeByUid(layoutUid, options.transaction)
       };
     }
@@ -1280,10 +1353,17 @@ class FlowSurfacesService {
         };
       }
     }
+    if (!parentRoute) {
+      return this.resolveDefaultDesktopRouteScope(actionName, options);
+    }
     const layoutUids = await this.resolveInheritedDesktopRouteUiLayoutUids(parentRoute, options.transaction);
-    return {
+    const scope = {
       portalUids: [],
-      layoutUids,
+      layoutUids
+    };
+    this.assertAdminLayoutCreateScope(actionName, scope, "values.parentMenuRouteId");
+    return {
+      ...scope,
       layoutType: layoutUids.length === 1 ? await this.getDesktopRouteUiLayoutTypeByUid(layoutUids[0], options.transaction) : void 0
     };
   }
@@ -1302,20 +1382,18 @@ class FlowSurfacesService {
         currentRoles: options.currentRoles,
         transaction: options.transaction
       });
-      await this.navigationTargets.assertRouteBelongsToPortal(
+      await this.assertRouteBelongsToResolvedPortal(
         actionName,
-        this.readRouteField(route, "id"),
-        portal.uid,
+        route,
+        portal,
         "values.menuRouteId",
         options.transaction
       );
-      return {
-        ...routeScope,
-        selectedPortal: portal,
-        layoutType: portal.layoutType
-      };
+      return this.buildDesktopRouteScopeForPortal(portal);
     }
     if (layoutUid) {
+      const scope2 = { ...routeScope, layoutUids: [layoutUid] };
+      this.assertAdminLayoutCreateScope(actionName, scope2, "values.layoutUid");
       await this.assertEnabledDesktopRouteUiLayoutUid(layoutUid, actionName, "values.layoutUid", options.transaction);
       await this.assertDesktopRouteBelongsToUiLayout(
         actionName,
@@ -1325,7 +1403,7 @@ class FlowSurfacesService {
         options.transaction
       );
       return {
-        ...routeScope,
+        ...scope2,
         layoutType: await this.getDesktopRouteUiLayoutTypeByUid(layoutUid, options.transaction)
       };
     }
@@ -1355,10 +1433,22 @@ class FlowSurfacesService {
         layoutType: portal.layoutType
       };
     }
-    const layoutUids = routeScope.layoutUids.length ? routeScope.layoutUids : await this.ensureDesktopRouteUiLayouts(route, options.transaction);
-    return {
+    let layoutUids = routeScope.layoutUids;
+    if (!layoutUids.length) {
+      const parentRouteId = this.readRouteField(route, "parentId");
+      const parentRoute = import_lodash.default.isNil(parentRouteId) ? null : await this.findMenuRouteById(parentRouteId, options.transaction);
+      layoutUids = await this.resolveInheritedDesktopRouteUiLayoutUids(parentRoute, options.transaction);
+    }
+    const scope = {
       portalUids: [],
-      layoutUids,
+      layoutUids
+    };
+    this.assertAdminLayoutCreateScope(actionName, scope, "values.menuRouteId");
+    if (!routeScope.layoutUids.length) {
+      await this.setDesktopRouteUiLayouts(this.readRouteField(route, "id"), layoutUids, options.transaction);
+    }
+    return {
+      ...scope,
       layoutType: layoutUids.length === 1 ? await this.getDesktopRouteUiLayoutTypeByUid(layoutUids[0], options.transaction) : void 0
     };
   }
@@ -1518,7 +1608,6 @@ class FlowSurfacesService {
     }
   }
   async createFlowMenuGroup(values, options = {}) {
-    var _a;
     const parentRoute = await this.assertMenuParentIsGroup(values.parentMenuRouteId, options.transaction);
     const parentId = this.readRouteField(parentRoute, "id") ?? null;
     const routeScope = await this.resolveRequestedDesktopRouteScope(values, parentRoute, "createMenu", options);
@@ -1528,7 +1617,7 @@ class FlowSurfacesService {
       title,
       options.transaction,
       routeScope.layoutUids,
-      (_a = routeScope.selectedPortal) == null ? void 0 : _a.uid
+      this.getPortalRouteFilterUid(routeScope.selectedPortal)
     );
     if (existingGroups.length === 1) {
       return this.buildMenuResult(existingGroups[0]);
@@ -3569,7 +3658,7 @@ class FlowSurfacesService {
       tabs
     };
   }
-  async resolveApplyBlueprintCreateNavigationGroup(document, transaction) {
+  async resolveApplyBlueprintCreateNavigationGroup(document, options = {}) {
     var _a;
     if (document.mode !== "create" || !import_lodash.default.isPlainObject((_a = document.navigation) == null ? void 0 : _a.group)) {
       return document;
@@ -3583,12 +3672,13 @@ class FlowSurfacesService {
     }
     const layoutUid = this.normalizeExplicitDesktopRouteLayoutUid(document.navigation.layoutUid);
     const portalUid = this.navigationTargets.normalizePortalUid(document.navigation.portalUid);
+    const matchScope = await this.resolveDesktopRouteMatchScope(layoutUid, portalUid, "applyBlueprint", options);
     const matchedRoutes = await this.findMenuGroupRoutesByParentIdAndTitle(
       null,
       groupTitle,
-      transaction,
-      layoutUid || await this.resolveDefaultDesktopRouteUiLayoutUids(transaction),
-      portalUid
+      options.transaction,
+      matchScope.layoutUids,
+      matchScope.portalUid
     );
     if (!matchedRoutes.length) {
       return document;
@@ -3614,6 +3704,24 @@ class FlowSurfacesService {
       }
     };
   }
+  async resolveApplyBlueprintDefaultNavigationTarget(document, options = {}) {
+    var _a, _b, _c, _d;
+    if (document.mode !== "create" || ((_a = document.navigation) == null ? void 0 : _a.layoutUid) || ((_b = document.navigation) == null ? void 0 : _b.portalUid) || !import_lodash.default.isUndefined((_d = (_c = document.navigation) == null ? void 0 : _c.group) == null ? void 0 : _d.routeId) || !this.navigationTargets.hasMultiPortalCapability()) {
+      return document;
+    }
+    const portal = await this.navigationTargets.resolveDefaultPortal({
+      actionName: "applyBlueprint",
+      currentRoles: options.currentRoles,
+      transaction: options.transaction
+    });
+    return {
+      ...document,
+      navigation: {
+        ...document.navigation,
+        portalUid: portal.uid
+      }
+    };
+  }
   async normalizeApplyBlueprintCreateMobileNavigation(document, options = {}) {
     var _a, _b;
     if (document.mode !== "create") {
@@ -3669,15 +3777,20 @@ class FlowSurfacesService {
         return;
       }
       const groupRoute2 = await this.assertMenuParentIsGroup(groupRouteId2, options.transaction);
-      await this.navigationTargets.assertRouteBelongsToPortal(
+      await this.assertRouteBelongsToResolvedPortal(
         "applyBlueprint",
-        this.readRouteField(groupRoute2, "id"),
-        portal.uid,
+        groupRoute2,
+        portal,
         "values.navigation.group.routeId",
         options.transaction
       );
       return;
     }
+    this.assertAdminLayoutCreateScope(
+      "applyBlueprint",
+      { portalUids: [], layoutUids: [layoutUid] },
+      "values.navigation.layoutUid"
+    );
     await this.assertEnabledDesktopRouteUiLayoutUid(
       layoutUid,
       "applyBlueprint",
@@ -3700,7 +3813,7 @@ class FlowSurfacesService {
       options.transaction
     );
   }
-  async resolveApplyBlueprintCreatePageIdentity(document, transaction) {
+  async resolveApplyBlueprintCreatePageIdentity(document, options = {}) {
     var _a, _b, _c, _d, _e, _f, _g;
     if (document.mode !== "create") {
       return document;
@@ -3713,12 +3826,10 @@ class FlowSurfacesService {
     if (!pageTitle || !hasGroupRouteId && !layoutUid && !portalUid) {
       return document;
     }
-    const groupRoute = hasGroupRouteId ? await this.findMenuRouteById(groupRouteId, transaction) : null;
+    const groupRoute = hasGroupRouteId ? await this.findMenuRouteById(groupRouteId, options.transaction) : null;
+    const groupScope = groupRoute && !portalUid ? await this.readDesktopRouteScope(groupRoute, options.transaction) : void 0;
     if (!portalUid && groupRoute) {
-      const groupPortalUids = await this.navigationTargets.readRoutePortalUids(
-        this.readRouteField(groupRoute, "id"),
-        transaction
-      );
+      const groupPortalUids = (groupScope == null ? void 0 : groupScope.portalUids) || [];
       if (groupPortalUids.length > 1) {
         (0, import_errors.throwBadRequest)(
           `flowSurfaces applyBlueprint navigation.group.routeId '${groupRouteId}' belongs to multiple portals; pass navigation.portalUid explicitly`,
@@ -3734,13 +3845,23 @@ class FlowSurfacesService {
       }
       portalUid = groupPortalUids[0];
     }
-    const layoutUidFilter = portalUid ? void 0 : layoutUid || (groupRoute ? await this.resolveInheritedDesktopRouteUiLayoutUids(groupRoute, transaction) : void 0);
+    const portalMatchScope = portalUid ? await this.resolveDesktopRouteMatchScope(layoutUid, portalUid, "applyBlueprint", options) : void 0;
+    let layoutUidFilter = (portalMatchScope == null ? void 0 : portalMatchScope.layoutUids) || layoutUid;
+    if (!portalMatchScope && !layoutUid && groupRoute) {
+      layoutUidFilter = (groupScope == null ? void 0 : groupScope.layoutUids.length) ? groupScope.layoutUids : await this.resolveInheritedDesktopRouteUiLayoutUids(groupRoute, options.transaction);
+      this.assertAdminLayoutCreateScope(
+        "applyBlueprint",
+        { portalUids: [], layoutUids: this.normalizeDesktopRouteLayoutUidFilter(layoutUidFilter) },
+        "values.navigation.group.routeId"
+      );
+    }
+    const portalUidFilter = portalMatchScope == null ? void 0 : portalMatchScope.portalUid;
     const matchedPages = await this.findFlowPageRoutesByParentIdAndTitle(
       hasGroupRouteId ? groupRouteId : null,
       pageTitle,
-      transaction,
+      options.transaction,
       layoutUidFilter,
-      portalUid
+      portalUidFilter
     );
     if (!matchedPages.length) {
       return document;
@@ -3769,14 +3890,15 @@ class FlowSurfacesService {
   }
   async prepareApplyBlueprintRequest(values, options = {}, createdKanbanSortFields) {
     var _a;
-    const initialDocument = (0, import_blueprint.prepareFlowSurfaceApplyBlueprintDocument)(values);
+    const parsedDocument = (0, import_blueprint.prepareFlowSurfaceApplyBlueprintDocument)(values);
+    const initialDocument = await this.resolveApplyBlueprintDefaultNavigationTarget(parsedDocument, options);
     await this.assertApplyBlueprintCreateNavigationTarget(initialDocument, options);
     const mobileNormalizedDocument = await this.normalizeApplyBlueprintCreateMobileNavigation(initialDocument, options);
     const groupResolvedDocument = await this.resolveApplyBlueprintCreateNavigationGroup(
       mobileNormalizedDocument,
-      options.transaction
+      options
     );
-    const document = await this.resolveApplyBlueprintCreatePageIdentity(groupResolvedDocument, options.transaction);
+    const document = await this.resolveApplyBlueprintCreatePageIdentity(groupResolvedDocument, options);
     await this.prepareApplyBlueprintKanbanBlocks(document, options.transaction, createdKanbanSortFields);
     const replaceTarget = document.mode === "replace" && document.target ? await this.resolveApplyBlueprintReplaceTargetInfo(document.target.pageSchemaUid, options.transaction) : void 0;
     if (document.mode === "replace" && document.tabs.length > 1 && typeof ((_a = document.page) == null ? void 0 : _a.enableTabs) === "undefined" && (replaceTarget == null ? void 0 : replaceTarget.pageEnableTabs) === false) {
@@ -4445,7 +4567,18 @@ class FlowSurfacesService {
     await (0, import_authoring_validation.assertFlowSurfaceAuthoringPayload)("applyBlueprint", values, {
       transaction: options.transaction,
       enabledPackages,
-      findMenuGroupRoutesByTitle: (title, transaction, targetLayoutUid, targetPortalUid) => this.findMenuGroupRoutesByTitle(title, transaction, targetLayoutUid, targetPortalUid),
+      findMenuGroupRoutesByTitle: async (title, transaction, targetLayoutUid, targetPortalUid) => {
+        const matchScope = await this.resolveDesktopRouteMatchScope(
+          targetLayoutUid,
+          targetPortalUid,
+          "applyBlueprint",
+          {
+            transaction,
+            currentRoles: options.currentRoles
+          }
+        );
+        return this.findMenuGroupRoutesByTitle(title, transaction, matchScope.layoutUids, matchScope.portalUid);
+      },
       getUiLayoutTypeByUid: (layoutUid2, transaction) => this.getDesktopRouteUiLayoutTypeByUid(layoutUid2, transaction),
       getPortalLayoutTypeByUid: async (targetPortalUid, transaction) => {
         if ((resolvedPortal == null ? void 0 : resolvedPortal.uid) === targetPortalUid) {
@@ -6515,18 +6648,18 @@ class FlowSurfacesService {
         currentRoles: options.currentRoles,
         transaction: options.transaction
       });
-      await this.navigationTargets.assertRouteBelongsToPortal(
+      await this.assertRouteBelongsToResolvedPortal(
         "updateMenu",
-        this.readRouteField(route, "id"),
-        portal.uid,
+        route,
+        portal,
         "values.menuRouteId",
         options.transaction
       );
       if (nextParentRoute) {
-        await this.navigationTargets.assertRouteBelongsToPortal(
+        await this.assertRouteBelongsToResolvedPortal(
           "updateMenu",
-          this.readRouteField(nextParentRoute, "id"),
-          portal.uid,
+          nextParentRoute,
+          portal,
           "values.parentMenuRouteId",
           options.transaction
         );

package/dist/swagger/flow-surfaces.js

@@ -621,7 +621,7 @@ const actionDocs = {
   },
   listNavigationTargets: {
     tags: [FLOW_SURFACES_TAG],
-    summary: "List available UI layouts and role-accessible Multi-portal workspaces",
+    summary: "List available UI layouts and role-accessible Multi-portal entries",
     description: valuesCompatibilityNote(
       `Returns the default Admin target, enabled UI layouts, and enabled custom Multi-portal targets visible to the current roles. capabilities.multiPortal=false and an empty custom-portal set are normal when the commercial Multi-portal capability is not installed. Reserved default portal records are never returned as custom workspaces; Admin and Mobile use their ordinary layout uids. Call this action only when the user explicitly names a workspace or asks to discover navigation targets. ${FLOW_SURFACES_READ_ACL_NOTE}`
     ),
@@ -632,7 +632,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Apply a page blueprint to create or replace one Modern page",
     description: valuesCompatibilityNote(
-      `In create mode, \`navigation.portalUid\` targets one enabled, role-accessible Multi-portal workspace and is mutually exclusive with \`navigation.layoutUid\`. Portal-backed mobile layouts ignore \`navigation.group\`, while desktop-backed portals scope group reuse and duplicate-page identity to that portal. If Multi-portal is unavailable, ordinary requests without \`portalUid\` keep their existing Admin behavior. Accepts one simplified JSON page blueprint and compiles it to internal flow-surface operations. The public blueprint describes page structure (\`create\` or \`replace\`, page metadata, ordered tabs, blocks, fields, actions, inline popups, optional reusable assets) and optional top-level \`reaction.items[]\` for whole-page interaction authoring. Each reaction item targets an explicit local key / bind key produced by the same blueprint run. Only explicitly listed reaction items are written. \`rules: []\` clears the targeted slot. Repeating the same \`(type, target)\` reaction slot in one blueprint is invalid. In \`replace\`, reaction targets always bind to the newly produced blueprint result, not historical nodes from the previous page version; if a slot must exist in the resulting surface, include it explicitly instead of relying on omission. Localized reaction edits on an existing surface should use \`getReactionMeta\` + \`set*Rules\` instead of applying a whole page blueprint again. The request body is that page-document JSON object itself and must not be JSON-stringified. Wrong: \`{ "requestBody": "{\\"version\\":\\"1\\"}" }\`. Internal planning details stay hidden. In \`create\`, \`navigation.layoutUid\` optionally scopes menu group reuse, duplicate page identity checks, and newly created routes to an enabled UI layout such as \`admin-layout-model\` or \`mobile-layout-model\`; when the target layout type is mobile, applyBlueprint ignores \`navigation.group\` and creates a root-level mobile tab page. When \`layoutUid\` is omitted, routes keep the existing admin/default inheritance behavior. In non-mobile \`create\`, \`navigation.group.routeId\` has the highest priority when targeting an existing menu group. If \`routeId\` is present, applyBlueprint ignores \`title\`, \`icon\`, \`tooltip\`, and \`hideInMenu\` on \`navigation.group\`; applyBlueprint create mode does not mutate existing group metadata, so callers should use \`updateMenu\` separately when that is required. When \`routeId\` is omitted and \`navigation.group.title\` is provided, applyBlueprint reuses one existing same-title group in the target layout when it is unique, creates a new group when none exists, and rejects ambiguous multi-match cases. Metadata such as \`icon\`, \`tooltip\`, and \`hideInMenu\` is used only when a new group is created and is ignored when an existing group is reused. \`replace\` uses \`target.pageSchemaUid\`, updates only the explicit page-level fields provided in \`page\`, maps blueprint tabs to existing route-backed tab slots by index, rewrites each slot in order, removes trailing old tabs, and appends extra new tabs when needed. Tab and block keys are optional in the public blueprint; omit them unless custom layout or cross-block targeting needs a stable in-document identifier. \`layout\` is only allowed on tabs and inline popup documents; blocks themselves do not accept a \`layout\` property. Public applyBlueprint blocks do not support generic \`form\`; use \`editForm\` or \`createForm\`. AI employee actions use \`type: "aiEmployee"\` plus public \`settings.username\`, \`workContext\`, \`tasks\`, \`auto\`, and \`style\`; work context may target \`self\` or a same-blueprint block key and is persisted as real Flow Model \`uid\` values. For JS blocks/fields/actions, \`script\` is a non-empty string asset key into \`assets.scripts\`; put inline JS in \`settings.code\` and \`settings.version\`. Direct \`table\` / \`list\` / \`gridCard\` / \`calendar\` / \`kanban\` blocks may omit \`defaultFilter\`; the backend generates one from live metadata with up to 4 scalar/filterable fields. Explicit values must contain at least the smaller of 3 and the collection eligible-field count, and values with more than 4 fields are truncated before persistence. A valid explicit or generated block-level value backfills the default \`filter\` action \`settings.defaultFilter\`; explicit filter-action \`settings.defaultFilter\` still wins. ${TREE_TABLE_RECORD_ACTION_DEFAULTS_NOTE} ${APPLY_BLUEPRINT_TREE_TABLE_TITLE_FIELD_NOTE} Inline popup documents may set \`popup.tryTemplate=true\` to ask the backend for the best compatible popup template before falling back to local popup content. Inline popup documents may also combine \`popup.tryTemplate\` with \`popup.saveAsTemplate={ name, description, local? }\`: a hit binds the matched template immediately and lets later inline popups in the same blueprint reuse that final bound template through \`popup.template={ local, mode }\`, while a miss requires explicit local \`popup.blocks\` so the fallback popup can be saved and reused. Custom \`edit\` popups that provide \`popup.blocks\` must include exactly one \`editForm\` block; that \`editForm\` may omit \`resource\` and then inherits the opener's current-record context. When layout is omitted, applyBlueprint auto-generates a simple top-to-bottom layout. When a \`replace\` run expands a page to multiple tabs while the current page still has \`enableTabs=false\`, callers must set \`page.enableTabs=true\` explicitly. The response hides execution internals and returns only the resolved page target and final surface readback.`
+      `In create mode, \`navigation.portalUid\` targets one enabled, role-accessible Multi-portal entry and is mutually exclusive with \`navigation.layoutUid\`. Portal-backed mobile layouts ignore \`navigation.group\`, while desktop-backed portals scope group reuse and duplicate-page identity to that portal. If Multi-portal is unavailable, ordinary requests without \`portalUid\` keep their existing Admin behavior. Accepts one simplified JSON page blueprint and compiles it to internal flow-surface operations. The public blueprint describes page structure (\`create\` or \`replace\`, page metadata, ordered tabs, blocks, fields, actions, inline popups, optional reusable assets) and optional top-level \`reaction.items[]\` for whole-page interaction authoring. Each reaction item targets an explicit local key / bind key produced by the same blueprint run. Only explicitly listed reaction items are written. \`rules: []\` clears the targeted slot. Repeating the same \`(type, target)\` reaction slot in one blueprint is invalid. In \`replace\`, reaction targets always bind to the newly produced blueprint result, not historical nodes from the previous page version; if a slot must exist in the resulting surface, include it explicitly instead of relying on omission. Localized reaction edits on an existing surface should use \`getReactionMeta\` + \`set*Rules\` instead of applying a whole page blueprint again. The request body is that page-document JSON object itself and must not be JSON-stringified. Wrong: \`{ "requestBody": "{\\"version\\":\\"1\\"}" }\`. Internal planning details stay hidden. In \`create\`, \`navigation.layoutUid\` optionally scopes menu group reuse, duplicate page identity checks, and newly created routes to an enabled UI layout such as \`admin-layout-model\` or \`mobile-layout-model\`; when the target layout type is mobile, applyBlueprint ignores \`navigation.group\` and creates a root-level mobile tab page. When \`layoutUid\` is omitted, routes keep the existing admin/default inheritance behavior. In non-mobile \`create\`, \`navigation.group.routeId\` has the highest priority when targeting an existing menu group. If \`routeId\` is present, applyBlueprint ignores \`title\`, \`icon\`, \`tooltip\`, and \`hideInMenu\` on \`navigation.group\`; applyBlueprint create mode does not mutate existing group metadata, so callers should use \`updateMenu\` separately when that is required. When \`routeId\` is omitted and \`navigation.group.title\` is provided, applyBlueprint reuses one existing same-title group in the target layout when it is unique, creates a new group when none exists, and rejects ambiguous multi-match cases. Metadata such as \`icon\`, \`tooltip\`, and \`hideInMenu\` is used only when a new group is created and is ignored when an existing group is reused. \`replace\` uses \`target.pageSchemaUid\`, updates only the explicit page-level fields provided in \`page\`, maps blueprint tabs to existing route-backed tab slots by index, rewrites each slot in order, removes trailing old tabs, and appends extra new tabs when needed. Tab and block keys are optional in the public blueprint; omit them unless custom layout or cross-block targeting needs a stable in-document identifier. \`layout\` is only allowed on tabs and inline popup documents; blocks themselves do not accept a \`layout\` property. Public applyBlueprint blocks do not support generic \`form\`; use \`editForm\` or \`createForm\`. AI employee actions use \`type: "aiEmployee"\` plus public \`settings.username\`, \`workContext\`, \`tasks\`, \`auto\`, and \`style\`; work context may target \`self\` or a same-blueprint block key and is persisted as real Flow Model \`uid\` values. For JS blocks/fields/actions, \`script\` is a non-empty string asset key into \`assets.scripts\`; put inline JS in \`settings.code\` and \`settings.version\`. Direct \`table\` / \`list\` / \`gridCard\` / \`calendar\` / \`kanban\` blocks may omit \`defaultFilter\`; the backend generates one from live metadata with up to 4 scalar/filterable fields. Explicit values must contain at least the smaller of 3 and the collection eligible-field count, and values with more than 4 fields are truncated before persistence. A valid explicit or generated block-level value backfills the default \`filter\` action \`settings.defaultFilter\`; explicit filter-action \`settings.defaultFilter\` still wins. ${TREE_TABLE_RECORD_ACTION_DEFAULTS_NOTE} ${APPLY_BLUEPRINT_TREE_TABLE_TITLE_FIELD_NOTE} Inline popup documents may set \`popup.tryTemplate=true\` to ask the backend for the best compatible popup template before falling back to local popup content. Inline popup documents may also combine \`popup.tryTemplate\` with \`popup.saveAsTemplate={ name, description, local? }\`: a hit binds the matched template immediately and lets later inline popups in the same blueprint reuse that final bound template through \`popup.template={ local, mode }\`, while a miss requires explicit local \`popup.blocks\` so the fallback popup can be saved and reused. Custom \`edit\` popups that provide \`popup.blocks\` must include exactly one \`editForm\` block; that \`editForm\` may omit \`resource\` and then inherits the opener's current-record context. When layout is omitted, applyBlueprint auto-generates a simple top-to-bottom layout. When a \`replace\` run expands a page to multiple tabs while the current page still has \`enableTabs=false\`, callers must set \`page.enableTabs=true\` explicitly. The response hides execution internals and returns only the resolved page target and final surface readback.`
     ),
     requestBody: {
       required: true,
@@ -818,7 +818,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Create a group menu or a bindable V2 menu item",
     description: valuesCompatibilityNote(
-      'Creates a FlowSurfaces menu node. `type="group"` creates a menu group. `type="item"` creates a menu item that can be bound to a modern page (v2), and automatically fills in the flowPage route, the default hidden tab route, and the RootPageModel anchor. Optional `layoutUid` scopes the route to an enabled UI layout. Optional `portalUid` scopes it to one enabled, role-accessible Multi-portal workspace and is mutually exclusive with `layoutUid`. Omitted values keep the existing parent/default admin inheritance.'
+      'Creates a FlowSurfaces menu node. `type="group"` creates a menu group. `type="item"` creates a menu item that can be bound to a modern page (v2), and automatically fills in the flowPage route, the default hidden tab route, and the RootPageModel anchor. Optional `layoutUid` scopes the route to an enabled UI layout. Optional `portalUid` scopes it to one enabled, role-accessible Multi-portal entry and is mutually exclusive with `layoutUid`. Omitted values keep the existing parent/default admin inheritance.'
     ),
     requestBody: requestBody("FlowSurfaceCreateMenuRequest", import_flow_surfaces.flowSurfaceExamples.createMenu),
     responses: responses("FlowSurfaceCreateMenuResult")
@@ -827,7 +827,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Update menu title/icon/tooltip or move it under another group",
     description: valuesCompatibilityNote(
-      "Updates menu display information, or moves a group / item to the top level or under another group. Only `group` and `flowPage` menu nodes are supported. Pass `portalUid` when explicitly targeting a Multi-portal workspace; the route and new parent must already belong to that portal."
+      "Updates menu display information, or moves a group / item to the top level or under another group. Only `group` and `flowPage` menu nodes are supported. Pass `portalUid` when explicitly targeting a Multi-portal entry; the route and new parent must already belong to that portal."
     ),
     requestBody: requestBody("FlowSurfaceUpdateMenuRequest", import_flow_surfaces.flowSurfaceExamples.updateMenu),
     responses: responses("FlowSurfaceUpdateMenuResult")
@@ -836,7 +836,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Initialize a modern page for an existing bindable menu item",
     description: valuesCompatibilityNote(
-      "Initializes a modern page (v2) for an existing bindable menu item through `menuRouteId` first, and fills in the default BlockGridModel. Optional `layoutUid` asserts that the existing menu route belongs to the target UI layout. Optional `portalUid` asserts that it belongs to one enabled, role-accessible Multi-portal workspace and is mutually exclusive with `layoutUid`. Omitted values preserve the route scope and keep default admin compatibility. In compatibility mode, if `menuRouteId` is omitted, the old behavior still applies and a top-level menu plus page will be created automatically. Before initialization, do not call page/tab lifecycle actions such as `addTab`, `updateTab`, `moveTab`, `removeTab`, or `destroyPage`."
+      "Initializes a modern page (v2) for an existing bindable menu item through `menuRouteId` first, and fills in the default BlockGridModel. Optional `layoutUid` asserts that the existing menu route belongs to the target UI layout. Optional `portalUid` asserts that it belongs to one enabled, role-accessible Multi-portal entry and is mutually exclusive with `layoutUid`. Omitted values preserve the route scope and keep default admin compatibility. In compatibility mode, if `menuRouteId` is omitted, the old behavior still applies and a top-level menu plus page will be created automatically. Before initialization, do not call page/tab lifecycle actions such as `addTab`, `updateTab`, `moveTab`, `removeTab`, or `destroyPage`."
     ),
     requestBody: requestBody("FlowSurfaceCreatePageRequest", import_flow_surfaces.flowSurfaceExamples.createPage),
     responses: responses("FlowSurfaceCreatePageResult")

package/package.json

@@ -4,7 +4,7 @@
   "displayName.zh-CN": "前端流引擎",
   "description": "",
   "description.zh-CN": "",
-  "version": "2.3.0-beta.5",
+  "version": "2.4.0-alpha.1",
   "main": "./dist/server/index.js",
   "license": "Apache-2.0",
   "devDependencies": {
@@ -26,5 +26,5 @@
     "@nocobase/test": "2.x",
     "@nocobase/utils": "2.x"
   },
-  "gitHead": "7047516aba0d14965ddf457b64587103a871b923"
+  "gitHead": "82ecd3aed067e4cc98c32e7a0039b6e55cee76a7"
 }