@jjlmoya/utils-tabletop 1.26.0 → 1.27.0

package/src/tool/token-stamp-studio/i18n/sv.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: 'Välj en ram',
+  frameHint: 'Välj den silhuett som visar gruppen vem karaktären är innan någon hinner läsa namnet.',
+  randomFrame: 'Slumpmässig ram',
+  surfaceLegend: 'Färglägg din token',
+  backgroundLabel: 'Bakgrund',
+  borderLabel: 'Ram',
+  textLabel: 'Text',
+  overlayLabel: 'Toning',
+  randomColors: 'Slumpmässiga färger',
+  borderWidthLabel: 'Ramtjocklek',
+  opacityLabel: 'Ramopacitet',
+  overlayOpacityLabel: 'Porträttoning',
+  stageLabel: 'Live token-smedja',
+  chooseImage: 'Välj porträtt',
+  clearImage: 'Ta bort porträtt',
+  positionHint: 'Dra porträttet eller etiketter direkt på din token.',
+  markerName: 'Markörnamn',
+  markerNamePlaceholder: 'Namnge denna markör',
+  textLegend: 'Lägg till läsbar information',
+  textHint: 'Använd korta etiketter som namn, nivå eller roll. Dra varje etikett på din token.',
+  textPlaceholder: 'Karaktärsnamn eller roll',
+  addText: 'Lägg till etikett',
+  removeText: 'Ta bort etikett',
+  textSizeLabel: 'Textstorlek',
+  alignmentLabel: 'Textjustering',
+  alignLeft: 'Vänsterjustera',
+  alignCenter: 'Centrera',
+  alignRight: 'Högerjustera',
+  imageLegend: 'Justera porträttet',
+  imageZoomLabel: 'Porträttzoom',
+  scaleLabel: 'Exportskala',
+  savedMarkers: 'Sparade markörer',
+  noSavedMarkers: 'Sparade markörer visas här så att du kan öppna och redigera dem igen.',
+  reuseMarker: 'Välj en markör för att öppna den igen.',
+  deleteMarker: 'Ta bort markör',
+  newMarker: 'Ny markör',
+  download: 'Ladda ner PNG',
+  copy: 'Kopiera PNG',
+  downloadBatch: 'Ladda ner batch',
+  batchLabel: 'Avancerad batchexport',
+  batchHint: 'Valfritt: exportera flera porträtt med nuvarande ram och färger.',
+  chooseBatch: 'Välj porträtt',
+  batchReady: '{count} porträtt redo att smidas.',
+  noImage: 'Inget porträtt laddat',
+  noText: 'Inga etiketter ännu. Lägg till informationen som din spelgrupp behöver.',
+  tokenDetails: 'Token-kontroller',
+  exportHint: 'PNG-filen har transparent bakgrund utanför den valda silhuetten, redo för VTT eller utskrift.',
+};
+
+const faq = [
+  {
+    question: 'Vad gör ett porträtt bra för en karaktärs-token?',
+    answer: 'Välj en bild med tydligt ansikte och bra kontrast mot ramen. En beskärning av huvud och axlar förblir lättläst på det virtuella spelbordet.',
+  },
+  {
+    question: 'Hur placerar jag porträttet bäst i ramen?',
+    answer: 'Ladda upp bilden och dra den direkt på token för att centrera ansiktet. Använd porträttzoom för att förstora utan att ändra ramen.',
+  },
+  {
+    question: 'Kan jag lägga till namnet och nivån på karaktären?',
+    answer: 'Ja. Lägg till korta etiketter, anpassa storlek och justering, och dra dem till en tydlig plats på din token.',
+  },
+  {
+    question: 'Behåller PNG-filen sin transparens utanför ramen?',
+    answer: 'Ja. Den exporterade bilden har genomskinlig bakgrund utanför silhuetten, vilket gör den enkelt att placera över kartor.',
+  },
+  {
+    question: 'Kan jag skapa tokens för hela spelgruppen samtidigt?',
+    answer: 'Ja. Använd batchexport för att ladda upp flera porträtt och ladda ner en transparent PNG för varje bild.',
+  },
+  {
+    question: 'Var sparas mina markörer?',
+    answer: 'Markörerna sparas lokalt i din webbläsare. Inga bilder laddas upp till externa servrar.',
+  },
+];
+
+const howTo = [
+  { name: 'Välj karaktärens silhuett', text: 'Välj en ram som passar rollen: rund för hjältar, sexkantig för taktiska strider eller stjärna för bossar.' },
+  { name: 'Ladda upp och centrera porträttet', text: 'Välj en bild, dra den till din token och justera zoomen så att ansiktet hamnar i mitten.' },
+  { name: 'Lägg till viktig information', text: 'Skriv ett kort namn eller status utan att täcka över viktiga detaljer i bilden.' },
+  { name: 'Exportera som transparent PNG', text: 'Ladda ner din transparenta PNG redo för digitala spelbord eller utskrift.' },
+];
+
+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: 'Skapa tydliga karaktärs-tokens för rollspel med anpassade ramar, etiketter, transparens och batchexport.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Hur man skapar en karaktärs-token för rollspel',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'karaktars-token-skapare-rpg-bordssport',
+  title: 'Skapa Karaktärs Tokens för Rollspel Online',
+  description: 'Skapa tydliga karaktärs-tokens för rollspel med anpassade ramar, etiketter, transparens och batchexport.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Skapa tydliga karaktärs-tokens för alla dina digitala spelkartor', level: 2 },
+    { type: 'paragraph', html: 'En token är ett extremt viktigt visuellt hjälpmedel vid det digitala spelbordet. Silhuetten visar spelgruppen direkt om det rör sig om en hjälte, ett farligt monster, en förtrollningseffekt eller en viktig allierad innan någon ens hinner zooma in på kartan. Välj rätt ram och se till att både bild och text förblir perfekt läsbara på den storlek din virtuella spelplattform använder.' },
+    { type: 'title', text: 'Välj rätt ram för varje unik karaktärstyp i kampanjen', level: 2 },
+    { type: 'list', items: ['<strong>Rund eller ring:</strong> klassisk och pålitlig standard för spelarkaraktärer och återkommande allierade.', '<strong>Sexkant eller åttkant:</strong> mycket enkelt att skilja ut i taktiska strider med många olika enheter.', '<strong>Stjärna:</strong> utmärkt för bossar, mästare och viktiga mål som kräver omedelbar uppmärksamhet.', '<strong>Moln:</strong> en mjuk och stilren form för andar, familjärer och magiska varelser.'] },
+    { type: 'tip', title: 'Designa alltid för den minsta spelstorleken du använder', html: 'Zooma ut på kartan tills din token blir bara ett tiotal pixlar bred. Om ansiktet, ramen och texten fortfarande syns tydligt kommer din token fungera utmärkt under intensiva strider.' },
+    { type: 'title', text: 'Håll alla etiketter korta och praktiska under spelsessionen', level: 2 },
+    { type: 'paragraph', html: 'En token ska aldrig ersätta ett fullständigt karaktärsblad. Lägg bara till den allra viktigaste informationen som gruppen ständigt behöver: ett kort namn, en nivå, en roll eller en status. För långa meningar skapar bara visuellt brus och täcker över bilden.' },
+    { type: 'title', text: 'Skapa tokens för hela spelgruppen samtidigt utan att förlora deras stil', level: 2 },
+    { type: 'paragraph', html: 'Batchexport gör det väldigt enkelt att ge hela gruppen samma visuella ramstil efter session noll medan varje enskilt porträtt behåller sin unika karaktär. En enhetlig inramning skapar sammanhållning i gruppen samtidigt som varje ansikte känns igen direkt.' },
+    { type: 'tip', title: 'Automatisk lokal sparande direkt på din enhet', html: 'Din aktiva markör sparas automatiskt i webbläsaren så att du enkelt kan öppna och redigera den igen när karaktären går upp i nivå.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/token-stamp-studio/i18n/tr.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: 'Bir çerçeve seçin',
+  frameHint: 'Kimse ismi okumadan önce bu karakterin kim olduğunu masaya gösteren silüeti seçin.',
+  randomFrame: 'Rastgele çerçeve',
+  surfaceLegend: 'Pulu renklendirin',
+  backgroundLabel: 'Arka plan',
+  borderLabel: 'Çerçeve',
+  textLabel: 'Yazı',
+  overlayLabel: 'Ton',
+  randomColors: 'Rastgele renkler',
+  borderWidthLabel: 'Çerçeve kalınlığı',
+  opacityLabel: 'Çerçeve saydamlığı',
+  overlayOpacityLabel: 'Portre tonu',
+  stageLabel: 'Canlı pul atölyesi',
+  chooseImage: 'Portre seçin',
+  clearImage: 'Portreyi kaldır',
+  positionHint: 'Portreyi veya etiketleri doğrudan pulun üzerine sürükleyin.',
+  markerName: 'İşaretçi adı',
+  markerNamePlaceholder: 'Bu işaretçiyi adlandırın',
+  textLegend: 'Okunabilir detaylar ekleyin',
+  textHint: 'İsim, seviye, rol gibi kısa etiketler kullanın. Her birini pulun üzerine sürükleyin.',
+  textPlaceholder: 'Karakter adı veya rolü',
+  addText: 'Etiket ekle',
+  removeText: 'Etiketi kaldır',
+  textSizeLabel: 'Yazı boyutu',
+  alignmentLabel: 'Yazı hizalaması',
+  alignLeft: 'Sola hizala',
+  alignCenter: 'Ortala',
+  alignRight: 'Sağa hizala',
+  imageLegend: 'Portreyi ayarlayın',
+  imageZoomLabel: 'Portre yakınlaştırma',
+  scaleLabel: 'Dışa aktarma ölçeği',
+  savedMarkers: 'Kaydedilen işaretçiler',
+  noSavedMarkers: 'Kaydedilen işaretçiler yeniden açıp düzenlemeniz için burada görünecektir.',
+  reuseMarker: 'Yeniden açmak için bir işaretçi seçin.',
+  deleteMarker: 'İşaretçiyi sil',
+  newMarker: 'Yeni işaretçi',
+  download: 'PNG indir',
+  copy: 'PNG kopyala',
+  downloadBatch: 'Toplu indir',
+  batchLabel: 'Gelişmiş toplu dışa aktarma',
+  batchHint: 'İsteğe bağlı: Mevcut çerçeve ve renk ayarlarıyla birden fazla portreyi dışa aktarın.',
+  chooseBatch: 'Portreleri seçin',
+  batchReady: '{count} portre hazırlanmaya hazır.',
+  noImage: 'Portre yüklenmedi',
+  noText: 'Henüz etiket yok. Grubunuzun ihtiyaç duyduğu detayları ekleyin.',
+  tokenDetails: 'Karakter pulu kontrolleri',
+  exportHint: 'PNG dosyası seçilen silüetin dışında şeffaftır, sanal masaüstü veya baskı için hazırdır.',
+};
+
+const faq = [
+  {
+    question: 'İyi bir karakter pulu portresi nasıl olmalıdır?',
+    answer: 'Net bir yüze ve çerçeveye göre yeterli kontrasta sahip bir görsel seçin. Baş ve omuz kesimi sanal masaüstünde pul küçüldüğünde bile okunabilir kalır.',
+  },
+  {
+    question: 'Portreyi çerçeve içine en iyi şekilde nasıl yerleştiririm?',
+    answer: 'Görseli yükleyin ve yüzü ortalamak için doğrudan pul üzerine sürükleyin. Çerçeveyi değiştirmeden yüzü büyütmek için portre yakınlaştırmayı kullanın.',
+  },
+  {
+    question: 'Karakter adı ve seviyesini ekleyebilir miyim?',
+    answer: 'Evet. İstediğiniz kadar kısa etiket ekleyin, boyutunu ve hizalamasını ayarlayın ve pul üzerinde okunabilir bir yere sürükleyin.',
+  },
+  {
+    question: 'PNG dosyası çerçevenin dışında şeffaflığı korur mu?',
+    answer: 'Evet. Dışa aktarılan görsel seçilen silüetin dışını şeffaf tutar, bu da haritalar üzerine yerleştirmeyi kolaylaştırır.',
+  },
+  {
+    question: 'Tüm grup için tek seferde pul oluşturabilir miyim?',
+    answer: 'Evet. Toplu dışa aktarmayı kullanarak birden fazla portre yükleyin ve her biri için şeffaf bir PNG indirin.',
+  },
+  {
+    question: 'Kaydedilen işaretçilerim nerede saklanır?',
+    answer: 'İşaretçiler tarayıcınızın yerel depolama alanında saklanır. Hiçbir görsel harici sunuculara yüklenmez.',
+  },
+];
+
+const howTo = [
+  { name: 'Karakter silüetini seçin', text: 'Role uygun bir çerçeve seçin: kahramanlar için daire, taktik savaşlar için altıgen veya patronlar için yıldız.' },
+  { name: 'Portreyi yükleyin ve ortalayın', text: 'Görseli seçin, pula sürükleyin ve yüz ortalanacak şekilde yakınlaştırmayı ayarlayın.' },
+  { name: 'Önemli bilgileri ekleyin', text: 'Görseli kapatmayacak şekilde kısa bir isim veya durum bilgisi ekleyin.' },
+  { name: 'Şeffaf PNG olarak dışa aktarın', text: 'Sanal masaüstünüzde (VTT) veya baskıda kullanmak üzere şeffaf PNG dosyasını indirin.' },
+];
+
+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: 'Masaüstü RPG oyunları için özel çerçeveli, etiketli, şeffaf ve toplu PNG indirmeli karakter pulları (tokens) oluşturun.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Masaüstü RPG karakter pulu nasıl yapılır',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'rpg-karakter-pulu-olusturucu-masaustu',
+  title: 'Masaüstü RPG Karakter Pulu Oluşturucu (Tokens)',
+  description: 'Masaüstü RPG oyunları için özel çerçeveli, etiketli, şeffaf ve toplu PNG indirmeli karakter pulları (tokens) oluşturun.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Oyun haritanızda son derece net görünen karakter pulları tasarlayın', level: 2 },
+    { type: 'paragraph', html: 'Bir pul, oyun masasındaki en önemli görsel iletişim araçlarından biridir. Silüeti, tüm gruba henüz haritayı yakınlaştırmadan önce bir kahramanla mı, tehlikeli bir canavarla mı yoksa kilit bir müttefikle mi karşı karşıya olduklarını anında gösterir. Doğru çerçeveyi seçin ve sanal masaüstü platformunuzun kullandığı ölçekte hem görselin hem de yazıların mükemmel bir okunabilirlikte kalmasını sağlayın.' },
+    { type: 'title', text: 'Karakter tipine ve rolüne en uygun çerçeveyi seçin', level: 2 },
+    { type: 'list', items: ['<strong>Daire veya halka:</strong> oyuncu karakterleri ve sürekli müttefikler için standart ve güvenilir bir seçim.', '<strong>Altıgen veya sekizgen:</strong> çok birimli taktik savaşlarda birimleri birbirinden kolayca ayırmak için harikadır.', '<strong>Yıldız:</strong> patronlar, şampiyonlar veya hemen dikkat çekmesi gereken önemli hedefler için mükemmeldir.', '<strong>Bulut:</strong> ruhlar, büyülü yaratıklar ve mistik varlıklar için yumuşak bir form.'] },
+    { type: 'tip', title: 'Her zaman aslında oynayacağınız en küçük boyutu hedefleyerek tasarlayın', html: 'Haritayı pul yalnızca birkaç düzine piksel genişliğinde kalana kadar uzaklaştırın. Yüz, çerçeve ve yazı hala net bir şekilde birbirinden ayrılabiliyorsa, pulunuz yoğun savaş anlarında harika çalışacaktır.' },
+    { type: 'title', text: 'Oyun sırasında kısa ve kullanışlı etiketler kullanın', level: 2 },
+    { type: 'paragraph', html: 'Bir pul asla eksiksiz bir karakter kağıdının yerini almaz. Yalnızca masanın sürekli ihtiyaç duyduğu en önemli bilgileri ekleyin: kısa bir isim, seviye veya sersemlemiş gibi bir durum bilgisi. Çok uzun cümleler yalnızca görsel kirlilik yaratır ve portrenin önüne geçer.' },
+    { type: 'title', text: 'Tüm ekibin pullarını kimliklerini kaybetmeden tek seferde hazırlayın', level: 2 },
+    { type: 'paragraph', html: 'Toplu dışa aktarma, her portrenin özgünlüğünü ve benzersizliğini korurken grubun genel stilini birleştirmenize olanak tanır. Tutarlı bir çerçeveleme ekibe görsel bir bütünlük katar.' },
+    { type: 'tip', title: 'Cihazınızda otomatik yerel kaydetme kolaylığı', html: 'Aktif işaretçiniz tarayıcınızda otomatik olarak saklanır, böylece karakter seviye atladığında kolayca yeniden açıp düzenleyebilirsiniz.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/token-stamp-studio/i18n/zh.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: '选择边框',
+  frameHint: '选择能在看到名字前就传达角色身份的轮廓边框。',
+  randomFrame: '随机边框',
+  surfaceLegend: '棋子配色设置',
+  backgroundLabel: '背景颜色',
+  borderLabel: '边框颜色',
+  textLabel: '文字颜色',
+  overlayLabel: '色调覆盖',
+  randomColors: '随机颜色',
+  borderWidthLabel: '边框粗细',
+  opacityLabel: '边框透明度',
+  overlayOpacityLabel: '头像遮罩透明度',
+  stageLabel: '实时棋子锻造台',
+  chooseImage: '选择头像',
+  clearImage: '清除头像',
+  positionHint: '可以直接在棋子上拖动调整头像或文字标签的位置。',
+  markerName: '标记名称',
+  markerNamePlaceholder: '为此标记命名',
+  textLegend: '添加清晰可读的桌面细节',
+  textHint: '使用简短标签（如名字、等级、职业或状态），并将其拖动到棋子上的合适位置。',
+  textPlaceholder: '角色名字或职业',
+  addText: '添加标签',
+  removeText: '移除标签',
+  textSizeLabel: '字体大小',
+  alignmentLabel: '对齐方式',
+  alignLeft: '左对齐',
+  alignCenter: '居中对齐',
+  alignRight: '右对齐',
+  imageLegend: '微调头像',
+  imageZoomLabel: '头像缩放',
+  scaleLabel: '导出比例',
+  savedMarkers: '已保存的标记',
+  noSavedMarkers: '已保存的标记将显示在此处，方便重新打开和编辑。',
+  reuseMarker: '选择标记以重新在锻造台编辑。',
+  deleteMarker: '删除标记',
+  newMarker: '新建标记',
+  download: '下载 PNG',
+  copy: '复制 PNG',
+  downloadBatch: '批量下载',
+  batchLabel: '高级批量导出',
+  batchHint: '可选：使用当前的边框和配色方案批量导出多个头像。',
+  chooseBatch: '选择批量图片',
+  batchReady: '已准备好 {count} 张图片。',
+  noImage: '未加载头像',
+  noText: '暂无标签。请添加团队所需的详细信息。',
+  tokenDetails: '角色棋子控制面板',
+  exportHint: '导出的 PNG 图片在选定轮廓外保持透明，可直接用于跑团软件（VTT）或打印。',
+};
+
+const faq = [
+  {
+    question: '什么样的头像适合制作角色棋子？',
+    answer: '选择面部清晰、与边框对比鲜明的图片。头部和肩膀的近景裁切在虚拟桌面上缩小显示时最清晰。',
+  },
+  {
+    question: '如何在边框内精准调整头像位置？',
+    answer: '导入图片后直接在棋子上拖动。使用头像缩放功能可以放大面部，而无需更改边框形状。',
+  },
+  {
+    question: '可以在棋子上添加角色名字和等级吗？',
+    answer: '可以。添加简短的文本标签，调整字体大小和对齐方式，然后拖动到棋子上的清晰位置。',
+  },
+  {
+    question: '导出的 PNG 图片背景是透明的吗？',
+    answer: '是的。导出的图片在边框轮廓之外保持透明，方便直接覆盖在战场地图上。',
+  },
+  {
+    question: '可以一次性为整个小队制作棋子吗？',
+    answer: '可以。使用批量导出功能，导入多张图片，即可应用相同的边框样式批量生成透明 PNG 棋子。',
+  },
+  {
+    question: '保存的标记保存在哪里？',
+    answer: '标记保存在您浏览器的本地存储中，不会将您的个人图片上传到任何服务器。',
+  },
+];
+
+const howTo = [
+  { name: '选择适合角色的边框', text: '根据角色属性选择边框：圆形适合主角，六边形适合战术棋盘，星形适合 Boss。' },
+  { name: '导入并调整头像位置', text: '拖入图片，调整拖动和缩放比例，使面部处于中央。' },
+  { name: '添加必要的桌面文本', text: '添加简短的名字或状态标签，避免遮挡主要画面。' },
+  { name: '导出透明 PNG', text: '下载透明 PNG 棋子，直接在 VTT 跑团软件中使用。' },
+];
+
+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: 'TRPG 桌面角色棋子（Token）制作工具，支持自定义边框、文本标签、背景透明及批量 PNG 导出。',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: '如何制作跑团角色棋子',
+  step: howTo.map((item) => ({ '@type': 'HowToStep', name: item.name, text: item.text })),
+};
+
+export const content: TokenStampLocaleContent = {
+  slug: 'token-stamp-studio',
+  title: 'TRPG跑团角色棋子在线制作工具 (Token Stamp)',
+  description: 'TRPG 桌面角色棋子（Token）制作工具，支持自定义边框、文本标签、背景透明及批量 PNG 导出。',
+  ui,
+  seo: [
+    { type: 'title', text: '制作在游戏地图上清晰辨识的在线桌面跑团角色棋子', level: 2 },
+    { type: 'paragraph', html: '棋子是桌游和 TRPG 跑团中不可或缺的核心视觉交流工具。棋子的轮廓能够在玩家放大地图细节之前，就直观地传达出当前代表的是英雄、强敌怪物、魔法效果还是重要盟友。为角色选择最契合的边框，并确保人物头像和文本标签在实际缩放比例下依然清晰易读。' },
+    { type: 'title', text: '为不同定位与阵营的角色选择最合适的边框样式', level: 2 },
+    { type: 'list', items: ['<strong>圆形与圆环:</strong> 玩家角色（PC）与常驻盟友的最经典可靠选择。', '<strong>六边形与八边形:</strong> 适合包含大量战斗单位的战术棋盘与战场地图。', '<strong>星形:</strong> 非常适合 Boss 怪物、精英敌人或需要引起注意的重要目标。', '<strong>云朵形:</strong> 适合召唤兽、精灵、魔宠等特殊的存在。'] },
+    { type: 'tip', title: '针对游戏时实际最小显示尺寸进行细致设计', html: '缩小地图视角，观察棋子缩到很小时面部特征与文字是否依然清晰可辨。' },
+    { type: 'title', text: '使用简短而实用的文本标签辅助对局', level: 2 },
+    { type: 'paragraph', html: '跑团棋子无需替代完整的角色卡，只需添加名字、等级或晕眩等状态标签，避免遮挡插画。' },
+    { type: 'title', text: '一键为整个冒险小队制作视觉统一的角色棋子', level: 2 },
+    { type: 'paragraph', html: '批量导出功能可以在保持团队整体视觉规范统一的同时，完美保留每个角色的独特插画。' },
+    { type: 'tip', title: '设备本地自动保存功能', html: '正在制作的标记会自动保存在浏览器本地，随角色升级轻松打开重新编辑。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

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

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../../types';
+import { tokenStampStudio } from './entry';
+
+export * from './entry';
+
+export const TOKEN_STAMP_STUDIO_TOOL: ToolDefinition = {
+  entry: tokenStampStudio,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/token-stamp-studio/logic.test.ts

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { FRAME_PRESETS, clamp, createDefaultState, getFrameGeometry, getStatus, hitTestText } from './logic';
+
+describe('token stamp studio logic', () => {
+  it('starts with a usable foundry state', () => {
+    const state = createDefaultState();
+    expect(state.frameId).toBe(FRAME_PRESETS[0]!.id);
+    expect(state.overlayOpacity).toBe(0);
+    expect(state.imageSrc).toBeNull();
+  });
+
+  it('clamps numeric controls to their safe ranges', () => {
+    expect(clamp(-4, 0, 1)).toBe(0);
+    expect(clamp(2, 0, 1)).toBe(1);
+    expect(clamp(0.4, 0, 1)).toBe(0.4);
+  });
+
+  it('builds a geometry for every frame family', () => {
+    FRAME_PRESETS.forEach((frame) => expect(getFrameGeometry(frame.shape)).toBeDefined());
+    expect(getFrameGeometry('circle').kind).toBe('circle');
+    expect(getFrameGeometry('hexagon').points).toHaveLength(6);
+  });
+
+  it('diagnoses the two empty states before ready', () => {
+    const messages = { statusReady: 'Ready', statusAddImage: 'Add an image', statusAddText: 'Finish the label' };
+    const state = createDefaultState();
+    expect(getStatus(state, messages).message).toBe('Add an image');
+    expect(getStatus({ ...state, imageSrc: 'data:image/png;base64,a', texts: [{ id: 'a', text: '', x: 0.5, y: 0.8, size: 54, align: 'center' }], selectedTextId: 'a' }, messages).message).toBe('Finish the label');
+  });
+
+  it('detects a text layer under the pointer', () => {
+    const layer = { id: 'a', text: 'Goblin', x: 0.5, y: 0.8, size: 54, align: 'center' as const };
+    expect(hitTestText(layer, { x: 0.5, y: 0.8 })).toBe(true);
+    expect(hitTestText(layer, { x: 0.05, y: 0.1 })).toBe(false);
+  });
+});

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

@@ -0,0 +1,127 @@
+import type { FrameGeometry, FramePreset, TextLayer, TokenPalette, TokenStampState, TokenStampStatus } from './types';
+
+export const FRAME_PRESETS: FramePreset[] = [
+  { id: 'ember-ring', name: 'Ember ring', shortName: 'Ring', description: 'A warm double ring for classic character tokens.', shape: 'circle', accent: '#d89555' },
+  { id: 'parchment-square', name: 'Parchment square', shortName: 'Square', description: 'A clean square cut for maps, cards, and item art.', shape: 'square', accent: '#c6a875' },
+  { id: 'hex-warden', name: 'Hex warden', shortName: 'Hex', description: 'A six sided badge with a tactical silhouette.', shape: 'hexagon', accent: '#89b9ae' },
+  { id: 'octagon-steel', name: 'Octagon steel', shortName: 'Octagon', description: 'A hard edged frame for monsters and machines.', shape: 'octagon', accent: '#a9b6c4' },
+  { id: 'star-forge', name: 'Star forge', shortName: 'Star', description: 'A bright eight point emblem for heroes and relics.', shape: 'star', accent: '#e0b35e' },
+  { id: 'diamond-sigil', name: 'Diamond sigil', shortName: 'Diamond', description: 'A turned frame that reads like a spell seal.', shape: 'diamond', accent: '#b48bd0' },
+  { id: 'ticket-relic', name: 'Ticket relic', shortName: 'Ticket', description: 'A notched frame for quests, clues, and locations.', shape: 'ticket', accent: '#d17f69' },
+  { id: 'cloud-echo', name: 'Cloud echo', shortName: 'Cloud', description: 'A soft irregular edge for spirits and fey creatures.', shape: 'cloud', accent: '#84b9ca' },
+  { id: 'scallop-crown', name: 'Scallop crown', shortName: 'Scallop', description: 'A ceremonial edge for bosses and named allies.', shape: 'scallop', accent: '#d4a4b9' },
+];
+
+export const DEFAULT_FRAME_ID = FRAME_PRESETS[0]!.id;
+
+export const COLOR_PALETTES: TokenPalette[] = [
+  { background: '#1d2430', border: '#d89555', text: '#fff4d6', overlay: '#e05b4f' },
+  { background: '#182b2a', border: '#80b8a5', text: '#f5f1dc', overlay: '#d26b5b' },
+  { background: '#29233a', border: '#c49ad7', text: '#fff1ca', overlay: '#6e91ca' },
+  { background: '#33251e', border: '#d4a45f', text: '#fff8e9', overlay: '#8f574c' },
+  { background: '#202c3d', border: '#86a9d3', text: '#f8f0dd', overlay: '#9c668c' },
+  { background: '#243329', border: '#c1b36a', text: '#fffbe3', overlay: '#b86a4e' },
+];
+
+export function clamp(value: number, min: number, max: number): number {
+  return Math.min(max, Math.max(min, value));
+}
+
+export function createDefaultState(): TokenStampState {
+  return {
+    markerName: '',
+    frameId: DEFAULT_FRAME_ID,
+    background: '#1d2430',
+    border: '#d89555',
+    borderWidth: 16,
+    borderOpacity: 1,
+    overlay: '#e05b4f',
+    overlayOpacity: 0,
+    imageSrc: null,
+    imageName: '',
+    imageX: 0,
+    imageY: 0,
+    imageZoom: 1,
+    scale: 1,
+    textColor: '#fff4d6',
+    texts: [],
+    selectedTextId: null,
+  };
+}
+
+export function getFramePreset(frameId: string): FramePreset {
+  return FRAME_PRESETS.find((frame) => frame.id === frameId) ?? FRAME_PRESETS[0]!;
+}
+
+export function getRandomPalette(): TokenPalette {
+  return COLOR_PALETTES[Math.floor(Math.random() * COLOR_PALETTES.length)]!;
+}
+
+function polygonGeometry(sides: number, rotation: number): FrameGeometry {
+  const points = Array.from({ length: sides }, (_, index) => {
+    const angle = rotation + (Math.PI * 2 * index) / sides;
+    return { x: 0.5 + Math.cos(angle) * 0.45, y: 0.5 + Math.sin(angle) * 0.45 };
+  });
+  return { kind: 'polygon', points };
+}
+
+function starGeometry(): FrameGeometry {
+  const points = Array.from({ length: 16 }, (_, index) => {
+    const angle = -Math.PI / 2 + (Math.PI * 2 * index) / 16;
+    const radius = index % 2 === 0 ? 0.45 : 0.25;
+    return { x: 0.5 + Math.cos(angle) * radius, y: 0.5 + Math.sin(angle) * radius };
+  });
+  return { kind: 'polygon', points };
+}
+
+function ticketGeometry(): FrameGeometry {
+  return { kind: 'polygon', points: [
+    { x: 0.24, y: 0.08 }, { x: 0.76, y: 0.08 }, { x: 0.82, y: 0.14 },
+    { x: 0.82, y: 0.86 }, { x: 0.76, y: 0.92 }, { x: 0.24, y: 0.92 },
+    { x: 0.18, y: 0.86 }, { x: 0.18, y: 0.14 },
+  ] };
+}
+
+function scallopGeometry(): FrameGeometry {
+  const points = Array.from({ length: 24 }, (_, index) => {
+    const angle = -Math.PI / 2 + (Math.PI * 2 * index) / 24;
+    const radius = index % 2 === 0 ? 0.45 : 0.38;
+    return { x: 0.5 + Math.cos(angle) * radius, y: 0.5 + Math.sin(angle) * radius };
+  });
+  return { kind: 'polygon', points };
+}
+
+const FRAME_GEOMETRIES: Record<FramePreset['shape'], () => FrameGeometry> = {
+  circle: () => ({ kind: 'circle' }),
+  square: () => polygonGeometry(4, Math.PI / 4),
+  hexagon: () => polygonGeometry(6, -Math.PI / 2),
+  octagon: () => polygonGeometry(8, Math.PI / 8),
+  star: starGeometry,
+  diamond: () => polygonGeometry(4, 0),
+  ticket: ticketGeometry,
+  cloud: () => ({ kind: 'circle' }),
+  scallop: scallopGeometry,
+};
+
+export function getFrameGeometry(shape: FramePreset['shape']): FrameGeometry {
+  return FRAME_GEOMETRIES[shape]();
+}
+
+export function updateTextLayer(texts: TextLayer[], selectedTextId: string | null, update: Partial<TextLayer>): TextLayer[] {
+  return texts.map((text) => text.id === selectedTextId ? { ...text, ...update } : text);
+}
+
+export function createTextLayer(index: number): TextLayer {
+  return { id: `text-${Date.now()}-${index}`, text: 'New label', x: 0.5, y: 0.8, size: 54, align: 'center' };
+}
+
+export function getStatus(state: TokenStampState, ui: { statusReady: string; statusAddImage: string; statusAddText: string }): TokenStampStatus {
+  if (!state.imageSrc) return { tone: 'attention', message: ui.statusAddImage };
+  if (state.texts.some((text) => text.text.trim().length === 0)) return { tone: 'attention', message: ui.statusAddText };
+  return { tone: 'ready', message: ui.statusReady };
+}
+
+export function hitTestText(text: TextLayer, point: { x: number; y: number }): boolean {
+  const width = Math.max(0.12, text.text.length * text.size / 900);
+  return Math.abs(point.x - text.x) <= width / 2 && Math.abs(point.y - text.y) <= text.size / 1100;
+}

package/src/tool/token-stamp-studio/seo.astro

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