@visactor/vchart-extension 2.1.0-alpha.14 → 2.1.0-alpha.15

package/cjs/charts/storyline/storyline-transformer.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.StorylineChartSpecTransformer = void 0;
+
+const vchart_1 = require("@visactor/vchart"), common_1 = require("./layouts/common"), clock_1 = require("./layouts/clock"), default_1 = require("./layouts/default"), landscape_1 = require("./layouts/landscape"), portrait_1 = require("./layouts/portrait"), dome_1 = require("./layouts/dome"), bowl_1 = require("./layouts/bowl");
+
+class StorylineChartSpecTransformer extends vchart_1.CommonChartSpecTransformer {
+    transformSpec(spec) {
+        var _a;
+        applyDefaultPadding(spec);
+        const storylineSpec = Object.assign(Object.assign({}, spec), {
+            data: [ ...null !== (_a = spec.data) && void 0 !== _a ? _a : [] ]
+        });
+        spec.type = "common", spec.data = [], spec.series = [], spec.axes = [], spec.customMark = buildStorylineMarks(storylineSpec), 
+        delete spec.layout, delete spec.title, super.transformSpec(spec);
+    }
+}
+
+exports.StorylineChartSpecTransformer = StorylineChartSpecTransformer;
+
+const applyDefaultPadding = spec => {
+    var _a, _b, _c, _d;
+    const DEFAULT_OTHER = 20, p = spec.padding;
+    if (null != p) if ("number" != typeof p) if (Array.isArray(p)) {
+        const [t = DEFAULT_OTHER, r = DEFAULT_OTHER, b, l = DEFAULT_OTHER] = p;
+        spec.padding = [ t, r, null != b ? b : 100, l ];
+    } else "object" == typeof p && (spec.padding = {
+        top: null !== (_a = p.top) && void 0 !== _a ? _a : DEFAULT_OTHER,
+        right: null !== (_b = p.right) && void 0 !== _b ? _b : DEFAULT_OTHER,
+        bottom: null !== (_c = p.bottom) && void 0 !== _c ? _c : 100,
+        left: null !== (_d = p.left) && void 0 !== _d ? _d : DEFAULT_OTHER
+    }); else spec.padding = [ p, p, Math.max(p, 100), p ]; else spec.padding = [ DEFAULT_OTHER, DEFAULT_OTHER, 100, DEFAULT_OTHER ];
+}, buildStorylineMarks = spec => {
+    var _a;
+    const lineMark = buildLineMark(spec), blockMarks = (null !== (_a = spec.data) && void 0 !== _a ? _a : []).map(((block, index) => buildBlockMark(spec, block, index)));
+    if ((0, common_1.isLandscape)(spec)) return [ ...blockMarks, lineMark ].filter(Boolean);
+    if ((0, common_1.isPortrait)(spec)) return [ lineMark, ...blockMarks ].filter(Boolean);
+    if ((0, common_1.isDome)(spec)) {
+        return [ (0, dome_1.buildDomeCenterImageMark)(spec), (0, dome_1.buildDomeArcMark)(spec), ...blockMarks ].filter(Boolean);
+    }
+    if ((0, common_1.isBowl)(spec)) {
+        return [ (0, bowl_1.buildBowlCenterImageMark)(spec), (0, bowl_1.buildBowlArcMark)(spec), ...blockMarks ].filter(Boolean);
+    }
+    if ((0, common_1.isClock)(spec)) {
+        const ringsMark = (0, clock_1.buildClockArcMark)(spec), centerImageMark = (0, clock_1.buildClockCenterImageMark)(spec);
+        return [ ringsMark, ...blockMarks, centerImageMark ].filter(Boolean);
+    }
+    return [ lineMark, ...blockMarks ].filter(Boolean);
+}, buildLineMark = spec => {
+    var _a, _b, _c;
+    return !1 === (null === (_a = spec.line) || void 0 === _a ? void 0 : _a.visible) || (null !== (_c = null === (_b = spec.data) || void 0 === _b ? void 0 : _b.length) && void 0 !== _c ? _c : 0) <= 1 ? null : (0, 
+    common_1.isLandscape)(spec) ? (0, landscape_1.buildLandscapeConnectingCurve)(spec) : (0, 
+    common_1.isPortrait)(spec) ? (0, portrait_1.buildPortraitAxisMark)(spec) : (0, default_1.buildDefaultLineMark)(spec);
+}, buildBlockMark = (spec, block, index) => (0, common_1.isLandscape)(spec) ? (0, 
+landscape_1.buildLandscapeBlockMark)(spec, block, index) : (0, common_1.isPortrait)(spec) ? (0, 
+portrait_1.buildPortraitBlockMark)(spec, block, index) : (0, common_1.isDome)(spec) ? (0, 
+dome_1.buildDomeBlockMark)(spec, block, index) : (0, common_1.isBowl)(spec) ? (0, 
+bowl_1.buildBowlBlockMark)(spec, block, index) : (0, common_1.isClock)(spec) ? (0, 
+clock_1.buildClockBlockMark)(spec, block, index) : (0, default_1.buildDefaultBlockMark)(spec, block, index);
+//# sourceMappingURL=storyline-transformer.js.map

