realreport 1.7.2 → 1.7.4

package/dist/realreport.css

@@ -12,7 +12,6 @@
     -moz-user-select: none;
     -ms-user-select: none;
     user-select: none;
-    touch-action: none;
     -ms-touch-action: none;
     -webkit-print-color-adjust: exact;
 }
@@ -29,10 +28,7 @@
 
 .rr-report-preview {
     position: absolute;
-    padding: 1px;
-    /** 현재 이 설정이 없으면 중간 빈 페이지가 출력된다! */
     background-color: transparent;
-    pointer-events: none;
 }
 
 .rr-feedback-container {
@@ -383,16 +379,11 @@
 
 .rr-page-break {
     margin-bottom: 20px;
-    /** preview page 간격 */
     border: 1px solid gray;
     box-sizing: border-box;
     box-shadow: rgba(50, 54, 57, 0.15) 0px 1px 3px 1px;
 }
 
-.rr-print-back {
-    position: absolute !important;
-}
-
 @page {
     margin: 0;
 }

package/dist/realreport.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="pdfkit" />
 /// <reference types="node" />
 /** 
-* RealReport v1.7.2
-* commit 3e2393d
+* RealReport v1.7.4
+* commit 8931b86
 
 * Copyright (C) 2013-2023 WooriTech Inc.
 	https://real-report.com
@@ -10,10 +10,10 @@
 */
 
 /** 
-* RealReport Core v1.7.2
+* RealReport Core v1.7.4
 * Copyright (C) 2013-2023 WooriTech Inc.
 * All Rights Reserved.
-* commit 5f0ed42cb85e4af49c799269cc92ce9139da2dcd
+* commit 92946b63c6b2aff0d7e155f742427f8fa8647b35
 */
 declare const enum Cursor$1 {
     DEFAULT = "default",
@@ -138,6 +138,10 @@ declare namespace ResizeDirection {
     function isEdge(dir: ResizeDirection): boolean;
     function isIn(dir: ResizeDirection, ...dirs: ResizeDirection[]): boolean;
 }
+declare enum DataDirection {
+    ASCENDING = "ascending",
+    DESCENDING = "descending"
+}
 /**
  * Find options
  */
@@ -1737,6 +1741,31 @@ declare class FieldValueRuntime extends ExpressionRuntime$1 {
     evaluateFunc(idKey: number, param: string): any;
 }
 
+/**
+ * @filename BandDataView.ts
+ * @author sykim <KIMSANGYEOB>
+ * @date 2023.07.13
+ * @description <밴드 데이터에서 추가적인 설정을 적용 후 표현하기 위해 작성>
+ */
+
+interface IBandDataView {
+    rowCount: number;
+    sort: (field: string, direction: DataDirection) => void;
+    getRowValue: (row: number, field: string) => any;
+    getFieldValues: (field: string, rows?: number[]) => any[];
+}
+declare class BandDataView extends Base$1 implements IBandDataView {
+    static readonly SOURCE_INDEX = "_sourceIndex";
+    private _source;
+    private _view;
+    constructor(data: IReportData);
+    get rowCount(): number;
+    sort(field: string, direction: DataDirection): this;
+    getRowValue(row: number, field: string): any;
+    getFieldValues(field: string, rows?: number[]): any[];
+    $_isValidField(field: string): boolean;
+}
+
 interface IBandDataField {
     fieldName: string;
     dataType?: "text" | "number" | "bool" | "datetime";
@@ -1770,7 +1799,7 @@ interface IBandData extends IReportData {
     getFieldValues(field: string | number): any[];
     equalValues(row: number, fields: string[], values: any[]): boolean;
     equalRows(row1: number, row2: number, fields?: string[]): boolean;
-    groupBy(fields: string[], rows: number[]): (number | IBandRowGroup | IBandRowGroupFooter)[];
+    groupBy(dataView: BandDataView, fields: string[], rows: number[]): (number | IBandRowGroup | IBandRowGroupFooter)[];
 }
 declare abstract class BandData extends ReportData$1 {
     protected _fields: IBandDataField[];
@@ -1793,7 +1822,7 @@ declare abstract class BandData extends ReportData$1 {
     addField(index: number, field: IBandDataField): boolean;
     removeField(field: IBandDataField): boolean;
     abstract getRowValue(row: number, field: string | number): any;
-    groupBy(fields: string[], subRows?: number[]): (number | IBandRowGroup | IBandRowGroupFooter)[];
+    groupBy(dataView: BandDataView, fields: string[], subRows?: number[]): (number | IBandRowGroup | IBandRowGroupFooter)[];
     readValue(field: IBandDataField, value: any): any;
     readRow(row: any): any;
     dateToStr(field: IBandDataField, v: Date): string;
@@ -2495,8 +2524,11 @@ declare abstract class DataBand extends ReportGroupItem {
     static readonly PROP_DATA_BAND_END_ROW_COUNT = "endRowCount";
     static readonly PROP_DATA_BAND_MAX_END_ROW_COUNT = "maxEndRowCount";
     static readonly PROP_DATA_BAND_END_ROW_MESSAGE = "endRowMessage";
+    static readonly PROP_DATA_BAND_REPEAT_HEADER = "repeatHeader";
     static readonly PROP_DATA_BAND_ALWAYS_HEADER = "alwaysHeader";
     static readonly PROP_DATA_BAND_NO_SPLIT = "noSplit";
+    static readonly PROP_DATA_BAND_SORT_FIELD = "sortField";
+    static readonly PROP_DATA_BAND_SORT_DIRECTION = "sortDirection";
     static readonly PROPINFOS: IPropInfo[];
     private _sectionCount;
     private _sectionLayout;
@@ -2513,8 +2545,11 @@ declare abstract class DataBand extends ReportGroupItem {
     private _repeatMastreRow;
     private _repeatDetailHeader;
     private _repeatDetailFooter;
+    private _repeatHeader;
     private _alwaysHeader;
     private _noSplit;
+    private _sortField;
+    private _sortDirection;
     private _detail;
     private _master;
     private _keyFlds;
@@ -2525,11 +2560,14 @@ declare abstract class DataBand extends ReportGroupItem {
     rowIndex: number;
     detailRows: number;
     masterValues: any;
+    isNextPagePrintRow: boolean;
+    _pr: number;
+    _currentPrintRow: number;
     private _dataObj;
     private _designData;
     private _fieldSummary;
     private _summaryRuntime;
-    _pr: number;
+    private _dataView;
     constructor(name: string);
     get dataObj(): IBandData;
     get designData(): IBandData;
@@ -2667,6 +2705,11 @@ declare abstract class DataBand extends ReportGroupItem {
      */
     get repeatDetailFooter(): boolean;
     set repeatDetailFooter(value: boolean);
+    /**
+     * 첫번째 밴드 헤더를 출력 후 장을 넘어갈 때 반복해서 헤더를 표시한다.
+     */
+    get repeatHeader(): boolean;
+    set repeatHeader(value: boolean);
     /**
      * true면 데이터행 없이 footer만 표시되는 경우에도 header를 표시한다.
      */
@@ -2677,20 +2720,31 @@ declare abstract class DataBand extends ReportGroupItem {
      */
     get noSplit(): boolean;
     set noSplit(value: boolean);
+    get sortField(): string;
+    set sortField(value: string);
+    get sortDirection(): DataDirection;
+    set sortDirection(value: DataDirection);
     /**
      * summary runtime
      */
     get summaryRuntime(): DataBandSummaryRuntime;
+    /**
+     * Data View Model
+     */
+    get dataView(): BandDataView;
+    /**
+     * current Print Row Index
+     */
+    get currentPrintRow(): number;
+    set currentPrintRow(value: number);
     prepareIndices(ctx: PrintContext): void;
     protected abstract _doPrepareIndices(ctx: PrintContext): void;
     getColPoints(w: number, x?: number): number[];
     getColWidth(w: number): number;
-    getValues(ctx: PrintContext, row: number, fields: string[]): any[];
-    protected _selectRow(data: IBandData, row: number, idx: number): boolean;
-    abstract getNextDetailRows(ctx: PrintContext): number[];
-    protected _getNextDetailRows(ctx: PrintContext, from: number): number[];
-    abstract skipDetailRows(ctx: PrintContext): void;
-    protected _skipDetailRows(ctx: PrintContext, from: number): number;
+    getValues(dataView: BandDataView, row: number, fields: string[]): any[];
+    protected _selectRow(dataView: BandDataView, row: number, idx: number): boolean;
+    abstract getNextDetailRows(dataView: BandDataView, from?: number): number[];
+    protected _getNextDetailRows(dataView: BandDataView, from: number): number[];
     getRowsPerPage(): {
         rowsPerPage: number;
         breakRowsPerPage: boolean;
@@ -3056,8 +3110,7 @@ declare class TableBand extends DataBand {
     protected _doPreparePrint(ctx: PrintContext): void;
     protected _doPrepareIndices(ctx: PrintContext): void;
     remove(item: ReportPageItem): void;
-    getNextDetailRows(ctx: PrintContext): number[];
-    skipDetailRows(ctx: PrintContext): void;
+    getNextDetailRows(dataView: BandDataView, from?: number): number[];
     containsInSection(item: ReportItem): boolean;
 }
 
@@ -3331,8 +3384,7 @@ declare class SimpleBand extends DataBand {
     protected _doPreparePrint(ctx: PrintContext): void;
     protected _doPrepareIndices(ctx: PrintContext): void;
     canRemove(item: ReportItem): boolean;
-    getNextDetailRows(ctx: PrintContext): number[];
-    skipDetailRows(ctx: PrintContext): void;
+    getNextDetailRows(dataView: BandDataView, from?: number): number[];
     containsInSection(item: ReportItem): boolean;
 }
 
@@ -3460,7 +3512,13 @@ declare abstract class ReportItemElement<T extends ReportItem> extends ReportEle
     getEditText(): string;
     setEditText(report: Report, text: string): void;
     refreshPrintValues(ctx: PrintContext): void;
-    get printable(): boolean;
+    /**
+     * - ReportItem에 visibileCallback 핸들러가 정의되어 있다면 핸들러의 반환값에 의해 아이템 표시여부 결정
+     * - 핸들러가 정의되어 있지 않거나 반환값이 boolean 값이 아닐경우 기존 아이템 속성의 Visible 값으로 표시여부 결정
+     * @param {PrintContext} ctx - PrintContext 객체 정보
+     * @returns {boolean}
+     */
+    isPrintable(ctx: PrintContext): boolean;
     protected _getModel(): T;
     protected _initDom(doc: Document, dom: HTMLElement): void;
     protected _setBindMarker(visible?: boolean, system?: boolean): void;
@@ -5175,6 +5233,7 @@ type ReportItemValueCallback = (ctx: PrintContext, item: ReportItem, row: number
 type ReportItemStyleCallback = (ctx: PrintContext, item: ReportItem, row: number, value: any) => {
     [key: string]: string | undefined;
 };
+type ReportItemVisibleCallback = (ctx: PrintContext, item: ReportItem, row: number, value: any) => boolean;
 /**
  * Report 구성 요소 기반 클래스.
  *
@@ -5194,6 +5253,7 @@ declare abstract class ReportItem extends ReportPageItem {
     static readonly PROP_BOTTOM = "bottom";
     static readonly PROP_DESIGN_BORDER = "designBorder";
     static readonly PROP_ON_GET_VALUE = "onGetValue";
+    static readonly PROP_ON_GET_VISIBLE = "onGetVisible";
     static readonly PROP_STYLES = "styles";
     static readonly PROP_ON_GET_STYLES = "onGetStyles";
     static readonly PROP_VISIBLE = "visible";
@@ -5246,6 +5306,8 @@ declare abstract class ReportItem extends ReportPageItem {
     private _name;
     private _tag;
     private _visible;
+    private _visibleCallback;
+    private _onGetVisible;
     private _data;
     private _value;
     private _valueCallback;
@@ -5274,6 +5336,8 @@ declare abstract class ReportItem extends ReportPageItem {
     private _valueCallbackDelegate;
     private _styleCallbackFunc;
     private _styleCallbackDelegate;
+    private _visibleCallbackFunc;
+    private _visibleCallbackDelegate;
     private _leftDim;
     private _rightDim;
     private _topDim;
@@ -5423,6 +5487,14 @@ declare abstract class ReportItem extends ReportPageItem {
     /** valueCallback */
     get valueCallback(): ReportItemValueCallback;
     set valueCallback(value: ReportItemValueCallback);
+    /**
+     * onGetVisible
+     */
+    get onGetVisible(): string;
+    set onGetVisible(value: string);
+    /** visibleCallback */
+    get visibleCallback(): ReportItemVisibleCallback;
+    set visibleCallback(value: ReportItemVisibleCallback);
     /** styles */
     get styles(): Styles;
     set styles(value: Styles);
@@ -5572,6 +5644,7 @@ declare abstract class ReportItem extends ReportPageItem {
      */
     getPrintValue(dp: IReportDataProvider, row: number): any;
     getLinkValue(dp: IReportDataProvider, row: number): any;
+    getDataViewValue(dv: BandDataView, row: number): any;
     protected _getParentData(): string;
     canRemoveFrom(): boolean;
     canAdoptDragSource(source: any): boolean;
@@ -6789,6 +6862,16 @@ declare class PrintContext extends Base$1 {
     saveBand(): void;
     restoreBand(): void;
     getBaseView(view: InheritableSectionElement<any>, viewType: string): InheritableSectionElement<any>;
+    /**
+     * - 현재 출력중인 data row를 반환
+     * @returns 0부터 시작하며 현재 출력중인 band의 row index 반환
+     */
+    getPrintingRow(): number;
+    /**
+     * - 정렬 적용 후에도 onGetValue, onGetStyles 이벤트에서 사용하는 row 인자에 원본 데이터의 index를 반환하기 위해 작성
+     * @returns 원본 데이터의 index 반환
+     */
+    getSourceIndex(): number;
 }
 type ContextValueCallback = (ctx: PrintContext) => any;
 declare class PageBreaker {
@@ -6845,6 +6928,7 @@ interface IReportData {
     getSaveType(): string;
     getSaveValues(): any;
     getValue(path: string): any;
+    getValues(): any[];
 }
 interface IReportDataProvider {
     designTime?: boolean;
@@ -6883,6 +6967,7 @@ declare class SimpleData extends ReportData$1 implements IReportData {
      * TODO: array index
      */
     getValue(path?: string): any;
+    getValues(): any;
     get sample(): any;
     setSample(values: any): void;
     getFieldNames(): string[];
@@ -6903,6 +6988,8 @@ interface IPreviewOptions {
     noScroll?: boolean;
     noIndicator?: boolean;
     singlePage?: boolean;
+    singlePageOptions?: ISinglePageOptions;
+    align?: Align;
     callback?: PrintPageCallback;
     endCallback?: PrintEndCallback;
 }
@@ -6913,6 +7000,9 @@ interface IPrintOptions {
     id?: string;
     previewOptions?: IPreviewOptions;
 }
+interface ISinglePageOptions {
+    border: boolean;
+}
 declare class PrintContainer extends VisualContainer$1 {
     static readonly CLASS_NAME = "rr-report-container";
     static readonly PREVIEW_CLASS = "rr-report-preview";
@@ -6948,6 +7038,8 @@ declare class PrintContainer extends VisualContainer$1 {
     get zoom(): number;
     set zoom(value: number);
     get pages(): PrintPage[];
+    get align(): Align;
+    set align(value: Align);
     print(options: IPrintOptions): void;
     printSingle(options: IPrintOptions): void;
     printAll(options: IPrintOptions): void;
@@ -41100,25 +41192,36 @@ declare type GridReportLayout = {
  * 리포트 프리뷰 옵션
  */
 declare type PreviewOptions = {
-    /**
-     * 리포트간 간격 조절 옵션
-     */
-    pageGap?: number;
     /**
      * 비동기 출력 여부
-     * default: false;
+     * @defaultValue `false`
      */
     async?: boolean;
     /**
      * 비동기 출력시 출력 페이지 마커 표시 여부
-     * default: false;
+     * @defaultValue `false`
      */
     pageMark?: boolean;
     /**
      * 비동기 출력시 출력 페이지마다 스크롤 이동 여부
-     * default: true;
+     * @defaultValue `true`
      */
     noScroll?: boolean;
+    /**
+     * 리포트 컨테이너에 페이지 정렬 설정
+     * @defaultValue `Align.CENTER`
+     */
+    align?: Align;
+    /**
+     * 리포트를 한장에 여백없이 출력하는 옵션
+     * @defaultValue `false`
+     */
+    singlePage?: boolean;
+    /**
+     * 싱글 페이지일 경우 관련 옵션
+     * @defaultValue `{ border: true }`
+     */
+    singlePageOptions?: ISinglePageOptions;
     /**
      * 미리보기가 시작될때 호출되는 콜백함수
      */