@jjlmoya/utils-civic 1.6.0 → 1.8.0

package/src/tool/parliamentary-voting-analyzer/parliamentary-voting-analyzer.css

@@ -0,0 +1,491 @@
+.parliamentary-voting-analyzer {
+  --n-paper: #f6f1e8;
+  --n-surface: #fffdf8;
+  --n-surface-soft: #eee8dc;
+  --n-ink: #162737;
+  --n-muted: #607180;
+  --n-line: #c9c0b1;
+  --n-blue: #1b648a;
+  --n-blue-soft: #cce5ed;
+  --n-rust: #b55038;
+  --n-rust-soft: #f0d2c8;
+  --n-quiet: #9ba6a9;
+  --n-shadow: #1627371a;
+
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: 1.25rem;
+  box-shadow: 0 1rem 2rem var(--n-shadow);
+  color: var(--n-ink);
+  display: grid;
+  gap: 1rem;
+  padding: clamp(1rem, 3vw, 2rem);
+}
+
+.theme-dark .parliamentary-voting-analyzer {
+  --n-paper: #172129;
+  --n-surface: #202d36;
+  --n-surface-soft: #2b3a43;
+  --n-ink: #f2eee5;
+  --n-muted: #b8c2c3;
+  --n-line: #52636a;
+  --n-blue: #76c4df;
+  --n-blue-soft: #214b5d;
+  --n-rust: #ef9475;
+  --n-rust-soft: #5a3028;
+  --n-quiet: #839397;
+  --n-shadow: #00000040;
+}
+
+.pv-input-zone,
+.pv-mode-zone,
+.pv-result,
+.pv-note-zone {
+  background: var(--n-surface);
+  border: 1px solid var(--n-line);
+  border-radius: .9rem;
+}
+
+.pv-input-zone {
+  display: grid;
+  gap: .75rem;
+  padding: clamp(1rem, 3vw, 1.5rem);
+}
+
+.pv-input-copy {
+  display: grid;
+  gap: .35rem;
+  max-width: 50rem;
+}
+
+.pv-input-copy p,
+.pv-mode-zone p,
+.pv-result p,
+.pv-note-zone p {
+  color: var(--n-muted);
+  line-height: 1.55;
+  margin: 0;
+}
+
+.pv-input-copy .pv-eyebrow,
+.pv-result .pv-eyebrow {
+  color: var(--n-rust);
+  font-size: .72rem;
+  font-weight: 800;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+}
+
+.pv-field-label {
+  font-size: .84rem;
+  font-weight: 750;
+  margin-top: .35rem;
+}
+
+.pv-csv-hint {
+  color: var(--n-muted);
+  font-size: .78rem;
+  margin: -.25rem 0 0;
+}
+
+.parliamentary-voting-analyzer textarea {
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: .6rem;
+  box-sizing: border-box;
+  color: var(--n-ink);
+  font: .86rem/1.55 ui-monospace, SFMono-Regular, Consolas, monospace;
+  min-height: 10rem;
+  padding: .85rem;
+  resize: vertical;
+  width: 100%;
+}
+
+.parliamentary-voting-analyzer textarea:focus,
+.parliamentary-voting-analyzer button:focus-visible,
+.parliamentary-voting-analyzer input:focus-visible {
+  outline: 3px solid var(--n-blue-soft);
+  outline-offset: 2px;
+}
+
+.pv-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .55rem;
+}
+
+.parliamentary-voting-analyzer button {
+  border: 1px solid var(--n-line);
+  border-radius: 999px;
+  cursor: pointer;
+  font: inherit;
+  font-size: .82rem;
+  font-weight: 750;
+  min-height: 2.7rem;
+  padding: .55rem 1rem;
+}
+
+.pv-primary-action {
+  background: var(--n-blue);
+  border-color: var(--n-blue);
+  color: var(--n-surface);
+}
+
+.pv-secondary-action,
+.pv-quiet-action {
+  background: var(--n-surface-soft);
+  color: var(--n-ink);
+}
+
+.pv-quiet-action {
+  min-height: 2.35rem;
+  padding: .4rem .75rem;
+}
+
+.pv-feedback {
+  font-size: .8rem;
+  min-height: 1.2rem;
+}
+
+.pv-mode-zone {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 1.4rem;
+  justify-content: space-between;
+  padding: .9rem 1.2rem;
+}
+
+.parliamentary-voting-analyzer fieldset {
+  border: 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: .65rem 1rem;
+  margin: 0;
+  padding: 0;
+}
+
+.parliamentary-voting-analyzer legend {
+  color: var(--n-muted);
+  font-size: .72rem;
+  font-weight: 800;
+  letter-spacing: .08em;
+  margin-bottom: .45rem;
+  text-transform: uppercase;
+}
+
+.parliamentary-voting-analyzer fieldset label {
+  align-items: center;
+  display: inline-flex;
+  font-size: .84rem;
+  gap: .35rem;
+}
+
+.parliamentary-voting-analyzer input[type='radio'] {
+  accent-color: var(--n-blue);
+  block-size: 1rem;
+  inline-size: 1rem;
+}
+
+.pv-method-strip {
+  align-items: center;
+  color: var(--n-muted);
+  display: flex;
+  font-size: .78rem;
+  gap: .55rem;
+  max-width: 33rem;
+}
+
+.pv-method-line {
+  background: var(--n-rust);
+  block-size: 2px;
+  display: block;
+  inline-size: 2.5rem;
+}
+
+.pv-empty {
+  align-items: center;
+  background: var(--n-surface-soft);
+  border-radius: .9rem;
+  color: var(--n-muted);
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  min-height: 11rem;
+  padding: 1.25rem;
+  text-align: center;
+}
+
+.pv-empty-mark {
+  border: 2px solid var(--n-blue);
+  border-radius: 50%;
+  block-size: 3.2rem;
+  inline-size: 3.2rem;
+  position: relative;
+}
+
+.pv-empty-mark::before,
+.pv-empty-mark::after {
+  background: var(--n-rust);
+  content: '';
+  inset: 50% auto auto 50%;
+  position: absolute;
+  transform: translate(-50%, -50%);
+}
+
+.pv-empty-mark::before {
+  block-size: 1px;
+  inline-size: 2rem;
+}
+
+.pv-empty-mark::after {
+  block-size: 2rem;
+  inline-size: 1px;
+}
+
+.pv-result {
+  display: grid;
+  gap: 1.1rem;
+  padding: clamp(1rem, 3vw, 1.5rem);
+}
+
+.pv-result-intro,
+.pv-ribbon-head,
+.pv-ribbon-row,
+.pv-summary-line {
+  align-items: center;
+  display: grid;
+  gap: .75rem;
+  grid-template-columns: minmax(7rem, 1fr) auto;
+}
+
+.pv-result-intro {
+  grid-template-columns: 1fr auto;
+}
+
+.pv-countline {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .7rem;
+}
+
+.pv-countline strong {
+  color: var(--n-ink);
+  font-size: 1.1rem;
+}
+
+.pv-ribbon {
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: .65rem;
+  overflow-x: auto;
+  padding: 1rem;
+}
+
+.pv-ribbon-head {
+  color: var(--n-muted);
+  font-size: .68rem;
+  font-weight: 800;
+  letter-spacing: .08em;
+  margin-bottom: .7rem;
+  text-transform: uppercase;
+}
+
+.pv-ribbon-votes {
+  display: flex;
+  gap: .45rem;
+  justify-content: flex-start;
+  min-width: 16rem;
+}
+
+.pv-ribbon-votes span {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  width: 2.2rem;
+}
+
+.pv-ribbon-row {
+  grid-template-columns: minmax(7rem, 1fr) minmax(16rem, 3fr) 4.5rem;
+  min-width: 29rem;
+  padding: .35rem 0;
+}
+
+.pv-ribbon-name {
+  font-size: .82rem;
+  font-weight: 750;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.pv-ribbon-track {
+  display: flex;
+  gap: .45rem;
+}
+
+.pv-ribbon-cell {
+  background: var(--n-quiet);
+  border-radius: .25rem;
+  display: block;
+  height: 1.25rem;
+  min-width: 2.2rem;
+}
+
+.pv-ribbon-cell.is-yes,
+.pv-dot.is-yes {
+  background: var(--n-blue);
+}
+
+.pv-ribbon-cell.is-no,
+.pv-dot.is-no {
+  background: var(--n-rust);
+}
+
+.pv-ribbon-cell.is-abstain,
+.pv-dot.is-abstain {
+  background: transparent;
+  border: 2px solid var(--n-rust);
+}
+
+.pv-ribbon-cell.is-tie {
+  background: var(--n-surface-soft);
+  border: 2px dashed var(--n-rust);
+}
+
+.pv-ribbon-cell.is-missing {
+  background: transparent;
+  border: 1px dashed var(--n-line);
+}
+
+.pv-ribbon-score {
+  font-size: .86rem;
+  font-variant-numeric: tabular-nums;
+  font-weight: 800;
+  text-align: right;
+}
+
+.pv-legend {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .45rem .75rem;
+  font-size: .75rem;
+}
+
+.pv-dot {
+  border-radius: 50%;
+  display: inline-block;
+  height: .7rem;
+  margin-right: -.3rem;
+  width: .7rem;
+}
+
+.pv-result-detail,
+.pv-note-zone {
+  display: grid;
+  gap: 1.2rem;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.pv-result-detail h3,
+.pv-note-zone h3 {
+  color: var(--n-ink);
+  font-size: 1rem;
+  margin: 0 0 .35rem;
+}
+
+.pv-result-detail > div,
+.pv-note-zone > div {
+  border-top: 2px solid var(--n-line);
+  padding-top: .8rem;
+}
+
+.pv-summary-list {
+  display: grid;
+  gap: .3rem;
+  margin-top: .9rem;
+}
+
+.pv-summary-line {
+  border-bottom: 1px solid var(--n-line);
+  font-size: .76rem;
+  grid-template-columns: 1.2fr .8fr 1fr;
+  padding: .45rem 0;
+}
+
+.pv-summary-line span:last-child {
+  color: var(--n-muted);
+  grid-column: 1 / -1;
+}
+
+.pv-table-wrap {
+  margin-top: .9rem;
+  max-height: 13rem;
+  overflow: auto;
+}
+
+.parliamentary-voting-analyzer table {
+  border-collapse: collapse;
+  font-size: .76rem;
+  min-width: 100%;
+}
+
+.parliamentary-voting-analyzer th,
+.parliamentary-voting-analyzer td {
+  border-bottom: 1px solid var(--n-line);
+  padding: .5rem .4rem;
+  text-align: left;
+}
+
+.parliamentary-voting-analyzer th {
+  color: var(--n-muted);
+  font-size: .68rem;
+  letter-spacing: .04em;
+  text-transform: uppercase;
+}
+
+.pv-warnings {
+  background: var(--n-rust-soft);
+  border-left: 3px solid var(--n-rust);
+  padding: .75rem 1rem;
+}
+
+.pv-warnings h3 {
+  color: var(--n-ink);
+  font-size: .85rem;
+  margin: 0 0 .35rem;
+}
+
+.pv-warnings ul {
+  color: var(--n-ink);
+  font-size: .8rem;
+  line-height: 1.5;
+  margin: 0;
+  padding-left: 1.1rem;
+}
+
+.pv-note-zone {
+  padding: 1rem 1.2rem;
+}
+
+@media (max-width: 42rem) {
+  .parliamentary-voting-analyzer {
+    border-radius: .8rem;
+    padding: .75rem;
+  }
+
+  .pv-result-detail,
+  .pv-note-zone {
+    grid-template-columns: 1fr;
+  }
+
+  .pv-result-intro {
+    align-items: start;
+    grid-template-columns: 1fr;
+  }
+
+  .pv-mode-zone {
+    align-items: start;
+    display: grid;
+    gap: .8rem;
+  }
+}

package/src/tool/parliamentary-voting-analyzer/seo.astro

@@ -0,0 +1,14 @@
+---
+import SEORenderer from '@jjlmoya/utils-shared/seo/SEORenderer.astro';
+import { parliamentaryVotingAnalyzer } from './entry';
+
+interface Props {
+  locale?: string;
+}
+
+const { locale = 'en' } = Astro.props;
+const loader = parliamentaryVotingAnalyzer.i18n[locale as keyof typeof parliamentaryVotingAnalyzer.i18n] ?? parliamentaryVotingAnalyzer.i18n.en;
+const content = await loader!();
+---
+
+<SEORenderer content={{ locale, sections: content.seo }} />

package/src/tool/parliamentary-voting-analyzer/storage.ts

@@ -0,0 +1,25 @@
+const storageKey = 'jjlmoya-civic-parliamentary-voting-analyzer';
+
+export const loadDraft = (): string => {
+  try {
+    return window.localStorage.getItem(storageKey) ?? '';
+  } catch {
+    return '';
+  }
+};
+
+export const saveDraft = (value: string): void => {
+  try {
+    window.localStorage.setItem(storageKey, value);
+  } catch {
+    return;
+  }
+};
+
+export const clearDraft = (): void => {
+  try {
+    window.localStorage.removeItem(storageKey);
+  } catch {
+    return;
+  }
+};

package/src/tool/parliamentary-voting-analyzer/ui.ts

@@ -0,0 +1,98 @@
+export interface ParliamentaryVotingUI {
+  [key: string]: string;
+  dataHeading: string;
+  dataHelp: string;
+  csvLabel: string;
+  csvHint: string;
+  loadExample: string;
+  analyzeAction: string;
+  clearAction: string;
+  compareLabel: string;
+  groupsOption: string;
+  membersOption: string;
+  resultHeading: string;
+  emptyResult: string;
+  rowsLabel: string;
+  groupsLabel: string;
+  votesLabel: string;
+  warningsHeading: string;
+  methodHeading: string;
+  methodText: string;
+  limitsHeading: string;
+  limitsText: string;
+  edgeHeading: string;
+  edgeText: string;
+  cohesionHeading: string;
+  cohesionHelp: string;
+  agreementHeading: string;
+  agreementHelp: string;
+  groupLabel: string;
+  voteLabel: string;
+  riceLabel: string;
+  comparableLabel: string;
+  participationLabel: string;
+  abstentionsLabel: string;
+  absencesLabel: string;
+  unknownLabel: string;
+  noComparableData: string;
+  noDataWarning: string;
+  malformedRowWarning: string;
+  duplicateWarning: string;
+  unknownChoiceWarning: string;
+  lowSampleWarning: string;
+  tieWarning: string;
+  importedMessage: string;
+  invalidCsvMessage: string;
+  copyAction: string;
+  copiedMessage: string;
+  copyFailure: string;
+}
+
+export const ui: ParliamentaryVotingUI = {
+  dataHeading: 'Bring a roll call into view',
+  dataHelp: 'Paste one row per member and vote. Use four columns named member, group, vote, and choice.',
+  csvLabel: 'Roll call CSV',
+  csvHint: 'Required columns: member, group, vote, choice. Accepted choices: yes, no, abstain, absent, unknown.',
+  loadExample: 'Load example',
+  analyzeAction: 'Analyze votes',
+  clearAction: 'Clear data',
+  compareLabel: 'Agreement view',
+  groupsOption: 'Groups',
+  membersOption: 'Members',
+  resultHeading: 'The voting record at a glance',
+  emptyResult: 'Paste a roll call or load the example to reveal the voting ribbon.',
+  rowsLabel: 'records',
+  groupsLabel: 'groups',
+  votesLabel: 'votes',
+  warningsHeading: 'Checks before interpretation',
+  methodHeading: 'Method applied',
+  methodText: 'The Rice Index for each group and vote is absolute yes minus no divided by yes plus no. Abstentions, absences, and unknown values are excluded from that binary denominator. Group means are unweighted averages of votes with at least one yes or no. Agreement compares binary choices on the same vote and always shows the comparable vote count.',
+  limitsHeading: 'What this tool does not do',
+  limitsText: 'It does not infer ideology, intent, discipline, collusion, misconduct, policy positions, or causation. It does not decide whether a vote was valid or whether a member was legally required to attend. Similar voting can have many explanations.',
+  edgeHeading: 'Edge cases and data warnings',
+  edgeText: 'Unanimous votes produce a score of 1, not proof of discipline. Ties produce zero cohesion and are marked separately from abstentions. Missing votes reduce the comparable sample. Keep changing group membership, duplicate identifiers, and unknown choices visible in the source data.',
+  cohesionHeading: 'Cohesion ribbon',
+  cohesionHelp: 'Each row is a group. A bright mark is yes, a dark mark is no, a dashed mark is a tie, a hollow mark is abstention, and a quiet mark is absence or unknown.',
+  agreementHeading: 'Pairwise agreement',
+  agreementHelp: 'Agreement uses only comparable yes and no choices shared by both entities. In the group view, each group contributes its non tied majority choice. Abstentions and nonvotes stay out of the numerator and denominator.',
+  groupLabel: 'Group',
+  voteLabel: 'Vote',
+  riceLabel: 'Rice Index',
+  comparableLabel: 'Comparable votes',
+  participationLabel: 'Recorded choices',
+  abstentionsLabel: 'abstentions',
+  absencesLabel: 'absences',
+  unknownLabel: 'unknown',
+  noComparableData: 'No comparable yes or no choices',
+  noDataWarning: 'No usable records were found. Add member, group, vote, and choice values.',
+  malformedRowWarning: 'Some rows were skipped because a required field was empty.',
+  duplicateWarning: 'Duplicate member and vote pairs were kept only once.',
+  unknownChoiceWarning: 'Some choices were retained as unknown because they were not recognized as yes, no, abstention, or absence.',
+  lowSampleWarning: 'Some pairwise results have fewer than two comparable votes and should not be treated as stable patterns.',
+  tieWarning: 'A group or entity tie was excluded from group level comparison for that vote.',
+  importedMessage: 'Example loaded. You can edit the rows before analyzing.',
+  invalidCsvMessage: 'The data could not be read as a row based CSV.',
+  copyAction: 'Copy summary',
+  copiedMessage: 'Summary copied to the clipboard.',
+  copyFailure: 'Copy failed. Select the summary text manually.',
+};

package/src/tool/public-budget-analyzer/bibliography.astro

@@ -0,0 +1,15 @@
+---
+import { Bibliography } from '@jjlmoya/utils-shared';
+import { publicBudgetAnalyzer } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale: KnownLocale;
+}
+
+const { locale } = Astro.props as Props;
+const loader = publicBudgetAnalyzer.i18n[locale] ?? publicBudgetAnalyzer.i18n.en;
+const content = loader ? await loader() : undefined;
+---
+
+{content ? <Bibliography links={content.bibliography} /> : null}

package/src/tool/public-budget-analyzer/bibliography.ts

@@ -0,0 +1,7 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  { name: 'International Monetary Fund, Government Finance Statistics Manual 2014', url: 'https://www.imf.org/external/pubs/ft/gfs/manual/2014/gfsfinal.pdf' },
+  { name: 'Intervencion General de la Administracion del Estado, Clasificacion funcional del gasto de las Administraciones Publicas COFOG', url: 'https://www.igae.pap.hacienda.gob.es/sitios/igae/es-ES/Contabilidad/ContabilidadNacional/Publicaciones/paginas/iacogof.aspx' },
+  { name: 'OECD, Budget Transparency Toolkit', url: 'https://www.oecd.org/en/publications/oecd-budget-transparency-toolkit_9789264282070-en.html' },
+];

