hazo_blog 1.4.0 → 2.0.0

package/dist/lib/mdx_mask.js

@@ -0,0 +1,165 @@
+// hazo_blog — MDX masking for the LLM translation round trip
+// (`service/index.ts#translatePost()`). Built on `hazo_i18n/html`'s
+// `maskHtml`/`unmaskHtml` (the same tag-masking primitives hazo_i18n's own
+// export/import/translate pipeline uses for rich-text HTML values) plus a
+// thin MDX-specific layer on top: frontmatter set-aside and a pre-pass for
+// bare (attribute-less) capitalized JSX component tags.
+//
+// ── Frontmatter ──────────────────────────────────────────────────────────────
+// `BlogPost.content` (`src/types/index.ts`) is documented as "raw MDX" and is
+// built exclusively by `service#upsertBySlug()`/`createTranslation()` from a
+// plain MDX body — title/excerpt/meta fields live in their own DB columns,
+// never folded into a `---\n...\n---` frontmatter block anywhere in this
+// package. So frontmatter extraction here is defensive, not load-bearing: if
+// `content` ever does start with a `---` block (e.g. content authored/pasted
+// elsewhere before being saved through this package), it's still set aside
+// untouched rather than risk the LLM mangling YAML syntax it was never asked
+// about.
+//
+// ── Why capitalized JSX tags need their own pass ────────────────────────────
+// `hazo_i18n`'s `maskHtml()` only masks tags that carry attributes (its own
+// doc: "only tags that carry attributes are masked... masking every tag
+// would turn long-form content into an unreadable wall of placeholders").
+// That heuristic is right for plain HTML, where an attribute-less tag like
+// `<p>` or `<strong>` is always a plain structural tag. It is WRONG for MDX,
+// where a bare `<Callout>` (no attrs) is a React component exactly as
+// fragile to translate around as `<Callout type="info">` — an LLM "helpfully"
+// paraphrasing or re-casing the tag name breaks the render. So this module
+// pre-masks every capitalized-tag-name JSX tag (self-closing or paired,
+// attributed or not) to its own placeholder space (`<j1>`/`<j2>`/...) BEFORE
+// handing the remainder to `maskHtml()`, which still runs its own pass over
+// whatever capitalized tags (now placeholders, ignored) and attributed plain
+// HTML tags (e.g. a stray `<a href="...">` inside MDX body text) remain.
+//
+// Any component name is accepted generically (`[A-Z][A-Za-z0-9]*`) — this
+// package can't know the host's `config.mdxComponents` additions in advance
+// (`defaultMdxComponents` ships `YouTube`/`Callout`/`BlogImage`, but a host
+// like gotimer can register more), so we mask by naming convention (JSX
+// components are always capitalized; HTML tags never are), not by an
+// enumerated component list.
+//
+// ── Why `hazo_i18n/html` is imported LAZILY, not statically ─────────────────
+// `hazo_i18n` is an OPTIONAL peer of this package (`package.json`'s
+// `peerDependenciesMeta`) — most hosts don't install it. This file is reached
+// from `service/index.ts`'s top-level imports (every consumer pulls in
+// `createBlogService`, not just ones using `translatePost()`), so a static
+// `import ... from "hazo_i18n/html"` here would turn an optional peer into a
+// hard runtime dependency for EVERY consumer, breaking the package for
+// anyone who doesn't have `hazo_i18n` installed and never calls
+// `translatePost()` in the first place. `optional_import()` (the same
+// `hazo_core` helper `service/index.ts#requireLlmApi()` uses for the
+// `hazo_llm_api` peer) resolves it lazily, only when `maskMdx()`/
+// `unmaskMdx()` are actually called, and throws the same `HazoUnavailableError`
+// 503 convention when it isn't installed.
+import { HazoUnavailableError, optional_import } from "hazo_core";
+async function requireHazoI18nHtml(fnName) {
+    const mod = await optional_import("hazo_i18n/html");
+    if (!mod) {
+        throw new HazoUnavailableError({
+            code: "HAZO_BLOG_MDX_MASK_UNAVAILABLE",
+            pkg: "hazo_blog",
+            message: `${fnName}() requires the hazo_i18n optional peer (its "./html" subpath) — it is not installed.`,
+        });
+    }
+    return mod;
+}
+const FRONTMATTER_PATTERN = /^---\n[\s\S]*?\n---\n?/;
+/** Matches a capitalized JSX tag: `<Name ...>`, `<Name/>`, `<Name>`, `</Name>`. */
+const JSX_TAG_PATTERN = /<(\/)?([A-Z][A-Za-z0-9]*)\b([^>]*?)(\/)?>/g;
+/**
+ * Masks every capitalized JSX component tag in `text` (attributed or bare),
+ * giving each open/close pair the same placeholder number (`<jN>`/`</jN>`,
+ * self-closing `<jN/>`). Mirrors `maskHtml()`'s own stack-based pairing
+ * algorithm (`hazo_i18n/src/lib/html_mask.ts`) but keyed on capitalization
+ * instead of attribute presence, and in its own `jN` placeholder namespace so
+ * it can never collide with `maskHtml()`'s own `xN` placeholders when both
+ * passes run over the same text.
+ */
+function maskJsxComponents(text) {
+    const map = {};
+    let counter = 0;
+    let result = "";
+    let lastIndex = 0;
+    const stack = [];
+    const pattern = new RegExp(JSX_TAG_PATTERN.source, "g");
+    for (const match of text.matchAll(pattern)) {
+        const [full, closingSlash, name, , selfClosingSlash] = match;
+        const index = match.index ?? 0;
+        result += text.slice(lastIndex, index);
+        lastIndex = index + full.length;
+        if (closingSlash === "/") {
+            const top = stack[stack.length - 1];
+            if (top && top.name === name) {
+                stack.pop();
+                map[top.maskName].close = full;
+                result += `</${top.maskName}>`;
+            }
+            else {
+                // Unbalanced/mismatched closing tag — leave untouched rather than
+                // guess at a pairing (same defensive fallback as `maskHtml()`).
+                result += full;
+            }
+            continue;
+        }
+        counter += 1;
+        const placeholder = `j${counter}`;
+        if (selfClosingSlash === "/") {
+            map[placeholder] = { open: full, close: "" };
+            result += `<${placeholder}/>`;
+            continue;
+        }
+        map[placeholder] = { open: full, close: "" };
+        stack.push({ name, maskName: placeholder });
+        result += `<${placeholder}>`;
+    }
+    result += text.slice(lastIndex);
+    return { masked: result, map };
+}
+const JSX_PLACEHOLDER_PATTERN = /<(\/?)j(\d+)(\/)?>/g;
+function unmaskJsxComponents(masked, map) {
+    const pattern = new RegExp(JSX_PLACEHOLDER_PATTERN.source, "g");
+    return masked.replace(pattern, (full, closingSlash, num, selfClosingSlash) => {
+        const entry = map[`j${num}`];
+        if (!entry)
+            return full;
+        if (selfClosingSlash === "/")
+            return entry.open;
+        if (closingSlash === "/")
+            return entry.close;
+        return entry.open;
+    });
+}
+/**
+ * Sets aside leading YAML frontmatter (if present — see this file's header,
+ * most posts have none), then masks every capitalized JSX component tag
+ * (`maskJsxComponents`, this file's own `jN` namespace) and finally every
+ * remaining attributed plain-HTML tag (`maskHtml()`'s `xN` namespace). The
+ * two placeholder maps are merged into one — the numeric prefixes (`j`/`x`)
+ * never collide, so a single `map` round-trips through `unmaskMdx()`.
+ */
+export async function maskMdx(content) {
+    const html = await requireHazoI18nHtml("maskMdx");
+    const frontmatterMatch = content.match(FRONTMATTER_PATTERN);
+    const frontmatter = frontmatterMatch ? frontmatterMatch[0] : null;
+    const body = frontmatter ? content.slice(frontmatter.length) : content;
+    const jsxPass = maskJsxComponents(body);
+    const htmlPass = html.maskHtml(jsxPass.masked);
+    return {
+        masked: htmlPass.masked,
+        frontmatter,
+        map: { ...jsxPass.map, ...htmlPass.map },
+    };
+}
+/**
+ * Exact inverse of `maskMdx()`: restores HTML tag placeholders, then JSX
+ * component placeholders, then re-prepends the frontmatter byte-for-byte.
+ * Order doesn't matter between the two unmask passes (disjoint placeholder
+ * namespaces), but running `unmaskHtml` first mirrors `maskMdx()`'s own
+ * "JSX pass, then HTML pass" order in reverse.
+ */
+export async function unmaskMdx(masked, frontmatter, map) {
+    const html = await requireHazoI18nHtml("unmaskMdx");
+    const afterHtml = html.unmaskHtml(masked, map);
+    const afterJsx = unmaskJsxComponents(afterHtml, map);
+    return frontmatter ? frontmatter + afterJsx : afterJsx;
+}

