1.0.3 • Published 1 year ago

@hishprorg/aut-nam-ab v1.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

@hishprorg/aut-nam-ab

Marks all side-effects in module initialization that will interfere with tree-shaking

npm JavaScript Style Guide Greenkeeper badge semantic-release

Usage

This plugin is intended as a means for library developers to identify patterns that will interfere with the tree-shaking algorithm of their module bundler (i.e. rollup or webpack).

JavaScript:

myGlobal = 17;
const x = { [globalFunction()]: "myString" };

export default 42;

Rollup output:

myGlobal = 17;
const x = { [globalFunction()]: "myString" };

var index = 42;

export default index;

ESLint output:

1:1   error  Cannot determine side-effects of assignment to global variable
2:13  error  Cannot determine side-effects of calling global function

This plugin is most useful when you integrate ESLint with your editor.

Installation and Setup

You'll first need to install ESLint:

$ npm i eslint --save-dev

Next, install @hishprorg/aut-nam-ab:

$ npm install @hishprorg/aut-nam-ab --save-dev

Note: If you installed ESLint globally (using the -g flag) then you must also install @hishprorg/aut-nam-ab globally.

Add tree-shaking to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

{
  "plugins": ["tree-shaking"]
}

Then add the rule no-side-effects-in-initialization to the rules section:

{
  "rules": {
    "tree-shaking/no-side-effects-in-initialization": 2
  }
}

To prevent false positives, configure like this:

{
  "rules": {
    "tree-shaking/no-side-effects-in-initialization": [
      2,
      {
        "noSideEffectsWhenCalled": [
          { "function": "Object.freeze" },
          {
            "module": "react",
            "functions": ["createContext", "createRef"]
          },
          {
            "module": "zod",
            "functions": ["array", "string", "nativeEnum", "number", "object", "optional"]
          },
          {
            "module": "my/local/module",
            "functions": ["foo", "bar", "baz"]
          }
        ]
      }
    ]
  }
}

Magic Comments

ESLint only ever analyzes one file at a time and by default, this plugin assumes that all imported functions have side-effects. If this is not the case, this plugin supports magic comments you can add before identifiers in imports and exports to specify that you assume an import or export to be a pure function. Examples:

  • By default, imported functions are assumed to have side-effects:

    JavaScript:

    import { x } from "./some-file";
    x();

    ESLint output:

    1:9  error  Cannot determine side-effects of calling imported function
  • You can mark a side-effect free import with a magic comment:

    JavaScript:

    import { /* tree-shaking no-side-effects-when-called */ x } from "./some-file";
    x();

    No ESLint errors

  • By default, exported functions are not checked for side-effects:

    JavaScript:

    export const x = globalFunction;

    No ESLint errors

  • You can check exports for side-effects with a magic comment:

    JavaScript:

    export const /* tree-shaking no-side-effects-when-called */ x = globalFunction;

    ESLint output:

    1:65  error  Cannot determine side-effects of calling global function

Background and Planned Development

This plugin is in development. If you want to contribute, please read CONTRIBUTING.md.

This plugin implements a side-effect detection algorithm similar to what rollup uses to determine if code can be removed safely. However, there is no one-to-one correspondence. If you find that you have code that

  • is not removed by rollup (even though tree-shaking is enabled) but
  • has no ESLint issues

please--if no-one else has done so yet--check the guidelines and file an issue!

