@homedev/objector 0.1.32 → 1.0.3

package/dist/index.js

@@ -1,3 +1,2 @@
-import y from"fs/promises";import Q from"path";import p from"yaml";var i=async(w)=>{try{return await y.access(w,y.constants.R_OK),!0}catch{return!1}},I=async(w,r)=>{let f=!Q.isAbsolute(w)&&r?["",...r]:[""];for(let F of f){let n=Q.join(F,w);if(await i(n))return Q.resolve(n)}throw new Error(`File not found: "${w}"`)},B=async(w,r)=>{let f=await I(w,r?.dirs),F=await y.readFile(f),n=Q.dirname(f),g={"[.](yml|yaml)$":p.parse,"[.]json$":JSON.parse,...r?.parsers},O=Object.entries(g).find((T)=>f.match(T[0]));if(!O)throw new Error(`Unhandled file type: ${w}`);return{content:O[1](F.toString()),fullPath:f,folderPath:n}};var P=async(w,r)=>{for(let f of w){let F=[];if(r?.root)F.push(r.root);if(r?.loadOptions?.dirs)F.push(...r.loadOptions.dirs);let n=r?.load?await r.load(f):(await B(f,{...r?.loadOptions,dirs:F})).content;if(r?.loaded&&n)await r.loaded(n)}};var Z=(w,r,f)=>{for(let F of Object.keys(r)){if(w[F]===void 0)continue;let n=r[F],g=w[F];if(typeof g!==typeof n||Array.isArray(g)!==Array.isArray(n)){let E=f?.mismatch?.(F,g,n,w,r);if(E!==void 0){r[F]=E;continue}throw new Error(`Type mismatch: ${F}`)}let O=f?.mode?.(F,g,n,w,r)??"merge";switch(O){case"source":r[F]=g;continue;case"target":continue;case"skip":delete r[F],delete w[F];continue;case"merge":break;default:throw new Error(`Unknown merge mode: ${O}`)}if(typeof g==="object")if(Array.isArray(g))n.push(...g);else{if(f?.navigate?.(F,g,n,w,r)===!1)continue;Z(g,n,f)}else{if(g===n)continue;let E=f?.conflict?.(F,g,n,w,r);r[F]=E===void 0?n:E}}for(let F of Object.keys(w))if(r[F]===void 0)r[F]=w[F]};var K;((O)=>{O[O.Explore=0]="Explore";O[O.SkipSiblings=1]="SkipSiblings";O[O.NoExplore=2]="NoExplore";O[O.ReplaceItem=3]="ReplaceItem";O[O.ReplaceParent=4]="ReplaceParent";O[O.DeleteParent=5]="DeleteParent"})(K||={});class j{action;by;constructor(w,r){this.action=w;this.by=r}static ReplaceParent(w){return new j(4,w)}static ReplaceItem(w){return new j(3,w)}static SkipSiblings(){return new j(1)}static Explore(){return new j(0)}static NoExplore(){return new j(2)}static DeleteParent(){return new j(5)}}var H=async(w,r)=>{let f=async(n)=>{let g=n.key===null,O=g?{action:0}:await r(n);if(n.value&&typeof n.value==="object"&&O.action==0){if(!g)n.path.push(n.key),n.parents.push(n.parent);if(await F(n),!g)n.parents.pop(),n.path.pop()}return O},F=async(n)=>{for(let[g,O]of Object.entries(n.value)){let E=await f({key:g,value:O,path:n.path,parent:n.value,parents:n.parents});switch(E.action){case 4:if(!n.key)throw new Error("Cannot replace root");n.parent[n.key]=E.by;return;case 3:n.value[g]=E.by;break;case 5:delete n.parent[n.key];return;case 1:return}}};await f({key:null,value:w,path:[],parent:null,parents:[]})};var z=(w,r,f="(",F=")")=>{let n=0,g="",O=[];for(let E of w){if(g+=E,E===f)n++;if(E===F)n--;if(n===0&&E===r)O.push(g.slice(0,-1)),g=""}if(g)O.push(g);return O},m=(w)=>{let r=/(?:\s*(?:"([^"]*)"|'([^']*)')\s*|([^"',]+))(?:,)?|(,)/g,f=[],F;while((F=r.exec(w))!==null){let n=F[1]??F[2];f.push({value:n??F[3]?.trim()??"",quoted:n!==void 0})}return f};var Y=(w,r,f,F)=>{if(w.startsWith("{")){let n=w.substring(1,w.length-1);return d(r,n,f).toString()}return F?w:void 0},e=(w,r,f,F)=>{let n=Y(r,f,F);if(n)return d(w,n,F);let g=/^\[([^=\]]*)([=]*)([^\]]*)\]$/.exec(r);if(g){let[E,T,b,C]=g,M=Y(T.trim(),f,F,!0),_=Y(C.trim(),f,F,!0);if(Array.isArray(w))switch(b){case"==":case"=":return w.find((L)=>L[M]==_)}}let O=/^([^[\]]*)\[([^\]]*)]/.exec(r);if(O)return w[O[1]][O[2]];return w[r]},d=(w,r,f)=>{let F=void 0,n=void 0;r??="";let g=(C)=>C?.endsWith("?")?[C.substring(0,C.length-1),!0]:[C,!1],O=(C,M)=>{let[_,L]=g(M.pop());if(_){let S=e(C,_,w,f);if(S===void 0){if(L||f?.defaultValue!==void 0)return;throw new Error(`Unknown path element: "${_}" in "${r}"`)}return F=C,n=_,O(S,M)}if(f?.set&&n)F[n]=f?.set;return C},E=z(r,f?.separator??".","{","}"),T=E.length>0&&E[E.length-1].startsWith("?=")?E.pop()?.substring(2):void 0;E.reverse();let b=O(w,E);if(b===void 0)return T??f?.defaultValue;return b};var $=(w,r)=>{let f=/^(?<path>[^@>]*)?(?:@(?<from>[^>]*))?$/.exec(w)?.groups;if(!f)throw new Error(`Invalid reference: "${w}"`);let{from:F,path:n}=f;if(!F)return d(r.root,n,{defaultValue:r?.defaultValue});if(r.async===!1){if(!r.load)throw new Error("No load function defined");return d(r.load(F),n,{defaultValue:r?.defaultValue})}else return(r.load??B)(F).then((g)=>d(g,n))};var W=async(w,r,f,F)=>{let n,g=[],O=r;if(!F.sources)return j.Explore();if(O=O.replaceAll(F.sourcesMatcher??/\$\((?<key>[^:()]+)(?::(?<arg>(?:(?:"[^"]*"|[^",()]*),?)*))?\)/g,(E,...T)=>{if(n)return E;let b=(A)=>{if(A instanceof Promise)return`ð[${g.push(A)}]ñ`;if(typeof A==="object")return n=A,E;return A??""},C=T[T.length-1],M=F.sources[C.key];if(C.arg===void 0)return b($(C.key,{root:f,load:F?.load}));if(M===void 0)throw new Error(`Unhandled source type: ${C.key}`);let[_,L]="fn"in M?[M.fn,M]:[M,{}],S=m(C.arg),s=L.processArgs===!1?[]:S.map((A)=>{if(A.quoted)return A.value;return A.value.startsWith("@")?A.value.substring(1):$(A.value,{root:f})});return b(_({groups:C,args:s,rawArgs:S,path:w,value:O,root:f,key:C.key,options:F,file:F.file}))}),n)O=await n;else if(g.length){let E=await Promise.all(g);O=E.find((T)=>typeof T==="object")??O.replaceAll(/\xf0\[(\d+)]\xf1/g,(T,b)=>E[+b-1])}if(O===null)return j.DeleteParent();if(O===r)return j.Explore();if(O instanceof j)return O;if(typeof O==="string"){let E=await W(w,O,f,F);if(E.action!==0)return E}return j.ReplaceItem(O)};var V=async(w,r,f,F)=>{if(w.key.startsWith("$"))return j.NoExplore();if(!F.keys)return;let n=(F?.keysMatcher??/^\.(?<key>.*)/).exec(w.key)?.groups;if(n){let g=F.keys[n.key];if(g!==void 0){let O=typeof g==="object"?g:{},E=typeof g==="function"?g:g.fn,T={...f,self:w.value,this:w.parent,parent:w.parents[w.parents.length-1],parents:[w.parent,...w.parents.toReversed()]};if(typeof w.value==="string"){let M=await W(r,w.value,T,F);if(M.by)w.value=M.by}else await U(w.value,{...F,root:T,filters:[...F.filters??[],...O.filters??[]]});let b={args:[w.value],rawArgs:[],groups:n,path:r,value:w.value,root:f,parent:w.parent,key:w.key,file:F?.file,options:F},C=await E(b);if(C instanceof j)return C;if(C===null)return j.DeleteParent();if(C===void 0)return j.Explore();return j.ReplaceParent(C)}}};var U=async(w,r)=>H(w,async(f)=>{let F=[...f.path,f.key].join(".");if(r.filters?.length&&r.filters.some((g)=>g.test(F)))return j.NoExplore();let n={...w,this:f.parent,parent:f.parents.length>0?f.parents[f.parents.length-1]:{},parents:f.parents.toReversed(),...r.root};try{return await V(f,F,n,r)??(typeof f.value==="string"?await W(F,f.value,n,r):j.Explore())}catch(g){throw new Error(`${g.message}
-	in ${r.file??""}(${F}) `)}});var Yr=async(w,r)=>{let f=[];return await H(w,(F)=>{if(r([...F.path,F.key].join("."),F.value))f.push(F.value);return j.Explore()}),f};var D=(w,r="name")=>Object.entries(w).map(([f,F])=>({[r]:f,...F})),Pr=(w,r="name")=>Object.fromEntries(w.map((f)=>[f[r],f])),R=(w,r="name")=>Object.fromEntries(w.map((f)=>{let{[r]:F,...n}=f;return[F,n]}));import G from"fs/promises";import a from"path";import c from"yaml";import J from"path";var h=(w)=>{return{load:async(r)=>{for(let{file:f,alias:F}of Array.isArray(r.value)?r.value:[r.value]){if(!f)throw new Error("File reference required");await w.load(f,F??f,r.file&&J.dirname(r.file))}delete r.parent[r.key]},include:(r)=>w.load(r.value,void 0,r.file&&J.dirname(r.file)),from:async(r)=>{let f=await $(r.value,{root:r.root,load:(F)=>w.load(F,void 0,r.file&&J.dirname(r.file))});if(r.parent.content){if(Array.isArray(r.parent.content)&&Array.isArray(f))return[...f,...r.parent.content];return w.merge(f,r.parent.content),r.parent.content}return f},concat:async(r)=>{let f=[];for(let F of Array.isArray(r.value)?r.value:[r.value])f.push(...await $(F,{root:r.root,load:(n)=>w.load(n,void 0,r.file&&J.dirname(r.file))}));return f.filter((F)=>F!==void 0)},extends:async(r)=>{let f=async(F,n)=>{for(let g of Array.isArray(n)?n:[n]){let O=await $(g,{root:r.root,load:(T)=>w.load(T,void 0,r.file&&J.dirname(r.file))}),E=JSON.parse(JSON.stringify(O));if(E[r.key])await f(E,E[r.key]);await U(E,{...r.options}),w.merge(E,F),delete F[r.key]}};await f(r.parent,r.value)},alias:(r)=>{w.alias(r.value,r.parent),delete r.parent[r.key]},if:(r)=>{if(delete r.parent[r.key],r.value===null||r.value===void 0||["0",0,"false",""].includes(r.value)||Array.isArray(r.value)&&r.value.length===0)return null},skip:(r)=>{return delete r.parent[r.key],j.SkipSiblings()},output:(r)=>{delete r.parent[r.key];for(let f of Array.isArray(r.value)?r.value:[r.value])if(typeof f==="string")w.output({name:f,value:r.parent});else w.output({...f,value:f.value??r.parent})},each:{filters:[/select|model/],fn:async(r)=>{delete r.parent[r.key];let f=(b)=>$(b,{root:r.root,load:(C)=>w.load(C,void 0,r.file&&J.dirname(r.file))}),F=()=>{if(typeof r.value==="string"||!r.value.model)return r.parent;if(typeof r.value.model==="string")return f(r.value.model);return r.value.model},n=()=>{if(typeof r.value==="string")return f(r.value);if(Array.isArray(r.value))return r.value;if(typeof r.value.from==="string")return f(r.value.from);return r.value.from},g=async(b)=>{let C=r.value.select;if(C===void 0)return b;if(typeof C!=="string"){let M=JSON.parse(JSON.stringify(C));return await U(M,{...r.options,root:{...r.root,result:b}}),M}return await $(C,{root:{...r.root,result:b}})},O=await n(),E=await F();if(!Array.isArray(O))throw new Error('Key "each" requires a source list');if(E===void 0)throw new Error('Key "each" must define a model');if(r.value.extend?.model)E=w.mergeAll([E,...Array.isArray(r.value.extend.model)?r.value.extend.model:[r.value.extend.model]]);let T=[];for(let b=0;b<O.length;b++){let C=JSON.parse(JSON.stringify(E));if(await U(C,{...r.options,root:{...r.root,item:O[b],this:C,index:b}}),r.value.extend?.result)C=w.mergeAll([C,...Array.isArray(r.value.extend?.result)?r.value.extend.result:[Array.isArray(r.value.extend?.result)]]);T.push(await g(C))}return T}}}};import k from"fs/promises";import X from"path";var o=(w,r)=>{if(r??=["null","empty","zero"],w==="false"||w===!1)return!1;if(r?.includes("null")&&(w===null||w===void 0))return!1;if(r?.includes("empty")&&w==="")return!1;if(r?.includes("zero")&&w==0)return!1;return!0},u=(w)=>w.replace(/((?:[_ ]+)\w|^\w)/g,(r,f)=>f.toUpperCase()).replace(/_/g,""),x=(w)=>u(w).replace(/((?:[ ]+\w)|^\w)/g,(r,f)=>f.toLowerCase()),l=(w,r)=>w.replace(/([a-z])([A-Z])/g,`$1${r}$2`).replace(/\s+/g,r),N=(w,r)=>{switch(r){case"upper":return w.toUpperCase();case"lower":return w.toLowerCase();default:return w}},q=async(w,r,f,F)=>r.rawArgs[f].quoted?r.rawArgs[f].value:await $(r.rawArgs[f].value,{root:r.root,load:(n)=>w.load(n),defaultValue:F}),v=(w)=>{return{include:async(r)=>await w.load(r.args[0],r.args[1],r.file&&X.dirname(r.file),{parent:r.root}),file:async(r)=>await k.readFile(await I(r.args[0],w.getIncludeDirectories())).then((f)=>f.toString()),scan:async(r)=>{let f=[],n=(()=>{let g=r.args[2]??["**/node_modules/**"],O=typeof g==="string"?g.split(",").map((E)=>E.trim()):g;if(!Array.isArray(O))throw new Error("Scan exclusion must be a list");return O})();for await(let g of k.glob(r.args[0],{cwd:r.args[1]??X.dirname(r.file??"."),exclude:(O)=>n.some((E)=>X.matchesGlob(O,E))}))f.push(g);return f},env:(r)=>process.env[r.args[0]],len:(r)=>r.args[0].length,reverse:(r)=>r.args[0].split("").reverse().join(""),substring:(r)=>r.args[0].substring(+r.args[1],+r.args[2]),concat:(r)=>r.args.join(""),lower:(r)=>r.args[0].toLowerCase(),upper:(r)=>r.args[0].toUpperCase(),pascal:(r)=>u(r.args[0]),camel:(r)=>x(r.args[0]),snake:(r)=>N(l(r.args[0],"_"),r.args[1]),kebab:(r)=>N(l(r.args[0],"-"),r.args[1]),encode:(r)=>Buffer.from(r.args[0]).toString(r.args[1]??"base64"),decode:(r)=>Buffer.from(r.args[0],r.args[1]??"base64").toString(),uuid:(r)=>crypto.randomUUID(),merge:(r)=>r.args.flatMap((f)=>f),join:(r)=>{let[f,F,n]=r.args,g=f;if(!Array.isArray(g))throw new Error("Object is not a list");if(F?.length)g=g.map((O)=>$(F,{root:{...r.root,...O},load:(E)=>w.load(E)}));return g.join(n?.replace("\\n",`
-`))},list:(r)=>D(r.args[0],r.args[1]),object:(r)=>R(r.args[0],r.args[1]),each:{processArgs:!1,fn:async(r)=>{let f=(T)=>$(T,{root:r.root,load:(b)=>w.load(b,void 0,r.file&&X.dirname(r.file))}),F=await f(r.rawArgs[0].value),n=await f(r.rawArgs[1].value),g=r.rawArgs[2]?.value,O=Array.isArray(F)?F:D(F),E=[];for(let T=0;T<O.length;T++){let b=JSON.parse(JSON.stringify(n)),C={instance:b};if(await U(C,{...r.options,root:{...r.root,item:O[T],this:b,parent:r.root.this,index:T,params:r.rawArgs.slice(3).map((M)=>M.value)}}),g!==void 0&&g!=="@")E.push(C.instance[g]);else E.push(C.instance)}return E}},log:(r)=>{console.log(...r.args)},default:{processArgs:!1,fn:async(r)=>{let f=r.rawArgs[1]?.value?await q(w,r,1):"";return q(w,r,0,f)}},if:{processArgs:!1,fn:async(r)=>{let f=await q(w,r,0,!1);if(!o(f,r.rawArgs.length>3?r.rawArgs[3].value.split(","):void 0))return r.rawArgs.length>2?q(w,r,2):"";return q(w,r,1)}},switch:{processArgs:!1,fn:async(r)=>{let f=await q(w,r,0,!1),F=await q(w,r,1);if(F[f]===void 0){if(r.rawArgs.length>2)return q(w,r,2);throw new Error(`Unhandled switch case: ${f}`)}return F[f]}}}};class t{options={load:{dirs:[]},merge:{},include:{},fields:{},includeKey:"includes",mergeKey:".merge",includes:[],outputs:[]};cache={};includeDirectory(...w){return this.options.load.dirs??=[],this.options.load.dirs.push(...w),this}include(...w){return this.options.includes??=[],this.options.includes.push(...w),this}keys(w){return this.options.fields.keys={...this.options.fields.keys,...w},this}sources(w){return this.options.fields.sources={...this.options.fields.sources,...w},this}variables(w){return this.options.variables={...this.options.variables,...w},this}output(w){return this.options.outputs??=[],this.options.outputs.push(w),this}defaultProcessors(){return this.sources(v(this)).keys(h(this))}alias(w,r){return this.cache[w]=r,this}getAlias(w){return this.cache[w]}getOutputs(){return this.options.outputs??[]}getIncludeDirectories(){return this.options.load.dirs??[]}use(w){return w(this),this}filter(w){return this.options.fields.filters??=[],this.options.fields.filters?.push(w),this}async load(w,r,f,F,n){if(r&&this.cache[r])return this.cache[r];if(this.cache[w])return this.cache[w];let g=f?[f]:[];this.options.load.dirs&&g.push(...this.options.load.dirs);let O=await B(w,{...this.options.load,dirs:g});if(!O.content)return null;if(r)this.cache[r]=O.content;let E=[];if(this.options.includeKey&&O.content[this.options.includeKey])E.push(...O.content[this.options.includeKey]),delete O.content[this.options.includeKey];if(this.options.includes)E.push(...this.options.includes),this.options.includes.length=0;if(await P(E,{root:O.folderPath,loaded:(T)=>{if(this.options.mergeKey)Z(T,O.content,{mode:(b,C,M)=>M[this.options.mergeKey],...this.options.merge})},load:(T)=>this.load(T,void 0,O.folderPath,{parent:O.content,...F},!0),...this.options.include}),n!==!0)await U(O.content,{...this.options.fields,file:O.fullPath,root:{...this.options.fields.root,...this.options.variables,$document:{root:O,fileName:w,folder:O.folderPath,fullPath:O.fullPath,...F}},load:(T)=>this.load(T,void 0,O.folderPath,{parent:O.content,...F})});return O.content}merge(w,r){Z(w,r,{mode:(f,F,n)=>n[this.options.mergeKey],...this.options.merge})}mergeAll(w){let r={};for(let f of w.toReversed())this.merge(f,r);return r}async writeOutputs(w){if(w?.targetDirectory&&w?.removeFirst)try{await G.rm(w?.targetDirectory,{recursive:!0,force:!0})}catch(r){throw new Error(`Failed to clean the output directory: ${r.message}`)}for(let r of this.getOutputs()){let f=a.join(w?.targetDirectory??".",r.name),F=a.dirname(f);if(w?.writing?.(r)===!1)continue;try{await G.mkdir(F,{recursive:!0})}catch(n){throw new Error(`Failed to create target directory "${F}" for output "${f}": ${n.message}`)}try{switch(r.type){case"yaml":await G.writeFile(f,c.stringify(r.value));break;case"json":await G.writeFile(f,JSON.stringify(r.value));break;default:await G.writeFile(f,r.value.toString())}}catch(n){throw new Error(`Failed to write output "${f}": ${n.message}`)}}}}export{Pr as toObjectWithKey,R as toObject,D as toList,$ as select,P as processIncludes,U as processFields,H as navigate,Z as merge,I as locate,B as load,Yr as find,t as Objector,j as NavigateResult,K as NavigateAction};
+var nr=Object.create;var{getPrototypeOf:ir,defineProperty:g,getOwnPropertyNames:E,getOwnPropertyDescriptor:pr}=Object,S=Object.prototype.hasOwnProperty;var w=(o,r,e)=>{e=o!=null?nr(ir(o)):{};let s=r||!o||!o.__esModule?g(e,"default",{value:o,enumerable:!0}):e;for(let t of E(o))if(!S.call(s,t))g(s,t,{get:()=>o[t],enumerable:!0});return s},h=new WeakMap,lr=(o)=>{var r=h.get(o),e;if(r)return r;if(r=g({},"__esModule",{value:!0}),o&&typeof o==="object"||typeof o==="function")E(o).map((s)=>!S.call(r,s)&&g(r,s,{get:()=>o[s],enumerable:!(e=pr(o,s))||e.enumerable}));return h.set(o,r),r};var mr=(o,r)=>{for(var e in r)g(o,e,{get:r[e],enumerable:!0,configurable:!0,set:(s)=>r[e]=()=>s})};var fr={};mr(fr,{Objector:()=>ar});module.exports=lr(fr);var sr=require("@homedev/fields"),F=require("@homedev/files"),tr=require("@homedev/merge"),P=w(require("path"));var C=(o)=>({output:(r)=>{delete r.parent[r.key];for(let e of Array.isArray(r.value)?r.value:[r.value])if(typeof e==="string")o.output({name:e,value:r.parent});else o.output({...e,value:e.value??r.parent})}});var _=require("@homedev/navigate"),v=w(require("path")),L=(o)=>({load:async(r)=>{let e=r.options.globalContext;for(let{file:s}of Array.isArray(r.value)?r.value:[r.value]){if(!s)throw new Error("File reference required");await o.load(s,e.file&&v.default.dirname(e.file))}return _.NavigateResult.DeleteItem()}});var j=require("@homedev/fields"),A=require("@homedev/merge"),c=require("@homedev/select"),D=(o)=>({each:{filters:[/select|model/],fn:async(r)=>{let e=r.value;delete r.parent[r.key];let s=()=>{let p=e.model;if(typeof r.value==="string"||!p)return r.parent;if(typeof p==="string")return c.select(r.root,p);return p},t=()=>{if(typeof r.value==="string")return c.select(r.root,r.value);if(Array.isArray(r.value))return r.value;if(typeof e.from==="string")return c.select(r.root,e.from);return e.from},a=async(p)=>{if(e.selector===void 0)return p;if(typeof e.selector!=="string"){let f=JSON.parse(JSON.stringify(e.selector));return await j.processFields(f,{...r.options,root:{...r.root,result:p}}),f}return await c.select({...r.root,result:p},e.selector)},n=await t(),i=await s();if(!Array.isArray(n))throw new Error('Key "each" requires a source list');if(i===void 0)throw new Error('Key "each" must define a model');if(e.extend?.model)i=A.mergeAll([e.model,...Array.isArray(e.extend.model)?e.extend.model:[e.extend.model]]);let m=[];for(let p=0;p<n.length;p++){let f=JSON.parse(JSON.stringify(i));if(await j.processFields(f,{...r.options,root:{...r.root,item:n[p],this:f,index:p}}),e.extend?.result)f=A.mergeAll([f,...Array.isArray(e.extend?.result)?e.extend.result:[Array.isArray(e.extend?.result)]]);m.push(await a(f))}return m}}});var I=require("@homedev/select"),q=(o)=>({concat:async(r)=>{let e=[];for(let s of Array.isArray(r.value)?r.value:[r.value])e.push(...await I.select(r.root,s));return e.filter((s)=>s!==void 0)}});var B=require("@homedev/fields"),J=require("@homedev/merge"),R=require("@homedev/select"),U=(o)=>({extends:async(r)=>{let e=async(s,t)=>{for(let a of Array.isArray(t)?t:[t]){let n=await R.select(r.root,a),i=JSON.parse(JSON.stringify(n));if(i[r.key])await e(i,i[r.key]);await B.processFields(i,{...r.options}),J.merge(i,s),delete s[r.key]}};await e(r.parent,r.value)}});var b=require("@homedev/navigate"),N=(o)=>({skip:()=>b.NavigateResult.DeleteParent(),metadata:({path:r,value:e})=>{return o.metadata(r,e),b.NavigateResult.DeleteItem()},if:(r)=>{let e=r.parent[".then"],s=r.parent[".else"];if(e)delete r.parent[".then"];if(s)delete r.parent[".else"];if(r.value===null||r.value===void 0||["0",0,"false",""].includes(r.value)||Array.isArray(r.value)&&r.value.length===0)return s??null;else return e??b.NavigateResult.DeleteItem()},switch:(r)=>{let e=r.value;if(!e.cases)throw new Error("Missing cases for switch");return e.cases[e.from]??e.default??null}});var z=require("@homedev/merge"),G=require("@homedev/select"),T=(o)=>({from:async({root:r,parent:e,value:s})=>{let t=await G.select(r,s);if(e.content){if(Array.isArray(e.content)&&Array.isArray(t))return[...t,...e.content];return z.merge(t,e.content),e.content}return t}});var y=require("@homedev/files"),M=w(require("fs/promises")),u=w(require("path")),V=(o)=>({include:async(r)=>{let{file:e}=r.options.globalContext;return await y.globMap(r.args[0],{cwd:u.default.dirname(e),filter:(s)=>u.default.basename(e)!==s,map:async(s)=>o.load(s,u.default.dirname(e),{parent:r.root})})},file:async(r)=>await M.default.readFile(await y.locate(r.args[0],o.getIncludeDirectories())).then((e)=>e.toString()),scan:async(r)=>{let e=[],t=(()=>{let i=r.args[2]??["**/node_modules/**"],m=typeof i==="string"?i.split(",").map((p)=>p.trim()):i;if(!Array.isArray(m))throw new Error("Scan exclusion must be a list");return m})(),{file:a}=r.options.globalContext,n=r.args[1]?await y.locate(r.args[1],o.getIncludeDirectories()):u.default.dirname(a);for await(let i of M.default.glob(r.args[0],{cwd:n,exclude:(m)=>t.some((p)=>u.default.matchesGlob(m,p))}))e.push(i);return e}});var $=(o)=>({env:(r)=>process.env[r.args[0]]});var l=require("@homedev/string-utils"),H=(o)=>({len:(r)=>r.args[0].length,reverse:(r)=>r.args[0].split("").reverse().join(""),substring:(r)=>r.args[0].substring(+r.args[1],+r.args[2]),concat:(r)=>r.args.join(""),lower:(r)=>r.args[0].toLowerCase(),upper:(r)=>r.args[0].toUpperCase(),pascal:(r)=>l.pascal(r.args[0]),camel:(r)=>l.camel(r.args[0]),capital:(r)=>l.capital(r.args[0]),snake:(r)=>l.changeCase(l.snake(r.args[0],"_"),r.args[1]),kebab:(r)=>l.changeCase(l.snake(r.args[0],"-"),r.args[1]),encode:(r)=>Buffer.from(r.args[0]).toString(r.args[1]??"base64"),decode:(r)=>Buffer.from(r.args[0],r.args[1]??"base64").toString(),uuid:(r)=>crypto.randomUUID()});var O=require("@homedev/object-utils"),K=require("@homedev/select"),Q=(o)=>({merge:(r)=>r.args.flatMap((e)=>e),join:(r)=>{let[e,s,t]=r.args,a=e;if(!Array.isArray(a))throw new Error("Object is not a list");if(s?.length)a=a.map((n)=>K.select({...r.root,...n},s));return a.join(t?.replace("\\n",`
+`))},list:(r)=>O.toList(r.args[0],r.args[1]),object:(r)=>O.toObject(r.args[0],r.args[1]),range:(r)=>{let[e,s,t]=r.args,a=parseInt(e),n=parseInt(s),i=parseInt(t)||1;if(isNaN(a)||isNaN(n))throw new Error("Invalid range");return Array.from({length:Math.floor((n-a)/i)+1},(m,p)=>a+p*i)}});var W=require("@homedev/fields"),X=require("@homedev/object-utils"),k=require("@homedev/select"),Y=(o)=>({each:{processArgs:!1,fn:async(r)=>{let e=await k.select(r.root,r.rawArgs[0].value),s=await k.select(r.root,r.rawArgs[1].value),t=r.rawArgs[2]?.value,a=Array.isArray(e)?e:X.toList(e),n=[];for(let i=0;i<a.length;i++){let m=JSON.parse(JSON.stringify(s)),p={instance:m};if(await W.processFields(p,{...r.options,root:{...r.root,item:a[i],this:m,parent:r.root.this,index:i,params:r.rawArgs.slice(3).map((f)=>f.value)}}),t!==void 0&&t!=="@")n.push(p.instance[t]);else n.push(p.instance)}return n}}});var Z=require("@homedev/select"),d=async(o,r,e)=>o.rawArgs[r].quoted?o.rawArgs[r].value:await Z.select(o.root,o.rawArgs[r].value,{defaultValue:e}),x=(o)=>({default:{processArgs:!1,fn:async(r)=>{let e=r.rawArgs[1]?.value?await d(r,1):"";return d(r,0,e)}},switch:{processArgs:!1,fn:async(r)=>{let e=await d(r,0,!1),s=await d(r,1);if(s[e]===void 0){if(r.rawArgs.length>2)return d(r,2);throw new Error(`Unhandled switch case: ${e}`)}return s[e]}}});var rr=(o)=>({log:(r)=>{console.log(...r.args)}});var or=(o)=>({if:{keywords:{0:["eq","ne","lt","le","gt","ge","in","notin","null","notnull","empty","notempty","nullorempty","notnullorempty"]},fn:(r)=>{let[e,...s]=r.args;switch(e){case"eq":return s.every((t,a,n)=>t===n[0]);case"ne":return s.every((t,a,n)=>t!==n[0]);case"lt":return s[0]<s[1];case"le":return s[0]<=s[1];case"gt":return s[0]>s[1];case"ge":return s[0]>=s[1];case"in":return s[0].includes(s[1]);case"notin":return!s[0].includes(s[1]);case"null":return s.every((t,a,n)=>t===null||t===void 0);case"notnull":return s.every((t,a,n)=>t!==null&&t!==void 0);case"empty":return s.every((t,a,n)=>t==="");case"notempty":return s.every((t,a,n)=>t!=="");case"nullorempty":return s.every((t,a,n)=>t===null||t===void 0||t==="");case"notnullorempty":return s.every((t,a,n)=>t!==null&&t!==void 0&&t!=="")}}}});var er=(o)=>o.keys(C(o)).keys(L(o)).keys(D(o)).keys(T(o)).keys(q(o)).keys(U(o)).keys(N(o)).sources(V(o)).sources($(o)).sources(H(o)).sources(Q(o)).sources(Y(o)).sources(x(o)).sources(rr(o)).sources(or(o));class ar{includeDirectories=[];includes=[];outputs=[];vars={};cache={};fields={};objectMetadata={};constructor(){this.use(er)}use(o){return o(this),this}includeDirectory(...o){return this.includeDirectories.push(...o),this}getIncludeDirectories(){return this.includeDirectories}include(...o){return this.includes.push(...o),this}keys(o){return this.fields.keys={...this.fields.keys,...o},this}sources(o){return this.fields.sources={...this.fields.sources,...o},this}variables(o){return this.vars={...this.vars,...o},this}getOutputs(){return this.outputs}output(o){return this.outputs.push(o),this}metadata(o,r){return this.objectMetadata[o]=r,this}getMetadata(o){return this.objectMetadata[o]}getAllMetadata(){return this.objectMetadata}filter(o){return this.fields.filters??=[],this.fields.filters?.push(o),this}async docIncludes(o,r){let e=[];if(o.content.includes)e.push(...o.content.includes),delete o.content.includes;e.push(...this.includes),this.includes.length=0;for(let s of e)tr.merge(await this.load(s,o.folderPath,{parent:o.content,...r},!0),o.content)}async load(o,r,e,s){if(this.cache[o])return this.cache[o];let t=r?[r]:[];t.push(...this.includeDirectories.map((n)=>P.default.isAbsolute(n)?n:P.default.join(r??process.cwd(),n)));let a=await F.loadFormat(o,{dirs:t});if(!a.content)return null;if(await this.docIncludes(a,e),s!==!0)await sr.processFields(a.content,{...this.fields,globalContext:{file:a.fullPath},root:{...this.fields.root,...this.vars,$document:{root:a,fileName:o,folder:a.folderPath,fullPath:a.fullPath,...e}}});return a.content}async writeOutputs(o){await F.writeOutputs(this.getOutputs(),o)}}

package/package.json

@@ -1,13 +1,20 @@
 {
   "name": "@homedev/objector",
-  "version": "0.1.32",
+  "version": "1.0.3",
   "description": "object extensions for YAML/JSON",
   "author": "julzor",
   "license": "ISC",
   "main": "dist/index.js",
   "type": "module",
-  "typings": "dist/objector.d.ts",
+  "typings": "dist/index.d.ts",
   "peerDependencies": {
-    "yaml": "^2.7.0"
+    "@homedev/fields": "^1.0.7",
+    "@homedev/files": "^1.0.1",
+    "@homedev/merge": "^1.0.1",
+    "@homedev/navigate": "^1.0.1",
+    "@homedev/object-utils": "^1.0.1",
+    "@homedev/select": "^1.0.2",
+    "@homedev/string-utils": "^1.0.5",
+    "yaml": "^2.8.0"
   }
 }

package/dist/objector.d.ts

@@ -1,222 +0,0 @@
-/**
- * @public
- */
-export declare interface DataFile<T = any> {
-    content: T;
-    fullPath: string;
-    folderPath: string;
-}
-
-export declare interface FieldContext {
-    value: any;
-    key: string;
-    args: any[];
-    rawArgs: {
-        value: string;
-        quoted: boolean;
-    }[];
-    groups: Record<string, string>;
-    path: string;
-    root: any;
-    parent?: any;
-    file?: string;
-    options?: ProcessFieldsOptions;
-}
-
-export declare type FieldProcessorFunc = (context: FieldContext) => MaybePromise<any>;
-
-export declare type FieldProcessorMap = Record<string, FieldProcessorFunc | FieldProcessorOptions>;
-
-export declare interface FieldProcessorOptions {
-    fn: FieldProcessorFunc;
-    filters?: RegExp[];
-    processArgs?: boolean;
-}
-
-/**
- * @public
- * @param from
- * @param cb
- * @returns
- */
-export declare const find: (from: any, cb: (path: string, value: string) => any) => Promise<any[]>;
-
-/**
- * @public
- */
-export declare interface IncludeOptions {
-    root?: string;
-    loaded?: (data: any) => Promise<void> | void;
-    loadOptions?: LoadOptions;
-    load?: (from: string) => Promise<any>;
-}
-
-/**
- * @public
- * @param fileName
- * @param options
- * @returns
- */
-export declare const load: <T = any>(fileName: string, options?: LoadOptions) => Promise<DataFile<T>>;
-
-/**
- * @public
- */
-export declare interface LoadOptions {
-    dirs?: string[];
-    parsers?: Record<string, (data: string) => any>;
-}
-
-export declare const locate: (fileName: string, optDirs?: string[]) => Promise<string>;
-
-declare type MaybePromise<T> = T | Promise<T>;
-
-/**
- * @public
- * @param source
- * @param target
- * @param options
- */
-export declare const merge: (source: any, target: any, options?: MergeOptions) => void;
-
-/**
- * @public
- */
-export declare type MergeMode = 'merge' | 'source' | 'target' | 'skip';
-
-/**
- * @public
- */
-export declare interface MergeOptions {
-    conflict?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => any;
-    mismatch?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => any;
-    navigate?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => boolean | undefined;
-    mode?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => MergeMode | void;
-}
-
-/**
- * @public
- * @param o
- * @param cb
- */
-export declare const navigate: (o: any, cb: NavigateCallback) => Promise<void>;
-
-/**
- * @public
- */
-export declare enum NavigateAction {
-    Explore = 0,
-    SkipSiblings = 1,
-    NoExplore = 2,
-    ReplaceItem = 3,
-    ReplaceParent = 4,
-    DeleteParent = 5
-}
-
-/**
- * @public
- */
-export declare type NavigateCallback = (context: NavigateContext) => Promise<NavigateResult> | NavigateResult;
-
-/**
- * @public
- */
-export declare interface NavigateContext {
-    key: string;
-    value: any;
-    path: string[];
-    parent: any;
-    parents: any[];
-}
-
-/**
- * @public
- */
-export declare class NavigateResult {
-    readonly action: NavigateAction;
-    by?: any | undefined;
-    constructor(action: NavigateAction, by?: any | undefined);
-    static ReplaceParent(by: any): NavigateResult;
-    static ReplaceItem(by: any): NavigateResult;
-    static SkipSiblings(): NavigateResult;
-    static Explore(): NavigateResult;
-    static NoExplore(): NavigateResult;
-    static DeleteParent(): NavigateResult;
-}
-
-/**
- * @public
- */
-export declare class Objector {
-    private cache;
-    includeDirectory(...dirs: string[]): this;
-    include(...files: string[]): this;
-    keys(keys: FieldProcessorMap): this;
-    sources(sources: FieldProcessorMap): this;
-    variables(vars: Record<string, any>): this;
-    output(o: ObjectorOutput): this;
-    defaultProcessors(): this;
-    alias(name: string, o: any): this;
-    getAlias(name: string): any;
-    getOutputs(): ObjectorOutput[];
-    getIncludeDirectories(): string[];
-    use(handler: (o: Objector) => void): this;
-    filter(f: RegExp): this;
-    load<T = any>(fileName: string, alias?: string, cwd?: string, container?: any, noProcess?: boolean): Promise<T | null>;
-    merge(source: any, target: any): void;
-    mergeAll(elements: any[]): any;
-    writeOutputs(options?: WriteOutputsOption): Promise<void>;
-}
-
-declare interface ObjectorOutput {
-    name: string;
-    type?: string;
-    value: any;
-}
-
-/**
- * @public
- * @param root
- * @param options
- * @returns
- */
-export declare const processFields: (root: any, options: ProcessFieldsOptions) => Promise<void>;
-
-export declare interface ProcessFieldsOptions {
-    sourcesMatcher?: RegExp;
-    sources?: FieldProcessorMap;
-    keysMatcher?: RegExp;
-    keys?: FieldProcessorMap;
-    filters?: RegExp[];
-    file?: string;
-    root?: any;
-    load?: (from: string) => Promise<any>;
-}
-
-/**
- * @public
- * @param includes
- * @param options
- */
-export declare const processIncludes: (includes: string[], options?: IncludeOptions) => Promise<void>;
-
-export declare const select: (at: string, options: {
-    root?: any;
-    load?: (from: string) => Promise<any>;
-    async?: boolean;
-    defaultValue?: any;
-}) => any;
-
-export declare const toList: <T>(from: any, key?: string) => T[];
-
-export declare const toObject: <T>(from: any[], key?: string) => T;
-
-export declare const toObjectWithKey: <T>(from: any[], key?: string) => T;
-
-declare interface WriteOutputsOption {
-    targetDirectory?: string;
-    removeFirst?: boolean;
-    writing?: (output: ObjectorOutput) => boolean | undefined | void;
-}
-
-export { }