@embroider/util NPM

@embroider/util

Utilities to help apps and addons with Embroider support.

Compatibility

Ember.js v3.13 or above
Ember CLI v2.13 or above
Node.js v10 or above

Installation

ember install @embroider/util

The Utilities

`ensureSafeComponent`

This function is intended to help addon authors who still need to support Ember < 3.25. In all other cases, instead of using this you should directly pass components around as values (not as strings) and invoke them directly with angle brackets (not the {{component}} helper).

For the full explanation of why and how you would use this, see the Addon Author Guide.

Example usage in Javascript:

import { ensureSafeComponent } from '@embroider/util';
import Component from '@glimmer/component';
import DefaultTitleComponent from './default-title';

export default class extends Component {
  get title() {
    return ensureSafeComponent(this.args.title || DefaultTitleComponent, this);
  }
}

<this.title />

Example usage in a template:

{{#let
  (ensure-safe-component (or @title (component 'default-title')))
  as |Title|
}}
  <Title />
{{/let}}

The first argument is allowed to be:

a string. If we see a string, we will emit a deprecation warning because passing components-as-strings doesn't work safely under Embroider with staticComponents enabled. We will return a value that is safe to invoke (via angle brackets) on your current Ember version.
a curried component definition (which is the kind of value you receive when someone does <YourComponent @customThing={{component "fancy"}}/>). These are returned unchanged, because they're always safe to invoke.
a component class, in which case if your ember version does not yet support directly invoking component classes, we will convert it to a curried component definition for you.

In the Javascript version, you must pass a second argument that is any object with an owner (a Component instance works great).

Glint usage

If you are using Glint and environment-ember-loose, you can add all the macros to your app at once by adding

import type { EmbroiderUtilRegistry } from "@embroider/util";

to your app's e.g. types/glint.d.ts file, and making sure your registry extends from EmbroiderMacrosRegistry:

declare module '@glint/environment-ember-loose/registry' {
  export default interface Registry
    extends EmbroiderUtilRegistry, /* other registries here */ {
      // ...
    }
}

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

ember-addon

broccoli-funnel ember-cli-babel @embroider/macros

@everything-registry/sub-chunk-288 ilios-common liquid-wormhole ember-basic-dropdown ember-bootstrap ember-bootstrap-modals-manager ember-collapsible-panel ember-cite ember-light-table ember-models-table ember-models-table-floating-filter ember-modal-dialog ember-simple-charts ember-showcase ember-power-calendar ember-power-datepicker ember-power-select ember-promise-modals ember-power-select-with-create ember-uikit ember-element-helper ember-elsewhere ember-form-builder ember-headless-form ember-validated-form field-guide @projectcaluma/ember-form @ember-eui/core @ember-eui/flatpickr @ember-eui/validated-form @ember-eui/changeset-form @eflexsystems/ember-model-select @eflexsystems/ember-power-select-with-create @gavant/ember-modals @gavant/ember-power-select-infinity @gavant/ember-table @hashicorp/field-guide @zalastax/nolb-_emb @twyr/ember-abstract-dropdown @twyr/ember-component-modifiers @twyr/ember-css-modifiers @twyr/ember-event-modifiers @twyr/ember-mdc-web @twyr/ember-observer-modifiers @twyr/embroider-addon @tryghost/ember-promise-modals @zestia/ember-dragula @zestia/ember-expander @zestia/ember-rich-intl @zestia/ember-select-box @zestia/ember-async-tooltips @zestia/ember-twitter-entities @zestia/ember-wrap-urls

1.13.1-unstable.4c21dd5

2 days ago

1.13.1

2 days ago

1.13.1-unstable.3d20631

7 days ago

1.13.1-unstable.ccbf41f

8 days ago

1.13.1-unstable.ea895c2

10 days ago

1.13.1-unstable.fad2387

15 days ago

1.13.1-unstable.649e0eb

16 days ago

1.13.1-unstable.c5595f2

16 days ago

1.13.1-unstable.d740ef0

16 days ago

1.13.1-unstable.445e96b

17 days ago

1.12.2-unstable.cb8efec

22 days ago

1.12.2-unstable.ef8eacd

23 days ago

