@inox-tools/utils 0.1.2 → 0.1.4

package/dist/lazy.js

@@ -1,5 +1,5 @@
 class a{constructor(i){this.factory=i;}initialized=!1;value;static of(i){return new this(i)}get(){return this.initialized||(this.value=this.factory(),this.initialized=!0),this.value}}
 
 export { a as Lazy };
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=lazy.js.map
 //# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/lazy.ts"],"names":["Lazy","factory"],"mappings":"AAMO,MAAMA,CAAQ,CAGZ,YAAoBC,EAAkB,CAAlB,aAAAA,CAAmB,CAFvC,YAAc,GACd,MAGR,OAAc,GAAMA,EAA2B,CAC9C,OAAO,IAAI,KAAKA,CAAO,CACxB,CAEO,KAAS,CACf,OAAK,KAAK,cACT,KAAK,MAAQ,KAAK,QAAQ,EAC1B,KAAK,YAAc,IAGb,KAAK,KACb,CACD","sourcesContent":["/**\n * A lazily computed memoized value.\n *\n * The given factory is only constructed on first use of the value.\n * Any subsequent use retrieves the same instance of the value.\n */\nexport class Lazy<T> {\n\tprivate initialized = false;\n\tprivate value?: T;\n\tprivate constructor(private factory: () => T) {}\n\n\tpublic static of<T>(factory: () => T): Lazy<T> {\n\t\treturn new this(factory);\n\t}\n\n\tpublic get(): T {\n\t\tif (!this.initialized) {\n\t\t\tthis.value = this.factory();\n\t\t\tthis.initialized = true;\n\t\t}\n\n\t\treturn this.value!;\n\t}\n}\n"]}
+{"version":3,"sources":["../src/lazy.ts"],"names":["Lazy","factory"],"mappings":"AAMO,MAAMA,CAAQ,CAGZ,WAAA,CAAoBC,CAAkB,CAAA,CAAlB,aAAAA,EAAmB,CAFvC,WAAc,CAAA,CAAA,CAAA,CACd,MAGR,OAAc,EAAA,CAAMA,CAA2B,CAAA,CAC9C,OAAO,IAAI,IAAA,CAAKA,CAAO,CACxB,CAEO,GAAS,EAAA,CACf,OAAK,IAAA,CAAK,cACT,IAAK,CAAA,KAAA,CAAQ,IAAK,CAAA,OAAA,GAClB,IAAK,CAAA,WAAA,CAAc,CAGb,CAAA,CAAA,CAAA,IAAA,CAAK,KACb,CACD","file":"lazy.js","sourcesContent":["/**\n * A lazily computed memoized value.\n *\n * The given factory is only constructed on first use of the value.\n * Any subsequent use retrieves the same instance of the value.\n */\nexport class Lazy<T> {\n\tprivate initialized = false;\n\tprivate value?: T;\n\tprivate constructor(private factory: () => T) {}\n\n\tpublic static of<T>(factory: () => T): Lazy<T> {\n\t\treturn new this(factory);\n\t}\n\n\tpublic get(): T {\n\t\tif (!this.initialized) {\n\t\t\tthis.value = this.factory();\n\t\t\tthis.initialized = true;\n\t\t}\n\n\t\treturn this.value!;\n\t}\n}\n"]}

package/dist/once.d.ts

@@ -1,6 +1,7 @@
 declare class Once {
     #private;
     do(callback: () => void): void;
+    doAsync(callback: () => Promise<void>): Promise<void>;
 }
 
 export { Once };

package/dist/once.js

