@webreflection/utils 0.2.4 → 0.2.6

package/README.md

@@ -34,4 +34,10 @@ resolve(4);
 
 boundOnce(Promise).all === all;
 boundOnce(Promise).resolve === resolve;
+
+// example: do not import or export same module
+
+import sticky from '@webreflection/utils/sticky-module';
+
+export default sticky('@module/name', { always: 'same' });
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webreflection/utils",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "types": {
     "./bound-once": "./types/bound-once.d.ts",
@@ -21,6 +21,10 @@
       "types": "./types/shared-array-buffer.d.ts",
       "import": "./src/shared-array-buffer.js"
     },
+    "./sticky-module": {
+      "types": "./types/sticky-module.d.ts",
+      "import": "./src/sticky-module.js"
+    },
     "./with-resolvers": {
       "types": "./types/with-resolvers.d.ts",
       "import": "./src/with-resolvers.js"
@@ -31,6 +35,7 @@
     "bound-once",
     "bound",
     "shared-array-buffer",
+    "sticky-module",
     "with-resolvers"
   ],
   "scripts": {

package/src/bound-once.js

@@ -4,9 +4,9 @@ const $ = Symbol.for('@webreflection/utils/bound-once');
 
 // @ts-ignore
 const methods = globalThis[$] || Object.defineProperty(
-    globalThis,
-    $,
-    { value: new WeakMap },
+  globalThis,
+  $,
+  { value: new WeakMap },
 )[$];
 
 /**
@@ -27,7 +27,6 @@ const handler = {
  * @returns {import('./bound.js').Bound<T>}
  */
 export default target => {
-  let known = methods.get(target);
-  if (!known) methods.set(target, (known = new Map));
+  if (!methods.has(target)) methods.set(target, new Map);
   return new Proxy(target, handler);
 };

package/src/sticky-module.js

@@ -0,0 +1,27 @@
+//@ts-check
+
+const { defineProperty } = Object;
+const { for: symbolFor } = Symbol;
+
+/**
+ * Allow leaking a module globally to help avoid conflicting exports
+ * if the module might have been re-bundled in other projects.
+ * @template T
+ * @param {string} name the module name to save or retrieve
+ * @param {T} value the module as value to save if not known
+ * @param {globalThis} [global=globalThis] the reference where modules are saved where `globalThis` is the default
+ * @returns {[T, boolean]} the passed `value` or the previous one as first entry, a boolean indicating if it was known or not
+ */
+export default (name, value, global = globalThis) => {
+  /** @type {symbol} */
+  const symbol = symbolFor(name);
+  const known = symbol in global;
+  return [
+    known ?
+      // @ts-ignore
+      global[symbol] :
+      // @ts-ignore
+      defineProperty(global, symbol, { value })[symbol],
+    known,
+  ];
+};

package/types/sticky-module.d.ts

@@ -0,0 +1,2 @@
+declare function _default<T>(name: string, value: T, global?: typeof globalThis): [T, boolean];
+export default _default;