@mxfb/tools 1.0.0 → 1.0.3

package/agnostic/poetry/index.js

@@ -0,0 +1 @@
+export * as generateRhymes from './generate-rhymes/index.js'

package/agnostic/scrapers/@meteociel/index.js

@@ -1,194 +1,248 @@
-import {
-  citiesData
-} from "../../../chunks/chunk-JQLUR5LO.js";
-
-// src/agnostic/scrapers/@meteociel/index.ts
-import { JSDOM } from "jsdom";
-function getCityAndModeUrl(cityName, mode) {
-  const modeUrlChunk = mode === "simple-gfs" ? "previsions" : null;
-  if (modeUrlChunk === null) throw "invalid mode";
-  return `https://www.meteociel.fr/${modeUrlChunk}/${citiesData[cityName].id}/${citiesData[cityName].urlSuffix}.htm`;
+import { JSDOM } from 'jsdom';
+import { citiesData } from './locations/index.js';
+/**
+ * Builds the Meteociel forecast page URL for a given city and forecast mode.
+ *
+ * @param cityName - The city identifier used to resolve Meteociel location data.
+ * @param mode - The forecast mode to use when building the URL.
+ * @returns The fully qualified Meteociel URL for the requested city and mode.
+ * @throws If the provided forecast mode is not supported.
+ */
+export function getCityAndModeUrl(cityName, mode) {
+    // `ForecastMode` has a single member today; this guard and the `default` branch of
+    // `scrap` are what will catch a second one.
+    /* eslint-disable-next-line @typescript-eslint/no-unnecessary-condition */
+    const modeUrlChunk = mode === 'simple-gfs' ? 'previsions' : null;
+    if (modeUrlChunk === null)
+        throw new Error('invalid mode');
+    return 'https://www.meteociel.fr/'
+        + `${modeUrlChunk}/`
+        + `${citiesData[cityName].id}/`
+        + `${citiesData[cityName].urlSuffix}.htm`;
 }
-async function fetchPage(url) {
-  const fetched = await fetch(url);
-  const buffer = await fetched.arrayBuffer();
-  const html = new TextDecoder("iso-8859-1").decode(buffer);
-  return html;
+/**
+ * Fetches a remote HTML page and decodes it using ISO-8859-1 encoding.
+ *
+ * @param url - The URL of the page to fetch.
+ * @returns The decoded HTML content of the fetched page.
+ */
+export async function fetchPage(url) {
+    const fetched = await fetch(url);
+    const buffer = await fetched.arrayBuffer();
+    const html = new TextDecoder('iso-8859-1').decode(buffer);
+    return html;
 }
-async function scrap(cityName, mode) {
-  const url = getCityAndModeUrl(cityName, mode);
-  const fetched = await fetchPage(url);
-  switch (mode) {
-    case "simple-gfs": {
-      const scraped = scrapSimpleGfsPrevisions(fetched);
-      return scraped.map((i) => ({
-        ...i,
-        location: {
-          ...i.location,
-          name: cityName
+/**
+ * Retrieves and scrapes weather forecast data for a given city and forecast mode.
+ *
+ * @param cityName - The city for which to retrieve weather forecasts.
+ * @param mode - The forecast mode determining the scraping strategy.
+ * @returns An array of weather forecasts enriched with city location metadata.
+ * @throws If the forecast mode is unknown or unsupported.
+ */
+export async function scrap(cityName, mode) {
+    const url = getCityAndModeUrl(cityName, mode);
+    const fetched = await fetchPage(url);
+    switch (mode) {
+        /* eslint-disable-next-line @typescript-eslint/no-unnecessary-condition */
+        case 'simple-gfs': {
+            const scraped = scrapSimpleGfsPrevisions(fetched);
+            return scraped.map(i => ({
+                ...i,
+                location: {
+                    ...i.location,
+                    name: cityName
+                }
+            }));
         }
-      }));
+        /* eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check */
+        default: throw new Error('unknown-mode');
     }
-    default:
-      throw "unknown-mode";
-  }
 }
-function scrapSimpleGfsPrevisions(pageContent) {
-  const dom = new JSDOM(pageContent);
-  const { document } = dom.window;
-  const COLLECTED_ON = /* @__PURE__ */ new Date();
-  const h3Parent = Array.from(document.querySelectorAll("h3")).find((n) => n.textContent.includes("Pr\xE9visions m\xE9t\xE9o \xE0 3 jours"))?.parentElement;
-  const issueTimeNode = Array.from(h3Parent?.childNodes ?? []).find((n) => n.textContent?.includes("R\xE9actualis\xE9 \xE0"));
-  const dataTableNode = Array.from(document.querySelectorAll("tbody")).find((n) => {
-    const trChldCnt = n.querySelectorAll("tr").length;
-    return trChldCnt > 25 && trChldCnt < 35;
-  });
-  const forecastTableRows = Array.from(dataTableNode?.querySelectorAll("tr") ?? []).slice(2);
-  const locationNode = Array.from(
-    Array.from(document.querySelectorAll("p")).find((n) => n.textContent.includes("sont exp\xE9rimentales et d\xE9termin\xE9es \xE0 partir des donn\xE9es brutes de GFS, un mod\xE8le num\xE9rique am\xE9ricain"))?.childNodes ?? []
-  ).find((n) => n.textContent?.startsWith("Localisation de"));
-  const issuedOnRaw = issueTimeNode?.textContent?.match(/\b([0-9]{1,2}):([0-5][0-9])\b/)?.[0];
-  if (issuedOnRaw === void 0) throw "no-refresh-time-found";
-  const [issuedOnH, issuedOnM] = issuedOnRaw.split(":");
-  const issuedOnYesteredayMaybe = /* @__PURE__ */ new Date();
-  issuedOnYesteredayMaybe.setDate((/* @__PURE__ */ new Date()).getDate() - 1);
-  issuedOnYesteredayMaybe.setHours(parseInt(issuedOnH));
-  issuedOnYesteredayMaybe.setMinutes(parseInt(issuedOnM));
-  issuedOnYesteredayMaybe.setSeconds(0);
-  issuedOnYesteredayMaybe.setMilliseconds(0);
-  const issuedOnYesteredayMaybeNowDiff = Math.abs((/* @__PURE__ */ new Date()).getTime() - issuedOnYesteredayMaybe.getTime());
-  const issuedOnTodayMaybe = /* @__PURE__ */ new Date();
-  issuedOnTodayMaybe.setHours(parseInt(issuedOnH));
-  issuedOnTodayMaybe.setMinutes(parseInt(issuedOnM));
-  issuedOnTodayMaybe.setSeconds(0);
-  issuedOnTodayMaybe.setMilliseconds(0);
-  const issuedOnTodayMaybeNowDiff = Math.abs((/* @__PURE__ */ new Date()).getTime() - issuedOnTodayMaybe.getTime());
-  const ISSUED_ON = issuedOnYesteredayMaybeNowDiff > issuedOnTodayMaybeNowDiff ? issuedOnTodayMaybe : issuedOnYesteredayMaybe;
-  function parseLocation(input) {
-    const regex = /Latitude\s+([NS])\s+(\d+)°(\d+)'\s+\/\s+Longitude\s+([EW])\s+(\d+)°(\d+)'\s+\/\s+Altitude\s*:\s*(\d+)\s*m/;
-    const match = input.match(regex);
-    if (!match) throw new Error("Format de coordonn\xE9es invalide");
-    const [, latDir, latDeg, latMin, lonDir, lonDeg, lonMin, altStr] = match;
-    let lat = Number(latDeg) + Number(latMin) / 60;
-    let lon = Number(lonDeg) + Number(lonMin) / 60;
-    if (latDir === "S") lat = -1 * lat;
-    if (lonDir === "W") lon = -1 * lon;
-    const alt = Number(altStr);
-    return {
-      latitudeDeg: lat,
-      longitudeDeg: lon,
-      elevationM: alt
-    };
-  }
-  let LOCATION;
-  try {
-    LOCATION = parseLocation(locationNode?.textContent ?? "");
-  } catch (err) {
-    throw "no-geolocation-found";
-  }
-  let currentDateLabel = null;
-  const currentHour = /* @__PURE__ */ new Date();
-  currentHour.setMinutes(0);
-  currentHour.setSeconds(0);
-  currentHour.setMilliseconds(0);
-  let RETURNED = [];
-  for (const row of forecastTableRows) {
-    const cells = Array.from(row.querySelectorAll("td"));
-    if (cells.length < 10 || cells.length > 11) continue;
-    let dateCell = void 0;
-    let otherCells = [];
-    if (cells.length === 11) {
-      dateCell = cells[0];
-      otherCells.push(...cells.slice(1));
-    } else {
-      otherCells.push(...cells);
+/**
+ * Scrapes 3-day GFS weather simple forecasts from a Meteociel HTML page.
+ *
+ * @param pageContent - The raw HTML content of the Meteociel forecast page.
+ * @returns An array of weather forecasts parsed from the page content.
+ * @throws If required data such as issue time or geolocation cannot be extracted.
+ */
+export function scrapSimpleGfsPrevisions(pageContent) {
+    const dom = new JSDOM(pageContent);
+    const { document } = dom.window;
+    // Storing collection time
+    const COLLECTED_ON = new Date();
+    // Extracting relevant DOM nodes
+    const h3Parent = Array
+        .from(document.querySelectorAll('h3'))
+        .find(n => n.textContent.includes('Prévisions météo à 3 jours'))
+        ?.parentElement;
+    const issueTimeNode = Array
+        .from(h3Parent?.childNodes ?? [])
+        .find(n => n.textContent?.includes('Réactualisé à') === true);
+    const dataTableNode = Array
+        .from(document.querySelectorAll('tbody'))
+        .find(n => {
+        const trChldCnt = n.querySelectorAll('tr').length;
+        return trChldCnt > 25 && trChldCnt < 35;
+    });
+    const forecastTableRows = Array
+        .from(dataTableNode?.querySelectorAll('tr') ?? [])
+        .slice(2);
+    const locationNode = Array.from(Array
+        .from(document.querySelectorAll('p'))
+        .find(n => n.textContent.includes('sont expérimentales et déterminées à partir des données brutes de GFS, un modèle numérique américain'))
+        ?.childNodes ?? []).find(n => n.textContent?.startsWith('Localisation de') === true);
+    // Extracting issue time
+    const issuedOnRaw = issueTimeNode?.textContent?.match(/\b([0-9]{1,2}):([0-5][0-9])\b/v)?.[0];
+    if (issuedOnRaw === undefined)
+        throw new Error('no-refresh-time-found');
+    // The regex above matched, so there are exactly two colon-separated groups.
+    /* eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion */
+    const [issuedOnH, issuedOnM] = issuedOnRaw.split(':');
+    const issuedOnYesteredayMaybe = new Date();
+    issuedOnYesteredayMaybe.setDate(new Date().getDate() - 1);
+    issuedOnYesteredayMaybe.setHours(parseInt(issuedOnH));
+    issuedOnYesteredayMaybe.setMinutes(parseInt(issuedOnM));
+    issuedOnYesteredayMaybe.setSeconds(0);
+    issuedOnYesteredayMaybe.setMilliseconds(0);
+    const issuedOnYesteredayMaybeNowDiff = Math.abs(new Date().getTime() - issuedOnYesteredayMaybe.getTime());
+    const issuedOnTodayMaybe = new Date();
+    issuedOnTodayMaybe.setHours(parseInt(issuedOnH));
+    issuedOnTodayMaybe.setMinutes(parseInt(issuedOnM));
+    issuedOnTodayMaybe.setSeconds(0);
+    issuedOnTodayMaybe.setMilliseconds(0);
+    const issuedOnTodayMaybeNowDiff = Math.abs(new Date().getTime() - issuedOnTodayMaybe.getTime());
+    const ISSUED_ON = issuedOnYesteredayMaybeNowDiff > issuedOnTodayMaybeNowDiff
+        ? issuedOnTodayMaybe
+        : issuedOnYesteredayMaybe;
+    // Extracting location
+    function parseLocation(input) {
+        const regex = /Latitude\s+([NS])\s+(\d+)°(\d+)'\s+\/\s+Longitude\s+([EW])\s+(\d+)°(\d+)'\s+\/\s+Altitude\s*:\s*(\d+)\s*m/v;
+        const match = input.match(regex);
+        if (match === null)
+            throw new Error('Format de coordonnées invalide');
+        const [, latDir, latDeg, latMin, lonDir, lonDeg, lonMin, altStr] = match;
+        let lat = Number(latDeg) + Number(latMin) / 60;
+        let lon = Number(lonDeg) + Number(lonMin) / 60;
+        if (latDir === 'S')
+            lat = -1 * lat;
+        if (lonDir === 'W')
+            lon = -1 * lon;
+        const alt = Number(altStr);
+        return {
+            latitudeDeg: lat,
+            longitudeDeg: lon,
+            elevationM: alt
+        };
     }
-    if (dateCell !== void 0) {
-      currentDateLabel = dateCell.textContent;
+    let LOCATION;
+    try {
+        LOCATION = parseLocation(locationNode?.textContent ?? '');
     }
-    const [
-      hourCell,
-      tempCell,
-      _emptyCell1,
-      windDirCell,
-      windSpeedCell,
-      gustSpeedCell,
-      rainAmountCell,
-      hygrometryCell,
-      airPressureCell,
-      weatherCell
-    ] = otherCells;
-    const hour = hourCell?.textContent ?? null;
-    const temp = tempCell?.textContent ?? null;
-    const windDir = windDirCell?.querySelector("img")?.getAttribute("title") ?? null;
-    const [windDirName = null, windDirAngle = null] = windDir?.split(" : ") ?? [];
-    const windSpeed = windSpeedCell?.textContent ?? null;
-    const gustSpeed = gustSpeedCell?.textContent ?? null;
-    const rainAmount = rainAmountCell?.textContent === "--" ? null : rainAmountCell?.textContent ?? null;
-    const hygrometry = hygrometryCell?.textContent ?? null;
-    const airPressure = airPressureCell?.textContent ?? null;
-    const weather = weatherCell?.querySelector("img")?.getAttribute("title") ?? null;
-    const rawDay = currentDateLabel;
-    const foundDate = rawDay?.slice(3) ?? "0";
-    const pMonthFullDate = new Date(currentHour);
-    pMonthFullDate.setMonth(currentHour.getMonth() - 1);
-    pMonthFullDate.setDate(parseInt(foundDate));
-    pMonthFullDate.setHours(parseInt(hour ?? "00"));
-    const curMonthFullDate = new Date(currentHour);
-    curMonthFullDate.setDate(parseInt(foundDate));
-    curMonthFullDate.setHours(parseInt(hour ?? "00"));
-    const nMonthFullDate = new Date(currentHour);
-    nMonthFullDate.setMonth(currentHour.getMonth() + 1);
-    nMonthFullDate.setDate(parseInt(foundDate));
-    nMonthFullDate.setHours(parseInt(hour ?? "00"));
-    const eligibleDateTimesDiff = [
-      Math.abs(currentHour.getTime() - pMonthFullDate.getTime()),
-      Math.abs(currentHour.getTime() - curMonthFullDate.getTime()),
-      Math.abs(currentHour.getTime() - nMonthFullDate.getTime())
-    ];
-    const minDateDiff = Math.min(...eligibleDateTimesDiff);
-    const indexOfMinDateDiff = eligibleDateTimesDiff.indexOf(minDateDiff);
-    const date = indexOfMinDateDiff === 0 ? pMonthFullDate : indexOfMinDateDiff === 1 ? curMonthFullDate : indexOfMinDateDiff === 2 ? nMonthFullDate : currentHour;
-    const validityTo = new Date(date);
-    validityTo.setHours(date.getHours() + 3);
-    const VALIDITY = {
-      from: date,
-      to: validityTo
-    };
-    const TEMPERATURE = { tempC: parseFloat(temp?.replace(" \xB0C", "") ?? "") };
-    const HUMIDITY = { relativePercent: parseFloat(hygrometry?.replace(" %", "") ?? "") };
-    const WIND = {
-      speedMs: parseFloat(windSpeed ?? ""),
-      directionDeg: parseFloat(windDirAngle?.replace(" \xB0", "") ?? ""),
-      gustMs: parseFloat(gustSpeed ?? "")
-    };
-    const PRESSURE = { stationLevelHpa: parseFloat(airPressure?.replace(" hPa", "") ?? "") };
-    const SOURCE = {
-      provider: "M\xE9t\xE9ociel",
-      type: "model",
-      model: "GFS"
-    };
-    RETURNED.push({
-      issuedOn: ISSUED_ON,
-      location: LOCATION,
-      validity: VALIDITY,
-      temperature: TEMPERATURE,
-      humidity: HUMIDITY,
-      wind: WIND,
-      pressure: PRESSURE,
-      precipitationMmh: parseFloat(rainAmount ?? ""),
-      metadata: {
-        source: SOURCE,
-        description: weather ?? "unknown",
-        collectedOn: COLLECTED_ON
-      }
-    });
-  }
-  return RETURNED;
+    catch (err) {
+        throw new Error('no-geolocation-found', { cause: err });
+    }
+    // Accessing data table rows
+    let currentDateLabel = null;
+    const currentHour = new Date();
+    currentHour.setMinutes(0);
+    currentHour.setSeconds(0);
+    currentHour.setMilliseconds(0);
+    const returned = forecastTableRows.map(row => {
+        const cells = Array.from(row.querySelectorAll('td'));
+        // Filter out irrelevant lines
+        if (cells.length < 10 || cells.length > 11)
+            return undefined;
+        // Extract cells
+        let dateCell;
+        const otherCells = [];
+        if (cells.length === 11) {
+            dateCell = cells[0];
+            otherCells.push(...cells.slice(1));
+        }
+        else {
+            otherCells.push(...cells);
+        }
+        // Extract current date
+        if (dateCell !== undefined) {
+            currentDateLabel = dateCell.textContent;
+        }
+        const [hourCell, tempCell, , windDirCell, windSpeedCell, gustSpeedCell, rainAmountCell, hygrometryCell, airPressureCell, weatherCell] = otherCells;
+        const hour = hourCell?.textContent ?? null;
+        const temp = tempCell?.textContent ?? null;
+        const windDir = windDirCell?.querySelector('img')?.getAttribute('title') ?? null;
+        const [, windDirAngle = null] = windDir?.split(' : ') ?? [];
+        const windSpeed = windSpeedCell?.textContent ?? null;
+        const gustSpeed = gustSpeedCell?.textContent ?? null;
+        const rainAmount = rainAmountCell?.textContent === '--' ? null : (rainAmountCell?.textContent) ?? null;
+        const hygrometry = hygrometryCell?.textContent ?? null;
+        const airPressure = airPressureCell?.textContent ?? null;
+        const weather = weatherCell?.querySelector('img')?.getAttribute('title') ?? null;
+        // Infer the actual date
+        const rawDay = currentDateLabel;
+        const foundDate = rawDay?.slice(3) ?? '0';
+        const pMonthFullDate = new Date(currentHour);
+        pMonthFullDate.setMonth(currentHour.getMonth() - 1);
+        pMonthFullDate.setDate(parseInt(foundDate));
+        pMonthFullDate.setHours(parseInt(hour ?? '00'));
+        const curMonthFullDate = new Date(currentHour);
+        curMonthFullDate.setDate(parseInt(foundDate));
+        curMonthFullDate.setHours(parseInt(hour ?? '00'));
+        const nMonthFullDate = new Date(currentHour);
+        nMonthFullDate.setMonth(currentHour.getMonth() + 1);
+        nMonthFullDate.setDate(parseInt(foundDate));
+        nMonthFullDate.setHours(parseInt(hour ?? '00'));
+        const eligibleDateTimesDiff = [
+            Math.abs(currentHour.getTime() - pMonthFullDate.getTime()),
+            Math.abs(currentHour.getTime() - curMonthFullDate.getTime()),
+            Math.abs(currentHour.getTime() - nMonthFullDate.getTime())
+        ];
+        const minDateDiff = Math.min(...eligibleDateTimesDiff);
+        const indexOfMinDateDiff = eligibleDateTimesDiff.indexOf(minDateDiff);
+        const date = indexOfMinDateDiff === 0
+            ? pMonthFullDate
+            : (indexOfMinDateDiff === 1
+                ? curMonthFullDate
+                : (indexOfMinDateDiff === 2
+                    ? nMonthFullDate
+                    : currentHour));
+        const validityTo = new Date(date);
+        validityTo.setHours(date.getHours() + 3);
+        const VALIDITY = {
+            from: date,
+            to: validityTo
+        };
+        // Convert scraped data to WeatherForecast compliant types
+        const TEMPERATURE = { tempC: parseFloat(temp?.replace(' °C', '') ?? '') };
+        const HUMIDITY = { relativePercent: parseFloat(hygrometry?.replace(' %', '') ?? '') };
+        const WIND = {
+            speedMs: parseFloat(windSpeed ?? ''),
+            directionDeg: parseFloat(windDirAngle?.replace(' °', '') ?? ''),
+            gustMs: parseFloat(gustSpeed ?? '')
+        };
+        const PRESSURE = { stationLevelHpa: parseFloat(airPressure?.replace(' hPa', '') ?? '') };
+        const SOURCE = {
+            provider: 'Météociel',
+            type: 'model',
+            model: 'GFS'
+        };
+        // Return
+        const returned = {
+            issuedOn: ISSUED_ON,
+            location: LOCATION,
+            validity: VALIDITY,
+            temperature: TEMPERATURE,
+            humidity: HUMIDITY,
+            wind: WIND,
+            pressure: PRESSURE,
+            precipitationMmh: parseFloat(rainAmount ?? ''),
+            metadata: {
+                source: SOURCE,
+                description: weather ?? 'unknown',
+                collectedOn: COLLECTED_ON
+            }
+        };
+        return returned;
+    }).filter(e => e !== undefined);
+    return returned;
 }
-export {
-  fetchPage,
-  getCityAndModeUrl,
-  scrap,
-  scrapSimpleGfsPrevisions
-};

package/agnostic/scrapers/@meteociel/index.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { getCityAndModeUrl, fetchPage, scrap, scrapSimpleGfsPrevisions } from './index.js';
+import { citiesData } from './locations/index.js';
+describe('scrapers/@meteociel/weather/getCityAndModeUrl', () => {
+    it('builds a valid Meteociel URL for a supported mode', () => {
+        const city = Object.keys(citiesData)[0];
+        const url = getCityAndModeUrl(city, 'simple-gfs');
+        expect(url).toContain('https://www.meteociel.fr/');
+        expect(url).toContain('previsions');
+    });
+    it('throws on unsupported mode', () => {
+        const city = Object.keys(citiesData)[0];
+        // eslint-disable-next-line  @typescript-eslint/no-unsafe-argument
+        expect(() => getCityAndModeUrl(city, 'unknown')).toThrow();
+    });
+});
+describe('scrapers/@meteociel/weather/fetchPage', () => {
+    const originalFetch = global.fetch;
+    beforeEach(() => {
+        global.fetch = vi.fn(async () => ({
+            arrayBuffer: async () => new TextEncoder().encode('<html>ok</html>').buffer
+        }));
+    });
+    afterEach(() => {
+        global.fetch = originalFetch;
+    });
+    it('fetches and decodes HTML content', async () => {
+        const html = await fetchPage('https://example.com');
+        expect(html).toContain('<html>');
+    });
+});
+describe('scrapers/@meteociel/weather/scrap', () => {
+    it('throws on unsupported mode', async () => {
+        const city = Object.keys((await import('./locations/index.js')).citiesData)[0];
+        // eslint-disable-next-line  @typescript-eslint/no-unsafe-argument
+        await expect(scrap(city, 'unknown')).rejects.toBeDefined();
+    });
+});
+describe('scrapers/@meteociel/weather/scrapSimpleGfsPrevisions', () => {
+    it('throws when page content is invalid', () => {
+        expect(() => scrapSimpleGfsPrevisions('<html></html>')).toThrow();
+    });
+});

package/agnostic/scrapers/@meteociel/locations/index.js

@@ -1,6 +1,10 @@
-import {
-  citiesData
-} from "../../../../chunks/chunk-JQLUR5LO.js";
-export {
-  citiesData
+export const citiesData = {
+    // Paris 11e
+    'paris11': {
+        id: 27827,
+        urlSuffix: 'paris_11eme_arrondissement'
+    }
 };
+// Typecheck
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _citiesDataTypecheck = citiesData;

package/agnostic/scrapers/@meteociel/types.js

@@ -0,0 +1 @@
+export {};

package/agnostic/scrapers/@tumblr/blogs/delabienbonnemusique/index.d.ts

@@ -0,0 +1,22 @@
+import type { TumblrBlogParser } from '../../types.js';
+/**
+ * Reads the theme `delabienbonnemusique.tumblr.com` has been frozen on since 2019.
+ *
+ * Every post is one track: a line of text in `.copy`, an embed in `.media` when the video
+ * still exists, and sometimes a `.copy.source` link. That line is kept whole and never
+ * taken apart — fifteen years of posts were not written to one format, and an artist
+ * guessed from a dash is worse than the line itself. Class names are what this reads,
+ * which is what a per-blog parser is for; the generic pass is the one that may not rely on
+ * them.
+ *
+ * What the years make fragile is the source: a YouTube or Dailymotion embed that may well
+ * be dead by now, a Spotify link, a Grooveshark one on the oldest posts. Every URL found
+ * in the embed or the body is kept, in the order it appeared, plus the embed's own title —
+ * which on a deleted video is the last trace of what it was.
+ *
+ * The date is the only one this blog has: the theme writes it in the `title` of its
+ * `.date` link, and the sitemap's `lastmod` is a 2023 bulk re-touch that says nothing
+ * about publication. It carries no timezone, so it is read as UTC and the label itself is
+ * kept in `detail.publishedLabel` for whoever needs to argue about the hour.
+ */
+export declare const parser: TumblrBlogParser;