hazo_blog 0.5.0 → 1.2.0

package/CHANGE_LOG.md

@@ -3,6 +3,215 @@
 All notable changes are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## 1.2.0 — 2026-09-12
+
+**Side preview in the post editor (`PanelDialog` + `PostPreview`)**
+
+The admin edit dialog now supports a split-pane layout showing the published article alongside the
+editor. When editing a published post, a "Preview" toggle appears in the dialog header; clicking it
+expands the dialog to `max-w-7xl` and loads the published article in an iframe on the right half.
+
+**`PanelDialog`** gained two new optional props:
+- `sideContent?: ReactNode` — when provided, the dialog widens and renders a two-column layout
+  (children on the left, sideContent on the right).
+- `headerActions?: ReactNode` — rendered inline after the title, used by `BlogAdminPanel` for the
+  preview toggle button.
+
+**`PostPreview`** — new component exported from `hazo_blog/ui`. A lightweight iframe wrapper that
+takes a `url` prop (the post's public URL), shows a loading state, and provides an "Open in new
+tab" link. Token-free Tailwind, same isolation rule as the rest of `src/ui/*`.
+
+**`BlogAdminPanel`** wires it up automatically: when the `dialogTarget` is a published post, the
+preview toggle and `PostPreview` are passed to `PanelDialog`. The iframe URL is constructed from
+`blogBasePath` + slug (e.g. `/guides/my-post`), so consuming apps that set a custom `blogBasePath`
+get correct preview URLs out of the box.
+
+**Back-compat: zero break.** Both new `PanelDialog` props are optional; `PostPreview` is additive.
+The dialog renders identically to before when `sideContent` is not provided (the only layout
+difference is the title now sits in a border-bottom header row — visually near-identical).
+
+## 1.1.0 — 2026-09-11
+
+**`onPostSaved` config hook + `createBlogManageSlugRoutes` factory**
+
+Two additive capabilities requested by a consumer (stocktools) that needs to react to individual
+post writes/deletes and to manage a single post by slug over the programmatic (API-key) surface,
+rather than only through the collection-level `createBlogManageRoutes`.
+
+**1. `BlogConfig.onPostSaved?: (post: BlogPost | null, action: 'upsert' | 'delete') => void |
+Promise<void>`** — mirrors the existing `onSettingsChanged` hook. `BlogService.upsertBySlug` calls
+it with the saved `BlogPost` and `'upsert'` after a successful write; `BlogService.deletePost`
+calls it with `null` and `'delete'` after a successful delete. Both call sites wrap the hook in a
+`try/catch` — a throwing (or rejecting) `onPostSaved` never fails the surrounding write/delete,
+same "best-effort" contract as `onSettingsChanged`. Useful for cache invalidation
+(`revalidatePath`) or search-index sync keyed off individual posts rather than the whole settings
+blob.
+
+**2. `createBlogManageSlugRoutes(config: BlogConfig)`** — a new route-handler factory alongside
+`createBlogManageRoutes`, for a Next.js `[slug]` dynamic route on the programmatic management API.
+Returns `{ GET, PATCH, DELETE }`, each gated by `withApiKey` the same way as the collection route
+(`blog:read` for `GET`, `blog:write` for `PATCH`/`DELETE`):
+
+- `GET` — fetches one post by slug (including drafts), 404 via `fail("NOT_FOUND", ...)` when
+  missing.
+- `PATCH` — fetches the existing post by slug (404 if missing), merges the JSON body's fields onto
+  it (same field-by-field merge semantics as `createBlogManageRoutes`'s collection `PATCH`), and
+  calls `service.upsertBySlug`.
+- `DELETE` — fetches the existing post by slug (404 if missing, to resolve its `id`), calls
+  `service.deletePost(id)`, and returns `{ deleted: slug }`.
+
+Exported from the package barrel alongside the other route factories. No breaking changes.
+
+## 1.0.0 — 2026-09-05
+
+**FR-034, Part 1 — locale variants + `indexable` (schema + types + repository + service)**
+
+This is the schema/data-layer half of FR-034 (locale-variant posts, categories, and tags, plus a
+per-post `indexable` flag for excluding a post from the sitemap/robots without unpublishing it).
+The SEO layer (`src/seo/index.ts`), Next.js pages/routes, and the admin `PostForm` UI are a
+follow-up change — this release only touches schema, `src/types`, `src/repository`, and
+`src/service`. Two breaking changes warrant the major bump:
+
+**1. Database schema — new columns + a changed unique constraint**
+
+`hazo_blog_posts` gains `locale TEXT DEFAULT NULL`, `translation_of TEXT REFERENCES
+hazo_blog_posts(id) ON DELETE SET NULL` (`UUID` on Postgres), and `indexable INTEGER NOT NULL
+DEFAULT 1` (`BOOLEAN NOT NULL DEFAULT TRUE` on Postgres). `hazo_blog_categories` and
+`hazo_blog_tags` each gain `locale TEXT DEFAULT NULL`. All three tables' `(scope_id, slug)` unique
+index is replaced by `(scope_id, slug, COALESCE(locale, ''))` — the `COALESCE` folds every
+default-locale (`locale IS NULL`) row into one uniqueness bucket per `(scope_id, slug)`, since a
+plain `(scope_id, slug, locale)` unique index would let SQLite/Postgres treat every `NULL` as
+distinct from every other `NULL`, silently allowing duplicate default-locale posts. A new
+`idx_hazo_blog_posts_translation_of` index backs translation-cluster lookups.
+
+No SQLite table rebuild is required — `ALTER TABLE ... ADD COLUMN` works fine for these
+plain nullable/defaulted columns, and the old unique constraints were already separate
+`CREATE UNIQUE INDEX` statements rather than inline column constraints, so the index swap is a
+`DROP INDEX` + `CREATE UNIQUE INDEX` pair (both idempotent, safe to run on every process start).
+`db_setup_sqlite.sql`/`db_setup_postgres.sql` and their `migrations/` mirrors carry the new columns
+directly in their `CREATE TABLE IF NOT EXISTS` lists (so a fresh DB gets them immediately) plus the
+idempotent index-swap statements. An already-materialized SQLite dev DB (this package's
+`test-app/data/blog.sqlite`) won't pick up new columns from a skipped `CREATE TABLE IF NOT EXISTS`
+— `test-app/scripts/seed.mjs` gained a small `ensureColumns()` helper (guarded `PRAGMA
+table_info` + `ALTER TABLE ... ADD COLUMN`) that backfills them before the schema file's DROP/CREATE
+INDEX statements run. Postgres needs no such helper — `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`
+is natively idempotent and is included directly in `db_setup_postgres.sql`.
+
+**2. `BlogRepository`/`BlogService` breaking signature changes**
+
+- `getPostBySlug(slug, includeUnpublished?: boolean)` → `getPostBySlug(slug, opts?: {
+  includeUnpublished?: boolean; locale?: string | null })`. The old positional boolean 2nd
+  argument is gone.
+  ```ts
+  // before
+  await repo.getPostBySlug(slug, true);
+  // after
+  await repo.getPostBySlug(slug, { includeUnpublished: true });
+  ```
+- `getAllSlugs(includeUnpublished?)` now returns `Array<{ slug: string; locale: string | null }>`
+  instead of `string[]` (unfiltered by locale — every translation's slug is included).
+- New `getTranslations(postId)` on both `BlogRepository` and `BlogService`, resolving a post's full
+  translation cluster (root + every other variant, normalizing two-hop sibling→root→sibling chains
+  into one flat list) as `TranslationInfo[]`.
+- `BlogService.getPost(slug, opts?, req?)` gains `opts.locale` and `opts.fallbackToDefault`
+  (default `false`). With `fallbackToDefault: false`, a locale-specific miss returns `null` rather
+  than silently serving the default-locale post.
+- `listPosts`, `searchPosts`/`search`, `getRelatedPosts`, and `getOrCreateCategory` are all
+  locale-aware now; omitting `locale` anywhere continues to mean "default-locale only"
+  (`locale IS NULL`), so **existing single-locale consumers need no query changes** — every new
+  parameter is optional and defaults to the pre-1.0 behaviour.
+
+**Migration note for existing consumers:** the only required change is any call site using the old
+`getPostBySlug(slug, true)` positional form — switch it to `getPostBySlug(slug, {
+includeUnpublished: true })`. Everything else (locale filtering, translation clusters, `indexable`)
+is additive and opt-in.
+
+**New types:** `BlogPost.locale`/`translation_of`/`indexable` (the last is a required `boolean` —
+the repository normalizes SQLite's raw `0`/`1` `INTEGER` read-back to a real boolean so the type is
+honest on both dialects), `UpsertPostInput.locale`/`translation_of`/`indexable`,
+`ListPostsOptions.locale`, `BlogCategory.locale`, `BlogTag.locale`, `BlogPostWithRelations.translations`,
+new `TranslationInfo`, and `BlogConfig.defaultLocale` (default `'en'`, consumed by the follow-up SEO
+change).
+
+**Tests:** `src/__tests__/repository.integration.test.ts` gained a `FR-034` describe block (default
++ translated variant CRUD, DB-level uniqueness enforcement including the two-default-locale-NULLs
+case, cross-locale listing, translation-cluster resolution with two-hop normalization, unfiltered
+`getAllSlugs`). New `src/__tests__/locale.integration.test.ts` exercises the schema files directly
+against a fresh SQLite DB: new columns exist, the locale-aware unique indexes replace the old ones,
+the `COALESCE(locale, '')` NULL-folding behavior, `translation_of`'s FK (including `ON DELETE SET
+NULL`), the `indexable` default, and DDL idempotency (schema file re-run twice, no errors, no data
+loss).
+
+**FR-034, Part 2 — SEO / Next.js pages & routes / admin UI**
+
+The SEO-facing and presentation half of FR-034, building on Part 1's schema/repository/service
+layer above. Additive only — no further breaking changes on top of Part 1's major bump.
+
+- **`src/seo/index.ts`:**
+  - `isIndexable(post)` now also returns `false` when `post.indexable === false`, independent of
+    the existing draft/publish-date gate — a live published post can still be excluded from the
+    sitemap/RSS/robots via the per-post flag without being unpublished.
+  - `buildBlogPostingJsonLd`'s JSON-LD `inLanguage` is now `post.locale || config.defaultLocale ||
+    "en"` instead of a hardcoded `"en"`.
+  - `getBlogSitemapEntries` gained a new `SitemapEntry.alternates?: Array<{ locale: string; url:
+    string }>` field, populated from a post's `translations` (indexable siblings only, via
+    `postUrl`) when present. This is intentionally passive: the function does no DB lookups of its
+    own, so a host wanting hreflang alternates in its sitemap must attach `.translations` (from
+    `BlogService.getTranslations`) to each post before calling it — the existing
+    `createBlogSitemapRoute` call site doesn't do this yet, since it lists posts in bulk and
+    per-post translation lookups there are a host-level tradeoff, not this package's call to make.
+  - `getBlogRssXml`'s channel `<language>` now follows `config.defaultLocale` (default `"en"`)
+    instead of a hardcoded `"en"`. Items whose `post.locale` differs from the feed-level language
+    get a per-item `<dc:language>` element, and the `<rss>` root gains the `xmlns:dc` namespace
+    attribute only when at least one item actually needed it (an all-default-locale feed is
+    byte-identical to before this change).
+  - `src/__tests__/seo.test.ts`'s `makePost()` helper now sets the required `indexable: true` field
+    (fixes a `type-check` failure introduced by Part 1's `BlogPost.indexable: boolean` becoming
+    non-optional). New tests cover locale-aware `inLanguage`, `indexable: false` sitemap exclusion,
+    sitemap `alternates` construction (including skipping non-indexable siblings), and the RSS
+    `<language>`/`<dc:language>`/`xmlns:dc` behavior.
+
+- **`src/next/pages.tsx`** (`createBlogPostPage`):
+  - `generateMetadata` now also awaits `service.getTranslations(post.id)` and, when the cluster is
+    non-empty, adds a Next.js Metadata API `alternates.languages` map (`{ [locale]: url }`, built
+    via `postUrl`, indexable siblings only) alongside the existing `alternates.canonical`.
+  - Both `generateMetadata` and the page component now accept an optional `params.locale` (in
+    addition to the existing `params.slug`) and, when present, thread it through to
+    `service.getPost(slug, { locale })`. When absent, behavior is unchanged from before this
+    release — locale-prefixed routing remains the consuming app's concern (see `postUrl`'s
+    doc-comment); this package only adds the pass-through slot.
+
+- **`src/next/routes.ts`:**
+  - `createBlogSearchRoute` now reads an optional `?locale=` query param and passes it through to
+    `service.search(q, 20, req, locale)`.
+  - `createBlogManageRoutes`'s `PATCH` handler now accepts `locale`, `translation_of`, and
+    `indexable` in the request body and merges them into the existing-post-derived
+    `UpsertPostInput`, same pattern as every other partial field on that handler.
+
+- **`src/components/admin/post-form.tsx`:** `PostForm` gained three new fields, all sent through
+  the existing unified `save()` payload: a free-text **Locale** input (BCP-47 code, blank = default
+  locale), a free-text **Translation of (post ID)** input (labeled explicitly since
+  `translation_of` stores the parent post's `id`, not its slug — no post-picker UI exists in this
+  form to reuse), and an **Indexable** checkbox (defaults to `true`, matching the DB default). All
+  three keep the file's existing `bg-background`/`border-border` token classes per the isolation
+  rule documented in `CLAUDE.md` (this form is the one accepted exception inside the
+  otherwise-token-free `src/ui/*` boundary).
+
+- **`test-app/app/autotest/hazo_blog_scenarios.ts`:** the browser-side `POST` fixture used by the
+  `/autotest` SEO-builder scenarios gained the required `indexable: true` field (same root cause as
+  the `seo.test.ts` fix above — this only surfaces in a full test-app Next build, not `tsc
+  --noEmit`, since it's outside this package's own `tsconfig.json` project).
+
+**Out of scope for Part 2 (deliberately):** wiring `createBlogSitemapRoute`/`createBlogFeedRoute` to
+actually populate `.translations` on each post before calling `getBlogSitemapEntries`/
+`getBlogRssXml` — that requires either N+1 `getTranslations` calls per sitemap post or a new bulk
+repository method, and no call site in this package currently needs it (`SitemapEntry.alternates`
+and the RSS locale fields work correctly today for any host that already attaches `.translations`
+itself, e.g. via a custom sitemap route). A locale-prefixed URL scheme for `postUrl`/route
+generation (e.g. `/blog/fr/hello-world`) — still explicitly the consuming app's routing concern per
+existing package convention. A post-picker UI for `translation_of` in `PostForm` — the plain
+post-ID text input is the proportionate choice given no such picker exists elsewhere in this form.
+
 ## 0.5.0 — 2026-08-17
 
 **Two named `/blog` index layouts — `grid` (unchanged) + new `editorial`**

package/README.md

@@ -218,6 +218,47 @@ This matters because `/blog` is typically ISR-cached (`revalidate = 3600` from
 step 3) — without a revalidate hook, switching layouts via the admin panel
 won't be visible on the public index until the next natural ISR window.
 
+## Locale variants
+
+> **Breaking change in 1.0.0** — see the migration note below if you're upgrading from 0.x.
+
+`hazo_blog_posts`/`_categories`/`_tags` each carry a nullable `locale` column, uniquely constrained per `(scope_id, slug, locale)` — a `NULL` locale is your "default" post, and only one default (and one per non-null locale) can exist per slug. Posts also carry `translation_of` (the id of the post this is a translation of) and `indexable` (excludes a post from the sitemap and marks its JSON-LD/RSS as non-indexable without unpublishing it).
+
+```ts
+// Create a translated variant of an existing post
+await service.upsertBySlug({
+  slug: "my-post",
+  locale: "fr",
+  translation_of: originalPost.id,
+  title: "Mon article",
+  // ...
+});
+
+// Fetch a specific locale — returns null (not the default post) when that
+// locale doesn't exist, unless you opt into fallback:
+const fr = await service.getPost("my-post", { locale: "fr" });
+const frOrDefault = await service.getPost("my-post", { locale: "fr", fallbackToDefault: true });
+
+// Walk a post's translation cluster (root + every sibling translation, minus itself)
+const translations = await service.getTranslations(post.id);
+// => [{ locale, slug, id, indexable }, ...]
+```
+
+`listPosts()`/`searchPosts()` default to `locale`-omitted, which returns **default-locale posts only** — existing single-locale consumers see no behavior change and never double-count translations in a listing. Pass `locale` explicitly to list/search one locale's posts.
+
+**SEO**: `buildBlogPostingJsonLd` sets `inLanguage` from `post.locale || config.defaultLocale || "en"`; `getBlogSitemapEntries` excludes `indexable: false` posts and adds an `alternates: [{ locale, url }]` entry per sitemap item when the post carries a `.translations` array (populate it yourself via `getTranslations` before calling the sitemap builder — the package doesn't do this join automatically); `getBlogRssXml` uses `config.defaultLocale` for the feed `<language>` and adds a per-item `<dc:language>` when an item's locale differs from the feed default. `generateMetadata` on the post page adds `alternates.languages` (hreflang) automatically from `getTranslations`.
+
+**Migrating from 0.x**: `getPostBySlug`'s second parameter is now an options object, not a boolean —
+
+```ts
+// before (0.x)
+await repo.getPostBySlug(slug, true);
+// after (1.0.0)
+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.
+
 ## Layouts
 
 `config.defaultIndexLayout` (and the runtime override in [Settings](#settings))

package/db_setup_postgres.sql

@@ -14,22 +14,33 @@ CREATE TABLE IF NOT EXISTS hazo_blog_categories (
   name        TEXT NOT NULL,
   description TEXT NOT NULL DEFAULT '',
   colour      TEXT NOT NULL DEFAULT '#3B82F6',
+  locale      TEXT DEFAULT NULL,                      -- BCP-47 locale; NULL = default locale
   created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
   updated_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug
-  ON hazo_blog_categories (scope_id, slug);
+ALTER TABLE hazo_blog_categories ADD COLUMN IF NOT EXISTS locale TEXT DEFAULT NULL;
+-- FR-034: locale-aware uniqueness. DROP+CREATE is idempotent and safe to
+-- always include. COALESCE(locale, '') folds NULL (default locale) into one
+-- bucket so two default-locale rows can't collide with Postgres's
+-- distinct-per-NULL UNIQUE-index semantics.
+DROP INDEX IF EXISTS idx_hazo_blog_categories_scope_slug;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug_locale
+  ON hazo_blog_categories (scope_id, slug, COALESCE(locale, ''));
 
 CREATE TABLE IF NOT EXISTS hazo_blog_tags (
   id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
   scope_id   TEXT,
   slug       TEXT NOT NULL,
   name       TEXT NOT NULL,
+  locale     TEXT DEFAULT NULL,                       -- BCP-47 locale; NULL = default locale
   created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
   updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug
-  ON hazo_blog_tags (scope_id, slug);
+ALTER TABLE hazo_blog_tags ADD COLUMN IF NOT EXISTS locale TEXT DEFAULT NULL;
+-- FR-034: locale-aware uniqueness (see categories index comment above).
+DROP INDEX IF EXISTS idx_hazo_blog_tags_scope_slug;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug_locale
+  ON hazo_blog_tags (scope_id, slug, COALESCE(locale, ''));
 
 CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   id               UUID PRIMARY KEY DEFAULT gen_random_uuid(),
@@ -51,15 +62,25 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   reading_time     INTEGER NOT NULL DEFAULT 0,        -- cached, minutes
   status           TEXT NOT NULL DEFAULT 'draft',     -- draft | published | scheduled
   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
+  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()
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug
-  ON hazo_blog_posts (scope_id, slug);
+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;
+-- 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
+  ON hazo_blog_posts (scope_id, slug, COALESCE(locale, ''));
 CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_status_date
   ON hazo_blog_posts (status, publish_date);
 CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_category
   ON hazo_blog_posts (category_id);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_translation_of
+  ON hazo_blog_posts (translation_of);
 
 CREATE TABLE IF NOT EXISTS hazo_blog_post_tags (
   id      UUID PRIMARY KEY DEFAULT gen_random_uuid(),

package/db_setup_sqlite.sql

@@ -21,22 +21,32 @@ CREATE TABLE IF NOT EXISTS hazo_blog_categories (
   name        TEXT NOT NULL,
   description TEXT NOT NULL DEFAULT '',
   colour      TEXT NOT NULL DEFAULT '#3B82F6',
+  locale      TEXT DEFAULT NULL,                      -- BCP-47 locale; NULL = default locale
   created_at  TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug
-  ON hazo_blog_categories (scope_id, slug);
+-- FR-034: locale-aware uniqueness. DROP+CREATE is idempotent and safe to
+-- re-run every process start (no table rebuild needed — this is an index
+-- swap, not a column change). COALESCE(locale, '') folds NULL (default
+-- locale) into one bucket so two default-locale rows can't collide with a
+-- distinct-per-NULL SQL semantics bug.
+DROP INDEX IF EXISTS idx_hazo_blog_categories_scope_slug;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug_locale
+  ON hazo_blog_categories (scope_id, slug, COALESCE(locale, ''));
 
 CREATE TABLE IF NOT EXISTS hazo_blog_tags (
   id         TEXT PRIMARY KEY,
   scope_id   TEXT,
   slug       TEXT NOT NULL,
   name       TEXT NOT NULL,
+  locale     TEXT DEFAULT NULL,                       -- BCP-47 locale; NULL = default locale
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at TEXT NOT NULL DEFAULT (datetime('now'))
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug
-  ON hazo_blog_tags (scope_id, slug);
+-- FR-034: locale-aware uniqueness (see categories index comment above).
+DROP INDEX IF EXISTS idx_hazo_blog_tags_scope_slug;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug_locale
+  ON hazo_blog_tags (scope_id, slug, COALESCE(locale, ''));
 
 CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   id               TEXT PRIMARY KEY,
@@ -58,15 +68,22 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
   reading_time     INTEGER NOT NULL DEFAULT 0,        -- cached, minutes
   status           TEXT NOT NULL DEFAULT 'draft',     -- draft | published | scheduled
   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
+  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'))
 );
-CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug
-  ON hazo_blog_posts (scope_id, slug);
+-- 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
+  ON hazo_blog_posts (scope_id, slug, COALESCE(locale, ''));
 CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_status_date
   ON hazo_blog_posts (status, publish_date);
 CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_category
   ON hazo_blog_posts (category_id);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_translation_of
+  ON hazo_blog_posts (translation_of);
 
 CREATE TABLE IF NOT EXISTS hazo_blog_post_tags (
   id      TEXT PRIMARY KEY,

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;AAI9B,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,2CAiOf"}
+{"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;AAI9B,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"}

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

@@ -37,6 +37,9 @@ export function PostForm({ post, categories = [], endpoint = "/api/admin/blog",
     const [featuredImage, setFeaturedImage] = useState(post?.featured_image ?? "");
     const [tags, setTags] = useState((post?.tags ?? []).map((t) => t.name).join(", "));
     const [faq, setFaq] = useState(post?.faq ?? []);
+    const [locale, setLocale] = useState(post?.locale ?? "");
+    const [translationOf, setTranslationOf] = useState(post?.translation_of ?? "");
+    const [indexable, setIndexable] = useState(post?.indexable ?? true);
     const [saving, setSaving] = useState(false);
     const [error, setError] = useState("");
     function effectiveSlug() {
@@ -60,6 +63,9 @@ export function PostForm({ post, categories = [], endpoint = "/api/admin/blog",
                     .filter(Boolean),
                 faq: faq.filter((f) => f.question.trim() && f.answer.trim()),
                 status,
+                locale: locale.trim() || undefined,
+                translation_of: translationOf.trim() || undefined,
+                indexable,
             };
             const res = await fetch(endpoint, {
                 method: "POST",
@@ -83,5 +89,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: "Title" }), _jsx("input", { className: inputCls, value: title, onChange: (e) => setTitle(e.target.value), placeholder: "Post title" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Slug" }), _jsx("input", { className: inputCls, value: slugTouched ? slug : effectiveSlug(), onChange: (e) => {
                             setSlugTouched(true);
                             setSlug(e.target.value);
-                        }, placeholder: "auto-generated-from-title" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Content (MDX)" }), _jsx(MarkdownEditor, { value: content, onChange: setContent, height: 480, embeds: embeds, onImageUpload: uploader, placeholder: "Write your post in Markdown / MDX\u2026" })] }), _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: "Category" }), _jsxs("select", { className: inputCls, value: categoryId, onChange: (e) => setCategoryId(e.target.value), children: [_jsx("option", { value: "", children: "\u2014 none \u2014" }), 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: "Tags (comma-separated)" }), _jsx("input", { className: inputCls, value: tags, onChange: (e) => setTags(e.target.value), placeholder: "guides, timers" })] })] }), _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: "Meta title (SEO)" }), _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: "Meta description (SEO)" }), _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: "FAQ" }), 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: "Question", onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, question: e.target.value } : f))) }), _jsx("input", { className: inputCls, value: item.answer, placeholder: "Answer", 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: "+ Add FAQ 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: "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: "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 ? "Saving…" : "Publish" })] })] }));
+                        }, placeholder: "auto-generated-from-title" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Content (MDX)" }), _jsx(MarkdownEditor, { value: content, onChange: setContent, height: 480, embeds: embeds, onImageUpload: uploader, placeholder: "Write your post in Markdown / MDX\u2026" })] }), _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: "Category" }), _jsxs("select", { className: inputCls, value: categoryId, onChange: (e) => setCategoryId(e.target.value), children: [_jsx("option", { value: "", children: "\u2014 none \u2014" }), 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: "Tags (comma-separated)" }), _jsx("input", { className: inputCls, value: tags, onChange: (e) => setTags(e.target.value), placeholder: "guides, timers" })] })] }), _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: "Locale" }), _jsx("input", { className: inputCls, value: locale, onChange: (e) => setLocale(e.target.value), placeholder: "e.g. fr, pt-BR (blank = default locale)" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Translation of (post ID)" }), _jsx("input", { className: inputCls, value: translationOf, onChange: (e) => setTranslationOf(e.target.value), placeholder: "Leave blank for the root post" })] })] }), _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: "Indexable (include in sitemap/robots)" })] }), _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: "Meta title (SEO)" }), _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: "Meta description (SEO)" }), _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: "FAQ" }), 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: "Question", onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, question: e.target.value } : f))) }), _jsx("input", { className: inputCls, value: item.answer, placeholder: "Answer", 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: "+ Add FAQ 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: "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: "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 ? "Saving…" : "Publish" })] })] }));
 }

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;AAEpD,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;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"}

package/dist/components/author-bio.js

@@ -1,6 +1,9 @@
 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 "../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
 export function AuthorBio({ author, className }) {
-    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: "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 })] })] }));
+    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.map

@@ -1 +1 @@
-{"version":3,"file":"blog-search.d.ts","sourceRoot":"","sources":["../../src/components/blog-search.tsx"],"names":[],"mappings":"AAeA,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,WAA6B,EAC7B,SAAS,EACT,OAAmB,GACpB,EAAE,eAAe,2CAyFjB"}
+{"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"}

package/dist/components/blog-search.js

@@ -6,7 +6,10 @@ import Link from "next/link";
 import { cn } from "hazo_ui/utils";
 import { trackBlogEvent } from "../lib/analytics.js";
 import { SearchIcon } from "./icons.js";
-export function BlogSearch({ endpoint, basePath = "/blog", placeholder = "Search posts…", className, variant = "default", }) {
+import en from "../locales/en.json" with { type: "json" };
+import { createPackageT } from "../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
+export function BlogSearch({ endpoint, basePath = "/blog", placeholder = t("blog_search.placeholder"), className, variant = "default", }) {
     const url = endpoint ?? `${basePath}/api/search`;
     const [query, setQuery] = useState("");
     const [results, setResults] = useState([]);

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;AAEjD,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,KAAoC,EAAE,SAAS,EAAE,EAAE,eAAe,kDAiBnG"}
+{"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"}

package/dist/components/faq-section.js

@@ -1,7 +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 "../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
 /** Renders FAQ as a no-JS <details> accordion (the FAQPage JSON-LD is emitted separately). */
-export function FaqSection({ faq, title = "Frequently asked questions", className }) {
+export function FaqSection({ faq, title = t("faq_section.title"), className }) {
     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))) })] }));

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;AAE/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":"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"}

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