package/cjs/charts/storyline/storyline-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/charts/storyline/storyline-transformer.ts"],"names":[],"mappings":"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","file":"storyline-transformer.js","sourcesContent":["import { CommonChartSpecTransformer, type IExtensionGroupMarkSpec } from '@visactor/vchart';\nimport type { IStorylineBlock, IStorylineSpec } from './interface';\nimport { isBowl, isClock, isDome, isLandscape, isPortrait } from './layouts/common';\nimport { buildClockArcMark, buildClockBlockMark, buildClockCenterImageMark } from './layouts/clock';\nimport { buildDefaultBlockMark, buildDefaultLineMark } from './layouts/default';\nimport { buildLandscapeBlockMark, buildLandscapeConnectingCurve } from './layouts/landscape';\nimport { buildPortraitAxisMark, buildPortraitBlockMark } from './layouts/portrait';\nimport { buildDomeArcMark, buildDomeBlockMark, buildDomeCenterImageMark } from './layouts/dome';\nimport { buildBowlArcMark, buildBowlBlockMark, buildBowlCenterImageMark } from './layouts/bowl';\n\nexport class StorylineChartSpecTransformer extends CommonChartSpecTransformer<any> {\n  transformSpec(spec: any): void {\n    applyDefaultPadding(spec);\n    const storylineSpec = {\n      ...spec,\n      data: [...(spec.data ?? [])]\n    } as IStorylineSpec;\n\n    spec.type = 'common' as any;\n    spec.data = [];\n    spec.series = [];\n    spec.axes = [];\n    spec.customMark = buildStorylineMarks(storylineSpec);\n    delete spec.layout;\n    delete spec.title;\n    super.transformSpec(spec as any);\n  }\n}\n\n/**\n * 图表默认 padding：所有 storyline 布局底部默认留 100px，\n * 给 dome 的 centerImage / 其它布局的引导线留出呼吸空间。\n * 用户在 spec.padding 中显式指定的值会被保留，仅在缺省时生效。\n */\nconst applyDefaultPadding = (spec: any) => {\n  const DEFAULT_BOTTOM = 100;\n  const DEFAULT_OTHER = 20;\n  const p = spec.padding;\n  if (p === undefined || p === null) {\n    spec.padding = [DEFAULT_OTHER, DEFAULT_OTHER, DEFAULT_BOTTOM, DEFAULT_OTHER];\n    return;\n  }\n  if (typeof p === 'number') {\n    spec.padding = [p, p, Math.max(p, DEFAULT_BOTTOM), p];\n    return;\n  }\n  if (Array.isArray(p)) {\n    const [t = DEFAULT_OTHER, r = DEFAULT_OTHER, b, l = DEFAULT_OTHER] = p;\n    spec.padding = [t, r, b ?? DEFAULT_BOTTOM, l];\n    return;\n  }\n  if (typeof p === 'object') {\n    spec.padding = {\n      top: p.top ?? DEFAULT_OTHER,\n      right: p.right ?? DEFAULT_OTHER,\n      bottom: p.bottom ?? DEFAULT_BOTTOM,\n      left: p.left ?? DEFAULT_OTHER\n    };\n  }\n};\n\nconst buildStorylineMarks = (spec: IStorylineSpec) => {\n  const lineMark = buildLineMark(spec);\n  const blockMarks = (spec.data ?? []).map((block, index) => buildBlockMark(spec, block, index));\n  // landscape：连接曲线绘制在所有 block 之上，避免被 image 遮挡\n  if (isLandscape(spec)) {\n    return [...blockMarks, lineMark].filter(Boolean) as IExtensionGroupMarkSpec[];\n  }\n  // portrait：lineMark 是中轴 rect，作为底层背景先绘制\n  if (isPortrait(spec)) {\n    return [lineMark, ...blockMarks].filter(Boolean) as IExtensionGroupMarkSpec[];\n  }\n  // dome：先绘制 centerImage（最底层视觉锚点），再绘制贯穿 block 的弧线，最后绘制 block；\n  // dome 不绘制 block 之间默认的连接线\n  if (isDome(spec)) {\n    const centerImageMark = buildDomeCenterImageMark(spec);\n    const arcMark = buildDomeArcMark(spec);\n    return [centerImageMark, arcMark, ...blockMarks].filter(Boolean) as IExtensionGroupMarkSpec[];\n  }\n  // bowl：dome 的上下镜像 —— centerImage 贴顶，弧线 + block 在下方\n  if (isBowl(spec)) {\n    const centerImageMark = buildBowlCenterImageMark(spec);\n    const arcMark = buildBowlArcMark(spec);\n    return [centerImageMark, arcMark, ...blockMarks].filter(Boolean) as IExtensionGroupMarkSpec[];\n  }\n  // clock：辐射式信息盘 —— 圆环骨架 + 径向分隔线 → centerImage（盘心）→ blocks（楔形 + 外圈文字）\n  if (isClock(spec)) {\n    const ringsMark = buildClockArcMark(spec);\n    const centerImageMark = buildClockCenterImageMark(spec);\n    return [ringsMark, ...blockMarks, centerImageMark].filter(Boolean) as IExtensionGroupMarkSpec[];\n  }\n  return [lineMark, ...blockMarks].filter(Boolean) as IExtensionGroupMarkSpec[];\n};\n\nconst buildLineMark = (spec: IStorylineSpec): IExtensionGroupMarkSpec | null => {\n  if (spec.line?.visible === false || (spec.data?.length ?? 0) <= 1) {\n    return null;\n  }\n  if (isLandscape(spec)) {\n    return buildLandscapeConnectingCurve(spec);\n  }\n  if (isPortrait(spec)) {\n    return buildPortraitAxisMark(spec);\n  }\n  return buildDefaultLineMark(spec);\n};\n\nconst buildBlockMark = (spec: IStorylineSpec, block: IStorylineBlock, index: number): IExtensionGroupMarkSpec => {\n  if (isLandscape(spec)) {\n    return buildLandscapeBlockMark(spec, block, index);\n  }\n  if (isPortrait(spec)) {\n    return buildPortraitBlockMark(spec, block, index);\n  }\n  if (isDome(spec)) {\n    return buildDomeBlockMark(spec, block, index);\n  }\n  if (isBowl(spec)) {\n    return buildBowlBlockMark(spec, block, index);\n  }\n  if (isClock(spec)) {\n    return buildClockBlockMark(spec, block, index);\n  }\n\n  return buildDefaultBlockMark(spec, block, index);\n};\n"]}

package/cjs/charts/storyline/storyline.d.ts

@@ -0,0 +1,16 @@
+import { BaseChart, VChart } from '@visactor/vchart';
+import type { IStorylineSpec } from './interface';
+import { StorylineChartSpecTransformer } from './storyline-transformer';
+export declare class StorylineChart<T extends IStorylineSpec = IStorylineSpec> extends BaseChart<Omit<T, 'data' | 'title' | 'layout'>> {
+    type: string;
+    static type: string;
+    static readonly view: string;
+    _spec: T;
+    static readonly transformerConstructor: typeof StorylineChartSpecTransformer;
+    readonly transformerConstructor: typeof StorylineChartSpecTransformer;
+    init(): void;
+    protected isValid(): boolean;
+}
+export declare const registerStorylineChart: (option?: {
+    VChart?: typeof VChart;
+}) => void;

package/cjs/charts/storyline/storyline.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.registerStorylineChart = exports.StorylineChart = void 0;
+
+const vchart_1 = require("@visactor/vchart"), storyline_transformer_1 = require("./storyline-transformer");
+
+class StorylineChart extends vchart_1.BaseChart {
+    constructor() {
+        super(...arguments), this.type = "storyline", this.transformerConstructor = storyline_transformer_1.StorylineChartSpecTransformer;
+    }
+    init() {
+        this.isValid() && super.init();
+    }
+    isValid() {
+        var _a, _b;
+        const {data: data} = this._spec;
+        return !!Array.isArray(data) || (null === (_b = (_a = this._option).onError) || void 0 === _b || _b.call(_a, "Data is required and should be an array for storyline chart"), 
+        !1);
+    }
+}
+
+exports.StorylineChart = StorylineChart, StorylineChart.type = "storyline", StorylineChart.view = "singleDefault", 
+StorylineChart.transformerConstructor = storyline_transformer_1.StorylineChartSpecTransformer;
+
+const registerStorylineChart = option => {
+    (0, vchart_1.registerCommonChart)(), (0, vchart_1.registerCustomMark)(), (0, vchart_1.registerGroupMark)(), 
+    (0, vchart_1.registerRectMark)(), (0, vchart_1.registerTextMark)(), (0, vchart_1.registerImageMark)(), 
+    (0, vchart_1.registerLineMark)(), (0, vchart_1.registerPathMark)(), (0, vchart_1.registerArcMark)();
+    const vchartConstructor = (null == option ? void 0 : option.VChart) || vchart_1.VChart;
+    vchartConstructor && vchartConstructor.useChart([ StorylineChart ]);
+};
+
+exports.registerStorylineChart = registerStorylineChart;
+//# sourceMappingURL=storyline.js.map

package/cjs/charts/storyline/storyline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/charts/storyline/storyline.ts"],"names":[],"mappings":";;;AAAA,6CAY0B;AAE1B,mEAAwE;AAExE,MAAa,cAA0D,SAAQ,kBAE9E;IAFD;;QAGE,SAAI,GAAG,WAAW,CAAC;QAOV,2BAAsB,GAAG,qDAA6B,CAAC;IAiBlE,CAAC;IAfC,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE;YACnB,OAAO;SACR;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;IACf,CAAC;IAES,OAAO;;QACf,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACxB,MAAA,MAAA,IAAI,CAAC,OAAO,EAAC,OAAO,mDAAG,6DAA6D,CAAC,CAAC;YACtF,OAAO,KAAK,CAAC;SACd;QACD,OAAO,IAAI,CAAC;IACd,CAAC;;AA1BH,wCA2BC;AAvBQ,mBAAI,GAAG,WAAW,CAAC;AACV,mBAAI,GAAW,eAAe,CAAC;AAI/B,qCAAsB,GAAG,qDAA6B,CAAC;AAoBlE,MAAM,sBAAsB,GAAG,CAAC,MAAmC,EAAE,EAAE;IAC5E,IAAA,4BAAmB,GAAE,CAAC;IACtB,IAAA,2BAAkB,GAAE,CAAC;IACrB,IAAA,0BAAiB,GAAE,CAAC;IACpB,IAAA,yBAAgB,GAAE,CAAC;IACnB,IAAA,yBAAgB,GAAE,CAAC;IACnB,IAAA,0BAAiB,GAAE,CAAC;IACpB,IAAA,yBAAgB,GAAE,CAAC;IACnB,IAAA,yBAAgB,GAAE,CAAC;IACnB,IAAA,wBAAe,GAAE,CAAC;IAElB,MAAM,iBAAiB,GAAG,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,KAAI,eAAM,CAAC;IACnD,IAAI,iBAAiB,EAAE;QACrB,iBAAiB,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;KAC9C;AACH,CAAC,CAAC;AAfW,QAAA,sBAAsB,0BAejC","file":"storyline.js","sourcesContent":["import {\n  BaseChart,\n  VChart,\n  registerArcMark,\n  registerCommonChart,\n  registerCustomMark,\n  registerGroupMark,\n  registerImageMark,\n  registerLineMark,\n  registerPathMark,\n  registerRectMark,\n  registerTextMark\n} from '@visactor/vchart';\nimport type { IStorylineSpec } from './interface';\nimport { StorylineChartSpecTransformer } from './storyline-transformer';\n\nexport class StorylineChart<T extends IStorylineSpec = IStorylineSpec> extends BaseChart<\n  Omit<T, 'data' | 'title' | 'layout'>\n> {\n  type = 'storyline';\n  static type = 'storyline';\n  static readonly view: string = 'singleDefault';\n\n  declare _spec: T;\n\n  static readonly transformerConstructor = StorylineChartSpecTransformer;\n  readonly transformerConstructor = StorylineChartSpecTransformer;\n\n  init() {\n    if (!this.isValid()) {\n      return;\n    }\n    super.init();\n  }\n\n  protected isValid() {\n    const { data } = this._spec;\n    if (!Array.isArray(data)) {\n      this._option.onError?.('Data is required and should be an array for storyline chart');\n      return false;\n    }\n    return true;\n  }\n}\n\nexport const registerStorylineChart = (option?: { VChart?: typeof VChart }) => {\n  registerCommonChart();\n  registerCustomMark();\n  registerGroupMark();\n  registerRectMark();\n  registerTextMark();\n  registerImageMark();\n  registerLineMark();\n  registerPathMark();\n  registerArcMark();\n\n  const vchartConstructor = option?.VChart || VChart;\n  if (vchartConstructor) {\n    vchartConstructor.useChart([StorylineChart]);\n  }\n};\n"]}

package/cjs/components/map-label/map-label.d.ts

@@ -0,0 +1,52 @@
+import { type IGraphic, type IGroup, type IRect as IRectGraphic, MarkPoint } from '@visactor/vchart';
+import type { Maybe } from '@visactor/vchart';
+import { LayoutZIndex, VChart, BaseComponent } from '@visactor/vchart';
+import type { IRect, IPoint, Datum, IModelSpecInfo, PanEventParam, ICartesianSeries, IGeoSeries } from '@visactor/vchart';
+import type { IPairInfo } from './layout';
+import type { IMapLabelSpec, MapLabelSceneNodeMap } from './type';
+import { MapLabelSpecTransformer } from './map-label-transformer';
+export declare class MapLabelComponent extends BaseComponent<IMapLabelSpec> {
+    static type: string;
+    type: string;
+    name: string;
+    static specKey: string;
+    specKey: string;
+    static readonly transformerConstructor: any;
+    readonly transformerConstructor: typeof MapLabelSpecTransformer;
+    layoutType: 'none';
+    layoutZIndex: LayoutZIndex;
+    protected nameField: string;
+    protected valueField?: string;
+    protected _series: ICartesianSeries | IGeoSeries;
+    protected _map: any[];
+    protected _longitudeField: string;
+    protected _latitudeField: string;
+    protected _markerComponents: MarkPoint[];
+    private _activeDatum;
+    static getSpecInfo(chartSpec: any): Maybe<IModelSpecInfo[]>;
+    setAttrFromSpec(): void;
+    created(): void;
+    initRelatedInfo(): void;
+    initData(): void;
+    initEvent(): void;
+    handlePan(e: PanEventParam): void;
+    handleZoom(): void;
+    private _updateDatum;
+    dataToPosition(datum: any): IPoint;
+    updateLayoutAttribute(): void;
+    protected _updateMarkerLayoutAttribute(): void;
+    protected _evaluateMarker(data: Datum, index: number): {
+        pairInfo: IPairInfo;
+        contentMarks: Partial<Record<import("./type").IMapLabelNodes, IGraphic<Partial<import("@visactor/vrender-core").IGraphicAttribute>>>>;
+    };
+    protected _layoutMarkers(positionedRects: IRect[], contentMarks: MapLabelSceneNodeMap[]): void;
+    protected _renderMarkers(): void;
+    protected _layoutLabels(rects: IPairInfo[]): IRectGraphic[];
+    private _isRelativeModel;
+    private _isRelativeSeries;
+    protected _getNeedClearVRenderComponents(): IGraphic[];
+    getVRenderComponents(): IGroup[];
+}
+export declare const registerMapLabel: (option?: {
+    VChart?: typeof VChart;
+}) => void;

package/cjs/index.d.ts

@@ -17,6 +17,7 @@ export * from './charts/pictogram';
 export * from './charts/image-cloud';
 export * from './charts/candlestick';
 export * from './charts/timeline';
+export * from './charts/storyline';
 export * from './components/series-break';
 export * from './components/bar-link';
 export * from './components/series-label';

package/cjs/index.js

@@ -36,8 +36,8 @@ Object.defineProperty(exports, "register3DPlugin", {
     }
 }), __exportStar(require("./charts/pictogram"), exports), __exportStar(require("./charts/image-cloud"), exports), 
 __exportStar(require("./charts/candlestick"), exports), __exportStar(require("./charts/timeline"), exports), 
