[feature] [transform] add new aggregate transform and id transform

[pissang]

Brief Information

This pull request is in the type of:

• bug fixing
• new feature
• others

What does this PR do?

This PR migrates the aggregate and id transform from echarts-simple-transform, which is a experiment repo maintained by one of our maintainers @100pah. The API design is mainly keeped same but code are refactored to be more clear and neater.

Also in this PR the old seriesLayoutBy option is renamed to sourceLayout to be more clear.

Details

Aggregate transform

const option = {
    dataset: [{
        source: [
            ['aa', 'bb', 'cc', 'tag'],
            [12, 0.33, 5200, 'AA'],
            [21, 0.65, 7100, 'AA'],
            [51, 0.15, 1100, 'BB'],
            [71, 0.75, 9100, 'BB'],
            ...
        ]
    }, {
        transform: {
            type: 'aggregate',
            config: {
                output: [
                    // by default, use the same name with `from`.
                    { from: 'aa', method: 'sum' },
                    { from: 'bb', method: 'count' },
                    { from: 'cc' }, // method by default: use the first value.
                    { from: 'dd', method: 'Q1' },
                    { from: 'tag' }
                ],
                groupBy: 'tag'
            }
        }
        // Then the result data will be:
        // [
        //     ['aa', 'bb', 'cc', 'tag'],
        //     [12, 0.33, 5200, 'AA'],
        //     [21, 0.65, 8100, 'BB'],
        //     ...
        // ]
    }],
    // ...
};

ID transform

const option = {
    dataset: [{
        source: [
            ['aa', 'bb', 'cc', 'tag'],
            [12, 0.33, 5200, 'AA'],
            [21, 0.65, 8100, 'AA'],
            ...
        ]
    }, {
        transform: {
            type: 'id',
            config: {
                dimensionIndex: 4,
                dimensionName: 'ID'
            }
        }
        // Then the result data will be:
        // [
        //     ['aa', 'bb', 'cc', 'tag', 'ID'],
        //     [12, 0.33, 5200, 'AA', 0],
        //     [21, 0.65, 8100, 'BB', 1],
        //     ...
        // ]
    }],
    // ...
};

Misc

• The API has been changed (apache/echarts-doc#xxx).
• This PR depends on ZRender changes (ecomfe/zrender#xxx).

Related test cases or examples to use the new APIs

N.A.

Others

Merging options

• Please squash the commits into a single one when merging.

Other information

[echarts-bot]

Thanks for your contribution!
The community will review it ASAP. In the meanwhile, please checkout the coding standard and Wiki about How to make a pull request.

The pull request is marked to be PR: author is committer because you are a committer of this project.

Document changes are required in this PR. Please also make a PR to apache/echarts-doc for document changes and update the issue id in the PR description. When the doc PR is merged, the maintainers will remove the PR: awaiting doc label.

[github-actions]

This PR has been automatically marked as stale because it has not had recent activity. It will be closed in 7 days if no further activity occurs. If you wish not to mark it as stale, please leave a comment in this PR. We are sorry for this but 2 years is a long time and the code base has been changed a lot. Thanks for your contribution anyway.

[namannitr]

Thanks for landing the aggregate/id migration design here.

Two correctness items from the experimental plugin that are worth checking against this branch before it leaves draft (they are easy to miss because src and dist diverged):

• SUM must not initialize to 0. That skips the first row of every group and zeroes singleton groups. Plugin history: initial value of sum should be the first value instead of 0 100pah/echarts-simple-transform#1 / update #3; rebuilt bundle: fix(aggregate): include first row in SUM and coerce numeric strings 100pah/echarts-simple-transform#9.
• Arithmetic methods should coerce cells (Number / dataset parsers). '400' + '100' string concat is a common objectRows footgun (Sum method not giving correct result 100pah/echarts-simple-transform#6).

Also, this PR’s aggregate still groups by one dimension. Long-format “one series per value of column X” is a reshape, not an aggregation — opened #21742 so that discussion does not block this migration.

I am not proposing extra API on this PR; just flagging the SUM seed/dist trap so core does not re-ship it.