@traqula/core 0.0.18 → 0.0.20

package/lib/Transformers.js

@@ -1,226 +0,0 @@
-export class TransformerType {
-    clone(obj) {
-        const newObj = Object.create(Object.getPrototypeOf(obj));
-        Object.defineProperties(newObj, Object.getOwnPropertyDescriptors(obj));
-        return newObj;
-    }
-    safeObjectVisit(value, mapper) {
-        if (value && typeof value === 'object') {
-            if (Array.isArray(value)) {
-                return value.map(x => this.safeObjectVisit(x, mapper));
-            }
-            return mapper(value);
-        }
-        return value;
-    }
-    /**
-     * Recursively transforms all objects that are not arrays. Mapper is called on deeper objects first.
-     * @param startObject object to start iterating from
-     * @param mapper mapper to transform the various objects - argument is a copy of the original
-     * @param preVisitor callback that is evaluated before iterating deeper.
-     *   If continues is false, we do not iterate deeper, current object is still mapped. - default: true
-     *   If shortcut is true, we do not iterate deeper, nor do we branch out, this mapper will be the last one called.
-     *    - Default false
-     */
-    transformObject(startObject, mapper, preVisitor = () => ({})) {
-        let didShortCut = false;
-        const recurse = (curObject) => {
-            const copy = this.clone(curObject);
-            const context = preVisitor(copy);
-            didShortCut = context.shortcut ?? false;
-            const continues = context.continue ?? true;
-            if (continues && !didShortCut) {
-                for (const [key, value] of Object.entries(copy)) {
-                    if (didShortCut) {
-                        return copy;
-                    }
-                    copy[key] =
-                        this.safeObjectVisit(value, obj => recurse(obj));
-                }
-            }
-            return mapper(copy);
-        };
-        return recurse(startObject);
-    }
-    /**
-     * Visitor that visits all objects. Visits deeper objects first.
-     */
-    visitObject(startObject, visitor, preVisitor = () => ({})) {
-        let didShortCut = false;
-        const recurse = (curObject) => {
-            const context = preVisitor(curObject);
-            didShortCut = context.shortcut ?? false;
-            const continues = context.continue ?? true;
-            if (continues && !didShortCut) {
-                for (const value of Object.values(curObject)) {
-                    if (didShortCut) {
-                        return;
-                    }
-                    this.safeObjectVisit(value, obj => recurse(obj));
-                }
-            }
-            visitor(curObject);
-        };
-        recurse(startObject);
-    }
-    transformNode(startObject, nodeCallBacks) {
-        const transformWrapper = (curObject) => {
-            const casted = curObject;
-            if (casted.type) {
-                const ogFunc = nodeCallBacks[casted.type]?.transform;
-                if (ogFunc) {
-                    return ogFunc(casted);
-                }
-            }
-            return curObject;
-        };
-        const preTransformWrapper = (curObject) => {
-            const casted = curObject;
-            if (casted.type) {
-                const ogFunc = nodeCallBacks[casted.type]?.preVisitor;
-                if (ogFunc) {
-                    return ogFunc(casted);
-                }
-            }
-            return {};
-        };
-        return this.transformObject(startObject, transformWrapper, preTransformWrapper);
-    }
-    visitNode(startObject, nodeCallBacks) {
-        const visitWrapper = (curObject) => {
-            const casted = curObject;
-            if (casted.type) {
-                const ogFunc = nodeCallBacks[casted.type]?.visitor;
-                if (ogFunc) {
-                    ogFunc(casted);
-                }
-            }
-        };
-        const preVisitWrapper = (curObject) => {
-            const casted = curObject;
-            if (casted.type) {
-                const ogFunc = nodeCallBacks[casted.type]?.preVisitor;
-                if (ogFunc) {
-                    return ogFunc(casted);
-                }
-            }
-            return {};
-        };
-        this.visitObject(startObject, visitWrapper, preVisitWrapper);
-    }
-    traverseNodes(currentNode, traverse) {
-        let didShortCut = false;
-        const recurse = (curNode) => {
-            const traverser = traverse[curNode.type];
-            if (traverser) {
-                const { next, shortcut } = traverser(curNode);
-                didShortCut = shortcut ?? false;
-                if (!didShortCut) {
-                    for (const node of next ?? []) {
-                        if (didShortCut) {
-                            return;
-                        }
-                        recurse(node);
-                    }
-                }
-            }
-        };
-        recurse(currentNode);
-    }
-}
-export class TransformerSubType extends TransformerType {
-    transformNodeSpecific(startObject, nodeCallBacks, nodeSpecificCallBacks) {
-        const transformWrapper = (curObject) => {
-            let ogTransform;
-            const casted = curObject;
-            if (casted.type && casted.subType) {
-                const specific = nodeSpecificCallBacks[casted.type];
-                if (specific) {
-                    ogTransform = specific[casted.subType]?.transform;
-                }
-                if (!ogTransform) {
-                    ogTransform = nodeCallBacks[casted.type]?.transform;
-                }
-            }
-            return ogTransform ? ogTransform(casted) : curObject;
-        };
-        const preVisitWrapper = (curObject) => {
-            let ogPreVisit;
-            const casted = curObject;
-            if (casted.type && casted.subType) {
-                const specific = nodeSpecificCallBacks[casted.type];
-                if (specific) {
-                    ogPreVisit = specific[casted.subType]?.preVisitor;
-                }
-                if (!ogPreVisit) {
-                    ogPreVisit = nodeCallBacks[casted.type]?.preVisitor;
-                }
-            }
-            return ogPreVisit ? ogPreVisit(casted) : curObject;
-        };
-        return this.transformObject(startObject, transformWrapper, preVisitWrapper);
-    }
-    /**
-     * When both nodeCallBack and NodeSpecific callBack are matched, will only look at nodeSpecifCallback
-     */
-    visitNodeSpecific(startObject, nodeCallBacks, nodeSpecificCallBacks) {
-        const visitWrapper = (curObject) => {
-            let ogTransform;
-            const casted = curObject;
-            if (casted.type && casted.subType) {
-                const specific = nodeSpecificCallBacks[casted.type];
-                if (specific) {
-                    ogTransform = specific[casted.subType]?.visitor;
-                }
-                if (!ogTransform) {
-                    ogTransform = nodeCallBacks[casted.type]?.visitor;
-                }
-            }
-            if (ogTransform) {
-                ogTransform(casted);
-            }
-        };
-        const preVisitWrapper = (curObject) => {
-            let ogPreVisit;
-            const casted = curObject;
-            if (casted.type && casted.subType) {
-                const specific = nodeSpecificCallBacks[casted.type];
-                if (specific) {
-                    ogPreVisit = specific[casted.subType]?.preVisitor;
-                }
-                if (!ogPreVisit) {
-                    ogPreVisit = nodeCallBacks[casted.type]?.preVisitor;
-                }
-            }
-            return ogPreVisit ? ogPreVisit(casted) : curObject;
-        };
-        this.visitObject(startObject, visitWrapper, preVisitWrapper);
-    }
-    traverseSubNodes(currentNode, traverseNode, traverseSubNode) {
-        let didShortCut = false;
-        const recurse = (curNode) => {
-            let traverser;
-            const subObj = traverseSubNode[curNode.type];
-            if (subObj) {
-                traverser = subObj[curNode.subType];
-            }
-            if (!traverser) {
-                traverser = traverseNode[curNode.type];
-            }
-            if (traverser) {
-                const { next, shortcut } = traverser(curNode);
-                didShortCut = shortcut ?? false;
-                if (!didShortCut) {
-                    for (const node of next ?? []) {
-                        if (didShortCut) {
-                            return;
-                        }
-                        recurse(node);
-                    }
-                }
-            }
-        };
-        recurse(currentNode);
-    }
-}
-//# sourceMappingURL=Transformers.js.map

