npm - realmap - Versions diffs - 1.1.8 → 1.1.10 - Mend

@@ -584,6 +584,16 @@ interface MapSource {
         border: MapBorderSource;
         closed?: boolean;
     }];
+    /**
+     * 지도의 표시 경계를 수동으로 지정한다.<br/>
+     * [최소 경도, 최소 위도, 최대 경도, 최대 위도] 형태로 지정한다.<br/>
+     * - bounds와 지도(url/source) 모두 지정되면 bounds가 경계가 된다. (지도가 작으면 덜 그려지고, 더 크면 clip됨)
+     * - bounds만 지정되고 지도가 없으면 bounds가 경계가 된다.
+     * - 둘 다 지정하지 않으면 지도 폴리곤에서 자동 계산된 경계를 사용한다.
+     *
+     * 주의: Orthographic Projection을 사용하는 경우, 해당 옵션은 무시된다.
+     */
+    bounds?: [number, number, number, number];
 }
 declare abstract class MapSourceItem {
     id: string;
@@ -624,6 +634,7 @@ declare abstract class MapSourceImpl extends RmObject {
     readonly externals: boolean;
     readonly alignArctic: boolean;
     readonly borders: MapBorderInfo[];
+    readonly bounds: [number, number, number, number] | undefined;
     items: MapSourceItem[];
     insets: {
         [area: string]: MapInset;
@@ -5496,7 +5507,7 @@ declare class SvgRichText {
     constructor(format?: string);
     setFormat(value: string): void;
     lines(): SvgLine[];
-    build(view: TextElement, maxWidth: number, maxHeight: number, target: any, domain: IRichTextDomain): void;
+    build(view: TextElement, maxWidth: number, maxHeight: number, target: any, domain: IRichTextDomain, prefixSuffixEnabled?: boolean): void;
     layout(tv: TextElement, align: Align, width: number, height: number, pad: Sides): void;
     $_parse(fmt: string): void;
 }
@@ -5904,6 +5915,15 @@ declare class MapModel extends RmObject {
      */
     private $_preflight;
     private $_resetAreas;
+    private $_hasArea;
+    /**
+     * 전 세계 범위(-180~180)로 경계 설정
+     */
+    private $_setBoundaryByWorld;
+    /**
+     * map.bounds 옵션으로 지도 경계를 설정하는 메서드
+     */
+    private $_setBoundsByOption;
     private $_updateMainAreaBounds;
     private $_load;
     private $_copy;
@@ -6137,7 +6157,10 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
     findAll(condition: {
         [key: string]: any;
     }): DataPoint[];
-    getPointText(p: DataPoint, index: number, label: any): string;
+    getPointText(p: DataPoint, index: number, label: any): {
+        label: string;
+        isCallbackExecuted: boolean;
+    };
     getPointArgs(p: DataPoint): DataPointArgs;
     getPointStyle(p: DataPoint): SVGStyleOrClass;
     getPointLabelStyle(p: DataPoint): SVGStyleOrClass;
@@ -7972,6 +7995,16 @@ declare class ChartGlobal extends ChartItem<ChartGlobalOptions> {
  * 시리즈가 하나도 설정되지 않으면(visible과 상관없이) data가 연결되지 않은 빈 'map' 시리즈를 표시한다.
  */
 declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IChart, IMapOwner, IAnnotationOwner, ITooltipOwner, ISelectionOwner {
+    /**
+     * map.bounds로 경계를 설정하는 경우 자동으로 격자(AxisGrid)를 표시하는데,
+     * 이 때 경계의 크기 차이인 diff를 기준으로 격자의 간격(step)을 결정한다.
+     */
+    private static readonly ZOOM_STEP_MAP;
+    /**
+     * 지도 영역이 너무 넓어 ZOOM_STEP_MAP의 최대치를 초과하는 경우
+     * (예: 전 세계 지도) 또는 투영법이 orthographic일 때 기본으로 적용할 격자 간격
+     */
+    private static readonly DEFAULT_GRID_STEP;
     private static defaults;
     _wrapper: any;
     _op: ChartConfiguration;
@@ -8013,6 +8046,7 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     _loadAnimatable: boolean;
     width: number;
     height: number;
+    _globalMapBound: MapBounds;
     lockOptionsDirty(): void;
     freeOptionsDirty(): void;
     constructor(config?: ChartConfiguration, wrapper?: any);
@@ -8047,6 +8081,10 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     get type(): "map" | "point" | "line" | "figure" | "image" | "bar" | "pie" | "waffle" | "bubble" | "route" | "feature" | "pin" | "vector" | "heatmap" | "panel" | "gauge" | "clock";
     get legend(): Legend;
     get credits(): Credits;
+    /**
+     * 전체 map의 통합 경계 정보
+     */
+    get globalMapBound(): MapBounds;
     /**
      * map model.
      */
@@ -8088,6 +8126,12 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     loadBase(source: any, model: string, type: string): any;
     private _setProperties;
     _load(config: ChartConfiguration): this;
+    /**
+     * 설정된 지도가 없어서 더미 MapModel이 설정되었거나, 지도에 지역 정보가 하나도 없는 경우, 자동으로 격자선을 그리도록 설정을 수정하는 메서드.
+     * 사용자가 매우 좁은 경계(map.bounds)를 설정한 경우(예: 폭 1도 미만), 기본 격자 단위인 10도(step=10)로는 선이 1개도 보이지 않음
+     * 경계에 맞는 간격으로 격자 설정. normalizedMap이 단일 객체로 변환된 경우도 포함한다
+     */
+    private $_resolveGrid;
     private $_loadTemplates;
     prepareRender(): void;
     afterRender(): void;
@@ -8113,11 +8157,25 @@ declare class ChartObject extends RmEventProvider<IMapChartEvents> implements IC
     click(info: any): void;
     pointToMap(x: number, y: number): MapCoord;
     private $_buildWidgetGroups;
+    /**
+     * 모든 MapModel의 경계좌표를 합쳐서 전체 지도의 좌표 범위를 구한다.
+     */
+    private $_resetGlobalMapBound;
     _visibleChanged(item: ChartItem): void;
     _hoverAreaChanged(series: Series, newArea: MapArea, oldArea: MapArea): void;
     _areaClicked(series: Series, area: MapArea): void;
 }
+interface MapBounds {
+    x1: number;
+    x2: number;
+    y1: number;
+    y2: number;
+    h1: number;
+    h2: number;
+    v1: number;
+    v2: number;
+}
 interface IChart {
     wrapper: any;
     options: ChartConfiguration;
@@ -8137,6 +8195,7 @@ interface IChart {
     firstVisible: Series;
     firstMapSeries: Series;
     isDirty: boolean;
+    globalMapBound: MapBounds;
     mapAt(index: number): MapModel;
     mapByName(name: string): MapModel;
     getMap(nameOrIndex: string | number): MapModel;
@@ -8318,7 +8377,7 @@ declare class ChartText<OP extends ChartTextOptions = ChartTextOptions> extends
     private _setText;
     isVisible(): boolean;
     setText(value: string): void;
-    buildSvg(view: TextElement, outline: TextElement, maxWidth: number, maxHeight: number, target: any, domain: IRichTextDomain): void;
+    buildSvg(view: TextElement, outline: TextElement, maxWidth: number, maxHeight: number, target: any, domain: IRichTextDomain, preSuffixEnabled?: boolean): void;
     prepareRich(text: string): void;
     protected _doSetSimple(op: OP, src: any): boolean;
     protected _doApply(op: OP): void;
@@ -9280,6 +9339,11 @@ declare abstract class SeriesView<T extends Series = Series> extends ChartElemen
     constructor(doc: Document, className: string, needLabels: boolean, useDefs: boolean);
     $_setInRegion(): this;
     needClip(): boolean;
+    /**
+     * bounds 기반 clip을 반환한다. 기본 구현은 BodyView에서 전달된 clip(투영 클리핑)을 그대로 반환한다.
+     * MapSeriesView에서 오버라이드하여 각 맵 시리즈의 bounds에 맞는 clip을 반환한다.
+     */
+    resolveBoundsClip(fallback: ClipElement | null, _scale: number, _tx: number, _ty: number, _prj: MapProjection): ClipElement | null;
     secondLabelContainer(): LayerElement;
     protected _setCalcedColor(model: T, dom: Element): void;
     protected _setModelColor(color: string): void;
@@ -9425,6 +9489,7 @@ declare class MapSeriesView extends SeriesView<MapSeries> {
     private static readonly DefaultHoverFilter;
     private static readonly DefaultHoverStrokeWidth;
     private _hoverArea;
+    private _boundsClip;
     private _internalContainer;
     private _externalContainer;
     private _borderContainer;
@@ -9444,6 +9509,11 @@ declare class MapSeriesView extends SeriesView<MapSeries> {
     areaOfDom(dom: Element): AreaView;
     getIntersectedAreas(rect: SVGGeometryElement): AreaView[];
     needClip(): boolean;
+    /**
+     * 이 시리즈의 맵에 bounds가 설정된 경우, 해당 bounds 기준의 SVG clip-path를 생성해 반환한다.
+     * bounds가 없거나 세계 전체 범위인 경우 BodyView에서 전달된 투영 clip(fallback)을 그대로 반환한다.
+     */
+    resolveBoundsClip(fallback: ClipElement | null, scale: number, tx: number, ty: number, prj: MapProjection): ClipElement | null;
     secondLabelContainer(): LayerElement;
     protected _getPointPool(): PointViewPool<PointElement>;
     protected _setModelColor(color: string): void;

@@ -1,6 +1,6 @@
 /**
- * RealMap Band v1.1.8
+ * RealMap Band v1.1.10
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved.
  */

@@ -1,6 +1,6 @@
 /**
- * RealMap Band v1.1.8
+ * RealMap Band v1.1.10
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved.
  */

@@ -1,6 +1,6 @@
 /**
- * RealMap Chart v1.1.8
+ * RealMap Chart v1.1.10
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved.
  */

@@ -1,6 +1,6 @@
 /**
- * RealMap Chart v1.1.8
+ * RealMap Chart v1.1.10
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved.
  */

@@ -1,6 +1,6 @@
 /**
- * RealMap Design v1.1.8
+ * RealMap Design v1.1.10
  * Copyright (C) 2023-2026 WooriTech Inc.
  * All Rights Reserved.
  */

realmap 1.1.8 → 1.1.10