-__exportStar(require("./components/series-break"), exports), __exportStar(require("./components/bar-link"), exports), 
-__exportStar(require("./components/series-label"), exports), __exportStar(require("./components/map-label"), exports), 
-__exportStar(require("./components/regression-line"), exports), __exportStar(require("./components/scatter-regression-line"), exports), 
-__exportStar(require("./components/bar-regression-line"), exports), __exportStar(require("./components/histogram-regression-line"), exports), 
-__exportStar(require("./components/extension-mark-sync-state"), exports);
+__exportStar(require("./charts/storyline"), exports), __exportStar(require("./components/series-break"), exports), 
+__exportStar(require("./components/bar-link"), exports), __exportStar(require("./components/series-label"), exports), 
+__exportStar(require("./components/map-label"), exports), __exportStar(require("./components/regression-line"), exports), 
+__exportStar(require("./components/scatter-regression-line"), exports), __exportStar(require("./components/bar-regression-line"), exports), 
+__exportStar(require("./components/histogram-regression-line"), exports), __exportStar(require("./components/extension-mark-sync-state"), exports);

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,qEAAmD;AACnD,6DAA2C;AAC3C,uFAAqE;AACrE,qFAAmE;AACnE,yFAAuE;AAEvE,kDAAgC;AAChC,qDAAmC;AACnC,wDAAsC;AACtC,kDAAgC;AAChC,mEAAiD;AACjD,yDAAuC;AACvC,mDAAiC;AACjC,2DAAyC;AACzC,6CAAsD;AAA7C,0GAAA,gBAAgB,OAAA;AACzB,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,oDAAkC;AAElC,4DAA0C;AAC1C,wDAAsC;AACtC,4DAA0C;AAC1C,yDAAuC;AACvC,+DAA6C;AAC7C,uEAAqD;AACrD,mEAAiD;AACjD,yEAAuD;AACvD,yEAAuD","file":"index.js","sourcesContent":["export * from './charts/ranking-bar/ranking-bar';\nexport * from './charts/ranking-list/ranking-list';\nexport * from './charts/conversion-funnel';\nexport * from './charts/sequence-scatter-link/sequence-scatter-link';\nexport * from './charts/sequence-scatter-kde/sequence-scatter-kde';\nexport * from './charts/sequence-scatter-pixel/sequence-scatter-pixel';\n\nexport * from './charts/bar-3d';\nexport * from './charts/funnel-3d';\nexport * from './charts/histogram-3d';\nexport * from './charts/pie-3d';\nexport * from './charts/combination-candlestick';\nexport * from './charts/word-cloud-3d';\nexport * from './charts/axis-3d';\nexport * from './charts/range-column-3d';\nexport { register3DPlugin } from './charts/3d/plugin';\nexport * from './charts/pictogram';\nexport * from './charts/image-cloud';\nexport * from './charts/candlestick';\nexport * from './charts/timeline';\n\nexport * from './components/series-break';\nexport * from './components/bar-link';\nexport * from './components/series-label';\nexport * from './components/map-label';\nexport * from './components/regression-line';\nexport * from './components/scatter-regression-line';\nexport * from './components/bar-regression-line';\nexport * from './components/histogram-regression-line';\nexport * from './components/extension-mark-sync-state';\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,qEAAmD;AACnD,6DAA2C;AAC3C,uFAAqE;AACrE,qFAAmE;AACnE,yFAAuE;AAEvE,kDAAgC;AAChC,qDAAmC;AACnC,wDAAsC;AACtC,kDAAgC;AAChC,mEAAiD;AACjD,yDAAuC;AACvC,mDAAiC;AACjC,2DAAyC;AACzC,6CAAsD;AAA7C,0GAAA,gBAAgB,OAAA;AACzB,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,oDAAkC;AAClC,qDAAmC;AAEnC,4DAA0C;AAC1C,wDAAsC;AACtC,4DAA0C;AAC1C,yDAAuC;AACvC,+DAA6C;AAC7C,uEAAqD;AACrD,mEAAiD;AACjD,yEAAuD;AACvD,yEAAuD","file":"index.js","sourcesContent":["export * from './charts/ranking-bar/ranking-bar';\nexport * from './charts/ranking-list/ranking-list';\nexport * from './charts/conversion-funnel';\nexport * from './charts/sequence-scatter-link/sequence-scatter-link';\nexport * from './charts/sequence-scatter-kde/sequence-scatter-kde';\nexport * from './charts/sequence-scatter-pixel/sequence-scatter-pixel';\n\nexport * from './charts/bar-3d';\nexport * from './charts/funnel-3d';\nexport * from './charts/histogram-3d';\nexport * from './charts/pie-3d';\nexport * from './charts/combination-candlestick';\nexport * from './charts/word-cloud-3d';\nexport * from './charts/axis-3d';\nexport * from './charts/range-column-3d';\nexport { register3DPlugin } from './charts/3d/plugin';\nexport * from './charts/pictogram';\nexport * from './charts/image-cloud';\nexport * from './charts/candlestick';\nexport * from './charts/timeline';\nexport * from './charts/storyline';\n\nexport * from './components/series-break';\nexport * from './components/bar-link';\nexport * from './components/series-label';\nexport * from './components/map-label';\nexport * from './components/regression-line';\nexport * from './components/scatter-regression-line';\nexport * from './components/bar-regression-line';\nexport * from './components/histogram-regression-line';\nexport * from './components/extension-mark-sync-state';\n"]}

