@jjlmoya/utils-home 1.5.0 → 1.7.0

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { SolarCalculatorUI } from '../ui';
+
+const slug = 'zonnepanelen-hellingshoek-calculator';
+const title = 'Zonnepanelen Hellingshoek Calculator';
+const description =
+  'Bereken de optimale hellingshoek voor uw zonnepanelen op basis van uw breedtegraad. Voor vaste installaties en seizoensgebonden aanpassingen.';
+
+const faqData = [
+  {
+    question: 'Wat als mijn dak niet de perfecte hoek heeft?',
+    answer:
+      'Dat is geen groot probleem. Het verlies bij afwijkingen van 5-10° is minder dan 3% van de jaarlijkse opbrengst. Het voorkomen van schaduw is belangrijker.',
+  },
+  {
+    question: 'Is de hoek overal ter wereld hetzelfde?',
+    answer:
+      'Nee, dit hangt af van de breedtegraad. In Amsterdam (~52°N) is de ideale hoek anders dan in Madrid (~40°N).',
+  },
+  {
+    question: 'Welke kant moeten de panelen op staan?',
+    answer:
+      'Op het noordelijk halfrond altijd naar het zuiden. Op het zuidelijk halfrond naar het noorden.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Voer breedtegraad in',
+    text: 'Voer uw breedtegraad in of gebruik de locatieknop.',
+  },
+  {
+    name: 'Check de optimale hoek',
+    text: 'De jaarlijkse hoek is het belangrijkste voor vaste systemen.',
+  },
+  {
+    name: 'Seizoensaanpassing (optioneel)',
+    text: 'Gebruik de winter- en zomerhoeken voor extra rendement bij verstelbare systemen.',
+  },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.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',
+};
+
+export const content: ToolLocaleContent<SolarCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Veelgestelde Vragen',
+  faq: faqData,
+  bibliographyTitle: 'Referenties',
+  bibliography: [
+    { name: 'PVGIS Tool', url: 'https://re.jrc.ec.europa.eu/pvgis/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'De Wetenschap van de Zonnehoek',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'De juiste hoek bepaalt hoeveel energie u echt opvraagt. Hoe meer loodrecht de zon op de panelen staat, hoe hoger de opbrengst.',
+    },
+    {
+      type: 'summary',
+      title: 'Tips voor een efficiënte installatie',
+      items: [
+        'Jaarlijkse hoek is de basis.',
+        'Kleine afwijkingen zijn niet erg.',
+        'Schaduw is de grootste vijand.',
+        'Richt op het zuiden op het noordelijk halfrond.',
+      ],
+    },
+  ],
+  ui: {
+    labelLatitude: 'Breedtegraad',
+    btnLocate: 'Vind mijn locatie',
+    labelOptimal: 'Optimale Jaarlijkse Hoek',
+    labelEfficiency: 'Maximale Efficiëntie',
+    labelWinter: 'Winter',
+    labelSummer: 'Zomer',
+    hemisphereNorth: 'Noordelijk Halfrond — Richt op ZUIDEN',
+    hemisphereSouth: 'Zuidelijk Halfrond — Richt op NOORDEN',
+    geoNotAvailable: 'Locatiebepaling niet beschikbaar.',
+  },
+};

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

@@ -0,0 +1,121 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { SolarCalculatorUI } from '../ui';
+
+const slug = 'kalkulator-paneli-slonecznych';
+const title = 'Kalkulator Nachylenia Paneli Słonecznych';
+const description =
+  'Oblicz optymalny kąt nachylenia paneli słonecznych na podstawie Twojej szerokości geograficznej. Wyniki dla instalacji stałych i okresowych.';
+
+const faqData = [
+  {
+    question: 'Co jeśli mój dach nie ma idealnego nachylenia?',
+    answer:
+      'To nie problem. Straty przy odchyleniu o 5-10° są mniejsze niż 3% produkcji rocznej. Ważniejsze jest unikanie cienia niż walka o każdy stopień kąta.',
+  },
+  {
+    question: 'Czy optymalny kąt jest taki sam na całym świecie?',
+    answer:
+      'Nie. Zależy od szerokości geograficznej. W Polsce (~52°N) kąt jest inny niż w Hiszpanii (~40°N) czy Australii.',
+  },
+  {
+    question: 'W którą stronę powinny patrzeć panele?',
+    answer:
+      'Na półkuli północnej zawsze na południe (azymut 180°). Na południowej — na północ.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Wpisz szerokość geograficzną',
+    text: 'Podaj szerokość w stopniach lub użyj przycisku auto-lokalizacji.',
+  },
+  {
+    name: 'Sprawdź kąt optymalny',
+    text: 'Kąt roczny to podstawa dla instalacji montowanych na stałe.',
+  },
+  {
+    name: 'Regulacja sezonowa (opcjonalnie)',
+    text: 'Jeśli masz regulowany stelaż, użyj kątów zimowych i letnich dla max. zysków.',
+  },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'PLN' },
+  inLanguage: 'pl',
+};
+
+export const content: ToolLocaleContent<SolarCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Często Zadawane Pytania',
+  faq: faqData,
+  bibliographyTitle: 'Bibliografia',
+  bibliography: [
+    { name: 'PVGIS — Europejskie narzędzie solarne', url: 'https://re.jrc.ec.europa.eu/pvgis/' },
+    { name: 'PVWatts Calculator', url: 'https://pvwatts.nrel.gov/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Nauka o Nachyleniu Słonecznym',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Efektywność paneli zależy od tego, jak prostopadle padają na nie promienie słońca. Poznaj geometrię słońca dla swojej lokalizacji.',
+    },
+    {
+      type: 'summary',
+      title: 'Klucze do wydajnej instalacji',
+      items: [
+        'Kąt roczny to główny punkt odniesienia.',
+        'Małe odchylenia ±5° nie psują produkcji.',
+        'Unikanie cienia jest absolutnie priorytetowe.',
+        'Orientacja na Południe (półkula płn.).',
+      ],
+    },
+  ],
+  ui: {
+    labelLatitude: 'Szerokość Geograficzna',
+    btnLocate: 'Wykryj moją lokalizację',
+    labelOptimal: 'Kąt Optymalny Roczny',
+    labelEfficiency: 'Maks. Efektywność',
+    labelWinter: 'Zima',
+    labelSummer: 'Lato',
+    hemisphereNorth: 'Półkula Północna — Kieruj na POŁUDNIE',
+    hemisphereSouth: 'Półkula Południowa — Kieruj na PÓŁNOC',
+    geoNotAvailable: 'Lokalizacja niedostępna w tej przeglądarce.',
+  },
+};

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