package/src/tool/public-budget-analyzer/component.astro

@@ -0,0 +1,52 @@
+---
+import type { PublicBudgetUI } from './ui';
+
+interface Props {
+  ui: PublicBudgetUI;
+  locale?: string;
+}
+
+const { ui } = Astro.props as Props;
+---
+
+<div class="public-budget-analyzer" data-public-budget-analyzer>
+  <div class="budget-command-bar">
+    <div class="budget-dropzone" data-budget-dropzone>
+      <input id="budget-file-input" data-budget-file type="file" accept=".csv,.json,text/csv,application/json" aria-label={ui.uploadLabel} />
+      <label for="budget-file-input">{ui.uploadLabel}</label>
+      <p>{ui.uploadHelp}</p>
+      <small>{ui.supportedFormat}</small>
+    </div>
+    <div class="budget-actions">
+      <button type="button" data-budget-example aria-label={`${ui.loadExample}: ${ui.exampleName}`}>{ui.loadExample}</button>
+      <button type="button" data-budget-download>{ui.downloadCsv}</button>
+      <button type="button" data-budget-print>{ui.printAction}</button>
+    </div>
+  </div>
+  <div class="budget-result" data-budget-result aria-live="polite">
+    <p class="budget-empty-note">{ui.analyzeEmpty}</p>
+  </div>
+  <div class="budget-guidance">
+    <section>
+      <h2>{ui.methodHeading}</h2>
+      <p>{ui.methodText}</p>
+    </section>
+    <section>
+      <h2>{ui.limitsHeading}</h2>
+      <p>{ui.limitsText}</p>
+    </section>
+    <section>
+      <h2>{ui.edgeCasesHeading}</h2>
+      <p>{ui.edgeCasesText}</p>
+    </section>
+  </div>
+</div>
+
+<script is:inline type="application/json" data-budget-ui set:html={JSON.stringify(ui)}></script>
+
+<script>
+  import { mountPublicBudgetAnalyzer } from './controller';
+  const root = document.querySelector<HTMLElement>('[data-public-budget-analyzer]');
+  const data = document.querySelector<HTMLScriptElement>('[data-budget-ui]');
+  if (root && data) mountPublicBudgetAnalyzer(root, JSON.parse(data.textContent || '{}'));
+</script>