@jjlmoya/utils-language 1.1.0

package/src/tool/language-learning-study-plan-planner/component.astro

@@ -0,0 +1,274 @@
+---
+import './language-learning-study-plan-planner.css';
+import { LEVEL_LABELS, STUDY_LEVELS } from './logic';
+import type { LanguagePlannerUI } from './ui';
+
+interface Props {
+  ui: LanguagePlannerUI;
+}
+
+const { ui } = Astro.props as Props;
+const languages = ui.languageOptions.split('|');
+---
+
+<div class="language-planner" data-study-planner data-ui={JSON.stringify(ui)}>
+  <div class="planner-editor">
+    <div class="form-intro">
+      <div>
+        <p class="eyebrow">{ui.plannerKicker}</p>
+        <h2>{ui.plannerHeading}</h2>
+      </div>
+      <p class="form-note">{ui.plannerNote}</p>
+    </div>
+
+    <form class="planner-form" data-planner-form>
+      <div class="form-grid">
+        <label>
+          <span>{ui.sourceLanguage}</span>
+          <select name="sourceLanguage" required>
+            {languages.map((language) => <option value={language}>{language}</option>)}
+          </select>
+        </label>
+        <label>
+          <span>{ui.targetLanguage}</span>
+          <select name="targetLanguage" required>
+            {languages.map((language, index) => <option value={language} selected={index === 1}>{language}</option>)}
+          </select>
+        </label>
+        <label>
+          <span>{ui.currentLevel}</span>
+          <select name="currentLevel" required>
+            {STUDY_LEVELS.map((level, index) => <option value={level} selected={index === 0}>{LEVEL_LABELS[level]} ({level})</option>)}
+          </select>
+        </label>
+        <label>
+          <span>{ui.targetLevel}</span>
+          <select name="targetLevel" required>
+            {STUDY_LEVELS.slice(1).map((level, index) => <option value={level} selected={index === 0}>{LEVEL_LABELS[level]} ({level})</option>)}
+          </select>
+        </label>
+        <label>
+          <span>{ui.targetDate}</span>
+          <input type="date" name="targetDate" required />
+        </label>
+        <label>
+          <span>{ui.weeklyHours}</span>
+          <input type="number" name="weeklyHours" min="0.5" max="40" step="0.5" value="5" required />
+        </label>
+        <label class="wide-field">
+          <span>{ui.priority}</span>
+          <select name="priority" required>
+            <option value="balanced">{ui.balanced}</option>
+            <option value="comprehension">{ui.comprehension}</option>
+            <option value="production">{ui.production}</option>
+          </select>
+        </label>
+      </div>
+
+      <div class="preset-row" aria-label={ui.presetsLabel}>
+        <span>{ui.presetsLabel}</span>
+        <button type="button" data-preset="casual">{ui.casualPreset}</button>
+        <button type="button" data-preset="steady">{ui.steadyPreset}</button>
+        <button type="button" data-preset="sprint">{ui.sprintPreset}</button>
+      </div>
+
+      <div class="form-actions">
+        <button class="primary-button" type="submit">{ui.planButton}</button>
+        <button class="text-button" type="reset">{ui.resetButton}</button>
+      </div>
+    </form>
+  </div>
+
+  <section class="planner-output">
+    <div class="output-heading">
+      <div>
+        <p class="eyebrow">{ui.resultTitle}</p>
+        <h2>{ui.resultTitle}</h2>
+      </div>
+      <span class="live-badge">{ui.liveLabel}</span>
+    </div>
+    <div class="results-panel" data-results aria-live="polite" aria-atomic="true">
+      <div class="empty-result">
+        <span class="route-mark" aria-hidden="true">→</span>
+        <p>{ui.emptyResultDescription}</p>
+      </div>
+    </div>
+  </section>
+</div>
+
+<script>
+  import { calculateStudyPlan, LEVEL_LABELS } from './logic';
+  import type { LanguagePlannerInputs, PlanStatus, StudyPlan, StudyLevel } from './types';
+  import type { LanguagePlannerUI } from './ui';
+
+  const root = document.querySelector<HTMLElement>('[data-study-planner]');
+  const ui = JSON.parse(root?.dataset.ui ?? '{}') as LanguagePlannerUI;
+  const form = root?.querySelector<HTMLFormElement>('[data-planner-form]');
+  const results = root?.querySelector<HTMLElement>('[data-results]');
+  const targetDateInput = form?.querySelector<HTMLInputElement>('[name="targetDate"]');
+  const storageKey = 'language-learning-study-plan';
+
+  if (root && form && results && targetDateInput) {
+    const input = (name: string) => form.elements.namedItem(name) as HTMLInputElement | HTMLSelectElement;
+    const today = new Date();
+    const defaultDate = new Date(today);
+    defaultDate.setDate(defaultDate.getDate() + 180);
+    targetDateInput.value = defaultDate.toISOString().slice(0, 10);
+    targetDateInput.min = today.toISOString().slice(0, 10);
+
+    try {
+      const saved = JSON.parse(localStorage.getItem(storageKey) || 'null');
+      if (saved) {
+        Object.entries(saved).forEach(([name, value]) => {
+          const field = input(name);
+          if (field && typeof value === 'string') field.value = value;
+        });
+      }
+    } catch {
+      localStorage.removeItem(storageKey);
+    }
+
+    root.querySelectorAll<HTMLButtonElement>('[data-preset]').forEach((button) => {
+      button.addEventListener('click', () => {
+        const preset = button.dataset.preset;
+        let hours = '5';
+        if (preset === 'casual') hours = '3.5';
+        if (preset === 'sprint') hours = '10';
+        input('weeklyHours').value = hours;
+        input('priority').value = preset === 'sprint' ? 'production' : 'balanced';
+        form.requestSubmit();
+      });
+    });
+
+    form.addEventListener('reset', () => {
+      window.setTimeout(() => {
+        input('weeklyHours').value = '5';
+        input('priority').value = 'balanced';
+        targetDateInput.value = defaultDate.toISOString().slice(0, 10);
+        results.replaceChildren(createEmptyResult());
+      }, 0);
+    });
+
+    form.addEventListener('submit', (event) => {
+      event.preventDefault();
+      const formData = new FormData(form);
+      const values = Object.fromEntries(formData.entries());
+      const plannerInputs: LanguagePlannerInputs = {
+        sourceLanguage: String(values.sourceLanguage),
+        targetLanguage: String(values.targetLanguage),
+        currentLevel: String(values.currentLevel) as StudyLevel,
+        targetLevel: String(values.targetLevel) as StudyLevel,
+        targetDate: String(values.targetDate),
+        weeklyHours: Number(values.weeklyHours),
+        priority: String(values.priority) as LanguagePlannerInputs['priority'],
+      };
+      const result = calculateStudyPlan(plannerInputs);
+      if (!result.ok) {
+        results.replaceChildren(createErrorResult(result.error));
+        return;
+      }
+      localStorage.setItem(storageKey, JSON.stringify(values));
+      results.replaceChildren(createPlanResult(result.plan));
+    });
+  }
+
+  function createEmptyResult() {
+    const wrapper = document.createElement('div');
+    wrapper.className = 'empty-result';
+    wrapper.innerHTML = '<span class="route-mark" aria-hidden="true">→</span><p></p>';
+    const description = wrapper.querySelector('p');
+    if (description) description.textContent = ui.emptyResultDescription;
+    return wrapper;
+  }
+
+  function createErrorResult(message: string) {
+    const wrapper = document.createElement('div');
+    wrapper.className = 'error-result';
+    const title = document.createElement('h2');
+    title.textContent = ui.errorPrefix;
+    const detail = document.createElement('p');
+    detail.textContent = message;
+    wrapper.append(title, detail);
+    return wrapper;
+  }
+
+  function createPlanResult(plan: StudyPlan) {
+    const wrapper = document.createElement('div');
+    wrapper.className = 'plan-result';
+    const status = document.createElement('div');
+    status.className = `status-banner ${plan.status}`;
+    status.append(createText('status-label', ui.statusLabel), createText('status-copy', statusMessage(plan.status)));
+    wrapper.append(status);
+
+    const heading = document.createElement('div');
+    heading.className = 'result-heading';
+    heading.append(createText('eyebrow', `${plan.inputs.sourceLanguage} → ${plan.inputs.targetLanguage}`), createText('result-level', `${LEVEL_LABELS[plan.inputs.currentLevel]} to ${LEVEL_LABELS[plan.inputs.targetLevel]}`));
+    wrapper.append(heading);
+
+    const cards = document.createElement('div');
+    cards.className = 'metric-grid';
+    cards.append(
+      metric(ui.hoursRange, `${plan.hoursLow}-${plan.hoursHigh} h`, ui.guidedLearningDetail),
+      metric(ui.weeksAvailable, String(plan.weeksRemaining), ui.targetDateDetail),
+      metric(ui.hoursAvailable, `${plan.availableHours} h`, ui.weeklyPaceDetail),
+      metric(ui.recommendedTime, `${plan.recommendedWeeklyHoursLow}-${plan.recommendedWeeklyHoursHigh} h`, ui.recommendedRangeDetail),
+    );
+    wrapper.append(cards);
+
+    wrapper.append(createAllocation(plan), createMilestones(plan));
+    return wrapper;
+  }
+
+  function createAllocation(plan: StudyPlan) {
+    const section = document.createElement('section');
+    section.className = 'allocation-section';
+    section.append(createText('section-title', ui.weeklyAllocation));
+    const grid = document.createElement('div');
+    grid.className = 'allocation-grid';
+    [['listening', ui.skillListening], ['speaking', ui.skillSpeaking], ['reading', ui.skillReading], ['writing', ui.skillWriting]].forEach(([skill, label]) => {
+      const item = document.createElement('div');
+      item.className = 'allocation-item';
+      const allocation = plan.allocation[skill as keyof typeof plan.allocation];
+      const minutes = Math.round((plan.inputs.weeklyHours * 60 * allocation) / 100);
+      item.append(createText('allocation-label', `${label} ${allocation}%`), createText('allocation-time', `${minutes} min`));
+      grid.append(item);
+    });
+    section.append(grid);
+    return section;
+  }
+
+  function createMilestones(plan: StudyPlan) {
+    const section = document.createElement('section');
+    section.className = 'milestones-section';
+    section.append(createText('section-title', ui.milestones));
+    const list = document.createElement('ol');
+    list.className = 'milestone-list';
+    plan.milestones.forEach((milestone) => {
+      const item = document.createElement('li');
+      item.append(createText('milestone-level', `${ui.milestoneTarget} ${LEVEL_LABELS[milestone.level]}`), createText('milestone-date', `${milestone.date} · ${ui.milestoneWeek} ${milestone.week}`), createText('milestone-hours', `${milestone.hoursLow}-${milestone.hoursHigh} h`));
+      list.append(item);
+    });
+    section.append(list);
+    return section;
+  }
+
+  function metric(label: string, value: string, detail: string) {
+    const card = document.createElement('div');
+    card.className = 'metric-card';
+    card.append(createText('metric-label', label), createText('metric-value', value), createText('metric-detail', detail));
+    return card;
+  }
+
+  function createText(className: string, text: string) {
+    const element = document.createElement('span');
+    element.className = className;
+    element.textContent = text;
+    return element;
+  }
+
+  function statusMessage(status: PlanStatus) {
+    if (status === 'on-track') return ui.onTrack;
+    if (status === 'tight') return ui.tight;
+    return ui.insufficient;
+  }
+</script>

