create-react-admin-template 0.0.0-stage → 0.1.0

package/template/src/components/AppPageForm/SOURCE.md

@@ -0,0 +1,26 @@
+# PageForm source snapshot
+
+来源仓库、固定 revision、导入日期、同步范围和再分发状态只记录在
+[`tools/component-governance/manifest.json`](../../../tools/component-governance/manifest.json)，
+避免文档与构建门禁各自保存一份版本事实。
+
+The snapshot intentionally excludes the Vue adapter, examples, publishing
+configuration, and repository tooling. The former package split has been
+flattened into one application-owned component directory. Application Features
+must import the public `AppPageForm` boundary instead of implementation files.
+
+The source repository did not contain a `LICENSE` or `NOTICE` file at the
+recorded commit. Treat this snapshot as internal company code until ownership
+and redistribution terms are documented. The release gate is recorded in
+[`docs/component-source-governance.md`](../../../docs/component-source-governance.md).
+
+同步前执行：
+
+```bash
+pnpm components:diff -- \
+  --component AppPageForm \
+  --source-root /absolute/path/to/page-form
+```
+
+完成选择性移植和评审后才更新清单，并执行 `pnpm components:check` 与清单列出的回归
+命令。

package/template/src/components/AppPageForm/config.ts

@@ -0,0 +1,253 @@
+import { resolvePageFormMessages } from './messages'
+import type {
+  IFormItem,
+  IFormProp,
+  Observer,
+  PageFormContext,
+  PageFormRecord,
+  ResolvedIFormItem,
+  ResolvedIFormProp,
+} from './types'
+
+const isListener = <TValue, TModel extends PageFormRecord>(
+  source: Observer<TValue, TModel>
+): source is {
+  listen: (context: PageFormContext<TModel>) => TValue
+} =>
+  Boolean(
+    source &&
+    typeof source === 'object' &&
+    'listen' in source &&
+    typeof source.listen === 'function'
+  )
+
+const FORM_OBSERVER_KEYS = [
+  'confirmButtonText',
+  'resetButtonText',
+  'preventAll',
+  'resetBtn',
+  'disableSubmit',
+  'enterToSubmit',
+] as const
+
+const ITEM_OBSERVER_KEYS = [
+  'label',
+  'inputType',
+  'type',
+  'placeholder',
+  'filterable',
+  'multiple',
+  'options',
+  'lengthGreaterThan',
+  'clearable',
+  'maxLength',
+  'size',
+  'readonly',
+  'disabled',
+  'required',
+  'isEmail',
+  'isPhone',
+  'isNumber',
+  'isPositiveNumber',
+  'isPositiveInt',
+  'decimalsLimit',
+  'notChinese',
+  'vIf',
+  'vShow',
+  'block',
+  'componentConfig',
+  'remoteSelectConfig',
+  'fileConfig',
+] as const
+
+const isObserverValue = (value: unknown) =>
+  Boolean(
+    value &&
+    typeof value === 'object' &&
+    'listen' in value &&
+    typeof value.listen === 'function'
+  )
+
+export const hasPageFormObservers = <TModel extends PageFormRecord>(
+  config: IFormProp<TModel>,
+  patches: ReadonlyMap<
+    string,
+    Partial<Omit<IFormItem<TModel>, 'prop'>>
+  > = new Map()
+) =>
+  FORM_OBSERVER_KEYS.some((key) => isObserverValue(config[key])) ||
+  (config.formItems ?? []).some((item) => {
+    const resolvedItem = mergePageFormItem(item, patches.get(item.prop))
+    return ITEM_OBSERVER_KEYS.some((key) => isObserverValue(resolvedItem[key]))
+  })
+
+const resolvePageFormValue = <
+  TValue,
+  TModel extends PageFormRecord = PageFormRecord,
+>(
+  source: Observer<TValue, TModel> | undefined,
+  fallback: TValue,
+  context: PageFormContext<TModel>
+): TValue =>
+  source === undefined
+    ? fallback
+    : isListener(source)
+      ? source.listen(context)
+      : source
+
+const isPlainObject = (value: unknown): value is Record<string, unknown> => {
+  if (!value || typeof value !== 'object') return false
+  const prototype = Object.getPrototypeOf(value)
+  return prototype === Object.prototype || prototype === null
+}
+
+const mergeObjects = (current: unknown, patch: unknown) =>
+  isPlainObject(current) && isPlainObject(patch)
+    ? { ...current, ...patch }
+    : patch
+
+export const mergePageFormItemPatch = <TModel extends PageFormRecord>(
+  current: Partial<Omit<IFormItem<TModel>, 'prop'>>,
+  patch: Partial<Omit<IFormItem<TModel>, 'prop'>>
+) => {
+  const result = { ...current }
+  for (const [key, value] of Object.entries(patch)) {
+    ;(result as Record<string, unknown>)[key] = mergeObjects(
+      (result as Record<string, unknown>)[key],
+      value
+    )
+  }
+  return result
+}
+
+const mergePageFormItem = <TModel extends PageFormRecord>(
+  item: IFormItem<TModel>,
+  patch?: Partial<Omit<IFormItem<TModel>, 'prop'>>
+): IFormItem<TModel> =>
+  patch ? { ...item, ...mergePageFormItemPatch(item, patch) } : { ...item }
+
+const resolvePageFormItem = <TModel extends PageFormRecord>(
+  item: IFormItem<TModel>,
+  context: PageFormContext<TModel>
+): ResolvedIFormItem<TModel> => {
+  const remoteSelectConfig = resolvePageFormValue(
+    item.remoteSelectConfig,
+    undefined,
+    context
+  )
+  const fileConfig = resolvePageFormValue(item.fileConfig, undefined, context)
+  const inferredType =
+    item.component || item.renderer
+      ? 'component'
+      : remoteSelectConfig
+        ? 'remoteSelect'
+        : 'input'
+  const inputType = resolvePageFormValue(item.inputType, 'text', context)
+
+  return {
+    ...item,
+    label: resolvePageFormValue(item.label, '', context),
+    type: resolvePageFormValue(item.type, inferredType, context),
+    inputType,
+    placeholder: resolvePageFormValue(
+      item.placeholder,
+      remoteSelectConfig?.placeholder ?? '',
+      context
+    ),
+    filterable: resolvePageFormValue(
+      item.filterable,
+      remoteSelectConfig?.filterable ?? true,
+      context
+    ),
+    multiple: resolvePageFormValue(
+      item.multiple,
+      remoteSelectConfig?.multiple ?? false,
+      context
+    ),
+    options: resolvePageFormValue(item.options, [], context),
+    lengthGreaterThan: resolvePageFormValue(
+      item.lengthGreaterThan,
+      undefined,
+      context
+    ),
+    clearable: resolvePageFormValue(
+      item.clearable,
+      remoteSelectConfig?.clearable ?? true,
+      context
+    ),
+    maxLength: resolvePageFormValue(item.maxLength, undefined, context),
+    size: resolvePageFormValue(
+      item.size,
+      remoteSelectConfig?.size ?? 'medium',
+      context
+    ),
+    readonly: resolvePageFormValue(item.readonly, false, context),
+    disabled: resolvePageFormValue(item.disabled, false, context),
+    required: resolvePageFormValue(item.required, false, context),
+    isEmail: resolvePageFormValue(item.isEmail, false, context),
+    isPhone: resolvePageFormValue(item.isPhone, false, context),
+    isNumber: resolvePageFormValue(item.isNumber, false, context),
+    isPositiveNumber: resolvePageFormValue(
+      item.isPositiveNumber,
+      false,
+      context
+    ),
+    isPositiveInt: resolvePageFormValue(item.isPositiveInt, false, context),
+    decimalsLimit: resolvePageFormValue(item.decimalsLimit, undefined, context),
+    notChinese: resolvePageFormValue(item.notChinese, false, context),
+    vIf: resolvePageFormValue(item.vIf, true, context),
+    vShow: resolvePageFormValue(item.vShow, true, context),
+    block: resolvePageFormValue(item.block, false, context),
+    rows: item.rows ?? (inputType === 'textarea' ? 3 : undefined),
+    componentConfig: resolvePageFormValue(item.componentConfig, {}, context),
+    remoteSelectConfig,
+    fileConfig,
+  }
+}
+
+export const resolvePageFormConfig = <TModel extends PageFormRecord>(
+  config: IFormProp<TModel>,
+  context: PageFormContext<TModel>,
+  patches: ReadonlyMap<
+    string,
+    Partial<Omit<IFormItem<TModel>, 'prop'>>
+  > = new Map()
+): ResolvedIFormProp<TModel> => {
+  const inline = config.inline ?? true
+  const messages = resolvePageFormMessages('zh-CN', config.messages)
+  return {
+    ...config,
+    inited: config.inited ?? true,
+    formItems: (config.formItems ?? []).map((item) =>
+      resolvePageFormItem(
+        mergePageFormItem(item, patches.get(item.prop)),
+        context
+      )
+    ),
+    itemWidth: config.itemWidth ?? (inline ? 250 : 300),
+    labelWidth: config.labelWidth ?? (inline ? '90px' : '120px'),
+    height: config.height ?? 'auto',
+    width: config.width ?? 'auto',
+    maxWidth: config.maxWidth ?? (inline ? '1200px' : '800px'),
+    overflow: config.overflow ?? (config.maxHeight ? 'auto' : undefined),
+    inline,
+    messages,
+    confirmButtonText: resolvePageFormValue(
+      config.confirmButtonText,
+      messages.strConfirm,
+      context
+    ),
+    resetButtonText: resolvePageFormValue(
+      config.resetButtonText,
+      messages.strReset,
+      context
+    ),
+    preventAll: resolvePageFormValue(config.preventAll, false, context),
+    resetBtn: resolvePageFormValue(config.resetBtn, true, context),
+    disableSubmit: resolvePageFormValue(config.disableSubmit, false, context),
+    enterToSubmit: resolvePageFormValue(config.enterToSubmit, false, context),
+  }
+}
+
+export const toPageFormCssUnit = (value?: string | number) =>
+  typeof value === 'number' ? `${value}px` : value