@jjlmoya/utils-tabletop 1.11.0 → 1.13.0

package/src/tool/scatter-direction-selector/i18n/ru.ts

@@ -0,0 +1,143 @@
+import { bibliography } from '../bibliography';
+import type { ScatterSelectorLocaleContent } from '../entry';
+
+const ui = {
+  title: 'Выбор Направления Разброса',
+  setupTitle: 'Настройки Разброса',
+  sectorsLabel: 'Секторы Компаса',
+  sectors8: '8 Направлений',
+  sectors12: '12 Направлений (Циферблат)',
+  diceLabel: 'Бросок Дистанции Отклонения',
+  diceD6: '1D6 Дюймов',
+  dice2D6: '2D6 Дюймов',
+  diceD10: '1D10 Дюймов',
+  diceCustom: 'Свой Диапазон',
+  customMaxLabel: 'Максимальная Дистанция',
+  hitChanceLabel: 'Вероятность Прямого Попадания (%)',
+  rollButton: 'Бросить Разброс',
+  hitResult: 'Прямое Попадание!',
+  scatterResult: 'Разброс!',
+  distanceLabel: 'Дистанция',
+  angleLabel: 'Угол',
+  dragHint: 'Перетащите компас, чтобы вручную задать направление ветра',
+  historyTitle: 'Последние Броски',
+  clearHistory: 'Очистить Историю',
+  presetTitle: 'Пресеты для Варгеймов',
+  soundOn: 'Звук Включён',
+  soundOff: 'Звук Выключен',
+  guideStep1: 'Перетащите компас, чтобы совместить его с ориентацией вашего стола',
+  guideStep2: 'Выберите секторы, кости и вероятность прямого попадания',
+  guideStep3: 'Центр = ваша цель. Зелёное свечение означает, что снаряд попал точно туда',
+  guideStep3Scatter: 'Стрелка = направление отклонения. Передвиньте выстрел из центра на столько дюймов вдоль стрелки',
+  scatterModeLabel: 'Направление Разброса',
+  scatterModeRandom: 'Случайное',
+  scatterModeWind: 'Дрейф Ветра',
+  scatterModeWindHint: 'Стрелка всегда следует за компасом - случайна только дистанция',
+};
+
+const faq = [
+  {
+    question: 'Как работает Выбор Направления Разброса?',
+    answer: 'Инструмент вычисляет случайный угол (0-359 градусов) и дистанцию на основе выбранной конфигурации костей. Также симулируется кость разброса с проверкой прямого попадания.',
+  },
+  {
+    question: 'Могу ли я изменить формат секторов?',
+    answer: 'Да, вы можете переключаться между 8-направленными кардинальными секторами и 12-направленными секторами в формате циферблата.',
+  },
+  {
+    question: 'Что такое вероятность прямого попадания?',
+    answer: 'Это шанс того, что снаряд приземлится точно в цель без какого-либо отклонения, симулируя результат «Попадание» на стандартной кости разброса.',
+  },
+  {
+    question: 'Совместимо ли это с Warhammer или Bolt Action?',
+    answer: 'Да, инструмент поддерживает стандартные 8-направленные шаблоны и 12-направленные часовые ориентиры, используемые в большинстве тактических варгеймов и миниатюрных правил.',
+  },
+  {
+    question: 'Как визуально отображается дистанция разброса?',
+    answer: 'Дистанция в дюймах появляется в виде всплывающей метки в точке попадания, расположенной вдоль направления отклонения. Красная стрелка компаса также фиксируется на итоговом угле для быстрого выравнивания шаблона.',
+  },
+  {
+    question: 'Могу ли я отключить анимацию для более быстрых результатов?',
+    answer: 'Анимация длится примерно две секунды, после чего финальный результат отображается в центре, а стрелка компаса фиксируется. В настоящее время нет возможности пропуска, но задержка соответствует темпу броска физических костей.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Настройте Правила',
+    text: 'Выберите секторы компаса, задайте кость дистанции и отрегулируйте вероятность прямого попадания.',
+  },
+  {
+    name: 'Бросайте или Перетаскивайте',
+    text: 'Нажмите Бросить Разброс, чтобы симулировать отклонение, или перетащите колесо компаса для ручной регулировки направления.',
+  },
+  {
+    name: 'Прочитайте Результат',
+    text: 'Проверьте центральный дисплей и векторную стрелку, чтобы узнать точную дистанцию, угол и направление разброса.',
+  },
+  {
+    name: 'Наблюдайте Траекторию',
+    text: 'После броска смотрите, как анимированный снаряд движется по компасу. Пунктирная линия показывает путь отклонения, а точка попадания отображает дистанцию в дюймах.',
+  },
+  {
+    name: 'Интерпретируйте Результат',
+    text: 'Зелёный импульс с надписью «DIRECT HIT» означает нулевое отклонение. Красная вспышка с меткой дистанции означает, что выстрел разбросался - поместите шаблон на это расстояние от цели в направлении стрелки.',
+  },
+];
+
+export const content: ScatterSelectorLocaleContent = {
+  slug: 'vybor-napravleniya-razbrosa',
+  title: 'Выбор Направления Разброса: Тактический Компас для Миниатюрных Варгеймов',
+  description: 'Определяйте случайные отклонения, дрейф ветра и направления разброса для миниатюрных варгеймов с помощью тактильного 3D-компаса.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Интерактивный Компас Разброса с Анимацией Снаряда в Реальном Времени', level: 2 },
+    { type: 'paragraph', html: 'Выбор Направления Разброса выходит за рамки статической генерации чисел, отображая анимированную траекторию снаряда прямо на наложении компаса. Когда вы нажимаете Бросить Разброс, светящийся снаряд движется от центра вдоль угла отклонения, оставляя пунктирный след и взрываясь частицами в точке попадания.' },
+    { type: 'stats', items: [
+      { value: '2', label: 'Системы Секторов', icon: 'mdi:compass-rose' },
+      { value: '4', label: 'Пресеты Костей', icon: 'mdi:dice-d6' },
+      { value: '0-100%', label: 'Диапазон Вероятности Попадания', icon: 'mdi:target' },
+      { value: '10', label: 'История Последних Бросков', icon: 'mdi:history' },
+    ], columns: 4 },
+    { type: 'title', text: 'Как Анимация Траектории Улучшает Принятие Решений в Варгеймах', level: 3 },
+    { type: 'paragraph', html: 'Традиционные инструменты отображают числовой угол и дистанцию, заставляя игроков мысленно визуализировать смещение на столе. Анимированная траектория устраняет этот разрыв, рисуя точный путь полёта от точки прицеливания до зоны приземления разброса.' },
+    { type: 'diagnostic', variant: 'success', title: 'Прямое Попадание', html: 'Когда бросок превышает вероятность попадания, центр компаса взрывается пульсирующими зелёными кольцами и анимацией текста «DIRECT HIT». Снаряд возвращается в центр, подтверждая идеальное попадание без отклонения.' },
+    { type: 'diagnostic', variant: 'error', title: 'Разброс', html: 'При результате разброса снаряд следует пунктирной траектории к точке приземления. Взрыв частиц, светящийся маркер и дистанция в дюймах (напр. <strong>5"</strong>) появляются в месте попадания.' },
+    { type: 'tip', title: 'Совет: Использование Режима Дрейфа Ветра', html: 'Включите Дрейф Ветра, чтобы зафиксировать направление разброса на вручную повёрнутый угол компаса. Это симулирует преобладающий ветер или фиксированный вектор смещения - идеально для неуправляемых ракет, газовых облаков или неудачных телепортаций.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': 'Выбор Направления Разброса',
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': 'Как использовать Выбор Направления Разброса',
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/scatter-direction-selector/i18n/sv.ts

@@ -0,0 +1,143 @@
+import { bibliography } from '../bibliography';
+import type { ScatterSelectorLocaleContent } from '../entry';
+
+const ui = {
+  title: 'Spridningsriktningsväljare',
+  setupTitle: 'Spridningsinställningar',
+  sectorsLabel: 'Kompasssektorer',
+  sectors8: '8 Riktningar',
+  sectors12: '12 Riktningar (Klocka)',
+  diceLabel: 'Avvikelseavstånd Kast',
+  diceD6: '1T6 Tum',
+  dice2D6: '2T6 Tum',
+  diceD10: '1T10 Tum',
+  diceCustom: 'Anpassat Intervall',
+  customMaxLabel: 'Maximalt Avstånd',
+  hitChanceLabel: 'Direktträff Sannolikhet (%)',
+  rollButton: 'Kasta Spridning',
+  hitResult: 'Direktträff!',
+  scatterResult: 'Spridning!',
+  distanceLabel: 'Avstånd',
+  angleLabel: 'Vinkel',
+  dragHint: 'Dra kompassen för att ställa in vindriktningen manuellt',
+  historyTitle: 'Senaste Kast',
+  clearHistory: 'Rensa Historik',
+  presetTitle: 'Wargaming Förinställningar',
+  soundOn: 'Ljud På',
+  soundOff: 'Ljud Av',
+  guideStep1: 'Dra kompassen så att den matchar din bordsorientering',
+  guideStep2: 'Välj sektorer, tärningar och direkt träff chans',
+  guideStep3: 'Mitten = ditt mål. Grönt sken betyder att det landade precis där',
+  guideStep3Scatter: 'Pil = avvikelseriktning. Flytta skottet från mitten så många tum längs pilen',
+  scatterModeLabel: 'Spridningsriktning',
+  scatterModeRandom: 'Slumpmässig',
+  scatterModeWind: 'Vinddrift',
+  scatterModeWindHint: 'Pilen följer alltid kompassen - bara avståndet är slumpmässigt',
+};
+
+const faq = [
+  {
+    question: 'Hur fungerar Spridningsriktningsväljaren?',
+    answer: 'Den beräknar en slumpmässig vinkel (0-359 grader) och ett avstånd baserat på vald tärningskonfiguration. Den simulerar också en spridningstärning och kontrollerar om det blir en direktträff.',
+  },
+  {
+    question: 'Kan jag ändra sektorformatet?',
+    answer: 'Ja, du kan växla mellan 8-riktnings kardinalsektorer och 12-riktnings klocksektorer.',
+  },
+  {
+    question: 'Vad är direktträff sannolikheten?',
+    answer: 'Den representerar chansen att projektilen landar precis där du siktade, utan någon avvikelse eller spridning. Detta simulerar ett "Träff"-resultat på en vanlig spridningstärning.',
+  },
+  {
+    question: 'Är detta kompatibelt med Warhammer eller Bolt Action?',
+    answer: 'Ja, den stöder vanliga 8-riktnings mallar och 12-riktnings klockutriktningar som används i de flesta taktiska krigsspel och miniatyrregler.',
+  },
+  {
+    question: 'Vad visar projektilbananimationen?',
+    answer: 'Ett lysande projektil färdas från kompassens mitt till spridningslandningsplatsen och lämnar ett streckat spår efter sig. Vid en direktträff stannar projektilen i mitten och expanderande gröna ringar pulserar utåt.',
+  },
+  {
+    question: 'Hur visas spridningsavståndet visuellt?',
+    answer: 'Avståndet i tum visas som en flytande etikett vid nedslagspunkten, placerad längs avvikelseriktningen. Den röda kompasspilen låses också till den slutliga vinkeln för snabb mallutriktning.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Konfigurera Regler',
+    text: 'Välj kompasssektorer, välj en avståndstärning och justera direktträff sannolikheten.',
+  },
+  {
+    name: 'Kasta eller Dra',
+    text: 'Klicka på Kasta Spridning för att simulera avvikelsen, eller dra i kompasshjulet för att justera riktningen manuellt.',
+  },
+  {
+    name: 'Läs Utfallet',
+    text: 'Kontrollera den centrala displayen och vektorpilen för att hitta det exakta avståndet, vinkeln och riktningen för spridningen.',
+  },
+  {
+    name: 'Observera Banan',
+    text: 'Efter kastet, observera det animerade projektilen färdas över kompassen. Det streckade spåret visar avvikelsevägen och nedslagspunkten visar avståndet i tum.',
+  },
+  {
+    name: 'Tolka Resultatet',
+    text: 'En grön puls med "DIRECT HIT" betyder ingen avvikelse. En röd explosion med en avståndsetikett betyder att skottet spreds  -  placera din mall så många tum från målet i pilens riktning.',
+  },
+];
+
+export const content: ScatterSelectorLocaleContent = {
+  slug: 'spridningsriktningsvaljare',
+  title: 'Spridningsriktningsväljare: Taktisk Kompass för Bordsspel Wargaming',
+  description: 'Bestäm slumpmässiga avvikelser, vinddrift och spridningsriktningar för miniatyr krigsspel med en taktil 3D-kompass.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Interaktiv Spridningskompass med Realtids Projektilanimation', level: 2 },
+    { type: 'paragraph', html: 'Spridningsriktningsväljaren går bortom statisk nummergenerering genom att rendera en animerad projektilbana direkt på kompassöverlägget. När du klickar på Kasta Spridning färdas ett lysande projektil från mitten längs avvikelsevinkeln, lämnar ett streckat spår och brister i partiklar vid nedslagspunkten.' },
+    { type: 'stats', items: [
+      { value: '2', label: 'Sektorsystem', icon: 'mdi:compass-rose' },
+      { value: '4', label: 'Tärnings Förinställningar', icon: 'mdi:dice-d6' },
+      { value: '0-100%', label: 'Träff Sannolikhetsintervall', icon: 'mdi:target' },
+      { value: '10', label: 'Senaste Kast Historik', icon: 'mdi:history' },
+    ], columns: 4 },
+    { type: 'title', text: 'Hur Bananimationen Förbättrar Beslutsfattande vid Wargaming', level: 3 },
+    { type: 'paragraph', html: 'Traditionella spridningsverktyg visar en numerisk vinkel och ett avstånd, vilket tvingar spelare att mentalt visualisera förskjutningen på bordet. Den animerade banan överbryggar detta gap genom att rita den exakta flygvägen från siktningspunkten till spridningslandningszonen.' },
+    { type: 'diagnostic', variant: 'success', title: 'Direktträff', html: 'När kastet slår träffsannolikheten, briserar kompassens mitt med pulserande gröna ringar och en "DIRECT HIT" textanimation. Projektilet återvänder till mitten och bekräftar en perfekt träff utan avvikelse.' },
+    { type: 'diagnostic', variant: 'error', title: 'Spridning', html: 'Vid ett spridningsresultat följer projektilen en streckad bana till sin landningsplats. En partikelexplosion, en lysande markör och avståndet i tum (t.ex. <strong>5"</strong>) visas på landningsplatsen.' },
+    { type: 'tip', title: 'Proffstips: Använd Vinddrift Läge', html: 'Aktivera Vinddrift för att låsa spridningsriktningen till din manuellt roterade kompassvinkel. Simulerar en rådande vind eller en fast förskjutningsvektor  -  idealisk för ostyrda raketer, gasmoln eller misslyckade teleporteringar.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': 'Spridningsriktningsväljare',
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': 'Hur du använder Spridningsriktningsväljaren',
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/scatter-direction-selector/i18n/tr.ts

@@ -0,0 +1,143 @@
+import { bibliography } from '../bibliography';
+import type { ScatterSelectorLocaleContent } from '../entry';
+
+const ui = {
+  title: 'Sapma Yönü Seçici',
+  setupTitle: 'Sapma Ayarları',
+  sectorsLabel: 'Pusula Sektörleri',
+  sectors8: '8 Yön',
+  sectors12: '12 Yön (Saat)',
+  diceLabel: 'Sapma Mesafesi Zarı',
+  diceD6: '1D6 İnç',
+  dice2D6: '2D6 İnç',
+  diceD10: '1D10 İnç',
+  diceCustom: 'Özel Aralık',
+  customMaxLabel: 'Maksimum Mesafe',
+  hitChanceLabel: 'Doğrudan İsabet Olasılığı (%)',
+  rollButton: 'Sapma Atışı Yap',
+  hitResult: 'Doğrudan İsabet!',
+  scatterResult: 'Sapma!',
+  distanceLabel: 'Mesafe',
+  angleLabel: 'Açı',
+  dragHint: 'Rüzgar yönünü elle ayarlamak için pusulayı sürükleyin',
+  historyTitle: 'Son Atışlar',
+  clearHistory: 'Geçmişi Temizle',
+  presetTitle: 'Savaş Oyunu Hazır Ayarları',
+  soundOn: 'Ses Açık',
+  soundOff: 'Ses Kapalı',
+  guideStep1: 'Pusulayı masa yönünüze uyacak şekilde sürükleyin',
+  guideStep2: 'Sektörleri, zarları ve doğrudan isabet şansını seçin',
+  guideStep3: 'Merkez = hedefiniz. Yeşil parlama tam isabet anlamına gelir',
+  guideStep3Scatter: 'Ok = sapma yönü. Atışı merkezden o kadar inç ok yönünde hareket ettirin',
+  scatterModeLabel: 'Sapma Yönü',
+  scatterModeRandom: 'Rastgele',
+  scatterModeWind: 'Rüzgar Sürüklenmesi',
+  scatterModeWindHint: 'Ok her zaman pusulayı takip eder - yalnızca mesafe rastgeledir',
+};
+
+const faq = [
+  {
+    question: 'Sapma Yönü Seçici nasıl çalışır?',
+    answer: 'Seçilen zar yapılandırmasına göre rastgele bir açı (0-359 derece) ve mesafe hesaplar. Ayrıca bir sapma zarını simüle ederek doğrudan isabetleri kontrol eder.',
+  },
+  {
+    question: 'Sektör formatını değiştirebilir miyim?',
+    answer: 'Evet, 8 yönlü ana yön sektörleri ile 12 yönlü saat kadranı sektörleri arasında geçiş yapabilirsiniz.',
+  },
+  {
+    question: 'Doğrudan isabet olasılığı nedir?',
+    answer: 'Merminin hedeflenen noktaya herhangi bir sapma olmadan tam olarak düşme şansını temsil eder ve standart bir sapma zarında «İsabet» sonucunu simüle eder.',
+  },
+  {
+    question: 'Bu araç Warhammer veya Bolt Action ile uyumlu mu?',
+    answer: 'Evet, çoğu taktik savaş oyunu ve minyatür kural setinde kullanılan standart 8 yönlü şablonları ve 12 yönlü saat hizalamalarını destekler.',
+  },
+  {
+    question: 'Sapma mesafesi görsel olarak nasıl gösterilir?',
+    answer: 'İnç cinsinden mesafe, çarpma noktasında sapma yönü boyunca konumlanmış bir etiket olarak görünür. Kırmızı pusula oku da hızlı şablon hizalaması için son açıya kilitlenir.',
+  },
+  {
+    question: 'Daha hızlı sonuç almak için animasyonu devre dışı bırakabilir miyim?',
+    answer: 'Animasyon yaklaşık iki saniye sürer, ardından nihai sonuç merkezde görüntülenir ve pusula oku kilitlenir. Şu anda atlama seçeneği yoktur, ancak gecikme fiziksel zar atma temposuna uyacak şekilde tasarlanmıştır.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Kuralları Yapılandırın',
+    text: 'Pusula sektörlerini seçin, bir mesafe zarı ön ayarı belirleyin ve doğrudan isabet şansını ayarlayın.',
+  },
+  {
+    name: 'Atın veya Sürükleyin',
+    text: 'Sapmayı simüle etmek için Sapma Atışı Yap düğmesine tıklayın veya yönü elle ayarlamak için pusula çarkını sürükleyin.',
+  },
+  {
+    name: 'Sonucu Okuyun',
+    text: 'Merkez ekranı ve vektör okunu kontrol ederek sapmanın tam mesafesini, açısını ve yönünü bulun.',
+  },
+  {
+    name: 'Yörüngeyi İzleyin',
+    text: 'Atıştan sonra animasyonlu merminin pusula üzerinde hareket etmesini izleyin. Kesik çizgi sapma yolunu gösterir ve çarpma noktası mesafeyi inç cinsinden görüntüler.',
+  },
+  {
+    name: 'Sonucu Yorumlayın',
+    text: '«DIRECT HIT» yazısıyla birlikte yeşil bir darbe sıfır sapma anlamına gelir. Mesafe etiketiyle birlikte kırmızı bir patlama, atışın saptığı anlamına gelir - şablonunuzu hedeften bu kadar inç uzağa, ok yönünde yerleştirin.',
+  },
+];
+
+export const content: ScatterSelectorLocaleContent = {
+  slug: 'sapma-yonu-secici',
+  title: 'Sapma Yönü Seçici: Minyatür Savaş Oyunları için Pusula',
+  description: 'Minyatür savaş oyunları için 3B dokunsal bir pusula kullanarak rastgele sapmaları, rüzgar sürüklenmesini ve dağılım yönlerini belirleyin.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Gerçek Zamanlı Mermi Animasyonlu Etkileşimli Sapma Pusulası', level: 2 },
+    { type: 'paragraph', html: 'Sapma Yönü Seçici, statik sayı üretiminin ötesine geçerek pusula katmanı üzerinde animasyonlu bir mermi yörüngesi oluşturur. Sapma Atışı Yap düğmesine tıkladığınızda, parlayan bir mermi merkezden sapma açısı boyunca ilerler, kesik bir iz bırakır ve çarpma noktasında parçacıklara ayrılır.' },
+    { type: 'stats', items: [
+      { value: '2', label: 'Sektör Sistemi', icon: 'mdi:compass-rose' },
+      { value: '4', label: 'Zar Hazır Ayarları', icon: 'mdi:dice-d6' },
+      { value: '0-100%', label: 'İsabet Olasılığı Aralığı', icon: 'mdi:target' },
+      { value: '10', label: 'Son Atış Geçmişi', icon: 'mdi:history' },
+    ], columns: 4 },
+    { type: 'title', text: 'Yörünge Animasyonu Savaş Oyunu Kararlarını Nasıl İyileştirir', level: 3 },
+    { type: 'paragraph', html: 'Geleneksel sapma araçları sayısal bir açı ve mesafe görüntüleyerek oyuncuların masadaki kaymayı zihinsel olarak canlandırmasını zorunlu kılar. Animasyonlu yörünge, nişan noktasından sapma iniş bölgesine kadar tam uçuş yolunu çizerek bu boşluğu kapatır.' },
+    { type: 'diagnostic', variant: 'success', title: 'Doğrudan İsabet', html: 'Atış isabet olasılığını geçtiğinde, pusula merkezi titreşen yeşil halkalar ve «DIRECT HIT» metin animasyonu ile aydınlanır. Mermi merkeze dönerek sıfır sapma ile mükemmel isabeti onaylar.' },
+    { type: 'diagnostic', variant: 'error', title: 'Sapma', html: 'Sapma sonucunda mermi, iniş noktasına kadar kesik bir yörünge izler. Bir parçacık patlaması, parlayan bir işaret ve inç cinsinden mesafe (örn. <strong>5"</strong>) çarpma noktasında belirir.' },
+    { type: 'tip', title: 'İpucu: Rüzgar Sürüklenmesi Modunu Kullanma', html: 'Sapma yönünü elle döndürdüğünüz pusula açısına kilitlemek için Rüzgar Sürüklenmesini açın. Bu, baskın bir rüzgarı veya sabit bir yer değiştirme vektörünü simüle eder - güdümsüz roketler, gaz bulutları veya başarısız teleportasyonlar için idealdir.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': 'Sapma Yönü Seçici',
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': 'Sapma Yönü Seçici nasıl kullanılır',
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/scatter-direction-selector/i18n/zh.ts

@@ -0,0 +1,143 @@
+import { bibliography } from '../bibliography';
+import type { ScatterSelectorLocaleContent } from '../entry';
+
+const ui = {
+  title: '散布方向选择器',
+  setupTitle: '散布设置',
+  sectorsLabel: '罗盘扇区',
+  sectors8: '8方向',
+  sectors12: '12方向（时钟）',
+  diceLabel: '偏差距离掷骰',
+  diceD6: '1D6 英寸',
+  dice2D6: '2D6 英寸',
+  diceD10: '1D10 英寸',
+  diceCustom: '自定义范围',
+  customMaxLabel: '最大距离',
+  hitChanceLabel: '直接命中概率（%）',
+  rollButton: '掷骰散布',
+  hitResult: '直接命中！',
+  scatterResult: '散布！',
+  distanceLabel: '距离',
+  angleLabel: '角度',
+  dragHint: '拖动罗盘手动设置风向',
+  historyTitle: '最近掷骰',
+  clearHistory: '清除历史',
+  presetTitle: '战棋预设',
+  soundOn: '音效开',
+  soundOff: '音效关',
+  guideStep1: '拖动罗盘以匹配您的桌面方向',
+  guideStep2: '选择扇区、骰子和直接命中概率',
+  guideStep3: '中心 = 您的目标。绿色光晕表示它准确落在了那里',
+  guideStep3Scatter: '箭头 = 偏差方向。从中心沿箭头方向移动相应的英寸数',
+  scatterModeLabel: '散布方向',
+  scatterModeRandom: '随机',
+  scatterModeWind: '风偏',
+  scatterModeWindHint: '箭头始终跟随罗盘 - 仅距离为随机',
+};
+
+const faq = [
+  {
+    question: '散布方向选择器如何工作？',
+    answer: '它根据选定的骰子配置计算随机角度（0-359度）和距离。同时模拟散布骰子，检查是否直接命中。',
+  },
+  {
+    question: '我可以更改扇区格式吗？',
+    answer: '可以，您可以在8方向基本扇区和12方向钟面扇区之间切换。',
+  },
+  {
+    question: '什么是直接命中概率？',
+    answer: '它代表抛射物精确命中目标而无任何偏差的概率，模拟标准散布骰子上的"命中"结果。',
+  },
+  {
+    question: '这与Warhammer或Bolt Action兼容吗？',
+    answer: '是的，它支持大多数战术战棋和微缩模型规则集中使用的标准8方向模板和12方向时钟对齐方式。',
+  },
+  {
+    question: '散布距离在视觉上如何显示？',
+    answer: '距离（英寸）作为浮动标签出现在撞击点，沿偏差方向定位。红色罗盘箭头也会锁定到最终角度，便于快速对齐模板。',
+  },
+  {
+    question: '我可以禁用动画以更快获得结果吗？',
+    answer: '动画持续约两秒，之后最终结果显示在中央，罗盘箭头锁定。目前没有跳过选项，但该延迟设计为与掷物理骰子的节奏相匹配。',
+  },
+];
+
+const howTo = [
+  {
+    name: '配置规则',
+    text: '选择罗盘扇区，选择距离骰子预设，调整直接命中概率。',
+  },
+  {
+    name: '掷骰或拖动',
+    text: '单击"掷骰散布"模拟偏差，或拖动罗盘滚轮手动调整方向。',
+  },
+  {
+    name: '读取结果',
+    text: '查看中央显示和矢量箭头，了解散布的确切距离、角度和方向。',
+  },
+  {
+    name: '观察轨迹',
+    text: '掷骰后，观察动画抛射物穿越罗盘。虚线轨迹显示偏差路径，撞击点显示距离（英寸）。',
+  },
+  {
+    name: '解读结果',
+    text: '绿色脉冲和"DIRECT HIT"表示零偏差。带有距离标签的红色爆炸表示散布 - 将模板从目标沿箭头方向放置相应的英寸数。',
+  },
+];
+
+export const content: ScatterSelectorLocaleContent = {
+  slug: 'scatter-direction-selector',
+  title: '散布方向选择器: 桌面战棋罗盘',
+  description: '使用3D触觉罗盘，为微缩模型战棋确定随机偏差、风偏和散布方向。',
+  ui,
+  seo: [
+    { type: 'title', text: '带有实时抛射物动画的交互式散布罗盘', level: 2 },
+    { type: 'paragraph', html: '散布方向选择器超越了静态数字生成，直接在罗盘覆盖层上渲染动画抛射物轨迹。当您单击"掷骰散布"时，发光的抛射物从中心沿偏差角度移动，留下虚线轨迹并在撞击点爆裂成粒子。' },
+    { type: 'stats', items: [
+      { value: '2', label: '扇区系统', icon: 'mdi:compass-rose' },
+      { value: '4', label: '骰子预设', icon: 'mdi:dice-d6' },
+      { value: '0-100%', label: '命中概率范围', icon: 'mdi:target' },
+      { value: '10', label: '最近掷骰历史', icon: 'mdi:history' },
+    ], columns: 4 },
+    { type: 'title', text: '轨迹动画如何提升战棋决策能力', level: 3 },
+    { type: 'paragraph', html: '传统的散布工具显示数字角度和距离，迫使玩家在脑海中想象桌面上的偏移量。动画轨迹通过绘制从瞄准点到散布着陆区的精确飞行路径，弥合了这一差距。' },
+    { type: 'diagnostic', variant: 'success', title: '直接命中', html: '当掷骰超过命中概率时，罗盘中心会爆发脉动的绿色光环和"DIRECT HIT"文字动画。抛射物返回中心，确认完美命中且零偏差。' },
+    { type: 'diagnostic', variant: 'error', title: '散布', html: '在散布结果中，抛射物沿虚线轨迹移动到着陆点。粒子爆炸、发光标记和距离（英寸）（例如 <strong>5"</strong>）出现在撞击位置。' },
+    { type: 'tip', title: '专业提示: 使用风偏模式', html: '启用风偏可将散布方向锁定到您手动旋转的罗盘角度。这模拟了盛行风或固定位移矢量 - 非常适合无制导火箭、毒气云或传送事故。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': '散布方向选择器',
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': '如何使用散布方向选择器',
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/scatter-direction-selector/index.ts

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

package/src/tool/scatter-direction-selector/logic.test.ts

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { calculateDistance, rollScatter, getSectorIndex } from './logic';
+
+describe('ScatterDirectionSelector Logic', () => {
+  describe('calculateDistance', () => {
+    it('returns a number within the expected D6 range', () => {
+      const config = { diceType: 'd6' as const, customMax: 6, hitChance: 33 };
+      const dist = calculateDistance(config);
+      expect(dist).toBeGreaterThanOrEqual(1);
+      expect(dist).toBeLessThanOrEqual(6);
+    });
+
+    it('returns a number within the expected 2D6 range', () => {
+      const config = { diceType: '2d6' as const, customMax: 12, hitChance: 33 };
+      const dist = calculateDistance(config);
+      expect(dist).toBeGreaterThanOrEqual(2);
+      expect(dist).toBeLessThanOrEqual(12);
+    });
+
+    it('returns a number within the custom range', () => {
+      const config = { diceType: 'custom' as const, customMax: 20, hitChance: 33 };
+      const dist = calculateDistance(config);
+      expect(dist).toBeGreaterThanOrEqual(1);
+      expect(dist).toBeLessThanOrEqual(20);
+    });
+  });
+
+  describe('rollScatter', () => {
+    it('returns isHit as true when hitChance is 100', () => {
+      const config = { diceType: 'd6' as const, customMax: 6, hitChance: 100 };
+      const res = rollScatter(config);
+      expect(res.isHit).toBe(true);
+      expect(res.distance).toBe(0);
+    });
+
+    it('returns isHit as false and positive distance when hitChance is 0', () => {
+      const config = { diceType: 'd6' as const, customMax: 6, hitChance: 0 };
+      const res = rollScatter(config);
+      expect(res.isHit).toBe(false);
+      expect(res.distance).toBeGreaterThanOrEqual(1);
+      expect(res.angle).toBeGreaterThanOrEqual(0);
+      expect(res.angle).toBeLessThan(360);
+    });
+  });
+
+  describe('getSectorIndex', () => {
+    it('correctly maps 0 degrees to sector index 0', () => {
+      const idx8 = getSectorIndex(0, 8);
+      expect(idx8).toBe(0);
+
+      const idx12 = getSectorIndex(0, 12);
+      expect(idx12).toBe(0);
+    });
+
+    it('maps angles correctly within sectors boundary', () => {
+      expect(getSectorIndex(45, 8)).toBe(1);
+      expect(getSectorIndex(90, 8)).toBe(2);
+      expect(getSectorIndex(180, 8)).toBe(4);
+      expect(getSectorIndex(270, 8)).toBe(6);
+    });
+  });
+});