@brandfine/client 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @brandfine/client
 
+## 0.3.0
+
+### Minor Changes
+
+- c41e51d: Add `imageUrl` to `BrandfineNavItem`. Navigation items can now carry an
+  optional image URL (icon, thumbnail, mega-menu art) on any item type. The
+  field is served by `GET /external/navigations/:key` and resolved by the
+  navigation resolver. `null` when unset. Additive, no breaking changes.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/{chunk-OKIEA3AD.cjs → chunk-2VCPYNF5.cjs}

@@ -52,6 +52,7 @@ function hydrate(item, children, locale, opts) {
     href: resolveHref(item, locale, opts),
     label: resolveLabel(item, locale, opts.defaultLocale),
     type: item.type,
+    imageUrl: item.imageUrl ?? null,
     children: children.map((c) => hydrate(c, [], locale, opts))
   };
 }
@@ -103,5 +104,5 @@ exports.localizePath = localizePath;
 exports.pickLocale = pickLocale;
 exports.resolveNavigation = resolveNavigation;
 exports.stripLocalePrefix = stripLocalePrefix;
-//# sourceMappingURL=chunk-OKIEA3AD.cjs.map
-//# sourceMappingURL=chunk-OKIEA3AD.cjs.map
+//# sourceMappingURL=chunk-2VCPYNF5.cjs.map
+//# sourceMappingURL=chunk-2VCPYNF5.cjs.map

