npmpackage.info

Gathering detailed insights and metrics for babel-plugin-debug-macros

Other packages similar to babel-plugin-debug-macros

babel-plugin-macros

3.1.0

Allows you to build compile-time libraries

ember-cli-babel

8.2.0

Ember CLI addon for Babel

vite-plugin-babel-macros

1.0.6

Use babel macros with vite

babel-plugin-twin

1.1.0

<a href="https://www.npmjs.com/package/babel-plugin-twin"><img src="https://img.shields.io/npm/dt/babel-plugin-twin.svg" alt="Total Downloads"></a> <a href="https://www.npmjs.com/package/babel-plugin-twin"><img src="https://img.shields.io/npm/v/babel-plug

Gathering detailed insights and metrics for babel-plugin-debug-macros

babel-plugin-debug-macros

1.0.2

TypeScript

9.89 kB

121,519,998 3.4

Installations

npm install babel-plugin-debug-macros

Pull Requests

Open

2

Total

81

Closed

5

Merged

74

Issues

Open

9

Total

21

Closed

12

Releases

v1.0.2-babel-plugin-debug-macros

Published on 11 Jul 2024

v1.0.1-babel-plugin-debug-macros

Published on 11 Jul 2024

Release 1.0.0

v1.0.0

Published on 27 Apr 2024

Release 1.0.0-alpha.2

v1.0.0-alpha.2

Published on 17 Apr 2024

Release 1.0.0-alpha.1

v1.0.0-alpha.1

Published on 11 Apr 2024

Release 1.0.0-alpha.0

v1.0.0-alpha.0

Published on 11 Apr 2024

View all 10 releases

Developer

ember-cli

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

>=16

Typescript Support

No

Node Version

18.20.3

NPM Version

10.7.0 Statistics

13 Stars

271 Commits

14 Forks

8 Watching

11 Branches

26 Contributors

Updated on 11 Jul 2024

Bundle Size

32.76 kB

Minified

9.89 kB

Minified + Gzipped

Bundlephobia

Languages

TypeScript (75.21%)

JavaScript (24.79%)

Total Downloads

Cumulative downloads

Total Downloads

121,519,998

Last day

-11.1%

62,011

Compared to previous day

Last week

-9.4%

329,286

Compared to previous week

Last month

21.9%

1,521,556

Compared to previous month

Last year

5.5%

19,708,468

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

babel-import-util semver

Peer Dependencies

@babel/core

Dev Dependencies

Versions

Babel Debug Macros And Feature Flags

This provides debug macros and feature flagging.

Setup

The plugin takes 4 types options: flags, svelte, debugTools, and externalizeHelpers. The importSpecifier is used as a hint to this plugin as to where macros are being imported and completely configurable by the host.

Like Babel you can supply your own helpers using the externalizeHelpers options.

1{
2  plugins: [
3    ['babel-plugin-debug-macros', {
4      // @optional
5      debugTools: {
6        isDebug: true,
7        source: 'debug-tools',
8        // @optional
9        assertPredicateIndex: 0
10      },
11
12      flags: [
13        { source: '@ember/env-flags', flags: { DEBUG: true } },
14        {
15          name: 'ember-source',
16          source: '@ember/features',
17          flags: {
18            FEATURE_A: false,
19            FEATURE_B: true,
20            DEPRECATED_CONTROLLERS: "2.12.0"
21          }
22        }
23      ],
24
25      // @optional
26      svelte: {
27        'ember-source': "2.15.0"
28      },
29
30      // @optional
31      externalizeHelpers: {
32        module: true,
33        // global: '__my_global_ns__'
34      }
35    }]
36  ]
37}

Flags and features are inlined into the consuming module so that something like UglifyJS will DCE them when they are unreachable.

Simple environment and feature flags

