@jjlmoya/utils-developer 1.3.0 → 1.5.0

package/src/tool/readabilityCalculator/i18n/ja.ts

@@ -0,0 +1,134 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+
+const slug = 'visual-readability-calculator-wcag-apca';
+const title = '視覚的可読性チェッカー WCAG と APCA';
+const description = 'APCAとWCAG 3.0であなたのデザインの実際のコントラストを確認しましょう。フォントの太さとサイズが可読性に与える影響を分析できます。単純な比率から知覚的な読みやすさまで対応。';
+
+const faqData = [
+  {
+    question: 'APCAとは何ですか？WCAG 2.1とどう違うのですか？',
+    answer: 'APCAは、WCAG 3.0向けに開発された「Advanced Perceptual Contrast Algorithm（高度知覚コントラストアルゴリズム）」です。従来の単純な比率とは異なり、APCAは人間の脳がコントラストを知覚する仕組みを数学的にモデル化しており、極性（明るい背景 vs 暗い背景）やフォントのサイズ・ウェイトを考慮しています。',
+  },
+  {
+    question: 'Lc値はどういう意味ですか？',
+    answer: 'Lc（Lightness Contrast）はAPCAが算出するコントラスト値です。100が理想的な最大コントラストを示し、60を下回ると連続する文章テキストには問題があるとされます。これは知覚の絶対スケールです。',
+  },
+  {
+    question: 'フォントの太さは可読性にどう影響しますか？',
+    answer: '細いフォント（ThinやLight）は読みやすくするためにより高いコントラストが必要です。APCAは低ウェイトのフォントに対してより厳しい基準を設けており、WCAG基準をウェイト100のフォントで通過したデザインでも実際には読みにくい場合があります。',
+  },
+  {
+    question: 'このツールはプライバシーに配慮していますか？',
+    answer: 'はい。すべての計算はブラウザ上でローカルに実行されます。分析した色や設定がサーバーに送信されることはなく、デザインプロジェクトのプライバシーは完全に守られます。',
+  },
+];
+
+const howToData = [
+  { name: '色を選ぶ', text: 'カラーピッカーを使ってテキストカラーと背景色を設定してください。' },
+  { name: 'タイポグラフィを調整する', text: 'フォントサイズとウェイトのスライダーを動かして、実際のタイポグラフィを再現してください。' },
+  { name: '結果を確認する', text: 'WCAG 2.1比率とAPCAのLc値を確認して、デザインがアクセシブルかどうかを判断してください。' },
+  { name: '推奨事項を見直す', text: 'ボディテキスト、小さなテキスト、UI要素に対するAPCA固有の推奨事項を確認してください。' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ja',
+};
+
+const ui: ReadabilityCalculatorUI = {
+  labelColors: 'ベースカラー',
+  labelText: 'テキスト',
+  labelBg: '背景',
+  labelTypo: 'タイポグラフィ',
+  labelFontSize: 'フォントサイズ',
+  labelFontWeight: 'フォントウェイト',
+  labelCompare: 'コントラスト比較',
+  labelPreview: '知覚的プレビュー',
+  labelApcaRecs: 'APCA 推奨事項',
+  labelBody: '本文テキスト（Body）',
+  labelSmall: '小さいテキスト / キャプション',
+  labelUi: 'UI / ボタン',
+  statusYes: 'はい',
+  statusNo: 'いいえ',
+  wcagAAA: 'AAA 合格',
+  wcagAA: 'AA 合格',
+  wcagLarge: '大きいテキストのみ',
+  wcagFail: '不合格',
+  apcaExcellent: '優秀',
+  apcaGood: '良好',
+  apcaMinimal: '最低限',
+  apcaPoor: '不十分',
+  previewText: '視覚的な読みやすさは、数学だけではありません。光と影があなたの目と交わる感覚です。',
+  wcagRatioLabel: 'WCAG 2.1 比率',
+  apcaLcLabel: 'APCA Lc（WCAG 3）',
+};
+
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'よくある質問',
+  faq: faqData,
+  bibliographyTitle: 'コントラストとAPCAに関するリソース',
+  bibliography: [
+    { name: 'W3C: WCAG 3.0 ドラフト（Silver）', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' },
+    { name: 'Myndex: APCA リファレンスガイド', url: 'https://apcaw3.myndex.com/' },
+    { name: 'MDN: アクセシビリティとカラーコントラスト', url: 'https://developer.mozilla.org/ja/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: '視覚的可読性チェッカー（WCAG vs APCA）', level: 2 },
+    {
+      type: 'paragraph',
+      html: '新しい知覚的アクセシビリティ標準を使って、色とタイポグラフィが実際の読みやすさにどう影響するかを理解しましょう。WCAG 2.1は2008年のシンプルな数式を使用しています。<strong>APCA</strong>は人間の知覚を模倣した<strong>WCAG 3.0</strong>向けの新しいモデルです。',
+    },
+    { type: 'title', text: 'APCAの主なポイント', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>極性：</strong>ダークモードとライトモードでは知覚が異なることを考慮しています。',
+        '<strong>フォントウェイト：</strong>タイポグラフィの太さに応じた具体的なコントラストレベル（Lc）を設定します。',
+        '<strong>線形性：</strong>2008年の相対輝度モデルにある数学的な不正確さを修正します。',
+      ],
+    },
+    { type: 'title', text: '推奨されるAPCAレベル', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Lc 90+：</strong>非常に小さいテキストや細いウェイトのテキストに最適。',
+        '<strong>Lc 75：</strong>メインの本文テキストの標準。',
+        '<strong>Lc 60：</strong>中程度のサイズのコンテンツを読めるようにするための最低基準。',
+        '<strong>Lc 45：</strong>大きな要素や装飾的な要素の最低基準。',
+      ],
+    },
+  ],
+};
+

