Files
vibemake/js/assembly-groups.js
T

90 lines
4.8 KiB
JavaScript

// Optional grouped playback. Legacy manifests remain cumulative.
export const isGroupedAssembly = pkg => ['grouped-v1', 'scoped-v1'].includes(pkg?.playback);
export function validateAssemblyGroups(pkg) {
const fail = message => { throw new Error(message); };
if (!isGroupedAssembly(pkg)) {
if (pkg.playback !== undefined || pkg.groups !== undefined || pkg.steps.some(s => s.groupId || s.type === 'join')) fail('分组装配需要受支持的 playback 协议');
return;
}
if (!Array.isArray(pkg.groups) || !pkg.groups.length || pkg.groups.length > 100) fail('分组装配需要有效的部件清单');
const byId = new Map(pkg.parts.map(p => [p.id, p]));
const membership = new Map(), groupIds = new Set();
pkg.groups = pkg.groups.map(g => {
if (!/^[a-zA-Z0-9_-]{1,100}$/.test(g.id) || groupIds.has(g.id) || !Array.isArray(g.parts) || !g.parts.length) fail('部件编号重复或零件清单无效');
groupIds.add(g.id);
for (const id of g.parts) {
if (!byId.has(id) || membership.has(id)) fail(`部件包含未知或重复的零件:${id}`);
membership.set(id, g.id);
}
return { id: g.id, label: String(g.label || g.id).slice(0, 120), parts: [...g.parts] };
});
for (const p of pkg.parts) if (p.parentId && membership.get(p.id) !== membership.get(p.parentId)) fail('父子零件必须属于同一部件');
if (pkg.playback === 'scoped-v1') {
if (membership.size !== pkg.parts.length) fail('按范围装配必须包含全部零件的分组');
const built = new Set();
for (const step of pkg.steps) {
if (!step.visibleParts || !groupIds.has(step.groupId)) fail('按范围装配需要完整显示清单和有效部件编号');
if (step.parts.some(id => membership.get(id) !== step.groupId)) fail('步骤引用的零件不属于当前部件');
if (step.type === 'join') {
const members = pkg.groups.find(g => g.id === step.groupId).parts;
if (members.length !== step.parts.length || members.some(id => !built.has(id))) fail('合装步骤必须包含整个已完成部件');
} else {
for (const id of step.parts) built.add(id);
}
}
return;
}
const built = new Set(), joined = new Set();
let groupIndex = 0, joining = false, finishing = false;
for (const step of pkg.steps) {
if (step.type === 'join') {
if (finishing || joined.has(step.groupId) || !groupIds.has(step.groupId) || built.size !== membership.size) fail('合装前须完成全部部件,且每个部件只能合装一次');
const members = pkg.groups.find(g => g.id === step.groupId).parts;
if (members.length !== step.parts.length || step.parts.some(id => membership.get(id) !== step.groupId)) fail('合装步骤必须包含整个部件');
joining = true;
joined.add(step.groupId);
} else if (step.groupId) {
if (joining || finishing || !groupIds.has(step.groupId)) fail('合装开始后不能再返回部件内部装配');
if (step.groupId !== pkg.groups[groupIndex].id) {
if (!pkg.groups[groupIndex].parts.every(id => built.has(id))) fail('切换部件前须完成当前部件');
groupIndex++;
if (step.groupId !== pkg.groups[groupIndex]?.id) fail('部件必须按清单顺序逐组安装');
}
for (const id of step.parts) {
if (membership.get(id) !== step.groupId) fail('步骤引用的零件不属于当前部件');
built.add(id);
}
} else {
if (joined.size !== groupIds.size || step.parts.some(id => membership.has(id))) fail('总装散件须在全部部件合装后安装');
finishing = true;
}
}
if (joined.size !== groupIds.size) fail('装配步骤缺少部件合装');
}
export function assemblyStageKey(pkg, index) {
const step = index === null ? null : pkg.steps[index];
if (!isGroupedAssembly(pkg) || !step?.groupId || step.type === 'join') return null;
if (pkg.playback === 'scoped-v1') {
const members = new Set(pkg.groups.find(g => g.id === step.groupId)?.parts);
if (step.visibleParts.some(id => !members.has(id))) return null;
}
return step.groupId;
}
export function groupedVisibleParts(pkg, index) {
const step = pkg.steps[index];
const history = pkg.steps.slice(0, index + 1);
if (step.groupId && step.type !== 'join') return new Set(history.filter(s => s.groupId === step.groupId).flatMap(s => s.parts));
// Local builds are hidden until their explicit joining step is reached.
return new Set(history.filter(s => s.type === 'join' || !s.groupId).flatMap(s => s.parts));
}
// All roots of a completed subassembly receive the SAME translation. Descendants
// inherit it once, so replaying a join cannot separate its screws from its frame.
export function stepEntryOffset(step, part) {
if (step?.type !== 'join') return part.installOffset;
return part.parentId && step.parts.includes(part.parentId) ? null : step.installOffset;
}