package/esm/charts/image-cloud/series/image-cloud.d.ts

@@ -0,0 +1,138 @@
+import type { IImageCloudSeriesSpec } from './interface';
+import { ImageCloudMarkNameEnum } from './constant';
+import type { IPoint } from '@visactor/vchart';
+import { createImage } from '@visactor/vchart';
+import type { Datum, IImageMark, IMark, IRectMark } from '@visactor/vchart';
+import { BaseSeries } from '@visactor/vchart';
+export declare class ImageCloudSeries<T extends IImageCloudSeriesSpec> extends BaseSeries<T> {
+    static readonly type: string;
+    type: string;
+    static readonly mark: {
+        image: {
+            name: ImageCloudMarkNameEnum;
+            type: import("@visactor/vchart").MarkTypeEnum;
+        };
+        imageMask: {
+            name: ImageCloudMarkNameEnum;
+            type: import("@visactor/vchart").MarkTypeEnum;
+        };
+        label?: import("@visactor/vchart").ISeriesMarkInfo;
+        point?: import("@visactor/vchart").ISeriesMarkInfo;
+        line?: import("@visactor/vchart").ISeriesMarkInfo;
+        area?: import("@visactor/vchart").ISeriesMarkInfo;
+        bar?: import("@visactor/vchart").ISeriesMarkInfo;
+        boxPlot?: import("@visactor/vchart").ISeriesMarkInfo;
+        outlier?: import("@visactor/vchart").ISeriesMarkInfo;
+        circlePacking?: import("@visactor/vchart").ISeriesMarkInfo;
+        group?: import("@visactor/vchart").ISeriesMarkInfo;
+        gridBackground?: import("@visactor/vchart").ISeriesMarkInfo;
+        grid?: import("@visactor/vchart").ISeriesMarkInfo;
+        dot?: import("@visactor/vchart").ISeriesMarkInfo;
+        title?: import("@visactor/vchart").ISeriesMarkInfo;
+        subTitle?: import("@visactor/vchart").ISeriesMarkInfo;
+        symbol?: import("@visactor/vchart").ISeriesMarkInfo;
+        funnel?: import("@visactor/vchart").ISeriesMarkInfo;
+        transform?: import("@visactor/vchart").ISeriesMarkInfo;
+        transformLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        outerLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        outerLabelLine?: import("@visactor/vchart").ISeriesMarkInfo;
+        pin?: import("@visactor/vchart").ISeriesMarkInfo;
+        pinBackground?: import("@visactor/vchart").ISeriesMarkInfo;
+        pointer?: import("@visactor/vchart").ISeriesMarkInfo;
+        segment?: import("@visactor/vchart").ISeriesMarkInfo;
+        track?: import("@visactor/vchart").ISeriesMarkInfo;
+        cell?: import("@visactor/vchart").ISeriesMarkInfo;
+        cellBackground?: import("@visactor/vchart").ISeriesMarkInfo;
+        link?: import("@visactor/vchart").ISeriesMarkInfo;
+        arrow?: import("@visactor/vchart").ISeriesMarkInfo;
+        pie?: import("@visactor/vchart").ISeriesMarkInfo;
+        labelLine?: import("@visactor/vchart").ISeriesMarkInfo;
+        progress?: import("@visactor/vchart").ISeriesMarkInfo;
+        minLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        maxLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        rose?: import("@visactor/vchart").ISeriesMarkInfo;
+        node?: import("@visactor/vchart").ISeriesMarkInfo;
+        sunburst?: import("@visactor/vchart").ISeriesMarkInfo;
+        nonLeaf?: import("@visactor/vchart").ISeriesMarkInfo;
+        leaf?: import("@visactor/vchart").ISeriesMarkInfo;
+        nonLeafLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        leaderLine?: import("@visactor/vchart").ISeriesMarkInfo;
+        stackLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        word?: import("@visactor/vchart").ISeriesMarkInfo;
+        fillingWord?: import("@visactor/vchart").ISeriesMarkInfo;
+        wordMask?: import("@visactor/vchart").ISeriesMarkInfo;
+        nodePoint?: import("@visactor/vchart").ISeriesMarkInfo;
+        ripplePoint?: import("@visactor/vchart").ISeriesMarkInfo;
+        centerPoint?: import("@visactor/vchart").ISeriesMarkInfo;
+        centerLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        barBackground?: import("@visactor/vchart").ISeriesMarkInfo;
+        lineLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        areaLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+        liquidGroup?: import("@visactor/vchart").ISeriesMarkInfo;
+        liquid?: import("@visactor/vchart").ISeriesMarkInfo;
+        liquidBackground?: import("@visactor/vchart").ISeriesMarkInfo;
+        liquidOutline?: import("@visactor/vchart").ISeriesMarkInfo;
+        circle?: import("@visactor/vchart").ISeriesMarkInfo;
+        overlap?: import("@visactor/vchart").ISeriesMarkInfo;
+        overlapLabel?: import("@visactor/vchart").ISeriesMarkInfo;
+    };
+    protected _urlField: string;
+    protected _nameField?: string;
+    protected _valueField?: string;
+    setValueField(field: string): void;
+    protected _imageMark?: IImageMark;
+    protected _maskMark?: IRectMark;
+    setAttrFromSpec(): void;
+    initMark(): void;
+    initMarkStyle(): void;
+    protected _initImageMarkStyle(): void;
+    protected isFillingImage(datum: Datum): boolean;
+    protected _initMaskMarkStyle(): void;
+    protected initTooltip(): void;
+    protected _imageCloudTransformOption(): {
+        size: () => number[];
+        image: {
+            field: string;
+        };
+        weight: {
+            field: string;
+        };
+        imageConfig: {
+            imageSize: number;
+            imageSizeRange: [number, number];
+            padding: number;
+        };
+        ratio: number;
+        mask: string | import("@visactor/vchart").TextShapeMask | import("@visactor/vchart").GeometricMaskShape;
+        maskConfig: {
+            visible?: boolean;
+            threshold?: number;
+            invert?: boolean;
+            removeWhiteBorder?: boolean;
+            style?: Partial<import("@visactor/vchart").IImageMarkSpec>;
+        };
+        layoutConfig: import("@visactor/vchart").LayoutConfigType;
+        createCanvas: (params: import("@visactor/vrender-core").ICreateCanvasParams) => any;
+        createImage: typeof createImage;
+        onUpdateMaskCanvas: (inputImage?: HTMLCanvasElement, maskImage?: HTMLCanvasElement) => void;
+        onLayoutFinished: () => void;
+    };
+    protected _buildMarkAttributeContext(): void;
+    initAnimation(): void;
+    getDimensionField(): string[];
+    getMeasureField(): string[];
+    getStatisticFields(): {
+        key: string;
+        operations: Array<'max' | 'min' | 'values'>;
+    }[];
+    getActiveMarks(): IMark[];
+    getMarkData(datum: Datum): any;
+    getGroupFields(): string[];
+    dataToPosition(data: Datum): IPoint | null;
+    dataToPositionX(data: Datum): number | null;
+    dataToPositionY(data: Datum): number | null;
+    valueToPosition(value1: any, value2?: any): null;
+    getStackGroupFields(): string[];
+    getStackValueField(): string;
+}
+export declare const registerImageCloudSeries: () => void;