1import { DEBUG } from '@ember/env-flags';
2import { FEATURE_A, FEATURE_B } from '@ember/features';
3
4if (DEBUG) {
5  console.log('Hello from debug');
6}
7
8let woot;
9if (FEATURE_A) {
10  woot = () => 'woot';
11} else if (FEATURE_B) {
12  woot = () => 'toow';
13}
14
15woot();

Transforms to:

1if (true /* DEBUG */) {
2  console.log('Hello from debug');
3}
4
5let woot;
6if (false /* FEATURE_A */) {
7  woot = () => 'woot';
8} else if (true) {
9  woot = () => 'toow';
10}
11
12woot();

`warn` macro expansion

1import { warn } from 'debug-tools';
2
3warn('this is a warning');

Expands into:

1(true && console.warn('this is a warning'));

`assert` macro expansion

The assert macro can expand in a more intelligent way with the correct configuration. When babel-plugin-debug-macros is provided with the assertPredicateIndex the predicate is injected in front of the assertion in order to avoid costly assertion message generation when not needed.

1import { assert } from 'debug-tools';
2
3assert((() => {
4  return 1 === 1;
5})(), 'You bad!');

With the debugTools: { assertPredicateIndex: 0 } configuration the following expansion is done:

1(true && !((() => { return 1 === 1;})()) && console.assert(false, 'this is a warning'));

When assertPredicateIndex is not specified, the following expansion is done:

1(true && console.assert((() => { return 1 === 1;})(), 'this is a warning'));

`deprecate` macro expansion

1import { deprecate } from 'debug-tools';
2
3let foo = 2;
4
5deprecate('This is deprecated.', foo % 2);

Expands into:

1let foo = 2;
2
3(true && !(foo % 2) && console.warn('This is deprecated.'));

Externalized Helpers

When you externalize helpers you must provide runtime implementations for the above macros. An expansion will still occur, however we will emit references to those runtime helpers.

A global expansion looks like the following:

1import { warn } from 'debug-tools';
2
3warn('this is a warning');

Expands into:

1(true && Ember.warn('this is a warning'));

While externalizing the helpers to a module looks like the following:

1import { warn } from 'debug-tools';
2
3warn('this is a warning');

Expands into:

1(true && warn('this is a warning'));

Svelte

Svelte allows for consumers to opt into stripping deprecated code from your dependecies. By adding a package name and minimum version that contains no deprecations, that code will be compiled away.

For example, consider you are on ember-source@2.10.0 and you have no deprecations. All deprecated code in ember-source that is <=2.10.0 will be removed.


svelte: {
  "ember-source": "2.10.0"
}

Now if you bump to ember-source@2.11.0 you may encounter new deprecations. The workflow would then be to clear out all deprecations and then bump the version in the svelte options.

svelte: {
  "ember-source": "2.11.0"
}

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Packaging

Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.

8

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/plan-release.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/plan-release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/plan-release.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/plan-release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/plan-release.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/plan-release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/plan-release.yml:58: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/plan-release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/plan-release.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/plan-release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/publish.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/publish.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/publish.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/ember-cli/babel-plugin-debug-macros/publish.yml/main?enable=pin
Info: 0 out of 10 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 5 third-party GitHubAction dependencies pinned

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

License

Determines if the project has defined a license.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

Score

3.4

/10

Last Scanned on 2024-11-25

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to babel-plugin-debug-macros

Other packages similar to babel-plugin-debug-macros

babel-plugin-debug-macros

Installations

Pull Requests

2

81

5

74

Issues

9

21

12

Releases

Developer

ember-cli

Developer Guide

CommonJS

>=16

No

18.20.3

10.7.0

Statistics

Bundle Size

32.76 kB

9.89 kB

Languages

Total Downloads

121,519,998

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

Babel Debug Macros And Feature Flags

Setup

Simple environment and feature flags

warn macro expansion

assert macro expansion

deprecate macro expansion

Externalized Helpers

Svelte

10

10

10

8

0

0

0

0

0

0

0

0

0

0

3.4

/10

`warn` macro expansion

`assert` macro expansion

`deprecate` macro expansion