openxiangda 1.0.264 → 2.0.0-alpha.2

package/packages/sdk/source/admin-list/README.md

@@ -1,12 +0,0 @@
-# AdminList 可复制源码
-
-此目录是 `AdminList` 的完整、可直接复制版本。它只依赖 React、Ant Design
-和 OpenXiangda 公开 SDK，不引用平台私有模块或旧列表实现。
-
-复制到业务项目后：
-
-1. 保留目录内文件的相对位置；
-2. 从本目录的 `index.ts` 引入组件和类型；
-3. 源码从复制时起完全由业务项目维护，不与 npm 包双向同步，也不会自动升级。
-
-`AdminList` 默认不渲染页面标题、列表标题、说明或面包屑，页面壳负责这些内容。

package/packages/sdk/source/admin-list/dataSources.ts

@@ -1,345 +0,0 @@
-// Complete ejectable AdminList source. Generated by npm run source:admin-list.
-// After copying this directory into an application it is fully application-owned.
-import type {
-  AdminListDataSource,
-  AdminListDataViewSourceOptions,
-  AdminListExportInput,
-  AdminListExportTask,
-  AdminListFormSourceOptions,
-  AdminListFunctionSourceOptions,
-  AdminListQuery,
-  AdminListResult,
-} from "./types"
-import { createAdminListPreferenceStore } from "./preferences"
-import type { PageBinaryResponse } from "openxiangda/runtime"
-
-const getHeaderValue = (
-  headers: PageBinaryResponse["headers"],
-  name: string,
-) => {
-  const match = Object.entries(headers || {}).find(
-    ([key]) => key.toLowerCase() === name.toLowerCase(),
-  )
-  return match?.[1] || ""
-}
-
-const decodeFileName = (value: string) => {
-  try {
-    return decodeURIComponent(value)
-  } catch {
-    return value
-  }
-}
-
-const parseContentDispositionFileName = (value: string) => {
-  const utf8Match = value.match(/filename\*=UTF-8''([^;]+)/i)
-  if (utf8Match?.[1]) return decodeFileName(utf8Match[1].trim())
-  const plainMatch = value.match(/filename="?([^";]+)"?/i)
-  return plainMatch?.[1] ? decodeFileName(plainMatch[1].trim()) : ""
-}
-
-const resolveExportFileName = (
-  response: PageBinaryResponse,
-  fallbackName: string,
-) => {
-  const disposition =
-    getHeaderValue(response.headers, "content-disposition") ||
-    (response.fileName?.includes("filename") ? response.fileName : "")
-  const candidate =
-    parseContentDispositionFileName(disposition) ||
-    response.fileName ||
-    fallbackName
-  return candidate.split(/[\\/]/).pop() || fallbackName
-}
-
-const saveExportBlob = (
-  response: PageBinaryResponse,
-  fallbackName: string,
-) => {
-  if (typeof window === "undefined" || typeof document === "undefined") return
-  const objectUrl = window.URL.createObjectURL(response.blob)
-  const anchor = document.createElement("a")
-  anchor.href = objectUrl
-  anchor.download = resolveExportFileName(response, fallbackName)
-  document.body.appendChild(anchor)
-  anchor.click()
-  anchor.remove()
-  window.URL.revokeObjectURL(objectUrl)
-}
-
-const nonEmpty = (value: unknown) =>
-  value !== undefined &&
-  value !== null &&
-  value !== "" &&
-  (!Array.isArray(value) || value.length > 0)
-
-const toFilterExpression = (
-  filters: Record<string, unknown>,
-  operators: Record<string, string> = {},
-) => ({
-  logic: "AND" as const,
-  rules: Object.entries(filters)
-    .filter(([, value]) => nonEmpty(value))
-    .map(([key, value]) => ({
-      key,
-      operator: operators[key] || (Array.isArray(value) ? "IN" : "EQ"),
-      value,
-    })),
-})
-
-const toOrder = (query: AdminListQuery) =>
-  query.sorts.map((sort) => ({
-    id: sort.field,
-    isAsc: (sort.direction === "ascend" ? "y" : "n") as "y" | "n",
-  }))
-
-const listRowKeys = ["rows", "data", "records", "list", "items"] as const
-
-const isObjectEnvelope = (value: unknown): value is Record<string, unknown> =>
-  Boolean(value) && typeof value === "object" && !Array.isArray(value)
-
-const resolveListEnvelope = (result: unknown) => {
-  const chain: Record<string, unknown>[] = []
-  const seen = new Set<Record<string, unknown>>()
-  let current: unknown = result
-
-  while (isObjectEnvelope(current) && !seen.has(current)) {
-    const envelope = current
-    seen.add(envelope)
-    chain.push(envelope)
-    if (listRowKeys.some((key) => Array.isArray(envelope[key]))) {
-      break
-    }
-    current = isObjectEnvelope(envelope.result)
-      ? envelope.result
-      : isObjectEnvelope(envelope.data)
-        ? envelope.data
-        : undefined
-  }
-
-  const value = chain[chain.length - 1] || {}
-  const metadataSources = [value, ...chain.slice(0, -1).reverse()]
-  const readMetadata = (...keys: string[]) => {
-    for (const source of metadataSources) {
-      for (const key of keys) {
-        if (source[key] !== undefined && source[key] !== null) return source[key]
-      }
-    }
-    return undefined
-  }
-
-  return { value, readMetadata }
-}
-
-const normalizeList = <Row>(result: unknown): AdminListResult<Row> => {
-  const { value, readMetadata } = resolveListEnvelope(result)
-  const rows = listRowKeys
-    .map((key) => value[key])
-    .find((candidate): candidate is Row[] => Array.isArray(candidate))
-  return {
-    rows: rows || [],
-    total: Number(readMetadata("total", "totalCount") ?? 0),
-    currentPage: readMetadata("currentPage") as number | undefined,
-    pageSize: readMetadata("pageSize") as number | undefined,
-    allowedColumnKeys: readMetadata("allowedColumnKeys") as string[] | undefined,
-    hiddenFieldsCount: readMetadata("hiddenFieldsCount") as number | undefined,
-  }
-}
-
-const createExportClient = (
-  options:
-    | AdminListFormSourceOptions
-    | AdminListDataViewSourceOptions
-    | AdminListFunctionSourceOptions,
-  source: Record<string, unknown>,
-) => {
-  const appType = options.appType || options.sdk.context.app.appType || ""
-  const requestedFileNames = new Map<string, string>()
-  const basePath = `/openxiangda-api/v1/apps/${encodeURIComponent(
-    appType,
-  )}/admin-list/exports`
-  return {
-    createExportTask: async (input: AdminListExportInput) => {
-      const normalizedInput = {
-        ...input,
-        rowIds: input.rowIds?.map((rowId) =>
-          typeof rowId === "number" ? rowId : String(rowId),
-        ),
-      }
-      let task: AdminListExportTask
-      if (options.sdk.export?.create) {
-        const response = await options.sdk.export.create({
-          appType,
-          exportKey: options.listKey,
-          source: source as any,
-          ...normalizedInput,
-          definitionCode: options.exportDefinitionCode,
-          definitionInput: options.exportDefinitionInput,
-        })
-        if (!response.result) {
-          throw new Error("创建导出任务失败：服务端未返回任务")
-        }
-        task = response.result
-      } else {
-        const response = await options.sdk.request<AdminListExportTask>({
-          path: basePath,
-          method: "post",
-          body: {
-            listKey: options.listKey,
-            source,
-            ...normalizedInput,
-          },
-        })
-        if (!response.result) {
-          throw new Error("创建导出任务失败：服务端未返回任务")
-        }
-        task = response.result
-      }
-      if (input.fileName) requestedFileNames.set(task.id, input.fileName)
-      return task
-    },
-    getExportTask: async (taskId: string) => {
-      if (options.sdk.export?.get) {
-        const response = await options.sdk.export.get(taskId, { appType })
-        if (!response.result) {
-          throw new Error("查询导出任务失败：任务不存在")
-        }
-        return response.result
-      }
-      const response = await options.sdk.request<AdminListExportTask>({
-        path: `${basePath}/${encodeURIComponent(taskId)}`,
-        method: "get",
-      })
-      if (!response.result) {
-        throw new Error("查询导出任务失败：任务不存在")
-      }
-      return response.result
-    },
-    downloadExportTask: async (
-      task: AdminListExportTask,
-      downloadOptions: { fileName?: string } = {},
-    ) => {
-      if (!task.downloadUrl) {
-        throw new Error("导出任务未返回下载地址")
-      }
-      const response = await options.sdk.transport.download({
-        path: task.downloadUrl,
-        method: "get",
-      })
-      const fallbackName =
-        downloadOptions.fileName ||
-        requestedFileNames.get(task.id) ||
-        `${options.listKey}.xlsx`
-      saveExportBlob(response, fallbackName)
-      requestedFileNames.delete(task.id)
-    },
-  }
-}
-
-export function createFormAdminListSource<Row>(
-  options: AdminListFormSourceOptions,
-): AdminListDataSource<Row> {
-  const appType = options.appType || options.sdk.context.app.appType || ""
-  const exportClient = createExportClient(options, {
-    type: "form",
-    formUuid: options.formUuid,
-    idField: options.idField || "formInstId",
-    filterOperators: options.filterOperators || {},
-  })
-  return {
-    key: `form:${appType}:${options.formUuid}:${options.listKey}`,
-    preferences: createAdminListPreferenceStore(options.sdk, appType),
-    async query(query) {
-      const filters = {
-        ...(options.fixedFilters || {}),
-        ...(query.fixedFilters || {}),
-        ...query.filters,
-      }
-      const response = await options.sdk.form.advancedSearch<Row>({
-        appType,
-        formUuid: options.formUuid,
-        currentPage: query.currentPage,
-        pageSize: query.pageSize,
-        filters: toFilterExpression(filters, options.filterOperators),
-        order: toOrder(query),
-      })
-      return normalizeList<Row>(response.result)
-    },
-    ...exportClient,
-  }
-}
-
-export function createDataViewAdminListSource<Row>(
-  options: AdminListDataViewSourceOptions,
-): AdminListDataSource<Row> {
-  const appType = options.appType || options.sdk.context.app.appType || ""
-  const exportClient = createExportClient(options, {
-    type: "dataView",
-    dataViewCode: options.dataViewCode,
-    fields: options.fields,
-    idField: options.idField || "id",
-    filterOperators: options.filterOperators || {},
-  })
-  return {
-    key: `data-view:${appType}:${options.dataViewCode}:${options.listKey}`,
-    preferences: createAdminListPreferenceStore(options.sdk, appType),
-    async query(query) {
-      const filters = {
-        ...(options.fixedFilters || {}),
-        ...(query.fixedFilters || {}),
-        ...query.filters,
-      }
-      const response = await options.sdk.dataView.query<Row>(
-        options.dataViewCode,
-        {
-          appType,
-          fields: options.fields,
-          currentPage: query.currentPage,
-          pageSize: query.pageSize,
-          filters: toFilterExpression(filters, options.filterOperators),
-          order: toOrder(query),
-        },
-      )
-      return normalizeList<Row>(response.result)
-    },
-    ...exportClient,
-  }
-}
-
-export function createFunctionAdminListSource<Row>(
-  options: AdminListFunctionSourceOptions,
-): AdminListDataSource<Row> {
-  const appType = options.appType || options.sdk.context.app.appType || ""
-  const exportClient = createExportClient(options, {
-    type: "function",
-    functionCode: options.functionCode,
-  })
-  return {
-    key: `function:${appType}:${options.functionCode}:${options.listKey}`,
-    preferences: createAdminListPreferenceStore(options.sdk, appType),
-    async query(query) {
-      const response = await options.sdk.function.invoke<
-        AdminListResult<Row>,
-        Record<string, unknown>
-      >(options.functionCode, {
-        appType,
-        input: {
-          contract: "admin_list_v1",
-          query: {
-            ...query,
-            fixedFilters: {
-              ...(options.fixedFilters || {}),
-              ...(query.fixedFilters || {}),
-            },
-          },
-        },
-      })
-      const invocation = response.result
-      if (!invocation) {
-        throw new Error("AdminList App Function 未返回结果")
-      }
-      return normalizeList<Row>(invocation.result || invocation.output)
-    },
-    ...exportClient,
-  }
-}

