ticbuild 1.0.0

package/dist/utils/encoding/codecRegistry.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kSourceEncoding = void 0;
+exports.resolveSourceEncoding = resolveSourceEncoding;
+exports.decodeSourceDataFromBytes = decodeSourceDataFromBytes;
+exports.decodeSourceDataFromString = decodeSourceDataFromString;
+exports.encodeBinaryToString = encodeBinaryToString;
+exports.isStringSourceEncoding = isStringSourceEncoding;
+const enum_1 = require("../enum");
+const b85_1 = require("./b85");
+const hex_1 = require("./hex");
+const lz_1 = require("./lz");
+exports.kSourceEncoding = (0, enum_1.defineEnum)({
+    raw: { value: "raw", input: "bytes" },
+    lz: { value: "lz", input: "bytes" },
+    hex: { value: "hex", input: "string" },
+    "b85+1": { value: "b85+1", input: "string" },
+    "lz85+1": { value: "lz85+1", input: "string" },
+});
+const sourceEncodings = {
+    raw: {
+        key: "raw",
+        input: "bytes",
+        decodeFromBytes: (data) => data,
+    },
+    lz: {
+        key: "lz",
+        input: "bytes",
+        decodeFromBytes: (data) => (0, lz_1.lzDecompress)(data),
+    },
+    hex: {
+        key: "hex",
+        input: "string",
+        decodeFromString: (text) => (0, hex_1.decodeHexString)(text),
+        encodeToString: (data) => (0, hex_1.encodeHexString)(data),
+    },
+    "b85+1": {
+        key: "b85+1",
+        input: "string",
+        decodeFromString: (text) => (0, b85_1.base85Plus1Decode)(text),
+        encodeToString: (data) => (0, b85_1.base85Plus1Encode)(data),
+    },
+    "lz85+1": {
+        key: "lz85+1",
+        input: "string",
+        decodeFromString: (text) => (0, lz_1.lzDecompress)((0, b85_1.base85Plus1Decode)(text)),
+        encodeToString: (data) => (0, b85_1.base85Plus1Encode)((0, lz_1.lzCompress)(data, lz_1.gSomaticLZDefaultConfig)),
+    },
+};
+function resolveSourceEncoding(encoding) {
+    const info = exports.kSourceEncoding.coerceByKey(encoding);
+    if (!info) {
+        throw new Error(`Unsupported source encoding: ${encoding}`);
+    }
+    return sourceEncodings[info.key];
+}
+function decodeSourceDataFromBytes(encoding, data) {
+    const codec = sourceEncodings[encoding];
+    if (!codec.decodeFromBytes) {
+        throw new Error(`Source encoding ${encoding} expects string input`);
+    }
+    return codec.decodeFromBytes(data);
+}
+function decodeSourceDataFromString(encoding, text) {
+    const codec = sourceEncodings[encoding];
+    if (!codec.decodeFromString) {
+        throw new Error(`Source encoding ${encoding} expects binary input`);
+    }
+    return codec.decodeFromString(text);
+}
+function encodeBinaryToString(encoding, data) {
+    const codec = sourceEncodings[encoding];
+    if (!codec.encodeToString) {
+        throw new Error(`Source encoding ${encoding} does not support string encoding`);
+    }
+    return codec.encodeToString(data);
+}
+function isStringSourceEncoding(encoding) {
+    return sourceEncodings[encoding].input === "string";
+}
+//# sourceMappingURL=codecRegistry.js.map

package/dist/utils/encoding/codecRegistry.js.map

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

package/dist/utils/encoding/hex.d.ts

@@ -0,0 +1,3 @@
+export declare function decodeHexString(input: string): Uint8Array;
+export declare function encodeHexString(data: Uint8Array): string;
+//# sourceMappingURL=hex.d.ts.map

package/dist/utils/encoding/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../src/utils/encoding/hex.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAgBzD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMxD"}

package/dist/utils/encoding/hex.js

