@peter.naydenov/walk-async 6.1.0 → 7.0.1

package/dist/walk-async.cjs

@@ -1 +1 @@
-"use strict";var e=require("ask-for-promise");async function o(e,o,n){for await(const o of e)await o.next();n.done(o)}function n(e){return null==e||e.nodeType?"simple":e instanceof Array?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}async function*t(e,o,n,t,a,i){yield await r(e,o,n,t,a,...i)}function a(e,o,n){"__proto__"===o?Object.defineProperty(e,o,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[o]=n}function r(o,r,i,l,s,...c){let[d,u,p]=l,f=Object.keys(o),m=e(f),b=e();return f.forEach((f,b)=>{let y=n(o[f]),$=o[f],k="simple"!==y&&null!=u,j=e(),v=e(),_=e(),C="array"===n(r),w=!isNaN(f),h=Symbol("ignore___"),g=`${s}/${f}`,S=`objectCallback at '${g}'`,x=`keyCallback at '${g}'`;k?(p.add(S),u({resolve:j.done,reject:()=>j.done(h),value:$,key:f,breadcrumbs:g},...c)):j.done("$$cancel"),j.onComplete(e=>{if(p.delete(S),"$$cancel"!==e||d){if("$$cancel"!==e&&($=e,y=n($)),$==h)return m.promises[b].done("ignore object"),v.done("$$cancel"),void _.done();if("simple"===y){if(!d)return void v.done("$$noUpdates");p.add(x),d({resolve:v.done,reject:()=>v.done(h),value:$,key:f,breadcrumbs:g},...c)}else v.done("$$cancel")}else v.done("$$noUpdates")}),v.onComplete(e=>{if(p.delete(x),e==h)return m.promises[b].done("ignore key"),void _.done();if("$$cancel"!==e){if("$$noUpdates"!==e&&($=e,y=n($)),"simple"===y){const e=function(e,o){return o instanceof Array&&!isNaN(e)}(f,r);return e?r.push($):a(r,f,$),void m.promises[b].done("key")}_.done()}else _.done()}),_.onComplete(()=>{if("object"===y){const e={};C&&w?r.push(e):a(r,f,e),i.push(t($,e,i,l,g,c)),m.promises[b].done("object")}if("array"===y){const e=[];C&&w?r.push(e):a(r,f,e),i.push(t($,e,i,l,g,c)),m.promises[b].done("array")}})}),m.onComplete(e=>b.done()),b.promise}module.exports=function({data:t,objectCallback:a=null,keyCallback:i=null,timeout:l=null},...s){let c,d=n(t),u=[],p="root",f=new Set,m=[i,a,f],b=e(),y=e(),$=Symbol("ignore___");if("simple"!==d&&a?(f.add("objectCallback at 'root'"),a({resolve:y.done,reject:()=>y.done($),value:t,key:"root",breadcrumbs:p},...s)):y.done(t),y.onComplete(e=>{if(f.delete("objectCallback at 'root'"),e!==$)switch(n(e)){case"array":c=[],r(e,c,u,m,p,...s).then(()=>o(u,c,b));break;case"object":c={},r(e,c,u,m,p,...s).then(()=>{o(u,c,b)});break;case"simple":b.done(e)}else b.done("array"===d?[]:{})}),null==l)return b.promise;const k=Symbol("expired___"),j=e();return b.timeout(l,k),b.onComplete(e=>{if(e!==k)return void j.done(e);const o=[...f].map(e=>`\n  - ${e}`).join("");j.cancel(new Error(`walk-async: timed out after ${l}ms; callbacks still pending:${o}`))}),j.promise};
+"use strict";function e(e){return null==e||e.nodeType?"simple":Array.isArray(e)?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}function t(e,t){if(!Array.isArray(t))return!1;const a=Number(e);return Number.isInteger(a)&&a>=0&&a<4294967295&&String(a)===e}function a(e,t,a){"__proto__"===t?Object.defineProperty(e,t,{value:a,enumerable:!0,writable:!0,configurable:!0}):e[t]=a}const n=new WeakSet;function r(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return n.add(t),t}function i(e){return n.has(e)}function o(e,t,a,n,i,o){return o.breadcrumbs&&o.parentPath?{value:e,key:t,breadcrumbs:n,parentPath:i,IGNORE:a,FINISH:r}:o.breadcrumbs?{value:e,key:t,breadcrumbs:n,IGNORE:a,FINISH:r}:o.parentPath?{value:e,key:t,parentPath:i,IGNORE:a,FINISH:r}:{value:e,key:t,IGNORE:a,FINISH:r}}const c=new WeakSet;function s(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return c.add(t),t}function u(e){return c.has(e)}const l=Symbol("ignore___");function f(){return l}function p(e){return e===l}async function d(e,t,a,n,...o){let c,l,p=`${n} at '${t.breadcrumbs??t.key}'`;function d(){c||(c=new Promise(e=>{l=e}),c.catch(()=>{}))}Object.defineProperties(t,{resolve:{enumerable:!0,get:()=>(d(),l)},reject:{enumerable:!0,get:()=>(d(),()=>l(f()))}}),a.add(p);try{const a=await e(t,...o),l=c?await c:a;return"objectCallback"===n&&u(l)&&l.hasValue?s(await l.value):i(l)&&l.hasValue?r(await l.value):l}finally{a.delete(p)}}async function y(n,r,c,l,y,v,k,w,j,P,g,S,...I){let[O,C]=l,F=Object.keys(n),V=v.detectCycles?{data:n,location:r,parent:P,depth:P?P.depth+1:0}:void 0,N=!1;g&&g.set(n,V);for(let l=0;l<F.length&&!N;l++){const P=F[l];let A=n[P],$=e(A),_=v.copy&&t(P,r),E=v.breadcrumbs&&("simple"!==$||!j&&O)?`${y}/${P}`:void 0,z=!1;if("simple"!==$&&C&&!k.isFinished){const t=o(A,P,f,E,w,v);t.PASS=s;const a=await d(C,t,S,"objectCallback",...I);if(i(a)){if(!a.hasValue||!O)return b(a,r,P,_,v,k),V;c.length=0,k.restart=!0,k.isFinished=!0,N=!0,A=a.value}else{if(p(a))continue;u(a)?(z=!0,a.hasValue&&(A=a.value)):A=a}$=e(A)}if("simple"===$){if(z||j&&!k.isFinished||!O){if(!v.copy)continue;_?r.push(A):a(r,P,A);continue}const t=o(A,P,f,E,w,v);t.isFinished=k.isFinished;let n=await d(O,t,S,"keyCallback",...I);if(i(n))return b(n,r,P,_,v,k),V;if(p(n))continue;const c=e(n);if("simple"===c){if(!v.copy)continue;_?r.push(n):a(r,P,n);continue}A=n,$=c}const R=v.detectCycles?m(A,V,g):void 0;if(R){if(!v.copy)continue;_?r.push(R.location):a(r,P,R.location)}else{if("object"===$){const e=v.copy?{}:void 0;v.copy&&(_?r.push(e):a(r,P,e)),c.push(h(A,e,E,w,P,z,V))}if("array"===$){const e=v.copy?[]:void 0;v.copy&&(_?r.push(e):a(r,P,e)),c.push(h(A,e,E,w,P,z,V))}}}return V}function b(e,t,n,r,i,o){o.finished=!0,i.copy&&e.hasValue&&(r?t.push(e.value):a(t,n,e.value))}function h(e,t,a,n,r,i,o){return{data:e,location:t,breadcrumbs:a,parentPath:n,key:r,pass:i,parent:o}}function m(e,t,a){if(a)return a.get(e);for(let a=t;a;a=a.parent)if(a.data===e)return a}function v(e,t,a){if(!a){if(t.depth<32)return;a=new WeakMap;for(let e=t;e;e=e.parent)a.set(e.data,e);return a}const n=[];for(;e!==t;)e.depth>=t.depth?(a.delete(e.data),e=e.parent):(n.push(t),t=t.parent);for(let e=n.length-1;e>=0;e--){const t=n[e];a.set(t.data,t)}return a}module.exports=async function(t,...a){const n=new Set,r=async function(t,a,...n){let r,c,l,{data:b,keyCallback:h,objectCallback:m,settings:k}=t,w=e(b),j=[],P=!(!h&&!m),g={copy:!1!==k?.copy,breadcrumbs:P&&!1!==k?.breadcrumbs,parentPath:P&&!1!==k?.parentPath,detectCycles:!1!==k?.detectCycles},S=g.breadcrumbs?"root":void 0,I=g.parentPath&&"simple"!==w?Object.freeze(["root"]):void 0,O=!1,C={finished:!1,isFinished:!1,restart:!1},F=[h,m];if("simple"!==w&&m){const t=o(b,"root",f,S,g.parentPath?Object.freeze([]):void 0,g);t.PASS=s;const r=await d(m,t,a,"objectCallback",...n);if(i(r)){if(!r.hasValue){if(!g.copy)return;return"array"===w?[]:{}}if(!h)return g.copy?r.value:void 0;C.isFinished=!0,b=r.value}else{if(p(r)){if(!g.copy)return;return"array"===w?[]:{}}u(r)?(O=!0,r.hasValue&&(b=r.value)):b=r}w=e(b)}switch(w){case"array":r=g.copy?[]:void 0,l=await y(b,r,j,F,S,g,C,I,O,void 0,c,a,...n);break;case"object":r=g.copy?{}:void 0,l=await y(b,r,j,F,S,g,C,I,O,void 0,c,a,...n);break;case"simple":return g.copy?b:void 0}for(let e=0;e<j.length&&!C.finished;){const t=j[e];j[e]=void 0,C.restart=!1,g.detectCycles&&(c=v(l,t.parent,c));const r=g.parentPath?Object.freeze([...t.parentPath,t.key]):void 0;l=await y(t.data,t.location,j,F,t.breadcrumbs,g,C,r,t.pass,t.parent,c,a,...n),e=C.restart?0:e+1}return r}(t,n,...a);if(null==t.timeout)return r;let c;const l=new Promise((e,a)=>{c=setTimeout(()=>{const e=[...n].map(e=>`\n  - ${e}`).join("");a(new Error(`walk-async: timed out after ${t.timeout}ms; callbacks still pending:${e}`))},t.timeout)});try{return await Promise.race([r,l])}finally{clearTimeout(c)}};

package/dist/walk-async.esm.mjs

@@ -1 +1 @@
-import e from"ask-for-promise";function o({data:o,objectCallback:t=null,keyCallback:r=null,timeout:l=null},...c){let s,d=a(o),f=[],p="root",u=new Set,m=[r,t,u],b=e(),y=e(),$=Symbol("ignore___");if("simple"!==d&&t?(u.add("objectCallback at 'root'"),t({resolve:y.done,reject:()=>y.done($),value:o,key:"root",breadcrumbs:p},...c)):y.done(o),y.onComplete(e=>{if(u.delete("objectCallback at 'root'"),e!==$)switch(a(e)){case"array":s=[],i(e,s,f,m,p,...c).then(()=>n(f,s,b));break;case"object":s={},i(e,s,f,m,p,...c).then(()=>{n(f,s,b)});break;case"simple":b.done(e)}else b.done("array"===d?[]:{})}),null==l)return b.promise;const k=Symbol("expired___"),j=e();return b.timeout(l,k),b.onComplete(e=>{if(e!==k)return void j.done(e);const o=[...u].map(e=>`\n  - ${e}`).join("");j.cancel(new Error(`walk-async: timed out after ${l}ms; callbacks still pending:${o}`))}),j.promise}async function n(e,o,n){for await(const o of e)await o.next();n.done(o)}function a(e){return null==e||e.nodeType?"simple":e instanceof Array?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}async function*t(e,o,n,a,t,r){yield await i(e,o,n,a,t,...r)}function r(e,o,n){"__proto__"===o?Object.defineProperty(e,o,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[o]=n}function i(o,n,i,l,c,...s){let[d,f,p]=l,u=Object.keys(o),m=e(u),b=e();return u.forEach((u,b)=>{let y=a(o[u]),$=o[u],k="simple"!==y&&null!=f,j=e(),_=e(),v=e(),C="array"===a(n),w=!isNaN(u),h=Symbol("ignore___"),g=`${c}/${u}`,S=`objectCallback at '${g}'`,x=`keyCallback at '${g}'`;k?(p.add(S),f({resolve:j.done,reject:()=>j.done(h),value:$,key:u,breadcrumbs:g},...s)):j.done("$$cancel"),j.onComplete(e=>{if(p.delete(S),"$$cancel"!==e||d){if("$$cancel"!==e&&($=e,y=a($)),$==h)return m.promises[b].done("ignore object"),_.done("$$cancel"),void v.done();if("simple"===y){if(!d)return void _.done("$$noUpdates");p.add(x),d({resolve:_.done,reject:()=>_.done(h),value:$,key:u,breadcrumbs:g},...s)}else _.done("$$cancel")}else _.done("$$noUpdates")}),_.onComplete(e=>{if(p.delete(x),e==h)return m.promises[b].done("ignore key"),void v.done();if("$$cancel"!==e){if("$$noUpdates"!==e&&($=e,y=a($)),"simple"===y){const e=function(e,o){return o instanceof Array&&!isNaN(e)}(u,n);return e?n.push($):r(n,u,$),void m.promises[b].done("key")}v.done()}else v.done()}),v.onComplete(()=>{if("object"===y){const e={};C&&w?n.push(e):r(n,u,e),i.push(t($,e,i,l,g,s)),m.promises[b].done("object")}if("array"===y){const e=[];C&&w?n.push(e):r(n,u,e),i.push(t($,e,i,l,g,s)),m.promises[b].done("array")}})}),m.onComplete(e=>b.done()),b.promise}export{o as default};
+function e(e){return null==e||e.nodeType?"simple":Array.isArray(e)?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}function t(e,t){if(!Array.isArray(t))return!1;const a=Number(e);return Number.isInteger(a)&&a>=0&&a<4294967295&&String(a)===e}function a(e,t,a){"__proto__"===t?Object.defineProperty(e,t,{value:a,enumerable:!0,writable:!0,configurable:!0}):e[t]=a}const n=new WeakSet;function r(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return n.add(t),t}function i(e){return n.has(e)}function o(e,t,a,n,i,o){return o.breadcrumbs&&o.parentPath?{value:e,key:t,breadcrumbs:n,parentPath:i,IGNORE:a,FINISH:r}:o.breadcrumbs?{value:e,key:t,breadcrumbs:n,IGNORE:a,FINISH:r}:o.parentPath?{value:e,key:t,parentPath:i,IGNORE:a,FINISH:r}:{value:e,key:t,IGNORE:a,FINISH:r}}const c=new WeakSet;function s(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return c.add(t),t}function u(e){return c.has(e)}const l=Symbol("ignore___");function f(){return l}function p(e){return e===l}async function d(e,t,a,n,...o){let c,l,p=`${n} at '${t.breadcrumbs??t.key}'`;function d(){c||(c=new Promise(e=>{l=e}),c.catch(()=>{}))}Object.defineProperties(t,{resolve:{enumerable:!0,get:()=>(d(),l)},reject:{enumerable:!0,get:()=>(d(),()=>l(f()))}}),a.add(p);try{const a=await e(t,...o),l=c?await c:a;return"objectCallback"===n&&u(l)&&l.hasValue?s(await l.value):i(l)&&l.hasValue?r(await l.value):l}finally{a.delete(p)}}async function y(n,r,c,l,y,v,k,w,j,P,g,S,...I){let[O,C]=l,F=Object.keys(n),V=v.detectCycles?{data:n,location:r,parent:P,depth:P?P.depth+1:0}:void 0,N=!1;g&&g.set(n,V);for(let l=0;l<F.length&&!N;l++){const P=F[l];let A=n[P],$=e(A),_=v.copy&&t(P,r),E=v.breadcrumbs&&("simple"!==$||!j&&O)?`${y}/${P}`:void 0,z=!1;if("simple"!==$&&C&&!k.isFinished){const t=o(A,P,f,E,w,v);t.PASS=s;const a=await d(C,t,S,"objectCallback",...I);if(i(a)){if(!a.hasValue||!O)return b(a,r,P,_,v,k),V;c.length=0,k.restart=!0,k.isFinished=!0,N=!0,A=a.value}else{if(p(a))continue;u(a)?(z=!0,a.hasValue&&(A=a.value)):A=a}$=e(A)}if("simple"===$){if(z||j&&!k.isFinished||!O){if(!v.copy)continue;_?r.push(A):a(r,P,A);continue}const t=o(A,P,f,E,w,v);t.isFinished=k.isFinished;let n=await d(O,t,S,"keyCallback",...I);if(i(n))return b(n,r,P,_,v,k),V;if(p(n))continue;const c=e(n);if("simple"===c){if(!v.copy)continue;_?r.push(n):a(r,P,n);continue}A=n,$=c}const R=v.detectCycles?m(A,V,g):void 0;if(R){if(!v.copy)continue;_?r.push(R.location):a(r,P,R.location)}else{if("object"===$){const e=v.copy?{}:void 0;v.copy&&(_?r.push(e):a(r,P,e)),c.push(h(A,e,E,w,P,z,V))}if("array"===$){const e=v.copy?[]:void 0;v.copy&&(_?r.push(e):a(r,P,e)),c.push(h(A,e,E,w,P,z,V))}}}return V}function b(e,t,n,r,i,o){o.finished=!0,i.copy&&e.hasValue&&(r?t.push(e.value):a(t,n,e.value))}function h(e,t,a,n,r,i,o){return{data:e,location:t,breadcrumbs:a,parentPath:n,key:r,pass:i,parent:o}}function m(e,t,a){if(a)return a.get(e);for(let a=t;a;a=a.parent)if(a.data===e)return a}async function v(t,...a){const n=new Set,r=async function(t,a,...n){let r,c,l,{data:b,keyCallback:h,objectCallback:m,settings:v}=t,w=e(b),j=[],P=!(!h&&!m),g={copy:!1!==v?.copy,breadcrumbs:P&&!1!==v?.breadcrumbs,parentPath:P&&!1!==v?.parentPath,detectCycles:!1!==v?.detectCycles},S=g.breadcrumbs?"root":void 0,I=g.parentPath&&"simple"!==w?Object.freeze(["root"]):void 0,O=!1,C={finished:!1,isFinished:!1,restart:!1},F=[h,m];if("simple"!==w&&m){const t=o(b,"root",f,S,g.parentPath?Object.freeze([]):void 0,g);t.PASS=s;const r=await d(m,t,a,"objectCallback",...n);if(i(r)){if(!r.hasValue){if(!g.copy)return;return"array"===w?[]:{}}if(!h)return g.copy?r.value:void 0;C.isFinished=!0,b=r.value}else{if(p(r)){if(!g.copy)return;return"array"===w?[]:{}}u(r)?(O=!0,r.hasValue&&(b=r.value)):b=r}w=e(b)}switch(w){case"array":r=g.copy?[]:void 0,l=await y(b,r,j,F,S,g,C,I,O,void 0,c,a,...n);break;case"object":r=g.copy?{}:void 0,l=await y(b,r,j,F,S,g,C,I,O,void 0,c,a,...n);break;case"simple":return g.copy?b:void 0}for(let e=0;e<j.length&&!C.finished;){const t=j[e];j[e]=void 0,C.restart=!1,g.detectCycles&&(c=k(l,t.parent,c));const r=g.parentPath?Object.freeze([...t.parentPath,t.key]):void 0;l=await y(t.data,t.location,j,F,t.breadcrumbs,g,C,r,t.pass,t.parent,c,a,...n),e=C.restart?0:e+1}return r}(t,n,...a);if(null==t.timeout)return r;let c;const l=new Promise((e,a)=>{c=setTimeout(()=>{const e=[...n].map(e=>`\n  - ${e}`).join("");a(new Error(`walk-async: timed out after ${t.timeout}ms; callbacks still pending:${e}`))},t.timeout)});try{return await Promise.race([r,l])}finally{clearTimeout(c)}}function k(e,t,a){if(!a){if(t.depth<32)return;a=new WeakMap;for(let e=t;e;e=e.parent)a.set(e.data,e);return a}const n=[];for(;e!==t;)e.depth>=t.depth?(a.delete(e.data),e=e.parent):(n.push(t),t=t.parent);for(let e=n.length-1;e>=0;e--){const t=n[e];a.set(t.data,t)}return a}export{v as default};

package/dist/walk-async.umd.js

@@ -1 +1 @@
-!function(e,o){"object"==typeof exports&&"undefined"!=typeof module?module.exports=o(require("ask-for-promise")):"function"==typeof define&&define.amd?define(["ask-for-promise"],o):(e="undefined"!=typeof globalThis?globalThis:e||self).walkAsync=o(e.askForPromise)}(this,function(e){"use strict";async function o(e,o,n){for await(const o of e)await o.next();n.done(o)}function n(e){return null==e||e.nodeType?"simple":e instanceof Array?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}async function*t(e,o,n,t,a,i){yield await r(e,o,n,t,a,...i)}function a(e,o,n){"__proto__"===o?Object.defineProperty(e,o,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[o]=n}function r(o,r,i,s,l,...c){let[d,f,u]=s,p=Object.keys(o),m=e(p),b=e();return p.forEach((p,b)=>{let y=n(o[p]),$=o[p],k="simple"!==y&&null!=f,j=e(),_=e(),h=e(),v="array"===n(r),C=!isNaN(p),w=Symbol("ignore___"),g=`${l}/${p}`,S=`objectCallback at '${g}'`,x=`keyCallback at '${g}'`;k?(u.add(S),f({resolve:j.done,reject:()=>j.done(w),value:$,key:p,breadcrumbs:g},...c)):j.done("$$cancel"),j.onComplete(e=>{if(u.delete(S),"$$cancel"!==e||d){if("$$cancel"!==e&&($=e,y=n($)),$==w)return m.promises[b].done("ignore object"),_.done("$$cancel"),void h.done();if("simple"===y){if(!d)return void _.done("$$noUpdates");u.add(x),d({resolve:_.done,reject:()=>_.done(w),value:$,key:p,breadcrumbs:g},...c)}else _.done("$$cancel")}else _.done("$$noUpdates")}),_.onComplete(e=>{if(u.delete(x),e==w)return m.promises[b].done("ignore key"),void h.done();if("$$cancel"!==e){if("$$noUpdates"!==e&&($=e,y=n($)),"simple"===y){const e=function(e,o){return o instanceof Array&&!isNaN(e)}(p,r);return e?r.push($):a(r,p,$),void m.promises[b].done("key")}h.done()}else h.done()}),h.onComplete(()=>{if("object"===y){const e={};v&&C?r.push(e):a(r,p,e),i.push(t($,e,i,s,g,c)),m.promises[b].done("object")}if("array"===y){const e=[];v&&C?r.push(e):a(r,p,e),i.push(t($,e,i,s,g,c)),m.promises[b].done("array")}})}),m.onComplete(e=>b.done()),b.promise}return function({data:t,objectCallback:a=null,keyCallback:i=null,timeout:s=null},...l){let c,d=n(t),f=[],u="root",p=new Set,m=[i,a,p],b=e(),y=e(),$=Symbol("ignore___");if("simple"!==d&&a?(p.add("objectCallback at 'root'"),a({resolve:y.done,reject:()=>y.done($),value:t,key:"root",breadcrumbs:u},...l)):y.done(t),y.onComplete(e=>{if(p.delete("objectCallback at 'root'"),e!==$)switch(n(e)){case"array":c=[],r(e,c,f,m,u,...l).then(()=>o(f,c,b));break;case"object":c={},r(e,c,f,m,u,...l).then(()=>{o(f,c,b)});break;case"simple":b.done(e)}else b.done("array"===d?[]:{})}),null==s)return b.promise;const k=Symbol("expired___"),j=e();return b.timeout(s,k),b.onComplete(e=>{if(e!==k)return void j.done(e);const o=[...p].map(e=>`\n  - ${e}`).join("");j.cancel(new Error(`walk-async: timed out after ${s}ms; callbacks still pending:${o}`))}),j.promise}});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).walkAsync=t()}(this,function(){"use strict";function e(e){return null==e||e.nodeType?"simple":Array.isArray(e)?"array":"object"==typeof e?e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||e instanceof WeakMap||e instanceof WeakSet||e instanceof ArrayBuffer||e instanceof DataView||ArrayBuffer.isView(e)?"simple":"object":"simple"}function t(e,t){if(!Array.isArray(t))return!1;const n=Number(e);return Number.isInteger(n)&&n>=0&&n<4294967295&&String(n)===e}function n(e,t,n){"__proto__"===t?Object.defineProperty(e,t,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[t]=n}const a=new WeakSet;function r(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return a.add(t),t}function i(e){return a.has(e)}function o(e,t,n,a,i,o){return o.breadcrumbs&&o.parentPath?{value:e,key:t,breadcrumbs:a,parentPath:i,IGNORE:n,FINISH:r}:o.breadcrumbs?{value:e,key:t,breadcrumbs:a,IGNORE:n,FINISH:r}:o.parentPath?{value:e,key:t,parentPath:i,IGNORE:n,FINISH:r}:{value:e,key:t,IGNORE:n,FINISH:r}}const c=new WeakSet;function s(e){const t=Object.freeze({value:e,hasValue:arguments.length>0});return c.add(t),t}function u(e){return c.has(e)}const l=Symbol("ignore___");function f(){return l}function p(e){return e===l}async function d(e,t,n,a,...o){let c,l,p=`${a} at '${t.breadcrumbs??t.key}'`;function d(){c||(c=new Promise(e=>{l=e}),c.catch(()=>{}))}Object.defineProperties(t,{resolve:{enumerable:!0,get:()=>(d(),l)},reject:{enumerable:!0,get:()=>(d(),()=>l(f()))}}),n.add(p);try{const n=await e(t,...o),l=c?await c:n;return"objectCallback"===a&&u(l)&&l.hasValue?s(await l.value):i(l)&&l.hasValue?r(await l.value):l}finally{n.delete(p)}}async function y(a,r,c,l,y,v,k,w,j,g,P,S,...I){let[O,C]=l,F=Object.keys(a),V=v.detectCycles?{data:a,location:r,parent:g,depth:g?g.depth+1:0}:void 0,N=!1;P&&P.set(a,V);for(let l=0;l<F.length&&!N;l++){const g=F[l];let A=a[g],$=e(A),_=v.copy&&t(g,r),E=v.breadcrumbs&&("simple"!==$||!j&&O)?`${y}/${g}`:void 0,z=!1;if("simple"!==$&&C&&!k.isFinished){const t=o(A,g,f,E,w,v);t.PASS=s;const n=await d(C,t,S,"objectCallback",...I);if(i(n)){if(!n.hasValue||!O)return b(n,r,g,_,v,k),V;c.length=0,k.restart=!0,k.isFinished=!0,N=!0,A=n.value}else{if(p(n))continue;u(n)?(z=!0,n.hasValue&&(A=n.value)):A=n}$=e(A)}if("simple"===$){if(z||j&&!k.isFinished||!O){if(!v.copy)continue;_?r.push(A):n(r,g,A);continue}const t=o(A,g,f,E,w,v);t.isFinished=k.isFinished;let a=await d(O,t,S,"keyCallback",...I);if(i(a))return b(a,r,g,_,v,k),V;if(p(a))continue;const c=e(a);if("simple"===c){if(!v.copy)continue;_?r.push(a):n(r,g,a);continue}A=a,$=c}const R=v.detectCycles?m(A,V,P):void 0;if(R){if(!v.copy)continue;_?r.push(R.location):n(r,g,R.location)}else{if("object"===$){const e=v.copy?{}:void 0;v.copy&&(_?r.push(e):n(r,g,e)),c.push(h(A,e,E,w,g,z,V))}if("array"===$){const e=v.copy?[]:void 0;v.copy&&(_?r.push(e):n(r,g,e)),c.push(h(A,e,E,w,g,z,V))}}}return V}function b(e,t,a,r,i,o){o.finished=!0,i.copy&&e.hasValue&&(r?t.push(e.value):n(t,a,e.value))}function h(e,t,n,a,r,i,o){return{data:e,location:t,breadcrumbs:n,parentPath:a,key:r,pass:i,parent:o}}function m(e,t,n){if(n)return n.get(e);for(let n=t;n;n=n.parent)if(n.data===e)return n}function v(e,t,n){if(!n){if(t.depth<32)return;n=new WeakMap;for(let e=t;e;e=e.parent)n.set(e.data,e);return n}const a=[];for(;e!==t;)e.depth>=t.depth?(n.delete(e.data),e=e.parent):(a.push(t),t=t.parent);for(let e=a.length-1;e>=0;e--){const t=a[e];n.set(t.data,t)}return n}return async function(t,...n){const a=new Set,r=async function(t,n,...a){let r,c,l,{data:b,keyCallback:h,objectCallback:m,settings:k}=t,w=e(b),j=[],g=!(!h&&!m),P={copy:!1!==k?.copy,breadcrumbs:g&&!1!==k?.breadcrumbs,parentPath:g&&!1!==k?.parentPath,detectCycles:!1!==k?.detectCycles},S=P.breadcrumbs?"root":void 0,I=P.parentPath&&"simple"!==w?Object.freeze(["root"]):void 0,O=!1,C={finished:!1,isFinished:!1,restart:!1},F=[h,m];if("simple"!==w&&m){const t=o(b,"root",f,S,P.parentPath?Object.freeze([]):void 0,P);t.PASS=s;const r=await d(m,t,n,"objectCallback",...a);if(i(r)){if(!r.hasValue){if(!P.copy)return;return"array"===w?[]:{}}if(!h)return P.copy?r.value:void 0;C.isFinished=!0,b=r.value}else{if(p(r)){if(!P.copy)return;return"array"===w?[]:{}}u(r)?(O=!0,r.hasValue&&(b=r.value)):b=r}w=e(b)}switch(w){case"array":r=P.copy?[]:void 0,l=await y(b,r,j,F,S,P,C,I,O,void 0,c,n,...a);break;case"object":r=P.copy?{}:void 0,l=await y(b,r,j,F,S,P,C,I,O,void 0,c,n,...a);break;case"simple":return P.copy?b:void 0}for(let e=0;e<j.length&&!C.finished;){const t=j[e];j[e]=void 0,C.restart=!1,P.detectCycles&&(c=v(l,t.parent,c));const r=P.parentPath?Object.freeze([...t.parentPath,t.key]):void 0;l=await y(t.data,t.location,j,F,t.breadcrumbs,P,C,r,t.pass,t.parent,c,n,...a),e=C.restart?0:e+1}return r}(t,a,...n);if(null==t.timeout)return r;let c;const l=new Promise((e,n)=>{c=setTimeout(()=>{const e=[...a].map(e=>`\n  - ${e}`).join("");n(new Error(`walk-async: timed out after ${t.timeout}ms; callbacks still pending:${e}`))},t.timeout)});try{return await Promise.race([r,l])}finally{clearTimeout(c)}}});

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@peter.naydenov/walk-async",
-  "version": "6.1.0",
+  "version": "7.0.1",
   "description": "Deep copy with fine control during the process. Can be used also as a deep forEach function",
   "main": "./dist/walk-async.umd.js",
   "type": "module",
   "types": "./types/main.d.ts",
   "exports": {
     ".": {
+      "types": "./types/main.d.ts",
       "import": "./dist/walk-async.esm.mjs",
       "require": "./dist/walk-async.cjs",
       "default": "./dist/walk-async.umd.js"
@@ -39,17 +40,17 @@
   "author": "Peter Naydenov",
   "license": "MIT",
   "dependencies": {
-    "ask-for-promise": "^3.2.0"
+    "ask-for-promise": "^3.2.1"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",
-    "@vitest/coverage-v8": "4.1.11",
-    "rollup": "^4.63.1",
+    "@vitest/coverage-v8": "5.0.5",
+    "rollup": "^4.64.0",
     "typescript": "^7.0.2",
-    "vite": "^8.2.2",
-    "vitest": "4.1.11"
+    "vite": "^8.3.4",
+    "vitest": "5.0.5"
   },
   "vitest": {
     "coverage": {

package/src/copyObject.js

@@ -0,0 +1,145 @@
+"use strict"
+
+import findType from "./findType.js";
+import validateForInsertion from "./validateForInsertion.js";
+import setKey from "./setKey.js";
+import createCallbackArgs from "./createCallbackArgs.js";
+import PASS, { isPass } from "./pass.js";
+import IGNORE, { isIgnore } from "./ignore.js";
+import { isFinish } from "./finish.js";
+import runCallback from "./runCallback.js";
+
+
+
+async function copyObject ( resource, result, extend, cb, breadcrumbs, settings, control, parentPath, pass, parent, ancestors, pending, ...args ) {
+    let
+          [ keyCallback, objectCallback ] = cb
+        , keys = Object.keys ( resource )
+        , parents = settings.detectCycles ? { data:resource, location:result, parent, depth:parent ? parent.depth + 1 : 0 } : undefined
+        , last = false
+        ;
+
+    if ( ancestors )   ancestors.set ( resource, parents )
+
+    for ( let index = 0; index < keys.length && !last; index++ ) {
+                    const k = keys[index];
+                    let
+                          item = resource[k]
+                        , type = findType ( item )
+                        , canInsert = settings.copy && validateForInsertion ( k, result )
+                        , br = settings.breadcrumbs && ( type !== 'simple' || ( !pass && keyCallback ) ) ? `${breadcrumbs}/${k}` : undefined
+                        , passChild = false
+                        ;
+
+                    if ( type !== 'simple' && objectCallback && !control.isFinished ) {
+                                        const callbackArgs = createCallbackArgs ( item, k, IGNORE, br, parentPath, settings )
+                                        callbackArgs.PASS = PASS
+                                        const replacement = await runCallback ( objectCallback, callbackArgs, pending, 'objectCallback', ...args )
+                                        if ( isFinish ( replacement ) ) {
+                                                if ( !replacement.hasValue || !keyCallback ) {
+                                                        finish ( replacement, result, k, canInsert, settings, control )
+                                                        return parents
+                                                    }
+                                                // Discard unrelated pending work. Only the selected
+                                                // final branch may schedule further containers.
+                                                extend.length = 0
+                                                control.restart = true
+                                                control.isFinished = true
+                                                last = true
+                                                item = replacement.value
+                                            }
+                                        else if ( isIgnore ( replacement ) )   continue
+                                        else if ( isPass ( replacement ) ) {
+                                                passChild = true
+                                                if ( replacement.hasValue )   item = replacement.value
+                                            }
+                                        else    item = replacement
+                                        type = findType ( item )
+                        }
+
+                    if ( type === 'simple' ) {
+                                    if ( passChild || ( pass && !control.isFinished ) || !keyCallback ) {
+                                            if ( !settings.copy )   continue
+                                            if ( canInsert )    result.push ( item )     // It's an array
+                                            else                setKey ( result, k, item ) // It's an object
+                                            continue
+                                        }
+                                    const callbackArgs = createCallbackArgs ( item, k, IGNORE, br, parentPath, settings );
+                                    callbackArgs.isFinished = control.isFinished
+                                    let keyRes = await runCallback ( keyCallback, callbackArgs, pending, 'keyCallback', ...args );
+                                    if ( isFinish ( keyRes ) ) {
+                                            finish ( keyRes, result, k, canInsert, settings, control )
+                                            return parents
+                                        }
+                                    if ( isIgnore ( keyRes ) )   continue
+                                    // Re-type the returned value. A plain object/array returned from
+                                    // keyCallback is walked into via the same work queue used for
+                                    // original nested values; built-in types (Date, Map, Set, etc.) are
+                                    // still 'simple' and stored by reference.
+                                    const newType = findType ( keyRes )
+                                    if ( newType === 'simple' ) {
+                                            if ( !settings.copy )   continue
+                                            if ( canInsert )    result.push ( keyRes )      // It's an array
+                                            else                setKey ( result, k, keyRes ) // It's an object
+                                            continue
+                                        }
+                                    item = keyRes
+                                    type = newType
+                        }
+
+                    const circular = settings.detectCycles ? findParent ( item, parents, ancestors ) : undefined
+                    if ( circular ) {
+                            if ( !settings.copy )   continue
+                            if ( canInsert )   result.push ( circular.location )
+                            else               setKey ( result, k, circular.location )
+                            continue
+                        }
+
+                    if ( type === 'object' ) {
+                            const newObject = settings.copy ? {} : undefined;
+                            if ( settings.copy ) {
+                                    if ( canInsert )   result.push ( newObject )
+                                    else               setKey ( result, k, newObject )
+                                }
+                            extend.push ( createJob ( item, newObject, br, parentPath, k, passChild, parents ) )
+                       }
+
+                    if ( type === 'array' ) {
+                            const newArray = settings.copy ? [] : undefined;
+                            if ( settings.copy ) {
+                                    if ( canInsert )   result.push ( newArray )
+                                    else               setKey ( result, k, newArray )
+                                }
+                            extend.push ( createJob ( item, newArray, br, parentPath, k, passChild, parents ) )
+                        }
+            }
+    return parents
+} // copyObject func.
+
+
+
+function finish ( instruction, result, k, canInsert, settings, control ) {
+    control.finished = true
+    if ( !settings.copy || !instruction.hasValue )   return
+    if ( canInsert )   result.push ( instruction.value )
+    else               setKey ( result, k, instruction.value )
+} // finish func.
+
+
+
+function createJob ( data, location, breadcrumbs, parentPath, key, pass, parent ) {
+    return { data, location, breadcrumbs, parentPath, key, pass, parent }
+} // createJob func.
+
+
+
+function findParent ( data, parent, ancestors ) {
+    if ( ancestors )   return ancestors.get ( data )
+    for ( let current = parent; current; current = current.parent ) {
+            if ( current.data === data )   return current
+        }
+} // findParent func.
+
+
+
+export default copyObject

package/src/createCallbackArgs.js

@@ -0,0 +1,15 @@
+import FINISH from "./finish.js";
+
+
+
+function createCallbackArgs ( value, key, IGNORE, breadcrumbs, parentPath, settings ) {
+    if ( settings.breadcrumbs && settings.parentPath )   return { value, key, breadcrumbs, parentPath, IGNORE, FINISH }
+    if ( settings.breadcrumbs )                         return { value, key, breadcrumbs, IGNORE, FINISH }
+    if ( settings.parentPath )                          return { value, key, parentPath, IGNORE, FINISH }
+    return { value, key, IGNORE, FINISH }
+} // createCallbackArgs func.
+
+
+
+export default createCallbackArgs
+

package/src/findType.js

@@ -0,0 +1,28 @@
+function findType ( x ) {
+    if ( x == null              )   return 'simple' // null and undefined
+    if ( x.nodeType             )   return 'simple' // DOM node
+    if ( Array.isArray ( x )     )   return 'array'
+    if ( typeof x === 'object'  ) {
+        // Built-in object types whose data lives outside the own-enumerable-string-key
+        // model that walk uses. Treated as 'simple' so the value is preserved by
+        // reference (same contract as functions and DOM nodes).
+        if ( x instanceof Date        )   return 'simple'
+        if ( x instanceof RegExp      )   return 'simple'
+        if ( x instanceof Map         )   return 'simple'
+        if ( x instanceof Set         )   return 'simple'
+        if ( x instanceof WeakMap     )   return 'simple'
+        if ( x instanceof WeakSet     )   return 'simple'
+        if ( x instanceof ArrayBuffer )   return 'simple'
+        if ( x instanceof DataView    )   return 'simple'
+        if ( ArrayBuffer.isView ( x ) )   return 'simple' // Typed arrays (Uint8Array, Float32Array, ...)
+        return 'object'
+    }
+    return 'simple'   // number, bigint, string, boolean, symbol, function
+ } // findType func.
+
+
+
+ export default findType
+
+
+ 

package/src/finish.js

@@ -0,0 +1,38 @@
+"use strict"
+
+const instructions = new WeakSet ();
+
+
+/**
+ *  Private instruction created by the FINISH helper.
+ *
+ *  @typedef {object} FinishInstruction
+ *  @property {*} value
+ *  @property {boolean} hasValue
+ */
+
+/**
+ *  Stop the entire walk. Omit the current value when no argument is
+ *  supplied. From objectCallback, a supplied value selects the final
+ *  branch for key callbacks with isFinished true. From keyCallback,
+ *  include the supplied value directly and stop immediately.
+ *
+ *  @param {*} [value] - Final value or branch.
+ *  @returns {FinishInstruction}
+ */
+function FINISH ( value ) {
+    const instruction = Object.freeze ({ value, hasValue:arguments.length > 0 });
+    instructions.add ( instruction )
+    return instruction
+} // FINISH func.
+
+
+
+function isFinish ( value ) {
+    return instructions.has ( value )
+} // isFinish func.
+
+
+
+export { isFinish }
+export default FINISH

package/src/ignore.js

@@ -0,0 +1,24 @@
+"use strict"
+
+const instruction = Symbol ( 'ignore___' );
+
+
+/**
+ *  Remove the current key or the entire current object/array branch.
+ *
+ *  @returns {symbol}
+ */
+function IGNORE () {
+    return instruction
+} // IGNORE func.
+
+
+
+function isIgnore ( value ) {
+    return value === instruction
+} // isIgnore func.
+
+
+
+export { isIgnore }
+export default IGNORE