hazo_blog 1.3.0 → 1.6.0

package/CHANGE_LOG.md

@@ -3,6 +3,172 @@
 All notable changes are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## 1.6.0 — 2026-10-09
+
+**Blog translation, Phase 4C: AI translate + AI review of translation-cluster drafts**
+
+Takes a Phase 4B draft (created via `createTranslation()`, content copied verbatim,
+untranslated) and fills it in — plus an independent quality-review pass. Both are new
+`BlogService` methods over the `hazo_llm_api` optional peer, mirroring `hazo_i18n`'s own
+`api/translate.ts`/`api/review.ts` shape and philosophy exactly (lazy `optional_import()`
+probe, local re-declared module-shape interface, per-call `HazoUnavailableError` 503,
+per-chunk graceful degradation).
+
+- **`src/lib/mdx_mask.ts`** — `maskMdx()`/`unmaskMdx()`. Sets aside leading YAML frontmatter
+  (defensive only — `BlogPost.content` is pure MDX body today, title/excerpt/meta live in
+  their own columns, so no post in this schema actually has frontmatter), masks every
+  capitalized JSX component tag (`<Callout>`, `<YouTube id="..."/>`, ANY `[A-Z]...` tag name —
+  not an enumerated list, since a host's `config.mdxComponents` can add more) into its own
+  `jN` placeholder namespace, then delegates the remainder to `hazo_i18n/html`'s
+  `maskHtml()`/`unmaskHtml()` (`xN` namespace) for plain attributed HTML tags. The JSX pass
+  exists because `maskHtml()` only masks tags that carry attributes — right for plain HTML,
+  wrong for MDX, where a bare `<Callout>` (no attrs) is exactly as fragile to translate
+  around as an attributed one. **`hazo_i18n/html` is resolved LAZILY** (`optional_import`,
+  same convention as the `hazo_llm_api` peer below) — a static import here would turn
+  `hazo_i18n` (an optional peer) into a hard dependency for every consumer of this package,
+  not just ones calling `translatePost()`. For the same reason this module is NOT re-exported
+  through the general `./lib` barrel.
+- **`src/lib/mdx_segment.ts`** — `segmentMdxForTranslation(content, maxChars = 2000)`. Splits
+  masked MDX at paragraph (blank-line) boundaries into LLM-call-sized chunks, grouping
+  consecutive paragraphs up to the budget; a single oversized paragraph still gets its own
+  chunk rather than being split mid-paragraph.
+- **`BlogService.translatePost(postId)`** — `postId` is an EXISTING translation-cluster
+  DRAFT's own id (not a new `targetLocale` parameter): its `translation_of` is read to find
+  the source post, and its own `locale` is the target — a deliberate refinement of the
+  original plan now that `createTranslation()` already owns "create the row". Masks the
+  source content, segments it, translates each segment sequentially with its own
+  `hazo_llm_text_text()` call (plain-text response — "return ONLY the translated text, no
+  commentary" — not JSON; there's nothing to extract-as-JSON for free-form prose, unlike
+  `hazo_i18n`'s key-value chunks), then the title with one more call. One segment's failure
+  never aborts the others, but if ANY segment (or the title) fails, nothing is written — a
+  partially translated MDX post going live is worse than failing the whole call. Never
+  changes `status` (stays `'draft'`).
+- **`BlogService.reviewTranslatedPost(postId)`** — one LLM call (not chunked; a blog post
+  comfortably fits one call) judging accuracy/naturalness/completeness/MDX-preservation
+  against the source, requesting structured `{ ok, notes }` JSON (parsed via
+  `try_extract_json()`, since a free-text verdict would need re-parsing anyway). Persists
+  `notes` to the post's new `review_notes` column on success; a failed review call leaves
+  `review_notes` untouched (`persisted: false`) rather than overwriting it with an error.
+  Never flips `status` — unlike `hazo_i18n`'s `reviewMessages()`, a human editor decides what
+  to do with the notes via the existing admin UI.
+- **`hazo_blog_posts.review_notes TEXT`** (nullable) — new column, both `db_setup_sqlite.sql`
+  and `db_setup_postgres.sql` (+ their `migrations/` mirrors). `excerpt` was deliberately NOT
+  repurposed — it's an actively-used teaser/meta-description field.
+- **New routes** (`src/next/routes.ts`, exported from the package root): `createBlogTranslateRoutes`
+  (`[id]/translate`, `POST` → `translatePost`) and `createBlogReviewRoutes` (`[id]/review`,
+  `POST` → `reviewTranslatedPost`) — mounted on their own resources rather than another method
+  on `[id]`, since that route's `POST`/`PUT`/`DELETE` are already spoken for (Phase 4B's
+  `createTranslation`, plus upsert/delete). Same cookie/session `config.authorize` guard, same
+  `HazoUnavailableError` → 503 convention as everywhere else in this file.
+- **`hazo_llm_api` is now a declared OPTIONAL peer** (`peerDependenciesMeta`), same convention
+  as `hazo_i18n`. **`hazo_i18n`'s declared range bumped `^0.9.0` → `^0.12.0`** — its new `./html`
+  subpath (this phase's `maskHtml`/`unmaskHtml` reuse) only exists from 0.12.0. Note: this
+  workspace's own `node_modules/hazo_i18n` held a STALE real copy (0.5.9 — not even satisfying
+  the old `^0.9.0` range) that shadowed the correctly-hoisted 0.12.0 at the monorepo root;
+  removed so resolution falls through to the hoisted copy. A fresh `npm install` anywhere this
+  stale-copy situation doesn't already exist should resolve cleanly against the declared range.
+
+## 1.5.0 — 2026-10-09
+
+**Blog translation, Phase 4B: locale-aware post URLs + static params + admin "Translate to..."**
+
+Closes three gaps left over from 1.4.0's locale infrastructure (locale columns, `translation_of`,
+locale-filtered repository reads, `getTranslations`) — URLs, static generation, and the admin UI
+never actually used any of it.
+
+- **`postUrl(config, slug, locale?)`** (`src/seo/index.ts`) gained an optional third parameter.
+  Omitted, `null`, or equal to `config.defaultLocale` (`"en"` when unset): byte-identical output
+  to before this parameter existed — no prefix, fully backward compatible. Any other locale gets
+  a `/${locale}` segment prepended **before** `basePath`: `https://site.com/de/blog/my-slug`, not
+  `/blog/de/my-slug` — matching gotimer's own `/[locale]/<slug>` convention (locale segment
+  first, default locale unprefixed) so a locale-aware host's `generateStaticParams`/routing
+  doesn't have to special-case blog URLs. `canonicalFor` now threads the post's own `locale`
+  through (a translated post's canonical was previously default-locale-shaped), and the sitemap's
+  per-post URL and hreflang `alternates` do the same.
+- **`createBlogPostPage(...).generateStaticParams`** now returns a `{ slug, locale }` entry for
+  **every** locale variant from `getAllSlugs(false)` — not just the default locale. Null-locale
+  (default) rows get `config.defaultLocale` (`"en"` fallback) filled in as their `locale` value,
+  matching `postUrl`'s own default-locale comparison. Previously only default-locale posts ever
+  got a static route; every translation 404'd until `dynamicParams` kicked in on-demand.
+- **Admin locale filter + "Translate to..."** (`BlogAdminPanel`, `PostListTable`,
+  `useBlogAdmin`, `createBlogAdminRoutes`):
+  - `collection.GET` now reads `?locale=` (same omitted-means-default-locale semantics as
+    `ListPostsOptions.locale`) and also returns a derived `locales: string[]` — every locale
+    currently in use, default locale first. No new DB query: reuses the existing
+    `getAllSlugs(true)` lookup (already built for `generateStaticParams`) rather than adding an
+    `enabledLocales` config field, since none exists today.
+  - New `BlogService.createTranslation(postId, targetLocale, req?)` + `BlogRepository.getPostById`
+    — creates a **draft** post in `targetLocale`, linked via `translation_of` to the source's
+    cluster root, with every content field (title/content/excerpt/meta/FAQ/tags/images) copied
+    **verbatim** from the source. Not a translation step — no LLM call; that's Phase 4C.
+  - New `item.POST` route (same `[id]` resource as the existing `PUT`/`DELETE`) wraps
+    `createTranslation`; body `{ locale: string }`.
+  - `BlogAdminPanel` gained a locale `<select>` filtering the post list (hidden when only one
+    locale is in use); `PostListTable` gained a Locale column and a per-row "Translate to…"
+    picker + button (hidden when `availableLocales` is empty). Both token-free Tailwind, per this
+    tree's isolation rule. New locale catalog keys (`post_list_table.col_locale`,
+    `post_list_table.translate_to`, `post_list_table.translate_failed`,
+    `blog_admin_panel.locale_filter_label`) in `en`/`de`/`sv`.
+- Out of scope (separate, later phases): gotimer's own hazo_blog 1.4.0 schema upgrade (4A) and
+  the LLM `translatePost`/`reviewTranslatedPost` pipeline (4C) — `createTranslation` deliberately
+  does a verbatim copy, not a translation.
+
+## 1.4.0 — 2026-10-06
+
+**Locale-aware UI text and dates (`en` / `de` / `sv`)**
+
+The package's own user-visible text was English-only, and `createPackageT` cannot serve a
+different locale (it bundles one English catalog and has no synchronous locale getter). This
+release adds a per-render translator and a `locale` prop without changing any default output.
+
+**New: `src/lib/i18n.ts`** — `blogTranslator(locale)` returns a `t()` bound to the matching
+catalog, with English fallback for missing keys or unshipped locales. Also `resolveBlogLocale`
+(`"de-AT"` → `de`, unknown → `en`), `pluralSuffix(locale, count)` (for the one plural-dependent
+key), `BLOG_LOCALES`. Exported from `hazo_blog/lib`.
+
+**New catalogs: `src/locales/de.json`, `src/locales/sv.json`** — same 105 keys as `en.json`
+(enforced by a test). `en.json` grew from 90 to 105 keys: toolbar labels (`post_form.embed_*`),
+status badges (`post_status.*`), and admin page chrome (`admin_pages.*`).
+
+- **de / sv values are first-pass drafts and need translation review.** Every value is a real
+  translation (no English placeholders), but none has been reviewed by a native speaker. Priority
+  review: admin-facing strings (`post_form.*`, `blog_admin_panel.*`, `featured_image_field.*`).
+- Pluralisation is handled by the caller via `pluralSuffix`: German "Ergebnis" + "se", Swedish
+  "resultat" is invariant.
+
+**`locale` prop (optional, default `"en"`)** on: `PostCard`, `FeaturedPostCard`,
+`EditorialPostCard`, `PostHero`, `BlogSearch`, `RelatedPosts`, `FaqSection`, `TableOfContents`,
+`AuthorBio`, `PostForm`, and `BlogIndexLayoutProps` (both `/blog` layouts). Components no longer
+import `createPackageT` for these strings. Explicit props (`title`, `placeholder`) still win over
+the locale default.
+
+**Dates: `formatPostDate(iso, style, locale)`** — the `en-US` hardcode in `post-card.tsx` and
+`post-hero.tsx` is gone; both now go through `formatPostDate`. Locale maps to `en-US`, `de-DE`,
+`sv-SE`. Omitted or unknown locales produce byte-identical English output (`"Jan 5, 2026"`).
+
+**`PostForm` toolbar labels** (`YT`, `Note`, `Img`) are now catalog keys. A custom `embeds` array
+still overrides the defaults entirely.
+
+**Sealed pages: `BlogConfig.uiLocale`** (optional, default `"en"`, resolved to the same key on
+`ResolvedBlogConfig`) drives chrome text and dates in `createBlogIndexPage`,
+`createBlogPostPage`, `createBlogTagPage`, and the admin list/new/edit pages. The admin pages'
+previously hardcoded English ("Blog posts", "+ New post", table headers, "Edit: …") are catalog
+keys. This is distinct from `defaultLocale`, which stays the content/JSON-LD locale.
+
+**Back-compat: zero break.** Every new prop and config field is optional, and the default output
+for every component is unchanged. `formatPostDate`'s new `locale` argument is last and optional.
+
+**Not yet locale-aware (still English-only, follow-up):** the `./ui` admin tree
+(`BlogAdminPanel`, `PostListTable`, `LayoutSelector`, `PostPreview`, `PanelDialog`),
+`FeaturedImageField`, the `YouTube` MDX embed, and `BlogContent`'s render-error text. These still
+use `createPackageT` and need the same treatment before a German admin is usable end to end.
+
+**Tests:** `src/__tests__/i18n.test.ts` (translator, catalog parity and placeholder integrity,
+plurals, date formatting per locale) and `src/__tests__/locale-components.test.ts`
+(react-dom/server render of the locale prop on FAQ, TOC, hero and card). New autotest cases in
+`test-app/app/autotest/hazo_blog_i18n_scenarios.ts` cover catalog parity and the locale-aware
+translator and dates.
+
 ## 1.3.0 — 2026-09-20
 
 **Migrated onto the canonical `hazo_core/i18n` bridge**

package/README.md

@@ -259,6 +259,17 @@ await repo.getPostBySlug(slug, { includeUnpublished: true });
 
 — and `getAllSlugs()` now returns `Array<{ slug, locale }>` instead of `string[]`. Existing single-locale data needs no migration: every current row's `locale` is `NULL` already, which *is* the default-locale bucket every existing query path reads from.
 
+## UI locale (chrome text and dates)
+
+Separate from the content locale above, the package's own UI text (headings, labels, empty states, admin pages, search placeholder) and date formatting follow a **UI locale**. Shipped catalogs: `en` (default), `de`, `sv` (`src/locales/*.json`, identical key sets). Any other value falls back to English text.
+
+- **Config:** `BlogConfig.uiLocale` (default `"en"`) drives the sealed page factories (`createBlogIndexPage`, `createBlogPostPage`, `createBlogTagPage`, admin pages). Build one factory per UI locale if your site serves several.
+- **Components:** the public presentational components accept an optional `locale` prop (default `"en"`): `PostCard`, `FeaturedPostCard`, `EditorialPostCard`, `PostHero`, `BlogSearch`, `RelatedPosts`, `FaqSection`, `TableOfContents`, `AuthorBio`, `PostForm` (toolbar labels included), and `BlogIndexLayoutProps.locale` for the `/blog` layouts.
+- **Dates:** `formatPostDate(iso, style, locale)` uses the locale's Intl conventions (`en-US`, `de-DE`, `sv-SE`).
+- **Translator:** `blogTranslator(locale)` (exported from `hazo_blog/lib`) returns a per-call `t()` bound to that catalog, with English fallback. `pluralSuffix(locale, count)` covers the one plural-dependent key.
+
+Not yet locale-aware (still English-only): the `./ui` admin panel tree (`BlogAdminPanel`, `PostListTable`, `LayoutSelector`, `PostPreview`, `PanelDialog`), `FeaturedImageField`, the MDX `YouTube` embed, and `BlogContent`'s error text.
+
 ## Layouts
 
 `config.defaultIndexLayout` (and the runtime override in [Settings](#settings))

package/db_setup_postgres.sql

@@ -64,6 +64,7 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   publish_date     TIMESTAMPTZ,
   locale           TEXT DEFAULT NULL,                 -- BCP-47 locale; NULL = default locale
   translation_of   UUID REFERENCES hazo_blog_posts(id) ON DELETE SET NULL, -- root post of this translation cluster
+  review_notes     TEXT,                              -- BlogService#reviewTranslatedPost()'s LLM notes (nullable; never flips status)
   indexable        BOOLEAN NOT NULL DEFAULT TRUE,     -- FALSE excludes from sitemap/robots
   created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
   updated_at       TIMESTAMPTZ NOT NULL DEFAULT NOW()
@@ -71,6 +72,7 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
 ALTER TABLE hazo_blog_posts ADD COLUMN IF NOT EXISTS locale TEXT DEFAULT NULL;
 ALTER TABLE hazo_blog_posts ADD COLUMN IF NOT EXISTS translation_of UUID REFERENCES hazo_blog_posts(id) ON DELETE SET NULL;
 ALTER TABLE hazo_blog_posts ADD COLUMN IF NOT EXISTS indexable BOOLEAN NOT NULL DEFAULT TRUE;
+ALTER TABLE hazo_blog_posts ADD COLUMN IF NOT EXISTS review_notes TEXT;
 -- FR-034: locale-aware uniqueness (see categories index comment above).
 DROP INDEX IF EXISTS idx_hazo_blog_posts_scope_slug;
 CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug_locale

package/db_setup_sqlite.sql

@@ -70,6 +70,7 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   publish_date     TEXT,
   locale           TEXT DEFAULT NULL,                 -- BCP-47 locale; NULL = default locale
   translation_of   TEXT REFERENCES hazo_blog_posts(id) ON DELETE SET NULL, -- root post of this translation cluster
+  review_notes     TEXT,                              -- BlogService#reviewTranslatedPost()'s LLM notes (nullable; never flips status)
   indexable        INTEGER NOT NULL DEFAULT 1,        -- 0/1; FALSE excludes from sitemap/robots
   created_at       TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at       TEXT NOT NULL DEFAULT (datetime('now'))

package/dist/components/admin/post-form.d.ts

@@ -8,8 +8,10 @@ export interface PostFormProps {
     endpoint?: string;
     /** Called after a successful save with the server response. */
     onSaved?: (result: unknown) => void;
-    /** MDX embeds offered in the editor toolbar (host can extend). */
+    /** MDX embeds offered in the editor toolbar (host can extend). Default: YouTube / Note / Image, labelled for `locale`. */
     embeds?: MarkdownEmbed[];
+    /** UI locale for user-visible text, toolbar labels and dates. Default "en". */
+    locale?: string;
     /**
      * Paste-to-upload handler wired to hazo_files by the host. Takes
      * precedence over `imageUploadEndpoint` when both are provided (back-compat
@@ -28,5 +30,5 @@ export interface PostFormProps {
     onCancel?: () => void;
     className?: string;
 }
-export declare function PostForm({ post, categories, endpoint, onSaved, embeds, onImageUpload, imageUploadEndpoint, fetchFn, onCancel, className, }: PostFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function PostForm({ post, categories, endpoint, onSaved, embeds, onImageUpload, imageUploadEndpoint, fetchFn, onCancel, className, locale: uiLocale, }: PostFormProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=post-form.d.ts.map

package/dist/components/admin/post-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-form.d.ts","sourceRoot":"","sources":["../../../src/components/admin/post-form.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,UAAe,EACf,QAA4B,EAC5B,OAAO,EACP,MAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE,aAAa,2CAyQf"}
+{"version":3,"file":"post-form.d.ts","sourceRoot":"","sources":["../../../src/components/admin/post-form.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,0HAA0H;IAC1H,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,UAAe,EACf,QAA4B,EAC5B,OAAO,EACP,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EAAE,QAAe,GACxB,EAAE,aAAa,2CA2Qf"}

package/dist/components/admin/post-form.js

@@ -6,23 +6,29 @@ import { cn } from "hazo_ui/utils";
 import { slugify } from "../../lib/text.js";
 import { createBlogImageUploader } from "./upload-image.js";
 import { FeaturedImageField } from "./featured-image-field.js";
-import en from "../../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
-const DEFAULT_EMBEDS = [
-    { name: "youtube", label: "YT", snippet: '\n<YouTube id="VIDEO_ID" title="" />\n' },
-    {
-        name: "callout",
-        label: "Note",
-        snippet: (sel) => `\n<Callout type="info">\n${sel || "..."}\n</Callout>\n`,
-    },
-    {
-        name: "image",
-        label: "Img",
-        snippet: '\n<BlogImage src="/path.jpg" alt="" caption="" />\n',
-    },
-];
-export function PostForm({ post, categories = [], endpoint = "/api/admin/blog", onSaved, embeds = DEFAULT_EMBEDS, onImageUpload, imageUploadEndpoint, fetchFn, onCancel, className, }) {
+import { blogTranslator } from "../../lib/i18n.js";
+function buildDefaultEmbeds(t) {
+    return [
+        {
+            name: "youtube",
+            label: t("post_form.embed_youtube_label"),
+            snippet: '\n<YouTube id="VIDEO_ID" title="" />\n',
+        },
+        {
+            name: "callout",
+            label: t("post_form.embed_note_label"),
+            snippet: (sel) => `\n<Callout type="info">\n${sel || "..."}\n</Callout>\n`,
+        },
+        {
+            name: "image",
+            label: t("post_form.embed_image_label"),
+            snippet: '\n<BlogImage src="/path.jpg" alt="" caption="" />\n',
+        },
+    ];
+}
+export function PostForm({ post, categories = [], endpoint = "/api/admin/blog", onSaved, embeds, onImageUpload, imageUploadEndpoint, fetchFn, onCancel, className, locale: uiLocale = "en", }) {
+    const t = blogTranslator(uiLocale);
+    const toolbarEmbeds = useMemo(() => embeds ?? buildDefaultEmbeds(t), [embeds, uiLocale]);
     // Reuse an existing `onImageUpload` if the caller already wired one
     // (back-compat); otherwise build one from `imageUploadEndpoint` if given;
     // otherwise `undefined` (URL-only mode, no upload UI).
@@ -92,5 +98,5 @@ export function PostForm({ post, categories = [], endpoint = "/api/admin/blog",
     return (_jsxs("form", { className: cn("space-y-5", className), onSubmit: (e) => e.preventDefault(), children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.title_label") }), _jsx("input", { className: inputCls, value: title, onChange: (e) => setTitle(e.target.value), placeholder: t("post_form.title_placeholder") })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.slug_label") }), _jsx("input", { className: inputCls, value: slugTouched ? slug : effectiveSlug(), onChange: (e) => {
                             setSlugTouched(true);
                             setSlug(e.target.value);
-                        }, placeholder: t("post_form.slug_placeholder") })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.content_label") }), _jsx(MarkdownEditor, { value: content, onChange: setContent, height: 480, embeds: embeds, onImageUpload: uploader, placeholder: t("post_form.content_placeholder") })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.category_label") }), _jsxs("select", { className: inputCls, value: categoryId, onChange: (e) => setCategoryId(e.target.value), children: [_jsx("option", { value: "", children: t("post_form.category_none_option") }), categories.map((c) => (_jsx("option", { value: c.id, children: c.name }, c.id)))] })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.tags_label") }), _jsx("input", { className: inputCls, value: tags, onChange: (e) => setTags(e.target.value), placeholder: t("post_form.tags_placeholder") })] })] }), _jsx(FeaturedImageField, { value: featuredImage, onChange: setFeaturedImage, uploader: uploader }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.locale_label") }), _jsx("input", { className: inputCls, value: locale, onChange: (e) => setLocale(e.target.value), placeholder: t("post_form.locale_placeholder") })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.translation_of_label") }), _jsx("input", { className: inputCls, value: translationOf, onChange: (e) => setTranslationOf(e.target.value), placeholder: t("post_form.translation_of_placeholder") })] })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("input", { id: "post-form-indexable", type: "checkbox", className: "h-4 w-4 rounded border-border accent-primary", checked: indexable, onChange: (e) => setIndexable(e.target.checked) }), _jsx("label", { htmlFor: "post-form-indexable", className: "text-sm font-medium", children: t("post_form.indexable_label") })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.meta_title_label") }), _jsx("input", { className: inputCls, value: metaTitle, onChange: (e) => setMetaTitle(e.target.value) })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.meta_description_label") }), _jsx("input", { className: inputCls, value: metaDescription, onChange: (e) => setMetaDescription(e.target.value) })] })] }), _jsxs("fieldset", { className: "rounded-lg border border-border p-4", children: [_jsx("legend", { className: "px-1 text-sm font-medium", children: t("post_form.faq_legend") }), faq.map((item, i) => (_jsxs("div", { className: "mb-2 grid gap-2 sm:grid-cols-2", children: [_jsx("input", { className: inputCls, value: item.question, placeholder: t("post_form.faq_question_placeholder"), onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, question: e.target.value } : f))) }), _jsx("input", { className: inputCls, value: item.answer, placeholder: t("post_form.faq_answer_placeholder"), onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, answer: e.target.value } : f))) })] }, i))), _jsx("button", { type: "button", className: "mt-1 text-sm text-primary hover:underline", onClick: () => setFaq((p) => [...p, { question: "", answer: "" }]), children: t("post_form.faq_add_item") })] }), error && _jsx("p", { className: "text-sm text-destructive", children: error }), _jsxs("div", { className: "flex gap-3", children: [onCancel && (_jsx("button", { type: "button", disabled: saving, onClick: onCancel, className: "rounded-lg border border-border px-4 py-2 text-sm font-medium hover:bg-accent disabled:opacity-50", children: t("post_form.cancel") })), _jsx("button", { type: "button", disabled: saving, onClick: () => save("draft"), className: "rounded-lg border border-border px-4 py-2 text-sm font-medium hover:bg-accent disabled:opacity-50", children: t("post_form.save_draft") }), _jsx("button", { type: "button", disabled: saving, onClick: () => save("published"), className: "rounded-lg bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:opacity-90 disabled:opacity-50", children: saving ? t("post_form.saving") : t("post_form.publish") })] })] }));
+                        }, placeholder: t("post_form.slug_placeholder") })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.content_label") }), _jsx(MarkdownEditor, { value: content, onChange: setContent, height: 480, embeds: toolbarEmbeds, onImageUpload: uploader, placeholder: t("post_form.content_placeholder") })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.category_label") }), _jsxs("select", { className: inputCls, value: categoryId, onChange: (e) => setCategoryId(e.target.value), children: [_jsx("option", { value: "", children: t("post_form.category_none_option") }), categories.map((c) => (_jsx("option", { value: c.id, children: c.name }, c.id)))] })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.tags_label") }), _jsx("input", { className: inputCls, value: tags, onChange: (e) => setTags(e.target.value), placeholder: t("post_form.tags_placeholder") })] })] }), _jsx(FeaturedImageField, { value: featuredImage, onChange: setFeaturedImage, uploader: uploader }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.locale_label") }), _jsx("input", { className: inputCls, value: locale, onChange: (e) => setLocale(e.target.value), placeholder: t("post_form.locale_placeholder") })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.translation_of_label") }), _jsx("input", { className: inputCls, value: translationOf, onChange: (e) => setTranslationOf(e.target.value), placeholder: t("post_form.translation_of_placeholder") })] })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("input", { id: "post-form-indexable", type: "checkbox", className: "h-4 w-4 rounded border-border accent-primary", checked: indexable, onChange: (e) => setIndexable(e.target.checked) }), _jsx("label", { htmlFor: "post-form-indexable", className: "text-sm font-medium", children: t("post_form.indexable_label") })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.meta_title_label") }), _jsx("input", { className: inputCls, value: metaTitle, onChange: (e) => setMetaTitle(e.target.value) })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: t("post_form.meta_description_label") }), _jsx("input", { className: inputCls, value: metaDescription, onChange: (e) => setMetaDescription(e.target.value) })] })] }), _jsxs("fieldset", { className: "rounded-lg border border-border p-4", children: [_jsx("legend", { className: "px-1 text-sm font-medium", children: t("post_form.faq_legend") }), faq.map((item, i) => (_jsxs("div", { className: "mb-2 grid gap-2 sm:grid-cols-2", children: [_jsx("input", { className: inputCls, value: item.question, placeholder: t("post_form.faq_question_placeholder"), onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, question: e.target.value } : f))) }), _jsx("input", { className: inputCls, value: item.answer, placeholder: t("post_form.faq_answer_placeholder"), onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, answer: e.target.value } : f))) })] }, i))), _jsx("button", { type: "button", className: "mt-1 text-sm text-primary hover:underline", onClick: () => setFaq((p) => [...p, { question: "", answer: "" }]), children: t("post_form.faq_add_item") })] }), error && _jsx("p", { className: "text-sm text-destructive", children: error }), _jsxs("div", { className: "flex gap-3", children: [onCancel && (_jsx("button", { type: "button", disabled: saving, onClick: onCancel, className: "rounded-lg border border-border px-4 py-2 text-sm font-medium hover:bg-accent disabled:opacity-50", children: t("post_form.cancel") })), _jsx("button", { type: "button", disabled: saving, onClick: () => save("draft"), className: "rounded-lg border border-border px-4 py-2 text-sm font-medium hover:bg-accent disabled:opacity-50", children: t("post_form.save_draft") }), _jsx("button", { type: "button", disabled: saving, onClick: () => save("published"), className: "rounded-lg bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:opacity-90 disabled:opacity-50", children: saving ? t("post_form.saving") : t("post_form.publish") })] })] }));
 }

package/dist/components/author-bio.d.ts

@@ -2,6 +2,8 @@ import type { AuthorInfo } from "../types/index.js";
 export interface AuthorBioProps {
     author: AuthorInfo;
     className?: string;
+    /** UI locale for user-visible text. Default "en". */
+    locale?: string;
 }
-export declare function AuthorBio({ author, className }: AuthorBioProps): import("react/jsx-runtime").JSX.Element;
+export declare function AuthorBio({ author, className, locale }: AuthorBioProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=author-bio.d.ts.map

package/dist/components/author-bio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"author-bio.d.ts","sourceRoot":"","sources":["../../src/components/author-bio.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,2CA0B9D"}
+{"version":3,"file":"author-bio.d.ts","sourceRoot":"","sources":["../../src/components/author-bio.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAa,EAAE,EAAE,cAAc,2CA2B7E"}

package/dist/components/author-bio.js

@@ -1,9 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Image from "next/image";
 import { cn } from "hazo_ui/utils";
-import en from "../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
-export function AuthorBio({ author, className }) {
+import { blogTranslator } from "../lib/i18n.js";
+export function AuthorBio({ author, className, locale = "en" }) {
+    const t = blogTranslator(locale);
     return (_jsxs("aside", { className: cn("my-8 flex items-center gap-4 rounded-xl border border-border bg-muted/30 p-5", className), children: [author.avatar && (_jsx(Image, { src: author.avatar, alt: author.name, width: 56, height: 56, className: "h-14 w-14 rounded-full object-cover" })), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "text-sm text-muted-foreground", children: t("author_bio.written_by") }), _jsx("a", { href: author.url, className: "font-semibold text-foreground hover:text-primary", children: author.name }), author.bio && _jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: author.bio })] })] }));
 }

