realreport 1.9.2 → 1.9.4

package/dist/realreport.d.ts

@@ -1,18 +1,18 @@
 /// <reference types="pdfkit" />
 /** 
-* RealReport v1.9.2
-* commit 21c3c82
+* RealReport v1.9.4
+* commit e6834dd
 
+* {@link https://real-report.com}
 * Copyright (C) 2013-2024 WooriTech Inc.
-	https://real-report.com
 * All Rights Reserved.
 */
 
 /** 
-* RealReport Core v1.9.2
+* RealReport Core v1.9.4
 * Copyright (C) 2013-2024 WooriTech Inc.
 * All Rights Reserved.
-* commit e334d25e406b0ee0b242fb863bd5c1a5cba46226
+* commit 8239402f0d47181a735208f664f905b6fad990b7
 */
 type ConfigObject$1 = {
     [key: string]: any;
@@ -1112,6 +1112,7 @@ declare enum PropCategory {
     TOOLTIP = "tooltip",
     CROSSHAIR = "crosshair",
     OPTIONS = "options",
+    BODY = "body",
     CREDITS = "credits",
     STYLES = "Styles",
     EMAIL_FORM_INFO = "email form info",
@@ -1397,7 +1398,7 @@ type TreeItemSource = {
     iconType?: TreeItemIconType;
     children?: TreeItemSource[];
 };
-type TreeItemIconType = 'group' | 'report' | 'asset' | 'favorite' | 'bandData' | 'simpleData' | 'language';
+type TreeItemIconType = 'group' | 'report' | 'reportFolder' | 'asset' | 'favorite' | 'bandData' | 'simpleData' | 'language';
 
 /**
  * Asset item base.
@@ -1741,7 +1742,7 @@ declare class BandDataView extends Base$1 implements IBandDataView {
 
 interface IBandDataField {
     fieldName: string;
-    dataType?: "text" | "number" | "bool" | "datetime";
+    dataType?: "text" | "number" | "bool" | "array" | "datetime";
     source?: string;
     expression?: string;
     format?: string;
@@ -1792,6 +1793,7 @@ declare abstract class BandData extends LinkableReportData {
     indexOfField(field: IBandDataField): number;
     setField(index: number, field: IBandDataField): void;
     getSaveFields(): IBandDataField[];
+    getSaveValues(): any[];
     getNextFieldName(prefix?: string): string;
     getFieldNames(): string[];
     addField(index: number, field: IBandDataField): boolean;
@@ -1804,6 +1806,7 @@ declare abstract class BandData extends LinkableReportData {
     abstract getFieldValues(field: string | number, rows?: number[]): any[];
     get isBand(): boolean;
     preparePrint(ctx: PrintContext, design: boolean): void;
+    protected _getSampleValues(): any[];
     protected _readRows(): void;
     protected _prepareCalcField(fields: IBandDataField[], fieldMap: any, calcField: IBandDataField, index: number, node: ExpressionNode$1): void;
 }
@@ -1831,6 +1834,7 @@ declare class BandArrayData extends BandData implements IBandData {
     get sample(): any[];
     getValues(): any[];
     setValues(vals: any[]): void;
+    getFieldSample(): any[];
     setSource(source: any[]): void;
     /**
      * 특정 모드의 데이터를 일회성으로 조작하기 위한 편의성 메서드 (callback 실행 후 모드는 원복됨)
@@ -1839,6 +1843,7 @@ declare class BandArrayData extends BandData implements IBandData {
     getSaveType(): string;
     protected _doDataFetched(fetchedData: unknown): void;
     private $_cloneRow;
+    protected _getSampleValues(): any[];
     protected _readRows(): void;
     protected _prepareCalcField(fields: IBandDataField[], fieldMap: any, calcField: IBandDataField, index: number, node: ExpressionNode$1): void;
 }
@@ -1889,6 +1894,7 @@ declare class DesignDataManager extends EventAware$1 implements IReportDataProvi
 }
 
 interface IOutlineSource {
+    hash: number;
     outlineParent: IOutlineSource;
     outlineExpandable: boolean;
     outlineItems?: IOutlineSource[];
@@ -2497,6 +2503,19 @@ declare abstract class DataBandRowGroup extends ReportGroupItem {
     protected _doSave(target: object): void;
     getPropDomain(prop: IPropInfo): any[];
 }
+interface BandBorders {
+    border: string;
+    borderLeft: string;
+    borderRight: string;
+    borderTop: string;
+    borderBottom: string;
+}
+interface BorderWidths {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
 /**
  * Data band base class.
  *
@@ -2800,6 +2819,9 @@ declare abstract class DataBand extends ReportGroupItem {
     getMin(field: string, count: number, rows?: number[]): number;
     getMax(field: string, count: number, rows?: number[]): number;
     getAvg(field: string, count: number, rows?: number[]): number;
+    getBandBorders(): BandBorders;
+    getBandBorderWidths(): BorderWidths;
+    hasBorder(): boolean;
     getPropDomain(prop: IPropInfo): any[];
     /**
      * 출력시 사용되는 밴드의 정보를 초기값으로 초기화
@@ -2843,6 +2865,7 @@ declare class DataBandCollection extends ReportGroupItem {
     get owner(): DataBand;
     protected _getChildPropInfos(item: ReportItem): IPropInfo[];
     getSaveType(): string;
+    canFold(): boolean;
     get outlineLabel(): string;
     get designLevel(): number;
     get marqueeParent(): ReportItem;
@@ -3143,6 +3166,8 @@ declare class TableBand extends DataBand {
     setPrinting(ctx: PrintContext, pr: number, trows?: number): void;
     getSaveType(): string;
     get outlineLabel(): string;
+    canFold(): boolean;
+    protected _getStyleProps(): string[];
     get isBand(): boolean;
     protected _ignoreItems(): boolean;
     protected _getEditProps(): IPropInfo[];
@@ -3424,7 +3449,9 @@ declare class SimpleBand extends DataBand {
     get outlineLabel(): string;
     get isBand(): boolean;
     protected _ignoreItems(): boolean;
+    canFold(): boolean;
     protected _getEditProps(): IPropInfo[];
+    protected _getStyleProps(): string[];
     isAncestorOf(item: ReportPageItem): boolean;
     protected _doLoad(loader: IReportLoader, src: any): void;
     protected _doSave(target: object): void;
@@ -3747,6 +3774,7 @@ type ReportGroupItemView = ReportGroupItemElement<ReportGroupItem>;
 declare abstract class BandElement<T extends DataBand> extends ReportGroupItemElement<T> {
     static readonly END_ROW_MESSAGE_CLASS = "rr-end-row-message";
     static readonly END_ROW_CLASS = "rr-end-row";
+    static readonly BORDER_CONTAINER = "rr-band-border-container";
     abstract get rowView(): ReportGroupItemView;
     private _needFooterView;
     get needFooterView(): boolean;
@@ -3754,6 +3782,8 @@ declare abstract class BandElement<T extends DataBand> extends ReportGroupItemEl
     abstract getLines(): ReportItemView[];
     abstract printRow(ctx: PrintContext, row: number): any;
     getSibling(item: ReportItemView, delta: number): ReportItemView;
+    findMasterBand(band: DataBand): DataBand;
+    getBandLevel(masterBand: DataBand, band: DataBand): string;
     abstract addMasterRow(page: HTMLDivElement, headerView: any, rowView: any, x: number, y: number): number;
     abstract prepareAsync(doc: Document, ctx: PrintContext, width: number, subRows: number[], masterRow: number): BandPrintInfo<any>;
     abstract prepareSubBand(doc: Document, ctx: PrintContext, width: number, dataRows: number[]): BandPrintInfo<any>;
@@ -3762,6 +3792,7 @@ declare abstract class BandElement<T extends DataBand> extends ReportGroupItemEl
     protected _getPrev(item: ReportItemView): ReportItemView;
     private $_prepareDetailDataBand;
     private $_prepareDetailBandGroup;
+    private $_setBandLevel;
 }
 
 /**
@@ -4203,6 +4234,7 @@ declare class CrosstabBandTitle extends ReportItem {
     /** text */
     get text(): string;
     set text(value: string);
+    get page(): ReportPage;
     protected _getEditProps(): any[];
     protected _getStyleProps(): string[];
     protected _doLoad(loader: IReportLoader, src: any): void;
@@ -4218,6 +4250,7 @@ declare class CrosstabNullValue extends ReportItem {
     /** text */
     get text(): string;
     set text(value: string);
+    get page(): ReportPage;
     protected _getEditProps(): any[];
     protected _getStyleProps(): string[];
     protected _doLoad(loader: IReportLoader, src: any): void;
@@ -4413,7 +4446,7 @@ type RCLegendConfig = {
 declare enum RCLegendAlignBase {
     CHART = "chart",
     PARENT = "parent",
-    PLOT = "plot"
+    BODY = "body"
 }
 declare enum RCLegendItemsAlign {
     START = "start",
@@ -4430,7 +4463,7 @@ declare enum RCLegendLocation {
     BOTTOM = "bottom",
     LEFT = "left",
     RIGHT = "right",
-    PLOT = "plot"
+    BODY = "body"
 }
 
 interface RCSubtitleConfig {
@@ -4479,6 +4512,7 @@ interface RCAxisConfigBase {
     name?: string;
     maxValue?: number;
     minValue?: number;
+    startAngle?: number;
     marginFar?: number;
     marginNear?: number;
     maxPadding?: number;
@@ -4486,19 +4520,25 @@ interface RCAxisConfigBase {
     label?: RCAxisLabelConfig;
     grid?: RCAxisGridConfig;
     line?: RCAxisLineConfig;
-    tick?: RCAxisGridConfig;
+    tick?: RCAxisTickConfig;
     crosshair?: RCAxisCorssHairConfig;
 }
 interface RCAxisTitleConfig {
     text: string;
     visible?: boolean;
-    align?: number;
+    align?: RCAxisTitleConfigAlign;
     gap?: number;
     offset?: number;
-    rotation?: number;
+    rotation?: RCAxisTitleConfigRotation;
     backgroundStyle?: RCSvgStyles;
     style?: RCSvgStyles;
 }
+declare enum RCAxisTitleConfigAlign {
+    MIDDLE = "middle",
+    START = "start",
+    END = "end"
+}
+type RCAxisTitleConfigRotation = 0 | 90 | 270 | -90 | -270;
 interface RCAxisLabelConfig {
     visible?: boolean;
     text?: string;
@@ -4620,6 +4660,8 @@ interface RCSeriesPointLabelConfig {
     visible?: boolean;
     text?: string;
     style?: RCSvgStyles;
+    offset?: number;
+    position?: RCSeriesPointLabelPosition;
 }
 interface RCSeriesTooltipConfig {
     visible?: boolean;
@@ -4645,11 +4687,21 @@ declare enum RCSeriesMarkerShape {
     ITRIANGLE = "itriangle",
     RECTANGLE = "rectangle"
 }
+declare enum RCSeriesPointLabelPosition {
+    AUTO = "auto",
+    FOOT = "foot",
+    HEAD = "head",
+    INSIDE = "inside",
+    INSIDEFIRST = "insideFirst",
+    OUTSIDE = "outside",
+    OUTSIDEFIRST = "outsideFirst"
+}
 
 /**
  * RealChart
  */
 type RCConfig = {
+    polar: boolean;
     inverted?: boolean;
     title?: RCTitleConfig;
     subtitle?: RCSubtitleConfig;
@@ -4658,6 +4710,7 @@ type RCConfig = {
     xAxis: RCAxisConfig[];
     yAxis: RCAxisConfig[];
     series: RCSeriesConfig[];
+    body?: RCBodyConfig;
 };
 /**
  *  Options
@@ -4666,6 +4719,12 @@ type RCOptionsConfig = {
     animatable?: boolean;
     credits?: RCCreditsConfig;
 };
+/**
+ *  Body
+ */
+type RCBodyConfig = {
+    circular?: boolean;
+};
 /**
  * Etc
  */
@@ -4832,6 +4891,7 @@ declare class RCAxisLabel extends RCAxisTextObject<RCAxisLabelConfig> {
     protected _getStyleProps(): string[];
     protected _doLoad(loader: IReportLoader, source: ReportSource): void;
     protected _doSave(target: ReportTarget): void;
+    getPropDomain(prop: IPropInfo): any[];
 }
 
 declare abstract class RCAxis<C = RCAxisConfig> extends ChartAxis<RealChartItem, C> {
@@ -4841,6 +4901,7 @@ declare abstract class RCAxis<C = RCAxisConfig> extends ChartAxis<RealChartItem,
     static readonly PROP_MIN_VALUE = "minValue";
     static readonly PROP_STRICT_MAX = "strictMax";
     static readonly PROP_STRICT_MIN = "strictMin";
+    static readonly PROP_START_ANGLE = "startAngle";
     static readonly PROP_TITLE = "title";
     static readonly PROP_LABEL = "label";
     static readonly PROP_GRID = "grid";
@@ -4852,6 +4913,7 @@ declare abstract class RCAxis<C = RCAxisConfig> extends ChartAxis<RealChartItem,
     private _minValue;
     private _strictMax;
     private _strictMin;
+    private _startAngle;
     private _title;
     private _label;
     private _grid;
@@ -4869,6 +4931,8 @@ declare abstract class RCAxis<C = RCAxisConfig> extends ChartAxis<RealChartItem,
     set maxValue(value: number);
     get minValue(): number;
     set minValue(value: number);
+    get startAngle(): number;
+    set startAngle(value: number);
     get strictMax(): number;
     set strictMax(value: number);
     get strictMin(): number;
@@ -5034,7 +5098,7 @@ declare class RCTitle extends ChartTextObject$1<RealChartItem, RCTitleConfig> {
 
 declare class RCLegend extends ChartObject$1<RealChartItem, RCLegendConfig> {
     static readonly PROP_ALIGN_BASE = "alignBase";
-    static readonly PROP_ALIGN_BASE_DEFAULT_VALUE = RCLegendAlignBase.PLOT;
+    static readonly PROP_ALIGN_BASE_DEFAULT_VALUE = RCLegendAlignBase.BODY;
     static readonly PROP_GAP = "gap";
     static readonly PROP_GAP_DEFAULT_VALUE = 6;
     static readonly PROP_ITEM_GAP = "itemGap";
@@ -5106,6 +5170,7 @@ declare class RCLegend extends ChartObject$1<RealChartItem, RCLegendConfig> {
     protected _setSubStyle(prop: string, style: string, value: any): void;
     protected _doLoad(loader: IReportLoader, source: ReportSource): void;
     protected _doSave(target: ReportTarget): void;
+    getPropDomain(prop: IPropInfo): any[];
 }
 
 declare class RCOptions extends ChartObject$1<RealChartItem, RCOptionsConfig> {
@@ -5124,6 +5189,21 @@ declare class RCOptions extends ChartObject$1<RealChartItem, RCOptionsConfig> {
     protected _doSave(target: ReportTarget): void;
 }
 
+declare class RCBody extends ChartObject$1<RealChartItem, RCBodyConfig> {
+    static readonly PROP_CIRCULAR = "circular";
+    static readonly PROPINFOS: IPropInfo[];
+    private _circular;
+    constructor(chart: RealChartItem);
+    get circular(): boolean;
+    set circular(value: boolean);
+    getChartConfig(context: PrintContext): RCBodyConfig;
+    getSaveLabel(): string;
+    protected _doDefaultInit(): void;
+    protected _getEditProps(): IPropInfo[];
+    protected _doLoad(loader: IReportLoader, source: ReportSource): void;
+    protected _doSave(target: ReportTarget): void;
+}
+
 /**
  * Chart Item
  */
@@ -5137,6 +5217,8 @@ declare class RealChartItem extends ChartItem<RCConfig> {
     static readonly PROP_SUBTITLE = "subtitle";
     static readonly PROP_LEGEND = "legend";
     static readonly PROP_OPTIONS = "options";
+    static readonly PROP_POLAR = "polar";
+    static readonly PROP_BODY = "body";
     static readonly PROPINFOS: IPropInfo[];
     static readonly STYLE_PROPS: string[];
     static readonly $_ctor: string;
@@ -5149,6 +5231,8 @@ declare class RealChartItem extends ChartItem<RCConfig> {
     private _subtitle;
     private _legend;
     private _options;
+    private _body;
+    private _polar;
     constructor(name: string);
     get outlineLabel(): string;
     get outlineItems(): IOutlineSource[];
@@ -5162,6 +5246,9 @@ declare class RealChartItem extends ChartItem<RCConfig> {
     get subtitle(): RCSubtitle;
     get legend(): RCLegend;
     get options(): RCOptions;
+    get polar(): boolean;
+    set polar(value: boolean);
+    get body(): RCBody;
     addNewXAxis(type: RCAxisType): RCAxis;
     addNewYAxis(type: RCAxisType): RCAxis;
     addAxis(axis: RCAxis): void;
@@ -6241,6 +6328,10 @@ declare class PrintContainer extends VisualContainer$1 {
      * 한 페이지당 수정가능한 아이템 정보를 찾아서 정보를 최신화 시킨다.
      */
     private $_addEditableItems;
+    /**
+     * 보더가 적용될 컨테이너를 생성하고 보더 너비만큼 반환한다.
+     */
+    private $_addBorderContainer;
     protected _fireScrollEnd: () => void;
 }
 
@@ -6836,6 +6927,34 @@ declare class Report extends EventAware$1 implements IEditCommandStackOwner, IPr
     protected _fireAlert(item: ReportItem, message: string): void;
 }
 
+/**
+ * ItemAddSection
+ */
+declare class ItemAddSection<S extends PageSection> extends PageSection {
+    static readonly $_ctor: string;
+    static readonly PROPINFOS: IPropInfo[];
+    private _targetSection;
+    constructor(target: S);
+    get targetSection(): S;
+    get pathLabel(): string;
+    canResize(dir: ResizeDirection): boolean;
+    canFold(): boolean;
+    protected _getStyleProps(): string[];
+    protected _getEditProps(): IPropInfo[];
+    canContainsBand(): boolean;
+    canContainsBandGroup(): boolean;
+}
+/**
+ * BodyItemAddSection
+ */
+declare class BodyItemAddSection extends ItemAddSection<PageBody> {
+    static readonly $_ctor: string;
+    constructor(target: PageBody);
+    get pathLabel(): string;
+    get outlineLabel(): string;
+    protected _doItemAdded(item: ReportItem, index: number): void;
+}
+
 /**
  * 리포트 페이지 모델. 하나 이상의 section들로 구성된다.
  *
@@ -6881,6 +7000,7 @@ declare class ReportPage extends ReportGroupItem implements IEventAware {
     saveTag: string;
     private _loading;
     private _removing;
+    private _addItemSection;
     constructor(report: Report, name?: string);
     addListener(listener: object): IEventAware;
     removeListener(listener: object): IEventAware;
@@ -6918,6 +7038,11 @@ declare class ReportPage extends ReportGroupItem implements IEventAware {
      */
     get body(): PageBody;
     set body(section: PageBody);
+    /**
+     * addItemSection
+     */
+    get addItemSection(): ItemAddSection<PageBody>;
+    set addItemSection(section: ItemAddSection<PageBody>);
     get backContainer(): PageItemContainer;
     set backContainer(section: PageItemContainer);
     /**
@@ -7250,6 +7375,16 @@ declare class PageFooterElement extends InheritableSectionElement<PageFooter> {
     protected _isContexable(): boolean;
     protected _doPrepareMeasure(ctx: PrintContext, dom: HTMLElement): void;
 }
+/** @internal */
+declare class BodyItemAddSectionElement extends SectionElement<ItemAddSection<PageSection>> {
+    constructor(doc: Document, model?: BodyItemAddSection);
+    protected _doDispose(): void;
+    get debugLabel(): string;
+    protected _getCssSelector(): string;
+    protected _isContexable(): boolean;
+    protected _doPrepareMeasure(ctx: PrintContext, dom: HTMLElement): void;
+    protected _doSizeChanged(): void;
+}
 
 /**
  * @internal
@@ -7410,16 +7545,19 @@ interface PageViewOptions {
     reportFooterEnabled?: boolean;
     pageHeaderEnabled?: boolean;
     pageFooterEnabled?: boolean;
+    addBodyItemSectionEnabled?: boolean;
 }
 /** @internal */
 declare class PageView extends LayerElement$1 {
     private static readonly DEFAULT_PAGE_VIEW_OPTIONS;
+    private static readonly PAGE_BOTTOM_GAP;
     private _model;
     private _reportHeaderView?;
     private _reportFooterView?;
     private _pageHeaderView?;
     private _pageFooterView?;
     private _bodyView;
+    private _addBodyItemSectionView;
     private _backView?;
     private _frontView?;
     private _sections;
@@ -7442,6 +7580,8 @@ declare class PageView extends LayerElement$1 {
     get pageFooterView(): PageFooterElement;
     /** bodyView */
     get bodyView(): PageBodyElement;
+    /** addItemElement */
+    get addItemSectionElement(): BodyItemAddSectionElement;
     /** backFloatingView */
     get backFloatingView(): PageItemContainerElement;
     /** frontFloatingView */
@@ -7567,6 +7707,8 @@ declare class ReportView extends LayerElement$1 implements IImageContainer {
     protected _layoutPageBorders(rReport: Rectangle$1, rPage: Rectangle$1): void;
     private $_layout;
     protected _afterLayout(ctx: PrintContext, bounds: Rectangle$1): void;
+    $_setRectPageViews(ctx: PrintContext, pageViews: PageView[], bounds: Rectangle$1, size: Size$1): void;
+    $_getOverflowHeight(): number;
     $_afterRender(ctx: PrintContext): void;
     $_createElement(item: ReportItem): ReportElement;
     /**
@@ -7918,6 +8060,10 @@ declare abstract class BandPrintInfo<T extends ReportItem> {
      */
     setBandBoundPosition(ctx: PrintContext, model: BandModel, div: HTMLDivElement): void;
     setBandPrevIndex(index: number): void;
+    createBorderContaienr(doc: Document, y: number, w: number, name: string, tModel: string): HTMLDivElement;
+    setBorderContainerStyle(borderContainer: HTMLDivElement, styles: {
+        [x: string]: string;
+    }): void;
     protected _setX(dom: HTMLElement, x: number): void;
     protected _setY(dom: HTMLElement, y: number): void;
     protected _setPos(dom: HTMLElement, x: number, y: number): void;