@jjlmoya/utils-tabletop 1.26.0 → 1.27.0

package/src/tool/token-stamp-studio/entry.ts

@@ -0,0 +1,27 @@
+import type { TabletopToolEntry, ToolLocaleContent } from '../../types';
+import type { TokenStampUI } from './ui';
+
+export type { TokenStampUI } from './ui';
+export type TokenStampLocaleContent = ToolLocaleContent<TokenStampUI>;
+
+export const tokenStampStudio: TabletopToolEntry<TokenStampUI> = {
+  id: 'token-stamp-studio',
+  icons: { bg: 'mdi:account-circle-outline', fg: 'mdi:account-circle' },
+  i18n: {
+    de: () => import('./i18n/de').then((module) => module.content),
+    en: () => import('./i18n/en').then((module) => module.content),
+    es: () => import('./i18n/es').then((module) => module.content),
+    fr: () => import('./i18n/fr').then((module) => module.content),
+    id: () => import('./i18n/id').then((module) => module.content),
+    it: () => import('./i18n/it').then((module) => module.content),
+    ja: () => import('./i18n/ja').then((module) => module.content),
+    ko: () => import('./i18n/ko').then((module) => module.content),
+    nl: () => import('./i18n/nl').then((module) => module.content),
+    pl: () => import('./i18n/pl').then((module) => module.content),
+    pt: () => import('./i18n/pt').then((module) => module.content),
+    ru: () => import('./i18n/ru').then((module) => module.content),
+    sv: () => import('./i18n/sv').then((module) => module.content),
+    tr: () => import('./i18n/tr').then((module) => module.content),
+    zh: () => import('./i18n/zh').then((module) => module.content),
+  },
+};

package/src/tool/token-stamp-studio/evaluator.ts

@@ -0,0 +1,6 @@
+import { getStatus } from './logic';
+import type { TokenStampState, TokenStampStatus } from './types';
+
+export function evaluateTokenState(state: TokenStampState, ui: { statusReady: string; statusAddImage: string; statusAddText: string }): TokenStampStatus {
+  return getStatus(state, ui);
+}

package/src/tool/token-stamp-studio/i18n/de.ts

