@jjlmoya/utils-tabletop 1.28.0 → 1.30.0

package/src/tool/rpg-settlement-exploration-map-generator/seo.astro

@@ -0,0 +1,11 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { rpgSettlementExplorationMapGenerator } from './index';
+import type { KnownLocale } from '../../types';
+interface Props { locale?: KnownLocale; }
+const { locale = 'en' } = Astro.props as Props;
+const loader = rpgSettlementExplorationMapGenerator.i18n[locale] || rpgSettlementExplorationMapGenerator.i18n.en;
+const content = await loader?.();
+if (!content) return null;
+---
+{content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/rpg-settlement-exploration-map-generator/storage.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_CONFIG, generateSettlement } from './logic';
+import { decodeShareState, encodeShareState } from './storage';
+
+describe('settlement map storage', () => {
+  it('shares the edited map and custom service catalog together', () => {
+    const map = generateSettlement({ ...DEFAULT_CONFIG, services: ['tavern', 'Shrine'] });
+    const decoded = decodeShareState(encodeShareState(map, ['Shrine', 'Waystone']));
+    expect(decoded?.map).toEqual(map);
+    expect(decoded?.customServices).toEqual(['Shrine', 'Waystone']);
+  });
+});

package/src/tool/rpg-settlement-exploration-map-generator/storage.ts

@@ -0,0 +1,24 @@
+import { normalizeConfig, type SettlementConfig, type SettlementMap } from './logic';
+
+const STORAGE_KEY = 'jjlmoya:rpg-settlement-map-generator';
+export interface SettlementState {
+  map: SettlementMap;
+  customServices: string[];
+}
+
+function cleanCustomServices(values: unknown): string[] { return Array.isArray(values) ? [...new Set(values.filter((value): value is string => typeof value === 'string' && value.trim().length > 0).map((value) => value.trim().slice(0, 28)))] : []; }
+
+function stateFromUnknown(value: unknown): SettlementState | null {
+  if (!value || typeof value !== 'object') return null;
+  const candidate = value as Partial<SettlementState> & Partial<SettlementMap>;
+  if (isSettlementMap(candidate.map)) return { map: candidate.map, customServices: cleanCustomServices(candidate.customServices) };
+  if (isSettlementMap(value)) return { map: value, customServices: [] };
+  return null;
+}
+
+export function saveSettlement(map: SettlementMap, customServices: string[] = []): void { try { window.localStorage.setItem(STORAGE_KEY, JSON.stringify({ map, customServices: cleanCustomServices(customServices) })); } catch {} }
+export function loadSettlement(): SettlementState | null { try { const raw = window.localStorage.getItem(STORAGE_KEY); return raw ? stateFromUnknown(JSON.parse(raw)) : null; } catch { return null; } }
+export function encodeShareState(map: SettlementMap, customServices: string[] = []): string { const state = { map, customServices: cleanCustomServices(customServices) }; return btoa(unescape(encodeURIComponent(JSON.stringify(state)))).replaceAll('+', '-').replaceAll('/', '_').replaceAll('=', ''); }
+export function decodeShareState(value: string): SettlementState | null { try { const padded = value.replaceAll('-', '+').replaceAll('_', '/') + '='.repeat((4 - value.length % 4) % 4); return stateFromUnknown(JSON.parse(decodeURIComponent(escape(atob(padded))))); } catch { return null; } }
+export function configFromMap(map: SettlementMap): SettlementConfig { return normalizeConfig({ ...map.config, services: [...map.config.services] }); }
+export function isSettlementMap(value: unknown): value is SettlementMap { if (!value || typeof value !== 'object') return false; const candidate = value as Partial<SettlementMap>; return typeof candidate.width === 'number' && typeof candidate.height === 'number' && !!candidate.config && Array.isArray(candidate.buildings) && Array.isArray(candidate.paths) && Array.isArray(candidate.water); }

package/src/tool/rpg-settlement-exploration-map-generator/ui.ts

@@ -0,0 +1,81 @@
+export interface SettlementMapUI extends Record<string, string> {
+  intro: string;
+  seedLabel: string;
+  seedHint: string;
+  randomSeed: string;
+  environmentLabel: string;
+  forest: string;
+  plains: string;
+  coast: string;
+  river: string;
+  mountain: string;
+  styleLabel: string;
+  styleHint: string;
+  styleTimber: string;
+  styleStone: string;
+  styleCoastal: string;
+  styleHighland: string;
+  styleMedieval: string;
+  styleEdo: string;
+  styleSahelian: string;
+  sizeLabel: string;
+  hamlet: string;
+  hamletHint: string;
+  village: string;
+  villageHint: string;
+  town: string;
+  townHint: string;
+  homesLabel: string;
+  homesHint: string;
+  servicesLabel: string;
+  serviceListHint: string;
+  newServicePlaceholder: string;
+  addService: string;
+  removeService: string;
+  serviceTavern: string;
+  serviceSmithy: string;
+  serviceTemple: string;
+  serviceMarket: string;
+  serviceStable: string;
+  serviceHall: string;
+  generate: string;
+  mapRegionLabel: string;
+  mapSummary: string;
+  buildings: string;
+  paths: string;
+  services: string;
+  terrain: string;
+  legendLabel: string;
+  legendHome: string;
+  legendService: string;
+  legendPath: string;
+  legendWater: string;
+  legendWild: string;
+  editLabel: string;
+  toolSelect: string;
+  toolBuilding: string;
+  toolPath: string;
+  toolWater: string;
+  toolTree: string;
+  toolErase: string;
+  serviceSelectLabel: string;
+  clickHint: string;
+  selectedHint: string;
+  shareLink: string;
+  linkCopied: string;
+  exportPng: string;
+  exportSvg: string;
+  exportJson: string;
+  importJson: string;
+  importError: string;
+  mapData: string;
+  readyBadge: string;
+  serviceNone: string;
+  contextMenuLabel: string;
+  contextInspect: string;
+  contextBuilding: string;
+  contextPath: string;
+  contextWater: string;
+  contextTree: string;
+  contextErase: string;
+}

package/src/tools.ts

@@ -15,6 +15,7 @@ import { DUNGEON_MAP_GENERATOR_TOOL } from './tool/dungeon-map-generator';
 import { ENCOUNTER_DIFFICULTY_CALCULATOR_TOOL } from './tool/encounter-difficulty-calculator';
 import { TOKEN_STAMP_STUDIO_TOOL } from './tool/token-stamp-studio';
 import { MUS_SCOREBOARD_TOOL } from './tool/mus-scoreboard';
+import { RPG_SETTLEMENT_EXPLORATION_MAP_GENERATOR_TOOL } from './tool/rpg-settlement-exploration-map-generator';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   DICE_ROLLER_SIMULATOR_TOOL,
@@ -32,5 +33,6 @@ export const ALL_TOOLS: ToolDefinition[] = [
   ENCOUNTER_DIFFICULTY_CALCULATOR_TOOL,
   TOKEN_STAMP_STUDIO_TOOL,
   MUS_SCOREBOARD_TOOL,
+  RPG_SETTLEMENT_EXPLORATION_MAP_GENERATOR_TOOL,
 ];