1.12.2-unstable.ea2a455

22 days ago

1.13.1-unstable.80f442d

22 days ago

1.12.2-unstable.b5fd677

28 days ago

1.12.2-unstable.2afc470

28 days ago

1.12.2-unstable.35f9ecd

30 days ago

1.12.2-unstable.8e692cc

30 days ago

1.12.2-unstable.bdb7f3d

1 month ago

1.12.2-unstable.e1142b1

1 month ago

1.12.2-unstable.11f2c70

1 month ago

1.12.2-unstable.bac2415

1 month ago

1.12.2-unstable.433b22c

1 month ago

1.13.0

2 months ago

1.12.2-unstable.f30e685

2 months ago

1.12.2-unstable.6d64eff

2 months ago

1.12.2-unstable.4c0881e

2 months ago

1.12.2-unstable.a90d03d

2 months ago

1.12.2-unstable.c52ad5c

2 months ago

1.12.2-unstable.8c7b24d

2 months ago

1.12.2-unstable.d6b87d7

2 months ago

1.12.2-unstable.50b6f9e

2 months ago

1.12.2-unstable.f56eaf1

3 months ago

1.12.2-unstable.12a42ca

3 months ago

1.12.2-unstable.43da932

3 months ago

1.12.2-unstable.d8e1f36

3 months ago

1.12.2-unstable.70b1c6f

3 months ago

1.12.2-unstable.f361b71

3 months ago

1.12.2-unstable.c5f8d55

3 months ago

1.12.2-unstable.2f2d9f8

3 months ago

1.12.2-unstable.b10d4db

3 months ago

1.12.2-unstable.6b405bd

3 months ago

1.12.2-unstable.eba0f6a

3 months ago

1.12.2-unstable.7f81070

3 months ago

1.12.2-unstable.2287af7

3 months ago

1.12.2-unstable.69a0e58

3 months ago

1.12.2-unstable.d015c8d

3 months ago

1.12.2-unstable.289f83d

4 months ago

1.12.2-unstable.a74ae69

4 months ago

1.12.2-unstable.7357b5a

4 months ago

1.12.2-unstable.241f631

4 months ago

1.12.2-unstable.a9f892a

4 months ago

1.12.2-unstable.2edb355

4 months ago

1.12.2-unstable.2a6775b

4 months ago

1.12.2-unstable.ecb0185

5 months ago

1.12.2-unstable.b4add32

5 months ago

1.12.2-unstable.5010f91

5 months ago

1.12.2-unstable.7619120

5 months ago

1.12.2-unstable.8bea275

5 months ago

1.12.2-unstable.efd9117

5 months ago

1.12.2-unstable.0dc2c93

5 months ago

1.12.2-unstable.b33cb4c

5 months ago

1.12.2-unstable.b6c717f

5 months ago

1.12.2-unstable.b446d89

5 months ago

1.12.2-unstable.996b2ff

5 months ago

1.12.2-unstable.2cefe80

5 months ago

1.12.2-unstable.3480aa6

5 months ago

1.12.2-unstable.6c8efe8

5 months ago

1.12.2-unstable.65ea799

5 months ago

1.11.3-unstable.3fc3a4d

10 months ago

1.12.1-unstable.ace1564

7 months ago

1.12.1-unstable.cacd923

9 months ago

1.11.3-unstable.812df54

10 months ago

1.11.2-unstable.be02b4a

10 months ago

1.11.3-unstable.e3a00a0

10 months ago

1.12.1-unstable.b49b5e2

9 months ago

1.11.2-unstable.128902

10 months ago

1.11.2-unstable.f4b7a14

10 months ago

1.11.2

10 months ago

1.12.1-unstable.45736c1

7 months ago

1.12.2-unstable.361e2f7

6 months ago

1.11.2-unstable.9f97d6e

10 months ago

1.12.1-unstable.f84b5cd

6 months ago

1.12.1-unstable.9048919

9 months ago

1.12.1-unstable.4fc4f94

9 months ago

1.12.2-unstable.bb9dfa8

6 months ago

1.11.2-unstable.5120323

10 months ago

1.11.2-unstable.02a1fbc

10 months ago

1.12.1-unstable.4665d9d

