@jjlmoya/utils-civic 1.2.0 → 1.4.0

package/src/tool/referendum-threshold-calculator/referendum-threshold-calculator.css

@@ -0,0 +1,640 @@
+:root {
+  --n-ink: #1f2933;
+  --n-muted: #667085;
+  --n-paper: #f6f1e7;
+  --n-card: #fffdf8;
+  --n-line: #d8cfc0;
+  --n-accent: #b54a35;
+  --n-accent-soft: #f1d8cf;
+  --n-teal: #166b68;
+  --n-teal-soft: #d4ebe5;
+  --n-warn: #965b19;
+  --n-danger: #9c3030;
+}
+
+.theme-dark {
+  --n-ink: #f5efe5;
+  --n-muted: #b6b0a6;
+  --n-paper: #17191a;
+  --n-card: #232526;
+  --n-line: #49433b;
+  --n-accent: #ed8065;
+  --n-accent-soft: #512e27;
+  --n-teal: #75c5bd;
+  --n-teal-soft: #1e4543;
+  --n-warn: #edb66c;
+  --n-danger: #f08787;
+}
+
+.referendum-tool {
+  --n-tool-bg: var(--n-paper);
+  --n-tool-card: var(--n-card);
+  --n-tool-ink: var(--n-ink);
+  --n-tool-muted: var(--n-muted);
+  --n-tool-line: var(--n-line);
+  --n-tool-accent: var(--n-accent);
+  --n-tool-accent-soft: var(--n-accent-soft);
+  --n-tool-teal: var(--n-teal);
+  --n-tool-teal-soft: var(--n-teal-soft);
+  --n-tool-warn: var(--n-warn);
+  --n-tool-danger: var(--n-danger);
+
+  color: var(--n-tool-ink);
+  background: var(--n-tool-bg);
+  border: 1px solid var(--n-tool-line);
+  border-radius: 24px;
+  padding: clamp(1rem, 3vw, 2rem);
+}
+
+.rule-workbench {
+  display: grid;
+  grid-template-columns: minmax(0, 1.02fr) minmax(0, 0.98fr);
+  gap: 1px;
+  background: var(--n-tool-line);
+  border: 1px solid var(--n-tool-line);
+}
+
+.rule-form,
+.decision-panel {
+  min-width: 0;
+  background: var(--n-tool-card);
+  padding: clamp(1rem, 2.5vw, 1.75rem);
+}
+
+fieldset {
+  min-width: 0;
+  margin: 0;
+  border: 0;
+  padding: 0;
+}
+
+legend,
+.panel-heading h2,
+.guardrails h2 {
+  color: var(--n-tool-ink);
+  font-size: 1rem;
+  font-weight: 800;
+  letter-spacing: -0.02em;
+}
+
+legend {
+  padding: 0;
+}
+
+.count-block {
+  padding-bottom: 1.5rem;
+  border-bottom: 1px solid var(--n-tool-line);
+}
+
+label,
+.field-label {
+  display: grid;
+  gap: 0.4rem;
+  color: var(--n-tool-muted);
+  font-size: 0.78rem;
+  font-weight: 700;
+}
+
+input,
+[data-select-trigger] {
+  width: 100%;
+  min-height: 2.8rem;
+  border: 1px solid var(--n-tool-line);
+  border-radius: 10px;
+  padding: 0.65rem 0.75rem;
+  color: var(--n-tool-ink);
+  background: var(--n-tool-bg);
+  font: inherit;
+}
+
+input:focus,
+button:focus-visible {
+  outline: 3px solid var(--n-tool-accent-soft);
+  outline-offset: 2px;
+}
+
+small,
+.quorum-block p,
+.guardrails p,
+.decision-banner p,
+.next-step p {
+  color: var(--n-tool-muted);
+  font-size: 0.78rem;
+  line-height: 1.5;
+}
+
+small {
+  font-weight: 500;
+}
+
+.wide-field {
+  margin-top: 1rem;
+}
+
+.count-grid,
+.quorum-fields {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 0.8rem;
+  margin-top: 0.8rem;
+}
+
+.quorum-block {
+  padding: 1.35rem 0;
+  border-bottom: 1px solid var(--n-tool-line);
+}
+
+.quorum-block p {
+  margin: 0.45rem 0 0.9rem;
+}
+
+.approval-block {
+  border-bottom: 0;
+}
+
+.mode-switch {
+  display: inline-grid;
+  grid-template-columns: 1fr 1fr;
+  border: 1px solid var(--n-tool-line);
+  border-radius: 10px;
+  overflow: hidden;
+}
+
+button {
+  border: 0;
+  cursor: pointer;
+  font: inherit;
+}
+
+.mode-switch button {
+  min-height: 2.35rem;
+  padding: 0 0.8rem;
+  color: var(--n-tool-muted);
+  background: var(--n-tool-bg);
+  font-size: 0.75rem;
+  font-weight: 800;
+}
+
+.mode-switch button + button {
+  border-left: 1px solid var(--n-tool-line);
+}
+
+.mode-switch button.active {
+  color: var(--n-tool-card);
+  background: var(--n-tool-teal);
+}
+
+.comparison-row,
+.preset-row {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  flex-wrap: wrap;
+  margin-top: 0.8rem;
+}
+
+.comparison-row > span,
+.preset-row > span {
+  width: 100%;
+  color: var(--n-tool-muted);
+  font-size: 0.7rem;
+  font-weight: 800;
+}
+
+.comparison-row button,
+.preset-row button,
+.share-action {
+  min-height: 2.2rem;
+  border: 1px solid var(--n-tool-line);
+  border-radius: 8px;
+  padding: 0.45rem 0.65rem;
+  color: var(--n-tool-muted);
+  background: var(--n-tool-bg);
+  font-size: 0.7rem;
+  font-weight: 800;
+}
+
+.comparison-row button.active,
+.preset-row button:hover,
+.share-action:hover {
+  border-color: var(--n-tool-teal);
+  color: var(--n-tool-teal);
+  background: var(--n-tool-teal-soft);
+}
+
+.preset-row {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.preset-row > span {
+  grid-column: 1 / -1;
+}
+
+.custom-select {
+  position: relative;
+}
+
+[data-select-trigger] {
+  margin-top: 0.4rem;
+  cursor: pointer;
+  text-align: left;
+  font-size: 0.82rem;
+  font-weight: 700;
+}
+
+.select-menu {
+  position: absolute;
+  z-index: 3;
+  top: 100%;
+  right: 0;
+  left: 0;
+  display: grid;
+  gap: 2px;
+  margin-top: 0.35rem;
+  padding: 0.35rem;
+  border: 1px solid var(--n-tool-line);
+  border-radius: 10px;
+  background: var(--n-tool-card);
+  box-shadow: 0 10px 24px var(--n-tool-accent-soft);
+}
+
+.select-menu[hidden],
+.result-content[hidden],
+.empty-result[hidden] {
+  display: none;
+}
+
+.select-menu button {
+  padding: 0.65rem;
+  border-radius: 7px;
+  color: var(--n-tool-ink);
+  background: var(--n-tool-card);
+  text-align: left;
+  font-size: 0.78rem;
+}
+
+.select-menu button:hover {
+  background: var(--n-tool-accent-soft);
+}
+
+.form-actions {
+  display: flex;
+  gap: 0.7rem;
+  flex-wrap: wrap;
+}
+
+.primary-action,
+.secondary-action {
+  min-height: 2.75rem;
+  border-radius: 10px;
+  padding: 0.7rem 1rem;
+  font-size: 0.8rem;
+  font-weight: 800;
+}
+
+.primary-action {
+  color: var(--n-tool-card);
+  background: var(--n-tool-accent);
+}
+
+.secondary-action {
+  color: var(--n-tool-accent);
+  background: var(--n-tool-accent-soft);
+}
+
+.share-action {
+  color: var(--n-tool-teal);
+  background: var(--n-tool-teal-soft);
+}
+
+.tool-status {
+  min-height: 1.2rem;
+  margin: 0.7rem 0 0;
+  color: var(--n-tool-danger);
+  font-size: 0.75rem;
+  font-weight: 700;
+}
+
+.decision-panel {
+  background: var(--n-tool-bg);
+}
+
+.panel-heading {
+  display: flex;
+  align-items: center;
+  gap: 0.65rem;
+}
+
+.panel-heading h2 {
+  margin: 0;
+}
+
+.panel-index,
+.guardrail-mark {
+  color: var(--n-tool-accent);
+  font-size: 0.68rem;
+  font-weight: 900;
+  letter-spacing: 0.08em;
+}
+
+.decision-scene {
+  margin: 1.4rem 0;
+  padding: 1rem;
+  border: 1px solid var(--n-tool-line);
+  background: var(--n-tool-card);
+}
+
+.ballot-path {
+  display: grid;
+  gap: 0.8rem;
+}
+
+.ballot-mark {
+  display: flex;
+  align-items: center;
+  gap: 0.7rem;
+  color: var(--n-tool-teal);
+  font-size: 0.82rem;
+  font-weight: 800;
+}
+
+.ballot-check,
+.decision-seal {
+  display: grid;
+  place-items: center;
+  width: 2rem;
+  height: 2rem;
+  border: 2px solid currentcolor;
+  border-radius: 50%;
+  font-size: 1rem;
+}
+
+.path-line {
+  width: 2px;
+  height: 1rem;
+  margin-left: 1rem;
+  background: var(--n-tool-accent);
+}
+
+.gate-stack {
+  display: grid;
+  gap: 0.8rem;
+}
+
+.quorum-gate {
+  padding: 0.7rem;
+  border-left: 3px solid var(--n-tool-warn);
+  background: var(--n-tool-accent-soft);
+}
+
+.quorum-gate.pass {
+  border-left-color: var(--n-tool-teal);
+  background: var(--n-tool-teal-soft);
+}
+
+.gate-top,
+.gate-bottom,
+.metric-card-head,
+.totals-strip {
+  display: flex;
+  justify-content: space-between;
+  gap: 0.7rem;
+}
+
+.gate-top {
+  color: var(--n-tool-ink);
+  font-size: 0.77rem;
+  font-weight: 800;
+}
+
+.gate-track {
+  position: relative;
+  height: 0.5rem;
+  margin: 0.6rem 0 0.45rem;
+  background: var(--n-tool-card);
+}
+
+.gate-track span {
+  display: block;
+  height: 100%;
+  background: var(--n-tool-accent);
+}
+
+.quorum-gate.pass .gate-track span {
+  background: var(--n-tool-teal);
+}
+
+.gate-track i {
+  position: absolute;
+  top: -0.2rem;
+  width: 2px;
+  height: 0.9rem;
+  background: var(--n-tool-ink);
+}
+
+.gate-bottom {
+  color: var(--n-tool-muted);
+  font-size: 0.68rem;
+}
+
+.empty-result {
+  display: grid;
+  min-height: 8rem;
+  place-items: center;
+  border: 1px dashed var(--n-tool-line);
+  padding: 1rem;
+  color: var(--n-tool-muted);
+  text-align: center;
+  font-size: 0.8rem;
+}
+
+.decision-banner {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  padding: 0.9rem;
+  border-left: 3px solid var(--n-tool-warn);
+  background: var(--n-tool-accent-soft);
+}
+
+.decision-banner.positive {
+  border-left-color: var(--n-tool-teal);
+  background: var(--n-tool-teal-soft);
+}
+
+.decision-banner.danger {
+  border-left-color: var(--n-tool-danger);
+}
+
+.decision-seal {
+  flex: 0 0 auto;
+  color: var(--n-tool-accent);
+}
+
+.decision-banner strong {
+  font-size: 0.88rem;
+}
+
+.decision-banner p {
+  margin: 0.25rem 0 0;
+}
+
+.metric-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 0.65rem;
+  margin-top: 0.8rem;
+}
+
+.metric-card {
+  min-width: 0;
+  border: 1px solid var(--n-tool-line);
+  padding: 0.8rem;
+  background: var(--n-tool-card);
+}
+
+.metric-card-head {
+  align-items: flex-start;
+  color: var(--n-tool-muted);
+  font-size: 0.7rem;
+  font-weight: 800;
+}
+
+.metric-state {
+  font-size: 0.62rem;
+}
+
+.metric-state.pass {
+  color: var(--n-tool-teal);
+}
+
+.metric-state.fail {
+  color: var(--n-tool-danger);
+}
+
+.metric-card > strong {
+  display: block;
+  margin: 0.55rem 0;
+  color: var(--n-tool-ink);
+  font-size: clamp(1.4rem, 4vw, 2.2rem);
+  line-height: 1;
+}
+
+dl {
+  display: grid;
+  gap: 0.35rem;
+  margin: 0;
+}
+
+dl div {
+  display: flex;
+  justify-content: space-between;
+  gap: 0.5rem;
+  border-top: 1px solid var(--n-tool-line);
+  padding-top: 0.35rem;
+}
+
+dt,
+dd {
+  color: var(--n-tool-muted);
+  font-size: 0.65rem;
+}
+
+dd {
+  margin: 0;
+  color: var(--n-tool-ink);
+  font-weight: 700;
+  text-align: right;
+}
+
+.totals-strip {
+  flex-wrap: wrap;
+  margin-top: 0.8rem;
+  border-top: 1px solid var(--n-tool-line);
+  border-bottom: 1px solid var(--n-tool-line);
+  padding: 0.65rem 0;
+  color: var(--n-tool-muted);
+  font-size: 0.65rem;
+}
+
+.totals-strip b {
+  color: var(--n-tool-ink);
+}
+
+.warning-list,
+.next-step,
+.inline-message {
+  margin-top: 0.8rem;
+  border: 1px solid var(--n-tool-line);
+  padding: 0.75rem;
+  color: var(--n-tool-muted);
+  font-size: 0.7rem;
+  line-height: 1.45;
+}
+
+.warning-list strong,
+.next-step strong {
+  color: var(--n-tool-ink);
+}
+
+.warning-list ul {
+  margin: 0.4rem 0 0;
+  padding-left: 1rem;
+}
+
+.next-step {
+  background: var(--n-tool-teal-soft);
+}
+
+.next-step p {
+  margin: 0.3rem 0 0;
+}
+
+.inline-message.danger {
+  border-color: var(--n-tool-danger);
+  color: var(--n-tool-danger);
+}
+
+.guardrails {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 1px;
+  margin-top: 1px;
+  background: var(--n-tool-line);
+  border: 1px solid var(--n-tool-line);
+}
+
+.guardrails article {
+  min-width: 0;
+  padding: 1rem;
+  background: var(--n-tool-card);
+}
+
+.guardrails h2 {
+  margin: 0.45rem 0 0;
+  font-size: 0.8rem;
+}
+
+.guardrails p {
+  margin: 0.5rem 0 0;
+}
+
+@media (max-width: 780px) {
+  .rule-workbench,
+  .guardrails {
+    grid-template-columns: 1fr;
+  }
+}
+
+@media (max-width: 460px) {
+  .count-grid,
+  .quorum-fields,
+  .metric-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .form-actions > button {
+    flex: 1 1 100%;
+  }
+}