package/src/tool/language-learning-study-plan-planner/entry.ts

@@ -0,0 +1,34 @@
+import type { LanguageToolEntry, ToolDefinition, ToolLocaleContent } from '../../types';
+import type { LanguagePlannerUI } from './ui';
+
+export type { LanguagePlannerUI } from './ui';
+export type LanguageLearningStudyPlanPlannerLocaleContent = ToolLocaleContent<LanguagePlannerUI>;
+
+export const languageLearningStudyPlanPlanner: LanguageToolEntry<LanguagePlannerUI> = {
+  id: 'language-learning-study-plan-planner',
+  icons: { bg: 'mdi:map-clock-outline', fg: 'mdi:translate-variant' },
+  i18n: {
+    de: () => import('./i18n/de').then((module) => module.content),
+    en: () => import('./i18n/en').then((module) => module.content),
+    es: () => import('./i18n/es').then((module) => module.content),
+    fr: () => import('./i18n/fr').then((module) => module.content),
+    id: () => import('./i18n/id').then((module) => module.content),
+    it: () => import('./i18n/it').then((module) => module.content),
+    ja: () => import('./i18n/ja').then((module) => module.content),
+    ko: () => import('./i18n/ko').then((module) => module.content),
+    nl: () => import('./i18n/nl').then((module) => module.content),
+    pl: () => import('./i18n/pl').then((module) => module.content),
+    pt: () => import('./i18n/pt').then((module) => module.content),
+    ru: () => import('./i18n/ru').then((module) => module.content),
+    sv: () => import('./i18n/sv').then((module) => module.content),
+    tr: () => import('./i18n/tr').then((module) => module.content),
+    zh: () => import('./i18n/zh').then((module) => module.content),
+  },
+};
+
+export const LANGUAGE_LEARNING_STUDY_PLAN_PLANNER_TOOL: ToolDefinition = {
+  entry: languageLearningStudyPlanPlanner,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/language-learning-study-plan-planner/i18n/de.ts

@@ -0,0 +1,22 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Lernplaner für Sprachen', plannerHeading: 'Mache dein nächstes Sprachziel sichtbar.',
+  sourceLanguage: 'Ausgangssprache', targetLanguage: 'Zu lernende Sprache', currentLevel: 'Aktuelles GER Niveau', targetLevel: 'Zielniveau nach GER', targetDate: 'Zieldatum', weeklyHours: 'Lernzeit pro Woche', priority: 'Schwerpunkt', balanced: 'Ausgewogen', comprehension: 'Verstehen', production: 'Sprechen und Schreiben', planButton: 'Meinen Lernplan erstellen', resetButton: 'Zurücksetzen', presetsLabel: 'Mit einem Tempo starten', casualPreset: '30 Minuten pro Tag', steadyPreset: '5 Stunden pro Woche', sprintPreset: 'Prüfungssprint', plannerNote: 'Dies ist eine Planungsschätzung auf Basis grober Bereiche für angeleitetes Lernen. Sie prüft dein Niveau nicht und garantiert keine Sprachflüssigkeit.', resultTitle: 'Dein Lernplan', liveLabel: 'Live', hoursRange: 'Geschätzter Stundenbedarf', weeksAvailable: 'Wochen bis zu deinem Datum', hoursAvailable: 'Verfügbare Stunden bei diesem Tempo', recommendedTime: 'Empfohlener Wochenbereich', onTrack: 'Dein Zeitplan deckt die obere Schätzung ab.', tight: 'Dein Zeitplan deckt die untere Schätzung ab. Lass Zeit für Wiederholung.', insufficient: 'Deine Frist ist kürzer als die untere Schätzung. Plane mehr Zeit ein oder verschiebe das Datum.', statusLabel: 'Planstatus', weeklyAllocation: 'Wochenaufteilung nach Fertigkeit', milestones: 'Meilensteine', skillListening: 'Hörverstehen', skillSpeaking: 'Sprechen', skillReading: 'Leseverstehen', skillWriting: 'Schreiben', milestoneTarget: 'Erreichen', milestoneWeek: 'etwa in Woche', errorPrefix: 'Prüfe deine Eingaben', languageOptions: 'Englisch|Spanisch|Französisch|Deutsch|Italienisch|Portugiesisch|Japanisch|Koreanisch|Chinesisch|Arabisch', emptyResultDescription: 'Wähle ein Tempo und ein Datum, um deine Route von einem Niveau zum nächsten zu sehen.', guidedLearningDetail: 'Bereich für angeleitetes Lernen', targetDateDetail: 'bis zu deinem Zieldatum', weeklyPaceDetail: 'bei deinem gewählten Wochentempo', recommendedRangeDetail: 'pro Woche für diesen Bereich',
+};
+
+const faq = [
+  { question: 'Was berechnet der Sprachlernplaner?', answer: 'Er schaetzt den Stundenbereich zwischen deinem aktuellen und deinem angestrebten GER Niveau, vergleicht ihn mit den verfuegbaren Wochen und Stunden bis zu deinem Datum und schlaegt eine Wochenaufteilung nach Fertigkeiten vor.' },
+  { question: 'Sind die Lernstunden garantiert?', answer: 'Nein. Es handelt sich um grobe Planungsbereiche aus Schaetzungen fuer angeleitetes Lernen. Sprachpaar, Vorerfahrung, Kontakt mit der Sprache, Lernqualitaet und Gelegenheiten zum Ueben koennen die tatsaechliche Dauer deutlich veraendern.' },
+  { question: 'Was ist der Unterschied zwischen Verstehen und Produktion?', answer: 'Verstehen legt mehr Zeit auf Hoeren und Lesen. Produktion legt mehr Zeit auf Sprechen und Schreiben. Ausgewogen verteilt die Zeit gleichmaessig auf alle vier Fertigkeiten.' },
+  { question: 'Kann ich den Planer fuer jedes Sprachpaar verwenden?', answer: 'Du kannst ihn fuer jedes Sprachpaar als Ausgangspunkt verwenden. Die Schaetzung beruecksichtigt jedoch weder Sprachabstand noch Schriftsystem. Behandle sie als Planungsrahmen und passe sie anhand deines Fortschritts an.' },
+  { question: 'Speichert der Planer meine Sprachauswahl?', answer: 'Der Planer laeuft in deinem Browser und sendet deine Eingaben nicht an einen Server. Die aktuelle Seite benoetigt weder Konto noch Anmeldung.' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'sprachlernplan-rechner', title: 'Rechner fuer deinen Sprachlernplan', description: 'Schaetze GER Lernstunden, pruefe eine Frist und verwandle deine woechentliche Zeit in einen praktischen Sprachlernplan.', ui, faq,
+  seo: makePlannerSeo({ titles: ['Einen Sprachlernplan passend zu deiner Frist erstellen', 'So wird die Schaetzung berechnet', 'Den Planstatus vor deiner Zusage lesen', 'Die Zahl als Ausgangspunkt verwenden'], paragraphs: ['Verwende diesen Rechner, wenn du ein klares Sprachziel hast, aber wissen musst, ob deine Frist realistisch ist. Waehle dein aktuelles GER Niveau, ein Zielniveau, ein Datum und die Wochenzeit, die du wirklich schuetzen kannst. Du erhaeltst einen Stundenbereich, ein empfohlenes Tempo und Meilensteine fuer die Kontrolle deines Fortschritts.', 'Der Planer nutzt kumulative Stundenbereiche fuer angeleitetes Lernen auf jeder GER Stufe. Er zieht den Bereich deines aktuellen Niveaus vom Bereich des Zielniveaus ab und vergleicht die Stunden mit den verbleibenden Wochen. Der Schritt von A1 zu B1 entspricht in diesem Modell ungefaehr 260 bis 300 Stunden. Bei 5 Stunden pro Woche dauert das etwa 52 bis 60 Wochen, bevor ausgefallene Einheiten oder zusaetzliche Wiederholung eingerechnet werden.', 'Das GER beschreibt Faehigkeiten, aber keinen garantierten Stundenplan. Sprachabstand, Vorkenntnisse, Lernqualitaet und echte Anwendung koennen das Tempo stark veraendern. Vergleiche die Meilensteine mit echten Ergebnissen: Wenn du langsamer vorankommst, verschiebe das Datum oder senke das Ziel. Wenn du schneller bist, nutze die freie Zeit fuer Gespraeche und Wiederholung.'], tableHeaders: ['Status', 'Bedeutung', 'Naechster Schritt'], tableRows: [['Im Plan', 'Deine verfuegbaren Stunden erreichen die obere Schaetzung.', 'Halte die Routine und nutze die Meilensteine als Kontrollpunkte.'], ['Eng', 'Deine Stunden erreichen die untere, aber nicht die obere Schaetzung.', 'Behandle das Datum als anspruchsvoll und schuetze Zeit fuer Wiederholung.'], ['Nicht ausreichend', 'Deine Stunden bleiben unter der unteren Schaetzung.', 'Erhoehe die Wochenzeit, verschiebe das Datum oder waehle ein naeheres Ziel.']] }),
+  bibliography: [{ name: 'Europarat: Begleitband zum GER, spanische Ausgabe', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: Stunden fuer angeleitetes Lernen', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: 'Einen Sprachlernplan erstellen', howTo: [{ name: 'Sprachen waehlen', text: 'Waehle die Sprache, die du sicher verwendest, und die Sprache, die du lernen moechtest.' }, { name: 'GER Fortschritt festlegen', text: 'Waehle dein aktuelles Niveau und das Niveau, das du erreichen willst. Das Ziel muss ueber dem aktuellen Niveau liegen.' }, { name: 'Eine Wochenroutine schuetzen', text: 'Setze ein kuenftiges Zieldatum und gib die Stunden ein, die du realistisch jede Woche lernen kannst.' }, { name: 'Pruefen und anpassen', text: 'Nutze Status, Aufteilung und Meilensteine als Startplan und passe Datum oder Wochenzeit mit neuen Erkenntnissen an.' }],
+});

package/src/tool/language-learning-study-plan-planner/i18n/en.ts

@@ -0,0 +1,103 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { LanguagePlannerUI } from '../ui';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Language learning planner',
+  plannerHeading: 'Make your next language goal visible.',
+  sourceLanguage: 'Starting language',
+  targetLanguage: 'Language you want to learn',
+  currentLevel: 'Current CEFR level',
+  targetLevel: 'Target CEFR level',
+  targetDate: 'Target date',
+  weeklyHours: 'Study time per week',
+  priority: 'Skill priority',
+  balanced: 'Balanced',
+  comprehension: 'Comprehension',
+  production: 'Speaking and writing',
+  planButton: 'Build my study plan',
+  resetButton: 'Reset',
+  presetsLabel: 'Start with a pace',
+  casualPreset: '30 min a day',
+  steadyPreset: '5 hours a week',
+  sprintPreset: 'Exam sprint',
+  plannerNote: 'This is a planning estimate based on broad guided-learning ranges. It does not test your level or guarantee fluency.',
+  resultTitle: 'Your study plan',
+  liveLabel: 'Live',
+  hoursRange: 'Estimated hours needed',
+  weeksAvailable: 'Weeks until your date',
+  hoursAvailable: 'Hours available at this pace',
+  recommendedTime: 'Suggested weekly range',
+  onTrack: 'Your schedule covers the upper estimate.',
+  tight: 'Your schedule covers the lower estimate; keep room for review.',
+  insufficient: 'Your deadline is tighter than the lower estimate. Add time or move the date.',
+  statusLabel: 'Plan status',
+  weeklyAllocation: 'Weekly skill split',
+  milestones: 'Milestones',
+  skillListening: 'Listening',
+  skillSpeaking: 'Speaking',
+  skillReading: 'Reading',
+  skillWriting: 'Writing',
+  milestoneTarget: 'Reach',
+  milestoneWeek: 'around week',
+  errorPrefix: 'Check your inputs',
+  languageOptions: 'English|Spanish|French|German|Italian|Portuguese|Japanese|Korean|Chinese|Arabic',
+  emptyResultDescription: 'Choose a pace and date to see your weekly route from one level to the next.',
+  guidedLearningDetail: 'guided-learning range',
+  targetDateDetail: 'until your target date',
+  weeklyPaceDetail: 'at your chosen weekly pace',
+  recommendedRangeDetail: 'per week for the range',
+};
+
+const faq = [
+  { question: 'What does the language learning planner calculate?', answer: 'It estimates a range of hours between your current and target CEFR levels, compares that range with the weeks and hours available before your date, and suggests a weekly skill split.' },
+  { question: 'Are the study hours a guarantee?', answer: 'No. They are broad planning ranges based on guided-learning estimates. Your language pair, previous experience, exposure, study quality, and practice opportunities can move the real number substantially.' },
+  { question: 'What is the difference between comprehension and production priorities?', answer: 'Comprehension puts more of the weekly plan into listening and reading. Production puts more into speaking and writing. Balanced divides the time evenly across the four skills.' },
+  { question: 'Can I use this for any language pair?', answer: 'You can use it as a starting point for any language pair, but the estimate does not model language distance or script complexity. Treat the range as a planning envelope and revise it with evidence from your own progress.' },
+  { question: 'Does the planner store my language choices?', answer: 'The planner works in your browser and does not send your inputs to a server. The current page does not require an account or a sign-in.' },
+];
+
+export const content: ToolLocaleContent<LanguagePlannerUI> = {
+  slug: 'language-learning-study-plan-planner',
+  title: 'Language Study Plan Calculator',
+  description: 'Estimate CEFR study hours, test a deadline, and turn your weekly availability into a practical language learning plan.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Build a Language Study Plan That Fits Your Deadline', level: 2 },
+    { type: 'paragraph', html: 'Use this calculator when you have a clear language goal but need to know whether your deadline is realistic. Choose a current CEFR level, a target level, a date, and the weekly time you can protect. You get a workload range, a suggested weekly pace, and milestones you can review as you progress.' },
+    { type: 'title', text: 'How the Estimate Is Calculated', level: 2 },
+    { type: 'paragraph', html: 'The planner uses cumulative guided learning hour bands for each CEFR level. It subtracts the band for your current level from the band for your target level, then compares those hours with the weeks remaining. For example, moving from A1 to B1 represents roughly 260 to 300 guided hours in this model. At 5 hours a week, that workload needs about 52 to 60 weeks, before allowing for missed sessions or extra review.' },
+    { type: 'title', text: 'Read the Plan Status Before You Commit', level: 2 },
+    { type: 'table', headers: ['Status', 'What it means', 'What to do'], rows: [
+      ['On track', 'Your available hours reach the upper estimate.', 'Keep the routine and use milestones as checkpoints.'],
+      ['Tight', 'Your available hours reach the lower estimate but not the upper one.', 'Treat the date as a stretch and protect review time.'],
+      ['Insufficient', 'Your available hours fall below the lower estimate.', 'Add weekly time, move the date, or choose a nearer target.'],
+    ] },
+    { type: 'title', text: 'Use the Number as a Baseline', level: 2 },
+    { type: 'paragraph', html: 'CEFR describes ability, not a guaranteed timetable. Language distance, previous exposure, study quality, and real world practice can change the pace substantially. Use the milestones to compare the plan with real evidence: if progress is slower, move the date or reduce the target; if it is faster, keep the extra time for conversation and review.' },
+  ],
+  faq,
+  bibliography: [
+    { name: 'Council of Europe: CEFR Companion Volume, Spanish edition', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' },
+    { name: 'Cambridge English: Guided learning hours', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' },
+  ],
+  howTo: [
+    { name: 'Choose your languages', text: 'Select the language you already use comfortably and the language you want to learn.' },
+    { name: 'Set the CEFR progression', text: 'Choose your current level and the level you want to reach. The target must be above the current level.' },
+    { name: 'Protect a weekly routine', text: 'Set a future target date and enter the hours you can realistically study every week.' },
+    { name: 'Review and adapt', text: 'Use the status, skill split, and milestones as a starting plan, then move the date or revise the weekly time as you learn.' },
+  ],
+  schemas: [
+    { '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: 'Language Study Plan Calculator', applicationCategory: 'EducationalApplication', operatingSystem: 'Any', isAccessibleForFree: true, url: 'https://gamebob.dev/en/language-learning-study-plan-planner' },
+    { '@context': 'https://schema.org', '@type': 'HowTo', name: 'Build a language study plan', step: contentSteps(ui) },
+    { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })) },
+  ],
+};
+
+function contentSteps(labels: LanguagePlannerUI) {
+  return [
+    { '@type': 'HowToStep', name: 'Choose your languages', text: labels.sourceLanguage },
+    { '@type': 'HowToStep', name: 'Set the CEFR progression', text: labels.currentLevel },
+    { '@type': 'HowToStep', name: 'Protect a weekly routine', text: labels.weeklyHours },
+    { '@type': 'HowToStep', name: 'Review and adapt', text: labels.planButton },
+  ];
+}

