@adviser/cement 0.5.0 → 0.5.1

package/esm/utils/to-sorted.test.js

@@ -0,0 +1,227 @@
+import { describe, it, expect } from "vitest";
+import { toSorted } from "./to-sorted.js";
+describe("toSorted", () => {
+    describe("primitive values", () => {
+        it("should return null as-is", () => {
+            expect(toSorted(null)).toBe(null);
+        });
+        it("should return undefined as-is", () => {
+            expect(toSorted(undefined)).toBe(undefined);
+        });
+        it("should return string as-is", () => {
+            expect(toSorted("hello")).toBe("hello");
+        });
+        it("should return number as-is", () => {
+            expect(toSorted(42)).toBe(42);
+        });
+        it("should return boolean as-is", () => {
+            expect(toSorted(true)).toBe(true);
+            expect(toSorted(false)).toBe(false);
+        });
+    });
+    describe("arrays", () => {
+        it("should handle empty array", () => {
+            expect(toSorted([])).toEqual([]);
+        });
+        it("should recursively sort array elements", () => {
+            const input = [
+                { c: 1, a: 2, b: 3 },
+                { z: 4, x: 5, y: 6 },
+            ];
+            const expected = [
+                { a: 2, b: 3, c: 1 },
+                { x: 5, y: 6, z: 4 },
+            ];
+            expect(toSorted(input)).toEqual(expected);
+        });
+        it("should handle nested arrays", () => {
+            const input = [[{ b: 1, a: 2 }], [{ d: 3, c: 4 }]];
+            const expected = [[{ a: 2, b: 1 }], [{ c: 4, d: 3 }]];
+            expect(toSorted(input)).toEqual(expected);
+        });
+        it("should handle array with mixed types", () => {
+            const input = [{ b: 1, a: 2 }, "string", 42, null, undefined];
+            const expected = [{ a: 2, b: 1 }, "string", 42, null, undefined];
+            expect(toSorted(input)).toEqual(expected);
+        });
+    });
+    describe("objects", () => {
+        it("should handle empty object", () => {
+            expect(toSorted({})).toEqual({});
+        });
+        it("should sort object keys alphabetically", () => {
+            const input = { c: 1, a: 2, b: 3 };
+            const expected = { a: 2, b: 3, c: 1 };
+            expect(toSorted(input)).toEqual(expected);
+        });
+        it("should recursively sort nested objects", () => {
+            const input = {
+                z: { c: 1, a: 2, b: 3 },
+                a: { z: 4, x: 5, y: 6 },
+            };
+            const expected = {
+                a: { x: 5, y: 6, z: 4 },
+                z: { a: 2, b: 3, c: 1 },
+            };
+            expect(toSorted(input)).toEqual(expected);
+        });
+        it("should handle objects with array values", () => {
+            const input = {
+                b: [{ z: 1, a: 2 }],
+                a: [{ c: 3, b: 4 }],
+            };
+            const expected = {
+                a: [{ b: 4, c: 3 }],
+                b: [{ a: 2, z: 1 }],
+            };
+            expect(toSorted(input)).toEqual(expected);
+        });
+        it("should handle deeply nested structures", () => {
+            const input = {
+                c: {
+                    b: {
+                        z: 1,
+                        a: { y: 2, x: 3 },
+                    },
+                    a: [{ c: 4, b: 5 }],
+                },
+                a: "simple",
+            };
+            const expected = {
+                a: "simple",
+                c: {
+                    a: [{ b: 5, c: 4 }],
+                    b: {
+                        a: { x: 3, y: 2 },
+                        z: 1,
+                    },
+                },
+            };
+            expect(toSorted(input)).toEqual(expected);
+        });
+    });
+    describe("cycle detection", () => {
+        it("should handle circular references in objects", () => {
+            const obj = { b: 1, a: 2 };
+            obj.self = obj;
+            const result = toSorted(obj);
+            expect(result).toEqual({
+                a: 2,
+                b: 1,
+                self: undefined,
+            });
+        });
+        it("should handle circular references in arrays", () => {
+            const arr = [{ b: 1, a: 2 }];
+            arr.push(arr);
+            const result = toSorted(arr);
+            expect(result).toEqual([{ a: 2, b: 1 }, undefined]);
+        });
+        it("should handle complex circular references", () => {
+            const obj1 = { c: 1, a: 2 };
+            const obj2 = { b: obj1, z: 3 };
+            obj1.ref = obj2;
+            const result = toSorted(obj1);
+            expect(result).toEqual({
+                a: 2,
+                c: 1,
+                ref: {
+                    b: undefined,
+                    z: 3,
+                },
+            });
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle Date objects", () => {
+            const date = new Date("2023-01-01");
+            const input = { b: date, a: 1 };
+            const result = toSorted(input);
+            expect(result).toEqual({
+                a: 1,
+                b: date.toISOString(),
+            });
+        });
+        it("should handle functions", () => {
+            const fn = () => "test";
+            const input = { b: fn, a: 1 };
+            const result = toSorted(input);
+            expect(result).toEqual({
+                a: 1,
+                b: undefined,
+            });
+        });
+        it("should handle symbols as object values", () => {
+            const sym = Symbol("test");
+            const input = { b: sym, a: 1 };
+            const result = toSorted(input);
+            expect(result).toEqual({
+                a: 1,
+                b: sym.toString(),
+            });
+        });
+        it("should maintain object prototype chain", () => {
+            class TestClass {
+                b;
+                a;
+                constructor(b, a) {
+                    this.b = b;
+                    this.a = a;
+                }
+            }
+            const instance = new TestClass(1, 2);
+            const result = toSorted(instance);
+            expect(result).toEqual({ a: 2, b: 1 });
+            expect(result).toBeInstanceOf(Object);
+        });
+    });
+    describe("performance and deep nesting", () => {
+        it("should handle deeply nested objects without stack overflow", () => {
+            let deep = { value: "end" };
+            for (let i = 0; i < 100; i++) {
+                deep = { [`key${i}`]: deep, [`akey${i}`]: i, ...deep };
+            }
+            const result = toSorted(deep);
+            expect(result).toBeDefined();
+            expect(typeof result).toBe("object");
+        });
+        it("should handle large objects efficiently", () => {
+            const large = {};
+            for (let i = 1000; i >= 0; i--) {
+                large[`key${i.toString().padStart(4, "0")}`] = i;
+            }
+            const result = toSorted(large);
+            const keys = Object.keys(result);
+            expect(keys).toHaveLength(1001);
+            expect(keys[0]).toBe("key0000");
+            expect(keys[keys.length - 1]).toBe("key1000");
+        });
+    });
+    it("is touch called", () => {
+        const input = {
+            b: [{ z: 1, a: 2 }],
+            a: [{ c: 3, b: 4 }],
+        };
+        const touchFn = vi.fn();
+        const v = toSorted(input, touchFn);
+        expect(v).toEqual({
+            a: [{ b: 4, c: 3 }],
+            b: [{ a: 2, z: 1 }],
+        });
+        expect(touchFn.mock.calls).toEqual([
+            ["a", "Key"],
+            [[{ b: 4, c: 3 }], "Array"],
+            ["b", "Key"],
+            [4, "Number"],
+            ["c", "Key"],
+            [3, "Number"],
+            ["b", "Key"],
+            [[{ a: 2, z: 1 }], "Array"],
+            ["a", "Key"],
+            [2, "Number"],
+            ["z", "Key"],
+            [1, "Number"],
+        ]);
+    });
+});
+//# sourceMappingURL=to-sorted.test.js.map

