+ Normalize file extension (.jpg -> .jpeg) in a filename string.N)EXTENSION_NORMALIZEitemslowerendswithlen)r old_extnew_exts& rnormalize_extensionr&sO/557 >>  $ $W - -Os7|m,w6 68 Orz^(?P[a-z][a-z0-9]*(?:-[a-z0-9]+)*)_(?Pidentity|turn|expr|loc|prop|scene)_(?P[a-z][a-z0-9]*(?:-[a-z0-9]+)*)_v(?P[0-9]{2})\.(?Ppng|jpeg|webp)$T)frozenslotsc^a]tRt^?toRt]V3RlRl4tV3RlRltV3RltRt Vt R#) AssetIdz+Parsed representation of an asset filename.c <V^8dQhRS[/#)r rr)r __classdict__s"rrAssetId.__annotate__Is[[#[rc  VP RVP RVP RVPR RVP 2 #)z#Reconstruct the canonical filename.__v02d.subjecttypevariantversionextselfs&rr AssetId.filenameHsA,,q 1T\\N"T\\#r?rBr4rrrFrF\sQrrF normalizec<V^8dQhR\R\R\/#)r r rGr)rboolr!)rs"rrras!&&3&d&g&rc JRV9gRV9d\RV: 24hV'd \V4p\PV4pVf \RV: R\ \ 4 24h\ VR,VR,VR,\VR ,4VR ,R 7#) aParse an asset filename into its constituent segments. Args: filename: The filename to parse (no directory components). Example: "torch_identity_hero_v01.png" normalize: If True, normalize extensions (.jpg -> .jpeg) before matching. If False, non-canonical extensions will fail to match. Returns: An AssetId dataclass with subject, type, variant, version, ext. Raises: AssetNameError: If the filename does not match the asset convention. /\z&Expected a bare filename, got a path: z*Filename does not match asset convention: zH. Expected: {subject}_{type}_{variant}_v{NN}.{ext} where type is one of r+r,r-r.r/r*)rFrASSET_FILENAME_REmatchsorted VALID_TYPESr!r:)r rGrNs&$ rparse_asset_filenamerQas h$(*4XL A  &x0  # #H -E }8 E$$*;$7#8 :  i 6]i E)$% %L  rc0V^8dQhR\R\/#r )rrI)rs"rrrscdrcB\V4R# \dR#i;i)z@Return True if the filename matches the asset naming convention.TF)rQrF)r s&ris_valid_asset_filenamerTs$X& s  c0a]tRt^toRtV3RltRtVtR#)SlotSpecz.Pipeline slot specification for an asset type.cb<V^8dQh/S[;R&S[;R&S[;R&S[;R&S[;R&S[;R&#)r asset_typeslot weight_min weight_maxorder auto_eligible)rr:rI)rr#s"rrSlotSpec.__annotate__sNO I  O  O  Jrr4N)r;r<r=r>r?rArBrCrDs@rrVrVs8rrV environment expression structurer+vibeFcVP#)N)r\)ss&rresQWWr)keyc0V^8dQhR\R\/#)r rXrr9)rs"rrrs44s4s4rc\PV4pVf^#VPVP,^,#)z@Return the default weight for an asset type (midpoint of range).)SLOT_MAPgetrZr[)rXspecs& rdefault_weightrls0 << #D | OOdoo -! 33rcRV^8dQhR\R\R\\,/#)r rXweightr)rr:list)rs"rrrs%Ccrc\PV4pVfRV: 2.#.pWP8d$VPV RV RVP 24WP8d$VPV RV RVP 24V#)zIReturn warnings if weight is outside the recommended range for this type.Unknown asset type: z weight z is below recommended minimum z is above recommended maximum )rirjrZappendr[)rXrnrkwarningss&& rvalidate_ref_weightrts << #D |&zn566H l(6(*HHY Z l(6(*HHY Z  OrcRV^8dQhR\R\R\\,/#)r rXautor)rrIro)rs"rrrs%#Td3irc\PV4pVfRV: 2.#V'dVP'gV R2.#.#)zBReturn errors if auto is True on a non-auto-eligible type (scene).rqz4 refs must not be auto-resolved (auto must be false))rirjr])rXrvrks&& rvalidate_ref_autorxsI << #D |&zn566 D&&&,RSTT Irc `V^8dQhR\R\R\R\R\R\/#)r r+rXr-r.r/rr9)rs"rrrsD     rc V\9d \RV: R\\4 24hV RV RV RVR RV 2 p\VRR7V#) ziBuild a canonical asset filename from components. Raises AssetNameError if the result would be invalid. zInvalid asset type: z. Must be one of r&r'r(r)F)rG)rPrFrOrQ)r+rXr-r.r/r s&&&&& rbuild_asset_filenamer{sa$3J>ARSYZeSfRghii!JVPV8Xd+VP V8Xd\ WFP4pKcKeKgKi V^,# \dKi;i)zTScan a directory for existing versions and return the next available version number.) iterdirrQnamer+r,r-maxr.rF)r}r+rXr-max_verpaids&&&& r next_versionrsG     &qvv.C{{g%#((j*@S[[T[E[g{{3F\*@%! Q;   sAB BBc0V^8dQhR\R\/#)r asset_idrr)rs"rrrs""s"s"rc\f^RIpVPR4sVP4pR FbpVP V4'gKVP RR4P RR4P RR4pWB\ V4R,pM VP RR4pVP RR4p\PRV4pR V9dVP R R4pKVPR4#) aUniversal slugify for characters, locations, and props. Preserves INT/EXT prefix (semantically meaningful for lighting). Strips non-alphanumeric except underscores. Examples: 'SADIE' -> 'sadie' 'INT. Dusty's Bar' -> 'int_dustys_bar' 'EXT. City Street' -> 'ext_city_street' 'INT/EXT. Alley' -> 'int_ext_alley' 'int_sadie_apartment'-> 'int_sadie_apartment' (passthrough) Nz [^a-z0-9_]rKr&z. r)'__)z int/ext. zint. zext. ) _SLUGIFY_RErecompiler startswithreplacersubstrip)r_reslugprefix replacements& rslugify_asset_idrskk-0 >> D1 ??6 " " ..c2::4EMMcSVWKc&kl!33D  2 <<S !D <<R D ??3 %D $,||D#& ::c?r characters locationspropsc0V^8dQhR\R\/#)r legacyrr)rs"rrr9src V\9d\V,#V\9dV#\RV: R\\4 R\\4 R24h)uTranslate a v1 plural-English entity type to its v2 singular kind. Raises ValueError on unknown legacy types — the migration script catches and falls back to its unmatched-file classifier (see Risk #5). zUnknown legacy type z. Expected one of z or a v2 kind in r))LEGACY_PLURAL_TO_KINDVALID_ASSET_KINDS ValueErrorrO)rs&rkind_for_legacy_typer9s` &&$V,, ""  vj(: ' ( )):6BS;T:UUV X rc0V^8dQhR\R\/#r r)rs"rrrJs""s"s"rcVP4pRV9gRV9dR#RF pW!9gK R# RV9dR#RpVF pWA9gK R# R#) u-Classify a filename from a v1 characters/{subject}/ directory into a v2 kind. The v1 layout grouped identity refs, turnarounds, and expression refs all into characters/{subject}/. The migration script needs to split them: - filename contains "_turn_" or "_angle_" or matches /^{subject}_(front|profile|three_quarter|back|closeup)/ → "turn" - filename contains "_expr_" or matches a known emotion label (anger, fear, joy, etc.) → "expr" - everything else (including hero, _identity_) → "identity" Returns one of: "identity", "turn", "expr". _turn__angle_r_expr_rr)_front_profile_three_quarter_back_closeup)angerfearjoysadnessdisgustsurpriseneutralcontempt anticipation_calm_smile_frown_grin_scowl)r)r rangleEMOTION_LABELSlabels& rclassify_legacy_filenamerJsd NN E5I.N >O 5N   > rcbV^8dQh/^\9d\\\3,;R&#)r ri)__conditional_annotations__dictrrV)rs"rrrs-B$sH} Cr>rrrrr r)png)#rr?r dataclassesrpathlibr frozensetrPrrrrMr!rrFrQrTrVrirOvalues SLOT_ORDERrlrtrxr{rrrrrrrr)rs@rrs" ! LM  G G JJ! $d#  $ 8 Z &T&R $d#$ ]AAtD VAAtD \AAtD [AAtDYAAtD VAAuE !HOO%+< = 4"& " "X * V""r