implement amd.autoId/amd.basePath options

cli/help.md

@@ -20,6 +20,8 @@ Basic options:
 -v, --version               Show version number
 -w, --watch                 Watch files in bundle and rebuild on changes
 --amd.id <id>               ID for AMD module (default is anonymous)
+--amd.autoId                Generate the AMD ID based off the chunk name
+--amd.basePath <prefix>     Path prepended to auto generated AMD ID
 --amd.define <name>         Function to use in place of `define`
 --assetFileNames <pattern>  Name pattern for emitted assets
 --banner <text>             Code to insert at top of bundle (outside wrapper)

docs/01-command-line-reference.md

@@ -278,6 +278,8 @@ Many options have command line equivalents. In those cases, any arguments passed
 -v, --version               Show version number
 -w, --watch                 Watch files in bundle and rebuild on changes
 --amd.id <id>               ID for AMD module (default is anonymous)
+--amd.autoId                Generate the AMD ID based off the chunk name
+--amd.basePath <prefix>     Path prepended to auto generated AMD ID
 --amd.define <name>         Function to use in place of `define`
 --assetFileNames <pattern>  Name pattern for emitted assets
 --banner <text>             Code to insert at top of bundle (outside wrapper)

docs/999-big-list-of-options.md

@@ -1053,15 +1053,15 @@ Type: `((id: string) => string) | { [id: string]: string }`<br>
 Same as [`context`](guide/en/#context), but per-module – can either be an object of `id: context` pairs, or an `id => context` function.
 
 #### output.amd
-Type: `{ id?: string, define?: string}`
+Type: `{ id?: string, autoId?: boolean, basePath?: string, define?: string }`
 
 An object that can contain the following properties:
 
 **output.amd.id**<br>
 Type: `string`<br>
 CLI: `--amd.id <amdId>`
 
-An ID to use for AMD/UMD bundles:
+An ID to use for AMD/UMD bundles.
 
 ```js
 // rollup.config.js
@@ -1076,6 +1076,49 @@ export default {
 // -> define('my-bundle', ['dependency'], ...
 ```
 
+**output.amd.autoId**<br>
+Type: `boolean`<br>
+CLI: `--amd.autoId`
+
+Set the ID to the chunk ID (with the '.js' extension removed).
+
+```js
+// rollup.config.js
+export default {
+  ...,
+  format: 'amd',
+  amd: {
+    autoId: true
+  }
+};
+
+// -> define('main', ['dependency'], ...
+// -> define('dynamic-chunk', ['dependency'], ...
+```
+
+**output.amd.basePath**<br>
+Type: `string`<br>
+CLI: `--amd.basePath`
+
+The path that will be prepended to the auto generated ID. This is useful if the build is going to be placed inside another AMD project, and is not at the root.
+
+Only valid with `output.amd.autoId`.
+
+```js
+// rollup.config.js
+export default {
+  ...,
+  format: 'amd',
+  amd: {
+    autoId: true
+    basePath: 'some/where'
+  }
+};
+
+// -> define('some/where/main', ['dependency'], ...
+// -> define('some/where/dynamic-chunk', ['dependency'], ...
+```
+
 **output.amd.define**<br>
 Type: `string`<br>
 CLI: `--amd.define <defineFunctionName>`

src/Chunk.ts

@@ -414,7 +414,7 @@ export default class Chunk {
 				: [options.chunkFileNames, 'output.chunkFileNames'];
 		return makeUnique(
 			renderNamePattern(
-				pattern,
+				typeof pattern === 'function' ? pattern(this.getChunkInfo()) : pattern,
 				patternName,
 				{
 					format: () => options.format,
@@ -423,8 +423,7 @@ export default class Chunk {
 							? this.computeContentHashWithDependencies(addons, options, existingNames)
 							: '[hash]',
 					name: () => this.getChunkName()
-				},
-				this.getChunkInfo.bind(this)
+				}
 			),
 			existingNames
 		);
@@ -448,15 +447,14 @@ export default class Chunk {
 				: options.entryFileNames;
 			const currentDir = dirname(sanitizedId);
 			const fileName = renderNamePattern(
-				pattern,
+				typeof pattern === 'function' ? pattern(this.getChunkInfo()) : pattern,
 				'output.entryFileNames',
 				{
 					ext: () => extension.substr(1),
 					extname: () => extension,
 					format: () => options.format as string,
 					name: () => this.getChunkName()
-				},
-				this.getChunkInfo.bind(this)
+				}
 			);
 			const currentPath = `${currentDir}/${fileName}`;
 			const { preserveModulesRoot } = options;
@@ -712,13 +710,18 @@ export default class Chunk {
 			});
 		}
 