@@ -0,0 +1,30 @@
+"use strict";
+// hex encoded string helpers
+// e.g. "4a 6f 68 6e" <--> Uint8Array [0x4a, 0x6f, 0x68, 0x6e]
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeHexString = decodeHexString;
+exports.encodeHexString = encodeHexString;
+function decodeHexString(input) {
+    const trimmed = input.replace(/\s+/g, "");
+    if (trimmed.length % 2 !== 0) {
+        throw new Error(`hex decode: input length ${trimmed.length} is not even`);
+    }
+    const out = new Uint8Array(trimmed.length / 2);
+    for (let i = 0; i < trimmed.length; i += 2) {
+        const byteStr = trimmed.slice(i, i + 2);
+        const value = Number.parseInt(byteStr, 16);
+        if (Number.isNaN(value)) {
+            throw new Error(`hex decode: invalid byte '${byteStr}' at index ${i}`);
+        }
+        out[i / 2] = value;
+    }
+    return out;
+}
+function encodeHexString(data) {
+    let out = "";
+    for (const byte of data) {
+        out += byte.toString(16).padStart(2, "0");
+    }
+    return out;
+}
+//# sourceMappingURL=hex.js.map

package/dist/utils/encoding/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../src/utils/encoding/hex.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,8DAA8D;;AAE9D,0CAgBC;AAED,0CAMC;AAxBD,SAAgB,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,cAAc,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,eAAe,CAAC,IAAgB;IAC9C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/encoding/lz.d.ts

@@ -0,0 +1,12 @@
+export interface LZConfig {
+    windowSize: number;
+    minMatchLength: number;
+    maxMatchLength: number;
+    useRLE: boolean;
+}
+/** ---- Decompress ---- */
+export declare function lzDecompress(encoded: Uint8Array): Uint8Array;
+export declare const gSomaticLZDefaultConfig: LZConfig;
+/** ---- Compress (greedy) ---- */
+export declare function lzCompress(input: Uint8Array, cfg: LZConfig): Uint8Array;
+//# sourceMappingURL=lz.d.ts.map

package/dist/utils/encoding/lz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lz.d.ts","sourceRoot":"","sources":["../../../src/utils/encoding/lz.ts"],"names":[],"mappings":"AA6DA,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAoCD,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAsC5D;AAKD,eAAO,MAAM,uBAAuB,EAAE,QAKrC,CAAC;AAEF,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,GAAG,UAAU,CAkIvE"}

package/dist/utils/encoding/lz.js