package/esm/utils/to-sorted.test.js.map

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

package/esm/utils/uint8array-equal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array-equal.d.ts","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAUrE"}
+{"version":3,"file":"uint8array-equal.d.ts","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAoBA,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAUrE"}

package/esm/utils/uint8array-equal.js.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array-equal.js","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,CAAa,EAAE,CAAa,EAAW;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACb"}
+{"version":3,"file":"uint8array-equal.js","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,eAAe,CAAC,CAAa,EAAE,CAAa,EAAW;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACb"}

package/esm/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.5.0";
+export const VERSION = "0.5.1";
 //# sourceMappingURL=version.js.map

package/esm/web-env/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./web-env-actions.js";
+export * from "./web-basic-sys-abstraction.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/web-env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/web-env/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC"}

package/esm/web-env/index.js

@@ -0,0 +1,3 @@
+export * from "./web-env-actions.js";
+export * from "./web-basic-sys-abstraction.js";
+//# sourceMappingURL=index.js.map

package/esm/web-env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web-env/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC"}

package/esm/web-env/web-basic-sys-abstraction.d.ts

@@ -0,0 +1,4 @@
+import { BaseBasicRuntimeSysAbstractionParams } from "../base-sys-abstraction.js";
+import { BasicSysAbstraction } from "../sys-abstraction.js";
+export declare function WebBasicSysAbstraction(param: Partial<BaseBasicRuntimeSysAbstractionParams>): BasicSysAbstraction;
+//# sourceMappingURL=web-basic-sys-abstraction.d.ts.map

