@rytass/bpm-core-react 0.17.9 → 0.18.1

package/dist/views/instances/new/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_Fragment","useRouterAdapter","useAuth","formatDateTime","readApplicantFormSchema","readApplicantSubmission","FormRenderer","Fragment$1","ContentHeader","FORM_SECTION_STYLE","InstanceNewView","Suspense","NewApprovalInstanceLoading","NewApprovalInstanceContent","props","templateIdProp","router","routes","useBPMRoutes","currentMemberId","member","templateId","context","setContext","useState","formValues","setFormValues","templates","setTemplates","error","setError","formErrors","setFormErrors","loading","setLoading","submitting","setSubmitting","dataSourceStates","setDataSourceStates","applicantSchema","useMemo","handleDataSourceStateChange","useCallback","currentState","currentStates","fieldKey","state","refreshContext","refreshTemplates","rows","template","columns","tableActions","record","listLaunchableTemplates","requestError","readErrorMessage","readLaunchContext","nextTemplateId","handleSubmit","dataSourceBlockMessage","readFormDataSourceSubmissionBlockMessage","submittedValues","buildFormRendererValues","validation","validateFormRendererValues","focusFormRendererField","instanceId","submitApprovalInstance","readFormDataCaseTitle","handleUploadAttachment","uploadAttachment","field","PageHeader","Button","CheckedIcon","SectionGroup","Section","Typography","values","Table","readFormDataSourceErrorMessage"],"sources":["../../../../src/views/instances/new/InstanceNewView.tsx"],"sourcesContent":["'use client';\n\nimport {\n  CSSProperties,\n  ReactElement,\n  Suspense,\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  Button,\n  PageHeader,\n  Section,\n  SectionGroup,\n  Table,\n  Typography,\n} from '@mezzanine-ui/react';\nimport ContentHeader from '@mezzanine-ui/react/ContentHeader';\nimport { CheckedIcon } from '@mezzanine-ui/icons';\nimport type { TableActions, TableColumn } from '@mezzanine-ui/core/table';\nimport { FormFieldDefinition } from '@rytass/bpm-core-shared/form';\nimport {\n  buildFormRendererValues,\n  focusFormRendererField,\n  FormRendererValues,\n  readFormDataSourceErrorMessage,\n  validateFormRendererValues,\n} from '@rytass/bpm-core-client/form';\nimport {\n  LaunchContext,\n  LaunchableTemplateRecord,\n  listLaunchableTemplates,\n  readFormDataCaseTitle,\n  readLaunchContext,\n  submitApprovalInstance,\n  uploadAttachment,\n} from '@rytass/bpm-core-client/workflow';\nimport {\n  readApplicantFormSchema,\n  readApplicantSubmission,\n} from '../approver-filled-form';\nimport { formatDateTime } from '../../../lib/format-date-time';\nimport { useAuth } from '../../../lib/auth-provider';\nimport { useRouterAdapter } from '../../../lib/router-adapter';\nimport { useBPMRoutes } from '../../../lib/routes-config';\nimport { FormRenderer } from '../../forms/renderer/FormRendererView';\nimport {\n  readFormDataSourceSubmissionBlockMessage,\n  type FormDataSourceFieldState,\n} from '../../forms/renderer/form-data-source-field';\n\nconst FORM_SECTION_STYLE: CSSProperties = {\n  display: 'grid',\n  gap: 16,\n};\n\ntype LaunchableTemplateRow = Readonly<\n  Record<string, unknown> &\n    LaunchableTemplateRecord & {\n      key: string;\n      versionLabel: string;\n    }\n>;\n\nexport interface InstanceNewViewProps {\n  /**\n   * Optional template id pre-selected by the host. The Server Component\n   * page should read `?templateId=` from its `searchParams` and pass the\n   * value through this prop.\n   */\n  readonly templateId?: string | null;\n}\n\n/**\n * Framework-agnostic view for the BPM \"發起簽核\" launch page. Mechanical port\n * of `apps/client/src/app/instances/new/page.tsx` — picks a launchable\n * template and submits the launch form.\n */\nexport function InstanceNewView(\n  props: InstanceNewViewProps = {},\n): ReactElement {\n  return (\n    <Suspense fallback={<NewApprovalInstanceLoading />}>\n      <NewApprovalInstanceContent templateId={props.templateId ?? undefined} />\n    </Suspense>\n  );\n}\n\nfunction NewApprovalInstanceContent({\n  templateId: templateIdProp,\n}: {\n  readonly templateId?: string;\n}): ReactElement {\n  const router = useRouterAdapter();\n  const routes = useBPMRoutes();\n  const { member } = useAuth();\n  const currentMemberId = member?.memberId ?? null;\n  const templateId = templateIdProp ?? null;\n  const [context, setContext] = useState<LaunchContext | null>(null);\n  const [formValues, setFormValues] = useState<FormRendererValues>({});\n  const [templates, setTemplates] = useState<\n    readonly LaunchableTemplateRecord[]\n  >([]);\n  const [error, setError] = useState<string | null>(null);\n  const [formErrors, setFormErrors] = useState<\n    Readonly<Record<string, string>>\n  >({});\n  const [loading, setLoading] = useState(true);\n  const [submitting, setSubmitting] = useState(false);\n  const [dataSourceStates, setDataSourceStates] = useState<\n    Readonly<\n      Record<string, Pick<FormDataSourceFieldState, 'hasValue' | 'status'>>\n    >\n  >({});\n\n  // The form the applicant sees: approver-filled fields are not theirs to fill\n  // (the server drops them), so they are left out of everything below.\n  const applicantSchema = useMemo(\n    () =>\n      context\n        ? readApplicantFormSchema(\n            context.formVersion.schema,\n            context.templateVersion.workflowDefinition,\n          )\n        : null,\n    [context],\n  );\n\n  const handleDataSourceStateChange = useCallback(\n    (\n      fieldKey: string,\n      state: Pick<\n        FormDataSourceFieldState,\n        'hasValue' | 'invalidValues' | 'status'\n      >,\n    ): void => {\n      setDataSourceStates((currentStates) => {\n        const currentState = currentStates[fieldKey];\n\n        if (\n          currentState?.hasValue === state.hasValue &&\n          currentState.status === state.status\n        ) {\n          return currentStates;\n        }\n\n        return {\n          ...currentStates,\n          [fieldKey]: {\n            hasValue: state.hasValue,\n            status: state.status,\n          },\n        };\n      });\n    },\n    [],\n  );\n\n  useEffect((): void => {\n    if (!templateId) {\n      void refreshTemplates();\n\n      return;\n    }\n\n    void refreshContext(templateId);\n  }, [templateId]);\n\n  const rows = useMemo(\n    (): LaunchableTemplateRow[] =>\n      templates.map((template) => ({\n        ...template,\n        key: template.id,\n        updatedAt: formatDateTime(template.updatedAt),\n        versionLabel: `v${template.version}`,\n      })),\n    [templates],\n  );\n  const columns = useMemo(\n    (): TableColumn<LaunchableTemplateRow>[] => [\n      { dataIndex: 'name', key: 'name', title: '模板名稱', width: 240 },\n      {\n        dataIndex: 'versionLabel',\n        key: 'versionLabel',\n        title: '發布版本',\n        width: 120,\n      },\n      {\n        dataIndex: 'updatedAt',\n        key: 'updatedAt',\n        title: '更新時間',\n        width: 220,\n      },\n    ],\n    [],\n  );\n  const tableActions = useMemo(\n    (): TableActions<LaunchableTemplateRow> => ({\n      render: (\n        record,\n      ): ReturnType<TableActions<LaunchableTemplateRow>['render']> => [\n        {\n          name: '發起',\n          onClick: (): void =>\n            router.push(routes.caseNew(record.id)),\n          variant: 'base-primary',\n        },\n      ],\n      variant: 'base-secondary',\n      width: 88,\n    }),\n    [router],\n  );\n\n  async function refreshTemplates(): Promise<void> {\n    setLoading(true);\n    setError(null);\n    setContext(null);\n    setDataSourceStates({});\n\n    try {\n      setTemplates(await listLaunchableTemplates());\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setLoading(false);\n    }\n  }\n\n  async function refreshContext(nextTemplateId: string): Promise<void> {\n    setLoading(true);\n    setError(null);\n    setTemplates([]);\n    setDataSourceStates({});\n\n    try {\n      setContext(await readLaunchContext(nextTemplateId));\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setLoading(false);\n    }\n  }\n\n  async function handleSubmit(): Promise<void> {\n    if (!context || !applicantSchema || !currentMemberId) {\n      return;\n    }\n\n    setSubmitting(true);\n    setError(null);\n    setFormErrors({});\n\n    const dataSourceBlockMessage = readFormDataSourceSubmissionBlockMessage(\n      Object.values(dataSourceStates),\n    );\n\n    if (dataSourceBlockMessage) {\n      setError(dataSourceBlockMessage);\n      setSubmitting(false);\n\n      return;\n    }\n\n    // What the renderer shows, not just what has been touched: a table seeds\n    // its `minRows` rows and a field can carry a `defaultValue`, and neither\n    // reaches this state until the filler edits something. Validating and\n    // submitting the raw state would reject a table the user can plainly see\n    // rows in — and submit a default the backend never receives.\n    const submittedValues = readApplicantSubmission(\n      buildFormRendererValues(applicantSchema.fields, formValues),\n      context.templateVersion.workflowDefinition,\n    );\n    const validation = validateFormRendererValues({\n      schema: applicantSchema,\n      uiSchema: context.formVersion.uiSchema,\n      values: submittedValues,\n    });\n\n    if (!validation.valid) {\n      setFormErrors(validation.errors);\n      setError('請先補齊必填欄位。');\n\n      if (validation.firstInvalidFieldKey) {\n        focusFormRendererField(validation.firstInvalidFieldKey);\n      }\n\n      setSubmitting(false);\n\n      return;\n    }\n\n    try {\n      const instanceId = await submitApprovalInstance({\n        formData: submittedValues,\n        initiatorMemberId: currentMemberId,\n        templateId: context.template.id,\n        title: readFormDataCaseTitle({\n          fallbackTitle: context.template.name,\n          formData: submittedValues,\n          schema: applicantSchema,\n          uiSchema: context.formVersion.uiSchema,\n        }),\n      });\n\n      router.push(routes.caseDetail(instanceId));\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setSubmitting(false);\n    }\n  }\n\n  async function handleUploadAttachment(\n    field: FormFieldDefinition,\n    file: File,\n  ): Promise<{ readonly id: string }> {\n    if (!currentMemberId) {\n      throw new Error('尚未登入，無法上傳附件');\n    }\n\n    const attachment = await uploadAttachment({\n      file,\n      formFieldPath: `form.${field.fieldKey}`,\n    });\n\n    return { id: attachment.id };\n  }\n\n  return (\n    <>\n        <PageHeader>\n          <ContentHeader\n            description={\n              context\n                ? `${context.template.name} · 表單 v${context.formVersion.version}`\n                : '選擇可發起的已發布模板後填寫表單內容。'\n            }\n            title=\"發起簽核\"\n          >\n            {context ? (\n              <Button\n                disabled={loading || submitting}\n                icon={CheckedIcon}\n                iconType=\"leading\"\n                onClick={handleSubmit}\n                variant=\"base-primary\"\n              >\n                送出\n              </Button>\n            ) : null}\n          </ContentHeader>\n        </PageHeader>\n\n        <SectionGroup>\n          <Section>\n            <div style={FORM_SECTION_STYLE}>\n              {error ? (\n                <Typography color=\"text-error\" variant=\"body\">\n                  {error}\n                </Typography>\n              ) : null}\n\n              {loading ? (\n                <Typography color=\"text-neutral\" variant=\"body\">\n                  載入中...\n                </Typography>\n              ) : null}\n\n              {context && applicantSchema ? (\n                <FormRenderer\n                  dataSourceContext={{\n                    kind: 'runtime',\n                    templateId: context.template.id,\n                  }}\n                  errors={formErrors}\n                  maxWidth={480}\n                  onChange={(values): void => {\n                    setFormValues(values);\n                    setFormErrors({});\n                  }}\n                  onDataSourceStateChange={handleDataSourceStateChange}\n                  onUploadAttachment={handleUploadAttachment}\n                  schema={applicantSchema}\n                  singleColumn\n                  uiSchema={context.formVersion.uiSchema}\n                  value={formValues}\n                />\n              ) : null}\n\n              {!templateId && !loading ? (\n                rows.length > 0 ? (\n                  <Table\n                    actions={tableActions}\n                    columns={columns}\n                    dataSource={rows}\n                    fullWidth\n                  />\n                ) : (\n                  <Typography color=\"text-neutral\" variant=\"body\">\n                    目前沒有可發起的已發布模板。\n                  </Typography>\n                )\n              ) : null}\n            </div>\n          </Section>\n        </SectionGroup>\n      </>\n  );\n}\n\nfunction NewApprovalInstanceLoading(): ReactElement {\n  return (\n    <>\n        <PageHeader>\n          <ContentHeader\n            description=\"選擇可發起的已發布模板後填寫表單內容。\"\n            title=\"發起簽核\"\n          />\n        </PageHeader>\n\n        <SectionGroup>\n          <Section>\n            <Typography color=\"text-neutral\" variant=\"body\">\n              載入中...\n            </Typography>\n          </Section>\n        </SectionGroup>\n      </>\n  );\n}\n\nfunction readErrorMessage(error: unknown): string {\n  // DataSource failures arrive as stable codes so the backend never leaks\n  // upstream transport detail; translate them instead of showing the raw code.\n  const dataSourceMessage = readFormDataSourceErrorMessage(error);\n\n  if (dataSourceMessage) {\n    return dataSourceMessage;\n  }\n\n  return error instanceof Error ? error.message : '發生未知錯誤';\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["_Fragment","readApplicantFormSchema","readApplicantSubmission","formatDateTime","useAuth","useRouterAdapter","useBPMRoutes","readFormDataSourceSubmissionBlockMessage","FormRenderer","Fragment$1","ContentHeader","FORM_SECTION_STYLE","InstanceNewView","Suspense","NewApprovalInstanceLoading","NewApprovalInstanceContent","props","templateIdProp","router","routes","currentMemberId","member","templateId","context","setContext","useState","formValues","setFormValues","templates","setTemplates","error","setError","formErrors","setFormErrors","loading","setLoading","submitting","setSubmitting","dataSourceStates","setDataSourceStates","applicantSchema","useMemo","handleDataSourceStateChange","useCallback","currentState","currentStates","fieldKey","state","refreshContext","refreshTemplates","rows","template","columns","tableActions","record","listLaunchableTemplates","requestError","readErrorMessage","readLaunchContext","nextTemplateId","handleSubmit","dataSourceBlockMessage","submittedValues","buildFormRendererValues","validation","validateFormRendererValuesInWorker","focusFormRendererField","instanceId","submitApprovalInstance","readFormDataCaseTitle","handleUploadAttachment","uploadAttachment","field","PageHeader","Button","CheckedIcon","SectionGroup","Section","Typography","values","Table","readFormDataSourceErrorMessage"],"sources":["../../../../src/views/instances/new/InstanceNewView.tsx"],"sourcesContent":["'use client';\n\nimport {\n  CSSProperties,\n  ReactElement,\n  Suspense,\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  Button,\n  PageHeader,\n  Section,\n  SectionGroup,\n  Table,\n  Typography,\n} from '@mezzanine-ui/react';\nimport ContentHeader from '@mezzanine-ui/react/ContentHeader';\nimport { CheckedIcon } from '@mezzanine-ui/icons';\nimport type { TableActions, TableColumn } from '@mezzanine-ui/core/table';\nimport { FormFieldDefinition } from '@rytass/bpm-core-shared/form';\nimport {\n  buildFormRendererValues,\n  focusFormRendererField,\n  FormRendererValues,\n  readFormDataSourceErrorMessage,\n  validateFormRendererValuesInWorker,\n} from '@rytass/bpm-core-client/form';\nimport {\n  LaunchContext,\n  LaunchableTemplateRecord,\n  listLaunchableTemplates,\n  readFormDataCaseTitle,\n  readLaunchContext,\n  submitApprovalInstance,\n  uploadAttachment,\n} from '@rytass/bpm-core-client/workflow';\nimport {\n  readApplicantFormSchema,\n  readApplicantSubmission,\n} from '../approver-filled-form';\nimport { formatDateTime } from '../../../lib/format-date-time';\nimport { useAuth } from '../../../lib/auth-provider';\nimport { useRouterAdapter } from '../../../lib/router-adapter';\nimport { useBPMRoutes } from '../../../lib/routes-config';\nimport { FormRenderer } from '../../forms/renderer/FormRendererView';\nimport {\n  readFormDataSourceSubmissionBlockMessage,\n  type FormDataSourceFieldState,\n} from '../../forms/renderer/form-data-source-field';\n\nconst FORM_SECTION_STYLE: CSSProperties = {\n  display: 'grid',\n  gap: 16,\n};\n\ntype LaunchableTemplateRow = Readonly<\n  Record<string, unknown> &\n    LaunchableTemplateRecord & {\n      key: string;\n      versionLabel: string;\n    }\n>;\n\nexport interface InstanceNewViewProps {\n  /**\n   * Optional template id pre-selected by the host. The Server Component\n   * page should read `?templateId=` from its `searchParams` and pass the\n   * value through this prop.\n   */\n  readonly templateId?: string | null;\n}\n\n/**\n * Framework-agnostic view for the BPM \"發起簽核\" launch page. Mechanical port\n * of `apps/client/src/app/instances/new/page.tsx` — picks a launchable\n * template and submits the launch form.\n */\nexport function InstanceNewView(\n  props: InstanceNewViewProps = {},\n): ReactElement {\n  return (\n    <Suspense fallback={<NewApprovalInstanceLoading />}>\n      <NewApprovalInstanceContent templateId={props.templateId ?? undefined} />\n    </Suspense>\n  );\n}\n\nfunction NewApprovalInstanceContent({\n  templateId: templateIdProp,\n}: {\n  readonly templateId?: string;\n}): ReactElement {\n  const router = useRouterAdapter();\n  const routes = useBPMRoutes();\n  const { member } = useAuth();\n  const currentMemberId = member?.memberId ?? null;\n  const templateId = templateIdProp ?? null;\n  const [context, setContext] = useState<LaunchContext | null>(null);\n  const [formValues, setFormValues] = useState<FormRendererValues>({});\n  const [templates, setTemplates] = useState<\n    readonly LaunchableTemplateRecord[]\n  >([]);\n  const [error, setError] = useState<string | null>(null);\n  const [formErrors, setFormErrors] = useState<\n    Readonly<Record<string, string>>\n  >({});\n  const [loading, setLoading] = useState(true);\n  const [submitting, setSubmitting] = useState(false);\n  const [dataSourceStates, setDataSourceStates] = useState<\n    Readonly<\n      Record<string, Pick<FormDataSourceFieldState, 'hasValue' | 'status'>>\n    >\n  >({});\n\n  // The form the applicant sees: approver-filled fields are not theirs to fill\n  // (the server drops them), so they are left out of everything below.\n  const applicantSchema = useMemo(\n    () =>\n      context\n        ? readApplicantFormSchema(\n            context.formVersion.schema,\n            context.templateVersion.workflowDefinition,\n          )\n        : null,\n    [context],\n  );\n\n  const handleDataSourceStateChange = useCallback(\n    (\n      fieldKey: string,\n      state: Pick<\n        FormDataSourceFieldState,\n        'hasValue' | 'invalidValues' | 'status'\n      >,\n    ): void => {\n      setDataSourceStates((currentStates) => {\n        const currentState = currentStates[fieldKey];\n\n        if (\n          currentState?.hasValue === state.hasValue &&\n          currentState.status === state.status\n        ) {\n          return currentStates;\n        }\n\n        return {\n          ...currentStates,\n          [fieldKey]: {\n            hasValue: state.hasValue,\n            status: state.status,\n          },\n        };\n      });\n    },\n    [],\n  );\n\n  useEffect((): void => {\n    if (!templateId) {\n      void refreshTemplates();\n\n      return;\n    }\n\n    void refreshContext(templateId);\n  }, [templateId]);\n\n  const rows = useMemo(\n    (): LaunchableTemplateRow[] =>\n      templates.map((template) => ({\n        ...template,\n        key: template.id,\n        updatedAt: formatDateTime(template.updatedAt),\n        versionLabel: `v${template.version}`,\n      })),\n    [templates],\n  );\n  const columns = useMemo(\n    (): TableColumn<LaunchableTemplateRow>[] => [\n      { dataIndex: 'name', key: 'name', title: '模板名稱', width: 240 },\n      {\n        dataIndex: 'versionLabel',\n        key: 'versionLabel',\n        title: '發布版本',\n        width: 120,\n      },\n      {\n        dataIndex: 'updatedAt',\n        key: 'updatedAt',\n        title: '更新時間',\n        width: 220,\n      },\n    ],\n    [],\n  );\n  const tableActions = useMemo(\n    (): TableActions<LaunchableTemplateRow> => ({\n      render: (\n        record,\n      ): ReturnType<TableActions<LaunchableTemplateRow>['render']> => [\n        {\n          name: '發起',\n          onClick: (): void =>\n            router.push(routes.caseNew(record.id)),\n          variant: 'base-primary',\n        },\n      ],\n      variant: 'base-secondary',\n      width: 88,\n    }),\n    [router],\n  );\n\n  async function refreshTemplates(): Promise<void> {\n    setLoading(true);\n    setError(null);\n    setContext(null);\n    setDataSourceStates({});\n\n    try {\n      setTemplates(await listLaunchableTemplates());\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setLoading(false);\n    }\n  }\n\n  async function refreshContext(nextTemplateId: string): Promise<void> {\n    setLoading(true);\n    setError(null);\n    setTemplates([]);\n    setDataSourceStates({});\n\n    try {\n      setContext(await readLaunchContext(nextTemplateId));\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setLoading(false);\n    }\n  }\n\n  async function handleSubmit(): Promise<void> {\n    if (!context || !applicantSchema || !currentMemberId) {\n      return;\n    }\n\n    setSubmitting(true);\n    setError(null);\n    setFormErrors({});\n\n    const dataSourceBlockMessage = readFormDataSourceSubmissionBlockMessage(\n      Object.values(dataSourceStates),\n    );\n\n    if (dataSourceBlockMessage) {\n      setError(dataSourceBlockMessage);\n      setSubmitting(false);\n\n      return;\n    }\n\n    // What the renderer shows, not just what has been touched: a table seeds\n    // its `minRows` rows and a field can carry a `defaultValue`, and neither\n    // reaches this state until the filler edits something. Validating and\n    // submitting the raw state would reject a table the user can plainly see\n    // rows in — and submit a default the backend never receives.\n    const submittedValues = readApplicantSubmission(\n      buildFormRendererValues(applicantSchema.fields, formValues),\n      context.templateVersion.workflowDefinition,\n    );\n    // Inside the `try`, so a validation that throws still clears `submitting`\n    // and shows its error instead of leaving the button busy for good.\n    try {\n      // The format patterns run in a worker under the engine's time budget, so\n      // a pattern that backtracks cannot freeze the page.\n      const validation = await validateFormRendererValuesInWorker({\n        schema: applicantSchema,\n        uiSchema: context.formVersion.uiSchema,\n        values: submittedValues,\n      });\n\n      if (!validation.valid) {\n        setFormErrors(validation.errors);\n        setError('請先修正表單中標示的欄位。');\n\n        if (validation.firstInvalidFieldKey) {\n          focusFormRendererField(validation.firstInvalidFieldKey);\n        }\n\n        return;\n      }\n\n      const instanceId = await submitApprovalInstance({\n        formData: submittedValues,\n        initiatorMemberId: currentMemberId,\n        templateId: context.template.id,\n        title: readFormDataCaseTitle({\n          fallbackTitle: context.template.name,\n          formData: submittedValues,\n          schema: applicantSchema,\n          uiSchema: context.formVersion.uiSchema,\n        }),\n      });\n\n      router.push(routes.caseDetail(instanceId));\n    } catch (requestError: unknown) {\n      setError(readErrorMessage(requestError));\n    } finally {\n      setSubmitting(false);\n    }\n  }\n\n  async function handleUploadAttachment(\n    field: FormFieldDefinition,\n    file: File,\n  ): Promise<{ readonly id: string }> {\n    if (!currentMemberId) {\n      throw new Error('尚未登入，無法上傳附件');\n    }\n\n    const attachment = await uploadAttachment({\n      file,\n      formFieldPath: `form.${field.fieldKey}`,\n    });\n\n    return { id: attachment.id };\n  }\n\n  return (\n    <>\n        <PageHeader>\n          <ContentHeader\n            description={\n              context\n                ? `${context.template.name} · 表單 v${context.formVersion.version}`\n                : '選擇可發起的已發布模板後填寫表單內容。'\n            }\n            title=\"發起簽核\"\n          >\n            {context ? (\n              <Button\n                disabled={loading || submitting}\n                icon={CheckedIcon}\n                iconType=\"leading\"\n                onClick={handleSubmit}\n                variant=\"base-primary\"\n              >\n                送出\n              </Button>\n            ) : null}\n          </ContentHeader>\n        </PageHeader>\n\n        <SectionGroup>\n          <Section>\n            <div style={FORM_SECTION_STYLE}>\n              {error ? (\n                <Typography color=\"text-error\" variant=\"body\">\n                  {error}\n                </Typography>\n              ) : null}\n\n              {loading ? (\n                <Typography color=\"text-neutral\" variant=\"body\">\n                  載入中...\n                </Typography>\n              ) : null}\n\n              {context && applicantSchema ? (\n                <FormRenderer\n                  dataSourceContext={{\n                    kind: 'runtime',\n                    templateId: context.template.id,\n                  }}\n                  errors={formErrors}\n                  maxWidth={480}\n                  onChange={(values): void => {\n                    setFormValues(values);\n                    setFormErrors({});\n                  }}\n                  onDataSourceStateChange={handleDataSourceStateChange}\n                  onUploadAttachment={handleUploadAttachment}\n                  schema={applicantSchema}\n                  singleColumn\n                  uiSchema={context.formVersion.uiSchema}\n                  value={formValues}\n                />\n              ) : null}\n\n              {!templateId && !loading ? (\n                rows.length > 0 ? (\n                  <Table\n                    actions={tableActions}\n                    columns={columns}\n                    dataSource={rows}\n                    fullWidth\n                  />\n                ) : (\n                  <Typography color=\"text-neutral\" variant=\"body\">\n                    目前沒有可發起的已發布模板。\n                  </Typography>\n                )\n              ) : null}\n            </div>\n          </Section>\n        </SectionGroup>\n      </>\n  );\n}\n\nfunction NewApprovalInstanceLoading(): ReactElement {\n  return (\n    <>\n        <PageHeader>\n          <ContentHeader\n            description=\"選擇可發起的已發布模板後填寫表單內容。\"\n            title=\"發起簽核\"\n          />\n        </PageHeader>\n\n        <SectionGroup>\n          <Section>\n            <Typography color=\"text-neutral\" variant=\"body\">\n              載入中...\n            </Typography>\n          </Section>\n        </SectionGroup>\n      </>\n  );\n}\n\nfunction readErrorMessage(error: unknown): string {\n  // DataSource failures arrive as stable codes so the backend never leaks\n  // upstream transport detail; translate them instead of showing the raw code.\n  const dataSourceMessage = readFormDataSourceErrorMessage(error);\n\n  if (dataSourceMessage) {\n    return dataSourceMessage;\n  }\n\n  return error instanceof Error ? error.message : '發生未知錯誤';\n}\n"],"mappings":"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"}

package/dist/views/login/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/login-AtVxZBsC.cjs");exports.LoginView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/login-uvVcltrS.cjs");exports.LoginView=e.t;

