@jjlmoya/utils-science 1.21.0 → 1.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-science",
-    "version": "1.21.0",
+    "version": "1.22.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -6,10 +6,11 @@ import { simulationProbability } from '../tool/simulation-probability/index';
 import { cellularRenewal } from '../tool/cellular-renewal/index';
 import { cosmicInflation } from '../tool/cosmic-inflation/index';
 import { temperatureTimeline } from '../tool/temperature-timeline/index';
+import { lorenzAttractor } from '../tool/lorenz-attractor/index';
 
 export const scienceCategory: ScienceCategoryEntry = {
   icon: 'mdi:flask',
-  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline],
+  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -6,6 +6,7 @@ export { microwaveDetector } from './tool/microwave-detector/entry';
 export { simulationProbability } from './tool/simulation-probability/entry';
 export { cosmicInflation } from './tool/cosmic-inflation/entry';
 export { temperatureTimeline } from './tool/temperature-timeline/entry';
+export { lorenzAttractor } from './tool/lorenz-attractor/entry';
 export { scienceCategory } from './category';
 import { asteroidImpact } from './tool/asteroid-impact/entry';
 import { cellularRenewal } from './tool/cellular-renewal/entry';
@@ -14,4 +15,5 @@ import { microwaveDetector } from './tool/microwave-detector/entry';
 import { simulationProbability } from './tool/simulation-probability/entry';
 import { cosmicInflation } from './tool/cosmic-inflation/entry';
 import { temperatureTimeline } from './tool/temperature-timeline/entry';
-export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline];
+import { lorenzAttractor } from './tool/lorenz-attractor/entry';
+export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor];

package/src/index.ts

@@ -7,6 +7,7 @@ export { SIMULATION_PROBABILITY_TOOL } from './tool/simulation-probability/index
 export { CELLULAR_RENEWAL_TOOL } from './tool/cellular-renewal/index';
 export { COSMIC_INFLATION_TOOL } from './tool/cosmic-inflation/index';
 export { TEMPERATURE_TIMELINE_TOOL } from './tool/temperature-timeline/index';
+export { LORENZ_ATTRACTOR_TOOL } from './tool/lorenz-attractor/index';
 
 export type {
   KnownLocale,

package/src/tests/locale_completeness.test.ts

@@ -18,8 +18,8 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 7 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(7);
+  it('all 8 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(8);
   });
 });
 

package/src/tests/tool_validation.test.ts

@@ -4,8 +4,8 @@ import { scienceCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 7 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(7);
+    it('should have 8 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(8);
     });
 
     it('scienceCategory should be defined', () => {

package/src/tool/lorenz-attractor/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { lorenzAttractor } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await lorenzAttractor.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}

package/src/tool/lorenz-attractor/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Lorenz, E. N. (1963). Deterministic Nonperiodic Flow. Journal of the Atmospheric Sciences, 20(2), 130-141.',
+    url: 'https://journals.sagepub.com/doi/10.1177/0309133308091948',
+  },
+  {
+    name: 'Sparrow, C. (1982). The Lorenz Equations: Bifurcations, Chaos, and Strange Attractors. Springer-Verlag.',
+    url: 'https://link.springer.com/book/10.1007/978-1-4612-5767-7',
+  }
+];

package/src/tool/lorenz-attractor/component.astro

