@jjlmoya/utils-games-development 1.63.0 → 1.65.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-games-development",
-    "version": "1.63.0",
+    "version": "1.65.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -6,10 +6,12 @@ import { saveFileEditor } from '../tool/saveFileEditor/entry';
 import { steamBbcodeTranslator } from '../tool/steamBbcodeTranslator/entry';
 import { gameUiAccessibilityTester } from '../tool/gameUIAccessibilityTester/entry';
 import { hitboxHurtboxAnimator } from '../tool/hitboxHurtboxAnimator/entry';
+import { damageFormulaLab } from '../tool/damageFormulaLab/entry';
+import { gameDeltaTimeFixedTimestepLab } from '../tool/gameDeltaTimeFixedTimestepLab/entry';
 
 export const gamesCategory: GamesCategoryEntry = {
   icon: 'mdi:gamepad-variant',
-  tools: [steamCapsuleGenerator, spriteSheetPacker, audioLoopPointFinder, saveFileEditor, steamBbcodeTranslator, gameUiAccessibilityTester, hitboxHurtboxAnimator],
+  tools: [steamCapsuleGenerator, spriteSheetPacker, audioLoopPointFinder, saveFileEditor, steamBbcodeTranslator, gameUiAccessibilityTester, hitboxHurtboxAnimator, damageFormulaLab, gameDeltaTimeFixedTimestepLab],
   i18n: {
     de: () => import('./i18n/de').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -18,6 +18,10 @@ export { pixelArtPaletteSwapper } from './tool/pixelArtPaletteSwapper/entry';
 export type { PixelArtPaletteSwapperUI, PixelArtPaletteSwapperLocaleContent } from './tool/pixelArtPaletteSwapper/entry';
 export { hitboxHurtboxAnimator } from './tool/hitboxHurtboxAnimator/entry';
 export type { HitboxHurtboxAnimatorUI, HitboxHurtboxAnimatorLocaleContent } from './tool/hitboxHurtboxAnimator/entry';
+export { damageFormulaLab } from './tool/damageFormulaLab/entry';
+export type { DamageFormulaLabUI, DamageFormulaLabLocaleContent } from './tool/damageFormulaLab/entry';
+export { gameDeltaTimeFixedTimestepLab } from './tool/gameDeltaTimeFixedTimestepLab/entry';
+export type { GameDeltaTimeFixedTimestepLabUI, GameDeltaTimeFixedTimestepLabLocaleContent } from './tool/gameDeltaTimeFixedTimestepLab/entry';
 export { gamesCategory } from './category';
 import { steamCapsuleGenerator } from './tool/steamCapsuleGenerator/entry';
 import { itchioGameTester } from './tool/itchioGameTester/entry';
@@ -30,5 +34,7 @@ import { retroSfxGenerator } from './tool/retroSfxGenerator/entry';
 import { pixelArtPaletteSwapper } from './tool/pixelArtPaletteSwapper/entry';
 import { gameUiAccessibilityTester } from './tool/gameUIAccessibilityTester/entry';
 import { hitboxHurtboxAnimator } from './tool/hitboxHurtboxAnimator/entry';
+import { damageFormulaLab } from './tool/damageFormulaLab/entry';
+import { gameDeltaTimeFixedTimestepLab } from './tool/gameDeltaTimeFixedTimestepLab/entry';
 
-export const ALL_ENTRIES = [steamCapsuleGenerator, itchioGameTester, spriteSheetPacker, audioLoopPointFinder, saveFileEditor, localizationSanitizer, steamBbcodeTranslator, retroSfxGenerator, pixelArtPaletteSwapper, gameUiAccessibilityTester, hitboxHurtboxAnimator];
+export const ALL_ENTRIES = [steamCapsuleGenerator, itchioGameTester, spriteSheetPacker, audioLoopPointFinder, saveFileEditor, localizationSanitizer, steamBbcodeTranslator, retroSfxGenerator, pixelArtPaletteSwapper, gameUiAccessibilityTester, hitboxHurtboxAnimator, damageFormulaLab, gameDeltaTimeFixedTimestepLab];

package/src/index.ts

@@ -22,5 +22,6 @@ export { RETRO_SFX_GENERATOR_TOOL, retroSfxGenerator } from './tool/retroSfxGene
 export { PIXEL_ART_PALETTE_SWAPPER_TOOL, pixelArtPaletteSwapper } from './tool/pixelArtPaletteSwapper';
 export { GAME_UI_ACCESSIBILITY_TESTER_TOOL, gameUiAccessibilityTester } from './tool/gameUIAccessibilityTester';
 export { HITBOX_HURTBOX_ANIMATOR_TOOL, hitboxHurtboxAnimator } from './tool/hitboxHurtboxAnimator';
+export { DAMAGE_FORMULA_LAB_TOOL, damageFormulaLab } from './tool/damageFormulaLab';
 
 export type { ToolLocaleContent as GamesToolLocaleContent } from './types';

package/src/tests/locale_completeness.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect } from 'vitest';
 import { ALL_TOOLS } from '../tools';
 
 describe('Locale Completeness Validation', () => {
-  it('eleven tools are registered', () => {
-    expect(ALL_TOOLS.length).toBe(11);
+  it('thirteen tools are registered', () => {
+    expect(ALL_TOOLS.length).toBe(13);
   });
 });

package/src/tests/seo_parity.test.ts

@@ -26,8 +26,8 @@ async function verifyLocaleParity(
 
   expect(
     locSeoCount,
-    `Locale ${loc} SEO sections count (${locSeoCount}) must match EN (${expected.seo})`,
-  ).toBe(expected.seo);
+    `Locale ${loc} SEO sections count (${locSeoCount}) must include the English base (${expected.seo})`,
+  ).toBeGreaterThanOrEqual(expected.seo);
   expect(
     locFaqCount,
     `Locale ${loc} FAQ items count (${locFaqCount}) must match EN (${expected.faq})`,

package/src/tests/seo_translation_completeness.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const ASIAN_LOCALES = ['ja', 'ko', 'zh'];
+
+function getSimpleSectionLength(section: any): number {
+  if (section.type === 'title') return section.text ? section.text.length : 0;
+  if (section.type === 'paragraph') return section.html ? section.html.replace(/<[^>]*>/g, '').length : 0;
+  if (section.type === 'list') return section.items ? section.items.join('').length : 0;
+  return 0;
+}
+
+function getComplexSectionLength(section: any): number {
+  if (section.type === 'diagnostic' || section.type === 'tip') {
+    return (section.title ? section.title.length : 0) + (section.html ? section.html.replace(/<[^>]*>/g, '').length : 0);
+  }
+  if (section.type === 'table') {
+    return ((section.headers || []).join('').length) + ((section.rows || []).flat().join('').length);
+  }
+  return 0;
+}
+
+function getSectionLength(section: any): number {
+  return getSimpleSectionLength(section) || getComplexSectionLength(section);
+}
+
+function calculateSeoTextLength(seoSections: any[]): number {
+  return seoSections.reduce((acc, section) => acc + getSectionLength(section), 0);
+}
+
+function checkLocaleSeoLength(toolId: string, locale: string, localeLen: number, enLen: number): void {
+  const isAsian = ASIAN_LOCALES.includes(locale);
+  const minLength = Math.floor(enLen * (isAsian ? 0.25 : 0.70));
+  const msgType = isAsian ? 'suspiciously short' : 'truncated/lazy';
+
+  expect(
+    localeLen,
+    `[LAZY SEO TRANSLATION] Tool "${toolId}" locale "${locale}" SEO text is ${msgType} (${localeLen} chars vs EN ${enLen} chars, expected min ${minLength})`,
+  ).toBeGreaterThanOrEqual(minLength);
+}
+
+async function auditSingleLocale(toolId: string, locale: string, loader: any, enSeoLength: number): Promise<void> {
+  if (locale === 'en' || !loader) return;
+  const content = await loader();
+  if (!content.seo || !Array.isArray(content.seo)) return;
+
+  checkLocaleSeoLength(toolId, locale, calculateSeoTextLength(content.seo), enSeoLength);
+}
+
+describe('SEO Translation Completeness & Laziness Audit', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should not have lazy or truncated SEO content compared to English reference', async () => {
+        const enLoader = entry.i18n['en' as keyof typeof entry.i18n];
+        if (!enLoader) return;
+
+        const enContent = await enLoader();
+        if (!enContent.seo || !Array.isArray(enContent.seo)) return;
+
+        const enSeoLength = calculateSeoTextLength(enContent.seo);
+
+        for (const [locale, loader] of Object.entries(entry.i18n)) {
+          await auditSingleLocale(entry.id, locale, loader, enSeoLength);
+        }
+      });
+    });
+  });
+});
+

