@pithy-sh/vite 0.1.4 → 0.2.0

package/dist/clientEnvDeclaration.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 /**
  * **`client-env.d.ts` is generated from the four declared client projections (#398).**
  *

package/dist/clientEnvDeclaration.js

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 //#region src/clientEnvDeclaration.ts

package/dist/devOrigin.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 /**
  * The slice of `@cloudflare/vite-plugin`'s worker config this touches.
  *

package/dist/devOrigin.js

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { LOCAL_ENVIRONMENT } from "@pithy-sh/core/src/naming/environment";
 import { ENVIRONMENT_VAR, WORKER_ORIGIN_VAR } from "@pithy-sh/core/src/worker/identity";
 //#region src/devOrigin.ts

package/dist/plugin.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 /**
  * What {@link pithy} hands back: a Vite plugin, described without naming a Vite type.
  *

package/dist/plugin.js

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { capabilityNameFromResolvedId, isResolvedVirtualId, renderVirtualModule, resolveVirtualId } from "./virtualModule.js";
 import { loadWorkerConfig } from "./workerConfig.js";
 import { resolve } from "node:path";

package/dist/testPlugin.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { type PithyPlugin, type PithyPluginOptions } from "./plugin";
 /**
  * The Pithy plugin, for a test runner's config.

package/dist/testPlugin.js

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { pithy } from "./plugin.js";
 //#region src/testPlugin.ts
 /**

package/dist/virtualModule.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import type { ClientProjection } from "@pithy-sh/core/src/capability/client";
 /**
  * The import specifier a screen writes: `import auth from "virtual:pithy/auth"`. One module per

package/dist/virtualModule.js

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 //#region src/virtualModule.ts
 /**
 * The import specifier a screen writes: `import auth from "virtual:pithy/auth"`. One module per

package/dist/workerConfig.d.ts

@@ -1,3 +1,5 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import type { Capability } from "@pithy-sh/core/src/capability/capability";
 /** One Worker's composed capabilities, indexed by name, plus the files the config was built from. */
 export interface LoadedWorkerConfig {
@@ -43,7 +45,17 @@ export interface WorkerConfigFailure {
     /** The remedy, chosen from the kind. Carries no absolute path, no source line, no stack. */
     action: string;
 }
-/** Choose the refusal's `action` **from** the failure rather than asserting one over it (#217). */
+/**
+ * Choose the refusal's `action` **from** the failure rather than asserting one over it (#217).
+ *
+ * An unresolved import names its **importer** alongside its specifier when the runtime gave one (#480,
+ * #489). A specifier alone is honest and can still send the reader to the wrong package, because the
+ * import that failed is often not the config's own: `pithy add email` refused with *nothing resolves
+ * `@pithy-sh/core/src/capability/capability`* while core resolved from the Worker throughout, because
+ * the failing import was `@pithy-sh/email`'s. The importer is the half that pointed at `email`, and
+ * `importingPackage` is where core records that both runtimes hand it over. **It asserts nothing about
+ * which package is absent** — nothing here can know that — only where the import is written.
+ */
 export declare function classifyWorkerConfigFailure(wrapped: unknown): WorkerConfigFailure;
 /**
  * Load a Worker's `pithy.config.ts` and index the capabilities it composes.

package/dist/workerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workerConfig.d.ts","sourceRoot":"","sources":["../src/workerConfig.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAkB3E,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,oGAAoG;IACpG,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,uBAAuB;AACjC,yFAAyF;AACvF,mBAAmB;AACrB,0GAA0G;GACxG,aAAa;AACf,iFAAiF;GAC/E,eAAe;AACjB,oGAAoG;GAClG,SAAS,CAAC;AAEd,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,IAAI,EAAE,uBAAuB,CAAC;IAC9B,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;CAChB;AA4CD,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAqCjF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkDtF"}
+{"version":3,"file":"workerConfig.d.ts","sourceRoot":"","sources":["../src/workerConfig.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAmB3E,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,oGAAoG;IACpG,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,uBAAuB;AACjC,yFAAyF;AACvF,mBAAmB;AACrB,0GAA0G;GACxG,aAAa;AACf,iFAAiF;GAC/E,eAAe;AACjB,oGAAoG;GAClG,SAAS,CAAC;AAEd,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,IAAI,EAAE,uBAAuB,CAAC;IAC9B,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;CAChB;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CA8CjF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkDtF"}

package/dist/workerConfig.js

@@ -1,6 +1,8 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
 import { access } from "node:fs/promises";
 import { runnerImport } from "vite";
-import { causeMessage, failurePosition, isBuildFailureWrapper, prop, rootCause, safeReason, unresolvedSpecifier } from "@pithy-sh/core/src/error/cause";
+import { causeMessage, failurePosition, importingPackage, isBuildFailureWrapper, prop, rootCause, safeReason, unresolvedSpecifier } from "@pithy-sh/core/src/error/cause";
 import { InternalError, NotFoundError } from "@pithy-sh/core/src/error/pithyError";
 //#region src/workerConfig.ts
 /**
@@ -28,14 +30,29 @@ function isParseError(cause) {
 	if (isBuildFailureWrapper(cause)) return true;
 	return /Transform failed|\[PARSE_ERROR]|Parse (?:error|failure)|Unexpected (?:token|end of input)/.test(rawMessage(cause));
 }
-/** Choose the refusal's `action` **from** the failure rather than asserting one over it (#217). */
+/**
+* Choose the refusal's `action` **from** the failure rather than asserting one over it (#217).
+*
+* An unresolved import names its **importer** alongside its specifier when the runtime gave one (#480,
+* #489). A specifier alone is honest and can still send the reader to the wrong package, because the
+* import that failed is often not the config's own: `pithy add email` refused with *nothing resolves
+* `@pithy-sh/core/src/capability/capability`* while core resolved from the Worker throughout, because
+* the failing import was `@pithy-sh/email`'s. The importer is the half that pointed at `email`, and
+* `importingPackage` is where core records that both runtimes hand it over. **It asserts nothing about
+* which package is absent** — nothing here can know that — only where the import is written.
+*/
 function classifyWorkerConfigFailure(wrapped) {
 	const cause = rootCause(wrapped);
 	if (isUnresolvedImport(cause)) {
 		const specifier = unresolvedSpecifier(cause);
+		const importer = importingPackage(cause);
+		if (specifier === void 0) return {
+			kind: "unresolved-import",
+			action: "An import in the config does not resolve. Install the project's dependencies (bun install), then check its imports."
+		};
 		return {
 			kind: "unresolved-import",
-			action: specifier ? `Nothing resolves "${specifier}". Install the project's dependencies (bun install), or correct that import.` : "An import in the config does not resolve. Install the project's dependencies (bun install), then check its imports."
+			action: importer ? `Nothing resolves "${specifier}". ${importer} is what imports it, not the config. Install the project's dependencies (bun install).` : `Nothing resolves "${specifier}". Install the project's dependencies (bun install), or correct that import.`
 		};
 	}
 	if (isParseError(cause)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pithy-sh/vite",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
   },
   "scripts": {
     "generate": "bun scripts/generateClientEnv.ts",
-    "build": "bun run generate && tsdown && tsc -p tsconfig.build.json",
+    "build": "bun run generate && tsdown && tsc -p tsconfig.build.json && bun ../../tooling/build/src/stampDeclarations.ts",
     "typecheck": "tsc -p tsconfig.json",
     "test": "vitest run",
     "test:node": "vitest run --project=node",
@@ -36,7 +36,7 @@
     "vite": "^6.1.0 || ^7.0.0 || ^8.0.0"
   },
   "dependencies": {
-    "@pithy-sh/core": "^0.1.4"
+    "@pithy-sh/core": "^0.2.0"
   },
   "devDependencies": {
     "@pithy-sh/auth": "workspace:*",

package/src/workerConfig.ts

@@ -6,6 +6,7 @@ import type { Capability } from "@pithy-sh/core/src/capability/capability";
 import {
   causeMessage,
   failurePosition,
+  importingPackage,
   isBuildFailureWrapper,
   prop,
   rootCause,
@@ -109,17 +110,36 @@ function isParseError(cause: unknown): boolean {
   );
 }
 
-/** Choose the refusal's `action` **from** the failure rather than asserting one over it (#217). */
+/**
+ * Choose the refusal's `action` **from** the failure rather than asserting one over it (#217).
+ *
+ * An unresolved import names its **importer** alongside its specifier when the runtime gave one (#480,
+ * #489). A specifier alone is honest and can still send the reader to the wrong package, because the
+ * import that failed is often not the config's own: `pithy add email` refused with *nothing resolves
+ * `@pithy-sh/core/src/capability/capability`* while core resolved from the Worker throughout, because
+ * the failing import was `@pithy-sh/email`'s. The importer is the half that pointed at `email`, and
+ * `importingPackage` is where core records that both runtimes hand it over. **It asserts nothing about
+ * which package is absent** — nothing here can know that — only where the import is written.
+ */
 export function classifyWorkerConfigFailure(wrapped: unknown): WorkerConfigFailure {
   // Bun hands `import()` failures over inside an `AggregateError`. Classify what is inside it.
   const cause = rootCause(wrapped);
   if (isUnresolvedImport(cause)) {
     const specifier = unresolvedSpecifier(cause);
+    // A package name or nothing — core never hands a path back, so there is none to keep out of here.
+    const importer = importingPackage(cause);
+    if (specifier === undefined) {
+      return {
+        kind: "unresolved-import",
+        action:
+          "An import in the config does not resolve. Install the project's dependencies (bun install), then check its imports.",
+      };
+    }
     return {
       kind: "unresolved-import",
-      action: specifier
-        ? `Nothing resolves "${specifier}". Install the project's dependencies (bun install), or correct that import.`
-        : "An import in the config does not resolve. Install the project's dependencies (bun install), then check its imports.",
+      action: importer
+        ? `Nothing resolves "${specifier}". ${importer} is what imports it, not the config. Install the project's dependencies (bun install).`
+        : `Nothing resolves "${specifier}". Install the project's dependencies (bun install), or correct that import.`,
     };
   }