Implement transform support for using declarations

.gitignore

@@ -29,6 +29,7 @@ package-lock.json
 /packages/babel-core/src/vendor/*.ts
 
 /packages/babel-runtime/helpers/*.js
+!/packages/babel-runtime/helpers/dispose.js
 !/packages/babel-runtime/helpers/toArray.js
 !/packages/babel-runtime/helpers/iterableToArray.js
 !/packages/babel-runtime/helpers/possibleConstructorReturn.js
@@ -55,6 +56,7 @@ package-lock.json
 !/packages/babel-runtime-corejs2/core-js/map.js
 
 /packages/babel-runtime-corejs3/helpers/*.js
+!/packages/babel-runtime-corejs3/helpers/dispose.js
 !/packages/babel-runtime-corejs3/helpers/possibleConstructorReturn.js
 /packages/babel-runtime-corejs3/helpers/esm/*.js
 !/packages/babel-runtime-corejs3/helpers/esm/possibleConstructorReturn.js

Makefile.source.mjs

@@ -456,10 +456,13 @@ target["new-version-checklist"] = function () {
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !!!!!!                                                   !!!!!!
-!!!!!!              Update the version in                !!!!!!
-!!!!!! packages/babel-plugin-syntax-import-attributes/src/index.ts
-!!!!!!                    and                            !!!!!!
-!!!!!! /Users/nic/Documents/dev/babel/babel/packages/babel-preset-env/src/available-plugins.ts#L159
+!!!!!! - Update the version in the                       !!!!!!
+!!!!!!   syntax-import-attributes plugin and in          !!!!!!
+!!!!!!   babel-preset-env/src/available-plugins.ts#L159  !!!!!!
+!!!!!! - Update the version in the using and dispose     !!!!!!
+!!!!!!   helpers                                         !!!!!!
+!!!!!! - Update the version in the                       !!!!!!
+!!!!!    proposal-explicit-resource-management plugin    !!!!!!
 !!!!!!                                                   !!!!!!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

packages/babel-helpers/src/helpers-generated.ts

@@ -61,6 +61,10 @@ export default Object.freeze({
     "7.20.7",
     "export default function _defineAccessor(type,obj,key,fn){var desc={configurable:!0,enumerable:!0};return desc[type]=fn,Object.defineProperty(obj,key,desc)}",
   ),
+  dispose: helper(
+    "7.0.0-beta.0",
+    'function dispose_SuppressedError(suppressed,error){return"undefined"!=typeof SuppressedError?dispose_SuppressedError=SuppressedError:(dispose_SuppressedError=function(suppressed,error){this.suppressed=suppressed,this.error=error,this.stack=(new Error).stack},dispose_SuppressedError.prototype=Object.create(Error.prototype,{constructor:{value:dispose_SuppressedError,writable:!0,configurable:!0}})),new dispose_SuppressedError(suppressed,error)}export default function _dispose(stack,error,hasError){function next(){if(0!==stack.length){var r=stack.pop();if(r.a)return Promise.resolve(r.d.call(r.v)).then(next,err);try{r.d.call(r.v)}catch(e){return err(e)}return next()}if(hasError)throw error}function err(e){return error=hasError?new dispose_SuppressedError(e,error):e,hasError=!0,next()}return next()}',
+  ),
   iterableToArrayLimit: helper(
     "7.0.0-beta.0",
     'export default function _iterableToArrayLimit(arr,i){var _i=null==arr?null:"undefined"!=typeof Symbol&&arr[Symbol.iterator]||arr["@@iterator"];if(null!=_i){var _s,_e,_x,_r,_arr=[],_n=!0,_d=!1;try{if(_x=(_i=_i.call(arr)).next,0===i){if(Object(_i)!==_i)return;_n=!1}else for(;!(_n=(_s=_x.call(_i)).done)&&(_arr.push(_s.value),_arr.length!==i);_n=!0);}catch(err){_d=!0,_e=err}finally{try{if(!_n&&null!=_i.return&&(_r=_i.return(),Object(_r)!==_r))return}finally{if(_d)throw _e}}return _arr}}',
@@ -85,6 +89,10 @@ export default Object.freeze({
     "7.0.0-beta.0",
     'export default function _typeof(obj){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(obj){return typeof obj}:function(obj){return obj&&"function"==typeof Symbol&&obj.constructor===Symbol&&obj!==Symbol.prototype?"symbol":typeof obj},_typeof(obj)}',
   ),
+  using: helper(
+    "7.0.0-beta.0",
+    'export default function _using(stack,value,isAwait){if(null==value)return value;if("object"!=typeof value)throw new TypeError("using decarations can only be used with objects, null, or undefined.");if(isAwait)var dispose=value[Symbol.asyncDispose||Symbol.for("Symbol.asyncDispose")];if(null==dispose&&(dispose=value[Symbol.dispose||Symbol.for("Symbol.dispose")]),"function"!=typeof dispose)throw new TypeError("Property [Symbol.dispose] is not a function.");return stack.push({v:value,d:dispose,a:isAwait}),value}',
+  ),
   wrapRegExp: helper(
     "7.19.0",
     'import setPrototypeOf from"setPrototypeOf";import inherits from"inherits";export default function _wrapRegExp(){_wrapRegExp=function(re,groups){return new BabelRegExp(re,void 0,groups)};var _super=RegExp.prototype,_groups=new WeakMap;function BabelRegExp(re,flags,groups){var _this=new RegExp(re,flags);return _groups.set(_this,groups||_groups.get(re)),setPrototypeOf(_this,BabelRegExp.prototype)}function buildGroups(result,re){var g=_groups.get(re);return Object.keys(g).reduce((function(groups,name){var i=g[name];if("number"==typeof i)groups[name]=result[i];else{for(var k=0;void 0===result[i[k]]&&k+1<i.length;)k++;groups[name]=result[i[k]]}return groups}),Object.create(null))}return inherits(BabelRegExp,RegExp),BabelRegExp.prototype.exec=function(str){var result=_super.exec.call(this,str);if(result){result.groups=buildGroups(result,this);var indices=result.indices;indices&&(indices.groups=buildGroups(indices,this))}return result},BabelRegExp.prototype[Symbol.replace]=function(str,substitution){if("string"==typeof substitution){var groups=_groups.get(this);return _super[Symbol.replace].call(this,str,substitution.replace(/\\$<([^>]+)>/g,(function(_,name){var group=groups[name];return"$"+(Array.isArray(group)?group.join("$"):group)})))}if("function"==typeof substitution){var _this=this;return _super[Symbol.replace].call(this,str,(function(){var args=arguments;return"object"!=typeof args[args.length-1]&&(args=[].slice.call(args)).push(buildGroups(args,_this)),substitution.apply(this,args)}))}return _super[Symbol.replace].call(this,str,substitution)},_wrapRegExp.apply(this,arguments)}',

packages/babel-helpers/src/helpers/dispose.js

@@ -0,0 +1,50 @@
+/* @minVersion 7.0.0-beta.0 */
+function dispose_SuppressedError(suppressed, error) {
+  if (typeof SuppressedError !== "undefined") {
+    // eslint-disable-next-line no-undef
+    dispose_SuppressedError = SuppressedError;
+  } else {
+    dispose_SuppressedError = function SuppressedError(suppressed, error) {
+      this.suppressed = suppressed;
+      this.error = error;
+      this.stack = new Error().stack;
+    };
+    dispose_SuppressedError.prototype = Object.create(Error.prototype, {
+      constructor: {
+        value: dispose_SuppressedError,
+        writable: true,
+        configurable: true,
+      },
+    });
+  }
+  return new dispose_SuppressedError(suppressed, error);
+}
+
+export default function _dispose(stack, error, hasError) {
+  function next() {
+    if (stack.length === 0) {
+      if (hasError) throw error;
+      return;
+    }
+
+    var r = stack.pop();
+    if (r.a) {
+      return Promise.resolve(r.d.call(r.v)).then(next, err);
+    }
+    try {
+      r.d.call(r.v);
+    } catch (e) {
+      return err(e);
+    }
+    return next();
+  }
+
+  function err(e) {
+    error = hasError ? new dispose_SuppressedError(e, error) : e;
+    hasError = true;
+
+    return next();
+  }
+
+  return next();
+}