package/src/tests/tool_validation.test.ts

@@ -4,8 +4,8 @@ import { gamesCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 11 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(11);
+    it('should have 13 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(13);
     });
 
     it('gamesCategory should be defined', () => {

package/src/tests/translation_copy.test.ts

@@ -91,6 +91,26 @@ function copySimilarity(left: string, right: string): number {
   return (2 * shared) / (leftTotal + rightTotal);
 }
 
+function findCopyViolations(corpora: Map<string, string>): string[] {
+  const locales = [...corpora.keys()];
+  const violations: string[] = [];
+
+  for (let leftIndex = 0; leftIndex < locales.length; leftIndex += 1) {
+    for (let rightIndex = leftIndex + 1; rightIndex < locales.length; rightIndex += 1) {
+      const left = locales[leftIndex];
+      const right = locales[rightIndex];
+      if (!left || !right) continue;
+      const similarity = copySimilarity(corpora.get(left) ?? '', corpora.get(right) ?? '');
+
+      if (similarity >= COPY_THRESHOLD) {
+        violations.push(`${left} ↔ ${right}: ${(similarity * 100).toFixed(1)}%`);
+      }
+    }
+  }
+
+  return violations;
+}
+
 describe('Locales must not copy another locale wholesale', () => {
   ALL_ENTRIES.forEach((entry) => {
     it(`${entry.id} is not at least ${COPY_THRESHOLD * 100}% identical to another locale`, async () => {
@@ -101,24 +121,7 @@ describe('Locales must not copy another locale wholesale', () => {
         corpora.set(locale, localeCorpus(await loader()));
       }
 
-      const locales = [...corpora.keys()];
-      const violations: string[] = [];
-
-      for (let leftIndex = 0; leftIndex < locales.length; leftIndex += 1) {
-        for (let rightIndex = leftIndex + 1; rightIndex < locales.length; rightIndex += 1) {
-          const left = locales[leftIndex];
-          const right = locales[rightIndex];
-          const similarity = copySimilarity(corpora.get(left) ?? '', corpora.get(right) ?? '');
-
-          if (similarity >= COPY_THRESHOLD) {
-            violations.push(`${left} ↔ ${right}: ${(similarity * 100).toFixed(1)}%`);
-          }
-        }
-      }
-
-      expect(violations, `Locale copy threshold exceeded in ${entry.id}`).toEqual([]);
+      expect(findCopyViolations(corpora), `Locale copy threshold exceeded in ${entry.id}`).toEqual([]);
     });
   });
 });
-
-

package/src/tool/audioLoopPointFinder/i18n/de.ts

@@ -132,6 +132,19 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Beim Exportieren von Tonspuren aus diesem Tool werden neue Metadatenstrukturen direkt in den RIFF-Header der ausgegebenen WAV-Binärdatei eingebettet. Die Anwendung erstellt sowohl einen Standard-Sample-Chunk als auch einen LIST-INFO-Chunk mit Text-Tags.',
     },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Loop-Länge und Phasenübergang beurteilen',
+    },
+    {
+      type: 'paragraph',
+      html: 'Ein Nulldurchgang reduziert Sprünge der Amplitude, garantiert aber nicht automatisch einen musikalisch passenden Übergang. Hören Sie den Anfang und das Ende gemeinsam an und prüfen Sie zusätzlich, ob Rhythmus, Harmonie und Hallfahne beim Wiederholen logisch weiterlaufen.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Die Marker werden in Samples gespeichert und bleiben dadurch unabhängig von einer gerundeten Millisekundenanzeige. Exportieren Sie erst nach der akustischen Kontrolle und testen Sie die WAV-Datei anschließend in der Engine, die sie im Spiel abspielen soll.',
+    },
   ],
   faqTitle: 'Häufig gestellte Fragen',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/fr.ts