package/packages/sdk/source/admin-list/index.ts

@@ -1,42 +0,0 @@
-// Complete ejectable AdminList source. Generated by npm run source:admin-list.
-// After copying this directory into an application it is fully application-owned.
-export { AdminList } from "./AdminList"
-export {
-  createDataViewAdminListSource,
-  createFormAdminListSource,
-  createFunctionAdminListSource,
-} from "./dataSources"
-export {
-  createAdminListPreferenceStore,
-  mergeAdminListPreference,
-} from "./preferences"
-export type {
-  AdminListBatchAction,
-  AdminListColumn,
-  AdminListColumnPreference,
-  AdminListDataSource,
-  AdminListDataSourceOptions,
-  AdminListDataViewSourceOptions,
-  AdminListDensity,
-  AdminListExportInput,
-  AdminListExportDownloadOptions,
-  AdminListExportScope,
-  AdminListExportTask,
-  AdminListExportTaskStatus,
-  AdminListFormSourceOptions,
-  AdminListFunctionSourceOptions,
-  AdminListLockedPreference,
-  AdminListOption,
-  AdminListPreference,
-  AdminListPreferenceStore,
-  AdminListProps,
-  AdminListQuery,
-  AdminListResult,
-  AdminListRowAction,
-  AdminListSearchField,
-  AdminListSearchFieldType,
-  AdminListSearchPreference,
-  AdminListSelectionChange,
-  AdminListSort,
-  AdminListSortDirection,
-} from "./types"

