@jjlmoya/utils-cooking 1.12.0 → 1.13.0

package/src/tool/ingredient-rescaler/i18n/pt.ts

@@ -0,0 +1,244 @@
+import type { ToolLocaleContent } from '../../../types';
+
+const title = 'Escalador de Ingredientes Ajuste de Receitas';
+const description = 'Escala receitas automaticamente segundo o número de doses. Calcula as quantidades exatas de ingredientes multiplicando ou reduzindo a tua receita sem complicações.';
+
+const faq = [
+  {
+    question: 'Por que o meu fator de conversão inclui decimais?',
+    answer: 'Porque as proporções culinárias nem sempre são redondas. Se escalas uma receita para 4 pessoas para 7, o fator é exatamente 1.75. Os ingredientes são multiplicados por esse número, mesmo que encontres frações. É mais exato do que arredondar arbitrariamente.',
+  },
+  {
+    question: 'O que acontece se eu inserir "1/2 colher de chá de sal"?',
+    answer: 'O parser procura o número primeiro. Reconhecerá "1" como quantidade, depois "/2" como parte da unidade. O resultado será "0.5", e ao escalar será multiplicado corretamente. Para frações como "1/2", insere "0.5" diretamente (é mais claro) ou a ferramenta interpreta como divisão.',
+  },
+  {
+    question: 'Devo arredondar os resultados finais?',
+    answer: 'Depende do ingrediente. Para farinhas, sim. Para fermentos ou especiarias, a precisão importa menos (escala a 75% do indicado). Para ovos: se obtiveres 2.3, usa 2 inteiros + parte de um terceiro (pesado), ou arredonda para 2 se o prato o permitir.',
+  },
+  {
+    question: 'Por que o resultado não muda quando altero as doses?',
+    answer: 'Certifica-te de que o campo de ingredientes tem conteúdo. Se estiver vazio, não há nada para escalar. Verifica também se os números nos teus ingredientes são reconhecíveis (ex: "500g", "1/2 colher de chá").',
+  },
+  {
+    question: 'Funciona com medidas imperiais (onzas, chávenas)?',
+    answer: 'Tecnicamente sim, a ferramenta lê números e escala. Mas a precisão é limitada com chávenas (volume inconsistente). Recomenda-se converter para gramas antes de escalar.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Insere as tuas doses',
+    text: 'No campo "Original", coloca o número de pessoas para o qual a receita foi desenhada. Em "Desejado", coloca o número de pessoas para quem vais cozinhar.',
+  },
+  {
+    name: 'Cola a tua lista de ingredientes',
+    text: 'Copia e cola a tua lista tal como está. Cada ingrediente numa linha. A ferramenta reconhece números no início (500g, 1/2, 2.5) e escala automaticamente.',
+  },
+  {
+    name: 'Ajusta segundo o contexto',
+    text: 'Os resultados são matematicamente exatos, mas a cozinha é arte. Especiarias: escala a 75%. Fermentos: menos do que o teórico em grandes quantidades. Tempos: nunca se escalam.',
+  },
+];
+
+const faqSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'All',
+};
+
+export const content: ToolLocaleContent = {
+  slug: 'reescalador-ingredientes',
+  title,
+  description,
+  ui: {
+    servings: 'Doses',
+    original: 'Original',
+    desired: 'Desejado',
+    multiplyingFactor: 'Fator Multiplicador',
+    ingredientsList: 'Lista de Ingredientes',
+    pasteHere: 'Cola aqui a tua lista.',
+    exampleLine1: 'Ex:',
+    exampleLine2: '500g Farinha',
+    exampleLine3: '300ml Água',
+    exampleLine4: '10g Sal',
+    result: 'Resultado',
+    copy: 'Copiar',
+    copied: 'Copiado!',
+    emptyState: 'Os teus ingredientes ajustados aparecerão aqui...',
+    defaultIngredient1: '200g Farinha',
+    defaultIngredient2: '100ml Leite',
+    defaultIngredient3: '2 Ovos',
+  },
+  faqTitle: 'Perguntas Frequentes',
+  faq,
+  bibliographyTitle: 'Bibliografia',
+  bibliography: [
+    {
+      name: 'Harold McGee - On Food and Cooking: The Science and Lore of the Kitchen',
+      url: 'https://en.wikipedia.org/wiki/Harold_McGee',
+    },
+    {
+      name: 'The Flavor Bible by Karen Page and Andrew Dornenburg',
+      url: 'https://www.flavorprints.com/',
+    },
+    {
+      name: 'Modernist Cuisine - Técnicas de escalamento científico',
+      url: 'https://www.modernistcuisine.com/',
+    },
+  ],
+  howTo,
+  seo: [
+    {
+      type: 'title',
+      text: 'Guia Mestre para o Escalamento e Conversão de Receitas',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'O <strong>escalamento de ingredientes</strong> é uma das tarefas mais críticas e propensas a erros na cozinha profissional. Não se trata simplesmente de multiplicar números, mas de entender como a química e a física dos alimentos reagem a mudanças de volume e superfície.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        {
+          value: 'x1.75',
+          label: 'Fator de 4 para 7 per.',
+          icon: 'mdi:calculator',
+        },
+        {
+          value: '75%',
+          label: 'Ajuste de Especiarias',
+          icon: 'mdi:shaker-outline',
+        },
+        {
+          value: '0%',
+          label: 'Escalamento de Tempo',
+          icon: 'mdi:timer-off',
+        },
+        {
+          value: '100g',
+          label: 'Base de Referência',
+          icon: 'mdi:weight-gram',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Diferenças entre Escalamento Linear e Contextual',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Escalamento Linear Matemático',
+          icon: 'mdi:math-log',
+          description: 'Multiplicação direta de todos os valores pelo fator de conversão obtido.',
+          points: [
+            'Perfeito para farinhas e líquidos base',
+            'Ideal para pastelaria de precisão',
+            'Funciona bem em mudanças pequenas (x2, x0.5)',
+            'Fácil de calcular automaticamente',
+          ],
+        },
+        {
+          title: 'Escalamento Contextual de Cozinha',
+          icon: 'mdi:chef-hat',
+          description: 'Ajuste de proporções baseado na saturação de sabor e evaporação.',
+          highlight: true,
+          points: [
+            'Evita o excesso de sal e especiarias',
+            'Considera a superfície de evaporação',
+            'Ajusta fermentos segundo a massa',
+            'Exige experiência e critério do chef',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Fatores de Conversão por Número de Comensais',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['De Doses', 'Para Doses', 'Fator (FC)', 'Dificuldade'],
+      rows: [
+        ['2 pessoas', '4 pessoas', 'x 2.0', 'Baixa (Linear)'],
+        ['4 pessoas', '6 pessoas', 'x 1.5', 'Baixa (Linear)'],
+        ['4 pessoas', '10 pessoas', 'x 2.5', 'Média (Atenção às especiarias)'],
+        ['4 pessoas', '25 pessoas', 'x 6.25', 'Alta (Contextual)'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Problemas Comuns ao Dobrar uma Receita',
+      html: 'Se notares que o sabor é demasiado intenso após escalar (especialmente com picantes ou sal), reduz o escalamento destes ingredientes específicos a 75%. Nunca dupliques o tempo de cozedura; a temperatura interna é atingida segundo a espessura da peça.',
+    },
+    {
+      type: 'title',
+      text: 'Glossário de Terminologia de Estandardização',
+      level: 3,
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'Fator de Conversão',
+          definition: 'Número pelo qual se multiplicam todos os ingredientes: Quantidade Desejada / Quantidade Original.',
+        },
+        {
+          term: 'Perda de Cozedura',
+          definition: 'Perda de peso de um ingrediente por evaporação ou perda de gordura.',
+        },
+        {
+          term: 'Peso Bruto vs Líquido',
+          definition: 'O peso antes e depois de limpar o ingrediente.',
+        },
+        {
+          term: 'Rendimento',
+          definition: 'Quantidade total de produto terminado após o escalamento e a cozedura.',
+        },
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'O truque do Ovo Batido',
+      html: 'Se a calculadora indicar 2.3 ovos, bate um ovo inteiro, pesa-o e utiliza apenas 30% do peso. É a única forma de manter a precisão em pastelaria fina.',
+    },
+    {
+      type: 'paragraph',
+      html: 'A nossa ferramenta simplifica a matemática para que possas dedicar a tua energia ao que realmente importa: criatividade e sabor.',
+    },
+  ],
+  schemas: [appSchema, faqSchema, howToSchema],
+};

package/src/tool/ingredient-rescaler/i18n/ru.ts

@@ -0,0 +1,244 @@
+import type { ToolLocaleContent } from '../../../types';
+
+const title = 'Калькулятор масштабирования ингредиентов и рецептов';
+const description = 'Автоматически изменяйте масштаб рецептов в зависимости от количества порций. Рассчитывайте точное количество ингредиентов без лишних сложностей.';
+
+const faq = [
+  {
+    question: 'Почему мой коэффициент пересчета содержит десятичные дроби?',
+    answer: 'Потому что кулинарные пропорции не всегда кратны целым числам. Если вы масштабируете рецепт с 4 человек на 7, коэффициент составит ровно 1,75. Ингредиенты умножаются на это число, даже если в итоге получаются дробные значения. Это точнее, чем произвольное округление.',
+  },
+  {
+    question: 'Что произойдет, если я введу "1/2 чайной ложки соли"?',
+    answer: 'Парсер сначала ищет число. Он распознает "1" как количество, а затем "/2" как часть единицы измерения. Результат будет "0,5" и будет масштабирован правильно. Для таких дробей лучше сразу вводить "0,5" (так понятнее), либо инструмент интерпретирует их как деление.',
+  },
+  {
+    question: 'Нужно ли округлять финальные результаты?',
+    answer: 'Зависит от ингредиента. Для муки — да. Для дрожжей или специй точность менее критична (масштабируйте их до 75% от расчетного). Для яиц: если получилось 2,3, используйте 2 целых + часть третьего (взвесив его), или округлите до 2, если блюдо это позволяет.',
+  },
+  {
+    question: 'Почему результат не меняется при изменении порций?',
+    answer: 'Убедитесь, что поле ингредиентов не пустое. Если оно пустое, масштабировать нечего. Также проверьте, чтобы числа в списке ингредиентов были узнаваемыми (например, "500г", "1/2 ч.л.").',
+  },
+  {
+    question: 'Работает ли это с имперскими мерами (унции, чашки)?',
+    answer: 'Технически да, инструмент считывает числа и масштабирует их. Но точность с чашками ограничена из-за непостоянства объема. Рекомендуется переводить все в граммы перед масштабированием.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Введите порции',
+    text: 'В поле "Оригинал" укажите количество человек, на которое рассчитан исходный рецепт. В поле "Желаемое" — сколько человек вы планируете накормить.',
+  },
+  {
+    name: 'Вставьте список ингредиентов',
+    text: 'Скопируйте и вставьте список как есть. Каждому ингредиенту — отдельная строка. Инструмент распознает числа в начале (500г, 1/2, 2.5) и автоматически изменит масштаб.',
+  },
+  {
+    name: 'Корректируйте по контексту',
+    text: 'Результаты математически точны, но кулинария — это искусство. Специи: масштабируйте до 75%. Дрожжи: при больших объемах берите чуть меньше. Время приготовления никогда не масштабируется.',
+  },
+];
+
+const faqSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'All',
+};
+
+export const content: ToolLocaleContent = {
+  slug: 'pereraschet-ingredientov',
+  title,
+  description,
+  ui: {
+    servings: 'Порции',
+    original: 'Оригинал',
+    desired: 'Желаемое',
+    multiplyingFactor: 'Множитель',
+    ingredientsList: 'Список ингредиентов',
+    pasteHere: 'Вставьте ваш список здесь.',
+    exampleLine1: 'Пример:',
+    exampleLine2: '500г Муки',
+    exampleLine3: '300мл Воды',
+    exampleLine4: '10г Соли',
+    result: 'Результат',
+    copy: 'Копировать',
+    copied: 'Скопировано!',
+    emptyState: 'Ваши пересчитанные ингредиенты появятся здесь...',
+    defaultIngredient1: '200г Муки',
+    defaultIngredient2: '100мл Молока',
+    defaultIngredient3: '2 Яйца',
+  },
+  faqTitle: 'Часто задаваемые вопросы',
+  faq,
+  bibliographyTitle: 'Библиография',
+  bibliography: [
+    {
+      name: 'Harold McGee - On Food and Cooking: The Science and Lore of the Kitchen',
+      url: 'https://en.wikipedia.org/wiki/Harold_McGee',
+    },
+    {
+      name: 'The Flavor Bible by Karen Page and Andrew Dornenburg',
+      url: 'https://www.flavorprints.com/',
+    },
+    {
+      name: 'Modernist Cuisine - Техники научного масштабирования',
+      url: 'https://www.modernistcuisine.com/',
+    },
+  ],
+  howTo,
+  seo: [
+    {
+      type: 'title',
+      text: 'Руководство мастера по масштабированию и конвертации рецептов',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Масштабирование ингредиентов</strong> — одна из самых ответственных и подверженных ошибкам задач на профессиональной кухне. Это не просто умножение чисел, но и понимание того, как химия и физика продуктов реагируют на изменение объема и поверхности.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        {
+          value: 'x1.75',
+          label: 'С 4 на 7 чел.',
+          icon: 'mdi:calculator',
+        },
+        {
+          value: '75%',
+          label: 'Коррекция специй',
+          icon: 'mdi:shaker-outline',
+        },
+        {
+          value: '0%',
+          label: 'Масштаб времени',
+          icon: 'mdi:timer-off',
+        },
+        {
+          value: '100г',
+          label: 'Базовая единица',
+          icon: 'mdi:weight-gram',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Различия между линейным и контекстным масштабированием',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Линейное математическое масштабирование',
+          icon: 'mdi:math-log',
+          description: 'Прямое умножение всех значений на полученный коэффициент пересчета.',
+          points: [
+            'Идеально для муки и базовых жидкостей',
+            'Оптимально для точной кондитерской выпечки',
+            'Хорошо работает при небольших изменениях (x2, x0.5)',
+            'Легко рассчитывается автоматически',
+          ],
+        },
+        {
+          title: 'Контекстное кухонное масштабирование',
+          icon: 'mdi:chef-hat',
+          description: 'Корректировка пропорций с учетом интенсивности вкуса и испарения.',
+          highlight: true,
+          points: [
+            'Позволяет избежать пересола и избытка специй',
+            'Учитывает площадь поверхности испарения',
+            'Корректирует дрожжи в зависимости от массы',
+            'Требует опыта и чутья шеф-повара',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Коэффициенты пересчета по количеству гостей',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['С порций', 'На порции', 'Коэффициент', 'Сложность'],
+      rows: [
+        ['2 человека', '4 человека', 'x 2.0', 'Низкая (Линейно)'],
+        ['4 человека', '6 человек', 'x 1.5', 'Низкая (Линейно)'],
+        ['4 человека', '10 человек', 'x 2.5', 'Средняя (Осторожно со специями)'],
+        ['4 человека', '25 человек', 'x 6.25', 'Высокая (Контекстно)'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Типичные проблемы при удвоении рецепта',
+      html: 'Если вы заметили, что вкус стал слишком интенсивным после пересчета (особенно острота или соль), уменьшите масштаб этих специфических ингредиентов до 75%. Никогда не увеличивайте время приготовления пропорционально весу; внутренняя температура достигается в зависимости от толщины изделия, а не от общей массы.',
+    },
+    {
+      type: 'title',
+      text: 'Словарь терминологии стандартизации',
+      level: 3,
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'Коэффициент пересчета',
+          definition: 'Число, на которое умножаются все ингредиенты: Желаемое количество / Исходное количество.',
+        },
+        {
+          term: 'Уварка/Усушка',
+          definition: 'Потеря веса ингредиента из-за испарения или потери жира. Не всегда линейна.',
+        },
+        {
+          term: 'Вес брутто и нетто',
+          definition: 'Вес до и после очистки ингредиента. Мы всегда масштабируем исходный вес по рецепту.',
+        },
+        {
+          term: 'Выход',
+          definition: 'Общее количество готового продукта после масштабирования и приготовления.',
+        },
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Трюк со взбитым яйцом',
+      html: 'Если калькулятор показывает 2,3 яйца, взбейте целое яйцо, взвесьте его и используйте только 30% веса. Это единственный способ сохранить точность в изысканной кондитерке.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Наш инструмент упрощает математику, чтобы вы могли направить энергию на то, что действительно важно: творчество и вкус.',
+    },
+  ],
+  schemas: [appSchema, faqSchema, howToSchema],
+};