package/dist/lib/mdx_segment.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Groups masked MDX content's paragraphs into chunks of at most `maxChars`
+ * characters each, never splitting a paragraph across two chunks. A single
+ * paragraph longer than `maxChars` still gets its own (oversized) chunk —
+ * same "never split a unit" rule `chunkRowsByLimits()` applies to an
+ * oversized row.
+ *
+ * Chunks are rejoined with `"\n\n"` so each chunk is itself valid
+ * Markdown/MDX (paragraphs separated by exactly one blank line), independent
+ * of whatever exact whitespace separated them in the source (1 blank line vs.
+ * 2+ — intentionally normalized; MDX treats any run of blank lines as one
+ * paragraph break).
+ */
+export declare function segmentMdxForTranslation(content: string, maxChars?: number): string[];
+//# sourceMappingURL=mdx_segment.d.ts.map

package/dist/lib/mdx_segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx_segment.d.ts","sourceRoot":"","sources":["../../src/lib/mdx_segment.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,EAAE,CAqBnF"}

package/dist/lib/mdx_segment.js

@@ -0,0 +1,56 @@
+// hazo_blog — MDX segmentation for the LLM translation round trip
+// (`service/index.ts#translatePost()`). Splits MASKED MDX content (see
+// `mdx_mask.ts`) into LLM-call-sized chunks, never splitting a paragraph
+// across two chunks.
+//
+// Mirrors the character-budget reasoning `hazo_i18n/src/lib/export.ts`'s
+// `chunkRowsByLimits()` uses for its own `chunkMaxChars` limit: group
+// consecutive units up to a character budget, and a single unit that alone
+// exceeds the budget still gets its own chunk rather than being split
+// mid-unit (there, a "unit" is one message row; here, one paragraph block).
+// Not literally reused — different package, different unit shape — but the
+// same "character budget, never split a unit" philosophy.
+/**
+ * Splits `content` into blank-line-separated paragraph blocks (the
+ * conventional Markdown/MDX paragraph boundary — one or more blank lines),
+ * preserving each block's internal newlines (a multi-line list or a fenced
+ * code block stays one block, since it contains no blank line itself).
+ */
+function splitIntoParagraphs(content) {
+    // Split on 1+ blank lines (any whitespace-only line counts as blank).
+    return content.split(/\n[ \t]*\n+/).filter((block) => block.trim().length > 0);
+}
+/**
+ * Groups masked MDX content's paragraphs into chunks of at most `maxChars`
+ * characters each, never splitting a paragraph across two chunks. A single
+ * paragraph longer than `maxChars` still gets its own (oversized) chunk —
+ * same "never split a unit" rule `chunkRowsByLimits()` applies to an
+ * oversized row.
+ *
+ * Chunks are rejoined with `"\n\n"` so each chunk is itself valid
+ * Markdown/MDX (paragraphs separated by exactly one blank line), independent
+ * of whatever exact whitespace separated them in the source (1 blank line vs.
+ * 2+ — intentionally normalized; MDX treats any run of blank lines as one
+ * paragraph break).
+ */
+export function segmentMdxForTranslation(content, maxChars = 2000) {
+    const paragraphs = splitIntoParagraphs(content);
+    if (paragraphs.length === 0)
+        return [];
+    const chunks = [];
+    let current = [];
+    let currentChars = 0;
+    for (const paragraph of paragraphs) {
+        const paragraphChars = paragraph.length;
+        if (current.length > 0 && currentChars + 2 + paragraphChars > maxChars) {
+            chunks.push(current.join("\n\n"));
+            current = [];
+            currentChars = 0;
+        }
+        current.push(paragraph);
+        currentChars += (current.length > 1 ? 2 : 0) + paragraphChars;
+    }
+    if (current.length > 0)
+        chunks.push(current.join("\n\n"));
+    return chunks;
+}