7 months ago

1.12.1-unstable.cb4e47b

7 months ago

1.12.1

6 months ago

1.12.0

10 months ago

1.12.1-unstable.80e325d

6 months ago

1.11.2-unstable.dff78b0

10 months ago

1.11.2-unstable.ef70747

10 months ago

1.12.1-unstable.268ef82

7 months ago

1.11.2-unstable.1cfdcec

10 months ago

1.12.1-unstable.20d0348

6 months ago

1.11.2-unstable.d660c6a

10 months ago

1.12.1-unstable.0a697b4

7 months ago

1.12.1-unstable.147128e

9 months ago

1.12.1-unstable.a3ff5ed

9 months ago

1.12.1-unstable.33ad547

7 months ago

1.12.1-unstable.2cbaf7c

9 months ago

1.12.1-unstable.b8ac17b

10 months ago

1.12.1-unstable.17cf74c

8 months ago

1.11.2-unstable.db25d62

10 months ago

1.11.3-unstable.5fd7c48

10 months ago

1.12.1-unstable.c4f8973

7 months ago

1.12.1-unstable.f6078b1

7 months ago

1.12.2-unstable.d68fbec

5 months ago

1.12.2-unstable.0ebfb9d

6 months ago

1.12.1-unstable.7a45975

9 months ago

1.11.3-unstable.3fbc5ec

10 months ago

1.12.2-unstable.ded6329

6 months ago

1.12.1-unstable.f89a1c7

7 months ago

1.12.2-unstable.ebf92d6

5 months ago

1.12.2-unstable.239b522

6 months ago

1.11.2-unstable.b321a7a

10 months ago

1.12.1-unstable.77ed393

7 months ago

1.12.2-unstable.138272d

6 months ago

1.11.2-unstable.96f87d1

10 months ago

1.11.3-unstable.4f3826d

10 months ago

1.12.1-unstable.d660963

9 months ago

1.11.2-unstable.7d1b7f0

10 months ago

1.12.2-unstable.2d59287

6 months ago

1.12.1-unstable.956b96b

7 months ago

1.11.3-unstable.1cdd50c

10 months ago

1.12.1-unstable.65d9067

7 months ago

1.12.1-unstable.e209cc9

9 months ago

1.11.3-unstable.7407f3a

10 months ago

1.12.2-unstable.075b94d

6 months ago

1.12.1-unstable.518ea37

6 months ago

1.11.2-unstable.47fc75d

10 months ago

1.11.3-unstable.9834d5b

10 months ago

1.11.2-unstable.229045b

10 months ago

1.11.2-unstable.326562b

10 months ago

1.11.3-unstable.0c7aa66

10 months ago

1.12.2-unstable.05badd2

5 months ago

1.12.2-unstable.6c2f482

6 months ago

1.12.1-unstable.b6dee02

9 months ago

1.11.2-unstable.8e0a473

10 months ago

1.12.2-unstable.9606cac

5 months ago

1.11.3-unstable.2c0e2bd

10 months ago

1.12.1-unstable.3934dea

6 months ago

1.12.2-unstable.2d06aa0

5 months ago

1.11.2-unstable.a1b2971

10 months ago

1.12.2-unstable.d8895a2

5 months ago

1.12.1-unstable.dfe4bc3

7 months ago

1.12.1-unstable.5da719c

9 months ago

1.11.3-unstable.0e00f2b

10 months ago

1.12.1-unstable.1e88426

7 months ago

1.11.2-unstable.7bd035f

10 months ago

1.12.2-unstable.04bf3a7

6 months ago

1.11.3-unstable.ed7b6fe

10 months ago

1.12.2-unstable.9a64955

6 months ago

1.12.1-unstable.51c1794

8 months ago

1.12.1-unstable.eba2166

7 months ago

1.11.3-unstable.f032c58

10 months ago

1.11.3-unstable.ed6910d

10 months ago

1.12.1-unstable.17b7b60

9 months ago

1.12.1-unstable.157dd62

7 months ago

1.12.2-unstable.5daf70e

5 months ago

1.12.1-unstable.786fccf

7 months ago

1.12.1-unstable.38a3aa7

7 months ago