@@ -132,6 +132,32 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Lors de l export des pistes depuis cet outil, les structures de métadonnées sont injectées directement dans l en-tête RIFF du fichier WAV. L outil crée un bloc d échantillon standard et un bloc LIST INFO.',
     },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Évaluer la durée de boucle et la transition de phase',
+    },
+    {
+      type: 'paragraph',
+      html: 'Un passage par zéro réduit les sauts d amplitude, mais ne garantit pas une transition musicale cohérente. Écoutez le début et la fin ensemble et vérifiez que le rythme, l harmonie et la réverbération se poursuivent naturellement pendant la répétition.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Les marqueurs sont conservés en échantillons et ne dépendent donc pas d un arrondi en millisecondes. Exportez après le contrôle auditif, puis testez le fichier WAV dans le moteur qui le lira réellement pendant le jeu.',
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Évaluer la durée de boucle et la transition de phase',
+    },
+    {
+      type: 'paragraph',
+      html: 'Un passage par zéro réduit les sauts d amplitude, mais ne garantit pas une transition musicale cohérente. Écoutez le début et la fin ensemble et vérifiez que le rythme, l harmonie et la réverbération se poursuivent naturellement pendant la répétition.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Les marqueurs sont conservés en échantillons et ne dépendent donc pas d un arrondi en millisecondes. Exportez après le contrôle auditif, puis testez le fichier WAV dans le moteur qui le lira réellement pendant le jeu.',
+    },
   ],
   faqTitle: 'Foire Aux Questions',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/id.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Saat mengekspor trek audio dari alat ini, struktur metadata baru disuntikkan langsung ke dalam header RIFF dari file WAV.',
     },
