nv-facutil-slct-ta 1.0.0 → 1.0.5

package/TEST/check.js

@@ -0,0 +1,180 @@
+const assert = require("assert");
+
+// ====== 你的 cp 函数 ======
+
+const AB_CLSES = [ArrayBuffer];
+if (globalThis.SharedArrayBuffer !== undefined) {
+    AB_CLSES.push(globalThis.SharedArrayBuffer)
+}
+
+const TA_CLSES = [
+    Uint8Array, Uint8ClampedArray, Uint16Array, Uint32Array, BigUint64Array,
+    Int8Array, Int16Array, Int32Array, BigInt64Array,
+    Float32Array, Float64Array
+];
+if (globalThis.Float16Array !== undefined) {
+    TA_CLSES.push(globalThis.Float16Array)
+}
+
+const VWLIKE_CLSES = [DataView];
+if (globalThis.Buffer !== undefined) { VWLIKE_CLSES.push(globalThis.Buffer) }
+if (globalThis.Blob !== undefined) { VWLIKE_CLSES.push(globalThis.Blob) }
+if (globalThis.File !== undefined) { VWLIKE_CLSES.push(globalThis.File) }
+
+const BUFLIKE_CLSES = [...AB_CLSES, ...TA_CLSES, ...VWLIKE_CLSES];
+
+function cp(o) {
+    var Cls = o.constructor;
+    if (TA_CLSES.includes(Cls) || Cls === DataView) {
+        var ab = o.buffer.slice(o.byteOffset, o.byteOffset + o.byteLength)
+        return new Cls(ab);
+    } else if (Cls === globalThis.Buffer) {
+        return globalThis?.Buffer?.from(o);
+    } else {
+        return o.slice(0)
+    }
+}
+
+// ====== 测试工具 ======
+
+function eq_buf(a, b) {
+    assert.strictEqual(a.byteLength, b.byteLength);
+    const ua = new Uint8Array(a);
+    const ub = new Uint8Array(b);
+    for (let i = 0; i < ua.length; i++) {
+        assert.strictEqual(ua[i], ub[i]);
+    }
+}
+
+function deep_test(orig, copy) {
+
+    assert.notStrictEqual(orig, copy);
+
+    if (orig instanceof ArrayBuffer || orig instanceof SharedArrayBuffer) {
+        eq_buf(orig, copy);
+    }
+    else if (ArrayBuffer.isView(orig)) {
+        assert.strictEqual(orig.length, copy.length);
+        for (let i = 0; i < orig.length; i++) {
+            assert.strictEqual(orig[i], copy[i]);
+        }
+    }
+    else if (orig instanceof Buffer) {
+        assert.strictEqual(orig.equals(copy), true);
+    }
+}
+
+// ====== TypedArray tests ======
+
+for (let Cls of TA_CLSES) {
+
+    const ta = new Cls(8);
+
+    for (let i = 0; i < ta.length; i++) {
+        if(Cls === BigInt64Array || Cls === BigUint64Array) {ta[i] = BigInt(i + 1);}  else {ta[i] = i + 1;}
+    }
+
+    const c = cp(ta);
+
+    deep_test(ta, c);
+
+    ta[0] = (Cls === BigInt64Array || Cls === BigUint64Array)?99n:99;
+
+    assert.notStrictEqual(ta[0], c[0]);
+
+}
+
+// ====== offset typedarray ======
+
+const buf = new ArrayBuffer(32);
+const ta = new Uint16Array(buf, 8, 4);
+
+for (let i = 0; i < ta.length; i++) {
+    ta[i] = i + 10;
+}
+
+const ta_copy = cp(ta);
+
+deep_test(ta, ta_copy);
+
+ta[0] = 999;
+
+assert.notStrictEqual(ta[0], ta_copy[0]);
+
+// ====== DataView ======
+
+const ab = new ArrayBuffer(16);
+const dv = new DataView(ab);
+
+dv.setUint32(0, 123456);
+
+const dv2 = cp(dv);
+
+assert.notStrictEqual(dv, dv2);
+assert.strictEqual(dv2.getUint32(0), 123456);
+
+dv.setUint32(0, 9);
+
+assert.notStrictEqual(dv.getUint32(0), dv2.getUint32(0));
+
+// ====== ArrayBuffer ======
+
+const ab1 = new ArrayBuffer(8);
+const v1 = new Uint8Array(ab1);
+v1[0] = 42;
+
+const ab2 = cp(ab1);
+
+eq_buf(ab1, ab2);
+
+v1[0] = 1;
+
+assert.notStrictEqual(new Uint8Array(ab2)[0], v1[0]);
+
+// ====== Buffer (Node) ======
+
+if (globalThis.Buffer) {
+
+    const b = Buffer.from([1, 2, 3, 4]);
+
+    const b2 = cp(b);
+
+    assert.notStrictEqual(b, b2);
+
+    assert.strictEqual(b.equals(b2), true);
+
+    b[0] = 9;
+
+    assert.notStrictEqual(b[0], b2[0]);
+}
+
+// ====== Blob ======
+
+if (globalThis.Blob) {
+
+    const blob = new Blob(["hello"]);
+
+    const blob2 = cp(blob);
+
+    assert.notStrictEqual(blob, blob2);
+
+    assert.strictEqual(blob.size, blob2.size);
+}
+
+// ====== File (browser) ======
+
+if (globalThis.File) {
+
+    const file = new File(["abc"], "a.txt");
+
+    const file2 = cp(file);
+
+    assert.notStrictEqual(file, file2);
+
+    assert.strictEqual(file.size, file2.size);
+
+}
+
+console.log("ALL TEST PASS");
+
+

