@nocobase/flow-engine 2.0.0-alpha.2

package/lib/runjs-context/snippets/scene/jsblock/render-react.snippet.js

@@ -0,0 +1,56 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var render_react_snippet_exports = {};
+__export(render_react_snippet_exports, {
+  default: () => render_react_snippet_default
+});
+module.exports = __toCommonJS(render_react_snippet_exports);
+var render_react_snippet_default = {
+  contexts: ["JSBlockRunJSContext"],
+  prefix: "sn-jsb-react",
+  label: "Render React",
+  content: `
+// Render a React element into ctx.element via ReactDOM
+const { React, ReactDOM, antd } = ctx;
+const { Button } = antd;
+
+// Unmount previous render to allow repeated runs
+if (ctx.__reactRoot?.unmount) {
+  try { ctx.__reactRoot.unmount(); } catch(_) {}
+  ctx.__reactRoot = undefined;
+}
+
+const node = React.createElement(
+  'div',
+  { style: { padding: 12 } },
+  React.createElement(Button, { type: 'primary', onClick: () => ctx.message.success(ctx.t('Clicked!')) }, ctx.t('Click')),
+);
+const root = ReactDOM.createRoot(ctx.element);
+root.render(node);
+ctx.__reactRoot = root;
+`
+};

package/lib/runjs-context/snippets/scene/jsfield/color-by-value.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/jsfield/color-by-value.snippet.js

@@ -0,0 +1,42 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var color_by_value_snippet_exports = {};
+__export(color_by_value_snippet_exports, {
+  default: () => color_by_value_snippet_default
+});
+module.exports = __toCommonJS(color_by_value_snippet_exports);
+var color_by_value_snippet_default = {
+  contexts: ["JSFieldRunJSContext", "FormJSFieldItemRunJSContext"],
+  prefix: "sn-jsf-color",
+  label: "Color by value",
+  content: `
+// Colorize based on numeric sign
+const n = Number(ctx.value ?? 0);
+const color = Number.isFinite(n) ? (n > 0 ? 'green' : n < 0 ? 'red' : '#999') : '#555';
+ctx.element.innerHTML = '<span style=' + JSON.stringify('color:' + color) + '>' + String(ctx.value ?? '') + '</span>';
+`
+};

package/lib/runjs-context/snippets/scene/jsfield/format-number.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/jsfield/format-number.snippet.js

@@ -0,0 +1,41 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var format_number_snippet_exports = {};
+__export(format_number_snippet_exports, {
+  default: () => format_number_snippet_default
+});
+module.exports = __toCommonJS(format_number_snippet_exports);
+var format_number_snippet_default = {
+  contexts: ["JSFieldRunJSContext", "FormJSFieldItemRunJSContext"],
+  prefix: "sn-jsf-num",
+  label: "Format number",
+  content: `
+// Format number using locale
+const n = Number(ctx.value ?? 0);
+ctx.element.innerHTML = String(Number.isFinite(n) ? n.toLocaleString() : ctx.value ?? '');
+`
+};

package/lib/runjs-context/snippets/scene/jsfield/innerHTML-value.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/jsfield/innerHTML-value.snippet.js

@@ -0,0 +1,40 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var innerHTML_value_snippet_exports = {};
+__export(innerHTML_value_snippet_exports, {
+  default: () => innerHTML_value_snippet_default
+});
+module.exports = __toCommonJS(innerHTML_value_snippet_exports);
+var innerHTML_value_snippet_default = {
+  contexts: ["JSFieldRunJSContext", "FormJSFieldItemRunJSContext"],
+  prefix: "sn-jsf-value",
+  label: "Render field value",
+  content: `
+const v = String(ctx.value ?? '');
+ctx.element.innerHTML = \`<span class="nb-js-field-value" style="color:#1890ff;font-weight:600">\${v}</span>\`;
+`
+};

package/lib/runjs-context/snippets/scene/jsitem/render-basic.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/jsitem/render-basic.snippet.js

@@ -0,0 +1,44 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var render_basic_snippet_exports = {};
+__export(render_basic_snippet_exports, {
+  default: () => render_basic_snippet_default
+});
+module.exports = __toCommonJS(render_basic_snippet_exports);
+var render_basic_snippet_default = {
+  contexts: ["JSItemRunJSContext"],
+  prefix: "sn-jsitem-basic",
+  label: "Render form item",
+  content: `
+ctx.element.innerHTML = \`
+  <div style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6;">
+    <h3 style="color: #1890ff; margin: 0 0 12px 0; font-size: 18px; font-weight: 600;">\${ctx.t('JS Item')}</h3>
+    <div style="color:#555">\${ctx.t('This area is rendered by your JavaScript code.')}</div>
+  </div>
+\`;
+`
+};

package/lib/runjs-context/snippets/scene/linkage/set-disabled.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/linkage/set-disabled.snippet.js

