export type CinemaGarmentSegmentationLabel = 'background' | 'head' | 'collar' | 'choker' | 'left-shoulder' | 'right-shoulder' | 'garment'; export interface CinemaGarmentMaskAudit { ok: boolean; headPixelCount: number; removedHeadPixelCount: number; headCoverage: number; protectedPixelCount: number; damagedProtectedPixelCount: number; preservedFeatures: string[]; damagedFeatures: string[]; issues: string[]; } const PROTECTED = new Set(['collar', 'choker', 'left-shoulder', 'right-shoulder', 'garment']); export function auditCinemaGarmentRemovalMask(input: { width: number; height: number; labels: CinemaGarmentSegmentationLabel[]; removalMask: boolean[]; }): CinemaGarmentMaskAudit { if (!Number.isInteger(input.width) || input.width < 1 || !Number.isInteger(input.height) || input.height < 1) throw new Error('Garment mask dimensions must be positive integers'); const pixels = input.width * input.height; if (input.labels.length !== pixels || input.removalMask.length !== pixels) throw new Error(`Garment mask arrays must contain exactly ${pixels} pixels`); let headPixelCount = 0; let removedHeadPixelCount = 0; let protectedPixelCount = 0; let damagedProtectedPixelCount = 0; const present = new Set(); const damaged = new Set(); input.labels.forEach((label, index) => { if (label === 'head') { headPixelCount += 1; if (input.removalMask[index]) removedHeadPixelCount += 1; } if (PROTECTED.has(label)) { protectedPixelCount += 1; present.add(label); if (input.removalMask[index]) { damagedProtectedPixelCount += 1; damaged.add(label); } } }); const headCoverage = headPixelCount === 0 ? 0 : removedHeadPixelCount / headPixelCount; const issues: string[] = []; if (headPixelCount === 0) issues.push('segmentation contains no head pixels'); if (headCoverage !== 1) issues.push(`head removal coverage is ${(headCoverage * 100).toFixed(2)}%, expected 100%`); if (protectedPixelCount === 0) issues.push('segmentation contains no protected garment-boundary pixels'); if (damagedProtectedPixelCount > 0) issues.push(`removal mask overlaps ${damagedProtectedPixelCount} protected garment pixel(s)`); return { ok: issues.length === 0, headPixelCount, removedHeadPixelCount, headCoverage, protectedPixelCount, damagedProtectedPixelCount, preservedFeatures: [...present].filter((feature) => !damaged.has(feature)).sort(), damagedFeatures: [...damaged].sort(), issues, }; }