openxiangda 1.0.264 → 1.0.265

package/README.md

@@ -1,4 +1,5 @@
 <!-- OpenXiangda-Policy-Version: 7 -->
+
 # OpenXiangda
 
 OpenXiangda is a lightweight CLI and skill package for private low-code platforms.
@@ -361,7 +362,7 @@ The dev host also calls the backend runtime route resolver for the current `/vie
 Built-in route defaults come from the `openxiangda` SDK: `StandardFormPage`, `FormSubmitTemplate`, `FormDetailTemplate`, `ProcessDetailTemplate`, and `DataManagementList`. Workspaces can override whole built-in pages from `src/runtime/builtin-overrides.tsx`; exact `formUuid` entries win before the `*` fallback.
 
 ```tsx
-import type { BuiltinRouteOverrides } from "openxiangda/runtime"
+import type { BuiltinRouteOverrides } from "openxiangda/runtime";
 
 export const runtimeRouteOverrides: BuiltinRouteOverrides = {
   "form-submit": {
@@ -371,7 +372,7 @@ export const runtimeRouteOverrides: BuiltinRouteOverrides = {
   "form-detail": {},
   "process-detail": {},
   "data-manage-list": {},
-}
+};
 ```
 
 AI / Playwright verification should use real user identity, not a bypass mode. The backend exposes `POST /openxiangda-api/v1/apps/:appType/verification-login-links` for platform admins to create a short-lived, single-use `loginUrl` for a target user and redirect URI. Playwright can open the returned URL directly; the backend writes cookies and redirects back to the local or tenant `/view/...` page. Test users can be created with `POST /openxiangda-api/v1/apps/:appType/test-users`; they use the `__ox_ai_test__:<appType>:<key>` ID prefix and are intended to be used through verification login links.
@@ -379,13 +380,13 @@ AI / Playwright verification should use real user identity, not a bypass mode. T
 An independent production user shell can call `resolveBrowserRuntimeRoute()` from `openxiangda/runtime` first. It posts the current `/view/...` path to `/openxiangda-api/v1/apps/:appType/runtime/routes/resolve`; the backend classifies the route as `custom-page`, `builtin-route`, `legacy-fallback`, or `not-found`. Code pages return backend-authorized bootstrap data directly, so the shell can pass that to `mountBrowserPageRuntime()` or mount with `createBrowserPageContext()` without reusing the legacy view workbench logic. Built-in routes can be rendered with `BuiltinRouteRenderer`, which loads form schema through the same `/service` proxy and keeps backend permission checks authoritative.
 
 ```ts
-import { resolveBrowserRuntimeRoute } from "openxiangda/runtime"
+import { resolveBrowserRuntimeRoute } from "openxiangda/runtime";
 
 const route = await resolveBrowserRuntimeRoute({
   appType: "APP_XXXX",
   path: window.location.pathname,
   search: window.location.search,
-})
+});
 ```
 
 Local workspace state is authoritative. If the current folder has no `.openxiangda/state.json` app binding, create a new app instead of searching the platform for a similar app name:
@@ -415,16 +416,16 @@ openxiangda form export customer --mode package --profile dev --output ./exports
 
 运行时页面读取当前用户信息时，优先使用 `sdk.user.getCurrent<PageUserRecord>()`。用户对象会返回常规组织成员关系 `departments`，也会返回系统维护的所属单位字段 `affiliatedDepartmentId` / `affiliatedDepartment`。`departments` 表示用户真实所在的部门、班级、专业等成员关系；`affiliatedDepartment` 表示业务上用于统计、筛选和展示的归属单位，通常是学院、单位或在源单位缺失时可用的具体部门节点，不用于替代权限部门成员关系。
 
-钉钉家校通讯录的家长、学生、教师身份和明确监护关系使用 `sdk.organization.schoolContact.*`（页面）或 `ctx.organization.schoolContact.*`（App Function）。已登录非游客用户无需给应用角色额外绑定权限，默认可查询当前租户全部关系，返回平台用户 ID、手机号、钉钉 userid 和姓名；应用可显式声明 `:self:read` / `:class:read` 收紧范围。完整示例见 [`docs/dingtalk-school-contact-relations.md`](docs/dingtalk-school-contact-relations.md)。
+钉钉家校通讯录的家长、学生、教师身份和明确监护关系使用 `sdk.organization.schoolContact.*`（页面）或 `ctx.organization.schoolContact.*`（App Function）。已登录非游客用户无需给应用角色额外绑定权限，默认可查询当前租户全部关系，返回平台用户 ID、手机号、钉钉 userid 和姓名；`teachers.list` 还返回 `teacher.managedClasses`、`class.headTeachers` 和同步/人工 `source`，用于班主任双向查询。应用可显式声明 `:self:read` / `:class:read` 收紧范围。完整示例见 [`docs/dingtalk-school-contact-relations.md`](docs/dingtalk-school-contact-relations.md)。
 
 ```ts
-import type { PageUserRecord } from "openxiangda/runtime"
+import type { PageUserRecord } from "openxiangda/runtime";
 
-const currentUser = await sdk.user.getCurrent<PageUserRecord>()
-const user = currentUser.result
+const currentUser = await sdk.user.getCurrent<PageUserRecord>();
+const user = currentUser.result;
 
