@jjlmoya/utils-games-development 1.53.0 → 1.54.0

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

@@ -0,0 +1,195 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { SteamBbcodeTranslatorUI } from '../ui';
+import { bibliographyEntries } from '../bibliography';
+
+export const content: ToolLocaleContent<SteamBbcodeTranslatorUI> = {
+  slug: 'steam-bbcode-omvandlare',
+  title: 'Steam BBCode, Markdown och HTML Omvandlare',
+  description: 'Konvertera mellan Steam BBCode, Markdown och HTML i båda riktningarna med automatisk syntaxdetektering och live-förhandsgranskning.',
+  ui: {
+    editorLabel: 'Klistra in din formaterade text',
+    editorHint: 'BBCode, Markdown eller HTML identifieras automatiskt medan du skriver.',
+    detectedLabel: 'Identifierad',
+    detectedEmpty: 'Väntar på text',
+    bbcode: 'Steam BBCode',
+    markdown: 'Markdown',
+    html: 'HTML',
+    clear: 'Rensa',
+    copy: 'Kopiera resultat',
+    copied: 'Kopierat till urklipp',
+    characters: 'Tecken',
+    blocks: 'Block',
+    privacyNote: 'Körs helt i din webbläsare. Inga uppladdningar.',
+    persistenceNote: 'Senaste utkastet sparat lokalt',
+    previewLabel: 'Förhandsgranskning',
+    previewEmpty: 'Din formaterade förhandsgranskning visas här.'
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: 'Varför butiksbeskrivningar behöver en omvandlare'
+    },
+    {
+      type: 'paragraph',
+      html: 'Steam-butikssidor använder BBCode. Presskit och dokumentation kräver ofta Markdown eller HTML. Detta verktyg konverterar automatiskt mellan de tre formaten.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Formateringsstöd'
+    },
+    {
+      type: 'paragraph',
+      html: 'Stödjer rubriker, fetstil, kursiv stil, länkar, listor, citat och spoilers.'
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { label: 'Indataformat', value: '3' },
+        { label: 'Utdata per klistra in', value: '2' },
+        { label: 'Listdjup', value: 'Nästlad' },
+        { label: 'Bearbetning', value: 'Endast webbläsare' }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Bevarade nästlade listor'
+    },
+    {
+      type: 'paragraph',
+      html: 'Ett trädträd upprätthåller underlistor i rätt strukturell position.'
+    },
+    {
+      type: 'table',
+      headers: ['Steam BBCode', 'Markdown', 'HTML'],
+      rows: [
+        ['[h1]Titel[/h1]', '# Titel', '&lt;h1&gt;Titel&lt;/h1&gt;'],
+        ['[b]Viktigt[/b]', '**Viktigt**', '&lt;strong&gt;Viktigt&lt;/strong&gt;'],
+        ['[i]Notering[/i]', '*Notering*', '&lt;em&gt;Notering&lt;/em&gt;'],
+        ['[url=https://example.com]Länk[/url]', '[Länk](https://example.com)', '&lt;a href="https://example.com"&gt;Länk&lt;/a&gt;'],
+        ['[list][*]Ett[*]Två[/list]', '- Ett\n- Två', '&lt;ul&gt;&lt;li&gt;Ett&lt;/li&gt;&lt;li&gt;Två&lt;/li&gt;&lt;/ul&gt;']
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Skillnader mellan Markdown och HTML'
+    },
+    {
+      type: 'paragraph',
+      html: 'När Markdown saknar stöd för understrykning används inline HTML.'
+    },
+    {
+      type: 'tip',
+      title: 'Granskning före publicering',
+      html: 'Jämför förhandsgranskningen med ditt originaldokument innan du publicerar på Steam.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Integritet'
+    },
+    {
+      type: 'paragraph',
+      html: 'All bearbetning sker lokalt i din webbläsare utan att skicka data vidare.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Begränsningar'
+    },
+    {
+      type: 'proscons',
+      title: 'Att tänka på',
+      items: [
+        {
+          pro: 'Strukturerad listförädling.',
+          con: 'Anpassade taggar behöver manuell översyn.'
+        }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Ordlista'
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'BBCode',
+          definition: 'Haki-baserad formatering som används på Steam.'
+        },
+        {
+          term: 'Markdown',
+          definition: 'Enkelt och läsbart textformat.'
+        },
+        {
+          term: 'HTML',
+          definition: 'Standardiserat märkspråk för webben.'
+        }
+      ]
+    }
+  ],
+  faqTitle: 'Vanliga frågor',
+  faq: [
+    {
+      question: 'Skickas min text till en server?',
+      answer: 'Nej. Konverteringen sker helt i din webbläsare.'
+    },
+    {
+      question: 'Stöds nästlade listor?',
+      answer: 'Ja. Liststrukturen analyseras innan konvertering.'
+    }
+  ],
+  howTo: [
+    {
+      name: 'Klistra in text',
+      text: 'Klistra in Steam BBCode, Markdown eller HTML.'
+    },
+    {
+      name: 'Automatisk detektering',
+      text: 'De övriga två formaten genereras direkt.'
+    }
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Steam BBCode, Markdown och HTML Omvandlare',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'SEK' }
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: 'Skickas min text till en server?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Nej. Konverteringen sker helt i din webbläsare.'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Hur man konverterar Steam BBCode, Markdown och HTML',
+      step: [
+        {
+          '@type': 'HowToStep',
+          name: 'Klistra in text',
+          text: 'Klistra in Steam BBCode, Markdown eller HTML.'
+        }
+      ]
+    }
+  ],
+  bibliography: bibliographyEntries
+};

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

