aontu 0.30.1 → 0.31.0

package/dist/ctx.d.ts

@@ -0,0 +1,51 @@
+import type { Val, FST, AontuOptions } from './type';
+import { NilVal } from './val/NilVal';
+type AontuContextConfig = {
+    cc?: number;
+    err?: any[];
+    explain?: any[] | boolean | null;
+    fs?: any;
+    path?: string[];
+    root?: Val;
+    seen?: Record<string, number>;
+    seenI?: number;
+    src?: string;
+    srcpath?: string;
+    vars?: Record<string, Val>;
+    vc?: number;
+    collect?: boolean;
+    opts?: AontuOptions;
+    deps?: Record<string, any>;
+};
+declare class AontuContext {
+    root?: Val;
+    path: string[];
+    vc: number;
+    cc: number;
+    vars: Record<string, Val>;
+    src?: string;
+    fs?: FST;
+    seenI: number;
+    seen: Record<string, number>;
+    collect: boolean;
+    err: any[];
+    explain: any[] | null;
+    srcpath?: string;
+    deps: Record<string, any>;
+    opts: AontuOptions;
+    _pathstr: string | undefined;
+    constructor(cfg: AontuContextConfig);
+    clone(cfg: {
+        root?: Val;
+        path?: string[];
+        err?: any[];
+        explain?: any[] | boolean | null;
+    }): AontuContext;
+    descend(key: string): AontuContext;
+    addopts(opts?: AontuOptions): void;
+    adderr(err: NilVal): void;
+    errmsg(): string;
+    find(path: string[]): Val | undefined;
+    get pathstr(): string;
+}
+export { AontuContext, AontuContextConfig };

package/dist/ctx.js

