Function findMotionSpec

packages/cli/src/utils/motionSpec.ts:115–131

(projectDir: string)

 * Returns null when none is present.
 */
export function findMotionSpec(projectDir: string): string | null {
  if (!existsSync(projectDir)) return null;
  const entries = readdirSync(projectDir);
  const sidecars = entries.filter((name) => name.endsWith(".motion.json")).sort();
  if (!sidecars[0]) return null;
  if (sidecars.length === 1) return join(projectDir, sidecars[0]);
  const htmlBases = new Set(
    entries.filter((name) => name.endsWith(".html")).map((name) => basename(name, ".html")),
  );
  const matched = sidecars.filter((name) => htmlBases.has(basename(name, ".motion.json")));
  if (matched.length > 1) {
    throw new Error(
      `ambiguous motion sidecars in ${projectDir}: ${matched.join(", ")} each match a composition — remove the sidecars you do not need, or use one composition per project`,
    );
  }
  return join(projectDir, matched[0] ?? sidecars[0]);
}

export function readMotionSpec(path: string): MotionSpecParse {
  let raw: unknown;