package/dist/views/login/index.js

@@ -1 +1 @@
-export { t as LoginView } from "../../chunks/login-C6qlTC6F.js";
+export { t as LoginView } from "../../chunks/login-D6cc3bo7.js";

package/dist/views/search/index.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/approval-instance-list-page-ax0pm8bt.cjs");let t=require("react/jsx-runtime");function n(){return(0,t.jsx)(e.t,{defaultState:null,description:`以關鍵字與狀態查詢你有權限查看的簽核案件。`,emptyMessage:`沒有符合條件的簽核案件。`,searchPlaceholder:`關鍵字：搜尋案件、發起人、模板或狀態`,title:`案件搜尋`,view:`ALL`})}exports.SearchView=n;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/approval-instance-list-page-fqvmkBlg.cjs");let t=require("react/jsx-runtime");function n(){return(0,t.jsx)(e.t,{defaultState:null,description:`以關鍵字與狀態查詢你有權限查看的簽核案件。`,emptyMessage:`沒有符合條件的簽核案件。`,searchPlaceholder:`關鍵字：搜尋案件、發起人、模板或狀態`,title:`案件搜尋`,view:`ALL`})}exports.SearchView=n;
 //# sourceMappingURL=index.cjs.map

package/dist/views/search/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ApprovalInstanceListPage","require_approval_instance_list_page","react_jsx_runtime","SearchView"],"sources":["../../../src/views/search/SearchView.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactElement } from 'react';\nimport { ApprovalInstanceListPage } from '../../components/approval-instance-list-page';\n\n\n/**\n * Framework-agnostic view for the BPM case search page — list of all\n * instances the current member has visibility on. Mechanical port of\n * `apps/client/src/app/search/page.tsx`.\n */\nexport function SearchView(): ReactElement {\n  return (\n    <ApprovalInstanceListPage\n      defaultState={null}\n      description=\"以關鍵字與狀態查詢你有權限查看的簽核案件。\"\n      emptyMessage=\"沒有符合條件的簽核案件。\"\n      searchPlaceholder=\"關鍵字：搜尋案件、發起人、模板或狀態\"\n      title=\"案件搜尋\"\n      view=\"ALL\"\n    />\n  );\n}\n"],"mappings":"4LAWA,SAAgBG,GAA2B,CACzC,OACE,EAAAD,EAAA,IAAA,CAACF,EAAAA,EAAD,CACE,aAAc,KACd,YAAY,wBACZ,aAAa,eACb,kBAAkB,qBAClB,MAAM,OACN,KAAK,KACN,CAAA,CAEL"}
+{"version":3,"file":"index.cjs","names":["ApprovalInstanceListPage","require_approval_instance_list_page","react_jsx_runtime","SearchView"],"sources":["../../../src/views/search/SearchView.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactElement } from 'react';\nimport { ApprovalInstanceListPage } from '../../components/approval-instance-list-page';\n\n\n/**\n * Framework-agnostic view for the BPM case search page — list of all\n * instances the current member has visibility on. Mechanical port of\n * `apps/client/src/app/search/page.tsx`.\n */\nexport function SearchView(): ReactElement {\n  return (\n    <ApprovalInstanceListPage\n      defaultState={null}\n      description=\"以關鍵字與狀態查詢你有權限查看的簽核案件。\"\n      emptyMessage=\"沒有符合條件的簽核案件。\"\n      searchPlaceholder=\"關鍵字：搜尋案件、發起人、模板或狀態\"\n      title=\"案件搜尋\"\n      view=\"ALL\"\n    />\n  );\n}\n"],"mappings":"A,4LAWA,SAAgBG,GAA2B,CACzC,OACE,EAAAD,EAAA,IAAA,CAACF,EAAAA,EAAD,CACE,aAAc,KACd,YAAY,wBACZ,aAAa,eACb,kBAAkB,qBAClB,MAAM,OACN,KAAK,KACN,CAAA,CAEL,C"}