@@ -0,0 +1,146 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="lorenz-app">
+  <div class="lorenz-card">
+    <div class="lorenz-grid">
+      <div class="lorenz-canvas-container">
+        <canvas id="lorenzCanvas" class="lorenz-canvas"></canvas>
+      </div>
+
+      <div class="lorenz-controls-section">
+        <div class="lorenz-sliders-block">
+          <div class="lorenz-slider-group">
+            <div class="lorenz-slider-header">
+              <span class="lorenz-slider-label">Sigma (&sigma;)</span>
+              <span class="lorenz-slider-val" id="valSigma">10.0</span>
+            </div>
+            <input
+              type="range"
+              id="slideSigma"
+              class="lorenz-slider"
+              min="1"
+              max="30"
+              step="0.1"
+              value="10.0"
+              aria-label="Sigma"
+            />
+          </div>
+
+          <div class="lorenz-slider-group">
+            <div class="lorenz-slider-header">
+              <span class="lorenz-slider-label">Rho (&rho;)</span>
+              <span class="lorenz-slider-val" id="valRho">28.0</span>
+            </div>
+            <input
+              type="range"
+              id="slideRho"
+              class="lorenz-slider"
+              min="1"
+              max="50"
+              step="0.1"
+              value="28.0"
+              aria-label="Rho"
+            />
+          </div>
+
+          <div class="lorenz-slider-group">
+            <div class="lorenz-slider-header">
+              <span class="lorenz-slider-label">Beta (&beta;)</span>
+              <span class="lorenz-slider-val" id="valBeta">2.67</span>
+            </div>
+            <input
+              type="range"
+              id="slideBeta"
+              class="lorenz-slider"
+              min="0.1"
+              max="10"
+              step="0.01"
+              value="2.67"
+              aria-label="Beta"
+            />
+          </div>
+
+          <div class="lorenz-slider-group">
+            <div class="lorenz-slider-header">
+              <span>{ui.simulationSpeed}</span>
+              <span class="lorenz-slider-val" id="valDt">0.005</span>
+            </div>
+            <input
+              type="range"
+              id="slideDt"
+              class="lorenz-slider"
+              min="0.001"
+              max="0.02"
+              step="0.001"
+              value="0.005"
+              aria-label="dt"
+            />
+          </div>
+
+          <div class="lorenz-slider-group">
+            <div class="lorenz-slider-header">
+              <span>{ui.initialPerturbation}</span>
+              <span class="lorenz-slider-val" id="valPerturb">0.00010</span>
+            </div>
+            <input
+              type="range"
+              id="slidePerturb"
+              class="lorenz-slider"
+              min="0.00001"
+              max="0.01"
+              step="0.00001"
+              value="0.00010"
+              aria-label="Perturbation"
+            />
+          </div>
+        </div>
+
+        <div class="lorenz-button-row">
+          <button id="btnPlayPause" class="lorenz-btn lorenz-btn-active-state">{ui.pause}</button>
+          <button id="btnReset" class="lorenz-btn">{ui.resetDefault}</button>
+          <button id="btnClear" class="lorenz-btn">{ui.clearPath}</button>
+        </div>
+
+        <div class="lorenz-stats-block">
+          <div class="lorenz-coords-row">
+            <div class="lorenz-coord-item">
+              T1: <span id="statT1" class="lorenz-coord-val">X:0.0 Y:0.0 Z:0.0</span>
+            </div>
+            <div class="lorenz-coord-item">
+              T2: <span id="statT2" class="lorenz-coord-val">X:0.0 Y:0.0 Z:0.0</span>
+            </div>
+          </div>
+
+          <div class="lorenz-divergence-display">
+            <span class="lorenz-divergence-title">{ui.distance}</span>
+            <div class="lorenz-divergence-main">
+              <span class="lorenz-divergence-num" id="statDist">0.0000</span>
+              <span class="lorenz-divergence-delta" id="statDelta">--</span>
+            </div>
+          </div>
+        </div>
+
+        <div class="lorenz-chart-block">
+          <div class="lorenz-chart-header">
+            <span>{ui.exponentialGrowth}</span>
+            <div class="lorenz-tooltip-container">
+              <span class="lorenz-info-icon">i</span>
+              <div class="lorenz-tooltip-text">{ui.divergenceExplanation}</div>
+            </div>
+          </div>
+          <div class="lorenz-chart-canvas-wrapper">
+            <canvas id="chartCanvas" class="lorenz-chart-canvas"></canvas>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script src="./script.ts"></script>

package/src/tool/lorenz-attractor/entry.ts

@@ -0,0 +1,27 @@
+import type { ScienceToolEntry } from '../../types';
+
+export const lorenzAttractor: ScienceToolEntry = {
+  id: 'lorenz-attractor',
+  icons: {
+    bg: 'mdi:chart-bell-curve-cumulative',
+    fg: 'mdi:butterfly',
+  },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};
+export type { ToolLocaleContent } from '../../types';

