libraries/stdlib/js/runtime/bitUtils.kt

/*
 * Copyright 2010-2026 JetBrains s.r.o. and Kotlin Programming Language contributors.
 * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
 */

package kotlin.js

import kotlin.internal.UsedFromCompilerGeneratedCode
import kotlin.js.internal.boxedLong.BoxedLongApi

// TODO use declarations from stdlib
private external class ArrayBuffer(size: Int)
private external class Float64Array(buffer: ArrayBuffer)
private external class Float32Array(buffer: ArrayBuffer)
private external class Int32Array(buffer: ArrayBuffer)

private val buf = ArrayBuffer(8)
// TODO use one DataView instead of bunch of typed views.
private val bufFloat64 = Float64Array(buf).unsafeCast<DoubleArray>()
private val bufFloat32 = Float32Array(buf).unsafeCast<FloatArray>()
private val bufInt32 = Int32Array(buf).unsafeCast<IntArray>()

private val lowIndex = run {
    bufFloat64[0] = -1.0  // bff00000_00000000
    if (bufInt32[0] != 0) 1 else 0
}
private val highIndex = 1 - lowIndex

@OptIn(BoxedLongApi::class) // Long constructor is intrinsified when BigInt-backed Longs are enabled.
internal fun doubleToRawBits(value: Double): Long {
    bufFloat64[0] = value
    return Long(bufInt32[lowIndex], bufInt32[highIndex])
}

@PublishedApi
@OptIn(BoxedLongApi::class) // Long `high` and `low` properties are intrinsified when BigInt-backed Longs are enabled.
internal fun doubleFromBits(value: Long): Double {
    bufInt32[lowIndex] = value.low
    bufInt32[highIndex] = value.high
    return bufFloat64[0]
}

internal fun floatToRawBits(value: Float): Int {
    bufFloat32[0] = value
    return bufInt32[0]
}

@PublishedApi
internal fun floatFromBits(value: Int): Float {
    bufInt32[0] = value
    return bufFloat32[0]
}

// returns zero value for number with positive sign bit and non-zero value for number with negative sign bit.
internal fun doubleSignBit(value: Double): Int {
    bufFloat64[0] = value
    return bufInt32[highIndex] and Int.MIN_VALUE
}

@UsedFromCompilerGeneratedCode
internal fun getNumberHashCode(obj: Double): Int {
    // JS VMs don't canonicalize NaN values, so their raw bytes may differ
    // (spec: https://tc39.es/ecma262/multipage/structured-data.html#sec-numerictorawbytes).
    // Without user-land canonicalization, the values of the [bufInt32] elements
    // could differ for different NaN representations (KT-86954).
    // However, NaN hash codes should be consistent with equality semantics.
    // To ensure this, we canonicalize NaN values in place before computing the hash code.
    val value = if (obj.isNaN()) Double.NaN else obj
    @Suppress("DEPRECATED_IDENTITY_EQUALS")
    if (jsBitwiseOr(value, 0).unsafeCast<Double>() === value) {
        return value.toInt()
    }

    bufFloat64[0] = value
    return bufInt32[highIndex] * 31 + bufInt32[lowIndex]
}