@@ -0,0 +1,126 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { SolarCalculatorUI } from '../ui';
+
+const slug = 'calculadora-inclinacao-paineis';
+const title = 'Calculadora de Inclinação de Painéis Solares';
+const description =
+  'Calcule o ângulo de inclinação ideal para os seus painéis solares com base na sua latitude. Obtenha valores para instalações fixas e ajustes sazonais.';
+
+const faqData = [
+  {
+    question: 'O que acontece se o meu telhado não tiver a inclinação perfeita?',
+    answer:
+      'Não é um problema grave. As perdas por pequenos desvios (5-10°) são inferiores a 3% da produção anual. É mais importante evitar sombras do que obcecar-se com o ângulo exato.',
+  },
+  {
+    question: 'O ângulo ideal é o mesmo em todo o mundo?',
+    answer:
+      'Não. Depende diretamente da sua latitude. Em Lisboa (~38°N) o ângulo ideal é diferente de alguém em Luanda (~8°S).',
+  },
+  {
+    question: 'Para onde devem olhar os painéis?',
+    answer:
+      'No Hemisfério Norte, sempre para Sul (azimute 180°). No Hemisfério Sul, para Norte.',
+  },
+  {
+    question: 'Serve também para coletores de água quente solar?',
+    answer:
+      'Sim. As fórmulas de inclinação são as mesmas para coletores térmicos e fotovoltaicos.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Introduza a latitude',
+    text: 'Escreva a latitude em graus decimais ou use o botão para detetar automaticamente.',
+  },
+  {
+    name: 'Consulte o ângulo ideal',
+    text: 'O ângulo ideal anual é a referência principal para instalações fixas.',
+  },
+  {
+    name: 'Ajuste por estação (opcional)',
+    text: 'Se tiver suporte regulável, use os ângulos de inverno e verão para maximizar os ganhos.',
+  },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.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',
+};
+
+export const content: ToolLocaleContent<SolarCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Perguntas Frequentes',
+  faq: faqData,
+  bibliographyTitle: 'Bibliografia',
+  bibliography: [
+    { name: 'PVGIS Tool', url: 'https://re.jrc.ec.europa.eu/pvgis/' },
+    { name: 'PVWatts Calculator', url: 'https://pvwatts.nrel.gov/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'A Ciência da Inclinação Solar',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'A orientação e o ângulo dos painéis determinam o retorno do investimento. Um painel deve estar o mais perpendicular possível aos raios solares.',
+    },
+    {
+      type: 'summary',
+      title: 'Chaves para uma instalação eficiente',
+      items: [
+        'O ângulo anual é o valor de referência.',
+        'Pequenos desvios têm pouco impacto na produção.',
+        'Evitar sombras é prioritário.',
+        'Orientar a Sul no Hemisfério Norte.',
+      ],
+    },
+  ],
+  ui: {
+    labelLatitude: 'Latitude Geográfica',
+    btnLocate: 'Detetar localização',
+    labelOptimal: 'Ângulo Ideal Anual',
+    labelEfficiency: 'Eficiência Máxima',
+    labelWinter: 'Inverno',
+    labelSummer: 'Verão',
+    hemisphereNorth: 'Hemisfério Norte — Orientar a SUL',
+    hemisphereSouth: 'Hemisfério Sul — Orientar a NORTE',
+    geoNotAvailable: 'Geolocalização não disponível.',
+  },
+};

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

