Function resolve

src/utils/imageMappingCsvResolver.ts:118–140

(ctx: ImageResolveContext)

export const imageMappingCsvStrategy: ImageSourceStrategy = {
  id: 'image-mapping-csv',
  async resolve(ctx: ImageResolveContext) {
    if (!ctx.fetchText) {
      return null;
    }
    // Prefer a mapping CSV in the model directory; fall back to any in the tree.
    const candidates = ctx.filePaths.filter(
      (path) => getBasename(path).toLowerCase() === IMAGE_MAPPING_CSV_FILENAME
    );
    const csvPath =
      candidates.find((path) => getParentDir(path) === ctx.modelDir) ?? candidates[0];
    if (!csvPath) {
      return null;
    }

    const text = await ctx.fetchText(csvPath);
    if (!text) {
      return null;
    }
    const imageNameToPath = parseImageMappingCsv(text);
    return Object.keys(imageNameToPath).length > 0
      ? { kind: 'per-image', imageNameToPath }
      : null;
  },
};