packages/babel-helpers/src/helpers/using.js

@@ -0,0 +1,23 @@
+/* @minVersion 7.0.0-beta.0 */
+
+export default function _using(stack, value, isAwait) {
+  if (value === null || value === void 0) return value;
+  if (typeof value !== "object") {
+    throw new TypeError(
+      "using decarations can only be used with objects, null, or undefined."
+    );
+  }
+  // core-js-pure uses Symbol.for for polyfilling well-known symbols
+  if (isAwait) {
+    var dispose =
+      value[Symbol.asyncDispose || Symbol.for("Symbol.asyncDispose")];
+  }
+  if (dispose === null || dispose === void 0) {
+    dispose = value[Symbol.dispose || Symbol.for("Symbol.dispose")];
+  }
+  if (typeof dispose !== "function") {
+    throw new TypeError(`Property [Symbol.dispose] is not a function.`);
+  }
+  stack.push({ v: value, d: dispose, a: isAwait });
+  return value;
+}

packages/babel-plugin-proposal-explicit-resource-management/.npmignore

@@ -0,0 +1,3 @@
+src
+test
+*.log

packages/babel-plugin-proposal-explicit-resource-management/README.md

@@ -0,0 +1,19 @@
+# @babel/plugin-proposal-explicit-resource-managements
+
+> Compile `using` declarations to ES2015
+
+See our website [@babel/plugin-proposal-explicit-resource-managements](https://babeljs.io/docs/en/babel-plugin-proposal-explicit-resource-managements) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save-dev @babel/plugin-proposal-explicit-resource-managements
+```
+
+or using yarn:
+
+```sh
+yarn add @babel/plugin-proposal-explicit-resource-managements --dev
+```

packages/babel-plugin-proposal-explicit-resource-management/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@babel/plugin-proposal-explicit-resource-management",
+  "version": "7.18.6",
+  "description": "Compile `using` declarations to ES2015",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/babel/babel.git",
+    "directory": "packages/babel-plugin-proposal-explicit-resource-management"
+  },
+  "homepage": "https://babel.dev/docs/en/next/babel-plugin-proposal-explicit-resource-management",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./lib/index.js",
+  "keywords": [
+    "babel-plugin"
+  ],
+  "dependencies": {
+    "@babel/helper-plugin-utils": "workspace:^",
+    "@babel/plugin-syntax-explicit-resource-management": "workspace:^"
+  },
+  "peerDependencies": {
+    "@babel/core": "^7.0.0-0"
+  },
+  "devDependencies": {
+    "@babel/core": "workspace:^",
+    "@babel/helper-plugin-test-runner": "workspace:^"
+  },
+  "engines": {
+    "node": ">=6.9.0"
+  },
+  "author": "The Babel Team (https://babel.dev/team)",
+  "conditions": {
+    "USE_ESM": [
+      {
+        "type": "module"
+      },
+      null
+    ]
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "type": "commonjs"
+}