package/src/tool/readabilityCalculator/i18n/ko.ts

@@ -0,0 +1,134 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+
+const slug = 'visual-readability-calculator-wcag-apca';
+const title = '시각적 가독성 계산기 WCAG와 APCA';
+const description = 'APCA(WCAG 3.0)로 디자인의 실제 명암 대비를 확인하세요. 폰트 굵기와 크기가 실제 가독성에 미치는 영향을 분석합니다. 단순 비율부터 지각적 가독성까지 모두 확인할 수 있습니다.';
+
+const faqData = [
+  {
+    question: 'APCA란 무엇이며 WCAG 2.1과 어떻게 다른가요?',
+    answer: 'APCA는 WCAG 3.0을 위해 개발된 고급 지각적 명암 대비 알고리즘(Advanced Perceptual Contrast Algorithm)입니다. 기존의 단순 비율과 달리, APCA는 극성(밝은 배경 대 어두운 배경)과 폰트 크기 및 굵기를 고려하여 인간의 뇌가 명암 대비를 지각하는 방식을 수학적으로 모델링합니다.',
+  },
+  {
+    question: 'Lc 값은 무엇을 의미하나요?',
+    answer: 'Lc(Lightness Contrast)는 APCA가 생성하는 명암 대비 값입니다. 100은 이상적인 최대 명암 대비를 나타내며, 60 미만은 연속적인 읽기 텍스트에 문제가 생기기 시작하는 수준입니다. 이는 지각의 절대적 크기 척도입니다.',
+  },
+  {
+    question: '폰트 굵기가 가독성에 어떤 영향을 미치나요?',
+    answer: '얇은 폰트(Thin/Light)는 읽기 위해 훨씬 더 높은 명암 대비가 필요합니다. APCA는 낮은 굵기의 폰트에 불이익을 주며, 굵기 100의 폰트로 WCAG를 통과한 디자인이 실제로는 읽기 어려울 수 있음을 보여줍니다.',
+  },
+  {
+    question: '이 계산기는 개인정보를 보호하나요?',
+    answer: '네, 모든 계산은 브라우저에서 로컬로 수행됩니다. 분석하는 색상과 설정은 어떤 서버에도 전송되지 않으므로 디자인 프로젝트의 완전한 개인정보 보호가 보장됩니다.',
+  },
+];
+
+const howToData = [
+  { name: '색상 선택', text: '색상 선택기를 사용하여 디자인의 텍스트 색상과 배경 색상을 설정하세요.' },
+  { name: '타이포그래피 조정', text: '폰트 크기와 굵기 슬라이더를 조정하여 실제 타이포그래피를 시뮬레이션하세요.' },
+  { name: '결과 확인', text: 'WCAG 2.1 비율과 APCA Lc 값을 확인하여 디자인이 접근성 기준을 충족하는지 파악하세요.' },
+  { name: '권장 사항 검토', text: '본문 텍스트, 작은 텍스트, UI 요소에 대한 APCA 전용 권장 사항을 확인하세요.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ko',
+};
+
+const ui: ReadabilityCalculatorUI = {
+  labelColors: '기본 색상',
+  labelText: '텍스트',
+  labelBg: '배경',
+  labelTypo: '타이포그래피',
+  labelFontSize: '폰트 크기',
+  labelFontWeight: '폰트 굵기',
+  labelCompare: '명암 대비 비교',
+  labelPreview: '지각적 미리보기',
+  labelApcaRecs: 'APCA 권장 사항',
+  labelBody: '본문 텍스트 (Body)',
+  labelSmall: '작은 텍스트 / 캡션',
+  labelUi: 'UI / 버튼',
+  statusYes: '예',
+  statusNo: '아니오',
+  wcagAAA: 'AAA 통과',
+  wcagAA: 'AA 통과',
+  wcagLarge: '큰 텍스트만 해당',
+  wcagFail: '미통과',
+  apcaExcellent: '우수',
+  apcaGood: '양호',
+  apcaMinimal: '최소',
+  apcaPoor: '미흡',
+  previewText: '시각적 가독성은 수학만이 아닙니다. 빛과 그림자가 당신의 눈과 상호작용하는 방식입니다.',
+  wcagRatioLabel: 'WCAG 2.1 비율',
+  apcaLcLabel: 'APCA Lc (WCAG 3)',
+};
+
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: '자주 묻는 질문',
+  faq: faqData,
+  bibliographyTitle: '명암 대비와 APCA 관련 자료',
+  bibliography: [
+    { name: 'W3C: WCAG 3.0 초안 (Silver)', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' },
+    { name: 'Myndex: APCA 참조 가이드', url: 'https://apcaw3.myndex.com/' },
+    { name: 'MDN: 접근성과 색상 명암 대비', url: 'https://developer.mozilla.org/ko/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: '시각적 가독성 계산기 (WCAG vs APCA)', level: 2 },
+    {
+      type: 'paragraph',
+      html: '새로운 지각적 접근성 표준으로 색상과 타이포그래피가 실제 가독성에 미치는 영향을 이해하세요. WCAG 2.1은 2008년의 단순한 수학 공식을 사용합니다. <strong>APCA</strong>는 인간의 지각을 모방한 <strong>WCAG 3.0</strong>의 새로운 모델입니다.',
+    },
+    { type: 'title', text: 'APCA의 핵심 포인트', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>극성:</strong> 다크 모드와 라이트 모드가 다르게 인식된다는 점을 반영합니다.',
+        '<strong>폰트 굵기:</strong> 타이포그래피 굵기에 따른 구체적인 명암 대비 수준(Lc)을 설정합니다.',
+        '<strong>선형성:</strong> 2008년 상대적 밝기 모델의 수학적 부정확성을 수정합니다.',
+      ],
+    },
+    { type: 'title', text: '권장 APCA 수준', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Lc 90+:</strong> 매우 작거나 가는 텍스트에 이상적입니다.',
+        '<strong>Lc 75:</strong> 메인 본문 텍스트의 표준 수준입니다.',
+        '<strong>Lc 60:</strong> 중간 크기 콘텐츠의 최소 가독성 기준입니다.',
+        '<strong>Lc 45:</strong> 크거나 장식적인 요소의 최소 기준입니다.',
+      ],
+    },
+  ],
+};
+

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

@@ -0,0 +1,133 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+
+const slug = 'visuele-leesbaarheidsrekenmachine-wcag-apca';
+const title = 'Visuele Leesbaarheidsrekenmachine WCAG en APCA';
+const description = 'Controleer het werkelijke contrast van uw ontwerpen met APCA (WCAG 3.0). Analyseer hoe lettergewicht en -grootte de echte leesbaarheid beïnvloeden. Van eenvoudige verhoudingen tot perceptuele leesbaarheid.';
+
+const faqData = [
+  {
+    question: 'Wat is APCA en waarom verschilt het van WCAG 2.1?',
+    answer: 'APCA is het Advanced Perceptual Contrast Algorithm, ontwikkeld voor WCAG 3.0. Anders dan de oude eenvoudige verhouding gebruikt APCA wiskundige modellen die nabootsen hoe het menselijk brein contrast waarneemt, rekening houdend met polariteit (lichte vs. donkere achtergrond) en lettergrootte en -gewicht.',
+  },
+  {
+    question: 'Wat betekent de Lc-waarde?',
+    answer: 'Lc (Lightness Contrast) is de contrastwaarde die APCA genereert. Een waarde van 100 staat voor het ideale maximale contrast, terwijl waarden onder de 60 kritisch worden voor doorlopende leesteksten. Het is een absolute schaal voor perceptuele grootte.',
+  },
+  {
+    question: 'Hoe beïnvloedt het lettergewicht de leesbaarheid?',
+    answer: 'Dunne lettertypen (Thin/Light) vereisen een veel hoger contrast om leesbaar te zijn. APCA penaliseert lettertypen met een laag gewicht en laat zien dat een ontwerp dat WCAG haalt met een gewicht-100-lettertype in de praktijk onleesbaar kan zijn.',
+  },
+  {
+    question: 'Is deze rekenmachine privacyvriendelijk?',
+    answer: 'Ja, alle berekeningen worden lokaal in uw browser uitgevoerd. De kleuren en instellingen die u analyseert worden nooit naar een server verzonden, wat volledige privacy voor uw ontwerpprojecten garandeert.',
+  },
+];
+
+const howToData = [
+  { name: 'Kleuren kiezen', text: 'Gebruik de kleurkiezers om de tekstkleur en achtergrondkleur van uw ontwerp in te stellen.' },
+  { name: 'Typografie aanpassen', text: 'Versleep de schuifregelaars voor lettergrootte en -gewicht om uw werkelijke typografie te simuleren.' },
+  { name: 'Resultaten lezen', text: 'Controleer de WCAG 2.1-verhouding en de APCA Lc-waarde om te weten of uw ontwerp toegankelijk is.' },
+  { name: 'Aanbevelingen bekijken', text: 'Bekijk de APCA-specifieke aanbevelingen voor leestekst, kleine tekst en UI-elementen.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'nl',
+};
+
+const ui: ReadabilityCalculatorUI = {
+  labelColors: 'Basiskleuren',
+  labelText: 'Tekst',
+  labelBg: 'Achtergrond',
+  labelTypo: 'Typografie',
+  labelFontSize: 'Lettergrootte',
+  labelFontWeight: 'Lettergewicht',
+  labelCompare: 'Contrastvergelijking',
+  labelPreview: 'Perceptueel voorbeeld',
+  labelApcaRecs: 'APCA-aanbevelingen',
+  labelBody: 'Leestekst (Body)',
+  labelSmall: 'Kleine tekst / Bijschrift',
+  labelUi: 'UI / Knoppen',
+  statusYes: 'Ja',
+  statusNo: 'Nee',
+  wcagAAA: 'Slaagt voor AAA',
+  wcagAA: 'Slaagt voor AA',
+  wcagLarge: 'Alleen grote tekst',
+  wcagFail: 'Slaagt niet',
+  apcaExcellent: 'Uitstekend',
+  apcaGood: 'Goed',
+  apcaMinimal: 'Minimaal',
+  apcaPoor: 'Onvoldoende',
+  previewText: 'Visuele leesbaarheid is niet alleen wiskunde. Het is de manier waarop licht en schaduw met uw ogen samenwerken.',
+  wcagRatioLabel: 'WCAG 2.1-verhouding',
+  apcaLcLabel: 'APCA Lc (WCAG 3)',
+};
+
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Veelgestelde vragen',
+  faq: faqData,
+  bibliographyTitle: 'Bronnen over contrast en APCA',
+  bibliography: [
+    { name: 'W3C: WCAG 3.0-concept (Silver)', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' },
+    { name: 'Myndex: APCA-referentiegids', url: 'https://apcaw3.myndex.com/' },
+    { name: 'MDN: Toegankelijkheid en kleurcontrast', url: 'https://developer.mozilla.org/nl/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Visuele leesbaarheidsrekenmachine (WCAG vs APCA)', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Begrijp hoe uw kleuren en typografie de werkelijke leesbaarheid beïnvloeden met de nieuwe perceptuele toegankelijkheidsstandaard. WCAG 2.1 gebruikt een eenvoudige wiskundige formule uit 2008. <strong>APCA</strong> is het nieuwe model voor <strong>WCAG 3.0</strong> dat menselijke waarneming nabootst.',
+    },
+    { type: 'title', text: 'Kernpunten van APCA', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Polariteit:</strong> Begrijpt dat donkere modus anders wordt waargenomen dan lichte modus.',
+        '<strong>Lettergewicht:</strong> Kent specifieke contrastniveaus (Lc) toe op basis van het typografisch gewicht.',
+        '<strong>Lineariteit:</strong> Corrigeert wiskundige onnauwkeurigheden in het relatieve luminantiemodel uit 2008.',
+      ],
+    },
+    { type: 'title', text: 'Aanbevolen APCA-niveaus', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Lc 90+:</strong> Ideaal voor zeer kleine of lichte tekst.',
+        '<strong>Lc 75:</strong> De standaard voor gewone leestekst.',
+        '<strong>Lc 60:</strong> Minimum voor leesbare content van gemiddelde grootte.',
+        '<strong>Lc 45:</strong> Minimum voor grote of decoratieve elementen.',
+      ],
+    },
+  ],
+};

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

