@jjlmoya/utils-civic 1.1.0 → 1.3.0

package/src/category/i18n/tr.ts

@@ -2,19 +2,22 @@ import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
   slug: 'kamusal',
-  title: 'Kamusal karar araçları',
-  description: 'Şeffaf varsayımlarla kamu karar sistemlerini incelemek için çevrimdışı araçlar; başlangıç noktası seçim sandalyesi dağılımı modelidir.',
+  title: 'Seçimler, bütçeler ve kamu verileri için araçlar',
+  description: 'Seçimleri, koalisyonları, referandumları, kamu bütçelerini, açık verileri, parlamento oylarını ve bilgiye erişimi açık varsayımlarla inceleyen yurttaşlık araçları.',
   seo: [
-    { type: 'title', text: 'Oy toplamlarından temsili modellemek', level: 2 },
-    { type: 'paragraph', html: 'İlk kamusal araç, parti veya liste oylarını izlenebilir bir sandalye dağılımına dönüştürür. Yöntem, seçim barajı, bölüm sırası, kalan oy sırası ve oylarla sandalyeler arasındaki fark adım adım görünür.' },
-    { type: 'title', text: 'Yöntemleri ve varsayımları karşılaştırın', level: 2 },
-    { type: 'paragraph', html: 'Kamusal modeller, varsayımları açık kaldığında işe yarar. Aynı girdilerle D\'Hondt, Sainte-Laguë ve Hare en büyük kalan yöntemlerini karşılaştırın; ardından barajın veya seçim bölgesi büyüklüğünün sonucu nasıl değiştirdiğini inceleyin. Çıktı eğitseldir ve resmî sayımın ya da belirli bir seçim hukukunun yerini tutmaz.' },
-    { type: 'title', text: 'Varsayılan olarak özel', level: 2 },
-    { type: 'paragraph', html: 'Girdiler tarayıcıda işlenir. Hesap açmak gerekmez. Model, dersler, kamusal açıklamalar ve oy senaryolarını bir hizmete göndermeden yapılan dikkatli varsayım çalışmaları için tasarlanmıştır.' },
+    { type: 'title', text: 'Seçimleri ve ortak kararları inceleyin', level: 2 },
+    { type: 'paragraph', html: 'Bu yurttaşlık araçları koleksiyonu, kamu karar sistemlerini anlamayı kolaylaştırır. Seçim sandalye dağılımıyla başlar ve koalisyon çoğunlukları, referandum eşikleri, parlamento oyları ve oyların karara dönüşme süreci için araçlar sunacak şekilde tasarlanmıştır.' },
+    { type: 'title', text: 'Kuralları gizlemeden temsili karşılaştırın', level: 2 },
+    { type: 'paragraph', html: 'Bir seçim senaryosu, varsayımları görünür olduğunda anlamlıdır. Sandalye dağılımı modeliyle D\'Hondt, Sainte-Laguë ve Hare en büyük kalan yöntemlerini karşılaştırın; ardından barajları, seçim bölgesi büyüklüğünü, oy paylarını, sandalye paylarını ve dağıtım sırasını inceleyin. Bunlar öğrenme ve açıklama senaryolarıdır, resmî sonuç değildir.' },
+    { type: 'title', text: 'Kamu önceliklerini bütçe senaryolarına dönüştürün', level: 2 },
+    { type: 'paragraph', html: 'Planlanan araçlar, öncelikleri anlaşılır bütçe senaryolarına dönüştürmeye de yardımcı olacaktır. Bir öncelik matrisinin kamu ihtiyaçlarını nasıl sıraladığını, katılımcı bütçenin kısıtlar altında nasıl dağıtılacağını ve kamu bütçesinin toplamlar, kategoriler ve tercihler üzerinden nasıl okunacağını inceleyin.' },
+    { type: 'title', text: 'Açık verileri ve kamu hesap verebilirliğini inceleyin', level: 2 },
+    { type: 'paragraph', html: 'Kamusal bir karar, arkasındaki bilginin kalitesine bağlıdır. Planlanan koleksiyon açık veri kalitesini profillemek, parlamento oylarını analiz etmek ve daha açık bilgi edinme başvuruları hazırlamak için araçlar içerir; böylece eksikler ve sorular daha kolay belgelenebilir.' },
+    { type: 'title', text: 'Şeffaf senaryolar, açık sınırlar ve tarayıcı gizliliği', level: 2 },
+    { type: 'paragraph', html: 'Her araç girdileri, yöntemi, varsayımları ve sınırları anlaşılır bir dille göstermeyi amaçlar. Koleksiyon derslerde, gazetecilikte, topluluk çalışmalarında ve dikkatli ne olurdu analizlerinde kullanılabilir. Tarayıcıdaki senaryolar resmî sayımın, belirli bir hukuk kuralının veya uzman görüşünün yerini tutmaz.' },
     { type: 'stats', items: [
       { label: 'Araç', value: '1', icon: 'mdi:tools' },
       { label: 'Yöntem', value: '3', icon: 'mdi:scale-balance' },
-      { label: 'Mod', value: 'Çevrimdışı', icon: 'mdi:lock-outline' },
       { label: 'Durum', value: 'Çok dilli', icon: 'mdi:translate' },
     ] },
   ],

