Function parseCompositionEntryArg

packages/cli/src/utils/renderArgs.ts:142–177

(
  raw: string | undefined,
  projectDir: string,
  stat: (path: string) => Stats,
)

 *     without touching the filesystem.
 */
export function parseCompositionEntryArg(
  raw: string | undefined,
  projectDir: string,
  stat: (path: string) => Stats,
): CompositionEntryParseResult {
  const trimmed = raw?.trim().replace(/^\.\//, "") || undefined;
  // Normalize the project-root shorthands to "no entry override" so the
  // producer falls back to index.html instead of statSync-ing the dir
  // and later blowing up with EISDIR inside readFileSync().
  if (!trimmed || trimmed === ".") return { ok: true, value: undefined };

  const absProjectDir = resolve(projectDir);
  const entryPath = resolve(absProjectDir, trimmed);
  // Trailing-separator guard: `startsWith` alone treats `/proj` as a
  // prefix of `/proj-evil`, letting a sibling-directory escape through.
  // Allow the resolved path to BE the project dir (already covered by
  // the trimmed === "." branch above) or to live beneath it with a
  // path separator.
  if (entryPath !== absProjectDir && !entryPath.startsWith(absProjectDir + sep)) {
    return { ok: false, error: { kind: "outside-project", entryFile: trimmed } };
  }

  let entryStat: Stats;
  try {
    entryStat = stat(entryPath);
  } catch {
    return { ok: false, error: { kind: "not-found", entryFile: trimmed } };
  }
  if (!entryStat.isFile()) {
    // Directory paths slip past existsSync downstream and explode with
    // `EISDIR: illegal operation on a directory, read` inside the
    // producer's readFileSync. Reject here with an actionable message.
    return { ok: false, error: { kind: "not-a-file", entryFile: trimmed } };
  }
  return { ok: true, value: trimmed };
}

function compositionEntryErrorMessage(error: CompositionEntryParseError): {
  title: string;