package/esm/charts/storyline/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interface';
+export * from './layout';
+export * from './storyline';
+export * from './storyline-transformer';

package/esm/charts/storyline/index.js

@@ -0,0 +1,8 @@
+export * from "./interface";
+
+export * from "./layout";
+
+export * from "./storyline";
+
+export * from "./storyline-transformer";
+//# sourceMappingURL=index.js.map

package/esm/charts/storyline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/charts/storyline/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC","file":"index.js","sourcesContent":["export * from './interface';\nexport * from './layout';\nexport * from './storyline';\nexport * from './storyline-transformer';\n"]}

package/esm/charts/storyline/interface.d.ts

@@ -0,0 +1,59 @@
+import type { IChartSpec, IComposedTextMarkSpec, IImageMarkSpec, IMarkSpec, IPathMarkSpec, IRectMarkSpec, ITextMarkSpec, StringOrNumber } from '@visactor/vchart';
+export type StorylineLayoutType = 'clock' | 'bowl' | 'dome' | 'left-wing' | 'right-wing' | 'landscape' | 'portrait' | 'up-ladder' | 'down-ladder' | 'pulse' | 'spiral';
+export type StorylineImagePosition = 'top' | 'left' | 'right' | 'bottom';
+export type StorylineLineType = 'line' | 'polyline' | 'curve';
+export interface IStorylineBlock {
+    id?: StringOrNumber;
+    title?: string;
+    content?: string | string[];
+    image?: string | HTMLImageElement | HTMLCanvasElement;
+    datum?: unknown;
+}
+export interface IStorylineLayoutOptions {
+    type: StorylineLayoutType;
+    padding?: number | [number, number, number, number];
+    radiusRatio?: number;
+    startAngle?: number;
+    endAngle?: number;
+}
+export interface IStorylineBlockSpec {
+    width?: number;
+    widthRatio?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    height?: number;
+    padding?: number | [number, number, number, number];
+    gap?: number;
+    style?: Partial<IRectMarkSpec>;
+}
+export interface IStorylineImageSpec extends IMarkSpec<IImageMarkSpec> {
+    width?: number;
+    height?: number;
+    position?: StorylineImagePosition;
+    gap?: number;
+}
+export interface IStorylineCenterImageSpec extends IMarkSpec<IImageMarkSpec> {
+    width?: number;
+    height?: number;
+    visible?: boolean;
+    image?: string | HTMLImageElement | HTMLCanvasElement;
+}
+export interface IStorylineLineSpec extends IMarkSpec<IPathMarkSpec> {
+    visible?: boolean;
+    type?: StorylineLineType;
+    showArrow?: boolean;
+    arrowSize?: number;
+    distance?: number;
+}
+export interface IStorylineSpec extends Omit<IChartSpec, 'type' | 'data' | 'series' | 'title' | 'layout'> {
+    type: 'storyline';
+    data: IStorylineBlock[];
+    layout?: StorylineLayoutType | IStorylineLayoutOptions;
+    block?: IStorylineBlockSpec;
+    title?: IMarkSpec<ITextMarkSpec>;
+    content?: IMarkSpec<IComposedTextMarkSpec>;
+    image?: IStorylineImageSpec;
+    centerImage?: IStorylineCenterImageSpec;
+    line?: IStorylineLineSpec;
+    themeColor?: string;
+}