package/esm/web-env/web-basic-sys-abstraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-basic-sys-abstraction.d.ts","sourceRoot":"","sources":["../../../../src/web-env/web-basic-sys-abstraction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EAGrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAuB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAuCjF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,oCAAoC,CAAC,GAAG,mBAAmB,CAWhH"}

package/esm/web-env/web-basic-sys-abstraction.js

@@ -0,0 +1,49 @@
+import { BaseBasicSysAbstraction, WrapperBasicSysAbstraction, } from "../base-sys-abstraction.js";
+import { envFactory } from "../sys-env.js";
+import { TxtEnDecoderSingleton } from "../txt-en-decoder.js";
+import { ConsoleWriterStream } from "../utils/console-write-stream.js";
+class WebSystemService {
+    _txtEnDe;
+    _envFactory;
+    _stdoutFactory;
+    constructor(ende, envFactory, stdoutFactory) {
+        this._txtEnDe = ende;
+        this._envFactory = envFactory;
+        this._stdoutFactory = stdoutFactory;
+    }
+    Env() {
+        return this._envFactory();
+    }
+    Args() {
+        throw new Error("Args-Method not implemented.");
+    }
+    Stdout() {
+        return this._stdoutFactory();
+    }
+    Stderr() {
+        const decoder = this._txtEnDe;
+        return new WritableStream({
+            write(chunk) {
+                return new Promise((resolve) => {
+                    const decoded = decoder.decode(chunk);
+                    console.error(decoded.trimEnd());
+                    resolve();
+                });
+            },
+        });
+    }
+}
+let baseBasicSysAbstraction = undefined;
+export function WebBasicSysAbstraction(param) {
+    const ende = param.TxtEnDecoder ?? TxtEnDecoderSingleton();
+    baseBasicSysAbstraction =
+        baseBasicSysAbstraction ??
+            new BaseBasicSysAbstraction({
+                TxtEnDecoder: ende,
+            });
+    return new WrapperBasicSysAbstraction(baseBasicSysAbstraction, {
+        basicRuntimeService: new WebSystemService(ende, envFactory, () => new ConsoleWriterStream()),
+        ...param,
+    });
+}
+//# sourceMappingURL=web-basic-sys-abstraction.js.map

package/esm/web-env/web-basic-sys-abstraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-basic-sys-abstraction.js","sourceRoot":"","sources":["../../../../src/web-env/web-basic-sys-abstraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAO,UAAU,EAAc,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAgB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,gBAAgB;IACX,QAAQ,CAAe;IACvB,WAAW,CAAa;IACxB,cAAc,CAAmC;IAC1D,YAAY,IAAkB,EAAE,UAAsB,EAAE,aAA+C,EAAE;QACvG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IAAA,CACrC;IACD,GAAG,GAAQ;QACT,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAAA,CAC3B;IACD,IAAI,GAAa;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAAA,CACjD;IACD,MAAM,GAA+B;QACnC,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IAAA,CAC9B;IACD,MAAM,GAA+B;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,OAAO,IAAI,cAAc,CAAC;YACxB,KAAK,CAAC,KAAK,EAAiB;gBAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAEtC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;oBACjC,OAAO,EAAE,CAAC;gBAAA,CACX,CAAC,CAAC;YAAA,CACJ;SACF,CAAC,CAAC;IAAA,CACJ;CACF;AAED,IAAI,uBAAuB,GAAwC,SAAS,CAAC;AAC7E,MAAM,UAAU,sBAAsB,CAAC,KAAoD,EAAuB;IAChH,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,qBAAqB,EAAE,CAAC;IAC3D,uBAAuB;QACrB,uBAAuB;YACvB,IAAI,uBAAuB,CAAC;gBAC1B,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;IACL,OAAO,IAAI,0BAA0B,CAAC,uBAAuB,EAAE;QAC7D,mBAAmB,EAAE,IAAI,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;QAC5F,GAAG,KAAK;KACT,CAAC,CAAC;AAAA,CACJ"}