package/dist/locales/de.json

@@ -68,6 +68,7 @@
     "blog_admin_panel.preview": "Vorschau",
     "blog_admin_panel.delete_confirm": "„{{title}}“ löschen? Dies kann nicht rückgängig gemacht werden.",
     "blog_admin_panel.delete_failed": "Löschen fehlgeschlagen",
+    "blog_admin_panel.locale_filter_label": "Sprache",
     "post_list_table.search_placeholder": "Titel oder Slug suchen…",
     "post_list_table.filter_all": "Alle",
     "post_list_table.filter_draft": "Entwurf",
@@ -81,6 +82,9 @@
     "post_list_table.untitled": "(ohne Titel)",
     "post_list_table.edit": "Bearbeiten",
     "post_list_table.delete": "Löschen",
+    "post_list_table.col_locale": "Sprache",
+    "post_list_table.translate_to": "Übersetzen nach…",
+    "post_list_table.translate_failed": "Übersetzung fehlgeschlagen",
     "layout_selector.not_persisted_notice": "Einstellungstabelle nicht migriert – Layout ist schreibgeschützt.",
     "layout_selector.save_failed": "Layout konnte nicht gespeichert werden",
     "layout_selector.saving": "Speichern…",

package/dist/locales/en.json

@@ -68,6 +68,7 @@
     "blog_admin_panel.preview": "Preview",
     "blog_admin_panel.delete_confirm": "Delete \"{{title}}\"? This cannot be undone.",
     "blog_admin_panel.delete_failed": "Delete failed",