@@ -0,0 +1,132 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { TokenStampLocaleContent, TokenStampUI } from '../entry';
+
+const ui: TokenStampUI = {
+  frameLegend: 'Wähle einen Rahmen',
+  frameHint: 'Wähle die Silhouette, die der Gruppe zeigt, wer dieser Charakter ist, bevor jemand den Namen liest.',
+  randomFrame: 'Zufälliger Rahmen',
+  surfaceLegend: 'Gestalte den Token',
+  backgroundLabel: 'Hintergrund',
+  borderLabel: 'Rahmen',
+  textLabel: 'Beschriftung',
+  overlayLabel: 'Tönung',
+  randomColors: 'Zufällige Farben',
+  borderWidthLabel: 'Rahmenstärke',
+  opacityLabel: 'Rahmentransparenz',
+  overlayOpacityLabel: 'Porträttönung',
+  stageLabel: 'Live Token Schmiede',
+  chooseImage: 'Porträt wählen',
+  clearImage: 'Porträt entfernen',
+  positionHint: 'Ziehe das Porträt oder Beschriftungen direkt auf den Token.',
+  markerName: 'Marker Name',
+  markerNamePlaceholder: 'Marker benennen',
+  textLegend: 'Füge lesbare Details hinzu',
+  textHint: 'Verwende kurze Angaben wie Name, Stufe, Rolle oder Zustand. Ziehe jede Beschriftung auf den Token.',
+  textPlaceholder: 'Charaktername oder Rolle',
+  addText: 'Beschriftung hinzufügen',
+  removeText: 'Beschriftung entfernen',
+  textSizeLabel: 'Schriftgröße',
+  alignmentLabel: 'Textausrichtung',
+  alignLeft: 'Links ausrichten',
+  alignCenter: 'Zentrieren',
+  alignRight: 'Rechts ausrichten',
+  imageLegend: 'Porträt anpassen',
+  imageZoomLabel: 'Porträt Zoom',
+  scaleLabel: 'Export Skalierung',
+  savedMarkers: 'Gespeicherte Marker',
+  noSavedMarkers: 'Gespeicherte Marker erscheinen hier, um sie erneut zu öffnen, zu bearbeiten und wiederzuverwenden.',
+  reuseMarker: 'Wähle einen Marker zum erneuten Öffnen.',
+  deleteMarker: 'Marker löschen',
+  newMarker: 'Neuer Marker',
+  download: 'PNG herunterladen',
+  copy: 'PNG kopieren',
+  downloadBatch: 'Stapel herunterladen',
+  batchLabel: 'Erweiterter Stapel Export',
+  batchHint: 'Optional: Exportiere mehrere Porträts mit den aktuellen Rahmen und Farbeinstellungen.',
+  chooseBatch: 'Porträts auswählen',
+  batchReady: '{count} Porträts bereit zum Schmieden.',
+  noImage: 'Kein Porträt geladen',
+  noText: 'Noch keine Beschriftungen. Füge Details hinzu, die deine Gruppe benötigt.',
+  tokenDetails: 'Charakter Token Steuerung',
+  exportHint: 'Das PNG ist außerhalb der gewählten Silhouette transparent, bereit für VTT oder Druckbögen.',
+};
+
+const faq = [
+  {
+    question: 'Was macht ein gutes Charakter Token Porträt aus?',
+    answer: 'Wähle ein Bild mit gut erkennbarem Gesicht oder starker Silhouette und ausreichend Kontrast zum Rahmen. Ein Kopf und Schultern Ausschnitt bleibt auch bei kleiner Darstellung auf dem VTT gut lesbar.',
+  },
+  {
+    question: 'Wie platziere ich das Porträt optimal im Rahmen?',
+    answer: 'Lade das Bild hoch und ziehe es direkt auf dem Token an die richtige Position. Nutze den Porträt Zoom, um das Gesicht zu vergrößern, ohne den Rahmen zu verändern.',
+  },
+  {
+    question: 'Kann ich Charaktername und Stufe hinzufügen?',
+    answer: 'Ja. Füge so viele kurze Beschriftungen hinzu wie nötig, wähle sie aus, passe Schriftgröße und Ausrichtung an und platziere sie gut lesbar auf dem Token.',
+  },
+  {
+    question: 'Bleibt das PNG außerhalb des Tokens transparent?',
+    answer: 'Ja. Das exportierte Bild behält den Bereich außerhalb der Silhouette transparent, sodass der Marker perfekt auf Spielplänen oder Druckbögen platziert werden kann.',
+  },
+  {
+    question: 'Kann ich eine ganze Abenteurergruppe auf einmal erstellen?',
+    answer: 'Ja. Lade mehrere Porträts im Stapel Export hoch, verwende dieselben Rahmen und Farbeinstellungen und lade für jedes Porträt ein transparentes PNG herunter.',
+  },
+  {
+    question: 'Wo werden meine gespeicherten Marker abgelegt?',
+    answer: 'Das Speichern auf diesem Gerät sichert den Marker im lokalen Browserspeicher. Es werden keine Bilder hochgeladen. Das Löschen von Browserdaten entfernt auch die lokale Kopie.',
+  },
+];
+
+const howTo = [
+  { name: 'Wähle die Charakter Silhouette', text: 'Starte mit einem Rahmen, der zum Charakter passt: Kreis für klassische Helden, Sechseck für taktische Spiele oder Stern für Bosse und Champions.' },
+  { name: 'Porträt laden und ausrichten', text: 'Wähle ein Bild aus und ziehe es auf den Live Token. Positioniere das Gesicht mittig im Rahmen und passe den Zoom an.' },
+  { name: 'Wichtige Details hinzufügen', text: 'Ergänze kurze Beschriftungen für Name, Stufe oder Status. Halte den Text kurz, damit das Bild gut erkennbar bleibt.' },
+  { name: 'Speichern und als PNG exportieren', text: 'Der Marker wird automatisch gespeichert. Lade ein transparentes PNG für dein Virtual Tabletop oder den Druckbogen herunter.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Token Stamp Studio',
+  operatingSystem: 'All',
+  applicationCategory: 'DesignApplication',
+  description: 'Erstelle gut lesbare Charakter Tokens für Pen and Paper Rollenspiele mit individuellen Rahmen, Beschriftungen, Transparenz und Stapel Export.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'So erstellst du ein Charakter Token für Rollenspiele',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'character-token-maker-rpg-rollenspiel',
+  title: 'Charakter Token Ersteller für Pen and Paper Rollenspiele',
+  description: 'Erstelle gut lesbare Charakter Tokens und Marker aus Porträts mit ausdrucksstarken Rahmen, verschiebbaren Ausschnitten, Beschriftungen und transparentem PNG Export.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Gestalte deutliche Charakter Tokens für jede Kartengröße', level: 2 },
+    { type: 'paragraph', html: 'Ein Token ist ein visueller Signalgeber am Spieltisch. Seine Silhouette verrät der Gruppe sofort, ob es sich um einen Helden, ein Monster oder ein wichtiges Ziel handelt. Wähle den passenden Rahmen und halte Gesicht und Text auch bei kleiner Darstellung auf dem VTT gut lesbar.' },
+    { type: 'title', text: 'Der richtige Rahmen für jeden Charaktertyp', level: 2 },
+    { type: 'list', items: ['<strong>Kreis oder Ring:</strong> bewährt für Spielercharaktere und Verbündete.', '<strong>Sechseck oder Achteck:</strong> ideal zur Unterscheidung in taktischen Gefechten mit vielen Einheiten.', '<strong>Stern:</strong> perfekt für Bosse, Champions oder Schlüsselpersonen.', '<strong>Wolke:</strong> sanfte Form für Geister, Vertraute und Fabelwesen.'] },
+    { type: 'tip', title: 'Entwirf Tokens für die kleinste Spielansicht', html: 'Zoome auf der Karte heraus, bis der Token nur noch wenige Pixel klein ist. Wenn Gesicht, Rahmen und Text weiterhin gut trennbar sind, bleibt der Marker im Spielgeschehen optimal nutzbar.' },
+    { type: 'title', text: 'Kurze und nützliche Beschriftungen am Spieltisch', level: 2 },
+    { type: 'paragraph', html: 'Ein Token ersetzt keinen Charakterbogen. Ergänze nur die ein oder zwei Informationen, die am Tisch ständig gebraucht werden: Name, Stufe oder Status wie benommen. Lange Texte lenken nur vom Porträt ab.' },
+    { type: 'title', text: 'Erstelle ganze Abenteurergruppen mit einheitlichem Stil', level: 2 },
+    { type: 'paragraph', html: 'Der Stapel Export eignet sich hervorragend nach einer Session Zero. Nutze einen gemeinsamen Rahmenstil für die Gruppe, während jedes Gesicht individuell bleibt. Das sorgt für visuellen Zusammenhalt bei klarer Unterscheidbarkeit.' },
+    { type: 'tip', title: 'Automatische Speicherung auf deinem Gerät', html: 'Das lokale Speichern behält den Ausschnitt und die Beschriftung auf deinem Gerät. Exportierte PNGs nutzt du im Spiel; der gespeicherte Marker bleibt deine bearbeitbare Vorlage.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/token-stamp-studio/i18n/en.ts

@@ -0,0 +1,132 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { TokenStampLocaleContent, TokenStampUI } from '../entry';
+
+const ui: TokenStampUI = {
+  frameLegend: 'Choose a frame',
+  frameHint: 'Pick the silhouette that tells the table who this character is before anyone reads the name.',
+  randomFrame: 'Random frame',
+  surfaceLegend: 'Paint the token',
+  backgroundLabel: 'Backdrop',
+  borderLabel: 'Frame',
+  textLabel: 'Lettering',
+  overlayLabel: 'Tint',
+  randomColors: 'Random colours',
+  borderWidthLabel: 'Frame weight',
+  opacityLabel: 'Frame opacity',
+  overlayOpacityLabel: 'Portrait tint',
+  stageLabel: 'Live token forge',
+  chooseImage: 'Choose portrait',
+  clearImage: 'Clear portrait',
+  positionHint: 'Drag the portrait or a label directly on the token.',
+  markerName: 'Marker name',
+  markerNamePlaceholder: 'Name this marker',
+  textLegend: 'Add table readable details',
+  textHint: 'Use short labels such as a name, level, role, or condition. Drag each one on the token.',
+  textPlaceholder: 'Character name or role',
+  addText: 'Add label',
+  removeText: 'Remove label',
+  textSizeLabel: 'Letter size',
+  alignmentLabel: 'Label alignment',
+  alignLeft: 'Align label left',
+  alignCenter: 'Align label center',
+  alignRight: 'Align label right',
+  imageLegend: 'Tune the portrait',
+  imageZoomLabel: 'Portrait zoom',
+  scaleLabel: 'Export scale',
+  savedMarkers: 'Saved markers',
+  noSavedMarkers: 'Saved markers will appear here so you can reopen, edit, and reuse them for another scene.',
+  reuseMarker: 'Select a marker to reopen it in the forge.',
+  deleteMarker: 'Delete marker',
+  newMarker: 'New marker',
+  download: 'Download PNG',
+  copy: 'Copy PNG',
+  downloadBatch: 'Download batch',
+  batchLabel: 'Advanced batch export',
+  batchHint: 'Optional: export several portraits with the current frame and paint settings.',
+  chooseBatch: 'Choose portraits',
+  batchReady: '{count} portraits ready to forge.',
+  noImage: 'No portrait loaded',
+  noText: 'No labels yet. Add the detail your group needs.',
+  tokenDetails: 'Character token controls',
+  exportHint: 'The PNG is transparent outside the chosen silhouette, ready for a virtual tabletop or print sheet.',
+};
+
+const faq = [
+  {
+    question: 'What makes a good character token portrait?',
+    answer: 'Choose art with a clear face or strong silhouette and enough contrast against the frame. A head and shoulders crop usually stays readable when the token is small on a virtual tabletop.',
+  },
+  {
+    question: 'How do I position a portrait inside the frame?',
+    answer: 'Drop in the image, then drag directly on the token to move the crop. Use Portrait zoom to bring a face forward without changing the frame or labels.',
+  },
+  {
+    question: 'Can I add a character name and level?',
+    answer: 'Yes. Add as many short labels as you need, select each label in the inspector, change its size and alignment, and drag it to a readable position on the token.',
+  },
+  {
+    question: 'Does the PNG keep transparency outside the token?',
+    answer: 'Yes. The exported image keeps the outside of the selected silhouette transparent, which makes it easy to place the marker over a map or print a sheet of tokens.',
+  },
+  {
+    question: 'Can I create a whole party at once?',
+    answer: 'Yes. Load several portraits in Batch forge, keep the current frame and paint settings, then download one PNG per portrait. Each file uses its source filename.',
+  },
+  {
+    question: 'Where is my saved marker stored?',
+    answer: 'Save on this device keeps the current marker in local browser storage. It never uploads the portrait, but clearing site data or using another device removes that local copy.',
+  },
+];
+
+const howTo = [
+  { name: 'Choose the character silhouette', text: 'Start with the frame that matches the character mood: ring for a classic hero, hex for a tactical game, star for a champion, or a softer shape for a spirit or fey creature.' },
+  { name: 'Drop in and frame the portrait', text: 'Choose a portrait or drag it onto the live token. Drag the image until the face or defining silhouette sits inside the frame, then adjust Portrait zoom.' },
+  { name: 'Add only the information the table needs', text: 'Add a short name, role, level, or condition. Keep labels brief, choose a readable size, and drag them so the artwork remains visible.' },
+  { name: 'Reuse and export for play', text: 'Your active marker saves as you work. Reopen it from Saved markers, or download a transparent PNG for your virtual tabletop, print sheet, or campaign handout.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Token Stamp Studio',
+  operatingSystem: 'All',
+  applicationCategory: 'DesignApplication',
+  description: 'Create readable character tokens for tabletop RPG maps with custom silhouettes, portraits, labels, transparency, and batch PNG export.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'How to make a tabletop character token',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'token-stamp-studio',
+  title: 'Character Token Maker for Tabletop RPGs',
+  description: 'Forge readable character markers from portraits with expressive frames, draggable crops, labels, transparency, local saving, and batch PNG export.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Make a Character Token That Reads Across the Map', level: 2 },
+    { type: 'paragraph', html: 'A token is a piece of table language. Its silhouette tells the group whether they are looking at a hero, a monster, a spell effect, or a named location before anyone zooms in. Start with the frame that matches the character, then keep the portrait and label readable at the scale your virtual tabletop uses.' },
+    { type: 'title', text: 'Choose the Right Frame for the Character', level: 2 },
+    { type: 'list', items: ['<strong>Ring:</strong> dependable for player characters and recurring allies.', '<strong>Hex or octagon:</strong> easy to distinguish in tactical scenes with many units.', '<strong>Star:</strong> useful for a champion, boss, or character who needs instant attention.', '<strong>Cloud:</strong> a softer signal for spirits, familiars, and fey creatures.'] },
+    { type: 'tip', title: 'Design for the smallest size you will actually play at', html: 'Zoom the map out until a token is only a few dozen pixels wide. If the face, border, and label still separate from one another, the marker will remain useful during a busy encounter.' },
+    { type: 'title', text: 'Keep Labels Short and Useful During Play', level: 2 },
+    { type: 'paragraph', html: 'A character token is not a character sheet. Add the one or two facts the table repeatedly needs: a short name, a level, a role such as healer, or a condition such as stunned. Long sentences become visual noise and compete with the portrait.' },
+    { type: 'title', text: 'Prepare a Whole Party Without Losing Their Identity', level: 2 },
+    { type: 'paragraph', html: 'Batch export is useful after a session zero or when a campaign gains new allies. Choose one frame and paint language for the group, then let each portrait stay individual. Consistent framing makes the party feel like one cast while the faces remain instantly distinct.' },
+    { type: 'tip', title: 'Your marker saves as you work', html: 'Local saving keeps the editable portrait crop and labels on this device. Exported PNGs are the play copies; the saved marker is the version to reopen when the character changes.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/token-stamp-studio/i18n/es.ts

@@ -0,0 +1,132 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { TokenStampLocaleContent, TokenStampUI } from '../entry';
+
+const ui: TokenStampUI = {
+  frameLegend: 'Elige un marco',
+  frameHint: 'Selecciona la silueta que indica a la mesa quién es este personaje antes de leer su nombre.',
+  randomFrame: 'Marco aleatorio',
+  surfaceLegend: 'Pinta la ficha',
+  backgroundLabel: 'Fondo',
+  borderLabel: 'Marco',
+  textLabel: 'Texto',
+  overlayLabel: 'Tinte',
+  randomColors: 'Colores aleatorios',
+  borderWidthLabel: 'Grosor de marco',
+  opacityLabel: 'Opacidad de marco',
+  overlayOpacityLabel: 'Tinte de retrato',
+  stageLabel: 'Forja de fichas en vivo',
+  chooseImage: 'Elegir retrato',
+  clearImage: 'Quitar retrato',
+  positionHint: 'Arrastra el retrato o las etiquetas directamente sobre la ficha.',
+  markerName: 'Nombre del marcador',
+  markerNamePlaceholder: 'Nombra este marcador',
+  textLegend: 'Añade detalles legibles para la mesa',
+  textHint: 'Usa etiquetas cortas como nombre, nivel, rol o estado. Arrastra cada una sobre la ficha.',
+  textPlaceholder: 'Nombre de personaje o rol',
+  addText: 'Añadir etiqueta',
+  removeText: 'Quitar etiqueta',
+  textSizeLabel: 'Tamaño de letra',
+  alignmentLabel: 'Alineación de etiqueta',
+  alignLeft: 'Alinear etiqueta a la izquierda',
+  alignCenter: 'Centrar etiqueta',
+  alignRight: 'Alinear etiqueta a la derecha',
+  imageLegend: 'Ajusta el retrato',
+  imageZoomLabel: 'Zoom de retrato',
+  scaleLabel: 'Escala de exportación',
+  savedMarkers: 'Marcadores guardados',
+  noSavedMarkers: 'Los marcadores guardados aparecerán aquí para reabrir, editar y reutilizar en otra escena.',
+  reuseMarker: 'Selecciona un marcador para reabrirlo en la forja.',
+  deleteMarker: 'Eliminar marcador',
+  newMarker: 'Nuevo marcador',
+  download: 'Descargar PNG',
+  copy: 'Copiar PNG',
+  downloadBatch: 'Descargar lote',
+  batchLabel: 'Exportación avanzada en lote',
+  batchHint: 'Opcional: exporta varios retratos con el marco y colores actuales.',
+  chooseBatch: 'Elegir retratos',
+  batchReady: '{count} retratos listos para forjar.',
+  noImage: 'Ningún retrato cargado',
+  noText: 'Sin etiquetas todavía. Añade la información que tu grupo necesite.',
+  tokenDetails: 'Controles de ficha de personaje',
+  exportHint: 'El PNG es transparente fuera de la silueta elegida, listo para tablero virtual o hoja impresa.',
+};
+
+const faq = [
+  {
+    question: '¿Qué hace que un retrato para ficha de personaje sea bueno?',
+    answer: 'Elige una ilustración con un rostro claro o una silueta fuerte y suficiente contraste respecto al marco. Un recorte de cabeza y hombros se mantiene legible cuando la ficha es pequeña en el tablero virtual.',
+  },
+  {
+    question: '¿Cómo me aseguro de posicionar bien el retrato dentro del marco?',
+    answer: 'Carga la imagen y arrastra directamente sobre la ficha para encuadrar la cara. Usa el zoom de retrato para acercar el rostro sin cambiar la forma del marco ni las etiquetas.',
+  },
+  {
+    question: '¿Puedo añadir el nombre y nivel del personaje?',
+    answer: 'Sí. Añade las etiquetas cortas que necesites, selecciona cada una en el inspector para cambiar su tamaño o alineación y arrástrala a una posición legible sobre la ficha.',
+  },
+  {
+    question: '¿El PNG conserva la transparencia fuera de la ficha?',
+    answer: 'Sí. La imagen exportada mantiene transparente todo el exterior de la silueta seleccionada, lo que facilita colocar el marcador sobre cualquier mapa o imprimirlo en una hoja.',
+  },
+  {
+    question: '¿Puedo crear las fichas de todo un grupo de golpe?',
+    answer: 'Sí. Carga varios retratos en la exportación en lote, mantén el marco y los colores elegidos y descarga un PNG transparente por cada retrato conservando su nombre original.',
+  },
+  {
+    question: '¿Dónde se almacenan mis marcadores guardados?',
+    answer: 'El guardado en este dispositivo conserva el marcador activo en el almacenamiento local del navegador. Nunca sube tus fotos a ningún servidor, pero borrar los datos de navegación o cambiar de dispositivo eliminará la copia local.',
+  },
+];
+
+const howTo = [
+  { name: 'Elige la silueta del personaje', text: 'Comienza seleccionando el marco acorde a la naturaleza del personaje: circular para un héroe clásico, hexagonal para combate táctico, estrella para un campeón o nube para una criatura feérica o espiritual.' },
+  { name: 'Carga y encuadra el retrato', text: 'Selecciona una imagen o arrástrala sobre la ficha en vivo. Muévela hasta que el rostro quede centrado en la silueta y ajusta el zoom de retrato.' },
+  { name: 'Añade la información necesaria para la mesa', text: 'Incluye un nombre corto, rol, nivel o condición. Mantén las etiquetas breves, ajusta un tamaño legible y arrástralas sin tapar los detalles clave de la ilustración.' },
+  { name: 'Reutiliza y exporta para tu partida', text: 'Tu marcador se guarda automáticamente mientras trabajas. Reábrelo desde los marcadores guardados o descarga un PNG transparente para tu tablero virtual o lámina impresa.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Token Stamp Studio',
+  operatingSystem: 'All',
+  applicationCategory: 'DesignApplication',
+  description: 'Crea fichas de personaje legibles para mapas de RPG de mesa con siluetas personalizadas, retratos, etiquetas, transparencia y exportación PNG en lote.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Cómo hacer una ficha de personaje para RPG de mesa',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'creador-fichas-personaje-tokens-rpg',
+  title: 'Creador de Tokens y Fichas de Personaje para RPG de Mesa',
+  description: 'Crea marcadores y fichas de personaje legibles a partir de retratos con marcos expresivos, recortes arrastrabiles, etiquetas, transparencia y exportación PNG en lote.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Crea fichas de personaje legibles a cualquier escala en el mapa', level: 2 },
+    { type: 'paragraph', html: 'Una ficha o token es un elemento de comunicación en la mesa. Su silueta comunica al grupo si se trata de un héroe, un monstruo, un efecto de hechizo o una localización destacada antes de acercar la cámara. Elige el marco adecuado para el personaje y mantén el retrato y las letras claros al tamaño real de tu tablero virtual.' },
+    { type: 'title', text: 'Elige el marco adecuado para la silueta del personaje', level: 2 },
+    { type: 'list', items: ['<strong>Círculo o anillo:</strong> ideal para personajes jugadores y aliados recurrentes.', '<strong>Hexágono u octógono:</strong> fácil de diferenciar en escenas tácticas con muchas unidades.', '<strong>Estrella:</strong> perfecto para un campeón, jefe de zona o personaje que requiere atención inmediata.', '<strong>Nube:</strong> una señal suave para espíritus, familiares y criaturas feéricas.'] },
+    { type: 'tip', title: 'Diseña pensando en el tamaño mínimo al que jugarás', html: 'Aleja el mapa hasta que la ficha tenga solo unas decenas de píxeles de ancho. Si el rostro, el borde y el texto se distinguen con claridad, el marcador funcionará perfectamente en combates concurridos.' },
+    { type: 'title', text: 'Mantén las etiquetas cortas y útiles durante la partida', level: 2 },
+    { type: 'paragraph', html: 'Una ficha de combate no es una hoja de personaje completa. Añade únicamente uno o dos datos que la mesa consulta constantemente: un nombre corto, el nivel, la función principal o una condición como aturdido. Las frases largas generan ruido visual y compiten con la ilustración.' },
+    { type: 'title', text: 'Prepara a todo un grupo de aventureros sin perder su identidad', level: 2 },
+    { type: 'paragraph', html: 'La exportación en lote es excelente tras una sesión cero o al incorporar aliados a la campaña. Selecciona una silueta y esquema de color común para el grupo y deja que cada retrato conserve su personalidad. El encuadre uniforme da cohesión al grupo mientras cada rostro se identifica al instante.' },
+    { type: 'tip', title: 'Tu marcador se guarda mientras trabajas', html: 'El guardado local conserva el encuadre del retrato y las etiquetas en este dispositivo. Los PNG exportados son para jugar; el marcador guardado es la versión que puedes editar cuando el personaje evolucione.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/token-stamp-studio/i18n/fr.ts

@@ -0,0 +1,132 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { TokenStampLocaleContent, TokenStampUI } from '../entry';
+
+const ui: TokenStampUI = {
+  frameLegend: 'Choisir un cadre',
+  frameHint: 'Sélectionnez la silhouette qui indique à la table qui est ce personnage avant même de lire son nom.',
+  randomFrame: 'Cadre aléatoire',
+  surfaceLegend: 'Peindre le jeton',
+  backgroundLabel: 'Arrière-plan',
+  borderLabel: 'Cadre',
+  textLabel: 'Texte',
+  overlayLabel: 'Teinte',
+  randomColors: 'Couleurs aléatoires',
+  borderWidthLabel: 'Épaisseur du cadre',
+  opacityLabel: 'Opacité du cadre',
+  overlayOpacityLabel: 'Teinte du portrait',
+  stageLabel: 'Forge de jetons en direct',
+  chooseImage: 'Choisir un portrait',
+  clearImage: 'Effacer le portrait',
+  positionHint: 'Faites glisser le portrait ou les étiquettes directement sur le jeton.',
+  markerName: 'Nom du marqueur',
+  markerNamePlaceholder: 'Nommer ce marqueur',
+  textLegend: 'Ajouter des détails lisibles',
+  textHint: 'Utilisez des étiquettes courtes comme le nom, le niveau ou le rôle. Glissez chacune sur le jeton.',
+  textPlaceholder: 'Nom ou rôle du personnage',
+  addText: 'Ajouter une étiquette',
+  removeText: 'Retirer l\'étiquette',
+  textSizeLabel: 'Taille du texte',
+  alignmentLabel: 'Alignement du texte',
+  alignLeft: 'Aligner à gauche',
+  alignCenter: 'Centrer',
+  alignRight: 'Aligner à droite',
+  imageLegend: 'Ajuster le portrait',
+  imageZoomLabel: 'Zoom du portrait',
+  scaleLabel: 'Échelle d\'exportation',
+  savedMarkers: 'Marqueurs enregistrés',
+  noSavedMarkers: 'Les marqueurs enregistrés apparaîtront ici pour être réouverts et réutilisés dans une autre scène.',
+  reuseMarker: 'Sélectionnez un marqueur pour le rouvrir dans la forge.',
+  deleteMarker: 'Supprimer le marqueur',
+  newMarker: 'Nouveau marqueur',
+  download: 'Télécharger PNG',
+  copy: 'Copier PNG',
+  downloadBatch: 'Télécharger le lot',
+  batchLabel: 'Exportation avancée en lot',
+  batchHint: 'Optionnel: exportez plusieurs portraits avec le cadre et les couleurs actuels.',
+  chooseBatch: 'Choisir les portraits',
+  batchReady: '{count} portraits prêts à forger.',
+  noImage: 'Aucun portrait chargé',
+  noText: 'Aucune étiquette pour l\'instant. Ajoutez les détails dont votre groupe a besoin.',
+  tokenDetails: 'Commandes du jeton de personnage',
+  exportHint: 'Le PNG est transparent autour de la silhouette choisie, prêt pour table virtuelle ou impression.',
+};
+
+const faq = [
+  {
+    question: 'Qu\'est-ce qui fait un bon portrait pour un jeton de personnage ?',
+    answer: 'Choisissez une illustration avec un visage net et un bon contraste par rapport au cadre. Un cadrage tête et épaules reste parfaitement lisible sur une table virtuelle.',
+  },
+  {
+    question: 'Comment positionner idéalement le portrait dans le cadre ?',
+    answer: 'Chargez l\'image puis faites-la glisser directement sur le jeton. Utilisez le zoom de portrait pour recentrer le visage sans modifier la forme du cadre.',
+  },
+  {
+    question: 'Puis-je ajouter un nom et un niveau de personnage ?',
+    answer: 'Oui. Ajoutez autant d\'étiquettes courtes que nécessaire, ajustez leur taille et leur alignement, puis placez-les sur une zone lisible du jeton.',
+  },
+  {
+    question: 'Le fichier PNG conserve-t-il la transparence autour du jeton ?',
+    answer: 'Oui. L\'image exportée garde le contour de la silhouette transparent, ce qui permet de placer facilement le jeton sur n\'importe quelle carte de jeu.',
+  },
+  {
+    question: 'Puis-je créer les jetons de toute mon équipe d\'un coup ?',
+    answer: 'Oui. Chargez plusieurs portraits dans l\'exportation en lot, conservez le style de cadre et téléchargez un fichier PNG transparent pour chaque portrait.',
+  },
+  {
+    question: 'Où sont stockés mes marqueurs enregistrés ?',
+    answer: 'La sauvegarde locale conserve vos marqueurs dans le navigateur de votre appareil. Aucune image n\'est envoyée vers un serveur distant.',
+  },
+];
+
+const howTo = [
+  { name: 'Choisissez la silhouette du personnage', text: 'Sélectionnez le cadre adapté au rôle: rond pour un héros classique, hexagonal pour le combat tactique ou étoile pour un boss.' },
+  { name: 'Importez et cadrez le portrait', text: 'Choisissez un fichier ou glissez-le sur le jeton. Ajustez la position du visage et le niveau de zoom.' },
+  { name: 'Ajoutez les informations utiles pour la table', text: 'Indiquez un nom court, un niveau ou un état. Gardez les textes brefs pour ne pas masquer l\'illustration.' },
+  { name: 'Enregistrez et exportez en PNG', text: 'Votre marqueur s\'enregistre automatiquement. Téléchargez un PNG transparent prêt à l\'emploi pour votre table virtuelle.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Token Stamp Studio',
+  operatingSystem: 'All',
+  applicationCategory: 'DesignApplication',
+  description: 'Créez des jetons de personnage lisibles pour jeux de rôle sur table avec cadres personnalisés, étiquettes, transparence et export PNG en lot.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Comment créer un jeton de personnage pour JDR',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'createur-tokens-personnages-jdr-table',
+  title: 'Créateur de Tokens et Jetons de Personnage pour JDR',
+  description: 'Créez des jetons de personnage lisibles pour jeux de rôle sur table avec cadres personnalisés, étiquettes, transparence et export PNG en lot.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Concevez des jetons de personnage lisibles sur vos cartes de jeu', level: 2 },
+    { type: 'paragraph', html: 'Un jeton est un outil de communication visuelle à la table de jeu. Sa silhouette indique immédiatement au groupe s\'il s\'agit d\'un héros, d\'un monstre ou d\'un PNJ. Choisissez le cadre approprié et gardez le visage et les textes parfaitement lisibles à petite échelle.' },
+    { type: 'title', text: 'Choisissez le bon cadre selon la nature du personnage', level: 2 },
+    { type: 'list', items: ['<strong>Cercle:</strong> classique et efficace pour les personnages joueurs et alliés.', '<strong>Hexagone ou octogone:</strong> idéal pour distinguer les unités dans les combats tactiques.', '<strong>Étoile:</strong> parfait pour les boss, champions ou cibles prioritaires.', '<strong>Nuage:</strong> adapté aux esprits, familiers et créatures féeriques.'] },
+    { type: 'tip', title: 'Concevez pour la taille minimale utilisée en jeu', html: 'Dézoomez la carte jusqu\'à ce que le jeton ne fasse plus que quelques dizaines de pixels. Si le visage et le cadre restent distincts, votre jeton sera parfait en cours de partie.' },
+    { type: 'title', text: 'Des étiquettes courtes et efficaces autour de la table', level: 2 },
+    { type: 'paragraph', html: 'Un jeton ne doit pas remplacer une feuille de personnage complète. Ajoutez seulement une ou deux informations essentielles: un nom court, un niveau ou un état. Les phrases longues créent du bruit visuel inutilisable.' },
+    { type: 'title', text: 'Préparez toute une équipe sans perdre leur identité', level: 2 },
+    { type: 'paragraph', html: 'L\'exportation en lot permet de traiter l\'ensemble du groupe après une session zéro. Appliquez un cadre commun pour l\'unité visuelle tout en laissant chaque illustration exprimer la personnalité du personnage.' },
+    { type: 'tip', title: 'Sauvegarde automatique dans votre navigateur', html: 'Le jeton actif est sauvegardé localement sur votre appareil. Vous pouvez y revenir à tout moment pour modifier un niveau ou un état au cours de la campagne.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};