Function plan

packages/cli/src/cli/cmd/run/plan.ts:11–140

(
  input: CmdRunContext,
)

import { CmdRunContext } from "./_types";

export default async function plan(
  input: CmdRunContext,
): Promise<CmdRunContext> {
  console.log(chalk.hex(colors.orange)("[Planning]"));

  let buckets = getBuckets(input.config!);
  if (input.flags.bucket) {
    buckets = buckets.filter((b) => input.flags.bucket!.includes(b.type));
  }

  const _sourceLocale = input.flags.sourceLocale || input.config!.locale.source;
  if (!_sourceLocale) {
    throw new Error(
      `No source locale provided. Use --source-locale to specify the source locale or add it to i18n.json (locale.source)`,
    );
  }
  const _targetLocales =
    input.flags.targetLocale || input.config!.locale.targets;
  if (!_targetLocales.length) {
    throw new Error(
      `No target locales provided. Use --target-locale to specify the target locales or add them to i18n.json (locale.targets)`,
    );
  }

  return new Listr<CmdRunContext>(
    [
      {
        title: "Locating content buckets",
        task: async (ctx, task) => {
          const bucketCount = buckets.length;
          const bucketFilter = input.flags.bucket
            ? ` ${chalk.dim(`(filtered by: ${chalk.hex(colors.yellow)(input.flags.bucket!.join(", "))})`)}`
            : "";
          task.title = `Found ${chalk.hex(colors.yellow)(bucketCount.toString())} bucket(s)${bucketFilter}`;
        },
      },
      {
        title: "Detecting locales",
        task: async (ctx, task) => {
          task.title = `Found ${chalk.hex(colors.yellow)(_targetLocales.length.toString())} target locale(s)`;
        },
      },
      {
        title: "Locating localizable files",
        task: async (ctx, task) => {
          const patterns: string[] = [];

          for (const bucket of buckets) {
            for (const bucketPath of bucket.paths) {
              if (input.flags.file) {
                if (
                  !input.flags.file.some(
                    (f) =>
                      bucketPath.pathPattern.includes(f) ||
                      minimatch(bucketPath.pathPattern, f),
                  )
                ) {
                  continue;