Class IntControl

Readonly disabled

Readonly id

defined

• get defined(): Cell<boolean>

• Create a cell the value of which is true if this cell's value is not null or undefined, false otherwise.

  Returns Cell<boolean>

  A cell.

not

• get not(): Cell<boolean>

• Create a cell that negates the value of this cell using the ! operator.

  Returns Cell<boolean>

  A negating cell.

props

• get props(): CellProxyObject<T>

• Returns CellProxyObject<T>

undefined

• get undefined(): Cell<boolean>

• Create a cell the value of which is true if this cell's value is null or undefined, false otherwise.

  Returns Cell<boolean>

  A cell.

value

• get value(): T

• Returns T

• set value(value): void

• Set the cell's value. This emits the new value to all observers.

  Parameters

  • value: T

    The new value.

  Returns void

addNode

• addNode(element, context): void

• Parameters

  • element: Node
  • context: Context

  Returns void

and

• and<T2>(other): Cell<false | T2>

• Type Parameters

  • T2

  Parameters

  • other: Cell<T2>

  Returns Cell<false | T2>

asCell

• asCell(): Cell<number>

• Convert this cell to an immutable cell. The resulting will no longer be an instance of MutCell but will still update its value whenever this cell is updated.

  Returns Cell<number>

await

• await(onrejected?): Cell<undefined | number>

• Parameters

  • Optional onrejected: ((reason) => void)
    • • (reason): void

      • Parameters

        • reason: unknown

        Returns void

  Returns Cell<undefined | number>

bimap

• bimap<T2>(encode, decode): MutCell<T2>

• Create a two-way binding that modified values in both directions. The resulting cell is mutable and any modification of it will also result in an update of this cell.

  Type Parameters

  • T2

  Parameters

  • encode: ((value) => T2)

    Applied to the value of this cell to get the value of the resulting cell.

    • • (value): T2

      • Parameters

        • value: number

        Returns T2

  • decode: ((value) => number)

    Applied to the value of the resulting cell to update the value of this cell.

    • • (value): number

      • Parameters

        • value: T2

        Returns number

  Returns MutCell<T2>

  Example

  const a = bind(1);
  const b = a.bimap(x => x + 1, y => y - 1);
  
  expect(b.value).toBe(2);
  
  a.value = 5;
  expect(b.value).toBe(6);
  
  b.value = 3;
  expect(a.value).toBe(2);
  Copy

blur

• blur(): void

• Returns void

eq

• eq<T2>(other): Cell<boolean>

• Create a cell tthe value of which is true if this cell's value is equal to the given value or the value of the given cell, false otherwise.

  Type Parameters

  • T2 extends undefined | number

  Parameters

  • other: T2 | Cell<T2>

    A value or cell to compare the value of this cell to.

  Returns Cell<boolean>

  A cell.

flatMap

• flatMap<T2>(f): Cell<T2>

• Create a cell that applies a function to the value of this cell. The function must return a cell.

  Type Parameters

  • T2

  Parameters

  • f: ((value) => Cell<T2>)

    The function apply to the cell value.

    • • (value): Cell<T2>

      • Parameters

        • value: number

        Returns Cell<T2>

  Returns Cell<T2>

  A flat mapping cell.

focus

• focus(): void

• Returns void

getAndObserve

• getAndObserve(observer): (() => void)

• Get the cells current value and attach an observer. The observer function is called once with the current value immediately upon calling this method.

  Parameters

  • observer: CellObserver<number>

    The observer function to attach.

  Returns (() => void)

  A function that can be called to detach the observer. Alternatively unobserve can be called.

  • • (): void

    • Returns void

map

• map<T2>(f): Cell<T2>

• Create a cell that applies a function to the value of this cell.

  The function will be called whenever the value property of the resulting cell is accessed. If the resulting cell is being observed, the function will also be called once each time the value of this cell changes.

  Type Parameters

  • T2

  Parameters

  • f: ((value) => T2)

    The function to apply to the cell value.

    • • (value): T2

      • Parameters

        • value: number

        Returns T2

  Returns Cell<T2>

  A cell.

mapDefined

• mapDefined<T2>(f): Cell<undefined | T2>

• Create a cell that applies a function to the value of this cell, but only when the value is not null or undefined.

  The function will be called whenever the value property of the resulting cell is accessed. If the resulting cell is being observed, the function will also be called once each time the value of this cell changes.

  Type Parameters

  • T2

  Parameters

  • f: ((value) => T2)

    The function apply to the cell value.

    • • (value): T2

      • Parameters

        • value: number

        Returns T2

  Returns Cell<undefined | T2>

  A mapping cell.

observe

• observe(observer): (() => void)

• Attach an observer.

  Parameters

  • observer: CellObserver<number>

    The observer function to attach.

  Returns (() => void)

  A function that can be called to detach the observer. Alternatively unobserve can be called.

  • • (): void

    • Returns void

or

• or<T2>(other): Cell<number | T2>

• Type Parameters

  • T2

  Parameters

  • other: Cell<T2>

  Returns Cell<number | T2>

orElse

• orElse(alternative): Cell<number>

• Parameters

  • alternative: number

  Returns Cell<number>

toPromise

• toPromise(): Promise<number>

• Create a promise that resolves with the first non-null, non-undefined value of this cell. If the value of this cell is not null or undefined the method returns a resolved Promise with the value.

  Returns Promise<number>

  A promise that resolves when the value of this cell is not null or undefined.

unobserve

• unobserve(observer): void

• Detach an observer.

  Parameters

  • observer: CellObserver<number>

    The observer function to detach.

  Returns void

update

• update<T2>(mutator): T2

• Update the cell's value via a function.

  Type Parameters

  • T2

  Parameters

  • mutator: ((value) => T2)

    A function that modifies the value of this cell.

    • • (value): T2

      • Parameters

        • value: number

        Returns T2

  Returns T2

  If the mutator function returns a value, that value is returned by update as well.

  Example

  const a = cell({b: 5});
  a.update(a => a.b = 10);
  expect(a.value.b).toBe(10);
  Copy

updateDefined

• updateDefined<T2>(mutator): undefined | T2

• Same as update but the function is only applied if the value of the cell is not null or undefined.

  Type Parameters

  • T2

  Parameters

  • mutator: ((value) => T2)
    • • (value): T2

      • Parameters

        • value: number

        Returns T2

  Returns undefined | T2

Static from

• from<T>(observable, initialValue): Cell<T>

• Create a cell from an existing observable (e.g. an Emitter) and an initial value.

  N.B. Unless observed, the value of the resulting cell will not update when the observable emits events.

  Type Parameters

  • T

  Parameters

  • observable: Observable<T>

    An observable.
  • initialValue: T

    The initial value of the cell.

  Returns Cell<T>

  A cell.