package/dist/views/search/index.js

@@ -1,7 +1,7 @@
 "use client";
-import { t as e } from "../../chunks/approval-instance-list-page-CPXMP3PL.js";
+import { t as e } from "../../chunks/approval-instance-list-page-BnI4t5mD.js";
 import { jsx as t } from "react/jsx-runtime";
-//#region src/views/search/SearchView.tsx
+// src/views/search/SearchView.tsx
 function n() {
 	return /* @__PURE__ */ t(e, {
 		defaultState: null,
@@ -12,7 +12,6 @@ function n() {
 		view: "ALL"
 	});
 }
-//#endregion
 export { n as SearchView };
 
 //# sourceMappingURL=index.js.map

package/dist/views/sent/index.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/approval-instance-list-page-ax0pm8bt.cjs");let t=require("react/jsx-runtime");function n(){return(0,t.jsx)(e.t,{defaultState:null,description:`查看由你發起或代為送出的簽核案件與目前流程狀態。`,emptyMessage:`目前沒有由你發起或代為送出的簽核案件。`,searchPlaceholder:`關鍵字：搜尋案件、發起人、模板或狀態`,title:`我發起的`,view:`SENT`})}exports.SentView=n;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/approval-instance-list-page-fqvmkBlg.cjs");let t=require("react/jsx-runtime");function n(){return(0,t.jsx)(e.t,{defaultState:null,description:`查看由你發起或代為送出的簽核案件與目前流程狀態。`,emptyMessage:`目前沒有由你發起或代為送出的簽核案件。`,searchPlaceholder:`關鍵字：搜尋案件、發起人、模板或狀態`,title:`我發起的`,view:`SENT`})}exports.SentView=n;
 //# sourceMappingURL=index.cjs.map

