@k8ts/instruments 0.1.0

package/dist/api-kind/index.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Kind = void 0;
+exports.kinded = kinded;
+const immutable_1 = require("immutable");
+const error_1 = require("../error");
+var Kind;
+(function (Kind_1) {
+    class Identifier {
+        constructor(name, parent) {
+            this.name = name;
+            this.parent = parent;
+            this.toString = () => this.text;
+        }
+        get text() {
+            return [this.parent?.text, this.name].filter(Boolean).join("/");
+        }
+        equals(other) {
+            if (typeof other !== "object" || !other) {
+                return false;
+            }
+            if (!(other instanceof Identifier)) {
+                return false;
+            }
+            return this.text === other.text;
+        }
+        hashCode() {
+            return (0, immutable_1.hash)(this.text);
+        }
+    }
+    Kind_1.Identifier = Identifier;
+    class Group extends Identifier {
+        constructor(name) {
+            super(name, null);
+            this.name = name;
+        }
+        version(apiVersion) {
+            return new Version(apiVersion, this);
+        }
+        child(name) {
+            if (!name.startsWith("v")) {
+                throw new error_1.InstrumentsError(`Invalid version name "${name}". Version name must start with "v".`);
+            }
+            return this.version(name);
+        }
+    }
+    Kind_1.Group = Group;
+    class Version extends Identifier {
+        kind(kind) {
+            return new Kind(kind, this);
+        }
+        get group() {
+            return this.parent;
+        }
+        child(name) {
+            return this.kind(name);
+        }
+    }
+    Kind_1.Version = Version;
+    class Kind extends Identifier {
+        get version() {
+            return this.parent;
+        }
+        get group() {
+            return this.parent?.parent;
+        }
+        subkind(subkind) {
+            return new SubKind(subkind, this);
+        }
+        child(name) {
+            return this.subkind(name);
+        }
+    }
+    Kind_1.Kind = Kind;
+    class SubKind extends Identifier {
+        constructor(name, parent) {
+            super(name, parent);
+        }
+        subkind(subkind) {
+            throw new error_1.InstrumentsError(`SubKind "${this.text}" cannot have subkind "${subkind}".`);
+        }
+        child(name) {
+            return this.subkind(name);
+        }
+    }
+    Kind_1.SubKind = SubKind;
+    function group(apiGroup) {
+        return new Group(apiGroup);
+    }
+    Kind_1.group = group;
+    function version(apiVersion) {
+        return new Version(apiVersion, group(""));
+    }
+    Kind_1.version = version;
+})(Kind || (exports.Kind = Kind = {}));
+function kinded(kind) {
+    return (ctor) => {
+        ctor.prototype.kind = kind;
+        return ctor;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/api-kind/index.js.map

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

package/dist/cmd/cli-command.d.ts

@@ -0,0 +1,23 @@
+import { List } from "immutable";
+import { type CliTerm, type ValueTermJoiner } from "./cli-term";
+import type { CliArgsMapping, CliKey } from "./types";
+export interface CliCommandBuilderOptions {
+    joiner: ValueTermJoiner;
+}
+export declare class CmdBuilder {
+    readonly executable: string;
+    private readonly _terms;
+    private readonly _options;
+    protected constructor(executable: string, _terms: List<CliTerm>, _options: CliCommandBuilderOptions);
+    private _withArgs;
+    private _withOptions;
+    flag(...flags: CliKey[]): CmdBuilder;
+    verbatim(...values: string[]): CmdBuilder;
+    option(args: CliArgsMapping): CmdBuilder;
+    joiner(joiner: ValueTermJoiner): CmdBuilder;
+    toArray(): string[];
+    toString(): string;
+    static make(executable: string, options: CliCommandBuilderOptions): CmdBuilder;
+}
+export declare function Cmd(executable: string, options?: Partial<CliCommandBuilderOptions>): CmdBuilder;
+//# sourceMappingURL=cli-command.d.ts.map

package/dist/cmd/cli-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.ts","sourceRoot":"","sources":["../../src/cmd/cli-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAO,MAAM,WAAW,CAAA;AAErC,OAAO,EAIH,KAAK,OAAO,EACZ,KAAK,eAAe,EACvB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErD,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,eAAe,CAAA;CAC1B;AAED,qBAAa,UAAU;IAEf,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAH7B,SAAS,aACI,UAAU,EAAE,MAAM,EACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EACrB,QAAQ,EAAE,wBAAwB;IAGvD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAIpB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE;IAKvB,QAAQ,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE;IAK5B,MAAM,CAAC,IAAI,EAAE,cAAc;IAiB3B,MAAM,CAAC,MAAM,EAAE,eAAe;IAI9B,OAAO;IAWP,QAAQ;IAIR,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB;CAGpE;AAMD,wBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,cAGlF"}

package/dist/cmd/cli-command.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CmdBuilder = void 0;
+exports.Cmd = Cmd;
+const immutable_1 = require("immutable");
+const lodash_1 = require("lodash");
+const cli_term_1 = require("./cli-term");
+class CmdBuilder {
+    constructor(executable, _terms, _options) {
+        this.executable = executable;
+        this._terms = _terms;
+        this._options = _options;
+    }
+    _withArgs(f) {
+        return new CmdBuilder(this.executable, f(this._terms), this._options);
+    }
+    _withOptions(f) {
+        return new CmdBuilder(this.executable, this._terms, f(this._options));
+    }
+    flag(...flags) {
+        const flagTerms = flags.map(flag => new cli_term_1.CliFlag(flag));
+        return this._withArgs(terms => terms.concat(flagTerms));
+    }
+    verbatim(...values) {
+        const verbatimTerms = values.map(value => new cli_term_1.VerbatimTerm(value));
+        return this._withArgs(terms => terms.concat(verbatimTerms));
+    }
+    option(args) {
+        const map = (0, immutable_1.Map)(args);
+        const optionTerms = map.entrySeq().map(([key, value]) => {
+            let joiner;
+            const lastChar = key.at(-1);
+            if (lastChar === "=") {
+                joiner = "=";
+                key = key.slice(0, -1);
+            }
+            else if (lastChar === " ") {
+                joiner = " ";
+                key = key.slice(0, -1);
+            }
+            return new cli_term_1.CliOptionValue(key, joiner, value);
+        });
+        return this._withArgs(terms => terms.concat(optionTerms));
+    }
+    joiner(joiner) {
+        return this._withOptions(options => (0, lodash_1.merge)({}, options, { joiner: joiner }));
+    }
+    toArray() {
+        const terms = this._terms
+            .filter(x => !x.isMissing)
+            .map(term => term.str(this._options.joiner))
+            .toArray();
+        if (this.executable !== "") {
+            terms.unshift(this.executable);
+        }
+        return terms;
+    }
+    toString() {
+        return this.toArray().join(" ");
+    }
+    static make(executable, options) {
+        return new CmdBuilder(executable, (0, immutable_1.List)(), options);
+    }
+}
+exports.CmdBuilder = CmdBuilder;
+const defaultOptions = {
+    joiner: " "
+};
+function Cmd(executable, options) {
+    options = (0, lodash_1.defaultsDeep)({}, options, defaultOptions);
+    return CmdBuilder.make(executable, options);
+}
+//# sourceMappingURL=cli-command.js.map

package/dist/cmd/cli-command.js.map

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

package/dist/cmd/cli-term.d.ts

@@ -0,0 +1,25 @@
+import type { CliValue } from "./types";
+export declare class CliFlag {
+    readonly key: string;
+    constructor(key: string);
+    str(joiner: string): string;
+    get isMissing(): boolean;
+}
+export type ValueTermJoiner = "=" | " ";
+export declare class CliOptionValue {
+    private readonly key;
+    private readonly overrideTermJoiner;
+    private readonly value;
+    constructor(key: string, overrideTermJoiner: string | undefined, value: CliValue);
+    get isMissing(): boolean;
+    private _valueStr;
+    str(joiner: string): string;
+}
+export declare class VerbatimTerm {
+    readonly value: string;
+    constructor(value: string);
+    str(joiner: string): string;
+    get isMissing(): boolean;
+}
+export type CliTerm = CliFlag | CliOptionValue | VerbatimTerm;
+//# sourceMappingURL=cli-term.d.ts.map

package/dist/cmd/cli-term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-term.d.ts","sourceRoot":"","sources":["../../src/cmd/cli-term.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,qBAAa,OAAO;IACJ,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;IAEhC,GAAG,CAAC,MAAM,EAAE,MAAM;IAIlB,IAAI,SAAS,YAEZ;CACJ;AAED,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,CAAA;AAEvC,qBAAa,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,QAAQ;IAGpC,IAAI,SAAS,YAEZ;IAED,OAAO,CAAC,SAAS;IAUjB,GAAG,CAAC,MAAM,EAAE,MAAM;CAOrB;AAED,qBAAa,YAAY;IACT,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,GAAG,CAAC,MAAM,EAAE,MAAM;IAIlB,IAAI,SAAS,YAEZ;CACJ;AAED,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,CAAA"}

package/dist/cmd/cli-term.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerbatimTerm = exports.CliOptionValue = exports.CliFlag = void 0;
+const error_1 = require("../error");
+class CliFlag {
+    constructor(key) {
+        this.key = key;
+    }
+    str(joiner) {
+        return this.key;
+    }
+    get isMissing() {
+        return false;
+    }
+}
+exports.CliFlag = CliFlag;
+class CliOptionValue {
+    constructor(key, overrideTermJoiner, value) {
+        this.key = key;
+        this.overrideTermJoiner = overrideTermJoiner;
+        this.value = value;
+    }
+    get isMissing() {
+        return this.value === null;
+    }
+    _valueStr() {
+        if (this.value === null) {
+            throw new Error("Shouldn't be here");
+        }
+        if (this.value === "") {
+            return `""`;
+        }
+        return `${this.value}`;
+    }
+    str(joiner) {
+        if (this.value === undefined) {
+            throw new error_1.InstrumentsError("CliOptionValue cannot be undefined, use null instead");
+        }
+        return [this.key, this._valueStr()].join(this.overrideTermJoiner ?? joiner);
+    }
+}
+exports.CliOptionValue = CliOptionValue;
+class VerbatimTerm {
+    constructor(value) {
+        this.value = value;
+    }
+    str(joiner) {
+        return this.value;
+    }
+    get isMissing() {
+        return false;
+    }
+}
+exports.VerbatimTerm = VerbatimTerm;
+//# sourceMappingURL=cli-term.js.map

package/dist/cmd/cli-term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-term.js","sourceRoot":"","sources":["../../src/cmd/cli-term.ts"],"names":[],"mappings":";;;AAAA,oCAA2C;AAG3C,MAAa,OAAO;IAChB,YAAqB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEpC,GAAG,CAAC,MAAc;QACd,OAAO,IAAI,CAAC,GAAG,CAAA;IACnB,CAAC;IAED,IAAI,SAAS;QACT,OAAO,KAAK,CAAA;IAChB,CAAC;CACJ;AAVD,0BAUC;AAID,MAAa,cAAc;IACvB,YACqB,GAAW,EACX,kBAAsC,EACtC,KAAe;QAFf,QAAG,GAAH,GAAG,CAAQ;QACX,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,UAAK,GAAL,KAAK,CAAU;IACjC,CAAC;IAEJ,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAA;IAC9B,CAAC;IAEO,SAAS;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YACpB,OAAO,IAAI,CAAA;QACf,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,MAAc;QACd,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,wBAAgB,CAAC,sDAAsD,CAAC,CAAA;QACtF,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAA;IAC/E,CAAC;CACJ;AA5BD,wCA4BC;AAED,MAAa,YAAY;IACrB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,GAAG,CAAC,MAAc;QACd,OAAO,IAAI,CAAC,KAAK,CAAA;IACrB,CAAC;IAED,IAAI,SAAS;QACT,OAAO,KAAK,CAAA;IAChB,CAAC;CACJ;AAVD,oCAUC"}

package/dist/cmd/index.d.ts

@@ -0,0 +1,3 @@
+export { Cmd, CmdBuilder } from "./cli-command";
+export { CliArgsMapping, CliKey, CliValue } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/cmd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cmd/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/cmd/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CmdBuilder = exports.Cmd = void 0;
+var cli_command_1 = require("./cli-command");
+Object.defineProperty(exports, "Cmd", { enumerable: true, get: function () { return cli_command_1.Cmd; } });
+Object.defineProperty(exports, "CmdBuilder", { enumerable: true, get: function () { return cli_command_1.CmdBuilder; } });
+//# sourceMappingURL=index.js.map

package/dist/cmd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cmd/index.ts"],"names":[],"mappings":";;;AAAA,6CAA+C;AAAtC,kGAAA,GAAG,OAAA;AAAE,yGAAA,UAAU,OAAA"}

package/dist/cmd/types.d.ts

@@ -0,0 +1,5 @@
+export type CliKey = `-${string}` | `--${string}`;
+export type InputCliKey = `${CliKey}=` | `${CliKey} ` | CliKey;
+export type CliValue = string | number | boolean | null | `${string}` | ` ${string}`;
+export type CliArgsMapping = Record<InputCliKey, CliValue>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cmd/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cmd/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,CAAA;AACjD,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,MAAM,CAAA;AAC9D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAA;AACpF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA"}

package/dist/cmd/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cmd/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cmd/types.ts"],"names":[],"mappings":""}

package/dist/displayers/displayers.d.ts

@@ -0,0 +1,33 @@
+export type KnownFormats = "local" | "global" | undefined;
+export declare namespace Displayers {
+    interface Out {
+        default: (format?: string) => string;
+        simple: (format?: KnownFormats | string) => string;
+        pretty: (format?: KnownFormats | string) => string;
+        prefix?: () => string;
+    }
+    type In<Target extends object = object> = {
+        simple?: (this: Out, self: Target, format?: string) => string | object;
+        pretty?: (this: Out, self: Target, format?: string) => string | object;
+        prefix?: (this: Out, self: Target) => string;
+    };
+    type Modes = keyof In;
+}
+declare class DisplayerDecorator {
+    private _system;
+    private _lastMode;
+    private _withLastMode;
+    implement(ctor: abstract new (...args: any[]) => object, input: Displayers.In): void;
+    wrapRecursiveFallback(out: Displayers.Out): Displayers.Out;
+    tryGet(target: any): Displayers.Out | undefined;
+    get(target: object): Displayers.Out;
+    get decorator(): (<Target extends abstract new (...args: any[]) => object, Impl extends Displayers.In<InstanceType<Target>>>(input: Impl) => (ctor: Target) => Target) & {
+        get: (target: object) => Displayers.Out;
+    };
+}
+export declare const Displayers: DisplayerDecorator;
+export declare const displayers: (<Target extends abstract new (...args: any[]) => object, Impl extends Displayers.In<InstanceType<Target>>>(input: Impl) => (ctor: Target) => Target) & {
+    get: (target: object) => Displayers.Out;
+};
+export {};
+//# sourceMappingURL=displayers.d.ts.map

package/dist/displayers/displayers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayers.d.ts","sourceRoot":"","sources":["../../src/displayers/displayers.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AACzD,yBAAiB,UAAU,CAAC;IACxB,UAAiB,GAAG;QAChB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;QACpC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,KAAK,MAAM,CAAA;QAClD,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,KAAK,MAAM,CAAA;QAClD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;KACxB;IACD,KAAY,EAAE,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;QAC7C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAA;QACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAA;QACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;KAC/C,CAAA;IACD,KAAY,KAAK,GAAG,MAAM,EAAE,CAAA;CAC/B;AAID,cAAM,kBAAkB;IACpB,OAAO,CAAC,OAAO,CAAoD;IACnE,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa;IASrB,SAAS,CAAC,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE;IAkB7E,qBAAqB,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG;IAiCzC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,UAAU,CAAC,GAAG,GAAG,SAAS;IAmC/C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAKnC,IAAI,SAAS,MAGD,MAAM,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EACtD,IAAI,SAAS,UAAU,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,SAEzC,IAAI,YAEG,MAAM;sBAMN,MAAM,KAAG,UAAU,CAAC,GAAG;MAKhD;CACJ;AACD,eAAO,MAAM,UAAU,oBAA2B,CAAA;AAClD,eAAO,MAAM,UAAU,IAnBP,MAAM,gCAAgC,GAAG,EAAE,KAAK,MAAM,EACtD,IAAI;kBAUU,MAAM,KAAG,UAAU,CAAC,GAAG;CAQP,CAAA"}

package/dist/displayers/displayers.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayers = exports.Displayers = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const _embedder_1 = require("../_embedder");
+const chalkNoColor = new chalk_1.default.Instance({
+    level: 0
+});
+class DisplayerDecorator {
+    constructor() {
+        this._system = new _embedder_1.Embedder("displayers");
+        this._lastMode = "simple";
+    }
+    _withLastMode(mode, fn) {
+        return (...args) => {
+            const oldMode = this._lastMode;
+            this._lastMode = mode;
+            const result = fn(...args);
+            this._lastMode = oldMode;
+            return result;
+        };
+    }
+    implement(ctor, input) {
+        this._system.set(ctor.prototype, input);
+        const decorator = this;
+        Object.defineProperties(ctor.prototype, {
+            [Symbol.toStringTag]: {
+                get() {
+                    const a = decorator.get(this);
+                    return a.default();
+                }
+            },
+            toString: {
+                value() {
+                    return this[Symbol.toStringTag];
+                }
+            }
+        });
+    }
+    wrapRecursiveFallback(out) {
+        const oAny = out;
+        const self = this;
+        for (const k in out) {
+            const orig = oAny[k];
+            if (typeof orig === "function") {
+                oAny[k] = function (...args) {
+                    const oldMode = self._lastMode;
+                    if (k === "simple" || k === "pretty") {
+                        self._lastMode = k;
+                    }
+                    try {
+                        let result = orig.call(oAny, ...args);
+                        if (!Array.isArray(result)) {
+                            result = [result];
+                        }
+                        const terms = result.map((x) => {
+                            const sndDisplayers = exports.Displayers.tryGet(x);
+                            if (sndDisplayers) {
+                                return sndDisplayers[k].call(sndDisplayers, x, ...args);
+                            }
+                            return x;
+                        });
+                        return terms.join(" ");
+                    }
+                    finally {
+                        this._lastMode = oldMode;
+                    }
+                };
+            }
+        }
+        return out;
+    }
+    tryGet(target) {
+        if (typeof target !== "object") {
+            return undefined;
+        }
+        const input = this._system.get(target);
+        if (!input) {
+            return undefined;
+        }
+        const o = {
+            default: (format) => {
+                const lastMode = this._lastMode;
+                const result = o[lastMode]?.call(o, format) ?? o.simple(format);
+                return result;
+            },
+            simple: format => {
+                const result = input.simple?.call(o, target, format);
+                if (!result) {
+                    const pretty = input.pretty?.call(o, target, format);
+                    if (typeof pretty === "string") {
+                        return chalkNoColor(pretty);
+                    }
+                    return "?!!?";
+                }
+                return result;
+            },
+            prefix: input.prefix && (() => input.prefix.call(o, target)),
+            pretty: format => {
+                return (input.pretty?.call(o, target, format) ??
+                    input.simple?.call(o, target, format) ??
+                    "?!?");
+            }
+        };
+        return this.wrapRecursiveFallback(o);
+    }
+    get(target) {
+        this._system.get(target); // error if not there
+        return this.tryGet(target);
+    }
+    get decorator() {
+        return Object.assign((input) => {
+            return (ctor) => {
+                this.implement(ctor, input);
+                return ctor;
+            };
+        }, {
+            get: (target) => {
+                return this.get(target);
+            }
+        });
+    }
+}
+exports.Displayers = new DisplayerDecorator();
+exports.displayers = exports.Displayers.decorator;
+//# sourceMappingURL=displayers.js.map

package/dist/displayers/displayers.js.map

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

package/dist/displayers/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./displayers";
+//# sourceMappingURL=index.d.ts.map

package/dist/displayers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/displayers/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/dist/displayers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./displayers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/displayers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/displayers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B"}

package/dist/env/env.d.ts

@@ -0,0 +1,20 @@
+import { type MapOf } from "immutable";
+import type { InputEnv, InputEnvMapping } from "./types";
+type _EnvBuilderMap = MapOf<InputEnvMapping>;
+export declare class EnvBuilder {
+    private readonly _env;
+    constructor(_env: _EnvBuilderMap);
+    get values(): _EnvBuilderMap;
+    private _withEnv;
+    add(name: string, value: string): EnvBuilder;
+    add(input: InputEnvMapping): EnvBuilder;
+    overwrite(name: string, value: string): EnvBuilder;
+    overwrite(input: InputEnvMapping): EnvBuilder;
+    toObject(): {
+        [key: string]: string;
+    };
+    static make(env?: InputEnv): EnvBuilder;
+}
+export declare function Env(env?: InputEnvMapping): EnvBuilder;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGxD,KAAK,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC,CAAA;AAC5C,qBAAa,UAAU;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAUjD,IAAI,MAAM,mBAET;IAED,OAAO,CAAC,QAAQ;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;IAC5C,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAgBvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;IAClD,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAU7C,QAAQ;;;IAOR,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ;CAS7B;AAED,wBAAgB,GAAG,CAAC,GAAG,CAAC,EAAE,eAAe,cAExC"}

package/dist/env/env.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvBuilder = void 0;
+exports.Env = Env;
+const immutable_1 = require("immutable");
+const error_1 = require("../error");
+const validate_name_1 = require("./validate-name");
+class EnvBuilder {
+    constructor(_env) {
+        this._env = _env;
+        for (const key of _env.keys()) {
+            if (!(0, validate_name_1.isValidEnvVarName)(key)) {
+                throw new error_1.InstrumentsError("Invalid environment variable name", {
+                    key: key
+                });
+            }
+        }
+    }
+    get values() {
+        return this._env;
+    }
+    _withEnv(f) {
+        return new EnvBuilder(f(this._env));
+    }
+    add(a, b) {
+        const pairs = typeof a === "string" ? [[a, b]] : Object.entries(a);
+        const map = (0, immutable_1.Map)(pairs);
+        const existingKeys = map
+            .keySeq()
+            .filter(k => this._env.has(k))
+            .toList();
+        if (existingKeys.size > 0) {
+            throw new error_1.InstrumentsError("Cannot overwrite existing keys using add", {
+                keys: existingKeys.toArray()
+            });
+        }
+        return this._withEnv(env => env.merge(map));
+    }
+    overwrite(a, b) {
+        if (typeof a === "string") {
+            return this._withEnv(env => env.set(a, b));
+        }
+        else {
+            const map = (0, immutable_1.Map)(a);
+            return this._withEnv(env => env.merge(map));
+        }
+    }
+    toObject() {
+        return this._env
+            .filter(v => v != null)
+            .map(x => `${x}`)
+            .toObject();
+    }
+    static make(env) {
+        if (!env) {
+            return new EnvBuilder((0, immutable_1.Map)({}));
+        }
+        if (env instanceof EnvBuilder) {
+            return env;
+        }
+        return new EnvBuilder((0, immutable_1.Map)(env ?? {}).filter(v => v != null));
+    }
+}
+exports.EnvBuilder = EnvBuilder;
+function Env(env) {
+    return EnvBuilder.make(env);
+}
+//# sourceMappingURL=env.js.map