@glissade/core 0.54.0 → 0.55.0-pre.0

package/dist/index.d.ts

@@ -470,6 +470,27 @@ type Rng = () => number;
 /** Returns a deterministic [0,1) generator for the given integer seed. */
 declare function random(seed: number): Rng;
 //#endregion
+//#region src/noise.d.ts
+/**
+ * `valueNoise(seed, t)` — closed-form smooth value noise, a PURE function of
+ * `(seed, t)`. It lerps between two lattice hash values with a smoothstep ease of
+ * the fractional part:
+ *
+ *   valueNoise(seed, t) = lerp(rand(seed, ⌊t⌋), rand(seed, ⌊t⌋+1), smoothstep(fract t))
+ *
+ * There is NO stored state, NO `bake()`, NO `Date.now`/`Math.random` — the only
+ * randomness is the seeded splitmix hash (`random`, DESIGN.md §5.5), so it is
+ * deterministic BY CONSTRUCTION: byte-identical run-to-run and re-entrant under
+ * out-of-order `evaluate()` (the determinism contract). fps-independent, O(1), and
+ * freely seekable — the closed-form sibling of a spring.
+ *
+ * Range is [0, 1) (the same as `rand`); center it to a signed jitter with
+ * `valueNoise(seed, t) * 2 - 1`. Reused by the `shake` driver + camera whole-frame
+ * shake (`@glissade/scene/motion`) and available to any scene that wants a smooth
+ * deterministic wobble (`window.glissade.valueNoise`).
+ */
+declare function valueNoise(seed: number, t: number): number;
+//#endregion
 //#region src/bake.d.ts
 interface BakeConfig<W> {
   /** seconds of simulation; keys land on the frame grid */
@@ -505,4 +526,4 @@ interface CheckpointedSim {
 }
 declare function bakeCheckpointed<W, S = W>(cfg: CheckpointedBakeConfig<W, S>): CheckpointedSim;
 //#endregion
-export { type AssetRef, type AudioClip, type BakeConfig, BakeError, type BindOptions, type BindTarget, BindTypeMismatchError, type BindableSignal, type BoundTimeline, type CheckpointedBakeConfig, type CheckpointedSim, type ChildEntry, CircularDependencyError, ColorParseError, type ColorStop, type CompiledTimeline, type CoverageReport, type CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type FontAxes, type FontFaceRef, type FontMode, type FontRegistry, type FontUsage, FontValidationError, type GainEnvelope, type GradientInterpolation, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type MeshInterpolation, type MeshPaint, type MeshPoint, type MissingGlyphs, type OkLab, type Paint, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type ResolvedFace, type RetargetSpring, type Rgba, type Rng, type Scheduler, type Signal, type SignalOptions, type SpringConfig, type SpringEase, type StaggerOpts, type StaggerSpec, TARGET_PATH, type TargetCarrier, type Timeline, type TimelineBuilder, type TimelineInit, TimelineValidationError, type Track, TrackValidationError, type TweenOpts, type TweenTarget, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, type ValidateFontsOptions, type ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Component, type Vec2Signal, WriteDuringEvaluationError, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, endReadPhase, evaluateAt, fontAxesType, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, listValueTypes, namedEasing, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, reprOf, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };
+export { type AssetRef, type AudioClip, type BakeConfig, BakeError, type BindOptions, type BindTarget, BindTypeMismatchError, type BindableSignal, type BoundTimeline, type CheckpointedBakeConfig, type CheckpointedSim, type ChildEntry, CircularDependencyError, ColorParseError, type ColorStop, type CompiledTimeline, type CoverageReport, type CurveSampler, DEFAULT_EASE, type DevWarning, type EaseSpec, type EasingFn, type Equals, type FontAxes, type FontFaceRef, type FontMode, type FontRegistry, type FontUsage, FontValidationError, type GainEnvelope, type GradientInterpolation, type HandoffKind, type Json, type Key, type KeyOpts, type Marker, type MeshInterpolation, type MeshPaint, type MeshPoint, type MissingGlyphs, type OkLab, type Paint, type PathContour, type PathValue, type Playhead, type Position, PositionError, type ReadonlySignal, type ResolvedFace, type RetargetSpring, type Rgba, type Rng, type Scheduler, type Signal, type SignalOptions, type SpringConfig, type SpringEase, type StaggerOpts, type StaggerSpec, TARGET_PATH, type TargetCarrier, type Timeline, type TimelineBuilder, type TimelineInit, TimelineValidationError, type Track, TrackValidationError, type TweenOpts, type TweenTarget, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, type ValidateFontsOptions, type ValueType, type ValueTypeId, ValueTypeInferenceError, type Vec2, type Vec2Component, type Vec2Signal, WriteDuringEvaluationError, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, endReadPhase, evaluateAt, fontAxesType, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, listValueTypes, namedEasing, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, reprOf, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, valueNoise, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/dist/index.js

@@ -1004,6 +1004,44 @@ function evaluateAt(playhead, t, read) {
 	}
 }
 //#endregion
+//#region src/noise.ts
+/**
+* `valueNoise(seed, t)` — closed-form smooth value noise, a PURE function of
+* `(seed, t)`. It lerps between two lattice hash values with a smoothstep ease of
+* the fractional part:
+*
+*   valueNoise(seed, t) = lerp(rand(seed, ⌊t⌋), rand(seed, ⌊t⌋+1), smoothstep(fract t))
+*
+* There is NO stored state, NO `bake()`, NO `Date.now`/`Math.random` — the only
+* randomness is the seeded splitmix hash (`random`, DESIGN.md §5.5), so it is
+* deterministic BY CONSTRUCTION: byte-identical run-to-run and re-entrant under
+* out-of-order `evaluate()` (the determinism contract). fps-independent, O(1), and
+* freely seekable — the closed-form sibling of a spring.
+*
+* Range is [0, 1) (the same as `rand`); center it to a signed jitter with
+* `valueNoise(seed, t) * 2 - 1`. Reused by the `shake` driver + camera whole-frame
+* shake (`@glissade/scene/motion`) and available to any scene that wants a smooth
+* deterministic wobble (`window.glissade.valueNoise`).
+*/
+/** smoothstep on a value already in [0,1] (the fractional part) — 3t²−2t³. */
+function smoothstep01(t) {
+	return t * t * (3 - 2 * t);
+}
+/**
+* Deterministic hash of the integer lattice point `i` for `seed` → [0, 1). Folds
+* `seed` and `i` into one uint32 (a splitmix-friendly mix) then draws one splitmix
+* step from core's seeded `random` — so adjacent seeds/lattice points decorrelate.
+*/
+function latticeRand(seed, i) {
+	return random((Math.imul(i | 0, 2654435761) ^ (seed | 0)) >>> 0)();
+}
+function valueNoise(seed, t) {
+	const i = Math.floor(t);
+	const f = t - i;
+	const a = latticeRand(seed, i);
+	return a + (latticeRand(seed, i + 1) - a) * smoothstep01(f);
+}
+//#endregion
 //#region src/bake.ts
 /**
 * bake() (DESIGN.md §2.8): stateful simulation as a compilation step. Run the
@@ -1108,4 +1146,4 @@ function bakeCheckpointed(cfg) {
 	};
 }
 //#endregion
-export { BakeError, BindTypeMismatchError, CircularDependencyError, ColorParseError, DEFAULT_EASE, FontValidationError, PositionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, endReadPhase, evaluateAt, fontAxesType, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, listValueTypes, namedEasing, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, reprOf, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };
+export { BakeError, BindTypeMismatchError, CircularDependencyError, ColorParseError, DEFAULT_EASE, FontValidationError, PositionError, TARGET_PATH, TimelineValidationError, TrackValidationError, UnboundTargetError, UnknownEasingError, UnknownValueTypeError, UnresolvableTargetError, ValueTypeInferenceError, WriteDuringEvaluationError, audioOffsetSamples, bake, bakeCheckpointed, batch, beginReadPhase, bindTimeline, booleanType, buildFontRegistry, buildTimeline, colorType, compileTimeline, computed, createPlayhead, cubicBezier, cubicBezierDerivative, easingDerivatives, easings, emitDevWarning, endReadPhase, evaluateAt, fontAxesType, formatColor, getTimelineCallbacks, getValueType, inReadPhase, inferValueType, isDurationEditable, isEditableNodeId, isExemptFamily, key, lerpColor, listValueTypes, namedEasing, numberType, oklabToRgba, paintType, parseCmap, parseColor, pathType, random, registerValueType, reprOf, resolveEase, resolveEaseDerivative, resolveTweenTarget, rgbaToOklab, sampleTrack, setDevWarning, setScheduler, signal, spring, springEasing, springEasingDerivative, springPresets, springTo, stagger, stringType, synchronousScheduler, targetNodeId, timeline, track, untracked, validateFonts, validateTrack, valueNoise, vec2ArcType, vec2Equals, vec2Signal, vec2Type, velocityAt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.54.0",
+  "version": "0.55.0-pre.0",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {