@atlassian/webresource-webpack-plugin 7.0.2 → 7.0.3

package/dist/types/types.d.ts

@@ -0,0 +1,132 @@
+export declare type ArrayBaseType<T> = T extends Array<infer U> ? U : never;
+export declare type Callable = (...args: any[]) => any;
+export declare type ObjectOrMap = Record<string, unknown> | Map<string, unknown>;
+export declare type ConditionParam = {
+    attributes?: {
+        [key: string]: string;
+    };
+    value?: string;
+};
+export declare type ConditionClass = {
+    class: string;
+    invert?: boolean;
+    params?: ConditionParam[];
+};
+export declare type Conditions = {
+    type: string;
+    conditions: Array<Conditions | ConditionClass>;
+};
+export declare type Condition = Conditions | ConditionClass | Array<Conditions | Condition>;
+export declare type DeprecationInfo = {
+    sinceVersion?: string;
+    removeInVersion?: string;
+    alternative?: string;
+    extraInfo?: string;
+} | true;
+export declare type ProvidedDependency = {
+    dependency: string;
+    import: {
+        var: string;
+        amd?: string;
+    } | string;
+};
+export declare type DataProvider = {
+    key: string;
+    class: string;
+};
+export declare type ResourceParam = {
+    name: string;
+    value: string;
+};
+export declare type WebresourceObject = {
+    key?: string;
+    name?: string;
+    state?: string | boolean;
+};
+export declare type WebresourceType = string | WebresourceObject;
+declare type MapOrObject<T> = Map<string, T> | {
+    [key: string]: T;
+};
+export declare type ContextMap = Map<string, string[]>;
+export declare type TransformationMap = Map<string, string[]>;
+export declare type ProvidedDependenciesMap = Map<string, ProvidedDependency>;
+export declare type ConditionsMap = Map<string, Condition>;
+export declare type DataProvidersMap = Map<string, DataProvider[]>;
+export declare type DeprecationMap = Map<string, DeprecationInfo>;
+export declare type ResourceParamMap = Map<string, ResourceParam[]>;
+export declare type WebresourceMap = Map<string, WebresourceType>;
+export declare type Options = {
+    /** @property pluginKey - The fully qualified plugin key. e.g.: com.atlassian.jira.plugins.my-jira-plugin */
+    pluginKey: string;
+    /** @property xmlDescriptors - Path to the directory where this plugin stores the descriptors about this plugin, used by the WRM to load your frontend code. */
+    xmlDescriptors: string;
+    /** @property packageName - Name of frontend package to associate all output JS files with. */
+    packageName?: string;
+    /** @property devAssetsHash - Custom hash used in development environment resources name. */
+    devAssetsHash?: string;
+    /** @property locationPrefix - Specify the sub-directory for all web-resource location values. */
+    locationPrefix?: string;
+    /** @property wrmManifestPath - Path to the WRM manifest file where this plugin stores the mapping of modules to generated web-resources. e.g.: `{"my-entry": "com.example.app:entrypoint-my-entry"}`. Useful if you set { output: { library, libraryTarget } } in your webpack config, to use your build result as provided dependencies for other builds. */
+    wrmManifestPath?: string;
+    /** @property singleRuntimeWebResourceKey - Ensure all web-resources depend on a single runtime shared amongst them */
+    singleRuntimeWebResourceKey?: string;
+    /** @property conditionMap - Conditions to be applied to the specified entry-point */
+    conditionMap?: MapOrObject<Condition>;
+    /** @property contextMap - One or more "context"s to which an entrypoint will be added. e.g.: `{"my-entry": ["my-plugin-context", "another-context"]}` */
+    contextMap?: MapOrObject<string[]>;
+    /** @property dataProvidersMap - A list of data providers that will be added to the entry point e.g.: `{"my-entry": [{ key: "data-provider-key", class: "my.data.provider.JavaClass" }]}` */
+    dataProvidersMap?: MapOrObject<DataProvider[]>;
+    /** @property deprecatedEntrypoints - Map of entrypoints that are deprecated to more detailed information about the deprecation including the affected versions, alternatives and reason. e.g.: `{"outdated-entrypoint": { sinceVersion: "2.0.0", removeInVersion: "3.0.0", alternative: "rewritten-endpoint", extraInfo: "outdated-endpoint does not support dark mode" }}` */
+    deprecatedEntrypoints?: MapOrObject<DeprecationInfo>;
+    /** @property providedDependencies - Map of ES6/AMD module identifiers to their related WRM module keys and JavaScript import values (read: webpack external dependency definition). If this module identifier is imported or required somewhere in the compiled code, it will not be bundled, but instead replaced with the specified external dependency placeholder. */
+    providedDependencies?: MapOrObject<ProvidedDependency>;
+    /** @property resourceParamMap - Parameters to be added to specific file types. */
+    resourceParamMap?: MapOrObject<ResourceParam[]>;
+    /** @property transformationMap - Transformations to be applied to the specified file-types. */
+    transformationMap?: MapOrObject<string[]> | false;
+    /** @property webresourceKeyMap - An explicit name for the web-resource generated per entry point. e.g.: `{"my-entry": "legacy-webresource-name"}`. */
+    webresourceKeyMap?: MapOrObject<WebresourceType>;
+    /** @property addAsyncNameAsContext - Adds the name of the async chunk as a context prefixed by `async-chunk-`. Will only do so if a webpackChunkName is set. */
+    addAsyncNameAsContext?: boolean;
+    /** @property addEntrypointNameAsContext - Guarantees each entrypoint will be given a context matching its name. Use with caution; this can adversely affect page weight and may conflict with other plugins and feature code. */
+    addEntrypointNameAsContext?: boolean;
+    /** @property noWRM - Do not add any WRM specifics to the webpack runtime to allow development on a greenfield. */
+    noWRM?: boolean;
+    /** @property useDocumentWriteInWatchMode - Use document.write when possible in "watch-mode" to ensure scripts are loaded "blocking" as they would be in a production environment */
+    useDocumentWriteInWatchMode?: boolean;
+    /** @property verbose - Indicate if log output should be verbose. */
+    verbose?: boolean;
+    /** @property watch - Trigger watch mode - this requires webpack-dev-server and will redirect requests to the entrypoints to the dev-server that must be running under webpack's `options.output.publicPath`. */
+    watch?: boolean;
+    /** @property watchPrepare - In conjunction with watch mode - indicates that only "redirects" to a webserver should be build in this run. */
+    watchPrepare?: boolean;
+};
+export declare type ConsolidatedOptions = Options & Required<Omit<Options, 'wrmManifestPath' | 'singleRuntimeWebResourceKey' | 'packageName'>> & {
+    conditionMap: ConditionsMap;
+    contextMap: ContextMap;
+    dataProvidersMap: DataProvidersMap;
+    deprecatedEntrypoints: DeprecationMap;
+    providedDependencies: ProvidedDependenciesMap;
+    resourceParamMap: ResourceParamMap;
+    transformationMap: TransformationMap;
+    webresourceKeyMap: WebresourceMap;
+};
+export declare type WrmResource = {
+    name: string;
+    location: string;
+};
+export declare type ChunkResourceDescriptor = {
+    attributes: {
+        key: string;
+        moduleId?: string;
+    };
+    resources: string[];
+    dependencies?: string[];
+    deprecationInfo?: DeprecationInfo;
+    contexts?: string[];
+    conditions?: Condition;
+    dataProviders?: DataProvider[];
+    externalResources?: WrmResource[];
+};
+export declare type AssetNames = Map<string, string>;
+export {};