package/dist/components/blog-search.d.ts

@@ -6,6 +6,8 @@ export interface BlogSearchProps {
     className?: string;
     /** Visual style. "default" preserves the original boxy input; "pill" renders a rounded, icon-prefixed input. */
     variant?: "default" | "pill";
+    /** UI locale for the placeholder. Default "en". An explicit `placeholder` always wins. */
+    locale?: string;
 }
-export declare function BlogSearch({ endpoint, basePath, placeholder, className, variant, }: BlogSearchProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlogSearch({ endpoint, basePath, placeholder, className, variant, locale, }: BlogSearchProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=blog-search.d.ts.map

package/dist/components/blog-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog-search.d.ts","sourceRoot":"","sources":["../../src/components/blog-search.tsx"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gHAAgH;IAChH,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAkB,EAClB,WAA0C,EAC1C,SAAS,EACT,OAAmB,GACpB,EAAE,eAAe,2CAyFjB"}
+{"version":3,"file":"blog-search.d.ts","sourceRoot":"","sources":["../../src/components/blog-search.tsx"],"names":[],"mappings":"AAgBA,MAAM,WAAW,eAAe;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gHAAgH;IAChH,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAkB,EAClB,WAAW,EACX,SAAS,EACT,OAAmB,EACnB,MAAa,GACd,EAAE,eAAe,2CA0FjB"}

package/dist/components/blog-search.js

@@ -6,10 +6,9 @@ import Link from "next/link";
 import { cn } from "hazo_ui/utils";
 import { trackBlogEvent } from "../lib/analytics.js";
 import { SearchIcon } from "./icons.js";
-import en from "../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
-export function BlogSearch({ endpoint, basePath = "/blog", placeholder = t("blog_search.placeholder"), className, variant = "default", }) {
+import { blogTranslator } from "../lib/i18n.js";
+export function BlogSearch({ endpoint, basePath = "/blog", placeholder, className, variant = "default", locale = "en", }) {
+    const t = blogTranslator(locale);
     const url = endpoint ?? `${basePath}/api/search`;
     const [query, setQuery] = useState("");
     const [results, setResults] = useState([]);
@@ -63,7 +62,7 @@ export function BlogSearch({ endpoint, basePath = "/blog", placeholder = t("blog
             setResults([]);
         }
     }
-    return (_jsxs("div", { className: cn("relative", className), children: [variant === "pill" && (_jsx(SearchIcon, { className: "pointer-events-none absolute left-4 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" })), _jsx("input", { type: "search", value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleKeyDown, placeholder: placeholder, className: variant === "pill"
+    return (_jsxs("div", { className: cn("relative", className), children: [variant === "pill" && (_jsx(SearchIcon, { className: "pointer-events-none absolute left-4 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" })), _jsx("input", { type: "search", value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleKeyDown, placeholder: placeholder ?? t("blog_search.placeholder"), className: variant === "pill"
                     ? "w-full rounded-full border border-border bg-background py-2.5 pl-11 pr-4 text-sm outline-none focus:ring-2 focus:ring-primary"
                     : "w-full rounded-lg border border-border bg-background px-4 py-2 text-sm outline-none focus:ring-2 focus:ring-primary" }), open && results.length > 0 && (_jsx("ul", { className: "absolute z-50 mt-1 max-h-80 w-full overflow-auto rounded-lg border border-border bg-background shadow-xl", children: results.map((r) => (_jsx("li", { className: "border-b border-border last:border-0", children: _jsxs(Link, { href: `${basePath}/${r.slug}`, className: "block px-4 py-3 text-sm hover:bg-accent", onClick: () => setOpen(false), children: [_jsx("span", { className: "font-medium text-foreground", children: r.title }), r.excerpt && (_jsx("span", { className: "block truncate text-xs text-muted-foreground", children: r.excerpt }))] }) }, r.slug))) }))] }));
 }

package/dist/components/editorial-post-card.d.ts

@@ -5,6 +5,8 @@ export interface EditorialPostCardProps {
     index: number;
     basePath?: string;
     className?: string;
+    /** UI locale for dates. Default "en". */
+    locale?: string;
 }
-export declare function EditorialPostCard({ post, index, basePath, className, }: EditorialPostCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorialPostCard({ post, index, basePath, className, locale, }: EditorialPostCardProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=editorial-post-card.d.ts.map

package/dist/components/editorial-post-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editorial-post-card.d.ts","sourceRoot":"","sources":["../../src/components/editorial-post-card.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAK/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,QAAkB,EAClB,SAAS,GACV,EAAE,sBAAsB,2CA+CxB"}
+{"version":3,"file":"editorial-post-card.d.ts","sourceRoot":"","sources":["../../src/components/editorial-post-card.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAK/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,QAAkB,EAClB,SAAS,EACT,MAAa,GACd,EAAE,sBAAsB,2CA+CxB"}

package/dist/components/editorial-post-card.js

@@ -11,10 +11,10 @@ import { ImageIcon } from "./icons.js";
 import { formatPostDate } from "../lib/dates.js";
 const ASPECT_BY_POSITION = ["aspect-[4/5]", "aspect-[16/10]", "aspect-[4/3]"];
 const OFFSET_BY_POSITION = ["", "", "lg:mt-6"];
-export function EditorialPostCard({ post, index, basePath = "/blog", className, }) {
+export function EditorialPostCard({ post, index, basePath = "/blog", className, locale = "en", }) {
     const position = index % 3;
     return (_jsx("article", { className: cn(OFFSET_BY_POSITION[position], className), children: _jsxs(Link, { href: `${basePath}/${post.slug}`, className: "group block", children: [_jsx("div", { className: cn("relative w-full overflow-hidden rounded-2xl", ASPECT_BY_POSITION[position]), children: post.featured_image ? (_jsx(Image, { src: post.featured_image, alt: post.title, fill: true, className: "object-cover transition-transform duration-300 group-hover:scale-105", sizes: "(max-width: 768px) 100vw, 33vw" })) : (_jsx("div", { className: "flex h-full w-full items-center justify-center bg-gradient-to-br from-muted to-muted/50", children: _jsx(ImageIcon, { className: "h-10 w-10 text-muted-foreground/40" }) })) }), _jsxs("div", { className: "mt-4", children: [post.category && (_jsx("span", { className: "mb-2 inline-block rounded-full px-2.5 py-0.5 text-xs font-medium", style: {
                                 backgroundColor: `${post.category.colour}20`,
                                 color: post.category.colour,
-                            }, children: post.category.name })), _jsx("h3", { className: "line-clamp-2 text-lg font-semibold text-foreground group-hover:text-primary", children: post.title }), _jsx("time", { className: "mt-2 block text-xs text-muted-foreground", children: formatPostDate(post.publish_date, "short") })] })] }) }));
+                            }, children: post.category.name })), _jsx("h3", { className: "line-clamp-2 text-lg font-semibold text-foreground group-hover:text-primary", children: post.title }), _jsx("time", { className: "mt-2 block text-xs text-muted-foreground", children: formatPostDate(post.publish_date, "short", locale) })] })] }) }));
 }

