Function buildNativeRegistry

src/ast/native-loader.ts:153–218

(r: NativeAstResolved)

 * or unroutable languages, and warnings for name mismatches / extension collisions.
 */
export function buildNativeRegistry(r: NativeAstResolved): NativeRegistry {
  const byExt = new Map<string, NativeRegistryEntry>();
  if (r.mode === false) return { byExt };

  const candidates = r.authoritative
    ? [...r.languages]
    : listPluginFiles(r.pluginDirs).map((f) => f.lang);

  for (const requested of candidates) {
    const loaded = loadPlugin(requested, r.pluginDirs);
    if (!loaded) {
      if (r.mode === "strict") recordUnavailableLang(r, requested);
      continue;
    }

    // `describe().languageId` is authoritative for identity; filename is fallback.
    // Coerce defensively — metadata is untrusted plugin output (a non-string id
    // is ignored rather than allowed to crash the registry build).
    const reported = typeof loaded.metadata?.languageId === "string" ? loaded.metadata.languageId : undefined;
    const lang = reported && reported.length > 0 ? reported : requested;
    if (reported && reported.length > 0 && reported !== requested) {
      addWarning(
        r,
        `plugin "codesight-${requested}-ast.wasm" self-reports languageId "${reported}" — honoring "${reported}" (rename the file to match for explicit --native-ast=${reported})`
      );
      // In explicit mode the user asked for `requested`; a file claiming a
      // different id doesn't satisfy that request.
      if (r.authoritative && !r.languages.has(lang)) {
        if (r.mode === "strict") recordUnavailableLang(r, requested);
        continue;
      }
    }

    // Untrusted: keep only string entries so a malformed array (numbers, null,
    // objects) can't throw out of the registry build and crash the scan.
    const declared = Array.isArray(loaded.metadata?.extensions)
      ? loaded.metadata.extensions.filter((e): e is string => typeof e === "string")
      : undefined;
    const exts = (declared && declared.length > 0 ? declared : DEFAULT_EXTENSIONS[lang]) ?? [];
    if (exts.length === 0) {
      if (r.mode === "strict") {
        r.diagnostics.push({
          lang,
          kind: "routes",
          reason: "no extensions declared (describe().extensions is required for non-built-in languages)",
        });
      }
      continue;
    }

    const entry: NativeRegistryEntry = { lang, authoritative: r.authoritative, plugin: adaptPlugin(loaded) };
    for (const raw of exts) {
      const ext = (raw.startsWith(".") ? raw : "." + raw).toLowerCase();
      const existing = byExt.get(ext);
      if (!existing || existing.lang === entry.lang) {
        byExt.set(ext, entry);
        continue;
      }