package/dist/views/sent/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ApprovalInstanceListPage","require_approval_instance_list_page","react_jsx_runtime","SentView"],"sources":["../../../src/views/sent/SentView.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactElement } from 'react';\nimport { ApprovalInstanceListPage } from '../../components/approval-instance-list-page';\n\n\n/**\n * Framework-agnostic view for the BPM \"sent\" inbox — instances the current\n * member has initiated or submitted on someone's behalf. Mechanical port of\n * `apps/client/src/app/sent/page.tsx`.\n */\nexport function SentView(): ReactElement {\n  return (\n    <ApprovalInstanceListPage\n      defaultState={null}\n      description=\"查看由你發起或代為送出的簽核案件與目前流程狀態。\"\n      emptyMessage=\"目前沒有由你發起或代為送出的簽核案件。\"\n      searchPlaceholder=\"關鍵字：搜尋案件、發起人、模板或狀態\"\n      title=\"我發起的\"\n      view=\"SENT\"\n    />\n  );\n}\n"],"mappings":"4LAWA,SAAgBG,GAAyB,CACvC,OACE,EAAAD,EAAA,IAAA,CAACF,EAAAA,EAAD,CACE,aAAc,KACd,YAAY,2BACZ,aAAa,sBACb,kBAAkB,qBAClB,MAAM,OACN,KAAK,MACN,CAAA,CAEL"}
+{"version":3,"file":"index.cjs","names":["ApprovalInstanceListPage","require_approval_instance_list_page","react_jsx_runtime","SentView"],"sources":["../../../src/views/sent/SentView.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactElement } from 'react';\nimport { ApprovalInstanceListPage } from '../../components/approval-instance-list-page';\n\n\n/**\n * Framework-agnostic view for the BPM \"sent\" inbox — instances the current\n * member has initiated or submitted on someone's behalf. Mechanical port of\n * `apps/client/src/app/sent/page.tsx`.\n */\nexport function SentView(): ReactElement {\n  return (\n    <ApprovalInstanceListPage\n      defaultState={null}\n      description=\"查看由你發起或代為送出的簽核案件與目前流程狀態。\"\n      emptyMessage=\"目前沒有由你發起或代為送出的簽核案件。\"\n      searchPlaceholder=\"關鍵字：搜尋案件、發起人、模板或狀態\"\n      title=\"我發起的\"\n      view=\"SENT\"\n    />\n  );\n}\n"],"mappings":"A,4LAWA,SAAgBG,GAAyB,CACvC,OACE,EAAAD,EAAA,IAAA,CAACF,EAAAA,EAAD,CACE,aAAc,KACd,YAAY,2BACZ,aAAa,sBACb,kBAAkB,qBAClB,MAAM,OACN,KAAK,MACN,CAAA,CAEL,C"}