package/dist/components/faq-section.d.ts

@@ -3,7 +3,9 @@ export interface FaqSectionProps {
     faq: FaqItem[];
     title?: string;
     className?: string;
+    /** UI locale for the default heading. Default "en". */
+    locale?: string;
 }
 /** Renders FAQ as a no-JS <details> accordion (the FAQPage JSON-LD is emitted separately). */
-export declare function FaqSection({ faq, title, className }: FaqSectionProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function FaqSection({ faq, title, className, locale }: FaqSectionProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=faq-section.d.ts.map

package/dist/components/faq-section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faq-section.d.ts","sourceRoot":"","sources":["../../src/components/faq-section.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,EAAE,GAAG,EAAE,KAA8B,EAAE,SAAS,EAAE,EAAE,eAAe,kDAiB7F"}
+{"version":3,"file":"faq-section.d.ts","sourceRoot":"","sources":["../../src/components/faq-section.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAa,EAAE,EAAE,eAAe,kDAkBnF"}

package/dist/components/faq-section.js

@@ -1,11 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "hazo_ui/utils";
-import en from "../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
+import { blogTranslator } from "../lib/i18n.js";
 /** Renders FAQ as a no-JS <details> accordion (the FAQPage JSON-LD is emitted separately). */
-export function FaqSection({ faq, title = t("faq_section.title"), className }) {
+export function FaqSection({ faq, title, className, locale = "en" }) {
     if (!faq || faq.length === 0)
         return null;
-    return (_jsxs("section", { className: cn("my-8", className), children: [_jsx("h2", { className: "mb-4 text-2xl font-bold text-foreground", children: title }), _jsx("dl", { className: "divide-y divide-border rounded-xl border border-border", children: faq.map((item, i) => (_jsxs("details", { className: "group p-4", children: [_jsx("summary", { className: "cursor-pointer list-none font-medium text-foreground", children: _jsx("dt", { className: "inline", children: item.question }) }), _jsx("dd", { className: "mt-2 text-sm text-muted-foreground", children: item.answer })] }, i))) })] }));
+    const t = blogTranslator(locale);
+    return (_jsxs("section", { className: cn("my-8", className), children: [_jsx("h2", { className: "mb-4 text-2xl font-bold text-foreground", children: title ?? t("faq_section.title") }), _jsx("dl", { className: "divide-y divide-border rounded-xl border border-border", children: faq.map((item, i) => (_jsxs("details", { className: "group p-4", children: [_jsx("summary", { className: "cursor-pointer list-none font-medium text-foreground", children: _jsx("dt", { className: "inline", children: item.question }) }), _jsx("dd", { className: "mt-2 text-sm text-muted-foreground", children: item.answer })] }, i))) })] }));
 }

package/dist/components/featured-post-card.d.ts

@@ -3,6 +3,8 @@ export interface FeaturedPostCardProps {
     post: BlogPostWithRelations;
     basePath?: string;
     className?: string;
+    /** UI locale for user-visible text and dates. Default "en". */
+    locale?: string;
 }
-export declare function FeaturedPostCard({ post, basePath, className }: FeaturedPostCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function FeaturedPostCard({ post, basePath, className, locale, }: FeaturedPostCardProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=featured-post-card.d.ts.map

package/dist/components/featured-post-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"featured-post-card.d.ts","sourceRoot":"","sources":["../../src/components/featured-post-card.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAM/D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAkB,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CA+D9F"}
+{"version":3,"file":"featured-post-card.d.ts","sourceRoot":"","sources":["../../src/components/featured-post-card.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAkB,EAClB,SAAS,EACT,MAAa,GACd,EAAE,qBAAqB,2CAgEvB"}

package/dist/components/featured-post-card.js

@@ -7,12 +7,11 @@ import Image from "next/image";
 import { cn } from "hazo_ui/utils";
 import { ClockIcon, ArrowRightIcon, ImageIcon } from "./icons.js";
 import { formatPostDate } from "../lib/dates.js";
-import en from "../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
-export function FeaturedPostCard({ post, basePath = "/blog", className }) {
+import { blogTranslator } from "../lib/i18n.js";
+export function FeaturedPostCard({ post, basePath = "/blog", className, locale = "en", }) {
+    const t = blogTranslator(locale);
     return (_jsxs("article", { className: cn("grid overflow-hidden rounded-3xl border border-border bg-card md:grid-cols-[3fr_2fr]", className), children: [_jsx("div", { className: "relative aspect-video w-full overflow-hidden md:aspect-auto md:h-full", children: post.featured_image ? (_jsx(Image, { src: post.featured_image, alt: post.title, fill: true, className: "object-cover", sizes: "(max-width: 768px) 100vw, 60vw", priority: true })) : (_jsx("div", { className: "flex h-full min-h-48 w-full items-center justify-center bg-gradient-to-br from-muted to-muted/50", children: _jsx(ImageIcon, { className: "h-12 w-12 text-muted-foreground/40" }) })) }), _jsxs("div", { className: "flex flex-col justify-center gap-4 p-6 sm:p-8 lg:p-10", children: [_jsxs("div", { className: "flex items-center gap-3 text-xs font-medium text-muted-foreground", children: [post.category && (_jsx("span", { className: "inline-block rounded-full px-2.5 py-0.5 text-xs font-medium", style: {
                                     backgroundColor: `${post.category.colour}20`,
                                     color: post.category.colour,
-                                }, children: post.category.name })), _jsxs("span", { className: "inline-flex items-center gap-1", children: [_jsx(ClockIcon, { className: "h-3.5 w-3.5" }), t("featured_post_card.reading_time", { minutes: String(post.reading_time) })] })] }), _jsx("h2", { className: "text-2xl font-bold leading-tight text-foreground sm:text-3xl lg:text-4xl", children: _jsx(Link, { href: `${basePath}/${post.slug}`, className: "hover:text-primary", children: post.title }) }), post.excerpt && (_jsx("p", { className: "line-clamp-3 text-base text-muted-foreground", children: post.excerpt })), _jsxs("div", { className: "mt-2 flex items-center justify-between", children: [_jsx("time", { className: "text-sm text-muted-foreground", children: formatPostDate(post.publish_date) }), _jsx(Link, { href: `${basePath}/${post.slug}`, "aria-label": t("featured_post_card.read_aria", { title: post.title }), className: "flex h-10 w-10 shrink-0 items-center justify-center rounded-full border border-border text-foreground transition-colors hover:bg-accent", children: _jsx(ArrowRightIcon, { className: "h-5 w-5" }) })] })] })] }));
+                                }, children: post.category.name })), _jsxs("span", { className: "inline-flex items-center gap-1", children: [_jsx(ClockIcon, { className: "h-3.5 w-3.5" }), t("featured_post_card.reading_time", { minutes: String(post.reading_time) })] })] }), _jsx("h2", { className: "text-2xl font-bold leading-tight text-foreground sm:text-3xl lg:text-4xl", children: _jsx(Link, { href: `${basePath}/${post.slug}`, className: "hover:text-primary", children: post.title }) }), post.excerpt && (_jsx("p", { className: "line-clamp-3 text-base text-muted-foreground", children: post.excerpt })), _jsxs("div", { className: "mt-2 flex items-center justify-between", children: [_jsx("time", { className: "text-sm text-muted-foreground", children: formatPostDate(post.publish_date, "short", locale) }), _jsx(Link, { href: `${basePath}/${post.slug}`, "aria-label": t("featured_post_card.read_aria", { title: post.title }), className: "flex h-10 w-10 shrink-0 items-center justify-center rounded-full border border-border text-foreground transition-colors hover:bg-accent", children: _jsx(ArrowRightIcon, { className: "h-5 w-5" }) })] })] })] }));
 }

