@mohasinac/appkit 4.14.0 → 4.16.0

package/scripts/node-esm-loader.mjs

@@ -0,0 +1,65 @@
+/**
+ * ESM resolver hook — makes `import("@mohasinac/appkit")` work from ANY
+ * standalone Node script.
+ *
+ * appkit is `"type": "module"` built by plain `tsc`, and tsc does not rewrite
+ * import specifiers — so all ~2,190 emitted `.js` files carry bare relative
+ * imports with no `.js` extension. Bundlers (Next/Turbopack, tsup, vite)
+ * resolve those happily; Node's ESM resolver refuses them outright. This hook
+ * retries with `.js` and then `/index.js` on ERR_MODULE_NOT_FOUND, and stubs
+ * the two other things that make a raw Node import of appkit explode.
+ *
+ * Registered by:
+ *   - `appkit/scripts/seed-cli.mjs`      (the appkit-seed CLI)
+ *   - `scripts/qa/roundtrip-diff.mjs`    (the schema field-loss gate)
+ *
+ * **Renamed from `seed-cli-loader.mjs`** — it was never seed-specific, and
+ * that name was why a later session diagnosed the same ESM failure from
+ * scratch and concluded the fix was to rewrite every specifier at build time.
+ * It is not: it is this file, registered in three lines. `seed-cli-loader.mjs`
+ * remains as a re-export so any pinned path keeps working.
+ */
+
+// Stub out non-JS asset imports (CSS, etc.) — appkit's dist contains
+// `import "./foo.css"` side-effect statements that Node ESM can't load.
+const STUB_EXTENSIONS = [".css", ".scss", ".sass", ".png", ".jpg", ".jpeg", ".svg", ".webp", ".gif"];
+
+// server-only / client-only are Next.js-specific sentinel packages — their
+// entire module body unconditionally throws, because their whole purpose is
+// a Next.js-compiler-time + Next.js-runtime guard against importing a
+// server-only (or client-only) module from the wrong side of the boundary.
+// A raw Node script (this CLI) is neither a Next.js Server Component nor a
+// Client Component, so the guard is meaningless here — the main
+// @mohasinac/appkit barrel transitively reaches a module (e.g.
+// features/contact/email.tsx) that imports "server-only" at the top level,
+// which crashes the whole CLI on load. Stub both to a no-op module. Found
+// 2026-08-17 debugging the CLI seed tool being unable to import appkit at all.
+const SENTINEL_SPECIFIERS = new Set(["server-only", "client-only"]);
+
+export async function load(url, context, nextLoad) {
+  if (STUB_EXTENSIONS.some((ext) => url.endsWith(ext))) {
+    return { format: "module", shortCircuit: true, source: "export default undefined;" };
+  }
+  return nextLoad(url, context);
+}
+
+export async function resolve(specifier, context, nextResolve) {
+  if (SENTINEL_SPECIFIERS.has(specifier)) {
+    return { url: `data:text/javascript,export default undefined;`, shortCircuit: true };
+  }
+  try {
+    return await nextResolve(specifier, context);
+  } catch (err) {
+    if (err?.code !== "ERR_MODULE_NOT_FOUND" && err?.code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw err;
+    if (specifier.endsWith(".js") || specifier.endsWith(".mjs") || specifier.endsWith(".cjs")) throw err;
+    // Try with .js suffix (most common case)
+    try {
+      return await nextResolve(`${specifier}.js`, context);
+    } catch {}
+    // Try as a directory index
+    try {
+      return await nextResolve(`${specifier}/index.js`, context);
+    } catch {}
+    throw err;
+  }
+}

package/scripts/seed-cli-loader.mjs

@@ -1,52 +1,9 @@
 /**
- * ESM resolver hook for seed-cli.mjs.
+ * Back-compat shim. The real implementation is `node-esm-loader.mjs`.
  *
- * appkit's dist emits bare relative imports without `.js` extensions
- * (TS build is bundler-target, not Node). Node ESM is strict and refuses
- * them. This hook tries appending `.js` and `/index.js` when a resolution
- * fails with ERR_MODULE_NOT_FOUND.
+ * The hook was never seed-specific — it makes a bare `import("@mohasinac/appkit")`
+ * resolve from any standalone Node script — so it was renamed. This file stays
+ * so a pinned path (a published tarball, a script outside this repo) keeps
+ * working. Register `node-esm-loader.mjs` directly in anything new.
  */
-
-// Stub out non-JS asset imports (CSS, etc.) — appkit's dist contains
-// `import "./foo.css"` side-effect statements that Node ESM can't load.
-const STUB_EXTENSIONS = [".css", ".scss", ".sass", ".png", ".jpg", ".jpeg", ".svg", ".webp", ".gif"];
-
-// server-only / client-only are Next.js-specific sentinel packages — their
-// entire module body unconditionally throws, because their whole purpose is
-// a Next.js-compiler-time + Next.js-runtime guard against importing a
-// server-only (or client-only) module from the wrong side of the boundary.
-// A raw Node script (this CLI) is neither a Next.js Server Component nor a
-// Client Component, so the guard is meaningless here — the main
-// @mohasinac/appkit barrel transitively reaches a module (e.g.
-// features/contact/email.tsx) that imports "server-only" at the top level,
-// which crashes the whole CLI on load. Stub both to a no-op module. Found
-// 2026-08-17 debugging the CLI seed tool being unable to import appkit at all.
-const SENTINEL_SPECIFIERS = new Set(["server-only", "client-only"]);
-
-export async function load(url, context, nextLoad) {
-  if (STUB_EXTENSIONS.some((ext) => url.endsWith(ext))) {
-    return { format: "module", shortCircuit: true, source: "export default undefined;" };
-  }
-  return nextLoad(url, context);
-}
-
-export async function resolve(specifier, context, nextResolve) {
-  if (SENTINEL_SPECIFIERS.has(specifier)) {
-    return { url: `data:text/javascript,export default undefined;`, shortCircuit: true };
-  }
-  try {
-    return await nextResolve(specifier, context);
-  } catch (err) {
-    if (err?.code !== "ERR_MODULE_NOT_FOUND" && err?.code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw err;
-    if (specifier.endsWith(".js") || specifier.endsWith(".mjs") || specifier.endsWith(".cjs")) throw err;
-    // Try with .js suffix (most common case)
-    try {
-      return await nextResolve(`${specifier}.js`, context);
-    } catch {}
-    // Try as a directory index
-    try {
-      return await nextResolve(`${specifier}/index.js`, context);
-    } catch {}
-    throw err;
-  }
-}
+export { load, resolve } from "./node-esm-loader.mjs";

package/scripts/seed-cli.mjs

@@ -34,7 +34,7 @@ import readline from "node:readline";
 // Register an ESM resolver hook that retries with `.js` / `/index.js` when
 // appkit's bundler-target dist emits extension-less relative imports.
 const __dirname = dirname(fileURLToPath(import.meta.url));
-register("./seed-cli-loader.mjs", pathToFileURL(__dirname + "/"));
+register("./node-esm-loader.mjs", pathToFileURL(__dirname + "/"));
 
 // ---------------------------------------------------------------------------
 // CLI parsing — entry point detects bin name so the same script powers