@k-table/report 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -226,8 +226,8 @@ export interface KtPreviewHooks {
   ) => void;
 }
 export interface KtDesignerHooks {
-  /** 业务绑定字段目录，并入设计器字段面板 */
-  bindingSchemas?: unknown[];
+  /** 业务绑定字段目录，并入设计器字段面板；函数形式按当前 artifact 动态解析 */
+  bindingSchemas?: unknown[] | ((ctx: { artifactId?: string }) => unknown[] | undefined);
   /** 公式试算（宿主业务 API，按字段）；缺省时公式面板只编辑不试算 */
   trialFormula?: (ctx: {
     artifactId?: string;
@@ -433,7 +433,17 @@ export function KtReportDesigner(props: {
   allowImportPack?: boolean;
   extraActions?: ReactNode;
   leadingActions?: ReactNode;
+  /** 宿主桥（如 AI 设计助手）：挂载后注入当前稿读写能力 */
+  bridgeRef?: { current: KtReportDesignerBridge | null };
+  /** 只读：隐藏保存/另存/导入入口（权限降级；画布仍可交互但不持久化） */
+  readOnly?: boolean;
 }): JSX.Element;
+/** 设计器宿主桥：读当前 KTL / 应用 KTL（带诊断）/ 当前预览字段袋文本 */
+export type KtReportDesignerBridge = {
+  getCurrentKtl: () => string;
+  applyKtl: (ktl: string) => { ok: boolean; diagnostics?: { severity: string; message: string }[] };
+  getFieldDataText?: () => string;
+};
 export function KtReportPreview(props: {
   artifact?: Artifact;
   artifactId?: string;
@@ -538,14 +548,23 @@ export function KtReportPreviewSurface(props: {
   pageChrome?: PageChromeRegions | null;
   onPageChromeCommit?: (next: PageChromeRegions, remember: PageChromeRemember) => void;
   watermarkOverride?: unknown;
+  /** 只构建指定 sheet（宿主分副本/隐藏副页场景） */
+  sheetIds?: string[];
+  /** 文档后处理（宿主业务变换）：内建构建完成、空白变换之后调用 */
+  transformDocument?: (doc: unknown, ctx: { fieldData: ReportFieldData }) => unknown;
 }): JSX.Element;
 export function KtReportCatalog(props: {
   store?: ArtifactStore;
   kinds?: ArtifactKind[];
   onOpenDesign: (id: string) => void;
-  onOpenPreview: (id: string) => void;
+  /** 不提供则行内无「预览」入口（如母版等不可独立预览的 kind） */
+  onOpenPreview?: (id: string) => void;
   /** 提供且 features.fill 开启时，行内出现「录入」入口 */
   onOpenFill?: (id: string) => void;
+  /** 宿主行操作插槽：追加在内建操作之后（如启用开关/变体/提升/重置等宿主语义） */
+  renderRowActions?: (row: ArtifactMeta, ctx: { reload: () => void }) => ReactNode;
+  /** 行选择（宿主批量操作）：提供后出现勾选列 */
+  rowSelection?: { selectedIds: string[]; onChange: (ids: string[]) => void };
 }): JSX.Element;
 export function KtThemeBar(props?: { variant?: "default" | "onPrimary" }): JSX.Element;
 export function KtBrandBar(props: { title: string; themeBar?: boolean }): JSX.Element;
@@ -578,7 +597,10 @@ export function validateFieldsFormulas(fields: FormulaField[]): string | null;
 export function prepageSaveError(workbook: unknown): string | null;
 export function readPrepage(workbook: unknown): { sheetId?: string; rules: unknown[] } | null;
 export function isPrepageSheet(workbook: unknown, sheetId: string): boolean;
-export function parseKtlSafe(ktl: string): { workbook: any; diagnostics: { severity: string; message: string }[] };
+export function parseKtlSafe(ktl: string): {
+  workbook: import("@k-table/sheet-core").TemplateWorkbookState | null;
+  diagnostics: { severity: string; message: string }[];
+};
 export function workbookToKtlText(workbook: unknown): string;
 
 // ---- C2a：实例填报（KtReportFill + 画布三件套） ----