package/dist/views/sent/index.js

@@ -1,7 +1,7 @@
 "use client";
-import { t as e } from "../../chunks/approval-instance-list-page-CPXMP3PL.js";
+import { t as e } from "../../chunks/approval-instance-list-page-BnI4t5mD.js";
 import { jsx as t } from "react/jsx-runtime";
-//#region src/views/sent/SentView.tsx
+// src/views/sent/SentView.tsx
 function n() {
 	return /* @__PURE__ */ t(e, {
 		defaultState: null,
@@ -12,7 +12,6 @@ function n() {
 		view: "SENT"
 	});
 }
-//#endregion
 export { n as SentView };
 
 //# sourceMappingURL=index.js.map

package/dist/views/settings/index.js

@@ -1 +1 @@
-export { t as SettingsNotificationsView } from "../../chunks/notifications-DJ5wzCye.js";
+export { t as SettingsNotificationsView } from "../../chunks/notifications-Cvme5Qbl.js";

package/dist/views/settings/notifications/index.js

@@ -1 +1 @@
-export { t as SettingsNotificationsView } from "../../../chunks/notifications-DJ5wzCye.js";
+export { t as SettingsNotificationsView } from "../../../chunks/notifications-Cvme5Qbl.js";

package/dist/views/templates/categories/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/categories-AxxhqjLZ.cjs");exports.TemplateCategoriesView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/categories-DQUtVEiV.cjs");exports.TemplateCategoriesView=e.t;