@@ -0,0 +1,105 @@
+"use strict";
+/* Copyright (c) 2021-2025 Richard Rodger, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AontuContext = void 0;
+const type_1 = require("./type");
+const MapVal_1 = require("./val/MapVal");
+const ListVal_1 = require("./val/ListVal");
+const err_1 = require("./err");
+class AontuContext {
+    constructor(cfg) {
+        this.cc = -1;
+        this.vars = {};
+        this.root = cfg.root;
+        this.path = [...(cfg.path ?? [])];
+        this.src = cfg.src;
+        this.collect = cfg.collect ?? null != cfg.err;
+        this.err = cfg.err ?? [];
+        this.explain = Array.isArray(cfg.explain) ? cfg.explain : null;
+        this.fs = cfg.fs ?? null;
+        // Multiple unify passes will keep incrementing Val counter.
+        this.vc = null == cfg.vc ? 1_000_000_000 : cfg.vc;
+        this.cc = null == cfg.cc ? this.cc : cfg.cc;
+        this.vars = cfg.vars ?? this.vars;
+        this.seenI = cfg.seenI ?? 0;
+        this.seen = cfg.seen ?? {};
+        this.srcpath = cfg.srcpath ?? undefined;
+        this.deps = cfg.deps ?? {};
+        this.opts = (0, type_1.DEFAULT_OPTS)();
+        this.addopts(cfg.opts);
+    }
+    clone(cfg) {
+        const ctx = Object.create(this);
+        ctx.path = cfg.path ?? this.path;
+        ctx.root = cfg.root ?? this.root;
+        ctx.var = Object.create(this.vars);
+        ctx.err = cfg.err ?? ctx.err;
+        ctx.explain = Array.isArray(cfg.explain) ? cfg.explain : ctx.explain;
+        ctx._pathstr = undefined;
+        return ctx;
+    }
+    descend(key) {
+        return this.clone({
+            root: this.root,
+            path: this.path.concat(key),
+        });
+    }
+    addopts(opts) {
+        if (null != opts) {
+            Object.assign(this.opts, opts);
+        }
+        this.collect = (this.opts.collect ?? null != this.opts.err) ?? this.collect;
+        this.err = this.opts.err ?? this.err;
+        this.fs = this.opts.fs ?? this.fs;
+        this.explain = this.opts.explain ?? this.explain;
+        this.src = ('string' === typeof this.opts.src ? this.opts.src : undefined) ?? this.src;
+        // TODO: rename srcpath to file
+        this.srcpath = this.opts.path ?? this.srcpath;
+    }
+    adderr(err) {
+        if (null != err && err.isNil) {
+            if (null == err.primary) {
+                err.primary = err;
+            }
+            if (!this.err.includes(err)) {
+                this.err.push(err);
+            }
+            if (null == err.msg || '' == err.msg) {
+                (0, err_1.descErr)(err, this);
+            }
+        }
+    }
+    errmsg() {
+        // return this.errlist
+        return this.err
+            .map((err) => err?.msg)
+            .filter(msg => null != msg)
+            .join('\n------\n');
+    }
+    find(path) {
+        let node = this.root;
+        let pI = 0;
+        for (; pI < path.length; pI++) {
+            let part = path[pI];
+            if (node instanceof MapVal_1.MapVal) {
+                node = node.peg[part];
+            }
+            else if (node instanceof ListVal_1.ListVal) {
+                node = node.peg[part];
+            }
+            else {
+                break;
+            }
+        }
+        if (pI < path.length) {
+            node = undefined;
+        }
+        return node;
+    }
+    get pathstr() {
+        return this._pathstr ??
+            (this._pathstr = this.path.map(p => p.replaceAll('.', '\\.')).join('.'));
+    }
+}
+exports.AontuContext = AontuContext;
+//# sourceMappingURL=ctx.js.map

package/dist/ctx.js.map

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

package/dist/err.d.ts

@@ -0,0 +1,12 @@
+import { Val, ErrContext } from './type';
+import { AontuContext } from './ctx';
+import { NilVal } from './val/NilVal';
+declare function getHint(why: any): string | undefined;
+declare function makeNilErr(ctx?: AontuContext, why?: any, av?: Val, bv?: Val, attempt?: string): NilVal;
+declare function descErr<NILS extends NilVal | NilVal[]>(err: NILS | any, errctx?: ErrContext): any;
+declare class AontuError extends Error {
+    aontu: boolean;
+    constructor(msg: string, errs?: NilVal[]);
+    errs: () => NilVal[];
+}
+export { getHint, makeNilErr, descErr, AontuError, };

package/dist/err.js

@@ -0,0 +1,123 @@
+"use strict";
+/* Copyright (c) 2021-2025 Richard Rodger, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AontuError = void 0;
+exports.getHint = getHint;
+exports.makeNilErr = makeNilErr;
+exports.descErr = descErr;
+const jsonic_1 = require("jsonic");
+const NilVal_1 = require("./val/NilVal");
+const hints_1 = require("./hints");
+const { errmsg } = jsonic_1.util;
+function getHint(why) {
+    if (hints_1.hints[why]) {
+        return hints_1.hints[why];
+    }
+    return undefined;
+}
+function makeNilErr(ctx, why, av, bv, attempt) {
+    const nilval = NilVal_1.NilVal.make(ctx, why, av, bv, attempt);
+    return nilval;
+}
+// TODO: move to utility?
+function descErr(err, errctx) {
+    if (err?.isNil) {
+        if (null == err.msg || '' === err.msg) {
+            let v1 = err.primary;
+            let v2 = err.secondary;
+            let v1src = resolveSrc(v1, errctx);
+            let v2src = resolveSrc(v2, errctx);
+            let path = ['$', ...err.path].filter((p) => null != p && '' != p);
+            let valpath = (0 < path.length ? path.join('.') : '');
+            let attempt = null != err.attempt ? err.attempt : (null == v2 ? 'resolve' : 'unify');
+            err.msg = [
+                errmsg({
+                    color: { active: true },
+                    name: 'aontu',
+                    code: err.why,
+                    txts: {
+                        msg: 'Cannot ' +
+                            attempt +
+                            ' value' + (null == v2 ? '' : 's') +
+                            ' at path ' + valpath,
+                        hint: getHint(err.why)
+                    }
+                }),
+                '\n',
+                (null != v1 && errmsg({
+                    // TODO: color should come from jsonic config
+                    color: { active: true, line: '\x1b[34m' },
+                    txts: {
+                        msg: 'Cannot ' + attempt + ' value: ' + v1.canon +
+                            (null == v2 ? '' : ' with value: ' + v2.canon), // + ' #' + err.id,
+                        site: ''
+                    },
+                    smsg: 'value was: ' + v1.canon,
+                    file: resolveFile(v1.site.url),
+                    src: v1src,
+                    row: v1.site.row,
+                    col: v1.site.col,
+                })),
+                (null != v2 && errmsg({
+                    // TODO: color should come from jsonic config
+                    color: { active: true, line: '\x1b[34m' },
+                    txts: {
+                        msg: 'Cannot ' + attempt + ' value: ' + v2.canon +
+                            ' with value: ' + v1.canon, // + ' #' + err.id,
+                        site: ''
+                    },
+                    smsg: 'value was: ' + v2.canon,
+                    file: resolveFile(v2.site.url),
+                    src: v2src,
+                    row: v2.site.row,
+                    col: v2.site.col,
+                })),
+            ]
+                .filter((n) => null != n && false !== n)
+                .join('\n')
+                // TODO: update jsonic errmsg to avoid multiple empty lines
+                .replace(/\n\n/g, '\n');
+        }
+        return err;
+    }
+    else {
+        return err.map((n) => descErr(n, errctx));
+    }
+}
+function resolveFile(url) {
+    const cwd = process.cwd();
+    let out = url?.replace(cwd + '/', '') ?? '<no-file>';
+    out = out === cwd || '' === out ? '<no-file>' : out;
+    return out;
+}
+function resolveSrc(v, errctx) {
+    let src = undefined;
+    if (null != v?.site.url) {
+        try {
+            const fileExists = errctx?.fs?.existsSync(v.site.url);
+            if (fileExists) {
+                src = errctx?.fs?.readFileSync(v.site.url, 'utf8') ?? undefined;
+            }
+        }
+        catch (fe) {
+            // ignore as more important to report original error
+        }
+    }
+    if (errctx && (undefined == src || '' === src)) {
+        src = errctx.src ?? '';
+    }
+    return src;
+}
+class AontuError extends Error {
+    constructor(msg, errs) {
+        super(msg);
+        this.aontu = true;
+        this.name = this.constructor.name;
+        this.errs = () => errs ?? [];
+        this.stack = this.stack?.split('\n')
+            .filter(line => !line.match(/aontu\/(src|dist)\//))
+            .join('\n');
+    }
+}
+exports.AontuError = AontuError;
+//# sourceMappingURL=err.js.map

package/dist/err.js.map

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

package/dist/hints.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error code hints for Aontu unification errors.
+ *
+ * Each key is an error code that can be passed to makeNilErr.
+ * Each value is a human-readable explanation of what the error means.
+ */
+declare const hints: Record<string, string>;
+export { hints, };

