@ethisyscore/vite-plugin 1.67.1 → 1.68.0

package/dist/index.d.cts

@@ -773,8 +773,23 @@ interface PlatformReactPageSource {
 }
 /** Input to {@link computePlatformReactPages} (already-read filesystem inputs). */
 interface ComputePlatformReactPagesInput {
-    /** `useView` module key (matched in each page's source). */
+    /**
+     * The plugin's own `useView` module key. This does NOT control which calls the scan
+     * matches: every `useView(<anyKey>, <Name>)` is matched and then classified against
+     * {@link moduleKeys}. Its only role here is being the default single entry of that set.
+     */
     module: string;
+    /**
+     * Every module key the plugin's page definer actually registers a page's flat `views`
+     * map under. Defaults to `[module]`, which is what `createPluginPageDefiner` produces.
+     * Must not be empty: an empty set would classify every call as unregistered.
+     * Supply the full set for a hand-rolled multi-key definer (registering the same map
+     * under several keys to serve cross-module `useView` calls).
+     *
+     * A `useView` call naming a key OUTSIDE this set can never resolve at runtime, so it is
+     * reported in {@link ComputePlatformReactPagesResult.unregisteredViews}.
+     */
+    moduleKeys?: string[];
     /** Extension slug for the `/extensions/<slug>/` route prefix. */
     slug: string;
     routeMeta: RouteMetaEntry[];
@@ -790,6 +805,13 @@ interface ComputePlatformReactPagesResult {
     entries: PlatformReactPageEntry[];
     /** `<file>: view "<name>" has no adapter file` diagnostics. */
     missingViews: string[];
+    /**
+     * `useView` calls naming a module key the definer does not register, which therefore
+     * render the SDK's `MissingViewFallback` ("View not available") at runtime behind a
+     * green build. Previously invisible: the scan was built from the plugin's own module
+     * key, so such a call matched nothing and produced no binding AND no diagnostic.
+     */
+    unregisteredViews: string[];
 }
 /**
  * Pure core: derive the `platformReactPages[]` entries from already-read inputs (no
@@ -852,6 +874,25 @@ interface GeneratePlatformReactManifestConfig {
     pageOverrides?: Record<string, PlatformReactPageOverride>;
     /** Path overrides (relative to `root` unless absolute). See {@link PlatformReactManifestPaths}. */
     paths?: PlatformReactManifestPaths;
+    /**
+     * Every module key the plugin's definer registers page `views` under. Defaults to
+     * `[module]`. See {@link ComputePlatformReactPagesInput.moduleKeys}.
+     */
+    moduleKeys?: string[];
+    /**
+     * Throw when any `useView` call cannot be satisfied (default `true`).
+     *
+     * `useView` is a name-to-component lookup against the static manifest slice the
+     * generated entry registers, not an import, so an unsatisfiable call is NOT a build
+     * error: the surface renders the SDK's `MissingViewFallback` ("View not available") at
+     * runtime behind a green build. Failing the generator is what turns that into a
+     * build-time error.
+     *
+     * Both manifests are still written before the throw, so the emitted files stay in sync
+     * with the page tree; the exception, not a stale file, is the gate. Set `false` only to
+     * unblock a migration mid-flight, and read the returned diagnostics instead.
+     */
+    strict?: boolean;
 }
 /** What {@link generatePlatformReactManifest} produced. */
 interface GeneratePlatformReactManifestResult {
@@ -860,6 +901,8 @@ interface GeneratePlatformReactManifestResult {
     pagesWithoutView: string[];
     /** `<file>: view "<name>" has no adapter file` diagnostics. */
     missingViews: string[];
+    /** `useView` calls naming an unregistered module key. See {@link ComputePlatformReactPagesResult.unregisteredViews}. */
+    unregisteredViews: string[];
     featureManifestPath: string;
     overlayPath: string;
 }

package/dist/index.d.ts

@@ -773,8 +773,23 @@ interface PlatformReactPageSource {
 }
 /** Input to {@link computePlatformReactPages} (already-read filesystem inputs). */
 interface ComputePlatformReactPagesInput {
-    /** `useView` module key (matched in each page's source). */
+    /**
+     * The plugin's own `useView` module key. This does NOT control which calls the scan
+     * matches: every `useView(<anyKey>, <Name>)` is matched and then classified against
+     * {@link moduleKeys}. Its only role here is being the default single entry of that set.
+     */
     module: string;
+    /**
+     * Every module key the plugin's page definer actually registers a page's flat `views`
+     * map under. Defaults to `[module]`, which is what `createPluginPageDefiner` produces.
+     * Must not be empty: an empty set would classify every call as unregistered.
+     * Supply the full set for a hand-rolled multi-key definer (registering the same map
+     * under several keys to serve cross-module `useView` calls).
+     *
+     * A `useView` call naming a key OUTSIDE this set can never resolve at runtime, so it is
+     * reported in {@link ComputePlatformReactPagesResult.unregisteredViews}.
+     */
+    moduleKeys?: string[];
     /** Extension slug for the `/extensions/<slug>/` route prefix. */
     slug: string;
     routeMeta: RouteMetaEntry[];
@@ -790,6 +805,13 @@ interface ComputePlatformReactPagesResult {
     entries: PlatformReactPageEntry[];
     /** `<file>: view "<name>" has no adapter file` diagnostics. */
     missingViews: string[];
+    /**
+     * `useView` calls naming a module key the definer does not register, which therefore
+     * render the SDK's `MissingViewFallback` ("View not available") at runtime behind a
+     * green build. Previously invisible: the scan was built from the plugin's own module
+     * key, so such a call matched nothing and produced no binding AND no diagnostic.
+     */
+    unregisteredViews: string[];
 }
 /**
  * Pure core: derive the `platformReactPages[]` entries from already-read inputs (no
@@ -852,6 +874,25 @@ interface GeneratePlatformReactManifestConfig {
     pageOverrides?: Record<string, PlatformReactPageOverride>;
     /** Path overrides (relative to `root` unless absolute). See {@link PlatformReactManifestPaths}. */
     paths?: PlatformReactManifestPaths;
+    /**
+     * Every module key the plugin's definer registers page `views` under. Defaults to
+     * `[module]`. See {@link ComputePlatformReactPagesInput.moduleKeys}.
+     */
+    moduleKeys?: string[];
+    /**
+     * Throw when any `useView` call cannot be satisfied (default `true`).
+     *
+     * `useView` is a name-to-component lookup against the static manifest slice the
+     * generated entry registers, not an import, so an unsatisfiable call is NOT a build
+     * error: the surface renders the SDK's `MissingViewFallback` ("View not available") at
+     * runtime behind a green build. Failing the generator is what turns that into a
+     * build-time error.
+     *
+     * Both manifests are still written before the throw, so the emitted files stay in sync
+     * with the page tree; the exception, not a stale file, is the gate. Set `false` only to
+     * unblock a migration mid-flight, and read the returned diagnostics instead.
+     */
+    strict?: boolean;
 }
 /** What {@link generatePlatformReactManifest} produced. */
 interface GeneratePlatformReactManifestResult {
@@ -860,6 +901,8 @@ interface GeneratePlatformReactManifestResult {
     pagesWithoutView: string[];
     /** `<file>: view "<name>" has no adapter file` diagnostics. */
     missingViews: string[];
+    /** `useView` calls naming an unregistered module key. See {@link ComputePlatformReactPagesResult.unregisteredViews}. */
+    unregisteredViews: string[];
     featureManifestPath: string;
     overlayPath: string;
 }

package/dist/index.js

@@ -1555,12 +1555,16 @@ function computePlatformReactPages(input) {
   const pageRouteById = Object.fromEntries(
     input.routeMeta.filter((e) => e.pageId && (e.pattern.startsWith(routePrefix) || e.pattern === routeRoot)).map((e) => [e.pageId, e.pattern === routeRoot ? "" : e.pattern.slice(routePrefix.length)])
   );
-  const useViewRe = new RegExp(
-    `useView\\(\\s*["']${escapeRegExp(input.module)}["']\\s*,\\s*["']([A-Za-z0-9_]+)["']\\s*\\)`,
-    "g"
-  );
+  const useViewRe = /useView\(\s*["']([\w-]+)["']\s*,\s*["']([A-Za-z0-9_]+)["']\s*,?\s*\)/g;
+  if (input.moduleKeys !== void 0 && input.moduleKeys.length === 0) {
+    throw new Error(
+      "generate-manifest: moduleKeys was supplied but empty. Omit it to default to [module], or list every module key the page definer registers views under."
+    );
+  }
+  const registeredKeys = new Set(input.moduleKeys ?? [input.module]);
   const entries = [];
   const missingViews = [];
+  const unregisteredViews = [];
   for (const { file, content, moduleSpecifier } of input.pages) {
     const name = basename(file, ".tsx");
     const override = input.pageOverrides?.[file] ?? {};
@@ -1568,7 +1572,13 @@ function computePlatformReactPages(input) {
     useViewRe.lastIndex = 0;
     let m;
     while ((m = useViewRe.exec(content)) !== null) {
-      const v = m[1];
+      const [, moduleKey, v] = m;
+      if (!registeredKeys.has(moduleKey)) {
+        unregisteredViews.push(
+          `${file}: useView("${moduleKey}", "${v}") names a module key the definer does not register (registered: ${[...registeredKeys].map((k) => `"${k}"`).join(", ")}), so the lookup renders "View not available" at runtime`
+        );
+        continue;
+      }
       if (input.viewFiles[v] !== void 0) {
         views[v] = input.viewFiles[v];
       } else {
@@ -1586,7 +1596,7 @@ function computePlatformReactPages(input) {
       views
     });
   }
-  return { entries, missingViews };
+  return { entries, missingViews, unregisteredViews };
 }
 function walk2(dir) {
   const out = [];
@@ -1643,8 +1653,9 @@ function generatePlatformReactManifest(config) {
       });
     }
   }
-  const { entries, missingViews } = computePlatformReactPages({
+  const { entries, missingViews, unregisteredViews } = computePlatformReactPages({
     module,
+    moduleKeys: config.moduleKeys,
     slug,
     routeMeta,
     pages,
@@ -1689,13 +1700,21 @@ function generatePlatformReactManifest(config) {
   const overlayPath = resolve(root, overlayRel);
   writeFileSync(overlayPath, JSON.stringify(overlay, null, 2) + "\n");
   const pagesWithoutView = entries.filter((e) => Object.keys(e.views).length === 0).map((e) => e.id);
-  return {
+  const result = {
     pageCount: entries.length,
     pagesWithoutView,
     missingViews,
+    unregisteredViews,
     featureManifestPath,
     overlayPath
   };
+  if ((config.strict ?? true) && (missingViews.length > 0 || unregisteredViews.length > 0)) {
+    throw new Error(
+      `generate-manifest: ${missingViews.length + unregisteredViews.length} unresolvable useView call(s). Each renders "View not available" at runtime behind a green build:
+` + [...unregisteredViews, ...missingViews].map((d) => `  - ${d}`).join("\n")
+    );
+  }
+  return result;
 }
 var DEFAULT_MANIFEST = "feature.manifest.json";
 var DEFAULT_OUTPUT_DIR = "dist/iframe-sandbox";