Merge pull request #812 from NullVoxPopuli/changeset-release/main

Release Preview (beta)

Author: NullVoxPopuli

.changeset/pre.json

@@ -11,6 +11,7 @@
     "afraid-cherries-type",
     "curvy-frogs-sin",
     "gold-weeks-destroy",
+    "hip-fishes-agree",
     "hungry-waves-kiss",
     "long-apples-sneeze",
     "many-brooms-turn",

ember-resources/CHANGELOG.md

@@ -1,5 +1,81 @@
 # ember-resources
 
+## 6.0.0-beta.2
+
+### Minor Changes
+
+- [#797](https://github.com/NullVoxPopuli/ember-resources/pull/797) [`18adb86`](https://github.com/NullVoxPopuli/ember-resources/commit/18adb86dc7a399b47dfd6a2065b059ad38b82967) Thanks [@NullVoxPopuli](https://github.com/NullVoxPopuli)! - Add link() and @link, importable from `ember-resources/link`.
+
+  NOTE: for existing users of `ember-resources`, this addition has no impact on your bundle.
+
+  <details><summary>Example property usage</summary>
+
+  ```js
+  import { link } from 'ember-resources/link';
+
+  class MyClass {  ... }
+
+  export default class Demo extends Component {
+    // This usage does now allow passing args to `MyClass`
+    @link(MyClass) myInstance;
+  }
+  ```
+
+  </details>
+
+  <details><summary>Example inline usage</summary>
+
+  ```js
+  import Component from "@glimmer/component";
+  import { cached } from "@glimmer/tracking";
+  import { link } from "ember-resources/link";
+
+  export default class Demo extends Component {
+    // To pass args to `MyClass`, you must use this form
+    // NOTE though, that `instance` is linked to the `Demo`s lifecycle.
+    //  So if @foo is changing frequently, memory pressure will increase rapidly
+    //  until the `Demo` instance is destroyed.
+    //
+    //  Resources are a better fit for this use case, as they won't add to memory pressure.
+    @cached
+    get myFunction() {
+      let instance = new MyClass(this.args.foo);
+
+      return link(instance, this);
+    }
+  }
+  ```
+
+  </details>
+
+  This abstracts away the following boilerplate:
+
+  ```js
+  import { getOwner, setOwner } from "@ember/owner";
+  import { associateDestroyableChild } from "@ember/destroyable";
+
+  class MyClass {
+    /* ... */
+  }
+
+  export default class Demo extends Component {
+    @cached
+    get myInstance() {
+      let instance = new MyClass();
+
+      associateDestroyableChild(this, instance);
+
+      let owner = getOwner(this);
+
+      if (owner) {
+        setOwner(instance, owner);
+      }
+
+      return instance;
+    }
+  }
+  ```
+
 ## 6.0.0-beta.1
 
 ### Major Changes

ember-resources/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember-resources",
-  "version": "6.0.0-beta.1",
+  "version": "6.0.0-beta.2",
   "keywords": [
     "ember-addon"
   ],