@@ -0,0 +1,110 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { SolarCalculatorUI } from '../ui';
+
+const slug = 'solnechnyj-kalkulyator';
+const title = 'Калькулятор наклона солнечных панелей';
+const description =
+  'Рассчитайте оптимальный угол наклона для ваших солнечных панелей на основе вашей географической широты.';
+
+const faqData = [
+  {
+    question: 'Что если у моей крыши не идеальный наклон?',
+    answer:
+      'Это не критично. Потери при отклонении на 5-10° составляют менее 3% годовой выработки. Важнее избегать теней.',
+  },
+  {
+    question: 'В какую сторону должны смотреть панели?',
+    answer:
+      'В Северном полушарии — всегда на Юг (азимут 180°). В Южном полушарии — на Север.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Введите широту',
+    text: 'Укажите широту вашего местоположения или используйте кнопку автоопределения.',
+  },
+  {
+    name: 'Проверьте угол',
+    text: 'Оптимальный годовой угол — основное значение для фиксированных установок.',
+  },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'RUB' },
+  inLanguage: 'ru',
+};
+
+export const content: ToolLocaleContent<SolarCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Часто задаваемые вопросы',
+  faq: faqData,
+  bibliographyTitle: 'Библиография',
+  bibliography: [
+    { name: 'PVGIS Tool — European Commission', url: 'https://re.jrc.ec.europa.eu/pvgis/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Наука солнечного наклона',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Эффективность панелей напрямую зависит от угла падения солнечных лучей.',
+    },
+    {
+      type: 'summary',
+      title: 'Ключи к эффективной установке',
+      items: [
+        'Годовой оптимальный угол — главный ориентир.',
+        'Избегайте теней любой ценой.',
+        'Ориентация на Юг в северных широтах.',
+      ],
+    },
+  ],
+  ui: {
+    labelLatitude: 'Географическая широта',
+    btnLocate: 'Определить мое местоположение',
+    labelOptimal: 'Оптимальный годовой угол',
+    labelEfficiency: 'Макс. эффективность',
+    labelWinter: 'Зима',
+    labelSummer: 'Лето',
+    hemisphereNorth: 'Северное полушарие — Ориентир на ЮГ',
+    hemisphereSouth: 'Южное полушарие — Ориентир на СЕВЕР',
+    geoNotAvailable: 'Геолокация недоступна в этом браузере.',
+  },
+};

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

@@ -0,0 +1,110 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { SolarCalculatorUI } from '../ui';
+
+const slug = 'solkalkylator';
+const title = 'Lutningskalkylator för Solpaneler';
+const description =
+  'Beräkna optimal lutningsvinkel för dina solpaneler baserat på din geografiska breddgrad.';
+
+const faqData = [
+  {
+    question: 'Vad händer om mitt tak inte har perfekt lutning?',
+    answer:
+      'Det är inte ett stort problem. Förluster vid avvikelser på 5-10° är mindre än 3% av årsproduktionen. Det är viktigare att undvika skugga.',
+  },
+  {
+    question: 'Vilket håll ska panelerna vara vända mot?',
+    answer:
+      'På norra halvklotet, alltid mot söder (azimut 180°). På södra halvklotet, mot norr.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Ange breddgrad',
+    text: 'Skriv in din breddgrad eller använd knappen för att hitta din plats.',
+  },
+  {
+    name: 'Se optimal vinkel',
+    text: 'Den årliga optimala vinkeln är huvudreferensen för fasta installationer.',
+  },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'SEK' },
+  inLanguage: 'sv',
+};
+
+export const content: ToolLocaleContent<SolarCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Vanliga Frågor',
+  faq: faqData,
+  bibliographyTitle: 'Referenser',
+  bibliography: [
+    { name: 'PVGIS Tool', url: 'https://re.jrc.ec.europa.eu/pvgis/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Vetenskapen bakom Sollutning',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Panelernas effektivitet beror på hur vinkelrätt solens strålar träffar dem.',
+    },
+    {
+      type: 'summary',
+      title: 'Nycklar till en effektiv installation',
+      items: [
+        'Årlig optimal vinkel är din referens.',
+        'Undvik skugga till varje pris.',
+        'Riktning mot Söder på norra halvklotet.',
+      ],
+    },
+  ],
+  ui: {
+    labelLatitude: 'Geografisk Breddgrad',
+    btnLocate: 'Hitta min plats',
+    labelOptimal: 'Optimal Årlig Vinkel',
+    labelEfficiency: 'Maximal Effektivitet',
+    labelWinter: 'Vinter',
+    labelSummer: 'Sommar',
+    hemisphereNorth: 'Norra Halvklotet — Rikta mot SÖDER',
+    hemisphereSouth: 'Södra Halvklotet — Rikta mot NORR',
+    geoNotAvailable: 'Positionering är inte tillgänglig i denna webbläsare.',
+  },
+};