Interface KaylaState<T>

alwaysRecall

0

• get "0"(): T

  Returns T

value

• get value(): T

  The current value of the state.

  Reading this property is always safe and does not trigger side effects.

  Returns T

lastChanged

• get lastChanged(): number

  Timestamp (milliseconds since epoch) of the last time the state was changed via .set().

  Useful for dependency tracking or knowing when the value was last mutated.

  Returns number

get

• get(this: KaylaState<T>): T

  Get the current value

  Parameters

  • this: KaylaState<T>

  Returns T

1

• "1"(s: T): void

  Parameters

  • s: T

  Returns void

legacy

• legacy(): [T, (val: T) => void]

  Returns [T, (val: T) => void]

add

• add(
      this: KaylaState<number>,
      added: number,
      options?: { recall?: boolean },
  ): void

  Adds a number to the current value (only available when T is number).

  Convenience method that calls .set(get() + added). Behaves exactly like .set() regarding refresh overhead.

  Parameters

  • this: KaylaState<number>
  • added: number

    Value to add

  • options: { recall?: boolean } = {}

    Optional control over refresh

    • Optionalrecall?: boolean

      Force refresh (default: false)

  Returns void

multiply

• multiply(
      this: KaylaState<number>,
      added: number,
      multiplier?: { recall?: boolean },
  ): void

  Multiplies the current value by a number (only available when T is number).

  Convenience method that calls .set(get() * multiplier). Behaves exactly like .set() regarding refresh overhead.

  Parameters

  • this: KaylaState<number>
  • added: number
  • multiplier: { recall?: boolean } = {}

    Value to multiply by

  Returns void

set

• set(this: KaylaState<T>, s: T, newValue?: { recall?: boolean }): void

  Updates the state value.

  If the new value differs from the current one (strict !== comparison), and either recall: true is passed or alwaysRecall was set at creation, this triggers a component refresh.

  Refreshing re-runs the entire component function, re-binds hooks, and may re-mount/unmount children — avoid in hot paths.

  Parameters

  • this: KaylaState<T>
  • s: T
  • newValue: { recall?: boolean } = {}

    The new state value

  Returns void