package/dist/components/layouts/blog-index-editorial.d.ts

@@ -1,3 +1,3 @@
 import type { BlogIndexLayoutProps } from "./index.js";
-export declare function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title, description, }: BlogIndexLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title, description, locale, }: BlogIndexLayoutProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=blog-index-editorial.d.ts.map

package/dist/components/layouts/blog-index-editorial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog-index-editorial.d.ts","sourceRoot":"","sources":["../../../src/components/layouts/blog-index-editorial.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAsC,EACtC,WAAW,GACZ,EAAE,oBAAoB,2CA+EtB"}
+{"version":3,"file":"blog-index-editorial.d.ts","sourceRoot":"","sources":["../../../src/components/layouts/blog-index-editorial.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAa,GACd,EAAE,oBAAoB,2CAiFtB"}

package/dist/components/layouts/blog-index-editorial.js

@@ -13,18 +13,17 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { FeaturedPostCard } from "../featured-post-card.js";
 import { EditorialPostCard } from "../editorial-post-card.js";
 import { BlogSearch } from "../blog-search.js";
-import en from "../../locales/en.json" with { type: "json" };
-import { createPackageT } from "hazo_core/i18n";
-const t = createPackageT("hazo_blog", en);
-export function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title = t("common.default_blog_title"), description, }) {
+import { blogTranslator, pluralSuffix } from "../../lib/i18n.js";
+export function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title, description, locale = "en", }) {
+    const t = blogTranslator(locale);
     const showFeatured = !query && posts.length > 0;
     const featured = showFeatured ? posts[0] : null;
     const gridPosts = showFeatured ? posts.slice(1) : posts;
-    return (_jsxs("div", { className: "mx-auto max-w-6xl px-4 py-10", children: [_jsxs("div", { className: "mb-8 flex flex-col gap-6 sm:flex-row sm:items-end sm:justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-4xl font-bold text-foreground sm:text-5xl", children: title }), description && (_jsx("p", { className: "mt-3 max-w-xl text-base text-muted-foreground", children: description })), query && (_jsxs("p", { className: "mt-3 text-sm text-muted-foreground", children: [t("common.results_count", {
+    return (_jsxs("div", { className: "mx-auto max-w-6xl px-4 py-10", children: [_jsxs("div", { className: "mb-8 flex flex-col gap-6 sm:flex-row sm:items-end sm:justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-4xl font-bold text-foreground sm:text-5xl", children: title ?? t("common.default_blog_title") }), description && (_jsx("p", { className: "mt-3 max-w-xl text-base text-muted-foreground", children: description })), query && (_jsxs("p", { className: "mt-3 text-sm text-muted-foreground", children: [t("common.results_count", {
                                         count: String(posts.length),
-                                        plural: posts.length !== 1 ? "s" : "",
+                                        plural: pluralSuffix(locale, posts.length),
                                         query,
-                                    }), "\u00A0\u00B7\u00A0", _jsx("a", { href: basePath, className: "text-primary hover:underline", children: t("common.clear") })] }))] }), _jsx(BlogSearch, { variant: "pill", basePath: basePath, endpoint: searchEndpoint, className: "sm:w-80" })] }), _jsx("div", { className: "border-t border-border" }), posts.length === 0 ? (_jsx("p", { className: "py-16 text-center text-muted-foreground", children: query ? t("common.no_results_for_query", { query }) : t("common.no_posts_yet") })) : (_jsxs(_Fragment, { children: [featured && (_jsx("div", { className: "mt-8", children: _jsx(FeaturedPostCard, { post: featured, basePath: basePath }) })), gridPosts.length > 0 && (_jsx("div", { className: "mt-8 grid items-start sm:grid-cols-2 lg:grid-cols-3 gap-6", children: gridPosts.map((p, i) => (_jsx(EditorialPostCard, { post: p, index: i, basePath: basePath }, p.id))) }))] })), !query && totalPages > 1 && (_jsx("nav", { className: "mt-10 flex justify-center gap-2 text-sm", children: Array.from({ length: totalPages }, (_, i) => i + 1).map((n) => (_jsx("a", { href: `${basePath}?page=${n}`, className: n === page
+                                    }), "\u00A0\u00B7\u00A0", _jsx("a", { href: basePath, className: "text-primary hover:underline", children: t("common.clear") })] }))] }), _jsx(BlogSearch, { variant: "pill", basePath: basePath, endpoint: searchEndpoint, className: "sm:w-80", locale: locale })] }), _jsx("div", { className: "border-t border-border" }), posts.length === 0 ? (_jsx("p", { className: "py-16 text-center text-muted-foreground", children: query ? t("common.no_results_for_query", { query }) : t("common.no_posts_yet") })) : (_jsxs(_Fragment, { children: [featured && (_jsx("div", { className: "mt-8", children: _jsx(FeaturedPostCard, { post: featured, basePath: basePath, locale: locale }) })), gridPosts.length > 0 && (_jsx("div", { className: "mt-8 grid items-start sm:grid-cols-2 lg:grid-cols-3 gap-6", children: gridPosts.map((p, i) => (_jsx(EditorialPostCard, { post: p, index: i, basePath: basePath, locale: locale }, p.id))) }))] })), !query && totalPages > 1 && (_jsx("nav", { className: "mt-10 flex justify-center gap-2 text-sm", children: Array.from({ length: totalPages }, (_, i) => i + 1).map((n) => (_jsx("a", { href: `${basePath}?page=${n}`, className: n === page
                         ? "rounded-full bg-primary px-4 py-1.5 text-primary-foreground"
                         : "rounded-full border border-border px-4 py-1.5 hover:bg-accent", children: n }, n))) }))] }));
 }

package/dist/components/layouts/blog-index-grid.d.ts

@@ -1,3 +1,3 @@
 import type { BlogIndexLayoutProps } from "./index.js";
-export declare function BlogIndexGrid({ posts, basePath, searchEndpoint, query, page, totalPages, title, }: BlogIndexLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlogIndexGrid({ posts, basePath, searchEndpoint, query, page, totalPages, title, locale, }: BlogIndexLayoutProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=blog-index-grid.d.ts.map

package/dist/components/layouts/blog-index-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog-index-grid.d.ts","sourceRoot":"","sources":["../../../src/components/layouts/blog-index-grid.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAsC,GACvC,EAAE,oBAAoB,2CAoDtB"}
+{"version":3,"file":"blog-index-grid.d.ts","sourceRoot":"","sources":["../../../src/components/layouts/blog-index-grid.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,MAAa,GACd,EAAE,oBAAoB,2CAqDtB"}