1.11.3-unstable.4a44b92

10 months ago

1.11.2-unstable.63f6836

10 months ago

1.12.2-unstable.ba9fd29

5 months ago

1.12.1-unstable.65cfb16

10 months ago

1.12.1-unstable.349e7fe

9 months ago

1.11.2-unstable.3030376

10 months ago

1.11.2-unstable.67f82f3

10 months ago

1.11.2-unstable.53de9f9

10 months ago

1.12.2-unstable.2914652

6 months ago

1.12.1-unstable.6d4a757

6 months ago

1.12.1-unstable.fe69a74

7 months ago

1.11.3-unstable.39842d0

10 months ago

1.12.1-unstable.a449708

7 months ago

1.12.1-unstable.cd8d1be

7 months ago

1.11.3-unstable.ad658ea

10 months ago

1.11.2-unstable.7532326

10 months ago

1.11.2-unstable.8a8ddf6

10 months ago

1.11.2-unstable.f7c5518

10 months ago

1.11.2-unstable.448d29f

10 months ago

1.10.1-unstable.e26de29

1 year ago

1.10.1-unstable.137fcab

1 year ago

1.11.2-unstable.5a5f4d5

11 months ago

1.11.1-unstable.8dfe2b3

11 months ago

1.10.1-unstable.a037764

12 months ago

1.11.2-unstable.95eef86

11 months ago

1.11.1-unstable.18fd6a9

12 months ago

1.11.1-unstable.739b8b5

11 months ago

1.10.1-unstable.514566f

1 year ago

1.10.1-unstable.40cebb2

12 months ago

1.10.1-unstable.3a232cc

1 year ago

1.10.1-unstable.16dc72c

12 months ago

1.10.1-unstable.e35628d

1 year ago

1.10.1-unstable.58c9ed2

1 year ago

1.11.1

11 months ago

1.11.2-unstable.9b83c11

11 months ago

1.11.1-unstable.d950e6a

11 months ago

1.10.1-unstable.c58f146

12 months ago

1.10.1-unstable.df7f441

1 year ago

1.11.1-unstable.abc3e4d

12 months ago

1.11.1-unstable.e3a95b9

11 months ago

1.11.1-unstable.806723a

12 months ago

1.10.0-unstable.21eae41

1 year ago

1.10.1-unstable.1ecd57e

12 months ago

1.11.1-unstable.64bbe47

11 months ago

1.11.1-unstable.d120477

11 months ago

1.11.2-unstable.3936fdb

11 months ago

1.10.0-unstable.73213f2a

1 year ago

1.10.1-unstable.9aaea50

12 months ago

1.10.1-unstable.e891bf1

12 months ago

1.10.1-unstable.c386613

12 months ago

1.10.1-unstable.3a9d8ad

1 year ago

1.11.1-unstable.8f4cd85

12 months ago

1.11.2-unstable.47e7548

11 months ago

1.11.2-unstable.65632a7

11 months ago

1.11.2-unstable.def53ab

11 months ago

1.10.1-unstable.3878f42

12 months ago

1.11.2-unstable.a4d18ab

11 months ago

1.11.0

12 months ago

1.10.1-unstable.a5135e2

1 year ago

1.10.1-unstable.a6cd4aa

1 year ago

1.11.2-unstable.791c2c3

11 months ago

1.11.1-unstable.22e656d

11 months ago

1.11.1-unstable.77dd32c

11 months ago

1.11.1-unstable.da01d2b

11 months ago

1.11.1-unstable.9f46f5e

11 months ago

1.10.1-unstable.5d60507

1 year ago

1.10.1-unstable.6e54dd1

1 year ago

1.10.0-unstable.72d5a8e

1 year ago

1.10.1-unstable.5877484

12 months ago

1.11.1-unstable.3f71493

11 months ago

1.11.1-unstable.ea4b13f

11 months ago

1.10.1-unstable.a993025

1 year ago

1.10.0-unstable.00ec2e7

1 year ago

1.10.1-unstable.77c945c

1 year ago

1.10.1-unstable.f004d11

12 months ago

1.10.1-unstable.e2cd385

1 year ago

1.10.0-unstable.936fd63

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago