Class Range

Hierarchy

Cell<V>
- Range (View Summary)

Index

Accessors

center

get center(): Writable<Num>
Midpoint body-drag: reads the center; a write shifts the range so the center matches (width preserved).

Returns Writable<Num>
- Defined in src/core/values/range.ts:93

hi

get hi(): this extends WritableBrand ? Writable<Num> : Num
End endpoint. Writes preserve lo (end-knob semantics).

Returns this extends WritableBrand ? Writable<Num> : Num
- Defined in src/core/values/range.ts:84

lo

get lo(): this extends WritableBrand ? Writable<Num> : Num
Start endpoint. Writes preserve hi (start-knob semantics).

Returns this extends WritableBrand ? Writable<Num> : Num
- Defined in src/core/values/range.ts:80

start

get start(): Writable<Num>
Body-drag handle: reads lo; a write shifts the range so lo matches (width preserved).

Returns Writable<Num>
- Defined in src/core/values/range.ts:125

width

get width(): Num
Returns Num
- Defined in src/core/values/range.ts:88

Constructors

constructor

new Range(v?: V): Range
Parameters
- v: V = ...
Returns Range
Overrides Cell.constructor
- Defined in src/core/values/range.ts:75

Methods

clampedRead

clampedRead(v: Val<number>): Num
Read-only clamp of v into [lo, hi].
Parameters
- v: Val<number>
Returns Num
- Defined in src/core/values/range.ts:173

contains

contains>(
v: P,
): P extends WritableBrand ? Writable<Bool> : Bool
True when v is in [lo, hi]. A writable Num yields a Writable<Bool>: flipping it clamps v inside (true) or ejects it past the nearest endpoint (false). Literal/RO inputs yield a read-only Bool.
Type Parameters
- P extends Val<number>
Parameters
- v: P
Returns P extends WritableBrand ? Writable<Bool> : Bool
- Defined in src/core/values/range.ts:155

derive

derive(this: Cell<V>, fn: (v: V) => V): this
Read-only same-type view: the RO dual of the endo .lens. For a cross-type view use the typed static Target.derive(src, fn).
Parameters
- this: Cell<V>
- fn: (v: V) => V
Returns this
Inherited from Cell.derive
- Defined in src/core/cell.ts:885

lens

lens(this: Cell<V>, fwd: (v: V) => V, bwd: (target: V, current: V) => V): this
Endomorphic lens. A 2-arg bwd(view, current) consults the current source; a 1-arg bwd(view) reconstructs it from the view alone.
Parameters
- this: Cell<V>
- fwd: (v: V) => V
- bwd: (target: V, current: V) => V
Returns this
Inherited from Cell.lens
- Defined in src/core/cell.ts:879

merge

merge(this: Cell<V>, fold?: MergeFold<V>): Cell<V>
Backward fan-in: forwards its parent's value unchanged; on write, folds N contributors into one value. fold defaults to last-writer-wins.
Parameters
- this: Cell<V>
- Optionalfold: MergeFold<V>
Returns Cell<V>
Inherited from Cell.merge
- Defined in src/core/cell.ts:914

paramOf

paramOf(v: Val<number>): Num
Inverse of sample: derive the t that would produce v.
Parameters
- v: Val<number>
Returns Num
- Defined in src/core/values/range.ts:177

peek

peek(): V
Returns V
Inherited from Cell.peek
- Defined in src/core/cell.ts:864

sample

sample(t: Val<number>): Num
RO sample at t. t ∈ [0, 1] stays inside; outside extrapolates.
Parameters
- t: Val<number>
Returns Num
- Defined in src/core/values/range.ts:134

scale

scale(k: Val<number>): this
Scale about the origin. Invertible when k ≠ 0.
Parameters
- k: Val<number>
Returns this
- Defined in src/core/values/range.ts:109

shift

shift(by: Val<number>): this
Translate by by.
Parameters
- by: Val<number>
Returns this
- Defined in src/core/values/range.ts:101

slider