@@ -0,0 +1,271 @@
+"use strict";
+/*
+
+Lua reference decoder (peek - poke)
+
+
+
+-- Read unsigned LEB128 varint from memory.
+-- base:   start address of encoded stream
+-- si:     current offset (0-based) into the stream
+-- srcLen: total length of the encoded stream (in bytes)
+-- Returns: value, next_si
+local function varint(base, si, srcLen)
+    local x, f = 0, 1
+    while true do
+        local b = peek(base + si)
+        si = si + 1
+        x = x + (b % 0x80) * f
+        if b < 0x80 then
+            return x, si
+        end
+        f = f * 0x80
+    end
+end
+
+-- LZ-Decompress from [src .. src+srcLen-1] into [dst ..).
+-- Returns number of decompressed bytes written.
+local function lzdm(src, srcLen, dst)
+    local si, di = 0, 0
+    while si < srcLen do
+        local t = peek(src + si)
+        si = si + 1
+        if t == 0 then
+            local l
+            l, si = varint(src, si, srcLen)
+            for j = 1, l do
+                poke(dst + di, peek(src + si))
+                si = si + 1
+                di = di + 1
+            end
+        else
+            local l, d
+            l, si = varint(src, si, srcLen)
+            d, si = varint(src, si, srcLen)
+            for j = 1, l do
+                poke(dst + di, peek(dst + di - d))
+                di = di + 1
+            end
+        end
+    end
+    return di
+end
+
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gSomaticLZDefaultConfig = void 0;
+exports.lzDecompress = lzDecompress;
+exports.lzCompress = lzCompress;
+/** ---- Varint (unsigned LEB128) ---- */
+function writeVarint(out, x) {
+    // x must be >= 0 and <= 2^31-ish; good enough for asset sizes
+    while (x >= 0x80) {
+        out.push((x & 0x7f) | 0x80);
+        x >>>= 7;
+    }
+    out.push(x);
+}
+function readVarint(data, i) {
+    let x = 0;
+    let shift = 0;
+    while (true) {
+        if (i >= data.length)
+            throw new Error("truncated varint");
+        const b = data[i++];
+        x |= (b & 0x7f) << shift;
+        if ((b & 0x80) === 0)
+            break;
+        shift += 7;
+        if (shift > 35)
+            throw new Error("varint too large");
+    }
+    return { value: x >>> 0, next: i };
+}
+/** Roughly how many bytes a varint would take (for cheap cost comparisons). */
+function varintSize(x) {
+    let n = 1;
+    while (x >= 0x80) {
+        n++;
+        x >>>= 7;
+    }
+    return n;
+}
+/** ---- Decompress ---- */
+function lzDecompress(encoded) {
+    const out = [];
+    let i = 0;
+    while (i < encoded.length) {
+        const tag = encoded[i++];
+        if (tag === 0x00) {
+            const r = readVarint(encoded, i);
+            i = r.next;
+            const len = r.value;
+            if (i + len > encoded.length)
+                throw new Error("truncated literal run");
+            for (let j = 0; j < len; j++)
+                out.push(encoded[i++]);
+        }
+        else if (tag === 0x80) {
+            const rl = readVarint(encoded, i);
+            i = rl.next;
+            const rd = readVarint(encoded, i);
+            i = rd.next;
+            const len = rl.value;
+            const dist = rd.value;
+            if (dist <= 0 || dist > out.length)
+                throw new Error("invalid match distance");
+            for (let j = 0; j < len; j++) {
+                out.push(out[out.length - dist]);
+            }
+        }
+        else if (tag === 0x81) {
+            const rl = readVarint(encoded, i);
+            i = rl.next;
+            const len = rl.value;
+            if (i >= encoded.length)
+                throw new Error("truncated rle");
+            const v = encoded[i++];
+            for (let j = 0; j < len; j++)
+                out.push(v);
+        }
+        else {
+            throw new Error(`unknown tag 0x${tag.toString(16)}`);
+        }
+    }
+    return Uint8Array.from(out);
+}
+// note that the playroutine's LZ decoder may need to be modified if this changes.
+// for example it does NOT support RLE (0x81) opcodes.
+// Also the window size affects decoder memory usage.
+exports.gSomaticLZDefaultConfig = {
+    windowSize: 16,
+    minMatchLength: 4,
+    maxMatchLength: 30,
+    useRLE: false,
+};
+/** ---- Compress (greedy) ---- */
+function lzCompress(input, cfg) {
+    const { windowSize, minMatchLength, maxMatchLength, useRLE } = cfg;
+    if (windowSize < 1)
+        throw new Error("windowSize must be >= 1");
+    if (minMatchLength < 2)
+        throw new Error("minMatchLength should be >= 2 (usually 3)");
+    if (maxMatchLength < minMatchLength)
+        throw new Error("maxMatchLength must be >= minMatchLength");
+    const out = [];
+    const lits = [];
+    function flushLits() {
+        if (lits.length === 0)
+            return;
+        out.push(0x00);
+        writeVarint(out, lits.length);
+        out.push(...lits);
+        lits.length = 0;
+    }
+    function emitMatch(len, dist) {
+        out.push(0x80);
+        writeVarint(out, len);
+        writeVarint(out, dist);
+    }
+    function emitRLE(len, value) {
+        out.push(0x81);
+        writeVarint(out, len);
+        out.push(value);
+    }
+    // Estimate encoded size of candidates (to choose between LZ vs RLE vs literals).
+    const matchCost = (len, dist) => 1 + varintSize(len) + varintSize(dist); // 0x80 + len + dist
+    const rleCost = (len) => 1 + varintSize(len) + 1; // 0x81 + len + value
+    const litCost = (len) => 1 + varintSize(len) + len; // 0x00 + len + bytes
+    let i = 0;
+    while (i < input.length) {
+        // Optional: detect RLE run at i
+        let rleLen = 0;
+        if (useRLE) {
+            const v = input[i];
+            let k = i + 1;
+            const cap = Math.min(input.length, i + maxMatchLength);
+            while (k < cap && input[k] === v)
+                k++;
+            rleLen = k - i;
+        }
+        // Find best LZ match (greedy longest within window, capped)
+        let bestLen = 0;
+        let bestDist = 0;
+        const maxDist = Math.min(windowSize, i);
+        const maxLenCap = Math.min(maxMatchLength, input.length - i);
+        // Simple brute-force search. For tuning/testing this is fine.
+        for (let dist = 1; dist <= maxDist; dist++) {
+            let len = 0;
+            // Compare input[i + len] vs input[i + len - dist]
+            while (len < maxLenCap && input[i + len] === input[i + len - dist])
+                len++;
+            if (len > bestLen) {
+                bestLen = len;
+                bestDist = dist;
+                if (bestLen === maxLenCap)
+                    break; // can't do better
+            }
+        }
+        const canMatch = bestLen >= minMatchLength;
+        const canRLE = useRLE && rleLen >= minMatchLength;
+        if (!canMatch && !canRLE) {
+            // literal byte
+            lits.push(input[i++]);
+            // optional: keep literals from growing too huge (not necessary, but keeps memory tame)
+            if (lits.length >= 1 << 15)
+                flushLits();
+            continue;
+        }
+        // Choose best operation by cost-per-byte-saved. We'll compare:
+        // - LZ match candidate (if any)
+        // - RLE candidate (if any)
+        // - otherwise literals
+        //
+        // For fairness, we compare costs for encoding exactly N bytes of output.
+        // For LZ, N = bestLen; for RLE, N = rleLen.
+        //
+        // If both exist, we can also clamp to the same N and compare, but
+        // typically you want the op that encodes MORE bytes cheaply.
+        let choose = "LIT";
+        let useLen = 1;
+        // Start with "literal run" as baseline (encode next byte as literal; we'll accumulate)
+        let bestScore = Infinity;
+        if (canMatch) {
+            const len = Math.min(bestLen, maxLenCap);
+            const cost = matchCost(len, bestDist);
+            const score = cost / len; // lower is better
+            bestScore = score;
+            choose = "LZ";
+            useLen = len;
+        }
+        if (canRLE) {
+            const len = Math.min(rleLen, maxLenCap);
+            const cost = rleCost(len);
+            const score = cost / len;
+            // Prefer RLE if it wins on score, or ties but is longer (often helps)
+            if (score < bestScore || (score === bestScore && len > useLen)) {
+                bestScore = score;
+                choose = "RLE";
+                useLen = len;
+            }
+        }
+        // Emit chosen op
+        flushLits();
+        if (choose === "LZ") {
+            emitMatch(useLen, bestDist);
+            i += useLen;
+        }
+        else if (choose === "RLE") {
+            emitRLE(useLen, input[i]);
+            i += useLen;
+        }
+        else {
+            // Shouldn't happen given canMatch/canRLE checks, but keep safe:
+            lits.push(input[i++]);
+        }
+    }
+    flushLits();
+    return Uint8Array.from(out);
+}
+//# sourceMappingURL=lz.js.map