package/lib/Transformers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Transformers.js","sourceRoot":"","sources":["Transformers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Node } from './nodeTypings.js';\n\ntype Safeness = 'safe' | 'unsafe';\ntype SafeWrap<Safe extends Safeness, obj extends object> = Safe extends 'safe' ? {[key in keyof obj]: unknown } : obj;\n\nexport interface VisitContext {\n  shortcut?: boolean;\n  continue?: boolean;\n}\n\nexport interface SelectiveTraversalContext<Nodes> {\n  next?: Nodes[];\n  shortcut?: boolean;\n}\n\nexport class TransformerType<Nodes extends Pick<Node, 'type'>> {\n  protected clone<T>(obj: T): T {\n    const newObj = Object.create(Object.getPrototypeOf(obj));\n    Object.defineProperties(\n      newObj,\n      Object.getOwnPropertyDescriptors(obj),\n    );\n    return newObj;\n  }\n\n  protected safeObjectVisit(value: unknown, mapper: (some: object) => any): unknown {\n    if (value && typeof value === 'object') {\n      if (Array.isArray(value)) {\n        return value.map(x => this.safeObjectVisit(x, mapper));\n      }\n      return mapper(value);\n    }\n    return value;\n  }\n\n  /**\n   * Recursively transforms all objects that are not arrays. Mapper is called on deeper objects first.\n   * @param startObject object to start iterating from\n   * @param mapper mapper to transform the various objects - argument is a copy of the original\n   * @param preVisitor callback that is evaluated before iterating deeper.\n   *   If continues is false, we do not iterate deeper, current object is still mapped. - default: true\n   *   If shortcut is true, we do not iterate deeper, nor do we branch out, this mapper will be the last one called.\n   *    - Default false\n   */\n  public transformObject(\n    startObject: object,\n    mapper: (some: object) => any,\n    preVisitor: (some: object) => VisitContext = () => ({}),\n  ): unknown {\n    let didShortCut = false;\n    const recurse = (curObject: object): unknown => {\n      const copy = this.clone(curObject);\n      const context = preVisitor(copy);\n      didShortCut = context.shortcut ?? false;\n      const continues = context.continue ?? true;\n      if (continues && !didShortCut) {\n        for (const [ key, value ] of Object.entries(copy)) {\n          if (didShortCut) {\n            return copy;\n          }\n          (<Record<string, unknown>> copy)[key] =\n            this.safeObjectVisit(value, obj => recurse(obj));\n        }\n      }\n      return mapper(copy);\n    };\n\n    return recurse(startObject);\n  }\n\n  /**\n   * Visitor that visits all objects. Visits deeper objects first.\n   */\n  public visitObject(\n    startObject: object,\n    visitor: (some: object) => void,\n    preVisitor: (some: object) => VisitContext = () => ({}),\n  ): void {\n    let didShortCut = false;\n\n    const recurse = (curObject: object): void => {\n      const context = preVisitor(curObject);\n      didShortCut = context.shortcut ?? false;\n      const continues = context.continue ?? true;\n      if (continues && !didShortCut) {\n        for (const value of Object.values(curObject)) {\n          if (didShortCut) {\n            return;\n          }\n          this.safeObjectVisit(value, obj => recurse(obj));\n        }\n      }\n      visitor(curObject);\n    };\n    recurse(startObject);\n  }\n\n  public transformNode<Safe extends 'safe' | 'unsafe' = 'safe'>(\n    startObject: object,\n    nodeCallBacks: {[T in Nodes['type']]?: {\n      transform?: (op: SafeWrap<Safe, Extract<Nodes, { type: T }>>) => any;\n      preVisitor?: (op: Extract<Nodes, { type: T }>) => VisitContext;\n    }},\n  ): any {\n    const transformWrapper = (curObject: object): unknown => {\n      const casted = <{ type?: Nodes['type'] }>curObject;\n      if (casted.type) {\n        const ogFunc: ((node: any) => unknown) | undefined = nodeCallBacks[casted.type]?.transform;\n        if (ogFunc) {\n          return ogFunc(casted);\n        }\n      }\n      return curObject;\n    };\n    const preTransformWrapper = (curObject: object): VisitContext => {\n      const casted = <{ type?: Nodes['type'] }>curObject;\n      if (casted.type) {\n        const ogFunc: ((node: any) => VisitContext) | undefined = nodeCallBacks[casted.type]?.preVisitor;\n        if (ogFunc) {\n          return ogFunc(casted);\n        }\n      }\n      return {};\n    };\n    return this.transformObject(startObject, transformWrapper, preTransformWrapper);\n  }\n\n  public visitNode(\n    startObject: object,\n    nodeCallBacks: {[T in Nodes['type']]?: {\n      visitor?: (op: Extract<Nodes, { type: T }>) => void;\n      preVisitor?: (op: Extract<Nodes, { type: T }>) => VisitContext;\n    }},\n  ): void {\n    const visitWrapper = (curObject: object): void => {\n      const casted = <{ type?: Nodes['type'] }>curObject;\n      if (casted.type) {\n        const ogFunc: ((node: any) => unknown) | undefined = nodeCallBacks[casted.type]?.visitor;\n        if (ogFunc) {\n          ogFunc(casted);\n        }\n      }\n    };\n    const preVisitWrapper = (curObject: object): VisitContext => {\n      const casted = <{ type?: Nodes['type'] }>curObject;\n      if (casted.type) {\n        const ogFunc: ((node: any) => VisitContext) | undefined = nodeCallBacks[casted.type]?.preVisitor;\n        if (ogFunc) {\n          return ogFunc(casted);\n        }\n      }\n      return {};\n    };\n    this.visitObject(startObject, visitWrapper, preVisitWrapper);\n  }\n\n  public traverseNodes(\n    currentNode: Nodes,\n    traverse: {[T in Nodes['type']]?: (op: Extract<Nodes, { type: T }>) => SelectiveTraversalContext<Nodes> },\n  ): void {\n    let didShortCut = false;\n\n    const recurse = (curNode: Nodes): void => {\n      const traverser = traverse[<Nodes['type']>curNode.type];\n      if (traverser) {\n        const { next, shortcut } = traverser(<any>curNode);\n        didShortCut = shortcut ?? false;\n        if (!didShortCut) {\n          for (const node of next ?? []) {\n            if (didShortCut) {\n              return;\n            }\n            recurse(node);\n          }\n        }\n      }\n    };\n\n    recurse(currentNode);\n  }\n}\n\nexport class TransformerSubType<Nodes extends Pick<Node, 'type' | 'subType'>> extends TransformerType<Nodes> {\n  public transformNodeSpecific<Safe extends 'safe' | 'unsafe' = 'safe'>(\n    startObject: object,\n    nodeCallBacks: {[T in Nodes['type']]?: {\n      transform?: (op: SafeWrap<Safe, Extract<Nodes, { type: T }>>) => any;\n      preVisitor?: (op: Extract<Nodes, { type: T }>) => VisitContext;\n    }},\n    nodeSpecificCallBacks: {[Type in Nodes['type']]?: {\n      [SubType in Extract<Nodes, { type: Type; subType: string }>['subType']]?: {\n        transform?: (op: SafeWrap<Safe, Extract<Nodes, { type: Type; subType: SubType }>>) => any;\n        preVisitor?: (op: Extract<Nodes, { type: Type; subType: SubType }>) => VisitContext;\n      }}},\n  ): any {\n    const transformWrapper = (curObject: object): unknown => {\n      let ogTransform: ((node: any) => unknown) | undefined;\n      const casted = <{ type?: Nodes['type']; subType?: string }>curObject;\n      if (casted.type && casted.subType) {\n        const specific = nodeSpecificCallBacks[casted.type];\n        if (specific) {\n          ogTransform = specific[<keyof typeof specific> casted.subType]?.transform;\n        }\n        if (!ogTransform) {\n          ogTransform = nodeCallBacks[casted.type]?.transform;\n        }\n      }\n      return ogTransform ? ogTransform(casted) : curObject;\n    };\n    const preVisitWrapper = (curObject: object): VisitContext => {\n      let ogPreVisit: ((node: any) => VisitContext) | undefined;\n      const casted = <{ type?: Nodes['type']; subType?: string }>curObject;\n      if (casted.type && casted.subType) {\n        const specific = nodeSpecificCallBacks[casted.type];\n        if (specific) {\n          ogPreVisit = specific[<keyof typeof specific> casted.subType]?.preVisitor;\n        }\n        if (!ogPreVisit) {\n          ogPreVisit = nodeCallBacks[casted.type]?.preVisitor;\n        }\n      }\n      return ogPreVisit ? ogPreVisit(casted) : curObject;\n    };\n    return this.transformObject(startObject, transformWrapper, preVisitWrapper);\n  }\n\n  /**\n   * When both nodeCallBack and NodeSpecific callBack are matched, will only look at nodeSpecifCallback\n   */\n  public visitNodeSpecific(\n    startObject: object,\n    nodeCallBacks: {[T in Nodes['type']]?: {\n      visitor?: (op: Extract<Nodes, { type: T }>) => void;\n      preVisitor?: (op: Extract<Nodes, { type: T }>) => VisitContext;\n    }},\n    nodeSpecificCallBacks: {[Type in Nodes['type']]?:\n      {[Subtype in Extract<Nodes, { type: Type; subType: string }>['subType']]?: {\n        visitor?: (op: Extract<Nodes, { type: Type; subType: Subtype }>) => void;\n        preVisitor?: (op: Extract<Nodes, { type: Type; subType: Subtype }>) => VisitContext;\n      }}},\n  ): void {\n    const visitWrapper = (curObject: object): void => {\n      let ogTransform: ((node: any) => void) | undefined;\n      const casted = <{ type?: Nodes['type']; subType?: string }>curObject;\n      if (casted.type && casted.subType) {\n        const specific = nodeSpecificCallBacks[casted.type];\n        if (specific) {\n          ogTransform = specific[<keyof typeof specific> casted.subType]?.visitor;\n        }\n        if (!ogTransform) {\n          ogTransform = nodeCallBacks[casted.type]?.visitor;\n        }\n      }\n      if (ogTransform) {\n        ogTransform(casted);\n      }\n    };\n    const preVisitWrapper = (curObject: object): VisitContext => {\n      let ogPreVisit: ((node: any) => VisitContext) | undefined;\n      const casted = <{ type?: Nodes['type']; subType?: string }>curObject;\n      if (casted.type && casted.subType) {\n        const specific = nodeSpecificCallBacks[casted.type];\n        if (specific) {\n          ogPreVisit = specific[<keyof typeof specific> casted.subType]?.preVisitor;\n        }\n        if (!ogPreVisit) {\n          ogPreVisit = nodeCallBacks[casted.type]?.preVisitor;\n        }\n      }\n      return ogPreVisit ? ogPreVisit(casted) : curObject;\n    };\n    this.visitObject(startObject, visitWrapper, preVisitWrapper);\n  }\n\n  public traverseSubNodes(\n    currentNode: Nodes,\n    traverseNode: {[Type in Nodes['type']]?:\n      (op: Extract<Nodes, { type: Type }>) => SelectiveTraversalContext<Nodes> },\n    traverseSubNode: {[Type in Nodes['type']]?:\n      {[Subtype in Extract<Nodes, { type: Type; subType: string }>['subType']]?:\n        (op: Extract<Nodes, { type: Type; subType: Subtype }>) => SelectiveTraversalContext<Nodes> }},\n  ): void {\n    let didShortCut = false;\n\n    const recurse = (curNode: Nodes): void => {\n      let traverser: ((call: any) => SelectiveTraversalContext<Nodes>) | undefined;\n      const subObj = traverseSubNode[<Nodes['type']>curNode.type];\n      if (subObj) {\n        traverser = subObj[<keyof typeof subObj>curNode.subType];\n      }\n      if (!traverser) {\n        traverser = traverseNode[<Nodes['type']>curNode.type];\n      }\n      if (traverser) {\n        const { next, shortcut } = traverser(<any>curNode);\n        didShortCut = shortcut ?? false;\n        if (!didShortCut) {\n          for (const node of next ?? []) {\n            if (didShortCut) {\n              return;\n            }\n            recurse(node);\n          }\n        }\n      }\n    };\n\n    recurse(currentNode);\n  }\n}\n"]}