slider(t: Writable<Num>): Writable<Num>
Bidirectional t ↔ value slider. Read lo + t·(hi - lo); write solves for t and updates t only, leaving lo / hi put.
Parameters
- t: Writable<Num>
Returns Writable<Num>
- Defined in src/core/values/range.ts:139

through

through(this: Cell<V>, o: Optic<V, B>): Writable<Cell>
Apply optic value(s) as a writable lens: c.through(o) ≡ lens(c, o.get, o.put); multiple optics compose left-to-right (c.through(a, b) = a then b). Cross-type, unlike the endomorphic instance .lens.
Type Parameters
- B
Parameters
- this: Cell<V>
- o: Optic<V, B>
Returns Writable<Cell>
Inherited from Cell.through
- Defined in src/core/cell.ts:892
through<B, C>(
 this: Cell<V>,
 o1: Optic<V, B>,
 o2: Optic<B, C>,
): Writable<Cell<C>>
Apply optic value(s) as a writable lens: c.through(o) ≡ lens(c, o.get, o.put); multiple optics compose left-to-right (c.through(a, b) = a then b). Cross-type, unlike the endomorphic instance .lens.
Type Parameters
- B
- C
Parameters
- this: Cell<V>
- o1: Optic<V, B>
- o2: Optic<B, C>
Returns Writable<Cell<C>>
Inherited from Cell.through
- Defined in src/core/cell.ts:893
through<B, C, D>(
 this: Cell<V>,
 o1: Optic<V, B>,
 o2: Optic<B, C>,
 o3: Optic<C, D>,
): Writable<Cell<D>>
Apply optic value(s) as a writable lens: c.through(o) ≡ lens(c, o.get, o.put); multiple optics compose left-to-right (c.through(a, b) = a then b). Cross-type, unlike the endomorphic instance .lens.
Type Parameters
- B
- C
- D
Parameters
- this: Cell<V>
- o1: Optic<V, B>
- o2: Optic<B, C>
- o3: Optic<C, D>
Returns Writable<Cell<D>>
Inherited from Cell.through
- Defined in src/core/cell.ts:894

to

to(this: Writable<Range>, target: V, dur: Val<number>, ease?: Easing): Tween<V>
Tween-builder.
Parameters
- this: Writable<Range>
- target: V
- dur: Val<number>
- Optionalease: Easing
Returns Tween<V>
- Defined in src/core/values/range.ts:182

`Static`coerce

coerce<C extends AnyCellCtor>(
this: C,
v: Val<Inner<InstanceType<C>>>,
): InstanceType<C>
Coerce Val<Inner<Cls>> → Cls: instance → identity, RO cell → tracked derive, literal → fresh seed.
Type Parameters
- C extends AnyCellCtor
Parameters
- this: C
- v: Val<Inner<InstanceType<C>>>
Returns InstanceType<C>
Inherited from Cell.coerce
- Defined in src/core/cell.ts:987

`Static`derive

derive<C extends AnyCellCtor, P>(
 this: C,
 parent: Read,
 fn: (v: P) => Inner<InstanceType<C>>,
): InstanceType<C>
Read-only typed view. Cls.derive(parent, fn) (1-input), Cls.derive(parents, fn) (N-input), or Cls.derive(fn) (closure). Polymorphic-this: Vec.derive(...) → Vec.
Type Parameters
- C extends AnyCellCtor
- P
Parameters
- this: C
- parent: Read
- fn: (v: P) => Inner<InstanceType<C>>
Returns InstanceType<C>
Inherited from Cell.derive
- Defined in src/core/cell.ts:932
derive<C extends AnyCellCtor, P extends readonly Read<unknown>[]>(
 this: C,
 parents: P,
 fn: (vals: ReadValues) => Inner<InstanceType<C>>,
): InstanceType<C>
Read-only typed view. Cls.derive(parent, fn) (1-input), Cls.derive(parents, fn) (N-input), or Cls.derive(fn) (closure). Polymorphic-this: Vec.derive(...) → Vec.
Type Parameters
- C extends AnyCellCtor
- P extends readonly Read<unknown>[]
Parameters
- this: C
- parents: P
- fn: (vals: ReadValues) => Inner<InstanceType<C>>
Returns InstanceType<C>
Inherited from Cell.derive
- Defined in src/core/cell.ts:937
derive<C extends AnyCellCtor>(
this: C,
fn: () => Inner<InstanceType<C>>,
): InstanceType<C>
Read-only typed view. Cls.derive(parent, fn) (1-input), Cls.derive(parents, fn) (N-input), or Cls.derive(fn) (closure). Polymorphic-this: Vec.derive(...) → Vec.
Type Parameters
- C extends AnyCellCtor
Parameters
- this: C
- fn: () => Inner<InstanceType<C>>
Returns InstanceType<C>
Inherited from Cell.derive
- Defined in src/core/cell.ts:942

