@finebi/finebi-cli 2.0.0 → 2.0.1

package/templates/web-app/tests/field-selection.test.mjs

@@ -1,70 +1,70 @@
-import assert from 'node:assert/strict';
-import {after,test} from 'node:test';
-import {createServer as createHttpServer} from 'node:http';
-import {createServer} from 'vite';
-import {configErrors} from '../src/finebi/config.js';
-import {createDevMiddleware} from '../scripts/dev-proxy.mjs';
-const server=await createServer({configFile:false,cacheDir:'temp/vite-field-selection-tests',server:{middlewareMode:true,hmr:false}});
-after(()=>server.close());
-const {queryWidget,queryWidgets}=await server.ssrLoadModule('/src/finebi/client.ts');
-const binding={entryId:'w',name:'Table',type:'table'};
-const config={schemaVersion:'1',title:'Test',basePath:'/bi',layout:'overview',dashboardId:'r',maxRows:10,pageSize:5,widgets:[binding],filters:[]};
-const response=()=>new Response(JSON.stringify({success:true,data:{w:{previewResult:{resultType:'DETAIL',header:[],items:[],row:0}}}}));
-
-test('optional dimensionIds validates lists without confusing omission and empty selection',()=>{
-  for(const ids of [undefined,[],['city'],['sales'],['city','sales']]) {
-    const widget=ids===undefined?binding:{...binding,dimensionIds:ids};
-    assert.deepEqual(configErrors({...config,widgets:[widget]}),[]);
-  }
-  for(const ids of [null,'sales',[1],[''],[' '],[null],['sales','sales']]) {
-    assert.ok(configErrors({...config,widgets:[{...binding,dimensionIds:ids}]}).some(e=>e.includes('dimensionIds')));
-  }
-});
-
-test('binding selection reaches ordinary and published queries unchanged, including omission',async()=>{
-  for(const directoryEntryId of [undefined,'directory']) {
-    const widgets=[binding,...[[],['city'],['sales'],['city','sales']].map(dimensionIds=>({...binding,dimensionIds}))];
-    const app={...config,...(directoryEntryId?{directoryEntryId}:{}),widgets};
-    for(const widget of widgets) {
-      await queryWidget(app,widget,{},undefined,async(_url,init)=>{
-        const body=JSON.parse(init.body);
-        assert.deepEqual(body.dimensionSelections,widget.dimensionIds===undefined?undefined:{w:widget.dimensionIds});
-        assert.equal(Object.hasOwn(body,'dimensionSelections'),widget.dimensionIds!==undefined);
-        assert.equal(body.reportEntryId,directoryEntryId);
-        return response();
-      });
-    }
-    await assert.rejects(queryWidgets(app,{},undefined,()=>assert.fail('conflicting bindings must not fetch')),/selection|选择/);
-  }
-});
-
-test('invalid selection fails before browser HTTP and matching batch selections can share an instance',async()=>{
-  await assert.rejects(queryWidgets({...config,widgets:[{...binding,dimensionIds:null}]},{},undefined,()=>assert.fail('invalid config must not fetch')),/dimensionIds/);
-  const widgets=[{...binding,dimensionIds:['city','sales']},{...binding,dimensionIds:['sales','city']}];
-  await queryWidgets({...config,widgets},{},undefined,async(_url,init)=>{
-    const body=JSON.parse(init.body);assert.deepEqual(body.widgetIds,['w']);
-    assert.deepEqual(body.dimensionSelections,{w:['city','sales']});return response();
-  });
-});
-
-test('proxy preserves configured choices and rejects malformed or unconfigured selections before upstream',async()=>{
-  const sent=[];
-  const widgets=[binding,...[[],['sales'],['city','sales']].map(dimensionIds=>({...binding,dimensionIds}))];
-  const middleware=createDevMiddleware({...config,directoryEntryId:'directory',widgets},
-    {FINEBI_DEV_BASE_URL:'http://bi.example/bi',FINEBI_DEV_TOKEN:'secret'},async(_url,init)=>{sent.push(JSON.parse(init.body));return response();});
-  const http=createHttpServer((req,res)=>middleware(req,res,()=>{}));
-  await new Promise(resolve=>http.listen(0,'127.0.0.1',resolve));
-  const send=extra=>fetch(`http://127.0.0.1:${http.address().port}/bi/v5/api/dashboard/report/r/widgets/query`,{
-    method:'POST',headers:{'X-Requested-With':'XMLHttpRequest'},body:JSON.stringify({widgetIds:['w'],pageLimit:10,reportEntryId:'directory',...extra})});
-  try {
-    for(const selections of [null,[],{other:['sales']},{w:null},{w:['']},{w:['sales','sales']},{w:['unknown']},{w:['city']}]) {
-      assert.equal((await send({dimensionSelections:selections})).status,400);
-    }
-    assert.equal(sent.length,0);
-    for(const selections of [undefined,{w:[]},{w:['sales']},{w:['city','sales']}]) {
-      assert.equal((await send(selections===undefined?{}:{dimensionSelections:selections})).status,200);
-      assert.deepEqual(sent.at(-1).dimensionSelections,selections);
-      assert.equal(sent.at(-1).reportEntryId,'directory');
-    }
-  } finally {middleware.dispose?.();await new Promise(resolve=>http.close(resolve));}
-});
+import assert from 'node:assert/strict';
+import {after,test} from 'node:test';
+import {createServer as createHttpServer} from 'node:http';
+import {createServer} from 'vite';
+import {configErrors} from '../src/finebi/config.js';
+import {createDevMiddleware} from '../scripts/dev-proxy.mjs';
+const server=await createServer({configFile:false,cacheDir:'temp/vite-field-selection-tests',server:{middlewareMode:true,hmr:false}});
+after(()=>server.close());
+const {queryWidget,queryWidgets}=await server.ssrLoadModule('/src/finebi/client.ts');
+const binding={entryId:'w',name:'Table',type:'table'};
+const config={schemaVersion:'1',title:'Test',basePath:'/bi',layout:'overview',dashboardId:'r',maxRows:10,pageSize:5,widgets:[binding],filters:[]};
+const response=()=>new Response(JSON.stringify({success:true,data:{w:{previewResult:{resultType:'DETAIL',header:[],items:[],row:0}}}}));
+
+test('optional dimensionIds validates lists without confusing omission and empty selection',()=>{
+  for(const ids of [undefined,[],['city'],['sales'],['city','sales']]) {
+    const widget=ids===undefined?binding:{...binding,dimensionIds:ids};
+    assert.deepEqual(configErrors({...config,widgets:[widget]}),[]);
+  }
+  for(const ids of [null,'sales',[1],[''],[' '],[null],['sales','sales']]) {
+    assert.ok(configErrors({...config,widgets:[{...binding,dimensionIds:ids}]}).some(e=>e.includes('dimensionIds')));
+  }
+});
+
+test('binding selection reaches ordinary and published queries unchanged, including omission',async()=>{
+  for(const directoryEntryId of [undefined,'directory']) {
+    const widgets=[binding,...[[],['city'],['sales'],['city','sales']].map(dimensionIds=>({...binding,dimensionIds}))];
+    const app={...config,...(directoryEntryId?{directoryEntryId}:{}),widgets};
+    for(const widget of widgets) {
+      await queryWidget(app,widget,{},undefined,async(_url,init)=>{
+        const body=JSON.parse(init.body);
+        assert.deepEqual(body.dimensionSelections,widget.dimensionIds===undefined?undefined:{w:widget.dimensionIds});
+        assert.equal(Object.hasOwn(body,'dimensionSelections'),widget.dimensionIds!==undefined);
+        assert.equal(body.reportEntryId,directoryEntryId);
+        return response();
+      });
+    }
+    await assert.rejects(queryWidgets(app,{},undefined,()=>assert.fail('conflicting bindings must not fetch')),/selection|选择/);
+  }
+});
+
+test('invalid selection fails before browser HTTP and matching batch selections can share an instance',async()=>{
+  await assert.rejects(queryWidgets({...config,widgets:[{...binding,dimensionIds:null}]},{},undefined,()=>assert.fail('invalid config must not fetch')),/dimensionIds/);
+  const widgets=[{...binding,dimensionIds:['city','sales']},{...binding,dimensionIds:['sales','city']}];
+  await queryWidgets({...config,widgets},{},undefined,async(_url,init)=>{
+    const body=JSON.parse(init.body);assert.deepEqual(body.widgetIds,['w']);
+    assert.deepEqual(body.dimensionSelections,{w:['city','sales']});return response();
+  });
+});
+
+test('proxy preserves configured choices and rejects malformed or unconfigured selections before upstream',async()=>{
+  const sent=[];
+  const widgets=[binding,...[[],['sales'],['city','sales']].map(dimensionIds=>({...binding,dimensionIds}))];
+  const middleware=createDevMiddleware({...config,directoryEntryId:'directory',widgets},
+    {FINEBI_DEV_BASE_URL:'http://bi.example/bi',FINEBI_DEV_TOKEN:'secret'},async(_url,init)=>{sent.push(JSON.parse(init.body));return response();});
+  const http=createHttpServer((req,res)=>middleware(req,res,()=>{}));
+  await new Promise(resolve=>http.listen(0,'127.0.0.1',resolve));
+  const send=extra=>fetch(`http://127.0.0.1:${http.address().port}/bi/v5/api/dashboard/report/r/widgets/query`,{
+    method:'POST',headers:{'X-Requested-With':'XMLHttpRequest'},body:JSON.stringify({widgetIds:['w'],pageLimit:10,reportEntryId:'directory',...extra})});
+  try {
+    for(const selections of [null,[],{other:['sales']},{w:null},{w:['']},{w:['sales','sales']},{w:['unknown']},{w:['city']}]) {
+      assert.equal((await send({dimensionSelections:selections})).status,400);
+    }
+    assert.equal(sent.length,0);
+    for(const selections of [undefined,{w:[]},{w:['sales']},{w:['city','sales']}]) {
+      assert.equal((await send(selections===undefined?{}:{dimensionSelections:selections})).status,200);
+      assert.deepEqual(sent.at(-1).dimensionSelections,selections);
+      assert.equal(sent.at(-1).reportEntryId,'directory');
+    }
+  } finally {middleware.dispose?.();await new Promise(resolve=>http.close(resolve));}
+});