package/esm/web-env/web-env-actions.d.ts

@@ -0,0 +1,14 @@
+import { Env, EnvActions, EnvFactoryOpts } from "../sys-env.js";
+export declare class BrowserEnvActions implements EnvActions {
+    readonly env: Map<string, string>;
+    readonly opts: Partial<EnvFactoryOpts>;
+    static new(opts: Partial<EnvFactoryOpts>): EnvActions;
+    private constructor();
+    get(key: string): string | undefined;
+    set(key: string, value?: string): void;
+    delete(key: string): void;
+    keys(): string[];
+    active(): boolean;
+    register(env: Env): Env;
+}
+//# sourceMappingURL=web-env-actions.d.ts.map

package/esm/web-env/web-env-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-env-actions.d.ts","sourceRoot":"","sources":["../../../../src/web-env/web-env-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGhE,qBAAa,iBAAkB,YAAW,UAAU;IAClD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAA6B;IAC9D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,UAAU,CAGpD;IAED,OAAO,eAEN;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnC;IACD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAIrC;IACD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IACD,IAAI,IAAI,MAAM,EAAE,CAEf;IACD,MAAM,IAAI,OAAO,CAEhB;IAED,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAKtB;CACF"}

package/esm/web-env/web-env-actions.js

@@ -0,0 +1,36 @@
+let once = undefined;
+export class BrowserEnvActions {
+    env = new Map();
+    opts;
+    static new(opts) {
+        once = once ?? new BrowserEnvActions(opts);
+        return once;
+    }
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get(key) {
+        return this.env.get(key);
+    }
+    set(key, value) {
+        if (value) {
+            this.env.set(key, value);
+        }
+    }
+    delete(key) {
+        this.env.delete(key);
+    }
+    keys() {
+        return Array.from(this.env.keys());
+    }
+    active() {
+        return true;
+    }
+    register(env) {
+        const sym = Symbol.for(this.opts.symbol || "CP_ENV");
+        const browser = globalThis;
+        browser[sym] = env;
+        return env;
+    }
+}
+//# sourceMappingURL=web-env-actions.js.map

package/esm/web-env/web-env-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-env-actions.js","sourceRoot":"","sources":["../../../../src/web-env/web-env-actions.ts"],"names":[],"mappings":"AAEA,IAAI,IAAI,GAAkC,SAAS,CAAC;AACpD,MAAM,OAAO,iBAAiB;IACnB,GAAG,GAAwB,IAAI,GAAG,EAAkB,CAAC;IACrD,IAAI,CAA0B;IAEvC,MAAM,CAAC,GAAG,CAAC,IAA6B,EAAc;QACpD,IAAI,GAAG,IAAI,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IAAA,CACb;IAED,YAAoB,IAA6B,EAAE;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAAA,CAClB;IAED,GAAG,CAAC,GAAW,EAAsB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAA,CAC1B;IACD,GAAG,CAAC,GAAW,EAAE,KAAc,EAAQ;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IAAA,CACF;IACD,MAAM,CAAC,GAAW,EAAQ;QACxB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAAA,CACtB;IACD,IAAI,GAAa;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAAA,CACpC;IACD,MAAM,GAAY;QAChB,OAAO,IAAI,CAAC;IAAA,CACb;IAED,QAAQ,CAAC,GAAQ,EAAO;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,UAA4C,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACnB,OAAO,GAAG,CAAC;IAAA,CACZ;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adviser/cement",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "better try/catch/finally handling",
   "main": "./cjs/index.js",
   "type": "module",