package/dist/views/templates/categories/index.js

@@ -1 +1 @@
-export { t as TemplateCategoriesView } from "../../../chunks/categories-riC33J_j.js";
+export { t as TemplateCategoriesView } from "../../../chunks/categories-BAdxjNSA.js";

package/dist/views/templates/compose/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/compose-Cock_B2Q.cjs");exports.EMPTY_COMPOSE_FORM_SCHEMA=e.n,exports.EMPTY_COMPOSE_FORM_UI_SCHEMA=e.r,exports.TemplateComposeWizardView=e.t,exports.useTemplateComposeWizard=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/compose-DtfX8DQ9.cjs");exports.EMPTY_COMPOSE_FORM_SCHEMA=e.n,exports.EMPTY_COMPOSE_FORM_UI_SCHEMA=e.r,exports.TemplateComposeWizardView=e.t,exports.useTemplateComposeWizard=e.i;

package/dist/views/templates/compose/index.js

@@ -1 +1 @@
-export { n as EMPTY_COMPOSE_FORM_SCHEMA, r as EMPTY_COMPOSE_FORM_UI_SCHEMA, t as TemplateComposeWizardView, i as useTemplateComposeWizard } from "../../../chunks/compose-jnvnnVfN.js";
+export { n as EMPTY_COMPOSE_FORM_SCHEMA, r as EMPTY_COMPOSE_FORM_UI_SCHEMA, t as TemplateComposeWizardView, i as useTemplateComposeWizard } from "../../../chunks/compose-D9ipJpF_.js";

package/dist/views/templates/designer/approver-resolver-model.d.cts

