@jjlmoya/utils-tabletop 1.27.0 → 1.28.0

package/src/tool/mus-scoreboard/i18n/sv.ts

@@ -0,0 +1,187 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { MusScoreboardLocaleContent, MusScoreboardUI } from '../entry';
+
+const ui: MusScoreboardUI = {
+  onboarding: 'Namnge de två paren, ställ in bordets regler och tryck på stenarna när händerna räknas.',
+  pairOneLabel: 'Par ett',
+  pairTwoLabel: 'Par två',
+  pairOneDefault: 'Bord Norr',
+  pairTwoDefault: 'Bord Söder',
+  targetPointsLabel: 'Poäng per spel',
+  targetPointsHint: 'Välj målpoäng för varje spel (30, 40 eller 50 poäng).',
+  gamesToWinLabel: 'Spel för att vinna vaca',
+  gamesToWinHint: 'Det första paret som når detta antal vinner matchen.',
+  deckLabel: 'Bordets kortlek',
+  deckHint: 'Spansk kortlek (Baraja española) är det traditionella valet. För fransk kortlek tar du bort 8:or, 9:or och 10:or.',
+  spanishDeck: 'Baraja española (Spansk kortlek)',
+  frenchDeck: 'Fransk kortlek',
+  frenchDeckNotice: 'Glöm inte att ta bort 8:or, 9:or och 10:or från den franska kortleken för att spela med 40 kort. Knektar är Sotas, Damer är Caballos och Kungar är Reyes.',
+  pointsOption30: '30 poäng',
+  pointsOption40: '40 poäng',
+  pointsOption50: '50 poäng',
+  gamesOption1: '1 spel',
+  gamesOption2: '2 spel',
+  gamesOption3: '3 spel',
+  startMatch: 'Öppna poängräknaren',
+  matchSettings: 'Ställ in par och regler',
+  liveMatch: 'Pågående match',
+  targetLabel: 'poäng per spel',
+  gameLabel: 'spel',
+  gamePlural: 'spel',
+  vacaLabel: 'spel för vinst',
+  scoreLabel: 'Aktuella stenar',
+  handLabel: 'Välj vilket par som är hand (Mano)',
+  handSelected: 'är hand (Mano).',
+  stonesLabel: 'Poängställning',
+  stoneSingular: 'sten (piedra)',
+  stonePlural: 'stenar (piedras)',
+  amarracoSingular: 'amarraco',
+  amarracoPlural: 'amarracos',
+  pointsToGo: 'kvar till mål',
+  addStone: 'sten',
+  addAmarraco: 'amarraco',
+  closeGame: 'Stäng spel',
+  closeGamePrompt: 'Bekräfta att detta par har vunnit spelet och starta nästa?',
+  confirmationTitle: 'Bekräfta åtgärd',
+  confirmAction: 'Bekräfta',
+  cancelAction: 'Fortsätt spela',
+  undo: 'Ångra',
+  resetMatch: 'Återställ match',
+  resetMatchPrompt: 'Återställa den aktuella matchen och rensa poänghistoriken?',
+  historyTitle: 'Senaste noteringar',
+  noHistory: 'Inga noteringar än.',
+  matchReady: 'Bordet är redo.',
+  closeGameHint: 'Ett par har nått målpoängen. Bekräfta vinnaren av spelet.',
+  waitingForScore: 'Räkna vidare. Återstående poäng för ledarna:',
+  gameWon: 'Spel avslutat.',
+  vacaWon: 'Vaca vunnen! Starta en ny match när bordet är redo.',
+  gameClosed: 'stängde spelet.',
+  pointsAdded: 'skrapade ihop',
+  matchSaved: 'Poäng sparad på denna enhet.',
+  lastAction: 'Senaste åtgärd',
+  settingsApplied: 'Nya regler tillämpade. Matchen återställdes.',
+  pairNameRequired: 'Ge båda paren ett namn innan du öppnar poängräknaren.',
+  visualScoreLabel: 'Mus-poängräknare för bordet med stenar, amarracos och spel',
+};
+
+const faq = [
+  {
+    question: 'Vad håller denna online Mus-poängräknare reda på?',
+    answer: 'Den håller reda på två par, stenar (enstaka poäng), amarracos (5-poängsblock), vunna spel (chicos), vaca, vem som är hand (Mano) och poänghistorik.',
+  },
+  {
+    question: 'Varför visas stenar och amarracos separat?',
+    answer: 'En sten (Piedra) motsvarar 1 poäng och en Amarraco motsvarar 5 stenar. Att visa dem separat gör det enkelt att jämföra med fysiska märkmarker på bordet.',
+  },
+  {
+    question: 'Kan man spela till 30, 40 eller 50 poäng?',
+    answer: 'Ja. Välj 30, 40 eller 50 poäng per spel innan du öppnar räknaren.',
+  },
+  {
+    question: 'Hur avslutas ett färdigt spel?',
+    answer: 'När ett par når målpoängen aktiveras knappen för att stänga spelet. Efter bekräftelse läggs 1 spel till och stenarna nollställs.',
+  },
+  {
+    question: 'Sparas matchen om sidan laddas om?',
+    answer: 'Ja. Inställningar, parnamn, stenar och vunna spel sparas lokalt i webbläsaren.',
+  },
+  {
+    question: 'Tvingar poängräknaren på lokala Mus regler?',
+    answer: 'Nej. Mus har många regionala varianter. Denna digitala räknare fokuserar på exakt poängräkning vid bordet.',
+  },
+  {
+    question: 'Hur anpassar man en fransk kortlek för Mus?',
+    answer: 'Ta bort 8:or, 9:or och 10:or från den franska kortleken så att 40 kort återstår. Knektar är Sotas, Damer är Caballos och Kungar är Reyes.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Ange parens namn',
+    text: 'Fyll i namnen på de två paren för att enkelt identifiera dem vid bordet.',
+  },
+  {
+    name: 'Ställ in mål och vaca',
+    text: 'Välj 30, 40 eller 50 poäng per spel samt antal vunna spel som krävs för vaca.',
+  },
+  {
+    name: 'Räkna poäng och amarracos',
+    text: 'Tryck på sten (+1) eller amarraco (+5) när poäng delas ut i rundorna.',
+  },
+  {
+    name: 'Bekräfta spelet och nollställ stenar',
+    text: 'Bekräfta vinnaren när målpoängen nås för att registrera spelet och återställa stenarna.',
+  },
+];
+
+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: 'Online Mus Poängräknare',
+  operatingSystem: 'All',
+  applicationCategory: 'GameApplication',
+  description: 'Digital poängräknare för det traditionella spanska kortspelet Mus.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Hur du räknar poäng i kortspelet Mus',
+  step: howTo.map((item) => ({
+    '@type': 'HowToStep',
+    name: item.name,
+    text: item.text,
+  })),
+};
+
+const schemas: WithContext<SoftwareApplication | FAQPage | HowTo>[] = [
+  faqSchema,
+  appSchema,
+  howToSchema,
+];
+
+export const content: MusScoreboardLocaleContent = {
+  slug: 'online-mus-poangraknare',
+  title: 'Online Mus Poängräknare för Live Matcher',
+  description: 'Räkna stenar, amarracos, spel och vacas i det spanska kortspelet Mus. Anpassat för spanska och franska kortlekar.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Tydlig och Snabb Poängräkning för dina Mus Matcher', level: 2 },
+    { type: 'paragraph', html: 'Mus är ett traditonellt spanskt kortspel fullt av dynamik, taktik, bluffar och spänning. Eftersom poängen räknas snabbt efter varje runda (Grande, Chica, Pares, Juego eller Punto) förhindrar denna digitala räknare felräkningar och diskussioner vid bordet.' },
+    { type: 'title', text: 'Välj Målpoäng Innan Första Handen', level: 2 },
+    { type: 'paragraph', html: 'Klassiska matcher spelas traditionellt till 40 poäng, men det går även bra att spela till 30 eller 50 poäng. Ställ in målet innan ni delar ut första handen så att räknaren och knapparna för matchavslut stämmer exakt med bordets regler.' },
+    {
+      type: 'table',
+      headers: ['Inställning', 'Effekt', 'När den används'],
+      rows: [
+        ['30 poäng', 'Kort spel', 'Snabba matcher, turneringar eller lokala regler'],
+        ['40 poäng', 'Standardspel', 'Klassisk traditionell match med vänner'],
+        ['50 poäng', 'Långt spel', 'Matcher med mer utrymme för strategi och djup'],
+      ],
+    },
+    { type: 'tip', title: 'Stäm av Reglerna vid Bordet', html: 'Kom överens om regeln med 8 kungar och 8 ess (där 3:or fungerar som kungar och 2:or som ess) och vem som ansvarar för bordets fysiska marker eller bönor.' },
+    { type: 'title', text: 'Anpassning av Spansk och Fransk Kortlek', level: 2 },
+    { type: 'paragraph', html: 'Den spanska kortleken med 40 kort (Oros, Copas, Espadas, Bastos) är originalet för Mus. Med franska kort tar ni enkelt bort 8:or, 9:or och 10:or. Knektar är Sotas, Damer är Caballos och Kungar är Reyes.' },
+    { type: 'title', text: 'Digital Poängställning Direkt vid Bordet', level: 2 },
+    { type: 'paragraph', html: 'Det stora talet visar den totala poängställningen på ett tydligt sätt. Raden nedanför översätter automatiskt poängen till amarracos (5-poängsblock) och enskilda stenar för snabb avstämning.' },
+    { type: 'list', items: ['<strong>Sten (Piedra):</strong> 1 enskild poäng i matchens sammanställning.', '<strong>Amarraco:</strong> 1 märkmarkör eller block motsvarande 5 stenar.', '<strong>Spel (Chico):</strong> Vunnen runda när det avtalade målet nås.', '<strong>Vaca:</strong> Slutgiltig matchvinst vid uppnått antal vunna spel.'] },
+    { type: 'title', text: 'Avsluta Spel och Återställa Fel', level: 2 },
+    { type: 'paragraph', html: 'När målpoängen nås aktiveras knappen för att stänga spelet med en tydlig bekräftelse. Om en poäng trycks in felaktigt kan du använda Ångra knappen för att direkt återställa det senaste draget.' },
+    { type: 'tip', title: 'Använd Ångra vid Felräkning', html: 'Om du av misstag ger poäng till fel par trycker du direkt på Ångra för att rätta till poängställningen utan att förstöra historiken.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/mus-scoreboard/i18n/tr.ts

@@ -0,0 +1,187 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { MusScoreboardLocaleContent, MusScoreboardUI } from '../entry';
+
+const ui: MusScoreboardUI = {
+  onboarding: 'İki çiftin adını yazın, masa kurallarını belirleyin ve puanlar sayıldıkça taşlara dokunun.',
+  pairOneLabel: 'Birinci çift',
+  pairTwoLabel: 'İkinci çift',
+  pairOneDefault: 'Kuzey Masası',
+  pairTwoDefault: 'Güney Masası',
+  targetPointsLabel: 'Oyun başına hedef puan',
+  targetPointsHint: 'Her oyun için bitiş çizgisini seçin (30, 40 veya 50 puan).',
+  gamesToWinLabel: 'Vaca kazanmak için gereken oyun',
+  gamesToWinHint: 'Bu sayıya ilk ulaşan çift maçı kazanır.',
+  deckLabel: 'Masa destesi',
+  deckHint: '40 kartlık İspanyol destesi (Baraja española) Mus için geleneksel seçimdir. Fransız destesi için 8, 9 ve 10\'ları çıkarın.',
+  spanishDeck: 'Baraja española (İspanyol destesi)',
+  frenchDeck: 'Fransız destesi (Standart)',
+  frenchDeckNotice: '40 kartla oynamak için Fransız destesinden 8, 9 ve 10\'ları çıkarmayı unutmayın. Vale Sota, Kız Caballo ve Papaz Rey yerine geçer.',
+  pointsOption30: '30 puan',
+  pointsOption40: '40 puan',
+  pointsOption50: '50 puan',
+  gamesOption1: '1 oyun',
+  gamesOption2: '2 oyun',
+  gamesOption3: '3 oyun',
+  startMatch: 'Skor tahtasını aç',
+  matchSettings: 'Çiftleri ve kuralları ayarla',
+  liveMatch: 'Canlı maç',
+  targetLabel: 'puanlık oyun',
+  gameLabel: 'oyun',
+  gamePlural: 'oyun',
+  vacaLabel: 'oyun kazanan galip',
+  scoreLabel: 'Mevcut taşlar',
+  handLabel: 'Hangi çiftin el sahibi (Mano) olduğunu seçin',
+  handSelected: 'el sahibi (Mano).',
+  stonesLabel: 'Puan sayacı',
+  stoneSingular: 'taş (piedra)',
+  stonePlural: 'taş (piedras)',
+  amarracoSingular: 'amarraco',
+  amarracoPlural: 'amarracos',
+  pointsToGo: 'puan kaldı',
+  addStone: 'taş',
+  addAmarraco: 'amarraco',
+  closeGame: 'Oyunu kapat',
+  closeGamePrompt: 'Bu çiftin oyunu kazandığını onaylayıp sonrakine geçilsin mi?',
+  confirmationTitle: 'Masa işlemini onayla',
+  confirmAction: 'Onayla',
+  cancelAction: 'Oynamaya devam et',
+  undo: 'Geri al',
+  resetMatch: 'Maçı sıfırla',
+  resetMatchPrompt: 'Mevcut maçı sıfırlayıp skor geçmişini temizlemek istiyor musunuz?',
+  historyTitle: 'Son sayımlar',
+  noHistory: 'Henüz sayı girilmedi.',
+  matchReady: 'Masa hazır.',
+  closeGameHint: 'Bir çift hedef puana ulaştı. Oyun kazananını onaylayın.',
+  waitingForScore: 'Saymaya devam edin. Liderin kalan puanı:',
+  gameWon: 'Oyun kapatıldı.',
+  vacaWon: 'Vaca kazanıldı! Masa hazır olduğunda yeni bir maç başlatın.',
+  gameClosed: 'oyunu kapattı.',
+  pointsAdded: 'skor elde etti:',
+  matchSaved: 'Skor bu cihaza kaydedildi.',
+  lastAction: 'Son işlem',
+  settingsApplied: 'Yeni kurallar uygulandı. Maç sıfırlandı.',
+  pairNameRequired: 'Skor tahtasını açmadan önce her iki çifte de bir isim verin.',
+  visualScoreLabel: 'Mus masa oyunları için taşlı ve amarracolu dijital skor tahtası',
+};
+
+const faq = [
+  {
+    question: 'Bu çevrimiçi Mus skor tahtası neleri takip eder?',
+    answer: 'İki çifti, taşları (tekli puanlar), amarracoları (5 puanlık bloklar), kazanılan oyunları (chicos), vaca galibiyetini, el sahipliğini (Mano) ve skor geçmişini takip eder.',
+  },
+  {
+    question: 'Taşlar ve amarracolar neden ayrı gösterilir?',
+    answer: 'Bir taş (Piedra) 1 puan, Amarraco ise 5 taş değerindedir. Ayrı gösterim masadaki gerçek pullar veya fasulyelerle kolayca eşleşmesini sağlar.',
+  },
+  {
+    question: '30, 40 veya 50 puanlık oyun oynanabilir mi?',
+    answer: 'Evet. Skor tahtasını açmadan önce oyun başına 30, 40 veya 50 puan hedefini seçebilirsiniz.',
+  },
+  {
+    question: 'Tamamlanan oyun nasıl kapatılır?',
+    answer: 'Bir çift hedef puana ulaştığında oyunu kapat düğmesi etkinleşir. Onaylandıktan sonra 1 oyun eklenir ve taşlar sıfırlanır.',
+  },
+  {
+    question: 'Sayfa yenilendiğinde maç verileri korunur mu?',
+    answer: 'Evet. Çift isimleri, taşlar ve kazanılan oyunlar cihazınızın tarayıcısında yerel olarak saklanır.',
+  },
+  {
+    question: 'Bu skor tahtası bölgesel Mus kurallarını zorunlu kılar mı?',
+    answer: 'Hayır. Mus oyununun birçok bölgesel kuralı vardır. Bu skor tahtası masadaki puanları doğru şekilde kaydetmeye odaklanır.',
+  },
+  {
+    question: 'Fransız destesi Mus için nasıl uyarlanır?',
+    answer: '8, 9 ve 10 numaralı kartları çıkararak 40 kart bırakın. Vale Sota, Kız Caballo, Papaz ise Rey olarak kabul edilir.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Çift isimlerini girin',
+    text: 'Masadaki iki tarafın kolayca tanınması için oyuncu çiftlerinin isimlerini yazın.',
+  },
+  {
+    name: 'Hedef puanı ve vacayı belirleyin',
+    text: 'Oyun başına 30, 40 veya 50 puan ile vaca için gereken oyun sayısını seçin.',
+  },
+  {
+    name: 'Taş ve amarracoları sayın',
+    text: 'El sonlarında puanlar belirlendikçe taş (+1) veya amarraco (+5) ekleyin.',
+  },
+  {
+    name: 'Oyunu kapatın ve skoru güncelleyin',
+    text: 'Hedef puana ulaşıldığında kazananı onaylayarak oyunu kaydedin ve taşları sıfırlayın.',
+  },
+];
+
+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: 'Çevrimiçi Mus Skor Tahtası',
+  operatingSystem: 'All',
+  applicationCategory: 'GameApplication',
+  description: 'Geleneksel İspanyol kart oyunu Mus için dijital canlı skor tahtası.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Mus iskambil oyununda skor nasıl tutulur',
+  step: howTo.map((item) => ({
+    '@type': 'HowToStep',
+    name: item.name,
+    text: item.text,
+  })),
+};
+
+const schemas: WithContext<SoftwareApplication | FAQPage | HowTo>[] = [
+  faqSchema,
+  appSchema,
+  howToSchema,
+];
+
+export const content: MusScoreboardLocaleContent = {
+  slug: 'cevrimici-mus-skor-tahtasi',
+  title: 'Canlı Maçlar İçin Çevrimiçi Mus Skor Tahtası',
+  description: 'Geleneksel İspanyol kart oyunu Mus için taşları, amarracoları ve vacaları canlı takip edin. 30, 40 ve 50 puan seçenekleriyle.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Mus Masanız İçin Net ve Hızlı Skor Takibi', level: 2 },
+    { type: 'paragraph', html: 'Mus, İspanya\'nın en popüler ve köklü geleneksel iskambil oyunlarından biridir. Oyun dinamik, stratejik, heyecanlı ve blöf doludur. Her elde puanlar (Grande, Chica, Pares, Juego veya Punto) hızlıca sayıldığı için bu dijital sayaç masadaki anlaşmazlıkları ve karışıklıkları tamamen önler.' },
+    { type: 'title', text: 'İlk Elden Önce Bitiş Çizgisini Belirleyin', level: 2 },
+    { type: 'paragraph', html: 'Standart geleneksel oyun 40 puan olsa da, 30 veya 50 puanlık oyunlar da arkadaş grupları arasında sıkça tercih edilir. Dağıtımdan önce hedef puanı ayarlayın, böylece sayaç ve oyunu kapatma düğmeleri masanızın kurallarıyla tam olarak eşleşir.' },
+    {
+      type: 'table',
+      headers: ['Ayar', 'İşlev', 'Kullanım Önerisi'],
+      rows: [
+        ['30 puan', 'Kısa oyun', 'Hızlı maçlar, turnuva ön elemeleri veya yerel ev kuralları'],
+        ['40 puan', 'Standart oyun', 'Arkadaş ortamının geleneksel ve klasik kuralı'],
+        ['50 puan', 'Uzun oyun', 'Daha fazla strateji alanı ve oyun derinliği sunan maçlar'],
+      ],
+    },
+    { type: 'tip', title: 'Yerel Kuralları Bastan Konuşun', html: 'Kartları dağıtmadan önce 3\'lerin Papaz, 2\'lerin As sayıldığı 8 Papaz kuralının geçerli olup olmadığını ve masadaki fiziki pulları kimin tutacağını netleştirin.' },
+    { type: 'title', text: 'İspanyol ve Fransız Destesi Uyarlaması', level: 2 },
+    { type: 'paragraph', html: '40 kartlık geleneksel İspanyol destesi (Oros, Copas, Espadas, Bastos) oyunun aslıdır. Fransız destesinde 8, 9 ve 10\'lar çıkarılarak 40 kartla kolayca oynanabilir. Vale Sota, Kız Caballo ve Papaz Rey yerine geçer.' },
+    { type: 'title', text: 'Masa Kenarında Canlı Dijital Skor Takibi', level: 2 },
+    { type: 'paragraph', html: 'Büyük sayı toplam puanı anlaşılır bir şekilde gösterir. Altındaki satır bu rakamı otomatik olarak amarracolara (5\'lik bloklar) ve tekli taşlara dönüştürerek masadaki pullarla anında eşleştirir.' },
+    { type: 'list', items: ['<strong>Taş (Piedra):</strong> Maç sayımında 1 puanlık birim.', '<strong>Amarraco:</strong> 5 taşa denk gelen sayma pulu veya bloğu.', '<strong>Oyun (Chico):</strong> Hedef puana ulaşılarak kazanılan tur.', '<strong>Vaca:</strong> Belirlenen oyun sayısına ulaşıldığında alınan nihai maç galibiyeti.'] },
+    { type: 'title', text: 'Oyunu Kapatma ve Hata Düzeltme', level: 2 },
+    { type: 'paragraph', html: 'Hedef puana ulaşıldığında oyunu kapat düğmesi onay uyarısıyla birlikte aktif olur. Yanlış bir puan girilirse Geri al düğmesi ile son işlem anında geri alınabilir.' },
+    { type: 'tip', title: 'Hatalarda Geri Al Düğmesini Kullanın', html: 'Yanlış çifte puan eklendiğinde maç geçmişini bozmadan skoru düzeltmek için Geri al düğmesini kullanın.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/mus-scoreboard/i18n/zh.ts

@@ -0,0 +1,187 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { MusScoreboardLocaleContent, MusScoreboardUI } from '../entry';
+
+const ui: MusScoreboardUI = {
+  onboarding: '输入两个对局组合的名字，设定本桌规则，在每手牌结算时点击加分。',
+  pairOneLabel: '第一组',
+  pairTwoLabel: '第二组',
+  pairOneDefault: '北桌',
+  pairTwoDefault: '南桌',
+  targetPointsLabel: '每局目标分数 (Chico)',
+  targetPointsHint: '选择每局比赛的决胜分数线 (30、40 或 50 分)。',
+  gamesToWinLabel: '赢得大比分 (Vaca) 所需局数',
+  gamesToWinHint: '首先达到该局数的组将赢得整场比赛。',
+  deckLabel: '桌面所用纸牌',
+  deckHint: '40张牌的西班牙纸牌 (Baraja española) 是 Mus 的传统选择；法式扑克牌也可调整后使用。',
+  spanishDeck: 'Baraja española (西班牙纸牌)',
+  frenchDeck: '法式扑克牌',
+  frenchDeckNotice: '使用法式扑克牌时，请抽出 8、9、10，保持 40 张牌。Jack (J) 相当于 Sota，Queen (Q) 相当于 Caballo，King (K) 相当于 Rey。',
+  pointsOption30: '30 分',
+  pointsOption40: '40 分',
+  pointsOption50: '50 分',
+  gamesOption1: '1 局',
+  gamesOption2: '2 局',
+  gamesOption3: '3 局',
+  startMatch: '开启记分板',
+  matchSettings: '设定组名与规则',
+  liveMatch: '实时对局',
+  targetLabel: '分局',
+  gameLabel: '局',
+  gamePlural: '局',
+  vacaLabel: '局先胜',
+  scoreLabel: '当前筹码 (Piedras)',
+  handLabel: '选择本手发牌顺位首位 (Mano)',
+  handSelected: '为发牌首位 (Mano)。',
+  stonesLabel: '记分筹码',
+  stoneSingular: '1分筹码 (Piedra)',
+  stonePlural: '1分筹码 (Piedras)',
+  amarracoSingular: '5分筹码 (Amarraco)',
+  amarracoPlural: '5分筹码 (Amarracos)',
+  pointsToGo: '分胜出',
+  addStone: '1分 (Piedra)',
+  addAmarraco: '5分 (Amarraco)',
+  closeGame: '结算本局 (Chico)',
+  closeGamePrompt: '确认该组赢得本局 (Chico) 并开始下一局？',
+  confirmationTitle: '确认操作',
+  confirmAction: '确认',
+  cancelAction: '继续比赛',
+  undo: '撤销',
+  resetMatch: '重置比赛',
+  resetMatchPrompt: '确定要重置当前整场比赛并清空记分历史吗？',
+  historyTitle: '近期记分记录',
+  noHistory: '暂无记分记录。',
+  matchReady: '棋牌桌已就绪。',
+  closeGameHint: '已有组达到目标分数。请确认本局获胜方。',
+  waitingForScore: '继续记分。领先组距离目标尚差：',
+  gameWon: '本局结束。',
+  vacaWon: '获得大比分胜利 (Vaca)！桌面就绪后可开启新比赛。',
+  gameClosed: '赢得了本局。',
+  pointsAdded: '获得',
+  matchSaved: '比分已保存在本设备中。',
+  lastAction: '最近操作',
+  settingsApplied: '新规则已生效。',
+  pairNameRequired: '请在开启记分板前为两组都输入名称。',
+  visualScoreLabel: 'Mus 对局专用数字记分板',
+};
+
+const faq = [
+  {
+    question: '这款在线 Mus 记分板可以记录哪些内容？',
+    answer: '可记录两组选手名称、单分筹码 (Piedras)、5分筹码 (Amarracos)、已胜局数 (Chicos)、大比分 (Vaca)、发牌首位 (Mano) 标记以及详细的近期记分历史。',
+  },
+  {
+    question: '为什么把 1分 (Piedra) 和 5分 (Amarraco) 分开显示？',
+    answer: '在西班牙 Mus 牌局中，1分称为 Piedra，5分集合称为 Amarraco。分开显示能够方便数字记分板与桌面上实物筹码（如蚕豆或代币）进行直观对照。',
+  },
+  {
+    question: '支持 30 分、40 分或 50 分制吗？',
+    answer: '支持。在开启记分板前，您可以自由选择每局 30 分、40 分或 50 分的目标分。',
+  },
+  {
+    question: '一局结束后如何进行结算？',
+    answer: '当有一组达到目标分数时，结算本局按钮会亮起。确认获胜方后，系统将为其增加 1 局胜利，并将筹码分数重置为零。',
+  },
+  {
+    question: '断网或刷新页面后数据会丢失吗？',
+    answer: '不会。所有比赛设置与分数均安全保存在本地浏览器中。',
+  },
+  {
+    question: '这款记分板会强制执行特定地区的细则吗？',
+    answer: '不会。记分板专注于精确记录叫分与比分，具体的明喊与暗号留给玩家在棋牌桌上进行。',
+  },
+  {
+    question: '能否使用普通法式扑克牌进行 Mus 游戏？',
+    answer: '可以。只需抽掉 8、9、10 保持 40 张牌。J 对应 Sota，Q 对应 Caballo，K 对应 Rey。在传统规则中，3 可当作 K，2 可当作 A。',
+  },
+];
+
+const howTo = [
+  {
+    name: '输入两组选手名称',
+    text: '输入搭档组的名称（如北桌/南桌或选手姓名），以便记分员快速辨识。',
+  },
+  {
+    name: '设定目标分数与大比分 (Vaca) 局数',
+    text: '选择每局 30、40 或 50 分，并设定赢得大比分 (Vaca) 所需的局数。',
+  },
+  {
+    name: '按手牌结算记分',
+    text: '根据大牌 (Grande)、小牌 (Chica)、对子 (Pares)、点数 (Juego/Punto) 的决胜结果，点击 +1 分 (Piedra) 或 +5 分 (Amarraco) 筹码。',
+  },
+  {
+    name: '确认局胜利并重置分数',
+    text: '达到目标分数后确认本局胜者，记录局数并重置下一局筹码。',
+  },
+];
+
+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: '在线 Mus 记分板',
+  operatingSystem: 'All',
+  applicationCategory: 'GameApplication',
+  description: '专为西班牙传统扑克游戏 Mus 打造的实战实时数字记分器。',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: '如何在 Mus 纸牌对局中记分',
+  step: howTo.map((item) => ({
+    '@type': 'HowToStep',
+    name: item.name,
+    text: item.text,
+  })),
+};
+
+const schemas: WithContext<SoftwareApplication | FAQPage | HowTo>[] = [
+  faqSchema,
+  appSchema,
+  howToSchema,
+];
+
+export const content: MusScoreboardLocaleContent = {
+  slug: 'online-mus-scoreboard',
+  title: '在线 Mus 记分板',
+  description: '实时记录西班牙 Mus 纸牌对局中的 Piedras (1分)、Amarracos (5分)、Chicos (局) 与 Vacas (大比分)。支持 30/40/50 分制。',
+  ui,
+  seo: [
+    { type: 'title', text: '为激烈的 Mus 纸牌对局提供清晰准确的数字记分', level: 2 },
+    { type: 'paragraph', html: 'Mus 是西班牙最具代表性的传统纸牌游戏，充满心理博弈与同伴默契。每手牌都会在多个环节（Grande、Chica、Pares、Juego、Punto）结算得分，使用数字记分板能有效杜绝计错分的情况。' },
+    { type: 'title', text: '在首手发牌前设定胜负目标', level: 2 },
+    { type: 'paragraph', html: '标准规则通常为 40 分一局，但在不同地区也流行 30 分或 50 分制。在发牌前设定好规则，让记分器与棋牌桌保持同步。' },
+    {
+      type: 'table',
+      headers: ['设定', '规则效果', '适用场景'],
+      rows: [
+        ['30 分', '短局制', '快速对局或锦标赛预赛'],
+        ['40 分', '标准局制', '最经典与通用的传统对局'],
+        ['50 分', '长局制', '更具博弈深度与容错率的高手较量'],
+      ],
+    },
+    { type: 'tip', title: '对局前明确本地规则', html: '在切牌前，请与对家确认是否采用 8张K与8张A（即3当作K、2当作A）的规则，并确定实物筹码保管人。' },
+    { type: 'title', text: '西班牙纸牌 (Baraja española) 与法式扑克牌的转换', level: 2 },
+    { type: 'paragraph', html: 'Mus 传统采用 40 张牌的西班牙纸牌 (Baraja española)。如果使用普通法式扑克牌，只需移除 8、9、10。J 对应 Sota，Q 对应 Caballo，K 对应 Rey。' },
+    { type: 'title', text: '实时对比数字比分与棋牌桌物理筹码', level: 2 },
+    { type: 'paragraph', html: '主数字显示当前总得分，下方一行自动换算为 Amarracos (5分筹码) 与单分 Piedras，极大方便了现场核对。' },
+    { type: 'list', items: ['<strong>Piedra:</strong> 单分筹码。', '<strong>Amarraco:</strong> 相当于 5 个 Piedra 的记分块。', '<strong>Chico:</strong> 达到目标分数赢下的单局。', '<strong>Vaca:</strong> 赢得预设局数后取得的整场胜利。'] },
+    { type: 'title', text: '结算单局胜利与误操作撤销', level: 2 },
+    { type: 'paragraph', html: '当得分达到目标后，结算按钮亮起。若点错记分，可点击撤销按钮即刻还原。' },
+    { type: 'tip', title: '善用撤销功能修正误记', html: '在喊分记错时，立即点击撤销按钮即可恢复至上一计分状态。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/mus-scoreboard/index.ts

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

package/src/tool/mus-scoreboard/logic.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import {
+  addPoints,
+  canCloseGame,
+  closeGame,
+  createMusState,
+  decomposeScore,
+  getMatchWinner,
+  isGameReadyToClose,
+  remainingPoints,
+  setHand,
+  undoLastAction,
+  updateConfig,
+} from './logic';
+
+describe('mus scoreboard logic', () => {
+  it('creates a clean match with the supplied rules', () => {
+    const state = createMusState({ pairNames: ['North', 'South'], targetPoints: 30, gamesToWin: 3, deck: 'spanish' });
+    expect(state.points).toEqual([0, 0]);
+    expect(state.games).toEqual([0, 0]);
+    expect(state.hand).toBe(0);
+    expect(state.config.targetPoints).toBe(30);
+  });
+
+  it('adds stones and amarracos to one pair', () => {
+    const state = addPoints(addPoints(createMusState(), 0, 5), 1, 1);
+    expect(state.points).toEqual([5, 1]);
+    expect(state.history).toHaveLength(2);
+  });
+
+  it('decomposes a score into amarracos and stones', () => {
+    expect(decomposeScore(17)).toEqual({ amarracos: 3, stones: 2 });
+    expect(decomposeScore(0)).toEqual({ amarracos: 0, stones: 0 });
+  });
+
+  it('allows closing only when a pair reaches the target', () => {
+    const state = addPoints(createMusState(), 0, 5);
+    expect(canCloseGame(state, 0)).toBe(false);
+    expect(isGameReadyToClose(state)).toBe(false);
+    const ready = { ...state, points: [40, 12] as [number, number] };
+    expect(canCloseGame(ready, 0)).toBe(true);
+    expect(isGameReadyToClose(ready)).toBe(true);
+  });
+
+  it('closes a game, resets points and records the winner', () => {
+    const ready = { ...createMusState(), points: [40, 22] as [number, number] };
+    const closed = closeGame(ready, 0);
+    expect(closed.points).toEqual([0, 0]);
+    expect(closed.games).toEqual([1, 0]);
+    expect(closed.history.at(-1)?.action).toBe('Close game');
+  });
+
+  it('does not close a game for the wrong pair or after the match is won', () => {
+    const ready = { ...createMusState({ pairNames: ['A', 'B'], targetPoints: 30, gamesToWin: 1, deck: 'spanish' }), points: [30, 20] as [number, number] };
+    expect(closeGame(ready, 1)).toEqual(ready);
+    const matchWon = closeGame(ready, 0);
+    expect(getMatchWinner(matchWon)).toBe(0);
+    expect(closeGame({ ...matchWon, points: [30, 30] as [number, number] }, 1).games).toEqual([1, 0]);
+  });
+
+  it('undoes the latest score and then returns to a clean match', () => {
+    const first = addPoints(createMusState(), 0, 5);
+    const second = addPoints(first, 1, 1);
+    expect(undoLastAction(second).points).toEqual([5, 0]);
+    expect(undoLastAction(undoLastAction(second)).points).toEqual([0, 0]);
+  });
+
+  it('moves mano between pairs and includes it in undo history', () => {
+    const moved = setHand(createMusState(), 1);
+    expect(moved.hand).toBe(1);
+    expect(moved.history.at(-1)?.action).toBe('Hand');
+    expect(undoLastAction(moved).hand).toBe(0);
+  });
+
+  it('calculates remaining points and resets when settings change', () => {
+    const state = addPoints(createMusState(), 0, 5);
+    expect(remainingPoints(state, 0)).toBe(35);
+    const changed = updateConfig(state, { pairNames: ['A', 'B'], targetPoints: 50, gamesToWin: 1, deck: 'french' });
+    expect(changed.points).toEqual([0, 0]);
+    expect(changed.config.targetPoints).toBe(50);
+  });
+});