/**
 * Comprehensive representation of a package.json file.
 * Feel free to add properties to this,
 * 🟠ℹ️   BUT ENSURE OPTIONAL STUFF IS ACTUALLY OPTIONAL  ℹ️🟠
 * 🟠ℹ️ SINCE THIS IS USED IN A NUMBER OF LOCATIONS WHERE ℹ️🟠
 * 🟠ℹ️ WE CANNOT ENFORCE/GUARANTEE ANY PARTICULAR PROPS  ℹ️🟠
 *
 * @public
 */
export type PackageJson = {
  // Required fields
  name: string;
  version: string;

  // Dependencies (optional)
  dependencies?: Record<string, string>;
  devDependencies?: Record<string, string>;
  peerDependencies?: Record<string, string>;

  // Module structure (optional)
  exports?: Record<string, unknown>;
  main?: string;
  types?: string;

  // Metadata (optional)
  author?: string;
  description?: string;
  engines?: Record<string, string>;
  license?: string;
  private?: boolean;
  repository?: { type: string; url: string };
  scripts?: Record<string, string>;
  type?: "module" | "commonjs";

  // Allow additional properties (mirrors z.looseObject)
  [key: string]: unknown;
};