package/esm/charts/storyline/interface.js

@@ -0,0 +1,2 @@
+export { };
+//# sourceMappingURL=interface.js.map

package/esm/charts/storyline/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/charts/storyline/interface.ts"],"names":[],"mappings":"","file":"interface.js","sourcesContent":["import type {\n  IChartSpec,\n  IComposedTextMarkSpec,\n  IImageMarkSpec,\n  IMarkSpec,\n  IPathMarkSpec,\n  IRectMarkSpec,\n  ITextMarkSpec,\n  StringOrNumber\n} from '@visactor/vchart';\n\nexport type StorylineLayoutType =\n  | 'clock'\n  | 'bowl'\n  | 'dome'\n  | 'left-wing'\n  | 'right-wing'\n  | 'landscape'\n  | 'portrait'\n  | 'up-ladder'\n  | 'down-ladder'\n  | 'pulse'\n  | 'spiral';\n\nexport type StorylineImagePosition = 'top' | 'left' | 'right' | 'bottom';\nexport type StorylineLineType = 'line' | 'polyline' | 'curve';\n\nexport interface IStorylineBlock {\n  id?: StringOrNumber;\n  title?: string;\n  content?: string | string[];\n  image?: string | HTMLImageElement | HTMLCanvasElement;\n  datum?: unknown;\n}\n\nexport interface IStorylineLayoutOptions {\n  type: StorylineLayoutType;\n  /**\n   * 边缘留白，支持单值或 [top, right, bottom, left]。\n   */\n  padding?: number | [number, number, number, number];\n  /**\n   * 对 circular/arc 布局生效，控制半径占可用空间的比例。\n   */\n  radiusRatio?: number;\n  /**\n   * 对 circular/arc 布局生效，角度单位为度。\n   */\n  startAngle?: number;\n  /**\n   * 对 circular/arc 布局生效，角度单位为度。\n   */\n  endAngle?: number;\n}\n\nexport interface IStorylineBlockSpec {\n  width?: number;\n  widthRatio?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  height?: number;\n  padding?: number | [number, number, number, number];\n  gap?: number;\n  style?: Partial<IRectMarkSpec>;\n}\n\nexport interface IStorylineImageSpec extends IMarkSpec<IImageMarkSpec> {\n  width?: number;\n  height?: number;\n  position?: StorylineImagePosition;\n  gap?: number;\n}\n\nexport interface IStorylineCenterImageSpec extends IMarkSpec<IImageMarkSpec> {\n  width?: number;\n  height?: number;\n  visible?: boolean;\n  image?: string | HTMLImageElement | HTMLCanvasElement;\n}\n\nexport interface IStorylineLineSpec extends IMarkSpec<IPathMarkSpec> {\n  visible?: boolean;\n  type?: StorylineLineType;\n  showArrow?: boolean;\n  arrowSize?: number;\n  /**\n   * 连接线和 block 边缘之间的距离。\n   */\n  distance?: number;\n}\n\nexport interface IStorylineSpec extends Omit<IChartSpec, 'type' | 'data' | 'series' | 'title' | 'layout'> {\n  type: 'storyline';\n  data: IStorylineBlock[];\n  layout?: StorylineLayoutType | IStorylineLayoutOptions;\n  block?: IStorylineBlockSpec;\n  title?: IMarkSpec<ITextMarkSpec>;\n  content?: IMarkSpec<IComposedTextMarkSpec>;\n  image?: IStorylineImageSpec;\n  centerImage?: IStorylineCenterImageSpec;\n  line?: IStorylineLineSpec;\n  themeColor?: string;\n}\n"]}

