package p.animation; import java.util.*; /** The single structural and asset-binding validator used by Studio and compiler. */ public final class AnimationValidator { public List validate(AnimationDocument doc, GlyphBankLayout layout) { var errors=new ArrayList(); if(doc.schemaVersion()!=1)add(errors,"schema_version","/schema_version","Unsupported version"); try { if(!doc.bankAssetUuid().matches("[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"))throw new IllegalArgumentException("UUID syntax"); if(!UUID.fromString(doc.bankAssetUuid()).equals(layout.assetUuid()))add(errors,"bank_uuid","/bank_asset_uuid","Containing bank UUID does not match"); } catch(IllegalArgumentException error){add(errors,"bank_uuid","/bank_asset_uuid","Invalid UUID");} var current=new HashMap(); var indices=new HashSet(); for(var glyph:layout.glyphs()) { if(glyph.artifactId().isEmpty()||current.putIfAbsent(glyph.artifactId(),glyph)!=null||!indices.add(glyph.glyphId()) ||glyph.glyphId()<0||glyph.glyphId()>65535||!glyph.fingerprint().matches("[0-9a-f]{64}")) add(errors,"bank_layout","/bindings","Current bank layout has missing/duplicate/invalid identities"); } var bound=new HashMap(); indices.clear(); for(int i=0;i65535||!indices.add(binding.glyphId()))add(errors,"invalid_glyph",p+"/glyph_id","Glyph ID is out of range or duplicated"); var actual=current.get(binding.artifactId()); if(actual==null)add(errors,"missing_artifact",p,"Selected artifact is absent from the current composition"); else if(actual.glyphId()!=binding.glyphId()||!actual.fingerprint().equals(binding.fingerprint()))add(errors,"binding_drift",p,"Glyph index or fingerprint changed; explicit rebind required"); if(!binding.fingerprint().matches("[0-9a-f]{64}"))add(errors,"invalid_fingerprint",p+"/fingerprint","Expected lowercase SHA-256"); } var ids=new HashSet(); for(int i=0;i(); for(int j=0;jLong.MAX_VALUE-frame.durationTicks())add(errors,"overflow",fp+"/duration_ticks","Clip duration exceeds signed 64-bit range"); else total+=frame.durationTicks(); } } if(animator.initialClip().isEmpty()||!names.contains(animator.initialClip()))add(errors,"initial_clip_missing",p+"/initial_clip","Initial clip must exist"); } return List.copyOf(errors); } public void requireValid(AnimationDocument doc,GlyphBankLayout layout) { var errors=validate(doc,layout);if(!errors.isEmpty())throw new IllegalArgumentException(errors.toString()); } private static void add(List list,String code,String pointer,String message){list.add(new AnimationDiagnostic(code,pointer,message));} }