@skopon-cool/form-sdk 0.1.0

package/src/submit/submitFormJson.ts

@@ -0,0 +1,50 @@
+export interface SubmitFormJsonOptions {
+  fetch?: typeof fetch
+  headers?: Record<string, string>
+}
+
+export interface SubmitFormJsonResult {
+  ok: boolean
+  status: number
+  body?: unknown
+}
+
+export async function submitFormJson(
+  callbackUrl: string,
+  payload: unknown,
+  options?: SubmitFormJsonOptions,
+): Promise<SubmitFormJsonResult> {
+  const url = callbackUrl.trim()
+  if (!url) {
+    throw new Error('callback_url 为空')
+  }
+  const fetchFn = options?.fetch ?? fetch
+  const response = await fetchFn(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...(options?.headers ?? {}),
+    },
+    body: JSON.stringify(payload ?? {}),
+  })
+  let body: unknown
+  const contentType = response.headers.get('content-type') ?? ''
+  if (contentType.includes('application/json')) {
+    try {
+      body = await response.json()
+    } catch {
+      body = undefined
+    }
+  } else {
+    try {
+      body = await response.text()
+    } catch {
+      body = undefined
+    }
+  }
+  return { ok: response.ok, status: response.status, body }
+}
+
+export async function copyTextToClipboard(text: string): Promise<void> {
+  await navigator.clipboard.writeText(text)
+}

package/src/types/index.ts

@@ -0,0 +1,139 @@
+/**
+ * A2UI v0.9 协议子集类型（对齐 @a2ui/react basicCatalog + skopon 自定义 catalog）。
+ */
+export type A2uiBinding<T> = T | { path: string }
+
+export type A2uiComponentName =
+  | 'Column'
+  | 'Row'
+  | 'Text'
+  | 'Image'
+  | 'Video'
+  | 'AudioPlayer'
+  | 'TextField'
+  | 'CheckBox'
+  | 'ChoicePicker'
+  | 'DateTimeInput'
+  | 'FileUpload'
+  | 'SkoponMedia'
+  | 'SkoponSelect'
+
+export interface A2uiComponentNode {
+  id: string
+  component: A2uiComponentName | string
+  children?: string[]
+  [prop: string]: unknown
+}
+
+export interface A2uiSurfaceDoc {
+  root: string
+  components: A2uiComponentNode[]
+  dataModel?: Record<string, unknown>
+  surfaceProperties?: Record<string, unknown> & { styleId?: string | null }
+}
+
+export const A2UI_PROTOCOL_VERSION = 'v0.9' as const
+
+export type FormJsonSchema = Record<string, unknown>
+
+export type FormBlockType =
+  | 'heading'
+  | 'paragraph'
+  | 'text'
+  | 'textarea'
+  | 'email'
+  | 'number'
+  | 'select'
+  | 'multiselect'
+  | 'radio'
+  | 'checkbox'
+  | 'toggle'
+  | 'tel'
+  | 'url'
+  | 'datetime'
+  | 'time'
+  | 'file'
+  | 'image'
+  | 'video'
+  | 'audio'
+
+export type FormMediaSize = 'huge' | 'large' | 'medium' | 'small' | 'icon'
+
+export type FormFilePlaceholderIcon =
+  | 'video'
+  | 'audio'
+  | 'image'
+  | 'file'
+  | 'spreadsheet'
+  | 'document'
+
+export const FORM_MEDIA_SIZES: FormMediaSize[] = [
+  'huge',
+  'large',
+  'medium',
+  'small',
+  'icon',
+]
+
+export interface FormBlockOption {
+  value: string
+  label: string
+}
+
+export interface FormBlock {
+  id: string
+  type: FormBlockType
+  name?: string
+  label?: string
+  placeholder?: string
+  help?: string
+  required?: boolean
+  options?: FormBlockOption[]
+  mediaUrl?: string
+  mediaUrls?: string[]
+  mediaSize?: FormMediaSize
+  fileAcceptTypes?: string[]
+  fileAcceptExtensions?: string[]
+  filePlaceholderIcon?: FormFilePlaceholderIcon
+  fileMinCount?: number
+  fileMaxCount?: number
+  defaultValue?: string | string[] | boolean
+}
+
+export interface FormSchema {
+  title?: string
+  description?: string
+  blocks: FormBlock[]
+  jsonSchema: FormJsonSchema
+}
+
+export function isMediaBlockType(type: FormBlockType): boolean {
+  return type === 'image' || type === 'video' || type === 'audio'
+}
+
+export function isLayoutBlockType(type: FormBlockType): boolean {
+  return type === 'heading' || type === 'paragraph'
+}
+
+export function isInputBlockType(type: FormBlockType): boolean {
+  return !isLayoutBlockType(type) && !isMediaBlockType(type)
+}
+
+export interface FormDefinitionPayload {
+  title?: string
+  description?: string
+  blocks?: FormBlock[]
+  a2ui?: A2uiSurfaceDoc
+  json_schema?: FormJsonSchema
+  jsonSchema?: FormJsonSchema
+}
+
+export interface FormDetailResult {
+  formUniqueId: string
+  formId?: number
+  disabled: boolean
+  formDefinition?: FormSchema
+  a2ui?: A2uiSurfaceDoc
+}
+
+export type SubmitMode = 'curl' | 'post'