v2.0.2

Major Changes

• Complete refactor of votes

  The old functions were getting difficult to work with, as I was trying to add tie-breaking mechanisms (not included in this release) and adding new systems.

  New API

  Old:

  import { utils as voteUtils, VotingSystem } from 'votes'
  
  const scores = scoresFromBallots(
    [
      { ranking: [['Lion'], ['Bear'], ['Sheep']], weight: 4 },
      { ranking: [['Sheep'], ['Bear'], ['Lion']], weight: 3 },
      { ranking: [['Bear', 'Sheep'], ['Lion']], weight: 2 },
    ],
    ['Lion', 'Bear', 'Sheep'],
    VotingSystem.Schulze,
  )
  // -> { Lion: 0, Bear: 2, Sheep: 1 }
  const ranking = scoresToRanking({ Bear: 2, Lion: 0, Sheep: 1 })
  // -> [ [ 'Bear' ], [ 'Sheep' ], [ 'Lion' ] ]

  New:

  import { Borda } from 'votes'
  
  const borda = new Borda({
    candidates: ['Lion', 'Bear', 'Sheep'],
    ballots: [
      { ranking: [['Lion'], ['Bear'], ['Sheep']], weight: 4 },
      { ranking: [['Sheep'], ['Bear'], ['Lion']], weight: 3 },
      { ranking: [['Bear', 'Sheep'], ['Lion']], weight: 2 },
    ],
  })
  const scores = borda.scores()
  // -> { Bear: 10, Lion: 8, Sheep: 9}
  const ranking = borda.ranking()
  // -> [ [ 'Bear' ], [ 'Sheep' ], [ 'Lion' ] ]

  Monorepo

  The repository now also contains the code for a demo, which will be hosted on www.rank-votes.vercel.app

  Back to classes

  My implementation of the voting systems keep on alternating between classes and some attempts of object composition. This time it was refactored to classes.

  Added systems

  • Random candidate: Selects a random ranking, regardless of ballots.

  • Random dictator: Selects a random ballot that decides the ranking.

  • Bottom-two-runoff: take the two options with the fewest first preference votes. The pairwise loser out of those two options is eliminated. Repeat.

Full Changelog: v1.8.4...v2.0.2