package/dist/types/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":""}

package/dist/webpack-modules/EmptyExportsModule.d.ts

@@ -0,0 +1,14 @@
+import type { sources } from 'webpack';
+import DllModule from 'webpack/lib/DllModule';
+/**
+ * This module type allows inclusion of special dependencies in the webpack compilation process
+ * that ultimately output nothing in the compiled bundles.
+ *
+ * This is of use when including certain file types with no associated loader in the compilation process,
+ * as is the case with things like Atlassian Soy templates.
+ */
+export default class EmptyExportsModule extends DllModule {
+    constructor(dependency: string, type: string);
+    chunkCondition(): boolean;
+    source(): sources.RawSource;
+}

package/dist/webpack-modules/EmptyExportsModule.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const DllModule_1 = __importDefault(require("webpack/lib/DllModule"));
+const webpack_sources_1 = require("webpack-sources");
+/**
+ * This module type allows inclusion of special dependencies in the webpack compilation process
+ * that ultimately output nothing in the compiled bundles.
+ *
+ * This is of use when including certain file types with no associated loader in the compilation process,
+ * as is the case with things like Atlassian Soy templates.
+ */
+class EmptyExportsModule extends DllModule_1.default {
+    constructor(dependency, type) {
+        super(null, [], dependency, type);
+    }
+    chunkCondition() {
+        return true;
+    }
+    source() {
+        // eslint-disable-next-line prettier/prettier
+        return new webpack_sources_1.RawSource('module.exports = undefined;');
+    }
+}
+exports.default = EmptyExportsModule;
+//# sourceMappingURL=EmptyExportsModule.js.map