package/templates/web-app/tests/retail.test.mjs

@@ -1,31 +1,31 @@
-import assert from 'node:assert/strict';
-import {after,test} from 'node:test';
-import {createServer} from 'vite';
-const server=await createServer({configFile:false,cacheDir:'temp/vite-retail-tests',server:{middlewareMode:true,hmr:false}});
-after(()=>server.close());
-const {formatMetric,formatCategory}=await server.ssrLoadModule('/src/services/presentation.ts');
-const {configErrors}=await import('../src/finebi/config.js');
-const cell=(value,state='AVAILABLE')=>({value,display:null,state,reason:null});
-test('KPI display preserves decimal precision and formats ratios only by explicit configuration',()=>{
-  assert.equal(formatMetric(cell('9007199254740993.01'),'number'),'9,007,199,254,740,993.01');
-  assert.equal(formatMetric(cell('1.2345678e7'),'number'),'12,345,678');
-  assert.equal(formatMetric(cell('0.123456789'),'percent'),'12.35%');
-  assert.equal(formatMetric(cell('-0.00005'),'percent'),'-0.01%');
-  assert.equal(formatMetric(cell('42.0'),'number'),'42');
-  assert.equal(formatMetric(cell('100','RESTRICTED'),'number'),'受限');
-  assert.equal(formatMetric(cell(null,'NULL'),'percent'),'—');
-  assert.equal(formatMetric(cell('0.5')),'0.5');
-});
-test('month formatting is explicit, timezone-aware and preserves invalid or restricted values',()=>{
-  const binding={categoryFormat:'epoch-month',categoryTimeZone:'Asia/Shanghai'};
-  const timestamp=String(Date.UTC(2024,1,29,16));
-  assert.equal(formatCategory(cell(timestamp),binding),'2024-03');
-  assert.equal(formatCategory(cell(timestamp),{}),timestamp);
-  assert.equal(formatCategory(cell('not-a-date'),binding),'not-a-date');
-  assert.equal(formatCategory(cell(timestamp,'RESTRICTED'),binding),'受限');
-});
-test('display configuration rejects implicit date timezone and invalid formats',()=>{
-  const config={schemaVersion:'1',title:'Test',basePath:'/bi',layout:'retail',dashboardId:'r',maxRows:1000,pageSize:8,filters:[],widgets:[{entryId:'w',name:'Trend',type:'line',categoryFieldId:'x',valueFieldId:'y',categoryFormat:'epoch-month',categoryTimeZone:'Asia/Shanghai'}]};
-  assert.deepEqual(configErrors(config),[]);
-  for(const patch of [{categoryTimeZone:undefined},{categoryTimeZone:'Bad/Timezone'},{categoryFormat:'guess'},{valueFormat:'guess'}])assert.ok(configErrors({...config,widgets:[{...config.widgets[0],...patch}]}).length);
-});
+import assert from 'node:assert/strict';
+import {after,test} from 'node:test';
+import {createServer} from 'vite';
+const server=await createServer({configFile:false,cacheDir:'temp/vite-retail-tests',server:{middlewareMode:true,hmr:false}});
+after(()=>server.close());
+const {formatMetric,formatCategory}=await server.ssrLoadModule('/src/services/presentation.ts');
+const {configErrors}=await import('../src/finebi/config.js');
+const cell=(value,state='AVAILABLE')=>({value,display:null,state,reason:null});
+test('KPI display preserves decimal precision and formats ratios only by explicit configuration',()=>{
+  assert.equal(formatMetric(cell('9007199254740993.01'),'number'),'9,007,199,254,740,993.01');
+  assert.equal(formatMetric(cell('1.2345678e7'),'number'),'12,345,678');
+  assert.equal(formatMetric(cell('0.123456789'),'percent'),'12.35%');
+  assert.equal(formatMetric(cell('-0.00005'),'percent'),'-0.01%');
+  assert.equal(formatMetric(cell('42.0'),'number'),'42');
+  assert.equal(formatMetric(cell('100','RESTRICTED'),'number'),'受限');
+  assert.equal(formatMetric(cell(null,'NULL'),'percent'),'—');
+  assert.equal(formatMetric(cell('0.5')),'0.5');
+});
+test('month formatting is explicit, timezone-aware and preserves invalid or restricted values',()=>{
+  const binding={categoryFormat:'epoch-month',categoryTimeZone:'Asia/Shanghai'};
+  const timestamp=String(Date.UTC(2024,1,29,16));
+  assert.equal(formatCategory(cell(timestamp),binding),'2024-03');
+  assert.equal(formatCategory(cell(timestamp),{}),timestamp);
+  assert.equal(formatCategory(cell('not-a-date'),binding),'not-a-date');
+  assert.equal(formatCategory(cell(timestamp,'RESTRICTED'),binding),'受限');
+});
+test('display configuration rejects implicit date timezone and invalid formats',()=>{
+  const config={schemaVersion:'1',title:'Test',basePath:'/bi',layout:'retail',dashboardId:'r',maxRows:1000,pageSize:8,filters:[],widgets:[{entryId:'w',name:'Trend',type:'line',categoryFieldId:'x',valueFieldId:'y',categoryFormat:'epoch-month',categoryTimeZone:'Asia/Shanghai'}]};
+  assert.deepEqual(configErrors(config),[]);
+  for(const patch of [{categoryTimeZone:undefined},{categoryTimeZone:'Bad/Timezone'},{categoryFormat:'guess'},{valueFormat:'guess'}])assert.ok(configErrors({...config,widgets:[{...config.widgets[0],...patch}]}).length);
+});