package/dist/chunk-2VCPYNF5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolvers/locale.ts","../src/resolvers/navigation.ts"],"names":[],"mappings":"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","file":"chunk-2VCPYNF5.cjs","sourcesContent":["/**\n * Locale helpers.\n *\n * Pure functions over BCP47 locale codes. Olavisa's in-tree\n * version reads `LOCALES` and `DEFAULT_LOCALE` from module-level\n * constants — the package takes them as options instead so a\n * single SDK instance can serve callers with different locale\n * sets (multi-tenant, preview environments, tests).\n *\n * The conventional URL shape these helpers assume:\n *   - The `defaultLocale` is served at the bare URL: `/about`\n *   - Other locales get a path prefix: `/pt/about`, `/es/about`\n *   - `pickLocale` falls back to `defaultLocale` for unknown\n *     inputs. Don't throw — `Astro.currentLocale` is `string |\n *     undefined`, and callers shouldn't have to defend against\n *     every framework's quirk.\n */\n\nexport type LocaleOptions = {\n  /** Locales the consumer serves, in any order. The list is used\n   *  for membership checks (`isLocale`), prefix detection\n   *  (`stripLocalePrefix`), and as the codomain of `pickLocale`. */\n  locales: readonly string[]\n  /** The locale served at bare URLs. Must appear in `locales`. */\n  defaultLocale: string\n}\n\n/**\n * Type guard. Narrows `unknown` inputs to a known locale so the\n * caller can use them without further coercion.\n *\n *   if (isLocale(value, ['en', 'pt'])) {\n *     // value: string (known to be 'en' | 'pt' at runtime)\n *   }\n */\nexport function isLocale(\n  value: unknown,\n  locales: readonly string[],\n): value is string {\n  return typeof value === 'string' && locales.includes(value)\n}\n\n/**\n * Coerce arbitrary input into a known locale, falling back to\n * `defaultLocale` for unknowns. Convenient at the consumer's\n * framework boundary (Astro.currentLocale, request headers, etc.).\n */\nexport function pickLocale(input: unknown, opts: LocaleOptions): string {\n  return isLocale(input, opts.locales) ? input : opts.defaultLocale\n}\n\n/**\n * Convert a canonical (default-locale) path into the locale-prefixed\n * variant for `locale`. The default locale's URLs are bare; every\n * other locale prefixes with `/<locale>`.\n *\n *   localizePath('/services/uk-eta', 'en', { defaultLocale: 'en' })\n *     → '/services/uk-eta'\n *   localizePath('/services/uk-eta', 'pt', { defaultLocale: 'en' })\n *     → '/pt/services/uk-eta'\n *   localizePath('/',                'pt', { defaultLocale: 'en' })\n *     → '/pt'\n */\nexport function localizePath(\n  path: string,\n  locale: string,\n  opts: { defaultLocale: string },\n): string {\n  if (locale === opts.defaultLocale) return path\n  if (path === '/') return `/${locale}`\n  return `/${locale}${path.startsWith('/') ? path : `/${path}`}`\n}\n\n/**\n * Strip a non-default locale prefix off a pathname. The inverse\n * of `localizePath` — useful for normalising back to a canonical\n * path before re-localising for a different locale (the language\n * switcher's main job).\n *\n *   stripLocalePrefix('/pt/about',  ...) → '/about'\n *   stripLocalePrefix('/about',     ...) → '/about'    (already canonical)\n *   stripLocalePrefix('/pt',        ...) → '/'\n *   stripLocalePrefix('/en/foo',    { defaultLocale: 'en', … })\n *     → '/en/foo'   (en is default — no prefix to strip)\n */\nexport function stripLocalePrefix(\n  pathname: string,\n  opts: LocaleOptions,\n): string {\n  for (const locale of opts.locales) {\n    if (locale === opts.defaultLocale) continue\n    const prefix = `/${locale}`\n    if (pathname === prefix || pathname === `${prefix}/`) return '/'\n    if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length)\n  }\n  return pathname\n}\n","/**\n * Navigation resolver.\n *\n * Turns a `BrandfineNavigation` (locale-agnostic shape from the\n * external API) into a `HydratedNav` ready for a specific locale —\n * URLs computed, labels picked, hidden items dropped, children\n * grouped under their parent. Header / Footer components consume\n * the hydrated form directly.\n *\n * The semantics encoded here come from olavisa but are\n * generalised:\n *   - POST items resolve URLs via `post.locales`. If the active\n *     locale has no translation, fall back to the default-locale\n *     URL. Consumers can override the URL pattern entirely via\n *     `urlForPost`.\n *   - CUSTOM_URL items: paths (start with `/`) run through\n *     `localizePath`; anything with a scheme (https://, mailto:)\n *     passes through unchanged.\n *   - Labels: per-locale override → default-locale label → any\n *     populated label (last-resort, covers single-locale fills) →\n *     for POST items, the post's per-locale title.\n *   - `hiddenLocales` drops the item entirely for that locale.\n */\n\nimport type {\n  BrandfineNavItem,\n  BrandfineNavPost,\n  BrandfineNavigation,\n} from '../types'\nimport { localizePath } from './locale'\n\nexport type HydratedNavItem = {\n  /** Final URL, ready to render in an `<a href>`. `null` for\n   *  HEADING items (label-only) and for POST items whose post\n   *  has been deleted (orphan). */\n  href: string | null\n  label: string\n  type: 'CUSTOM_URL' | 'POST' | 'HEADING'\n  /** Optional image URL, passed through from the item. Not\n   *  per-locale; `null` when unset. */\n  imageUrl: string | null\n  children: HydratedNavItem[]\n}\n\nexport type HydratedNav = {\n  key: string\n  name: string\n  items: HydratedNavItem[]\n}\n\nexport type ResolveNavigationOptions = {\n  defaultLocale: string\n  /** Override the URL pattern for POST items. Default:\n   *  `localizePath('/${postTypeSlug}/${sibling.slug}', linkLocale)`.\n   *\n   *  Use when a consumer routes posts under a non-default prefix\n   *  (e.g. `/blog/<slug>` instead of `/posts/<slug>`), or wants\n   *  to omit the locale prefix for specific post types. */\n  urlForPost?: (args: {\n    post: BrandfineNavPost\n    sibling: BrandfineNavPost['locales'][number]\n    locale: string\n    defaultLocale: string\n  }) => string | null\n}\n\nexport function resolveNavigation(\n  nav: BrandfineNavigation,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNav {\n  const childrenByParent = new Map<string, BrandfineNavItem[]>()\n  for (const item of nav.items) {\n    if (!item.parentId) continue\n    const arr = childrenByParent.get(item.parentId) ?? []\n    arr.push(item)\n    childrenByParent.set(item.parentId, arr)\n  }\n  // Array-position dictates sibling order within a parent —\n  // matches the cms editor's render contract.\n  const topLevel = nav.items.filter((i) => i.parentId === null)\n\n  return {\n    key: nav.key,\n    name: nav.name,\n    items: topLevel\n      .filter((item) => !item.hiddenLocales.includes(locale))\n      .map((item) =>\n        hydrate(\n          item,\n          (childrenByParent.get(item.id) ?? []).filter(\n            (c) => !c.hiddenLocales.includes(locale),\n          ),\n          locale,\n          opts,\n        ),\n      ),\n  }\n}\n\nfunction hydrate(\n  item: BrandfineNavItem,\n  children: BrandfineNavItem[],\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNavItem {\n  return {\n    href: resolveHref(item, locale, opts),\n    label: resolveLabel(item, locale, opts.defaultLocale),\n    type: item.type,\n    imageUrl: item.imageUrl ?? null,\n    children: children.map((c) => hydrate(c, [], locale, opts)),\n  }\n}\n\nfunction resolveHref(\n  item: BrandfineNavItem,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): string | null {\n  if (item.type === 'HEADING') return null\n\n  if (item.type === 'CUSTOM_URL') {\n    const url = item.customUrl ?? ''\n    if (!url) return null\n    // External (scheme:) and protocol-relative URLs pass through;\n    // `localizePath` would mangle them. Anything else is treated\n    // as a path on the consumer site.\n    if (/^([a-z][a-z0-9+.-]*:)|^\\/\\//i.test(url)) return url\n    return localizePath(\n      url.startsWith('/') ? url : `/${url}`,\n      locale,\n      { defaultLocale: opts.defaultLocale },\n    )\n  }\n\n  // POST\n  const post = item.post\n  if (!post) return null\n\n  // Pick the sibling for the active locale, falling back to the\n  // default-locale sibling, then any sibling. If none exist, the\n  // post has no published translations.\n  const sibling =\n    post.locales.find((s) => s.locale === locale) ??\n    post.locales.find((s) => s.locale === opts.defaultLocale) ??\n    post.locales[0]\n  if (!sibling) return null\n\n  // The URL prefix the user navigates to — `locale` when this\n  // post has a translation in `locale`, else `defaultLocale` so\n  // we land on the default-locale page (Astro's i18n rewrite or\n  // similar serves the right content under the right URL).\n  const linkLocale = post.locales.some((s) => s.locale === locale)\n    ? locale\n    : opts.defaultLocale\n\n  if (opts.urlForPost) {\n    return opts.urlForPost({\n      post,\n      sibling,\n      locale: linkLocale,\n      defaultLocale: opts.defaultLocale,\n    })\n  }\n\n  // Default convention: `/<postTypeSlug>/<sibling.slug>`.\n  // Orphan posts (postType deleted) have no path — return null so\n  // the consumer can render an unlinked label or skip the item.\n  if (!post.postTypeSlug) return null\n  return localizePath(\n    `/${post.postTypeSlug}/${sibling.slug}`,\n    linkLocale,\n    { defaultLocale: opts.defaultLocale },\n  )\n}\n\nfunction resolveLabel(\n  item: BrandfineNavItem,\n  locale: string,\n  defaultLocale: string,\n): string {\n  const labels = item.labels ?? {}\n  // Active locale override → default-locale label → any other\n  // populated label (last-resort, useful when editors only fill\n  // one locale). Empty strings are treated as \"not set\".\n  const override =\n    labels[locale]?.trim() ||\n    labels[defaultLocale]?.trim() ||\n    Object.values(labels)\n      .map((v) => v?.trim())\n      .find((v) => Boolean(v)) ||\n    ''\n  if (override) return override\n\n  if (item.type === 'POST' && item.post) {\n    const sibling =\n      item.post.locales.find((s) => s.locale === locale) ??\n      item.post.locales.find((s) => s.locale === defaultLocale) ??\n      item.post.locales[0]\n    if (sibling) return sibling.title\n  }\n  return ''\n}\n"]}

package/dist/{chunk-MTBSSTTG.js → chunk-3OXDF4ZY.js}

@@ -50,6 +50,7 @@ function hydrate(item, children, locale, opts) {
     href: resolveHref(item, locale, opts),
     label: resolveLabel(item, locale, opts.defaultLocale),
     type: item.type,
+    imageUrl: item.imageUrl ?? null,
     children: children.map((c) => hydrate(c, [], locale, opts))
   };
 }
@@ -97,5 +98,5 @@ function resolveLabel(item, locale, defaultLocale) {
 }
 
 export { isLocale, localizePath, pickLocale, resolveNavigation, stripLocalePrefix };
-//# sourceMappingURL=chunk-MTBSSTTG.js.map
-//# sourceMappingURL=chunk-MTBSSTTG.js.map
+//# sourceMappingURL=chunk-3OXDF4ZY.js.map
+//# sourceMappingURL=chunk-3OXDF4ZY.js.map

package/dist/chunk-3OXDF4ZY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolvers/locale.ts","../src/resolvers/navigation.ts"],"names":[],"mappings":"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","file":"chunk-3OXDF4ZY.js","sourcesContent":["/**\n * Locale helpers.\n *\n * Pure functions over BCP47 locale codes. Olavisa's in-tree\n * version reads `LOCALES` and `DEFAULT_LOCALE` from module-level\n * constants — the package takes them as options instead so a\n * single SDK instance can serve callers with different locale\n * sets (multi-tenant, preview environments, tests).\n *\n * The conventional URL shape these helpers assume:\n *   - The `defaultLocale` is served at the bare URL: `/about`\n *   - Other locales get a path prefix: `/pt/about`, `/es/about`\n *   - `pickLocale` falls back to `defaultLocale` for unknown\n *     inputs. Don't throw — `Astro.currentLocale` is `string |\n *     undefined`, and callers shouldn't have to defend against\n *     every framework's quirk.\n */\n\nexport type LocaleOptions = {\n  /** Locales the consumer serves, in any order. The list is used\n   *  for membership checks (`isLocale`), prefix detection\n   *  (`stripLocalePrefix`), and as the codomain of `pickLocale`. */\n  locales: readonly string[]\n  /** The locale served at bare URLs. Must appear in `locales`. */\n  defaultLocale: string\n}\n\n/**\n * Type guard. Narrows `unknown` inputs to a known locale so the\n * caller can use them without further coercion.\n *\n *   if (isLocale(value, ['en', 'pt'])) {\n *     // value: string (known to be 'en' | 'pt' at runtime)\n *   }\n */\nexport function isLocale(\n  value: unknown,\n  locales: readonly string[],\n): value is string {\n  return typeof value === 'string' && locales.includes(value)\n}\n\n/**\n * Coerce arbitrary input into a known locale, falling back to\n * `defaultLocale` for unknowns. Convenient at the consumer's\n * framework boundary (Astro.currentLocale, request headers, etc.).\n */\nexport function pickLocale(input: unknown, opts: LocaleOptions): string {\n  return isLocale(input, opts.locales) ? input : opts.defaultLocale\n}\n\n/**\n * Convert a canonical (default-locale) path into the locale-prefixed\n * variant for `locale`. The default locale's URLs are bare; every\n * other locale prefixes with `/<locale>`.\n *\n *   localizePath('/services/uk-eta', 'en', { defaultLocale: 'en' })\n *     → '/services/uk-eta'\n *   localizePath('/services/uk-eta', 'pt', { defaultLocale: 'en' })\n *     → '/pt/services/uk-eta'\n *   localizePath('/',                'pt', { defaultLocale: 'en' })\n *     → '/pt'\n */\nexport function localizePath(\n  path: string,\n  locale: string,\n  opts: { defaultLocale: string },\n): string {\n  if (locale === opts.defaultLocale) return path\n  if (path === '/') return `/${locale}`\n  return `/${locale}${path.startsWith('/') ? path : `/${path}`}`\n}\n\n/**\n * Strip a non-default locale prefix off a pathname. The inverse\n * of `localizePath` — useful for normalising back to a canonical\n * path before re-localising for a different locale (the language\n * switcher's main job).\n *\n *   stripLocalePrefix('/pt/about',  ...) → '/about'\n *   stripLocalePrefix('/about',     ...) → '/about'    (already canonical)\n *   stripLocalePrefix('/pt',        ...) → '/'\n *   stripLocalePrefix('/en/foo',    { defaultLocale: 'en', … })\n *     → '/en/foo'   (en is default — no prefix to strip)\n */\nexport function stripLocalePrefix(\n  pathname: string,\n  opts: LocaleOptions,\n): string {\n  for (const locale of opts.locales) {\n    if (locale === opts.defaultLocale) continue\n    const prefix = `/${locale}`\n    if (pathname === prefix || pathname === `${prefix}/`) return '/'\n    if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length)\n  }\n  return pathname\n}\n","/**\n * Navigation resolver.\n *\n * Turns a `BrandfineNavigation` (locale-agnostic shape from the\n * external API) into a `HydratedNav` ready for a specific locale —\n * URLs computed, labels picked, hidden items dropped, children\n * grouped under their parent. Header / Footer components consume\n * the hydrated form directly.\n *\n * The semantics encoded here come from olavisa but are\n * generalised:\n *   - POST items resolve URLs via `post.locales`. If the active\n *     locale has no translation, fall back to the default-locale\n *     URL. Consumers can override the URL pattern entirely via\n *     `urlForPost`.\n *   - CUSTOM_URL items: paths (start with `/`) run through\n *     `localizePath`; anything with a scheme (https://, mailto:)\n *     passes through unchanged.\n *   - Labels: per-locale override → default-locale label → any\n *     populated label (last-resort, covers single-locale fills) →\n *     for POST items, the post's per-locale title.\n *   - `hiddenLocales` drops the item entirely for that locale.\n */\n\nimport type {\n  BrandfineNavItem,\n  BrandfineNavPost,\n  BrandfineNavigation,\n} from '../types'\nimport { localizePath } from './locale'\n\nexport type HydratedNavItem = {\n  /** Final URL, ready to render in an `<a href>`. `null` for\n   *  HEADING items (label-only) and for POST items whose post\n   *  has been deleted (orphan). */\n  href: string | null\n  label: string\n  type: 'CUSTOM_URL' | 'POST' | 'HEADING'\n  /** Optional image URL, passed through from the item. Not\n   *  per-locale; `null` when unset. */\n  imageUrl: string | null\n  children: HydratedNavItem[]\n}\n\nexport type HydratedNav = {\n  key: string\n  name: string\n  items: HydratedNavItem[]\n}\n\nexport type ResolveNavigationOptions = {\n  defaultLocale: string\n  /** Override the URL pattern for POST items. Default:\n   *  `localizePath('/${postTypeSlug}/${sibling.slug}', linkLocale)`.\n   *\n   *  Use when a consumer routes posts under a non-default prefix\n   *  (e.g. `/blog/<slug>` instead of `/posts/<slug>`), or wants\n   *  to omit the locale prefix for specific post types. */\n  urlForPost?: (args: {\n    post: BrandfineNavPost\n    sibling: BrandfineNavPost['locales'][number]\n    locale: string\n    defaultLocale: string\n  }) => string | null\n}\n\nexport function resolveNavigation(\n  nav: BrandfineNavigation,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNav {\n  const childrenByParent = new Map<string, BrandfineNavItem[]>()\n  for (const item of nav.items) {\n    if (!item.parentId) continue\n    const arr = childrenByParent.get(item.parentId) ?? []\n    arr.push(item)\n    childrenByParent.set(item.parentId, arr)\n  }\n  // Array-position dictates sibling order within a parent —\n  // matches the cms editor's render contract.\n  const topLevel = nav.items.filter((i) => i.parentId === null)\n\n  return {\n    key: nav.key,\n    name: nav.name,\n    items: topLevel\n      .filter((item) => !item.hiddenLocales.includes(locale))\n      .map((item) =>\n        hydrate(\n          item,\n          (childrenByParent.get(item.id) ?? []).filter(\n            (c) => !c.hiddenLocales.includes(locale),\n          ),\n          locale,\n          opts,\n        ),\n      ),\n  }\n}\n\nfunction hydrate(\n  item: BrandfineNavItem,\n  children: BrandfineNavItem[],\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNavItem {\n  return {\n    href: resolveHref(item, locale, opts),\n    label: resolveLabel(item, locale, opts.defaultLocale),\n    type: item.type,\n    imageUrl: item.imageUrl ?? null,\n    children: children.map((c) => hydrate(c, [], locale, opts)),\n  }\n}\n\nfunction resolveHref(\n  item: BrandfineNavItem,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): string | null {\n  if (item.type === 'HEADING') return null\n\n  if (item.type === 'CUSTOM_URL') {\n    const url = item.customUrl ?? ''\n    if (!url) return null\n    // External (scheme:) and protocol-relative URLs pass through;\n    // `localizePath` would mangle them. Anything else is treated\n    // as a path on the consumer site.\n    if (/^([a-z][a-z0-9+.-]*:)|^\\/\\//i.test(url)) return url\n    return localizePath(\n      url.startsWith('/') ? url : `/${url}`,\n      locale,\n      { defaultLocale: opts.defaultLocale },\n    )\n  }\n\n  // POST\n  const post = item.post\n  if (!post) return null\n\n  // Pick the sibling for the active locale, falling back to the\n  // default-locale sibling, then any sibling. If none exist, the\n  // post has no published translations.\n  const sibling =\n    post.locales.find((s) => s.locale === locale) ??\n    post.locales.find((s) => s.locale === opts.defaultLocale) ??\n    post.locales[0]\n  if (!sibling) return null\n\n  // The URL prefix the user navigates to — `locale` when this\n  // post has a translation in `locale`, else `defaultLocale` so\n  // we land on the default-locale page (Astro's i18n rewrite or\n  // similar serves the right content under the right URL).\n  const linkLocale = post.locales.some((s) => s.locale === locale)\n    ? locale\n    : opts.defaultLocale\n\n  if (opts.urlForPost) {\n    return opts.urlForPost({\n      post,\n      sibling,\n      locale: linkLocale,\n      defaultLocale: opts.defaultLocale,\n    })\n  }\n\n  // Default convention: `/<postTypeSlug>/<sibling.slug>`.\n  // Orphan posts (postType deleted) have no path — return null so\n  // the consumer can render an unlinked label or skip the item.\n  if (!post.postTypeSlug) return null\n  return localizePath(\n    `/${post.postTypeSlug}/${sibling.slug}`,\n    linkLocale,\n    { defaultLocale: opts.defaultLocale },\n  )\n}\n\nfunction resolveLabel(\n  item: BrandfineNavItem,\n  locale: string,\n  defaultLocale: string,\n): string {\n  const labels = item.labels ?? {}\n  // Active locale override → default-locale label → any other\n  // populated label (last-resort, useful when editors only fill\n  // one locale). Empty strings are treated as \"not set\".\n  const override =\n    labels[locale]?.trim() ||\n    labels[defaultLocale]?.trim() ||\n    Object.values(labels)\n      .map((v) => v?.trim())\n      .find((v) => Boolean(v)) ||\n    ''\n  if (override) return override\n\n  if (item.type === 'POST' && item.post) {\n    const sibling =\n      item.post.locales.find((s) => s.locale === locale) ??\n      item.post.locales.find((s) => s.locale === defaultLocale) ??\n      item.post.locales[0]\n    if (sibling) return sibling.title\n  }\n  return ''\n}\n"]}

package/dist/{index-CnR601Y2.d.cts → index-D4SS91_D.d.cts}

@@ -115,6 +115,9 @@ type BrandfineNavItem = {
     type: BrandfineNavItemType;
     /** CUSTOM_URL: free-form path or absolute URL. */
     customUrl: string | null;
+    /** Optional image URL for the item (icon, thumbnail, mega-menu
+     *  art). Set on any item type; not per-locale. Null when unset. */
+    imageUrl: string | null;
     /** `{ [locale]: string }` map. May be null on POST items —
      *  consumers fall back to the post's per-locale `title` then. */
     labels: Record<string, string> | null;
@@ -265,6 +268,9 @@ type HydratedNavItem = {
     href: string | null;
     label: string;
     type: 'CUSTOM_URL' | 'POST' | 'HEADING';
+    /** Optional image URL, passed through from the item. Not
+     *  per-locale; `null` when unset. */
+    imageUrl: string | null;
     children: HydratedNavItem[];
 };
 type HydratedNav = {

package/dist/{index-CnR601Y2.d.ts → index-D4SS91_D.d.ts}

@@ -115,6 +115,9 @@ type BrandfineNavItem = {
     type: BrandfineNavItemType;
     /** CUSTOM_URL: free-form path or absolute URL. */
     customUrl: string | null;
+    /** Optional image URL for the item (icon, thumbnail, mega-menu
+     *  art). Set on any item type; not per-locale. Null when unset. */
+    imageUrl: string | null;
     /** `{ [locale]: string }` map. May be null on POST items —
      *  consumers fall back to the post's per-locale `title` then. */
     labels: Record<string, string> | null;
@@ -265,6 +268,9 @@ type HydratedNavItem = {
     href: string | null;
     label: string;
     type: 'CUSTOM_URL' | 'POST' | 'HEADING';
+    /** Optional image URL, passed through from the item. Not
+     *  per-locale; `null` when unset. */
+    imageUrl: string | null;
     children: HydratedNavItem[];
 };
 type HydratedNav = {

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkXJFKL2HU_cjs = require('./chunk-XJFKL2HU.cjs');
-var chunkOKIEA3AD_cjs = require('./chunk-OKIEA3AD.cjs');
+var chunk2VCPYNF5_cjs = require('./chunk-2VCPYNF5.cjs');
 var chunkKHHMR2NX_cjs = require('./chunk-KHHMR2NX.cjs');
 
 // src/client.ts
@@ -122,23 +122,23 @@ Object.defineProperty(exports, "createKeyedCache", {
 });
 Object.defineProperty(exports, "isLocale", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.isLocale; }
+  get: function () { return chunk2VCPYNF5_cjs.isLocale; }
 });
 Object.defineProperty(exports, "localizePath", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.localizePath; }
+  get: function () { return chunk2VCPYNF5_cjs.localizePath; }
 });
 Object.defineProperty(exports, "pickLocale", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.pickLocale; }
+  get: function () { return chunk2VCPYNF5_cjs.pickLocale; }
 });
 Object.defineProperty(exports, "resolveNavigation", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.resolveNavigation; }
