es-module-shims 1.5.5 → 1.5.8

package/README.md

@@ -29,7 +29,7 @@ Because we are still using the native module loader the edge cases work out comp
 Include ES Module Shims with a `async` attribute on the script, then include an import map and module scripts normally:
 
 ```html
-<script async src="https://ga.jspm.io/npm:es-module-shims@1.5.5/dist/es-module-shims.js"></script>
+<script async src="https://ga.jspm.io/npm:es-module-shims@1.5.8/dist/es-module-shims.js"></script>
 
 <!-- https://generator.jspm.io/#U2NhYGBkDM0rySzJSU1hKEpNTC5xMLTQM9Az0C1K1jMAAKFS5w0gAA -->
 <script type="importmap">
@@ -292,11 +292,22 @@ While in polyfill mode the same restrictions apply that multiple import maps, im
 To make it easy to keep track of import map state, es-module-shims provides a `importShim.getImportMap` utility function, available only in shim mode.
 
 ```js
-const importMap = importShim.getImportMap()
+const importMap = importShim.getImportMap();
 
 // importMap will be an object in the same shape as the json in a importmap script
 ```
 
+#### Setting current import map state
+To make it easy to set the import map state, es-module-shims provides a `importShim.addImportMap` utility function, available only in shim mode.
+
+```js
+// importMap will be an object in the same shape as the json in a importmap script
+const importMap = { imports: {/*...*/}, scopes: {/*...*/} };
+
+importShim.addImportMap(importMap);
+```
+
+
 ### Dynamic Import
 
 > Stability: Stable browser standard
@@ -423,6 +434,34 @@ var resolvedUrl = import.meta.resolve('dep', 'https://site.com/another/scope');
 
 Node.js also implements a similar API, although it's in the process of shifting to a synchronous resolver.
 
+### Module Workers
+ES Module Shims can be used in module workers in browsers that provide dynamic import in worker environments, which at the moment are Chrome(80+), Edge(80+), Safari(15+).
+
+An example of ES Module Shims usage in web workers is provided below:
+```js
+/**
+ * 
+ * @param {string} aURL a string representing the URL of the module script the worker will execute.
+ * @returns {string} The string representing the URL of the script the worker will execute.
+ */
+function getWorkerScriptURL(aURL) {
+  // baseURL, esModuleShimsURL are considered to be known in advance
+  // esModuleShimsURL - must point to the non-CSP build of ES Module Shims, 
+  // namely the `es-module-shim.wasm.js` output: es-module-shims/dist/es-module-shims.wasm.js
+
+  return URL.createObjectURL(new Blob(
+    [
+      `importScripts('${new URL(esModuleShimsURL, baseURL).href}');
+      importShim.addImportMap(${JSON.stringify(importShim.getImportMap())});
+      importShim('${new URL(aURL, baseURL).href}').catch(e => setTimeout(() => { throw e; }))`
+    ],
+    { type: 'application/javascript' }))
+}
+
+const worker = new Worker(getWorkerScriptURL('myEsModule.js'));
+```
+> For now, in web workers must be used the non-CSP build of ES Module Shims, namely the `es-module-shim.wasm.js` output: es-module-shims/dist/es-module-shims.wasm.js.
+
 ## Init Options
 
 Provide a `esmsInitOptions` on the global scope before `es-module-shims` is loaded to configure various aspects of the module loading process:

package/dist/es-module-shims.js

@@ -1,14 +1,17 @@
-/* ES Module Shims 1.5.5 */
+/* ES Module Shims 1.5.8 */
 (function () {
 
+  const hasWindow = typeof window !== 'undefined';
+  const hasDocument = typeof document !== 'undefined';
+
   const noop = () => {};
 
-  const optionsScript = document.querySelector('script[type=esms-options]');
+  const optionsScript = hasDocument ? document.querySelector('script[type=esms-options]') : undefined;
 
   const esmsInitOptions = optionsScript ? JSON.parse(optionsScript.innerHTML) : {};
   Object.assign(esmsInitOptions, self.esmsInitOptions || {});
 
-  let shimMode = !!esmsInitOptions.shimMode;
+  let shimMode = hasDocument ? !!esmsInitOptions.shimMode : true;
 
   const importHook = globalHook(shimMode && esmsInitOptions.onimport);
   const resolveHook = globalHook(shimMode && esmsInitOptions.resolve);
@@ -17,11 +20,10 @@
 
   const skip = esmsInitOptions.skip ? new RegExp(esmsInitOptions.skip) : null;
 
-  let nonce = esmsInitOptions.nonce;
-
   const mapOverrides = esmsInitOptions.mapOverrides;
 
-  if (!nonce) {
+  let nonce = esmsInitOptions.nonce;
+  if (!nonce && hasDocument) {
     const nonceElement = document.querySelector('script[nonce]');
     if (nonceElement)
       nonce = nonceElement.nonce || nonceElement.getAttribute('nonce');
@@ -48,7 +50,11 @@
 
   const edge = !navigator.userAgentData && !!navigator.userAgent.match(/Edge\/\d+\.\d+/);
 
-  const baseUrl = document.baseURI;
+  const baseUrl = hasDocument
+    ? document.baseURI
+    : `${location.protocol}//${location.host}${location.pathname.includes('/') 
+    ? location.pathname.slice(0, location.pathname.lastIndexOf('/') + 1) 
+    : location.pathname}`;
 
   function createBlob (source, type = 'text/javascript') {
     return URL.createObjectURL(new Blob([source], { type }));
@@ -56,7 +62,7 @@
 
   const eoop = err => setTimeout(() => { throw err });
 
-  const throwError = err => { (window.reportError || window.safari && console.error || eoop)(err), void onerror(err); };
+  const throwError = err => { (self.reportError || hasWindow && window.safari && console.error || eoop)(err), void onerror(err); };
 
   function fromParent (parent) {
     return parent ? ` imported from ${parent}` : '';
@@ -273,33 +279,43 @@
   let supportsJsonAssertions = false;
   let supportsCssAssertions = false;
 
-  let supportsImportMeta = false;
-  let supportsImportMaps = false;
-
+  let supportsImportMaps = hasDocument && HTMLScriptElement.supports ? HTMLScriptElement.supports('importmap') : false;
+  let supportsImportMeta = supportsImportMaps;
   let supportsDynamicImport = false;
 
-  const featureDetectionPromise = Promise.resolve(supportsDynamicImportCheck).then(_supportsDynamicImport => {
+  const featureDetectionPromise = Promise.resolve(supportsImportMaps || supportsDynamicImportCheck).then(_supportsDynamicImport => {
     if (!_supportsDynamicImport)
       return;
     supportsDynamicImport = true;
 
     return Promise.all([
-      dynamicImport(createBlob('import.meta')).then(() => supportsImportMeta = true, noop),
-      cssModulesEnabled && dynamicImport(createBlob('import"data:text/css,{}"assert{type:"css"}')).then(() => supportsCssAssertions = true, noop),
-      jsonModulesEnabled && dynamicImport(createBlob('import"data:text/json,{}"assert{type:"json"}')).then(() => supportsJsonAssertions = true, noop),
-      HTMLScriptElement.supports ? supportsImportMaps = HTMLScriptElement.supports('importmap') : new Promise(resolve => {
-        self._$s = v => {
-          document.head.removeChild(iframe);
-          if (v) supportsImportMaps = true;
-          delete self._$s;
-          resolve();
-        };
+      supportsImportMaps || dynamicImport(createBlob('import.meta')).then(() => supportsImportMeta = true, noop),
+      cssModulesEnabled && dynamicImport(createBlob(`import"${createBlob('', 'text/css')}"assert{type:"css"}`)).then(() => supportsCssAssertions = true, noop),
+      jsonModulesEnabled && dynamicImport(createBlob(`import"${createBlob('{}', 'text/json')}"assert{type:"json"}`)).then(() => supportsJsonAssertions = true, noop),
+      supportsImportMaps || hasDocument && (HTMLScriptElement.supports || new Promise(resolve => {
         const iframe = document.createElement('iframe');
         iframe.style.display = 'none';
         iframe.setAttribute('nonce', nonce);
-        iframe.srcdoc = `<script type=importmap nonce="${nonce}">{"imports":{"x":"data:text/javascript,"}}<${''}/script><script nonce="${nonce}">import('x').then(()=>1,()=>0).then(v=>parent._$s(v))<${''}/script>`;
+        // setting src to a blob URL results in a navigation event in webviews
+        // setting srcdoc is not supported in React native webviews on iOS
+        // therefore, we need to first feature detect srcdoc support
+        iframe.srcdoc = `<!doctype html><script nonce="${nonce}"><${''}/script>`;
         document.head.appendChild(iframe);
-      })
+        iframe.onload = () => {
+          self._$s = v => {
+            document.head.removeChild(iframe);
+            supportsImportMaps = v;
+            delete self._$s;
+            resolve();
+          };
+          const supportsSrcDoc = iframe.contentDocument.head.childNodes.length > 0;
+          const importMapTest = `<!doctype html><script type=importmap nonce="${nonce}">{"imports":{"x":"${createBlob('')}"}<${''}/script><script nonce="${nonce}">import('x').catch(() => {}).then(v=>parent._$s(!!v))<${''}/script>`;
+          if (supportsSrcDoc)
+            iframe.srcdoc = importMapTest;
+          else
+            iframe.contentDocument.write(importMapTest);
+        };
+      }))
     ]);
   });
 
@@ -336,7 +352,9 @@
     await initPromise;
     if (importHook) await importHook(id, typeof args[1] !== 'string' ? args[1] : {}, parentUrl);
     if (acceptingImportMaps || shimMode || !baselinePassthrough) {
-      processImportMaps();
+      if (hasDocument)
+        processImportMaps();
+
       if (!shimMode)
         acceptingImportMaps = false;
     }
@@ -366,6 +384,10 @@
 
   importShim.resolve = resolveSync;
   importShim.getImportMap = () => JSON.parse(JSON.stringify(importMap));
+  importShim.addImportMap = importMapIn => {
+    if (!shimMode) throw new Error('Unsupported in polyfill mode.');
+    importMap = resolveAndComposeImportMap(importMapIn, baseUrl, importMap);
+  };
 
   const registry = importShim._r = {};
 
@@ -404,44 +426,47 @@
       }
     }
     baselinePassthrough = esmsInitOptions.polyfillEnable !== true && supportsDynamicImport && supportsImportMeta && supportsImportMaps && (!jsonModulesEnabled || supportsJsonAssertions) && (!cssModulesEnabled || supportsCssAssertions) && !importMapSrcOrLazy && !false;
-    if (!supportsImportMaps) {
-      const supports = HTMLScriptElement.supports || (type => type === 'classic' || type === 'module');
-      HTMLScriptElement.supports = type => type === 'importmap' || supports(type);
-    }
-    if (shimMode || !baselinePassthrough) {
-      new MutationObserver(mutations => {
-        for (const mutation of mutations) {
-          if (mutation.type !== 'childList') continue;
-          for (const node of mutation.addedNodes) {
-            if (node.tagName === 'SCRIPT') {
-              if (node.type === (shimMode ? 'module-shim' : 'module'))
-                processScript(node);
-              if (node.type === (shimMode ? 'importmap-shim' : 'importmap'))
-                processImportMap(node);
+    if (hasDocument) {
+      if (!supportsImportMaps) {
+        const supports = HTMLScriptElement.supports || (type => type === 'classic' || type === 'module');
+        HTMLScriptElement.supports = type => type === 'importmap' || supports(type);
+      }
+
+      if (shimMode || !baselinePassthrough) {
+        new MutationObserver(mutations => {
+          for (const mutation of mutations) {
+            if (mutation.type !== 'childList') continue;
+            for (const node of mutation.addedNodes) {
+              if (node.tagName === 'SCRIPT') {
+                if (node.type === (shimMode ? 'module-shim' : 'module'))
+                  processScript(node);
+                if (node.type === (shimMode ? 'importmap-shim' : 'importmap'))
+                  processImportMap(node);
+              }
+              else if (node.tagName === 'LINK' && node.rel === (shimMode ? 'modulepreload-shim' : 'modulepreload'))
+                processPreload(node);
             }
-            else if (node.tagName === 'LINK' && node.rel === (shimMode ? 'modulepreload-shim' : 'modulepreload'))
-              processPreload(node);
           }
+        }).observe(document, {childList: true, subtree: true});
+        processImportMaps();
+        processScriptsAndPreloads();
+        if (document.readyState === 'complete') {
+          readyStateCompleteCheck();
         }
-      }).observe(document, { childList: true, subtree: true });
-      processImportMaps();
-      processScriptsAndPreloads();
-      if (document.readyState === 'complete') {
-        readyStateCompleteCheck();
-      }
-      else {
-        async function readyListener () {
-          await initPromise;
-          processImportMaps();
-          if (document.readyState === 'complete') {
-            readyStateCompleteCheck();
-            document.removeEventListener('readystatechange', readyListener);
+        else {
+          async function readyListener() {
+            await initPromise;
+            processImportMaps();
+            if (document.readyState === 'complete') {
+              readyStateCompleteCheck();
+              document.removeEventListener('readystatechange', readyListener);
+            }
           }
+          document.addEventListener('readystatechange', readyListener);
         }
-        document.addEventListener('readystatechange', readyListener);
       }
-      return undefined;
     }
+    return undefined;
   });
   let importMapPromise = initPromise;
   let firstPolyfillLoad = true;
@@ -521,7 +546,7 @@
     const source = load.S;
 
     // edge doesnt execute sibling in order, so we fix this up by ensuring all previous executions are explicit dependencies
-    let resolvedSource = edge && lastLoad ? `import '${lastLoad}';` : '';  
+    let resolvedSource = edge && lastLoad ? `import '${lastLoad}';` : '';
 
     if (!imports.length) {
       resolvedSource += source;
@@ -562,7 +587,7 @@
           resolvedSource += `/*${source.slice(start - 1, statementEnd)}*/${urlJsString(blobUrl)}`;
 
           // circular shell execution
-          if (!cycleShell && depLoad.s) {          
+          if (!cycleShell && depLoad.s) {
             resolvedSource += `;import*as m$_${depIndex} from'${depLoad.b}';import{u$_ as u$_${depIndex}}from'${depLoad.s}';u$_${depIndex}(m$_${depIndex})`;
             depLoad.s = undefined;
           }
@@ -649,8 +674,8 @@
       return { r: res.url, s: `export default ${await res.text()}`, t: 'json' };
     else if (cssContentType.test(contentType)) {
       return { r: res.url, s: `var s=new CSSStyleSheet();s.replaceSync(${
-      JSON.stringify((await res.text()).replace(cssUrlRegEx, (_match, quotes = '', relUrl1, relUrl2) => `url(${quotes}${resolveUrl(relUrl1 || relUrl2, url)}${quotes})`))
-    });export default s;`, t: 'css' };
+        JSON.stringify((await res.text()).replace(cssUrlRegEx, (_match, quotes = '', relUrl1, relUrl2) => `url(${quotes}${resolveUrl(relUrl1 || relUrl2, url)}${quotes})`))
+      });export default s;`, t: 'css' };
     }
     else
       throw Error(`Unsupported Content-Type "${contentType}" loading ${url}${fromParent(parent)}. Modules must be served with a valid MIME type like application/javascript.`);