@@ -0,0 +1,60 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var set_disabled_snippet_exports = {};
+__export(set_disabled_snippet_exports, {
+  default: () => set_disabled_snippet_default
+});
+module.exports = __toCommonJS(set_disabled_snippet_exports);
+var set_disabled_snippet_default = {
+  contexts: ["*"],
+  prefix: "sn-link-disable",
+  label: "Set disabled",
+  content: `
+const targetFieldUid = 'FIELD_UID_OR_NAME';
+const disabled = true;
+
+const items = ctx.model?.subModels?.grid?.subModels?.items;
+const candidates: any[] = Array.isArray(items)
+  ? items
+  : Array.from(items?.values?.() || items || []);
+const fieldModel =
+  candidates.find((item) => item?.uid === targetFieldUid) ||
+  candidates.find((item) => item?.props?.name === targetFieldUid);
+
+if (!fieldModel) {
+  ctx.message?.warning?.(ctx.t('Field {{name}} not found', { name: targetFieldUid }));
+  return;
+}
+
+fieldModel.setProps({ disabled });
+ctx.message?.success?.(
+  ctx.t(disabled ? 'Disabled field {{name}}' : 'Enabled field {{name}}', {
+    name: fieldModel?.props?.label || targetFieldUid,
+  }),
+);
+`
+};

package/lib/runjs-context/snippets/scene/linkage/set-field-value.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/linkage/set-field-value.snippet.js

@@ -0,0 +1,59 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var set_field_value_snippet_exports = {};
+__export(set_field_value_snippet_exports, {
+  default: () => set_field_value_snippet_default
+});
+module.exports = __toCommonJS(set_field_value_snippet_exports);
+var set_field_value_snippet_default = {
+  contexts: ["*"],
+  prefix: "sn-link-set",
+  label: "Set field value",
+  content: `
+// Update another field in the same form/block
+const targetFieldUid = 'FIELD_UID_OR_NAME';
+const nextValue = ctx.record?.status ?? ctx.t('Updated value');
+
+const items = ctx.model?.subModels?.grid?.subModels?.items;
+const candidates: any[] = Array.isArray(items)
+  ? items
+  : Array.from(items?.values?.() || items || []);
+const fieldModel =
+  candidates.find((item) => item?.uid === targetFieldUid) ||
+  candidates.find((item) => item?.props?.name === targetFieldUid);
+
+if (!fieldModel) {
+  ctx.message?.warning?.(ctx.t('Field {{name}} not found', { name: targetFieldUid }));
+  return;
+}
+
+fieldModel.setProps({ value: nextValue });
+ctx.message?.success?.(
+  ctx.t('Updated field {{name}}', { name: fieldModel?.props?.label || targetFieldUid }),
+);
+`
+};

package/lib/runjs-context/snippets/scene/linkage/set-required.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/linkage/set-required.snippet.js

@@ -0,0 +1,60 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var set_required_snippet_exports = {};
+__export(set_required_snippet_exports, {
+  default: () => set_required_snippet_default
+});
+module.exports = __toCommonJS(set_required_snippet_exports);
+var set_required_snippet_default = {
+  contexts: ["*"],
+  prefix: "sn-link-required",
+  label: "Set required",
+  content: `
+const targetFieldUid = 'FIELD_UID_OR_NAME';
+const required = true;
+
+const items = ctx.model?.subModels?.grid?.subModels?.items;
+const candidates: any[] = Array.isArray(items)
+  ? items
+  : Array.from(items?.values?.() || items || []);
+const fieldModel =
+  candidates.find((item) => item?.uid === targetFieldUid) ||
+  candidates.find((item) => item?.props?.name === targetFieldUid);
+
+if (!fieldModel) {
+  ctx.message?.warning?.(ctx.t('Field {{name}} not found', { name: targetFieldUid }));
+  return;
+}
+
+fieldModel.setProps({ required });
+ctx.message?.success?.(
+  ctx.t(required ? 'Set field {{name}} as required' : 'Field {{name}} is optional', {
+    name: fieldModel?.props?.label || targetFieldUid,
+  }),
+);
+`
+};

package/lib/runjs-context/snippets/scene/linkage/toggle-visible.snippet.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+declare const _default: {
+    contexts: string[];
+    prefix: string;
+    label: string;
+    content: string;
+};
+export default _default;

package/lib/runjs-context/snippets/scene/linkage/toggle-visible.snippet.js

@@ -0,0 +1,60 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var toggle_visible_snippet_exports = {};
+__export(toggle_visible_snippet_exports, {
+  default: () => toggle_visible_snippet_default
+});
+module.exports = __toCommonJS(toggle_visible_snippet_exports);
+var toggle_visible_snippet_default = {
+  contexts: ["*"],
+  prefix: "sn-link-visibility",
+  label: "Toggle visible",
+  content: `
+const targetFieldUid = 'FIELD_UID_OR_NAME';
+const shouldHide = true;
+
+const items = ctx.model?.subModels?.grid?.subModels?.items;
+const candidates: any[] = Array.isArray(items)
+  ? items
+  : Array.from(items?.values?.() || items || []);
+const fieldModel =
+  candidates.find((item) => item?.uid === targetFieldUid) ||
+  candidates.find((item) => item?.props?.name === targetFieldUid);
+
+if (!fieldModel) {
+  ctx.message?.warning?.(ctx.t('Field {{name}} not found', { name: targetFieldUid }));
+  return;
+}
+
+fieldModel.setProps({ hiddenModel: shouldHide });
+ctx.message?.success?.(
+  ctx.t(shouldHide ? 'Hidden field {{name}}' : 'Shown field {{name}}', {
+    name: fieldModel?.props?.label || targetFieldUid,
+  }),
+);
+`
+};

package/lib/runjs-context/snippets/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export type SnippetModule = {
+    content: string;
+    contexts?: string[];
+    versions?: string[];
+    prefix?: string;
+    label?: string;
+    description?: string;
+};

package/lib/runjs-context/snippets/types.js

@@ -0,0 +1,24 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);