@yanqirenshi/d3.sql 0.1.0

package/tests/SqlModel.test.js

@@ -0,0 +1,135 @@
+import SqlModel, {
+    withDerivedColumns,
+    markFinalResult,
+    groupByJoin,
+    orderByJoinAB,
+    estimateLabelWidth,
+    buildLayout,
+    buildJoinLines,
+    buildLineageLines,
+    findRowY,
+    HEADER_H,
+    ROW_H,
+    BOX_W,
+} from '../src/js/SqlModel.js';
+
+describe('withDerivedColumns', () => {
+    it('columns 未指定なら lineage/join で参照される列を初出順に導出する', () => {
+        const entities = [{ id: 't1', kind: 'table', title: 'a' }, { id: 'r1', kind: 'result', title: 'Result 1' }];
+        const lineage = [
+            { from: { entity: 't1', column: 'x' }, to: { entity: 'r1', column: 'out_x' } },
+            { from: { entity: 't1', column: 'y' }, to: { entity: 'r1', column: 'out_y' } },
+        ];
+        const joins = [{ a: { entity: 't1', column: 'id' }, b: { entity: 'r1', column: 'ref' } }];
+
+        const [t1, r1] = withDerivedColumns(entities, lineage, joins);
+        expect(t1.columns).toEqual(['x', 'y', 'id']);
+        expect(r1.columns).toEqual(['out_x', 'out_y', 'ref']);
+    });
+
+    it('明示された columns を優先し、from が配列/null のエッジも扱える', () => {
+        const entities = [{ id: 't1', kind: 'table', title: 'a', columns: ['own'] }, { id: 'r1', kind: 'result', title: 'Result 1' }];
+        const lineage = [
+            { from: [{ entity: 't1', column: 'x' }, { entity: 't1', column: 'y' }], to: { entity: 'r1', column: 'joined' } },
+            { from: null, to: { entity: 'r1', column: 'lit' }, label: "'L'" },
+        ];
+
+        const [t1, r1] = withDerivedColumns(entities, lineage, []);
+        expect(t1.columns).toEqual(['own']);          // 明示 columns 優先
+        expect(r1.columns).toEqual(['joined', 'lit']);
+    });
+});
+
+describe('markFinalResult', () => {
+    it('一番番号の大きい Result N を黒背景白文字の「Result」にする', () => {
+        const entities = [
+            { id: 'r1', kind: 'result', title: 'Result 1' },
+            { id: 'r2', kind: 'result', title: 'Result 2' },
+            { id: 't1', kind: 'table', title: 'a' },
+        ];
+        const marked = markFinalResult(entities);
+
+        expect(marked[0].title).toBe('Result 1');    // 中間はそのまま
+        expect(marked[1].title).toBe('Result');
+        expect(marked[1].headerColor).toBe('#000000');
+        expect(marked[1].headerTextColor).toBe('#ffffff');
+        expect(marked[2].title).toBe('a');
+    });
+});
+
+describe('groupByJoin / orderByJoinAB', () => {
+    it('JOIN で繋がるエンティティを同じグループにまとめる', () => {
+        const entities = [{ id: 'a' }, { id: 'b' }, { id: 'c' }];
+        const joins = [{ a: { entity: 'a', column: 'id' }, b: { entity: 'b', column: 'id' } }];
+
+        const { find, groups } = groupByJoin(entities, joins);
+        expect(find('a')).toBe(find('b'));
+        expect(find('a')).not.toBe(find('c'));
+        expect(groups[find('a')].map((e) => e.id).sort()).toEqual(['a', 'b']);
+    });
+
+    it('JOIN の a 側を上、b 側を下に並べる', () => {
+        const joins = [{ a: { entity: 'a', column: 'id' }, b: { entity: 'b', column: 'id' } }];
+        expect(orderByJoinAB(['b', 'a'], joins)).toEqual(['a', 'b']);
+    });
+});
+
+describe('estimateLabelWidth', () => {
+    it('全角文字は半角より広く見積もる', () => {
+        expect(estimateLabelWidth(null)).toBe(0);
+        expect(estimateLabelWidth('AB')).toBe(8 + 7 * 2);
+        expect(estimateLabelWidth('集約')).toBe(8 + 13 * 2);
+    });
+});
+
+describe('buildLayout / findRowY / 線の幾何', () => {
+    const entities = [
+        { id: 't1', kind: 'table', title: 'orders', columns: ['id', 'amount'] },
+        { id: 'r1', kind: 'result', title: 'Result', columns: ['total'] },
+    ];
+    const positions = { t1: { x: 400, y: 0 }, r1: { x: 0, y: 0 } };
+    const boxes = buildLayout(entities, positions, { orders: '#4e79a7' });
+
+    it('箱の寸法と行のYを計算する(ヘッダ + 行数 × 行高)', () => {
+        expect(boxes.t1.w).toBe(BOX_W);
+        expect(boxes.t1.h).toBe(HEADER_H + 2 * ROW_H);
+        expect(boxes.t1.headerColor).toBe('#4e79a7');   // table はテーブル色
+        expect(boxes.r1.headerColor).toBeNull();        // result は既定
+        expect(findRowY(boxes.t1, 'id')).toBe(HEADER_H + ROW_H / 2);
+        expect(findRowY(boxes.t1, 'amount')).toBe(HEADER_H + ROW_H + ROW_H / 2);
+        expect(findRowY(boxes.t1, 'missing')).toBeNull();
+    });
+
+    it('JOIN 線は a の左に分岐点(branchX)を持ち、索引に登録される', () => {
+        const { lines, branchPointByPort } = buildJoinLines(boxes, [
+            { a: { entity: 't1', column: 'id' }, b: { entity: 'r1', column: 'total' }, joinType: 'INNER' },
+        ]);
+
+        expect(lines).toHaveLength(1);
+        expect(lines[0].branchX).toBe(boxes.t1.x - 20);
+        expect(branchPointByPort['t1.id']).toBe(lines[0].branchX);
+    });
+
+    it('リネージ線は from → to の座標を持ち、from: null はラベルのみの矢印になる', () => {
+        const lines = buildLineageLines(boxes, [
+            { from: { entity: 't1', column: 'amount' }, to: { entity: 'r1', column: 'total' }, label: 'SUM' },
+            { from: null, to: { entity: 'r1', column: 'total' }, label: "'0'" },
+        ], {});
+
+        expect(lines).toHaveLength(2);
+        expect(lines[0].sources[0].y).toBe(findRowY(boxes.t1, 'amount'));
+        expect(lines[0].x2).toBe(boxes.r1.x + boxes.r1.w);
+        expect(lines[1].showPort).toBe(false);          // リテラル値は由来なし
+    });
+});
+
+describe('SqlModel', () => {
+    it('データ無しでも空のモデルとして構築できる(描画側の null ガード用)', () => {
+        const model = new SqlModel(null);
+
+        expect(model.boxList()).toEqual([]);
+        expect(model.joinLines).toEqual([]);
+        expect(model.lineageLines).toEqual([]);
+        expect(model.initialTransform()).toEqual({ x: 0, y: 0, k: 1 });
+    });
+});