package/dist/webpack-modules/EmptyExportsModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyExportsModule.js","sourceRoot":"","sources":["../../src/webpack-modules/EmptyExportsModule.ts"],"names":[],"mappings":";;;;;AACA,sEAA8C;AAC9C,qDAA4C;AAE5C;;;;;;GAMG;AACH,MAAqB,kBAAmB,SAAQ,mBAAS;IACvD,YAAY,UAAkB,EAAE,IAAY;QAC1C,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,6CAA6C;QAC7C,OAAO,IAAI,2BAAS,CAAC,6BAA6B,CAAiC,CAAC;IACtF,CAAC;CACF;AAbD,qCAaC"}

package/dist/webpack-modules/ProvidedExternalDependencyModule.d.ts

@@ -0,0 +1,20 @@
+import ExternalModule from 'webpack/lib/ExternalModule';
+import type { ProvidedDependency } from '../types/types';
+/**
+ * ProvidedExternalModule ensures that the `chunkCondition` is true to allow proper asyncChunk context handling
+ * ExternalModules can be defined in different ways. Some of them require the external module to be loaded in the entry point.
+ * This is generally not bad as it doesnt cost anything. However the WRM Plugin relies on ExternalModules to specify provided dependencies.
+ * These provided dependencies are then added to the context of the chunk in which they occur. Async chunks should therefore
+ * have their own dependencies to make the entrypoint as small as possible.
+ * ProvidedExternalModule ensures that.
+ */
+export default class ProvidedExternalDependencyModule extends ExternalModule {
+    private _wrmDependency;
+    private _request;
+    private _target;
+    constructor(request: ProvidedDependency['import'], dependency: string, target: 'var' | 'amd');
+    libIdent(): string;
+    chunkCondition(): boolean;
+    getDependency(): string;
+    getConcatenationBailoutReason(): string;
+}

package/dist/webpack-modules/ProvidedExternalDependencyModule.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ExternalModule_1 = __importDefault(require("webpack/lib/ExternalModule"));
+/**
+ * ProvidedExternalModule ensures that the `chunkCondition` is true to allow proper asyncChunk context handling
+ * ExternalModules can be defined in different ways. Some of them require the external module to be loaded in the entry point.
+ * This is generally not bad as it doesnt cost anything. However the WRM Plugin relies on ExternalModules to specify provided dependencies.
+ * These provided dependencies are then added to the context of the chunk in which they occur. Async chunks should therefore
+ * have their own dependencies to make the entrypoint as small as possible.
+ * ProvidedExternalModule ensures that.
+ */
+class ProvidedExternalDependencyModule extends ExternalModule_1.default {
+    constructor(request, dependency, target) {
+        super(request, target);
+        this._request = request;
+        this._wrmDependency = dependency;
+        this._target = target;
+    }
+    libIdent() {
+        return `${this._wrmDependency}/${typeof this._request === 'string' ? this._request : this._request[this._target]}`;
+    }
+    chunkCondition() {
+        return true;
+    }
+    getDependency() {
+        return this._wrmDependency;
+    }
+    getConcatenationBailoutReason() {
+        return `Provided external dependencies can't be concatenated`;
+    }
+}
+exports.default = ProvidedExternalDependencyModule;
+//# sourceMappingURL=ProvidedExternalDependencyModule.js.map

package/dist/webpack-modules/ProvidedExternalDependencyModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProvidedExternalDependencyModule.js","sourceRoot":"","sources":["../../src/webpack-modules/ProvidedExternalDependencyModule.ts"],"names":[],"mappings":";;;;;AAAA,gFAAwD;AAIxD;;;;;;;GAOG;AACH,MAAqB,gCAAiC,SAAQ,wBAAc;IAK1E,YAAY,OAAqC,EAAE,UAAkB,EAAE,MAAqB;QAC1F,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACrH,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,6BAA6B;QAC3B,OAAO,sDAAsD,CAAC;IAChE,CAAC;CACF;AA3BD,mDA2BC"}

