Linearappfringe512/fel 128 object3d force matrix updates should honor direct (#10)

* Release 0.4.0.1

* Fix FEL-128 forced matrix world updates

---------

Co-authored-by: Codex <codex@example.com>

Author: codeyousef

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to the Materia library will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0.2] - 2026-05-05
+
+### Fixed
+
+- **Forced scene matrix updates**: `Object3D.updateMatrixWorld(force = true)` now recomposes the local matrix before propagating world matrices, so direct `position` and `scale` vector mutations are reflected immediately.
+
+### Tests
+
+- Added scene graph regression coverage for forced world-matrix updates after direct position and scale changes.
+
 ## [0.4.0.1] - 2026-05-05
 
 ### Fixed

src/commonMain/kotlin/io/materia/core/scene/Object3D.kt

@@ -268,7 +268,7 @@ abstract class Object3D {
             return
         }
 
-        if (matrixAutoUpdate && matrixNeedsUpdate) {
+        if (matrixAutoUpdate && (matrixNeedsUpdate || force)) {
             updateMatrix()
             matrixNeedsUpdate = false
             localMatrixVersion++

src/commonTest/kotlin/io/materia/core/scene/Object3DMatrixWorldTest.kt

@@ -0,0 +1,40 @@
+package io.materia.core.scene
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class Object3DMatrixWorldTest {
+    @Test
+    fun forcedMatrixWorldUpdateReflectsDirectPositionMutation() {
+        val scene = Scene()
+        val node = Group()
+        scene.add(node)
+
+        scene.updateMatrixWorld(force = true)
+        node.position.set(3f, 4f, 5f)
+
+        scene.updateMatrixWorld(force = true)
+
+        val worldPosition = node.matrixWorld.getPosition()
+        assertEquals(3f, worldPosition.x)
+        assertEquals(4f, worldPosition.y)
+        assertEquals(5f, worldPosition.z)
+    }
+
+    @Test
+    fun forcedMatrixWorldUpdateReflectsDirectScaleMutation() {
+        val scene = Scene()
+        val node = Group()
+        scene.add(node)
+
+        scene.updateMatrixWorld(force = true)
+        node.scale.set(2f, 3f, 4f)
+
+        scene.updateMatrixWorld(force = true)
+
+        val worldScale = node.matrixWorld.getScale()
+        assertEquals(2f, worldScale.x)
+        assertEquals(3f, worldScale.y)
+        assertEquals(4f, worldScale.z)
+    }
+}

version.properties

@@ -1,3 +1,3 @@
-VERSION=0.4.0.1
+VERSION=0.4.0.2
 GROUP=codes.yousef
 ARTIFACT_ID=materia