+    { type: 'title', level: 2, text: 'Menilai durasi loop dan transisi fase' },
+    { type: 'paragraph', html: 'Zero crossing mengurangi lonjakan amplitudo, tetapi tidak otomatis membuat transisi musik terdengar alami. Dengarkan bagian awal dan akhir secara berurutan, lalu periksa ritme, harmoni, serta ekor reverb saat loop diulang.' },
+    { type: 'paragraph', html: 'Marker disimpan dalam satuan sample sehingga tidak bergantung pada pembulatan milidetik. Setelah pemeriksaan audio, ekspor WAV dan uji berkas tersebut di engine yang akan memutarnya dalam game.' },
+    { type: 'paragraph', html: 'Periksa juga bahwa panjang loop sesuai dengan frasa musik dan tidak memotong nada atau ekor efek. Nilai marker dalam sample memberikan ketelitian yang tetap saat file berpindah antara perangkat, tetapi hasil akhirnya tetap harus didengarkan pada tempo dan volume permainan yang sebenarnya.' },
   ],
   faqTitle: 'Pertanyaan yang Sering Diajukan',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/it.ts

@@ -132,6 +132,9 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Durante l esportazione delle tracce, le nuove strutture di metadati vengono iniettate direttamente nell intestazione RIFF del file binario WAV.',
     },
+    { type: 'title', level: 2, text: 'Valutare la durata del loop e la transizione di fase' },
+    { type: 'paragraph', html: 'Un passaggio per lo zero riduce i salti di ampiezza, ma non garantisce da solo una transizione musicale naturale. Ascolta in sequenza inizio e fine e controlla ritmo, armonia e coda del riverbero durante la ripetizione.' },
+    { type: 'paragraph', html: 'I marker sono conservati in campioni e non dipendono dall arrotondamento dei millisecondi. Dopo il controllo d ascolto, esporta il WAV e provalo nel motore che lo riprodurrà nel gioco.' },
   ],
   faqTitle: 'Domande Frequenti',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/nl.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Bij het exporteren van audiotracks vanuit deze tool worden nieuwe metadatastructuren direct in de RIFF-header van het WAV-bestand geplaatst.',
     },
+    { type: 'title', level: 2, text: 'Loopduur en faseovergang beoordelen' },
+    { type: 'paragraph', html: 'Een nuldoorgang beperkt sprongen in amplitude, maar garandeert niet automatisch een muzikale overgang. Luister naar begin en einde achter elkaar en controleer ritme, harmonie en de galmstaart tijdens het herhalen.' },
+    { type: 'paragraph', html: 'Markers worden in samples bewaard en zijn daardoor niet afhankelijk van afronding naar milliseconden. Exporteer pas na de luistercontrole en test het WAV-bestand in de engine die het in de game afspeelt.' },
+    { type: 'paragraph', html: 'Controleer ook of de looplengte bij de muzikale frase past en geen noot of effectstaart afsnijdt. Markers in samples behouden hun nauwkeurigheid wanneer het bestand tussen apparaten verhuist, maar luister altijd op het echte tempo en volume van de game.' },
   ],
   faqTitle: 'Veelgestelde Vragen',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/pl.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Podczas eksportowania ścieżek z tego narzędzia nowe struktury metadanych są wstrzykiwane bezpośrednio do nagłówka RIFF pliku WAV.',
     },
