@k8slens/package-build 3.3.0 → 3.4.0

package/bin/extension-publish-check

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+const { extensionPublishCheck } = require("../dist");
+
+process.exitCode = extensionPublishCheck();

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { globImportPlugin } from "./src/glob-import-plugin";
 export { packageBuild } from "./src/package-build";
 export { stylesheetPlugin, type StylesheetPluginParams } from "./src/stylesheet-plugin";
 export { extensionDependenciesCheck } from "./src/extension-dependencies-check";
+export { extensionPublishCheck } from "./src/extension-publish-check";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -1360,11 +1360,11 @@ var require_lodash = __commonJS({
             return isFunction(object[key]);
           });
         }
-        function baseGet(object, path5) {
-          path5 = castPath(path5, object);
-          var index = 0, length = path5.length;
+        function baseGet(object, path6) {
+          path6 = castPath(path6, object);
+          var index = 0, length = path6.length;
           while (object != null && index < length) {
-            object = object[toKey(path5[index++])];
+            object = object[toKey(path6[index++])];
           }
           return index && index == length ? object : undefined2;
         }
@@ -1428,10 +1428,10 @@ var require_lodash = __commonJS({
           });
           return accumulator;
         }
-        function baseInvoke(object, path5, args) {
-          path5 = castPath(path5, object);
-          object = parent(object, path5);
-          var func = object == null ? object : object[toKey(last(path5))];
+        function baseInvoke(object, path6, args) {
+          path6 = castPath(path6, object);
+          object = parent(object, path6);
+          var func = object == null ? object : object[toKey(last(path6))];
           return func == null ? undefined2 : apply(func, object, args);
         }
         function baseIsArguments(value) {
@@ -1587,13 +1587,13 @@ var require_lodash = __commonJS({
             return object === source || baseIsMatch(object, source, matchData);
           };
         }
-        function baseMatchesProperty(path5, srcValue) {
-          if (isKey(path5) && isStrictComparable(srcValue)) {
-            return matchesStrictComparable(toKey(path5), srcValue);
+        function baseMatchesProperty(path6, srcValue) {
+          if (isKey(path6) && isStrictComparable(srcValue)) {
+            return matchesStrictComparable(toKey(path6), srcValue);
           }
           return function(object) {
-            var objValue = get(object, path5);
-            return objValue === undefined2 && objValue === srcValue ? hasIn(object, path5) : baseIsEqual(srcValue, objValue, COMPARE_PARTIAL_FLAG | COMPARE_UNORDERED_FLAG);
+            var objValue = get(object, path6);
+            return objValue === undefined2 && objValue === srcValue ? hasIn(object, path6) : baseIsEqual(srcValue, objValue, COMPARE_PARTIAL_FLAG | COMPARE_UNORDERED_FLAG);
           };
         }
         function baseMerge(object, source, srcIndex, customizer, stack) {
@@ -1690,23 +1690,23 @@ var require_lodash = __commonJS({
           });
         }
         function basePick(object, paths) {
-          return basePickBy(object, paths, function(value, path5) {
-            return hasIn(object, path5);
+          return basePickBy(object, paths, function(value, path6) {
+            return hasIn(object, path6);
           });
         }
         function basePickBy(object, paths, predicate) {
           var index = -1, length = paths.length, result2 = {};
           while (++index < length) {
-            var path5 = paths[index], value = baseGet(object, path5);
-            if (predicate(value, path5)) {
-              baseSet(result2, castPath(path5, object), value);
+            var path6 = paths[index], value = baseGet(object, path6);
+            if (predicate(value, path6)) {
+              baseSet(result2, castPath(path6, object), value);
             }
           }
           return result2;
         }
-        function basePropertyDeep(path5) {
+        function basePropertyDeep(path6) {
           return function(object) {
-            return baseGet(object, path5);
+            return baseGet(object, path6);
           };
         }
         function basePullAll(array, values2, iteratee2, comparator) {
@@ -1780,14 +1780,14 @@ var require_lodash = __commonJS({
           var array = values(collection);
           return shuffleSelf(array, baseClamp(n, 0, array.length));
         }
-        function baseSet(object, path5, value, customizer) {
+        function baseSet(object, path6, value, customizer) {
           if (!isObject(object)) {
             return object;
           }
-          path5 = castPath(path5, object);
-          var index = -1, length = path5.length, lastIndex = length - 1, nested = object;
+          path6 = castPath(path6, object);
+          var index = -1, length = path6.length, lastIndex = length - 1, nested = object;
           while (nested != null && ++index < length) {
-            var key = toKey(path5[index]), newValue = value;
+            var key = toKey(path6[index]), newValue = value;
             if (key === "__proto__" || key === "constructor" || key === "prototype") {
               return object;
             }
@@ -1795,7 +1795,7 @@ var require_lodash = __commonJS({
               var objValue = nested[key];
               newValue = customizer ? customizer(objValue, key, nested) : undefined2;
               if (newValue === undefined2) {
-                newValue = isObject(objValue) ? objValue : isIndex(path5[index + 1]) ? [] : {};
+                newValue = isObject(objValue) ? objValue : isIndex(path6[index + 1]) ? [] : {};
               }
             }
             assignValue(nested, key, newValue);
@@ -1961,33 +1961,33 @@ var require_lodash = __commonJS({
             }
           return result2;
         }
-        function baseUnset(object, path5) {
-          path5 = castPath(path5, object);
-          var index = -1, length = path5.length;
+        function baseUnset(object, path6) {
+          path6 = castPath(path6, object);
+          var index = -1, length = path6.length;
           if (!length) {
             return true;
           }
           var isRootPrimitive = object == null || typeof object !== "object" && typeof object !== "function";
           while (++index < length) {
-            var key = path5[index];
+            var key = path6[index];
             if (typeof key !== "string") {
               continue;
             }
             if (key === "__proto__" && !hasOwnProperty2.call(object, "__proto__")) {
               return false;
             }
-            if (key === "constructor" && index + 1 < length && typeof path5[index + 1] === "string" && path5[index + 1] === "prototype") {
+            if (key === "constructor" && index + 1 < length && typeof path6[index + 1] === "string" && path6[index + 1] === "prototype") {
               if (isRootPrimitive && index === 0) {
                 continue;
               }
               return false;
             }
           }
-          var obj = parent(object, path5);
-          return obj == null || delete obj[toKey(last(path5))];
+          var obj = parent(object, path6);
+          return obj == null || delete obj[toKey(last(path6))];
         }
-        function baseUpdate(object, path5, updater, customizer) {
-          return baseSet(object, path5, updater(baseGet(object, path5)), customizer);
+        function baseUpdate(object, path6, updater, customizer) {
+          return baseSet(object, path6, updater(baseGet(object, path6)), customizer);
         }
         function baseWhile(array, predicate, isDrop, fromRight) {
           var length = array.length, index = fromRight ? length : -1;
@@ -2870,11 +2870,11 @@ var require_lodash = __commonJS({
           var match = source.match(reWrapDetails);
           return match ? match[1].split(reSplitDetails) : [];
         }
-        function hasPath(object, path5, hasFunc) {
-          path5 = castPath(path5, object);
-          var index = -1, length = path5.length, result2 = false;
+        function hasPath(object, path6, hasFunc) {
+          path6 = castPath(path6, object);
+          var index = -1, length = path6.length, result2 = false;
           while (++index < length) {
-            var key = toKey(path5[index]);
+            var key = toKey(path6[index]);
             if (!(result2 = object != null && hasFunc(object, key))) {
               break;
             }
@@ -3076,8 +3076,8 @@ var require_lodash = __commonJS({
             return apply(func, this, otherArgs);
           };
         }
-        function parent(object, path5) {
-          return path5.length < 2 ? object : baseGet(object, baseSlice(path5, 0, -1));
+        function parent(object, path6) {
+          return path6.length < 2 ? object : baseGet(object, baseSlice(path6, 0, -1));
         }
         function reorder(array, indexes) {
           var arrLength = array.length, length = nativeMin(indexes.length, arrLength), oldArray = copyArray(array);
@@ -3712,10 +3712,10 @@ var require_lodash = __commonJS({
           }
           return isString(collection) ? fromIndex <= length && collection.indexOf(value, fromIndex) > -1 : !!length && baseIndexOf(collection, value, fromIndex) > -1;
         }
-        var invokeMap = baseRest(function(collection, path5, args) {
-          var index = -1, isFunc = typeof path5 == "function", result2 = isArrayLike(collection) ? Array2(collection.length) : [];
+        var invokeMap = baseRest(function(collection, path6, args) {
+          var index = -1, isFunc = typeof path6 == "function", result2 = isArrayLike(collection) ? Array2(collection.length) : [];
           baseEach(collection, function(value) {
-            result2[++index] = isFunc ? apply(path5, value, args) : baseInvoke(value, path5, args);
+            result2[++index] = isFunc ? apply(path6, value, args) : baseInvoke(value, path6, args);
           });
           return result2;
         });
@@ -4367,15 +4367,15 @@ var require_lodash = __commonJS({
         function functionsIn(object) {
           return object == null ? [] : baseFunctions(object, keysIn(object));
         }
-        function get(object, path5, defaultValue) {
-          var result2 = object == null ? undefined2 : baseGet(object, path5);
+        function get(object, path6, defaultValue) {
+          var result2 = object == null ? undefined2 : baseGet(object, path6);
           return result2 === undefined2 ? defaultValue : result2;
         }
-        function has(object, path5) {
-          return object != null && hasPath(object, path5, baseHas);
+        function has(object, path6) {
+          return object != null && hasPath(object, path6, baseHas);
         }
-        function hasIn(object, path5) {
-          return object != null && hasPath(object, path5, baseHasIn);
+        function hasIn(object, path6) {
+          return object != null && hasPath(object, path6, baseHasIn);
         }
         var invert = createInverter(function(result2, value, key) {
           if (value != null && typeof value.toString != "function") {
@@ -4428,10 +4428,10 @@ var require_lodash = __commonJS({
             return result2;
           }
           var isDeep = false;
-          paths = arrayMap(paths, function(path5) {
-            path5 = castPath(path5, object);
-            isDeep || (isDeep = path5.length > 1);
-            return path5;
+          paths = arrayMap(paths, function(path6) {
+            path6 = castPath(path6, object);
+            isDeep || (isDeep = path6.length > 1);
+            return path6;
           });
           copyObject(object, getAllKeysIn(object), result2);
           if (isDeep) {
@@ -4457,19 +4457,19 @@ var require_lodash = __commonJS({
             return [prop];
           });
           predicate = getIteratee(predicate);
-          return basePickBy(object, props, function(value, path5) {
-            return predicate(value, path5[0]);
+          return basePickBy(object, props, function(value, path6) {
+            return predicate(value, path6[0]);
           });
         }
-        function result(object, path5, defaultValue) {
-          path5 = castPath(path5, object);
-          var index = -1, length = path5.length;
+        function result(object, path6, defaultValue) {
+          path6 = castPath(path6, object);
+          var index = -1, length = path6.length;
           if (!length) {
             length = 1;
             object = undefined2;
           }
           while (++index < length) {
-            var value = object == null ? undefined2 : object[toKey(path5[index])];
+            var value = object == null ? undefined2 : object[toKey(path6[index])];
             if (value === undefined2) {
               index = length;
               value = defaultValue;
@@ -4478,12 +4478,12 @@ var require_lodash = __commonJS({
           }
           return object;
         }
-        function set(object, path5, value) {
-          return object == null ? object : baseSet(object, path5, value);
+        function set(object, path6, value) {
+          return object == null ? object : baseSet(object, path6, value);
         }
-        function setWith(object, path5, value, customizer) {
+        function setWith(object, path6, value, customizer) {
           customizer = typeof customizer == "function" ? customizer : undefined2;
-          return object == null ? object : baseSet(object, path5, value, customizer);
+          return object == null ? object : baseSet(object, path6, value, customizer);
         }
         var toPairs = createToPairs(keys);
         var toPairsIn = createToPairs(keysIn);
@@ -4505,15 +4505,15 @@ var require_lodash = __commonJS({
           });
           return accumulator;
         }
-        function unset(object, path5) {
-          return object == null ? true : baseUnset(object, path5);
+        function unset(object, path6) {
+          return object == null ? true : baseUnset(object, path6);
         }
-        function update(object, path5, updater) {
-          return object == null ? object : baseUpdate(object, path5, castFunction(updater));
+        function update(object, path6, updater) {
+          return object == null ? object : baseUpdate(object, path6, castFunction(updater));
         }
-        function updateWith(object, path5, updater, customizer) {
+        function updateWith(object, path6, updater, customizer) {
           customizer = typeof customizer == "function" ? customizer : undefined2;
-          return object == null ? object : baseUpdate(object, path5, castFunction(updater), customizer);
+          return object == null ? object : baseUpdate(object, path6, castFunction(updater), customizer);
         }
         function values(object) {
           return object == null ? [] : baseValues(object, keys(object));
@@ -4894,17 +4894,17 @@ var require_lodash = __commonJS({
         function matches(source) {
           return baseMatches(baseClone(source, CLONE_DEEP_FLAG));
         }
-        function matchesProperty(path5, srcValue) {
-          return baseMatchesProperty(path5, baseClone(srcValue, CLONE_DEEP_FLAG));
+        function matchesProperty(path6, srcValue) {
+          return baseMatchesProperty(path6, baseClone(srcValue, CLONE_DEEP_FLAG));
         }
-        var method = baseRest(function(path5, args) {
+        var method = baseRest(function(path6, args) {
           return function(object) {
-            return baseInvoke(object, path5, args);
+            return baseInvoke(object, path6, args);
           };
         });
         var methodOf = baseRest(function(object, args) {
-          return function(path5) {
-            return baseInvoke(object, path5, args);
+          return function(path6) {
+            return baseInvoke(object, path6, args);
           };
         });
         function mixin(object, source, options) {
@@ -4951,12 +4951,12 @@ var require_lodash = __commonJS({
         var over = createOver(arrayMap);
         var overEvery = createOver(arrayEvery);
         var overSome = createOver(arraySome);
-        function property(path5) {
-          return isKey(path5) ? baseProperty(toKey(path5)) : basePropertyDeep(path5);
+        function property(path6) {
+          return isKey(path6) ? baseProperty(toKey(path6)) : basePropertyDeep(path6);
         }
         function propertyOf(object) {
-          return function(path5) {
-            return object == null ? undefined2 : baseGet(object, path5);
+          return function(path6) {
+            return object == null ? undefined2 : baseGet(object, path6);
           };
         }
         var range = createRange();
@@ -5409,12 +5409,12 @@ var require_lodash = __commonJS({
         LazyWrapper.prototype.findLast = function(predicate) {
           return this.reverse().find(predicate);
         };
-        LazyWrapper.prototype.invokeMap = baseRest(function(path5, args) {
-          if (typeof path5 == "function") {
+        LazyWrapper.prototype.invokeMap = baseRest(function(path6, args) {
+          if (typeof path6 == "function") {
             return new LazyWrapper(this);
           }
           return this.map(function(value) {
-            return baseInvoke(value, path5, args);
+            return baseInvoke(value, path6, args);
           });
         });
         LazyWrapper.prototype.reject = function(predicate) {
@@ -5535,6 +5535,7 @@ var index_exports = {};
 __export(index_exports, {
   asciiOutputPlugin: () => asciiOutputPlugin,
   extensionDependenciesCheck: () => extensionDependenciesCheck,
+  extensionPublishCheck: () => extensionPublishCheck,
   globImportPlugin: () => globImportPlugin,
   packageBuild: () => packageBuild,
   stylesheetPlugin: () => stylesheetPlugin
@@ -11296,17 +11297,17 @@ var isEscapedByBackslash = (code, position) => {
   }
   return backslashes % 2 === 1;
 };
-var shiftColumnsOfSourceMapFile = async (path5, columnShifts) => {
+var shiftColumnsOfSourceMapFile = async (path6, columnShifts) => {
   let sourceMap;
   try {
-    sourceMap = await (0, import_promises.readFile)(path5);
+    sourceMap = await (0, import_promises.readFile)(path6);
   } catch (error) {
     if (error.code === "ENOENT") {
       return;
     }
     throw error;
   }
-  await (0, import_promises.writeFile)(path5, shiftColumnsOfSourceMap(sourceMap, columnShifts));
+  await (0, import_promises.writeFile)(path6, shiftColumnsOfSourceMap(sourceMap, columnShifts));
 };
 var shiftColumnsOfLine = (line, shifts) => {
   if (line === "") {
@@ -11368,24 +11369,24 @@ var globImportPlugin = () => ({
   setup: (build2) => {
     const uniquenessCache = /* @__PURE__ */ new Map();
     build2.onResolve({ filter: /\*/ }, async (args) => {
-      const { resolveDir, path: path5 } = args;
+      const { resolveDir, path: path6 } = args;
       if (resolveDir === "") {
         return;
       }
-      const cacheKey = (0, import_node_path.resolve)(resolveDir, path5);
+      const cacheKey = (0, import_node_path.resolve)(resolveDir, path6);
       const uniqueId = getOrInsertWith(uniquenessCache, cacheKey, getRandomUniqueId);
       return {
-        path: `${path5}/proof-of-uniqueness/${uniqueId}`,
+        path: `${path6}/proof-of-uniqueness/${uniqueId}`,
         namespace: "import-glob",
         pluginData: { resolveDir }
       };
     });
     build2.onLoad({ filter: /.*/, namespace: "import-glob" }, async (args) => {
       const {
-        path: path5,
+        path: path6,
         pluginData: { resolveDir }
       } = args;
-      const [globImportString] = path5.split("/proof-of-uniqueness/");
+      const [globImportString] = path6.split("/proof-of-uniqueness/");
       const files = (await (0, import_fast_glob.default)(globImportString, { cwd: resolveDir })).sort();
       const contents = [
         files.map((module2, index) => `import * as module${index} from './${module2}'`).join(";"),
@@ -11812,9 +11813,16 @@ var checkExtensionDependencies = ({
   packageJsonPath,
   versionsFilePath,
   fix,
-  log
+  log,
+  requireVersions = false
 }) => {
   const versions = readVersions(versionsFilePath);
+  if (!versions && requireVersions) {
+    log(
+      `Cannot check the dependency ranges against Lens: no "${versionsFilePath}", which Lens writes when it runs on this machine. Start Lens once, or name the versions of another Lens in ${extensionDependencyVersionsFileEnvironmentVariable}.`
+    );
+    return 1;
+  }
   if (!versions) {
     log(
       `Skipped checking dependency ranges against Lens: no "${versionsFilePath}", which Lens writes when it runs on this machine.`
@@ -11866,6 +11874,101 @@ var extensionDependenciesCheck = () => checkExtensionDependencies({
   fix: process.argv.slice(2).includes("--fix"),
   log: (line) => console.log(line)
 });
+
+// src/extension-publish-check.ts
+var import_node_child_process = require("node:child_process");
+var import_node_fs4 = require("node:fs");
+var import_node_path6 = __toESM(require("node:path"));
+var import_semver2 = __toESM(require("semver"));
+var prereleaseDistTag = "next";
+var relativeEntrypointOf = (packageJson2) => {
+  const { exports, main } = packageJson2;
+  if (exports === void 0 || exports === null) {
+    return typeof main === "string" ? main : void 0;
+  }
+  if (typeof exports === "string") {
+    return exports;
+  }
+  const defaultInExports = exports["."];
+  if (typeof defaultInExports === "string") {
+    return defaultInExports;
+  }
+  if (typeof defaultInExports === "object" && defaultInExports !== null) {
+    const conditions = defaultInExports;
+    const conditional = conditions.default ?? conditions.require;
+    if (typeof conditional === "string") {
+      return conditional;
+    }
+  }
+  return typeof main === "string" ? main : void 0;
+};
+var normalized = (relativePath) => relativePath.replaceAll("\\", "/").split("/").filter((segment) => segment !== "" && segment !== ".").join("/");
+var checkEntrypointIsPacked = (packageJson2, packedFiles) => {
+  const entrypoint = relativeEntrypointOf(packageJson2);
+  if (entrypoint === void 0) {
+    return 'package.json names no entrypoint: set "main" to the built file Lens loads, such as "./dist/index.js".';
+  }
+  if (!packedFiles().map(normalized).includes(normalized(entrypoint))) {
+    return `npm would publish the extension without its entrypoint "${entrypoint}", and Lens could not install it. Build first, and list the built directory in "files" of package.json, such as "files": ["dist"].`;
+  }
+  return void 0;
+};
+var checkPrereleaseIsTagged = (version2, distTag) => {
+  const isPrerelease = typeof version2 === "string" && (import_semver2.default.prerelease(version2) ?? []).length > 0;
+  if (!isPrerelease || distTag !== void 0 && distTag !== "latest") {
+    return void 0;
+  }
+  return `${version2} is a prerelease, which would become the version users see and install by default. Publish it with "--tag ${prereleaseDistTag}", or raise "version" in package.json to a release.`;
+};
+var checkExtensionPublishing = ({
+  packageJsonPath,
+  versionsFilePath,
+  packedFiles,
+  distTag,
+  log
+}) => {
+  const packageJson2 = JSON.parse((0, import_node_fs4.readFileSync)(packageJsonPath, "utf-8"));
+  const problems = [
+    checkEntrypointIsPacked(packageJson2, packedFiles),
+    checkPrereleaseIsTagged(packageJson2.version, distTag)
+  ].filter((problem) => problem !== void 0);
+  const dependenciesExitCode = checkExtensionDependencies({
+    packageJsonPath,
+    versionsFilePath,
+    fix: false,
+    log,
+    requireVersions: true
+  });
+  for (const problem of problems) {
+    log(problem);
+  }
+  if (problems.length > 0 || dependenciesExitCode !== 0) {
+    log("Not publishing: fix the above, and publish again.");
+    return 1;
+  }
+  return 0;
+};
+var packedFilesOf = (output) => {
+  const listingStart = output.indexOf("[");
+  if (listingStart === -1) {
+    return [];
+  }
+  const [packed] = JSON.parse(output.slice(listingStart));
+  return packed?.files?.map((file) => file.path) ?? [];
+};
+var extensionPublishCheck = ({ directory, environment, runCommand, log } = {
+  directory: process.cwd(),
+  environment: process.env,
+  runCommand: (command, cwd) => (0, import_node_child_process.execSync)(command, { cwd, encoding: "utf-8" }),
+  log: (line) => console.log(line)
+}) => checkExtensionPublishing({
+  packageJsonPath: import_node_path6.default.resolve(directory, "package.json"),
+  versionsFilePath: environment[extensionDependencyVersionsFileEnvironmentVariable] || defaultVersionsFilePath(),
+  packedFiles: () => packedFilesOf(runCommand("npm pack --dry-run --json --ignore-scripts", directory)),
+  // What npm tells the scripts it runs of `npm publish --tag <tag>`.
+  distTag: environment.npm_config_tag || void 0,
+  log
+});
 /*! Bundled license information:
 
 lodash/lodash.js:

package/dist/src/extension-dependencies-check.d.ts

@@ -1,10 +1,13 @@
 /** Overrides where the check reads the versions Lens serves, e.g. to check against another Lens than the one on this machine. */
 export declare const extensionDependencyVersionsFileEnvironmentVariable = "LENS_EXTENSION_DEPENDENCY_VERSIONS_FILE";
+export declare const defaultVersionsFilePath: () => string;
 export interface CheckExtensionDependenciesParams {
     readonly packageJsonPath: string;
     readonly versionsFilePath: string;
     readonly fix: boolean;
     readonly log: (line: string) => void;
+    /** Fails, instead of passing, when Lens has written no versions to check against: what publishing needs. */
+    readonly requireVersions?: boolean;
 }
 /**
  * Checks the ranges an extension's package.json declares for the packages Lens serves to
@@ -13,9 +16,9 @@ export interface CheckExtensionDependenciesParams {
  * fails the check; one in `devDependencies` only warns, as Lens never reads those. With `fix`,
  * rewrites every such range, in all three, to the caret range of the version Lens serves.
  *
- * @returns the exit code: 0 when Lens would load the extension, or when there is nothing to check against.
+ * @returns the exit code: 0 when Lens would load the extension, or when there is nothing to check against and `requireVersions` is not set.
  */
-export declare const checkExtensionDependencies: ({ packageJsonPath, versionsFilePath, fix, log, }: CheckExtensionDependenciesParams) => number;
+export declare const checkExtensionDependencies: ({ packageJsonPath, versionsFilePath, fix, log, requireVersions, }: CheckExtensionDependenciesParams) => number;
 /** The `lens-extension-dependencies-check [--fix]` command, run in the extension's directory. */
 export declare const extensionDependenciesCheck: () => number;
 //# sourceMappingURL=extension-dependencies-check.d.ts.map

package/dist/src/extension-dependencies-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-dependencies-check.d.ts","sourceRoot":"","sources":["../../src/extension-dependencies-check.ts"],"names":[],"mappings":"AAKA,iIAAiI;AACjI,eAAO,MAAM,kDAAkD,4CAA4C,CAAC;AAoB5G,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAyCD;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,qDAKpC,gCAAgC,KAAG,MA8DrC,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,QAAO,MAM1C,CAAC"}
+{"version":3,"file":"extension-dependencies-check.d.ts","sourceRoot":"","sources":["../../src/extension-dependencies-check.ts"],"names":[],"mappings":"AAKA,iIAAiI;AACjI,eAAO,MAAM,kDAAkD,4CAA4C,CAAC;AAK5G,eAAO,MAAM,uBAAuB,cAOjC,CAAC;AAQJ,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,4GAA4G;IAC5G,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAyCD;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,sEAMpC,gCAAgC,KAAG,MAsErC,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,QAAO,MAM1C,CAAC"}

package/dist/src/extension-publish-check.d.ts

@@ -0,0 +1,42 @@
+/** The dist-tag a prerelease is published under, so it never becomes the version users install by default. */
+export declare const prereleaseDistTag = "next";
+export interface CheckExtensionPublishingParams {
+    readonly packageJsonPath: string;
+    readonly versionsFilePath: string;
+    /** The paths npm would pack, relative to the extension's directory, as `npm pack --dry-run` lists them. */
+    readonly packedFiles: () => readonly string[];
+    /** The dist-tag npm is publishing under, when one was given. */
+    readonly distTag: string | undefined;
+    readonly log: (line: string) => void;
+}
+/**
+ * Checks an extension is fit to publish, before npm publishes it: that what npm packs has the
+ * entrypoint Lens loads, that Lens would accept every range the extension declares for a package
+ * Lens serves, and that a prerelease is not published as the latest version. Fails when Lens has
+ * written no versions to check the ranges against, as publishing unchecked is how an extension
+ * reaches users that no Lens loads.
+ *
+ * @returns the exit code: 0 when the extension is fit to publish.
+ */
+export declare const checkExtensionPublishing: ({ packageJsonPath, versionsFilePath, packedFiles, distTag, log, }: CheckExtensionPublishingParams) => number;
+/**
+ * The paths `npm pack --dry-run --json` says it would pack, from what it printed: one entry per
+ * package packed, listing its files, after whatever lines npm writes before it. None when npm
+ * printed no listing.
+ */
+export declare const packedFilesOf: (output: string) => string[];
+export interface ExtensionPublishCheckParams {
+    /** The extension's directory, where npm runs its scripts. */
+    readonly directory: string;
+    /** The environment npm runs the script in. */
+    readonly environment: Readonly<Record<string, string | undefined>>;
+    /** Runs a command in a directory, giving back what it printed. */
+    readonly runCommand: (command: string, directory: string) => string;
+    readonly log: (line: string) => void;
+}
+/**
+ * The `lens-extension-publish-check` command, run in the extension's directory, as its
+ * `prepublishOnly` script: npm runs it before every publish, and gives up publishing when it fails.
+ */
+export declare const extensionPublishCheck: ({ directory, environment, runCommand, log }?: ExtensionPublishCheckParams) => number;
+//# sourceMappingURL=extension-publish-check.d.ts.map

package/dist/src/extension-publish-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-publish-check.d.ts","sourceRoot":"","sources":["../../src/extension-publish-check.ts"],"names":[],"mappings":"AAUA,8GAA8G;AAC9G,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2GAA2G;IAC3G,QAAQ,CAAC,WAAW,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAC9C,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAiED;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,sEAMlC,8BAA8B,KAAG,MA2BnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,MAAM,EAUpD,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnE,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACpE,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iDACa,2BAA2B,KAMvE,MAQC,CAAC"}