vite-plugin-glob-guard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# vite-plugin-glob-guard
+
+Fail the build when a required `import.meta.glob(...)` matches zero files.
+
+## What it is
+
+When a glob pattern stops matching (rename/move, wrong extension, negation patterns, etc.),
+Vite typically does not fail the build; you can end up with an empty object `{}`.
+
+This plugin makes that failure mode opt-in and explicit: mark a glob call site as
+required and fail the build if it matches zero files.
+
+## Install
+
+```bash
+npm i -D vite-plugin-glob-guard
+```
+
+## Usage
+
+Vite config:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import globGuard from 'vite-plugin-glob-guard'
+
+export default defineConfig({
+  plugins: [globGuard()],
+})
+```
+
+Mark required call sites:
+
+```ts
+// glob-guard:required
+const posts = import.meta.glob('./posts/*.md', { eager: true })
+```
+
+## Options
+
+```ts
+export interface GlobGuardOptions {
+  mode?: 'annotated' | 'all'
+  failOnBuild?: boolean
+  report?: false | true | { file: string }
+  ignoreImporters?: (string | RegExp)[]
+}
+```
+
+Defaults:
+
+- `mode: 'annotated'`
+- `failOnBuild: true`
+- `report: false`
+
+## Example error
+
+```
+[glob-guard] Required glob matched 0 files
+  importer: src/content.ts:12:5
+  glob: ./posts/*.md
+  resolved:
+    - /abs/path/to/project/src/posts/*.md
+  hints:
+    - Did you rename/move the directory?
+    - Did you change file extensions?
+    - Are you excluding everything via a negated pattern ("!...")?
+```
+
+## Notes
+
+- Vite 7+ only.

package/dist/index.cjs

@@ -0,0 +1,460 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => globGuard
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/parse.ts
+var import_parser = require("@babel/parser");
+var import_traverse = __toESM(require("@babel/traverse"), 1);
+var REQUIRED_TOKEN = "glob-guard:required";
+function hasRequiredAnnotation(comments) {
+  if (!comments || comments.length === 0) return false;
+  return comments.some((c) => c.value.includes(REQUIRED_TOKEN));
+}
+function isImportMetaGlobCallee(node) {
+  if (node.type !== "MemberExpression") return false;
+  if (node.computed) return false;
+  const object = node.object;
+  const property = node.property;
+  if (object.type !== "MetaProperty") return false;
+  if (object.meta.type !== "Identifier" || object.meta.name !== "import") return false;
+  if (object.property.type !== "Identifier" || object.property.name !== "meta")
+    return false;
+  return property.type === "Identifier" && property.name === "glob";
+}
+function readStringLiteral(node) {
+  if (node.type === "StringLiteral") return node.value;
+  if (node.type === "TemplateLiteral") {
+    if (node.expressions.length !== 0) return null;
+    return node.quasis[0]?.value?.raw ?? "";
+  }
+  return null;
+}
+function readGlobsArg(node) {
+  const single = readStringLiteral(node);
+  if (single != null) return [single];
+  if (node.type !== "ArrayExpression") return null;
+  const globs = [];
+  for (const el of node.elements) {
+    if (!el) continue;
+    if (el.type === "SpreadElement") return null;
+    const s = readStringLiteral(el);
+    if (s == null) return null;
+    globs.push(s);
+  }
+  return globs;
+}
+function readOptions(node) {
+  if (!node) return {};
+  if (node.type !== "ObjectExpression") return {};
+  const out = {};
+  for (const prop of node.properties) {
+    if (prop.type !== "ObjectProperty") continue;
+    if (prop.computed) continue;
+    if (prop.key.type !== "Identifier" && prop.key.type !== "StringLiteral") continue;
+    const key = prop.key.type === "Identifier" ? prop.key.name : prop.key.value;
+    if (key === "exhaustive" && prop.value.type === "BooleanLiteral") {
+      out.exhaustive = prop.value.value;
+    }
+    if (key === "base") {
+      const base = readStringLiteral(prop.value);
+      if (base != null) out.base = base;
+    }
+  }
+  return out;
+}
+function parseRequiredGlobCalls(code, importer, options) {
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const ast = (0, import_parser.parse)(code, {
+    sourceType: "module",
+    sourceFilename: importer,
+    plugins: ["typescript", "jsx"],
+    errorRecovery: true,
+    ranges: true,
+    attachComment: true
+  });
+  const results = [];
+  (0, import_traverse.default)(ast, {
+    CallExpression(path) {
+      if (!isImportMetaGlobCallee(path.node.callee)) return;
+      const args = path.node.arguments;
+      if (args.length < 1) return;
+      const arg0 = args[0];
+      const arg1 = args[1];
+      const globNode = arg0;
+      const optsNode = arg1 ?? void 0;
+      const globs = readGlobsArg(globNode);
+      if (!globs || globs.length === 0) return;
+      const required = options.mode === "all" || (() => {
+        const stmt = path.getStatementParent()?.node;
+        if (!stmt) return false;
+        return hasRequiredAnnotation(stmt.leadingComments) || hasRequiredAnnotation(stmt.trailingComments) || hasRequiredAnnotation(path.node.leadingComments) || hasRequiredAnnotation(path.node.trailingComments);
+      })();
+      if (!required) return;
+      const opts = readOptions(optsNode);
+      results.push({
+        importer,
+        globs,
+        options: opts,
+        loc: path.node.loc ? { line: path.node.loc.start.line, column: path.node.loc.start.column } : null
+      });
+    }
+  });
+  return results;
+}
+function getLineAndColumn(source, index) {
+  const prefix = source.slice(0, index);
+  const lastNewline = prefix.lastIndexOf("\n");
+  const line = prefix.split("\n").length;
+  const column = lastNewline === -1 ? prefix.length : prefix.length - lastNewline - 1;
+  return { line, column };
+}
+function offsetLoc(loc, startLine, startColumn) {
+  if (!loc) return null;
+  const line = startLine + loc.line - 1;
+  const column = loc.line === 1 ? startColumn + loc.column : loc.column;
+  return { line, column };
+}
+function parseRequiredGlobCallsInScriptTags(code, importer, options) {
+  if (!code.includes("<script")) return [];
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const results = [];
+  let cursor = 0;
+  while (cursor < code.length) {
+    const open = code.indexOf("<script", cursor);
+    if (open === -1) break;
+    const openEnd = code.indexOf(">", open);
+    if (openEnd === -1) break;
+    const close = code.indexOf("</script>", openEnd + 1);
+    if (close === -1) break;
+    const contentStart = openEnd + 1;
+    const contentEnd = close;
+    const content = code.slice(contentStart, contentEnd);
+    const start = getLineAndColumn(code, contentStart);
+    const callsites = parseRequiredGlobCalls(content, importer, options);
+    for (const cs of callsites) {
+      results.push({
+        ...cs,
+        loc: offsetLoc(cs.loc, start.line, start.column)
+      });
+    }
+    cursor = close + "</script>".length;
+  }
+  return results;
+}
+function parseRequiredGlobCallsInAstroFrontmatter(code, importer, options) {
+  if (!code.startsWith("---")) return [];
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const openNewline = code.indexOf("\n");
+  if (openNewline === -1) return [];
+  const contentStart = openNewline + 1;
+  const fmMatch = code.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/);
+  if (!fmMatch) return [];
+  const frontmatter = fmMatch[1] ?? "";
+  const start = getLineAndColumn(code, contentStart);
+  const callsites = parseRequiredGlobCalls(frontmatter, importer, options);
+  return callsites.map((cs) => ({
+    ...cs,
+    loc: offsetLoc(cs.loc, start.line, start.column)
+  }));
+}
+
+// src/utils.ts
+function slash(p) {
+  return p.replace(/\\/g, "/");
+}
+function stripQuery(id) {
+  const i = id.indexOf("?");
+  return i === -1 ? id : id.slice(0, i);
+}
+function matchesAny(value, patterns) {
+  if (!patterns || patterns.length === 0) return false;
+  return patterns.some((p) => typeof p === "string" ? p === value : p.test(value));
+}
+
+// src/resolve.ts
+var import_node_path = require("path");
+var import_picomatch = __toESM(require("picomatch"), 1);
+var import_tinyglobby = require("tinyglobby");
+function globSafePath(p) {
+  return (0, import_tinyglobby.escapePath)(slash(p));
+}
+function lastNthChar(str, n) {
+  return str.charAt(str.length - 1 - n);
+}
+function globSafeResolvedPath(resolved, glob) {
+  let numEqual = 0;
+  const maxEqual = Math.min(resolved.length, glob.length);
+  while (numEqual < maxEqual && lastNthChar(resolved, numEqual) === lastNthChar(glob, numEqual)) {
+    numEqual += 1;
+  }
+  const staticPartEnd = resolved.length - numEqual;
+  const staticPart = resolved.slice(0, staticPartEnd);
+  const dynamicPart = resolved.slice(staticPartEnd);
+  return globSafePath(staticPart) + dynamicPart;
+}
+async function toAbsoluteGlob(glob, ctx) {
+  let pre = "";
+  if (glob[0] === "!") {
+    pre = "!";
+    glob = glob.slice(1);
+  }
+  const root = globSafePath(ctx.root);
+  let dir;
+  if (ctx.base) {
+    if (ctx.base[0] === "/") {
+      dir = import_node_path.posix.join(root, ctx.base);
+    } else {
+      dir = import_node_path.posix.resolve(globSafePath(import_node_path.posix.dirname(ctx.importer)), ctx.base);
+    }
+  } else {
+    dir = globSafePath(import_node_path.posix.dirname(ctx.importer));
+  }
+  if (glob[0] === "/") return pre + import_node_path.posix.join(root, glob.slice(1));
+  if (glob.startsWith("./")) return pre + import_node_path.posix.join(dir, glob.slice(2));
+  if (glob.startsWith("../")) return pre + import_node_path.posix.join(dir, glob);
+  if (glob.startsWith("**")) return pre + glob;
+  const resolved = slash(await ctx.resolveId(glob, ctx.importer) || glob);
+  if ((0, import_node_path.isAbsolute)(resolved)) {
+    return pre + globSafeResolvedPath(resolved, glob);
+  }
+  throw new Error(
+    `Invalid glob: "${glob}" (resolved: "${resolved}"). It must start with '/' or './'`
+  );
+}
+function getCommonBase(globsResolved) {
+  const bases = globsResolved.filter((g) => g[0] !== "!").map((glob) => {
+    let { base } = import_picomatch.default.scan(glob);
+    if (import_node_path.posix.basename(base).includes(".")) base = import_node_path.posix.dirname(base);
+    return base;
+  });
+  if (!bases.length) return null;
+  let commonAncestor = "";
+  const parts = bases[0].split("/");
+  for (let i = 0; i < parts.length; i++) {
+    const candidate = parts.slice(0, i + 1).join("/");
+    if (bases.every((b) => b.startsWith(candidate))) commonAncestor = candidate;
+    else break;
+  }
+  if (!commonAncestor) commonAncestor = "/";
+  return commonAncestor;
+}
+
+// src/match.ts
+var import_tinyglobby2 = require("tinyglobby");
+async function matchGlobs(input) {
+  const globsResolved = input.globsResolved.map(slash);
+  const root = slash(input.root);
+  const importerFile = slash(input.importerFile);
+  const cwd = getCommonBase(globsResolved) ?? root;
+  const dot = !!input.exhaustive;
+  const ignore = dot ? [] : ["**/node_modules/**"];
+  const matches = (await (0, import_tinyglobby2.glob)(globsResolved, {
+    cwd,
+    absolute: true,
+    dot,
+    expandDirectories: false,
+    ignore
+  })).map(slash).filter((f) => f !== importerFile).sort();
+  return {
+    cwd,
+    dot,
+    ignore,
+    matches
+  };
+}
+
+// src/diagnostics.ts
+function formatEmptyGlobFailure(f) {
+  const importerLabel = f.loc != null ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}` : slash(f.importerFile);
+  const lines = [];
+  lines.push("[glob-guard] Required glob matched 0 files");
+  lines.push(`  importer: ${importerLabel}`);
+  if (f.globs.length === 1) {
+    lines.push(`  glob: ${f.globs[0]}`);
+  } else {
+    lines.push("  globs:");
+    for (const g of f.globs) lines.push(`    - ${g}`);
+  }
+  lines.push("  resolved:");
+  for (const g of f.globsResolved) lines.push(`    - ${g}`);
+  lines.push(`  options: exhaustive=${String(f.exhaustive)}${f.base ? ` base=${f.base}` : ""}`);
+  lines.push(`  cwd: ${f.cwd}`);
+  if (f.ignore.length > 0) {
+    lines.push("  ignore:");
+    for (const i of f.ignore) lines.push(`    - ${i}`);
+  }
+  lines.push("  hints:");
+  lines.push("    - Did you rename/move the directory?");
+  lines.push("    - Did you change file extensions?");
+  lines.push('    - Are you excluding everything via a negated pattern ("!...")?');
+  const err = new Error(lines.join("\n"));
+  err.id = slash(f.importerFile);
+  if (f.loc) err.loc = { file: err.id, line: f.loc.line, column: f.loc.column };
+  return err;
+}
+function formatManyFailures(failures) {
+  if (failures.length === 1) return formatEmptyGlobFailure(failures[0]);
+  const lines = [];
+  lines.push(`[glob-guard] ${failures.length} required globs matched 0 files`);
+  for (const f of failures) {
+    const importerLabel = f.loc != null ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}` : slash(f.importerFile);
+    lines.push(`  - ${importerLabel}`);
+    if (f.globs.length === 1) {
+      lines.push(`    glob: ${f.globs[0]}`);
+    } else {
+      lines.push("    globs:");
+      for (const g of f.globs) lines.push(`      - ${g}`);
+    }
+  }
+  const err = new Error(lines.join("\n"));
+  return err;
+}
+
+// src/index.ts
+var DEFAULTS = {
+  mode: "annotated",
+  failOnBuild: true,
+  checkOnServe: false,
+  failOnServe: false,
+  report: false,
+  ignoreImporters: []
+};
+function globGuard(userOptions = {}) {
+  const options = { ...DEFAULTS, ...userOptions };
+  let root = "";
+  let isBuild = false;
+  const callsites = [];
+  async function checkAll() {
+    if (callsites.length === 0) return;
+    const failures = [];
+    for (const cs of callsites) {
+      const importerFile = stripQuery(cs.importer);
+      const globsResolved = await Promise.all(
+        cs.globs.map(
+          (g) => toAbsoluteGlob(g, {
+            root,
+            importer: slash(importerFile),
+            base: cs.options.base,
+            resolveId: async (id, importer) => {
+              const r = await this.resolve(id, importer);
+              return r?.id;
+            }
+          })
+        )
+      );
+      const match = await matchGlobs({
+        globsResolved,
+        root,
+        importerFile,
+        exhaustive: cs.options.exhaustive
+      });
+      if (match.matches.length === 0) {
+        failures.push({
+          importer: cs.importer,
+          importerFile,
+          loc: cs.loc,
+          globs: cs.globs,
+          globsResolved,
+          exhaustive: !!cs.options.exhaustive,
+          base: cs.options.base,
+          cwd: match.cwd,
+          ignore: match.ignore
+        });
+      }
+    }
+    if (failures.length === 0) return;
+    if (options.report) {
+      const reportFile = options.report === true ? "glob-guard.report.json" : options.report.file;
+      const fs = await import("fs/promises");
+      const payload = {
+        root,
+        failures: failures.map((f) => ({
+          importer: slash(f.importerFile),
+          loc: f.loc,
+          globs: f.globs,
+          globsResolved: f.globsResolved,
+          exhaustive: f.exhaustive,
+          base: f.base,
+          cwd: f.cwd,
+          ignore: f.ignore
+        }))
+      };
+      await fs.writeFile(reportFile, JSON.stringify(payload, null, 2), "utf8");
+    }
+    const err = formatManyFailures(failures);
+    if (isBuild ? options.failOnBuild : options.failOnServe) {
+      this.error(err);
+    } else {
+      this.warn(err);
+    }
+  }
+  return {
+    name: "glob-guard",
+    // We must run before Vite's internal TS/JS transforms (esbuild), otherwise
+    // comment annotations may be stripped before we can read them.
+    enforce: "pre",
+    configResolved(config) {
+      root = slash(config.root);
+      isBuild = config.command === "build";
+    },
+    transform(code, id) {
+      if (matchesAny(id, options.ignoreImporters)) return null;
+      let parsed;
+      try {
+        const file = stripQuery(id);
+        if (file.endsWith(".vue") || file.endsWith(".svelte")) {
+          parsed = parseRequiredGlobCallsInScriptTags(code, id, { mode: options.mode });
+        } else if (file.endsWith(".astro")) {
+          parsed = parseRequiredGlobCallsInAstroFrontmatter(code, id, { mode: options.mode });
+        } else {
+          parsed = parseRequiredGlobCalls(code, id, { mode: options.mode });
+        }
+      } catch {
+        return null;
+      }
+      if (parsed.length > 0) callsites.push(...parsed);
+      return null;
+    },
+    async buildEnd() {
+      await checkAll.call(this);
+    }
+  };
+}
+if (typeof module !== 'undefined' && module.exports && module.exports.default) { module.exports = module.exports.default }
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/parse.ts","../src/utils.ts","../src/resolve.ts","../src/match.ts","../src/diagnostics.ts"],"sourcesContent":["import type { Plugin } from 'vite'\nimport {\n  parseRequiredGlobCalls,\n  parseRequiredGlobCallsInAstroFrontmatter,\n  parseRequiredGlobCallsInScriptTags,\n  type ParsedGlobCallsite,\n} from './parse'\nimport { matchesAny, slash, stripQuery } from './utils'\nimport { toAbsoluteGlob } from './resolve'\nimport { matchGlobs } from './match'\nimport { formatManyFailures, type EmptyGlobFailure } from './diagnostics'\nimport type { GlobGuardOptions } from './types'\n\nconst DEFAULTS: Required<Pick<\n  GlobGuardOptions,\n  'mode' | 'failOnBuild' | 'checkOnServe' | 'failOnServe' | 'report' | 'ignoreImporters'\n>> = {\n  mode: 'annotated',\n  failOnBuild: true,\n  checkOnServe: false,\n  failOnServe: false,\n  report: false,\n  ignoreImporters: [],\n}\n\nexport default function globGuard(userOptions: GlobGuardOptions = {}): Plugin {\n  const options = { ...DEFAULTS, ...userOptions }\n\n  let root = ''\n  let isBuild = false\n\n  const callsites: ParsedGlobCallsite[] = []\n\n  async function checkAll(this: any) {\n    if (callsites.length === 0) return\n\n    const failures: EmptyGlobFailure[] = []\n\n    for (const cs of callsites) {\n      const importerFile = stripQuery(cs.importer)\n\n      const globsResolved = await Promise.all(\n        cs.globs.map((g) =>\n          toAbsoluteGlob(g, {\n            root,\n            importer: slash(importerFile),\n            base: cs.options.base,\n            resolveId: async (id, importer) => {\n              const r = await this.resolve(id, importer)\n              return r?.id\n            },\n          }),\n        ),\n      )\n\n      const match = await matchGlobs({\n        globsResolved,\n        root,\n        importerFile,\n        exhaustive: cs.options.exhaustive,\n      })\n\n      if (match.matches.length === 0) {\n        failures.push({\n          importer: cs.importer,\n          importerFile,\n          loc: cs.loc,\n          globs: cs.globs,\n          globsResolved,\n          exhaustive: !!cs.options.exhaustive,\n          base: cs.options.base,\n          cwd: match.cwd,\n          ignore: match.ignore,\n        })\n      }\n    }\n\n    if (failures.length === 0) return\n\n    // Report (optional)\n    if (options.report) {\n      const reportFile =\n        options.report === true\n          ? 'glob-guard.report.json'\n          : options.report.file\n      const fs = await import('node:fs/promises')\n      const payload = {\n        root,\n        failures: failures.map((f) => ({\n          importer: slash(f.importerFile),\n          loc: f.loc,\n          globs: f.globs,\n          globsResolved: f.globsResolved,\n          exhaustive: f.exhaustive,\n          base: f.base,\n          cwd: f.cwd,\n          ignore: f.ignore,\n        })),\n      }\n      await fs.writeFile(reportFile, JSON.stringify(payload, null, 2), 'utf8')\n    }\n\n    const err = formatManyFailures(failures)\n    if (isBuild ? options.failOnBuild : options.failOnServe) {\n      this.error(err)\n    } else {\n      this.warn(err)\n    }\n  }\n\n  return {\n    name: 'glob-guard',\n\n    // We must run before Vite's internal TS/JS transforms (esbuild), otherwise\n    // comment annotations may be stripped before we can read them.\n    enforce: 'pre',\n\n\n    configResolved(config) {\n      root = slash(config.root)\n      isBuild = config.command === 'build'\n    },\n\n    transform(code, id) {\n      if (matchesAny(id, options.ignoreImporters)) return null\n\n      let parsed: ParsedGlobCallsite[]\n      try {\n        const file = stripQuery(id)\n        if (file.endsWith('.vue') || file.endsWith('.svelte')) {\n          parsed = parseRequiredGlobCallsInScriptTags(code, id, { mode: options.mode })\n        } else if (file.endsWith('.astro')) {\n          parsed = parseRequiredGlobCallsInAstroFrontmatter(code, id, { mode: options.mode })\n        } else {\n          parsed = parseRequiredGlobCalls(code, id, { mode: options.mode })\n        }\n      } catch {\n        // Some files (e.g. Vue/Svelte SFC source) are not valid JS/TS before\n        // their framework plugin runs. We intentionally ignore parse failures\n        // and only act on call sites we can confidently extract.\n        return null\n      }\n      if (parsed.length > 0) callsites.push(...parsed)\n      return null\n    },\n\n    async buildEnd() {\n      await checkAll.call(this)\n    },\n  }\n}\n","import { parse } from '@babel/parser'\nimport traverse from '@babel/traverse'\nimport type { Comment, Node } from '@babel/types'\n\nexport interface ParsedGlobCallsite {\n  importer: string\n  globs: string[]\n  options: {\n    exhaustive?: boolean\n    base?: string\n  }\n  loc: { line: number; column: number } | null\n}\n\nexport interface ParseOptions {\n  mode: 'annotated' | 'all'\n}\n\nconst REQUIRED_TOKEN = 'glob-guard:required'\n\nfunction hasRequiredAnnotation(comments: Comment[] | null | undefined): boolean {\n  if (!comments || comments.length === 0) return false\n  return comments.some((c) => c.value.includes(REQUIRED_TOKEN))\n}\n\nfunction isImportMetaGlobCallee(node: Node): boolean {\n  if (node.type !== 'MemberExpression') return false\n  if (node.computed) return false\n\n  const object = node.object\n  const property = node.property\n\n  if (object.type !== 'MetaProperty') return false\n  if (object.meta.type !== 'Identifier' || object.meta.name !== 'import') return false\n  if (object.property.type !== 'Identifier' || object.property.name !== 'meta')\n    return false\n\n  return property.type === 'Identifier' && property.name === 'glob'\n}\n\nfunction readStringLiteral(node: Node): string | null {\n  if (node.type === 'StringLiteral') return node.value\n  if (node.type === 'TemplateLiteral') {\n    if (node.expressions.length !== 0) return null\n    return node.quasis[0]?.value?.raw ?? ''\n  }\n  return null\n}\n\nfunction readGlobsArg(node: Node): string[] | null {\n  const single = readStringLiteral(node)\n  if (single != null) return [single]\n  if (node.type !== 'ArrayExpression') return null\n\n  const globs: string[] = []\n  for (const el of node.elements) {\n    if (!el) continue\n    if (el.type === 'SpreadElement') return null\n    const s = readStringLiteral(el)\n    if (s == null) return null\n    globs.push(s)\n  }\n  return globs\n}\n\nfunction readOptions(node: Node | null | undefined): {\n  exhaustive?: boolean\n  base?: string\n} {\n  if (!node) return {}\n  if (node.type !== 'ObjectExpression') return {}\n\n  const out: { exhaustive?: boolean; base?: string } = {}\n  for (const prop of node.properties) {\n    if (prop.type !== 'ObjectProperty') continue\n    if (prop.computed) continue\n    if (prop.key.type !== 'Identifier' && prop.key.type !== 'StringLiteral') continue\n\n    const key = prop.key.type === 'Identifier' ? prop.key.name : prop.key.value\n    if (key === 'exhaustive' && prop.value.type === 'BooleanLiteral') {\n      out.exhaustive = prop.value.value\n    }\n    if (key === 'base') {\n      const base = readStringLiteral(prop.value)\n      if (base != null) out.base = base\n    }\n  }\n  return out\n}\n\nexport function parseRequiredGlobCalls(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  // Fast exits.\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const ast = parse(code, {\n    sourceType: 'module',\n    sourceFilename: importer,\n    plugins: ['typescript', 'jsx'],\n    errorRecovery: true,\n    ranges: true,\n    attachComment: true,\n  })\n\n  const results: ParsedGlobCallsite[] = []\n\n  traverse(ast, {\n    CallExpression(path) {\n      if (!isImportMetaGlobCallee(path.node.callee as unknown as Node)) return\n\n      const args = path.node.arguments\n      if (args.length < 1) return\n      const arg0 = args[0]\n      const arg1 = args[1]\n\n      // @babel/parser uses different node types inside CallExpression.arguments.\n      // We rely on runtime checks only.\n      const globNode = arg0 as unknown as Node\n      const optsNode = (arg1 as unknown as Node | undefined) ?? undefined\n\n      const globs = readGlobsArg(globNode)\n      if (!globs || globs.length === 0) return\n\n      const required =\n        options.mode === 'all' ||\n        (() => {\n          const stmt = path.getStatementParent()?.node as any\n          if (!stmt) return false\n          return (\n            hasRequiredAnnotation(stmt.leadingComments) ||\n            hasRequiredAnnotation(stmt.trailingComments) ||\n            hasRequiredAnnotation((path.node as any).leadingComments) ||\n            hasRequiredAnnotation((path.node as any).trailingComments)\n          )\n        })()\n\n      if (!required) return\n\n      const opts = readOptions(optsNode)\n\n      results.push({\n        importer,\n        globs,\n        options: opts,\n        loc: path.node.loc\n          ? { line: path.node.loc.start.line, column: path.node.loc.start.column }\n          : null,\n      })\n    },\n  })\n\n  return results\n}\n\nfunction getLineAndColumn(source: string, index: number): { line: number; column: number } {\n  const prefix = source.slice(0, index)\n  const lastNewline = prefix.lastIndexOf('\\n')\n  const line = prefix.split('\\n').length\n  const column = lastNewline === -1 ? prefix.length : prefix.length - lastNewline - 1\n  return { line, column }\n}\n\nfunction offsetLoc(\n  loc: { line: number; column: number } | null,\n  startLine: number,\n  startColumn: number,\n): { line: number; column: number } | null {\n  if (!loc) return null\n  const line = startLine + loc.line - 1\n  const column = loc.line === 1 ? startColumn + loc.column : loc.column\n  return { line, column }\n}\n\n/**\n * Extract required glob call sites from <script> blocks inside SFC-ish files\n * (Vue/Svelte). This is a lightweight extractor: it doesn't try to fully parse\n * HTML/SFC syntax; it only slices out script contents.\n */\nexport function parseRequiredGlobCallsInScriptTags(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  // If the file can't possibly contain our targets, skip quickly.\n  if (!code.includes('<script')) return []\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const results: ParsedGlobCallsite[] = []\n\n  let cursor = 0\n  while (cursor < code.length) {\n    const open = code.indexOf('<script', cursor)\n    if (open === -1) break\n\n    const openEnd = code.indexOf('>', open)\n    if (openEnd === -1) break\n\n    const close = code.indexOf('</script>', openEnd + 1)\n    if (close === -1) break\n\n    const contentStart = openEnd + 1\n    const contentEnd = close\n    const content = code.slice(contentStart, contentEnd)\n\n    const start = getLineAndColumn(code, contentStart)\n    const callsites = parseRequiredGlobCalls(content, importer, options)\n    for (const cs of callsites) {\n      results.push({\n        ...cs,\n        loc: offsetLoc(cs.loc, start.line, start.column),\n      })\n    }\n\n    cursor = close + '</script>'.length\n  }\n\n  return results\n}\n\n/**\n * Extract required glob call sites from Astro frontmatter:\n *\n * ---\n * // TS/JS\n * ---\n */\nexport function parseRequiredGlobCallsInAstroFrontmatter(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  if (!code.startsWith('---')) return []\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const openNewline = code.indexOf('\\n')\n  if (openNewline === -1) return []\n  const contentStart = openNewline + 1\n\n  const fmMatch = code.match(/^---\\s*\\r?\\n([\\s\\S]*?)\\r?\\n---\\s*(?:\\r?\\n|$)/)\n  if (!fmMatch) return []\n  const frontmatter = fmMatch[1] ?? ''\n\n  const start = getLineAndColumn(code, contentStart)\n  const callsites = parseRequiredGlobCalls(frontmatter, importer, options)\n  return callsites.map((cs) => ({\n    ...cs,\n    loc: offsetLoc(cs.loc, start.line, start.column),\n  }))\n}\n","export function slash(p: string): string {\n  return p.replace(/\\\\/g, '/')\n}\n\nexport function stripQuery(id: string): string {\n  const i = id.indexOf('?')\n  return i === -1 ? id : id.slice(0, i)\n}\n\nexport function toArray<T>(value: T | T[]): T[] {\n  return Array.isArray(value) ? value : [value]\n}\n\nexport function matchesAny(\n  value: string,\n  patterns: (string | RegExp)[] | undefined,\n): boolean {\n  if (!patterns || patterns.length === 0) return false\n  return patterns.some((p) => (typeof p === 'string' ? p === value : p.test(value)))\n}\n","// Portions of this file are based on Vite's importMetaGlob implementation:\n// https://github.com/vitejs/vite/blob/v7.3.1/packages/vite/src/node/plugins/importMetaGlob.ts\n// Vite is licensed under the MIT License.\n\nimport { isAbsolute, posix } from 'node:path'\nimport picomatch from 'picomatch'\nimport { escapePath } from 'tinyglobby'\nimport { slash } from './utils'\n\nexport interface ResolveContext {\n  root: string\n  importer: string\n  base?: string\n  resolveId: (id: string, importer?: string) => Promise<string | undefined>\n}\n\nfunction globSafePath(p: string): string {\n  // slash path to ensure \\ is converted to / as \\ could lead to a double escape scenario\n  return escapePath(slash(p))\n}\n\nfunction lastNthChar(str: string, n: number) {\n  return str.charAt(str.length - 1 - n)\n}\n\nfunction globSafeResolvedPath(resolved: string, glob: string) {\n  let numEqual = 0\n  const maxEqual = Math.min(resolved.length, glob.length)\n  while (numEqual < maxEqual && lastNthChar(resolved, numEqual) === lastNthChar(glob, numEqual)) {\n    numEqual += 1\n  }\n  const staticPartEnd = resolved.length - numEqual\n  const staticPart = resolved.slice(0, staticPartEnd)\n  const dynamicPart = resolved.slice(staticPartEnd)\n  return globSafePath(staticPart) + dynamicPart\n}\n\nexport async function toAbsoluteGlob(glob: string, ctx: ResolveContext): Promise<string> {\n  let pre = ''\n  if (glob[0] === '!') {\n    pre = '!'\n    glob = glob.slice(1)\n  }\n\n  const root = globSafePath(ctx.root)\n\n  let dir: string\n  if (ctx.base) {\n    if (ctx.base[0] === '/') {\n      dir = posix.join(root, ctx.base)\n    } else {\n      dir = posix.resolve(globSafePath(posix.dirname(ctx.importer)), ctx.base)\n    }\n  } else {\n    dir = globSafePath(posix.dirname(ctx.importer))\n  }\n\n  if (glob[0] === '/') return pre + posix.join(root, glob.slice(1))\n  if (glob.startsWith('./')) return pre + posix.join(dir, glob.slice(2))\n  if (glob.startsWith('../')) return pre + posix.join(dir, glob)\n  if (glob.startsWith('**')) return pre + glob\n\n  const resolved = slash((await ctx.resolveId(glob, ctx.importer)) || glob)\n  if (isAbsolute(resolved)) {\n    return pre + globSafeResolvedPath(resolved, glob)\n  }\n\n  throw new Error(\n    `Invalid glob: \"${glob}\" (resolved: \"${resolved}\"). It must start with '/' or './'`,\n  )\n}\n\nexport function getCommonBase(globsResolved: string[]): null | string {\n  const bases = globsResolved\n    .filter((g) => g[0] !== '!')\n    .map((glob) => {\n      let { base } = picomatch.scan(glob)\n      if (posix.basename(base).includes('.')) base = posix.dirname(base)\n      return base\n    })\n\n  if (!bases.length) return null\n\n  let commonAncestor = ''\n  const parts = bases[0].split('/')\n  for (let i = 0; i < parts.length; i++) {\n    const candidate = parts.slice(0, i + 1).join('/')\n    if (bases.every((b) => b.startsWith(candidate))) commonAncestor = candidate\n    else break\n  }\n  if (!commonAncestor) commonAncestor = '/'\n  return commonAncestor\n}\n","import { glob as tinyGlob } from 'tinyglobby'\nimport { getCommonBase } from './resolve'\nimport { slash } from './utils'\n\nexport interface MatchInput {\n  globsResolved: string[]\n  root: string\n  importerFile: string\n  exhaustive?: boolean\n}\n\nexport interface MatchResult {\n  cwd: string\n  dot: boolean\n  ignore: string[]\n  matches: string[]\n}\n\nexport async function matchGlobs(input: MatchInput): Promise<MatchResult> {\n  const globsResolved = input.globsResolved.map(slash)\n  const root = slash(input.root)\n  const importerFile = slash(input.importerFile)\n  const cwd = getCommonBase(globsResolved) ?? root\n  const dot = !!input.exhaustive\n\n  const ignore = dot ? [] : ['**/node_modules/**']\n  const matches = (\n    await tinyGlob(globsResolved, {\n      cwd,\n      absolute: true,\n      dot,\n      expandDirectories: false,\n      ignore,\n    })\n  )\n    .map(slash)\n    .filter((f) => f !== importerFile)\n    .sort()\n\n  return {\n    cwd,\n    dot,\n    ignore,\n    matches,\n  }\n}\n","import type { RollupError } from 'rollup'\nimport { slash } from './utils'\n\nexport interface EmptyGlobFailure {\n  importer: string\n  importerFile: string\n  loc: { line: number; column: number } | null\n  globs: string[]\n  globsResolved: string[]\n  exhaustive: boolean\n  base?: string\n  cwd: string\n  ignore: string[]\n}\n\nexport function formatEmptyGlobFailure(f: EmptyGlobFailure): RollupError {\n  const importerLabel =\n    f.loc != null\n      ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}`\n      : slash(f.importerFile)\n\n  const lines: string[] = []\n  lines.push('[glob-guard] Required glob matched 0 files')\n  lines.push(`  importer: ${importerLabel}`)\n  if (f.globs.length === 1) {\n    lines.push(`  glob: ${f.globs[0]}`)\n  } else {\n    lines.push('  globs:')\n    for (const g of f.globs) lines.push(`    - ${g}`)\n  }\n  lines.push('  resolved:')\n  for (const g of f.globsResolved) lines.push(`    - ${g}`)\n  lines.push(`  options: exhaustive=${String(f.exhaustive)}${f.base ? ` base=${f.base}` : ''}`)\n  lines.push(`  cwd: ${f.cwd}`)\n  if (f.ignore.length > 0) {\n    lines.push('  ignore:')\n    for (const i of f.ignore) lines.push(`    - ${i}`)\n  }\n  lines.push('  hints:')\n  lines.push('    - Did you rename/move the directory?')\n  lines.push('    - Did you change file extensions?')\n  lines.push('    - Are you excluding everything via a negated pattern (\"!...\")?')\n\n  const err = new Error(lines.join('\\n')) as RollupError\n  err.id = slash(f.importerFile)\n  if (f.loc) err.loc = { file: err.id, line: f.loc.line, column: f.loc.column }\n  return err\n}\n\nexport function formatManyFailures(failures: EmptyGlobFailure[]): RollupError {\n  if (failures.length === 1) return formatEmptyGlobFailure(failures[0])\n\n  const lines: string[] = []\n  lines.push(`[glob-guard] ${failures.length} required globs matched 0 files`)\n  for (const f of failures) {\n    const importerLabel =\n      f.loc != null\n        ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}`\n        : slash(f.importerFile)\n    lines.push(`  - ${importerLabel}`)\n    if (f.globs.length === 1) {\n      lines.push(`    glob: ${f.globs[0]}`)\n    } else {\n      lines.push('    globs:')\n      for (const g of f.globs) lines.push(`      - ${g}`)\n    }\n  }\n  const err = new Error(lines.join('\\n')) as RollupError\n  return err\n}\n"],"mappings":"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","names":["traverse","picomatch","import_tinyglobby","tinyGlob"]}

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { Plugin } from 'vite';
+
+interface GlobGuardOptions {
+    /**
+     * Which call sites should be enforced.
+     * - 'annotated': only those with a glob-guard:required annotation
+     * - 'all': every import.meta.glob call must match at least 1 file
+     */
+    mode?: 'annotated' | 'all';
+    /** Fail the build on required empty globs. Default: true */
+    failOnBuild?: boolean;
+    /** Warn (or fail) during dev server. Default: false */
+    checkOnServe?: boolean;
+    /** If true and checkOnServe enabled, fail dev server start. Default: false */
+    failOnServe?: boolean;
+    /** Optional JSON report of resolved globs and matches */
+    report?: false | true | {
+        file: string;
+    };
+    /** Ignore importer ids (e.g. virtual modules). Optional */
+    ignoreImporters?: (string | RegExp)[];
+}
+
+declare function globGuard(userOptions?: GlobGuardOptions): Plugin;
+
+export = globGuard;

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { Plugin } from 'vite';
+
+interface GlobGuardOptions {
+    /**
+     * Which call sites should be enforced.
+     * - 'annotated': only those with a glob-guard:required annotation
+     * - 'all': every import.meta.glob call must match at least 1 file
+     */
+    mode?: 'annotated' | 'all';
+    /** Fail the build on required empty globs. Default: true */
+    failOnBuild?: boolean;
+    /** Warn (or fail) during dev server. Default: false */
+    checkOnServe?: boolean;
+    /** If true and checkOnServe enabled, fail dev server start. Default: false */
+    failOnServe?: boolean;
+    /** Optional JSON report of resolved globs and matches */
+    report?: false | true | {
+        file: string;
+    };
+    /** Ignore importer ids (e.g. virtual modules). Optional */
+    ignoreImporters?: (string | RegExp)[];
+}
+
+declare function globGuard(userOptions?: GlobGuardOptions): Plugin;
+
+export { globGuard as default };

package/dist/index.js

@@ -0,0 +1,427 @@
+// src/parse.ts
+import { parse } from "@babel/parser";
+import traverse from "@babel/traverse";
+var REQUIRED_TOKEN = "glob-guard:required";
+function hasRequiredAnnotation(comments) {
+  if (!comments || comments.length === 0) return false;
+  return comments.some((c) => c.value.includes(REQUIRED_TOKEN));
+}
+function isImportMetaGlobCallee(node) {
+  if (node.type !== "MemberExpression") return false;
+  if (node.computed) return false;
+  const object = node.object;
+  const property = node.property;
+  if (object.type !== "MetaProperty") return false;
+  if (object.meta.type !== "Identifier" || object.meta.name !== "import") return false;
+  if (object.property.type !== "Identifier" || object.property.name !== "meta")
+    return false;
+  return property.type === "Identifier" && property.name === "glob";
+}
+function readStringLiteral(node) {
+  if (node.type === "StringLiteral") return node.value;
+  if (node.type === "TemplateLiteral") {
+    if (node.expressions.length !== 0) return null;
+    return node.quasis[0]?.value?.raw ?? "";
+  }
+  return null;
+}
+function readGlobsArg(node) {
+  const single = readStringLiteral(node);
+  if (single != null) return [single];
+  if (node.type !== "ArrayExpression") return null;
+  const globs = [];
+  for (const el of node.elements) {
+    if (!el) continue;
+    if (el.type === "SpreadElement") return null;
+    const s = readStringLiteral(el);
+    if (s == null) return null;
+    globs.push(s);
+  }
+  return globs;
+}
+function readOptions(node) {
+  if (!node) return {};
+  if (node.type !== "ObjectExpression") return {};
+  const out = {};
+  for (const prop of node.properties) {
+    if (prop.type !== "ObjectProperty") continue;
+    if (prop.computed) continue;
+    if (prop.key.type !== "Identifier" && prop.key.type !== "StringLiteral") continue;
+    const key = prop.key.type === "Identifier" ? prop.key.name : prop.key.value;
+    if (key === "exhaustive" && prop.value.type === "BooleanLiteral") {
+      out.exhaustive = prop.value.value;
+    }
+    if (key === "base") {
+      const base = readStringLiteral(prop.value);
+      if (base != null) out.base = base;
+    }
+  }
+  return out;
+}
+function parseRequiredGlobCalls(code, importer, options) {
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const ast = parse(code, {
+    sourceType: "module",
+    sourceFilename: importer,
+    plugins: ["typescript", "jsx"],
+    errorRecovery: true,
+    ranges: true,
+    attachComment: true
+  });
+  const results = [];
+  traverse(ast, {
+    CallExpression(path) {
+      if (!isImportMetaGlobCallee(path.node.callee)) return;
+      const args = path.node.arguments;
+      if (args.length < 1) return;
+      const arg0 = args[0];
+      const arg1 = args[1];
+      const globNode = arg0;
+      const optsNode = arg1 ?? void 0;
+      const globs = readGlobsArg(globNode);
+      if (!globs || globs.length === 0) return;
+      const required = options.mode === "all" || (() => {
+        const stmt = path.getStatementParent()?.node;
+        if (!stmt) return false;
+        return hasRequiredAnnotation(stmt.leadingComments) || hasRequiredAnnotation(stmt.trailingComments) || hasRequiredAnnotation(path.node.leadingComments) || hasRequiredAnnotation(path.node.trailingComments);
+      })();
+      if (!required) return;
+      const opts = readOptions(optsNode);
+      results.push({
+        importer,
+        globs,
+        options: opts,
+        loc: path.node.loc ? { line: path.node.loc.start.line, column: path.node.loc.start.column } : null
+      });
+    }
+  });
+  return results;
+}
+function getLineAndColumn(source, index) {
+  const prefix = source.slice(0, index);
+  const lastNewline = prefix.lastIndexOf("\n");
+  const line = prefix.split("\n").length;
+  const column = lastNewline === -1 ? prefix.length : prefix.length - lastNewline - 1;
+  return { line, column };
+}
+function offsetLoc(loc, startLine, startColumn) {
+  if (!loc) return null;
+  const line = startLine + loc.line - 1;
+  const column = loc.line === 1 ? startColumn + loc.column : loc.column;
+  return { line, column };
+}
+function parseRequiredGlobCallsInScriptTags(code, importer, options) {
+  if (!code.includes("<script")) return [];
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const results = [];
+  let cursor = 0;
+  while (cursor < code.length) {
+    const open = code.indexOf("<script", cursor);
+    if (open === -1) break;
+    const openEnd = code.indexOf(">", open);
+    if (openEnd === -1) break;
+    const close = code.indexOf("</script>", openEnd + 1);
+    if (close === -1) break;
+    const contentStart = openEnd + 1;
+    const contentEnd = close;
+    const content = code.slice(contentStart, contentEnd);
+    const start = getLineAndColumn(code, contentStart);
+    const callsites = parseRequiredGlobCalls(content, importer, options);
+    for (const cs of callsites) {
+      results.push({
+        ...cs,
+        loc: offsetLoc(cs.loc, start.line, start.column)
+      });
+    }
+    cursor = close + "</script>".length;
+  }
+  return results;
+}
+function parseRequiredGlobCallsInAstroFrontmatter(code, importer, options) {
+  if (!code.startsWith("---")) return [];
+  if (!code.includes("import.meta.glob")) return [];
+  if (options.mode === "annotated" && !code.includes(REQUIRED_TOKEN)) return [];
+  const openNewline = code.indexOf("\n");
+  if (openNewline === -1) return [];
+  const contentStart = openNewline + 1;
+  const fmMatch = code.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/);
+  if (!fmMatch) return [];
+  const frontmatter = fmMatch[1] ?? "";
+  const start = getLineAndColumn(code, contentStart);
+  const callsites = parseRequiredGlobCalls(frontmatter, importer, options);
+  return callsites.map((cs) => ({
+    ...cs,
+    loc: offsetLoc(cs.loc, start.line, start.column)
+  }));
+}
+
+// src/utils.ts
+function slash(p) {
+  return p.replace(/\\/g, "/");
+}
+function stripQuery(id) {
+  const i = id.indexOf("?");
+  return i === -1 ? id : id.slice(0, i);
+}
+function matchesAny(value, patterns) {
+  if (!patterns || patterns.length === 0) return false;
+  return patterns.some((p) => typeof p === "string" ? p === value : p.test(value));
+}
+
+// src/resolve.ts
+import { isAbsolute, posix } from "path";
+import picomatch from "picomatch";
+import { escapePath } from "tinyglobby";
+function globSafePath(p) {
+  return escapePath(slash(p));
+}
+function lastNthChar(str, n) {
+  return str.charAt(str.length - 1 - n);
+}
+function globSafeResolvedPath(resolved, glob) {
+  let numEqual = 0;
+  const maxEqual = Math.min(resolved.length, glob.length);
+  while (numEqual < maxEqual && lastNthChar(resolved, numEqual) === lastNthChar(glob, numEqual)) {
+    numEqual += 1;
+  }
+  const staticPartEnd = resolved.length - numEqual;
+  const staticPart = resolved.slice(0, staticPartEnd);
+  const dynamicPart = resolved.slice(staticPartEnd);
+  return globSafePath(staticPart) + dynamicPart;
+}
+async function toAbsoluteGlob(glob, ctx) {
+  let pre = "";
+  if (glob[0] === "!") {
+    pre = "!";
+    glob = glob.slice(1);
+  }
+  const root = globSafePath(ctx.root);
+  let dir;
+  if (ctx.base) {
+    if (ctx.base[0] === "/") {
+      dir = posix.join(root, ctx.base);
+    } else {
+      dir = posix.resolve(globSafePath(posix.dirname(ctx.importer)), ctx.base);
+    }
+  } else {
+    dir = globSafePath(posix.dirname(ctx.importer));
+  }
+  if (glob[0] === "/") return pre + posix.join(root, glob.slice(1));
+  if (glob.startsWith("./")) return pre + posix.join(dir, glob.slice(2));
+  if (glob.startsWith("../")) return pre + posix.join(dir, glob);
+  if (glob.startsWith("**")) return pre + glob;
+  const resolved = slash(await ctx.resolveId(glob, ctx.importer) || glob);
+  if (isAbsolute(resolved)) {
+    return pre + globSafeResolvedPath(resolved, glob);
+  }
+  throw new Error(
+    `Invalid glob: "${glob}" (resolved: "${resolved}"). It must start with '/' or './'`
+  );
+}
+function getCommonBase(globsResolved) {
+  const bases = globsResolved.filter((g) => g[0] !== "!").map((glob) => {
+    let { base } = picomatch.scan(glob);
+    if (posix.basename(base).includes(".")) base = posix.dirname(base);
+    return base;
+  });
+  if (!bases.length) return null;
+  let commonAncestor = "";
+  const parts = bases[0].split("/");
+  for (let i = 0; i < parts.length; i++) {
+    const candidate = parts.slice(0, i + 1).join("/");
+    if (bases.every((b) => b.startsWith(candidate))) commonAncestor = candidate;
+    else break;
+  }
+  if (!commonAncestor) commonAncestor = "/";
+  return commonAncestor;
+}
+
+// src/match.ts
+import { glob as tinyGlob } from "tinyglobby";
+async function matchGlobs(input) {
+  const globsResolved = input.globsResolved.map(slash);
+  const root = slash(input.root);
+  const importerFile = slash(input.importerFile);
+  const cwd = getCommonBase(globsResolved) ?? root;
+  const dot = !!input.exhaustive;
+  const ignore = dot ? [] : ["**/node_modules/**"];
+  const matches = (await tinyGlob(globsResolved, {
+    cwd,
+    absolute: true,
+    dot,
+    expandDirectories: false,
+    ignore
+  })).map(slash).filter((f) => f !== importerFile).sort();
+  return {
+    cwd,
+    dot,
+    ignore,
+    matches
+  };
+}
+
+// src/diagnostics.ts
+function formatEmptyGlobFailure(f) {
+  const importerLabel = f.loc != null ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}` : slash(f.importerFile);
+  const lines = [];
+  lines.push("[glob-guard] Required glob matched 0 files");
+  lines.push(`  importer: ${importerLabel}`);
+  if (f.globs.length === 1) {
+    lines.push(`  glob: ${f.globs[0]}`);
+  } else {
+    lines.push("  globs:");
+    for (const g of f.globs) lines.push(`    - ${g}`);
+  }
+  lines.push("  resolved:");
+  for (const g of f.globsResolved) lines.push(`    - ${g}`);
+  lines.push(`  options: exhaustive=${String(f.exhaustive)}${f.base ? ` base=${f.base}` : ""}`);
+  lines.push(`  cwd: ${f.cwd}`);
+  if (f.ignore.length > 0) {
+    lines.push("  ignore:");
+    for (const i of f.ignore) lines.push(`    - ${i}`);
+  }
+  lines.push("  hints:");
+  lines.push("    - Did you rename/move the directory?");
+  lines.push("    - Did you change file extensions?");
+  lines.push('    - Are you excluding everything via a negated pattern ("!...")?');
+  const err = new Error(lines.join("\n"));
+  err.id = slash(f.importerFile);
+  if (f.loc) err.loc = { file: err.id, line: f.loc.line, column: f.loc.column };
+  return err;
+}
+function formatManyFailures(failures) {
+  if (failures.length === 1) return formatEmptyGlobFailure(failures[0]);
+  const lines = [];
+  lines.push(`[glob-guard] ${failures.length} required globs matched 0 files`);
+  for (const f of failures) {
+    const importerLabel = f.loc != null ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}` : slash(f.importerFile);
+    lines.push(`  - ${importerLabel}`);
+    if (f.globs.length === 1) {
+      lines.push(`    glob: ${f.globs[0]}`);
+    } else {
+      lines.push("    globs:");
+      for (const g of f.globs) lines.push(`      - ${g}`);
+    }
+  }
+  const err = new Error(lines.join("\n"));
+  return err;
+}
+
+// src/index.ts
+var DEFAULTS = {
+  mode: "annotated",
+  failOnBuild: true,
+  checkOnServe: false,
+  failOnServe: false,
+  report: false,
+  ignoreImporters: []
+};
+function globGuard(userOptions = {}) {
+  const options = { ...DEFAULTS, ...userOptions };
+  let root = "";
+  let isBuild = false;
+  const callsites = [];
+  async function checkAll() {
+    if (callsites.length === 0) return;
+    const failures = [];
+    for (const cs of callsites) {
+      const importerFile = stripQuery(cs.importer);
+      const globsResolved = await Promise.all(
+        cs.globs.map(
+          (g) => toAbsoluteGlob(g, {
+            root,
+            importer: slash(importerFile),
+            base: cs.options.base,
+            resolveId: async (id, importer) => {
+              const r = await this.resolve(id, importer);
+              return r?.id;
+            }
+          })
+        )
+      );
+      const match = await matchGlobs({
+        globsResolved,
+        root,
+        importerFile,
+        exhaustive: cs.options.exhaustive
+      });
+      if (match.matches.length === 0) {
+        failures.push({
+          importer: cs.importer,
+          importerFile,
+          loc: cs.loc,
+          globs: cs.globs,
+          globsResolved,
+          exhaustive: !!cs.options.exhaustive,
+          base: cs.options.base,
+          cwd: match.cwd,
+          ignore: match.ignore
+        });
+      }
+    }
+    if (failures.length === 0) return;
+    if (options.report) {
+      const reportFile = options.report === true ? "glob-guard.report.json" : options.report.file;
+      const fs = await import("fs/promises");
+      const payload = {
+        root,
+        failures: failures.map((f) => ({
+          importer: slash(f.importerFile),
+          loc: f.loc,
+          globs: f.globs,
+          globsResolved: f.globsResolved,
+          exhaustive: f.exhaustive,
+          base: f.base,
+          cwd: f.cwd,
+          ignore: f.ignore
+        }))
+      };
+      await fs.writeFile(reportFile, JSON.stringify(payload, null, 2), "utf8");
+    }
+    const err = formatManyFailures(failures);
+    if (isBuild ? options.failOnBuild : options.failOnServe) {
+      this.error(err);
+    } else {
+      this.warn(err);
+    }
+  }
+  return {
+    name: "glob-guard",
+    // We must run before Vite's internal TS/JS transforms (esbuild), otherwise
+    // comment annotations may be stripped before we can read them.
+    enforce: "pre",
+    configResolved(config) {
+      root = slash(config.root);
+      isBuild = config.command === "build";
+    },
+    transform(code, id) {
+      if (matchesAny(id, options.ignoreImporters)) return null;
+      let parsed;
+      try {
+        const file = stripQuery(id);
+        if (file.endsWith(".vue") || file.endsWith(".svelte")) {
+          parsed = parseRequiredGlobCallsInScriptTags(code, id, { mode: options.mode });
+        } else if (file.endsWith(".astro")) {
+          parsed = parseRequiredGlobCallsInAstroFrontmatter(code, id, { mode: options.mode });
+        } else {
+          parsed = parseRequiredGlobCalls(code, id, { mode: options.mode });
+        }
+      } catch {
+        return null;
+      }
+      if (parsed.length > 0) callsites.push(...parsed);
+      return null;
+    },
+    async buildEnd() {
+      await checkAll.call(this);
+    }
+  };
+}
+export {
+  globGuard as default
+};
+if (typeof module !== 'undefined' && module.exports && module.exports.default) { module.exports = module.exports.default }
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts","../src/utils.ts","../src/resolve.ts","../src/match.ts","../src/diagnostics.ts","../src/index.ts"],"sourcesContent":["import { parse } from '@babel/parser'\nimport traverse from '@babel/traverse'\nimport type { Comment, Node } from '@babel/types'\n\nexport interface ParsedGlobCallsite {\n  importer: string\n  globs: string[]\n  options: {\n    exhaustive?: boolean\n    base?: string\n  }\n  loc: { line: number; column: number } | null\n}\n\nexport interface ParseOptions {\n  mode: 'annotated' | 'all'\n}\n\nconst REQUIRED_TOKEN = 'glob-guard:required'\n\nfunction hasRequiredAnnotation(comments: Comment[] | null | undefined): boolean {\n  if (!comments || comments.length === 0) return false\n  return comments.some((c) => c.value.includes(REQUIRED_TOKEN))\n}\n\nfunction isImportMetaGlobCallee(node: Node): boolean {\n  if (node.type !== 'MemberExpression') return false\n  if (node.computed) return false\n\n  const object = node.object\n  const property = node.property\n\n  if (object.type !== 'MetaProperty') return false\n  if (object.meta.type !== 'Identifier' || object.meta.name !== 'import') return false\n  if (object.property.type !== 'Identifier' || object.property.name !== 'meta')\n    return false\n\n  return property.type === 'Identifier' && property.name === 'glob'\n}\n\nfunction readStringLiteral(node: Node): string | null {\n  if (node.type === 'StringLiteral') return node.value\n  if (node.type === 'TemplateLiteral') {\n    if (node.expressions.length !== 0) return null\n    return node.quasis[0]?.value?.raw ?? ''\n  }\n  return null\n}\n\nfunction readGlobsArg(node: Node): string[] | null {\n  const single = readStringLiteral(node)\n  if (single != null) return [single]\n  if (node.type !== 'ArrayExpression') return null\n\n  const globs: string[] = []\n  for (const el of node.elements) {\n    if (!el) continue\n    if (el.type === 'SpreadElement') return null\n    const s = readStringLiteral(el)\n    if (s == null) return null\n    globs.push(s)\n  }\n  return globs\n}\n\nfunction readOptions(node: Node | null | undefined): {\n  exhaustive?: boolean\n  base?: string\n} {\n  if (!node) return {}\n  if (node.type !== 'ObjectExpression') return {}\n\n  const out: { exhaustive?: boolean; base?: string } = {}\n  for (const prop of node.properties) {\n    if (prop.type !== 'ObjectProperty') continue\n    if (prop.computed) continue\n    if (prop.key.type !== 'Identifier' && prop.key.type !== 'StringLiteral') continue\n\n    const key = prop.key.type === 'Identifier' ? prop.key.name : prop.key.value\n    if (key === 'exhaustive' && prop.value.type === 'BooleanLiteral') {\n      out.exhaustive = prop.value.value\n    }\n    if (key === 'base') {\n      const base = readStringLiteral(prop.value)\n      if (base != null) out.base = base\n    }\n  }\n  return out\n}\n\nexport function parseRequiredGlobCalls(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  // Fast exits.\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const ast = parse(code, {\n    sourceType: 'module',\n    sourceFilename: importer,\n    plugins: ['typescript', 'jsx'],\n    errorRecovery: true,\n    ranges: true,\n    attachComment: true,\n  })\n\n  const results: ParsedGlobCallsite[] = []\n\n  traverse(ast, {\n    CallExpression(path) {\n      if (!isImportMetaGlobCallee(path.node.callee as unknown as Node)) return\n\n      const args = path.node.arguments\n      if (args.length < 1) return\n      const arg0 = args[0]\n      const arg1 = args[1]\n\n      // @babel/parser uses different node types inside CallExpression.arguments.\n      // We rely on runtime checks only.\n      const globNode = arg0 as unknown as Node\n      const optsNode = (arg1 as unknown as Node | undefined) ?? undefined\n\n      const globs = readGlobsArg(globNode)\n      if (!globs || globs.length === 0) return\n\n      const required =\n        options.mode === 'all' ||\n        (() => {\n          const stmt = path.getStatementParent()?.node as any\n          if (!stmt) return false\n          return (\n            hasRequiredAnnotation(stmt.leadingComments) ||\n            hasRequiredAnnotation(stmt.trailingComments) ||\n            hasRequiredAnnotation((path.node as any).leadingComments) ||\n            hasRequiredAnnotation((path.node as any).trailingComments)\n          )\n        })()\n\n      if (!required) return\n\n      const opts = readOptions(optsNode)\n\n      results.push({\n        importer,\n        globs,\n        options: opts,\n        loc: path.node.loc\n          ? { line: path.node.loc.start.line, column: path.node.loc.start.column }\n          : null,\n      })\n    },\n  })\n\n  return results\n}\n\nfunction getLineAndColumn(source: string, index: number): { line: number; column: number } {\n  const prefix = source.slice(0, index)\n  const lastNewline = prefix.lastIndexOf('\\n')\n  const line = prefix.split('\\n').length\n  const column = lastNewline === -1 ? prefix.length : prefix.length - lastNewline - 1\n  return { line, column }\n}\n\nfunction offsetLoc(\n  loc: { line: number; column: number } | null,\n  startLine: number,\n  startColumn: number,\n): { line: number; column: number } | null {\n  if (!loc) return null\n  const line = startLine + loc.line - 1\n  const column = loc.line === 1 ? startColumn + loc.column : loc.column\n  return { line, column }\n}\n\n/**\n * Extract required glob call sites from <script> blocks inside SFC-ish files\n * (Vue/Svelte). This is a lightweight extractor: it doesn't try to fully parse\n * HTML/SFC syntax; it only slices out script contents.\n */\nexport function parseRequiredGlobCallsInScriptTags(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  // If the file can't possibly contain our targets, skip quickly.\n  if (!code.includes('<script')) return []\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const results: ParsedGlobCallsite[] = []\n\n  let cursor = 0\n  while (cursor < code.length) {\n    const open = code.indexOf('<script', cursor)\n    if (open === -1) break\n\n    const openEnd = code.indexOf('>', open)\n    if (openEnd === -1) break\n\n    const close = code.indexOf('</script>', openEnd + 1)\n    if (close === -1) break\n\n    const contentStart = openEnd + 1\n    const contentEnd = close\n    const content = code.slice(contentStart, contentEnd)\n\n    const start = getLineAndColumn(code, contentStart)\n    const callsites = parseRequiredGlobCalls(content, importer, options)\n    for (const cs of callsites) {\n      results.push({\n        ...cs,\n        loc: offsetLoc(cs.loc, start.line, start.column),\n      })\n    }\n\n    cursor = close + '</script>'.length\n  }\n\n  return results\n}\n\n/**\n * Extract required glob call sites from Astro frontmatter:\n *\n * ---\n * // TS/JS\n * ---\n */\nexport function parseRequiredGlobCallsInAstroFrontmatter(\n  code: string,\n  importer: string,\n  options: ParseOptions,\n): ParsedGlobCallsite[] {\n  if (!code.startsWith('---')) return []\n  if (!code.includes('import.meta.glob')) return []\n  if (options.mode === 'annotated' && !code.includes(REQUIRED_TOKEN)) return []\n\n  const openNewline = code.indexOf('\\n')\n  if (openNewline === -1) return []\n  const contentStart = openNewline + 1\n\n  const fmMatch = code.match(/^---\\s*\\r?\\n([\\s\\S]*?)\\r?\\n---\\s*(?:\\r?\\n|$)/)\n  if (!fmMatch) return []\n  const frontmatter = fmMatch[1] ?? ''\n\n  const start = getLineAndColumn(code, contentStart)\n  const callsites = parseRequiredGlobCalls(frontmatter, importer, options)\n  return callsites.map((cs) => ({\n    ...cs,\n    loc: offsetLoc(cs.loc, start.line, start.column),\n  }))\n}\n","export function slash(p: string): string {\n  return p.replace(/\\\\/g, '/')\n}\n\nexport function stripQuery(id: string): string {\n  const i = id.indexOf('?')\n  return i === -1 ? id : id.slice(0, i)\n}\n\nexport function toArray<T>(value: T | T[]): T[] {\n  return Array.isArray(value) ? value : [value]\n}\n\nexport function matchesAny(\n  value: string,\n  patterns: (string | RegExp)[] | undefined,\n): boolean {\n  if (!patterns || patterns.length === 0) return false\n  return patterns.some((p) => (typeof p === 'string' ? p === value : p.test(value)))\n}\n","// Portions of this file are based on Vite's importMetaGlob implementation:\n// https://github.com/vitejs/vite/blob/v7.3.1/packages/vite/src/node/plugins/importMetaGlob.ts\n// Vite is licensed under the MIT License.\n\nimport { isAbsolute, posix } from 'node:path'\nimport picomatch from 'picomatch'\nimport { escapePath } from 'tinyglobby'\nimport { slash } from './utils'\n\nexport interface ResolveContext {\n  root: string\n  importer: string\n  base?: string\n  resolveId: (id: string, importer?: string) => Promise<string | undefined>\n}\n\nfunction globSafePath(p: string): string {\n  // slash path to ensure \\ is converted to / as \\ could lead to a double escape scenario\n  return escapePath(slash(p))\n}\n\nfunction lastNthChar(str: string, n: number) {\n  return str.charAt(str.length - 1 - n)\n}\n\nfunction globSafeResolvedPath(resolved: string, glob: string) {\n  let numEqual = 0\n  const maxEqual = Math.min(resolved.length, glob.length)\n  while (numEqual < maxEqual && lastNthChar(resolved, numEqual) === lastNthChar(glob, numEqual)) {\n    numEqual += 1\n  }\n  const staticPartEnd = resolved.length - numEqual\n  const staticPart = resolved.slice(0, staticPartEnd)\n  const dynamicPart = resolved.slice(staticPartEnd)\n  return globSafePath(staticPart) + dynamicPart\n}\n\nexport async function toAbsoluteGlob(glob: string, ctx: ResolveContext): Promise<string> {\n  let pre = ''\n  if (glob[0] === '!') {\n    pre = '!'\n    glob = glob.slice(1)\n  }\n\n  const root = globSafePath(ctx.root)\n\n  let dir: string\n  if (ctx.base) {\n    if (ctx.base[0] === '/') {\n      dir = posix.join(root, ctx.base)\n    } else {\n      dir = posix.resolve(globSafePath(posix.dirname(ctx.importer)), ctx.base)\n    }\n  } else {\n    dir = globSafePath(posix.dirname(ctx.importer))\n  }\n\n  if (glob[0] === '/') return pre + posix.join(root, glob.slice(1))\n  if (glob.startsWith('./')) return pre + posix.join(dir, glob.slice(2))\n  if (glob.startsWith('../')) return pre + posix.join(dir, glob)\n  if (glob.startsWith('**')) return pre + glob\n\n  const resolved = slash((await ctx.resolveId(glob, ctx.importer)) || glob)\n  if (isAbsolute(resolved)) {\n    return pre + globSafeResolvedPath(resolved, glob)\n  }\n\n  throw new Error(\n    `Invalid glob: \"${glob}\" (resolved: \"${resolved}\"). It must start with '/' or './'`,\n  )\n}\n\nexport function getCommonBase(globsResolved: string[]): null | string {\n  const bases = globsResolved\n    .filter((g) => g[0] !== '!')\n    .map((glob) => {\n      let { base } = picomatch.scan(glob)\n      if (posix.basename(base).includes('.')) base = posix.dirname(base)\n      return base\n    })\n\n  if (!bases.length) return null\n\n  let commonAncestor = ''\n  const parts = bases[0].split('/')\n  for (let i = 0; i < parts.length; i++) {\n    const candidate = parts.slice(0, i + 1).join('/')\n    if (bases.every((b) => b.startsWith(candidate))) commonAncestor = candidate\n    else break\n  }\n  if (!commonAncestor) commonAncestor = '/'\n  return commonAncestor\n}\n","import { glob as tinyGlob } from 'tinyglobby'\nimport { getCommonBase } from './resolve'\nimport { slash } from './utils'\n\nexport interface MatchInput {\n  globsResolved: string[]\n  root: string\n  importerFile: string\n  exhaustive?: boolean\n}\n\nexport interface MatchResult {\n  cwd: string\n  dot: boolean\n  ignore: string[]\n  matches: string[]\n}\n\nexport async function matchGlobs(input: MatchInput): Promise<MatchResult> {\n  const globsResolved = input.globsResolved.map(slash)\n  const root = slash(input.root)\n  const importerFile = slash(input.importerFile)\n  const cwd = getCommonBase(globsResolved) ?? root\n  const dot = !!input.exhaustive\n\n  const ignore = dot ? [] : ['**/node_modules/**']\n  const matches = (\n    await tinyGlob(globsResolved, {\n      cwd,\n      absolute: true,\n      dot,\n      expandDirectories: false,\n      ignore,\n    })\n  )\n    .map(slash)\n    .filter((f) => f !== importerFile)\n    .sort()\n\n  return {\n    cwd,\n    dot,\n    ignore,\n    matches,\n  }\n}\n","import type { RollupError } from 'rollup'\nimport { slash } from './utils'\n\nexport interface EmptyGlobFailure {\n  importer: string\n  importerFile: string\n  loc: { line: number; column: number } | null\n  globs: string[]\n  globsResolved: string[]\n  exhaustive: boolean\n  base?: string\n  cwd: string\n  ignore: string[]\n}\n\nexport function formatEmptyGlobFailure(f: EmptyGlobFailure): RollupError {\n  const importerLabel =\n    f.loc != null\n      ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}`\n      : slash(f.importerFile)\n\n  const lines: string[] = []\n  lines.push('[glob-guard] Required glob matched 0 files')\n  lines.push(`  importer: ${importerLabel}`)\n  if (f.globs.length === 1) {\n    lines.push(`  glob: ${f.globs[0]}`)\n  } else {\n    lines.push('  globs:')\n    for (const g of f.globs) lines.push(`    - ${g}`)\n  }\n  lines.push('  resolved:')\n  for (const g of f.globsResolved) lines.push(`    - ${g}`)\n  lines.push(`  options: exhaustive=${String(f.exhaustive)}${f.base ? ` base=${f.base}` : ''}`)\n  lines.push(`  cwd: ${f.cwd}`)\n  if (f.ignore.length > 0) {\n    lines.push('  ignore:')\n    for (const i of f.ignore) lines.push(`    - ${i}`)\n  }\n  lines.push('  hints:')\n  lines.push('    - Did you rename/move the directory?')\n  lines.push('    - Did you change file extensions?')\n  lines.push('    - Are you excluding everything via a negated pattern (\"!...\")?')\n\n  const err = new Error(lines.join('\\n')) as RollupError\n  err.id = slash(f.importerFile)\n  if (f.loc) err.loc = { file: err.id, line: f.loc.line, column: f.loc.column }\n  return err\n}\n\nexport function formatManyFailures(failures: EmptyGlobFailure[]): RollupError {\n  if (failures.length === 1) return formatEmptyGlobFailure(failures[0])\n\n  const lines: string[] = []\n  lines.push(`[glob-guard] ${failures.length} required globs matched 0 files`)\n  for (const f of failures) {\n    const importerLabel =\n      f.loc != null\n        ? `${slash(f.importerFile)}:${f.loc.line}:${f.loc.column + 1}`\n        : slash(f.importerFile)\n    lines.push(`  - ${importerLabel}`)\n    if (f.globs.length === 1) {\n      lines.push(`    glob: ${f.globs[0]}`)\n    } else {\n      lines.push('    globs:')\n      for (const g of f.globs) lines.push(`      - ${g}`)\n    }\n  }\n  const err = new Error(lines.join('\\n')) as RollupError\n  return err\n}\n","import type { Plugin } from 'vite'\nimport {\n  parseRequiredGlobCalls,\n  parseRequiredGlobCallsInAstroFrontmatter,\n  parseRequiredGlobCallsInScriptTags,\n  type ParsedGlobCallsite,\n} from './parse'\nimport { matchesAny, slash, stripQuery } from './utils'\nimport { toAbsoluteGlob } from './resolve'\nimport { matchGlobs } from './match'\nimport { formatManyFailures, type EmptyGlobFailure } from './diagnostics'\nimport type { GlobGuardOptions } from './types'\n\nconst DEFAULTS: Required<Pick<\n  GlobGuardOptions,\n  'mode' | 'failOnBuild' | 'checkOnServe' | 'failOnServe' | 'report' | 'ignoreImporters'\n>> = {\n  mode: 'annotated',\n  failOnBuild: true,\n  checkOnServe: false,\n  failOnServe: false,\n  report: false,\n  ignoreImporters: [],\n}\n\nexport default function globGuard(userOptions: GlobGuardOptions = {}): Plugin {\n  const options = { ...DEFAULTS, ...userOptions }\n\n  let root = ''\n  let isBuild = false\n\n  const callsites: ParsedGlobCallsite[] = []\n\n  async function checkAll(this: any) {\n    if (callsites.length === 0) return\n\n    const failures: EmptyGlobFailure[] = []\n\n    for (const cs of callsites) {\n      const importerFile = stripQuery(cs.importer)\n\n      const globsResolved = await Promise.all(\n        cs.globs.map((g) =>\n          toAbsoluteGlob(g, {\n            root,\n            importer: slash(importerFile),\n            base: cs.options.base,\n            resolveId: async (id, importer) => {\n              const r = await this.resolve(id, importer)\n              return r?.id\n            },\n          }),\n        ),\n      )\n\n      const match = await matchGlobs({\n        globsResolved,\n        root,\n        importerFile,\n        exhaustive: cs.options.exhaustive,\n      })\n\n      if (match.matches.length === 0) {\n        failures.push({\n          importer: cs.importer,\n          importerFile,\n          loc: cs.loc,\n          globs: cs.globs,\n          globsResolved,\n          exhaustive: !!cs.options.exhaustive,\n          base: cs.options.base,\n          cwd: match.cwd,\n          ignore: match.ignore,\n        })\n      }\n    }\n\n    if (failures.length === 0) return\n\n    // Report (optional)\n    if (options.report) {\n      const reportFile =\n        options.report === true\n          ? 'glob-guard.report.json'\n          : options.report.file\n      const fs = await import('node:fs/promises')\n      const payload = {\n        root,\n        failures: failures.map((f) => ({\n          importer: slash(f.importerFile),\n          loc: f.loc,\n          globs: f.globs,\n          globsResolved: f.globsResolved,\n          exhaustive: f.exhaustive,\n          base: f.base,\n          cwd: f.cwd,\n          ignore: f.ignore,\n        })),\n      }\n      await fs.writeFile(reportFile, JSON.stringify(payload, null, 2), 'utf8')\n    }\n\n    const err = formatManyFailures(failures)\n    if (isBuild ? options.failOnBuild : options.failOnServe) {\n      this.error(err)\n    } else {\n      this.warn(err)\n    }\n  }\n\n  return {\n    name: 'glob-guard',\n\n    // We must run before Vite's internal TS/JS transforms (esbuild), otherwise\n    // comment annotations may be stripped before we can read them.\n    enforce: 'pre',\n\n\n    configResolved(config) {\n      root = slash(config.root)\n      isBuild = config.command === 'build'\n    },\n\n    transform(code, id) {\n      if (matchesAny(id, options.ignoreImporters)) return null\n\n      let parsed: ParsedGlobCallsite[]\n      try {\n        const file = stripQuery(id)\n        if (file.endsWith('.vue') || file.endsWith('.svelte')) {\n          parsed = parseRequiredGlobCallsInScriptTags(code, id, { mode: options.mode })\n        } else if (file.endsWith('.astro')) {\n          parsed = parseRequiredGlobCallsInAstroFrontmatter(code, id, { mode: options.mode })\n        } else {\n          parsed = parseRequiredGlobCalls(code, id, { mode: options.mode })\n        }\n      } catch {\n        // Some files (e.g. Vue/Svelte SFC source) are not valid JS/TS before\n        // their framework plugin runs. We intentionally ignore parse failures\n        // and only act on call sites we can confidently extract.\n        return null\n      }\n      if (parsed.length > 0) callsites.push(...parsed)\n      return null\n    },\n\n    async buildEnd() {\n      await checkAll.call(this)\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "vite-plugin-glob-guard",
+  "version": "0.1.0",
+  "description": "Opt-in guardrails for import.meta.glob() required globs",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "import-meta-glob",
+    "glob",
+    "tooling"
+  ],
+  "dependencies": {
+    "@babel/parser": "^7.29.0",
+    "@babel/traverse": "^7.29.0",
+    "picomatch": "^4.0.3",
+    "tinyglobby": "^0.2.15"
+  },
+  "devDependencies": {
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/node": "^25.2.0",
+    "@types/picomatch": "^4.0.2",
+    "@vitejs/plugin-react": "^5.1.3",
+    "@vitejs/plugin-vue": "^6.0.4",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "svelte": "^5.49.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vue": "^3.5.27",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "vite": ">=7.0.0"
+  }
+}