@creejs/commons-lang 2.1.9 → 2.1.11

package/types/array-buffer-utils.d.ts

@@ -1,6 +1,7 @@
 declare namespace _default {
     export { readString };
     export { writeString };
+    export { writeArrayBuffer };
 }
 export default _default;
 /**
@@ -24,3 +25,27 @@ export function readString(buffer: ArrayBuffer, offset?: number, length?: number
  * @returns {void}
  */
 export function writeString(buffer: ArrayBuffer, str: string, offset?: number): void;
+/**
+ * Writes an ArrayBuffer into a target ArrayBuffer at the specified offset.
+ * 1. targetOffset
+ *    * Negative index counts back from the end of the buffer
+ *      * if -target.length <= targetOffset < 0, start + target.length is used.
+ *    * If targetOffset < -buffer.length or targetOffset is omitted, 0 is used.
+ *    * If targetOffset >= buffer.length, throw "Out of target Bounds" Error
+ * 2. dataOffset
+ *    * Negative index counts back from the end of the buffer
+ *      * if -dataArrayBuffer.length <= dataOffset < 0, start + dataArrayBuffer.length is used.
+ *    * If dataOffset < -buffer.length or dataOffset is omitted, 0 is used.
+ *    * If dataOffset >= buffer.length, throw "Out of data Bounds" Error
+ * 3. dataLength
+ *    * if dataLength <= 0, throw "Not Positive" Error
+ *    * if dataLength is omitted, read all bytes from dataOffset to the end of dataArrayBuffer
+ *    * if dataLength + dataOffset > dataArrayBuffer.length, read all bytes from dataOffset to the end of dataArrayBuffer
+ * @param {ArrayBuffer} target - The target buffer to write into.
+ * @param {ArrayBuffer} dataArrayBuffer - The data ArrayBuffer to write.
+ * @param {number} [targetOffset=0] - Zero-based index at which to start write.
+ * @param {number} [dataOffset=0] - The offset in the dataArrayBuffer
+ * @param {number} [dataLength] - how many bytes extract from dataArrayBuffer
+ * @returns {void}
+ */
+export function writeArrayBuffer(target: ArrayBuffer, dataArrayBuffer: ArrayBuffer, targetOffset?: number, dataOffset?: number, dataLength?: number): void;

package/types/index.d.ts

@@ -13,6 +13,7 @@ declare namespace _default {
     export { ReflectUtils };
     export { TypedArrayUtils };
     export { ArrayBufferUtils };
+    export { TimeUtils };
 }
 export default _default;
 import LangUtils from './lang-utils.js';
@@ -26,4 +27,5 @@ import InstanceProxyUtils from './instance-proxy-utils.js';
 import ReflectUtils from './reflect-utils.js';
 import TypedArrayUtils from './typed-array-utils.js';
 import ArrayBufferUtils from './array-buffer-utils.js';
-export { LangUtils, StringUtils, TypeUtils, TypeAssert, ExecUtils, PromiseUtils, LangUtils as Lang, TypeUtils as Type, ExecUtils as Exec, ClassProxyUtils, InstanceProxyUtils, ReflectUtils, TypedArrayUtils, ArrayBufferUtils };
+import TimeUtils from './time-utils.js';
+export { LangUtils, StringUtils, TypeUtils, TypeAssert, ExecUtils, PromiseUtils, LangUtils as Lang, TypeUtils as Type, ExecUtils as Exec, ClassProxyUtils, InstanceProxyUtils, ReflectUtils, TypedArrayUtils, ArrayBufferUtils, TimeUtils };

package/types/time-utils.d.ts

@@ -0,0 +1,10 @@
+declare namespace _default {
+    export { timestamp64 };
+}
+export default _default;
+/**
+ * Gets the current timestamp in nanoseconds (if running in Node.js) or milliseconds (in browser).
+ * Uses `process.hrtime.bigint()` for high-resolution timestamps in Node.js, falls back to `Date.now()` in browsers.
+ * @returns {bigint} Current timestamp as a BigInt
+ */
+export function timestamp64(): bigint;