package/src/tool/referendum-threshold-calculator/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { referendumThresholdCalculator } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props as Props;
+const content = await referendumThresholdCalculator.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/referendum-threshold-calculator/sharing.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { buildShareUrl, readShareUrl } from './sharing';
+import { getExampleInput } from './logic';
+
+describe('referendum sharing', () => {
+  it('round trips counts and both declared rules', () => {
+    const input = getExampleInput();
+    input.rules.approval = { mode: 'percentage', value: 55, denominator: 'eligible-voters', comparison: 'more-than' };
+    const url = buildShareUrl('https://gamebob.dev/en/referendum-threshold-calculator?view=review', input);
+    expect(readShareUrl(url)).toEqual(input);
+  });
+
+  it('preserves the page route and unrelated parameters', () => {
+    const url = buildShareUrl('https://gamebob.dev/en/referendum-threshold-calculator?view=review', getExampleInput());
+    expect(url).toContain('/en/referendum-threshold-calculator');
+    expect(url).toContain('view=review');
+  });
+
+  it('rejects malformed or incomplete state', () => {
+    expect(readShareUrl('https://gamebob.dev/en/referendum-threshold-calculator?state=nope')).toBeNull();
+    expect(readShareUrl('https://gamebob.dev/en/referendum-threshold-calculator?state=%7B%7D')).toBeNull();
+  });
+});

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