@@ -0,0 +1,211 @@
+import { ApproverResolver, ApproverResolverFallback } from '@rytass/bpm-core-shared/workflow';
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+import { OrgUnitRecord, PositionRecord } from '@rytass/bpm-core-client/organization';
+import { OrgUnitOption, PositionOption } from '../../../components/admin-picker-options.cjs';
+export type ApproverResolverMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'NODE_ACTOR' | 'ORG_MANAGER' | 'ORG_MANAGER_CHAIN' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export type ApproverResolverModeOption = Readonly<{
+    id: ApproverResolverMode;
+    name: string;
+}>;
+export type ManagerLevelOption = Readonly<{
+    id: string;
+    name: string;
+    value: number;
+}>;
+export type MemberSelectOption = Readonly<{
+    displayName: string;
+    email: string;
+    id: string;
+    memberId: string;
+    name: string;
+    /**
+     * Set on the placeholder written when a member's profile could not be
+     * fetched. Marking it explicitly lets {@link mergeMemberOptions} replace the
+     * placeholder once the real profile turns up, instead of the "未知會員"
+     * sentinel sticking for the rest of the session.
+     */
+    unresolved?: boolean;
+}>;
+export declare const APPROVER_RESOLVER_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+export declare const MANAGER_LEVEL_OPTIONS: readonly ManagerLevelOption[];
+export type NodeNameRecord = Readonly<{
+    id: string;
+    name: string;
+}>;
+/**
+ * The 簽核人 choices of the two sources that start from "someone": the person
+ * the source names, or their manager one to three levels up. `value` 0 is the
+ * person themselves; it is what the select stores for a source with no
+ * manager level.
+ */
+export declare const FORM_MEMBER_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export declare const NODE_ACTOR_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export type OrgUnitManagerSource = 'FIXED' | 'FORM_FIELD';
+export declare const ORG_UNIT_SOURCE_OPTIONS: readonly Readonly<{
+    id: OrgUnitManagerSource;
+    name: string;
+}>[];
+/**
+ * The option for a stored level. A level this screen has no option for (a
+ * hand-written or AI-written definition) is shown as itself rather than
+ * mistaken for another one.
+ */
+export declare function readApproverSubjectOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+/**
+ * The option for the manager level a FORM_MEMBER_MANAGER / NODE_ACTOR_MANAGER
+ * definition stores. Those types always name a manager, so a level below 1 (or
+ * not a whole number) is a broken definition: it is shown as an invalid level
+ * rather than as the option whose `value` happens to be 0 (本人). The stored
+ * JSON is never touched by this read; the publish lint is what blocks it.
+ */
+export declare function readStoredManagerLevelOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+export declare function readApproverResolverMode(value: string): ApproverResolverMode;
+export declare function readDefaultApproverResolver(value: string | null, positions: readonly PositionRecord[]): ApproverResolver;
+export declare function updateApproverResolverFallback(resolver: ApproverResolver, fallback: ApproverResolverFallback): ApproverResolver;
+export declare function readManagerLevelOption(levelsUp: number): ManagerLevelOption;
+export declare function readManagerLevelOptionById(id: string | null): ManagerLevelOption;
+/**
+ * Every member id a resolver names outright, so the designer can pre-fetch
+ * their display names on load.
+ *
+ * The manager resolvers' `DIRECT` fallback ("固定改派") counts: it is a member
+ * the author picked and the property form renders it through
+ * `readMemberSelectOption`, which falls back to the "未知會員" sentinel for any
+ * id it cannot find. Leaving it out meant a saved fallback always rendered as
+ * 未知會員 until an unrelated search happened to return that member.
+ */
+export declare function readApproverResolverMemberIds(resolver: ApproverResolver): readonly string[];
+export declare function readApproverResolverSummary(resolver: ApproverResolver, memberOptions: readonly MemberSelectOption[], orgUnits: readonly OrgUnitRecord[], positions: readonly PositionRecord[], formSchema: FormDefinitionSchema | null, nodes?: readonly NodeNameRecord[]): string;
+export declare function readMemberEmailSummary(memberIds: readonly string[], memberOptions: readonly MemberSelectOption[], emptyLabel: string): string;
+export declare function readOrgUnitDisplayName(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): string;
+export declare function readPositionDisplayName(positions: readonly PositionRecord[], positionId: string): string;
+export declare function readSelectedOrgUnitOption(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): OrgUnitOption | null;
+export declare function readSelectedPositionOption(positions: readonly PositionRecord[], positionId: string): PositionOption | null;
+export declare function readMemberSelectOption(options: readonly MemberSelectOption[], memberId: string): MemberSelectOption;
+export declare function readFallbackMemberSelectOption(memberId: string): MemberSelectOption;
+/**
+ * The one label for a resolver `type` this build does not know (a definition
+ * saved by a newer BPMCore): the designer's read-only 簽核來源 entry, the node
+ * summary and the compose review table all say it with this.
+ */
+export declare function readUnsupportedApproverSourceLabel(type: string): string;
+/**
+ * The short 簽核方式 label the compose review table shows for a user task.
+ */
+export declare function readApproverResolverDetail(resolver: ApproverResolver): string;
+type ManagerRule = Readonly<{
+    fallback?: ApproverResolverFallback;
+    preferClosestOrgUnit?: boolean;
+}>;
+/**
+ * What the 簽核來源 panel edits. The three sources with two stored types each
+ * (本人／主管, 固定組織／表單欄位) carry the screen's own choice instead of the
+ * JSON type; every other known type is held as saved and edited field by
+ * field, and a type this build does not know is held as saved, read-only.
+ *
+ * `levelsUp` is `null` for the 本人 choice (no manager level), otherwise the
+ * stored level.
+ */
+export type ApproverResolverEditorState = (Readonly<{
+    formPath: string;
+    levelsUp: number | null;
+    mode: 'DYNAMIC_FORM';
+}> & ManagerRule) | (Readonly<{
+    formPath: string;
+    mode: 'ORG_UNIT_MANAGER';
+    orgSource: OrgUnitManagerSource;
+    orgUnitId: string;
+}> & ManagerRule) | (Readonly<{
+    levelsUp: number | null;
+    mode: 'NODE_ACTOR';
+    nodeIds: readonly string[];
+}> & ManagerRule) | Readonly<{
+    mode: 'AS_STORED';
+    resolver: ApproverResolver;
+}> | Readonly<{
+    mode: 'UNSUPPORTED';
+    resolver: ApproverResolver;
+    type: string;
+}>;
+export declare function readApproverResolverEditorState(resolver: ApproverResolver): ApproverResolverEditorState;
+/**
+ * The JSON for a screen state. Only the fields that belong to the chosen type
+ * are written, so a field left over from the choice the author switched away
+ * from (the manager level after 回到欄位裡的人, the formPath after 改選固定組織)
+ * never reaches the saved definition.
+ */
+export declare function buildApproverResolver(state: ApproverResolverEditorState): ApproverResolver;
+/**
+ * Applies the 簽核人 select: 0 is the person themselves, 1-3 their manager.
+ * Sources with no such choice come back as the same state.
+ */
+export declare function withApproverSubject(state: ApproverResolverEditorState, value: number): ApproverResolverEditorState;
+/**
+ * Applies the 組織 choice of 指定組織主管. A form-field org starts with 只取最近
+ * 一層主管 on (SPEC 3.3) unless the author already chose; a fixed org keeps the
+ * stored choice as it is. Switching back does not take the default off again:
+ * the toggle keeps whatever value the resolver has, and stays visible.
+ */
+export declare function withOrgUnitSource(state: ApproverResolverEditorState, source: OrgUnitManagerSource): ApproverResolverEditorState;
+/** The id of the read-only entry an unknown resolver type is shown as. */
+export declare const UNSUPPORTED_APPROVER_SOURCE_OPTION_ID = "UNSUPPORTED";
+export type ApproverSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 簽核來源 select: the source options, plus, for a type this build does
+ * not know, a read-only entry carrying its name that is the current value: it
+ * is shown, never edited, and nothing is written unless the author explicitly
+ * picks a different source (which replaces the stored one).
+ * `readApproverResolverMode` would call such a type 指定會員.
+ */
+export declare function readApproverSourceChoice(state: ApproverResolverEditorState): ApproverSourceChoice;
+/**
+ * The resolver a 簽核來源 pick produces, or `null` when the pick must change
+ * nothing: no option, an id that is not an option (the read-only unsupported
+ * entry included), or the source already stored. Re-picking the shown source
+ * used to rebuild a clean default and wipe what the author had filled in.
+ *
+ * "Already stored" is the state's own mode, not the displayed option: an
+ * EXPRESSION resolver is displayed as 指定會員 but is not one, so picking 指定會員
+ * still switches it.
+ */
+export declare function readApproverSourcePick(resolver: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+export type ApproverSubjectChoice = Readonly<{
+    /** The stored level is below 1 (or fractional): shown, not offered again. */
+    invalid: boolean;
+    options: readonly ManagerLevelOption[];
+    selected: ManagerLevelOption;
+}>;
+/**
+ * The 簽核人 select of ② and ③. A stored manager level the list has no option
+ * for (invalid, or a level above 3) is appended so the select can show it.
+ */
+export declare function readApproverSubjectChoice(state: ApproverResolverEditorState): ApproverSubjectChoice | null;
+/**
+ * The state a 簽核人 pick produces, or `null` for a no-op (the shown choice
+ * picked again, the invalid-level entry, an id that is not an option).
+ */
+export declare function readApproverSubjectPick(state: ApproverResolverEditorState, optionId: string | null): ApproverResolverEditorState | null;
+export type ApproverManagerRuleView = Readonly<{
+    fallback: ApproverResolverFallback;
+    preferClosestOrgUnit: boolean;
+    /** 主管鏈 has no 只取最近一層主管. */
+    showPreferClosestOrgUnit: boolean;
+}>;
+/**
+ * The 只取最近一層主管 / 無主管時 pair of a resolver that looks a manager up,
+ * `null` for one that does not (so 本人 shows neither).
+ */
+export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
+export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+export {};

package/dist/views/templates/designer/approver-resolver-model.d.ts

@@ -0,0 +1,211 @@
+import { ApproverResolver, ApproverResolverFallback } from '@rytass/bpm-core-shared/workflow';
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+import { OrgUnitRecord, PositionRecord } from '@rytass/bpm-core-client/organization';
+import { OrgUnitOption, PositionOption } from '../../../components/admin-picker-options.js';
+export type ApproverResolverMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'NODE_ACTOR' | 'ORG_MANAGER' | 'ORG_MANAGER_CHAIN' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export type ApproverResolverModeOption = Readonly<{
+    id: ApproverResolverMode;
+    name: string;
+}>;
+export type ManagerLevelOption = Readonly<{
+    id: string;
+    name: string;
+    value: number;
+}>;
+export type MemberSelectOption = Readonly<{
+    displayName: string;
+    email: string;
+    id: string;
+    memberId: string;
+    name: string;
+    /**
+     * Set on the placeholder written when a member's profile could not be
+     * fetched. Marking it explicitly lets {@link mergeMemberOptions} replace the
+     * placeholder once the real profile turns up, instead of the "未知會員"
+     * sentinel sticking for the rest of the session.
+     */
+    unresolved?: boolean;
+}>;
+export declare const APPROVER_RESOLVER_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+export declare const MANAGER_LEVEL_OPTIONS: readonly ManagerLevelOption[];
+export type NodeNameRecord = Readonly<{
+    id: string;
+    name: string;
+}>;
+/**
+ * The 簽核人 choices of the two sources that start from "someone": the person
+ * the source names, or their manager one to three levels up. `value` 0 is the
+ * person themselves; it is what the select stores for a source with no
+ * manager level.
+ */
+export declare const FORM_MEMBER_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export declare const NODE_ACTOR_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export type OrgUnitManagerSource = 'FIXED' | 'FORM_FIELD';
+export declare const ORG_UNIT_SOURCE_OPTIONS: readonly Readonly<{
+    id: OrgUnitManagerSource;
+    name: string;
+}>[];
+/**
+ * The option for a stored level. A level this screen has no option for (a
+ * hand-written or AI-written definition) is shown as itself rather than
+ * mistaken for another one.
+ */
+export declare function readApproverSubjectOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+/**
+ * The option for the manager level a FORM_MEMBER_MANAGER / NODE_ACTOR_MANAGER
+ * definition stores. Those types always name a manager, so a level below 1 (or
+ * not a whole number) is a broken definition: it is shown as an invalid level
+ * rather than as the option whose `value` happens to be 0 (本人). The stored
+ * JSON is never touched by this read; the publish lint is what blocks it.
+ */
+export declare function readStoredManagerLevelOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+export declare function readApproverResolverMode(value: string): ApproverResolverMode;
+export declare function readDefaultApproverResolver(value: string | null, positions: readonly PositionRecord[]): ApproverResolver;
+export declare function updateApproverResolverFallback(resolver: ApproverResolver, fallback: ApproverResolverFallback): ApproverResolver;
+export declare function readManagerLevelOption(levelsUp: number): ManagerLevelOption;
+export declare function readManagerLevelOptionById(id: string | null): ManagerLevelOption;
+/**
+ * Every member id a resolver names outright, so the designer can pre-fetch
+ * their display names on load.
+ *
+ * The manager resolvers' `DIRECT` fallback ("固定改派") counts: it is a member
+ * the author picked and the property form renders it through
+ * `readMemberSelectOption`, which falls back to the "未知會員" sentinel for any
+ * id it cannot find. Leaving it out meant a saved fallback always rendered as
+ * 未知會員 until an unrelated search happened to return that member.
+ */
+export declare function readApproverResolverMemberIds(resolver: ApproverResolver): readonly string[];
+export declare function readApproverResolverSummary(resolver: ApproverResolver, memberOptions: readonly MemberSelectOption[], orgUnits: readonly OrgUnitRecord[], positions: readonly PositionRecord[], formSchema: FormDefinitionSchema | null, nodes?: readonly NodeNameRecord[]): string;
+export declare function readMemberEmailSummary(memberIds: readonly string[], memberOptions: readonly MemberSelectOption[], emptyLabel: string): string;
+export declare function readOrgUnitDisplayName(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): string;
+export declare function readPositionDisplayName(positions: readonly PositionRecord[], positionId: string): string;
+export declare function readSelectedOrgUnitOption(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): OrgUnitOption | null;
+export declare function readSelectedPositionOption(positions: readonly PositionRecord[], positionId: string): PositionOption | null;
+export declare function readMemberSelectOption(options: readonly MemberSelectOption[], memberId: string): MemberSelectOption;
+export declare function readFallbackMemberSelectOption(memberId: string): MemberSelectOption;
+/**
+ * The one label for a resolver `type` this build does not know (a definition
+ * saved by a newer BPMCore): the designer's read-only 簽核來源 entry, the node
+ * summary and the compose review table all say it with this.
+ */
+export declare function readUnsupportedApproverSourceLabel(type: string): string;
+/**
+ * The short 簽核方式 label the compose review table shows for a user task.
+ */
+export declare function readApproverResolverDetail(resolver: ApproverResolver): string;
+type ManagerRule = Readonly<{
+    fallback?: ApproverResolverFallback;
+    preferClosestOrgUnit?: boolean;
+}>;
+/**
+ * What the 簽核來源 panel edits. The three sources with two stored types each
+ * (本人／主管, 固定組織／表單欄位) carry the screen's own choice instead of the
+ * JSON type; every other known type is held as saved and edited field by
+ * field, and a type this build does not know is held as saved, read-only.
+ *
+ * `levelsUp` is `null` for the 本人 choice (no manager level), otherwise the
+ * stored level.
+ */
+export type ApproverResolverEditorState = (Readonly<{
+    formPath: string;
+    levelsUp: number | null;
+    mode: 'DYNAMIC_FORM';
+}> & ManagerRule) | (Readonly<{
+    formPath: string;
+    mode: 'ORG_UNIT_MANAGER';
+    orgSource: OrgUnitManagerSource;
+    orgUnitId: string;
+}> & ManagerRule) | (Readonly<{
+    levelsUp: number | null;
+    mode: 'NODE_ACTOR';
+    nodeIds: readonly string[];
+}> & ManagerRule) | Readonly<{
+    mode: 'AS_STORED';
+    resolver: ApproverResolver;
+}> | Readonly<{
+    mode: 'UNSUPPORTED';
+    resolver: ApproverResolver;
+    type: string;
+}>;
+export declare function readApproverResolverEditorState(resolver: ApproverResolver): ApproverResolverEditorState;
+/**
+ * The JSON for a screen state. Only the fields that belong to the chosen type
+ * are written, so a field left over from the choice the author switched away
+ * from (the manager level after 回到欄位裡的人, the formPath after 改選固定組織)
+ * never reaches the saved definition.
+ */
+export declare function buildApproverResolver(state: ApproverResolverEditorState): ApproverResolver;
+/**
+ * Applies the 簽核人 select: 0 is the person themselves, 1-3 their manager.
+ * Sources with no such choice come back as the same state.
+ */
+export declare function withApproverSubject(state: ApproverResolverEditorState, value: number): ApproverResolverEditorState;
+/**
+ * Applies the 組織 choice of 指定組織主管. A form-field org starts with 只取最近
+ * 一層主管 on (SPEC 3.3) unless the author already chose; a fixed org keeps the
+ * stored choice as it is. Switching back does not take the default off again:
+ * the toggle keeps whatever value the resolver has, and stays visible.
+ */
+export declare function withOrgUnitSource(state: ApproverResolverEditorState, source: OrgUnitManagerSource): ApproverResolverEditorState;
+/** The id of the read-only entry an unknown resolver type is shown as. */
+export declare const UNSUPPORTED_APPROVER_SOURCE_OPTION_ID = "UNSUPPORTED";
+export type ApproverSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 簽核來源 select: the source options, plus, for a type this build does
+ * not know, a read-only entry carrying its name that is the current value: it
+ * is shown, never edited, and nothing is written unless the author explicitly
+ * picks a different source (which replaces the stored one).
+ * `readApproverResolverMode` would call such a type 指定會員.
+ */
+export declare function readApproverSourceChoice(state: ApproverResolverEditorState): ApproverSourceChoice;
+/**
+ * The resolver a 簽核來源 pick produces, or `null` when the pick must change
+ * nothing: no option, an id that is not an option (the read-only unsupported
+ * entry included), or the source already stored. Re-picking the shown source
+ * used to rebuild a clean default and wipe what the author had filled in.
+ *
+ * "Already stored" is the state's own mode, not the displayed option: an
+ * EXPRESSION resolver is displayed as 指定會員 but is not one, so picking 指定會員
+ * still switches it.
+ */
+export declare function readApproverSourcePick(resolver: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+export type ApproverSubjectChoice = Readonly<{
+    /** The stored level is below 1 (or fractional): shown, not offered again. */
+    invalid: boolean;
+    options: readonly ManagerLevelOption[];
+    selected: ManagerLevelOption;
+}>;
+/**
+ * The 簽核人 select of ② and ③. A stored manager level the list has no option
+ * for (invalid, or a level above 3) is appended so the select can show it.
+ */
+export declare function readApproverSubjectChoice(state: ApproverResolverEditorState): ApproverSubjectChoice | null;
+/**
+ * The state a 簽核人 pick produces, or `null` for a no-op (the shown choice
+ * picked again, the invalid-level entry, an id that is not an option).
+ */
+export declare function readApproverSubjectPick(state: ApproverResolverEditorState, optionId: string | null): ApproverResolverEditorState | null;
+export type ApproverManagerRuleView = Readonly<{
+    fallback: ApproverResolverFallback;
+    preferClosestOrgUnit: boolean;
+    /** 主管鏈 has no 只取最近一層主管. */
+    showPreferClosestOrgUnit: boolean;
+}>;
+/**
+ * The 只取最近一層主管 / 無主管時 pair of a resolver that looks a manager up,
+ * `null` for one that does not (so 本人 shows neither).
+ */
+export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
+export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+export {};

package/dist/views/templates/designer/dry-run-assignee-label.d.cts

@@ -11,6 +11,8 @@ export type DryRunAssigneeDirectory = Readonly<{
     formFields: readonly FormFieldRecord[];
     /** Display name of a real member id, or `null` when it is not known. */
     memberName: (memberId: string) => string | null;
+    /** Nodes of the workflow, to name the stages a `nodeActor:` placeholder lists. */
+    nodes: readonly NamedRecord[];
     orgUnits: readonly NamedRecord[];
     positions: readonly NamedRecord[];
 }>;