package/tests/d3-dag-stub.js

@@ -0,0 +1,4 @@
+// jest 用の d3-dag スタブ(ESM-only のため CJS の jest では読めない)。
+// 自動レイアウト(buildAutoPositions)以外のデータ層は d3-dag を使わない。
+// d3-dag を通るレイアウトはブラウザ検証で担保する。
+module.exports = {};

package/tests/d3-stub.js

@@ -0,0 +1,19 @@
+// jest 用の d3 スタブ。
+// d3 v7 は ESM-only のため CJS ランタイムの jest では読み込めない。
+// テスト対象(データクラス)のうち色割り当て(scaleOrdinal)だけが d3 を
+// 使うので、決定的な単純スタブを返す。
+module.exports = {
+    scaleOrdinal: (scheme) => {
+        const assigned = {};
+        let i = 0;
+        const scale = (key) => {
+            if (!(key in assigned))
+                assigned[key] = scheme[i++ % scheme.length];
+            return assigned[key];
+        };
+        scale.domain = () => scale;
+        return scale;
+    },
+    schemeTableau10: ['#4e79a7', '#f28e2c', '#e15759', '#76b7b2', '#59a14f',
+                      '#edc949', '#af7aa1', '#ff9da7', '#9c755f', '#bab0ab'],
+};