feat: rng & commands impl & tests
This commit is contained in:
hyper
@@ -0,0 +1,226 @@
|
||||
import { describe, it, expect, beforeEach } from 'vitest';
|
||||
import { applyAlign, shuffle, type Region, type RegionAxis } from '../../src/core/region';
|
||||
import { createRNG } from '../../src/utils/rng';
|
||||
import { createEntityCollection } from '../../src/utils/entity';
|
||||
import { type Part } from '../../src/core/part';
|
||||
|
||||
describe('Region', () => {
|
||||
function createPart(id: string, position: number[]): Part {
|
||||
const collection = createEntityCollection<Part>();
|
||||
const part: Part = {
|
||||
id,
|
||||
sides: 1,
|
||||
side: 0,
|
||||
region: { id: 'region1', value: {} as Region },
|
||||
position: [...position]
|
||||
};
|
||||
collection.add(part);
|
||||
return part;
|
||||
}
|
||||
|
||||
function createRegion(axes: RegionAxis[], parts: Part[]): Region {
|
||||
const region: Region = {
|
||||
id: 'region1',
|
||||
axes: [...axes],
|
||||
children: parts.map(p => ({ id: p.id, value: p }))
|
||||
};
|
||||
return region;
|
||||
}
|
||||
|
||||
describe('applyAlign', () => {
|
||||
it('should do nothing with empty region', () => {
|
||||
const region = createRegion([{ name: 'x', min: 0, align: 'start' }], []);
|
||||
applyAlign(region);
|
||||
expect(region.children).toHaveLength(0);
|
||||
});
|
||||
|
||||
it('should align parts to start', () => {
|
||||
const part1 = createPart('p1', [5, 0]);
|
||||
const part2 = createPart('p2', [7, 0]);
|
||||
const part3 = createPart('p3', [2, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', min: 0, align: 'start' }],
|
||||
[part1, part2, part3]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
// 排序后应该是 part3(2), part1(5), part2(7) -> 对齐到 0, 1, 2
|
||||
expect(region.children[0].value.position[0]).toBe(0);
|
||||
expect(region.children[1].value.position[0]).toBe(1);
|
||||
expect(region.children[2].value.position[0]).toBe(2);
|
||||
});
|
||||
|
||||
it('should align parts to start with custom min', () => {
|
||||
const part1 = createPart('p1', [5, 0]);
|
||||
const part2 = createPart('p2', [7, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', min: 10, align: 'start' }],
|
||||
[part1, part2]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
expect(region.children[0].value.position[0]).toBe(10);
|
||||
expect(region.children[1].value.position[0]).toBe(11);
|
||||
});
|
||||
|
||||
it('should align parts to end', () => {
|
||||
const part1 = createPart('p1', [2, 0]);
|
||||
const part2 = createPart('p2', [4, 0]);
|
||||
const part3 = createPart('p3', [1, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', max: 10, align: 'end' }],
|
||||
[part1, part2, part3]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
// 3 个部分，对齐到 end(max=10)，应该是 8, 9, 10
|
||||
expect(region.children[0].value.position[0]).toBe(8);
|
||||
expect(region.children[1].value.position[0]).toBe(9);
|
||||
expect(region.children[2].value.position[0]).toBe(10);
|
||||
});
|
||||
|
||||
it('should align parts to center', () => {
|
||||
const part1 = createPart('p1', [0, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
const part3 = createPart('p3', [2, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', min: 0, max: 10, align: 'center' }],
|
||||
[part1, part2, part3]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
// 中心是 5，3 个部分应该是 4, 5, 6
|
||||
expect(region.children[0].value.position[0]).toBe(4);
|
||||
expect(region.children[1].value.position[0]).toBe(5);
|
||||
expect(region.children[2].value.position[0]).toBe(6);
|
||||
});
|
||||
|
||||
it('should handle even count center alignment', () => {
|
||||
const part1 = createPart('p1', [0, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', min: 0, max: 10, align: 'center' }],
|
||||
[part1, part2]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
// 中心是 5，2 个部分应该是 4.5, 5.5
|
||||
expect(region.children[0].value.position[0]).toBe(4.5);
|
||||
expect(region.children[1].value.position[0]).toBe(5.5);
|
||||
});
|
||||
|
||||
it('should sort children by position', () => {
|
||||
const part1 = createPart('p1', [5, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
const part3 = createPart('p3', [3, 0]);
|
||||
|
||||
const region = createRegion(
|
||||
[{ name: 'x', min: 0, align: 'start' }],
|
||||
[part1, part2, part3]
|
||||
);
|
||||
|
||||
applyAlign(region);
|
||||
|
||||
// children 应该按位置排序
|
||||
expect(region.children[0].value.id).toBe('p2');
|
||||
expect(region.children[1].value.id).toBe('p3');
|
||||
expect(region.children[2].value.id).toBe('p1');
|
||||
});
|
||||
});
|
||||
|
||||
describe('shuffle', () => {
|
||||
it('should do nothing with empty region', () => {
|
||||
const region = createRegion([], []);
|
||||
const rng = createRNG(42);
|
||||
shuffle(region, rng);
|
||||
expect(region.children).toHaveLength(0);
|
||||
});
|
||||
|
||||
it('should do nothing with single part', () => {
|
||||
const part = createPart('p1', [0, 0]);
|
||||
const region = createRegion([], [part]);
|
||||
const rng = createRNG(42);
|
||||
shuffle(region, rng);
|
||||
expect(region.children[0].value.position).toEqual([0, 0]);
|
||||
});
|
||||
|
||||
it('should shuffle positions of multiple parts', () => {
|
||||
const part1 = createPart('p1', [0, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
const part3 = createPart('p3', [2, 0]);
|
||||
|
||||
const region = createRegion([], [part1, part2, part3]);
|
||||
const rng = createRNG(42);
|
||||
|
||||
const originalPositions = region.children.map(c => [...c.value.position]);
|
||||
shuffle(region, rng);
|
||||
|
||||
// 位置应该被交换
|
||||
const newPositions = region.children.map(c => c.value.position);
|
||||
|
||||
// 验证所有原始位置仍然存在（只是被交换了）
|
||||
originalPositions.forEach(origPos => {
|
||||
const found = newPositions.some(newPos =>
|
||||
newPos[0] === origPos[0] && newPos[1] === origPos[1]
|
||||
);
|
||||
expect(found).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
it('should be deterministic with same seed', () => {
|
||||
const createRegionForTest = () => {
|
||||
const part1 = createPart('p1', [0, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
const part3 = createPart('p3', [2, 0]);
|
||||
return createRegion([], [part1, part2, part3]);
|
||||
};
|
||||
|
||||
const region1 = createRegionForTest();
|
||||
const region2 = createRegionForTest();
|
||||
|
||||
const rng1 = createRNG(42);
|
||||
const rng2 = createRNG(42);
|
||||
|
||||
shuffle(region1, rng1);
|
||||
shuffle(region2, rng2);
|
||||
|
||||
const positions1 = region1.children.map(c => c.value.position);
|
||||
const positions2 = region2.children.map(c => c.value.position);
|
||||
|
||||
expect(positions1).toEqual(positions2);
|
||||
});
|
||||
|
||||
it('should produce different results with different seeds', () => {
|
||||
const part1 = createPart('p1', [0, 0]);
|
||||
const part2 = createPart('p2', [1, 0]);
|
||||
const part3 = createPart('p3', [2, 0]);
|
||||
const part4 = createPart('p4', [3, 0]);
|
||||
const part5 = createPart('p5', [4, 0]);
|
||||
|
||||
const results = new Set<string>();
|
||||
|
||||
// 尝试多个种子，确保大多数产生不同结果
|
||||
for (let seed = 1; seed <= 10; seed++) {
|
||||
const region = createRegion([], [part1, part2, part3, part4, part5]);
|
||||
const rng = createRNG(seed);
|
||||
shuffle(region, rng);
|
||||
|
||||
const positions = JSON.stringify(region.children.map(c => c.value.position));
|
||||
results.add(positions);
|
||||
}
|
||||
|
||||
// 10 个种子中至少应该有 5 个不同的结果
|
||||
expect(results.size).toBeGreaterThan(5);
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,114 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { parseCommand, type Command } from '../../src/utils/command';
|
||||
|
||||
describe('parseCommand', () => {
|
||||
it('should parse empty string', () => {
|
||||
const result = parseCommand('');
|
||||
expect(result).toEqual({
|
||||
name: '',
|
||||
flags: {},
|
||||
options: {},
|
||||
params: []
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command name only', () => {
|
||||
const result = parseCommand('move');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: {},
|
||||
options: {},
|
||||
params: []
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with params', () => {
|
||||
const result = parseCommand('move meeple1 region1');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: {},
|
||||
options: {},
|
||||
params: ['meeple1', 'region1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with long flags', () => {
|
||||
const result = parseCommand('move meeple1 --force --quiet');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: { force: true, quiet: true },
|
||||
options: {},
|
||||
params: ['meeple1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with short flags', () => {
|
||||
const result = parseCommand('move meeple1 -f -q');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: { f: true, q: true },
|
||||
options: {},
|
||||
params: ['meeple1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with long options', () => {
|
||||
const result = parseCommand('move meeple1 --x 10 --y 20');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: {},
|
||||
options: { x: '10', y: '20' },
|
||||
params: ['meeple1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with short options', () => {
|
||||
const result = parseCommand('move meeple1 -x 10 -y 20');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: {},
|
||||
options: { x: '10', y: '20' },
|
||||
params: ['meeple1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse command with mixed flags和选项', () => {
|
||||
const result = parseCommand('move meeple1 region1 --force -x 10 -q');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: { force: true, q: true },
|
||||
options: { x: '10' },
|
||||
params: ['meeple1', 'region1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should handle extra whitespace', () => {
|
||||
const result = parseCommand(' move meeple1 --force ');
|
||||
expect(result).toEqual({
|
||||
name: 'move',
|
||||
flags: { force: true },
|
||||
options: {},
|
||||
params: ['meeple1']
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse complex command', () => {
|
||||
const result = parseCommand('place meeple1 board --x 5 --y 3 --rotate 90 --force');
|
||||
expect(result).toEqual({
|
||||
name: 'place',
|
||||
flags: { force: true },
|
||||
options: { x: '5', y: '3', rotate: '90' },
|
||||
params: ['meeple1', 'board']
|
||||
});
|
||||
});
|
||||
|
||||
it('should treat negative number as option value', () => {
|
||||
const result = parseCommand('set --value -10');
|
||||
expect(result).toEqual({
|
||||
name: 'set',
|
||||
flags: {},
|
||||
options: { value: '-10' },
|
||||
params: []
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,117 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { createEntityCollection, type Entity } from '../../src/utils/entity';
|
||||
|
||||
interface TestEntity extends Entity {
|
||||
name: string;
|
||||
value: number;
|
||||
}
|
||||
|
||||
describe('createEntityCollection', () => {
|
||||
it('should create empty collection', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
expect(collection.collection.value).toEqual({});
|
||||
});
|
||||
|
||||
it('should add single entity', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
|
||||
collection.add(entity);
|
||||
|
||||
expect(collection.collection.value).toHaveProperty('e1');
|
||||
expect(collection.get('e1').value).toEqual(entity);
|
||||
});
|
||||
|
||||
it('should add multiple entities', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity1: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
const entity2: TestEntity = { id: 'e2', name: 'Entity 2', value: 20 };
|
||||
const entity3: TestEntity = { id: 'e3', name: 'Entity 3', value: 30 };
|
||||
|
||||
collection.add(entity1, entity2, entity3);
|
||||
|
||||
expect(Object.keys(collection.collection.value)).toHaveLength(3);
|
||||
expect(collection.get('e1').value.name).toBe('Entity 1');
|
||||
expect(collection.get('e2').value.name).toBe('Entity 2');
|
||||
expect(collection.get('e3').value.name).toBe('Entity 3');
|
||||
});
|
||||
|
||||
it('should remove single entity', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity1: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
const entity2: TestEntity = { id: 'e2', name: 'Entity 2', value: 20 };
|
||||
|
||||
collection.add(entity1, entity2);
|
||||
collection.remove('e1');
|
||||
|
||||
expect(Object.keys(collection.collection.value)).toHaveLength(1);
|
||||
expect(collection.collection.value).not.toHaveProperty('e1');
|
||||
expect(collection.collection.value).toHaveProperty('e2');
|
||||
});
|
||||
|
||||
it('should remove multiple entities', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity1: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
const entity2: TestEntity = { id: 'e2', name: 'Entity 2', value: 20 };
|
||||
const entity3: TestEntity = { id: 'e3', name: 'Entity 3', value: 30 };
|
||||
|
||||
collection.add(entity1, entity2, entity3);
|
||||
collection.remove('e1', 'e3');
|
||||
|
||||
expect(Object.keys(collection.collection.value)).toHaveLength(1);
|
||||
expect(collection.collection.value).toHaveProperty('e2');
|
||||
});
|
||||
|
||||
it('should update entity via accessor', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
|
||||
collection.add(entity);
|
||||
|
||||
const accessor = collection.get('e1');
|
||||
accessor.value = { ...entity, value: 100, name: 'Updated' };
|
||||
|
||||
expect(collection.get('e1').value.value).toBe(100);
|
||||
expect(collection.get('e1').value.name).toBe('Updated');
|
||||
});
|
||||
|
||||
it('should return undefined for non-existent entity', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
|
||||
expect(collection.get('nonexistent').value).toBeUndefined();
|
||||
});
|
||||
|
||||
it('should have correct accessor id', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
|
||||
collection.add(entity);
|
||||
|
||||
const accessor = collection.get('e1');
|
||||
expect(accessor.id).toBe('e1');
|
||||
});
|
||||
|
||||
it('should handle removing non-existent entity', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
|
||||
collection.add(entity);
|
||||
collection.remove('nonexistent');
|
||||
|
||||
expect(Object.keys(collection.collection.value)).toHaveLength(1);
|
||||
});
|
||||
|
||||
it('should work with reactive updates', () => {
|
||||
const collection = createEntityCollection<TestEntity>();
|
||||
const entity: TestEntity = { id: 'e1', name: 'Entity 1', value: 10 };
|
||||
|
||||
collection.add(entity);
|
||||
|
||||
// 验证 accessor 可以正确获取和设置值
|
||||
const accessor = collection.get('e1');
|
||||
expect(accessor.value.value).toBe(10);
|
||||
|
||||
accessor.value = { ...entity, value: 50 };
|
||||
expect(accessor.value.value).toBe(50);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,98 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { createRNG } from '../../src/utils/rng';
|
||||
|
||||
describe('createRNG', () => {
|
||||
it('should create RNG with default seed', () => {
|
||||
const rng = createRNG();
|
||||
expect(rng.getSeed()).toBe(1);
|
||||
});
|
||||
|
||||
it('should create RNG with custom seed', () => {
|
||||
const rng = createRNG(12345);
|
||||
expect(rng.getSeed()).toBe(12345);
|
||||
});
|
||||
|
||||
it('should generate numbers in range [0, 1)', () => {
|
||||
const rng = createRNG(42);
|
||||
for (let i = 0; i < 100; i++) {
|
||||
const num = rng.next();
|
||||
expect(num).toBeGreaterThanOrEqual(0);
|
||||
expect(num).toBeLessThan(1);
|
||||
}
|
||||
});
|
||||
|
||||
it('should generate numbers with max parameter', () => {
|
||||
const rng = createRNG(42);
|
||||
for (let i = 0; i < 100; i++) {
|
||||
const num = rng.next(100);
|
||||
expect(num).toBeGreaterThanOrEqual(0);
|
||||
expect(num).toBeLessThan(100);
|
||||
}
|
||||
});
|
||||
|
||||
it('should generate integers in range [0, max)', () => {
|
||||
const rng = createRNG(42);
|
||||
for (let i = 0; i < 100; i++) {
|
||||
const num = rng.nextInt(10);
|
||||
expect(Number.isInteger(num)).toBe(true);
|
||||
expect(num).toBeGreaterThanOrEqual(0);
|
||||
expect(num).toBeLessThan(10);
|
||||
}
|
||||
});
|
||||
|
||||
it('should be deterministic with same seed', () => {
|
||||
const rng1 = createRNG(12345);
|
||||
const rng2 = createRNG(12345);
|
||||
|
||||
const sequence1 = Array.from({ length: 10 }, () => rng1.next());
|
||||
const sequence2 = Array.from({ length: 10 }, () => rng2.next());
|
||||
|
||||
expect(sequence1).toEqual(sequence2);
|
||||
});
|
||||
|
||||
it('should produce different sequences with different seeds', () => {
|
||||
const rng1 = createRNG(12345);
|
||||
const rng2 = createRNG(54321);
|
||||
|
||||
const sequence1 = Array.from({ length: 10 }, () => rng1.next());
|
||||
const sequence2 = Array.from({ length: 10 }, () => rng2.next());
|
||||
|
||||
expect(sequence1).not.toEqual(sequence2);
|
||||
});
|
||||
|
||||
it('should reset seed with setSeed', () => {
|
||||
const rng = createRNG(42);
|
||||
const firstSequence = Array.from({ length: 5 }, () => rng.next());
|
||||
|
||||
rng.setSeed(42);
|
||||
const secondSequence = Array.from({ length: 5 }, () => rng.next());
|
||||
|
||||
expect(firstSequence).toEqual(secondSequence);
|
||||
});
|
||||
|
||||
it('should work as callable function', () => {
|
||||
const rng = createRNG(42);
|
||||
rng(123);
|
||||
expect(rng.getSeed()).toBe(123);
|
||||
});
|
||||
|
||||
it('should generate uniformly distributed integers', () => {
|
||||
const rng = createRNG(42);
|
||||
const buckets = new Array(10).fill(0);
|
||||
const iterations = 10000;
|
||||
|
||||
for (let i = 0; i < iterations; i++) {
|
||||
const num = rng.nextInt(10);
|
||||
buckets[num]++;
|
||||
}
|
||||
|
||||
// 每个桶应该大约有 10% 的值
|
||||
const expected = iterations / 10;
|
||||
const tolerance = expected * 0.3; // 30% 容差
|
||||
|
||||
buckets.forEach((count, index) => {
|
||||
expect(count).toBeGreaterThan(expected - tolerance);
|
||||
expect(count).toBeLessThan(expected + tolerance);
|
||||
});
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user