@lovo/matter 0.5.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @lovo/matter
 
+## 1.0.0
+
+### Major Changes
+
+- 8d9d4ad: Rename the `filmGrain` primitive to `grain`.
+
+  The `filmGrain(intensity, timeOffset?)` primitive is now exported as `grain` with
+  an identical signature and behavior. The Tier 1 `<FilmGrain>` component (delivered
+  via the CLI) is likewise renamed to `<Grain>`, and its `film-grain` registry slug
+  is now `grain`.
+
+  **Migration:** one-pass find-and-replace.
+
+  ```ts
+  // Before
+  import { filmGrain } from '@lovo/matter';
+  const g = filmGrain(0.08);
+
+  // After
+  import { grain } from '@lovo/matter';
+  const g = grain(0.08);
+  ```
+
+## 0.6.0
+
+### Minor Changes
+
+- 24ec05d: Add color-space-aware interpolation. `colorRamp` and the new `mixColor` primitive
+  accept `colorSpace` ('linear' | 'oklab' | 'oklch' | 'lch' | 'hsl' | 'hsv',
+  default 'oklab') and `hueInterpolation` ('shorter' | 'longer' | 'increasing' |
+  'decreasing', default 'shorter'). LinearGradient, SimplexNoise, and MeshGradient
+  gain matching props. Foundation fix: hex colors now decode to linear-sRGB (true
+  color), and the LCH conversion's green coefficient was corrected. This shifts the
+  default appearance of those components (pre-1.0 breaking color change).
+
 ## 0.5.0
 
 ### Minor Changes
@@ -12,7 +47,7 @@
   - `time` → `elapsedTime`
   - `Vec2` → `Vector2`
 
-  `TSLNode`, `voronoi`, `colorRamp`, `quantize`, `displace`, `cursorRipple`, and `filmGrain` are unchanged.
+  `TSLNode`, `voronoi`, `colorRamp`, `quantize`, `displace`, `cursorRipple`, and `grain` are unchanged.
 
   **Migration:** one-pass find-and-replace in your imports and call sites. No behavioral changes.
 
@@ -38,21 +73,21 @@
 
 ### Minor Changes
 
-- 3856367: Add `filmGrain` primitive — hash-based, centered film grain for shader compositions.
+- 3856367: Add `grain` primitive — hash-based, centered film grain for shader compositions.
 
   ```ts
-  import { filmGrain, time } from "@lovo/matter";
+  import { grain, time } from "@lovo/matter";
   import { uv } from "three/tsl";
 
   // Static grain:
-  const grain = filmGrain(uv(), 0.08);
+  const grainValue = grain(uv(), 0.08);
 
   // Twinkling grain — caller controls the shutter rate. floor() quantizes
   // time to a discrete cadence; the hash is so sensitive that a continuous
   // time input gives no perceptible speed control.
-  const grain = filmGrain(uv(), 0.08, time.mul(speed).mul(60).floor());
+  const grainValue = grain(uv(), 0.08, time.mul(speed).mul(60).floor());
 
-  material.colorNode = vec4(color.add(grain), 1);
+  material.colorNode = vec4(color.add(grainValue), 1);
   ```
 
   Output is centered around zero (mean of `length(vec2(u, v))` for uniform