`Static`is

is<C extends AnyCellCtor>(this: C, v: unknown): v is InstanceType<C>
Type predicate against this class: Vec.is(x) narrows x to Vec. Inherited static; works for any subclass via polymorphic this.
Type Parameters
- C extends AnyCellCtor
Parameters
- this: C
- v: unknown
Returns v is InstanceType<C>
Inherited from Cell.is
- Defined in src/core/cell.ts:981

`Static`lens

lens<C extends AnyCellCtor, P>(
 this: C,
 parent: Read,
 fwd: (v: P) => Inner<InstanceType<C>>,
 bwd: (target: Inner<InstanceType<C>>, v: P) => P,
): Writable<InstanceType<C>>
Writable lens. Cls.lens(parent, fwd, bwd) for one input, Cls.lens(parents, fwd, bwd) for N; a 2-arg bwd reads the source, a 1-arg bwd reconstructs it. Cls.lens(parent(s), spec) builds a complement-carrying lens from { init, step, fwd, bwd }.
Type Parameters
- C extends AnyCellCtor
- P
Parameters
- this: C
- parent: Read
- fwd: (v: P) => Inner<InstanceType<C>>
- bwd: (target: Inner<InstanceType<C>>, v: P) => P
Returns Writable<InstanceType<C>>
Inherited from Cell.lens
- Defined in src/core/cell.ts:952
lens<C extends AnyCellCtor, P extends readonly Read<unknown>[]>(
 this: C,
 parents: P,
 fwd: (vals: ReadValues) => Inner<InstanceType<C>>,
 bwd: (
 target: Inner<InstanceType<C>>,
 vals: ReadValues,
 ) => BackUpdates<ReadValuesOrSkip>,
): Writable<InstanceType<C>>
Writable lens. Cls.lens(parent, fwd, bwd) for one input, Cls.lens(parents, fwd, bwd) for N; a 2-arg bwd reads the source, a 1-arg bwd reconstructs it. Cls.lens(parent(s), spec) builds a complement-carrying lens from { init, step, fwd, bwd }.
Type Parameters
- C extends AnyCellCtor
- P extends readonly Read<unknown>[]
Parameters
- this: C
- parents: P
- fwd: (vals: ReadValues) => Inner<InstanceType<C>>
- bwd: (
 target: Inner<InstanceType<C>>,
 vals: ReadValues,
 ) => BackUpdates<ReadValuesOrSkip>