@@ -1,5 +1,5 @@
-class e{#o=!1;do(o){this.#o||o();}}
+class o{#i=!1;do(i){this.#i||(i(),this.#i=!0);}async doAsync(i){this.#i||(await i(),this.#i=!0);}}
 
-export { e as Once };
-//# sourceMappingURL=out.js.map
+export { o as Once };
+//# sourceMappingURL=once.js.map
 //# sourceMappingURL=once.js.map

package/dist/once.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/once.ts"],"names":["Once","#done","callback"],"mappings":"AAAO,MAAMA,CAAK,CACRC,GAAQ,GAEV,GAAGC,EAA4B,CAChC,KAAKD,IACTC,EAAS,CAEX,CACD","sourcesContent":["export class Once {\n\treadonly #done = false;\n\n\tpublic do(callback: () => void): void {\n\t\tif (!this.#done) {\n\t\t\tcallback();\n\t\t}\n\t}\n}\n"]}
+{"version":3,"sources":["../src/once.ts"],"names":["Once","#done","callback"],"mappings":"AAAO,MAAMA,CAAK,CACjBC,EAAAA,CAAQ,CAED,CAAA,CAAA,EAAA,CAAGC,CAA4B,CAAA,CAChC,IAAKD,CAAAA,EAAAA,GACTC,CAAS,EAAA,CACT,IAAKD,CAAAA,EAAAA,CAAQ,CAEf,CAAA,EAAA,CAEA,MAAa,OAAA,CAAQC,CAA8C,CAAA,CAC7D,IAAKD,CAAAA,EAAAA,GACT,MAAMC,CAAAA,EACN,CAAA,IAAA,CAAKD,EAAQ,CAAA,CAAA,CAAA,EAEf,CACD","file":"once.js","sourcesContent":["export class Once {\n\t#done = false;\n\n\tpublic do(callback: () => void): void {\n\t\tif (!this.#done) {\n\t\t\tcallback();\n\t\t\tthis.#done = true;\n\t\t}\n\t}\n\n\tpublic async doAsync(callback: () => Promise<void>): Promise<void> {\n\t\tif (!this.#done) {\n\t\t\tawait callback();\n\t\t\tthis.#done = true;\n\t\t}\n\t}\n}\n"]}

package/dist/types.js

@@ -1,3 +1,3 @@
 
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=types.js.map
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":""}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/values.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A value that can be might be pending to be resolved.
+ */
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * A value or a thunk for a value.
+ *
+ * A "thunk" is a function that takes no arguments and return
+ * a value that is potentially expensive to compute.
+ * This can be used when the value might not be needed and as
+ * such can be computed on demand potentially saving the
+ * expensive computation.
+ *
+ * If the value is not expensive to compute it can be used directly
+ * for simplicity.
+ *
+ * A value type that is itself a function cannot be a "maybe" thunk.
+ *
+ * @see https://en.wikipedia.org/wiki/Thunk
+ */
+type MaybeThunk<T> = T extends Function ? never : T | (() => T);
+/**
+ * A value or a thunk for a synchronous or asynchronous value.
+ *
+ * @see MaybePromise
+ * @see MaybeThunk
+ */
+type MaybeAsyncThunk<T> = MaybeThunk<MaybePromise<T>>;
+/**
+ * Load a value from a possibly thunk argument.
+ *
+ * If the value is a thunk it is called and the result is returned.
+ * Otherwise the value itself is returned.
+ *
+ * @see MaybeThunk
+ */
+declare function loadThunkValue<T>(value: MaybeThunk<T>): T;
+
+export { type MaybeAsyncThunk, type MaybePromise, type MaybeThunk, loadThunkValue };

package/dist/values.js

@@ -0,0 +1,5 @@
+function T(e){return typeof e=="function"?e():e}
+
+export { T as loadThunkValue };
+//# sourceMappingURL=values.js.map
+//# sourceMappingURL=values.js.map

package/dist/values.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/values.ts"],"names":["loadThunkValue","value"],"mappings":"AAuCO,SAASA,CAAAA,CAAkBC,EAAyB,CAC1D,OAAO,OAAOA,CAAU,EAAA,UAAA,CAAaA,CAAM,EAAA,CAAIA,CAChD","file":"values.js","sourcesContent":["/**\n * A value that can be might be pending to be resolved.\n */\nexport type MaybePromise<T> = T | Promise<T>;\n\n/**\n * A value or a thunk for a value.\n *\n * A \"thunk\" is a function that takes no arguments and return\n * a value that is potentially expensive to compute.\n * This can be used when the value might not be needed and as\n * such can be computed on demand potentially saving the\n * expensive computation.\n *\n * If the value is not expensive to compute it can be used directly\n * for simplicity.\n *\n * A value type that is itself a function cannot be a \"maybe\" thunk.\n *\n * @see https://en.wikipedia.org/wiki/Thunk\n */\nexport type MaybeThunk<T> = T extends Function ? never : T | (() => T);\n\n/**\n * A value or a thunk for a synchronous or asynchronous value.\n *\n * @see MaybePromise\n * @see MaybeThunk\n */\nexport type MaybeAsyncThunk<T> = MaybeThunk<MaybePromise<T>>;\n\n/**\n * Load a value from a possibly thunk argument.\n *\n * If the value is a thunk it is called and the result is returned.\n * Otherwise the value itself is returned.\n *\n * @see MaybeThunk\n */\nexport function loadThunkValue<T>(value: MaybeThunk<T>): T {\n\treturn typeof value === 'function' ? value() : value;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inox-tools/utils",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A collection of utilities used throughout Inox Tools",
   "keywords": [
     "utilities"
@@ -20,15 +20,15 @@
     "src"
   ],
   "devDependencies": {
-    "@types/node": "^20.14.10",
-    "@vitest/coverage-v8": "^1.6.0",
-    "@vitest/ui": "^1.6.0",
-    "astro": "^4.11.5",
+    "@types/node": "^22.5.4",
+    "@vitest/coverage-v8": "^2.0.5",
+    "@vitest/ui": "^2.0.5",
+    "astro": "^4.15.3",
     "jest-extended": "^4.0.2",
-    "tsup": "^8.1.0",
-    "typescript": "^5.5.3",
-    "vite": "^5.3.3",
-    "vitest": "^1.6.0"
+    "tsup": "8.2.4",
+    "typescript": "^5.5.4",
+    "vite": "^5.4.3",
+    "vitest": "^2.0.5"
   },
   "scripts": {
     "build": "tsup",

package/src/once.ts

@@ -1,9 +1,17 @@
 export class Once {
-	readonly #done = false;
+	#done = false;
 
 	public do(callback: () => void): void {
 		if (!this.#done) {
 			callback();
+			this.#done = true;
+		}
+	}
+
+	public async doAsync(callback: () => Promise<void>): Promise<void> {
+		if (!this.#done) {
+			await callback();
+			this.#done = true;
 		}
 	}
 }

package/src/values.ts

@@ -0,0 +1,42 @@
+/**
+ * A value that can be might be pending to be resolved.
+ */
+export type MaybePromise<T> = T | Promise<T>;
+
+/**
+ * A value or a thunk for a value.
+ *
+ * A "thunk" is a function that takes no arguments and return
+ * a value that is potentially expensive to compute.
+ * This can be used when the value might not be needed and as
+ * such can be computed on demand potentially saving the
+ * expensive computation.
+ *
+ * If the value is not expensive to compute it can be used directly
+ * for simplicity.
+ *
+ * A value type that is itself a function cannot be a "maybe" thunk.
+ *
+ * @see https://en.wikipedia.org/wiki/Thunk
+ */
+export type MaybeThunk<T> = T extends Function ? never : T | (() => T);
+
+/**
+ * A value or a thunk for a synchronous or asynchronous value.
+ *
+ * @see MaybePromise
+ * @see MaybeThunk
+ */
+export type MaybeAsyncThunk<T> = MaybeThunk<MaybePromise<T>>;
+
+/**
+ * Load a value from a possibly thunk argument.
+ *
+ * If the value is a thunk it is called and the result is returned.
+ * Otherwise the value itself is returned.
+ *
+ * @see MaybeThunk
+ */
+export function loadThunkValue<T>(value: MaybeThunk<T>): T {
+	return typeof value === 'function' ? value() : value;
+}