@jjlmoya/utils-civic 1.4.0 → 1.5.0

package/src/tool/civic-priority-matrix/seo.astro

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

package/src/tool/civic-priority-matrix/storage.ts

@@ -0,0 +1,50 @@
+import type { InitiativeInput } from './logic';
+
+export interface CivicPriorityState {
+  initiatives: InitiativeInput[];
+}
+
+const STORAGE_KEY = 'jjlmoya-civic-priority-matrix';
+
+export const defaultInitiatives: InitiativeInput[] = [
+  { id: 'accessible-bus-stops', name: 'Accessible bus stops', impact: 5, urgency: 4, effort: 2 },
+  { id: 'cooling-centres', name: 'Cooling centres', impact: 4, urgency: 5, effort: 3 },
+  { id: 'meeting-transcripts', name: 'Public meeting transcripts', impact: 3, urgency: 2, effort: 1 },
+  { id: 'park-lighting', name: 'Park lighting repair', impact: 4, urgency: 3, effort: 4 },
+];
+
+function isInitiative(value: unknown): value is InitiativeInput {
+  if (!value || typeof value !== 'object') return false;
+  const item = value as Record<string, unknown>;
+  return typeof item.id === 'string'
+    && typeof item.name === 'string'
+    && typeof item.impact === 'number'
+    && typeof item.urgency === 'number'
+    && typeof item.effort === 'number';
+}
+
+function isState(value: unknown): value is CivicPriorityState {
+  if (!value || typeof value !== 'object') return false;
+  const state = value as Record<string, unknown>;
+  return Array.isArray(state.initiatives) && state.initiatives.every(isInitiative);
+}
+
+export function loadCivicPriorityState(): CivicPriorityState | null {
+  try {
+    if (typeof window === 'undefined') return null;
+    const raw = window.localStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed: unknown = JSON.parse(raw);
+    return isState(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+export function saveCivicPriorityState(state: CivicPriorityState): void {
+  try {
+    if (typeof window !== 'undefined') window.localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+  } catch {
+    return;
+  }
+}

package/src/tool/civic-priority-matrix/ui.ts

@@ -0,0 +1,96 @@
+export interface CivicPriorityUI {
+  [key: string]: string;
+  addInitiative: string;
+  initiativeList: string;
+  inputHint: string;
+  initiative: string;
+  impact: string;
+  urgency: string;
+  effort: string;
+  scoreScale: string;
+  scoreHint: string;
+  removeInitiative: string;
+  reset: string;
+  resultTitle: string;
+  rankingTitle: string;
+  matrixLabel: string;
+  summaryPrefix: string;
+  summarySuffix: string;
+  rank: string;
+  priorityScore: string;
+  denominator: string;
+  quadrant: string;
+  emptyState: string;
+  invalidState: string;
+  nameRequired: string;
+  impactInvalid: string;
+  urgencyInvalid: string;
+  effortInvalid: string;
+  actNow: string;
+  plan: string;
+  quickResponse: string;
+  defer: string;
+  highImpact: string;
+  lowImpact: string;
+  highUrgency: string;
+  lowUrgency: string;
+  methodTitle: string;
+  methodText: string;
+  notDoTitle: string;
+  notDoText: string;
+  edgeCasesTitle: string;
+  edgeCasesText: string;
+  warningTitle: string;
+  zeroEffortWarning: string;
+  invalidRowsWarning: string;
+  noInitiatives: string;
+  scoreOutOf: string;
+}
+
+export const ui: CivicPriorityUI = {
+  addInitiative: 'Add initiative',
+  initiativeList: 'Initiatives to score',
+  inputHint: 'Give every proposal the same 1 to 5 scale before comparing them.',
+  initiative: 'Initiative',
+  impact: 'Impact',
+  urgency: 'Urgency',
+  effort: 'Effort',
+  scoreScale: 'Score from 1 to 5',
+  scoreHint: 'Higher means more impact, more urgency, or more effort.',
+  removeInitiative: 'Remove initiative',
+  reset: 'Reset example',
+  resultTitle: 'Decision field',
+  rankingTitle: 'Explainable order',
+  matrixLabel: 'Initiatives placed by impact and urgency',
+  summaryPrefix: 'Showing',
+  summarySuffix: 'scored initiatives',
+  rank: 'Rank',
+  priorityScore: 'Priority score',
+  denominator: 'Effort denominator',
+  quadrant: 'Quadrant',
+  emptyState: 'Add an initiative to open the decision field.',
+  invalidState: 'Fix the highlighted values to calculate a priority order.',
+  nameRequired: 'Name is required.',
+  impactInvalid: 'Impact must be a whole number from 1 to 5.',
+  urgencyInvalid: 'Urgency must be a whole number from 1 to 5.',
+  effortInvalid: 'Effort must be a whole number from 0 to 5.',
+  actNow: 'Act now',
+  plan: 'Plan',
+  quickResponse: 'Quick response',
+  defer: 'Defer',
+  highImpact: 'High impact',
+  lowImpact: 'Low impact',
+  highUrgency: 'High urgency',
+  lowUrgency: 'Low urgency',
+  methodTitle: 'Method applied',
+  methodText: 'The priority score is impact multiplied by urgency, divided by effort. Impact, urgency, and effort use a visible 1 to 5 scale. Effort 0 is treated as 1 so a free or already-resourced action remains finite rather than becoming an infinite score. The ranking breaks ties by impact, urgency, lower effort, then input order.',
+  notDoTitle: 'What this tool does not do',
+  notDoText: 'It does not establish objective social value, measure outcomes automatically, or replace deliberation. A high score is a transparent scenario under your assumptions, not a mandate or a prediction of public benefit.',
+  edgeCasesTitle: 'Edge cases and warnings',
+  edgeCasesText: 'Keep the same interpretation of each score across every row. A missing or non-integer score excludes that row until fixed. Score 3 is the dividing line in the field. Equal scores remain in stable input order after the documented tie-breakers. Change one assessment at a time when discussing a result with a group.',
+  warningTitle: 'Review before deciding',
+  zeroEffortWarning: 'An effort score of 0 uses a denominator of 1 to keep the score finite and comparable.',
+  invalidRowsWarning: 'Some rows are excluded until their highlighted values are fixed.',
+  noInitiatives: 'No initiatives entered yet.',
+  scoreOutOf: 'of 25 maximum',
+};

package/src/tools.ts

@@ -1,12 +1,14 @@
 export { ALL_ENTRIES } from './entries';
 import type { ToolDefinition } from './types';
 import { COALITION_MAJORITY_CALCULATOR_TOOL } from './tool/coalition-majority-calculator';
+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';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   COALITION_MAJORITY_CALCULATOR_TOOL,
+  CIVIC_PRIORITY_MATRIX_TOOL,
   ELECTION_SEAT_APPORTIONMENT_CALCULATOR_TOOL,
   REFERENDUM_THRESHOLD_CALCULATOR_TOOL,
   VOTE_SEAT_DISPROPORTIONALITY_ANALYZER_TOOL,