+    "blog_admin_panel.locale_filter_label": "Locale",
     "post_list_table.search_placeholder": "Search title or slug…",
     "post_list_table.filter_all": "All",
     "post_list_table.filter_draft": "Draft",
@@ -81,6 +82,9 @@
     "post_list_table.untitled": "(untitled)",
     "post_list_table.edit": "Edit",
     "post_list_table.delete": "Delete",
+    "post_list_table.col_locale": "Locale",
+    "post_list_table.translate_to": "Translate to…",
+    "post_list_table.translate_failed": "Translation failed",
     "layout_selector.not_persisted_notice": "Settings table not migrated — layout is read-only.",
     "layout_selector.save_failed": "Failed to save layout",
     "layout_selector.saving": "Saving…",

package/dist/locales/sv.json

@@ -68,6 +68,7 @@
     "blog_admin_panel.preview": "Förhandsgranska",
     "blog_admin_panel.delete_confirm": "Ta bort “{{title}}”? Det går inte att ångra.",
     "blog_admin_panel.delete_failed": "Borttagningen misslyckades",
+    "blog_admin_panel.locale_filter_label": "Språk",
     "post_list_table.search_placeholder": "Sök på titel eller slug…",
     "post_list_table.filter_all": "Alla",
     "post_list_table.filter_draft": "Utkast",
@@ -81,6 +82,9 @@
     "post_list_table.untitled": "(namnlös)",
     "post_list_table.edit": "Redigera",
     "post_list_table.delete": "Ta bort",
+    "post_list_table.col_locale": "Språk",
+    "post_list_table.translate_to": "Översätt till…",
+    "post_list_table.translate_failed": "Översättningen misslyckades",
     "layout_selector.not_persisted_notice": "Inställningstabellen är inte migrerad – layouten är skrivskyddad.",
     "layout_selector.save_failed": "Det gick inte att spara layouten",
     "layout_selector.saving": "Sparar…",

