@k8slens/package-build 3.2.0 → 3.4.0

package/dist/src/ascii-output-plugin.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "esbuild";
+/**
+ * Escapes what esbuild left outside ASCII in the bundle it wrote to `outfile`, and moves the columns
+ * of its source map to match. A string of the source of a script is one byte per character in V8
+ * only when every character of it is Latin-1: a single em dash in a comment makes it two.
+ */
+export declare const asciiOutputPlugin: () => Plugin;
+//# sourceMappingURL=ascii-output-plugin.d.ts.map

package/dist/src/ascii-output-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-output-plugin.d.ts","sourceRoot":"","sources":["../../src/ascii-output-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAqJtC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,MA6BnC,CAAC"}

package/dist/src/declared-imports-plugin.d.ts

@@ -0,0 +1,27 @@
+import type { Plugin } from "esbuild";
+export interface DeclaredImportsPluginParams {
+    readonly packageDirectory: string;
+    readonly packageJson: {
+        readonly name: string;
+        readonly dependencies?: Record<string, string>;
+        readonly peerDependencies?: Record<string, string>;
+        readonly devDependencies?: Record<string, string>;
+        readonly lens?: {
+            readonly inlinedDependencies?: readonly string[];
+        };
+    };
+}
+/**
+ * Keeps a package's dist to the package's own code: every bare import of the package's own
+ * sources must name a package declared in its dependencies or peerDependencies, and stays a
+ * `require()` of it. Esbuild would otherwise inline the imported package and everything it
+ * imports in turn, shipping a private copy of e.g. MobX or the DI container in the dist, with
+ * module state of its own. A package that inlines something on purpose names it in
+ * `lens.inlinedDependencies` (and declares it as a devDependency).
+ *
+ * A package of the Lens monorepo, which has a `lens` section in its package.json, fails to build
+ * on such an import. Any other package, such as an extension built with this tool, is warned
+ * instead, as its build inlined undeclared imports before and keeps doing so.
+ */
+export declare const declaredImportsPlugin: ({ packageDirectory, packageJson }: DeclaredImportsPluginParams) => Plugin;
+//# sourceMappingURL=declared-imports-plugin.d.ts.map

package/dist/src/declared-imports-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-imports-plugin.d.ts","sourceRoot":"","sources":["../../src/declared-imports-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKtC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;SAAE,CAAC;KACtE,CAAC;CACH;AAsBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,sCAAuC,2BAA2B,KAAG,MAwFtG,CAAC"}

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"}

package/dist/src/package-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-build.d.ts","sourceRoot":"","sources":["../../src/package-build.ts"],"names":[],"mappings":"AA4LA,eAAO,MAAM,YAAY,qBAkCxB,CAAC"}
+{"version":3,"file":"package-build.d.ts","sourceRoot":"","sources":["../../src/package-build.ts"],"names":[],"mappings":"AAiGA,eAAO,MAAM,YAAY,qBAkCxB,CAAC"}