@jjlmoya/utils-civic 1.5.0 → 1.7.0

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

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } 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 ? <SEORenderer content={{ locale, sections: content.seo }} /> : null}

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

@@ -0,0 +1,28 @@
+const storageKey = 'jjlmoya-public-budget-analyzer';
+
+export interface SavedBudgetState {
+  format: 'csv' | 'json';
+  text: string;
+}
+
+export function loadSavedBudget(): SavedBudgetState | undefined {
+  try {
+    const value = window.localStorage.getItem(storageKey);
+    if (!value) return undefined;
+    const parsed: unknown = JSON.parse(value);
+    if (!parsed || typeof parsed !== 'object') return undefined;
+    const candidate = parsed as Record<string, unknown>;
+    if ((candidate.format !== 'csv' && candidate.format !== 'json') || typeof candidate.text !== 'string') return undefined;
+    return { format: candidate.format, text: candidate.text };
+  } catch {
+    return undefined;
+  }
+}
+
+export function saveBudgetState(state: SavedBudgetState): void {
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(state));
+  } catch {
+    return;
+  }
+}

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

@@ -0,0 +1,78 @@
+export interface PublicBudgetUI {
+  [key: string]: string;
+  uploadLabel: string;
+  uploadHelp: string;
+  loadExample: string;
+  supportedFormat: string;
+  tableHeading: string;
+  categoryLabel: string;
+  amountLabel: string;
+  populationLabel: string;
+  sourceRowsLabel: string;
+  analyzeEmpty: string;
+  resultHeading: string;
+  totalLabel: string;
+  perCapitaLabel: string;
+  variationLabel: string;
+  topCategoryLabel: string;
+  shareLabel: string;
+  sourceLabel: string;
+  noData: string;
+  warningsHeading: string;
+  errorsHeading: string;
+  methodHeading: string;
+  methodText: string;
+  limitsHeading: string;
+  limitsText: string;
+  edgeCasesHeading: string;
+  edgeCasesText: string;
+  downloadCsv: string;
+  printAction: string;
+  rowsLabel: string;
+  categoriesLabel: string;
+  positiveTotalLabel: string;
+  previousTotalLabel: string;
+  invalidFile: string;
+  fileReadError: string;
+  exampleName: string;
+  noPreviousData: string;
+}
+
+export const ui: PublicBudgetUI = {
+  uploadLabel: 'Drop a budget CSV or JSON file here',
+  uploadHelp: 'Required fields: category and amount. Optional fields: population, period, priorAmount, currency, and parentCategory.',
+  loadExample: 'Load example budget',
+  supportedFormat: 'CSV or JSON, processed only in this browser',
+  tableHeading: 'Source rows and category totals',
+  categoryLabel: 'Category',
+  amountLabel: 'Amount',
+  populationLabel: 'Population',
+  sourceRowsLabel: 'Source rows',
+  analyzeEmpty: 'Choose a file or load the example to inspect a budget.',
+  resultHeading: 'Budget landscape',
+  totalLabel: 'Total spending',
+  perCapitaLabel: 'Spending per person',
+  variationLabel: 'Change from prior period',
+  topCategoryLabel: 'Largest category',
+  shareLabel: 'Share of total',
+  sourceLabel: 'Source rows',
+  noData: 'No valid budget rows are available yet.',
+  warningsHeading: 'Warnings to review',
+  errorsHeading: 'Rows not included',
+  methodHeading: 'Method applied',
+  methodText: 'The tool validates the required fields, preserves each source row, groups exact category paths, and calculates totals from the normalized amounts. Category share is amount divided by the total when the total is positive. Per capita spending divides the total by the first consistent positive population denominator. Period change is (current minus prior) divided by prior, and is omitted when the prior amount is zero.',
+  limitsHeading: 'What this tool does not do',
+  limitsText: 'It does not prove that a budget is complete, comparable, legal, efficient, fair, unbiased, or correctly classified. It does not audit the source, infer policy quality, reconcile currencies, or identify whether a row is an appropriation, obligation, payment, or forecast.',
+  edgeCasesHeading: 'Edge cases and data warnings',
+  edgeCasesText: 'Mixed currencies, changing populations, duplicate categories, negative adjustments, parent rows beside child rows, locale-specific number formats, and zero prior amounts need human review. The browser keeps the original row number so every aggregate can be traced back to its input.',
+  downloadCsv: 'Download reviewed table',
+  printAction: 'Print analysis',
+  rowsLabel: 'valid rows',
+  categoriesLabel: 'categories',
+  positiveTotalLabel: 'positive amounts visualized',
+  previousTotalLabel: 'Previous total',
+  invalidFile: 'The file could not be understood as a non-empty CSV or JSON table.',
+  fileReadError: 'The file could not be read in this browser.',
+  exampleName: 'Community budget sample',
+  noPreviousData: 'No comparable prior-period amount was supplied.',
+};

package/src/tools.ts

@@ -5,6 +5,8 @@ import { CIVIC_PRIORITY_MATRIX_TOOL } from './tool/civic-priority-matrix';
 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';
+import { PARTICIPATORY_BUDGET_ALLOCATOR_TOOL } from './tool/participatory-budget-allocator';
+import { PUBLIC_BUDGET_ANALYZER_TOOL } from './tool/public-budget-analyzer';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   COALITION_MAJORITY_CALCULATOR_TOOL,
@@ -12,4 +14,6 @@ export const ALL_TOOLS: ToolDefinition[] = [
   ELECTION_SEAT_APPORTIONMENT_CALCULATOR_TOOL,
   REFERENDUM_THRESHOLD_CALCULATOR_TOOL,
   VOTE_SEAT_DISPROPORTIONALITY_ANALYZER_TOOL,
+  PARTICIPATORY_BUDGET_ALLOCATOR_TOOL,
+  PUBLIC_BUDGET_ANALYZER_TOOL,
 ];