@solidrt/core 0.0.63 → 0.0.64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/core",
-  "version": "0.0.63",
+  "version": "0.0.64",
   "license": "MIT",
   "funding": "https://github.com/sponsors/wellawaretech",
   "author": "Antoine van Wel",
@@ -32,7 +32,7 @@
     "AGENTS.md"
   ],
   "devDependencies": {
-    "@solidrt/flux-types": "0.0.63"
+    "@solidrt/flux-types": "0.0.64"
   },
   "peerDependencies": {
     "@solidjs/signals": "2.0.0-rc.9",

package/src/camera-control.ts

@@ -308,7 +308,8 @@ export const BLEND_SECONDS = 0.5
 
 /** A shot's recording target: what its control drives. `camera()` is
  * the shot's latest full camera (the control's partial updates merged
- * over the initial one). */
+ * over the initial one; an undefined field is absent and keeps its
+ * value, as the real target's setCamera treats it). */
 export type ShotTarget<C> = { setCamera(update: Partial<C>): void; camera(): C }
 
 export type ShotBlendOptions = {
@@ -379,7 +380,13 @@ export function createShotBlend<C extends object>(push: (camera: C) => void, mix
       shots.set(name, s)
       return {
         setCamera(update) {
-          Object.assign(s.latest, update)
+          // A component's props arrive as explicit undefineds for the
+          // unset ones; copying those would blank a field the mix then
+          // reads (NaN, or a missing vector).
+          for (let key of Object.keys(update) as (keyof C)[]) {
+            let value = update[key]
+            if (value !== undefined) s.latest[key] = value as C[keyof C]
+          }
           if (s === live && from === null) pushNow()
         },
         camera: () => ({ ...s.latest }),

package/src/gpu.ts

@@ -80,9 +80,11 @@ export type { FilterMode, WrapMode, TextureBinding, TextureBindings } from "flux
 // createCubeTexture, createMutableTexture), fixed for the id's lifetime like
 // the sampler state. "rgba8" (default), "rgba8-srgb" (decodes to linear
 // light on sample), "r8", the float data-texture formats "r32f"/"rgba32f"
-// (Float32Array payload, nearest/texelFetch sampling only, no readback) and
-// the HDR image format "rgba16f" (Float32Array payload packed to half float,
-// filterable) - see TextureFormat in flux:gpu for each format's contract.
+// (Float32Array payload, nearest/texelFetch sampling only, no readback), the
+// HDR image format "rgba16f" (Float32Array payload packed to half float,
+// filterable) and the integer data-texture format "rgba32ui" (Uint32Array
+// payload, a uvec4 per texel through a usampler2D, nearest/texelFetch only)
+// - see TextureFormat in flux:gpu for each format's contract.
 // Draw targets (createDrawTarget, createCubeDrawTarget) take the renderable
 // subset: "rgba8", "rgba8-srgb", "rgba16f".
 // "etc2-rgba8" (compressed) is a reserved future value of the same
@@ -245,7 +247,7 @@ export { captureSnapshot, readTexture } from "flux:gpu"
  * scope.
  */
 export function createTexture(
-  data: Uint8Array | Float32Array,
+  data: Uint8Array | Float32Array | Uint32Array,
   width: number,
   height: number,
   opts?: CreateOptions & SamplerOptions & TextureFormatOptions,
@@ -279,7 +281,7 @@ export function createTexture(
  * reactive owner, `{ autoFree: false }` or `destroyTexture` otherwise).
  */
 export function createCubeTexture(
-  faces: (Uint8Array | Float32Array)[] | (Uint8Array | Float32Array)[][],
+  faces: (Uint8Array | Float32Array | Uint32Array)[] | (Uint8Array | Float32Array | Uint32Array)[][],
   size: number,
   opts?: CreateOptions & SamplerOptions & TextureFormatOptions,
 ): gpu.TextureId {
@@ -300,7 +302,7 @@ export function createCubeTexture(
  * flux:gpu) yourself.
  */
 export function createMutableTexture(
-  data: Uint8Array | Float32Array,
+  data: Uint8Array | Float32Array | Uint32Array,
   width: number,
   height: number,
   opts?: CreateOptions & SamplerOptions & TextureFormatOptions,
@@ -757,4 +759,16 @@ export function beginBufferWrite(id: gpu.BufferId): Float32Array {
  */
 export function writeBuffer(id: gpu.BufferId, data: ArrayBuffer | ArrayBufferView, byteOffset?: number): void {
   gpu.writeBuffer(id, toUint8(data), byteOffset)
+}
+
+/**
+ * Hands an ordered instance buffer's full record set to the engine - the
+ * write-once form: the engine keeps the one CPU copy and sorts,
+ * republishes and count-dials from it on its own; the caller keeps
+ * nothing and partial rewrites are off the table. Hand off before the
+ * entry attaches over the buffer. See `transferRecords` in flux:gpu for
+ * the full contract.
+ */
+export function transferRecords(id: gpu.BufferId, records: ArrayBuffer | ArrayBufferView): void {
+  gpu.transferRecords(id, toUint8(records))
 }

package/src/index.ts

@@ -67,6 +67,8 @@ export type {
   TextEvent,
   TextInputHints,
   PaintProps,
+  ShadowProps,
+  FilterProps,
   BlendMode,
   DrawStyle,
   StrokeCap,

package/src/types.d.ts

@@ -189,7 +189,11 @@ export interface PaintProps {
  * paint inside, so the box is the outer edge) - except on `path`, where the
  * shadow mirrors the element's own fill/stroke silhouette and `spread` is
  * rejected (an arbitrary path cannot be inflated exactly). `color` is
- * required; there is no currentColor to inherit.
+ * required; there is no currentColor to inherit. Animates as one value
+ * under `transition={{ shadow }}`: offset, blur, spread and color move
+ * together (the color in oklab), an unset shadow counts as none (zero,
+ * transparent), so a shadow fades in from nothing and a `null` write
+ * fades it out.
  */
 export interface ShadowProps {
   x?: number
@@ -484,7 +488,7 @@ export type TransitionCurve = "linear" | "ease" | "ease-in" | "ease-out" | "ease
  * spring entry is a tween of the entry's duration.
  */
 export interface TransitionEndpoint {
-  value: number | string
+  value: number | string | ShadowProps | null
   duration?: number
   curve?: TransitionCurve
   bounce?: number
@@ -509,11 +513,12 @@ export interface TransitionSpring {
    * Mount-time enter animation: at the element's first attach the property
    * snaps to this value and animates to the value it mounted with. Numbers
    * for the scalar properties; the color property takes a CSS color string
-   * or packed number, or a {@link TransitionEndpoint} giving the enter its
+   * or packed number; the shadow property a {@link ShadowProps} object or
+   * `null` for none; or a {@link TransitionEndpoint} giving the enter its
    * own curve, duration, bounce or delay. Per-property entries only (not
    * under `all`); a later move or reorder re-runs nothing.
    */
-  from?: number | string | TransitionEndpoint
+  from?: number | string | ShadowProps | null | TransitionEndpoint
   /**
    * Removal exit animation: when an element unmounts, every `exit`
    * declared on it or under it animates its property to this value
@@ -528,7 +533,7 @@ export interface TransitionSpring {
    * motion: an ease-out enter reads wrong played backwards, so pair it with
    * `exit: { value, curve: "ease-in" }`.
    */
-  exit?: number | string | TransitionEndpoint
+  exit?: number | string | ShadowProps | null | TransitionEndpoint
 }
 
 /**
@@ -547,11 +552,12 @@ export interface TransitionTween {
    * Mount-time enter animation: at the element's first attach the property
    * snaps to this value and animates to the value it mounted with. Numbers
    * for the scalar properties; the color property takes a CSS color string
-   * or packed number, or a {@link TransitionEndpoint} giving the enter its
+   * or packed number; the shadow property a {@link ShadowProps} object or
+   * `null` for none; or a {@link TransitionEndpoint} giving the enter its
    * own curve, duration, bounce or delay. Per-property entries only (not
    * under `all`); a later move or reorder re-runs nothing.
    */
-  from?: number | string | TransitionEndpoint
+  from?: number | string | ShadowProps | null | TransitionEndpoint
   /**
    * Removal exit animation: when an element unmounts, every `exit`
    * declared on it or under it animates its property to this value
@@ -566,7 +572,7 @@ export interface TransitionTween {
    * motion: an ease-out enter reads wrong played backwards, so pair it with
    * `exit: { value, curve: "ease-in" }`.
    */
-  exit?: number | string | TransitionEndpoint
+  exit?: number | string | ShadowProps | null | TransitionEndpoint
 }
 
 /**
@@ -579,7 +585,11 @@ export type TransitionShorthand = string
 
 export type Transition = TransitionSpring | TransitionTween | TransitionShorthand
 
-/** The property names a transition can cover (numeric scalars). */
+/**
+ * The property names a transition can cover: the numeric scalars, `color`
+ * (solid colors, in oklab) and `shadow` (the whole {@link ShadowProps}
+ * value).
+ */
 export type TransitionPropName =
   | "x"
   | "y"
@@ -612,6 +622,7 @@ export type TransitionPropName =
   | "strokeWidth"
   | "radius"
   | "color"
+  | "shadow"
 
 /**
  * Payload of onTransitionEnd: which animated property finished. `"layout"`
@@ -637,8 +648,9 @@ export interface TransitionProps {
    * properties the element carries animate (a d-rect has x, a view's x is
    * its transform); the initial values (every write before the element's
    * first paint) never animate unless the entry sets `from` (an enter
-   * animation), and a non-numeric write (e.g. null) cancels the running
-   * animation and snaps. `null` clears the
+   * animation), and a write the property cannot animate (null on a scalar,
+   * a gradient color) cancels the running animation and snaps; `shadow`
+   * alone animates to and from `null`, its none. `null` clears the
    * declaration; already-running animations finish. A spec built in a
    * conditional widens `curve` to `string` for TypeScript; write
    * `satisfies Transition` on the branch.