package/src/tool/lorenz-attractor/i18n/de.ts

@@ -0,0 +1,113 @@
+const slug = 'lorenz-attraktor';
+const title = 'Lorenz Attraktor Chaos Simulator Der Schmetterlingseffekt in 3D';
+const description = 'Erforschen Sie die Chaostheorie mit dieser interaktiven 3D-Lorenz-Attraktor-Simulation. Visualisieren Sie den Schmetterlingseffekt.';
+
+const howTo = [
+  {
+    "name": "Leinwand drehen",
+    "text": "Klicken und ziehen Sie im 3D-Viewport, um den Attraktor zu drehen."
+  },
+  {
+    "name": "Schieberegler anpassen",
+    "text": "Aendern Sie die Parameter Sigma, Rho und Beta, um das Chaos zu beobachten."
+  },
+  {
+    "name": "Divergenz beobachten",
+    "text": "Beobachten Sie, wie der Abstand zwischen den beiden Trajektorien exponentiell waechst."
+  },
+  {
+    "name": "Pause und Reset",
+    "text": "Verwenden Sie die Steuerelemente, um die Simulation anzuhalten oder zurueckzusetzen."
+  }
+];
+
+const faq = [
+  {
+    "question": "Was ist der Lorenz-Attraktor?",
+    "answer": "Der Lorenz-Attraktor ist eine Reihe chaotischer Loesungen des Lorenz-Systems."
+  },
+  {
+    "question": "Was ist der Schmetterlingseffekt?",
+    "answer": "Die empfindliche Abhaengigkeit von den Anfangsbedingungen in chaotischen Systemen."
+  },
+  {
+    "question": "Was bedeuten die Parameter?",
+    "answer": "Sigma ist die Prandtl-Zahl, Rho die Rayleigh-Zahl und Beta das geometrische Aspektverhaeltnis."
+  }
+];
+
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+
+export const content: ToolLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+  "copied": "Kopiert",
+  "noHistory": "Kein Verlauf",
+  "load": "Laden",
+  "delete": "Loeschen",
+  "title": "Lorenz-Attraktor",
+  "subTitle": "Deterministisches Chaos",
+  "parameterControls": "Systemparameter",
+  "simulationSpeed": "Geschwindigkeit (dt)",
+  "initialPerturbation": "Anfaengliche Stoerung (dx)",
+  "trajectories": "Trajektorien",
+  "distance": "Divergenzabstand",
+  "exponentialGrowth": "Exponentielle Divergenz",
+  "resetDefault": "Reset",
+  "clearPath": "Clear",
+  "play": "Resume",
+  "pause": "Pause",
+  "coords": "Koordinaten",
+  "divergenceExplanation": "Das Divergenzdiagramm zeigt den euklidischen Abstand zwischen den beiden Trajektorien im Laufe der Zeit."
+},
+  seo: [
+  {
+    "type": "title",
+    "text": "Deterministisches Chaos: Die Lorenz-Gleichungen verstehen",
+    "level": 2
+  },
+  {
+    "type": "paragraph",
+    "html": "Das Lorenz-System ist ein Meilenstein in der Geschichte der Mathematik und der nichtlinearen Dynamik."
+  }
+],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      description: description,
+      applicationCategory: 'ScientificApplication',
+      operatingSystem: 'Any',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((item) => ({
+        '@type': 'Question',
+        name: item.question,
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: item.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((step) => ({
+        '@type': 'HowToStep',
+        name: step.name,
+        stepValue: step.name,
+        text: step.text,
+      })),
+    },
+  ],
+};

package/src/tool/lorenz-attractor/i18n/en.ts