package/dist/hints.js

@@ -0,0 +1,90 @@
+"use strict";
+/* Copyright (c) 2025 Richard Rodger, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hints = void 0;
+/**
+ * Error code hints for Aontu unification errors.
+ *
+ * Each key is an error code that can be passed to makeNilErr.
+ * Each value is a human-readable explanation of what the error means.
+ */
+const hints = {
+    scalar_value: 'Literal scalar values of the same kind can only unify if they are\n' +
+        'exactly equal.' +
+        '\n \nExamples:\n' +
+        '  1 & 1   -> 1    # Does unify (equal Integers);\n' +
+        '  a & a   -> a    # Does unify (equal Strings);\n' +
+        '  1 & 2   -> nil  # Does not unify (unequal Integers);\n' +
+        '  1 & 1.0 -> nil  # Does not unify (kinds: Integer & Number).',
+    scalar_kind: 'Literal scalar values of different kinds cannot unify.' +
+        '\n \nExamples:\n' +
+        '  1 & 1   -> 1    # Does unify (equal Integers);\n' +
+        '  1 & a   -> nil  # Does not unify (Kinds: Integer & String);\n' +
+        '  1 & 1.0 -> nil  # Does not unify (kinds: Integer & Number).',
+    nil_gen: 'The nil value was present after unification, and nil cannot be\n' +
+        'generated because nil is not a literal value.',
+    no_gen: 'This value was present after unification, and cannot be generated\n' +
+        'because it is not a literal value.',
+    // TODO: extend errors to have details so we can name the key
+    mapval_required: 'This map value is required.',
+    mapval_no_gen: 'This value was present after unification, and cannot be generated\n' +
+        'because it is not a literal value.',
+    listval_required: 'This list element is required.',
+    listval_no_gen: 'This list element was present after unification, and cannot be generated\n' +
+        'because it is not a literal value.',
+    unknown_function: 'This function name is not recognized.',
+    literal_nil: 'A literal nil cannot unify with any other value.',
+    unify_cycle: 'Circular reference detected during unification.',
+    conjunct: 'This conjunction (& operator) could not be completed as some terms\n' +
+        'could not be resolved.',
+    no_path: 'The path reference could not be found.' +
+        '\n \nExamples:\n' +
+        '  a:1 b:$.a  -> a:1,b:1  # $.a is a valid path reference as a is a key of root ($).\n' +
+        '  a:$.b      -> nil      # $.b is not a valid path reference as there is no key b in root ($).\n',
+    // Parsing errors
+    'parse_bad_src': 'Invalid source provided for parsing. The source must be a non-empty string.',
+    // Unification errors
+    'unify_no_src': 'No source provided for unification. Cannot unify without source values.',
+    'unify_no_res': 'Unification produced no result. The values could not be unified.',
+    'unite': 'Failed to unite two values. The values are incompatible and cannot be unified.',
+    'internal': 'Internal error during unification. This indicates an unexpected error in the unification process.',
+    // Type mismatch errors
+    'scalar-type': 'Scalar type mismatch. The scalar types are incompatible.',
+    'no-scalar-unify': 'Cannot unify scalar values. The scalar values have incompatible types.',
+    'not-scalar-type': 'Expected a scalar type but got a non-scalar type.',
+    'map': 'Type mismatch: expected a map value but got a different type.',
+    'list': 'Type mismatch: expected a list value but got a different type.',
+    // Argument errors
+    'arg': 'Missing required argument. A function requires an argument but none was provided.',
+    'invalid-arg': 'Invalid argument provided. The argument does not match the expected type or format.',
+    'no_first_arg': 'Missing first argument. The function requires a first argument but none was provided.',
+    // Variable errors
+    'unknown_var': 'Unknown variable reference. The variable has not been defined.',
+    'invalid_var_kind': 'Invalid variable kind. The variable type does not match the expected kind.',
+    // Path and reference errors
+    path_cycle: 'Path cycle detected. The path contains a circular reference.',
+    'ref': 'Reference resolution failed. Unable to resolve the reference to a value.',
+    // Closure and state errors
+    'closed': 'Cannot add to closed structure. The map or list is closed and does not accept new keys/elements.',
+    'required_listelem': 'Required list element is missing. A non-optional list element has no value.',
+    // Junction errors (disjunction/conjection)
+    '|:empty': 'Empty disjunction. The disjunction has no valid alternatives.',
+    '|:empty-dist': 'Empty disjunction distribution. All alternatives in the disjunction are invalid.',
+    // Function errors (dynamic patterns)
+    'func': 'Function operation failed. See the specific function name for details.',
+    'make': 'Failed to create a new value. The make operation could not construct the value.',
+    'resolve': 'Failed to resolve a value. The resolution process could not find or compute the value.',
+    'operate': 'Operation failed. The operation could not be performed on the given values.',
+    // Operator errors (dynamic patterns)
+    'op': 'Operator operation failed. See the specific operator name for details.',
+    // Close operation
+    'close': 'Failed to close structure. The structure could not be closed.',
+    // Dynamic patterns (these serve as prefixes)
+    'func:': 'Function error: ',
+    'op:': 'Operator error: ',
+    'var[': 'Variable type error: ',
+    'ref[': 'Reference error: ',
+    'op[': 'Operator value error: ',
+};
+exports.hints = hints;
+//# sourceMappingURL=hints.js.map