package/templates/web-app/tests/table-normalize.test.mjs

@@ -1,189 +1,189 @@
-import assert from 'node:assert/strict';
-import {after, test} from 'node:test';
-import {createServer} from 'vite';
-import {createElement} from 'react';
-import {renderToStaticMarkup} from 'react-dom/server';
-const server = await createServer({configFile: false, cacheDir: '../../../temp/vite-table-tests', server: {middlewareMode: true, hmr: false}});
-after(() => server.close());
-const {normalize} = await server.ssrLoadModule('/src/finebi/normalize.ts');
-const {DataTable} = await server.ssrLoadModule('/src/components/DataTable.tsx');
-const {tableCsv} = await server.ssrLoadModule('/src/services/table-data.ts');
-const metric = (text, rowSumInfo = {totalSum: false, innerSum: false}, extra = {}) => ({dId: 'amount', text, authority: true, rowSumInfo, ...extra});
-const group = items => ({previewResult: {resultType: 'BIGROUP', header: [{dId: 'region', text: '地区'}, {dId: 'city', text: '城市'}, {dId: 'amount', text: '金额'}], items, hasNext: true, hasPrev: false}, widgetBean: {dimensions: {region: {type: 1}, city: {type: 1}}, settings: {tableStyle: {rowCounts: 10}}}});
-const detailInfo = {totalSum: false, innerSum: false};
-const totalInfo = {totalSum: true, innerSum: false};
-const node = (dId, text, children = null, values = null) => ({dId, text, formatText: text, authority: true, children, values});
-const crossMetric = (text, colSumInfo = detailInfo, rowSumInfo = detailInfo, dId = 'amount') => ({dId, text, authority: true, colSumInfo, rowSumInfo});
-const cross = (top, left) => ({previewResult: {resultType: 'BICROSS', top: {header: [{dId: 'year', text: '年'}], items: [node(null, null, top)]}, left: {header: [{dId: 'region', text: '地区'}], items: [node(null, null, left)]}, hasXNext: true, hasXPrev: false, hasYNext: false, hasYPrev: false}});
-
-test('cross display removes only repeated metric captions and DATA summary carriers', () => {
-  const source = cross([node('region', '金额', [node('target-name', '金额', null, [node('amount', '金额')])])], [
-    node('region', '合计', [node('__summary_dim_id__', '合计', null, [crossMetric('1')])]),
-    node('__summary_dim_id__', '合计', null, [crossMetric('2', detailInfo, totalInfo)]),
-    node('__summary_dim_id__', '合计', null, [crossMetric('3', detailInfo, {totalSum: false, innerSum: true})]),
-    node('__summary_dim_id__', '合计', null, [{...crossMetric('4'), rowSumInfo: null}]),
-  ]);
-  const data = normalize(source).datasets[0];
-  assert.equal(data.columns[1].name, '金额 / 金额', 'real repeated grouping labels must remain');
-  assert.equal(data.columns[1].path.length, 3, 'source path metadata must remain intact');
-  assert.equal(data.rows[0].cells[0].display, '合计', 'business dimension named 合计 must remain');
-  assert.equal(data.rows[0].path.length, 2);
-  assert.deepEqual(data.rows.slice(1).map(row => [row.kind, row.cells[0].display]), [['GRAND_TOTAL', '合计'], ['SUBTOTAL', '合计'], ['UNKNOWN', '合计']]);
-});
-
-test('cross metric rows deduplicate only the verified trailing metric caption', () => {
-  const rows = [
-    node('region', '金额', [node('target-name', '金额', [node('amount', '金额', null, [crossMetric('7')])])]),
-    node('region', '金额', [node('other-dimension', '金额', null, [crossMetric('8')])]),
-    node('target-name', '金额', [node('amount', '别名', null, [crossMetric('9')])]),
-    node('target-name', '金额', [node('amount', '金额', null, [crossMetric('10', detailInfo, detailInfo, 'count')])]),
-  ];
-  const data = normalize(cross([node('year', '2024', null, [{}])], rows)).datasets[0];
-  assert.deepEqual(data.rows.map(r => r.cells[0].display), ['金额 / 金额', '金额 / 金额', '金额 / 别名', '金额 / 金额']);
-  assert.equal(data.rows[0].path.length, 3);
-  assert.equal(data.rows[0].cells[1].sourceFieldId, 'amount');
-  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
-  assert.doesNotMatch(html, /金额 \/ 金额 \/ 金额/);
-  assert.doesNotMatch(tableCsv(data, data.rows), /金额 \/ 金额 \/ 金额/);
-});
-
-test('cross real null renders as dash while placeholders, missing payload and permissions stay distinct', () => {
-  const empty = {...crossMetric(null), value: null, formatText: null};
-  const cells = [empty, {...empty, dId: null}, {...empty, authority: false}, {...empty, authority: undefined}, {dId: 'amount', authority: true}, {...empty, formatText: '仅展示'}];
-  const data = normalize(cross([node('year', '2024', null, cells.map(() => ({})))], [node('region', '东部', null, cells)])).datasets[0];
-  assert.deepEqual(data.rows[0].cells.slice(1).map(c => c.state), ['NULL', 'UNAVAILABLE', 'RESTRICTED', 'UNAVAILABLE', 'UNAVAILABLE', 'UNAVAILABLE']);
-  assert.equal(data.rows[0].cells[1].reason, null);
-  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
-  assert.match(html, /<td>—<\/td><td>不可用<\/td><td>受限<\/td>/);
-  assert.match(tableCsv(data, data.rows), /"—","不可用","受限"/);
-});
-
-test('cross placeholders without valid metric ids never become available numeric values', () => {
-  const cells = [null, undefined, '', ' ', 12].map(dId => ({...crossMetric('12'), dId, value: 12}));
-  const data = normalize(cross([node('year', '2024', null, cells.map(() => ({})))], [node('region', '东部', null, cells)])).datasets[0];
-  for (const cell of data.rows[0].cells.slice(1)) {
-    assert.equal(cell.state, 'UNAVAILABLE');
-    assert.equal(cell.value, null);
-    assert.equal(cell.sourceFieldId, null);
-  }
-});
-
-test('cross table aligns repeated metric ids by column slots and preserves both axes and totals', () => {
-  for (const totalFirst of [false, true]) {
-    const columns = [node('year', '2024', null, [node('amount', '金额')]), node('year', '2025', null, [node('amount', '金额')])];
-    const summary = node('__summary_dim_id__', '合计', [node('amount', '金额', null, [{}])]);
-    columns.splice(totalFirst ? 0 : columns.length, 0, summary);
-    const values = [crossMetric('9007199254740993.12'), crossMetric('2.50')];
-    values.splice(totalFirst ? 0 : values.length, 0, crossMetric('9007199254740995.62', totalInfo));
-    const source = cross(columns, [node('region', '东部', [node('__summary_dim_id__', null, null, values)]), node('__summary_dim_id__', '合计', [node('amount', '金额', null, values.map(v => ({...v, rowSumInfo: totalInfo})))])]);
-    const result = normalize(source), data = result.datasets[0];
-    assert.equal(result.resultType, 'CROSS_TABLE'); assert.equal(result.normalization, 'COMPLETE');
-    assert.deepEqual(data.rows[0].cells.slice(1).map(c => c.value), values.map(v => v.text));
-    assert.equal(new Set(data.columns.map(c => c.fieldId)).size, 4);
-    assert.equal(data.rows[0].cells[1].sourceFieldId, 'amount');
-    assert.deepEqual(data.rows.map(r => r.kind), ['DATA', 'GRAND_TOTAL']);
-    assert.equal(data.columns[totalFirst ? 1 : 3].kind, 'GRAND_TOTAL');
-    assert.equal(result.range.mode, 'INITIAL_VIEW'); assert.equal(result.range.page, null);
-    assert.deepEqual(result.range.axes, {horizontal: {hasNext: true, hasPrevious: false}, vertical: {hasNext: false, hasPrevious: false}});
-    assert.equal(result.range.hasNext, true); assert.ok(result.warnings.includes('NEXT_PAGE_UNSUPPORTED'));
-    const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
-    assert.match(html, /2024/); assert.match(html, /2025/); assert.match(html, /总计/);
-    assert.match(tableCsv(data, data.rows), /9007199254740993.12/);
-    assert.equal(source.previewResult.top.items[0].children.length, 3);
-  }
-});
-
-test('cross table supports metrics on rows and multi-level columns without id joins', () => {
-  const source = cross([node('year', '2024', [node('quarter', 'Q1', null, []), node('quarter', 'Q2', null, [])])], [
-    node('region', '东部', [node('target-name', '金额', [node('amount', '金额', null, [crossMetric('12'), crossMetric('18')])]), node('target-name', '数量', [node('count', '数量', null, [crossMetric('3', detailInfo, detailInfo, 'count'), crossMetric('4', detailInfo, detailInfo, 'count')])])]),
-  ]);
-  const data = normalize(source).datasets[0];
-  assert.equal(data.columns.length, 3); assert.equal(data.rows.length, 2);
-  assert.match(data.columns[1].name, /2024.*Q1/);
-  assert.match(data.rows[1].cells[0].display, /东部.*数量/);
-  assert.deepEqual(data.rows[1].cells.slice(1).map(c => c.sourceFieldId), ['count', 'count']);
-});
-
-test('cross table never exposes restricted axis labels and retains missing/ambiguous value states', () => {
-  const secret = node('year', 'secret column', null, [{}]); secret.authority = false;
-  const row = node('region', 'secret row', null, [crossMetric('123')]); row.authority = false;
-  const result = normalize(cross([secret], [row]));
-  assert.doesNotMatch(JSON.stringify(result), /secret column|secret row/);
-  assert.equal(result.datasets[0].rows[0].cells[0].state, 'RESTRICTED');
-  assert.equal(result.datasets[0].rows[0].cells[1].state, 'RESTRICTED');
-  const source = cross([node('year', 'A', null, [{}, {}])], [node('region', 'X', null, [{...crossMetric('1万'), formatText: '1万'}])]);
-  const incomplete = normalize(source);
-  assert.equal(incomplete.normalization, 'PARTIAL');
-  assert.equal(incomplete.datasets[0].rows[0].cells[1].state, 'UNAVAILABLE');
-  assert.equal(incomplete.datasets[0].rows[0].cells[2].reason, 'MISSING_CELL');
-  source.previewResult.left.items[0].children[0].values.push(crossMetric('2'), crossMetric('3'));
-  assert.equal(normalize(source).normalization, 'UNSUPPORTED', 'extra values must not be silently dropped');
-});
-
-test('cross table distinguishes empty views, missing axes and unsupported mixed node topology', () => {
-  assert.equal(normalize(cross([], [])).normalization, 'COMPLETE');
-  assert.equal(normalize(cross([], [])).datasets[0].returnedRowCount, 0);
-  assert.equal(normalize({previewResult: {resultType: 'BICROSS', left: {header: [], items: []}}}).normalization, 'UNSUPPORTED');
-  assert.equal(normalize(cross([node('x', 'A', [node('x', 'B')], [{}])], [])).normalization, 'UNSUPPORTED');
-});
-
-test('cross table handles no column dimensions and preserves metric-name intersection placeholders', () => {
-  const source = cross([], [node('target', '金额', null, [crossMetric('7'), {dId: null, text: null, value: null, authority: true}])]);
-  source.previewResult.top = {header: [], items: []};
-  const result = normalize(source);
-  assert.equal(result.normalization, 'COMPLETE');
-  assert.deepEqual(result.datasets[0].rows[0].cells.slice(1).map(c => c.state), ['AVAILABLE', 'UNAVAILABLE']);
-  assert.equal(result.datasets[0].rows[0].cells[2].value, null);
-  const swapped = cross([node('year', '2024', null, [node('amount', '金额')])], [node('region', '东部', null, [crossMetric('1', detailInfo, detailInfo, 'count')])]);
-  assert.equal(normalize(swapped).normalization, 'PARTIAL');
-  assert.equal(normalize(swapped).datasets[0].rows[0].cells[1].reason, 'AMBIGUOUS_FIELD');
-});
-
-test('group preserves parent keys, totals, metric precision and the first group page', () => {
-  const source = group([{dId: 'region', text: '东部', authority: true, values: [metric('9007199254740993.12', {totalSum: false, innerSum: true})], children: [
-    {dId: 'city', text: '甲城', authority: true, values: [metric('12.50', undefined, {formatText: '12.50元'})]},
-  ]}, {values: [metric('9007199254741005.62', {totalSum: true, innerSum: false})]}]);
-  const result = normalize(source), data = result.datasets[0];
-  assert.equal(result.resultType, 'GROUP_TABLE');
-  assert.equal(result.normalization, 'COMPLETE');
-  assert.deepEqual(data.rows.map(r => r.kind), ['SUBTOTAL', 'DATA', 'GRAND_TOTAL']);
-  assert.deepEqual(data.rows[1].cells.map(c => c.value), ['东部', '甲城', '12.50']);
-  assert.equal(data.rows[0].cells[2].value, '9007199254740993.12');
-  assert.equal(data.returnedRowCount, 3);
-  assert.deepEqual(result.range, {mode: 'PAGE', page: 1, pageSize: 10, pageUnit: 'GROUP', hasNext: true, hasPrevious: false, total: {value: null, unit: 'GROUP'}});
-  assert.ok(result.warnings.includes('NEXT_PAGE_UNSUPPORTED'));
-  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
-  assert.match(html, /小计/); assert.match(html, /总计/);
-  assert.match(tableCsv(data, data.rows), /GRAND_TOTAL/);
-});
-
-test('group keeps restricted and ambiguous cells unavailable and does not infer numeric group keys', () => {
-  const source = group([{dId: 'region', text: '42', authority: true, values: [metric('12万', undefined, {formatText: '12万'})], children: [
-    {dId: 'city', text: '秘密', authority: false, values: [metric('999', undefined, {authority: false})]},
-    {dId: 'city', text: '乙城', authority: true, values: [metric('1'), metric('2')]},
-    {dId: 'city', text: '丙城', authority: true, values: [metric(null, null)]},
-  ]}]);
-  source.widgetBean.dimensions.region.type = 2;
-  const result = normalize(source), rows = result.datasets[0].rows;
-  assert.equal(rows[0].cells[0].reason, 'GROUP_KEY_SEMANTICS_UNKNOWN');
-  assert.equal(rows[0].cells[2].state, 'UNAVAILABLE');
-  assert.equal(rows[1].cells[1].state, 'RESTRICTED');
-  assert.equal(rows[1].cells[2].state, 'RESTRICTED');
-  assert.equal(rows[2].cells[2].reason, 'AMBIGUOUS_FIELD');
-  assert.equal(rows[3].cells[2].state, 'UNAVAILABLE');
-  assert.equal(rows[3].kind, 'UNKNOWN');
-  assert.equal(result.normalization, 'PARTIAL');
-});
-
-test('group header expansion reports an initial view and malformed groups are not empty successes', () => {
-  const source = group([]);
-  source.widgetBean.settings.tableStyle.showRowHeaderIcon = true;
-  const result = normalize(source);
-  assert.equal(result.range.mode, 'INITIAL_VIEW');
-  assert.equal(result.range.page, null);
-  assert.equal(result.range.hasNext, null);
-  assert.equal(result.datasets[0].returnedRowCount, 0);
-  assert.equal(normalize({previewResult: {resultType: 'BIGROUP'}}).normalization, 'UNSUPPORTED');
-  source.previewResult.items = [null, {dId: 'unknown', values: [metric('1')]}];
-  assert.equal(normalize(source).normalization, 'PARTIAL');
-});
+import assert from 'node:assert/strict';
+import {after, test} from 'node:test';
+import {createServer} from 'vite';
+import {createElement} from 'react';
+import {renderToStaticMarkup} from 'react-dom/server';
+const server = await createServer({configFile: false, cacheDir: '../../../temp/vite-table-tests', server: {middlewareMode: true, hmr: false}});
+after(() => server.close());
+const {normalize} = await server.ssrLoadModule('/src/finebi/normalize.ts');
+const {DataTable} = await server.ssrLoadModule('/src/components/DataTable.tsx');
+const {tableCsv} = await server.ssrLoadModule('/src/services/table-data.ts');
+const metric = (text, rowSumInfo = {totalSum: false, innerSum: false}, extra = {}) => ({dId: 'amount', text, authority: true, rowSumInfo, ...extra});
+const group = items => ({previewResult: {resultType: 'BIGROUP', header: [{dId: 'region', text: '地区'}, {dId: 'city', text: '城市'}, {dId: 'amount', text: '金额'}], items, hasNext: true, hasPrev: false}, widgetBean: {dimensions: {region: {type: 1}, city: {type: 1}}, settings: {tableStyle: {rowCounts: 10}}}});
+const detailInfo = {totalSum: false, innerSum: false};
+const totalInfo = {totalSum: true, innerSum: false};
+const node = (dId, text, children = null, values = null) => ({dId, text, formatText: text, authority: true, children, values});
+const crossMetric = (text, colSumInfo = detailInfo, rowSumInfo = detailInfo, dId = 'amount') => ({dId, text, authority: true, colSumInfo, rowSumInfo});
+const cross = (top, left) => ({previewResult: {resultType: 'BICROSS', top: {header: [{dId: 'year', text: '年'}], items: [node(null, null, top)]}, left: {header: [{dId: 'region', text: '地区'}], items: [node(null, null, left)]}, hasXNext: true, hasXPrev: false, hasYNext: false, hasYPrev: false}});
+
+test('cross display removes only repeated metric captions and DATA summary carriers', () => {
+  const source = cross([node('region', '金额', [node('target-name', '金额', null, [node('amount', '金额')])])], [
+    node('region', '合计', [node('__summary_dim_id__', '合计', null, [crossMetric('1')])]),
+    node('__summary_dim_id__', '合计', null, [crossMetric('2', detailInfo, totalInfo)]),
+    node('__summary_dim_id__', '合计', null, [crossMetric('3', detailInfo, {totalSum: false, innerSum: true})]),
+    node('__summary_dim_id__', '合计', null, [{...crossMetric('4'), rowSumInfo: null}]),
+  ]);
+  const data = normalize(source).datasets[0];
+  assert.equal(data.columns[1].name, '金额 / 金额', 'real repeated grouping labels must remain');
+  assert.equal(data.columns[1].path.length, 3, 'source path metadata must remain intact');
+  assert.equal(data.rows[0].cells[0].display, '合计', 'business dimension named 合计 must remain');
+  assert.equal(data.rows[0].path.length, 2);
+  assert.deepEqual(data.rows.slice(1).map(row => [row.kind, row.cells[0].display]), [['GRAND_TOTAL', '合计'], ['SUBTOTAL', '合计'], ['UNKNOWN', '合计']]);
+});
+
+test('cross metric rows deduplicate only the verified trailing metric caption', () => {
+  const rows = [
+    node('region', '金额', [node('target-name', '金额', [node('amount', '金额', null, [crossMetric('7')])])]),
+    node('region', '金额', [node('other-dimension', '金额', null, [crossMetric('8')])]),
+    node('target-name', '金额', [node('amount', '别名', null, [crossMetric('9')])]),
+    node('target-name', '金额', [node('amount', '金额', null, [crossMetric('10', detailInfo, detailInfo, 'count')])]),
+  ];
+  const data = normalize(cross([node('year', '2024', null, [{}])], rows)).datasets[0];
+  assert.deepEqual(data.rows.map(r => r.cells[0].display), ['金额 / 金额', '金额 / 金额', '金额 / 别名', '金额 / 金额']);
+  assert.equal(data.rows[0].path.length, 3);
+  assert.equal(data.rows[0].cells[1].sourceFieldId, 'amount');
+  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
+  assert.doesNotMatch(html, /金额 \/ 金额 \/ 金额/);
+  assert.doesNotMatch(tableCsv(data, data.rows), /金额 \/ 金额 \/ 金额/);
+});
+
+test('cross real null renders as dash while placeholders, missing payload and permissions stay distinct', () => {
+  const empty = {...crossMetric(null), value: null, formatText: null};
+  const cells = [empty, {...empty, dId: null}, {...empty, authority: false}, {...empty, authority: undefined}, {dId: 'amount', authority: true}, {...empty, formatText: '仅展示'}];
+  const data = normalize(cross([node('year', '2024', null, cells.map(() => ({})))], [node('region', '东部', null, cells)])).datasets[0];
+  assert.deepEqual(data.rows[0].cells.slice(1).map(c => c.state), ['NULL', 'UNAVAILABLE', 'RESTRICTED', 'UNAVAILABLE', 'UNAVAILABLE', 'UNAVAILABLE']);
+  assert.equal(data.rows[0].cells[1].reason, null);
+  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
+  assert.match(html, /<td>—<\/td><td>不可用<\/td><td>受限<\/td>/);
+  assert.match(tableCsv(data, data.rows), /"—","不可用","受限"/);
+});
+
+test('cross placeholders without valid metric ids never become available numeric values', () => {
+  const cells = [null, undefined, '', ' ', 12].map(dId => ({...crossMetric('12'), dId, value: 12}));
+  const data = normalize(cross([node('year', '2024', null, cells.map(() => ({})))], [node('region', '东部', null, cells)])).datasets[0];
+  for (const cell of data.rows[0].cells.slice(1)) {
+    assert.equal(cell.state, 'UNAVAILABLE');
+    assert.equal(cell.value, null);
+    assert.equal(cell.sourceFieldId, null);
+  }
+});
+
+test('cross table aligns repeated metric ids by column slots and preserves both axes and totals', () => {
+  for (const totalFirst of [false, true]) {
+    const columns = [node('year', '2024', null, [node('amount', '金额')]), node('year', '2025', null, [node('amount', '金额')])];
+    const summary = node('__summary_dim_id__', '合计', [node('amount', '金额', null, [{}])]);
+    columns.splice(totalFirst ? 0 : columns.length, 0, summary);
+    const values = [crossMetric('9007199254740993.12'), crossMetric('2.50')];
+    values.splice(totalFirst ? 0 : values.length, 0, crossMetric('9007199254740995.62', totalInfo));
+    const source = cross(columns, [node('region', '东部', [node('__summary_dim_id__', null, null, values)]), node('__summary_dim_id__', '合计', [node('amount', '金额', null, values.map(v => ({...v, rowSumInfo: totalInfo})))])]);
+    const result = normalize(source), data = result.datasets[0];
+    assert.equal(result.resultType, 'CROSS_TABLE'); assert.equal(result.normalization, 'COMPLETE');
+    assert.deepEqual(data.rows[0].cells.slice(1).map(c => c.value), values.map(v => v.text));
+    assert.equal(new Set(data.columns.map(c => c.fieldId)).size, 4);
+    assert.equal(data.rows[0].cells[1].sourceFieldId, 'amount');
+    assert.deepEqual(data.rows.map(r => r.kind), ['DATA', 'GRAND_TOTAL']);
+    assert.equal(data.columns[totalFirst ? 1 : 3].kind, 'GRAND_TOTAL');
+    assert.equal(result.range.mode, 'INITIAL_VIEW'); assert.equal(result.range.page, null);
+    assert.deepEqual(result.range.axes, {horizontal: {hasNext: true, hasPrevious: false}, vertical: {hasNext: false, hasPrevious: false}});
+    assert.equal(result.range.hasNext, true); assert.ok(result.warnings.includes('NEXT_PAGE_UNSUPPORTED'));
+    const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
+    assert.match(html, /2024/); assert.match(html, /2025/); assert.match(html, /总计/);
+    assert.match(tableCsv(data, data.rows), /9007199254740993.12/);
+    assert.equal(source.previewResult.top.items[0].children.length, 3);
+  }
+});
+
+test('cross table supports metrics on rows and multi-level columns without id joins', () => {
+  const source = cross([node('year', '2024', [node('quarter', 'Q1', null, []), node('quarter', 'Q2', null, [])])], [
+    node('region', '东部', [node('target-name', '金额', [node('amount', '金额', null, [crossMetric('12'), crossMetric('18')])]), node('target-name', '数量', [node('count', '数量', null, [crossMetric('3', detailInfo, detailInfo, 'count'), crossMetric('4', detailInfo, detailInfo, 'count')])])]),
+  ]);
+  const data = normalize(source).datasets[0];
+  assert.equal(data.columns.length, 3); assert.equal(data.rows.length, 2);
+  assert.match(data.columns[1].name, /2024.*Q1/);
+  assert.match(data.rows[1].cells[0].display, /东部.*数量/);
+  assert.deepEqual(data.rows[1].cells.slice(1).map(c => c.sourceFieldId), ['count', 'count']);
+});
+
+test('cross table never exposes restricted axis labels and retains missing/ambiguous value states', () => {
+  const secret = node('year', 'secret column', null, [{}]); secret.authority = false;
+  const row = node('region', 'secret row', null, [crossMetric('123')]); row.authority = false;
+  const result = normalize(cross([secret], [row]));
+  assert.doesNotMatch(JSON.stringify(result), /secret column|secret row/);
+  assert.equal(result.datasets[0].rows[0].cells[0].state, 'RESTRICTED');
+  assert.equal(result.datasets[0].rows[0].cells[1].state, 'RESTRICTED');
+  const source = cross([node('year', 'A', null, [{}, {}])], [node('region', 'X', null, [{...crossMetric('1万'), formatText: '1万'}])]);
+  const incomplete = normalize(source);
+  assert.equal(incomplete.normalization, 'PARTIAL');
+  assert.equal(incomplete.datasets[0].rows[0].cells[1].state, 'UNAVAILABLE');
+  assert.equal(incomplete.datasets[0].rows[0].cells[2].reason, 'MISSING_CELL');
+  source.previewResult.left.items[0].children[0].values.push(crossMetric('2'), crossMetric('3'));
+  assert.equal(normalize(source).normalization, 'UNSUPPORTED', 'extra values must not be silently dropped');
+});
+
+test('cross table distinguishes empty views, missing axes and unsupported mixed node topology', () => {
+  assert.equal(normalize(cross([], [])).normalization, 'COMPLETE');
+  assert.equal(normalize(cross([], [])).datasets[0].returnedRowCount, 0);
+  assert.equal(normalize({previewResult: {resultType: 'BICROSS', left: {header: [], items: []}}}).normalization, 'UNSUPPORTED');
+  assert.equal(normalize(cross([node('x', 'A', [node('x', 'B')], [{}])], [])).normalization, 'UNSUPPORTED');
+});
+
+test('cross table handles no column dimensions and preserves metric-name intersection placeholders', () => {
+  const source = cross([], [node('target', '金额', null, [crossMetric('7'), {dId: null, text: null, value: null, authority: true}])]);
+  source.previewResult.top = {header: [], items: []};
+  const result = normalize(source);
+  assert.equal(result.normalization, 'COMPLETE');
+  assert.deepEqual(result.datasets[0].rows[0].cells.slice(1).map(c => c.state), ['AVAILABLE', 'UNAVAILABLE']);
+  assert.equal(result.datasets[0].rows[0].cells[2].value, null);
+  const swapped = cross([node('year', '2024', null, [node('amount', '金额')])], [node('region', '东部', null, [crossMetric('1', detailInfo, detailInfo, 'count')])]);
+  assert.equal(normalize(swapped).normalization, 'PARTIAL');
+  assert.equal(normalize(swapped).datasets[0].rows[0].cells[1].reason, 'AMBIGUOUS_FIELD');
+});
+
+test('group preserves parent keys, totals, metric precision and the first group page', () => {
+  const source = group([{dId: 'region', text: '东部', authority: true, values: [metric('9007199254740993.12', {totalSum: false, innerSum: true})], children: [
+    {dId: 'city', text: '甲城', authority: true, values: [metric('12.50', undefined, {formatText: '12.50元'})]},
+  ]}, {values: [metric('9007199254741005.62', {totalSum: true, innerSum: false})]}]);
+  const result = normalize(source), data = result.datasets[0];
+  assert.equal(result.resultType, 'GROUP_TABLE');
+  assert.equal(result.normalization, 'COMPLETE');
+  assert.deepEqual(data.rows.map(r => r.kind), ['SUBTOTAL', 'DATA', 'GRAND_TOTAL']);
+  assert.deepEqual(data.rows[1].cells.map(c => c.value), ['东部', '甲城', '12.50']);
+  assert.equal(data.rows[0].cells[2].value, '9007199254740993.12');
+  assert.equal(data.returnedRowCount, 3);
+  assert.deepEqual(result.range, {mode: 'PAGE', page: 1, pageSize: 10, pageUnit: 'GROUP', hasNext: true, hasPrevious: false, total: {value: null, unit: 'GROUP'}});
+  assert.ok(result.warnings.includes('NEXT_PAGE_UNSUPPORTED'));
+  const html = renderToStaticMarkup(createElement(DataTable, {dataset: data, pageSize: 10, binding: {type: 'table'}}));
+  assert.match(html, /小计/); assert.match(html, /总计/);
+  assert.match(tableCsv(data, data.rows), /GRAND_TOTAL/);
+});
+
+test('group keeps restricted and ambiguous cells unavailable and does not infer numeric group keys', () => {
+  const source = group([{dId: 'region', text: '42', authority: true, values: [metric('12万', undefined, {formatText: '12万'})], children: [
+    {dId: 'city', text: '秘密', authority: false, values: [metric('999', undefined, {authority: false})]},
+    {dId: 'city', text: '乙城', authority: true, values: [metric('1'), metric('2')]},
+    {dId: 'city', text: '丙城', authority: true, values: [metric(null, null)]},
+  ]}]);
+  source.widgetBean.dimensions.region.type = 2;
+  const result = normalize(source), rows = result.datasets[0].rows;
+  assert.equal(rows[0].cells[0].reason, 'GROUP_KEY_SEMANTICS_UNKNOWN');
+  assert.equal(rows[0].cells[2].state, 'UNAVAILABLE');
+  assert.equal(rows[1].cells[1].state, 'RESTRICTED');
+  assert.equal(rows[1].cells[2].state, 'RESTRICTED');
+  assert.equal(rows[2].cells[2].reason, 'AMBIGUOUS_FIELD');
+  assert.equal(rows[3].cells[2].state, 'UNAVAILABLE');
+  assert.equal(rows[3].kind, 'UNKNOWN');
+  assert.equal(result.normalization, 'PARTIAL');
+});
+
+test('group header expansion reports an initial view and malformed groups are not empty successes', () => {
+  const source = group([]);
+  source.widgetBean.settings.tableStyle.showRowHeaderIcon = true;
+  const result = normalize(source);
+  assert.equal(result.range.mode, 'INITIAL_VIEW');
+  assert.equal(result.range.page, null);
+  assert.equal(result.range.hasNext, null);
+  assert.equal(result.datasets[0].returnedRowCount, 0);
+  assert.equal(normalize({previewResult: {resultType: 'BIGROUP'}}).normalization, 'UNSUPPORTED');
+  source.previewResult.items = [null, {dId: 'unknown', values: [metric('1')]}];
+  assert.equal(normalize(source).normalization, 'PARTIAL');
+});

package/templates/web-app/tsconfig.json

@@ -1,4 +1,4 @@
-{
-  "compilerOptions": {"target":"ES2020","lib":["ES2020","DOM","DOM.Iterable"],"module":"ESNext","moduleResolution":"Bundler","jsx":"react-jsx","strict":true,"skipLibCheck":true,"esModuleInterop":true,"resolveJsonModule":true,"isolatedModules":true,"noEmit":true},
-  "include":["src","vite.config.ts"]
-}
+{
+  "compilerOptions": {"target":"ES2020","lib":["ES2020","DOM","DOM.Iterable"],"module":"ESNext","moduleResolution":"Bundler","jsx":"react-jsx","strict":true,"skipLibCheck":true,"esModuleInterop":true,"resolveJsonModule":true,"isolatedModules":true,"noEmit":true},
+  "include":["src","vite.config.ts"]
+}