package/dist/next/pages.d.ts

@@ -22,6 +22,7 @@ export declare function createBlogPostPage(rawConfig: BlogConfig): {
     }) => Promise<Metadata>;
     generateStaticParams: () => Promise<{
         slug: string;
+        locale: string;
     }[]>;
     revalidate: number;
     dynamicParams: boolean;

package/dist/next/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAI3E,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAexC,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU;2BAsDnD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxF;oCAzCE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxF,KAAG,OAAO,CAAC,QAAQ,CAAC;;;;;;EAyEtB;AAED,+BAA+B;AAC/B,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,UAAU;iCAepD;QACD,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzE;4BAZkC,OAAO,CAAC,QAAQ,CAAC;;EAsDrD;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU;2BAOlD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD;oCAuBE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,KAAG,OAAO,CAAC,QAAQ,CAAC;;EAStB;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,UAAU;;EA0E5D;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,UAAU;;EAqB3D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,UAAU;2BAOxD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACtD;EAwBF"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAI3E,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAexC,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU;2BAyDnD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxF;oCAzCE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxF,KAAG,OAAO,CAAC,QAAQ,CAAC;;;;;;;EAyEtB;AAED,+BAA+B;AAC/B,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,UAAU;iCAepD;QACD,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzE;4BAZkC,OAAO,CAAC,QAAQ,CAAC;;EAsDrD;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU;2BAOlD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD;oCAuBE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,KAAG,OAAO,CAAC,QAAQ,CAAC;;EAStB;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,UAAU;;EA0E5D;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,UAAU;;EAqB3D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,UAAU;2BAOxD;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACtD;EAwBF"}

package/dist/next/pages.js