Returns Writable<InstanceType<C>>
Inherited from Cell.lens
- Defined in src/core/cell.ts:958
lens<C extends AnyCellCtor, P, Cm>(
 this: C,
 parent: Read,
 spec: StatefulLensSpec1<P, Inner<InstanceType<C>>, Cm>,
): Writable<InstanceType<C>>
Writable lens. Cls.lens(parent, fwd, bwd) for one input, Cls.lens(parents, fwd, bwd) for N; a 2-arg bwd reads the source, a 1-arg bwd reconstructs it. Cls.lens(parent(s), spec) builds a complement-carrying lens from { init, step, fwd, bwd }.
Type Parameters
- C extends AnyCellCtor
- P
- Cm
Parameters
- this: C
- parent: Read
- spec: StatefulLensSpec1<P, Inner<InstanceType<C>>, Cm>
Returns Writable<InstanceType<C>>
Inherited from Cell.lens
- Defined in src/core/cell.ts:964
lens<C extends AnyCellCtor, P extends readonly Read<unknown>[], Cm>(
 this: C,
 parents: P,
 spec: StatefulLensSpec<ReadValues, Inner<InstanceType<C>>, Cm>,
): Writable<InstanceType<C>>
Writable lens. Cls.lens(parent, fwd, bwd) for one input, Cls.lens(parents, fwd, bwd) for N; a 2-arg bwd reads the source, a 1-arg bwd reconstructs it. Cls.lens(parent(s), spec) builds a complement-carrying lens from { init, step, fwd, bwd }.
Type Parameters
- C extends AnyCellCtor
- P extends readonly Read<unknown>[]
- Cm
Parameters
- this: C
- parents: P
- spec: StatefulLensSpec<ReadValues, Inner<InstanceType<C>>, Cm>
Returns Writable<InstanceType<C>>
Inherited from Cell.lens
- Defined in src/core/cell.ts:969

`Static`pin

pin<C extends AnyCellCtor>(
this: C,
v: Inner<InstanceType<C>>,
): Writable<InstanceType<C>>
Writable-shaped constant: always reads v, absorbs writes (parentless sink lens), for APIs demanding bidirectionality.
Type Parameters
- C extends AnyCellCtor
Parameters
- this: C
- v: Inner<InstanceType<C>>
Returns Writable<InstanceType<C>>
Inherited from Cell.pin
- Defined in src/core/cell.ts:1000

Properties

`Readonly`_t

_t: {
 equals: (a: V, b: V) => boolean;
 lerp: (a: V, b: V, t: number) => V;
 linear: Linear<V>;
 metric: (a: V, b: V) => number;
 pack: Pack<V>;
}

Type Declaration

equals: (a: V, b: V) => boolean
lerp: (a: V, b: V, t: number) => V
linear: Linear<V>
metric: (a: V, b: V) => number
Euclidean distance over (lo, hi).
pack: Pack<V>

name

name: string | undefined

Optional debug label (cell(0, { name })); used by errors and graph dumps.

`Readonly`value

value: V

`Static`traits

traits: {
 equals: (a: V, b: V) => boolean;
 lerp: (a: V, b: V, t: number) => V;
 linear: Linear<V>;
 metric: (a: V, b: V) => number;
 pack: Pack<V>;
} = ...

Type Declaration

equals: (a: V, b: V) => boolean
lerp: (a: V, b: V, t: number) => V
linear: Linear<V>
metric: (a: V, b: V) => number
Euclidean distance over (lo, hi).
pack: Pack<V>

Class Range

Hierarchy

Index

Accessors

Constructors

Methods

Properties

Accessors

center

Returns Writable<Num>

hi

Returns this extends WritableBrand ? Writable<Num> : Num

lo

Returns this extends WritableBrand ? Writable<Num> : Num

start

Returns Writable<Num>

width

Returns Num

Constructors

constructor

Parameters

Returns Range

Methods

clampedRead

Parameters

Returns Num

contains

Type Parameters

Parameters

Returns P extends WritableBrand ? Writable<Bool> : Bool

derive

Parameters

Returns this

lens

Parameters

Returns this

merge

Parameters

Returns Cell<V>

paramOf

Parameters

Returns Num

peek

Returns V

sample

Parameters

Returns Num

scale

Parameters

Returns this

shift

Parameters

Returns this

slider

Parameters

Returns Writable<Num>

through

Type Parameters

Parameters

Returns Writable<Cell<B>>

Type Parameters

Parameters

Returns Writable<Cell<C>>

Type Parameters

Parameters

Returns Writable<Cell<D>>

to

Parameters

Returns Tween<V>

Staticcoerce

Type Parameters

Parameters

Returns InstanceType<C>

Staticderive

Type Parameters

Parameters

Returns InstanceType<C>

Type Parameters

Parameters

Returns InstanceType<C>

`Static`coerce

`Static`derive

`Static`is

`Static`lens

`Static`pin

`Readonly`_t

`Readonly`value

`Static`traits