API 参考

interface BlockComponentProps<TContent = unknown, TBusiness = unknown> {
  block: ResolvedBlock<TContent, TBusiness>;
  mode: "page" | "editor";
}

interface ResolvedBlock<TContent = unknown, TBusiness = unknown> {
  id: number | string;
  block: string;
  description?: string;
  content: TContent;
  runtime: BlockRuntimeEnvelope<TBusiness>;
}

interface BlockRuntimeEnvelope<TBusiness = unknown> {
  context: {
    slug?: string;
    page?: number;
    url?: string;
    pageSize?: number;
    [k: string]: unknown;
  };
  placeholders: Record<string, unknown>;
  media: Record<string, unknown>;
  business: TBusiness;
  meta: {
    status: "ok" | "error";
    errors?: Array<{ code: string; message: string; stage?: string }>;
  };
}

interface RuntimeBlockInput<TContent = unknown> {
  id: number | string;
  block: string;
  description?: string;
  content: TContent;
  data?: unknown;
}

interface BlockDefinition<TContent = unknown, TBusiness = unknown> {
  type: string;
  schema: () => Promise<BlockFormConfig>;
  component: () => Promise<ComponentType<BlockComponentProps<TContent, TBusiness>>>;
  capabilities: {
    context: "inherit" | "none";
    placeholders?: {
      enabled: boolean;
      source: "content";
      withContext: boolean;
    };
    media?: Array<{
      path: string;
      kind: "image" | "imageArray";
      output?: string;
    }>;
  };
}

interface BlockFormConfig {
  blockType: string;
  displayName: string;
  description?: string;
  fields: FieldConfig[];
  groups?: FormGroup[];
  actions?: {
    db: number;
    config: number;
  };
  author?: {
    name: string;
    url?: string;
  };
  theme?: {
    name: string;
    url?: string;
  };
  previewData?: Record<string, unknown>;
}