@@ -8,7 +8,7 @@
   "exports": {
     ".": {
       "types": "./esm/index.d.ts",
-      "require": "./cjs/index.cjs.cjs",
+      "require": "./cjs/index.cjs",
       "import": "./esm/index.js"
     },
     "./cli": {
@@ -16,30 +16,15 @@
       "require": "./cjs/cli/index.cjs",
       "import": "./esm/cli/index.js"
     },
-    "./web": {
-      "types": "./esm/web/index.d.ts",
-      "require": "./cjs/web/index.cjs",
-      "import": "./esm/web/index.js"
+    "./node-fs": {
+      "types": "./esm/node-fs/index.d.ts",
+      "require": "./cjs/node-fs/index.cjs",
+      "import": "./esm/node-fs/index.js"
     },
-    "./utils": {
-      "types": "./esm/utils/index.d.ts",
-      "require": "./cjs/utils/index.cjs",
-      "import": "./esm/utils/index.js"
-    },
-    "./cf": {
-      "types": "./esm/cf/index.d.ts",
-      "require": "./cjs/cf/index.cjs",
-      "import": "./esm/cf/index.js"
-    },
-    "./node": {
-      "types": "./esm/node/index.d.ts",
-      "require": "./cjs/node/index.cjs",
-      "import": "./esm/node/index.js"
-    },
-    "./deno": {
-      "types": "./esm/deno/index.d.ts",
-      "require": "./cjs/deno/index.cjs",
-      "import": "./esm/deno/index.js"
+    "./deno-fs": {
+      "types": "./esm/deno-fs/index.d.ts",
+      "require": "./cjs/deno-fs/index.cjs",
+      "import": "./esm/deno-fs/index.js"
     },
     "./import-meta-env": {
       "types": "./esm/import-meta-env.module.d.ts",
@@ -47,41 +32,69 @@
       "import": "./esm/import-meta-env.module.js"
     }
   },
+  "scripts": {
+    "clean": "rm -rf dist node_modules",
+    "build": "pnpm run build:tsgo && pnpm run build:js && pnpm run build:deno && pnpm run build:isplain",
+    "build:tsc": "rm -rf ./dist/ts ; pnpm run /^build:tsc:/",
+    "build:tsgo": "rm -rf ./dist/ts ; pnpm run /^build:tsgo:/",
+    "build:tsgo:global": "tsgo --noEmit",
+    "build:tsgo:esm": "tsgo -p ./tsconfig.esm.json; src/cli/run.sh generateVersionTs -t ./tsconfig.esm.json",
+    "build:tsgo:cjs": "tsgo -p ./tsconfig.cjs.json; src/cli/run.sh generateVersionTs -t ./tsconfig.cjs.json",
+    "build:js": "rm -rf dist/pkg ; mkdir -p dist/pkg; cp -pr ./dist/ts/* dist/pkg",
+    "build:isplain": "esbuild --bundle src/index.ts --outfile=/dev/null --format=esm",
+    "build:deno": "deno publish --dry-run --unstable-sloppy-imports --allow-dirty --set-version 0.0.0-dev --quiet",
+    "test": "pnpm run test:js; pnpm run test:deno",
+    "test:deno": "deno run --quiet --allow-net --allow-write --allow-run  --allow-sys --allow-ffi  --allow-read --allow-env  ./node_modules/vitest/vitest.mjs --run --project node",
+    "test:js": "vitest --run",
+    "pubdir": "src/cli/run.sh preparePubdir",
+    "presmoke": "pnpm run pubdir ; cd pubdir",
+    "deno:publish": "pnpm run pubdir; cd pubdir ; pnpm exec deno publish --allow-dirty --unstable-sloppy-imports --quiet",
+    "smoke": "bash ./smoke/it.sh",
+    "lint": "eslint .",
+    "prettier": "prettier .",
+    "format": "prettier .",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch"
+  },
   "keywords": [],
   "author": "Meno Abels <meno.abels@adviser.com>",
   "license": "AFL-2.0",
   "bugs": {
     "url": "https://github.com/mabels/cement/issues"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mabels/cement"
+  },
   "homepage": "https://github.com/mabels/cement#readme",
   "dependencies": {
     "ts-essentials": "^10.0.2",
     "yaml": "^2.7.1"
   },
   "devDependencies": {
-    "@cloudflare/vitest-pool-workers": "^0.9.1",
-    "@eslint/js": "^9.20.0",
+    "@cloudflare/vitest-pool-workers": "^0.10.3",
+    "@eslint/js": "^9.39.1",
     "@types/deno": "^2.3.0",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.4.0",
-    "@typescript-eslint/eslint-plugin": "^8.7.0",
-    "@typescript-eslint/parser": "^8.7.0",
-    "@typescript/native-preview": "7.0.0-dev.20250928.1",
+    "@types/semver": "^7.7.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.3",
+    "@typescript-eslint/parser": "^8.46.3",
+    "@typescript/native-preview": "7.0.0-dev.20251124.1",
     "@vitest/browser": "^3.2.4",
     "@vitest/runner": "^3.2.4",
     "cmd-ts": "^0.14.1",
     "deno": "^2.5.1",
-    "esbuild-plugin-replace": "^1.4.0",
-    "esbuild-plugin-resolve": "^2.0.0",
-    "eslint": "^9.35.0",
+    "eslint": "^9.39.1",
     "jscodeshift": "^17.3.0",
     "playwright": "^1.54.1",
-    "playwright-chromium": "^1.54.1",
     "prettier": "^3.6.2",
+    "semver": "^7.7.3",
     "tsup": "^8.3.0",
     "tsx": "^4.19.1",
+    "typedoc": "^0.28.14",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.44.0",
+    "typescript-eslint": "^8.46.3",
     "vite": "^7.0.4",
     "vite-tsconfig-paths": "^5.0.1",
     "vitest": "^3.2.4",
@@ -90,25 +103,18 @@
   "engines": {
     "node": ">=20.19.0"
   },
-  "scripts": {
-    "clean": "rm -rf dist node_modules",
-    "build": "pnpm run build:tsgo; pnpm run build:js; pnpm run build:deno",
-    "build:tsc": "rm -rf ./dist/ts ; pnpm run /^build:tsc:/",
-    "build:tsgo": "rm -rf ./dist/ts ; pnpm run /^build:tsgo:/",
-    "build:tsgo:global": "tsgo --noEmit",
-    "build:tsgo:esm": "tsgo -p ./tsconfig.esm.json; src/cli/run.sh generateVersionTs -t ./tsconfig.esm.json",
-    "build:tsgo:cjs": "tsgo -p ./tsconfig.cjs.json; src/cli/run.sh generateVersionTs -t ./tsconfig.cjs.json",
-    "build:js": "rm -rf dist/pkg ; mkdir -p dist/pkg; cp -pr ./dist/ts/* dist/pkg",
-    "build:deno": "deno publish --dry-run --unstable-sloppy-imports --allow-dirty --set-version 0.0.0-dev",
-    "test": "pnpm run test:js; pnpm run test:deno",
-    "test:deno": "deno run --quiet --allow-net --allow-write --allow-run  --allow-sys --allow-ffi  --allow-read --allow-env  ./node_modules/vitest/vitest.mjs --run --project node",
-    "test:js": "vitest --run",
-    "pubdir": "src/cli/run.sh preparePubdir",
-    "presmoke": "pnpm run pubdir ; cd pubdir ; pnpm pack",
-    "deno:publish": "pnpm run pubdir; cd pubdir ; pnpm exec deno publish --allow-dirty --unstable-sloppy-imports",
-    "smoke": "bash ./smoke/it.sh",
-    "lint": "eslint .",
-    "prettier": "prettier .",
-    "format": "prettier ."
+  "pnpm": {
+    "ignoredBuiltDependencies": [
+      "edgedriver",
+      "geckodriver",
+      "msw",
+      "sharp"
+    ],
+    "onlyBuiltDependencies": [
+      "deno",
+      "esbuild",
+      "playwright-chromium",
+      "workerd"
+    ]
   }
-}
+}

package/src/add-cement-do-not-export.ts

@@ -0,0 +1,29 @@
+import { WithCement } from "./types.js";
+import { runtimeFn } from "./runtime.js";
+import {
+  WrapperBasicSysAbstraction,
+  WrapperRuntimeSysAbstraction,
+  BaseBasicSysAbstraction,
+  BaseSysAbstraction,
+} from "./base-sys-abstraction.js";
+import { TxtEnDecoderSingleton } from "./txt-en-decoder.js";
+import { ConsoleWriterStream } from "./utils/console-write-stream.js";
+import { envFactory } from "./sys-env.js";
+import { NodeBasicSysAbstraction } from "./node-env/index.js";
+
+export function addCement<T>(params: T): WithCement<T> {
+  return {
+    cement: {
+      runtimeFn,
+      WrapperBasicSysAbstraction,
+      WrapperRuntimeSysAbstraction,
+      TxtEnDecoderSingleton,
+      ConsoleWriterStream,
+      envFactory,
+      BaseBasicSysAbstraction,
+      BaseSysAbstraction,
+      NodeBasicSysAbstraction,
+    },
+    ...params,
+  };
+}