+  get: function () { return chunk2VCPYNF5_cjs.resolveNavigation; }
 });
 Object.defineProperty(exports, "stripLocalePrefix", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.stripLocalePrefix; }
+  get: function () { return chunk2VCPYNF5_cjs.stripLocalePrefix; }
 });
 Object.defineProperty(exports, "createBrandfineWebhookHandler", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { L as ListPostsOptions, B as BrandfinePost, a as ListCategoriesOptions, b as BrandfineCategory, c as BrandfineWorkspace, d as BrandfineNavigation } from './index-CnR601Y2.cjs';
-export { e as BrandfineNavItem, f as BrandfineNavItemType, g as BrandfineNavPost, h as BrandfinePostListResponse, i as BrandfinePostTranslation, H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from './index-CnR601Y2.cjs';
+import { L as ListPostsOptions, B as BrandfinePost, a as ListCategoriesOptions, b as BrandfineCategory, c as BrandfineWorkspace, d as BrandfineNavigation } from './index-D4SS91_D.cjs';
+export { e as BrandfineNavItem, f as BrandfineNavItemType, g as BrandfineNavPost, h as BrandfinePostListResponse, i as BrandfinePostTranslation, H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from './index-D4SS91_D.cjs';
 export { Cache, CacheOptions, KeyedCache, KeyedCacheOptions, createCache, createKeyedCache } from './cache/index.cjs';
 export { BrandfineWebhookEvent, BrandfineWebhookHandlerOptions, BrandfineWebhookPayload, createBrandfineWebhookHandler, parseWebhookPayload, verifyWebhookSecret } from './webhook/index.cjs';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as ListPostsOptions, B as BrandfinePost, a as ListCategoriesOptions, b as BrandfineCategory, c as BrandfineWorkspace, d as BrandfineNavigation } from './index-CnR601Y2.js';
-export { e as BrandfineNavItem, f as BrandfineNavItemType, g as BrandfineNavPost, h as BrandfinePostListResponse, i as BrandfinePostTranslation, H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from './index-CnR601Y2.js';
+import { L as ListPostsOptions, B as BrandfinePost, a as ListCategoriesOptions, b as BrandfineCategory, c as BrandfineWorkspace, d as BrandfineNavigation } from './index-D4SS91_D.js';
+export { e as BrandfineNavItem, f as BrandfineNavItemType, g as BrandfineNavPost, h as BrandfinePostListResponse, i as BrandfinePostTranslation, H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from './index-D4SS91_D.js';
 export { Cache, CacheOptions, KeyedCache, KeyedCacheOptions, createCache, createKeyedCache } from './cache/index.js';
 export { BrandfineWebhookEvent, BrandfineWebhookHandlerOptions, BrandfineWebhookPayload, createBrandfineWebhookHandler, parseWebhookPayload, verifyWebhookSecret } from './webhook/index.js';
 

package/dist/index.js

@@ -1,5 +1,5 @@
 export { createCache, createKeyedCache } from './chunk-DHQHUIFO.js';
-export { isLocale, localizePath, pickLocale, resolveNavigation, stripLocalePrefix } from './chunk-MTBSSTTG.js';
+export { isLocale, localizePath, pickLocale, resolveNavigation, stripLocalePrefix } from './chunk-3OXDF4ZY.js';
 export { createBrandfineWebhookHandler, parseWebhookPayload, verifyWebhookSecret } from './chunk-QQLAYITF.js';
 
 // src/client.ts

package/dist/resolvers/index.cjs

@@ -1,28 +1,28 @@
 'use strict';
 
-var chunkOKIEA3AD_cjs = require('../chunk-OKIEA3AD.cjs');
+var chunk2VCPYNF5_cjs = require('../chunk-2VCPYNF5.cjs');
 
 
 
 Object.defineProperty(exports, "isLocale", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.isLocale; }
+  get: function () { return chunk2VCPYNF5_cjs.isLocale; }
 });
 Object.defineProperty(exports, "localizePath", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.localizePath; }
+  get: function () { return chunk2VCPYNF5_cjs.localizePath; }
 });
 Object.defineProperty(exports, "pickLocale", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.pickLocale; }