-const affiliatedDepartmentName = user?.affiliatedDepartment?.name
-const affiliatedDepartmentExternalId = user?.affiliatedDepartment?.externalId
+const affiliatedDepartmentName = user?.affiliatedDepartment?.name;
+const affiliatedDepartmentExternalId = user?.affiliatedDepartment?.externalId;
 ```
 
 工程化资源放在工作区 `src/resources/` 下，由 `openxiangda resource validate|plan|publish|pull` 管理。`workspace publish` 会先构建并注册 workspace 表单/页面，再执行非破坏性资源 upsert，这样菜单、权限组、流程和表单设置可以解析最新的 profile-local ID。需要删除平台中 manifest 未声明的资源时，显式传 `--prune`。连接器页面运行时通过 `sdk.connector.invoke()` / `sdk.connector.call("connector.api")` 调用平台运行时接口，第三方密钥只保存在后端连接器配置中。
@@ -460,7 +461,15 @@ React SPA 新应用的无需登录访问统一使用 `/view/:appType/public/*`
           "text/csv",
           "application/json"
         ],
-        "allowedExtensions": ["pdf", "docx", "xlsx", "pptx", "txt", "csv", "json"],
+        "allowedExtensions": [
+          "pdf",
+          "docx",
+          "xlsx",
+          "pptx",
+          "txt",
+          "csv",
+          "json"
+        ],
         "maxSizeBytes": 31457280,
         "visibility": "private",
         "pathPrefix": "public/register/attachments/"
@@ -477,10 +486,10 @@ React SPA 新应用的无需登录访问统一使用 `/view/:appType/public/*`
 公开页面里的图片和附件分两类处理。真正可以对公网长期公开的资产，例如仪器封面图、公开说明书、门户 banner，应上传到平台公开文件区，默认 bucket 为 `public-assets`，上传后保存的 `url` / `previewUrl` / `downloadUrl` 会是 `/file/public/...`，未登录浏览器可以直接读取并被浏览器/CDN 缓存。仍可能包含隐私、审批材料、订单报告、结算单、维保现场照片的附件不要放入公开区，应继续保存在私有 bucket，并通过登录态或受控文件票据访问。
 
 ```ts
-import { createFormRuntimeApi } from "openxiangda"
+import { createFormRuntimeApi } from "openxiangda";
 
-const api = createFormRuntimeApi({ baseUrl: "/service" })
-const file = await api.uploadPublicFile(imageFile, "public-assets")
+const api = createFormRuntimeApi({ baseUrl: "/service" });
+const file = await api.uploadPublicFile(imageFile, "public-assets");
 
 // file.url === "/service/file/public/public-assets/..."
 // file.visibility === "public"
@@ -503,7 +512,7 @@ import {
 这些独立 API 必须在模板默认提供的 `OpenXiangdaProvider` 和 `OpenXiangdaPageProvider` 内使用。它们会从 PageSdk 获取当前 `appType`，并统一处理 preview ticket、metadata 和二进制文件响应。默认覆盖 PDF、常见媒体、文本、DOCX 和 XLSX，更多 DOC/XLS/PPT、ODF 格式由部署侧 ONLYOFFICE 配置决定。只有在需要复制、分享或新窗口打开预览页时，才通过 PageSdk `sdk.createFileAccessTicket(..., "preview", { appType })` 获取并打开 `previewPageUrl`；不要直接打开文件内容流 `previewUrl`。
 
 ```tsx
-import { ImageField } from "openxiangda"
+import { ImageField } from "openxiangda";
 
 <ImageField
   fieldId="photos"
@@ -514,9 +523,9 @@ import { ImageField } from "openxiangda"
     enabled: true,
     skipBelowBytes: 200 * 1024,
     thumb: { maxWidth: 320, maxHeight: 320, quality: 0.72 },
-    preview: { maxWidth: 1280, maxHeight: 1280, quality: 0.82 }
+    preview: { maxWidth: 1280, maxHeight: 1280, quality: 0.82 },
   }}
-/>
+/>;
 ```
 
 压缩默认 `format: "source"`，会尽量沿用原图片格式。如果显式输出 `webp`、`png` 或 `jpeg`，对应 OSS storage resource 的 `allowedExtensions` 也要包含该扩展名。
@@ -602,15 +611,15 @@ openxiangda organization account-reset-password user-alice --profile dev --body-
 页面 SDK 和 App Function 使用同一套后端权限：
 
 ```ts
-const capabilities = await sdk.organization.capabilities()
+const capabilities = await sdk.organization.capabilities();
 if (!capabilities.result?.canManage) {
-  throw new Error("当前账号没有组织账号管理权限")
+  throw new Error("当前账号没有组织账号管理权限");
 }
 
 await sdk.organization.departments.create({
   name: "销售部",
   parentId: "dept-root",
-})
+});
 
 await sdk.organization.accounts.create({
   id: "user-alice",
@@ -618,12 +627,12 @@ await sdk.organization.accounts.create({
   password: initialPassword,
   name: "Alice",
   departmentIds: ["dept-sales"],
-})
+});
 
 // App Function / trusted JS uses ctx.organization with the same permission check.
 await ctx.organization.accounts.resetPassword("user-alice", {
   newPassword,
-})
+});
 ```
 
 应用登录能力通过 auth resource 和 runtime SDK 提供：登录配置放在 `src/resources/auth/<code>.json`，默认 React SPA 模板已包含 `/view/:appType/login`，自定义页面可使用 `createAuthClient({ appType, servicePrefix })` 或 `LoginPage` / `useAuth` from `openxiangda/runtime/react`。钉钉登录默认使用 `dingtalkFlow="auto"`：只有明确位于钉钉容器且 JSAPI 可用时才走免登码，普通浏览器会请求应用级 OAuth 地址并跳转钉钉认证页；自定义页可调用 `getDingTalkOAuthUrl({ returnUrl })` 接入相同能力。手机号验证码、CAS/SSO 或其他外部登录可以由 App Function provider 校验外部凭证，但 provider 只能返回 `phone` / `email` / `externalId` / `unionId` 等身份声明；平台后端按 auth resource 策略执行账号匹配、绑定、创建或拒绝，并由平台统一签发 token/cookie。默认注册策略是拒绝，开启自动注册或白名单注册前必须确认身份匹配键、默认角色、验证码 TTL/频率/失败次数、审计字段和错误文案策略。

package/openxiangda-skills/SKILL.md

@@ -4,6 +4,7 @@ description: "Use OpenXiangda for private low-code platform work: app workspaces
 ---
 
 <!-- OpenXiangda-Policy-Version: 7 -->
+
 # OpenXiangda
 
 OpenXiangda connects an AI coding workspace to the private low-code platform through a normal-user profile and `/openxiangda-api/v1`. External backends using AK/SK are a separate `openxiangda-open-api` flow.
@@ -57,18 +58,18 @@ content/source/parent verification and never overwrites immutable storage.
 
 ## Decide the track
 
-| Intent | Read next | First action |
-| --- | --- | --- |
-| Diagnose, snapshot, compare, explain an error | `openxiangda-inspect` | read-only snapshot/inspect |
-| Login, profile, release, CLI/state issue | `openxiangda-core` | resolve explicit profile and workspace |
-| Create or bind an app | `openxiangda-app` | inspect local binding, then init/bind |
-| Form/schema/data view | `openxiangda-form` | inspect the target form and schema |
-| React/classic page | `openxiangda-page` | inspect the target route/page |
-| Function, automation, workflow, JS_CODE | `openxiangda-workflow-automation` | inspect the exact resource codes |
-| Roles, permission groups, data scope | `openxiangda-permission-settings` | produce the permission matrix |
+| Intent                                                 | Read next                                                        | First action                                                               |
+| ------------------------------------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Diagnose, snapshot, compare, explain an error          | `openxiangda-inspect`                                            | read-only snapshot/inspect                                                 |
+| Login, profile, release, CLI/state issue               | `openxiangda-core`                                               | resolve explicit profile and workspace                                     |
+| Create or bind an app                                  | `openxiangda-app`                                                | inspect local binding, then init/bind                                      |
+| Form/schema/data view                                  | `openxiangda-form`                                               | inspect the target form and schema                                         |
+| React/classic page                                     | `openxiangda-page`                                               | inspect the target route/page                                              |
+| Function, automation, workflow, JS_CODE                | `openxiangda-workflow-automation`                                | inspect the exact resource codes                                           |
+| Roles, permission groups, data scope                   | `openxiangda-permission-settings`                                | produce the permission matrix                                              |
 | DingTalk school-contact guardian/student relationships | `openxiangda-page` plus `references/school-contact-relations.md` | use the platform relationship SDK, defaulting to unrestricted tenant scope |
-| New app architecture, auth, public access | `openxiangda-architecture-design` plus the relevant domain skill | run the design gate |
-| External backend/OpenAPI/AK-SK | `openxiangda-open-api` | describe the exact operation |
+| New app architecture, auth, public access              | `openxiangda-architecture-design` plus the relevant domain skill | run the design gate                                                        |
+| External backend/OpenAPI/AK-SK                         | `openxiangda-open-api`                                           | describe the exact operation                                               |
 
 ## Scope before work
 
@@ -194,7 +195,9 @@ The lease is app-level promotion ownership, while worktree ownership prevents tw
 - Read school-contact guardian/student and teacher/class relationships through
   `sdk.organization.schoolContact` or the trusted App Function bridge. Use
   `SCHOOL_HEAD_TEACHER` only for global identity and `teachers.list` for the
-  exact class relationship. Keep the
+  exact class relationship; consume `teacher.managedClasses` and
+  `class.headTeachers` for the two relationship directions and inspect
+  `source` when synced/manual provenance matters. Keep the
   authenticated non-guest default tenant-wide scope without adding an app-role
   permission binding unless the product explicitly requires self/class
   restrictions; never infer relations from department membership.

package/openxiangda-skills/references/school-contact-relations.md

@@ -1,6 +1,6 @@
 # 家校通讯录关系
 
-家校关系由平台组织中心统一同步和维护。应用不得直连钉钉，也不得根据班级成员自行推断家长和学生关系。
+家校关系由平台组织中心统一同步和维护。同步成员和人工成员都直接位于班级部门下，通过 `guardian`、`student`、`teacher` 和班主任标记区分，不再依赖“家长/学生/老师”子部门。应用不得直连钉钉，也不得根据班级成员自行推断家长和学生关系。
 
 ## 权限与默认范围
 
@@ -10,9 +10,7 @@
 
 ```json
 {
-  "apiPermissionCodes": [
-    "app:organization:school-contact:read"
-  ]
+  "apiPermissionCodes": ["app:organization:school-contact:read"]
 }
 ```
 
@@ -31,11 +29,11 @@
 
 每次成功的钉钉家校通讯录全量同步都会对账并维护四种平台层系统身份角色：
 
-| 展示名 | 稳定角色编码 | 含义 |
-| --- | --- | --- |
-| 家长 | `SCHOOL_GUARDIAN` | 在家校成员关系中作为 guardian |
-| 学生 | `SCHOOL_STUDENT` | 在家校成员关系中作为 student |
-| 老师 | `SCHOOL_TEACHER` | 在家校成员关系中作为 teacher |
+| 展示名 | 稳定角色编码          | 含义                                          |
+| ------ | --------------------- | --------------------------------------------- |
+| 家长   | `SCHOOL_GUARDIAN`     | 在家校成员关系中作为 guardian                 |
+| 学生   | `SCHOOL_STUDENT`      | 在家校成员关系中作为 student                  |
+| 老师   | `SCHOOL_TEACHER`      | 在家校成员关系中作为 teacher                  |
 | 班主任 | `SCHOOL_HEAD_TEACHER` | 至少一个 teacher 班级成员带 `is_adviser=true` |
 
 身份角色可组合，一个平台用户可以同时是老师和家长；角色由同步维护，不能在平台角色管理中手工分配、修改、删除，也不会被当前平台角色切换隐藏。应用权限组把这些编码填入 `platformRoleCodes`，与应用角色 `roles` 是并列的 OR 条件；两个数组都为空仍表示不限制。
@@ -44,10 +42,11 @@
 
 ```ts
 const isGuardian =
-  sdk.context.permissions?.platformRoleCodes?.includes("SCHOOL_GUARDIAN")
+  sdk.context.permissions?.platformRoleCodes?.includes("SCHOOL_GUARDIAN");
 
-const isHeadTeacher =
-  sdk.context.permissions?.platformRoleCodes?.includes("SCHOOL_HEAD_TEACHER")
+const isHeadTeacher = sdk.context.permissions?.platformRoleCodes?.includes(
+  "SCHOOL_HEAD_TEACHER",
+);
 ```
 
 `SCHOOL_HEAD_TEACHER` 只说明当前用户至少担任一个班的班主任。班主任是班级维度的关系；要判断具体班级，必须使用下方 `teachers.list` 返回的 `isHeadTeacher`，不能用全局角色推断。
@@ -75,9 +74,9 @@ const response = await sdk.organization.schoolContact.relations.list({
   classId,
   page: 1,
   pageSize: 20,
-})
+});
 
-const relations = response.result?.items || []
+const relations = response.result?.items || [];
 ```
 
 常用方法：
@@ -86,23 +85,31 @@ const relations = response.result?.items || []
 await sdk.organization.schoolContact.children.list(guardianUserId, {
   page: 1,
   pageSize: 20,
-})
+});
 
 await sdk.organization.schoolContact.guardians.list(studentUserId, {
   page: 1,
   pageSize: 20,
-})
+});
 
-await sdk.organization.schoolContact.myFamily.get({ pageSize: 50 })
+await sdk.organization.schoolContact.myFamily.get({ pageSize: 50 });
 
 await sdk.organization.schoolContact.teachers.list({
   classId,
   isHeadTeacher: true,
   page: 1,
   pageSize: 20,
-})
+});
 ```
 
+`teachers.list` 的每个结果同时提供两个方向的班主任信息：
+
+- `teacher.managedClasses`：该老师当前作为班主任管理的全部班级。
+- `class.headTeachers`：该班级当前的全部班主任。
+- `source`：班级身份来源，值为 `dingtalk_school_contact` 或 `manual`。
+
+这两个字段可直接用于“我管理的班级”和“班级班主任”场景，不要在应用中自行维护第二份映射。
+
 关系列表支持以下服务端过滤条件：
 
 - `userId`、`guardianUserId`、`studentUserId`：平台用户 ID。
@@ -128,38 +135,38 @@ await sdk.organization.schoolContact.teachers.list({
 App Function、Automation 或 Workflow 中需要复用关系时，调用对应的受控后端桥接：
 
 ```ts
-export default async function(ctx, input) {
+export default async function (ctx, input) {
   const result = await ctx.organization.schoolContact.relations.list({
     guardianUserId: input.guardianUserId,
     page: 1,
     pageSize: 20,
-  })
+  });
 
-  return result.items
+  return result.items;
 }
 ```
 
 查询某位老师担任班主任的班级：
 
 ```ts
-export default async function(ctx, input) {
+export default async function (ctx, input) {
   return await ctx.organization.schoolContact.teachers.list({
     userId: input.teacherUserId,
     isHeadTeacher: true,
     page: 1,
     pageSize: 100,
-  })
+  });
 }
 ```
 
 对应方法为：
 
 ```ts
-ctx.organization.schoolContact.relations.list(params)
-ctx.organization.schoolContact.teachers.list(params)
-ctx.organization.schoolContact.children.list(userId, params)
-ctx.organization.schoolContact.guardians.list(userId, params)
-ctx.organization.schoolContact.myFamily.get(params)
+ctx.organization.schoolContact.relations.list(params);
+ctx.organization.schoolContact.teachers.list(params);
+ctx.organization.schoolContact.children.list(userId, params);
+ctx.organization.schoolContact.guardians.list(userId, params);
+ctx.organization.schoolContact.myFamily.get(params);
 ```
 
 运行时使用平台提供的真实操作者做权限校验。不要信任页面 input 中伪造的租户、角色或当前用户 ID。
@@ -168,31 +175,31 @@ ctx.organization.schoolContact.myFamily.get(params)
 
 ```ts
 interface SchoolContactRelation {
-  relationId: string
-  relationCode: string | null
-  relationName: string | null
+  relationId: string;
+  relationCode: string | null;
+  relationName: string | null;
   guardian: {
-    userId: string
-    dingtalkUserId: string
-    name: string
-    mobile: string | null
-  }
+    userId: string;
+    dingtalkUserId: string | null;
+    name: string;
+    mobile: string | null;
+  };
   student: {
-    userId: string
-    dingtalkUserId: string
-    name: string
-    mobile: string | null
-  }
+    userId: string;
+    dingtalkUserId: string | null;
+    name: string;
+    mobile: string | null;
+  };
   class: {
-    id: string
-    dingtalkClassId: string
-    name: string
-    campusName: string | null
-    periodName: string | null
-    gradeName: string | null
-  }
-  syncedAt: string
-  syncState: "current" | "not_synced" | "disabled"
+    id: string;
+    dingtalkClassId: string;
+    name: string;
+    campusName: string | null;
+    periodName: string | null;
+    gradeName: string | null;
+  };
+  syncedAt: string;
+  syncState: "current" | "not_synced" | "disabled";
 }
 ```
 
@@ -200,22 +207,33 @@ interface SchoolContactRelation {
 
 ```ts
 interface SchoolContactTeacherMembership {
-  membershipId: string
+  membershipId: string;
   teacher: {
-    userId: string
-    dingtalkUserId: string
-    name: string
-    mobile: string | null
-  }
-  class: SchoolContactRelation["class"]
-  isHeadTeacher: boolean
-  syncedAt: string
-  syncState: "current" | "not_synced" | "disabled"
+    userId: string;
+    dingtalkUserId: string | null;
+    name: string;
+    mobile: string | null;
+    managedClasses: SchoolContactRelation["class"][];
+  };
+  class: SchoolContactRelation["class"] & {
+    headTeachers: Array<{
+      userId: string;
+      dingtalkUserId: string | null;
+      name: string;
+      mobile: string | null;
+    }>;
+  };
+  isHeadTeacher: boolean;
+  source: "dingtalk_school_contact" | "manual";
+  syncedAt: string;
+  syncState: "current" | "not_synced" | "disabled";
 }
 ```
 
 手机号可能为空。`sync.state=disabled` 表示管理员关闭了后续同步，现有数据仍保留但可能过期；业务页面在对时效敏感时应展示 `lastSuccessfulSyncAt`。
 
+平台管理员人工添加的班级身份也会由 `teachers.list` 返回，并标记 `source=manual`。人工家长/学生身份会维护对应平台身份和班级归属，但不会自动生成监护关系；只有明确存在的家庭关系才会出现在 `relations`、`children`、`guardians` 和 `myFamily`。
+
 ## 持久化边界
 
 - 平台关系是当前事实，不要复制全量关系到应用表单或 Data View。

package/openxiangda-skills/skills/openxiangda-page/SKILL.md

@@ -36,7 +36,7 @@ openxiangda workspace publish --profile <name> --page <pageCode>
 - ✅ For external APIs use `src/resources/connectors/<code>.json` + `sdk.connector.invoke()`; for joined read-only lists use row data views + `sdk.dataView.query`; for stable dashboard metrics use aggregate data views + `sdk.dataView.stats`.
 - ✅ Choose data view `storageMode` deliberately: `materialized` for refreshed reports/lists that tolerate delay, `live` for bounded real-time multi-form reads.
 - ✅ For reusable backend orchestration use App Function (`src/functions/<functionCode>/index.ts` + `src/resources/functions/<functionCode>.json`) and call `sdk.function.invoke(code, { input })`; keep page components out of multi-table business orchestration.
-- ✅ 家长、学生、教师、班主任身份或班级/监护关系页面使用 `sdk.organization.schoolContact.*`；先读 `references/school-contact-relations.md`。用 `SCHOOL_HEAD_TEACHER` 判断全局身份，用 `teachers.list({ classId, isHeadTeacher: true })` 判断具体班主任班级；默认使用已登录用户的租户内全部关系，仅在业务要求时声明 self/class 收紧范围，并保持服务端分页。
+- ✅ 家长、学生、教师、班主任身份或班级/监护关系页面使用 `sdk.organization.schoolContact.*`；先读 `references/school-contact-relations.md`。用 `SCHOOL_HEAD_TEACHER` 判断全局身份，用 `teachers.list({ classId, isHeadTeacher: true })` 判断具体班主任班级，并直接读取 `teacher.managedClasses` / `class.headTeachers`；默认使用已登录用户的租户内全部关系，仅在业务要求时声明 self/class 收紧范围，并保持服务端分页。
 - ✅ Filters, search bars, modal forms, drawers, and inline edits use platform components for platform data fields, otherwise `antd` / `antd-mobile` controls.
 - ❌ Single-file giant pages. Split per `references/best-practices.md`.
 - ❌ Hardcoded `/view/...&isRenderNav=false` URLs scattered through page code; use the runtime navigation helper.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.264",
+  "version": "1.0.265",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/dist/runtime/index.d.mts

@@ -1,5 +1,5 @@
 import { PageContext, PageInfo, PageBridgeApi } from './react.mjs';
-export { AdminList, AdminListBatchAction, AdminListColumn, AdminListColumnPreference, AdminListDataSource, AdminListDataSourceOptions, AdminListDataViewSourceOptions, AdminListDensity, AdminListExportDownloadOptions, AdminListExportInput, AdminListExportScope, AdminListExportTask, AdminListExportTaskStatus, AdminListFormSourceOptions, AdminListFunctionSourceOptions, AdminListLockedPreference, AdminListOption, AdminListPreference, AdminListPreferenceStore, AdminListProps, AdminListQuery, AdminListResult, AdminListRowAction, AdminListSearchField, AdminListSearchFieldType, AdminListSearchPreference, AdminListSelectionChange, AdminListSort, AdminListSortDirection, ApiEnvelope, ApiPermissionListParams, AppAuthClient, AppFunctionAttachmentReference, AppFunctionBase64File, AppFunctionConnectorApi, AppFunctionContext, AppFunctionContextV2, AppFunctionDataViewApi, AppFunctionFileReadInput, AppFunctionFileReadOptions, AppFunctionFilesApi, AppFunctionFormApi, AppFunctionFormDeleteResult, AppFunctionFormFileReadOptions, AppFunctionFormGetByIdParams, AppFunctionFormQueryParams, AppFunctionFormWriteParams, AppFunctionHttpApi, AppFunctionHttpRequest, AppFunctionHttpResponse, AppFunctionManifestV2, AppFunctionNotificationApi, AppFunctionOperatorInfo, AppFunctionOrganizationApi, AppFunctionPermissionContext, AppFunctionPlatformApi, AppFunctionPlatformApiRequest, AppFunctionPlatformApiResponse, AppFunctionPlatformHttpApi, AppFunctionPlatformRolesApi, AppFunctionProcessApi, AppFunctionProcessStartResult, AppFunctionProcessTaskResult, AppFunctionProcessWithdrawResult, AppFunctionRoleBatchAddResult, AppFunctionRoleListParams, AppFunctionRoleMemberMutationResult, AppFunctionRoleUsersParams, AppFunctionRuntimeContext, AppFunctionSecretRef, AppFunctionSecrets, AppFunctionUtils, ApproveTaskParams, AssignPermissionsParams, AssignRolesParams, AttachmentPreviewList, AttachmentPreviewListProps, AuthChallengePayload, AuthClientError, AuthClientErrorOptions, AuthClientOptions, AuthErrorExtra, AuthLogoutRedirectOptions, AuthMethod, AuthMethodType, AuthTokenData, AuthUser, BatchAddUsersToRoleParams, BatchSendNotificationByTypeParams, ChangeOrganizationAccountPasswordParams, ChangeUserRoleParams, ConnectorCallParams, ConnectorInvokeParams, ConnectorInvokeResult, ConnectorRequestBodyType, ConnectorResponseType, CreateApiPermissionParams, CreateFileAccessTicketOptions, CreateFormPermissionGroupDto, CreateOrganizationAccountParams, CreateOrganizationDepartmentParams, CreatePagePermissionGroupDto, CreateRoleParams, CreateUiPermissionParams, CreateUserParams, CurrentUserDepartmentParents, CustomPageEntryConfig, CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, DataManagementConfigParams, DataManagementFilterState, DataPermissionConditionDto, DataPermissionDto, DataPermissionRuleDto, DataViewQueryParams, DataViewQueryResult, DataViewStatsParams, DingTalkBrowserContext, DingTalkClient, DingTalkExternalBrowserGuide, DingTalkExternalBrowserGuideProps, DingTalkLoginEnvironment, DingTalkLoginFlow, DingTalkLoginInput, DingTalkNotificationCapabilities, DingTalkNotificationCardConfig, DingTalkNotificationCardField, DingTalkNotificationCardMode, DingTalkNotificationCardPreview, DingTalkNotificationChannelConfig, DingTalkNotificationDeliveryMode, DingTalkNotificationPreviewResult, DingTalkOAuthStartInput, DingTalkOAuthStartResult, ExecuteProcessOperationInput, FieldAccessLevel, FieldAccessPolicyDto, FieldAccessPolicyItemDto, FieldOptionValue, FieldPermissionDto, FileAccessTicketAction, FileAccessTicketPurpose, FileAccessTicketResult, FilePreviewController, FilePreviewItem, FindNotificationConfigParams, FormAdvancedSearchParams, FormChangeRecordParams, FormCreateParams, FormCreateResult, FormDetailResult, FormExportParams, FormFieldValue, FormGetDetailParams, FormImportParams, FormInstanceIdentifierResult, FormPermissionGroup, FormRemoveParams, FormSearchParams, FormUpdateParams, FormUpdateResult, FunctionInvokeParams, FunctionInvokeResult, GetParentDepartmentsOptions, GetProcessInstanceParams, GetUserRolesParams, GuestLoginInput, ImagePreviewGrid, ImagePreviewGridProps, ImportExportRecordDownloadParams, ImportExportRecordQuery, InitiatorApproverSelector, InstanceStatus, ListNotificationInboxParams, ListWorkCenterItemsParams, LoadDingTalkClientOptions, LoginLogGetParams, LoginLogListParams, LoginLogRecord, LoginLogStats, LoginLogStatsParams, LoginLogStatus, LoginMethodsResult, LoginPage, LoginPageProps, MarkAllNotificationReadResult, NotificationChannel, NotificationChannelConfig, NotificationChannelsConfig, NotificationConfigLevel, NotificationInboxListResult, NotificationInboxMessage, NotificationInboxReadStatus, NotificationMessageRecord, NotificationTemplate, NotificationTemplatePreview, NotificationTypeConfig, NotificationUnreadCountResult, OpenXiangdaPageProvider, OpenXiangdaPageProviderProps, OpenXiangdaProvider, OpenXiangdaProviderProps, OrganizationAccountListParams, OrganizationCapabilities, OrganizationListResult, PageApiPermissionRecord, PageApiResponse, PageAppInfo, PageBinaryResponse, PageDataManagementConfig, PageDataSourceDescriptor, PageDepartmentInfo, PageDepartmentRecord, PageHttpMethod, PageListResult, PageMessageApi, PageModalApi, PageNavigationApi, PageOffsetListResult, PagePermissionGroup, PagePermissionInfo, PageProvider, PageQueryValue, PageRequestCache, PageRequestOptions, PageRoleRecord, PageRouteInfo, PageScope, PageSdk, PageSdkError, PageSdkMeta, PageTransportDownloadPayload, PageTransportRequestPayload, PageUiPermissionRecord, PageUiPermissionType, PageUserInfo, PageUserRecord, PageUserType, PasswordLoginInput, PermissionBoundary, PermissionBoundaryFallback, PermissionBoundaryFallbackState, PermissionBoundaryProps, PhoneCodeInput, PhoneCodeLoginInput, PhoneCodeRegisterInput, PhoneCodeSendResult, PreviewDingTalkNotificationParams, PreviewNotificationTemplateParams, ProcessActionBar, ProcessActionBarProps, ProcessApproveAction, ProcessCapabilities, ProcessCapabilityOperation, ProcessInstanceLookupParams, ProcessPreviewPanel, ProcessPreviewPanelProps, ProcessTimeline, ProcessTimelineProps, PublicAccessClaim, PublicAccessClient, PublicAccessClientError, PublicAccessClientOptions, PublicAccessGate, PublicAccessGateProps, PublicAccessSessionData, PublicAccessSessionInput, PublicFormGrant, PublicStorageAction, PublicStorageGrant, QueryFormPermissionGroupDto, QueryPagePermissionGroupDto, RefreshInput, RequestDingTalkAuthCodeOptions, ResetOrganizationAccountPasswordParams, ResolveLoginUrlInput, ResolveProcessCapabilitiesParams, RoleListParams, RoleUsersParams, RouteAccessResult, RuntimeAuthGuard, RuntimeAuthGuardProps, RuntimeAuthState, RuntimeAuthStatus, RuntimeBootstrap, RuntimeErrorSnapshot, RuntimeErrorType, RuntimeLogoutOptions, RuntimeMenuItem, RuntimePagePermissions, RuntimeRedirectLoginOptions, RuntimeRequestError, RuntimeRequestState, RuntimeResolveLoginOptions, SaveDataManagementConfigParams, SchoolContactClass, SchoolContactPerson, SchoolContactRelationListParams, SchoolContactRelationListResult, SchoolContactRelationRecord, SchoolContactSyncState, SchoolContactTeacherListParams, SchoolContactTeacherListResult, SchoolContactTeacherMembershipRecord, SearchComponentName, SearchExpression, SearchFieldKey, SearchGroup, SearchLogic, SearchOperator, SearchRule, SearchSortItem, SearchSystemField, SendNotificationByTypeParams, SendNotificationResult, SsoLoginUrlInput, SsoLoginUrlResult, StructuredExportCellStyle, StructuredExportColumnDefinition, StructuredExportCreateParams, StructuredExportFormatDefinition, StructuredExportFormatType, StructuredExportGetParams, StructuredExportScope, StructuredExportSheetDefinition, StructuredExportSourceDefinition, StructuredExportStyleRule, StructuredExportTask, StructuredExportTaskStatus, StructuredExportValueDefinition, StructuredExportWorkbookDefinition, SubFormRule, SwitchAppRoleParams, SwitchPlatformRoleParams, TerminateProcessInstanceParams, TriggerCallbackTaskParams, TrustedNodeV2Context, UiPermissionListParams, UpdateApiPermissionParams, UpdateDingTalkCardParams, UpdateDingTalkCardResult, UpdateFormPermissionGroupDto, UpdateOrganizationAccountParams, UpdateOrganizationDepartmentParams, UpdatePagePermissionGroupDto, UpdateRoleParams, UpdateUiPermissionParams, UpdateUserParams, UseAuthOptions, UseCanAccessRouteInput, UseFilePreviewOptions, UseLoginMethodsState, UseProcessActionsOptions, UseProcessActionsReturn, UseProcessCapabilitiesOptions, UseProcessCapabilitiesReturn, UsePublicAccessOptions, UsePublicAccessState, UserListParams, UserMenuPermissionsResponse, ValidateUserParams, ViewFieldPermissionValue, ViewOperationPermission, ViewPermissionSummary, WorkCenterBoxType, WorkCenterGroupedStat, WorkCenterItem, WorkCenterListResult, WorkCenterStats, WorkCenterStatsParams, WorkflowApproveParams, WorkflowCapabilityActionKey, WorkflowDefinitionByFormParams, WorkflowInitiatorSelectCandidatesParams, WorkflowInitiatorSelectRequirementsParams, WorkflowPreviewParams, WorkflowResubmitInitiatorSelectRequirementsParams, WorkflowResubmitParams, WorkflowReturnParams, WorkflowSaveTaskParams, WorkflowStartFromExistingInstanceParams, WorkflowTaskParams, WorkflowTransferParams, WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap } from './react.mjs';
+export { AdminList, AdminListBatchAction, AdminListColumn, AdminListColumnPreference, AdminListDataSource, AdminListDataSourceOptions, AdminListDataViewSourceOptions, AdminListDensity, AdminListExportDownloadOptions, AdminListExportInput, AdminListExportScope, AdminListExportTask, AdminListExportTaskStatus, AdminListFormSourceOptions, AdminListFunctionSourceOptions, AdminListLockedPreference, AdminListOption, AdminListPreference, AdminListPreferenceStore, AdminListProps, AdminListQuery, AdminListResult, AdminListRowAction, AdminListSearchField, AdminListSearchFieldType, AdminListSearchPreference, AdminListSelectionChange, AdminListSort, AdminListSortDirection, ApiEnvelope, ApiPermissionListParams, AppAuthClient, AppFunctionAttachmentReference, AppFunctionBase64File, AppFunctionConnectorApi, AppFunctionContext, AppFunctionContextV2, AppFunctionDataViewApi, AppFunctionFileReadInput, AppFunctionFileReadOptions, AppFunctionFilesApi, AppFunctionFormApi, AppFunctionFormDeleteResult, AppFunctionFormFileReadOptions, AppFunctionFormGetByIdParams, AppFunctionFormQueryParams, AppFunctionFormWriteParams, AppFunctionHttpApi, AppFunctionHttpRequest, AppFunctionHttpResponse, AppFunctionManifestV2, AppFunctionNotificationApi, AppFunctionOperatorInfo, AppFunctionOrganizationApi, AppFunctionPermissionContext, AppFunctionPlatformApi, AppFunctionPlatformApiRequest, AppFunctionPlatformApiResponse, AppFunctionPlatformHttpApi, AppFunctionPlatformRolesApi, AppFunctionProcessApi, AppFunctionProcessStartResult, AppFunctionProcessTaskResult, AppFunctionProcessWithdrawResult, AppFunctionRoleBatchAddResult, AppFunctionRoleListParams, AppFunctionRoleMemberMutationResult, AppFunctionRoleUsersParams, AppFunctionRuntimeContext, AppFunctionSecretRef, AppFunctionSecrets, AppFunctionUtils, ApproveTaskParams, AssignPermissionsParams, AssignRolesParams, AttachmentPreviewList, AttachmentPreviewListProps, AuthChallengePayload, AuthClientError, AuthClientErrorOptions, AuthClientOptions, AuthErrorExtra, AuthLogoutRedirectOptions, AuthMethod, AuthMethodType, AuthTokenData, AuthUser, BatchAddUsersToRoleParams, BatchSendNotificationByTypeParams, ChangeOrganizationAccountPasswordParams, ChangeUserRoleParams, ConnectorCallParams, ConnectorInvokeParams, ConnectorInvokeResult, ConnectorRequestBodyType, ConnectorResponseType, CreateApiPermissionParams, CreateFileAccessTicketOptions, CreateFormPermissionGroupDto, CreateOrganizationAccountParams, CreateOrganizationDepartmentParams, CreatePagePermissionGroupDto, CreateRoleParams, CreateUiPermissionParams, CreateUserParams, CurrentUserDepartmentParents, CustomPageEntryConfig, CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, DataManagementConfigParams, DataManagementFilterState, DataPermissionConditionDto, DataPermissionDto, DataPermissionRuleDto, DataViewQueryParams, DataViewQueryResult, DataViewStatsParams, DingTalkBrowserContext, DingTalkClient, DingTalkExternalBrowserGuide, DingTalkExternalBrowserGuideProps, DingTalkLoginEnvironment, DingTalkLoginFlow, DingTalkLoginInput, DingTalkNotificationCapabilities, DingTalkNotificationCardConfig, DingTalkNotificationCardField, DingTalkNotificationCardMode, DingTalkNotificationCardPreview, DingTalkNotificationChannelConfig, DingTalkNotificationDeliveryMode, DingTalkNotificationPreviewResult, DingTalkOAuthStartInput, DingTalkOAuthStartResult, ExecuteProcessOperationInput, FieldAccessLevel, FieldAccessPolicyDto, FieldAccessPolicyItemDto, FieldOptionValue, FieldPermissionDto, FileAccessTicketAction, FileAccessTicketPurpose, FileAccessTicketResult, FilePreviewController, FilePreviewItem, FindNotificationConfigParams, FormAdvancedSearchParams, FormChangeRecordParams, FormCreateParams, FormCreateResult, FormDetailResult, FormExportParams, FormFieldValue, FormGetDetailParams, FormImportParams, FormInstanceIdentifierResult, FormPermissionGroup, FormRemoveParams, FormSearchParams, FormUpdateParams, FormUpdateResult, FunctionInvokeParams, FunctionInvokeResult, GetParentDepartmentsOptions, GetProcessInstanceParams, GetUserRolesParams, GuestLoginInput, ImagePreviewGrid, ImagePreviewGridProps, ImportExportRecordDownloadParams, ImportExportRecordQuery, InitiatorApproverSelector, InstanceStatus, ListNotificationInboxParams, ListWorkCenterItemsParams, LoadDingTalkClientOptions, LoginLogGetParams, LoginLogListParams, LoginLogRecord, LoginLogStats, LoginLogStatsParams, LoginLogStatus, LoginMethodsResult, LoginPage, LoginPageProps, MarkAllNotificationReadResult, NotificationChannel, NotificationChannelConfig, NotificationChannelsConfig, NotificationConfigLevel, NotificationInboxListResult, NotificationInboxMessage, NotificationInboxReadStatus, NotificationMessageRecord, NotificationTemplate, NotificationTemplatePreview, NotificationTypeConfig, NotificationUnreadCountResult, OpenXiangdaPageProvider, OpenXiangdaPageProviderProps, OpenXiangdaProvider, OpenXiangdaProviderProps, OrganizationAccountListParams, OrganizationCapabilities, OrganizationListResult, PageApiPermissionRecord, PageApiResponse, PageAppInfo, PageBinaryResponse, PageDataManagementConfig, PageDataSourceDescriptor, PageDepartmentInfo, PageDepartmentRecord, PageHttpMethod, PageListResult, PageMessageApi, PageModalApi, PageNavigationApi, PageOffsetListResult, PagePermissionGroup, PagePermissionInfo, PageProvider, PageQueryValue, PageRequestCache, PageRequestOptions, PageRoleRecord, PageRouteInfo, PageScope, PageSdk, PageSdkError, PageSdkMeta, PageTransportDownloadPayload, PageTransportRequestPayload, PageUiPermissionRecord, PageUiPermissionType, PageUserInfo, PageUserRecord, PageUserType, PasswordLoginInput, PermissionBoundary, PermissionBoundaryFallback, PermissionBoundaryFallbackState, PermissionBoundaryProps, PhoneCodeInput, PhoneCodeLoginInput, PhoneCodeRegisterInput, PhoneCodeSendResult, PreviewDingTalkNotificationParams, PreviewNotificationTemplateParams, ProcessActionBar, ProcessActionBarProps, ProcessApproveAction, ProcessCapabilities, ProcessCapabilityOperation, ProcessInstanceLookupParams, ProcessPreviewPanel, ProcessPreviewPanelProps, ProcessTimeline, ProcessTimelineProps, PublicAccessClaim, PublicAccessClient, PublicAccessClientError, PublicAccessClientOptions, PublicAccessGate, PublicAccessGateProps, PublicAccessSessionData, PublicAccessSessionInput, PublicFormGrant, PublicStorageAction, PublicStorageGrant, QueryFormPermissionGroupDto, QueryPagePermissionGroupDto, RefreshInput, RequestDingTalkAuthCodeOptions, ResetOrganizationAccountPasswordParams, ResolveLoginUrlInput, ResolveProcessCapabilitiesParams, RoleListParams, RoleUsersParams, RouteAccessResult, RuntimeAuthGuard, RuntimeAuthGuardProps, RuntimeAuthState, RuntimeAuthStatus, RuntimeBootstrap, RuntimeErrorSnapshot, RuntimeErrorType, RuntimeLogoutOptions, RuntimeMenuItem, RuntimePagePermissions, RuntimeRedirectLoginOptions, RuntimeRequestError, RuntimeRequestState, RuntimeResolveLoginOptions, SaveDataManagementConfigParams, SchoolContactClass, SchoolContactPerson, SchoolContactRelationListParams, SchoolContactRelationListResult, SchoolContactRelationRecord, SchoolContactSyncState, SchoolContactTeacher, SchoolContactTeacherListParams, SchoolContactTeacherListResult, SchoolContactTeacherMembershipRecord, SearchComponentName, SearchExpression, SearchFieldKey, SearchGroup, SearchLogic, SearchOperator, SearchRule, SearchSortItem, SearchSystemField, SendNotificationByTypeParams, SendNotificationResult, SsoLoginUrlInput, SsoLoginUrlResult, StructuredExportCellStyle, StructuredExportColumnDefinition, StructuredExportCreateParams, StructuredExportFormatDefinition, StructuredExportFormatType, StructuredExportGetParams, StructuredExportScope, StructuredExportSheetDefinition, StructuredExportSourceDefinition, StructuredExportStyleRule, StructuredExportTask, StructuredExportTaskStatus, StructuredExportValueDefinition, StructuredExportWorkbookDefinition, SubFormRule, SwitchAppRoleParams, SwitchPlatformRoleParams, TerminateProcessInstanceParams, TriggerCallbackTaskParams, TrustedNodeV2Context, UiPermissionListParams, UpdateApiPermissionParams, UpdateDingTalkCardParams, UpdateDingTalkCardResult, UpdateFormPermissionGroupDto, UpdateOrganizationAccountParams, UpdateOrganizationDepartmentParams, UpdatePagePermissionGroupDto, UpdateRoleParams, UpdateUiPermissionParams, UpdateUserParams, UseAuthOptions, UseCanAccessRouteInput, UseFilePreviewOptions, UseLoginMethodsState, UseProcessActionsOptions, UseProcessActionsReturn, UseProcessCapabilitiesOptions, UseProcessCapabilitiesReturn, UsePublicAccessOptions, UsePublicAccessState, UserListParams, UserMenuPermissionsResponse, ValidateUserParams, ViewFieldPermissionValue, ViewOperationPermission, ViewPermissionSummary, WorkCenterBoxType, WorkCenterGroupedStat, WorkCenterItem, WorkCenterListResult, WorkCenterStats, WorkCenterStatsParams, WorkflowApproveParams, WorkflowCapabilityActionKey, WorkflowDefinitionByFormParams, WorkflowInitiatorSelectCandidatesParams, WorkflowInitiatorSelectRequirementsParams, WorkflowPreviewParams, WorkflowResubmitInitiatorSelectRequirementsParams, WorkflowResubmitParams, WorkflowReturnParams, WorkflowSaveTaskParams, WorkflowStartFromExistingInstanceParams, WorkflowTaskParams, WorkflowTransferParams, WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap } from './react.mjs';
 import React__default from 'react';
 import { b as FormSchema, a as FormRuntimeApi, c as FormRuntimeApiConfig } from '../ProcessPreview-DSUIJi5V.mjs';
 export { e as extractFieldsFromComponentsTree } from '../dataManagementApi-p_HOhQnA.mjs';

package/packages/sdk/dist/runtime/index.d.ts

@@ -1,5 +1,5 @@
 import { PageContext, PageInfo, PageBridgeApi } from './react.js';
-export { AdminList, AdminListBatchAction, AdminListColumn, AdminListColumnPreference, AdminListDataSource, AdminListDataSourceOptions, AdminListDataViewSourceOptions, AdminListDensity, AdminListExportDownloadOptions, AdminListExportInput, AdminListExportScope, AdminListExportTask, AdminListExportTaskStatus, AdminListFormSourceOptions, AdminListFunctionSourceOptions, AdminListLockedPreference, AdminListOption, AdminListPreference, AdminListPreferenceStore, AdminListProps, AdminListQuery, AdminListResult, AdminListRowAction, AdminListSearchField, AdminListSearchFieldType, AdminListSearchPreference, AdminListSelectionChange, AdminListSort, AdminListSortDirection, ApiEnvelope, ApiPermissionListParams, AppAuthClient, AppFunctionAttachmentReference, AppFunctionBase64File, AppFunctionConnectorApi, AppFunctionContext, AppFunctionContextV2, AppFunctionDataViewApi, AppFunctionFileReadInput, AppFunctionFileReadOptions, AppFunctionFilesApi, AppFunctionFormApi, AppFunctionFormDeleteResult, AppFunctionFormFileReadOptions, AppFunctionFormGetByIdParams, AppFunctionFormQueryParams, AppFunctionFormWriteParams, AppFunctionHttpApi, AppFunctionHttpRequest, AppFunctionHttpResponse, AppFunctionManifestV2, AppFunctionNotificationApi, AppFunctionOperatorInfo, AppFunctionOrganizationApi, AppFunctionPermissionContext, AppFunctionPlatformApi, AppFunctionPlatformApiRequest, AppFunctionPlatformApiResponse, AppFunctionPlatformHttpApi, AppFunctionPlatformRolesApi, AppFunctionProcessApi, AppFunctionProcessStartResult, AppFunctionProcessTaskResult, AppFunctionProcessWithdrawResult, AppFunctionRoleBatchAddResult, AppFunctionRoleListParams, AppFunctionRoleMemberMutationResult, AppFunctionRoleUsersParams, AppFunctionRuntimeContext, AppFunctionSecretRef, AppFunctionSecrets, AppFunctionUtils, ApproveTaskParams, AssignPermissionsParams, AssignRolesParams, AttachmentPreviewList, AttachmentPreviewListProps, AuthChallengePayload, AuthClientError, AuthClientErrorOptions, AuthClientOptions, AuthErrorExtra, AuthLogoutRedirectOptions, AuthMethod, AuthMethodType, AuthTokenData, AuthUser, BatchAddUsersToRoleParams, BatchSendNotificationByTypeParams, ChangeOrganizationAccountPasswordParams, ChangeUserRoleParams, ConnectorCallParams, ConnectorInvokeParams, ConnectorInvokeResult, ConnectorRequestBodyType, ConnectorResponseType, CreateApiPermissionParams, CreateFileAccessTicketOptions, CreateFormPermissionGroupDto, CreateOrganizationAccountParams, CreateOrganizationDepartmentParams, CreatePagePermissionGroupDto, CreateRoleParams, CreateUiPermissionParams, CreateUserParams, CurrentUserDepartmentParents, CustomPageEntryConfig, CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, DataManagementConfigParams, DataManagementFilterState, DataPermissionConditionDto, DataPermissionDto, DataPermissionRuleDto, DataViewQueryParams, DataViewQueryResult, DataViewStatsParams, DingTalkBrowserContext, DingTalkClient, DingTalkExternalBrowserGuide, DingTalkExternalBrowserGuideProps, DingTalkLoginEnvironment, DingTalkLoginFlow, DingTalkLoginInput, DingTalkNotificationCapabilities, DingTalkNotificationCardConfig, DingTalkNotificationCardField, DingTalkNotificationCardMode, DingTalkNotificationCardPreview, DingTalkNotificationChannelConfig, DingTalkNotificationDeliveryMode, DingTalkNotificationPreviewResult, DingTalkOAuthStartInput, DingTalkOAuthStartResult, ExecuteProcessOperationInput, FieldAccessLevel, FieldAccessPolicyDto, FieldAccessPolicyItemDto, FieldOptionValue, FieldPermissionDto, FileAccessTicketAction, FileAccessTicketPurpose, FileAccessTicketResult, FilePreviewController, FilePreviewItem, FindNotificationConfigParams, FormAdvancedSearchParams, FormChangeRecordParams, FormCreateParams, FormCreateResult, FormDetailResult, FormExportParams, FormFieldValue, FormGetDetailParams, FormImportParams, FormInstanceIdentifierResult, FormPermissionGroup, FormRemoveParams, FormSearchParams, FormUpdateParams, FormUpdateResult, FunctionInvokeParams, FunctionInvokeResult, GetParentDepartmentsOptions, GetProcessInstanceParams, GetUserRolesParams, GuestLoginInput, ImagePreviewGrid, ImagePreviewGridProps, ImportExportRecordDownloadParams, ImportExportRecordQuery, InitiatorApproverSelector, InstanceStatus, ListNotificationInboxParams, ListWorkCenterItemsParams, LoadDingTalkClientOptions, LoginLogGetParams, LoginLogListParams, LoginLogRecord, LoginLogStats, LoginLogStatsParams, LoginLogStatus, LoginMethodsResult, LoginPage, LoginPageProps, MarkAllNotificationReadResult, NotificationChannel, NotificationChannelConfig, NotificationChannelsConfig, NotificationConfigLevel, NotificationInboxListResult, NotificationInboxMessage, NotificationInboxReadStatus, NotificationMessageRecord, NotificationTemplate, NotificationTemplatePreview, NotificationTypeConfig, NotificationUnreadCountResult, OpenXiangdaPageProvider, OpenXiangdaPageProviderProps, OpenXiangdaProvider, OpenXiangdaProviderProps, OrganizationAccountListParams, OrganizationCapabilities, OrganizationListResult, PageApiPermissionRecord, PageApiResponse, PageAppInfo, PageBinaryResponse, PageDataManagementConfig, PageDataSourceDescriptor, PageDepartmentInfo, PageDepartmentRecord, PageHttpMethod, PageListResult, PageMessageApi, PageModalApi, PageNavigationApi, PageOffsetListResult, PagePermissionGroup, PagePermissionInfo, PageProvider, PageQueryValue, PageRequestCache, PageRequestOptions, PageRoleRecord, PageRouteInfo, PageScope, PageSdk, PageSdkError, PageSdkMeta, PageTransportDownloadPayload, PageTransportRequestPayload, PageUiPermissionRecord, PageUiPermissionType, PageUserInfo, PageUserRecord, PageUserType, PasswordLoginInput, PermissionBoundary, PermissionBoundaryFallback, PermissionBoundaryFallbackState, PermissionBoundaryProps, PhoneCodeInput, PhoneCodeLoginInput, PhoneCodeRegisterInput, PhoneCodeSendResult, PreviewDingTalkNotificationParams, PreviewNotificationTemplateParams, ProcessActionBar, ProcessActionBarProps, ProcessApproveAction, ProcessCapabilities, ProcessCapabilityOperation, ProcessInstanceLookupParams, ProcessPreviewPanel, ProcessPreviewPanelProps, ProcessTimeline, ProcessTimelineProps, PublicAccessClaim, PublicAccessClient, PublicAccessClientError, PublicAccessClientOptions, PublicAccessGate, PublicAccessGateProps, PublicAccessSessionData, PublicAccessSessionInput, PublicFormGrant, PublicStorageAction, PublicStorageGrant, QueryFormPermissionGroupDto, QueryPagePermissionGroupDto, RefreshInput, RequestDingTalkAuthCodeOptions, ResetOrganizationAccountPasswordParams, ResolveLoginUrlInput, ResolveProcessCapabilitiesParams, RoleListParams, RoleUsersParams, RouteAccessResult, RuntimeAuthGuard, RuntimeAuthGuardProps, RuntimeAuthState, RuntimeAuthStatus, RuntimeBootstrap, RuntimeErrorSnapshot, RuntimeErrorType, RuntimeLogoutOptions, RuntimeMenuItem, RuntimePagePermissions, RuntimeRedirectLoginOptions, RuntimeRequestError, RuntimeRequestState, RuntimeResolveLoginOptions, SaveDataManagementConfigParams, SchoolContactClass, SchoolContactPerson, SchoolContactRelationListParams, SchoolContactRelationListResult, SchoolContactRelationRecord, SchoolContactSyncState, SchoolContactTeacherListParams, SchoolContactTeacherListResult, SchoolContactTeacherMembershipRecord, SearchComponentName, SearchExpression, SearchFieldKey, SearchGroup, SearchLogic, SearchOperator, SearchRule, SearchSortItem, SearchSystemField, SendNotificationByTypeParams, SendNotificationResult, SsoLoginUrlInput, SsoLoginUrlResult, StructuredExportCellStyle, StructuredExportColumnDefinition, StructuredExportCreateParams, StructuredExportFormatDefinition, StructuredExportFormatType, StructuredExportGetParams, StructuredExportScope, StructuredExportSheetDefinition, StructuredExportSourceDefinition, StructuredExportStyleRule, StructuredExportTask, StructuredExportTaskStatus, StructuredExportValueDefinition, StructuredExportWorkbookDefinition, SubFormRule, SwitchAppRoleParams, SwitchPlatformRoleParams, TerminateProcessInstanceParams, TriggerCallbackTaskParams, TrustedNodeV2Context, UiPermissionListParams, UpdateApiPermissionParams, UpdateDingTalkCardParams, UpdateDingTalkCardResult, UpdateFormPermissionGroupDto, UpdateOrganizationAccountParams, UpdateOrganizationDepartmentParams, UpdatePagePermissionGroupDto, UpdateRoleParams, UpdateUiPermissionParams, UpdateUserParams, UseAuthOptions, UseCanAccessRouteInput, UseFilePreviewOptions, UseLoginMethodsState, UseProcessActionsOptions, UseProcessActionsReturn, UseProcessCapabilitiesOptions, UseProcessCapabilitiesReturn, UsePublicAccessOptions, UsePublicAccessState, UserListParams, UserMenuPermissionsResponse, ValidateUserParams, ViewFieldPermissionValue, ViewOperationPermission, ViewPermissionSummary, WorkCenterBoxType, WorkCenterGroupedStat, WorkCenterItem, WorkCenterListResult, WorkCenterStats, WorkCenterStatsParams, WorkflowApproveParams, WorkflowCapabilityActionKey, WorkflowDefinitionByFormParams, WorkflowInitiatorSelectCandidatesParams, WorkflowInitiatorSelectRequirementsParams, WorkflowPreviewParams, WorkflowResubmitInitiatorSelectRequirementsParams, WorkflowResubmitParams, WorkflowReturnParams, WorkflowSaveTaskParams, WorkflowStartFromExistingInstanceParams, WorkflowTaskParams, WorkflowTransferParams, WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap } from './react.js';
+export { AdminList, AdminListBatchAction, AdminListColumn, AdminListColumnPreference, AdminListDataSource, AdminListDataSourceOptions, AdminListDataViewSourceOptions, AdminListDensity, AdminListExportDownloadOptions, AdminListExportInput, AdminListExportScope, AdminListExportTask, AdminListExportTaskStatus, AdminListFormSourceOptions, AdminListFunctionSourceOptions, AdminListLockedPreference, AdminListOption, AdminListPreference, AdminListPreferenceStore, AdminListProps, AdminListQuery, AdminListResult, AdminListRowAction, AdminListSearchField, AdminListSearchFieldType, AdminListSearchPreference, AdminListSelectionChange, AdminListSort, AdminListSortDirection, ApiEnvelope, ApiPermissionListParams, AppAuthClient, AppFunctionAttachmentReference, AppFunctionBase64File, AppFunctionConnectorApi, AppFunctionContext, AppFunctionContextV2, AppFunctionDataViewApi, AppFunctionFileReadInput, AppFunctionFileReadOptions, AppFunctionFilesApi, AppFunctionFormApi, AppFunctionFormDeleteResult, AppFunctionFormFileReadOptions, AppFunctionFormGetByIdParams, AppFunctionFormQueryParams, AppFunctionFormWriteParams, AppFunctionHttpApi, AppFunctionHttpRequest, AppFunctionHttpResponse, AppFunctionManifestV2, AppFunctionNotificationApi, AppFunctionOperatorInfo, AppFunctionOrganizationApi, AppFunctionPermissionContext, AppFunctionPlatformApi, AppFunctionPlatformApiRequest, AppFunctionPlatformApiResponse, AppFunctionPlatformHttpApi, AppFunctionPlatformRolesApi, AppFunctionProcessApi, AppFunctionProcessStartResult, AppFunctionProcessTaskResult, AppFunctionProcessWithdrawResult, AppFunctionRoleBatchAddResult, AppFunctionRoleListParams, AppFunctionRoleMemberMutationResult, AppFunctionRoleUsersParams, AppFunctionRuntimeContext, AppFunctionSecretRef, AppFunctionSecrets, AppFunctionUtils, ApproveTaskParams, AssignPermissionsParams, AssignRolesParams, AttachmentPreviewList, AttachmentPreviewListProps, AuthChallengePayload, AuthClientError, AuthClientErrorOptions, AuthClientOptions, AuthErrorExtra, AuthLogoutRedirectOptions, AuthMethod, AuthMethodType, AuthTokenData, AuthUser, BatchAddUsersToRoleParams, BatchSendNotificationByTypeParams, ChangeOrganizationAccountPasswordParams, ChangeUserRoleParams, ConnectorCallParams, ConnectorInvokeParams, ConnectorInvokeResult, ConnectorRequestBodyType, ConnectorResponseType, CreateApiPermissionParams, CreateFileAccessTicketOptions, CreateFormPermissionGroupDto, CreateOrganizationAccountParams, CreateOrganizationDepartmentParams, CreatePagePermissionGroupDto, CreateRoleParams, CreateUiPermissionParams, CreateUserParams, CurrentUserDepartmentParents, CustomPageEntryConfig, CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, DataManagementConfigParams, DataManagementFilterState, DataPermissionConditionDto, DataPermissionDto, DataPermissionRuleDto, DataViewQueryParams, DataViewQueryResult, DataViewStatsParams, DingTalkBrowserContext, DingTalkClient, DingTalkExternalBrowserGuide, DingTalkExternalBrowserGuideProps, DingTalkLoginEnvironment, DingTalkLoginFlow, DingTalkLoginInput, DingTalkNotificationCapabilities, DingTalkNotificationCardConfig, DingTalkNotificationCardField, DingTalkNotificationCardMode, DingTalkNotificationCardPreview, DingTalkNotificationChannelConfig, DingTalkNotificationDeliveryMode, DingTalkNotificationPreviewResult, DingTalkOAuthStartInput, DingTalkOAuthStartResult, ExecuteProcessOperationInput, FieldAccessLevel, FieldAccessPolicyDto, FieldAccessPolicyItemDto, FieldOptionValue, FieldPermissionDto, FileAccessTicketAction, FileAccessTicketPurpose, FileAccessTicketResult, FilePreviewController, FilePreviewItem, FindNotificationConfigParams, FormAdvancedSearchParams, FormChangeRecordParams, FormCreateParams, FormCreateResult, FormDetailResult, FormExportParams, FormFieldValue, FormGetDetailParams, FormImportParams, FormInstanceIdentifierResult, FormPermissionGroup, FormRemoveParams, FormSearchParams, FormUpdateParams, FormUpdateResult, FunctionInvokeParams, FunctionInvokeResult, GetParentDepartmentsOptions, GetProcessInstanceParams, GetUserRolesParams, GuestLoginInput, ImagePreviewGrid, ImagePreviewGridProps, ImportExportRecordDownloadParams, ImportExportRecordQuery, InitiatorApproverSelector, InstanceStatus, ListNotificationInboxParams, ListWorkCenterItemsParams, LoadDingTalkClientOptions, LoginLogGetParams, LoginLogListParams, LoginLogRecord, LoginLogStats, LoginLogStatsParams, LoginLogStatus, LoginMethodsResult, LoginPage, LoginPageProps, MarkAllNotificationReadResult, NotificationChannel, NotificationChannelConfig, NotificationChannelsConfig, NotificationConfigLevel, NotificationInboxListResult, NotificationInboxMessage, NotificationInboxReadStatus, NotificationMessageRecord, NotificationTemplate, NotificationTemplatePreview, NotificationTypeConfig, NotificationUnreadCountResult, OpenXiangdaPageProvider, OpenXiangdaPageProviderProps, OpenXiangdaProvider, OpenXiangdaProviderProps, OrganizationAccountListParams, OrganizationCapabilities, OrganizationListResult, PageApiPermissionRecord, PageApiResponse, PageAppInfo, PageBinaryResponse, PageDataManagementConfig, PageDataSourceDescriptor, PageDepartmentInfo, PageDepartmentRecord, PageHttpMethod, PageListResult, PageMessageApi, PageModalApi, PageNavigationApi, PageOffsetListResult, PagePermissionGroup, PagePermissionInfo, PageProvider, PageQueryValue, PageRequestCache, PageRequestOptions, PageRoleRecord, PageRouteInfo, PageScope, PageSdk, PageSdkError, PageSdkMeta, PageTransportDownloadPayload, PageTransportRequestPayload, PageUiPermissionRecord, PageUiPermissionType, PageUserInfo, PageUserRecord, PageUserType, PasswordLoginInput, PermissionBoundary, PermissionBoundaryFallback, PermissionBoundaryFallbackState, PermissionBoundaryProps, PhoneCodeInput, PhoneCodeLoginInput, PhoneCodeRegisterInput, PhoneCodeSendResult, PreviewDingTalkNotificationParams, PreviewNotificationTemplateParams, ProcessActionBar, ProcessActionBarProps, ProcessApproveAction, ProcessCapabilities, ProcessCapabilityOperation, ProcessInstanceLookupParams, ProcessPreviewPanel, ProcessPreviewPanelProps, ProcessTimeline, ProcessTimelineProps, PublicAccessClaim, PublicAccessClient, PublicAccessClientError, PublicAccessClientOptions, PublicAccessGate, PublicAccessGateProps, PublicAccessSessionData, PublicAccessSessionInput, PublicFormGrant, PublicStorageAction, PublicStorageGrant, QueryFormPermissionGroupDto, QueryPagePermissionGroupDto, RefreshInput, RequestDingTalkAuthCodeOptions, ResetOrganizationAccountPasswordParams, ResolveLoginUrlInput, ResolveProcessCapabilitiesParams, RoleListParams, RoleUsersParams, RouteAccessResult, RuntimeAuthGuard, RuntimeAuthGuardProps, RuntimeAuthState, RuntimeAuthStatus, RuntimeBootstrap, RuntimeErrorSnapshot, RuntimeErrorType, RuntimeLogoutOptions, RuntimeMenuItem, RuntimePagePermissions, RuntimeRedirectLoginOptions, RuntimeRequestError, RuntimeRequestState, RuntimeResolveLoginOptions, SaveDataManagementConfigParams, SchoolContactClass, SchoolContactPerson, SchoolContactRelationListParams, SchoolContactRelationListResult, SchoolContactRelationRecord, SchoolContactSyncState, SchoolContactTeacher, SchoolContactTeacherListParams, SchoolContactTeacherListResult, SchoolContactTeacherMembershipRecord, SearchComponentName, SearchExpression, SearchFieldKey, SearchGroup, SearchLogic, SearchOperator, SearchRule, SearchSortItem, SearchSystemField, SendNotificationByTypeParams, SendNotificationResult, SsoLoginUrlInput, SsoLoginUrlResult, StructuredExportCellStyle, StructuredExportColumnDefinition, StructuredExportCreateParams, StructuredExportFormatDefinition, StructuredExportFormatType, StructuredExportGetParams, StructuredExportScope, StructuredExportSheetDefinition, StructuredExportSourceDefinition, StructuredExportStyleRule, StructuredExportTask, StructuredExportTaskStatus, StructuredExportValueDefinition, StructuredExportWorkbookDefinition, SubFormRule, SwitchAppRoleParams, SwitchPlatformRoleParams, TerminateProcessInstanceParams, TriggerCallbackTaskParams, TrustedNodeV2Context, UiPermissionListParams, UpdateApiPermissionParams, UpdateDingTalkCardParams, UpdateDingTalkCardResult, UpdateFormPermissionGroupDto, UpdateOrganizationAccountParams, UpdateOrganizationDepartmentParams, UpdatePagePermissionGroupDto, UpdateRoleParams, UpdateUiPermissionParams, UpdateUserParams, UseAuthOptions, UseCanAccessRouteInput, UseFilePreviewOptions, UseLoginMethodsState, UseProcessActionsOptions, UseProcessActionsReturn, UseProcessCapabilitiesOptions, UseProcessCapabilitiesReturn, UsePublicAccessOptions, UsePublicAccessState, UserListParams, UserMenuPermissionsResponse, ValidateUserParams, ViewFieldPermissionValue, ViewOperationPermission, ViewPermissionSummary, WorkCenterBoxType, WorkCenterGroupedStat, WorkCenterItem, WorkCenterListResult, WorkCenterStats, WorkCenterStatsParams, WorkflowApproveParams, WorkflowCapabilityActionKey, WorkflowDefinitionByFormParams, WorkflowInitiatorSelectCandidatesParams, WorkflowInitiatorSelectRequirementsParams, WorkflowPreviewParams, WorkflowResubmitInitiatorSelectRequirementsParams, WorkflowResubmitParams, WorkflowReturnParams, WorkflowSaveTaskParams, WorkflowStartFromExistingInstanceParams, WorkflowTaskParams, WorkflowTransferParams, WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap } from './react.js';
 import React__default from 'react';
 import { b as FormSchema, a as FormRuntimeApi, c as FormRuntimeApiConfig } from '../ProcessPreview-DSUIJi5V.js';
 export { e as extractFieldsFromComponentsTree } from '../dataManagementApi-Ro9itwm8.js';

package/packages/sdk/dist/runtime/react.d.mts

@@ -412,7 +412,7 @@ interface OrganizationListResult<TItem = unknown> {
 }
 interface SchoolContactPerson {
     userId: string;
-    dingtalkUserId: string;
+    dingtalkUserId: string | null;
     name: string;
     mobile: string | null;
 }
@@ -423,6 +423,12 @@ interface SchoolContactClass {
     campusName: string | null;
     periodName: string | null;
     gradeName: string | null;
+    /** Current head teachers for this class. Populated by teachers.list. */
+    headTeachers?: SchoolContactPerson[];
+}
+interface SchoolContactTeacher extends SchoolContactPerson {
+    /** Classes currently managed by this teacher as head teacher. */
+    managedClasses: SchoolContactClass[];
 }
 interface SchoolContactSyncState {
     enabled: boolean;
@@ -458,9 +464,10 @@ interface SchoolContactRelationListParams {
 }
 interface SchoolContactTeacherMembershipRecord {
     membershipId: string;
-    teacher: SchoolContactPerson;
+    teacher: SchoolContactTeacher;
     class: SchoolContactClass;
     isHeadTeacher: boolean;
+    source: "dingtalk_school_contact" | "manual";
     syncedAt: string | Date;
     syncState: SchoolContactSyncState["state"];
 }
@@ -881,12 +888,12 @@ interface FormCreateParams {
     draft?: boolean;
     startProcess?: boolean;
     autoStartProcess?: boolean;
-    processStartMode?: 'auto' | 'manual' | 'draft' | 'delayed' | 'none' | string;
+    processStartMode?: "auto" | "manual" | "draft" | "delayed" | "none" | string;
     /**
      * Legacy compatibility only. New code should not infer a created row by
      * submitted field values; the save API returns identifiers, not full row data.
      */
-    lookupAfterCreate?: boolean | 'legacy';
+    lookupAfterCreate?: boolean | "legacy";
     lookupFields?: string[];
 }
 interface FormUpdateParams {
@@ -3199,4 +3206,4 @@ declare function requestDingTalkAuthCode({ clientId, corpId, client, timeoutMs,
 declare function getDingTalkOAuthRecoveryMessage(search?: string | URLSearchParams): "检测到授权过程中切换了浏览器，请在当前浏览器重新点击“使用钉钉登录”。" | undefined;
 declare const DingTalkExternalBrowserGuide: React__default.FC<DingTalkExternalBrowserGuideProps>;
 
-export { AdminList, type AdminListBatchAction, type AdminListColumn, type AdminListColumnPreference, type AdminListDataSource, type AdminListDataSourceOptions, type AdminListDataViewSourceOptions, type AdminListDensity, type AdminListExportDownloadOptions, type AdminListExportInput, type AdminListExportScope, type AdminListExportTask, type AdminListExportTaskStatus, type AdminListFormSourceOptions, type AdminListFunctionSourceOptions, type AdminListLockedPreference, type AdminListOption, type AdminListPreference, type AdminListPreferenceStore, type AdminListProps, type AdminListQuery, type AdminListResult, type AdminListRowAction, type AdminListSearchField, type AdminListSearchFieldType, type AdminListSearchPreference, type AdminListSelectionChange, type AdminListSort, type AdminListSortDirection, type ApiEnvelope, type ApiPermissionListParams, type AppAuthClient, type AppFunctionAttachmentReference, type AppFunctionBase64File, type AppFunctionConnectorApi, type AppFunctionContext, type AppFunctionContextV2, type AppFunctionDataViewApi, type AppFunctionFileReadInput, type AppFunctionFileReadOptions, type AppFunctionFilesApi, type AppFunctionFormApi, type AppFunctionFormDeleteResult, type AppFunctionFormFileReadOptions, type AppFunctionFormGetByIdParams, type AppFunctionFormQueryParams, type AppFunctionFormWriteParams, type AppFunctionHttpApi, type AppFunctionHttpRequest, type AppFunctionHttpResponse, type AppFunctionManifestV2, type AppFunctionNotificationApi, type AppFunctionOperatorInfo, type AppFunctionOrganizationApi, type AppFunctionPermissionContext, type AppFunctionPlatformApi, type AppFunctionPlatformApiRequest, type AppFunctionPlatformApiResponse, type AppFunctionPlatformHttpApi, type AppFunctionPlatformRolesApi, type AppFunctionProcessApi, type AppFunctionProcessStartResult, type AppFunctionProcessTaskResult, type AppFunctionProcessWithdrawResult, type AppFunctionRoleBatchAddResult, type AppFunctionRoleListParams, type AppFunctionRoleMemberMutationResult, type AppFunctionRoleUsersParams, type AppFunctionRuntimeContext, type AppFunctionSecretRef, type AppFunctionSecrets, type AppFunctionUtils, type ApproveTaskParams, type AssignPermissionsParams, type AssignRolesParams, AttachmentPreviewList, type AttachmentPreviewListProps, type AuthChallengePayload, AuthClientError, type AuthClientErrorOptions, type AuthClientOptions, type AuthErrorExtra, type AuthLogoutRedirectOptions, type AuthMethod, type AuthMethodType, type AuthTokenData, type AuthUser, type BatchAddUsersToRoleParams, type BatchSendNotificationByTypeParams, type ChangeOrganizationAccountPasswordParams, type ChangeUserRoleParams, type ConnectorCallParams, type ConnectorInvokeParams, type ConnectorInvokeResult, type ConnectorRequestBodyType, type ConnectorResponseType, type CreateApiPermissionParams, type CreateFileAccessTicketOptions, type CreateFormPermissionGroupDto, type CreateOrganizationAccountParams, type CreateOrganizationDepartmentParams, type CreatePagePermissionGroupDto, type CreateRoleParams, type CreateUiPermissionParams, type CreateUserParams, type CurrentUserDepartmentParents, type CustomPageEntryConfig, type CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, type DataManagementConfigParams, type DataManagementFilterState, type DataPermissionConditionDto, type DataPermissionDto, type DataPermissionRuleDto, type DataViewQueryParams, type DataViewQueryResult, type DataViewStatsParams, type DingTalkBrowserContext, type DingTalkClient, DingTalkExternalBrowserGuide, type DingTalkExternalBrowserGuideProps, type DingTalkLoginEnvironment, type DingTalkLoginFlow, type DingTalkLoginInput, type DingTalkNotificationCapabilities, type DingTalkNotificationCardConfig, type DingTalkNotificationCardField, type DingTalkNotificationCardMode, type DingTalkNotificationCardPreview, type DingTalkNotificationChannelConfig, type DingTalkNotificationDeliveryMode, type DingTalkNotificationPreviewResult, type DingTalkOAuthStartInput, type DingTalkOAuthStartResult, type ExecuteProcessOperationInput, type FieldAccessLevel, type FieldAccessPolicyDto, type FieldAccessPolicyItemDto, type FieldOptionValue, type FieldPermissionDto, type FileAccessTicketAction, type FileAccessTicketPurpose, type FileAccessTicketResult, type FilePreviewController, type FilePreviewItem, type FindNotificationConfigParams, type FormAdvancedSearchParams, type FormChangeRecordParams, type FormCreateParams, type FormCreateResult, type FormDetailResult, type FormExportParams, type FormFieldValue, type FormGetDetailParams, type FormImportParams, type FormInstanceIdentifierResult, type FormPermissionGroup, type FormRemoveParams, type FormSearchParams, type FormUpdateParams, type FormUpdateResult, type FunctionInvokeParams, type FunctionInvokeResult, type GetParentDepartmentsOptions, type GetProcessInstanceParams, type GetUserRolesParams, type GuestLoginInput, ImagePreviewGrid, type ImagePreviewGridProps, type ImportExportRecordDownloadParams, type ImportExportRecordQuery, InitiatorApproverSelector, type InstanceStatus, type ListNotificationInboxParams, type ListWorkCenterItemsParams, type LoadDingTalkClientOptions, type LoginLogGetParams, type LoginLogListParams, type LoginLogRecord, type LoginLogStats, type LoginLogStatsParams, type LoginLogStatus, type LoginMethodsResult, LoginPage, type LoginPageProps, type MarkAllNotificationReadResult, type NotificationChannel, type NotificationChannelConfig, type NotificationChannelsConfig, type NotificationConfigLevel, type NotificationInboxListResult, type NotificationInboxMessage, type NotificationInboxReadStatus, type NotificationMessageRecord, type NotificationTemplate, type NotificationTemplatePreview, type NotificationTypeConfig, type NotificationUnreadCountResult, OpenXiangdaPageProvider, type OpenXiangdaPageProviderProps, OpenXiangdaProvider, type OpenXiangdaProviderProps, type OrganizationAccountListParams, type OrganizationCapabilities, type OrganizationListResult, type PageApiPermissionRecord, type PageApiResponse, type PageAppInfo, type PageBinaryResponse, type PageBridgeApi, type PageContext, type PageDataManagementConfig, type PageDataSourceDescriptor, type PageDepartmentInfo, type PageDepartmentRecord, type PageHttpMethod, type PageInfo, type PageListResult, type PageMessageApi, type PageModalApi, type PageNavigationApi, type PageOffsetListResult, type PagePermissionGroup, type PagePermissionInfo, PageProvider, type PageQueryValue, type PageRequestCache, type PageRequestOptions, type PageRoleRecord, type PageRouteInfo, type PageScope, type PageSdk, type PageSdkError, type PageSdkMeta, type PageTransportDownloadPayload, type PageTransportRequestPayload, type PageUiPermissionRecord, type PageUiPermissionType, type PageUserInfo, type PageUserRecord, type PageUserType, type PasswordLoginInput, PermissionBoundary, type PermissionBoundaryFallback, type PermissionBoundaryFallbackState, type PermissionBoundaryProps, type PhoneCodeInput, type PhoneCodeLoginInput, type PhoneCodeRegisterInput, type PhoneCodeSendResult, type PreviewDingTalkNotificationParams, type PreviewNotificationTemplateParams, ProcessActionBar, type ProcessActionBarProps, type ProcessApproveAction, type ProcessCapabilities, type ProcessCapabilityOperation, type ProcessInstanceLookupParams, ProcessPreviewPanel, type ProcessPreviewPanelProps, ProcessTimeline, type ProcessTimelineProps, type PublicAccessClaim, type PublicAccessClient, PublicAccessClientError, type PublicAccessClientOptions, PublicAccessGate, type PublicAccessGateProps, type PublicAccessSessionData, type PublicAccessSessionInput, type PublicFormGrant, type PublicStorageAction, type PublicStorageGrant, type QueryFormPermissionGroupDto, type QueryPagePermissionGroupDto, type RefreshInput, type RequestDingTalkAuthCodeOptions, type ResetOrganizationAccountPasswordParams, type ResolveLoginUrlInput, type ResolveProcessCapabilitiesParams, type RoleListParams, type RoleUsersParams, type RouteAccessResult, RuntimeAuthGuard, type RuntimeAuthGuardProps, type RuntimeAuthState, type RuntimeAuthStatus, type RuntimeBootstrap, type RuntimeErrorSnapshot, type RuntimeErrorType, type RuntimeLogoutOptions, type RuntimeMenuItem, type RuntimePagePermissions, type RuntimeRedirectLoginOptions, type RuntimeRequestError, type RuntimeRequestState, type RuntimeResolveLoginOptions, type SaveDataManagementConfigParams, type SchoolContactClass, type SchoolContactPerson, type SchoolContactRelationListParams, type SchoolContactRelationListResult, type SchoolContactRelationRecord, type SchoolContactSyncState, type SchoolContactTeacherListParams, type SchoolContactTeacherListResult, type SchoolContactTeacherMembershipRecord, type SearchComponentName, type SearchExpression, type SearchFieldKey, type SearchGroup, type SearchLogic, type SearchOperator, type SearchRule, type SearchSortItem, type SearchSystemField, type SendNotificationByTypeParams, type SendNotificationResult, type SsoLoginUrlInput, type SsoLoginUrlResult, type StructuredExportCellStyle, type StructuredExportColumnDefinition, type StructuredExportCreateParams, type StructuredExportFormatDefinition, type StructuredExportFormatType, type StructuredExportGetParams, type StructuredExportScope, type StructuredExportSheetDefinition, type StructuredExportSourceDefinition, type StructuredExportStyleRule, type StructuredExportTask, type StructuredExportTaskStatus, type StructuredExportValueDefinition, type StructuredExportWorkbookDefinition, type SubFormRule, type SwitchAppRoleParams, type SwitchPlatformRoleParams, type TerminateProcessInstanceParams, type TriggerCallbackTaskParams, type TrustedNodeV2Context, type UiPermissionListParams, type UpdateApiPermissionParams, type UpdateDingTalkCardParams, type UpdateDingTalkCardResult, type UpdateFormPermissionGroupDto, type UpdateOrganizationAccountParams, type UpdateOrganizationDepartmentParams, type UpdatePagePermissionGroupDto, type UpdateRoleParams, type UpdateUiPermissionParams, type UpdateUserParams, type UseAuthOptions, type UseCanAccessRouteInput, type UseFilePreviewOptions, type UseLoginMethodsState, type UseProcessActionsOptions, type UseProcessActionsReturn, type UseProcessCapabilitiesOptions, type UseProcessCapabilitiesReturn, type UsePublicAccessOptions, type UsePublicAccessState, type UserListParams, type UserMenuPermissionsResponse, type ValidateUserParams, type ViewFieldPermissionValue, type ViewOperationPermission, type ViewPermissionSummary, type WorkCenterBoxType, type WorkCenterGroupedStat, type WorkCenterItem, type WorkCenterListResult, type WorkCenterStats, type WorkCenterStatsParams, type WorkflowApproveParams, type WorkflowCapabilityActionKey, type WorkflowDefinitionByFormParams, type WorkflowInitiatorSelectCandidatesParams, type WorkflowInitiatorSelectRequirementsParams, type WorkflowPreviewParams, type WorkflowResubmitInitiatorSelectRequirementsParams, type WorkflowResubmitParams, type WorkflowReturnParams, type WorkflowSaveTaskParams, type WorkflowStartFromExistingInstanceParams, type WorkflowTaskParams, type WorkflowTransferParams, type WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap };
+export { AdminList, type AdminListBatchAction, type AdminListColumn, type AdminListColumnPreference, type AdminListDataSource, type AdminListDataSourceOptions, type AdminListDataViewSourceOptions, type AdminListDensity, type AdminListExportDownloadOptions, type AdminListExportInput, type AdminListExportScope, type AdminListExportTask, type AdminListExportTaskStatus, type AdminListFormSourceOptions, type AdminListFunctionSourceOptions, type AdminListLockedPreference, type AdminListOption, type AdminListPreference, type AdminListPreferenceStore, type AdminListProps, type AdminListQuery, type AdminListResult, type AdminListRowAction, type AdminListSearchField, type AdminListSearchFieldType, type AdminListSearchPreference, type AdminListSelectionChange, type AdminListSort, type AdminListSortDirection, type ApiEnvelope, type ApiPermissionListParams, type AppAuthClient, type AppFunctionAttachmentReference, type AppFunctionBase64File, type AppFunctionConnectorApi, type AppFunctionContext, type AppFunctionContextV2, type AppFunctionDataViewApi, type AppFunctionFileReadInput, type AppFunctionFileReadOptions, type AppFunctionFilesApi, type AppFunctionFormApi, type AppFunctionFormDeleteResult, type AppFunctionFormFileReadOptions, type AppFunctionFormGetByIdParams, type AppFunctionFormQueryParams, type AppFunctionFormWriteParams, type AppFunctionHttpApi, type AppFunctionHttpRequest, type AppFunctionHttpResponse, type AppFunctionManifestV2, type AppFunctionNotificationApi, type AppFunctionOperatorInfo, type AppFunctionOrganizationApi, type AppFunctionPermissionContext, type AppFunctionPlatformApi, type AppFunctionPlatformApiRequest, type AppFunctionPlatformApiResponse, type AppFunctionPlatformHttpApi, type AppFunctionPlatformRolesApi, type AppFunctionProcessApi, type AppFunctionProcessStartResult, type AppFunctionProcessTaskResult, type AppFunctionProcessWithdrawResult, type AppFunctionRoleBatchAddResult, type AppFunctionRoleListParams, type AppFunctionRoleMemberMutationResult, type AppFunctionRoleUsersParams, type AppFunctionRuntimeContext, type AppFunctionSecretRef, type AppFunctionSecrets, type AppFunctionUtils, type ApproveTaskParams, type AssignPermissionsParams, type AssignRolesParams, AttachmentPreviewList, type AttachmentPreviewListProps, type AuthChallengePayload, AuthClientError, type AuthClientErrorOptions, type AuthClientOptions, type AuthErrorExtra, type AuthLogoutRedirectOptions, type AuthMethod, type AuthMethodType, type AuthTokenData, type AuthUser, type BatchAddUsersToRoleParams, type BatchSendNotificationByTypeParams, type ChangeOrganizationAccountPasswordParams, type ChangeUserRoleParams, type ConnectorCallParams, type ConnectorInvokeParams, type ConnectorInvokeResult, type ConnectorRequestBodyType, type ConnectorResponseType, type CreateApiPermissionParams, type CreateFileAccessTicketOptions, type CreateFormPermissionGroupDto, type CreateOrganizationAccountParams, type CreateOrganizationDepartmentParams, type CreatePagePermissionGroupDto, type CreateRoleParams, type CreateUiPermissionParams, type CreateUserParams, type CurrentUserDepartmentParents, type CustomPageEntryConfig, type CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, type DataManagementConfigParams, type DataManagementFilterState, type DataPermissionConditionDto, type DataPermissionDto, type DataPermissionRuleDto, type DataViewQueryParams, type DataViewQueryResult, type DataViewStatsParams, type DingTalkBrowserContext, type DingTalkClient, DingTalkExternalBrowserGuide, type DingTalkExternalBrowserGuideProps, type DingTalkLoginEnvironment, type DingTalkLoginFlow, type DingTalkLoginInput, type DingTalkNotificationCapabilities, type DingTalkNotificationCardConfig, type DingTalkNotificationCardField, type DingTalkNotificationCardMode, type DingTalkNotificationCardPreview, type DingTalkNotificationChannelConfig, type DingTalkNotificationDeliveryMode, type DingTalkNotificationPreviewResult, type DingTalkOAuthStartInput, type DingTalkOAuthStartResult, type ExecuteProcessOperationInput, type FieldAccessLevel, type FieldAccessPolicyDto, type FieldAccessPolicyItemDto, type FieldOptionValue, type FieldPermissionDto, type FileAccessTicketAction, type FileAccessTicketPurpose, type FileAccessTicketResult, type FilePreviewController, type FilePreviewItem, type FindNotificationConfigParams, type FormAdvancedSearchParams, type FormChangeRecordParams, type FormCreateParams, type FormCreateResult, type FormDetailResult, type FormExportParams, type FormFieldValue, type FormGetDetailParams, type FormImportParams, type FormInstanceIdentifierResult, type FormPermissionGroup, type FormRemoveParams, type FormSearchParams, type FormUpdateParams, type FormUpdateResult, type FunctionInvokeParams, type FunctionInvokeResult, type GetParentDepartmentsOptions, type GetProcessInstanceParams, type GetUserRolesParams, type GuestLoginInput, ImagePreviewGrid, type ImagePreviewGridProps, type ImportExportRecordDownloadParams, type ImportExportRecordQuery, InitiatorApproverSelector, type InstanceStatus, type ListNotificationInboxParams, type ListWorkCenterItemsParams, type LoadDingTalkClientOptions, type LoginLogGetParams, type LoginLogListParams, type LoginLogRecord, type LoginLogStats, type LoginLogStatsParams, type LoginLogStatus, type LoginMethodsResult, LoginPage, type LoginPageProps, type MarkAllNotificationReadResult, type NotificationChannel, type NotificationChannelConfig, type NotificationChannelsConfig, type NotificationConfigLevel, type NotificationInboxListResult, type NotificationInboxMessage, type NotificationInboxReadStatus, type NotificationMessageRecord, type NotificationTemplate, type NotificationTemplatePreview, type NotificationTypeConfig, type NotificationUnreadCountResult, OpenXiangdaPageProvider, type OpenXiangdaPageProviderProps, OpenXiangdaProvider, type OpenXiangdaProviderProps, type OrganizationAccountListParams, type OrganizationCapabilities, type OrganizationListResult, type PageApiPermissionRecord, type PageApiResponse, type PageAppInfo, type PageBinaryResponse, type PageBridgeApi, type PageContext, type PageDataManagementConfig, type PageDataSourceDescriptor, type PageDepartmentInfo, type PageDepartmentRecord, type PageHttpMethod, type PageInfo, type PageListResult, type PageMessageApi, type PageModalApi, type PageNavigationApi, type PageOffsetListResult, type PagePermissionGroup, type PagePermissionInfo, PageProvider, type PageQueryValue, type PageRequestCache, type PageRequestOptions, type PageRoleRecord, type PageRouteInfo, type PageScope, type PageSdk, type PageSdkError, type PageSdkMeta, type PageTransportDownloadPayload, type PageTransportRequestPayload, type PageUiPermissionRecord, type PageUiPermissionType, type PageUserInfo, type PageUserRecord, type PageUserType, type PasswordLoginInput, PermissionBoundary, type PermissionBoundaryFallback, type PermissionBoundaryFallbackState, type PermissionBoundaryProps, type PhoneCodeInput, type PhoneCodeLoginInput, type PhoneCodeRegisterInput, type PhoneCodeSendResult, type PreviewDingTalkNotificationParams, type PreviewNotificationTemplateParams, ProcessActionBar, type ProcessActionBarProps, type ProcessApproveAction, type ProcessCapabilities, type ProcessCapabilityOperation, type ProcessInstanceLookupParams, ProcessPreviewPanel, type ProcessPreviewPanelProps, ProcessTimeline, type ProcessTimelineProps, type PublicAccessClaim, type PublicAccessClient, PublicAccessClientError, type PublicAccessClientOptions, PublicAccessGate, type PublicAccessGateProps, type PublicAccessSessionData, type PublicAccessSessionInput, type PublicFormGrant, type PublicStorageAction, type PublicStorageGrant, type QueryFormPermissionGroupDto, type QueryPagePermissionGroupDto, type RefreshInput, type RequestDingTalkAuthCodeOptions, type ResetOrganizationAccountPasswordParams, type ResolveLoginUrlInput, type ResolveProcessCapabilitiesParams, type RoleListParams, type RoleUsersParams, type RouteAccessResult, RuntimeAuthGuard, type RuntimeAuthGuardProps, type RuntimeAuthState, type RuntimeAuthStatus, type RuntimeBootstrap, type RuntimeErrorSnapshot, type RuntimeErrorType, type RuntimeLogoutOptions, type RuntimeMenuItem, type RuntimePagePermissions, type RuntimeRedirectLoginOptions, type RuntimeRequestError, type RuntimeRequestState, type RuntimeResolveLoginOptions, type SaveDataManagementConfigParams, type SchoolContactClass, type SchoolContactPerson, type SchoolContactRelationListParams, type SchoolContactRelationListResult, type SchoolContactRelationRecord, type SchoolContactSyncState, type SchoolContactTeacher, type SchoolContactTeacherListParams, type SchoolContactTeacherListResult, type SchoolContactTeacherMembershipRecord, type SearchComponentName, type SearchExpression, type SearchFieldKey, type SearchGroup, type SearchLogic, type SearchOperator, type SearchRule, type SearchSortItem, type SearchSystemField, type SendNotificationByTypeParams, type SendNotificationResult, type SsoLoginUrlInput, type SsoLoginUrlResult, type StructuredExportCellStyle, type StructuredExportColumnDefinition, type StructuredExportCreateParams, type StructuredExportFormatDefinition, type StructuredExportFormatType, type StructuredExportGetParams, type StructuredExportScope, type StructuredExportSheetDefinition, type StructuredExportSourceDefinition, type StructuredExportStyleRule, type StructuredExportTask, type StructuredExportTaskStatus, type StructuredExportValueDefinition, type StructuredExportWorkbookDefinition, type SubFormRule, type SwitchAppRoleParams, type SwitchPlatformRoleParams, type TerminateProcessInstanceParams, type TriggerCallbackTaskParams, type TrustedNodeV2Context, type UiPermissionListParams, type UpdateApiPermissionParams, type UpdateDingTalkCardParams, type UpdateDingTalkCardResult, type UpdateFormPermissionGroupDto, type UpdateOrganizationAccountParams, type UpdateOrganizationDepartmentParams, type UpdatePagePermissionGroupDto, type UpdateRoleParams, type UpdateUiPermissionParams, type UpdateUserParams, type UseAuthOptions, type UseCanAccessRouteInput, type UseFilePreviewOptions, type UseLoginMethodsState, type UseProcessActionsOptions, type UseProcessActionsReturn, type UseProcessCapabilitiesOptions, type UseProcessCapabilitiesReturn, type UsePublicAccessOptions, type UsePublicAccessState, type UserListParams, type UserMenuPermissionsResponse, type ValidateUserParams, type ViewFieldPermissionValue, type ViewOperationPermission, type ViewPermissionSummary, type WorkCenterBoxType, type WorkCenterGroupedStat, type WorkCenterItem, type WorkCenterListResult, type WorkCenterStats, type WorkCenterStatsParams, type WorkflowApproveParams, type WorkflowCapabilityActionKey, type WorkflowDefinitionByFormParams, type WorkflowInitiatorSelectCandidatesParams, type WorkflowInitiatorSelectRequirementsParams, type WorkflowPreviewParams, type WorkflowResubmitInitiatorSelectRequirementsParams, type WorkflowResubmitParams, type WorkflowReturnParams, type WorkflowSaveTaskParams, type WorkflowStartFromExistingInstanceParams, type WorkflowTaskParams, type WorkflowTransferParams, type WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap };

package/packages/sdk/dist/runtime/react.d.ts

@@ -412,7 +412,7 @@ interface OrganizationListResult<TItem = unknown> {
 }
 interface SchoolContactPerson {
     userId: string;
-    dingtalkUserId: string;
+    dingtalkUserId: string | null;
     name: string;
     mobile: string | null;
 }
@@ -423,6 +423,12 @@ interface SchoolContactClass {
     campusName: string | null;
     periodName: string | null;
     gradeName: string | null;
+    /** Current head teachers for this class. Populated by teachers.list. */
+    headTeachers?: SchoolContactPerson[];
+}
+interface SchoolContactTeacher extends SchoolContactPerson {
+    /** Classes currently managed by this teacher as head teacher. */
+    managedClasses: SchoolContactClass[];
 }
 interface SchoolContactSyncState {
     enabled: boolean;
@@ -458,9 +464,10 @@ interface SchoolContactRelationListParams {
 }
 interface SchoolContactTeacherMembershipRecord {
     membershipId: string;
-    teacher: SchoolContactPerson;
+    teacher: SchoolContactTeacher;
     class: SchoolContactClass;
     isHeadTeacher: boolean;
+    source: "dingtalk_school_contact" | "manual";
     syncedAt: string | Date;
     syncState: SchoolContactSyncState["state"];
 }
@@ -881,12 +888,12 @@ interface FormCreateParams {
     draft?: boolean;
     startProcess?: boolean;
     autoStartProcess?: boolean;
-    processStartMode?: 'auto' | 'manual' | 'draft' | 'delayed' | 'none' | string;
+    processStartMode?: "auto" | "manual" | "draft" | "delayed" | "none" | string;
     /**
      * Legacy compatibility only. New code should not infer a created row by
      * submitted field values; the save API returns identifiers, not full row data.
      */
-    lookupAfterCreate?: boolean | 'legacy';
+    lookupAfterCreate?: boolean | "legacy";
     lookupFields?: string[];
 }
 interface FormUpdateParams {
@@ -3199,4 +3206,4 @@ declare function requestDingTalkAuthCode({ clientId, corpId, client, timeoutMs,
 declare function getDingTalkOAuthRecoveryMessage(search?: string | URLSearchParams): "检测到授权过程中切换了浏览器，请在当前浏览器重新点击“使用钉钉登录”。" | undefined;
 declare const DingTalkExternalBrowserGuide: React__default.FC<DingTalkExternalBrowserGuideProps>;
 
-export { AdminList, type AdminListBatchAction, type AdminListColumn, type AdminListColumnPreference, type AdminListDataSource, type AdminListDataSourceOptions, type AdminListDataViewSourceOptions, type AdminListDensity, type AdminListExportDownloadOptions, type AdminListExportInput, type AdminListExportScope, type AdminListExportTask, type AdminListExportTaskStatus, type AdminListFormSourceOptions, type AdminListFunctionSourceOptions, type AdminListLockedPreference, type AdminListOption, type AdminListPreference, type AdminListPreferenceStore, type AdminListProps, type AdminListQuery, type AdminListResult, type AdminListRowAction, type AdminListSearchField, type AdminListSearchFieldType, type AdminListSearchPreference, type AdminListSelectionChange, type AdminListSort, type AdminListSortDirection, type ApiEnvelope, type ApiPermissionListParams, type AppAuthClient, type AppFunctionAttachmentReference, type AppFunctionBase64File, type AppFunctionConnectorApi, type AppFunctionContext, type AppFunctionContextV2, type AppFunctionDataViewApi, type AppFunctionFileReadInput, type AppFunctionFileReadOptions, type AppFunctionFilesApi, type AppFunctionFormApi, type AppFunctionFormDeleteResult, type AppFunctionFormFileReadOptions, type AppFunctionFormGetByIdParams, type AppFunctionFormQueryParams, type AppFunctionFormWriteParams, type AppFunctionHttpApi, type AppFunctionHttpRequest, type AppFunctionHttpResponse, type AppFunctionManifestV2, type AppFunctionNotificationApi, type AppFunctionOperatorInfo, type AppFunctionOrganizationApi, type AppFunctionPermissionContext, type AppFunctionPlatformApi, type AppFunctionPlatformApiRequest, type AppFunctionPlatformApiResponse, type AppFunctionPlatformHttpApi, type AppFunctionPlatformRolesApi, type AppFunctionProcessApi, type AppFunctionProcessStartResult, type AppFunctionProcessTaskResult, type AppFunctionProcessWithdrawResult, type AppFunctionRoleBatchAddResult, type AppFunctionRoleListParams, type AppFunctionRoleMemberMutationResult, type AppFunctionRoleUsersParams, type AppFunctionRuntimeContext, type AppFunctionSecretRef, type AppFunctionSecrets, type AppFunctionUtils, type ApproveTaskParams, type AssignPermissionsParams, type AssignRolesParams, AttachmentPreviewList, type AttachmentPreviewListProps, type AuthChallengePayload, AuthClientError, type AuthClientErrorOptions, type AuthClientOptions, type AuthErrorExtra, type AuthLogoutRedirectOptions, type AuthMethod, type AuthMethodType, type AuthTokenData, type AuthUser, type BatchAddUsersToRoleParams, type BatchSendNotificationByTypeParams, type ChangeOrganizationAccountPasswordParams, type ChangeUserRoleParams, type ConnectorCallParams, type ConnectorInvokeParams, type ConnectorInvokeResult, type ConnectorRequestBodyType, type ConnectorResponseType, type CreateApiPermissionParams, type CreateFileAccessTicketOptions, type CreateFormPermissionGroupDto, type CreateOrganizationAccountParams, type CreateOrganizationDepartmentParams, type CreatePagePermissionGroupDto, type CreateRoleParams, type CreateUiPermissionParams, type CreateUserParams, type CurrentUserDepartmentParents, type CustomPageEntryConfig, type CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, type DataManagementConfigParams, type DataManagementFilterState, type DataPermissionConditionDto, type DataPermissionDto, type DataPermissionRuleDto, type DataViewQueryParams, type DataViewQueryResult, type DataViewStatsParams, type DingTalkBrowserContext, type DingTalkClient, DingTalkExternalBrowserGuide, type DingTalkExternalBrowserGuideProps, type DingTalkLoginEnvironment, type DingTalkLoginFlow, type DingTalkLoginInput, type DingTalkNotificationCapabilities, type DingTalkNotificationCardConfig, type DingTalkNotificationCardField, type DingTalkNotificationCardMode, type DingTalkNotificationCardPreview, type DingTalkNotificationChannelConfig, type DingTalkNotificationDeliveryMode, type DingTalkNotificationPreviewResult, type DingTalkOAuthStartInput, type DingTalkOAuthStartResult, type ExecuteProcessOperationInput, type FieldAccessLevel, type FieldAccessPolicyDto, type FieldAccessPolicyItemDto, type FieldOptionValue, type FieldPermissionDto, type FileAccessTicketAction, type FileAccessTicketPurpose, type FileAccessTicketResult, type FilePreviewController, type FilePreviewItem, type FindNotificationConfigParams, type FormAdvancedSearchParams, type FormChangeRecordParams, type FormCreateParams, type FormCreateResult, type FormDetailResult, type FormExportParams, type FormFieldValue, type FormGetDetailParams, type FormImportParams, type FormInstanceIdentifierResult, type FormPermissionGroup, type FormRemoveParams, type FormSearchParams, type FormUpdateParams, type FormUpdateResult, type FunctionInvokeParams, type FunctionInvokeResult, type GetParentDepartmentsOptions, type GetProcessInstanceParams, type GetUserRolesParams, type GuestLoginInput, ImagePreviewGrid, type ImagePreviewGridProps, type ImportExportRecordDownloadParams, type ImportExportRecordQuery, InitiatorApproverSelector, type InstanceStatus, type ListNotificationInboxParams, type ListWorkCenterItemsParams, type LoadDingTalkClientOptions, type LoginLogGetParams, type LoginLogListParams, type LoginLogRecord, type LoginLogStats, type LoginLogStatsParams, type LoginLogStatus, type LoginMethodsResult, LoginPage, type LoginPageProps, type MarkAllNotificationReadResult, type NotificationChannel, type NotificationChannelConfig, type NotificationChannelsConfig, type NotificationConfigLevel, type NotificationInboxListResult, type NotificationInboxMessage, type NotificationInboxReadStatus, type NotificationMessageRecord, type NotificationTemplate, type NotificationTemplatePreview, type NotificationTypeConfig, type NotificationUnreadCountResult, OpenXiangdaPageProvider, type OpenXiangdaPageProviderProps, OpenXiangdaProvider, type OpenXiangdaProviderProps, type OrganizationAccountListParams, type OrganizationCapabilities, type OrganizationListResult, type PageApiPermissionRecord, type PageApiResponse, type PageAppInfo, type PageBinaryResponse, type PageBridgeApi, type PageContext, type PageDataManagementConfig, type PageDataSourceDescriptor, type PageDepartmentInfo, type PageDepartmentRecord, type PageHttpMethod, type PageInfo, type PageListResult, type PageMessageApi, type PageModalApi, type PageNavigationApi, type PageOffsetListResult, type PagePermissionGroup, type PagePermissionInfo, PageProvider, type PageQueryValue, type PageRequestCache, type PageRequestOptions, type PageRoleRecord, type PageRouteInfo, type PageScope, type PageSdk, type PageSdkError, type PageSdkMeta, type PageTransportDownloadPayload, type PageTransportRequestPayload, type PageUiPermissionRecord, type PageUiPermissionType, type PageUserInfo, type PageUserRecord, type PageUserType, type PasswordLoginInput, PermissionBoundary, type PermissionBoundaryFallback, type PermissionBoundaryFallbackState, type PermissionBoundaryProps, type PhoneCodeInput, type PhoneCodeLoginInput, type PhoneCodeRegisterInput, type PhoneCodeSendResult, type PreviewDingTalkNotificationParams, type PreviewNotificationTemplateParams, ProcessActionBar, type ProcessActionBarProps, type ProcessApproveAction, type ProcessCapabilities, type ProcessCapabilityOperation, type ProcessInstanceLookupParams, ProcessPreviewPanel, type ProcessPreviewPanelProps, ProcessTimeline, type ProcessTimelineProps, type PublicAccessClaim, type PublicAccessClient, PublicAccessClientError, type PublicAccessClientOptions, PublicAccessGate, type PublicAccessGateProps, type PublicAccessSessionData, type PublicAccessSessionInput, type PublicFormGrant, type PublicStorageAction, type PublicStorageGrant, type QueryFormPermissionGroupDto, type QueryPagePermissionGroupDto, type RefreshInput, type RequestDingTalkAuthCodeOptions, type ResetOrganizationAccountPasswordParams, type ResolveLoginUrlInput, type ResolveProcessCapabilitiesParams, type RoleListParams, type RoleUsersParams, type RouteAccessResult, RuntimeAuthGuard, type RuntimeAuthGuardProps, type RuntimeAuthState, type RuntimeAuthStatus, type RuntimeBootstrap, type RuntimeErrorSnapshot, type RuntimeErrorType, type RuntimeLogoutOptions, type RuntimeMenuItem, type RuntimePagePermissions, type RuntimeRedirectLoginOptions, type RuntimeRequestError, type RuntimeRequestState, type RuntimeResolveLoginOptions, type SaveDataManagementConfigParams, type SchoolContactClass, type SchoolContactPerson, type SchoolContactRelationListParams, type SchoolContactRelationListResult, type SchoolContactRelationRecord, type SchoolContactSyncState, type SchoolContactTeacherListParams, type SchoolContactTeacherListResult, type SchoolContactTeacherMembershipRecord, type SearchComponentName, type SearchExpression, type SearchFieldKey, type SearchGroup, type SearchLogic, type SearchOperator, type SearchRule, type SearchSortItem, type SearchSystemField, type SendNotificationByTypeParams, type SendNotificationResult, type SsoLoginUrlInput, type SsoLoginUrlResult, type StructuredExportCellStyle, type StructuredExportColumnDefinition, type StructuredExportCreateParams, type StructuredExportFormatDefinition, type StructuredExportFormatType, type StructuredExportGetParams, type StructuredExportScope, type StructuredExportSheetDefinition, type StructuredExportSourceDefinition, type StructuredExportStyleRule, type StructuredExportTask, type StructuredExportTaskStatus, type StructuredExportValueDefinition, type StructuredExportWorkbookDefinition, type SubFormRule, type SwitchAppRoleParams, type SwitchPlatformRoleParams, type TerminateProcessInstanceParams, type TriggerCallbackTaskParams, type TrustedNodeV2Context, type UiPermissionListParams, type UpdateApiPermissionParams, type UpdateDingTalkCardParams, type UpdateDingTalkCardResult, type UpdateFormPermissionGroupDto, type UpdateOrganizationAccountParams, type UpdateOrganizationDepartmentParams, type UpdatePagePermissionGroupDto, type UpdateRoleParams, type UpdateUiPermissionParams, type UpdateUserParams, type UseAuthOptions, type UseCanAccessRouteInput, type UseFilePreviewOptions, type UseLoginMethodsState, type UseProcessActionsOptions, type UseProcessActionsReturn, type UseProcessCapabilitiesOptions, type UseProcessCapabilitiesReturn, type UsePublicAccessOptions, type UsePublicAccessState, type UserListParams, type UserMenuPermissionsResponse, type ValidateUserParams, type ViewFieldPermissionValue, type ViewOperationPermission, type ViewPermissionSummary, type WorkCenterBoxType, type WorkCenterGroupedStat, type WorkCenterItem, type WorkCenterListResult, type WorkCenterStats, type WorkCenterStatsParams, type WorkflowApproveParams, type WorkflowCapabilityActionKey, type WorkflowDefinitionByFormParams, type WorkflowInitiatorSelectCandidatesParams, type WorkflowInitiatorSelectRequirementsParams, type WorkflowPreviewParams, type WorkflowResubmitInitiatorSelectRequirementsParams, type WorkflowResubmitParams, type WorkflowReturnParams, type WorkflowSaveTaskParams, type WorkflowStartFromExistingInstanceParams, type WorkflowTaskParams, type WorkflowTransferParams, type WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap };
+export { AdminList, type AdminListBatchAction, type AdminListColumn, type AdminListColumnPreference, type AdminListDataSource, type AdminListDataSourceOptions, type AdminListDataViewSourceOptions, type AdminListDensity, type AdminListExportDownloadOptions, type AdminListExportInput, type AdminListExportScope, type AdminListExportTask, type AdminListExportTaskStatus, type AdminListFormSourceOptions, type AdminListFunctionSourceOptions, type AdminListLockedPreference, type AdminListOption, type AdminListPreference, type AdminListPreferenceStore, type AdminListProps, type AdminListQuery, type AdminListResult, type AdminListRowAction, type AdminListSearchField, type AdminListSearchFieldType, type AdminListSearchPreference, type AdminListSelectionChange, type AdminListSort, type AdminListSortDirection, type ApiEnvelope, type ApiPermissionListParams, type AppAuthClient, type AppFunctionAttachmentReference, type AppFunctionBase64File, type AppFunctionConnectorApi, type AppFunctionContext, type AppFunctionContextV2, type AppFunctionDataViewApi, type AppFunctionFileReadInput, type AppFunctionFileReadOptions, type AppFunctionFilesApi, type AppFunctionFormApi, type AppFunctionFormDeleteResult, type AppFunctionFormFileReadOptions, type AppFunctionFormGetByIdParams, type AppFunctionFormQueryParams, type AppFunctionFormWriteParams, type AppFunctionHttpApi, type AppFunctionHttpRequest, type AppFunctionHttpResponse, type AppFunctionManifestV2, type AppFunctionNotificationApi, type AppFunctionOperatorInfo, type AppFunctionOrganizationApi, type AppFunctionPermissionContext, type AppFunctionPlatformApi, type AppFunctionPlatformApiRequest, type AppFunctionPlatformApiResponse, type AppFunctionPlatformHttpApi, type AppFunctionPlatformRolesApi, type AppFunctionProcessApi, type AppFunctionProcessStartResult, type AppFunctionProcessTaskResult, type AppFunctionProcessWithdrawResult, type AppFunctionRoleBatchAddResult, type AppFunctionRoleListParams, type AppFunctionRoleMemberMutationResult, type AppFunctionRoleUsersParams, type AppFunctionRuntimeContext, type AppFunctionSecretRef, type AppFunctionSecrets, type AppFunctionUtils, type ApproveTaskParams, type AssignPermissionsParams, type AssignRolesParams, AttachmentPreviewList, type AttachmentPreviewListProps, type AuthChallengePayload, AuthClientError, type AuthClientErrorOptions, type AuthClientOptions, type AuthErrorExtra, type AuthLogoutRedirectOptions, type AuthMethod, type AuthMethodType, type AuthTokenData, type AuthUser, type BatchAddUsersToRoleParams, type BatchSendNotificationByTypeParams, type ChangeOrganizationAccountPasswordParams, type ChangeUserRoleParams, type ConnectorCallParams, type ConnectorInvokeParams, type ConnectorInvokeResult, type ConnectorRequestBodyType, type ConnectorResponseType, type CreateApiPermissionParams, type CreateFileAccessTicketOptions, type CreateFormPermissionGroupDto, type CreateOrganizationAccountParams, type CreateOrganizationDepartmentParams, type CreatePagePermissionGroupDto, type CreateRoleParams, type CreateUiPermissionParams, type CreateUserParams, type CurrentUserDepartmentParents, type CustomPageEntryConfig, type CustomPageEntryMode, DINGTALK_OAUTH_BROWSER_CONTEXT_CHANGED, type DataManagementConfigParams, type DataManagementFilterState, type DataPermissionConditionDto, type DataPermissionDto, type DataPermissionRuleDto, type DataViewQueryParams, type DataViewQueryResult, type DataViewStatsParams, type DingTalkBrowserContext, type DingTalkClient, DingTalkExternalBrowserGuide, type DingTalkExternalBrowserGuideProps, type DingTalkLoginEnvironment, type DingTalkLoginFlow, type DingTalkLoginInput, type DingTalkNotificationCapabilities, type DingTalkNotificationCardConfig, type DingTalkNotificationCardField, type DingTalkNotificationCardMode, type DingTalkNotificationCardPreview, type DingTalkNotificationChannelConfig, type DingTalkNotificationDeliveryMode, type DingTalkNotificationPreviewResult, type DingTalkOAuthStartInput, type DingTalkOAuthStartResult, type ExecuteProcessOperationInput, type FieldAccessLevel, type FieldAccessPolicyDto, type FieldAccessPolicyItemDto, type FieldOptionValue, type FieldPermissionDto, type FileAccessTicketAction, type FileAccessTicketPurpose, type FileAccessTicketResult, type FilePreviewController, type FilePreviewItem, type FindNotificationConfigParams, type FormAdvancedSearchParams, type FormChangeRecordParams, type FormCreateParams, type FormCreateResult, type FormDetailResult, type FormExportParams, type FormFieldValue, type FormGetDetailParams, type FormImportParams, type FormInstanceIdentifierResult, type FormPermissionGroup, type FormRemoveParams, type FormSearchParams, type FormUpdateParams, type FormUpdateResult, type FunctionInvokeParams, type FunctionInvokeResult, type GetParentDepartmentsOptions, type GetProcessInstanceParams, type GetUserRolesParams, type GuestLoginInput, ImagePreviewGrid, type ImagePreviewGridProps, type ImportExportRecordDownloadParams, type ImportExportRecordQuery, InitiatorApproverSelector, type InstanceStatus, type ListNotificationInboxParams, type ListWorkCenterItemsParams, type LoadDingTalkClientOptions, type LoginLogGetParams, type LoginLogListParams, type LoginLogRecord, type LoginLogStats, type LoginLogStatsParams, type LoginLogStatus, type LoginMethodsResult, LoginPage, type LoginPageProps, type MarkAllNotificationReadResult, type NotificationChannel, type NotificationChannelConfig, type NotificationChannelsConfig, type NotificationConfigLevel, type NotificationInboxListResult, type NotificationInboxMessage, type NotificationInboxReadStatus, type NotificationMessageRecord, type NotificationTemplate, type NotificationTemplatePreview, type NotificationTypeConfig, type NotificationUnreadCountResult, OpenXiangdaPageProvider, type OpenXiangdaPageProviderProps, OpenXiangdaProvider, type OpenXiangdaProviderProps, type OrganizationAccountListParams, type OrganizationCapabilities, type OrganizationListResult, type PageApiPermissionRecord, type PageApiResponse, type PageAppInfo, type PageBinaryResponse, type PageBridgeApi, type PageContext, type PageDataManagementConfig, type PageDataSourceDescriptor, type PageDepartmentInfo, type PageDepartmentRecord, type PageHttpMethod, type PageInfo, type PageListResult, type PageMessageApi, type PageModalApi, type PageNavigationApi, type PageOffsetListResult, type PagePermissionGroup, type PagePermissionInfo, PageProvider, type PageQueryValue, type PageRequestCache, type PageRequestOptions, type PageRoleRecord, type PageRouteInfo, type PageScope, type PageSdk, type PageSdkError, type PageSdkMeta, type PageTransportDownloadPayload, type PageTransportRequestPayload, type PageUiPermissionRecord, type PageUiPermissionType, type PageUserInfo, type PageUserRecord, type PageUserType, type PasswordLoginInput, PermissionBoundary, type PermissionBoundaryFallback, type PermissionBoundaryFallbackState, type PermissionBoundaryProps, type PhoneCodeInput, type PhoneCodeLoginInput, type PhoneCodeRegisterInput, type PhoneCodeSendResult, type PreviewDingTalkNotificationParams, type PreviewNotificationTemplateParams, ProcessActionBar, type ProcessActionBarProps, type ProcessApproveAction, type ProcessCapabilities, type ProcessCapabilityOperation, type ProcessInstanceLookupParams, ProcessPreviewPanel, type ProcessPreviewPanelProps, ProcessTimeline, type ProcessTimelineProps, type PublicAccessClaim, type PublicAccessClient, PublicAccessClientError, type PublicAccessClientOptions, PublicAccessGate, type PublicAccessGateProps, type PublicAccessSessionData, type PublicAccessSessionInput, type PublicFormGrant, type PublicStorageAction, type PublicStorageGrant, type QueryFormPermissionGroupDto, type QueryPagePermissionGroupDto, type RefreshInput, type RequestDingTalkAuthCodeOptions, type ResetOrganizationAccountPasswordParams, type ResolveLoginUrlInput, type ResolveProcessCapabilitiesParams, type RoleListParams, type RoleUsersParams, type RouteAccessResult, RuntimeAuthGuard, type RuntimeAuthGuardProps, type RuntimeAuthState, type RuntimeAuthStatus, type RuntimeBootstrap, type RuntimeErrorSnapshot, type RuntimeErrorType, type RuntimeLogoutOptions, type RuntimeMenuItem, type RuntimePagePermissions, type RuntimeRedirectLoginOptions, type RuntimeRequestError, type RuntimeRequestState, type RuntimeResolveLoginOptions, type SaveDataManagementConfigParams, type SchoolContactClass, type SchoolContactPerson, type SchoolContactRelationListParams, type SchoolContactRelationListResult, type SchoolContactRelationRecord, type SchoolContactSyncState, type SchoolContactTeacher, type SchoolContactTeacherListParams, type SchoolContactTeacherListResult, type SchoolContactTeacherMembershipRecord, type SearchComponentName, type SearchExpression, type SearchFieldKey, type SearchGroup, type SearchLogic, type SearchOperator, type SearchRule, type SearchSortItem, type SearchSystemField, type SendNotificationByTypeParams, type SendNotificationResult, type SsoLoginUrlInput, type SsoLoginUrlResult, type StructuredExportCellStyle, type StructuredExportColumnDefinition, type StructuredExportCreateParams, type StructuredExportFormatDefinition, type StructuredExportFormatType, type StructuredExportGetParams, type StructuredExportScope, type StructuredExportSheetDefinition, type StructuredExportSourceDefinition, type StructuredExportStyleRule, type StructuredExportTask, type StructuredExportTaskStatus, type StructuredExportValueDefinition, type StructuredExportWorkbookDefinition, type SubFormRule, type SwitchAppRoleParams, type SwitchPlatformRoleParams, type TerminateProcessInstanceParams, type TriggerCallbackTaskParams, type TrustedNodeV2Context, type UiPermissionListParams, type UpdateApiPermissionParams, type UpdateDingTalkCardParams, type UpdateDingTalkCardResult, type UpdateFormPermissionGroupDto, type UpdateOrganizationAccountParams, type UpdateOrganizationDepartmentParams, type UpdatePagePermissionGroupDto, type UpdateRoleParams, type UpdateUiPermissionParams, type UpdateUserParams, type UseAuthOptions, type UseCanAccessRouteInput, type UseFilePreviewOptions, type UseLoginMethodsState, type UseProcessActionsOptions, type UseProcessActionsReturn, type UseProcessCapabilitiesOptions, type UseProcessCapabilitiesReturn, type UsePublicAccessOptions, type UsePublicAccessState, type UserListParams, type UserMenuPermissionsResponse, type ValidateUserParams, type ViewFieldPermissionValue, type ViewOperationPermission, type ViewPermissionSummary, type WorkCenterBoxType, type WorkCenterGroupedStat, type WorkCenterItem, type WorkCenterListResult, type WorkCenterStats, type WorkCenterStatsParams, type WorkflowApproveParams, type WorkflowCapabilityActionKey, type WorkflowDefinitionByFormParams, type WorkflowInitiatorSelectCandidatesParams, type WorkflowInitiatorSelectRequirementsParams, type WorkflowPreviewParams, type WorkflowResubmitInitiatorSelectRequirementsParams, type WorkflowResubmitParams, type WorkflowReturnParams, type WorkflowSaveTaskParams, type WorkflowStartFromExistingInstanceParams, type WorkflowTaskParams, type WorkflowTransferParams, type WorkflowWithdrawParams, createAdminListPreferenceStore, createAuthClient, createDataViewAdminListSource, createFormAdminListSource, createFunctionAdminListSource, createPageFormRuntimeApi, createPageSdk, createPublicAccessClient, createReactPage, detectDingTalkLoginEnvironment, getAuthErrorExtra, getAuthErrorReason, getDingTalkClient, getDingTalkOAuthRecoveryMessage, isAuthChallengeRequired, isAuthClientError, isDingTalkContainer, isDingTalkJsApiReady, isWeChatBrowser, loadDingTalkClient, mergeAdminListPreference, requestDingTalkAuthCode, useAppMenus, useAuth, useCanAccessRoute, useCurrentUser, useDataSource, useFilePreview, useFormViewPermissions, useLoginMethods, useMessage, useModal, useNavigation, useOpenXiangda, usePageContext, usePageFormRuntimeApi, usePageProps, usePageRoute, usePageSdk, usePermission, useProcessActions, useProcessCapabilities, usePublicAccess, useRuntimeAuth, useRuntimeBootstrap };

package/templates/openxiangda-react-spa/AGENTS.md

@@ -1,4 +1,5 @@
 <!-- OpenXiangda-Policy-Version: 7 -->
+
 # AGENTS.md — OpenXiangda React SPA 应用工作区
 
 本工作区是标准 React 18 + Vite + React Router 应用。默认模板只提供应用壳、账号菜单和一个首页，不是开发验证控制台。
@@ -17,7 +18,7 @@
 - 调查预算默认为一次覆盖完整调用链的 CodeGraph 查询，只有明确缺失符号时再补一次精确查询；普通任务只加载一个领域技能。租约、构建或部署状态未变化时不重复输出相同进度，使用 `openxiangda task status --watch` 等待状态变化。
 - 账号、角色、权限、数据范围、组织账号、RBAC、查询参数授权需求必须先运行 `openxiangda design gates --topic permissions --json`，选择 `managed-platform-account` / `existing-platform-user-assignment` / `static-role-permission` / `query-param-context`，输出权限矩阵后再实现。
 - 应用角色只读查询组织账号时声明 `app:organization:read`；创建、修改账号/部门或重置密码时声明 `app:organization:manage`。创建角色、分配成员或维护权限组也必须在角色资源的 `apiPermissionCodes` 声明对应的 `app:role:manage`、`app:page-permission-group:manage`、`app:form-permission-group:manage`。
-- 家校关系页面调用 `sdk.organization.schoolContact.*`；用 `SCHOOL_HEAD_TEACHER` 判断全局班主任身份，用 `teachers.list` 的 `isHeadTeacher` 判断具体班级。已登录非游客用户无需绑定应用角色权限，默认范围是当前租户全部关系。只有明确需要本人或任教班级限制时才声明 `:self:read` / `:class:read`。
+- 家校关系页面调用 `sdk.organization.schoolContact.*`；用 `SCHOOL_HEAD_TEACHER` 判断全局班主任身份，用 `teachers.list` 的 `isHeadTeacher`、`teacher.managedClasses` 和 `class.headTeachers` 判断具体班级双向关系。已登录非游客用户无需绑定应用角色权限，默认范围是当前租户全部关系。只有明确需要本人或任教班级限制时才声明 `:self:read` / `:class:read`。
 - 默认用户界面保持克制：左侧应用导航、顶部账号信息、首页内容区域。
 - 不在默认可见页面展示 SDK、Runtime、Cookie、Proxy、Playwright、AI 验证、调试上下文、构建号等开发语言。
 - 使用 React Router 管理路由，路由定义在 `src/app/router.tsx`。
@@ -128,7 +129,11 @@ React SPA 页面需要声明菜单 code、route code 和 path pattern。默认
 页面中可以使用：
 
 ```tsx
-import { PermissionBoundary, useAppMenus, useRuntimeBootstrap } from "openxiangda/runtime/react";
+import {
+  PermissionBoundary,
+  useAppMenus,
+  useRuntimeBootstrap,
+} from "openxiangda/runtime/react";
 ```
 
 `PermissionBoundary` 只能做展示保护，不能替代后端权限。不要硬编码角色、前端模拟权限、只判断 query 参数或用空数组兜底伪装成功。后端返回 401 时跳登录，403 时展示无权限状态。

package/templates/sy-lowcode-app-workspace/AGENTS.md

@@ -1,4 +1,5 @@
 <!-- OpenXiangda-Policy-Version: 7 -->
+
 # AGENTS.md — OpenXiangda 工作区 AI 强约束
 
 > 任何 AI（Qoder / Claude / Codex / Cursor / Copilot 等）在本工作区操作前 **必须先读完本文件**。
@@ -24,25 +25,25 @@ Delivery V2 自动从期望状态按资源指纹计算精确范围，使用 CLI
 
 ## 路由表 — 用户意图 → 命令 / skill
 
-| 用户说（中 / 英） | 用 skill | 第一条命令 |
-|---|---|---|
-| 发布 / 上线 / 部署 / publish / deploy | `openxiangda-core` | `openxiangda check --environment preproduction` → `openxiangda deploy preproduction` |
-| 晋级生产 | `openxiangda-core` | `openxiangda deploy production --package <packageDigest>` |
-| 发布失败 / 断点续跑 | `openxiangda-core` | `openxiangda status <runId>` → `openxiangda retry <runId>` |
-| 创建应用 / 新建 app / 初始化工作区 | `openxiangda-app` | `openxiangda workspace init <dir> --profile <name> --app-name "..."` |
-| 绑定已有应用 | `openxiangda-app` | `openxiangda workspace bind --profile <name> --app-type APP_XXX` |
-| 创建 / 改表单字段、schema、表单页 | `openxiangda-form` | 编辑表单并声明 form-setting bundle → `resource publish form-setting --only <code>` 暂存；整应用由 `app-finalize` 激活 |
-| 导出表单数据 / 图片 / 附件 / Excel / zip | `openxiangda-form` | `openxiangda form export <formCode> --mode xlsx|xlsx-images|package --profile <name>` |
-| 创建 / 改自定义代码页、portal、看板 | `openxiangda-page` | 编辑 `src/pages/<code>/` → `workspace publish --page <code>` |
-| 审批流程 / 流程节点 / JS_CODE | `openxiangda-workflow-automation` | `openxiangda workflow validate / create / publish` |
-| 自动化 / 定时任务 / 提交触发 / cron | `openxiangda-workflow-automation` | `openxiangda automation validate / create / publish / enable` |
+| 用户说（中 / 英）                                         | 用 skill                          | 第一条命令                                                                                                             |
+| --------------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| 发布 / 上线 / 部署 / publish / deploy                     | `openxiangda-core`                | `openxiangda check --environment preproduction` → `openxiangda deploy preproduction`                                   |
+| 晋级生产                                                  | `openxiangda-core`                | `openxiangda deploy production --package <packageDigest>`                                                              |
+| 发布失败 / 断点续跑                                       | `openxiangda-core`                | `openxiangda status <runId>` → `openxiangda retry <runId>`                                                             |
+| 创建应用 / 新建 app / 初始化工作区                        | `openxiangda-app`                 | `openxiangda workspace init <dir> --profile <name> --app-name "..."`                                                   |
+| 绑定已有应用                                              | `openxiangda-app`                 | `openxiangda workspace bind --profile <name> --app-type APP_XXX`                                                       |
+| 创建 / 改表单字段、schema、表单页                         | `openxiangda-form`                | 编辑表单并声明 form-setting bundle → `resource publish form-setting --only <code>` 暂存；整应用由 `app-finalize` 激活  |
+| 导出表单数据 / 图片 / 附件 / Excel / zip                  | `openxiangda-form`                | `openxiangda form export <formCode> --mode xlsx                                                                        | xlsx-images   | package --profile <name>` |
+| 创建 / 改自定义代码页、portal、看板                       | `openxiangda-page`                | 编辑 `src/pages/<code>/` → `workspace publish --page <code>`                                                           |
+| 审批流程 / 流程节点 / JS_CODE                             | `openxiangda-workflow-automation` | `openxiangda workflow validate / create / publish`                                                                     |
+| 自动化 / 定时任务 / 提交触发 / cron                       | `openxiangda-workflow-automation` | `openxiangda automation validate / create / publish / enable`                                                          |
 | 账号 / 角色 / 权限组 / 字段权限 / 数据范围 / 查询参数授权 | `openxiangda-permission-settings` | 先 `openxiangda design gates --topic permissions --json`，再 `openxiangda permission ...` / `openxiangda settings ...` |
-| 查应用结构 / 快照 / 对比 / 排查 / 报错 | `openxiangda-inspect` | `openxiangda app snapshot <APP_XXX> --profile <name> --json` |
-| 登录 / 切平台 / token / whoami | `openxiangda-core` | `openxiangda env --profile <name>` / `openxiangda auth status` |
-| 多表只读联表查询 / 报表数据源 | `openxiangda-form`（data view） | 在 `src/resources/data-views/<code>.json` 声明 → `resource publish` |
-| 调外部 / 第三方 API / 钉钉 / 自建系统 | `openxiangda-page`（connector） | 在 `src/resources/connectors/<code>.json` 声明 → `sdk.connector.invoke()` |
-| 外部后端 / 三方系统调用享搭 / AK/SK / 开放接口 | `openxiangda-open-api` | `openxiangda open-api spec list --search <keyword> --json` |
-| 资源诊断 / 小步修复 / 同步 manifest | 对应资源 skill | `openxiangda route|public-access|auth-config|function|connector|notification|data-view|menu|permission ... --dry-run` |
+| 查应用结构 / 快照 / 对比 / 排查 / 报错                    | `openxiangda-inspect`             | `openxiangda app snapshot <APP_XXX> --profile <name> --json`                                                           |
+| 登录 / 切平台 / token / whoami                            | `openxiangda-core`                | `openxiangda env --profile <name>` / `openxiangda auth status`                                                         |
+| 多表只读联表查询 / 报表数据源                             | `openxiangda-form`（data view）   | 在 `src/resources/data-views/<code>.json` 声明 → `resource publish`                                                    |
+| 调外部 / 第三方 API / 钉钉 / 自建系统                     | `openxiangda-page`（connector）   | 在 `src/resources/connectors/<code>.json` 声明 → `sdk.connector.invoke()`                                              |
+| 外部后端 / 三方系统调用享搭 / AK/SK / 开放接口            | `openxiangda-open-api`            | `openxiangda open-api spec list --search <keyword> --json`                                                             |
+| 资源诊断 / 小步修复 / 同步 manifest                       | 对应资源 skill                    | `openxiangda route                                                                                                     | public-access | auth-config               | function | connector | notification | data-view | menu | permission ... --dry-run` |
 
 ## 必须遵守
 
@@ -51,7 +52,7 @@ Delivery V2 自动从期望状态按资源指纹计算精确范围，使用 CLI
 - ✅ L2/L3 保留 context → propose → 用户确认 → approve；默认只创建 change/coverage/release，完整文档由 `sdd render` 按需生成。approval、coverage 与实际发布范围为硬门禁，未完成的任务/证据/规格文案只告警。需要严格文档门禁时显式配置 `strictDocumentation: true`。
 - ✅ 涉及账号、角色、权限、数据范围、组织账号、RBAC、查询参数授权时，先跑 `openxiangda design gates --topic permissions --json`，选择 `managed-platform-account` / `existing-platform-user-assignment` / `static-role-permission` / `query-param-context`，并输出权限矩阵后再改资源。
 - ✅ 某个应用角色如果要查询组织账号，声明 `app:organization:read`；如需创建、修改账号/部门或重置密码，再声明 `app:organization:manage`。角色设置、页面/表单权限组等能力同样通过 `src/resources/roles/<code>.json` 的 `apiPermissionCodes` 显式授权，例如 `app:role:manage`、`app:page-permission-group:manage`、`app:form-permission-group:manage`。
-- ✅ 查询家校通讯录的家长、学生、教师、班主任身份和班级/监护关系时使用 `sdk.organization.schoolContact.*` / `ctx.organization.schoolContact.*`。`SCHOOL_HEAD_TEACHER` 只判断全局身份，具体班级必须读取 `teachers.list` 的 `isHeadTeacher`。已登录非游客用户无需绑定应用角色权限，默认查询当前租户全部关系；只有明确要求时才声明 `:self:read` 或 `:class:read` 收紧。
+- ✅ 查询家校通讯录的家长、学生、教师、班主任身份和班级/监护关系时使用 `sdk.organization.schoolContact.*` / `ctx.organization.schoolContact.*`。`SCHOOL_HEAD_TEACHER` 只判断全局身份，具体班级必须读取 `teachers.list` 的 `isHeadTeacher`、`teacher.managedClasses` 和 `class.headTeachers`。已登录非游客用户无需绑定应用角色权限，默认查询当前租户全部关系；只有明确要求时才声明 `:self:read` 或 `:class:read` 收紧。
 - ✅ 单文件改动默认按 change 和逻辑资源增量发布：`workspace plan --profile <name> --change <change> --changed`，再 `workspace publish --profile <name> --change <change> --only pages/a,forms/b --dry-run` → 正式发布。
 - ✅ 用户 token 在 `~/.openxiangda/profiles.json`；项目 state 在 `.openxiangda/state.json`（只存 ID）。
 - ✅ 共享环境（`APP_OSS_*`、反馈机器人等）在 `~/.openxiangda/.env`，项目 `.env` 仅做 per-workspace override。