render: extract native M2 animation resource observer

docs/modules/m2-raw-model-repository.md

@@ -28,10 +28,12 @@ static or animated Dictionary consumed by existing builders and classifiers.
 ```mermaid
 flowchart LR
     Loader[StreamingWorldLoader] --> Repository[M2RawModelRepository]
+    Observer[M2NativeAnimationResourceObserver] --> Repository
     Repository --> File[Extracted M2 file]
     Repository --> Native[ClassDB M2Loader]
     Native --> Raw[Raw Dictionary]
     Raw --> Loader
+    Raw --> Observer
     Loader --> Builder[Existing M2 builders/finalizer]
 ```
 
@@ -54,7 +56,7 @@ renderer policy and other application layers are forbidden.
 | Input | Already-normalized relative M2 path String | Loader normalization | Repository | Copied value | One call |
 | Input | Extracted `.m2` bytes | Local legal extraction | Native M2Loader | File-owned | Native call |
 | Output | Static raw M2 Dictionary | Native `load_m2` | Loader/finalizer/M2Builder | Fresh native result | One caller operation |
-| Output | Animated raw M2 Dictionary | Native `load_m2_animated` | Loader/animated builder | Fresh native result | One caller operation |
+| Output | Animated raw M2 Dictionary | Native `load_m2_animated` | Native animation observer/builder | Fresh native result | One caller operation |
 | Output | Empty Dictionary | Repository guards | Loader fallback and prototype outcome adapter | Fresh value | One failed call |
 
 Side effects are limited to file-existence inspection, synchronous native file
@@ -98,18 +100,18 @@ No request, result or failure state survives a call.
 
 ```mermaid
 sequenceDiagram
-    participant Loader as StreamingWorldLoader
+    participant Caller as Loader or NativeAnimationObserver
     participant Repo as M2RawModelRepository
     participant File as FileAccess
     participant Native as M2Loader
-    Loader->>Repo: load static/animated(directory, path)
+    Caller->>Repo: load static/animated(directory, path)
     Repo->>File: file_exists(globalized joined path)
     alt dependency or file unavailable
-        Repo-->>Loader: empty Dictionary
+        Repo-->>Caller: empty Dictionary
     else available
         Repo->>Native: instantiate and call exact native method
         Native-->>Repo: Variant
-        Repo-->>Loader: Dictionary or empty Dictionary
+        Repo-->>Caller: Dictionary or empty Dictionary
     end
 ```
 
@@ -118,13 +120,14 @@ sequenceDiagram
 ```mermaid
 flowchart TB
     Loader[StreamingWorldLoader] --> Repository[M2RawModelRepository]
+    Observer[M2NativeAnimationResourceObserver] --> Repository
     Repository --> ProjectSettings
     Repository --> FileAccess
     Repository --> ClassDB
     ClassDB --> Native[M2Loader extension]
     Loader --> Finalizer[M2RuntimeMeshFinalizer]
     Loader --> StaticBuilder[M2Builder]
-    Loader --> AnimatedBuilder[M2NativeAnimatedBuilder]
+    Observer --> AnimatedBuilder[M2NativeAnimatedBuilder]
     Repository -. no dependency .-> Finalizer
     Repository -. no dependency .-> StaticBuilder
     Repository -. no dependency .-> Cache[Renderer caches/queues]
@@ -133,7 +136,8 @@ flowchart TB
 ## Ownership, threading and resources
 
 - The repository owns only call-local path, native instance and result values.
-- The loader owns path normalization and fallback selection;
+- The loader owns path normalization and fallback selection; the native observer
+  owns the animated raw-read/build decision;
   `M2PrototypeCacheState` owns prototype/negative adoption.
 - Native `M2Loader` owns parsing behavior and returns a new Dictionary value.
 - Calls are synchronous on the caller's thread; current renderer callers use the
@@ -211,6 +215,7 @@ measured work packages rather than expansion of this repository.
 | Path | Responsibility |
 |---|---|
 | `src/render/m2/m2_raw_model_repository.gd` | Stateless native class/file/method boundary |
+| `src/render/m2/m2_native_animation_resource_observer.gd` | Animated raw-data consumer and builder adapter |
 | `src/render/m2/m2_prototype_cache_state.gd` | Prototype and negative-result retention |
 | `src/scenes/streaming/streaming_world_loader.gd` | Path normalization, fallback decisions and result consumers |
 | `src/native/src/m2_loader.cpp` | Native static/animated parsing implementation |