+    { type: 'title', level: 2, text: 'Ocena długości pętli i przejścia fazowego' },
+    { type: 'paragraph', html: 'Przejście przez zero ogranicza skoki amplitudy, ale samo nie gwarantuje naturalnego przejścia muzycznego. Posłuchaj początku i końca jeden po drugim oraz sprawdź rytm, harmonię i wybrzmienie pogłosu podczas powtarzania.' },
+    { type: 'paragraph', html: 'Znaczniki są zapisywane w próbkach, więc nie zależą od zaokrąglenia do milisekund. Po kontroli odsłuchowej wyeksportuj WAV i przetestuj go w silniku, który odtworzy go w grze.' },
+    { type: 'paragraph', html: 'Sprawdź także, czy długość pętli pasuje do frazy muzycznej i nie ucina nuty ani wybrzmienia efektu. Znaczniki w próbkach zachowują precyzję między urządzeniami, ale wynik trzeba odsłuchać w rzeczywistym tempie i przy docelowej głośności gry.' },
   ],
   faqTitle: 'Często Zadawane Pytania',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/pt.ts

@@ -132,6 +132,9 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Ao exportar faixas de áudio desta ferramenta, novas estruturas de metadatos são injetadas diretamente no cabeçalho RIFF do arquivo WAV.',
     },
+    { type: 'title', level: 2, text: 'Avaliar a duração do loop e a transição de fase' },
+    { type: 'paragraph', html: 'Um cruzamento por zero reduz saltos de amplitude, mas não garante sozinho uma transição musical natural. Ouça o início e o fim em sequência e confira ritmo, harmonia e cauda de reverberação durante a repetição.' },
+    { type: 'paragraph', html: 'Os marcadores são armazenados em samples e não dependem do arredondamento em milissegundos. Depois da conferência auditiva, exporte o WAV e teste-o na engine que fará a reprodução no jogo.' },
   ],
   faqTitle: 'Perguntas Frequentes',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/ru.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'При экспорте аудиодорожек из этой утилиты новые структуры метаданных внедряются непосредственно в заголовок RIFF выходного файла WAV.',
     },
+    { type: 'title', level: 2, text: 'Оценка длины петли и перехода фазы' },
+    { type: 'paragraph', html: 'Переход через ноль уменьшает скачки амплитуды, но сам по себе не гарантирует естественное музыкальное соединение. Прослушайте начало и конец подряд и проверьте ритм, гармонию и хвост реверберации при повторении.' },
+    { type: 'paragraph', html: 'Маркеры сохраняются в сэмплах и не зависят от округления миллисекунд. После проверки на слух экспортируйте WAV и протестируйте его в движке, который будет воспроизводить файл в игре.' },
+    { type: 'paragraph', html: 'Также проверьте, соответствует ли длина петли музыкальной фразе и не обрезает ли ноту или хвост эффекта. Маркеры в сэмплах сохраняют точность при переносе файла между устройствами, однако результат нужно прослушать в реальном темпе и с целевой громкостью игры.' },
   ],
   faqTitle: 'Часто Задаваемые Вопросы',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/sv.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'När du exporterar ljudspår från detta verktyg bäddas nya metadatastrukturer in direkt i RIFF-headern på den exporterade WAV-filen.',
     },
+    { type: 'title', level: 2, text: 'Bedöm loopens längd och fasövergång' },
+    { type: 'paragraph', html: 'En nollgenomgång minskar amplitudhopp, men garanterar inte automatiskt en naturlig musikalisk övergång. Lyssna på början och slutet efter varandra och kontrollera rytm, harmoni och efterklang när loopen upprepas.' },
+    { type: 'paragraph', html: 'Markörerna sparas i samplingar och påverkas därför inte av avrundning till millisekunder. Exportera efter lyssningskontrollen och testa WAV-filen i motorn som ska spela den i spelet.' },
+    { type: 'paragraph', html: 'Kontrollera också att loopens längd passar den musikaliska frasen och inte klipper en ton eller en effektklang. Markörer i samplingar behåller precision mellan enheter, men resultatet ska alltid lyssnas på i spelets verkliga tempo och volym.' },
   ],
   faqTitle: 'Vanliga Frågor',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/tr.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: 'Bu araçtan ses parçalarını dışa aktarırken yeni üstveri yapıları doğrudan WAV dosyasının RIFF başlığına enjekte edilir.',
     },