@@ -0,0 +1,195 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { SteamBbcodeTranslatorUI } from '../ui';
+import { bibliographyEntries } from '../bibliography';
+
+export const content: ToolLocaleContent<SteamBbcodeTranslatorUI> = {
+  slug: 'steam-bbcode-donusturucu',
+  title: 'Steam BBCode, Markdown ve HTML Donusturucu',
+  description: 'Steam BBCode, Markdown ve HTML formatlari arasinda otomatik sozvarligi tespiti ve canli onizleme ile cift yonlu donusturme yapin.',
+  ui: {
+    editorLabel: 'Bicimlendirilmis metninizi yapistirin',
+    editorHint: 'BBCode, Markdown veya HTML siz yazarken otomatik olarak algilanir.',
+    detectedLabel: 'Algilanan',
+    detectedEmpty: 'Metin bekleniyor',
+    bbcode: 'Steam BBCode',
+    markdown: 'Markdown',
+    html: 'HTML',
+    clear: 'Temizle',
+    copy: 'Sonucu kopyala',
+    copied: 'Panoya kopyalandi',
+    characters: 'Karakterler',
+    blocks: 'Bloklar',
+    privacyNote: 'Tarayicinizda calisir. Hicbir sey yuklenmez.',
+    persistenceNote: 'Son taslak yerel olarak kaydedildi',
+    previewLabel: 'Onizleme',
+    previewEmpty: 'Bicimlendirilmis onizlemeniz burada gorunur.'
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: 'Magaza aciklamalari neden donusturucuye ihtiyac duyar'
+    },
+    {
+      type: 'paragraph',
+      html: 'Steam magaza aciklamalari BBCode kullanir. Basin kitleri veya dokuman siteleri Markdown veya HTML gerektirir. Bu arac formatlar arasinda otomatik donusum saglar.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Desteklenen etiketler'
+    },
+    {
+      type: 'paragraph',
+      html: 'Basliklar, kalin, italik, baglantilar, listeler, alintilar ve spoiler etiketleri desteklenir.'
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { label: 'Girdi formati', value: '3' },
+        { label: 'Cikti formati', value: '2' },
+        { label: 'Liste derinligi', value: 'Ic ice' },
+        { label: 'Islem', value: 'Sadece tarayici' }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Ic ice listelerin korunmasi'
+    },
+    {
+      type: 'paragraph',
+      html: 'Hiyerarsik yapi agaci alt listelerin ana oge icinde kalmasini saglar.'
+    },
+    {
+      type: 'table',
+      headers: ['Steam BBCode', 'Markdown', 'HTML'],
+      rows: [
+        ['[h1]Baslik[/h1]', '# Baslik', '&lt;h1&gt;Baslik&lt;/h1&gt;'],
+        ['[b]Onemli[/b]', '**Onemli**', '&lt;strong&gt;Onemli&lt;/strong&gt;'],
+        ['[i]Not[/i]', '*Not*', '&lt;em&gt;Not&lt;/em&gt;'],
+        ['[url=https://example.com]Baglanti[/url]', '[Baglanti](https://example.com)', '&lt;a href="https://example.com"&gt;Baglanti&lt;/a&gt;'],
+        ['[list][*]Bir[*]Iki[/list]', '- Bir\n- Iki', '&lt;ul&gt;&lt;li&gt;Bir&lt;/li&gt;&lt;li&gt;Iki&lt;/li&gt;&lt;/ul&gt;']
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Markdown ve HTML farkliliklari'
+    },
+    {
+      type: 'paragraph',
+      html: 'Markdown alti cizili metni yerel olarak desteklemediginde HTML etiketleri kullanilir.'
+    },
+    {
+      type: 'tip',
+      title: 'Yayinlama oncesi kontrol',
+      html: 'Yayinlamadan once onizleme ekranindaki ciktilari kaynak belgenizle karsilastirin.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Veri gizliligi'
+    },
+    {
+      type: 'paragraph',
+      html: 'Tum islemler tamamen yerel olarak tarayicinizda gerceklesir.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Sinirlamalar'
+    },
+    {
+      type: 'proscons',
+      title: 'Dikkat edilecekler',
+      items: [
+        {
+          pro: 'Liste yapisi korunur.',
+          con: 'Ozel etiketler manuel kontrol gerektirebilir.'
+        }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Terimler sozlugu'
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'BBCode',
+          definition: 'Steam tarafindan kullanilan kosebenti etiket yapisi.'
+        },
+        {
+          term: 'Markdown',
+          definition: 'Kolay okunabilir duz metin bicimlendirme dili.'
+        },
+        {
+          term: 'HTML',
+          definition: 'Web sayfalari icin standart isaretleme dili.'
+        }
+      ]
+    }
+  ],
+  faqTitle: 'Sikca sorulan sorular',
+  faq: [
+    {
+      question: 'Metnim bir sunucuya gonderiliyor mu?',
+      answer: 'Hayir. Donusum tamamen tarayicinizda gerceklesir.'
+    },
+    {
+      question: 'Ic ice listeler destekleniyor mu?',
+      answer: 'Evet. Liste yapisi donusumden once cozümlenir.'
+    }
+  ],
+  howTo: [
+    {
+      name: 'Metni yapistirin',
+      text: 'Steam BBCode, Markdown veya HTML yapistirin.'
+    },
+    {
+      name: 'Otomatik donusum',
+      text: 'Diger iki format aninda olusturulur.'
+    }
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Steam BBCode, Markdown ve HTML Donusturucu',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'TRY' }
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: 'Metnim bir sunucuya gonderiliyor mu?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Hayir. Donusum tamamen tarayicinizda gerceklesir.'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Steam BBCode, Markdown ve HTML nasil donusturulur',
+      step: [
+        {
+          '@type': 'HowToStep',
+          name: 'Metni yapistirin',
+          text: 'Steam BBCode, Markdown veya HTML yapistirin.'
+        }
+      ]
+    }
+  ],
+  bibliography: bibliographyEntries
+};

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