@@ -720,7 +745,7 @@
     load.L = load.f.then(async () => {
       let childFetchOpts = fetchOpts;
       load.d = (await Promise.all(load.a[0].map(async ({ n, d }) => {
-        if (d >= 0 && !supportsDynamicImport || d === 2 && !supportsImportMeta)
+        if (d >= 0 && !supportsDynamicImport || d === -2 && !supportsImportMeta)
           load.n = true;
         if (d !== -1 || !n) return;
         const { r, b } = await resolve(n, load.r || load.u);
@@ -771,14 +796,16 @@
       document.dispatchEvent(new Event('DOMContentLoaded'));
   }
   // this should always trigger because we assume es-module-shims is itself a domcontentloaded requirement
-  document.addEventListener('DOMContentLoaded', async () => {
-    await initPromise;
-    domContentLoadedCheck();
-    if (shimMode || !baselinePassthrough) {
-      processImportMaps();
-      processScriptsAndPreloads();
-    }
-  });
+  if (hasDocument) {
+    document.addEventListener('DOMContentLoaded', async () => {
+      await initPromise;
+      domContentLoadedCheck();
+      if (shimMode || !baselinePassthrough) {
+        processImportMaps();
+        processScriptsAndPreloads();
+      }
+    });
+  }
 
   let readyStateCompleteCnt = 1;
   function readyStateCompleteCheck () {

package/dist/es-module-shims.wasm.js

@@ -1,14 +1,17 @@
-/* ES Module Shims Wasm 1.5.5 */
+/* ES Module Shims Wasm 1.5.8 */
 (function () {
 
+  const hasWindow = typeof window !== 'undefined';
+  const hasDocument = typeof document !== 'undefined';
+
   const noop = () => {};
 
-  const optionsScript = document.querySelector('script[type=esms-options]');
+  const optionsScript = hasDocument ? document.querySelector('script[type=esms-options]') : undefined;
 
   const esmsInitOptions = optionsScript ? JSON.parse(optionsScript.innerHTML) : {};
   Object.assign(esmsInitOptions, self.esmsInitOptions || {});
 
-  let shimMode = !!esmsInitOptions.shimMode;
+  let shimMode = hasDocument ? !!esmsInitOptions.shimMode : true;
 
   const importHook = globalHook(shimMode && esmsInitOptions.onimport);
   const resolveHook = globalHook(shimMode && esmsInitOptions.resolve);
@@ -17,11 +20,10 @@
 
   const skip = esmsInitOptions.skip ? new RegExp(esmsInitOptions.skip) : null;
 
-  let nonce = esmsInitOptions.nonce;
-
   const mapOverrides = esmsInitOptions.mapOverrides;
 
-  if (!nonce) {
+  let nonce = esmsInitOptions.nonce;
+  if (!nonce && hasDocument) {
     const nonceElement = document.querySelector('script[nonce]');
     if (nonceElement)
       nonce = nonceElement.nonce || nonceElement.getAttribute('nonce');
@@ -48,7 +50,11 @@
 
   const edge = !navigator.userAgentData && !!navigator.userAgent.match(/Edge\/\d+\.\d+/);
 
-  const baseUrl = document.baseURI;
+  const baseUrl = hasDocument
+    ? document.baseURI
+    : `${location.protocol}//${location.host}${location.pathname.includes('/') 
+    ? location.pathname.slice(0, location.pathname.lastIndexOf('/') + 1) 
+    : location.pathname}`;
 
   function createBlob (source, type = 'text/javascript') {
     return URL.createObjectURL(new Blob([source], { type }));
@@ -56,7 +62,7 @@
 
   const eoop = err => setTimeout(() => { throw err });
 
-  const throwError = err => { (window.reportError || window.safari && console.error || eoop)(err), void onerror(err); };
+  const throwError = err => { (self.reportError || hasWindow && window.safari && console.error || eoop)(err), void onerror(err); };
 
   function fromParent (parent) {
     return parent ? ` imported from ${parent}` : '';
@@ -234,6 +240,15 @@
 
   let supportsDynamicImportCheck = false;
 
+  // first check basic eval support
+  try {
+    eval('');
+  }
+  catch (e) {
+    throw new Error(`The ES Module Shims Wasm build will not work without eval support. Either use the alternative CSP-compatible build or make sure to add both the "unsafe-eval" and "unsafe-wasm-eval" CSP policies.`);
+  }
+
+  // polyfill dynamic import if not supported
   let dynamicImport;
   try {
     dynamicImport = (0, eval)('u=>import(u)');
@@ -241,7 +256,7 @@
   }
   catch (e) {}
 
-  if (!supportsDynamicImportCheck) {
+  if (hasDocument && !supportsDynamicImportCheck) {
     let err;
     window.addEventListener('error', _err => err = _err);
     dynamicImport = (url, { errUrl = url }) => {
@@ -249,7 +264,6 @@
       const src = createBlob(`import*as m from'${url}';self._esmsi=m;`);
       const s = Object.assign(document.createElement('script'), { type: 'module', src });
       s.setAttribute('noshim', '');
-      s.setAttribute('nonce', nonce);
       document.head.appendChild(s);
       return new Promise((resolve, reject) => {
         s.addEventListener('load', () => {
@@ -271,33 +285,43 @@
   let supportsJsonAssertions = false;
   let supportsCssAssertions = false;
 
-  let supportsImportMeta = false;
-  let supportsImportMaps = false;
-
+  let supportsImportMaps = hasDocument && HTMLScriptElement.supports ? HTMLScriptElement.supports('importmap') : false;
+  let supportsImportMeta = supportsImportMaps;
   let supportsDynamicImport = false;
 
-  const featureDetectionPromise = Promise.resolve(supportsDynamicImportCheck).then(_supportsDynamicImport => {
+  const featureDetectionPromise = Promise.resolve(supportsImportMaps || supportsDynamicImportCheck).then(_supportsDynamicImport => {
     if (!_supportsDynamicImport)
       return;
     supportsDynamicImport = true;
 
     return Promise.all([
-      dynamicImport(createBlob('import.meta')).then(() => supportsImportMeta = true, noop),
-      cssModulesEnabled && dynamicImport(createBlob('import"data:text/css,{}"assert{type:"css"}')).then(() => supportsCssAssertions = true, noop),
-      jsonModulesEnabled && dynamicImport(createBlob('import"data:text/json,{}"assert{type:"json"}')).then(() => supportsJsonAssertions = true, noop),
-      HTMLScriptElement.supports ? supportsImportMaps = HTMLScriptElement.supports('importmap') : new Promise(resolve => {
-        self._$s = v => {
-          document.head.removeChild(iframe);
-          if (v) supportsImportMaps = true;
-          delete self._$s;
-          resolve();
-        };
+      supportsImportMaps || dynamicImport(createBlob('import.meta')).then(() => supportsImportMeta = true, noop),
+      cssModulesEnabled && dynamicImport(createBlob(`import"${createBlob('', 'text/css')}"assert{type:"css"}`)).then(() => supportsCssAssertions = true, noop),
+      jsonModulesEnabled && dynamicImport(createBlob(`import"${createBlob('{}', 'text/json')}"assert{type:"json"}`)).then(() => supportsJsonAssertions = true, noop),
+      supportsImportMaps || hasDocument && (HTMLScriptElement.supports || new Promise(resolve => {
         const iframe = document.createElement('iframe');
         iframe.style.display = 'none';
         iframe.setAttribute('nonce', nonce);
-        iframe.srcdoc = `<script type=importmap nonce="${nonce}">{"imports":{"x":"data:text/javascript,"}}<${''}/script><script nonce="${nonce}">import('x').then(()=>1,()=>0).then(v=>parent._$s(v))<${''}/script>`;
+        // setting src to a blob URL results in a navigation event in webviews
+        // setting srcdoc is not supported in React native webviews on iOS
+        // therefore, we need to first feature detect srcdoc support
+        iframe.srcdoc = `<!doctype html><script nonce="${nonce}"><${''}/script>`;
         document.head.appendChild(iframe);
-      })
+        iframe.onload = () => {
+          self._$s = v => {
+            document.head.removeChild(iframe);
+            supportsImportMaps = v;
+            delete self._$s;
+            resolve();
+          };
+          const supportsSrcDoc = iframe.contentDocument.head.childNodes.length > 0;
+          const importMapTest = `<!doctype html><script type=importmap nonce="${nonce}">{"imports":{"x":"${createBlob('')}"}<${''}/script><script nonce="${nonce}">import('x').catch(() => {}).then(v=>parent._$s(!!v))<${''}/script>`;
+          if (supportsSrcDoc)
+            iframe.srcdoc = importMapTest;
+          else
+            iframe.contentDocument.write(importMapTest);
+        };
+      }))
     ]);
   });
 
@@ -334,7 +358,9 @@
     await initPromise;
     if (importHook) await importHook(id, typeof args[1] !== 'string' ? args[1] : {}, parentUrl);
     if (acceptingImportMaps || shimMode || !baselinePassthrough) {
-      processImportMaps();
+      if (hasDocument)
+        processImportMaps();
+
       if (!shimMode)
         acceptingImportMaps = false;
     }
@@ -364,6 +390,10 @@
 
   importShim.resolve = resolveSync;
   importShim.getImportMap = () => JSON.parse(JSON.stringify(importMap));
+  importShim.addImportMap = importMapIn => {
+    if (!shimMode) throw new Error('Unsupported in polyfill mode.');
+    importMap = resolveAndComposeImportMap(importMapIn, baseUrl, importMap);
+  };
 
   const registry = importShim._r = {};
 
@@ -402,44 +432,47 @@
       }
     }
     baselinePassthrough = esmsInitOptions.polyfillEnable !== true && supportsDynamicImport && supportsImportMeta && supportsImportMaps && (!jsonModulesEnabled || supportsJsonAssertions) && (!cssModulesEnabled || supportsCssAssertions) && !importMapSrcOrLazy && !false;
-    if (!supportsImportMaps) {
-      const supports = HTMLScriptElement.supports || (type => type === 'classic' || type === 'module');
-      HTMLScriptElement.supports = type => type === 'importmap' || supports(type);
-    }
-    if (shimMode || !baselinePassthrough) {
-      new MutationObserver(mutations => {
-        for (const mutation of mutations) {
-          if (mutation.type !== 'childList') continue;
-          for (const node of mutation.addedNodes) {
-            if (node.tagName === 'SCRIPT') {
-              if (node.type === (shimMode ? 'module-shim' : 'module'))
-                processScript(node);
-              if (node.type === (shimMode ? 'importmap-shim' : 'importmap'))
-                processImportMap(node);
+    if (hasDocument) {
+      if (!supportsImportMaps) {
+        const supports = HTMLScriptElement.supports || (type => type === 'classic' || type === 'module');
+        HTMLScriptElement.supports = type => type === 'importmap' || supports(type);
+      }
+
+      if (shimMode || !baselinePassthrough) {
+        new MutationObserver(mutations => {
+          for (const mutation of mutations) {
+            if (mutation.type !== 'childList') continue;
+            for (const node of mutation.addedNodes) {
+              if (node.tagName === 'SCRIPT') {
+                if (node.type === (shimMode ? 'module-shim' : 'module'))
+                  processScript(node);
+                if (node.type === (shimMode ? 'importmap-shim' : 'importmap'))
+                  processImportMap(node);
+              }
+              else if (node.tagName === 'LINK' && node.rel === (shimMode ? 'modulepreload-shim' : 'modulepreload'))
+                processPreload(node);
             }
-            else if (node.tagName === 'LINK' && node.rel === (shimMode ? 'modulepreload-shim' : 'modulepreload'))
-              processPreload(node);
           }
+        }).observe(document, {childList: true, subtree: true});
+        processImportMaps();
+        processScriptsAndPreloads();
+        if (document.readyState === 'complete') {
+          readyStateCompleteCheck();
         }
-      }).observe(document, { childList: true, subtree: true });
-      processImportMaps();
-      processScriptsAndPreloads();
-      if (document.readyState === 'complete') {
-        readyStateCompleteCheck();
-      }
-      else {
-        async function readyListener () {
-          await initPromise;
-          processImportMaps();
-          if (document.readyState === 'complete') {
-            readyStateCompleteCheck();
-            document.removeEventListener('readystatechange', readyListener);
+        else {
+          async function readyListener() {
+            await initPromise;
+            processImportMaps();
+            if (document.readyState === 'complete') {
+              readyStateCompleteCheck();
+              document.removeEventListener('readystatechange', readyListener);
+            }
           }
+          document.addEventListener('readystatechange', readyListener);
         }
-        document.addEventListener('readystatechange', readyListener);
       }
-      return init;
     }
+    return init;
   });
   let importMapPromise = initPromise;
   let firstPolyfillLoad = true;
@@ -519,7 +552,7 @@
     const source = load.S;
 
     // edge doesnt execute sibling in order, so we fix this up by ensuring all previous executions are explicit dependencies
-    let resolvedSource = edge && lastLoad ? `import '${lastLoad}';` : '';  
+    let resolvedSource = edge && lastLoad ? `import '${lastLoad}';` : '';
 
     if (!imports.length) {
       resolvedSource += source;
@@ -560,7 +593,7 @@
           resolvedSource += `/*${source.slice(start - 1, statementEnd)}*/${urlJsString(blobUrl)}`;
 
           // circular shell execution
-          if (!cycleShell && depLoad.s) {          
+          if (!cycleShell && depLoad.s) {
             resolvedSource += `;import*as m$_${depIndex} from'${depLoad.b}';import{u$_ as u$_${depIndex}}from'${depLoad.s}';u$_${depIndex}(m$_${depIndex})`;
             depLoad.s = undefined;
           }
@@ -647,8 +680,8 @@
       return { r: res.url, s: `export default ${await res.text()}`, t: 'json' };
     else if (cssContentType.test(contentType)) {
       return { r: res.url, s: `var s=new CSSStyleSheet();s.replaceSync(${
-      JSON.stringify((await res.text()).replace(cssUrlRegEx, (_match, quotes = '', relUrl1, relUrl2) => `url(${quotes}${resolveUrl(relUrl1 || relUrl2, url)}${quotes})`))
-    });export default s;`, t: 'css' };
+        JSON.stringify((await res.text()).replace(cssUrlRegEx, (_match, quotes = '', relUrl1, relUrl2) => `url(${quotes}${resolveUrl(relUrl1 || relUrl2, url)}${quotes})`))
+      });export default s;`, t: 'css' };
     }
     else
       throw Error(`Unsupported Content-Type "${contentType}" loading ${url}${fromParent(parent)}. Modules must be served with a valid MIME type like application/javascript.`);
@@ -718,7 +751,7 @@
     load.L = load.f.then(async () => {
       let childFetchOpts = fetchOpts;
       load.d = (await Promise.all(load.a[0].map(async ({ n, d }) => {
-        if (d >= 0 && !supportsDynamicImport || d === 2 && !supportsImportMeta)
+        if (d >= 0 && !supportsDynamicImport || d === -2 && !supportsImportMeta)
           load.n = true;
         if (d !== -1 || !n) return;
         const { r, b } = await resolve(n, load.r || load.u);
@@ -769,14 +802,16 @@
       document.dispatchEvent(new Event('DOMContentLoaded'));
   }
   // this should always trigger because we assume es-module-shims is itself a domcontentloaded requirement
-  document.addEventListener('DOMContentLoaded', async () => {
-    await initPromise;
-    domContentLoadedCheck();
-    if (shimMode || !baselinePassthrough) {
-      processImportMaps();
-      processScriptsAndPreloads();
-    }
-  });
+  if (hasDocument) {
+    document.addEventListener('DOMContentLoaded', async () => {
+      await initPromise;
+      domContentLoadedCheck();
+      if (shimMode || !baselinePassthrough) {
+        processImportMaps();
+        processScriptsAndPreloads();
+      }
+    });
+  }
 
   let readyStateCompleteCnt = 1;
   function readyStateCompleteCheck () {

package/index.d.ts

@@ -18,7 +18,7 @@ interface ESMSInitOptions {
   /**
    * Disable retriggering of document readystate
    */
-  noLoadEventRetriggers: true,
+  noLoadEventRetriggers: true;
 
   /**
    * #### Skip Processing Stability
@@ -45,24 +45,28 @@ interface ESMSInitOptions {
 
   /**
    * #### Error hook
-   * 
+   *
    * Register a callback for any ES Module Shims module errors.
-   * 
+   *
    */
   onerror: (e: any) => any;
 
   /**
    * #### Resolve Hook
-   * 
+   *
    * Only supported in Shim Mode.
-   * 
+   *
    * Provide a custom resolver function.
    */
-  resolve: (id: string, parentUrl: string, resolve: (id: string, parentUrl: string) => string) => string | Promise<string>;
+  resolve: (
+    id: string,
+    parentUrl: string,
+    resolve: (id: string, parentUrl: string) => string
+  ) => string | Promise<string>;
 
   /**
    * #### Fetch Hook
-   * 
+   *
    * Only supported in Shim Mode.
    *
    * > Stability: Non-spec feature
@@ -126,14 +130,19 @@ interface ESMSInitOptions {
 
   /**
    * #### Revoke Blob URLs
-   * 
+   *
    * Set to *true* to cleanup blob URLs from memory after execution.
    * Can cost some compute time for large loads.
-   * 
+   *
    */
   revokeBlobURLs: boolean;
 }
 
+interface ImportMap {
+  imports: Record<string, string>;
+  scopes: Record<string, Record<string, string>>;
+}
+
 /**
  * Dynamic import(...) within any modules loaded will be rewritten as
  * importShim(...) automatically providing full support for all es-module-shims
@@ -151,6 +160,12 @@ declare function importShim<Default, Exports extends object>(
   parentUrl?: string
 ): Promise<{ default: Default } & Exports>;
 
+declare namespace importShim {
+  const resolve: (id: string, parentURL?: string) => string;
+  const addImportMap: (importMap: Partial<ImportMap>) => void;
+  const getImportMap: () => ImportMap;
+}
+
 interface Window {
   esmsInitOptions?: ESMSInitOptions;
   importShim: typeof importShim;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-module-shims",
-  "version": "1.5.5",
+  "version": "1.5.8",
   "description": "Shims for the latest ES module features",
   "main": "dist/es-module-shims.js",
   "exports": {