Allow namespaced packages

This is in preparation for the move to @khanacademy/tota11y

Author: bdukes

gulpfile.js

@@ -16,8 +16,14 @@ const {
 
 const libraries = getLibraries();
 
+/**
+ * Creates a Gulp task function to package the given library
+ *
+ * @param {Library} library - A library object
+ * @returns {Task} A Gulp task function
+ */
 function makePackageTask(library) {
-	const packageFn = function() {
+	const packageFn = () => {
 		const resourceZipStream =
 			library.manifest.resources && library.manifest.resources.length
 				? gulp
@@ -46,11 +52,17 @@ function makePackageTask(library) {
 	};
 
 	packageFn.displayName = `Generate ${library.name}_${library.version}.zip`;
+
 	return packageFn;
 }
 
 const defaultTask = gulp.parallel(...libraries.map(makePackageTask));
 
+/**
+ * A Gulp task to output a table of outdated libraries
+ *
+ * @returns {Promise} A promise which resolves when the outdated table is complete
+ */
 function outdated() {
 	const allUpgradesPromises = libraries.map(library =>
 		getUpgradeVersions(library).then(upgrades =>
@@ -76,8 +88,14 @@ ${formatPackageUpgrades(validUpgrades)}`);
 	});
 }
 
+/**
+ * Creates a Gulp task function to upgrade libraries
+ *
+ * @param {string} upgradeType - patch, minor, or major
+ * @returns {Task} A Gulp task function
+ */
 function makeUpgradeTask(upgradeType) {
-	const upgradeFn = function() {
+	const upgradeFn = () => {
 		const allUpgradesPromises = libraries.map(library =>
 			getUpgradeVersions(library).then(upgrades =>
 				Object.assign(library, { upgrades })

utility/packages.js

@@ -3,9 +3,37 @@
 const path = require('path');
 const glob = require('glob');
 const semver = require('semver');
+const log = require('fancy-log');
+const chalk = require('chalk');
 const packageJson = require('package-json');
 const { dependencies } = require('../package.json');
 
+const validLibraryNames = new Set(Object.keys(dependencies));
+
+/**
+ * Gets the name of the npm package from a path to a library
+ *
+ * @private
+ * @param {string} libraryPath - The path to the library directory
+ * @returns {string} The name of the library on the npm registry
+ */
+function resolveLibraryName(libraryPath) {
+	const name = path.basename(libraryPath);
+	if (validLibraryNames.has(name)) {
+		return name;
+	}
+
+	for (const libraryName of validLibraryNames) {
+		if (libraryName.endsWith(`/${name}`)) {
+			return libraryName;
+		}
+	}
+
+	log.warn(chalk`Unable to find npm package name for {yellow ${name}}`);
+
+	return null;
+}
+
 /**
  * Gets the current list of DNN JS libraries in this repo
  *
@@ -19,7 +47,7 @@ function getLibraries() {
 			manifest: require(path.resolve(manifestPath)),
 		}))
 		.map(library =>
-			Object.assign(library, { name: path.basename(library.path) })
+			Object.assign(library, { name: resolveLibraryName(library.path) })
 		)
 		.map(library =>
 			Object.assign(library, { version: dependencies[library.name] })