Function phase1_config

packages/cli/scripts/check-package.ts:80–124

()

// ── Phase 1: Pre-pack validation ───────────────────────────────────

function phase1_config() {
  heading('Phase 1a: Package.json validation');

  const pkg = readPkg();

  // 1. files field exists
  const files = pkg.files as string[] | undefined;
  check('#1  `files` field exists', Array.isArray(files) && files.length > 0,
    'Add a "files" array to package.json to control what ships');

  // 2. exports structure
  const exports = pkg.exports as Record<string, Record<string, string>> | undefined;
  check('#2  `exports["."]` defined', !!exports?.['.'],
    'Missing exports["."] in package.json');

  if (exports?.['.']) {
    check('#3  `exports["."].types` field exists', !!exports['.'].types,
      'Missing types condition in exports["."]');
  } else {
    fail('#3  `exports["."].types` field exists', 'Skipped — no exports');
  }

  // 4. main field
  const main = pkg.main as string | undefined;
  check('#4  `main` field exists', !!main,
    'Missing "main" field in package.json');

  // 5. types field
  const types = pkg.types as string | undefined;
  check('#5  `types` field exists', !!types,
    'Missing "types" field in package.json');

  // 5c. bin map exposes a Windows-friendly alias (no dot in the name).
  // The `design.md` bin file is unrunnable on Windows because the `.md`
  // suffix collides with the Markdown file association, so PowerShell
  // opens the shim in the user's Markdown editor instead of executing it.
  // A dot-free alias such as `designmd` lets the npm CMD/PowerShell shims
  // resolve cleanly via PATHEXT. See https://github.com/google-labs-code/design.md/issues/54.
  const bin = pkg.bin as Record<string, string> | string | undefined;
  const binEntries = typeof bin === 'object' && bin !== null ? Object.keys(bin) : [];
  const hasDotFreeAlias = binEntries.some((name) => !name.includes('.'));
  check('#5c bin map exposes a Windows-friendly alias (no dot in the name)',
    hasDotFreeAlias,
    `bin entries: ${binEntries.join(', ') || '(none)'} — add an alias without a dot for Windows compatibility`);
}

function phase1_paths() {
  heading('Phase 1b: Path resolution (post-build)');