package/src/tool/language-learning-study-plan-planner/i18n/es.ts

@@ -0,0 +1,21 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Planificador de aprendizaje de idiomas', plannerHeading: 'Haz visible tu próximo objetivo lingüístico.', sourceLanguage: 'Idioma de partida', targetLanguage: 'Idioma que quieres aprender', currentLevel: 'Nivel MCER actual', targetLevel: 'Nivel MCER objetivo', targetDate: 'Fecha objetivo', weeklyHours: 'Tiempo de estudio semanal', priority: 'Prioridad de destrezas', balanced: 'Equilibrado', comprehension: 'Comprensión', production: 'Expresión oral y escrita', planButton: 'Crear mi plan de estudio', resetButton: 'Restablecer', presetsLabel: 'Empieza con un ritmo', casualPreset: '30 min al día', steadyPreset: '5 horas a la semana', sprintPreset: 'Sprint de examen', plannerNote: 'Es una estimación de planificación basada en rangos amplios de aprendizaje guiado. No evalúa tu nivel ni garantiza fluidez.', resultTitle: 'Tu plan de estudio', liveLabel: 'En directo', hoursRange: 'Horas estimadas necesarias', weeksAvailable: 'Semanas hasta tu fecha', hoursAvailable: 'Horas disponibles a este ritmo', recommendedTime: 'Rango semanal sugerido', onTrack: 'Tu calendario cubre la estimación superior.', tight: 'Tu calendario cubre la estimación inferior. Reserva margen para repasar.', insufficient: 'Tu fecha es más ajustada que la estimación inferior. Añade tiempo o mueve la fecha.', statusLabel: 'Estado del plan', weeklyAllocation: 'Reparto semanal por destreza', milestones: 'Hitos', skillListening: 'Comprensión auditiva', skillSpeaking: 'Expresión oral', skillReading: 'Comprensión lectora', skillWriting: 'Expresión escrita', milestoneTarget: 'Alcanzar', milestoneWeek: 'hacia la semana', errorPrefix: 'Revisa tus datos', languageOptions: 'inglés|español|francés|alemán|italiano|portugués|japonés|coreano|chino|árabe', emptyResultDescription: 'Elige un ritmo y una fecha para ver tu recorrido de un nivel al siguiente.', guidedLearningDetail: 'rango de aprendizaje guiado', targetDateDetail: 'hasta tu fecha objetivo', weeklyPaceDetail: 'con tu ritmo semanal', recommendedRangeDetail: 'por semana para este recorrido',
+};
+
+const faq = [
+  { question: '¿Qué calcula el planificador de aprendizaje de idiomas?', answer: 'Estima el rango de horas entre tus niveles MCER actual y objetivo, lo compara con las semanas y horas disponibles hasta tu fecha y propone un reparto semanal entre destrezas.' },
+  { question: '¿Las horas de estudio son una garantía?', answer: 'No. Son rangos amplios para planificar, basados en estimaciones de aprendizaje guiado. La combinación de idiomas, tu experiencia, la exposición, la calidad del estudio y las oportunidades de práctica pueden cambiar mucho el resultado real.' },
+  { question: '¿Cuál es la diferencia entre comprensión y producción?', answer: 'Comprensión dedica más tiempo a escuchar y leer. Producción dedica más tiempo a hablar y escribir. Equilibrado reparte el tiempo por igual entre las cuatro destrezas.' },
+  { question: '¿Puedo usarlo para cualquier combinación de idiomas?', answer: 'Puedes usarlo como punto de partida para cualquier combinación, pero la estimación no modela la distancia entre idiomas ni la complejidad de su escritura. Toma el rango como una referencia y ajústalo con tu progreso.' },
+  { question: '¿El planificador guarda mis idiomas?', answer: 'Funciona en tu navegador y no envía tus datos a un servidor. La página no necesita cuenta ni inicio de sesión.' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'calculadora-plan-estudio-idiomas', title: 'Calculadora de plan de estudio de idiomas', description: 'Estima las horas de estudio según el MCER, comprueba una fecha límite y convierte tu tiempo semanal en un plan práctico para aprender idiomas.', ui, faq,
+  seo: makePlannerSeo({ titles: ['Crea un plan de idiomas que encaje con tu fecha', 'Cómo se calcula la estimación', 'Lee el estado del plan antes de comprometerte', 'Usa la cifra como punto de partida'], paragraphs: ['Usa esta calculadora cuando tengas un objetivo lingüístico claro pero necesites saber si tu fecha es realista. Elige tu nivel MCER actual, el nivel objetivo, una fecha y el tiempo semanal que puedes proteger de verdad. Obtendrás un rango de carga, un ritmo semanal sugerido y varios hitos para revisar tu avance.', 'El planificador usa rangos acumulados de horas de aprendizaje guiado para cada nivel MCER. Resta el rango de tu nivel actual al del nivel objetivo y compara esas horas con las semanas restantes. Por ejemplo, pasar de A1 a B1 representa aproximadamente entre 260 y 300 horas guiadas en este modelo. A 5 horas por semana, la carga requiere unas 52 a 60 semanas, sin contar sesiones perdidas ni repasos adicionales.', 'El MCER describe capacidades, no un calendario garantizado. La distancia entre idiomas, la exposición previa, la calidad del estudio y la práctica real pueden cambiar mucho el ritmo. Compara los hitos con pruebas reales: si avanzas más despacio, mueve la fecha o reduce el objetivo; si avanzas más rápido, reserva el tiempo extra para conversar y repasar.'], tableHeaders: ['Estado', 'Qué significa', 'Qué hacer'], tableRows: [['En camino', 'Tus horas disponibles alcanzan la estimación superior.', 'Mantén la rutina y usa los hitos como puntos de control.'], ['Ajustado', 'Tus horas llegan a la estimación inferior, pero no a la superior.', 'Trata la fecha como exigente y protege tiempo para repasar.'], ['Insuficiente', 'Tus horas disponibles quedan por debajo de la estimación inferior.', 'Añade tiempo semanal, mueve la fecha o elige un objetivo más cercano.']] }),
+  bibliography: [{ name: 'Consejo de Europa: Volumen complementario del MCER, edición en español', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: Horas de aprendizaje guiado', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: 'Crear un plan de estudio de idiomas', howTo: [{ name: 'Elige tus idiomas', text: 'Selecciona el idioma que ya usas con soltura y el idioma que quieres aprender.' }, { name: 'Define la progresión MCER', text: 'Elige tu nivel actual y el nivel que quieres alcanzar. El objetivo debe estar por encima del nivel actual.' }, { name: 'Protege una rutina semanal', text: 'Indica una fecha objetivo futura y las horas que puedes estudiar de forma realista cada semana.' }, { name: 'Revisa y adapta', text: 'Usa el estado, el reparto de destrezas y los hitos como punto de partida; después ajusta la fecha o el tiempo semanal.' }],
+});

package/src/tool/language-learning-study-plan-planner/i18n/fr.ts

@@ -0,0 +1,21 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Planificateur d apprentissage des langues', plannerHeading: 'Rendez votre prochain objectif linguistique visible.', sourceLanguage: 'Langue de départ', targetLanguage: 'Langue à apprendre', currentLevel: 'Niveau CECR actuel', targetLevel: 'Niveau CECR visé', targetDate: 'Date cible', weeklyHours: 'Temps d étude par semaine', priority: 'Priorité de compétence', balanced: 'Équilibré', comprehension: 'Compréhension', production: 'Expression orale et écrite', planButton: 'Créer mon plan d étude', resetButton: 'Réinitialiser', presetsLabel: 'Commencer avec un rythme', casualPreset: '30 min par jour', steadyPreset: '5 heures par semaine', sprintPreset: 'Sprint examen', plannerNote: 'Il s agit d une estimation de planification fondée sur de larges fourchettes d apprentissage guidé. Elle ne teste pas votre niveau et ne garantit pas la fluidité.', resultTitle: 'Votre plan d étude', liveLabel: 'En direct', hoursRange: 'Heures estimées nécessaires', weeksAvailable: 'Semaines jusqu à votre date', hoursAvailable: 'Heures disponibles à ce rythme', recommendedTime: 'Fourchette hebdomadaire suggérée', onTrack: 'Votre calendrier couvre l estimation haute.', tight: 'Votre calendrier couvre l estimation basse. Gardez du temps pour réviser.', insufficient: 'Votre délai est plus court que l estimation basse. Ajoutez du temps ou repoussez la date.', statusLabel: 'État du plan', weeklyAllocation: 'Répartition hebdomadaire par compétence', milestones: 'Jalons', skillListening: 'Compréhension orale', skillSpeaking: 'Expression orale', skillReading: 'Compréhension écrite', skillWriting: 'Expression écrite', milestoneTarget: 'Atteindre', milestoneWeek: 'vers la semaine', errorPrefix: 'Vérifiez vos données', languageOptions: 'anglais|espagnol|français|allemand|italien|portugais|japonais|coréen|chinois|arabe', emptyResultDescription: 'Choisissez un rythme et une date pour voir votre parcours entre deux niveaux.', guidedLearningDetail: 'fourchette d apprentissage guidé', targetDateDetail: 'jusqu à votre date cible', weeklyPaceDetail: 'à votre rythme hebdomadaire', recommendedRangeDetail: 'par semaine pour ce parcours',
+};
+
+const faq = [
+  { question: 'Que calcule le planificateur d apprentissage des langues ?', answer: 'Il estime une fourchette d heures entre vos niveaux CECR actuel et visé, la compare aux semaines et aux heures disponibles avant votre date, puis propose une répartition hebdomadaire par compétence.' },
+  { question: 'Les heures d étude sont elles garanties ?', answer: 'Non. Ce sont de larges fourchettes de planification issues d estimations d apprentissage guidé. La combinaison linguistique, votre expérience, votre exposition, la qualité du travail et les occasions de pratiquer peuvent modifier fortement la durée réelle.' },
+  { question: 'Quelle différence entre compréhension et production ?', answer: 'La compréhension donne davantage de temps à l écoute et à la lecture. La production en donne davantage à l oral et à l écrit. Le mode équilibré partage le temps entre les quatre compétences.' },
+  { question: 'Puis je utiliser cet outil pour toutes les langues ?', answer: 'Vous pouvez l utiliser comme point de départ pour toute combinaison de langues, mais l estimation ne modélise ni la distance linguistique ni la complexité de l écriture. Considérez la fourchette comme un cadre et révisez la avec vos progrès.' },
+  { question: 'Le planificateur conserve t il mes choix de langues ?', answer: 'Il fonctionne dans votre navigateur et n envoie pas vos données à un serveur. La page actuelle ne demande ni compte ni connexion.' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'calculateur-plan-etude-langue', title: 'Calculateur de plan d étude des langues', description: 'Estimez les heures selon le CECR, testez une échéance et transformez votre temps hebdomadaire en plan d apprentissage pratique.', ui, faq,
+  seo: makePlannerSeo({ titles: ['Construire un plan de langue adapté à votre échéance', 'Comment l estimation est calculée', 'Lire l état du plan avant de s engager', 'Utiliser le nombre comme base de travail'], paragraphs: ['Utilisez ce calculateur lorsque vous avez un objectif linguistique précis mais devez vérifier si votre échéance est réaliste. Choisissez un niveau CECR actuel, un niveau visé, une date et le temps hebdomadaire que vous pouvez réellement protéger. Vous obtenez une charge estimée, un rythme conseillé et des jalons à revoir pendant votre progression.', 'Le planificateur utilise des fourchettes cumulées d heures d apprentissage guidé pour chaque niveau CECR. Il soustrait la fourchette du niveau actuel de celle du niveau visé, puis compare ces heures aux semaines restantes. Dans ce modèle, le passage de A1 à B1 représente environ 260 à 300 heures guidées. À raison de 5 heures par semaine, cette charge demande environ 52 à 60 semaines, sans compter les séances manquées ni les révisions supplémentaires.', 'Le CECR décrit des capacités, pas un calendrier garanti. La distance entre les langues, l exposition antérieure, la qualité de l étude et la pratique réelle peuvent modifier sensiblement le rythme. Comparez les jalons à des preuves concrètes: si les progrès ralentissent, repoussez la date ou réduisez l objectif; s ils accélèrent, gardez le temps gagné pour la conversation et la révision.'], tableHeaders: ['État', 'Signification', 'Action'], tableRows: [['Dans les temps', 'Vos heures disponibles atteignent l estimation haute.', 'Gardez la routine et utilisez les jalons comme points de contrôle.'], ['Serré', 'Vos heures atteignent l estimation basse mais pas l estimation haute.', 'Considérez la date comme ambitieuse et protégez du temps de révision.'], ['Insuffisant', 'Vos heures disponibles restent sous l estimation basse.', 'Ajoutez du temps chaque semaine, repoussez la date ou choisissez un objectif plus proche.']] }),
+  bibliography: [{ name: 'Conseil de l Europe: Volume complémentaire du CECR, édition espagnole', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: Heures d apprentissage guidé', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: 'Construire un plan d apprentissage linguistique', howTo: [{ name: 'Choisir vos langues', text: 'Sélectionnez la langue que vous utilisez déjà avec aisance et celle que vous souhaitez apprendre.' }, { name: 'Définir la progression CECR', text: 'Choisissez votre niveau actuel et le niveau à atteindre. La cible doit être supérieure au niveau actuel.' }, { name: 'Protéger une routine hebdomadaire', text: 'Définissez une date cible future et indiquez les heures que vous pouvez étudier de façon réaliste chaque semaine.' }, { name: 'Revoir et adapter', text: 'Utilisez l état, la répartition et les jalons comme plan de départ, puis ajustez la date ou le temps hebdomadaire.' }],
+});

package/src/tool/language-learning-study-plan-planner/i18n/id.ts

@@ -0,0 +1,21 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Perencana belajar bahasa', plannerHeading: 'Buat target bahasa berikutnya terlihat.', sourceLanguage: 'Bahasa awal', targetLanguage: 'Bahasa yang ingin dipelajari', currentLevel: 'Level CEFR saat ini', targetLevel: 'Level CEFR tujuan', targetDate: 'Tanggal tujuan', weeklyHours: 'Waktu belajar per minggu', priority: 'Prioritas keterampilan', balanced: 'Seimbang', comprehension: 'Pemahaman', production: 'Berbicara dan menulis', planButton: 'Buat rencana belajar saya', resetButton: 'Atur ulang', presetsLabel: 'Mulai dengan tempo', casualPreset: '30 menit per hari', steadyPreset: '5 jam per minggu', sprintPreset: 'Sprint ujian', plannerNote: 'Ini adalah perkiraan perencanaan berdasarkan rentang umum pembelajaran terpandu. Alat ini tidak menguji level atau menjamin kefasihan.', resultTitle: 'Rencana belajar Anda', liveLabel: 'Langsung', hoursRange: 'Perkiraan jam yang dibutuhkan', weeksAvailable: 'Minggu sampai tanggal Anda', hoursAvailable: 'Jam tersedia dengan tempo ini', recommendedTime: 'Rentang mingguan yang disarankan', onTrack: 'Jadwal Anda mencakup perkiraan tertinggi.', tight: 'Jadwal Anda mencakup perkiraan terendah. Sisakan waktu untuk mengulang.', insufficient: 'Batas waktu Anda lebih singkat dari perkiraan terendah. Tambahkan waktu atau ubah tanggal.', statusLabel: 'Status rencana', weeklyAllocation: 'Pembagian keterampilan mingguan', milestones: 'Tonggak', skillListening: 'Menyimak', skillSpeaking: 'Berbicara', skillReading: 'Membaca', skillWriting: 'Menulis', milestoneTarget: 'Mencapai', milestoneWeek: 'sekitar minggu', errorPrefix: 'Periksa masukan Anda', languageOptions: 'Inggris|Spanyol|Prancis|Jerman|Italia|Portugis|Jepang|Korea|Tionghoa|Arab', emptyResultDescription: 'Pilih tempo dan tanggal untuk melihat jalur dari satu level ke level berikutnya.', guidedLearningDetail: 'rentang pembelajaran terpandu', targetDateDetail: 'sampai tanggal tujuan', weeklyPaceDetail: 'dengan tempo mingguan pilihan Anda', recommendedRangeDetail: 'per minggu untuk rentang ini',
+};
+
+const faq = [
+  { question: 'Apa yang dihitung oleh perencana belajar bahasa?', answer: 'Alat ini memperkirakan rentang jam antara level CEFR saat ini dan tujuan, membandingkannya dengan minggu serta jam yang tersedia sebelum tanggal Anda, lalu menyarankan pembagian keterampilan mingguan.' },
+  { question: 'Apakah jam belajar ini merupakan jaminan?', answer: 'Tidak. Ini adalah rentang perencanaan umum berdasarkan perkiraan pembelajaran terpandu. Pasangan bahasa, pengalaman sebelumnya, paparan, kualitas belajar, dan kesempatan berlatih dapat mengubah jumlah sebenarnya secara besar.' },
+  { question: 'Apa perbedaan prioritas pemahaman dan produksi?', answer: 'Pemahaman memberi porsi lebih besar untuk menyimak dan membaca. Produksi memberi porsi lebih besar untuk berbicara dan menulis. Seimbang membagi waktu rata pada empat keterampilan.' },
+  { question: 'Bisakah alat ini dipakai untuk pasangan bahasa apa pun?', answer: 'Anda dapat memakainya sebagai titik awal untuk pasangan bahasa apa pun, tetapi perkiraan ini tidak memodelkan jarak bahasa atau kerumitan aksara. Anggap rentang ini sebagai batas perencanaan dan tinjau dengan kemajuan Anda.' },
+  { question: 'Apakah perencana menyimpan pilihan bahasa saya?', answer: 'Perencana berjalan di browser dan tidak mengirim masukan Anda ke server. Halaman ini tidak memerlukan akun atau proses masuk.' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'kalkulator-rencana-belajar-bahasa', title: 'Kalkulator Rencana Belajar Bahasa', description: 'Perkirakan jam belajar berdasarkan CEFR, uji tenggat waktu, dan ubah waktu mingguan Anda menjadi rencana belajar bahasa yang praktis.', ui, faq,
+  seo: makePlannerSeo({ titles: ['Buat rencana belajar bahasa yang sesuai tenggat', 'Cara perkiraan ini dihitung', 'Baca status rencana sebelum berkomitmen', 'Gunakan angka sebagai dasar'], paragraphs: ['Gunakan kalkulator ini saat Anda memiliki tujuan bahasa yang jelas tetapi perlu tahu apakah tenggat Anda realistis. Pilih level CEFR saat ini, level tujuan, tanggal, dan waktu mingguan yang benar benar dapat Anda lindungi. Anda akan mendapat rentang beban belajar, tempo mingguan yang disarankan, dan tonggak untuk meninjau kemajuan.', 'Perencana memakai rentang jam pembelajaran terpandu kumulatif untuk setiap level CEFR. Rentang level saat ini dikurangi dari rentang level tujuan, lalu hasilnya dibandingkan dengan minggu yang tersisa. Dalam model ini, perpindahan dari A1 ke B1 mewakili sekitar 260 sampai 300 jam terpandu. Dengan 5 jam per minggu, beban itu memerlukan sekitar 52 sampai 60 minggu, sebelum memperhitungkan sesi yang terlewat atau pengulangan tambahan.', 'CEFR menjelaskan kemampuan, bukan jadwal yang dijamin. Jarak bahasa, paparan sebelumnya, kualitas belajar, dan praktik nyata dapat mengubah tempo secara signifikan. Bandingkan tonggak dengan bukti nyata: jika kemajuan lebih lambat, ubah tanggal atau turunkan tujuan; jika lebih cepat, gunakan waktu tambahan untuk percakapan dan pengulangan.'], tableHeaders: ['Status', 'Artinya', 'Tindakan'], tableRows: [['Sesuai rencana', 'Jam tersedia mencapai perkiraan tertinggi.', 'Pertahankan rutinitas dan gunakan tonggak sebagai titik pemeriksaan.'], ['Ketat', 'Jam tersedia mencapai perkiraan terendah tetapi belum mencapai yang tertinggi.', 'Anggap tanggal ini menantang dan sisakan waktu untuk mengulang.'], ['Tidak cukup', 'Jam tersedia berada di bawah perkiraan terendah.', 'Tambah waktu mingguan, ubah tanggal, atau pilih tujuan yang lebih dekat.']] }),
+  bibliography: [{ name: 'Council of Europe: CEFR Companion Volume, edisi bahasa Spanyol', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: Jam pembelajaran terpandu', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: 'Membuat rencana belajar bahasa', howTo: [{ name: 'Pilih bahasa Anda', text: 'Pilih bahasa yang sudah Anda gunakan dengan nyaman dan bahasa yang ingin Anda pelajari.' }, { name: 'Atur kemajuan CEFR', text: 'Pilih level saat ini dan level yang ingin dicapai. Tujuan harus lebih tinggi dari level saat ini.' }, { name: 'Lindungi rutinitas mingguan', text: 'Atur tanggal tujuan di masa depan dan masukkan jam yang realistis untuk belajar setiap minggu.' }, { name: 'Tinjau dan sesuaikan', text: 'Gunakan status, pembagian keterampilan, dan tonggak sebagai rencana awal, lalu sesuaikan tanggal atau waktu mingguan.' }],
+});

package/src/tool/language-learning-study-plan-planner/i18n/it.ts

@@ -0,0 +1,21 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: 'Pianificatore per lo studio delle lingue', plannerHeading: 'Rendi visibile il tuo prossimo obiettivo linguistico.', sourceLanguage: 'Lingua di partenza', targetLanguage: 'Lingua da imparare', currentLevel: 'Livello QCER attuale', targetLevel: 'Livello QCER obiettivo', targetDate: 'Data obiettivo', weeklyHours: 'Tempo di studio settimanale', priority: 'Priorità delle abilità', balanced: 'Bilanciato', comprehension: 'Comprensione', production: 'Produzione orale e scritta', planButton: 'Crea il mio piano di studio', resetButton: 'Reimposta', presetsLabel: 'Inizia con un ritmo', casualPreset: '30 min al giorno', steadyPreset: '5 ore a settimana', sprintPreset: 'Sprint per l esame', plannerNote: 'È una stima per la pianificazione basata su ampi intervalli di apprendimento guidato. Non verifica il tuo livello e non garantisce la padronanza.', resultTitle: 'Il tuo piano di studio', liveLabel: 'Attivo', hoursRange: 'Ore stimate necessarie', weeksAvailable: 'Settimane fino alla tua data', hoursAvailable: 'Ore disponibili a questo ritmo', recommendedTime: 'Intervallo settimanale suggerito', onTrack: 'Il tuo calendario copre la stima alta.', tight: 'Il tuo calendario copre la stima bassa. Lascia spazio per il ripasso.', insufficient: 'La tua scadenza è più stretta della stima bassa. Aggiungi tempo o sposta la data.', statusLabel: 'Stato del piano', weeklyAllocation: 'Ripartizione settimanale delle abilità', milestones: 'Traguardi', skillListening: 'Ascolto', skillSpeaking: 'Conversazione', skillReading: 'Lettura', skillWriting: 'Scrittura', milestoneTarget: 'Raggiungere', milestoneWeek: 'circa alla settimana', errorPrefix: 'Controlla i dati', languageOptions: 'inglese|spagnolo|francese|tedesco|italiano|portoghese|giapponese|coreano|cinese|arabo', emptyResultDescription: 'Scegli un ritmo e una data per vedere il percorso da un livello al successivo.', guidedLearningDetail: 'intervallo di apprendimento guidato', targetDateDetail: 'fino alla data obiettivo', weeklyPaceDetail: 'al ritmo settimanale scelto', recommendedRangeDetail: 'a settimana per questo intervallo',
+};
+
+const faq = [
+  { question: 'Che cosa calcola il pianificatore per lo studio delle lingue?', answer: 'Stima un intervallo di ore tra il livello QCER attuale e quello obiettivo, lo confronta con le settimane e le ore disponibili prima della data scelta e suggerisce una ripartizione settimanale delle abilità.' },
+  { question: 'Le ore di studio sono una garanzia?', answer: 'No. Sono intervalli ampi per la pianificazione, basati su stime di apprendimento guidato. La coppia di lingue, l esperienza precedente, l esposizione, la qualità dello studio e le occasioni di pratica possono cambiare molto il risultato reale.' },
+  { question: 'Qual è la differenza tra comprensione e produzione?', answer: 'La comprensione assegna più tempo all ascolto e alla lettura. La produzione assegna più tempo alla conversazione e alla scrittura. Bilanciato divide il tempo in modo uniforme tra le quattro abilità.' },
+  { question: 'Posso usare il pianificatore per qualsiasi coppia di lingue?', answer: 'Puoi usarlo come punto di partenza per qualsiasi coppia, ma la stima non considera la distanza linguistica o la complessità della scrittura. Considera l intervallo una base di pianificazione e correggilo osservando i tuoi progressi.' },
+  { question: 'Il pianificatore conserva le mie scelte linguistiche?', answer: 'Funziona nel browser e non invia i tuoi dati a un server. La pagina non richiede un account né un accesso.' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'calcolatore-piano-studio-lingua', title: 'Calcolatore del piano di studio linguistico', description: 'Stima le ore QCER, verifica una scadenza e trasforma il tempo settimanale in un piano pratico per imparare una lingua.', ui, faq,
+  seo: makePlannerSeo({ titles: ['Crea un piano linguistico adatto alla tua scadenza', 'Come viene calcolata la stima', 'Leggi lo stato del piano prima di impegnarti', 'Usa il numero come punto di partenza'], paragraphs: ['Usa questo calcolatore quando hai un obiettivo linguistico chiaro ma vuoi sapere se la tua scadenza è realistica. Scegli il livello QCER attuale, il livello obiettivo, una data e il tempo settimanale che puoi davvero proteggere. Otterrai un intervallo di carico, un ritmo settimanale consigliato e traguardi da controllare durante il percorso.', 'Il pianificatore usa intervalli cumulativi di ore di apprendimento guidato per ogni livello QCER. Sottrae l intervallo del livello attuale da quello del livello obiettivo e confronta le ore con le settimane rimanenti. In questo modello, passare da A1 a B1 rappresenta circa 260 a 300 ore guidate. Con 5 ore alla settimana, il carico richiede circa 52 a 60 settimane, prima di considerare lezioni perse o ripassi aggiuntivi.', 'Il QCER descrive capacità, non un calendario garantito. La distanza tra le lingue, l esposizione precedente, la qualità dello studio e la pratica reale possono cambiare molto il ritmo. Confronta i traguardi con prove concrete: se i progressi rallentano, sposta la data o riduci l obiettivo; se accelerano, dedica il tempo extra alla conversazione e al ripasso.'], tableHeaders: ['Stato', 'Significato', 'Cosa fare'], tableRows: [['In linea', 'Le ore disponibili raggiungono la stima alta.', 'Mantieni la routine e usa i traguardi come punti di controllo.'], ['Stretto', 'Le ore raggiungono la stima bassa ma non quella alta.', 'Considera la data ambiziosa e proteggi il tempo per il ripasso.'], ['Insufficiente', 'Le ore disponibili restano sotto la stima bassa.', 'Aggiungi tempo settimanale, sposta la data o scegli un obiettivo più vicino.']] }),
+  bibliography: [{ name: 'Consiglio d Europa: Volume complementare del QCER, edizione spagnola', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: Ore di apprendimento guidato', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: 'Creare un piano di studio linguistico', howTo: [{ name: 'Scegli le lingue', text: 'Seleziona la lingua che già usi con sicurezza e quella che vuoi imparare.' }, { name: 'Imposta il percorso QCER', text: 'Scegli il livello attuale e quello che vuoi raggiungere. L obiettivo deve essere superiore al livello attuale.' }, { name: 'Proteggi una routine settimanale', text: 'Imposta una data obiettivo futura e inserisci le ore che puoi studiare realisticamente ogni settimana.' }, { name: 'Controlla e adatta', text: 'Usa stato, ripartizione e traguardi come piano iniziale, poi modifica la data o il tempo settimanale mentre impari.' }],
+});

package/src/tool/language-learning-study-plan-planner/i18n/ja.ts

@@ -0,0 +1,21 @@
+import type { LanguagePlannerUI } from '../ui';
+import { createPlannerLocale, makePlannerSeo } from './shared';
+
+const ui: LanguagePlannerUI = {
+  plannerKicker: '語学学習プランナー', plannerHeading: '次の語学目標を見える化しましょう。', sourceLanguage: '開始時の言語', targetLanguage: '学びたい言語', currentLevel: '現在のCEFRレベル', targetLevel: '目標のCEFRレベル', targetDate: '目標日', weeklyHours: '週あたりの学習時間', priority: '技能の優先順位', balanced: 'バランス', comprehension: '理解', production: '会話と作文', planButton: '学習プランを作成', resetButton: 'リセット', presetsLabel: 'ペースを選んで開始', casualPreset: '1日30分', steadyPreset: '週5時間', sprintPreset: '試験対策スプリント', plannerNote: 'これは幅広いガイド付き学習時間に基づく計画用の目安です。レベルを判定したり、流暢さを保証したりするものではありません。', resultTitle: 'あなたの学習プラン', liveLabel: '現在値', hoursRange: '必要な学習時間の目安', weeksAvailable: '目標日までの週数', hoursAvailable: 'このペースで使える時間', recommendedTime: '推奨される週あたりの範囲', onTrack: '利用できる時間が上限の目安を満たしています。', tight: '下限の目安は満たしていますが、復習の時間も確保しましょう。', insufficient: '期限が下限の目安より短くなっています。時間を増やすか目標日を変更してください。', statusLabel: 'プランの状態', weeklyAllocation: '週ごとの技能配分', milestones: '到達目安', skillListening: '聞く', skillSpeaking: '話す', skillReading: '読む', skillWriting: '書く', milestoneTarget: '到達', milestoneWeek: '週目ごろ', errorPrefix: '入力を確認してください', languageOptions: '英語|スペイン語|フランス語|ドイツ語|イタリア語|ポルトガル語|日本語|韓国語|中国語|アラビア語', emptyResultDescription: 'ペースと日付を選ぶと、現在のレベルから次のレベルまでの道筋が表示されます。', guidedLearningDetail: 'ガイド付き学習の範囲', targetDateDetail: '目標日まで', weeklyPaceDetail: '選択した週ペースで', recommendedRangeDetail: 'この範囲に必要な週あたり',
+};
+
+const faq = [
+  { question: '語学学習プランナーは何を計算しますか？', answer: '現在のCEFRレベルから目標レベルまでに必要な時間の範囲を見積もり、目標日までの週数と学習時間を比較して、技能ごとの週配分を提案します。' },
+  { question: '表示される学習時間は保証ですか？', answer: 'いいえ。ガイド付き学習の目安に基づく幅広い計画用の範囲です。言語の組み合わせ、経験、触れる量、学習の質、練習機会によって実際の時間は大きく変わります。' },
+  { question: '理解と産出の優先順位はどう違いますか？', answer: '理解は聞くことと読むことに多くの時間を配分します。産出は話すことと書くことに多く配分します。バランスは4技能に均等に時間を配分します。' },
+  { question: 'どの言語の組み合わせにも使えますか？', answer: 'どの言語の組み合わせでも出発点として使えますが、言語間の距離や文字体系の複雑さは計算していません。計画の枠として使い、実際の進歩を見ながら修正してください。' },
+  { question: '選んだ言語は保存されますか？', answer: 'このプランナーはブラウザー内で動作し、入力内容をサーバーへ送信しません。アカウントやログインも必要ありません。' },
+];
+
+export const content = createPlannerLocale({
+  slug: 'language-learning-study-plan-planner', title: '語学学習プラン計算ツール', description: 'CEFRレベル間の学習時間を見積もり、目標日と週の学習時間から実行しやすい語学学習プランを作成します。', ui, faq,
+  seo: makePlannerSeo({ titles: ['期限に合う語学学習プランを作る', '見積もりの計算方法', '決める前にプランの状態を確認する', '数値を出発点として使う'], paragraphs: ['明確な語学目標があり、設定した期限が現実的かを知りたいときに使ってください。現在のCEFRレベル、目標レベル、日付、毎週確保できる学習時間を選びます。必要時間の範囲、提案される週ペース、進捗を確認するための到達目安が表示されます。', 'このプランナーは各CEFRレベルについて、ガイド付き学習時間の累積範囲を使います。現在のレベルの範囲を目標レベルの範囲から引き、残りの週数と比較します。このモデルではA1からB1への移行はおよそ260から300時間です。週5時間なら、欠席や追加の復習を含める前に約52から60週かかります。', 'CEFRは能力を表す基準であり、保証された日程ではありません。言語間の距離、これまでの接触、学習の質、実際の使用によってペースは変わります。到達目安を実際の結果と比べ、遅ければ目標日を延ばすか目標を下げ、速ければ会話と復習に余分な時間を使いましょう。'], tableHeaders: ['状態', '意味', '対応'], tableRows: [['順調', '利用できる時間が上限の目安に届いています。', '習慣を維持し、到達目安を確認点として使います。'], ['余裕が少ない', '下限には届きますが、上限には届きません。', '挑戦的な期限と考え、復習時間を確保します。'], ['不足', '利用できる時間が下限の目安を下回っています。', '週の時間を増やす、日付を延ばす、近い目標を選ぶ、のいずれかを行います。']] }),
+  bibliography: [{ name: '欧州評議会: CEFR Companion Volume スペイン語版', url: 'https://rm.coe.int/marco-comun-europeo-de-referencia-para-las-lenguas-aprendizaje-ensenan/1680a52d53' }, { name: 'Cambridge English: ガイド付き学習時間', url: 'https://support.cambridgeenglish.org/hc/en-gb/articles/202838506-Guided-learning-hours' }],
+  howToName: '語学学習プランを作成する', howTo: [{ name: '言語を選ぶ', text: 'すでに無理なく使える言語と、学びたい言語を選びます。' }, { name: 'CEFRの進歩を設定する', text: '現在のレベルと到達したいレベルを選びます。目標は現在のレベルより上である必要があります。' }, { name: '毎週の習慣を確保する', text: '将来の目標日を設定し、毎週現実的に学べる時間を入力します。' }, { name: '確認して調整する', text: '状態、技能配分、到達目安を最初の計画として使い、学習しながら日付や週の時間を調整します。' }],
+});