cloudfrontuuidnameMapjestformattingbufferspredictablestablematchpinoes2018columnsArrayBufferSymbolonceecmascriptsetPrototypeOfserializationtslibgetintrinsicbusyidleformmobileregulartoolsroutebanner.envmulti-packagesidearktypeperformanceTypeBoxlivecolumnexpresseslintpluginRxStyleSheetdragsuperstructwhatwgfast-copy6to5function.lengthcore-jstrimLefturlutilsmapreducefastcloneregexspringfile systemwindowshigher-orderECMAScript 2021propertyfluxpositivefnmatchform-validationhasnegative zerocheckansidiffhasOwneventsnumberenvtacitkeysetImmediateinputelectronstarterlastescapees7installclassesprivateacornredux-toolkitlinkintrinsicvalidatetoolkitdescriptorsimmutablefull-widthconstsettingsindicatorJSONmanagerhttpsReactiveXdotenvInt32ArraytypedarraysthreeObject.definePropertypopmotionrgbnodeArray.prototype.findLastIndexmakereplaypurebyteArrayargvchrometypefsdeep-copyiteratorsuperagenttypeerrorWebSockettrimInt8Arrayhashcurlfastcopyvariables in cssObservablesreactnativemkdirhasOwnPropertytranspileTypedArraycorejapaneseregular-expressionserializemonorepoJSON-SchemaarraysmacosvalidatorObject.entriesgetPrototypeOfmoveURLformatquerycreatesetmapformsl10nbinreact-testing-librarymergequoteuser-streamscallboundinspectweaksetloggingWeakSetArray.prototype.includessharediamString.prototype.trimbyteOffsettoobjectpostcss-pluginReactiveExtensionsdynamodbramdasameValueZerojsxdependenciesrfc9562executeHyBireact-componenttrimEndawsvpcfphookformmatchesutilityless.jsposeglobalThisReflect.getPrototypeOfStreampropfullwidthUint8ArraybrowserlistsignalbinaryES2021writedefinefpssymbolsfunctionsperformantutilstoragegatewayflagsbeanstalkfunctionless compilerargsharmonyECMAScript 2016asterisksstyleguideutilitiestraversedefinePropertyflattenreuseincludescensordescriptorrangeerrorregular expressioneffect-tssliceFunction.prototype.nameECMAScript 6ECMAScriptirqgenericsec2lruFloat64Array_.extendfetchdataViewequalityrequireregexppersistentchinesegetoptes-abstractstructuredClonelesscssomitviewpostcssless cssES2019testgradients css3Object.keysdeterministicnpmjson-schema-validatorsignalsBigInt64ArrayzerocertificatesendpointlengthvisualUint16Arrayio-tsUint32ArrayECMAScript 2019ES2017computed-typesjsdiffmixinsinternal slotpreserve-symlinksES2018interruptsIteratorObject.isdayjstc39variablesmetadataECMAScript 3rapidcss nestingsymlinkscloudtrailloadbalancingobjcopyi18nmkdirsruntimebddsafeconsoleECMAScript 7enumerable0optimistlockfilecloudsearchcss-in-jssetterObject.fromEntrieses2017spinnerstestersortedglacieroffsetCSSStyleDeclarationtoStringTaghas-ownimportexportjson-schema-validationArray.prototype.flattencliWebSockets[[Prototype]]mruschemarulesprocesstoArrayentriesanimationcssBigUint64ArrayflatMapenderbrowserslistreact posetestingES6bootstrap lessinstreamsstringifieroptimizers3reduxRegExp#flagsgitignoreArray.prototype.flatMapsomepipegraphqldataviewchanneltrimRightwarningoutputsequencequerystringdescriptionselfprogressimmervalidutil.inspectloggerbabel-coreclass-validatorbootstrap csssubprocesscryptoremoveponyfillcloneES7package.jsondeep-cloneprettyArray.prototype.containscryptjoiwgetreact-hook-formObjectfast-cloneisConcatSpreadableES2015emrpropertiesenvironmentsassignhardlinksoptionES3varspreprocessorspawnESmomentsymbolglobalssigintphonedirlesskeystddcommandglobalzodfixed-widthnamesloadingRxJSprotobufswfsigtermjshintsyntaxerrorguidaccessorcompare256elasticacheresolveECMAScript 5route53bindstringifytypescriptcollection.es6arraybufferxhrpyyamlES2023lazystatelessowncircularCSSYAMLapiiterationxtermwhichObservableMicrosoftreduceragentstringstylingelmauthenticationaccessibilitycoercibleyuptypedarrayreact animationhelpershelpereventDispatcherbundlershebang@@toStringTagawesomesaucemodulesPushwaapies6picomatchzxasyncconfigrobustshimparseeveryAsyncIteratorArray.prototype.findLastkoreanimportstatusreduceartfast-deep-copydependency managerfromes-shim APIfasttranspilerassertssnsterminalpackagesRFC-6455Int16Arrayes-shimsArray.prototype.flatbinariescodesebscompile lessconfigurablettysharedarraybufferequaljavascriptcloudformationreverseinvariantSystem.globalworkspace:*esdeletestyletyped arrayURLSearchParams.gitignoreECMAScript 2022inferencehandlersreact-hooksa11ygroupshamtypeddeepcopyconcaterrorfunctionalmatchAllUint8ClampedArraynpmignorecharacterSetstylesheetECMAScript 2023fullarrayworkerES5readablestreamcalltelephonepolyfillfindhttpexit-codees5tsES2016airbnbflagestreefilterpushreal-timeapolloString.prototype.matchAllprotoqueueMicrotaskwalkschemeassertcloudwatchtostringtagstyleshotlintbrowserstyled-components-0signedjwtjsqueueECMAScript 2015curriedtimenegativeuninstallflatautoscalingforkshellforEachgetterreadlinuxvarreadabletypeses2016proxygradients csscollectiontoReversedastroutingcallbindhookssort$.extendtransportfilecjkpnpm9pathasciieast-asian-widthcommanderprivate dataspeedTypeScriptdropprefixpackage managercommand-linewidthes8domrandomes2015protocol-buffersWeakMapgdprwindowchaicolorframerignorestreamprototypeArrayBuffer.prototype.sliceuploadeslintconfiglogglobal objecteventEmittertypeoffigletjsdombabeljsonschemabcryptenvironmentoperating-systemclientamazonidentifiersbufferECMAScript 2018datastructureextendcall-bindeslint-pluginparserspeccall-boundRegExp.prototype.flagsObject.assignfindLastnopetoSortednodejsqsES2022emitrequestclassnamestypesafevalidationextracallbackredactlocalkinesisdom-testing-libraryslot__proto__internalfast-deep-clonesymlinkESnextmake dirassertionfindLastIndexweakmapauthscheme-validationexecvaluesjson-schemawaitworkflowgetOwnPropertyDescriptortakeFloat32ArrayefficientspinnerObject.valuescacheprunenested cssless mixinsStreamsfantasy-landopensslrfc4122patchmodulepoint-freecontainssimpledbPromisebyteLengthshrinkwrapvalueECMAScript 2020directorygesturestrimStartboundieissesobjecttexttypanionrdsrecursivejson
1.0.3

1 year ago

1.0.2

1 year ago

1.0.1

1 year ago

1.0.0

1 year ago