+		if (!this.id) {
+			throw new Error('Internal Error: expecting chunk id');
+		}
+
 		const magicString = finalise(
 			this.renderedSource!,
 			{
 				accessedGlobals,
 				dependencies: [...this.renderedDependencies!.values()],
 				exports: this.renderedExports!,
 				hasExports,
+				id: this.id,
 				indentString: this.indentString,
 				intro: addons.intro!,
 				isEntryFacade:
@@ -754,8 +757,8 @@ export default class Chunk {
 
 			let file: string;
 			if (options.file) file = resolve(options.sourcemapFile || options.file);
-			else if (options.dir) file = resolve(options.dir, this.id!);
-			else file = resolve(this.id!);
+			else if (options.dir) file = resolve(options.dir, this.id);
+			else file = resolve(this.id);
 
 			const decodedMap = magicString.generateDecodedMap({});
 			map = collapseSourcemaps(

src/finalisers/amd.ts

@@ -1,6 +1,7 @@
 import { Bundle as MagicStringBundle } from 'magic-string';
 import { NormalizedOutputOptions } from '../rollup/types';
 import { FinaliserOptions } from './index';
+import getCompleteAmdId from './shared/getCompleteAmdId';
 import { getExportBlock, getNamespaceMarkers } from './shared/getExportBlock';
 import getInteropBlock from './shared/getInteropBlock';
 import removeExtensionFromRelativeAmdId from './shared/removeExtensionFromRelativeAmdId';
@@ -13,6 +14,7 @@ export default function amd(
 		dependencies,
 		exports,
 		hasExports,
+		id,
 		indentString: t,
 		intro,
 		isEntryFacade,
@@ -23,7 +25,7 @@ export default function amd(
 		warn
 	}: FinaliserOptions,
 	{
-		amd: { define: amdDefine, id: amdId },
+		amd,
 		compact,
 		esModule,
 		externalLiveBindings,
@@ -55,8 +57,10 @@ export default function amd(
 		deps.unshift(`'module'`);
 	}
 
+	const completeAmdId = getCompleteAmdId(amd, id);
 	const params =
-		(amdId ? `'${amdId}',${_}` : ``) + (deps.length ? `[${deps.join(`,${_}`)}],${_}` : ``);
+		(completeAmdId ? `'${completeAmdId}',${_}` : ``) +
+		(deps.length ? `[${deps.join(`,${_}`)}],${_}` : ``);
 	const useStrict = strict ? `${_}'use strict';` : '';
 
 	magicString.prepend(
@@ -97,6 +101,6 @@ export default function amd(
 	magicString.append(`${exportBlock}${namespaceMarkers}${outro}`);
 	return magicString
 		.indent(t)
-		.prepend(`${amdDefine}(${params}function${_}(${args.join(`,${_}`)})${_}{${useStrict}${n}${n}`)
+		.prepend(`${amd.define}(${params}function${_}(${args.join(`,${_}`)})${_}{${useStrict}${n}${n}`)
 		.append(`${n}${n}});`);
 }

src/finalisers/index.ts

@@ -13,6 +13,7 @@ export interface FinaliserOptions {
 	dependencies: ChunkDependencies;
 	exports: ChunkExports;
 	hasExports: boolean;
+	id: string;
 	indentString: string;
 	intro: string;
 	isEntryFacade: boolean;

src/finalisers/shared/getCompleteAmdId.ts

@@ -0,0 +1,15 @@
+import { NormalizedOutputOptions } from '../../rollup/types';
+import removeJsExtension from './removeJsExtension';
+
+export default function getCompleteAmdId(
+	{ id, autoId, basePath }: NormalizedOutputOptions['amd'],
+	chunkId: string
+): string {
+	if (id) {
+		return id;
+	} else if (autoId) {
+		return `${basePath ? basePath + '/' : ''}${removeJsExtension(chunkId)}`;
+	} else {
+		return '';
+	}
+}

src/finalisers/shared/removeExtensionFromRelativeAmdId.ts

@@ -1,9 +1,8 @@
+import removeJsExtension from './removeJsExtension';
+
 // AMD resolution will only respect the AMD baseUrl if the .js extension is omitted.
 // The assumption is that this makes sense for all relative ids:
 // https://requirejs.org/docs/api.html#jsfiles
 export default function removeExtensionFromRelativeAmdId(id: string) {
-	if (id[0] === '.' && id.endsWith('.js')) {
-		return id.slice(0, -3);
-	}
-	return id;
+	return id[0] === '.' ? removeJsExtension(id) : id;
 }

src/finalisers/shared/removeJsExtension.ts

@@ -0,0 +1,3 @@
+export default function removeJsExtension(name: string) {
+	return name.endsWith('.js') ? name.slice(0, -3) : name;
+}

src/finalisers/umd.ts

@@ -2,6 +2,7 @@ import { Bundle as MagicStringBundle } from 'magic-string';
 import { NormalizedOutputOptions } from '../rollup/types';
 import { error } from '../utils/error';
 import { FinaliserOptions } from './index';
+import getCompleteAmdId from './shared/getCompleteAmdId';
 import { getExportBlock, getNamespaceMarkers } from './shared/getExportBlock';
 import getInteropBlock from './shared/getInteropBlock';
 import removeExtensionFromRelativeAmdId from './shared/removeExtensionFromRelativeAmdId';
@@ -29,6 +30,7 @@ export default function umd(
 		dependencies,
 		exports,
 		hasExports,
+		id,
 		indentString: t,
 		intro,
 		namedExportsMode,
@@ -37,7 +39,7 @@ export default function umd(
 		warn
 	}: FinaliserOptions,
 	{
-		amd: { define: amdDefine, id: amdId },
+		amd,
 		compact,
 		esModule,
 		extend,
@@ -90,10 +92,12 @@ export default function umd(
 		factoryArgs.unshift('exports');
 	}
 
+	const completeAmdId = getCompleteAmdId(amd, id);
 	const amdParams =
-		(amdId ? `'${amdId}',${_}` : ``) + (amdDeps.length ? `[${amdDeps.join(`,${_}`)}],${_}` : ``);
+		(completeAmdId ? `'${completeAmdId}',${_}` : ``) +
+		(amdDeps.length ? `[${amdDeps.join(`,${_}`)}],${_}` : ``);
 
-	const define = amdDefine;
+	const define = amd.define;
 	const cjsExport = !namedExportsMode && hasExports ? `module.exports${_}=${_}` : ``;
 	const useStrict = strict ? `${_}'use strict';${n}` : ``;
 

src/rollup/types.d.ts

@@ -320,8 +320,12 @@ export type ResolveFileUrlHook = (
 export type AddonHookFunction = (this: PluginContext) => string | Promise<string>;
 export type AddonHook = string | AddonHookFunction;
 
-export type ChangeEvent = 'create' | 'update' | 'delete'
-export type WatchChangeHook = (this: PluginContext, id: string, change: {event: ChangeEvent}) => void
+export type ChangeEvent = 'create' | 'update' | 'delete';
+export type WatchChangeHook = (
+	this: PluginContext,
+	id: string,
+	change: { event: ChangeEvent }
+) => void;
 
 /**
  * use this type for plugin annotation
@@ -574,6 +578,8 @@ export type GetInterop = (id: string | null) => InteropType;
 
 export interface OutputOptions {
 	amd?: {
+		autoId?: boolean;
+		basePath?: string;
 		define?: string;
 		id?: string;
 	};
@@ -622,6 +628,8 @@ export interface OutputOptions {
 
 export interface NormalizedOutputOptions {
 	amd: {
+		autoId: boolean;
+		basePath: string;
 		define: string;
 		id?: string;
 	};
@@ -794,7 +802,7 @@ export interface RollupWatchOptions extends InputOptions {
 	watch?: WatcherOptions | false;
 }
 
-interface TypedEventEmitter<T extends {[event: string]: (...args: any) => any}> {
+interface TypedEventEmitter<T extends { [event: string]: (...args: any) => any }> {
 	addListener<K extends keyof T>(event: K, listener: T[K]): this;
 	emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): boolean;
 	eventNames(): Array<keyof T>;
@@ -827,7 +835,7 @@ export type RollupWatcherEvent =
 
 export interface RollupWatcher
 	extends TypedEventEmitter<{
-		change: (id: string, change: {event: ChangeEvent}) => void;
+		change: (id: string, change: { event: ChangeEvent }) => void;
 		close: () => void;
 		event: (event: RollupWatcherEvent) => void;
 		restart: () => void;

src/utils/FileEmitter.ts

@@ -41,7 +41,9 @@ function generateAssetFileName(
 	const emittedName = name || 'asset';
 	return makeUnique(
 		renderNamePattern(
-			output.assetFileNames,
+			typeof output.assetFileNames === 'function'
+				? output.assetFileNames({ name, source, type: 'asset' })
+				: output.assetFileNames,
 			'output.assetFileNames',
 			{
 				hash() {
@@ -54,8 +56,7 @@ function generateAssetFileName(
 				ext: () => extname(emittedName).substr(1),
 				extname: () => extname(emittedName),
 				name: () => emittedName.substr(0, emittedName.length - extname(emittedName).length)
-			},
-			() => ({ name, source, type: 'asset' })
+			}
 		),
 		output.bundle
 	);

src/utils/options/normalizeOutputOptions.ts

@@ -179,18 +179,28 @@ const getPreserveModulesRoot = (config: GenericConfigObject): string | undefined
 	return resolve(preserveModulesRoot);
 };
 
-const getAmd = (
-	config: GenericConfigObject
-): {
-	define: string;
-	id?: string;
-} => ({
-	define: 'define',
-	...(config.amd as {
-		define?: string;
-		id?: string;
-	})
-});
+const getAmd = (config: GenericConfigObject): NormalizedOutputOptions['amd'] => {
+	const normalized = {
+		autoId: false,
+		basePath: '',
+		define: 'define',
+		...(config.amd as OutputOptions['amd'])
+	};
+	if ((normalized.autoId || normalized.basePath) && normalized.id) {
+		return error({
+			code: 'INVALID_OPTION',
+			message:
+				'"output.amd.autoId"/"output.amd.basePath" and "output.amd.id" cannot be used together.'
+		});
+	}
+	if (normalized.basePath && !normalized.autoId) {
+		return error({
+			code: 'INVALID_OPTION',
+			message: '"output.amd.basePath" only works with "output.amd.autoId".'
+		});
+	}
+	return normalized;
+};
 
 const getAddon = (config: GenericConfigObject, name: string): (() => string | Promise<string>) => {
 	const configAddon = config[name] as string | (() => string | Promise<string>);