package/src/category/i18n/zh.ts

@@ -2,15 +2,19 @@ import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
   slug: 'civic',
-  title: '公共决策工具',
-  description: '用透明的假设探索公共决策制度的离线工具，首先提供选举席位分配模型。',
+  title: '选举、预算与公共数据的公民工具',
+  description: '用清晰的假设探索选举、联盟、公投、公共预算、开放数据、议会投票和信息公开的公民工具。',
   seo: [
-    { type: 'title', text: '从得票数建立代表性模型', level: 2 },
-    { type: 'paragraph', html: '第一个公共工具把政党或名单的得票数转换为可追溯的席位分配。用户可以逐步查看分配方法、门槛、商的顺序、余数的顺序，以及得票与席位之间的差异。' },
-    { type: 'title', text: '比较方法与假设', level: 2 },
-    { type: 'paragraph', html: '公共制度模型只有在假设清晰时才有帮助。用相同输入比较顿特法、圣拉古法和黑尔最大余数法，再测试门槛或选区席位数如何改变结果。输出用于学习和解释，不能替代官方计票或任何特定地区的选举法。' },
-    { type: 'title', text: '默认在浏览器中处理', level: 2 },
-    { type: 'paragraph', html: '输入在浏览器内处理，不需要账户。它适合课堂练习、公共说明和谨慎的假设分析，不会把投票情景发送给外部服务。' },
+    { type: 'title', text: '探索选举与集体决策', level: 2 },
+    { type: 'paragraph', html: '这组公民工具旨在让公共决策制度更容易理解。它从选举席位分配开始，并计划覆盖联盟多数、公投门槛、议会投票模式，以及得票如何转化为公共决策等问题。' },
+    { type: 'title', text: '不隐藏规则，比较代表性差异', level: 2 },
+    { type: 'paragraph', html: '选举情景只有在假设清晰时才有意义。使用席位分配模型比较顿特法、圣拉古法和黑尔最大余数法，再查看门槛、选区规模、得票率、席位率和席位分配顺序。这些情景用于学习和解释，不是官方结果。' },
+    { type: 'title', text: '把公共优先事项转化为预算情景', level: 2 },
+    { type: 'paragraph', html: '计划中的工具还将帮助把优先事项转化为易于理解的预算情景。探索优先级矩阵如何排列公共需求，参与式预算如何在限制条件下分配，以及如何通过总额、类别和权衡来阅读公共预算。' },
+    { type: 'title', text: '检查开放数据与公共问责', level: 2 },
+    { type: 'paragraph', html: '公共决策取决于支撑它的信息质量。计划中的工具包括开放数据质量分析、议会投票分析和信息公开申请构建，帮助记录信息缺口、提出清晰问题并追踪依据。' },
+    { type: 'title', text: '为公共决策提供清晰情景', level: 2 },
+    { type: 'paragraph', html: '每个工具都计划用易懂的语言展示输入、方法、假设和限制。它们适合课堂、新闻报道、社区工作和谨慎的假设分析。工具帮助清晰解释问题，但不能替代官方计票、具体法律规则或专业意见。' },
     { type: 'stats', items: [
       { label: '工具', value: '1', icon: 'mdi:tools' },
       { label: '方法', value: '3', icon: 'mdi:scale-balance' },

package/src/category/index.ts

@@ -1,9 +1,11 @@
+import { coalitionMajorityCalculator } from '../tool/coalition-majority-calculator/entry';
 import { electionSeatApportionmentCalculator } from '../tool/election-seat-apportionment-calculator/entry';
+import { voteSeatDisproportionalityAnalyzer } from '../tool/vote-seat-disproportionality-analyzer/entry';
 import type { CategoryLocaleContent, KnownLocale } from '../types';
 
 export const civicCategory = {
   icon: 'mdi:bank-outline',
-  tools: [electionSeatApportionmentCalculator],
+  tools: [coalitionMajorityCalculator, electionSeatApportionmentCalculator, voteSeatDisproportionalityAnalyzer],
   i18n: {
     en: () => import('./i18n/en').then((m) => m.content),
     de: () => import('./i18n/de').then((m) => m.content),

package/src/entries.ts

@@ -1,9 +1,15 @@
 export { electionSeatApportionmentCalculator } from './tool/election-seat-apportionment-calculator/entry';
 export type { ElectionSeatUI, ElectionSeatLocaleContent } from './tool/election-seat-apportionment-calculator/entry';
+export { voteSeatDisproportionalityAnalyzer } from './tool/vote-seat-disproportionality-analyzer/entry';
+export type { VoteSeatUI, VoteSeatLocaleContent } from './tool/vote-seat-disproportionality-analyzer/entry';
 export { civicCategory } from './category';
 
+import { coalitionMajorityCalculator } from './tool/coalition-majority-calculator/entry';
 import { electionSeatApportionmentCalculator } from './tool/election-seat-apportionment-calculator/entry';
+import { voteSeatDisproportionalityAnalyzer } from './tool/vote-seat-disproportionality-analyzer/entry';
 
 export const ALL_ENTRIES = [
+  coalitionMajorityCalculator,
   electionSeatApportionmentCalculator,
+  voteSeatDisproportionalityAnalyzer,
 ];

package/src/index.ts

@@ -2,6 +2,7 @@ export { civicCategory } from './category';
 export const civicCategorySEO = () => import('./category/CivicCategorySEO.astro').then((m) => m.default);
 
 export { electionSeatApportionmentCalculator, ELECTION_SEAT_APPORTIONMENT_CALCULATOR_TOOL } from './tool/election-seat-apportionment-calculator';
+export { voteSeatDisproportionalityAnalyzer, VOTE_SEAT_DISPROPORTIONALITY_ANALYZER_TOOL } from './tool/vote-seat-disproportionality-analyzer';
 
 export type {
   KnownLocale,

package/src/tests/i18n_coverage.test.ts

@@ -11,6 +11,10 @@ describe('I18n Coverage Validation', () => {
   ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
     describe(`Tool: ${entry.id}`, () => {
       it('should have all 15 required locales', () => {
+        if (entry.phase === 'english-first') {
+          expect(Object.keys(entry.i18n)).toEqual(['en']);
+          return;
+        }
         const registeredLocales = Object.keys(entry.i18n);
         EXPECTED_LOCALES.forEach((locale) => {
           expect(
@@ -21,6 +25,10 @@ describe('I18n Coverage Validation', () => {
       });
 
       it('all locale loaders should be functions', () => {
+        if (entry.phase === 'english-first') {
+          expect(typeof entry.i18n.en).toBe('function');
+          return;
+        }
         EXPECTED_LOCALES.forEach((locale) => {
           const loader = entry.i18n[locale as keyof typeof entry.i18n];
           expect(

package/src/tests/locale_completeness.test.ts

@@ -18,6 +18,6 @@ describe('Locale Completeness Validation', () => {
   });
 
   it('all tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(1);
+    expect(ALL_TOOLS.length).toBe(3);
   });
 });

package/src/tests/tool_validation.test.ts

@@ -5,7 +5,7 @@ import { civicCategory } from '../data';
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
     it('should have tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(1);
+      expect(ALL_TOOLS.length).toBe(3);
     });
 
     it('civicCategory should be defined', () => {

package/src/tool/coalition-majority-calculator/bibliography.astro

@@ -0,0 +1,6 @@
+---
+import { Bibliography } from '@jjlmoya/utils-shared';
+import { bibliography } from './bibliography';
+---
+
+<Bibliography links={bibliography} />

package/src/tool/coalition-majority-calculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Deutscher Bundestag, Koalition',
+    url: 'https://www.bundestag.de/services/glossar/glossar/K/koalition-245478',
+  },
+  {
+    name: 'Madeleine O. Hosli, The New Voting Weights in the Council of the European Union',
+    url: 'https://ciaotest.cc.columbia.edu/isa/hom01/',
+  },
+];

package/src/tool/coalition-majority-calculator/coalition-majority-calculator.css

@@ -0,0 +1,467 @@
+:root {
+  --n-paper: #f5f1e8;
+  --n-card: #fffdf8;
+  --n-ink: #17202a;
+  --n-muted: #5e6872;
+  --n-line: #d8d2c8;
+  --n-accent: #a44a2f;
+  --n-accent-soft: #f0d7c8;
+  --n-orbit: #d1a23a;
+  --n-good: #2f7759;
+  --n-warn: #a44a2f;
+}
+
+.theme-dark {
+  --n-paper: #161817;
+  --n-card: #202321;
+  --n-ink: #f1eee6;
+  --n-muted: #b5b9b2;
+  --n-line: #454945;
+  --n-accent: #ef8b63;
+  --n-accent-soft: #4b3028;
+  --n-orbit: #e0bd57;
+  --n-good: #79bd96;
+  --n-warn: #ef8b63;
+}
+
+.coalition-tool {
+  --n-surface: var(--n-card);
+  --n-field: var(--n-paper);
+
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  color: var(--n-ink);
+  margin: 0 auto;
+  max-width: 1120px;
+  overflow: hidden;
+}
+
+.coalition-workspace {
+  display: grid;
+  grid-template-columns: minmax(300px, .8fr) minmax(400px, 1.2fr);
+}
+
+.coalition-controls,
+.coalition-result {
+  min-width: 0;
+  padding: 1.4rem;
+}
+
+.coalition-controls {
+  border-right: 1px solid var(--n-line);
+}
+
+.coalition-result {
+  background: var(--n-surface);
+}
+
+.section-kicker {
+  color: var(--n-accent);
+  font-size: .75rem;
+  font-weight: 800;
+  letter-spacing: .11em;
+  text-transform: uppercase;
+}
+
+.party-list {
+  display: grid;
+  gap: .7rem;
+  margin: 1rem 0;
+}
+
+.party-row {
+  align-items: end;
+  display: grid;
+  gap: .55rem;
+  grid-template-columns: minmax(0, 1fr) 6rem 2rem;
+}
+
+label {
+  color: var(--n-muted);
+  display: grid;
+  font-size: .76rem;
+  font-weight: 700;
+  gap: .3rem;
+}
+
+input {
+  background: var(--n-field);
+  border: 1px solid var(--n-line);
+  border-radius: .35rem;
+  box-sizing: border-box;
+  color: var(--n-ink);
+  font: inherit;
+  min-height: 2.55rem;
+  padding: .5rem .6rem;
+  width: 100%;
+}
+
+input:focus-visible,
+button:focus-visible {
+  outline: 3px solid var(--n-orbit);
+  outline-offset: 2px;
+}
+
+.icon-button,
+.secondary-button,
+.text-button {
+  border: 0;
+  cursor: pointer;
+  font: inherit;
+}
+
+.icon-button {
+  background: transparent;
+  color: var(--n-muted);
+  font-size: 1.1rem;
+  min-height: 2.55rem;
+}
+
+.control-actions {
+  align-items: center;
+  display: flex;
+  gap: .8rem;
+  margin: .8rem 0 1.4rem;
+}
+
+.secondary-button {
+  background: var(--n-accent-soft);
+  border-radius: 999px;
+  color: var(--n-ink);
+  padding: .65rem .9rem;
+}
+
+.text-button {
+  background: transparent;
+  color: var(--n-accent);
+  padding: .5rem 0;
+  text-decoration: underline;
+}
+
+.threshold-control {
+  border-top: 1px solid var(--n-line);
+  padding-top: 1rem;
+}
+
+.threshold-help,
+.threshold-control small,
+.control-note,
+.limit-note,
+.method-note,
+.scene-empty {
+  color: var(--n-muted);
+}
+
+.control-note,
+.limit-note {
+  font-size: .88rem;
+  line-height: 1.5;
+}
+
+.limit-note {
+  border-left: 3px solid var(--n-orbit);
+  padding-left: .7rem;
+}
+
+.result-heading {
+  align-items: baseline;
+  display: flex;
+  justify-content: space-between;
+  gap: 1rem;
+}
+
+.result-heading p {
+  color: var(--n-good);
+  font-size: .86rem;
+  margin: 0;
+  text-align: right;
+}
+
+.result-heading p[data-tone="warn"] {
+  color: var(--n-warn);
+}
+
+.scene-wrap {
+  align-items: center;
+  border-bottom: 1px solid var(--n-line);
+  display: flex;
+  justify-content: center;
+  min-height: 300px;
+}
+
+.scene-empty {
+  font-size: .9rem;
+  line-height: 1.5;
+  max-width: 20rem;
+  text-align: center;
+}
+
+.coalition-orbit {
+  fill: none;
+  stroke: var(--n-orbit);
+  stroke-dasharray: 3 7;
+  stroke-width: 2;
+}
+
+.coalition-core {
+  fill: var(--n-accent-soft);
+  stroke: var(--n-accent);
+  stroke-width: 2;
+}
+
+.coalition-link {
+  stroke: var(--n-line);
+  stroke-width: 1.2;
+}
+
+.coalition-node circle {
+  fill: var(--n-field);
+  stroke: var(--n-muted);
+  stroke-width: 1.5;
+}
+
+.coalition-winning-link {
+  opacity: .42;
+  stroke: var(--n-accent);
+  stroke-width: 2.4;
+}
+
+.coalition-node.is-pivotal circle {
+  fill: var(--n-accent-soft);
+  stroke: var(--n-accent);
+  stroke-width: 3;
+}
+
+.coalition-core-label,
+.coalition-node-name,
+.coalition-node-seats,
+.coalition-core-caption {
+  fill: var(--n-ink);
+}
+
+.coalition-core-label {
+  font-size: 1.25rem;
+  font-weight: 800;
+}
+
+.coalition-core-caption,
+.coalition-node-seats {
+  fill: var(--n-muted);
+  font-size: .62rem;
+}
+
+.coalition-node-name {
+  font-size: .68rem;
+  font-weight: 800;
+  text-anchor: middle;
+}
+
+.coalition-node-seats {
+  text-anchor: middle;
+}
+
+.coalition-stats {
+  display: grid;
+  gap: .7rem;
+  grid-template-columns: repeat(2, 1fr);
+  margin: 1.2rem 0;
+}
+
+.coalition-stat {
+  border-left: 2px solid var(--n-orbit);
+  padding-left: .65rem;
+}
+
+.coalition-stat dt {
+  color: var(--n-muted);
+  font-size: .72rem;
+}
+
+.coalition-stat dd {
+  font-size: 1.1rem;
+  font-weight: 800;
+  margin: .15rem 0 0;
+}
+
+.pivots,
+.coalition-table-wrap {
+  border-top: 1px solid var(--n-line);
+  padding-top: 1rem;
+}
+
+.pivots h3,
+.coalition-table-wrap h3 {
+  font-size: .9rem;
+  margin: 0;
+}
+
+.table-heading {
+  align-items: end;
+  display: flex;
+  gap: 1rem;
+  justify-content: space-between;
+  margin-bottom: .65rem;
+}
+
+.table-filter {
+  align-items: center;
+  display: flex;
+  flex-direction: row;
+  font-size: .7rem;
+  gap: .4rem;
+}
+
+.table-filter select {
+  background: var(--n-field);
+  border: 1px solid var(--n-line);
+  border-radius: .35rem;
+  color: var(--n-ink);
+  font: inherit;
+  min-height: 2rem;
+  padding: .25rem .4rem;
+}
+
+.pivots ul {
+  display: grid;
+  gap: .45rem;
+  grid-template-columns: repeat(2, 1fr);
+  list-style: none;
+  margin: 0 0 1.2rem;
+  padding: 0;
+}
+
+.pivots li {
+  display: grid;
+  grid-template-columns: 1fr auto;
+  gap: .2rem .5rem;
+}
+
+.pivots small {
+  color: var(--n-muted);
+  font-size: .7rem;
+  grid-column: 1 / -1;
+}
+
+.table-scroll {
+  overflow-x: auto;
+}
+
+table {
+  border-collapse: collapse;
+  font-size: .78rem;
+  width: 100%;
+}
+
+th,
+td {
+  border-bottom: 1px solid var(--n-line);
+  padding: .55rem .4rem;
+  text-align: left;
+  vertical-align: top;
+}
+
+thead th {
+  color: var(--n-muted);
+  font-size: .7rem;
+  position: sticky;
+  text-transform: uppercase;
+  top: 0;
+}
+
+.row-badge {
+  color: var(--n-muted);
+  display: block;
+  font-size: .65rem;
+  font-weight: 800;
+  margin-bottom: .15rem;
+  text-transform: uppercase;
+}
+
+.row-badge.is-minimal {
+  color: var(--n-accent);
+}
+
+.method-note {
+  border-top: 1px solid var(--n-line);
+  display: grid;
+  font-size: .8rem;
+  gap: 1rem;
+  grid-template-columns: repeat(3, 1fr);
+  line-height: 1.45;
+  padding: 1rem 1.4rem;
+}
+
+.method-note section {
+  display: grid;
+  gap: .35rem;
+}
+
+.method-note strong {
+  color: var(--n-ink);
+}
+
+.coalition-seo,
+.coalition-bibliography {
+  color: var(--n-ink);
+  margin: 2rem auto;
+  max-width: 840px;
+}
+
+.coalition-seo h2,
+.coalition-bibliography h2 {
+  margin-top: 2rem;
+}
+
+.coalition-seo p,
+.coalition-seo li,
+.coalition-bibliography li {
+  line-height: 1.65;
+}
+
+.coalition-seo aside {
+  border-left: 3px solid var(--n-orbit);
+  margin: 1.2rem 0;
+  padding: .2rem 1rem;
+}
+
+.coalition-seo table {
+  margin: 1rem 0;
+}
+
+.coalition-bibliography a {
+  color: var(--n-accent);
+}
+
+@media (max-width: 760px) {
+  .coalition-workspace {
+    grid-template-columns: 1fr;
+  }
+
+  .coalition-controls {
+    border-bottom: 1px solid var(--n-line);
+    border-right: 0;
+  }
+
+  .coalition-result {
+    padding-top: 1.1rem;
+  }
+}
+
+@media (max-width: 460px) {
+  .coalition-controls,
+  .coalition-result,
+  .method-note {
+    padding-left: .9rem;
+    padding-right: .9rem;
+  }
+
+  .party-row {
+    grid-template-columns: minmax(0, 1fr) 5rem 1.7rem;
+  }
+
+  .pivots ul {
+    grid-template-columns: 1fr;
+  }
+
+  .method-note { grid-template-columns: 1fr; }
+}