package/dist/utils/encoding/lz.js.map

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

package/dist/utils/enum.d.ts

@@ -0,0 +1,45 @@
+type EnumValue = string | number;
+type EnumDef = Record<string, {
+    value: EnumValue;
+} & Record<string, any>>;
+type EnumKeyUnion<D extends EnumDef> = keyof D;
+type EnumValueUnion<D extends EnumDef> = D[EnumKeyUnion<D>]["value"];
+type EnumInfo<D extends EnumDef, K extends EnumKeyUnion<D>> = {
+    key: K;
+} & D[K];
+type EnumInfoUnion<D extends EnumDef> = {
+    [K in EnumKeyUnion<D>]: {
+        key: K;
+    } & D[K];
+}[EnumKeyUnion<D>];
+export declare function defineEnum<const D extends EnumDef>(def: D): {
+    readonly $key: keyof D;
+    readonly $value: EnumValueUnion<D>;
+    readonly $info: EnumInfoUnion<D>;
+    readonly valueByKey: keyof D extends infer T extends keyof D ? { [K in T]: D[K]["value"]; } : never;
+    readonly infoByKey: keyof D extends infer T_1 extends keyof D ? { [K_1 in T_1]: EnumInfo<D, K_1>; } : never;
+    readonly key: keyof D extends infer T_2 extends keyof D ? { [K_2 in T_2]: K_2; } : never;
+    readonly byKey: D;
+    readonly infoByValue: Map<EnumValueUnion<D>, EnumInfoUnion<D>>;
+    readonly keyByValue: Map<EnumValueUnion<D>, keyof D>;
+    readonly keys: [keyof D, ...(keyof D)[]];
+    readonly values: EnumValueUnion<D>[];
+    readonly infos: EnumInfoUnion<D>[];
+    readonly valuesSet: Set<EnumValueUnion<D>>;
+    readonly keysSet: Set<keyof D>;
+    readonly isValidKey: (k: any) => k is EnumKeyUnion<D>;
+    readonly coerceByKey: {
+        (k: any): EnumInfoUnion<D> | undefined;
+        (k: any, fallbackKey: keyof typeof def): EnumInfoUnion<D>;
+    };
+    readonly coerceByValue: {
+        (v: any): EnumInfoUnion<D> | undefined;
+        (v: any, fallbackKey: keyof typeof def): EnumInfoUnion<D>;
+    };
+    readonly coerceByValueOrKey: {
+        (vk: any): EnumInfoUnion<D> | undefined;
+        (vk: any, fallbackKey: keyof typeof def): EnumInfoUnion<D>;
+    };
+};
+export {};
+//# sourceMappingURL=enum.d.ts.map