@@ -0,0 +1,185 @@
+const slug = 'lorenz-attractor';
+const title = 'Lorenz Attractor Chaos Simulator: The Butterfly Effect in 3D';
+const description = 'Explore chaos theory with this interactive 3D Lorenz attractor simulation. Visualize the butterfly effect by running two nearly identical trajectories side-by-side.';
+
+const howTo = [
+  {
+    name: 'Rotate the canvas',
+    text: 'Click and drag on the 3D viewport (or swipe on mobile) to rotate the attractor and view it from different angles.',
+  },
+  {
+    name: 'Adjust the sliders',
+    text: 'Modify the Sigma, Rho, and Beta parameters. Observe how changing Rho transitions the system from stable orbits to chaotic behavior.',
+  },
+  {
+    name: 'Observe the divergence',
+    text: 'Adjust the initial perturbation slider. Watch the live chart showing the separation distance between the two trajectories grow exponentially.',
+  },
+  {
+    name: 'Pause and reset',
+    text: 'Use the controls to pause the simulation, clear the drawing paths, or reset parameters to the standard chaotic defaults.',
+  },
+];
+
+const faq = [
+  {
+    question: 'What is the Lorenz Attractor?',
+    answer: 'The Lorenz attractor is a set of chaotic solutions to the Lorenz system, a system of three ordinary differential equations first formulated by Edward Lorenz in 1963. It was originally derived from a simplified mathematical model of atmospheric convection.',
+  },
+  {
+    question: 'What is the Butterfly Effect?',
+    answer: 'The butterfly effect is the sensitive dependence on initial conditions, where a small change in one state of a deterministic nonlinear system can result in large differences in a later state. In this simulator, a tiny starting perturbation of 0.0001 causes the two paths to diverge completely after a short time.',
+  },
+  {
+    question: 'What do the parameters Sigma, Rho, and Beta represent?',
+    answer: 'Sigma represents the Prandtl number (related to fluid viscosity and thermal conductivity), Rho represents the Rayleigh number (related to thermal convection strength), and Beta is a geometric parameter related to the physical dimensions of the convective layer.',
+  },
+  {
+    question: 'Why does the attractor shape look like a butterfly?',
+    answer: 'The iconic double-winged butterfly shape arises because the system has two unstable equilibrium points. The trajectory orbits around one wing, then unpredictably transitions to orbit the other, creating the distinctive structure in 3D phase space.',
+  },
+  {
+    question: 'Is the Lorenz Attractor truly random?',
+    answer: 'No. The Lorenz system is entirely deterministic, meaning its future state is fully defined by its current state and equations. However, because it is chaotic, it is completely unpredictable in the long term without infinite precision of the initial conditions.',
+  },
+];
+
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+
+export const content: ToolLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+    copied: 'Copied',
+    noHistory: 'No history',
+    load: 'Load',
+    delete: 'Delete',
+    title: 'Lorenz Attractor',
+    subTitle: 'Deterministic Chaos and Sensitive Dependence',
+    parameterControls: 'System Parameters',
+    simulationSpeed: 'Simulation Speed (dt)',
+    initialPerturbation: 'Initial Perturbation (dx)',
+    trajectories: 'Trajectories',
+    distance: 'Divergence Distance',
+    exponentialGrowth: 'Exponential Divergence',
+    resetDefault: 'Reset',
+    clearPath: 'Clear',
+    play: 'Resume',
+    pause: 'Pause',
+    coords: 'Coordinates',
+    divergenceExplanation: 'The divergence chart shows the Euclidean distance between the two trajectories over time. Notice how it remains near zero before spiking rapidly, illustrating the butterfly effect.',
+  },
+  seo: [
+    {
+      type: 'title',
+      text: 'Deterministic Chaos: Understanding the Lorenz Equations',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'The Lorenz system is a landmark formulation in nonlinear dynamics and chaos theory. Originally derived in 1963 by the meteorologist and mathematician <strong>Edward Lorenz</strong>, the model was born out of a simplified representation of atmospheric convection. Lorenz simplified the complex fluid dynamics equations of atmospheric flow into three coupled, ordinary differential equations. His discovery that these simple, deterministic equations could produce highly complex, non-periodic, and chaotic behavior changed our understanding of physical systems.',
+    },
+    {
+      type: 'paragraph',
+      html: 'The system is defined by three coupled differential equations that track a coordinate in a three-dimensional phase space over time:',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>dx/dt = &sigma; * (y - x):</strong> Describes the rate of convective motion. The parameter &sigma; (Prandtl number) represents the ratio of fluid viscosity to thermal conductivity.',
+        '<strong>dy/dt = x * (&rho; - z) - y:</strong> Represents the temperature difference between ascending and descending convective currents. The parameter &rho; (Rayleigh number) represents the convective heating intensity.',
+        '<strong>dz/dt = x * y - &beta; * z:</strong> Tracks the distortion of the vertical temperature profile from a linear gradient. The parameter &beta; is a geometric aspect ratio of the convective physical cell.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'The Butterfly Effect: Sensitive Dependence on Initial Conditions',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'The defining feature of chaotic systems is their <strong>sensitive dependence on initial conditions</strong>, popularly known as the <strong>Butterfly Effect</strong>. In a non-chaotic system, a minor difference in the initial state leads to a proportionally minor difference in the final state. In a chaotic system, however, the distance between two trajectories starting arbitrarily close to each other grows exponentially over time.',
+    },
+    {
+      type: 'paragraph',
+      html: 'This sensitivity is demonstrated in this simulator by running two trajectories (T1 in Cyan and T2 in Pink) that start with a tiny separation (defined by the Perturbation slider). Initially, they travel along virtually the same path, rendering a blended purple line. After a short period of time, the minor starting difference is amplified by the system\'s nonlinear terms, and the paths diverge completely, orbiting different wings of the attractor.',
+    },
+    {
+      type: 'table',
+      headers: ['Parameter', 'Standard Value', 'Physical Setting', 'System Behavior on Change'],
+      rows: [
+        ['&sigma; (Sigma)', '10.0', 'Prandtl Number', 'Determines the fluid\'s internal friction. Higher values speed up the reaction of velocity changes relative to temperature gradients.'],
+        ['&rho; (Rho)', '28.0', 'Rayleigh Number', 'Main driver of chaos. Below &rho; = 1, the origin is the only stable point. At &rho; = 28, the system is fully chaotic.'],
+        ['&beta; (Beta)', '8/3 (2.667)', 'Geometric Aspect Ratio', 'Controls the physical width-to-height ratio of the convection cells. Modifies the scale and rotation speed of the orbits.'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Phase Space, Strange Attractors, and Fractals',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'In classical physics, trajectories eventually settle into steady points (sinks) or repeat the same path indefinitely (limit cycles). The Lorenz system does neither. The path loops in three dimensions infinitely without ever crossing itself, since the system is deterministic and unique at every coordinate. This infinite, non-repeating structure is bounded within a finite volume of phase space, forming a <strong>strange attractor</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'The geometry of this attractor is fractal, with a Hausdorff dimension of approximately 2.06. This means the attractor is more than a two-dimensional surface but less than a solid three-dimensional volume, showcasing a complex topological structure where paths fold over each other without intersecting.',
+    },
+    {
+      type: 'title',
+      text: 'Applications of Chaos Theory in Science',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'The lessons learned from the Lorenz attractor extend far beyond weather forecasting. Chaos theory has influenced many modern fields of study:',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Meteorology:</strong> Established the fundamental limits of weather predictability, leading to ensemble forecasting methods.',
+        '<strong>Cryptography:</strong> The deterministic yet unpredictable nature of chaotic orbits is used to generate secure pseudo-random keys and encrypt sensitive data streams.',
+        '<strong>Cardiology:</strong> Used to model cardiac rhythms, where healthy hearts exhibit chaotic characteristics, while periodic rhythms can indicate pathology.',
+        '<strong>Engineering:</strong> Helps design stable structures by analyzing and avoiding chaotic resonance in suspension bridges and mechanical systems.',
+      ],
+    },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      description: description,
+      applicationCategory: 'ScientificApplication',
+      operatingSystem: 'Any',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((item) => ({
+        '@type': 'Question',
+        name: item.question,
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: item.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((step) => ({
+        '@type': 'HowToStep',
+        name: step.name,
+        text: step.text,
+      })),
+    },
+  ],
+};