@k-table/report 1.0.0 → 1.0.3

package/dist/index.css

@@ -136,9 +136,9 @@ table.kt-sheet-region-table td {
   padding: 6px 8px;
   border-bottom-width: 1px;
   border-bottom-style: solid;
-  border-bottom-color: #e5e6eb;
-  background: #fff;
-  color: #1d2129;
+  border-bottom-color: var(--kt-forms-border, var(--kt-border, #e5e6eb));
+  background: var(--kt-forms-chrome-bar, var(--kt-header-bg, #fff));
+  color: var(--kt-forms-text, var(--kt-text, #1d2129));
 }
 .kt-compose-preview-pane-head__start {
   display: flex;
@@ -156,29 +156,28 @@ table.kt-sheet-region-table td {
 .kt-preview-print-bar {
   display: flex;
   align-items: center;
+  flex-wrap: wrap;
   gap: 8px;
-  height: 28px;
-  min-height: 28px;
+  min-height: 40px;
   margin-bottom: 8px;
   box-sizing: border-box;
+  color: var(--kt-forms-text, var(--kt-text, #1d2129));
 }
 .kt-preview-print-bar-main,
 .kt-preview-print-bar-end,
 .kt-preview-zoom {
   display: flex;
   align-items: center;
-  min-height: 0;
-  height: 28px;
+  min-height: 28px;
 }
 .kt-preview-print-bar-main {
   min-width: 0;
-  flex: 1;
+  flex: 1 1 auto;
   gap: 8px;
-  flex-wrap: nowrap;
-  overflow-x: auto;
+  flex-wrap: wrap;
 }
 .kt-preview-print-bar-end {
-  flex-shrink: 0;
+  flex: 0 0 auto;
   margin-left: auto;
   gap: 4px;
 }
@@ -191,34 +190,48 @@ table.kt-sheet-region-table td {
   height: 28px;
   line-height: 28px;
   font-size: 12px;
-  color: #8c8c8c;
+  color: var(--kt-forms-text-secondary, var(--kt-text-secondary, #8c8c8c));
   white-space: nowrap;
 }
 .kt-preview-fill-icon-btn {
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  width: 24px;
-  height: 24px;
+  width: 28px;
+  height: 28px;
   padding: 0;
   border-width: 0;
   background: transparent;
-  color: #4e5969;
+  color: var(--kt-forms-text-secondary, var(--kt-text-secondary, #4e5969));
   cursor: pointer;
   border-radius: 2px;
   flex-shrink: 0;
   font-size: 16px;
 }
 .kt-preview-fill-icon-btn:hover {
-  background: #e5e6eb;
-  color: #1d2129;
+  background: var(--kt-primary-soft, #e5e6eb);
+  color: var(--kt-forms-text, var(--kt-text, #1d2129));
 }
 .kt-preview-page-chrome {
   box-sizing: border-box;
   min-height: calc(100vh - 104px);
-  background: #fff;
+  background: var(--kt-forms-preview-host, var(--kt-page-bg, #f2f3f5));
+  color: var(--kt-forms-text, var(--kt-text));
   padding: 16px;
 }
+.kt-preview--modal {
+  min-width: 0;
+  min-height: 0;
+}
+.kt-preview--modal .kt-preview-print-bar {
+  position: sticky;
+  top: 0;
+  z-index: 2;
+  background: var(--kt-forms-preview-host, var(--kt-page-bg, #f2f3f5));
+}
+.kt-preview--modal .kt-report-preview-host {
+  padding-top: 8px;
+}
 .kt-preview-page-chrome--fill {
   min-height: 100vh;
   padding: 8px;

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;
@@ -466,6 +476,8 @@ export function KtReportPreview(props: {
     next: { showOpinion: boolean; showQr: boolean; showReviewer: boolean },
     remember: { rememberUnit?: boolean; rememberMaster?: boolean },
   ) => void;
+  /** page = 整页预览台；modal = 设计器弹层 */
+  chrome?: "page" | "modal";
 }): JSX.Element;
 // C3：低层逃生舱与通用预览工具
 export type PageChromeRegions = { showOpinion: boolean; showQr: boolean; showReviewer: boolean };
@@ -536,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;
@@ -576,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 + 画布三件套） ----
@@ -670,6 +694,7 @@ export const KtReportFill: React.ForwardRefExoticComponent<
       request?: <T>(path: string, init?: RequestInit) => Promise<T>;
       scheme?: any;
       onSchemeChange?: (s: any, b: any) => void;
+      loadMaster?: (masterId: string) => Promise<string | null>;
     };
     dicts?: Record<string, { value: string; label: string }[]>;
     className?: string;