package/dist/webpack-modules/WrmDependencyModule.d.ts

@@ -0,0 +1,6 @@
+import EmptyExportsModule from './EmptyExportsModule';
+export default class WrmDependencyModule extends EmptyExportsModule {
+    private _wrmDependency;
+    constructor(dependency: string, type: string, pluginKey: string);
+    getDependency(): string;
+}

package/dist/webpack-modules/WrmDependencyModule.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const EmptyExportsModule_1 = __importDefault(require("./EmptyExportsModule"));
+class WrmDependencyModule extends EmptyExportsModule_1.default {
+    constructor(dependency, type, pluginKey) {
+        super(dependency, type);
+        this._wrmDependency = dependency.includes(':') ? dependency : `${pluginKey}:${dependency}`;
+    }
+    getDependency() {
+        return this._wrmDependency;
+    }
+}
+exports.default = WrmDependencyModule;
+//# sourceMappingURL=WrmDependencyModule.js.map

package/dist/webpack-modules/WrmDependencyModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrmDependencyModule.js","sourceRoot":"","sources":["../../src/webpack-modules/WrmDependencyModule.ts"],"names":[],"mappings":";;;;;AAAA,8EAAsD;AAEtD,MAAqB,mBAAoB,SAAQ,4BAAkB;IAGjE,YAAY,UAAkB,EAAE,IAAY,EAAE,SAAiB;QAC7D,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;IAC7F,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AAXD,sCAWC"}

package/dist/webpack-modules/WrmResourceModule.d.ts

@@ -0,0 +1,10 @@
+import EmptyExportsModule from './EmptyExportsModule';
+export default class WrmResourceModule extends EmptyExportsModule {
+    private _resource;
+    constructor(resourceNameAndLocationPair: string, target: string, requestContext: string, rootContext: string);
+    getResourcePair(): [string, string];
+    getResource(): {
+        name: string;
+        location: string;
+    };
+}

package/dist/webpack-modules/WrmResourceModule.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const EmptyExportsModule_1 = __importDefault(require("./EmptyExportsModule"));
+class WrmResourceModule extends EmptyExportsModule_1.default {
+    constructor(resourceNameAndLocationPair, target, requestContext, rootContext) {
+        super(resourceNameAndLocationPair, target);
+        const resourcePair = resourceNameAndLocationPair.split('!');
+        let resPath = resourcePair[1];
+        // enable relative resource-paths. Still requires that this resource is correctly copied to the right location in target.
+        if (resPath.startsWith('./') || resPath.startsWith('../')) {
+            const fullResourcePath = path_1.default.join(requestContext, resPath);
+            resPath = path_1.default.relative(rootContext, fullResourcePath);
+        }
+        this._resource = [resourcePair[0], resPath];
+    }
+    getResourcePair() {
+        return this._resource;
+    }
+    getResource() {
+        const [name, location] = this._resource;
+        return { name, location };
+    }
+}
+exports.default = WrmResourceModule;
+//# sourceMappingURL=WrmResourceModule.js.map

package/dist/webpack-modules/WrmResourceModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrmResourceModule.js","sourceRoot":"","sources":["../../src/webpack-modules/WrmResourceModule.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AAExB,8EAAsD;AAEtD,MAAqB,iBAAkB,SAAQ,4BAAkB;IAG/D,YAAY,2BAAmC,EAAE,MAAc,EAAE,cAAsB,EAAE,WAAmB;QAC1G,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAE9B,yHAAyH;QACzH,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YACzD,MAAM,gBAAgB,GAAG,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO,GAAG,cAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;SACxD;QAED,IAAI,CAAC,SAAS,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,WAAW;QACT,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;CACF;AAzBD,oCAyBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlassian/webresource-webpack-plugin",
-  "version": "7.0.2",
+  "version": "7.0.3",
   "description": "Auto-generates web-resource definitions from your webpacked code, for usage in an Atlassian product or plugin.",
   "main": "dist/WrmPlugin.js",
   "types": "dist/WrmPlugin.d.ts",
@@ -116,5 +116,5 @@
     "test": "jest",
     "test:watch": "jest --watch"
   },
-  "gitHead": "622a7f318cc99f3760df5c1c90a5598b202526fd"
+  "gitHead": "97de29c8ee207d7c11d0a48b457a7b83202cdf43"
 }