nv-buf-resize-mthd 1.0.0

package/index.d.ts

@@ -0,0 +1,84 @@
+export type IntLike = number;
+export type UintLike = number;
+export type TypedArray =
+    | Int8Array
+    | Uint8Array
+    | Uint8ClampedArray
+    | Int16Array
+    | Uint16Array
+    | Int32Array
+    | Uint32Array
+    | Float32Array
+    | Float64Array
+    | BigInt64Array
+    | BigUint64Array;
+
+export interface ResizeCfg {
+    stride: number
+    expand_ratio: number
+    aloc?: (oldBuf: TypedArray, newLen: number) => TypedArray
+    copy?: (src: TypedArray, dst: TypedArray, cnt: number) => void
+}
+
+export interface BufCore<TA extends TypedArray = TypedArray> {
+    buf: TA
+    ei: number
+
+    length: number
+
+    capacity(): number
+
+    get(unit_index: UintLike): any
+
+    _set(
+        unit_index: UintLike,
+        v: number | TA
+    ): number
+}
+
+export interface BufMethods<TA extends TypedArray = TypedArray> {
+    size(): number
+    empty(): boolean
+    is_full(): boolean
+
+    dflt_incr_cnt_when_expand(): number
+    dflt_decr_cnt_when_shrink(): number
+
+    get_lst(): any
+
+    _expand(incr_cnt: number): void
+    expand(): number
+
+    push(v: any): any
+    set(unit_index: number, v: any): any
+    pop(): any
+
+    _shrink(decr_cnt: number): void
+
+    shrink_to_fit(): number
+    shrink(decr_cnt: number): number
+
+    resize(cnt: number): number
+}
+
+export type BufLike<TA extends TypedArray = TypedArray> =
+    BufCore<TA> & BufMethods<TA> & ResizeCfg
+
+export type NeedImplDesc = {
+    type: "accessor" | "getter" | "method"
+    value_type?: string
+    param_types?: Record<string, string>
+    rtrn_type?: string
+}
+
+export const NEED_IMPLS: Record<string, NeedImplDesc>
+
+export const IMPLED_MTHDS: BufMethods
+
+export const PX_HANDLES: ProxyHandler<any>
+
+export function add_impled_mthds<T extends new (...args: any[]) => any>(
+    BufCls: T
+): void
+
+export function creat_px<T extends object>(target: T): T

package/index.js

@@ -0,0 +1,110 @@
+
+const {
+    fmt_cfg,
+    DFLT_ALOC,DFLT_COPY,
+    DFLT_CFG,
+    _expand,
+    _shrink
+} = require("nv-buf-resize-util")
+
+
+
+const NEED_IMPLS = {
+   "buf"     :  {type:"accessor", value_type:'typed_array'},         //ta typed-array 
+   "ei"      :  {type:"accessor", value_type:'intlike'}, 
+   "length"  :  {type:"getter"  , value_type:'intlike'},
+   "capacity":  {type:"method"  , param_types:{/*{[name]:<value_type>}*/},rtrn_type:'intlike'},
+   "get"     :  {type:"method"  , param_types:{unit_index:"uintlike"},rtrn_type:'intlike'},
+   "_set"    :  {type:"method"  , param_types:{unit_index:"uintlike",v:"intlike@(if_stride_eq_1) | typed_array@(if_stride_gt_1)"},rtrn_type:'intlike'},
+} 
+
+
+
+const IMPLED_MTHDS = {
+    size: function()  {return this.ei;},
+    empty: function()  {return this.ei === 0;},
+    is_full:function()  {return this.ei === this.capacity();},
+    dflt_incr_cnt_when_expand : function() { return Math.ceil(this.capacity()*this.expand_ratio)},
+    dflt_decr_cnt_when_shrink : function() { return this.capacity() - this.ei;},
+    get_lst : function() {return this.get(this.ei -1);},
+    _expand: function(incr_cnt) {this.buf = _expand(this.buf,incr_cnt,this); },
+    expand: function()         {var incr_cnt = this.dflt_incr_cnt_when_expand(); this._expand(incr_cnt); return incr_cnt;},
+    push: function(v) {
+        if(!this.is_full()) {} else {this._expand(this.dflt_incr_cnt_when_expand());}
+        this._set(this.ei,v);
+        ++this.ei;
+        return v;
+    },
+    set: function(unit_index,v) {
+        while(unit_index>= this.capacity()) { this._expand(this.dflt_incr_cnt_when_expand());}
+        this._set(unit_index,v);
+        if(unit_index < this.ei) {} else {this.ei = unit_index +1;}
+        return v;
+    },
+    pop: function() {
+        var v = this.get_lst();
+        --this.ei;
+        return v;
+    },
+    _shrink: function(decr_cnt) {this.buf = _shrink(this.buf,decr_cnt,this);},
+    shrink_to_fit: function() {
+        var decr_cnt = this.decr_cnt_when_shrink();
+        this.buf = _shrink(this.buf,decr_cnt,this)
+        return decr_cnt;
+    },
+    shrink: function(decr_cnt) {
+        var mx_decr_cnt = this.decr_cnt_when_shrink();
+        decr_cnt = (decr_cnt < mx_decr_cnt)?decr_cnt:mx_decr_cnt;
+        this._shrink(decr_cnt);
+        return decr_cnt;
+    },
+    resize: function(cnt) {
+	var cap = this.capacity();
+        if(cnt>cap) {
+            this._expand(cnt-cap);
+        } else if(cnt === cap) {
+        } else {
+            this._shrink(cap-cnt);
+        }
+        return cnt;
+    }
+}
+
+
+const PX_HANDLES =  {
+    get (target, k, receiver)              {
+        var i = Number(k);
+        if(Number.isInteger(i)) {
+            return target.get(i)
+        } else        {
+            return Reflect.get(target,k);
+        }
+    },
+    set (target, k, v,receiver)            {
+        var i = Number(k);
+        if(Number.isInteger(i)) {
+            target.set(i,v);
+        } else        {
+            Reflect.set(target,k);
+        }
+        return true
+    },
+    deleteProperty(target, k)              {return false;},
+    getOwnPropertyDescriptor(target, prop) {return { configurable:true,enumerable: true,writable:true};},
+    ownKeys(target)                        {return Reflect.ownKeys(target);},
+    has(target, k)                         {return target.get(k) !== undefined;},
+    getPrototypeOf(target)                 {return null;}
+} 
+
+const add_impled_mthds = (BufCls)=>{
+    for(let name in IMPLED_MTHDS) {
+        BufCls.prototype[name] = IMPLED_MTHDS[name];
+    }
+}
+
+module.exports = add_impled_mthds;
+module.exports.creat_px = (target)=>new Proxy(target,PX_HANDLES);
+////
+module.exports.NEED_IMPLS   = NEED_IMPLS;
+module.exports.IMPLED_MTHDS = IMPLED_MTHDS;
+module.exports.PX_HANDLES   = PX_HANDLES;

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "nv-buf-resize-mthd",
+  "version": "1.0.0",
+  "main": "index.js",
+  "dependencies": {
+    "nv-buf-resize-util": "^1.0.0"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "description": ""
+}