@jjlmoya/utils-civic 1.2.0 → 1.4.0

package/src/tool/referendum-threshold-calculator/storage.ts

@@ -0,0 +1,39 @@
+import type { ReferendumInput } from './logic';
+
+const STORAGE_KEY = 'jjlmoya-civic-referendum-threshold-v1';
+
+function hasStorage(): boolean {
+  return typeof window !== 'undefined' && typeof window.localStorage !== 'undefined';
+}
+
+function isSavedInput(value: unknown): value is ReferendumInput {
+  if (!value || typeof value !== 'object') return false;
+  const candidate = value as Record<string, unknown>;
+  return Boolean(candidate.counts && candidate.rules);
+}
+
+export function loadSavedInput(): ReferendumInput | null {
+  if (!hasStorage()) return null;
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed: unknown = JSON.parse(raw);
+    return isSavedInput(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+export function saveInput(input: ReferendumInput): void {
+  if (!hasStorage()) return;
+  try {
+    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(input));
+  } catch {}
+}
+
+export function clearSavedInput(): void {
+  if (!hasStorage()) return;
+  try {
+    window.localStorage.removeItem(STORAGE_KEY);
+  } catch {}
+}

package/src/tool/referendum-threshold-calculator/ui.ts

@@ -0,0 +1,126 @@
+export interface ReferendumThresholdUI {
+  [key: string]: string;
+  countsHeading: string;
+  eligibleLabel: string;
+  eligibleHelp: string;
+  yesLabel: string;
+  noLabel: string;
+  blankLabel: string;
+  invalidLabel: string;
+  participationHeading: string;
+  participationHelp: string;
+  approvalHeading: string;
+  approvalHelp: string;
+  thresholdModeLabel: string;
+  comparisonLabel: string;
+  atLeastOption: string;
+  moreThanOption: string;
+  percentageOption: string;
+  absoluteOption: string;
+  thresholdValueLabel: string;
+  denominatorLabel: string;
+  allBallotsOption: string;
+  validVotesOption: string;
+  eligibleVotersOption: string;
+  presetsLabel: string;
+  simpleMajorityPreset: string;
+  electorateMajorityPreset: string;
+  qualified55Preset: string;
+  qualified60Preset: string;
+  loadExample: string;
+  shareAction: string;
+  shareSuccess: string;
+  shareFailure: string;
+  resultHeading: string;
+  emptyResult: string;
+  passed: string;
+  participationFailed: string;
+  approvalFailed: string;
+  bothFailed: string;
+  invalidResult: string;
+  participationMetric: string;
+  approvalMetric: string;
+  observedLabel: string;
+  thresholdLabel: string;
+  decisionPathLabel: string;
+  methodHeading: string;
+  methodText: string;
+  limitsHeading: string;
+  limitsText: string;
+  warningsHeading: string;
+  warningsText: string;
+  invalidInput: string;
+  ballotsExceedEligible: string;
+  noValidVotes: string;
+  noBallots: string;
+  peopleSuffix: string;
+  yesShareLabel: string;
+  allBallotsLabel: string;
+  validVotesLabel: string;
+  eligibleVotersLabel: string;
+  whatNextLabel: string;
+  whatNextText: string;
+}
+
+export const ui: ReferendumThresholdUI = {
+  countsHeading: 'Enter the declared vote counts',
+  eligibleLabel: 'Eligible or registered voters',
+  eligibleHelp: 'Use the electorate denominator named by the rule you are checking.',
+  yesLabel: 'Yes votes',
+  noLabel: 'No votes',
+  blankLabel: 'Blank votes',
+  invalidLabel: 'Invalid votes',
+  participationHeading: 'Participation quorum',
+  participationHelp: 'Choose what counts as participation and the threshold it must reach.',
+  approvalHeading: 'Approval quorum',
+  approvalHelp: 'Choose the denominator for the Yes threshold. Every rule stays visible in the result.',
+  thresholdModeLabel: 'Threshold type',
+  comparisonLabel: 'Comparison',
+  atLeastOption: 'At least',
+  moreThanOption: 'More than',
+  percentageOption: 'Percentage',
+  absoluteOption: 'Absolute number',
+  thresholdValueLabel: 'Threshold value',
+  denominatorLabel: 'Count used',
+  allBallotsOption: 'All ballots',
+  validVotesOption: 'Valid votes only',
+  eligibleVotersOption: 'Eligible voters',
+  presetsLabel: 'Approval presets',
+  simpleMajorityPreset: 'Simple majority',
+  electorateMajorityPreset: 'Electorate majority',
+  qualified55Preset: 'Qualified 55%',
+  qualified60Preset: 'Qualified 60%',
+  loadExample: 'Load example',
+  shareAction: 'Copy permalink',
+  shareSuccess: 'Permalink copied. It contains the counts and both declared rules.',
+  shareFailure: 'The permalink is in the address bar. Copy it when you are ready to share.',
+  resultHeading: 'Declared rule decision',
+  emptyResult: 'Enter counts and thresholds to see the two quorum tests.',
+  passed: 'Both thresholds pass',
+  participationFailed: 'Participation quorum fails',
+  approvalFailed: 'Approval quorum fails',
+  bothFailed: 'Both thresholds fail',
+  invalidResult: 'Check the declared counts',
+  participationMetric: 'Participation test',
+  approvalMetric: 'Approval test',
+  observedLabel: 'Observed',
+  thresholdLabel: 'Required',
+  decisionPathLabel: 'Decision path',
+  methodHeading: 'Method applied',
+  methodText: 'Participation is the selected ballot count divided by eligible voters. Approval is Yes divided by the selected approval denominator. The comparison control decides whether an exact percentage passes or the observed value must be greater. Absolute thresholds compare counts directly.',
+  limitsHeading: 'What this tool does not do',
+  limitsText: 'It does not identify the competent authority, determine a statutory deadline, guarantee disclosure, reproduce an official count, file a referendum, or provide legal advice. The rule is only as valid as the assumptions you enter.',
+  warningsHeading: 'Edge cases and data warnings',
+  warningsText: 'Broad or mixed ballot definitions can change the result. Check whether blanks and invalid ballots belong in the participation count, whether the electorate is current, and whether the jurisdiction defines approval against valid votes or all ballots.',
+  invalidInput: 'Use whole, nonnegative counts. Eligible voters must be greater than zero and the ballot total cannot exceed the electorate.',
+  ballotsExceedEligible: 'The declared ballots exceed the eligible electorate.',
+  noValidVotes: 'There are no Yes or No votes, so the approval percentage has no valid vote denominator.',
+  noBallots: 'No ballots were declared, so participation and approval cannot pass unless the chosen rules have a zero threshold.',
+  peopleSuffix: 'people',
+  yesShareLabel: 'Yes share',
+  allBallotsLabel: 'all ballots',
+  validVotesLabel: 'valid votes',
+  eligibleVotersLabel: 'eligible voters',
+  whatNextLabel: 'Before you rely on the result',
+  whatNextText: 'Copy the exact rule wording and ballot definitions from the applicable official source, then compare them with the configuration shown here.',
+};

package/src/tools.ts

@@ -1,9 +1,13 @@
 export { ALL_ENTRIES } from './entries';
 import type { ToolDefinition } from './types';
+import { COALITION_MAJORITY_CALCULATOR_TOOL } from './tool/coalition-majority-calculator';
 import { ELECTION_SEAT_APPORTIONMENT_CALCULATOR_TOOL } from './tool/election-seat-apportionment-calculator';
+import { REFERENDUM_THRESHOLD_CALCULATOR_TOOL } from './tool/referendum-threshold-calculator';
 import { VOTE_SEAT_DISPROPORTIONALITY_ANALYZER_TOOL } from './tool/vote-seat-disproportionality-analyzer';
 
 export const ALL_TOOLS: ToolDefinition[] = [
+  COALITION_MAJORITY_CALCULATOR_TOOL,
   ELECTION_SEAT_APPORTIONMENT_CALCULATOR_TOOL,
+  REFERENDUM_THRESHOLD_CALCULATOR_TOOL,
   VOTE_SEAT_DISPROPORTIONALITY_ANALYZER_TOOL,
 ];