idlize

1
/*
2
 * Copyright (c) 2022-2024 Huawei Device Co., Ltd.
3
 * Licensed under the Apache License, Version 2.0 (the "License");
4
 * you may not use this file except in compliance with the License.
5
 * You may obtain a copy of the License at
6
 *
7
 * http://www.apache.org/licenses/LICENSE-2.0
8
 *
9
 * Unless required by applicable law or agreed to in writing, software
10
 * distributed under the License is distributed on an "AS IS" BASIS,
11
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
 * See the License for the specific language governing permissions and
13
 * limitations under the License.
14
 */
15

16
import { uint64 } from "@koalaui/common"
17
import { GlobalStateManager } from "../states/GlobalStateManager"
18
import { MutableState, StateContext } from "../states/State"
19

20
const GLOBAL_ANIMATION_TIMER = "ohos.koala.runtime.global.animation.timer"
21

22
/**
23
 * @returns the state for the global animation timer, or `undefined`
24
 * @internal
25
 */
26
export function getAnimationTimer(context: StateContext = GlobalStateManager.instance): MutableState<uint64> | undefined {
27
    return context.stateBy<uint64>(GLOBAL_ANIMATION_TIMER, true)
28
}
29

30
/**
31
 * @param initial - initial timestamp for a timer
32
 * @returns new state for the global animation timer
33
 * @throws an error if it is already initialized
34
 * @internal
35
 */
36
export function createAnimationTimer(context: StateContext, initial: uint64 = 0): MutableState<uint64> {
37
    if (getAnimationTimer(context) !== undefined) throw new Error("the global animation timer is already initialized")
38
    return context.namedState(GLOBAL_ANIMATION_TIMER, () => initial, true, undefined, undefined)
39
}
40