+    { type: 'title', level: 2, text: 'Döngü süresini ve faz geçişini değerlendirme' },
+    { type: 'paragraph', html: 'Sıfır geçişi genlik sıçramalarını azaltır, ancak tek başına doğal bir müzik geçişini garanti etmez. Başlangıç ve bitişi art arda dinleyin; tekrar sırasında ritmi, armoniyi ve yankı kuyruğunu kontrol edin.' },
+    { type: 'paragraph', html: 'İşaretçiler sample cinsinden saklandığı için milisaniye yuvarlamasına bağlı değildir. Dinleme kontrolünden sonra WAV dosyasını dışa aktarın ve oyunda çalacak motorda test edin.' },
+    { type: 'paragraph', html: 'Döngü uzunluğunun müzik cümlesine uyduğunu ve bir notayı ya da efekt kuyruğunu kesmediğini de kontrol edin. Sample cinsindeki işaretçiler dosya cihazlar arasında taşınsa bile hassasiyeti korur; yine de sonucu oyunun gerçek temposunda ve ses düzeyinde dinleyin.' },
   ],
   faqTitle: 'Sıkça Sorulan Sorular',
   faq: [

package/src/tool/audioLoopPointFinder/i18n/zh.ts

@@ -132,6 +132,10 @@ export const content: ToolLocaleContent<AudioLoopPointFinderUI> = {
       type: 'paragraph',
       html: '从此工具导出音频轨道时，新的元数据结构将直接注入到输出WAV二进制文件的RIFF头中。',
     },
+    { type: 'title', level: 2, text: '评估循环长度与相位衔接' },
+    { type: 'paragraph', html: '过零点可以减少振幅跳变，但不能单独保证自然的音乐衔接。请连续聆听开头和结尾，并检查循环重复时的节奏、和声以及混响尾音。' },
+    { type: 'paragraph', html: '标记点以采样数保存，不依赖毫秒四舍五入。完成听感检查后再导出 WAV，并在游戏实际使用的引擎中测试播放结果。' },
+    { type: 'paragraph', html: '还要确认循环长度符合音乐乐句，不会截断音符或效果尾音。采样数标记在设备之间传递时仍能保持精度，但最终结果应在游戏的实际速度和音量下试听。' },
   ],
   faqTitle: '常见问题解答',
   faq: [

package/src/tool/damageFormulaLab/bibliography.astro

@@ -0,0 +1,24 @@
+---
+import type { BibliographyEntry } from '../../types';
+
+interface Props {
+  title?: string;
+  entries?: BibliographyEntry[];
+}
+
+const { title = 'References', entries = [] } = Astro.props;
+---
+
+{entries.length > 0 && (
+  <section class="damage-lab-references" aria-labelledby="damage-lab-reference-title">
+    <h2 id="damage-lab-reference-title">{title}</h2>
+    <ul>
+      {entries.map((entry) => <li><a href={entry.url} rel="noopener noreferrer" target="_blank">{entry.name}</a></li>)}
+    </ul>
+  </section>
+)}
+
+<style>
+  .damage-lab-references { margin-block: 2rem; }
+  .damage-lab-references a { color: var(--n-primary); }
+</style>

package/src/tool/damageFormulaLab/bibliography.ts

@@ -0,0 +1,10 @@
+export const bibliographyEntries = [
+  {
+    name: "Game Balance Concepts: Numeric Relationships",
+    url: "https://gamebalanceconcepts.wordpress.com/2010/07/14/level-2-numeric-relationships/",
+  },
+  {
+    name: "Oracle Numerical Computation Guide: What Is IEEE Arithmetic?",
+    url: "https://docs.oracle.com/cd/E37069_01/html/E39019/z4000ac019127.html",
+  },
+];

package/src/tool/damageFormulaLab/component.astro

@@ -0,0 +1,178 @@
+---
+import type { DamageFormulaLabUI } from './ui';
+import './damage-formula-lab.css';
+
+interface Props {
+  ui: DamageFormulaLabUI;
+}
+
+const { ui } = Astro.props;
+
+const coreInputs = [
+  ['attack', ui.attackLabel, 0, 100000, 1],
+  ['defense', ui.defenseLabel, 0, 100000, 1],
+  ['health', ui.healthLabel, 1, 10000000, 1],
+  ['attacksPerSecond', ui.cadenceLabel, 0.01, 100, 0.05],
+] as const;
+
+const advancedInputs = [
+  ['level', ui.levelLabel, 1, 999, 1],
+  ['power', ui.powerLabel, 0, 100, 0.05],
+  ['resistance', ui.resistanceLabel, 0, 100, 1],
+  ['flat', ui.flatLabel, -100000, 100000, 1],
+  ['criticalChance', ui.criticalChanceLabel, 0, 100, 1],
+  ['criticalMultiplier', ui.criticalMultiplierLabel, 1, 20, 0.05],
+] as const;
+---
+
+<section class="damage-lab" data-damage-lab>
+  <script is:inline type="application/json" data-damage-ui set:html={JSON.stringify(ui)} />
+
+  <header class="damage-lab-header">
+    <p>{ui.onboarding}</p>
+    <span>{ui.localNote}</span>
+  </header>
+
+  <section class="damage-lab-composer" aria-labelledby="damage-lab-formulas-title">
+    <div class="damage-lab-heading">
+      <h2 id="damage-lab-formulas-title">{ui.formulaDeck}</h2>
+      <div class="damage-lab-presets" aria-label="Formula presets">
+        <button type="button" data-preset="linear">{ui.presetLinear}</button>
+        <button type="button" data-preset="ratio">{ui.presetRatio}</button>
+        <button type="button" data-preset="level">{ui.presetLevel}</button>
+      </div>
+    </div>
+    <div class="damage-lab-formulas">
+      <label class="damage-lab-formula damage-lab-formula-a">
+        <span><i aria-hidden="true"></i>{ui.formulaALabel}</span>
+        <input name="formulaA" type="text" spellcheck="false" autocomplete="off" />
+      </label>
+      <label class="damage-lab-formula damage-lab-formula-b">
+        <span><i aria-hidden="true"></i>{ui.formulaBLabel}</span>
+        <input name="formulaB" type="text" spellcheck="false" autocomplete="off" />
+      </label>
+    </div>
+    <details class="damage-lab-language">
+      <summary>Formula language</summary>
+      <p>{ui.formulaHint}<br />{ui.formulaFunctions}</p>
+    </details>
+  </section>
+
+  <section class="damage-lab-tuning" aria-labelledby="damage-lab-tuning-title">
+    <div class="damage-lab-heading">
+      <h2 id="damage-lab-tuning-title">{ui.combatInputs}</h2>
+      <div class="damage-lab-scenarios" aria-label={ui.scenariosTitle}>
+        <button type="button" data-scenario="skirmisher">{ui.scenarioSkirmisher}</button>
+        <button type="button" data-scenario="guardian">{ui.scenarioGuardian}</button>
+        <button type="button" data-scenario="boss">{ui.scenarioBoss}</button>
+        <button type="button" data-scenario="custom">{ui.scenarioCustom}</button>
+      </div>
+    </div>
+    <div class="damage-lab-core-inputs">
+      {coreInputs.map(([name, label, min, max, step]) => (
+        <label>
+          <span>{label}</span>
+          <input name={name} type="number" min={min} max={max} step={step} inputmode="decimal" />
+        </label>
+      ))}
+    </div>
+    <details class="damage-lab-advanced">
+      <summary>Advanced combat and engine rules</summary>
+      <div class="damage-lab-advanced-grid">
+        {advancedInputs.map(([name, label, min, max, step]) => (
+          <label>
+            <span>{label}</span>
+            <input name={name} type="number" min={min} max={max} step={step} inputmode="decimal" />
+          </label>
+        ))}
+      </div>
+      <fieldset class="damage-lab-choice">
+        <legend>{ui.roundingLabel}</legend>
+        <button type="button" data-rounding="none">{ui.roundingNone}</button>
+        <button type="button" data-rounding="floor">{ui.roundingFloor}</button>
+        <button type="button" data-rounding="round">{ui.roundingRound}</button>
+        <button type="button" data-rounding="ceil">{ui.roundingCeil}</button>
+      </fieldset>
+      <fieldset class="damage-lab-choice">
+        <legend>{ui.orderLabel}</legend>
+        <button type="button" data-order="resistance-first">{ui.resistanceFirst}</button>
+        <button type="button" data-order="flat-first">{ui.flatFirst}</button>
+      </fieldset>
+    </details>
+  </section>
+
+  <section class="damage-lab-result" aria-labelledby="damage-lab-result-title">
+    <div class="damage-lab-result-heading">
+      <div><span>Live model</span><h2 id="damage-lab-result-title">{ui.runLabel}</h2></div>
+      <div class="damage-lab-gap"><small>{ui.resultDifference}</small><strong data-result="gap">0</strong></div>
+    </div>
+    <div class="damage-lab-totals">
+      <article>
+        <span>{ui.formulaAName}</span>
+        <strong data-result="a-damage">0</strong>
+        <small>{ui.resultDamage}</small>
+        <dl><div><dt>{ui.resultHits}</dt><dd data-result="a-hits">0</dd></div><div><dt>{ui.resultTtk}</dt><dd data-result="a-ttk">0 s</dd></div></dl>
+      </article>
+      <article>
+        <span>{ui.formulaBName}</span>
+        <strong data-result="b-damage">0</strong>
+        <small>{ui.resultDamage}</small>
+        <dl><div><dt>{ui.resultHits}</dt><dd data-result="b-hits">0</dd></div><div><dt>{ui.resultTtk}</dt><dd data-result="b-ttk">0 s</dd></div></dl>
+      </article>
+    </div>
+    <div class="damage-lab-curve-heading">
+      <div><h3>{ui.curveTitle}</h3><p>{ui.curveCaption}</p></div>
+      <span><b data-curve-max>0</b> max</span>
+    </div>
+    <svg class="damage-lab-chart" data-chart viewBox="0 0 100 100" preserveAspectRatio="none" role="img" aria-label={ui.curveTitle}>
+      <path class="damage-lab-guide" d="M0 25 H100 M0 50 H100 M0 75 H100" />
+      <path class="damage-lab-curve damage-lab-curve-a" data-curve="a" d="" />
+      <path class="damage-lab-curve damage-lab-curve-b" data-curve="b" d="" />
+    </svg>
+    <div class="damage-lab-legend"><span>{ui.formulaAName}</span><span>{ui.formulaBName}</span></div>
+  </section>
+
+  <details class="damage-lab-secondary">
+    <summary>{ui.heatmapTitle} + {ui.diagnosticsTitle}</summary>
+    <div class="damage-lab-notes">
+      <section class="damage-lab-pressure" aria-labelledby="damage-lab-heatmap-title">
+        <h2 id="damage-lab-heatmap-title">{ui.heatmapTitle}</h2>
+        <p>{ui.heatmapCaption}</p>
+        <div class="damage-lab-axis">{ui.attackAxis}</div>
+        <div class="damage-lab-heatmap" data-heatmap></div>
+        <small>{ui.defenseAxis}</small>
+      </section>
+      <section class="damage-lab-diagnostics" aria-labelledby="damage-lab-diagnostics-title">
+        <h2 id="damage-lab-diagnostics-title">{ui.diagnosticsTitle}</h2>
+        <ul data-diagnostics></ul>
+        <p>{ui.limitationDisclosure}</p>
+      </section>
+    </div>
+  </details>
+
+  <details class="damage-lab-export-panel">
+    <summary>{ui.exportTitle}</summary>
+    <footer class="damage-lab-exports">
+      <p>{ui.privacyDisclosure}</p>
+      <div class="damage-lab-actions">
+        <button type="button" data-share>{ui.copyLink}</button>
+        <button type="button" data-csv>{ui.exportCsv}</button>
+        <button type="button" data-json>{ui.exportJson}</button>
+        <label>{ui.importJson}<input type="file" accept="application/json,.json" data-import /></label>
+        <button type="button" data-png>{ui.exportPng}</button>
+        <button type="button" data-reset>{ui.reset}</button>
+      </div>
+      <p class="damage-lab-status" data-status aria-live="polite"></p>
+    </footer>
+  </details>
+</section>
+
+<script>
+  import { mountDamageFormulaLab } from './controller';
+  import type { DamageFormulaLabUI } from './ui';
+
+  document.querySelectorAll<HTMLElement>('[data-damage-lab]').forEach((root) => {
+    const source = root.querySelector<HTMLScriptElement>('[data-damage-ui]');
+    if (source?.textContent) mountDamageFormulaLab(root, JSON.parse(source.textContent) as DamageFormulaLabUI);
+  });
+</script>