package/packages/sdk/source/admin-list/preferences.ts

@@ -1,174 +0,0 @@
-// Complete ejectable AdminList source. Generated by npm run source:admin-list.
-// After copying this directory into an application it is fully application-owned.
-import type {
-  AdminListColumn,
-  AdminListLockedPreference,
-  AdminListPreference,
-  AdminListPreferenceStore,
-  AdminListSearchField,
-  AdminListSort,
-} from "./types"
-import type { PageSdk } from "openxiangda/runtime"
-
-const unique = (values: string[]) => Array.from(new Set(values.filter(Boolean)))
-
-const validSorts = (
-  sorts: AdminListSort[] | undefined,
-  sortableKeys: Set<string>,
-) =>
-  (sorts || []).filter(
-    (sort) =>
-      sortableKeys.has(sort.field) &&
-      (sort.direction === "ascend" || sort.direction === "descend"),
-  )
-
-export function mergeAdminListPreference<Row>(input: {
-  version: number
-  columns: AdminListColumn<Row>[]
-  searchFields: AdminListSearchField[]
-  defaultSorts?: AdminListSort[]
-  defaults?: Partial<AdminListPreference>
-  user?: AdminListPreference | null
-  locked?: AdminListLockedPreference
-  allowedColumnKeys?: string[]
-}): AdminListPreference {
-  const {
-    allowedColumnKeys,
-    columns,
-    defaultSorts,
-    defaults,
-    locked,
-    searchFields,
-    user,
-    version,
-  } = input
-  const columnMap = new Map(columns.map((column) => [column.key, column]))
-  const searchMap = new Map(searchFields.map((field) => [field.key, field]))
-  const allowed = allowedColumnKeys?.length
-    ? new Set(allowedColumnKeys)
-    : new Set(columns.map((column) => column.key))
-  const forcedVisible = new Set(locked?.visibleColumnKeys || [])
-  const forcedHidden = new Set(locked?.hiddenColumnKeys || [])
-  const forcedSearchVisible = new Set(locked?.visibleSearchKeys || [])
-  const forcedSearchHidden = new Set(locked?.hiddenSearchKeys || [])
-  const userColumns = new Map(
-    (user?.columns || [])
-      .filter((column) => columnMap.has(column.key))
-      .map((column) => [column.key, column]),
-  )
-  const orderedColumnKeys = unique([
-    ...(user?.columns || []).map((column) => column.key),
-    ...columns.map((column) => column.key),
-  ]).filter((key) => columnMap.has(key) && allowed.has(key))
-  const normalizedColumns = orderedColumnKeys.map((key) => {
-    const definition = columnMap.get(key)!
-    const preference = userColumns.get(key)
-    const visible = forcedHidden.has(key)
-      ? false
-      : forcedVisible.has(key) || definition.locked
-        ? true
-        : preference?.visible ??
-          definition.defaultVisible ??
-          !definition.hidden
-    return {
-      key,
-      visible,
-      width:
-        typeof preference?.width === "number" && preference.width >= 60
-          ? Math.round(preference.width)
-          : definition.width,
-      fixed:
-        definition.fixed ??
-        (preference?.fixed === "left" || preference?.fixed === "right"
-          ? preference.fixed
-          : null),
-    }
-  })
-  const userSearches = new Map(
-    (user?.searches || [])
-      .filter((field) => searchMap.has(field.key))
-      .map((field) => [field.key, field]),
-  )
-  const orderedSearchKeys = unique([
-    ...(user?.searches || []).map((field) => field.key),
-    ...searchFields.map((field) => field.key),
-  ]).filter((key) => searchMap.has(key))
-  const normalizedSearches = orderedSearchKeys.map((key) => {
-    const definition = searchMap.get(key)!
-    return {
-      key,
-      visible: forcedSearchHidden.has(key)
-        ? false
-        : forcedSearchVisible.has(key) || definition.locked
-          ? true
-          : userSearches.get(key)?.visible ??
-            definition.defaultVisible ??
-            true,
-    }
-  })
-  const sortableKeys = new Set(
-    columns
-      .filter((column) => column.sortable && allowed.has(column.key))
-      .map((column) => column.sortField || column.key),
-  )
-  return {
-    version,
-    columns: normalizedColumns,
-    searches: normalizedSearches,
-    sorts: locked?.sorts?.length
-      ? validSorts(locked.sorts, sortableKeys)
-      : validSorts(user?.sorts, sortableKeys).length
-        ? validSorts(user?.sorts, sortableKeys)
-        : validSorts(defaultSorts, sortableKeys),
-    density: locked?.density || user?.density || defaults?.density || "middle",
-    pageSize:
-      locked?.pageSize ||
-      (Number.isSafeInteger(user?.pageSize) && Number(user?.pageSize) > 0
-        ? Number(user?.pageSize)
-        : defaults?.pageSize || 20),
-    defaultVisibleSearchCount:
-      Number.isSafeInteger(user?.defaultVisibleSearchCount) &&
-      Number(user?.defaultVisibleSearchCount) > 0
-        ? Number(user?.defaultVisibleSearchCount)
-        : defaults?.defaultVisibleSearchCount || 4,
-    showBorders: user?.showBorders ?? defaults?.showBorders ?? false,
-    striped: user?.striped ?? defaults?.striped ?? false,
-    hoverActions: user?.hoverActions ?? defaults?.hoverActions ?? true,
-    updatedAt: user?.updatedAt,
-  }
-}
-
-export function createAdminListPreferenceStore(
-  sdk: PageSdk,
-  appType: string,
-): AdminListPreferenceStore {
-  const basePath = `/openxiangda-api/v1/apps/${encodeURIComponent(
-    appType,
-  )}/admin-list/preferences`
-  return {
-    async get(listKey) {
-      const response = await sdk.request<AdminListPreference | null>({
-        path: `${basePath}/${encodeURIComponent(listKey)}`,
-        method: "get",
-      })
-      return response.result || null
-    },
-    async put(listKey, preference) {
-      const response = await sdk.request<AdminListPreference>({
-        path: `${basePath}/${encodeURIComponent(listKey)}`,
-        method: "put",
-        body: preference,
-      })
-      if (!response.result) {
-        throw new Error("列表设置保存失败：服务端未返回配置")
-      }
-      return response.result
-    },
-    async remove(listKey) {
-      await sdk.request({
-        path: `${basePath}/${encodeURIComponent(listKey)}`,
-        method: "delete",
-      })
-    },
-  }
-}