@@ -0,0 +1,42 @@
+import type { ReferendumInput, ThresholdComparison, ThresholdMode, DenominatorMode } from './logic';
+
+const STATE_PARAMETER = 'state';
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value && typeof value === 'object');
+}
+
+function isCounts(value: unknown): boolean {
+  if (!isRecord(value)) return false;
+  return ['eligibleVoters', 'yes', 'no', 'blank', 'invalid'].every((key) => typeof value[key] === 'number');
+}
+
+function isRule(value: unknown): boolean {
+  if (!isRecord(value)) return false;
+  const mode = value.mode as ThresholdMode;
+  const denominator = value.denominator as DenominatorMode;
+  const comparison = value.comparison as ThresholdComparison | undefined;
+  return typeof value.value === 'number' && (mode === 'percentage' || mode === 'absolute') && ['all-ballots', 'valid-votes', 'eligible-voters'].includes(denominator) && (comparison === undefined || comparison === 'at-least' || comparison === 'more-than');
+}
+
+function isReferendumInput(value: unknown): value is ReferendumInput {
+  if (!isRecord(value) || !isCounts(value.counts) || !isRecord(value.rules)) return false;
+  return isRule(value.rules.participation) && isRule(value.rules.approval);
+}
+
+export function buildShareUrl(currentUrl: string, input: ReferendumInput): string {
+  const url = new URL(currentUrl);
+  url.searchParams.set(STATE_PARAMETER, JSON.stringify(input));
+  return url.toString();
+}
+
+export function readShareUrl(currentUrl: string): ReferendumInput | null {
+  try {
+    const encoded = new URL(currentUrl).searchParams.get(STATE_PARAMETER);
+    if (!encoded) return null;
+    const parsed: unknown = JSON.parse(encoded);
+    return isReferendumInput(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}