cm-reporting 0.8.4 → 0.8.6

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ForwardRefExoticComponent } from 'react';
+import { JSX } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { ThemeConfig } from 'antd';
@@ -157,7 +158,7 @@ declare function cirsGpmLegacyToInternal(input: unknown): {
  * CM 自定义 CSS 变量配置。
  * 用于覆盖 lib/variables.css 中定义的默认值。
  */
-declare interface CMCSSVariables {
+export declare interface CMCSSVariables {
     /** 布局相关 */
     layout?: {
         /** 内容区域最大宽度 */
@@ -247,6 +248,36 @@ export declare interface CMReportingApi {
     validate: () => Promise<boolean>;
 }
 
+/**
+ * CMReportingApp：主入口组件。
+ * 接收 templateType、versionId 作为 props，内部管理页面导航状态。
+ */
+export declare function CMReportingApp({ templateType, versionId, readOnly, showPageActions, pageKey: controlledPageKey, onNavigatePage, maxContentWidth, integrations, children, }: CMReportingAppProps): JSX.Element;
+
+/**
+ * CMReportingApp Props。
+ */
+export declare interface CMReportingAppProps {
+    /** 模板类型 */
+    templateType: TemplateType;
+    /** 版本 ID */
+    versionId: string;
+    /** 全局只读模式 */
+    readOnly?: boolean;
+    /** 是否显示底部翻页操作（默认 true） */
+    showPageActions?: boolean;
+    /** 当前页面（受控模式） */
+    pageKey?: PageKey;
+    /** 页面导航回调（受控模式） */
+    onNavigatePage?: (pageKey: PageKey) => void;
+    /** 内容区域最大宽度（可选，不设置则填充父容器） */
+    maxContentWidth?: number;
+    /** 宿主扩展点：外部选择/回写列表等 */
+    integrations?: CMReportingIntegrations;
+    /** 插入点：用于对外门面组件做 snapshot/export 绑定（不作为 public API 承诺） */
+    children?: ReactNode;
+}
+
 export declare interface CMReportingIntegrations {
     smelterList?: SmelterListIntegration;
     productList?: ProductListIntegration;
@@ -274,10 +305,16 @@ export declare interface CMReportingProps {
     fallback?: ReactNode;
 }
 
+/**
+ * CMReportingProvider：顶层 Provider。
+ * 负责 i18n 初始化、Ant Design 配置和 Suspense 边界。
+ */
+export declare function CMReportingProvider({ locale, onLocaleChange, theme, cssVariables, children, fallback, }: CMReportingProviderProps): JSX.Element;
+
 /**
  * CMReportingProvider Props。
  */
-declare interface CMReportingProviderProps {
+export declare interface CMReportingProviderProps {
     /** 初始语言，默认 'en-US' */
     locale?: Locale;
     /** 语言变化回调 */
@@ -302,6 +339,17 @@ export declare interface CMReportingRef {
     validate: () => Promise<boolean>;
 }
 
+/**
+ * CM 主题配置。
+ * 结合 Ant Design 主题和 CM 自定义 CSS 变量。
+ */
+export declare interface CMThemeConfig {
+    /** Ant Design 主题配置 */
+    antd?: ThemeConfig;
+    /** CM 自定义 CSS 变量 */
+    cssVariables?: CMCSSVariables;
+}
+
 /**
  * 导出接口类型：CompanyQuestionDef。
  */
@@ -1550,6 +1598,11 @@ declare const _default: {
     }
 };
 
+/**
+ * 默认 Ant Design 主题配置。
+ */
+export declare const defaultAntdTheme: ThemeConfig;
+
 declare type DotNestedKeys<T> = T extends object ? {
     [K in keyof T & string]: T[K] extends Array<unknown> ? `${K}` : T[K] extends object ? `${K}` | `${K}.${DotNestedKeys<T[K]>}` : `${K}`;
 }[keyof T & string] : never;
@@ -1644,6 +1697,12 @@ declare function internalToCirsGpmLegacy(snapshot: ReportSnapshotV1, ctx: CirsGp
  */
 export declare type Locale = 'en-US' | 'zh-CN';
 
+/**
+ * 合并主题配置。
+ * 将用户提供的配置与默认配置深度合并。
+ */
+export declare function mergeThemeConfig(customTheme?: ThemeConfig, defaultTheme?: ThemeConfig): ThemeConfig;
+
 /**
  * 导出类型：MetalDropdownSource。
  */