@@ -43,11 +43,14 @@ export function createBlogPostPage(rawConfig) {
     const service = createBlogService(config);
     const t = blogTranslator(config.uiLocale);
     async function generateStaticParams() {
-        // Default-locale slugs only — getAllSlugs() with no locale filter returns
-        // every translation variant too, which would generate duplicate static
-        // routes for the same `slug` segment under different locales.
+        // Every locale variant's slug — the route this is designed for expects
+        // BOTH `slug` and `locale` segments (see Page/generateMetadata below,
+        // which destructure both from `params`), so default-locale rows (where
+        // `locale` is null in the DB) are given the configured default locale
+        // string here rather than being dropped.
+        const defaultLocale = config.defaultLocale || "en";
         const slugs = await service.getAllSlugs(false);
-        return slugs.filter((s) => !s.locale).map(({ slug }) => ({ slug }));
+        return slugs.map((s) => ({ slug: s.slug, locale: s.locale ?? defaultLocale }));
     }
     async function generateMetadata({ params, }) {
         const { slug, locale } = params instanceof Promise ? await params : params;
@@ -62,7 +65,7 @@ export function createBlogPostPage(rawConfig) {
         const languages = translations
             .filter((tr) => tr.indexable !== false)
             .reduce((acc, tr) => {
-            acc[tr.locale] = postUrl(config, tr.slug);
+            acc[tr.locale] = postUrl(config, tr.slug, tr.locale);
             return acc;
         }, {});
         return {

package/dist/next/routes.d.ts

@@ -52,6 +52,12 @@ export declare function createBlogAdminRoutes(config: BlogConfig): {
         POST(req: Request): Promise<Response>;
     };
     item: {
+        /**
+         * Create a draft translation of this post ("Translate to...") — body
+         * `{ locale: string }`. Mirrors the PUT/DELETE pattern below: mounted on
+         * the same `[id]` route, one more HTTP method on the same resource.
+         */
+        POST(req: Request, ctx?: RouteCtx): Promise<Response>;
         PUT(req: Request, ctx?: RouteCtx): Promise<Response>;
         DELETE(req: Request, ctx?: RouteCtx): Promise<Response>;
     };
@@ -66,5 +72,32 @@ export declare function createBlogSettingsRoutes(config: BlogConfig): {
     GET: (req: Request) => Promise<Response>;
     PUT: (req: Request) => Promise<Response>;
 };
+/**
+ * Translate an EXISTING translation-cluster draft's content (cookie/session,
+ * guarded by config.authorize). Mounted on its own `[id]/translate` resource
+ * rather than another method on the `[id]` route, since that route's `POST`
+ * is already `createTranslation` (Phase 4B's "Translate to..." — creates the
+ * draft row); this one fills an existing draft in.
+ *
+ *   POST — `service.translatePost(id, req)`. 503 `SERVICE_UNAVAILABLE` if the
+ *   `hazo_llm_api` optional peer isn't installed; 400 `VALIDATION_FAILED` for
+ *   any other failure (unknown id, missing `translation_of`/source).
+ */
+export declare function createBlogTranslateRoutes(config: BlogConfig): {
+    POST: (req: Request, ctx?: RouteCtx) => Promise<Response>;
+};
+/**
+ * AI quality-review a translated post against its source (cookie/session,
+ * guarded by config.authorize). Mounted on its own `[id]/review` resource
+ * for the same reason `createBlogTranslateRoutes` gets its own —
+ * `[id]`'s `POST`/`PUT`/`DELETE` are already spoken for.
+ *
+ *   POST — `service.reviewTranslatedPost(id, req)`. 503
+ *   `SERVICE_UNAVAILABLE` if the `hazo_llm_api` optional peer isn't
+ *   installed; 400 `VALIDATION_FAILED` for any other failure.
+ */
+export declare function createBlogReviewRoutes(config: BlogConfig): {
+    POST: (req: Request, ctx?: RouteCtx) => Promise<Response>;
+};
 export {};
 //# sourceMappingURL=routes.d.ts.map

package/dist/next/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/next/routes.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAErE,KAAK,QAAQ,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAYjG;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAK9F;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,IAE5B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAS3D;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,IAE1B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAO3D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,IAE7B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU;;;;EAuDxD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU;;;;EA4D5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU;;iBAKrC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;kBAS1B,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;;iBAe5B,OAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;oBAaxC,OAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;;EAWhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU;eAIjC,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;eAe3B,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAsBpD"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/next/routes.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAErE,KAAK,QAAQ,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAYjG;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAK9F;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,IAE5B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAS3D;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,IAE1B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAO3D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,IAE7B,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU;;;;EAuDxD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU;;;;EA4D5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU;;iBAKrC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;kBAuB1B,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;;QAe3C;;;;WAIG;kBACa,OAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;iBAmB5C,OAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;oBAaxC,OAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;;EAWhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU;eAIjC,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;eAe3B,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAsBpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU;gBAIjC,OAAO,QAAQ,QAAQ,KAAG,OAAO,CAAC,QAAQ,CAAC;EAkBrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU;gBAI9B,OAAO,QAAQ,QAAQ,KAAG,OAAO,CAAC,QAAQ,CAAC;EAkBrE"}

package/dist/next/routes.js

@@ -3,6 +3,7 @@
 //   Admin (cookie/session) routes are guarded by config.authorize.
 //   Management (programmatic) routes use hazo_api API keys + envelopes.
 //   Search / RSS / sitemap are public.
+import { HazoUnavailableError } from "hazo_core";
 import { ok, fail, withApiKey, createApiKeyService } from "hazo_api";
 import { createBlogService, BlogSettingsUnavailableError } from "../service/index.js";
 import { getBlogRssXml, getBlogSitemapEntries } from "../seo/index.js";
@@ -195,11 +196,25 @@ export function createBlogAdminRoutes(config) {
             const denied = await guard(req);
             if (denied)
                 return denied;
-            const [{ posts, total }, categories] = await Promise.all([
-                service.listPosts({ perPage: 1000, includeUnpublished: true }, req),
+            const url = new URL(req.url);
+            // Omitted => `listPosts`' own default (default-locale posts only),
+            // matching `ListPostsOptions.locale`'s existing semantics.
+            const locale = url.searchParams.get("locale") || undefined;
+            const [{ posts, total }, categories, allSlugs] = await Promise.all([
+                service.listPosts({ perPage: 1000, includeUnpublished: true, locale }, req),
                 service.repository(req).then((repo) => repo.listCategories()),
+                // Reuses the existing un-filtered slug lookup (already built for
+                // generateStaticParams) to derive the set of locales actually in use,
+                // rather than adding a new DB query — this package has no
+                // `enabledLocales` config field today.
+                service.getAllSlugs(true, req),
             ]);
-            return ok({ posts, total, categories });
+            const defaultLocale = service.config.defaultLocale || "en";
+            const locales = [
+                defaultLocale,
+                ...new Set(allSlugs.map((s) => s.locale).filter((l) => !!l)),
+            ].filter((l, i, arr) => arr.indexOf(l) === i);
+            return ok({ posts, total, categories, locales });
         },
         async POST(req) {
             const denied = await guard(req);
@@ -217,6 +232,34 @@ export function createBlogAdminRoutes(config) {
         },
     };
     const item = {
+        /**
+         * Create a draft translation of this post ("Translate to...") — body
+         * `{ locale: string }`. Mirrors the PUT/DELETE pattern below: mounted on
+         * the same `[id]` route, one more HTTP method on the same resource.
+         */
+        async POST(req, ctx) {
+            const denied = await guard(req);
+            if (denied)
+                return denied;
+            const { id } = await readParams(ctx);
+            let body;
+            try {
+                body = (await req.json());
+            }
+            catch {
+                return fail("VALIDATION_FAILED", "Invalid JSON body");
+            }
+            if (!body?.locale)
+                return fail("VALIDATION_FAILED", "locale is required");
+            try {
+                const saved = await service.createTranslation(id, body.locale, req);
+                return ok({ post: saved }, { status: 201 });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail("NOT_FOUND", message);
+            }
+        },
         async PUT(req, ctx) {
             const denied = await guard(req);
             if (denied)
@@ -294,3 +337,72 @@ export function createBlogSettingsRoutes(config) {
     }
     return { GET, PUT };
 }
+/**
+ * Translate an EXISTING translation-cluster draft's content (cookie/session,
+ * guarded by config.authorize). Mounted on its own `[id]/translate` resource
+ * rather than another method on the `[id]` route, since that route's `POST`
+ * is already `createTranslation` (Phase 4B's "Translate to..." — creates the
+ * draft row); this one fills an existing draft in.
+ *
+ *   POST — `service.translatePost(id, req)`. 503 `SERVICE_UNAVAILABLE` if the
+ *   `hazo_llm_api` optional peer isn't installed; 400 `VALIDATION_FAILED` for
+ *   any other failure (unknown id, missing `translation_of`/source).
+ */
+export function createBlogTranslateRoutes(config) {
+    const service = createBlogService(config);
+    const guard = createAuthGuard(config);
+    async function POST(req, ctx) {
+        const denied = await guard(req);
+        if (denied)
+            return denied;
+        const { id } = await readParams(ctx);
+        if (!id)
+            return fail("VALIDATION_FAILED", "id is required");
+        try {
+            const result = await service.translatePost(id, req);
+            return ok(result);
+        }
+        catch (err) {
+            if (err instanceof HazoUnavailableError) {
+                return fail("SERVICE_UNAVAILABLE", err.message, { status: 503 });
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return fail("VALIDATION_FAILED", message, { status: 400 });
+        }
+    }
+    return { POST };
+}
+/**
+ * AI quality-review a translated post against its source (cookie/session,
+ * guarded by config.authorize). Mounted on its own `[id]/review` resource
+ * for the same reason `createBlogTranslateRoutes` gets its own —
+ * `[id]`'s `POST`/`PUT`/`DELETE` are already spoken for.
+ *
+ *   POST — `service.reviewTranslatedPost(id, req)`. 503
+ *   `SERVICE_UNAVAILABLE` if the `hazo_llm_api` optional peer isn't
+ *   installed; 400 `VALIDATION_FAILED` for any other failure.
+ */
+export function createBlogReviewRoutes(config) {
+    const service = createBlogService(config);
+    const guard = createAuthGuard(config);
+    async function POST(req, ctx) {
+        const denied = await guard(req);
+        if (denied)
+            return denied;
+        const { id } = await readParams(ctx);
+        if (!id)
+            return fail("VALIDATION_FAILED", "id is required");
+        try {
+            const result = await service.reviewTranslatedPost(id, req);
+            return ok(result);
+        }
+        catch (err) {
+            if (err instanceof HazoUnavailableError) {
+                return fail("SERVICE_UNAVAILABLE", err.message, { status: 503 });
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return fail("VALIDATION_FAILED", message, { status: 400 });
+        }
+    }
+    return { POST };
+}

package/dist/repository/index.d.ts

@@ -25,6 +25,8 @@ export interface BlogRepository {
         includeUnpublished?: boolean;
         locale?: string | null;
     }): Promise<BlogPostWithRelations | null>;
+    /** Fetch a single post by id, regardless of status/locale. Null if not found. */
+    getPostById(id: string): Promise<BlogPostWithRelations | null>;
     /** Returns every locale variant's slug — NOT filtered to the default locale. */
     getAllSlugs(includeUnpublished?: boolean): Promise<Array<{
         slug: string;

package/dist/repository/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,OAAO,EAEP,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAmB3B,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF;;;OAGG;IACH,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC9D,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACzC,iFAAiF;IACjF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAC/D,gFAAgF;IAChF,WAAW,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACnG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1C,mBAAmB,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpG,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC/F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC7F;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5D,oGAAoG;IACpG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,kGAAkG;IAClG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,wFAAwF;IACxF,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AA0BD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CAsbhB"}

package/dist/repository/index.js

@@ -171,6 +171,19 @@ export function createBlogRepository(adapter, options = {}) {
             const [hydrated] = await hydrate([row]);
             return hydrated ?? null;
         },
+        async getPostById(id) {
+            // Not findById: findById has no scope predicate, which would let one
+            // tenant fetch (and, via the translate/review flow, mutate) another
+            // tenant's post by guessing its id.
+            const rows = await posts.list(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (qb) => scoped(qb).where("id", "eq", id).limit(1));
+            const row = rows[0] ?? null;
+            if (!row)
+                return null;
+            const [hydrated] = await hydrate([row]);
+            return hydrated ?? null;
+        },
         async getAllSlugs(includeUnpublished = false) {
             // Deliberately NOT locale-filtered — every locale variant's slug is
             // returned (e.g. for generateStaticParams to build every translation).

package/dist/seo/index.d.ts

@@ -1,6 +1,14 @@
 import type { AuthorInfo, BlogPostWithRelations, ResolvedBlogConfig } from "../types/index.js";
-/** Absolute URL for a post. */
-export declare function postUrl(config: ResolvedBlogConfig, slug: string): string;
+/**
+ * Absolute URL for a post. `locale` omitted, `null`, or equal to
+ * `config.defaultLocale` ("en" when unset) produces the same URL as before
+ * this parameter existed — no prefix. Any other locale gets a `/${locale}`
+ * segment prepended BEFORE the blog's own `basePath`, matching gotimer's own
+ * `/[locale]/<slug>` routing convention (locale segment first, default
+ * locale unprefixed) so a locale-aware host doesn't have to special-case
+ * blog URLs: `https://site.com/de/blog/my-slug`, not `/blog/de/my-slug`.
+ */
+export declare function postUrl(config: ResolvedBlogConfig, slug: string, locale?: string | null): string;
 /** Absolute URL for the blog index. */
 export declare function indexUrl(config: ResolvedBlogConfig): string;
 /** Absolute URL for a tag page. */

package/dist/seo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAS3B,+BAA+B;AAC/B,wBAAgB,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAE3D;AAED,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5F;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE1F;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAKhE;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,UAAU,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EACX,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,EAAE,GAC7B,YAAY,EAAE,CAqBhB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAM1E;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CA6CR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAS3B;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAMR;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAE3D;AAED,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5F;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE1F;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAKhE;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,UAAU,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EACX,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,EAAE,GAC7B,YAAY,EAAE,CAqBhB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAM1E;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CA6CR"}