package/dist/utils/enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/utils/enum.ts"],"names":[],"mappings":"AA8BA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAIjC,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAE1E,KAAK,YAAY,CAAC,CAAC,SAAS,OAAO,IAAI,MAAM,CAAC,CAAC;AAC/C,KAAK,cAAc,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAIrE,KAAK,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,IAAI;IAC5D,GAAG,EAAE,CAAC,CAAC;CACR,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACT,KAAK,aAAa,CAAC,CAAC,SAAS,OAAO,IAAI;KACrC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;QAAE,GAAG,EAAE,CAAC,CAAA;KAAE,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1C,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAenB,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,CAAC;;;;sEAqBrD,CAAC;;;;;;;;;;;6BAgEmB,GAAG,KAAG,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;;YApCxB,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS;YAClC,GAAG,eAAe,MAAM,OAAO,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC;;;YAWnD,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS;YAClC,GAAG,eAAe,MAAM,OAAO,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC;;;aAS/C,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS;aAClC,GAAG,eAAe,MAAM,OAAO,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC;;EAsDvF"}

package/dist/utils/enum.js

@@ -0,0 +1,135 @@
+"use strict";
+// utility to define enums with all the extras without needing tons of
+// boilerplate and symbols scattered around also allows enums to attach more
+// complex arbitrary data to them.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEnum = defineEnum;
+// const ExampleDef = {
+//    A: {value: 1, title: "First"},
+//    B: {value: 2, title: "Second"},
+// } as const;
+// type ExampleKey = EnumKeyUnion<typeof ExampleDef>;   // "A" | "B"
+// type ExampleVal = EnumValueUnion<typeof ExampleDef>; // 1 | 2
+// type ExampleInfoA = EnumInfo<typeof ExampleDef, "A">;
+// // now let's make a type which unions all infos.
+// // {key: "A", value: 1, title: "First"} | {key: "B", value: 2, title:
+// "Second"} type ExampleInfoUnion = EnumInfoUnion<typeof ExampleDef>;
+function defineEnum(def) {
+    // ok so what type do we actualyl want for keys?
+    // -> ["KEY1", "KEY2"] -- explict literal array, not sure if this is actually
+    // possible without some recursive type magic
+    // -> ("KEY1" | "KEY2")[]
+    // -> Set<"KEY1" | "KEY2">
+    // etc. ?
+    // const keys = typedKeys(def);
+    const keys = Object.keys(def); //(keyof D)[]; // specify that
+    //there are at least 1; then it
+    //can be used in z.enum().
+    // Set<string>() of keys
+    // []
+    // key.TIC80 -> "TIC80"
+    const key = Object.fromEntries(keys.map((k) => [k, k]));
+    // valueByKey.TIC80 -> 1
+    const valueByKey = Object.fromEntries(keys.map((k) => [k, def[k].value]));
+    const values = keys.map((k) => valueByKey[k]);
+    const infos = keys.map((k) => ({ key: k, ...def[k] }));
+    // Reverse lookups (Map handles number keys cleanly)
+    const keyByValue = new Map();
+    const infoByValue = new Map();
+    const infoByKey = Object.fromEntries(keys.map((k) => [k, { key: k, ...def[k] }]));
+    for (const k of keys) {
+        const v = valueByKey[k];
+        // Optional: detect duplicate values (uncomment to hard fail)
+        // if (keyByValue.has(v)) throw new Error(`Duplicate enum value:
+        // ${String(v)}`);
+        keyByValue.set(v, k);
+        infoByValue.set(v, infos.find((x) => x.key === k));
+    }
+    // phantom fields for type extraction convenience
+    const $key = null;
+    const $value = null;
+    const $info = null;
+    function _coerceByKey(k, fallbackKey) {
+        if (typeof k !== "string") {
+            return fallbackKey ? infoByKey[fallbackKey] : undefined;
+        }
+        if (k in def) {
+            return infoByKey[k];
+        }
+        return fallbackKey ? infoByKey[fallbackKey] : undefined;
+    }
+    function _coerceByValue(v, fallbackKey) {
+        const info = infoByValue.get(v);
+        if (info) {
+            return info;
+        }
+        return fallbackKey ? infoByKey[fallbackKey] : undefined;
+    }
+    function _coerceByValueOrKey(vk, fallbackKey) {
+        // prefer key first
+        const infoByKeyResult = _coerceByKey(vk);
+        if (infoByKeyResult) {
+            return infoByKeyResult;
+        }
+        if (fallbackKey === undefined) {
+            return _coerceByValue(vk);
+        }
+        return _coerceByValue(vk, fallbackKey);
+    }
+    function isValidKey(k) {
+        return typeof k === "string" && k in def;
+    }
+    return {
+        // phantom fields for type extraction
+        $key,
+        $value,
+        $info,
+        // record objects
+        valueByKey, // e.valueByKey.TIC80 -> 1
+        infoByKey, // e.infoByKey.TIC80 -> {key: "TIC80", value: 1, title:
+        // "TIC-80"}
+        key, // e.key.TIC80 -> "TIC80" (so you can refer to keys like traditional
+        // enums)
+        byKey: def, // e.byKey.TIC80 -> {value: 1, title: "TIC-80"} -- this is just
+        // the original def
+        // maps
+        infoByValue,
+        keyByValue,
+        // arrays
+        keys, // array of keys e.keys -> ("TIC80" | "AMIGAMOD")[].
+        values,
+        infos, // flat array of all infos
+        // sets
+        valuesSet: new Set(values),
+        keysSet: new Set(keys),
+        // query fns
+        isValidKey,
+        // todo: others? a lot can be done via coersions.
+        // coercion fns (lookup from `any`, with fallback)
+        coerceByKey: _coerceByKey,
+        coerceByValue: _coerceByValue,
+        coerceByValueOrKey: _coerceByValueOrKey,
+    };
+}
+// const ExampleDef = {
+//    A: {value: 1, title: "First"},
+//    B: {value: 2, title: "Second"},
+// } as const;
+// type ExampleKey = EnumKeyUnion<typeof ExampleDef>;   // "A" | "B"
+// type ExampleVal = EnumValueUnion<typeof ExampleDef>; // 1 | 2
+// type ExampleInfoA = EnumInfo<typeof ExampleDef, "A">;
+// // now let's make a type which unions all infos.
+// // {key: "A", value: 1, title: "First"} | {key: "B", value: 2, title:
+// "Second"} type ExampleInfoUnion = EnumInfoUnion<typeof ExampleDef>;
+// const kExampleEnum = defineEnum(ExampleDef);
+// const throwaway = {
+//    aKey: kExampleEnum.key.A,
+//    aValue: kExampleEnum.valueByKey.A,
+//    aInfo: kExampleEnum.infoByKey.A,
+//    aInfoByValue: kExampleEnum.infoByValue.get(1),
+//    x: kExampleEnum.values,
+//    // y: kExampleEnum.values,
+//    // z: kExampleEnum.infos,
+// };
+// throwaway.x[0]
+//# sourceMappingURL=enum.js.map

package/dist/utils/enum.js.map

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

package/dist/utils/errorHandling.d.ts

@@ -0,0 +1,13 @@
+export type Ok<T> = {
+    ok: true;
+    value: T;
+};
+export type Err = {
+    ok: false;
+    error: string;
+};
+export type Result<T> = Ok<T> | Err;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<T = never>(error: string): Result<T>;
+export declare function assert(condition?: boolean, message?: string): asserts condition;
+//# sourceMappingURL=errorHandling.d.ts.map

package/dist/utils/errorHandling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandling.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAClB,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AACF,MAAM,MAAM,GAAG,GAAG;IAChB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAEpC,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAEvD;AAED,wBAAgB,MAAM,CAAC,SAAS,GAAE,OAAc,EAAE,OAAO,GAAE,MAA2B,GAAG,OAAO,CAAC,SAAS,CAKzG"}