feat(showcase): verifier checks @/snippets and @/components import paths

Author: tylerslaton

showcase/scripts/verify-shell-docs.test.ts

@@ -3,6 +3,7 @@ import { runBuildCheck } from "./verify-shell-docs.js";
 import { checkInlineDemoRefs } from "./verify-shell-docs.js";
 import { checkSnippetRegions } from "./verify-shell-docs.js";
 import { checkInternalLinks } from "./verify-shell-docs.js";
+import { checkImportPaths } from "./verify-shell-docs.js";
 
 describe("runBuildCheck", () => {
   it("returns a result with name, status, and messages", () => {
@@ -137,3 +138,30 @@ describe("checkInternalLinks", () => {
     expect(result.status).toBe("pass");
   });
 });
+
+describe("checkImportPaths", () => {
+  it("fails when an @/snippets/... path does not exist", () => {
+    const pages = [
+      {
+        path: "a.mdx",
+        body: 'import X from "@/snippets/does-not-exist.mdx";',
+      },
+    ];
+    const existsOnDisk = (_p: string) => false;
+    const result = checkImportPaths({ pages, existsOnDisk });
+    expect(result.status).toBe("fail");
+    expect(result.messages.join(" ")).toContain("@/snippets/does-not-exist.mdx");
+  });
+
+  it("passes when all paths resolve", () => {
+    const pages = [
+      {
+        path: "a.mdx",
+        body: 'import X from "@/snippets/exists.mdx";',
+      },
+    ];
+    const existsOnDisk = (_p: string) => true;
+    const result = checkImportPaths({ pages, existsOnDisk });
+    expect(result.status).toBe("pass");
+  });
+});

showcase/scripts/verify-shell-docs.ts

@@ -167,3 +167,27 @@ export function checkInternalLinks(input: {
     messages: failures,
   };
 }
+
+const ALIAS_IMPORT_RE =
+  /^\s*import\s+[^"';]+from\s+["'](@\/[^"']+)["']\s*;?\s*$/gm;
+
+export function checkImportPaths(input: {
+  pages: PageInput[];
+  existsOnDisk: (importPath: string) => boolean;
+}): CheckResult {
+  const failures: string[] = [];
+  for (const page of input.pages) {
+    ALIAS_IMPORT_RE.lastIndex = 0;
+    let m: RegExpExecArray | null;
+    while ((m = ALIAS_IMPORT_RE.exec(page.body)) !== null) {
+      if (!input.existsOnDisk(m[1])) {
+        failures.push(`${page.path}: unresolved import "${m[1]}"`);
+      }
+    }
+  }
+  return {
+    name: "import-paths",
+    status: failures.length === 0 ? "pass" : "fail",
+    messages: failures,
+  };
+}