@@ -0,0 +1,195 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { SteamBbcodeTranslatorUI } from '../ui';
+import { bibliographyEntries } from '../bibliography';
+
+export const content: ToolLocaleContent<SteamBbcodeTranslatorUI> = {
+  slug: 'steam-bbcode-translator',
+  title: 'Steam BBCode, Markdown 与 HTML 转换器',
+  description: '支持 Steam BBCode、Markdown 和 HTML 之间的双向自动识别转换与实时预览。',
+  ui: {
+    editorLabel: '粘贴您的富文本',
+    editorHint: '输入时将自动识别 BBCode、Markdown 或 HTML 格式。',
+    detectedLabel: '识别格式',
+    detectedEmpty: '等待输入文本',
+    bbcode: 'Steam BBCode',
+    markdown: 'Markdown',
+    html: 'HTML',
+    clear: '清空',
+    copy: '复制输出',
+    copied: '已复制到剪贴板',
+    characters: '字符数',
+    blocks: '区块数',
+    privacyNote: '在浏览器中本地运行，无需上传。',
+    persistenceNote: '最后草稿已保存在本地',
+    previewLabel: '预览',
+    previewEmpty: '格式化后的预览将在此显示。'
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: '为什么商店文案需要格式转换器'
+    },
+    {
+      type: 'paragraph',
+      html: 'Steam 商店页面编辑使用 BBCode 语法，而新闻资料包或文档网站通常使用 Markdown 或 HTML。本工具能够自动识别并同步生成其他两种格式。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '支持的标记与结构'
+    },
+    {
+      type: 'paragraph',
+      html: '支持标题、加粗、斜体、链接、列表、引用与黑幕剧透标记的转换。'
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { label: '输入格式', value: '3 种' },
+        { label: '同时输出', value: '2 种' },
+        { label: '列表深度', value: '支持嵌套' },
+        { label: '数据处理', value: '纯本地' }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '保留嵌套列表结构'
+    },
+    {
+      type: 'paragraph',
+      html: '通过构建轻量级语法树，确保子列表项在转换后依然精确嵌套在父级列表中。'
+    },
+    {
+      type: 'table',
+      headers: ['Steam BBCode', 'Markdown', 'HTML'],
+      rows: [
+        ['[h1]标题[/h1]', '# 标题', '&lt;h1&gt;标题&lt;/h1&gt;'],
+        ['[b]重点[/b]', '**重点**', '&lt;strong&gt;重点&lt;/strong&gt;'],
+        ['[i]备注[/i]', '*备注*', '&lt;em&gt;备注&lt;/em&gt;'],
+        ['[url=https://example.com]链接[/url]', '[链接](https://example.com)', '&lt;a href="https://example.com"&gt;链接&lt;/a&gt;'],
+        ['[list][*]第一[*]第二[/list]', '- 第一\n- 第二', '&lt;ul&gt;&lt;li&gt;第一&lt;/li&gt;&lt;li&gt;第二&lt;/li&gt;&lt;/ul&gt;']
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Markdown 与 HTML 转换差异'
+    },
+    {
+      type: 'paragraph',
+      html: '当 Markdown 原生不支持下划线等样式时，转换器会自动补充内联 HTML 标签。'
+    },
+    {
+      type: 'tip',
+      title: '发布前检查建议',
+      html: '在发布到 Steam 或官网之前，请在预览面板中核对排版效果。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '隐私与数据安全'
+    },
+    {
+      type: 'paragraph',
+      html: '所有转换均在您的浏览器本地完成，绝不会上传任何未公开文案。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '转换说明'
+    },
+    {
+      type: 'proscons',
+      title: '转换特点',
+      items: [
+        {
+          pro: '结构化处理嵌套列表。',
+          con: '自定义非标标签需手动复核。'
+        }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '术语表'
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'BBCode',
+          definition: 'Steam 商店页面使用的方括号标记语法。'
+        },
+        {
+          term: 'Markdown',
+          definition: '易读易写的轻量级标记语言。'
+        },
+        {
+          term: 'HTML',
+          definition: '网页标准的超文本标记语言。'
+        }
+      ]
+    }
+  ],
+  faqTitle: '常见问题解答',
+  faq: [
+    {
+      question: '文本会被上传到服务器吗？',
+      answer: '不会。转换完全在您的浏览器本地进行。'
+    },
+    {
+      question: '支持嵌套列表吗？',
+      answer: '支持。系统会先解析列表语法树再生成目标格式。'
+    }
+  ],
+  howTo: [
+    {
+      name: '粘贴文本',
+      text: '粘贴 Steam BBCode、Markdown 或 HTML 文本。'
+    },
+    {
+      name: '自动转换',
+      text: '系统将自动生成另外两种格式。'
+    }
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Steam BBCode, Markdown 与 HTML 转换器',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'CNY' }
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: '文本会被上传到服务器吗？',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'จะไม่。转换完全在您的浏览器本地进行。'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: '如何转换 Steam BBCode、Markdown 与 HTML',
+      step: [
+        {
+          '@type': 'HowToStep',
+          name: '粘贴文本',
+          text: '粘贴 Steam BBCode、Markdown 或 HTML 文本。'
+        }
+      ]
+    }
+  ],
+  bibliography: bibliographyEntries
+};

