@k-table/report 1.0.1 → 1.0.4

package/dist/index.css

@@ -212,6 +212,52 @@ table.kt-sheet-region-table td {
   background: var(--kt-primary-soft, #e5e6eb);
   color: var(--kt-forms-text, var(--kt-text, #1d2129));
 }
+.kt-preview-body {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+}
+.kt-preview-main {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+.kt-preview-options-panel {
+  flex: 0 0 auto;
+  width: 232px;
+  box-sizing: border-box;
+  padding: 4px 12px 12px 0;
+  border-right: 1px solid var(--kt-forms-border, var(--kt-border, #f0e6d8));
+  position: sticky;
+  top: 48px;
+  align-self: flex-start;
+  max-height: calc(100vh - 160px);
+  overflow-y: auto;
+  font-size: 12px;
+  color: var(--kt-forms-text, var(--kt-text, #1d2129));
+}
+.kt-preview-options-section {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 8px;
+  margin-bottom: 16px;
+}
+.kt-preview-options-section:last-child {
+  margin-bottom: 0;
+}
+.kt-preview-options-section-title {
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--kt-forms-text-secondary, var(--kt-text-secondary, #8c8c8c));
+}
+.kt-preview-options-toggle--open {
+  color: var(--kt-primary, #165dff) !important;
+  border-color: var(--kt-primary, #165dff) !important;
+  background: var(--kt-primary-soft, rgba(22, 93, 255, 0.12)) !important;
+}
+.kt-preview-page-chrome .kt-preview-options-panel {
+  top: 16px;
+}
 .kt-preview-page-chrome {
   box-sizing: border-box;
   min-height: calc(100vh - 104px);

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 + 画布三件套） ----