+  get: function () { return chunk2VCPYNF5_cjs.pickLocale; }
 });
 Object.defineProperty(exports, "resolveNavigation", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.resolveNavigation; }
+  get: function () { return chunk2VCPYNF5_cjs.resolveNavigation; }
 });
 Object.defineProperty(exports, "stripLocalePrefix", {
   enumerable: true,
-  get: function () { return chunkOKIEA3AD_cjs.stripLocalePrefix; }
+  get: function () { return chunk2VCPYNF5_cjs.stripLocalePrefix; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/resolvers/index.d.cts

@@ -1 +1 @@
-export { H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from '../index-CnR601Y2.cjs';
+export { H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from '../index-D4SS91_D.cjs';

package/dist/resolvers/index.d.ts

@@ -1 +1 @@
-export { H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from '../index-CnR601Y2.js';
+export { H as HydratedNav, j as HydratedNavItem, k as LocaleOptions, R as ResolveNavigationOptions, l as isLocale, m as localizePath, p as pickLocale, r as resolveNavigation, s as stripLocalePrefix } from '../index-D4SS91_D.js';

package/dist/resolvers/index.js

@@ -1,3 +1,3 @@
-export { isLocale, localizePath, pickLocale, resolveNavigation, stripLocalePrefix } from '../chunk-MTBSSTTG.js';
+export { isLocale, localizePath, pickLocale, resolveNavigation, stripLocalePrefix } from '../chunk-3OXDF4ZY.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brandfine/client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Brandfine consumer SDK — typed HTTP client, server-side caches, locale + navigation resolvers, and webhook helpers for landing-page integrations.",
   "license": "MIT",
   "type": "module",

package/dist/chunk-MTBSSTTG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resolvers/locale.ts","../src/resolvers/navigation.ts"],"names":[],"mappings":"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","file":"chunk-MTBSSTTG.js","sourcesContent":["/**\n * Locale helpers.\n *\n * Pure functions over BCP47 locale codes. Olavisa's in-tree\n * version reads `LOCALES` and `DEFAULT_LOCALE` from module-level\n * constants — the package takes them as options instead so a\n * single SDK instance can serve callers with different locale\n * sets (multi-tenant, preview environments, tests).\n *\n * The conventional URL shape these helpers assume:\n *   - The `defaultLocale` is served at the bare URL: `/about`\n *   - Other locales get a path prefix: `/pt/about`, `/es/about`\n *   - `pickLocale` falls back to `defaultLocale` for unknown\n *     inputs. Don't throw — `Astro.currentLocale` is `string |\n *     undefined`, and callers shouldn't have to defend against\n *     every framework's quirk.\n */\n\nexport type LocaleOptions = {\n  /** Locales the consumer serves, in any order. The list is used\n   *  for membership checks (`isLocale`), prefix detection\n   *  (`stripLocalePrefix`), and as the codomain of `pickLocale`. */\n  locales: readonly string[]\n  /** The locale served at bare URLs. Must appear in `locales`. */\n  defaultLocale: string\n}\n\n/**\n * Type guard. Narrows `unknown` inputs to a known locale so the\n * caller can use them without further coercion.\n *\n *   if (isLocale(value, ['en', 'pt'])) {\n *     // value: string (known to be 'en' | 'pt' at runtime)\n *   }\n */\nexport function isLocale(\n  value: unknown,\n  locales: readonly string[],\n): value is string {\n  return typeof value === 'string' && locales.includes(value)\n}\n\n/**\n * Coerce arbitrary input into a known locale, falling back to\n * `defaultLocale` for unknowns. Convenient at the consumer's\n * framework boundary (Astro.currentLocale, request headers, etc.).\n */\nexport function pickLocale(input: unknown, opts: LocaleOptions): string {\n  return isLocale(input, opts.locales) ? input : opts.defaultLocale\n}\n\n/**\n * Convert a canonical (default-locale) path into the locale-prefixed\n * variant for `locale`. The default locale's URLs are bare; every\n * other locale prefixes with `/<locale>`.\n *\n *   localizePath('/services/uk-eta', 'en', { defaultLocale: 'en' })\n *     → '/services/uk-eta'\n *   localizePath('/services/uk-eta', 'pt', { defaultLocale: 'en' })\n *     → '/pt/services/uk-eta'\n *   localizePath('/',                'pt', { defaultLocale: 'en' })\n *     → '/pt'\n */\nexport function localizePath(\n  path: string,\n  locale: string,\n  opts: { defaultLocale: string },\n): string {\n  if (locale === opts.defaultLocale) return path\n  if (path === '/') return `/${locale}`\n  return `/${locale}${path.startsWith('/') ? path : `/${path}`}`\n}\n\n/**\n * Strip a non-default locale prefix off a pathname. The inverse\n * of `localizePath` — useful for normalising back to a canonical\n * path before re-localising for a different locale (the language\n * switcher's main job).\n *\n *   stripLocalePrefix('/pt/about',  ...) → '/about'\n *   stripLocalePrefix('/about',     ...) → '/about'    (already canonical)\n *   stripLocalePrefix('/pt',        ...) → '/'\n *   stripLocalePrefix('/en/foo',    { defaultLocale: 'en', … })\n *     → '/en/foo'   (en is default — no prefix to strip)\n */\nexport function stripLocalePrefix(\n  pathname: string,\n  opts: LocaleOptions,\n): string {\n  for (const locale of opts.locales) {\n    if (locale === opts.defaultLocale) continue\n    const prefix = `/${locale}`\n    if (pathname === prefix || pathname === `${prefix}/`) return '/'\n    if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length)\n  }\n  return pathname\n}\n","/**\n * Navigation resolver.\n *\n * Turns a `BrandfineNavigation` (locale-agnostic shape from the\n * external API) into a `HydratedNav` ready for a specific locale —\n * URLs computed, labels picked, hidden items dropped, children\n * grouped under their parent. Header / Footer components consume\n * the hydrated form directly.\n *\n * The semantics encoded here come from olavisa but are\n * generalised:\n *   - POST items resolve URLs via `post.locales`. If the active\n *     locale has no translation, fall back to the default-locale\n *     URL. Consumers can override the URL pattern entirely via\n *     `urlForPost`.\n *   - CUSTOM_URL items: paths (start with `/`) run through\n *     `localizePath`; anything with a scheme (https://, mailto:)\n *     passes through unchanged.\n *   - Labels: per-locale override → default-locale label → any\n *     populated label (last-resort, covers single-locale fills) →\n *     for POST items, the post's per-locale title.\n *   - `hiddenLocales` drops the item entirely for that locale.\n */\n\nimport type {\n  BrandfineNavItem,\n  BrandfineNavPost,\n  BrandfineNavigation,\n} from '../types'\nimport { localizePath } from './locale'\n\nexport type HydratedNavItem = {\n  /** Final URL, ready to render in an `<a href>`. `null` for\n   *  HEADING items (label-only) and for POST items whose post\n   *  has been deleted (orphan). */\n  href: string | null\n  label: string\n  type: 'CUSTOM_URL' | 'POST' | 'HEADING'\n  children: HydratedNavItem[]\n}\n\nexport type HydratedNav = {\n  key: string\n  name: string\n  items: HydratedNavItem[]\n}\n\nexport type ResolveNavigationOptions = {\n  defaultLocale: string\n  /** Override the URL pattern for POST items. Default:\n   *  `localizePath('/${postTypeSlug}/${sibling.slug}', linkLocale)`.\n   *\n   *  Use when a consumer routes posts under a non-default prefix\n   *  (e.g. `/blog/<slug>` instead of `/posts/<slug>`), or wants\n   *  to omit the locale prefix for specific post types. */\n  urlForPost?: (args: {\n    post: BrandfineNavPost\n    sibling: BrandfineNavPost['locales'][number]\n    locale: string\n    defaultLocale: string\n  }) => string | null\n}\n\nexport function resolveNavigation(\n  nav: BrandfineNavigation,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNav {\n  const childrenByParent = new Map<string, BrandfineNavItem[]>()\n  for (const item of nav.items) {\n    if (!item.parentId) continue\n    const arr = childrenByParent.get(item.parentId) ?? []\n    arr.push(item)\n    childrenByParent.set(item.parentId, arr)\n  }\n  // Array-position dictates sibling order within a parent —\n  // matches the cms editor's render contract.\n  const topLevel = nav.items.filter((i) => i.parentId === null)\n\n  return {\n    key: nav.key,\n    name: nav.name,\n    items: topLevel\n      .filter((item) => !item.hiddenLocales.includes(locale))\n      .map((item) =>\n        hydrate(\n          item,\n          (childrenByParent.get(item.id) ?? []).filter(\n            (c) => !c.hiddenLocales.includes(locale),\n          ),\n          locale,\n          opts,\n        ),\n      ),\n  }\n}\n\nfunction hydrate(\n  item: BrandfineNavItem,\n  children: BrandfineNavItem[],\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNavItem {\n  return {\n    href: resolveHref(item, locale, opts),\n    label: resolveLabel(item, locale, opts.defaultLocale),\n    type: item.type,\n    children: children.map((c) => hydrate(c, [], locale, opts)),\n  }\n}\n\nfunction resolveHref(\n  item: BrandfineNavItem,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): string | null {\n  if (item.type === 'HEADING') return null\n\n  if (item.type === 'CUSTOM_URL') {\n    const url = item.customUrl ?? ''\n    if (!url) return null\n    // External (scheme:) and protocol-relative URLs pass through;\n    // `localizePath` would mangle them. Anything else is treated\n    // as a path on the consumer site.\n    if (/^([a-z][a-z0-9+.-]*:)|^\\/\\//i.test(url)) return url\n    return localizePath(\n      url.startsWith('/') ? url : `/${url}`,\n      locale,\n      { defaultLocale: opts.defaultLocale },\n    )\n  }\n\n  // POST\n  const post = item.post\n  if (!post) return null\n\n  // Pick the sibling for the active locale, falling back to the\n  // default-locale sibling, then any sibling. If none exist, the\n  // post has no published translations.\n  const sibling =\n    post.locales.find((s) => s.locale === locale) ??\n    post.locales.find((s) => s.locale === opts.defaultLocale) ??\n    post.locales[0]\n  if (!sibling) return null\n\n  // The URL prefix the user navigates to — `locale` when this\n  // post has a translation in `locale`, else `defaultLocale` so\n  // we land on the default-locale page (Astro's i18n rewrite or\n  // similar serves the right content under the right URL).\n  const linkLocale = post.locales.some((s) => s.locale === locale)\n    ? locale\n    : opts.defaultLocale\n\n  if (opts.urlForPost) {\n    return opts.urlForPost({\n      post,\n      sibling,\n      locale: linkLocale,\n      defaultLocale: opts.defaultLocale,\n    })\n  }\n\n  // Default convention: `/<postTypeSlug>/<sibling.slug>`.\n  // Orphan posts (postType deleted) have no path — return null so\n  // the consumer can render an unlinked label or skip the item.\n  if (!post.postTypeSlug) return null\n  return localizePath(\n    `/${post.postTypeSlug}/${sibling.slug}`,\n    linkLocale,\n    { defaultLocale: opts.defaultLocale },\n  )\n}\n\nfunction resolveLabel(\n  item: BrandfineNavItem,\n  locale: string,\n  defaultLocale: string,\n): string {\n  const labels = item.labels ?? {}\n  // Active locale override → default-locale label → any other\n  // populated label (last-resort, useful when editors only fill\n  // one locale). Empty strings are treated as \"not set\".\n  const override =\n    labels[locale]?.trim() ||\n    labels[defaultLocale]?.trim() ||\n    Object.values(labels)\n      .map((v) => v?.trim())\n      .find((v) => Boolean(v)) ||\n    ''\n  if (override) return override\n\n  if (item.type === 'POST' && item.post) {\n    const sibling =\n      item.post.locales.find((s) => s.locale === locale) ??\n      item.post.locales.find((s) => s.locale === defaultLocale) ??\n      item.post.locales[0]\n    if (sibling) return sibling.title\n  }\n  return ''\n}\n"]}

package/dist/chunk-OKIEA3AD.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resolvers/locale.ts","../src/resolvers/navigation.ts"],"names":[],"mappings":"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","file":"chunk-OKIEA3AD.cjs","sourcesContent":["/**\n * Locale helpers.\n *\n * Pure functions over BCP47 locale codes. Olavisa's in-tree\n * version reads `LOCALES` and `DEFAULT_LOCALE` from module-level\n * constants — the package takes them as options instead so a\n * single SDK instance can serve callers with different locale\n * sets (multi-tenant, preview environments, tests).\n *\n * The conventional URL shape these helpers assume:\n *   - The `defaultLocale` is served at the bare URL: `/about`\n *   - Other locales get a path prefix: `/pt/about`, `/es/about`\n *   - `pickLocale` falls back to `defaultLocale` for unknown\n *     inputs. Don't throw — `Astro.currentLocale` is `string |\n *     undefined`, and callers shouldn't have to defend against\n *     every framework's quirk.\n */\n\nexport type LocaleOptions = {\n  /** Locales the consumer serves, in any order. The list is used\n   *  for membership checks (`isLocale`), prefix detection\n   *  (`stripLocalePrefix`), and as the codomain of `pickLocale`. */\n  locales: readonly string[]\n  /** The locale served at bare URLs. Must appear in `locales`. */\n  defaultLocale: string\n}\n\n/**\n * Type guard. Narrows `unknown` inputs to a known locale so the\n * caller can use them without further coercion.\n *\n *   if (isLocale(value, ['en', 'pt'])) {\n *     // value: string (known to be 'en' | 'pt' at runtime)\n *   }\n */\nexport function isLocale(\n  value: unknown,\n  locales: readonly string[],\n): value is string {\n  return typeof value === 'string' && locales.includes(value)\n}\n\n/**\n * Coerce arbitrary input into a known locale, falling back to\n * `defaultLocale` for unknowns. Convenient at the consumer's\n * framework boundary (Astro.currentLocale, request headers, etc.).\n */\nexport function pickLocale(input: unknown, opts: LocaleOptions): string {\n  return isLocale(input, opts.locales) ? input : opts.defaultLocale\n}\n\n/**\n * Convert a canonical (default-locale) path into the locale-prefixed\n * variant for `locale`. The default locale's URLs are bare; every\n * other locale prefixes with `/<locale>`.\n *\n *   localizePath('/services/uk-eta', 'en', { defaultLocale: 'en' })\n *     → '/services/uk-eta'\n *   localizePath('/services/uk-eta', 'pt', { defaultLocale: 'en' })\n *     → '/pt/services/uk-eta'\n *   localizePath('/',                'pt', { defaultLocale: 'en' })\n *     → '/pt'\n */\nexport function localizePath(\n  path: string,\n  locale: string,\n  opts: { defaultLocale: string },\n): string {\n  if (locale === opts.defaultLocale) return path\n  if (path === '/') return `/${locale}`\n  return `/${locale}${path.startsWith('/') ? path : `/${path}`}`\n}\n\n/**\n * Strip a non-default locale prefix off a pathname. The inverse\n * of `localizePath` — useful for normalising back to a canonical\n * path before re-localising for a different locale (the language\n * switcher's main job).\n *\n *   stripLocalePrefix('/pt/about',  ...) → '/about'\n *   stripLocalePrefix('/about',     ...) → '/about'    (already canonical)\n *   stripLocalePrefix('/pt',        ...) → '/'\n *   stripLocalePrefix('/en/foo',    { defaultLocale: 'en', … })\n *     → '/en/foo'   (en is default — no prefix to strip)\n */\nexport function stripLocalePrefix(\n  pathname: string,\n  opts: LocaleOptions,\n): string {\n  for (const locale of opts.locales) {\n    if (locale === opts.defaultLocale) continue\n    const prefix = `/${locale}`\n    if (pathname === prefix || pathname === `${prefix}/`) return '/'\n    if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length)\n  }\n  return pathname\n}\n","/**\n * Navigation resolver.\n *\n * Turns a `BrandfineNavigation` (locale-agnostic shape from the\n * external API) into a `HydratedNav` ready for a specific locale —\n * URLs computed, labels picked, hidden items dropped, children\n * grouped under their parent. Header / Footer components consume\n * the hydrated form directly.\n *\n * The semantics encoded here come from olavisa but are\n * generalised:\n *   - POST items resolve URLs via `post.locales`. If the active\n *     locale has no translation, fall back to the default-locale\n *     URL. Consumers can override the URL pattern entirely via\n *     `urlForPost`.\n *   - CUSTOM_URL items: paths (start with `/`) run through\n *     `localizePath`; anything with a scheme (https://, mailto:)\n *     passes through unchanged.\n *   - Labels: per-locale override → default-locale label → any\n *     populated label (last-resort, covers single-locale fills) →\n *     for POST items, the post's per-locale title.\n *   - `hiddenLocales` drops the item entirely for that locale.\n */\n\nimport type {\n  BrandfineNavItem,\n  BrandfineNavPost,\n  BrandfineNavigation,\n} from '../types'\nimport { localizePath } from './locale'\n\nexport type HydratedNavItem = {\n  /** Final URL, ready to render in an `<a href>`. `null` for\n   *  HEADING items (label-only) and for POST items whose post\n   *  has been deleted (orphan). */\n  href: string | null\n  label: string\n  type: 'CUSTOM_URL' | 'POST' | 'HEADING'\n  children: HydratedNavItem[]\n}\n\nexport type HydratedNav = {\n  key: string\n  name: string\n  items: HydratedNavItem[]\n}\n\nexport type ResolveNavigationOptions = {\n  defaultLocale: string\n  /** Override the URL pattern for POST items. Default:\n   *  `localizePath('/${postTypeSlug}/${sibling.slug}', linkLocale)`.\n   *\n   *  Use when a consumer routes posts under a non-default prefix\n   *  (e.g. `/blog/<slug>` instead of `/posts/<slug>`), or wants\n   *  to omit the locale prefix for specific post types. */\n  urlForPost?: (args: {\n    post: BrandfineNavPost\n    sibling: BrandfineNavPost['locales'][number]\n    locale: string\n    defaultLocale: string\n  }) => string | null\n}\n\nexport function resolveNavigation(\n  nav: BrandfineNavigation,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNav {\n  const childrenByParent = new Map<string, BrandfineNavItem[]>()\n  for (const item of nav.items) {\n    if (!item.parentId) continue\n    const arr = childrenByParent.get(item.parentId) ?? []\n    arr.push(item)\n    childrenByParent.set(item.parentId, arr)\n  }\n  // Array-position dictates sibling order within a parent —\n  // matches the cms editor's render contract.\n  const topLevel = nav.items.filter((i) => i.parentId === null)\n\n  return {\n    key: nav.key,\n    name: nav.name,\n    items: topLevel\n      .filter((item) => !item.hiddenLocales.includes(locale))\n      .map((item) =>\n        hydrate(\n          item,\n          (childrenByParent.get(item.id) ?? []).filter(\n            (c) => !c.hiddenLocales.includes(locale),\n          ),\n          locale,\n          opts,\n        ),\n      ),\n  }\n}\n\nfunction hydrate(\n  item: BrandfineNavItem,\n  children: BrandfineNavItem[],\n  locale: string,\n  opts: ResolveNavigationOptions,\n): HydratedNavItem {\n  return {\n    href: resolveHref(item, locale, opts),\n    label: resolveLabel(item, locale, opts.defaultLocale),\n    type: item.type,\n    children: children.map((c) => hydrate(c, [], locale, opts)),\n  }\n}\n\nfunction resolveHref(\n  item: BrandfineNavItem,\n  locale: string,\n  opts: ResolveNavigationOptions,\n): string | null {\n  if (item.type === 'HEADING') return null\n\n  if (item.type === 'CUSTOM_URL') {\n    const url = item.customUrl ?? ''\n    if (!url) return null\n    // External (scheme:) and protocol-relative URLs pass through;\n    // `localizePath` would mangle them. Anything else is treated\n    // as a path on the consumer site.\n    if (/^([a-z][a-z0-9+.-]*:)|^\\/\\//i.test(url)) return url\n    return localizePath(\n      url.startsWith('/') ? url : `/${url}`,\n      locale,\n      { defaultLocale: opts.defaultLocale },\n    )\n  }\n\n  // POST\n  const post = item.post\n  if (!post) return null\n\n  // Pick the sibling for the active locale, falling back to the\n  // default-locale sibling, then any sibling. If none exist, the\n  // post has no published translations.\n  const sibling =\n    post.locales.find((s) => s.locale === locale) ??\n    post.locales.find((s) => s.locale === opts.defaultLocale) ??\n    post.locales[0]\n  if (!sibling) return null\n\n  // The URL prefix the user navigates to — `locale` when this\n  // post has a translation in `locale`, else `defaultLocale` so\n  // we land on the default-locale page (Astro's i18n rewrite or\n  // similar serves the right content under the right URL).\n  const linkLocale = post.locales.some((s) => s.locale === locale)\n    ? locale\n    : opts.defaultLocale\n\n  if (opts.urlForPost) {\n    return opts.urlForPost({\n      post,\n      sibling,\n      locale: linkLocale,\n      defaultLocale: opts.defaultLocale,\n    })\n  }\n\n  // Default convention: `/<postTypeSlug>/<sibling.slug>`.\n  // Orphan posts (postType deleted) have no path — return null so\n  // the consumer can render an unlinked label or skip the item.\n  if (!post.postTypeSlug) return null\n  return localizePath(\n    `/${post.postTypeSlug}/${sibling.slug}`,\n    linkLocale,\n    { defaultLocale: opts.defaultLocale },\n  )\n}\n\nfunction resolveLabel(\n  item: BrandfineNavItem,\n  locale: string,\n  defaultLocale: string,\n): string {\n  const labels = item.labels ?? {}\n  // Active locale override → default-locale label → any other\n  // populated label (last-resort, useful when editors only fill\n  // one locale). Empty strings are treated as \"not set\".\n  const override =\n    labels[locale]?.trim() ||\n    labels[defaultLocale]?.trim() ||\n    Object.values(labels)\n      .map((v) => v?.trim())\n      .find((v) => Boolean(v)) ||\n    ''\n  if (override) return override\n\n  if (item.type === 'POST' && item.post) {\n    const sibling =\n      item.post.locales.find((s) => s.locale === locale) ??\n      item.post.locales.find((s) => s.locale === defaultLocale) ??\n      item.post.locales[0]\n    if (sibling) return sibling.title\n  }\n  return ''\n}\n"]}