package/src/tool/steamBbcodeTranslator/index.ts

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

package/src/tool/steamBbcodeTranslator/logic.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+import { detectSyntax, getPreviewHtml, markdownToBbcode, sampleBbcode, translate, translateToAll } from './logic';
+
+describe('steam BBCode translator', () => {
+  it('converts headings, inline emphasis and links to Markdown', () => {
+    const result = translate('[h1]Signal Lost[/h1]\n[b]Bold[/b] [url=https://example.com]Read[/url]', 'bbcode-to-output', 'markdown');
+    expect(result.output).toContain('# Signal Lost');
+    expect(result.output).toContain('**Bold**');
+    expect(result.output).toContain('[Read](https://example.com)');
+  });
+
+  it('keeps nested BBCode lists nested in Markdown and HTML', () => {
+    const markdown = translate('[list][*]Parent[list][*]Child[/list][*]Sibling[/list]', 'bbcode-to-output', 'markdown');
+    const html = translate('[list][*]Parent[list][*]Child[/list][*]Sibling[/list]', 'bbcode-to-output', 'html');
+    expect(markdown.output).toContain('- Parent\n  - Child');
+    expect(html.output).toContain('<ul><li>Parent<ul><li>Child</li></ul></li><li>Sibling</li></ul>');
+  });
+
+  it('translates Markdown list indentation back to Steam list tags', () => {
+    const result = markdownToBbcode('- Parent\n  - Child\n- Sibling');
+    expect(result.output).toBe('[list]\n[*]Parent\n[list]\n[*]Child\n[/list]\n[*]Sibling\n[/list]');
+  });
+
+  it('handles empty input and exposes a safe preview', () => {
+    expect(translate('   ', 'bbcode-to-output', 'html').stats.characters).toBe(0);
+    expect(getPreviewHtml(sampleBbcode, 'bbcode-to-output', 'html')).not.toContain('<script');
+  });
+
+  it('detects the pasted syntax and returns only the other two formats', () => {
+    expect(detectSyntax('[b]Steam[/b]')).toBe('bbcode');
+    expect(detectSyntax('# Markdown')).toBe('markdown');
+    expect(detectSyntax('<strong>HTML</strong>')).toBe('html');
+    expect(Object.keys(translateToAll(sampleBbcode).outputs).sort()).toEqual(['html', 'markdown']);
+  });
+
+  it('reports malformed closing tags without throwing', () => {
+    const result = translate('[b]Unfinished[/i]', 'bbcode-to-output', 'markdown');
+    expect(result.output).toContain('Unfinished');
+    expect(result.warnings.length).toBeGreaterThan(0);
+  });
+});