package/esm/charts/storyline/layout.d.ts

@@ -0,0 +1,53 @@
+import type { IStorylineBlock, IStorylineLayoutOptions, StorylineLayoutType } from './interface';
+export interface StorylineSize {
+    width: number;
+    height: number;
+}
+export interface StorylinePadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface StorylinePoint {
+    x: number;
+    y: number;
+}
+export interface StorylineBlockPosition extends StorylinePoint, StorylineSize {
+    id: string | number;
+    index: number;
+    datum: IStorylineBlock;
+    center: StorylinePoint;
+}
+export interface StorylineLinkPosition {
+    from: StorylineBlockPosition;
+    to: StorylineBlockPosition;
+    start: StorylinePoint;
+    end: StorylinePoint;
+    points: StorylinePoint[];
+}
+export interface StorylineCircleGuide {
+    center: StorylinePoint;
+    radius: number;
+}
+export interface StorylineLayoutResult {
+    blocks: StorylineBlockPosition[];
+    links: StorylineLinkPosition[];
+    circleGuide?: StorylineCircleGuide;
+}
+export interface StorylineComputeOptions {
+    layout: StorylineLayoutType | IStorylineLayoutOptions | undefined;
+    viewBox: StorylineSize;
+    block: StorylineSize;
+    gap?: number;
+    padding?: number | [number, number, number, number];
+    lineDistance?: number;
+}
+export declare const normalizePadding: (padding?: number | [
+    number,
+    number,
+    number,
+    number
+]) => StorylinePadding;
+export declare const normalizeLayout: (layout?: StorylineLayoutType | IStorylineLayoutOptions) => IStorylineLayoutOptions;
+export declare const computeStorylineLayout: (data: IStorylineBlock[], options: StorylineComputeOptions) => StorylineLayoutResult;