@@ -0,0 +1,29 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+
+const slug = 'kalkulator-czytelnosci-wizualnej-wcag-apca';
+const title = 'Kalkulator Czytelności Wizualnej WCAG i APCA';
+const description = 'Sprawdzaj rzeczywisty kontrast swoich projektów za pomocą APCA (WCAG 3.0). Analizuj, jak waga i rozmiar czcionki wpływają na faktyczną czytelność. Od prostych stosunków do percepcyjnej czytelności.';
+
+const faqData = [
+  { question: 'Co to jest APCA i czym się różni od WCAG 2.1?', answer: 'APCA to zaawansowany algorytm kontrastu percepcyjnego opracowany dla WCAG 3.0. W przeciwieństwie do starego prostego stosunku, APCA wykorzystuje modele matematyczne naśladujące sposób, w jaki ludzki mózg postrzega kontrast, biorąc pod uwagę polarność (jasne vs. ciemne tło) i rozmiar/wagę czcionki.' },
+  { question: 'Co oznacza wartość Lc?', answer: 'Lc (Lightness Contrast) to wartość kontrastu wygenerowana przez APCA. Wartość 100 reprezentuje idealny maksymalny kontrast, podczas gdy wartości poniżej 60 zaczynają być krytyczne dla ciągłego czytania tekstu. To absolutna skala wielkości percepcji.' },
+  { question: 'Jak waga czcionki wpływa na czytelność?', answer: 'Cienkie/lekkie czcionki wymagają znacznie wyższego kontrastu, aby być czytelne. APCA karze lekkie czcionki, wskazując, że projekt przechodzący WCAG z wagą 100 może być nieczytelny w praktyce.' },
+  { question: 'Czy ten kalkulator jest prywatny?', answer: 'Tak, wszystkie obliczenia są wykonywane lokalnie w przeglądarce. Kolory i ustawienia, które analizujesz, nigdy nie są wysyłane do żadnego serwera, gwarantując pełną prywatność dla Twoich projektów designu.' },
+];
+
+const howToData = [
+  { name: 'Wybierz kolory', text: 'Użyj selektorów kolorów, aby ustawić kolor tekstu i kolor tła Twojego designu.' },
+  { name: 'Dostosuj typografię', text: 'Przesuń suwaki rozmiaru czcionki i wagi, aby symulować swoją rzeczywistą typografię.' },
+  { name: 'Czytaj wyniki', text: 'Sprawdź stosunek WCAG 2.1 i wartość APCA Lc, aby wiedzieć, czy Twój design jest dostępny.' },
+  { name: 'Przejrzyj rekomendacje', text: 'Sprawdź rekomendacje specyficzne dla APCA dla tekstu głównego, małego tekstu i elementów UI.' },
+];
+
+const faqSchema: WithContext<FAQPage> = { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity: faqData.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })) };
+const howToSchema: WithContext<HowToThing> = { '@context': 'https://schema.org', '@type': 'HowTo', name: title, description, step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })) };
+const appSchema: WithContext<SoftwareApplication> = { '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: title, description, applicationCategory: 'UtilityApplication', operatingSystem: 'All', offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' }, inLanguage: 'pl' };
+
+const ui: ReadabilityCalculatorUI = { labelColors: 'Kolory Bazowe', labelText: 'Tekst', labelBg: 'Tło', labelTypo: 'Typografia', labelFontSize: 'Rozmiar Czcionki', labelFontWeight: 'Waga', labelCompare: 'Porównanie Kontrastu', labelPreview: 'Percepcyjny Podgląd', labelApcaRecs: 'Rekomendacje APCA', labelBody: 'Tekst Czytania (Treść)', labelSmall: 'Mały Tekst / Podpis', labelUi: 'UI / Przyciski', statusYes: 'Tak', statusNo: 'Nie', wcagAAA: 'Przechodzi AAA', wcagAA: 'Przechodzi AA', wcagLarge: 'Tylko duży tekst', wcagFail: 'Niepowodzenie', apcaExcellent: 'Doskonały', apcaGood: 'Dobry', apcaMinimal: 'Minimalny', apcaPoor: 'Słaby', previewText: 'Czytelność wizualna to nie tylko matematyka. To jak światło i cień oddziałują na twoje oczy.', wcagRatioLabel: 'Stosunek WCAG 2.1', apcaLcLabel: 'APCA Lc (WCAG 3)', };
+
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = { slug, title, description, ui, faqTitle: 'Często Zadawane Pytania', faq: faqData, bibliographyTitle: 'Zasoby na temat Kontrastu i APCA', bibliography: [{ name: 'W3C: WCAG 3.0 Draft (Silver)', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' }, { name: 'Myndex: APCA Reference Guide', url: 'https://apcaw3.myndex.com/' }, { name: 'MDN: Accessibility and Color Contrast', url: 'https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' }], howTo: howToData, schemas: [faqSchema, howToSchema, appSchema], seo: [{ type: 'title', text: 'Kalkulator Czytelności Wizualnej (WCAG vs APCA)', level: 2 }, { type: 'paragraph', html: 'Dowiedz się, jak Twoje kolory i typografia wpływają na rzeczywiste czytanie za pomocą nowego standardu percepcyjnej dostępności. WCAG 2.1 używa prostego wzoru matematycznego z 2008 roku. <strong>APCA</strong> to nowy model proponowany dla <strong>WCAG 3.0</strong>, który naśladuje percepcję człowieka.' }, { type: 'title', text: 'Kluczowe Punkty APCA', level: 3 }, { type: 'list', items: ['<strong>Polarność:</strong> Rozumie, że Tryb Ciemny jest postrzegany inaczej niż Tryb Jasny.', '<strong>Waga Czcionki:</strong> Przydziela określone poziomy kontrastu (Lc) w zależności od wagi typografii.', '<strong>Liniowość:</strong> Naprawia nieścisłości matematyczne w modelu względnej luminancji z 2008 roku.'] }, { type: 'title', text: 'Rekomendowane Poziomy APCA', level: 3 }, { type: 'list', items: ['<strong>Lc 90+:</strong> Idealne dla bardzo małego lub nisko ważonego tekstu.', '<strong>Lc 75:</strong> Standard dla głównego tekstu czytającego.', '<strong>Lc 60:</strong> Minimum dla czytelnej zawartości średniego rozmiaru.', '<strong>Lc 45:</strong> Minimum dla dużych lub dekoracyjnych elementów.'] }] };

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

@@ -0,0 +1,91 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+const slug = 'calculadora-legibilidade-visual';
+const title = 'Calculadora de Legibilidade Visual WCAG e APCA';
+const description = 'Verifique o contraste real de seus designs com APCA (WCAG 3.0). Analise como peso e tamanho da fonte afetam a legibilidade real.';
+const faqData = [
+  { question: 'O que é APCA e por que é diferente de WCAG 2.1?', answer: 'APCA é o Algoritmo Avançado de Contraste Perceptual desenvolvido para WCAG 3.0. Diferentemente da razão simples antiga, APCA usa modelos matemáticos que imitam como o cérebro humano percebe contraste, levando em conta polaridade e peso/tamanho da fonte.' },
+  { question: 'O que significa o valor Lc?', answer: 'Lc (Contraste de Luminosidade) é o valor de contraste gerado por APCA. Um valor de 100 representa contraste máximo ideal, enquanto valores abaixo de 60 começam a ser críticos para leitura contínua.' },
+  { question: 'Como o peso da fonte afeta a legibilidade?', answer: 'Fontes Finas/Claras requerem contraste muito mais alto para serem legíveis. APCA penaliza fontes de baixo peso, indicando que um design passando em WCAG com fonte peso-100 pode ser ilegível na prática.' },
+  { question: 'Esta calculadora é privada?', answer: 'Sim, todos os cálculos são realizados localmente em seu navegador. As cores e configurações que você analisa nunca são enviadas para nenhum servidor, garantindo total privacidade.' },
+];
+const howToData = [
+  { name: 'Escolha Cores', text: 'Use os seletores de cor para definir a cor do texto e cor de fundo do seu design.' },
+  { name: 'Ajuste Tipografia', text: 'Mova os sliders de tamanho e peso de fonte para simular sua tipografia real.' },
+  { name: 'Leia os Resultados', text: 'Verifique a razão WCAG 2.1 e o valor Lc APCA para saber se seu design é acessível.' },
+  { name: 'Revise Recomendações', text: 'Verifique recomendações específicas de APCA para texto corporal, texto pequeno e elementos de UI.' },
+];
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'pt',
+};
+const ui: ReadabilityCalculatorUI = {
+  labelColors: 'Cores Base',
+  labelText: 'Texto',
+  labelBg: 'Fundo',
+  labelTypo: 'Tipografia',
+  labelFontSize: 'Tamanho da Fonte',
+  labelFontWeight: 'Peso',
+  labelCompare: 'Comparação de Contraste',
+  labelPreview: 'Visualização Perceptual',
+  labelApcaRecs: 'Recomendações APCA',
+  labelBody: 'Texto de Leitura (Corpo)',
+  labelSmall: 'Texto Pequeno / Legenda',
+  labelUi: 'UI / Botões',
+  statusYes: 'Sim',
+  statusNo: 'Não',
+  wcagAAA: 'Aprova AAA',
+  wcagAA: 'Aprova AA',
+  wcagLarge: 'Apenas Texto Grande',
+  wcagFail: 'Falha',
+  apcaExcellent: 'Excelente',
+  apcaGood: 'Bom',
+  apcaMinimal: 'Mínimo',
+  apcaPoor: 'Pobre',
+  previewText: 'A legibilidade visual não é apenas matemática. É como luz e sombra interagem com seus olhos.',
+  wcagRatioLabel: 'Razão WCAG 2.1',
+  apcaLcLabel: 'APCA Lc (WCAG 3)',
+};
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Perguntas Frequentes',
+  faq: faqData,
+  bibliographyTitle: 'Recursos em Contraste e APCA',
+  bibliography: [
+    { name: 'W3C: WCAG 3.0 Draft (Silver)', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' },
+    { name: 'Myndex: Guia de Referência APCA', url: 'https://apcaw3.myndex.com/' },
+    { name: 'MDN: Acessibilidade e Contraste de Cor', url: 'https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Calculadora de Legibilidade Visual (WCAG vs APCA)', level: 2 },
+    { type: 'paragraph', html: 'Entenda como suas cores e tipografia afetam a leitura real com o novo padrão de acessibilidade perceptual. WCAG 2.1 usa uma fórmula matemática simples de 2008. <strong>APCA</strong> é o novo modelo proposto para <strong>WCAG 3.0</strong> que imita percepção humana.' },
+    { type: 'title', text: 'Pontos-Chave de APCA', level: 3 },
+    { type: 'list', items: [ '<strong>Polaridade:</strong> Entende que Modo Escuro é percebido diferentemente do Modo Claro.', '<strong>Peso da Fonte:</strong> Atribui níveis de contraste específicos (Lc) baseado em peso tipográfico.', '<strong>Linearidade:</strong> Corrige imprecisões matemáticas no modelo de luminância relativa de 2008.' ] },
+    { type: 'title', text: 'Níveis APCA Recomendados', level: 3 },
+    { type: 'list', items: [ '<strong>Lc 90+:</strong> Ideal para texto muito pequeno ou peso baixo.', '<strong>Lc 75:</strong> Padrão para texto corporal principal.', '<strong>Lc 60:</strong> Mínimo para conteúdo médio legível.', '<strong>Lc 45:</strong> Mínimo para elementos grandes ou decorativos.' ] },
+  ],
+};

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

@@ -0,0 +1,91 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ReadabilityCalculatorUI } from '../ui';
+const slug = 'kalkulyator-vizualnoj-chitaemosti';
+const title = 'Калькулятор Визуальной Читаемости WCAG и APCA';
+const description = 'Проверьте реальный контраст ваших дизайнов с APCA (WCAG 3.0). Анализируйте, как вес и размер шрифта влияют на фактическую читаемость.';
+const faqData = [
+  { question: 'Что такое APCA и почему она отличается от WCAG 2.1?', answer: 'APCA - это Алгоритм Расширенного Перцептивного Контраста, разработанный для WCAG 3.0. В отличие от старой простой формулы, APCA использует математические модели, которые имитируют, как человеческий мозг воспринимает контраст.' },
+  { question: 'Что означает значение Lc?', answer: 'Lc (Lightness Contrast) - это значение контраста, сгенерированное APCA. Значение 100 представляет идеальный максимальный контраст, а значения ниже 60 начинают быть критическими для непрерывного чтения текста.' },
+  { question: 'Как вес шрифта влияет на читаемость?', answer: 'Тонкие/Светлые шрифты требуют гораздо более высокого контраста для читаемости. APCA штрафует шрифты низкого веса, указывая, что дизайн, прошедший WCAG с шрифтом weight-100, может быть нечитаемым на практике.' },
+  { question: 'Этот калькулятор приватный?', answer: 'Да, все расчеты выполняются локально в вашем браузере. Цвета и настройки, которые вы анализируете, никогда не отправляются на какой-либо сервер, гарантируя полную конфиденциальность.' },
+];
+const howToData = [
+  { name: 'Выберите Цвета', text: 'Используйте средства выбора цвета для установки цвета текста и цвета фона вашего дизайна.' },
+  { name: 'Отрегулируйте Типографику', text: 'Переместите ползунки размера и веса шрифта, чтобы смоделировать вашу реальную типографику.' },
+  { name: 'Прочитайте Результаты', text: 'Проверьте коэффициент WCAG 2.1 и значение Lc APCA, чтобы узнать, доступен ли ваш дизайн.' },
+  { name: 'Просмотрите Рекомендации', text: 'Проверьте рекомендации для основного текста, мелкого текста и элементов UI.' },
+];
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ru',
+};
+const ui: ReadabilityCalculatorUI = {
+  labelColors: 'Базовые Цвета',
+  labelText: 'Текст',
+  labelBg: 'Фон',
+  labelTypo: 'Типографика',
+  labelFontSize: 'Размер Шрифта',
+  labelFontWeight: 'Вес',
+  labelCompare: 'Сравнение Контраста',
+  labelPreview: 'Перцептивный Предпросмотр',
+  labelApcaRecs: 'Рекомендации APCA',
+  labelBody: 'Основной Текст',
+  labelSmall: 'Мелкий Текст',
+  labelUi: 'UI / Кнопки',
+  statusYes: 'Да',
+  statusNo: 'Нет',
+  wcagAAA: 'Проходит AAA',
+  wcagAA: 'Проходит AA',
+  wcagLarge: 'Только Крупный Текст',
+  wcagFail: 'Не Проходит',
+  apcaExcellent: 'Отличное',
+  apcaGood: 'Хорошее',
+  apcaMinimal: 'Минимальное',
+  apcaPoor: 'Плохое',
+  previewText: 'Визуальная читаемость - это не только математика. Это то, как свет и тень взаимодействуют с вашими глазами.',
+  wcagRatioLabel: 'Коэффициент WCAG 2.1',
+  apcaLcLabel: 'APCA Lc (WCAG 3)',
+};
+export const content: ToolLocaleContent<ReadabilityCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Часто Задаваемые Вопросы',
+  faq: faqData,
+  bibliographyTitle: 'Ресурсы о Контрасте и APCA',
+  bibliography: [
+    { name: 'W3C: WCAG 3.0 Draft (Silver)', url: 'https://www.w3.org/WAI/standards-guidelines/wcag/wcag3-intro/' },
+    { name: 'Myndex: Справочное Руководство APCA', url: 'https://apcaw3.myndex.com/' },
+    { name: 'MDN: Доступность и Контраст Цвета', url: 'https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Калькулятор Визуальной Читаемости (WCAG vs APCA)', level: 2 },
+    { type: 'paragraph', html: 'Поймите, как ваши цвета и типографика влияют на реальное чтение с новым стандартом доступности восприятия. WCAG 2.1 использует простую математическую формулу 2008 года. <strong>APCA</strong> - это новая модель, предложенная для <strong>WCAG 3.0</strong>, которая имитирует человеческое восприятие.' },
+    { type: 'title', text: 'Ключевые Моменты APCA', level: 3 },
+    { type: 'list', items: [ '<strong>Полярность:</strong> Понимает, что Темный режим воспринимается иначе, чем Светлый режим.', '<strong>Вес Шрифта:</strong> Назначает определенные уровни контраста (Lc) на основе веса типографики.', '<strong>Линейность:</strong> Исправляет математические неточности в модели относительной яркости 2008 года.' ] },
+    { type: 'title', text: 'Рекомендуемые Уровни APCA', level: 3 },
+    { type: 'list', items: [ '<strong>Lc 90+:</strong> Идеально для очень мелкого текста или низкого веса.', '<strong>Lc 75:</strong> Стандарт для основного текста для чтения.', '<strong>Lc 60:</strong> Минимум для читаемого контента среднего размера.', '<strong>Lc 45:</strong> Минимум для крупных или декоративных элементов.' ] },
+  ],
+};