@endo/module-source 1.0.2 → 1.1.0

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@endo/module-source",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Ponyfill for the SES ModuleSource and module-to-program transformer",
   "keywords": [
     "ses",
@@ -23,12 +23,13 @@
   "main": "./index.js",
   "exports": {
     ".": "./index.js",
+    "./shim.js": "./shim.js",
     "./package.json": "./package.json"
   },
   "scripts": {
     "build": "exit 0",
     "prepack": "tsc --build tsconfig.build.json",
-    "postpack": "git clean -f '*.d.ts*'",
+    "postpack": "git clean -f '*.d.ts*' '*.tsbuildinfo'",
     "cover": "c8 ava",
     "lint": "yarn lint:types && yarn lint:eslint",
     "lint:types": "tsc",
@@ -41,7 +42,7 @@
     "@babel/parser": "^7.23.6",
     "@babel/traverse": "^7.23.6",
     "@babel/types": "^7.24.0",
-    "ses": "^1.8.0"
+    "ses": "^1.9.0"
   },
   "devDependencies": {
     "ava": "^6.1.3",
@@ -54,14 +55,18 @@
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-import": "^2.29.1",
     "prettier": "^3.2.5",
-    "typescript": "~5.6.1-rc"
+    "typescript": "~5.6.2"
   },
   "files": [
+    "./*.d.ts",
+    "./*.js",
+    "./*.map",
     "LICENSE*",
     "SECURITY*",
+    "dist",
+    "lib",
     "src",
-    "*.js",
-    "*.ts"
+    "tools"
   ],
   "publishConfig": {
     "access": "public"
@@ -73,7 +78,6 @@
   },
   "ava": {
     "files": [
-      "test/**/test-*.*",
       "test/**/*.test.*"
     ],
     "timeout": "2m"
@@ -81,5 +85,5 @@
   "typeCoverage": {
     "atLeast": 40.33
   },
-  "gitHead": "cb060b7e22c92cc951fb03d86cdbceeae82fec34"
+  "gitHead": "bbf20fae6726f7d26456714b8852572787d34e05"
 }

package/shim.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shim.d.ts.map

package/shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["shim.js"],"names":[],"mappings":""}

package/shim.js

@@ -0,0 +1,10 @@
+/* global globalThis */
+
+import { ModuleSource } from './index.js';
+
+Object.defineProperty(globalThis, 'ModuleSource', {
+  value: ModuleSource,
+  enumerable: false,
+  writable: true,
+  configurable: true,
+});

package/src/hidden.d.ts

@@ -1,11 +1,11 @@
-export const HIDDEN_PREFIX: "$h‍_";
-export const HIDDEN_CONST_VAR_PREFIX: "$c‍_";
-export const HIDDEN_A: "$h‍_a";
-export const HIDDEN_IMPORT: "$h‍_import";
-export const HIDDEN_IMPORT_SELF: "$h‍_importSelf";
-export const HIDDEN_IMPORTS: "$h‍_imports";
-export const HIDDEN_ONCE: "$h‍_once";
-export const HIDDEN_META: "$h‍____meta";
-export const HIDDEN_LIVE: "$h‍_live";
+export const HIDDEN_PREFIX: "$h͏_";
+export const HIDDEN_CONST_VAR_PREFIX: "$c͏_";
+export const HIDDEN_A: "$h͏_a";
+export const HIDDEN_IMPORT: "$h͏_import";
+export const HIDDEN_IMPORT_SELF: "$h͏_importSelf";
+export const HIDDEN_IMPORTS: "$h͏_imports";
+export const HIDDEN_ONCE: "$h͏_once";
+export const HIDDEN_META: "$h͏____meta";
+export const HIDDEN_LIVE: "$h͏_live";
 export const HIDDEN_IDENTIFIERS: string[];
 //# sourceMappingURL=hidden.d.ts.map

package/src/hidden.js

@@ -1,5 +1,5 @@
-export const HIDDEN_PREFIX = '$h\u200d_';
-export const HIDDEN_CONST_VAR_PREFIX = '$c\u200d_';
+export const HIDDEN_PREFIX = '$h\u034f_';
+export const HIDDEN_CONST_VAR_PREFIX = '$c\u034f_';
 export const HIDDEN_A = `${HIDDEN_PREFIX}a`;
 export const HIDDEN_IMPORT = `${HIDDEN_PREFIX}import`;
 export const HIDDEN_IMPORT_SELF = `${HIDDEN_PREFIX}importSelf`;

package/src/module-source.js

@@ -100,3 +100,32 @@ export function ModuleSource(source, opts = {}) {
   this.__needsImportMeta__ = needsImportMeta;
   freeze(this);
 }
+
+// AbstractModuleSource
+// https://github.com/tc39/proposal-source-phase-imports?tab=readme-ov-file#js-module-source
+//
+// We are attempting to ensure that a JavaScript shim (particularly ses) is
+// forward-compatible as the engine evolves beneath it, with or without this
+// ModuleSource shim, and with our without a native AbstractModuleSource which
+// remains undecided.
+// Lockdown does not gracefully handle the presence of an unexpected prototype,
+// but can tolerate the absence of an expected prototype.
+// So, we are providing AbstractModuleSource since we can better tolerate the
+// various uncertain futures.
+//
+// WebAssembly and ModuleSource are both in motion.
+// The Source Phase Imports proposal implies an additional AbstractModuleSource
+// layer above the existing WebAssembly.Module that would be shared by
+// the JavaScript ModuleSource prototype chains.
+// At time of writing, no version of WebAssembly provides the shared base
+// class, and the ModuleSource *shim* gains nothing from sharing one when that
+// prototype when it comes into being.
+// So, we do not attempt to entangle our AbstractModuleSource with
+// WebAssembly.Module.
+
+function AbstractModuleSource() {
+  // no-op, safe to super()
+}
+
+Object.setPrototypeOf(ModuleSource, AbstractModuleSource);
+Object.setPrototypeOf(ModuleSource.prototype, AbstractModuleSource.prototype);