@nocobase/app 2.1.0-alpha.45 → 2.1.0-alpha.47

package/client/public/browser-checker.js

@@ -1,14 +1,35 @@
-const basename = window['__nocobase_public_path__'] || '/';
-let currentPath = window.location.pathname;
-if (currentPath === basename.slice(0, -1)) {
+function ensureLeadingSlash(value) {
+  if (!value) {
+    return '/';
+  }
+  return value.startsWith('/') ? value : `/${value}`;
+}
+
+function ensureTrailingSlash(value) {
+  if (!value) {
+    return '/';
+  }
+  return value.endsWith('/') ? value : `${value}/`;
+}
+
+function normalizePublicPath(value) {
+  const normalized = ensureLeadingSlash(String(value || '/').trim() || '/').replace(/\/{2,}/g, '/');
+  return ensureTrailingSlash(normalized);
+}
+
+const basename = normalizePublicPath(window['__nocobase_public_path__'] || '/');
+const currentPath = ensureLeadingSlash(String(window.location.pathname || '/').trim() || '/').replace(/\/{2,}/g, '/');
+const basenameWithoutTrailingSlash = basename === '/' ? '/' : basename.replace(/\/+$/, '');
+
+if (currentPath === basenameWithoutTrailingSlash) {
   const newUrl = `${window.location.origin}${basename}${window.location.search}${window.location.hash}`;
   window.location.replace(newUrl);
-} else if (!currentPath.startsWith(basename)) {
-  let newPath = basename + (currentPath.startsWith('/') ? currentPath.slice(1) : currentPath);
+} else if (basename !== '/' && !currentPath.startsWith(basename)) {
+  const newPath = currentPath === '/' ? basename : `${basenameWithoutTrailingSlash}${currentPath}`;
   let newUrl = window.location.origin + newPath + window.location.search + window.location.hash;
   window.location.replace(newUrl);
 }
-showLog = true;
+let showLog = true;
 function log(m) {
   if (window.console && showLog) {
     console.log(m);
@@ -46,7 +67,7 @@ function css_browser_selector(u) {
     dv = 'device_',
     html = document.documentElement,
     b = [
-      (!/opera|webtv/i.test(ua) && /msie\s(\d+)/.test(ua)) || /trident\/.*rv:([0-9]{1,}[\.0-9]{0,})/.test(ua)
+      (!/opera|webtv/i.test(ua) && /msie\s(\d+)/.test(ua)) || /trident\/.*rv:([0-9]{1,}[.0-9]{0,})/.test(ua)
         ? 'ie ie' + (/trident\/4\.0/.test(ua) ? '8' : RegExp.$1 == '11.0' ? '11' : RegExp.$1)
         : is('firefox/')
         ? g +
@@ -70,7 +91,7 @@ function css_browser_selector(u) {
         ? bb +
           (/Version\/(\d+)(\.(\d+)+)/i.test(ua)
             ? ' ' + bb + RegExp.$1 + ' ' + bb + RegExp.$1 + RegExp.$2.replace('.', '_')
-            : /Blackberry ?(([0-9]+)([a-z]?))[\/|;]/gi.test(ua)
+            : /Blackberry ?(([0-9]+)([a-z]?))[/|;]/gi.test(ua)
             ? ' ' + bb + RegExp.$2 + (RegExp.$3 ? ' ' + bb + RegExp.$2 + RegExp.$3 : '')
             : '')
         : is('android')
@@ -112,7 +133,7 @@ function css_browser_selector(u) {
       is('j2me')
         ? 'j2me'
         : is('ipad|ipod|iphone')
-        ? (/CPU( iPhone)? OS (\d+[_|\.]\d+([_|\.]\d+)*)/i.test(ua) ? 'ios' + version('ios', RegExp.$2) : '') +
+        ? (/CPU( iPhone)? OS (\d+[_.]\d+([_.]\d+)*)/i.test(ua) ? 'ios' + version('ios', RegExp.$2) : '') +
           ' ' +
           (/(ip(ad|od|hone))/gi.test(ua) ? RegExp.$1 : '')
         : is('playbook')
@@ -144,7 +165,7 @@ function css_browser_selector(u) {
         : is('x11|linux')
         ? 'linux'
         : '',
-      /[; |\[](([a-z]{2})(\-[a-z]{2})?)[)|;|\]]/i.test(ua)
+      /(?:[; |]|\[)(([a-z]{2})(-[a-z]{2})?)(?:\)|;|\||])/i.test(ua)
         ? (lang + RegExp.$2).replace('-', '_') + (RegExp.$3 != '' ? (' ' + lang + RegExp.$1).replace('-', '_') : '')
         : '',
       is('ipad|iphone|ipod') && !is('safari') ? 'ipad_app' : '',
@@ -161,7 +182,7 @@ function css_browser_selector(u) {
         break;
       }
     }
-    widthClasses = '';
+    let widthClasses = '';
     for (var info in uaInfo) {
       widthClasses += ' ' + info + '_' + uaInfo[info];
     }

package/client/rsbuild.config.ts

@@ -99,7 +99,14 @@ export default defineConfig(({ command }) => {
   const localStorageBasePath = ensurePublicPath(`${resolvedAppPublicPath}storage/uploads/`, '/storage/uploads/');
   const staticBasePath = ensurePublicPath(`${resolvedAppPublicPath}static/`, '/static/');
   const wsBasePath = ensurePublicPath(process.env.WS_PATH, '/ws/');
-  const v2BasePath = ensurePublicPath(`${resolvedAppPublicPath.replace(/\/$/, '')}/v2/`, '/v2/');
+  const modernClientPrefix =
+    String(process.env.APP_MODERN_CLIENT_PREFIX || 'v')
+      .trim()
+      .replace(/^\/+|\/+$/g, '') || 'v';
+  const v2BasePath = ensurePublicPath(
+    `${resolvedAppPublicPath.replace(/\/$/, '')}/${modernClientPrefix}/`,
+    `/${modernClientPrefix}/`,
+  );
   const clientPort = toNumber(process.env.APP_PORT, 13001);
   const v2Port = toNumber(process.env.APP_V2_PORT, clientPort + 2);
   const hmrPath = `${resolvedAppPublicPath.replace(/\/$/, '')}/__rspack_hmr`;

package/client-v2/public/browser-checker.js

@@ -1,14 +1,35 @@
-const basename = window['__nocobase_public_path__'] || '/';
-let currentPath = window.location.pathname;
-if (currentPath === basename.slice(0, -1)) {
+function ensureLeadingSlash(value) {
+  if (!value) {
+    return '/';
+  }
+  return value.startsWith('/') ? value : `/${value}`;
+}
+
+function ensureTrailingSlash(value) {
+  if (!value) {
+    return '/';
+  }
+  return value.endsWith('/') ? value : `${value}/`;
+}
+
+function normalizePublicPath(value) {
+  const normalized = ensureLeadingSlash(String(value || '/').trim() || '/').replace(/\/{2,}/g, '/');
+  return ensureTrailingSlash(normalized);
+}
+
+const basename = normalizePublicPath(window['__nocobase_public_path__'] || '/');
+const currentPath = ensureLeadingSlash(String(window.location.pathname || '/').trim() || '/').replace(/\/{2,}/g, '/');
+const basenameWithoutTrailingSlash = basename === '/' ? '/' : basename.replace(/\/+$/, '');
+
+if (currentPath === basenameWithoutTrailingSlash) {
   const newUrl = `${window.location.origin}${basename}${window.location.search}${window.location.hash}`;
   window.location.replace(newUrl);
-} else if (!currentPath.startsWith(basename)) {
-  let newPath = basename + (currentPath.startsWith('/') ? currentPath.slice(1) : currentPath);
+} else if (basename !== '/' && !currentPath.startsWith(basename)) {
+  const newPath = currentPath === '/' ? basename : `${basenameWithoutTrailingSlash}${currentPath}`;
   let newUrl = window.location.origin + newPath + window.location.search + window.location.hash;
   window.location.replace(newUrl);
 }
-showLog = true;
+let showLog = true;
 function log(m) {
   if (window.console && showLog) {
     console.log(m);
@@ -46,7 +67,7 @@ function css_browser_selector(u) {
     dv = 'device_',
     html = document.documentElement,
     b = [
-      (!/opera|webtv/i.test(ua) && /msie\s(\d+)/.test(ua)) || /trident\/.*rv:([0-9]{1,}[\.0-9]{0,})/.test(ua)
+      (!/opera|webtv/i.test(ua) && /msie\s(\d+)/.test(ua)) || /trident\/.*rv:([0-9]{1,}[.0-9]{0,})/.test(ua)
         ? 'ie ie' + (/trident\/4\.0/.test(ua) ? '8' : RegExp.$1 == '11.0' ? '11' : RegExp.$1)
         : is('firefox/')
         ? g +
@@ -70,7 +91,7 @@ function css_browser_selector(u) {
         ? bb +
           (/Version\/(\d+)(\.(\d+)+)/i.test(ua)
             ? ' ' + bb + RegExp.$1 + ' ' + bb + RegExp.$1 + RegExp.$2.replace('.', '_')
-            : /Blackberry ?(([0-9]+)([a-z]?))[\/|;]/gi.test(ua)
+            : /Blackberry ?(([0-9]+)([a-z]?))[/|;]/gi.test(ua)
             ? ' ' + bb + RegExp.$2 + (RegExp.$3 ? ' ' + bb + RegExp.$2 + RegExp.$3 : '')
             : '')
         : is('android')
@@ -112,7 +133,7 @@ function css_browser_selector(u) {
       is('j2me')
         ? 'j2me'
         : is('ipad|ipod|iphone')
-        ? (/CPU( iPhone)? OS (\d+[_|\.]\d+([_|\.]\d+)*)/i.test(ua) ? 'ios' + version('ios', RegExp.$2) : '') +
+        ? (/CPU( iPhone)? OS (\d+[_.]\d+([_.]\d+)*)/i.test(ua) ? 'ios' + version('ios', RegExp.$2) : '') +
           ' ' +
           (/(ip(ad|od|hone))/gi.test(ua) ? RegExp.$1 : '')
         : is('playbook')
@@ -144,7 +165,7 @@ function css_browser_selector(u) {
         : is('x11|linux')
         ? 'linux'
         : '',
-      /[; |\[](([a-z]{2})(\-[a-z]{2})?)[)|;|\]]/i.test(ua)
+      /(?:[; |]|\[)(([a-z]{2})(-[a-z]{2})?)(?:\)|;|\||])/i.test(ua)
         ? (lang + RegExp.$2).replace('-', '_') + (RegExp.$3 != '' ? (' ' + lang + RegExp.$1).replace('-', '_') : '')
         : '',
       is('ipad|iphone|ipod') && !is('safari') ? 'ipad_app' : '',
@@ -161,7 +182,7 @@ function css_browser_selector(u) {
         break;
       }
     }
-    widthClasses = '';
+    let widthClasses = '';
     for (var info in uaInfo) {
       widthClasses += ' ' + info + '_' + uaInfo[info];
     }

package/client-v2/rsbuild.config.ts

@@ -21,8 +21,23 @@ const __dirname = path.dirname(__filename);
 
 generateV2Plugins();
 
+// Fixed on-disk build-output directory name for the modern (v2) client. A
+// sibling copy of this default lives in packages/core/cli-v1/src/util.js
+// (DEFAULT_MODERN_CLIENT_PREFIX) and packages/core/server/src/gateway (utils.ts
+// MODERN_CLIENT_DIST_DIR). Keep them in sync. See docs/adr/0001-modern-client-prefix.md.
+const MODERN_CLIENT_DIST_DIR = 'v';
+
+// Normalize APP_MODERN_CLIENT_PREFIX (accepts `v`, `/v`, `/v/`)
+// to a bare segment, falling back to the fixed dist dir name.
+function normalizeModernClientPrefix(value: string | undefined) {
+  const segment = String(value || '')
+    .trim()
+    .replace(/^\/+|\/+$/g, '');
+  return segment || MODERN_CLIENT_DIST_DIR;
+}
+
 function ensurePublicPath(value: string) {
-  let normalized = value || '/v2/';
+  let normalized = value || `/${MODERN_CLIENT_DIST_DIR}/`;
   if (!normalized.startsWith('/')) {
     normalized = `/${normalized}`;
   }
@@ -37,10 +52,13 @@ function toNumber(value: string | undefined, fallback: number) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 
-function createRuntimeHeadScript(v2PublicPath: string, isBuild: boolean) {
+function createRuntimeHeadScript(v2PublicPath: string, isBuild: boolean, modernClientPrefix: string) {
   if (!isBuild) {
     return [
       `window['__nocobase_public_path__'] = window['__nocobase_public_path__'] || ${JSON.stringify(v2PublicPath)};`,
+      `window['__nocobase_modern_client_prefix__'] = window['__nocobase_modern_client_prefix__'] || ${JSON.stringify(
+        modernClientPrefix,
+      )};`,
       `window['__nocobase_app_dev__'] = window['__nocobase_app_dev__'] || ${JSON.stringify(
         process.env.NOCOBASE_APP_DEV === 'true',
       )};`,
@@ -55,6 +73,9 @@ function createRuntimeHeadScript(v2PublicPath: string, isBuild: boolean) {
 
   return [
     `window['__nocobase_public_path__'] = window['__nocobase_public_path__'] || ${JSON.stringify(v2PublicPath)};`,
+    `window['__nocobase_modern_client_prefix__'] = window['__nocobase_modern_client_prefix__'] || ${JSON.stringify(
+      modernClientPrefix,
+    )};`,
     `window['__nocobase_api_base_url__'] = window['__nocobase_api_base_url__'] || ${JSON.stringify(
       process.env.API_BASE_URL || process.env.API_BASE_PATH || '',
     )};`,
@@ -104,7 +125,13 @@ export default defineConfig(({ command }) => {
   const apiBasePath = ensurePublicPath(process.env.API_BASE_PATH || '/api/');
   const localStorageBasePath = ensurePublicPath(`${appPublicPath.replace(/\/$/, '')}/storage/uploads/`);
   const staticBasePath = ensurePublicPath(`${appPublicPath.replace(/\/$/, '')}/static/`);
-  const v2PublicPath = ensurePublicPath(`${appPublicPath.replace(/\/$/, '')}/v2/`);
+  const modernClientPrefix = normalizeModernClientPrefix(process.env.APP_MODERN_CLIENT_PREFIX);
+  // Build bakes the FIXED dist-dir segment (`/v/`) as a sentinel that the
+  // server rewrites to the runtime prefix per request. Dev serves under the
+  // actual runtime prefix so URLs line up with the v1 dev proxy.
+  const modernClientDistPath = ensurePublicPath(`${appPublicPath.replace(/\/$/, '')}/${MODERN_CLIENT_DIST_DIR}/`);
+  const modernClientPublicPath = ensurePublicPath(`${appPublicPath.replace(/\/$/, '')}/${modernClientPrefix}/`);
+  const v2PublicPath = isBuild ? modernClientDistPath : modernClientPublicPath;
   const wsBasePath = ensurePublicPath(process.env.WS_PATH || '/ws/');
   const hmrPath = `${v2PublicPath.replace(/\/$/, '')}/__rspack_hmr`;
   const v2Port = toNumber(process.env.APP_V2_PORT, 13002);
@@ -151,7 +178,11 @@ export default defineConfig(({ command }) => {
         },
         {
           tag: 'script',
-          children: createRuntimeHeadScript(v2PublicPath, isBuild),
+          children: createRuntimeHeadScript(
+            v2PublicPath,
+            isBuild,
+            isBuild ? MODERN_CLIENT_DIST_DIR : modernClientPrefix,
+          ),
           head: true,
           append: false,
         },
@@ -169,7 +200,7 @@ export default defineConfig(({ command }) => {
     output: {
       target: 'web',
       distPath: {
-        root: path.resolve(__dirname, '../dist/client/v2'),
+        root: path.resolve(__dirname, `../dist/client/${MODERN_CLIENT_DIST_DIR}`),
         js: 'assets',
         jsAsync: 'assets',
         css: 'assets',

package/client-v2/src/main.tsx

@@ -7,13 +7,15 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 
-import { Application } from '@nocobase/client-v2';
+import { Application, getModernClientPrefix } from '@nocobase/client-v2';
 import devDynamicImport from './.plugins';
 import { NocoBaseClientPresetPluginV2 } from '@nocobase/preset-nocobase/client-v2';
 
 declare global {
   interface Window {
     __nocobase_public_path__?: string;
+    __nocobase_modern_client_prefix__?: string;
+    __webpack_public_path__?: string;
     __nocobase_api_base_url__?: string;
     __nocobase_api_client_storage_prefix__?: string;
     __nocobase_api_client_storage_type__?: string;
@@ -38,8 +40,20 @@ function ensureSlash(pathname: string, fallback: string) {
   return normalized;
 }
 
+function getModernPrefixSuffix() {
+  return `/${getModernClientPrefix()}/`;
+}
+
+function stripPrefixSuffix(value: string) {
+  const suffix = getModernPrefixSuffix();
+  if (value.endsWith(suffix)) {
+    return ensureSlash(value.slice(0, value.length - suffix.length), '/');
+  }
+  return ensureSlash(value, '/');
+}
+
 function inferRootPublicPathFromLocation() {
-  const marker = '/v2/';
+  const marker = getModernPrefixSuffix();
   const pathname = window.location.pathname;
   const index = pathname.indexOf(marker);
   if (index >= 0) {
@@ -51,17 +65,18 @@ function inferRootPublicPathFromLocation() {
 function getRootPublicPath() {
   const fromWindow = window.__nocobase_public_path__;
   if (fromWindow) {
-    return ensureSlash(fromWindow.replace(/\/v2\/$/, '/'), '/');
+    return stripPrefixSuffix(ensureSlash(fromWindow, '/'));
   }
   const fromBase = import.meta.env.BASE_URL;
   if (fromBase) {
-    return ensureSlash(fromBase.replace(/\/v2\/$/, '/'), '/');
+    return stripPrefixSuffix(ensureSlash(fromBase, '/'));
   }
   return inferRootPublicPathFromLocation();
 }
 
 function getV2PublicPath() {
-  return ensureSlash(`${getRootPublicPath().replace(/\/$/, '')}/v2/`, '/v2/');
+  const suffix = getModernPrefixSuffix();
+  return ensureSlash(`${getRootPublicPath().replace(/\/$/, '')}${suffix}`, suffix);
 }
 
 function parseShareToken(value: boolean | string | undefined) {
@@ -83,6 +98,25 @@ function parseStorageType(value: string | undefined): ClientStorageType {
 const rootPublicPath = getRootPublicPath();
 const v2PublicPath = getV2PublicPath();
 
+// The fixed build-output directory segment baked into asset paths at build time
+// (e.g. `v`), derived from the baked BASE_URL. Distinct from the runtime
+// modern-client prefix, which may be overridden per-deployment.
+function getBuildAssetDir() {
+  const base = (import.meta.env.BASE_URL || '/v/').replace(/\/+$/, '');
+  return base.split('/').pop() || 'v';
+}
+
+// Point dynamically-imported chunks of the main bundle at the runtime modern
+// client asset path, so a runtime prefix override / sub-path deployment / CDN
+// works without rebuilding (mirrors AutoInjectPublicPathPlugin used for plugins).
+// `__webpack_public_path__` is a webpack magic global that must be assigned.
+declare let __webpack_public_path__: string;
+const cdnBase = window.__webpack_public_path__;
+// eslint-disable-next-line prefer-const
+__webpack_public_path__ = cdnBase
+  ? ensureSlash(`${cdnBase.replace(/\/$/, '')}/${getBuildAssetDir()}/`, '/')
+  : v2PublicPath;
+
 const app = new Application({
   publicPath: v2PublicPath,
   apiClient: {

package/dist/client/assets/1507-be1bb59f.js

@@ -0,0 +1,7 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["1507"],{98542(e,n,t){t.r(n),t.d(n,{JSFieldRunJSContext:()=>l});var a=t(29007),o=t(4418);class l extends a.uk{}l.define({label:"JSField RunJS context",properties:{element:(0,o.e)(`ElementProxy instance providing a safe DOM container for field rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`),value:`Current value of the field (read-only).
+      Contains the data value stored in this field.`,record:`Current record data object (read-only).
+      Contains all field values of the parent record.`,collection:`Collection definition metadata (read-only).
+      Provides schema information about the collection this field belongs to.`},methods:{onRefReady:`Wait for field container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void
+      Example: ctx.onRefReady(ctx.ref, (el) => { el.innerHTML = ctx.value })`}}),l.define({label:"JS 字段 RunJS 上下文",properties:{element:(0,o.V)("ElementProxy，字段渲染容器，支持 innerHTML/append 等 DOM 操作"),value:"字段当前值（只读）",record:"当前记录对象（只读，包含父记录全部字段值）",collection:"集合定义元数据（只读，描述字段所属集合的 Schema）"},methods:{onRefReady:"在字段容器 DOM 就绪后执行回调。参数：(ref, callback, timeout?)；示例：ctx.onRefReady(ctx.ref, el => { el.innerHTML = ctx.value })"}},{locale:"zh-CN"})}}]);

package/dist/client/assets/2702-2229ffce.js

@@ -0,0 +1,5 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["2702"],{32221(e,t,r){r.r(t),r.d(t,{JSItemRunJSContext:()=>n});var o=r(29007),a=r(4418);class n extends o.uk{}n.define({label:"JSItem RunJS context",properties:{element:(0,a.e)(`ElementProxy instance providing a safe DOM container for form item rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`),resource:`Current resource instance (read-only).
+      Provides access to the data resource associated with the current form context.`,record:`Current record data object (read-only).
+      Contains all field values of the parent record.`,formValues:{description:"Snapshot of current form values (object). Available in form contexts (CreateForm/EditForm).",detail:"Record<string, any>",examples:["const { name, status } = ctx.formValues || {};"]}},methods:{onRefReady:`Wait for form item container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void`}}),n.define({label:"JS 表单项 RunJS 上下文",properties:{element:(0,a.V)("ElementProxy，表单项渲染容器，支持 innerHTML/append 等 DOM 操作"),resource:"当前资源（只读）",record:"当前记录（只读）",formValues:{description:"当前表单值快照（对象）。仅表单相关上下文可用（Create/Edit Form）。",detail:"Record<string, any>",examples:["const { name, status } = ctx.formValues || {};"]}},methods:{onRefReady:"容器就绪后执行回调。参数：(ref, callback, timeout?)"}},{locale:"zh-CN"})}}]);

package/dist/client/assets/3475-c853dcfb.js

@@ -0,0 +1 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["3475"],{99502(e,t,a){a.r(t),a.d(t,{JSEditableFieldRunJSContext:()=>i});var n=a(29007),l=a(4418);class i extends n.uk{}i.define({label:"JSEditableField RunJS context",properties:{element:(0,l.e)("ElementProxy instance providing a safe DOM container for field rendering. In editable mode this container is typically a <span> element."),value:{description:"Current field value (read-only snapshot). In editable scenarios, prefer ctx.getValue()/ctx.setValue(v) for two-way binding.",detail:"any",examples:["const v = ctx.getValue?.() ?? ctx.value;",'ctx.setValue?.("new value");']},record:{description:"Current record data object (read-only). Available in forms that are bound to a record.",detail:"Record<string, any>"},form:{description:'Ant Design Form instance for reading/writing other fields. Example: ctx.form.getFieldValue("name")',detail:"FormInstance"},formValues:{description:"Snapshot of current form values (object). Prefer ctx.form.getFieldsValue() when you need the latest values.",detail:"Record<string, any>"},namePath:{description:"Field namePath in the form (array). Useful for advanced Form operations.",detail:"Array<string | number>"},disabled:"Whether the field is disabled (boolean).",readOnly:"Whether the field is read-only (boolean)."},methods:{getValue:{description:"Get current field value (recommended for editable custom fields).",detail:"() => any",completion:{insertText:"ctx.getValue?.()"}},setValue:{description:"Set current field value (two-way binding with the form).",detail:"(value: any) => void",completion:{insertText:"ctx.setValue?.(value)"},examples:["ctx.setValue?.(e.target.value);"]}}}),i.define({label:"JS 可编辑字段 RunJS 上下文",properties:{element:(0,l.V)("ElementProxy，字段渲染的安全容器（通常为 <span> 容器）。"),value:{description:"字段当前值（只读快照）。可编辑场景建议使用 ctx.getValue()/ctx.setValue(v) 做双向绑定。",detail:"any",examples:["const v = ctx.getValue?.() ?? ctx.value;",'ctx.setValue?.("新值");']},record:{description:"当前记录对象（只读；表单绑定记录时可用）。",detail:"Record<string, any>"},form:{description:"Ant Design Form 实例，可读写其它字段。",detail:"FormInstance"},formValues:{description:"当前表单值快照（对象）。需要最新值可用 ctx.form.getFieldsValue()。",detail:"Record<string, any>"},namePath:{description:"字段在表单中的 namePath（数组）。",detail:"Array<string | number>"},disabled:"是否禁用（boolean）",readOnly:"是否只读（boolean）"},methods:{getValue:{description:"获取字段当前值（可编辑字段推荐使用）。",detail:"() => any",completion:{insertText:"ctx.getValue?.()"}},setValue:{description:"设置字段当前值（与表单双向绑定）。",detail:"(value: any) => void",completion:{insertText:"ctx.setValue?.(value)"},examples:["ctx.setValue?.(e.target.value);"]}}},{locale:"zh-CN"})}}]);

package/dist/client/assets/3660-ae135b62.js

@@ -0,0 +1,6 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["3660"],{79271(e,t,n){n.r(t),n.d(t,{JSBlockRunJSContext:()=>o});var a=n(29007),r=n(4418);class o extends a.uk{}o.define({label:"RunJS context",properties:{element:(0,r.e)(`ElementProxy instance providing a safe DOM container.
+      Supports innerHTML, append, and other DOM manipulation methods.
+      Use this to render content in the JS block.`),record:`Current record data object (read-only).
+      Available when the JS block is within a data block or detail view context.`,value:"Current value of the field or component, if available in the current context.",React:"React library",antd:"Ant Design library"},methods:{onRefReady:`Wait for container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void
+      Example: ctx.onRefReady(ctx.ref, (el) => { el.innerHTML = "Ready!" })`,requireAsync:"Load external library: `const lib = await ctx.requireAsync(url)`",importAsync:"Dynamically import an ESM module by URL: `const mod = await ctx.importAsync(url)`.\nNote: if the module has only a default export, ctx.importAsync returns that default value directly (no `.default`)."}}),o.define({label:"RunJS 上下文",properties:{element:(0,r.V)("ElementProxy，安全的 DOM 容器，支持 innerHTML/append 等"),record:"当前记录（只读，用于数据区块/详情等场景）",value:"当前值（若存在）",React:"React 库",antd:"Ant Design 库"},methods:{onRefReady:"容器 ref 就绪回调：\n```js\nctx.onRefReady(ctx.ref, el => { /* ... */ })\n```",requireAsync:"加载外部库：`const lib = await ctx.requireAsync(url)`",importAsync:"按 URL 动态导入 ESM 模块：`const mod = await ctx.importAsync(url)`。\n注意：当模块只有 default 一个导出时，ctx.importAsync 会直接返回 default 值（无需再写 `.default`）。"}},{locale:"zh-CN"})}}]);

package/dist/client/assets/3916-03cc08e1.js

@@ -0,0 +1,6 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["3916"],{25831(e,o,a){a.r(o),a.d(o,{FormJSFieldItemRunJSContext:()=>l});var r=a(29007),t=a(4418);class l extends r.uk{}l.define({label:"FormJSFieldItem RunJS context",properties:{element:(0,t.e)(`ElementProxy instance providing a safe DOM container for form field rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`),value:"Current field value (read-only in display mode; in controlled scenarios, use setProps to modify).",record:`Current record data object (read-only).
+      Contains all field values of the parent record.`,formValues:{description:"Snapshot of current form values (object). Available in form contexts (CreateForm/EditForm).",detail:"Record<string, any>",examples:["const { name, status } = ctx.formValues || {};"]}},methods:{onRefReady:`Wait for form field container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void`,setProps:`Set form field properties programmatically.
+      Parameters: (fieldModel: any, props: { value?: any, disabled?: boolean, visible?: boolean }) => void
+      Example: ctx.setProps(fieldModel, { value: "new value" })`}}),l.define({label:"表单 JS 字段项 RunJS 上下文",properties:{element:(0,t.V)("ElementProxy，表单字段容器"),value:"字段值（展示模式为只读；受控场景用 setProps 修改）",record:"当前记录（只读）",formValues:{description:"当前表单值快照（对象）。仅表单相关上下文可用（Create/Edit Form）。",detail:"Record<string, any>",examples:["const { name, status } = ctx.formValues || {};"]}},methods:{onRefReady:"容器就绪回调",setProps:"设置表单项属性：`setProps(fieldModel, { value })`（由联动/表单上下文提供）"}},{locale:"zh-CN"})}}]);

package/dist/client/assets/4687-cb88a94b.js

@@ -0,0 +1 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["4687"],{4418(e,t,n){n.d(t,{V:()=>o,e:()=>l});let i={innerHTML:"Sanitized inner HTML string.",outerHTML:"Sanitized outer HTML string.",textContent:"Text content.",style:"Inline style declaration.",classList:"DOMTokenList for CSS classes.",appendChild:{type:"function",description:"Append a DOM node or text.",detail:"(child: Node | string) => void",completion:{insertText:"ctx.element.appendChild('text')"}},setAttribute:{type:"function",description:"Set an HTML attribute.",detail:"(name: string, value: string) => void",completion:{insertText:"ctx.element.setAttribute('data-key', 'value')"}},getAttribute:{type:"function",description:"Read an HTML attribute.",detail:"(name: string) => string | null",completion:{insertText:"ctx.element.getAttribute('data-key')"}},querySelector:{type:"function",description:"Find the first matching descendant.",detail:"(selectors: string) => Element | null",completion:{insertText:"ctx.element.querySelector('.selector')"}},querySelectorAll:{type:"function",description:"Find all matching descendants.",detail:"(selectors: string) => NodeListOf<Element>",completion:{insertText:"ctx.element.querySelectorAll('.selector')"}},addEventListener:{type:"function",description:"Attach an event listener to the element.",detail:"(type: string, listener: EventListener) => void",completion:{insertText:"ctx.element.addEventListener('click', (event) => {})"}},removeEventListener:{type:"function",description:"Remove an event listener from the element.",detail:"(type: string, listener: EventListener) => void",completion:{insertText:"ctx.element.removeEventListener('click', handler)"}}},r={innerHTML:"已消毒的 innerHTML 字符串。",outerHTML:"已消毒的 outerHTML 字符串。",textContent:"文本内容。",style:"内联样式声明。",classList:"CSS class 列表。",appendChild:{type:"function",description:"追加 DOM 节点或文本。",detail:"(child: Node | string) => void",completion:{insertText:"ctx.element.appendChild('text')"}},setAttribute:{type:"function",description:"设置 HTML 属性。",detail:"(name: string, value: string) => void",completion:{insertText:"ctx.element.setAttribute('data-key', 'value')"}},getAttribute:{type:"function",description:"读取 HTML 属性。",detail:"(name: string) => string | null",completion:{insertText:"ctx.element.getAttribute('data-key')"}},querySelector:{type:"function",description:"查询第一个匹配的后代元素。",detail:"(selectors: string) => Element | null",completion:{insertText:"ctx.element.querySelector('.selector')"}},querySelectorAll:{type:"function",description:"查询所有匹配的后代元素。",detail:"(selectors: string) => NodeListOf<Element>",completion:{insertText:"ctx.element.querySelectorAll('.selector')"}},addEventListener:{type:"function",description:"给元素添加事件监听。",detail:"(type: string, listener: EventListener) => void",completion:{insertText:"ctx.element.addEventListener('click', (event) => {})"}},removeEventListener:{type:"function",description:"移除元素事件监听。",detail:"(type: string, listener: EventListener) => void",completion:{insertText:"ctx.element.removeEventListener('click', handler)"}}};function l(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"Current DOM container for this RunJS context. Usually an ElementProxy.";return{description:e,detail:"HTMLElement | ElementProxy",properties:i}}function o(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"当前 RunJS 上下文的 DOM 容器，通常为 ElementProxy。";return{description:e,detail:"HTMLElement | ElementProxy",properties:r}}}}]);

package/dist/client/assets/6269-d8f21ee9.js

@@ -0,0 +1 @@
+"use strict";(globalThis.webpackChunknocobase=globalThis.webpackChunknocobase||[]).push([["6269"],{96108(e,r,n){n.r(r),n.d(r,{JSColumnRunJSContext:()=>a});var t=n(29007),o=n(4418);class a extends t.uk{}a.define({label:"JSColumn RunJS context",properties:{element:(0,o.e)("ElementProxy instance providing a safe DOM container for the current table cell. Supports innerHTML/append and basic DOM APIs."),record:"Current row record object (read-only).",recordIndex:"Index of the current row in the page (0-based).",collection:"Collection definition metadata (read-only).",viewer:"View controller providing dialog/drawer/embed helpers for interactions initiated from the cell (e.g., open details).",React:"React library",antd:"Ant Design library"},methods:{onRefReady:"Wait for cell DOM element to be ready before executing callback. Parameters: (ref, callback, timeout?) => void",requireAsync:"Load external library by URL: `const lib = await ctx.requireAsync(url)`",importAsync:"Dynamically import ESM module by URL: `const mod = await ctx.importAsync(url)`"}}),a.define({label:"JS 列 RunJS 上下文",properties:{element:(0,o.V)("ElementProxy，表格单元格的安全 DOM 容器，支持 innerHTML/append 等"),record:"当前行记录对象（只读）",recordIndex:"当前行索引（从 0 开始）",collection:"集合定义元数据（只读）",viewer:"视图控制器，可用于在单元格中触发抽屉/对话框/内嵌等交互",React:"React 库",antd:"Ant Design 库"},methods:{onRefReady:"等待单元格 DOM 就绪后执行回调。参数：(ref, callback, timeout?)",requireAsync:"按 URL 异步加载外部库：`const lib = await ctx.requireAsync(url)`",importAsync:"按 URL 动态导入 ESM 模块：`const mod = await ctx.importAsync(url)`"}},{locale:"zh-CN"})}}]);