@@ -7,9 +7,12 @@ 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 "../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
 export function FeaturedPostCard({ post, basePath = "/blog", className }) {
     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" }), post.reading_time, " min read"] })] }), _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": `Read ${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) }), _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.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;AAEvD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAc,EACd,WAAW,GACZ,EAAE,oBAAoB,2CA2EtB"}
+{"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"}

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

@@ -13,11 +13,18 @@ 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";
-export function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title = "Blog", description, }) {
+import en from "../../locales/en.json" with { type: "json" };
+import { createPackageT } from "../../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
+export function BlogIndexEditorial({ posts, basePath, searchEndpoint, query, page, totalPages, title = t("common.default_blog_title"), description, }) {
     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: [posts.length, " result", posts.length !== 1 ? "s" : "", " for \u201C", query, "\u201D \u00A0\u00B7\u00A0", _jsx("a", { href: basePath, className: "text-primary hover:underline", children: "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 ? `No posts matching "${query}".` : "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
+    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", {
+                                        count: String(posts.length),
+                                        plural: posts.length !== 1 ? "s" : "",
+                                        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
                         ? "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.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;AAEvD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,cAAc,EACd,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAc,GACf,EAAE,oBAAoB,2CA8CtB"}
+{"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"}

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

@@ -9,8 +9,15 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Do NOT modernize this file — new layouts belong alongside it, not inside it.
 import { PostCard } from "../post-card.js";
 import { BlogSearch } from "../blog-search.js";
-export function BlogIndexGrid({ posts, basePath, searchEndpoint, query, page, totalPages, title = "Blog", }) {
-    return (_jsxs("div", { className: "mx-auto max-w-6xl px-4 py-10", children: [_jsxs("div", { className: "mb-8 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-3xl font-bold text-foreground", children: title }), query && (_jsxs("p", { className: "mt-1 text-sm text-muted-foreground", children: [posts.length, " result", posts.length !== 1 ? "s" : "", " for \u201C", query, "\u201D \u00A0\u00B7\u00A0", _jsx("a", { href: basePath, className: "text-primary hover:underline", children: "Clear" })] }))] }), _jsx(BlogSearch, { basePath: basePath, endpoint: searchEndpoint, className: "sm:w-72" })] }), posts.length === 0 ? (_jsx("p", { className: "text-muted-foreground", children: query ? `No posts matching "${query}".` : "No posts yet." })) : (_jsx("div", { className: "grid gap-6 sm:grid-cols-2 lg:grid-cols-3", children: posts.map((p) => (_jsx(PostCard, { post: p, 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
+import en from "../../locales/en.json" with { type: "json" };
+import { createPackageT } from "../../lib/create_package_t.js";
+const t = createPackageT("hazo_blog", en);
+export function BlogIndexGrid({ posts, basePath, searchEndpoint, query, page, totalPages, title = t("common.default_blog_title"), }) {
+    return (_jsxs("div", { className: "mx-auto max-w-6xl px-4 py-10", children: [_jsxs("div", { className: "mb-8 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-3xl font-bold text-foreground", children: title }), query && (_jsxs("p", { className: "mt-1 text-sm text-muted-foreground", children: [t("common.results_count", {
+                                        count: String(posts.length),
+                                        plural: posts.length !== 1 ? "s" : "",
+                                        query,
+                                    }), "\u00A0\u00B7\u00A0", _jsx("a", { href: basePath, className: "text-primary hover:underline", children: t("common.clear") })] }))] }), _jsx(BlogSearch, { basePath: basePath, endpoint: searchEndpoint, className: "sm:w-72" })] }), posts.length === 0 ? (_jsx("p", { className: "text-muted-foreground", children: query ? t("common.no_results_for_query", { query }) : t("common.no_posts_yet") })) : (_jsx("div", { className: "grid gap-6 sm:grid-cols-2 lg:grid-cols-3", children: posts.map((p) => (_jsx(PostCard, { post: p, 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
                         ? "rounded bg-primary px-3 py-1 text-primary-foreground"
                         : "rounded border border-border px-3 py-1 hover:bg-accent", children: n }, n))) }))] }));
 }

package/dist/components/mdx/youtube.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../../../src/components/mdx/youtube.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAuB,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,YAAY,2CActF"}
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../../../src/components/mdx/youtube.tsx"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAkC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,YAAY,2CAcjG"}