package/index.js

@@ -1,3 +1,14 @@
+function check_sz_and_algn(sz,algnsz) {
+    if(sz<algnsz) {
+        return [false,`size(${sz}) MUST >= algnsz(${algnsz})`]
+    } else if(sz % algnsz !== 0) {
+	return [false,`size(${sz}) % algnsz(${algnsz}) = ${sz % algnsz} MUST == 0`]
+    } else {
+        return [true,null]
+    }
+}
+
+
 function calc_algn_si(si,algnsz) {
     var r = si % algnsz;
     if(r === 0) {
@@ -32,10 +43,10 @@ function get_ta_cls_with_max_cnt(cnt,using_u64_when_gt_safe_f64_int=false) {
 }
 
 const DUMP_ONE_BYTE_TYPE_MP = {
-    0: Uint8Array,
-    1: Uint16Array,
-    2: Uint32Array,
-    3: BigUint64Array, // js version NOT supported
+    0:   Uint8Array,
+    1:   Uint16Array,
+    2:   Uint32Array,
+    3:   BigUint64Array, // js version NOT supported
     255: Float64Array,
 }
 
@@ -63,12 +74,139 @@ function  get_display_name_prefix(TypedArrayClass) {
     return "Large";
 }
 
+const BRIEF_MIRR = new Map();
+BRIEF_MIRR.set("u8a",Uint8Array);
+BRIEF_MIRR.set("u8ca",Uint8ClampedArray);
+BRIEF_MIRR.set("u16a",Uint16Array);
+BRIEF_MIRR.set("u32a",Uint16Array);
+BRIEF_MIRR.set("u64a",BigUint64Array);
+BRIEF_MIRR.set("i8a",  Int8Array);
+BRIEF_MIRR.set("i16a", Int16Array);
+BRIEF_MIRR.set("i32a", Int32Array);
+BRIEF_MIRR.set("i64a", BigInt64Array);
+BRIEF_MIRR.set("f32a", Float32Array);
+BRIEF_MIRR.set("f64a", Float64Array);
+if (globalThis.Float16Array !== undefined) {BRIEF_MIRR.set("f16a", globalThis.Float16Array);}
+BRIEF_MIRR.set("dv", DataView);
+if (globalThis.Buffer !== undefined) {BRIEF_MIRR.set("buf", globalThis.Buffer);}
+if (globalThis.Blob !== undefined) {BRIEF_MIRR.set("blob", globalThis.Blob);}
+if (globalThis.File !== undefined) {BRIEF_MIRR.set("file", globalThis.File);}
+BRIEF_MIRR.set(Uint8Array,"u8a");
+BRIEF_MIRR.set(Uint8ClampedArray, "u8ca");
+BRIEF_MIRR.set(Uint16Array, "u16a");
+BRIEF_MIRR.set(Uint32Array, "u32a");
+BRIEF_MIRR.set(BigUint64Array, "u64a");
+BRIEF_MIRR.set(Int8Array, "i8a");
+BRIEF_MIRR.set(Int16Array, "i16a");
+BRIEF_MIRR.set(Int32Array, "i32a");
+BRIEF_MIRR.set(BigInt64Array, "i64a");
+BRIEF_MIRR.set(Float32Array, "f32a");
+BRIEF_MIRR.set(Float64Array, "f64a");
+
+if (globalThis.Float16Array !== undefined) {
+    BRIEF_MIRR.set(globalThis.Float16Array, "f16a");
+}
+
+BRIEF_MIRR.set(DataView, "dv");
+
+if (globalThis.Buffer !== undefined) {
+    BRIEF_MIRR.set(globalThis.Buffer, "buf");
+}
+
+if (globalThis.Blob !== undefined) {
+    BRIEF_MIRR.set(globalThis.Blob, "blob");
+}
+
+if (globalThis.File !== undefined) {
+    BRIEF_MIRR.set(globalThis.File, "file");
+}
+function get_brief_name(Cls) {return BRIEF_MIRR.get(Cls)}
+function get_cls_from_brief_name(brief) {return BRIEF_MIRR.get(brief.toLowerCase())}
+
+
+
+////
+const AB_CLSES = [ArrayBuffer];
+if(globalThis.SharedArrayBuffer!== undefined) { AB_CLSES.push(globalThis.SharedArrayBuffer)}
+
+const TA_CLSES = [
+   Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array,BigUint64Array,
+   Int8Array,                   Int16Array,Int32Array,BigInt64Array,
+   Float32Array,Float64Array
+];
+if(globalThis.Float16Array!== undefined) { TA_CLSES.push(globalThis.Float16Array)}
+
+const VWLIKE_CLSES = [DataView];
+if(globalThis.Buffer!== undefined) { VWLIKE_CLSES.push(globalThis.Buffer)}
+if(globalThis.Blob!==   undefined) { VWLIKE_CLSES.push(globalThis.Blob)}
+if(globalThis.File!==   undefined) { VWLIKE_CLSES.push(globalThis.File)}
+
+const BUFLIKE_CLSES = [...AB_CLSES,...TA_CLSES,...VWLIKE_CLSES];
+
+function cp(o) {
+   var Cls = o.constructor;
+   if(Cls === DataView ) {
+       var ab = o.buffer.slice(o.byteOffset,o.byteOffset+o.byteLength)
+       return new Cls(ab); 
+   } else if(Cls === globalThis.Buffer) {
+       return globalThis?.Buffer?.from(o);
+   } else {
+       return o.slice(0) 
+   }
+}
+
+function setv(ta,i,v) {
+    if(ta.constructor.BYTES_PER_ELEMENT === 8 && ta.constructor !== Float64Array) {
+        ta[i] = BigInt(v)    
+    } else {
+        ta[i] = v;
+    }
+}
+
+function is_readonly(o) {
+    if(globalThis.Blob!==   undefined && o.constructor === globalThis.Blob) { return true}
+    if(globalThis.File!==   undefined && o.constructor === globalThis.File) { return true}
+    return false;
+}
+
+function creat_debug_view(o) {
+    var ab     = o.buffer;    var offset = o.byteOffset; var sz = o.byteLength;
+    var view   = {};
+    view.u8a  = new Uint8Array(ab,offset,sz);
+    view.u8ca = new Uint8ClampedArray(ab,offset,sz);
+    view.u16a = new Uint16Array(ab,offset,sz/2);
+    view.u32a = new Uint32Array(ab,offset,sz/4);
+    view.u64a = new BigUint64Array(ab,offset,sz/8);
+    view.i8a  = new Int8Array(ab,offset,sz);
+    view.i16a = new Int16Array(ab,offset,sz/2);
+    view.i32a = new Int32Array(ab,offset,sz/4);
+    view.i64a = new BigInt64Array(ab,offset,sz/8);    
+    if (globalThis.Float16Array !== undefined) {view.f16a=new Float16Array(ab,offset,sz/2);;}
+    view.f32a = new Float32Array(ab,offset,sz/4);
+    view.f64a = new Float64Array(ab,offset,sz/8);
+    view.dv   = new DataView(ab,offset,sz);
+    return view;
+}
+
+
 module.exports = {
+    check_sz_and_algn,
     calc_algn_si,
     calc_max_incr_cnt,
     get_ta_cls_with_max_cnt,
     get_cls_from_dump_fst_byte,
     get_fst_byte_for_dump,
     set_fst_byte_for_dump,
-    get_display_name_prefix
+    ////
+    BRIEF_MIRR,
+    get_display_name_prefix,
+    get_brief_name,get_cls_from_brief_name,
+    ////
+    AB_CLSES,TA_CLSES,VWLIKE_CLSES,BUFLIKE_CLSES,
+    ////
+    cp,
+    setv,
+    is_readonly,
+    ////
+    creat_debug_view
 }   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nv-facutil-slct-ta",
-  "version": "1.0.0",
+  "version": "1.0.5",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"