@hamak/shared-utils 0.4.1

package/dist/core-utils-pathway.js

@@ -0,0 +1,206 @@
+/**
+ * Class representing a normalized pathway.
+ */
+export class Pathway {
+    /**
+     * Creates a Pathway instance.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     *                An empty array or "." represents the current directory.
+     */
+    constructor(path) {
+        if (path == null || path === "." || (Array.isArray(path) && path.length === 0)) {
+            this.segments = [];
+            this.isAbsolutePath = false;
+        }
+        else {
+            this.isAbsolutePath = Array.isArray(path) ? path[0].startsWith('/') : path.startsWith('/');
+            this.segments = this.normalizePath(path);
+        }
+    }
+    /**
+     * Factory method to create a Pathway instance.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     * @returns A new Pathway instance.
+     */
+    static of(path) {
+        if (path !== undefined && path !== null && typeof path === "object" && !Array.isArray(path)) {
+            return path;
+        }
+        else {
+            return new Pathway(path);
+        }
+    }
+    /**
+     * Normalizes a pathway by converting it into an array of segments.
+     * @param path - The pathway to normalize, either as a string or an array of strings.
+     * @returns An array of normalized path segments, or an empty array if the input is null or undefined.
+     */
+    normalizePath(path) {
+        if (path == null) {
+            return [];
+        }
+        const segments = Array.isArray(path) ? path : path.split('/');
+        return segments
+            .reduce((acc, segment) => {
+            if (segment === "." || segment === "") {
+                return acc;
+            }
+            return acc.concat(segment.split('/'));
+        }, [])
+            .filter(segment => segment.length > 0);
+    }
+    /**
+     * Returns the normalized path segments.
+     * @returns An array of normalized path segments.
+     */
+    getSegments() {
+        return this.segments;
+    }
+    isCurrentDir() {
+        return this.getSegments().length === 0;
+    }
+    /**
+     * Converts the normalized path segments back to a string.
+     * @returns The normalized path as a string.
+     */
+    toString() {
+        return this.isAbsolute() ? '/' + this.segments.join('/') : this.segments.join('/');
+    }
+    /**
+     * Checks if the pathway is absolute.
+     * @returns True if the pathway is absolute, false otherwise.
+     */
+    isAbsolute() {
+        return this.isAbsolutePath;
+    }
+    /**
+     * Checks if the pathway is relative.
+     * @returns True if the pathway is relative, false otherwise.
+     */
+    isRelative() {
+        return !this.isAbsolutePath;
+    }
+    /**
+     * Resolves the current pathway with another pathway or string.
+     * @param otherPath - The other pathway or string to resolve against.
+     * @returns A new Pathway instance representing the resolved path.
+     */
+    resolve(otherPath) {
+        const otherSegments = otherPath instanceof Pathway ? otherPath.getSegments() : this.normalizePath(otherPath);
+        const resolvedSegments = [...this.segments];
+        if (otherPath instanceof Pathway ? otherPath.isAbsolute() : (Array.isArray(otherPath) ? otherPath[0].startsWith('/') : otherPath.startsWith('/'))) {
+            return new Pathway(otherSegments);
+        }
+        for (const segment of otherSegments) {
+            if (segment === '..') {
+                if (resolvedSegments.length > 0 && resolvedSegments[resolvedSegments.length - 1] !== '..') {
+                    resolvedSegments.pop();
+                }
+                else {
+                    resolvedSegments.push(segment);
+                }
+            }
+            else if (segment !== '.') {
+                resolvedSegments.push(segment);
+            }
+        }
+        return new Pathway(this.isAbsolute() ? ["/", ...resolvedSegments] : resolvedSegments);
+    }
+    /**
+     * Gets the parent directory of the current pathway.
+     * @returns A new Pathway instance representing the parent directory.
+     */
+    getParent() {
+        if (this.segments.length === 0) {
+            return new Pathway(null);
+        }
+        const parentSegments = this.segments.slice(0, -1);
+        return new Pathway(this.isAbsolute() ? ["/", ...parentSegments] : parentSegments);
+    }
+    /**
+     * Gets the current directory of the pathway.
+     * @returns The current directory as a string.
+     */
+    getCurrentDirectory() {
+        if (this.segments.length === 0) {
+            return '';
+        }
+        return this.segments[this.segments.length - 1];
+    }
+    /**
+     * Static method to get the absolute path of the root.
+     * @returns A new Pathway instance representing the root path.
+     */
+    static ofRoot() {
+        return new Pathway('/');
+    }
+    /**
+     * Determines the relative path from this pathway to another pathway.
+     * @param otherPath - The other pathway to relativize against.
+     * @returns A new Pathway instance representing the relative path.
+     */
+    relativize(otherPath) {
+        const otherSegments = otherPath instanceof Pathway ? otherPath.getSegments() : this.normalizePath(otherPath);
+        if (this.isAbsolute() !== (otherPath instanceof Pathway ? otherPath.isAbsolute() : (Array.isArray(otherPath) ? otherPath[0].startsWith('/') : otherPath.startsWith('/')))) {
+            throw new Error("Cannot relativize between absolute and relative paths");
+        }
+        let commonLength = 0;
+        const maxLength = Math.min(this.segments.length, otherSegments.length);
+        for (let i = 0; i < maxLength; i++) {
+            if (this.segments[i] !== otherSegments[i]) {
+                break;
+            }
+            commonLength++;
+        }
+        const upSegments = this.segments.slice(commonLength).map(() => '..');
+        const downSegments = otherSegments.slice(commonLength);
+        return new Pathway(upSegments.concat(downSegments));
+    }
+    /**
+     * Checks if the given path is a descendant of the current pathway.
+     * @param otherPath - The other pathway to check.
+     * @returns True if the given path is a descendant, false otherwise.
+     */
+    isDescendant(otherPath) {
+        const otherSegments = otherPath instanceof Pathway ? otherPath.getSegments() : this.normalizePath(otherPath);
+        if (otherSegments.length < this.segments.length) {
+            return false;
+        }
+        for (let i = 0; i < this.segments.length; i++) {
+            if (this.segments[i] !== otherSegments[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    static isRelativePath(path) {
+        const pathway = typeof path === "object" && !Array.isArray(path) ? path : Pathway.of(path);
+        return pathway.isRelative();
+    }
+    static asString(path) {
+        if (typeof path === "string") {
+            return path;
+        }
+        else {
+            const pathway = typeof path === "object" && !Array.isArray(path) ? path : Pathway.of(path);
+            return pathway.toString();
+        }
+    }
+    static getName(path) {
+        let name;
+        switch (typeof path) {
+            case "string":
+                {
+                    name = path;
+                }
+                break;
+            case "object":
+                {
+                    const segments = Array.isArray(path) ? path : path.getSegments();
+                    name = segments[segments.length - 1];
+                }
+                break;
+        }
+        return name;
+    }
+}

package/dist/core-utils-registry.d.ts

@@ -0,0 +1,7 @@
+import { Resolver } from './core-utils-resolver';
+export declare class SimpleRegistry<T> implements Resolver<T> {
+    private readonly records;
+    resolve(namespace: string | undefined, prefix: string | undefined, variableName: string): T | undefined;
+    register(namespace: string | undefined, variableName: string, t: T): void;
+}
+//# sourceMappingURL=core-utils-registry.d.ts.map

package/dist/core-utils-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-registry.d.ts","sourceRoot":"","sources":["../src/core-utils-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IASvG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAG,CAAC;CASpE"}

package/dist/core-utils-registry.js

@@ -0,0 +1,22 @@
+export class SimpleRegistry {
+    constructor() {
+        this.records = new Map();
+    }
+    resolve(namespace, prefix, variableName) {
+        if (prefix !== undefined) {
+            throw new Error(`Not support namespace prefix for name resolution : '${prefix}'`);
+        }
+        else {
+            const record = this.records.get(namespace);
+            return record?.[variableName];
+        }
+    }
+    register(namespace, variableName, t) {
+        let namespaceRecord = this.records.get(namespace);
+        if (namespaceRecord === undefined) {
+            namespaceRecord = {};
+            this.records.set(namespace, namespaceRecord);
+        }
+        namespaceRecord[variableName] = t;
+    }
+}

package/dist/core-utils-resolver.d.ts

@@ -0,0 +1,33 @@
+export interface Resolver<T> {
+    resolve(namespace: string | undefined, prefix: string | undefined, variableName: string): T | undefined;
+}
+export declare class RecordResolver<T> implements Resolver<T> {
+    readonly variables: Record<string, T>;
+    readonly parent?: Resolver<T> | undefined;
+    constructor(variables: Record<string, T>, parent?: Resolver<T> | undefined);
+    resolve(namespace: string | undefined, prefix: string | undefined, variableName: string): T | undefined;
+}
+export declare class QualifiedNameResolverImpl<T> implements Resolver<T> {
+    readonly ignoreNs: boolean;
+    readonly entries: Map<string | undefined, Map<string, T>>;
+    constructor(ignoreNs?: boolean);
+    resolve(namespace: string | undefined, prefix: string | undefined, name: string): T | undefined;
+    setEntries(prefix: string | undefined, entries: Record<string, T>): void;
+    setEntry(prefix: string | undefined, name: string, entry: T): void;
+    private getOrCreatePrefixEntry;
+}
+export type ResolverPredicate = (namespace: string | undefined, prefix: string | undefined, name: string) => boolean;
+export declare class SimpleResolver<T> implements Resolver<T> {
+    readonly parent: Resolver<T> | undefined;
+    readonly namespace: string | undefined;
+    readonly variableName: string | undefined;
+    readonly variableValue: T;
+    constructor(parent: Resolver<T> | undefined, namespace: string | undefined, variableName: string | undefined, variableValue: T);
+    resolve(namespace: string | undefined, prefix: string | undefined, variableName: string): T | undefined;
+}
+export declare class ChainedResolver<T> implements Resolver<T> {
+    readonly resolvers: Resolver<T>[];
+    constructor(resolvers: Resolver<T>[]);
+    resolve(namespace: string | undefined, prefix: string | undefined, variableName: string): T | undefined;
+}
+//# sourceMappingURL=core-utils-resolver.d.ts.map

package/dist/core-utils-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-resolver.d.ts","sourceRoot":"","sources":["../src/core-utils-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;CACxG;AAED,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAAE,QAAQ,CAAC,MAAM,CAAC;gBAA9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAW,MAAM,CAAC,yBAAa;IAGhF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;CAGxG;AAED,qBAAa,yBAAyB,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAElD,QAAQ,CAAC,QAAQ;IAD7B,QAAQ,CAAC,OAAO,0CAA+C;gBAC1C,QAAQ,UAAQ;IAErC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAO/F,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAIlE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAG,MAAM,EAAE,KAAK,EAAG,CAAC;IAK7D,OAAO,CAAC,sBAAsB;CAU/B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;AAEpH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS;IAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAA7I,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,EAAW,SAAS,EAAE,MAAM,GAAG,SAAS,EAAW,YAAY,EAAE,MAAM,GAAG,SAAS,EAAW,aAAa,EAAE,CAAC;IAGlK,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;CAOxG;AAED,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE;gBAAxB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE;IAG7C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;CAUxG"}

package/dist/core-utils-resolver.js

@@ -0,0 +1,65 @@
+export class RecordResolver {
+    constructor(variables, parent) {
+        this.variables = variables;
+        this.parent = parent;
+    }
+    resolve(namespace, prefix, variableName) {
+        return this.variables[variableName] ?? this.parent?.resolve(undefined, undefined, variableName);
+    }
+}
+export class QualifiedNameResolverImpl {
+    constructor(ignoreNs = false) {
+        this.ignoreNs = ignoreNs;
+        this.entries = new Map();
+    }
+    resolve(namespace, prefix, name) {
+        if (!this.ignoreNs && namespace !== undefined && namespace !== null) {
+            throw new Error(`Not support namespace URI but passed as parameter: ${namespace}`);
+        }
+        return this.entries.get(namespace)?.get(name);
+    }
+    setEntries(prefix, entries) {
+        const prefixEntry = this.getOrCreatePrefixEntry(prefix);
+        Object.entries(entries).forEach(([k, v]) => prefixEntry.set(k, v));
+    }
+    setEntry(prefix, name, entry) {
+        const prefixEntry = this.getOrCreatePrefixEntry(prefix);
+        prefixEntry.set(name, entry);
+    }
+    getOrCreatePrefixEntry(prefix) {
+        let prefixEntry = this.entries.get(prefix);
+        if (prefixEntry === undefined) {
+            prefixEntry = new Map();
+            this.entries.set(prefix, prefixEntry);
+        }
+        return prefixEntry;
+    }
+}
+export class SimpleResolver {
+    constructor(parent, namespace, variableName, variableValue) {
+        this.parent = parent;
+        this.namespace = namespace;
+        this.variableName = variableName;
+        this.variableValue = variableValue;
+    }
+    resolve(namespace, prefix, variableName) {
+        if (this.namespace === namespace && this.variableName === variableName) {
+            return this.variableValue;
+        }
+        return this.parent?.resolve(namespace, prefix, variableName);
+    }
+}
+export class ChainedResolver {
+    constructor(resolvers) {
+        this.resolvers = resolvers;
+    }
+    resolve(namespace, prefix, variableName) {
+        for (const resolver of this.resolvers) {
+            const s = resolver.resolve(namespace, prefix, variableName);
+            if (s !== undefined) {
+                return s;
+            }
+        }
+        return undefined;
+    }
+}

package/dist/core-utils-stack.d.ts

@@ -0,0 +1,20 @@
+export interface StackElement<T> {
+    value: T;
+    parent?: StackElement<T>;
+}
+export declare function head<T>(value: T): StackElement<T>;
+export declare function push<T>(head: StackElement<T> | undefined, value: T): StackElement<T>;
+export declare function concat<T>(tail: StackElement<T> | undefined, stack: StackElement<T> | undefined): StackElement<T> | undefined;
+export declare function fromArray<T = any>(t: T[] | undefined): StackElement<T> | undefined;
+export declare function reduce<T, R>(head: StackElement<T> | undefined, reducer: (r: R, t: T) => R, initial: R): R;
+declare function equal<T>(a: StackElement<T> | null | undefined, b: StackElement<T> | null | undefined): boolean;
+declare const stack: {
+    push: typeof push;
+    head: typeof head;
+    concat: typeof concat;
+    reduce: typeof reduce;
+    fromArray: typeof fromArray;
+    equal: typeof equal;
+};
+export default stack;
+//# sourceMappingURL=core-utils-stack.d.ts.map

package/dist/core-utils-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-stack.d.ts","sourceRoot":"","sources":["../src/core-utils-stack.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAG,CAAC,CAAA;IACT,MAAM,CAAC,EAAG,YAAY,CAAC,CAAC,CAAC,CAAA;CAC1B;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAG,CAAC,GAAI,YAAY,CAAC,CAAC,CAAC,CAEnD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAG,CAAC,GAAI,YAAY,CAAC,CAAC,CAAC,CAEvF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,GAAI,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAO/H;AAED,wBAAgB,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,EAAG,CAAC,EAAE,GAAG,SAAS,GAAI,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAEpF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,OAAO,EAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAG,CAAC,GAAI,CAAC,CAQ9G;AAED,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAI,OAAO,CAqBxG;AAED,QAAA,MAAM,KAAK;;;;;;;CAAiD,CAAA;AAE5D,eAAe,KAAK,CAAC"}

package/dist/core-utils-stack.js

@@ -0,0 +1,47 @@
+export function head(value) {
+    return { value };
+}
+export function push(head, value) {
+    return { value, parent: head };
+}
+export function concat(tail, stack) {
+    if (tail === undefined)
+        return stack;
+    if (stack === undefined)
+        return tail;
+    const { parent, value } = stack;
+    return { value, parent: concat(tail, parent) };
+}
+export function fromArray(t) {
+    return t?.reduce((acc, t) => push(acc, t), undefined);
+}
+export function reduce(head, reducer, initial) {
+    if (head === undefined) {
+        return initial;
+    }
+    const { parent, value } = head;
+    const acc = reduce(parent, reducer, initial);
+    return reducer(acc, value);
+}
+function equal(a, b) {
+    // Not equal if both are nullish
+    if (a === undefined || a === null || b === undefined || b === null) {
+        return false;
+    }
+    while (a !== undefined && b !== undefined) {
+        if (a.value !== b.value) {
+            return false;
+        }
+        a = a.parent;
+        b = b.parent;
+    }
+    // Equal if traversed all stack at both side
+    if ((a === undefined || a === null) && (b === undefined || b === null)) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+const stack = { push, head, concat, reduce, fromArray, equal };
+export default stack;

package/dist/core-utils-types-hkt.d.ts

@@ -0,0 +1,12 @@
+export interface HKT3<Obj, Key extends PropertyKey, Value> {
+    _Obj: Obj;
+    _Key: Key;
+    _Value: Value;
+    _Result: unknown;
+}
+export type Apply3<F extends HKT3<any, any, any>, Obj, Key extends PropertyKey, Value> = (F & {
+    _Obj: Obj;
+    _Key: Key;
+    _Value: Value;
+})["_Result"];
+//# sourceMappingURL=core-utils-types-hkt.d.ts.map

package/dist/core-utils-types-hkt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-types-hkt.d.ts","sourceRoot":"","sources":["../src/core-utils-types-hkt.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,WAAW,EAAE,KAAK;IACvD,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,WAAW,EAAE,KAAK,IACnF,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC"}

package/dist/core-utils-types-hkt.js

@@ -0,0 +1 @@
+export {};

package/dist/core-utils-types.d.ts

@@ -0,0 +1,83 @@
+import { Apply3, HKT3 } from "./core-utils-types-hkt";
+export type TypedObject<T extends string = string> = {
+    type: T;
+};
+export type AnyFunction = (...args: any[]) => any;
+/**
+ * Intended to hold value which can be undefined.
+ * It helps to know if a value (incl. undefined) is present or not.
+ */
+export interface Holder<T = any> {
+    value: T;
+}
+export declare function holder<T = any>(value: T): Holder<T>;
+export interface GenericReason {
+    code?: string;
+    message?: string;
+    parameters?: Record<string, any>;
+}
+export type GenericError = GenericReason;
+export type ExpressionString = string;
+export interface HyperLayerNode<T> {
+    keys?: Record<PropertyKey, any>;
+    data?: T;
+    children?: Record<string, HyperLayerNode<T>> | Array<HyperLayerNode<T>>;
+}
+export declare function hyper<T>(data: T, children?: Record<string, HyperLayerNode<T>> | Array<HyperLayerNode<T>>): HyperLayerNode<T>;
+/**
+ * Utility function that create Overlay which mirror original object
+ * @param o
+ */
+export declare function hyperReflect(o: any): HyperLayerNode<any>;
+export type HyperLayerNodeHKT<T, F extends HKT3<any, any, any>, Host = never, Key extends PropertyKey = never> = T extends Array<infer U> ? {
+    data?: Apply3<F, Host, Key, T>;
+    children?: HyperLayerNodeHKT<U, F, T, never>[];
+} : T extends Record<string, any> ? {
+    data?: Apply3<F, Host, Key, T>;
+    children?: {
+        [K in keyof T]?: HyperLayerNodeHKT<T[K], F, T, K>;
+    };
+} : {
+    data?: Apply3<F, Host, Key, T>;
+};
+export interface OverlayNodeBase<A> {
+    type: "object" | "array" | "scalar";
+    annotation?: A;
+}
+export interface ObjectOverlayNode<A> extends OverlayNodeBase<A> {
+    type: "object";
+    children: Record<string, OverlayNode<A>>;
+}
+export interface ArrayOverlayNode<A> extends OverlayNodeBase<A> {
+    type: "array";
+    children: Array<OverlayNode<A>>;
+}
+export interface ScalarOverlayNode<A> extends OverlayNodeBase<A> {
+    type: "scalar";
+}
+export type OverlayNode<A> = ObjectOverlayNode<A> | ArrayOverlayNode<A> | ScalarOverlayNode<A>;
+export interface Annotation<A> {
+    annotation?: A;
+}
+export type Overlay<T, A> = T extends Array<infer U> ? {
+    type: "array";
+    children: Overlay<U, A>[];
+} & Annotation<A> : T extends Record<string, any> ? {
+    type: "object";
+    children: {
+        [K in keyof T]?: Overlay<T[K], A>;
+    };
+} & Annotation<A> : {
+    type: "scalar";
+} & Annotation<A>;
+/**
+ * Mainly used to prevent re-entrant navitation
+ */
+export declare class ExplorationContext<T> {
+    readonly parent: ExplorationContext<T> | undefined;
+    readonly values: T[];
+    constructor(parent: ExplorationContext<T> | undefined, values: T[]);
+    explored(t: T): boolean;
+    newChild(values: T[]): ExplorationContext<T>;
+}
+//# sourceMappingURL=core-utils-types.d.ts.map

package/dist/core-utils-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-types.d.ts","sourceRoot":"","sources":["../src/core-utils-types.ts"],"names":[],"mappings":"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"}

package/dist/core-utils-types.js

@@ -0,0 +1,39 @@
+export function holder(value) {
+    return { value };
+}
+export function hyper(data, children) {
+    return { data, children };
+}
+/**
+ * Utility function that create Overlay which mirror original object
+ * @param o
+ */
+export function hyperReflect(o) {
+    if (o === null || o === undefined) {
+        return hyper(o);
+    }
+    else if (Array.isArray(o)) {
+        return hyper(o, o.map(e => hyperReflect(e)));
+    }
+    else if (typeof o === "object") {
+        return hyper(o, Object.entries(o).reduce((acc, [k, v]) => ({ ...acc, [k]: hyperReflect(v) }), {}));
+    }
+    else {
+        return hyper(o);
+    }
+}
+/**
+ * Mainly used to prevent re-entrant navitation
+ */
+export class ExplorationContext {
+    constructor(parent, values) {
+        this.parent = parent;
+        this.values = values;
+    }
+    explored(t) {
+        return this.values.includes(t);
+    }
+    newChild(values) {
+        return new ExplorationContext(this, values);
+    }
+}

package/dist/core-utils-validations.d.ts

@@ -0,0 +1,21 @@
+export interface NodeValidation {
+    type: "core:node-validation";
+    notes: ValidationNote[];
+}
+export interface ValidationNote {
+    uuid?: string;
+    severity: "info" | "warning" | "error";
+    key?: string;
+    message?: string;
+    params?: Record<string, any>;
+}
+declare class NoteUtils {
+    add(nv: NodeValidation, ...notes: ValidationNote[]): NodeValidation;
+    of(...notes: ValidationNote[]): NodeValidation;
+    info(key?: string, message?: string, params?: Record<string, any>): ValidationNote;
+    warning(key?: string, message?: string, params?: Record<string, any>): ValidationNote;
+    error(key?: string, message?: string, params?: Record<string, any>): ValidationNote;
+}
+export declare const notes: NoteUtils;
+export {};
+//# sourceMappingURL=core-utils-validations.d.ts.map

package/dist/core-utils-validations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils-validations.d.ts","sourceRoot":"","sources":["../src/core-utils-validations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,sBAAsB,CAAA;IAC5B,KAAK,EAAG,cAAc,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC7B;AAGD,cAAM,SAAS;IACb,GAAG,CAAC,EAAE,EAAG,cAAc,EAAE,GAAG,KAAK,EAAG,cAAc,EAAE,GAAI,cAAc;IAGtE,EAAE,CAAC,GAAG,KAAK,EAAG,cAAc,EAAE,GAAI,cAAc;IAGhD,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc;IAIlF,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc;IAIrF,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc;CAGpF;AAGD,eAAO,MAAM,KAAK,WAAkB,CAAA"}

package/dist/core-utils-validations.js

@@ -0,0 +1,18 @@
+class NoteUtils {
+    add(nv, ...notes) {
+        return { ...(nv ?? { type: "core:node-validation" }), notes };
+    }
+    of(...notes) {
+        return { type: "core:node-validation", notes };
+    }
+    info(key, message, params) {
+        return { severity: "info", key, message, params };
+    }
+    warning(key, message, params) {
+        return { severity: "warning", key, message, params };
+    }
+    error(key, message, params) {
+        return { severity: "error", key, message, params };
+    }
+}
+export const notes = new NoteUtils();

package/dist/core-utils.d.ts

@@ -0,0 +1,39 @@
+declare function includes<T extends U, U>(arr: Array<T>, t: U): t is U;
+export declare function isNonNullObject(data: any): boolean;
+declare function isBlank(s: string): boolean;
+declare function isDefined(data: any): boolean;
+declare function isNotDefined(data: any): boolean;
+export declare function isNullish(o: any): o is (null | undefined);
+export declare function isEmptyObject(object: Record<any, any>): boolean;
+export declare function equalSet(a: Set<unknown>, b: Set<unknown>): boolean;
+export type EqualFn<T> = (a: T, b: T) => boolean;
+export declare const DEFAULT_EQUAL_FN: EqualFn<any>;
+export declare function areSameDefined<T>(a: T | undefined, b: T | undefined, equalFn?: EqualFn<T>): boolean;
+/**
+ * Warning: non performant O(n2)
+ * @param arr
+ * @param equals
+ */
+export declare function removeDuplicates<T>(arr: T[], equals?: EqualFn<T>): T[];
+declare function intersection<T>(o1: Record<string, T>, o2: Record<string, T>): string[];
+declare function deepEqual(obj1: any, obj2: any): boolean;
+declare function escapeForXPath(input: string): string;
+export type ArrayFilterFn<T> = (value: T, index: number, array: Array<T>) => boolean;
+declare function cascadeFilter<T>(arr: Array<T>, fns: ArrayFilterFn<T>[]): Array<T>;
+export declare const utils: {
+    includes: typeof includes;
+    isNonNullObject: typeof isNonNullObject;
+    isEmptyObject: typeof isEmptyObject;
+    equalSet: typeof equalSet;
+    isDefined: typeof isDefined;
+    isBlank: typeof isBlank;
+    isNotDefined: typeof isNotDefined;
+    removeDuplicates: typeof removeDuplicates;
+    areSameDefined: typeof areSameDefined;
+    intersection: typeof intersection;
+    deepEqual: typeof deepEqual;
+    escapeForXPath: typeof escapeForXPath;
+    cascadeFilter: typeof cascadeFilter;
+};
+export {};
+//# sourceMappingURL=core-utils.d.ts.map

package/dist/core-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-utils.d.ts","sourceRoot":"","sources":["../src/core-utils.ts"],"names":[],"mappings":"AAAA,iBAAS,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAG,GAAG,EAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAG,CAAC,GAAI,CAAC,IAAI,CAAC,CAEjE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAG,GAAG,GAAI,OAAO,CAOpD;AAGD,iBAAS,OAAO,CAAC,CAAC,EAAG,MAAM,GAAI,OAAO,CAErC;AAED,iBAAS,SAAS,CAAC,IAAI,EAAG,GAAG,GAAI,OAAO,CAEvC;AAED,iBAAS,YAAY,CAAC,IAAI,EAAG,GAAG,GAAI,OAAO,CAE1C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAG,GAAG,GAAI,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAE3D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,WAKtD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAG,GAAG,CAAC,OAAO,CAAC,WAE1D;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,CAAC,KAAK,OAAO,CAAA;AAC9C,eAAO,MAAM,gBAAgB,EAAG,OAAO,CAAC,GAAG,CAAqB,CAAA;AAEhE,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAG,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC,EAAG,OAAO,CAAC,CAAC,CAAC,GAAI,OAAO,CAStG;AACD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAoB,GAAI,CAAC,EAAE,CAE3F;AAKD,iBAAS,YAAY,CAAC,CAAC,EAAE,EAAE,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,YAEtE;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CA+BhD;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc7C;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAC,CAAC,EAAE,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;AAIrF,iBAAS,aAAa,CAAC,CAAC,EAAE,GAAG,EAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAG,aAAa,CAAC,CAAC,CAAC,EAAE,GAAI,KAAK,CAAC,CAAC,CAAC,CAa7E;AACD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;CAAmL,CAAA"}