package/dist/hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../src/hints.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD;;;;;GAKG;AAEH,MAAM,KAAK,GAA2B;IAEpC,YAAY,EACV,qEAAqE;QACrE,gBAAgB;QAChB,kBAAkB;QAClB,oDAAoD;QACpD,mDAAmD;QACnD,0DAA0D;QAC1D,+DAA+D;IAEjE,WAAW,EACT,wDAAwD;QACxD,kBAAkB;QAClB,oDAAoD;QACpD,iEAAiE;QACjE,+DAA+D;IAEjE,OAAO,EACL,kEAAkE;QAClE,+CAA+C;IAEjD,MAAM,EACJ,qEAAqE;QACrE,oCAAoC;IAGtC,6DAA6D;IAC7D,eAAe,EAAE,6BAA6B;IAE9C,aAAa,EACX,qEAAqE;QACrE,oCAAoC;IAEtC,gBAAgB,EAAE,gCAAgC;IAElD,cAAc,EACZ,4EAA4E;QAC5E,oCAAoC;IAEtC,gBAAgB,EACd,uCAAuC;IAEzC,WAAW,EACT,kDAAkD;IAEpD,WAAW,EAAE,iDAAiD;IAE9D,QAAQ,EACN,sEAAsE;QACtE,wBAAwB;IAE1B,OAAO,EAAE,wCAAwC;QAC/C,kBAAkB;QAClB,uFAAuF;QACvF,kGAAkG;IAEpG,iBAAiB;IACjB,eAAe,EAAE,6EAA6E;IAE9F,qBAAqB;IACrB,cAAc,EAAE,yEAAyE;IACzF,cAAc,EAAE,kEAAkE;IAClF,OAAO,EAAE,gFAAgF;IAEzF,UAAU,EAAE,mGAAmG;IAE/G,uBAAuB;IAEvB,aAAa,EAAE,0DAA0D;IACzE,iBAAiB,EAAE,wEAAwE;IAC3F,iBAAiB,EAAE,mDAAmD;IACtE,KAAK,EAAE,+DAA+D;IACtE,MAAM,EAAE,gEAAgE;IAExE,kBAAkB;IAClB,KAAK,EAAE,mFAAmF;IAC1F,aAAa,EAAE,qFAAqF;IACpG,cAAc,EAAE,uFAAuF;IAEvG,kBAAkB;IAClB,aAAa,EAAE,gEAAgE;IAC/E,kBAAkB,EAAE,4EAA4E;IAEhG,4BAA4B;IAC5B,UAAU,EAAE,8DAA8D;IAC1E,KAAK,EAAE,0EAA0E;IAEjF,2BAA2B;IAC3B,QAAQ,EAAE,kGAAkG;IAC5G,mBAAmB,EAAE,6EAA6E;IAElG,2CAA2C;IAC3C,SAAS,EAAE,+DAA+D;IAC1E,cAAc,EAAE,kFAAkF;IAElG,qCAAqC;IACrC,MAAM,EAAE,wEAAwE;IAChF,MAAM,EAAE,iFAAiF;IACzF,SAAS,EAAE,wFAAwF;IACnG,SAAS,EAAE,6EAA6E;IAExF,qCAAqC;IACrC,IAAI,EAAE,wEAAwE;IAE9E,kBAAkB;IAClB,OAAO,EAAE,+DAA+D;IAExE,6CAA6C;IAC7C,OAAO,EAAE,kBAAkB;IAC3B,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,uBAAuB;IAC/B,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,wBAAwB;CAChC,CAAA;AAIC,sBAAK"}

package/dist/lang.d.ts

@@ -0,0 +1,11 @@
+import { Jsonic } from 'jsonic';
+import type { Val, AontuOptions } from './type';
+import { Site } from './site';
+declare class Lang {
+    jsonic: Jsonic;
+    opts: AontuOptions;
+    idcount: number | undefined;
+    constructor(options?: Partial<AontuOptions>);
+    parse(src: string, opts?: Partial<AontuOptions>): Val;
+}
+export { Lang, Site, };