@ingram-tech/nk-blog 0.1.11 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -61,6 +61,49 @@ export default async function Post({ params }: PageProps<"/blog/[slug]">) {
61
61
  }
62
62
  ```
63
63
 
64
+ ## Multilingual blogs
65
+
66
+ Set `defaultLang` and each post is written in one language:
67
+
68
+ ```md
69
+ ---
70
+ title: "Facturation électronique : ce qui change pour les utilisateurs Stripe"
71
+ lang: fr
72
+ translationKey: france-e-invoicing-mandate # the English post's slug; omit for a French-only post
73
+ ---
74
+ ```
75
+
76
+ - **`lang`** is the post's language; posts without it take `defaultLang`.
77
+ - **Slugs are unique per language**, so a translation can reuse its original's
78
+ slug or carry its own (a French slug for French search).
79
+ - **`translationKey`** groups a post with its translations. It defaults to the
80
+ slug, so same-slug posts link without declaring it. A post links only to
81
+ versions that exist: a French-only article advertises no English URL.
82
+
83
+ ```ts
84
+ export const blog = createBlog({ source: fsSource("content/blog"), defaultLang: "en" });
85
+
86
+ await blog.previews({ lang: "fr" }); // the French index
87
+ await blog.post(slug, { lang: "fr" }); // a French post
88
+ const versions = await blog.translations(post);
89
+
90
+ const seoConfig = { baseUrl, basePath: "/blog", defaultLang: "en" };
91
+ postUrl(post, seoConfig); // /blog/what-is, /fr/blog/cest-quoi
92
+ const { canonical, languages } = blogPostAlternates(post, versions, seoConfig);
93
+ // → Metadata.alternates: { canonical, languages }
94
+ ```
95
+
96
+ URLs: default-language posts live at `basePath`, others at `/<lang><basePath>`
97
+ (nk-i18n's prefix shape). Unlike nk-i18n's negotiated pages the default
98
+ language is not prefixed: a post is one document in one language with exactly
99
+ one address, so there is no language-neutral bare URL to reserve. Route the
100
+ other languages with a `[lang]` segment (`app/[lang]/blog/[slug]/page.tsx`,
101
+ `generateStaticParams` over `blog.posts()` minus the default language) so the
102
+ posts stay fully static. `blogPostArticle` sets `inLanguage`; a per-language
103
+ feed is `generateRss({ ...config, basePath: "/fr/blog", language: "fr" },
104
+ await blog.previews({ lang: "fr" }))`. `readTime` is English — localize from
105
+ `readingTimeMinutes`.
106
+
64
107
  ## The rules that keep this portable
65
108
 
66
109
  - **Vocabulary, not imports.** A Tier-1 post references `<Callout>`, `<Figure>`,
package/dist/blog.d.ts CHANGED
@@ -15,6 +15,13 @@ export interface BlogConfig {
15
15
  wordsPerMinute?: number;
16
16
  /** Include drafts (listing pages typically pass `NODE_ENV !== "production"`). */
17
17
  drafts?: boolean;
18
+ /**
19
+ * Language of every post that declares no `lang`. Set it to make the blog
20
+ * multilingual: each post is written in one language, slugs are unique per
21
+ * language, and posts sharing a `translationKey` are one another's
22
+ * translations. Unset, `lang` is only what frontmatter says.
23
+ */
24
+ defaultLang?: string;
18
25
  /**
19
26
  * Site-specific image fallback (e.g. "look in /public/images/posts/<slug>").
20
27
  * This is config precisely so per-site divergence never forks the reader.
@@ -31,15 +38,29 @@ export interface BlogConfig {
31
38
  */
32
39
  onInvalid?: "throw" | "skip";
33
40
  }
41
+ /** Narrows a listing to one language. Omitted, every language is included. */
42
+ export interface LangFilter {
43
+ lang?: string;
44
+ }
34
45
  export interface Blog {
35
46
  /** All non-draft posts, newest first, with bodies. */
36
- posts(): Promise<BlogPost[]>;
47
+ posts(filter?: LangFilter): Promise<BlogPost[]>;
37
48
  /** All non-draft posts, newest first, without bodies. */
38
- previews(): Promise<BlogPostPreview[]>;
39
- post(slug: string): Promise<BlogPost | null>;
40
- slugs(): Promise<string[]>;
49
+ previews(filter?: LangFilter): Promise<BlogPostPreview[]>;
50
+ /**
51
+ * The post at `slug`. Slugs are unique per language, so pass `lang` on a
52
+ * multilingual blog; without it, the `defaultLang` post wins a shared slug.
53
+ */
54
+ post(slug: string, filter?: LangFilter): Promise<BlogPost | null>;
55
+ slugs(filter?: LangFilter): Promise<string[]>;
41
56
  /** The pinned (`featured: true`) post, else the newest. */
42
- featured(): Promise<BlogPost | null>;
57
+ featured(filter?: LangFilter): Promise<BlogPost | null>;
58
+ /**
59
+ * Every language version of `post`, itself included, in `posts()` order —
60
+ * the input to `blogPostAlternates`. Drafts are excluded like everywhere
61
+ * else, so an unpublished translation is never advertised.
62
+ */
63
+ translations(post: BlogPostPreview): Promise<BlogPostPreview[]>;
43
64
  }
44
65
  interface ParsedName {
45
66
  slug: string;
@@ -1 +1 @@
1
- {"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACrC;AAID,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAuDhF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAyCnD"}
1
+ {"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAClE,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAChE;AAID,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAwDhF;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA0EnD"}
package/dist/blog.js CHANGED
@@ -59,7 +59,8 @@ export function parsePost(file, config) {
59
59
  image,
60
60
  draft: frontmatter.draft || named.draftByName,
61
61
  featured: frontmatter.featured,
62
- lang: frontmatter.lang,
62
+ lang: frontmatter.lang ?? config.defaultLang,
63
+ translationKey: frontmatter.translationKey ?? slug,
63
64
  canonical: frontmatter.canonical,
64
65
  format: named.format,
65
66
  readingTimeMinutes: time.minutes,
@@ -67,38 +68,60 @@ export function parsePost(file, config) {
67
68
  content: body,
68
69
  };
69
70
  }
71
+ const inLang = (post, filter) => filter?.lang === undefined || post.lang === filter.lang;
70
72
  export function createBlog(config) {
71
- const posts = async () => {
73
+ const all = async () => {
72
74
  const files = await config.source.load();
73
75
  const parsed = files
74
76
  .map((file) => parsePost(file, config))
75
77
  .filter((post) => post !== null);
76
- // Collision check BEFORE the draft filter: a draft colliding with a live
77
- // post must fail the production build too, not only draft-enabled
78
- // previews. Two files resolving to one slug is a routing conflict —
79
- // always a loud build failure, never a quiet last-one-wins.
80
- const seen = new Map();
78
+ // Collision checks BEFORE the draft filter: a draft colliding with a
79
+ // live post must fail the production build too, not only draft-enabled
80
+ // previews. Two files resolving to one address, or two posts claiming
81
+ // to be the same translation, is a conflict — always a loud build
82
+ // failure, never a quiet last-one-wins.
83
+ const bySlug = new Map();
84
+ const byTranslation = new Map();
81
85
  for (const post of parsed) {
82
- if (seen.has(post.slug)) {
83
- throw new Error(`nk-blog: duplicate slug "${post.slug}"`);
86
+ const where = post.lang === undefined ? "" : ` in lang "${post.lang}"`;
87
+ const slugKey = `${post.lang ?? ""}\0${post.slug}`;
88
+ if (bySlug.has(slugKey)) {
89
+ throw new Error(`nk-blog: duplicate slug "${post.slug}"${where}`);
84
90
  }
85
- seen.set(post.slug, post);
91
+ bySlug.set(slugKey, post);
92
+ const translationKey = `${post.lang ?? ""}\0${post.translationKey}`;
93
+ const claimed = byTranslation.get(translationKey);
94
+ if (claimed) {
95
+ throw new Error(`nk-blog: "${claimed.slug}" and "${post.slug}" are both the${where} version of translation "${post.translationKey}"`);
96
+ }
97
+ byTranslation.set(translationKey, post);
86
98
  }
87
- return [...seen.values()]
99
+ return [...bySlug.values()]
88
100
  .filter((post) => config.drafts === true || !post.draft)
89
101
  .sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime() ||
90
102
  // Same-day posts: deterministic order between builds.
91
- a.slug.localeCompare(b.slug));
103
+ a.slug.localeCompare(b.slug) ||
104
+ (a.lang ?? "").localeCompare(b.lang ?? ""));
92
105
  };
106
+ const posts = async (filter) => (await all()).filter((post) => inLang(post, filter));
93
107
  return {
94
108
  posts,
95
- previews: async () => (await posts()).map(({ content: _content, ...preview }) => preview),
96
- post: async (slug) => (await posts()).find((candidate) => candidate.slug === slug) ?? null,
97
- slugs: async () => (await posts()).map((post) => post.slug),
98
- featured: async () => {
99
- const all = await posts();
100
- return all.find((post) => post.featured) ?? all[0] ?? null;
109
+ previews: async (filter) => (await posts(filter)).map(({ content: _content, ...preview }) => preview),
110
+ post: async (slug, filter) => {
111
+ const matches = (await posts(filter)).filter((candidate) => candidate.slug === slug);
112
+ return (matches.find((candidate) => candidate.lang === config.defaultLang) ??
113
+ matches[0] ??
114
+ null);
115
+ },
116
+ slugs: async (filter) => (await posts(filter)).map((post) => post.slug),
117
+ featured: async (filter) => {
118
+ const listed = await posts(filter);
119
+ return listed.find((post) => post.featured) ?? listed[0] ?? null;
101
120
  },
121
+ translations: async (post) => (await all())
122
+ .filter((candidate) => (candidate.translationKey ?? candidate.slug) ===
123
+ (post.translationKey ?? post.slug))
124
+ .map(({ content: _content, ...preview }) => preview),
102
125
  };
103
126
  }
104
127
  //# sourceMappingURL=blog.js.map
package/dist/blog.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -3,5 +3,5 @@ export type { BlogPost, BlogPostPreview, PostFormat } from "./types.js";
3
3
  export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, type BlogComponents, type VocabularyName, type VocabularyPropsMap, type CalloutProps, type FigureProps, type YouTubeProps, type TweetProps, type NewsletterSubscribeProps, } from "./contract.js";
4
4
  export { readingTime, DEFAULT_WORDS_PER_MINUTE, type ReadingTime, } from "./reading-time.js";
5
5
  export { formatPostDate } from "./date.js";
6
- export { blogPostArticle, blogPostBreadcrumbs, postUrl, type BlogSeoConfig, } from "./seo.js";
6
+ export { blogIndexUrl, blogPostAlternates, blogPostArticle, blogPostBreadcrumbs, postUrl, type BlogPostAlternates, type BlogSeoConfig, } from "./seo.js";
7
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,KAAK,aAAa,GAClB,MAAM,UAAU,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,KAAK,kBAAkB,EACvB,KAAK,aAAa,GAClB,MAAM,UAAU,CAAC"}
package/dist/index.js CHANGED
@@ -6,5 +6,5 @@ export { blogFrontmatterSchema, } from "./schema.js";
6
6
  export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, } from "./contract.js";
7
7
  export { readingTime, DEFAULT_WORDS_PER_MINUTE, } from "./reading-time.js";
8
8
  export { formatPostDate } from "./date.js";
9
- export { blogPostArticle, blogPostBreadcrumbs, postUrl, } from "./seo.js";
9
+ export { blogIndexUrl, blogPostAlternates, blogPostArticle, blogPostBreadcrumbs, postUrl, } from "./seo.js";
10
10
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,OAAO,EACN,qBAAqB,GAGrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,GASxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,GAEP,MAAM,UAAU,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,OAAO,EACN,qBAAqB,GAGrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,GASxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,GAGP,MAAM,UAAU,CAAC"}
package/dist/schema.d.ts CHANGED
@@ -29,6 +29,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
29
29
  draft: z.ZodDefault<z.ZodBoolean>;
30
30
  featured: z.ZodDefault<z.ZodBoolean>;
31
31
  lang: z.ZodOptional<z.ZodString>;
32
+ translationKey: z.ZodOptional<z.ZodString>;
32
33
  canonical: z.ZodOptional<z.ZodString>;
33
34
  }, z.core.$strip>, z.ZodTransform<{
34
35
  title: string;
@@ -42,6 +43,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
42
43
  draft: boolean;
43
44
  featured: boolean;
44
45
  lang?: string | undefined;
46
+ translationKey?: string | undefined;
45
47
  canonical?: string | undefined;
46
48
  image: string | undefined;
47
49
  authors: string[];
@@ -61,6 +63,7 @@ export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
61
63
  draft: boolean;
62
64
  featured: boolean;
63
65
  lang?: string | undefined;
66
+ translationKey?: string | undefined;
64
67
  canonical?: string | undefined;
65
68
  }>>;
66
69
  export type BlogFrontmatter = z.infer<typeof blogFrontmatterSchema>;
@@ -1 +1 @@
1
- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAS5D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwB9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAS5D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6B9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
package/dist/schema.js CHANGED
@@ -46,8 +46,13 @@ export const blogFrontmatterSchema = z
46
46
  slug: slugSchema.optional(),
47
47
  draft: z.boolean().default(false),
48
48
  featured: z.boolean().default(false),
49
- // Reserved fields — validated now so adding behavior later isn't breaking.
49
+ // The post's language (e.g. "fr"); `BlogConfig.defaultLang` when absent.
50
50
  lang: nonEmpty.optional(),
51
+ // Groups a post with its translations; defaults to the slug, so posts
52
+ // sharing a slug across languages link without declaring it. Set it
53
+ // when a translation carries its own slug.
54
+ translationKey: nonEmpty.optional(),
55
+ // Reserved — validated now so adding behavior later isn't breaking.
51
56
  canonical: nonEmpty.optional(),
52
57
  })
53
58
  .transform(({ author, authors, coverImage, image, ...rest }) => ({
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,6DAA6D;AAC7D,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,iBAAiB,MAAM,CAAC,KAAK,CAAC,iCAAiC;SACxE,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,KAAK,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAE5D,MAAM,UAAU,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,KAAK,CACL,WAAW,EACX,0EAA0E,CAC1E,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACpC,MAAM,CAAC;IACP,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,GAAG,IAAI;IACP,KAAK,EAAE,KAAK,IAAI,UAAU;IAC1B,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7E,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
package/dist/seo.d.ts CHANGED
@@ -9,8 +9,39 @@ export interface BlogSeoConfig {
9
9
  publisher?: OrganizationInput;
10
10
  /** Crumb label for the blog index; defaults to "Blog". */
11
11
  blogName?: string;
12
+ /**
13
+ * The blog's default language — the same value as `BlogConfig.defaultLang`.
14
+ * Its posts live at `basePath`; every other language's posts at
15
+ * `/<lang><basePath>` (`/fr/blog/<slug>`), matching nk-i18n's prefix
16
+ * strategy. Unset, no URL carries a language.
17
+ *
18
+ * The default language is deliberately unprefixed, unlike nk-i18n's
19
+ * negotiated pages: a post is one document in one language, not a page
20
+ * rendered per visitor, so it has exactly one address and there is no
21
+ * language-neutral bare URL to keep free.
22
+ */
23
+ defaultLang?: string;
12
24
  }
25
+ /** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
26
+ export declare function blogIndexUrl(lang: string | undefined, config: BlogSeoConfig): string;
27
+ /** Absolute URL of a post, prefixed by its language when that isn't the default. */
13
28
  export declare function postUrl(post: BlogPostPreview, config: BlogSeoConfig): string;
29
+ export interface BlogPostAlternates {
30
+ /** The post's own address, or its `canonical` override. */
31
+ canonical: string;
32
+ /**
33
+ * hreflang → URL for every language version, plus `x-default` pointing at
34
+ * the default-language version when there is one. Empty for a post with no
35
+ * translation: a single-member cluster says nothing.
36
+ */
37
+ languages: Record<string, string>;
38
+ }
39
+ /**
40
+ * Canonical + hreflang alternates for a post, from `blog.translations(post)`.
41
+ * Spread into Next's `Metadata.alternates`. A post links only to versions that
42
+ * exist, so a French-only article never advertises an English URL.
43
+ */
44
+ export declare function blogPostAlternates(post: BlogPostPreview, translations: readonly BlogPostPreview[], config: BlogSeoConfig): BlogPostAlternates;
14
45
  /** BlogPosting JSON-LD for a post — the nk-seo bridge. */
15
46
  export declare function blogPostArticle(post: BlogPostPreview, config: BlogSeoConfig, overrides?: Partial<ArticleInput>): WithContext<ArticleNode>;
16
47
  /** Home → Blog → Post breadcrumb JSON-LD. */
package/dist/seo.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5E;AAaD,0DAA0D;AAC1D,wBAAgB,eAAe,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACnC,WAAW,CAAC,WAAW,CAAC,CAc1B;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,GACnB,WAAW,CAAC,kBAAkB,CAAC,CAMjC"}
1
+ {"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAEpF;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5E;AAED,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,SAAS,eAAe,EAAE,EACxC,MAAM,EAAE,aAAa,GACnB,kBAAkB,CAepB;AAaD,0DAA0D;AAC1D,wBAAgB,eAAe,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACnC,WAAW,CAAC,WAAW,CAAC,CAe1B;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,GACnB,WAAW,CAAC,kBAAkB,CAAC,CAMjC"}
package/dist/seo.js CHANGED
@@ -1,6 +1,37 @@
1
1
  import { article, breadcrumbList, } from "@ingram-tech/nk-seo";
2
+ /** `/fr` for a non-default language, `""` for the default (or no language). */
3
+ const langPrefix = (lang, config) => config.defaultLang !== undefined &&
4
+ lang !== undefined &&
5
+ lang !== config.defaultLang
6
+ ? `/${lang}`
7
+ : "";
8
+ /** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
9
+ export function blogIndexUrl(lang, config) {
10
+ return `${config.baseUrl}${langPrefix(lang, config)}${config.basePath}`;
11
+ }
12
+ /** Absolute URL of a post, prefixed by its language when that isn't the default. */
2
13
  export function postUrl(post, config) {
3
- return `${config.baseUrl}${config.basePath}/${post.slug}`;
14
+ return `${blogIndexUrl(post.lang, config)}/${post.slug}`;
15
+ }
16
+ /**
17
+ * Canonical + hreflang alternates for a post, from `blog.translations(post)`.
18
+ * Spread into Next's `Metadata.alternates`. A post links only to versions that
19
+ * exist, so a French-only article never advertises an English URL.
20
+ */
21
+ export function blogPostAlternates(post, translations, config) {
22
+ const canonical = toAbsoluteUrl(post.canonical ?? postUrl(post, config), config.baseUrl);
23
+ const versions = translations.filter((version) => version.lang !== undefined);
24
+ if (versions.length < 2)
25
+ return { canonical, languages: {} };
26
+ const languages = {};
27
+ for (const version of versions) {
28
+ if (version.lang)
29
+ languages[version.lang] = postUrl(version, config);
30
+ }
31
+ const fallback = versions.find((version) => version.lang === config.defaultLang);
32
+ if (fallback)
33
+ languages["x-default"] = postUrl(fallback, config);
34
+ return { canonical, languages };
4
35
  }
5
36
  // JSON-LD consumers don't resolve relative URLs, so anything without a scheme
6
37
  // (leading-`/` or bare `img/x.png`) is absolutized against the site. Unlike
@@ -24,14 +55,15 @@ export function blogPostArticle(post, config, overrides = {}) {
24
55
  image: post.image ? toAbsoluteUrl(post.image, config.baseUrl) : undefined,
25
56
  keywords: post.tags.length ? post.tags : undefined,
26
57
  publisher: config.publisher,
58
+ ...(post.lang ? { extra: { inLanguage: post.lang } } : {}),
27
59
  ...overrides,
28
60
  });
29
61
  }
30
62
  /** Home → Blog → Post breadcrumb JSON-LD. */
31
63
  export function blogPostBreadcrumbs(post, config) {
32
64
  return breadcrumbList([
33
- { name: "Home", url: config.baseUrl },
34
- { name: config.blogName ?? "Blog", url: `${config.baseUrl}${config.basePath}` },
65
+ { name: "Home", url: `${config.baseUrl}${langPrefix(post.lang, config)}` },
66
+ { name: config.blogName ?? "Blog", url: blogIndexUrl(post.lang, config) },
35
67
  { name: post.title, url: postUrl(post, config) },
36
68
  ]);
37
69
  }
package/dist/seo.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,EAGP,cAAc,GAId,MAAM,qBAAqB,CAAC;AAc7B,MAAM,UAAU,OAAO,CAAC,IAAqB,EAAE,MAAqB;IACnE,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,gFAAgF;AAChF,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,OAAe,EAAU,EAAE,CAC9D,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;IACvB,CAAC,CAAC,GAAG;IACL,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;AAExD,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAC9B,IAAqB,EACrB,MAAqB,EACrB,SAAS,GAA0B,EAAE;IAErC,OAAO,OAAO,CAAC;QACd,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;QAC3E,aAAa,EAAE,IAAI,CAAC,IAAI;QACxB,YAAY,EAAE,IAAI,CAAC,OAAO;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACzE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,SAAS;KACZ,CAAC,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CAClC,IAAqB,EACrB,MAAqB;IAErB,OAAO,cAAc,CAAC;QACrB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE;QACrC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE;QAC/E,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;KAChD,CAAC,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"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"}
package/dist/server.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { createBlog, parsePost, parsePostFileName, type Blog, type BlogConfig, type BlogSource, type RawPostFile, } from "./blog.js";
1
+ export { createBlog, parsePost, parsePostFileName, type Blog, type BlogConfig, type BlogSource, type LangFilter, type RawPostFile, } from "./blog.js";
2
2
  export { fsSource } from "./sources/fs.js";
3
3
  export { githubSource, type GitHubRepoConfig } from "./sources/github.js";
4
4
  export { publishPost, serializePost, type PublishedPost, type PublishPostInput, } from "./sources/publish.js";
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAKjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAMjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
package/dist/types.d.ts CHANGED
@@ -17,8 +17,17 @@ export interface BlogPostPreview {
17
17
  image?: string;
18
18
  draft: boolean;
19
19
  featured: boolean;
20
- /** Reserved for i18n'd blogs; not interpreted by the reader yet. */
20
+ /**
21
+ * The post's language: frontmatter `lang`, else `BlogConfig.defaultLang`.
22
+ * Undefined on a single-language blog that sets neither.
23
+ */
21
24
  lang?: string;
25
+ /**
26
+ * Shared by a post and its translations: frontmatter `translationKey`, else
27
+ * the slug. Always set by the reader; optional so hand-built previews
28
+ * (tests, fixtures) need not spell it out.
29
+ */
30
+ translationKey?: string;
22
31
  /** Reserved canonical-URL override for syndicated posts. */
23
32
  canonical?: string;
24
33
  format: PostFormat;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtC,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAS,SAAQ,eAAe;IAChD,OAAO,EAAE,MAAM,CAAC;CAChB"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtC,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAS,SAAQ,eAAe;IAChD,OAAO,EAAE,MAAM,CAAC;CAChB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ingram-tech/nk-blog",
3
- "version": "0.1.11",
3
+ "version": "0.2.0",
4
4
  "description": "File-based blog foundation for Next.js sites: frontmatter schema, build-time reader, limited-MDX rendering, a typed component contract with unstyled defaults, GitHub read/publish, and RSS.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -64,7 +64,7 @@
64
64
  }
65
65
  },
66
66
  "devDependencies": {
67
- "@ingram-tech/nk-dev": "0.17.0",
67
+ "@ingram-tech/nk-dev": "0.18.0",
68
68
  "@types/mdast": "^4.0.4",
69
69
  "@types/node": "^26.5.1",
70
70
  "@types/react": "^19.3.0",
package/src/blog.ts CHANGED
@@ -21,6 +21,13 @@ export interface BlogConfig {
21
21
  wordsPerMinute?: number;
22
22
  /** Include drafts (listing pages typically pass `NODE_ENV !== "production"`). */
23
23
  drafts?: boolean;
24
+ /**
25
+ * Language of every post that declares no `lang`. Set it to make the blog
26
+ * multilingual: each post is written in one language, slugs are unique per
27
+ * language, and posts sharing a `translationKey` are one another's
28
+ * translations. Unset, `lang` is only what frontmatter says.
29
+ */
30
+ defaultLang?: string;
24
31
  /**
25
32
  * Site-specific image fallback (e.g. "look in /public/images/posts/<slug>").
26
33
  * This is config precisely so per-site divergence never forks the reader.
@@ -35,15 +42,30 @@ export interface BlogConfig {
35
42
  onInvalid?: "throw" | "skip";
36
43
  }
37
44
 
45
+ /** Narrows a listing to one language. Omitted, every language is included. */
46
+ export interface LangFilter {
47
+ lang?: string;
48
+ }
49
+
38
50
  export interface Blog {
39
51
  /** All non-draft posts, newest first, with bodies. */
40
- posts(): Promise<BlogPost[]>;
52
+ posts(filter?: LangFilter): Promise<BlogPost[]>;
41
53
  /** All non-draft posts, newest first, without bodies. */
42
- previews(): Promise<BlogPostPreview[]>;
43
- post(slug: string): Promise<BlogPost | null>;
44
- slugs(): Promise<string[]>;
54
+ previews(filter?: LangFilter): Promise<BlogPostPreview[]>;
55
+ /**
56
+ * The post at `slug`. Slugs are unique per language, so pass `lang` on a
57
+ * multilingual blog; without it, the `defaultLang` post wins a shared slug.
58
+ */
59
+ post(slug: string, filter?: LangFilter): Promise<BlogPost | null>;
60
+ slugs(filter?: LangFilter): Promise<string[]>;
45
61
  /** The pinned (`featured: true`) post, else the newest. */
46
- featured(): Promise<BlogPost | null>;
62
+ featured(filter?: LangFilter): Promise<BlogPost | null>;
63
+ /**
64
+ * Every language version of `post`, itself included, in `posts()` order —
65
+ * the input to `blogPostAlternates`. Drafts are excluded like everywhere
66
+ * else, so an unpublished translation is never advertised.
67
+ */
68
+ translations(post: BlogPostPreview): Promise<BlogPostPreview[]>;
47
69
  }
48
70
 
49
71
  const POST_FILE = /^(?:(?<flat>[^/]+)|(?<dir>[^/]+)\/index)\.(?<ext>mdx?)$/;
@@ -117,7 +139,8 @@ export function parsePost(file: RawPostFile, config: BlogConfig): BlogPost | nul
117
139
  image,
118
140
  draft: frontmatter.draft || named.draftByName,
119
141
  featured: frontmatter.featured,
120
- lang: frontmatter.lang,
142
+ lang: frontmatter.lang ?? config.defaultLang,
143
+ translationKey: frontmatter.translationKey ?? slug,
121
144
  canonical: frontmatter.canonical,
122
145
  format: named.format,
123
146
  readingTimeMinutes: time.minutes,
@@ -126,45 +149,81 @@ export function parsePost(file: RawPostFile, config: BlogConfig): BlogPost | nul
126
149
  };
127
150
  }
128
151
 
152
+ const inLang = (post: BlogPostPreview, filter?: LangFilter): boolean =>
153
+ filter?.lang === undefined || post.lang === filter.lang;
154
+
129
155
  export function createBlog(config: BlogConfig): Blog {
130
- const posts = async (): Promise<BlogPost[]> => {
156
+ const all = async (): Promise<BlogPost[]> => {
131
157
  const files = await config.source.load();
132
158
  const parsed = files
133
159
  .map((file) => parsePost(file, config))
134
160
  .filter((post): post is BlogPost => post !== null);
135
161
 
136
- // Collision check BEFORE the draft filter: a draft colliding with a live
137
- // post must fail the production build too, not only draft-enabled
138
- // previews. Two files resolving to one slug is a routing conflict —
139
- // always a loud build failure, never a quiet last-one-wins.
140
- const seen = new Map<string, BlogPost>();
162
+ // Collision checks BEFORE the draft filter: a draft colliding with a
163
+ // live post must fail the production build too, not only draft-enabled
164
+ // previews. Two files resolving to one address, or two posts claiming
165
+ // to be the same translation, is a conflict — always a loud build
166
+ // failure, never a quiet last-one-wins.
167
+ const bySlug = new Map<string, BlogPost>();
168
+ const byTranslation = new Map<string, BlogPost>();
141
169
  for (const post of parsed) {
142
- if (seen.has(post.slug)) {
143
- throw new Error(`nk-blog: duplicate slug "${post.slug}"`);
170
+ const where = post.lang === undefined ? "" : ` in lang "${post.lang}"`;
171
+ const slugKey = `${post.lang ?? ""}\0${post.slug}`;
172
+ if (bySlug.has(slugKey)) {
173
+ throw new Error(`nk-blog: duplicate slug "${post.slug}"${where}`);
174
+ }
175
+ bySlug.set(slugKey, post);
176
+
177
+ const translationKey = `${post.lang ?? ""}\0${post.translationKey}`;
178
+ const claimed = byTranslation.get(translationKey);
179
+ if (claimed) {
180
+ throw new Error(
181
+ `nk-blog: "${claimed.slug}" and "${post.slug}" are both the${where} version of translation "${post.translationKey}"`,
182
+ );
144
183
  }
145
- seen.set(post.slug, post);
184
+ byTranslation.set(translationKey, post);
146
185
  }
147
186
 
148
- return [...seen.values()]
187
+ return [...bySlug.values()]
149
188
  .filter((post) => config.drafts === true || !post.draft)
150
189
  .sort(
151
190
  (a, b) =>
152
191
  new Date(b.date).getTime() - new Date(a.date).getTime() ||
153
192
  // Same-day posts: deterministic order between builds.
154
- a.slug.localeCompare(b.slug),
193
+ a.slug.localeCompare(b.slug) ||
194
+ (a.lang ?? "").localeCompare(b.lang ?? ""),
155
195
  );
156
196
  };
157
197
 
198
+ const posts = async (filter?: LangFilter): Promise<BlogPost[]> =>
199
+ (await all()).filter((post) => inLang(post, filter));
200
+
158
201
  return {
159
202
  posts,
160
- previews: async () =>
161
- (await posts()).map(({ content: _content, ...preview }) => preview),
162
- post: async (slug) =>
163
- (await posts()).find((candidate) => candidate.slug === slug) ?? null,
164
- slugs: async () => (await posts()).map((post) => post.slug),
165
- featured: async () => {
166
- const all = await posts();
167
- return all.find((post) => post.featured) ?? all[0] ?? null;
203
+ previews: async (filter) =>
204
+ (await posts(filter)).map(({ content: _content, ...preview }) => preview),
205
+ post: async (slug, filter) => {
206
+ const matches = (await posts(filter)).filter(
207
+ (candidate) => candidate.slug === slug,
208
+ );
209
+ return (
210
+ matches.find((candidate) => candidate.lang === config.defaultLang) ??
211
+ matches[0] ??
212
+ null
213
+ );
214
+ },
215
+ slugs: async (filter) => (await posts(filter)).map((post) => post.slug),
216
+ featured: async (filter) => {
217
+ const listed = await posts(filter);
218
+ return listed.find((post) => post.featured) ?? listed[0] ?? null;
168
219
  },
220
+ translations: async (post) =>
221
+ (await all())
222
+ .filter(
223
+ (candidate) =>
224
+ (candidate.translationKey ?? candidate.slug) ===
225
+ (post.translationKey ?? post.slug),
226
+ )
227
+ .map(({ content: _content, ...preview }) => preview),
169
228
  };
170
229
  }
package/src/index.ts CHANGED
@@ -33,8 +33,11 @@ export {
33
33
  } from "./reading-time.js";
34
34
  export { formatPostDate } from "./date.js";
35
35
  export {
36
+ blogIndexUrl,
37
+ blogPostAlternates,
36
38
  blogPostArticle,
37
39
  blogPostBreadcrumbs,
38
40
  postUrl,
41
+ type BlogPostAlternates,
39
42
  type BlogSeoConfig,
40
43
  } from "./seo.js";
package/src/schema.ts CHANGED
@@ -54,8 +54,13 @@ export const blogFrontmatterSchema = z
54
54
  slug: slugSchema.optional(),
55
55
  draft: z.boolean().default(false),
56
56
  featured: z.boolean().default(false),
57
- // Reserved fields — validated now so adding behavior later isn't breaking.
57
+ // The post's language (e.g. "fr"); `BlogConfig.defaultLang` when absent.
58
58
  lang: nonEmpty.optional(),
59
+ // Groups a post with its translations; defaults to the slug, so posts
60
+ // sharing a slug across languages link without declaring it. Set it
61
+ // when a translation carries its own slug.
62
+ translationKey: nonEmpty.optional(),
63
+ // Reserved — validated now so adding behavior later isn't breaking.
59
64
  canonical: nonEmpty.optional(),
60
65
  })
61
66
  .transform(({ author, authors, coverImage, image, ...rest }) => ({
package/src/seo.ts CHANGED
@@ -18,10 +18,73 @@ export interface BlogSeoConfig {
18
18
  publisher?: OrganizationInput;
19
19
  /** Crumb label for the blog index; defaults to "Blog". */
20
20
  blogName?: string;
21
+ /**
22
+ * The blog's default language — the same value as `BlogConfig.defaultLang`.
23
+ * Its posts live at `basePath`; every other language's posts at
24
+ * `/<lang><basePath>` (`/fr/blog/<slug>`), matching nk-i18n's prefix
25
+ * strategy. Unset, no URL carries a language.
26
+ *
27
+ * The default language is deliberately unprefixed, unlike nk-i18n's
28
+ * negotiated pages: a post is one document in one language, not a page
29
+ * rendered per visitor, so it has exactly one address and there is no
30
+ * language-neutral bare URL to keep free.
31
+ */
32
+ defaultLang?: string;
21
33
  }
22
34
 
35
+ /** `/fr` for a non-default language, `""` for the default (or no language). */
36
+ const langPrefix = (lang: string | undefined, config: BlogSeoConfig): string =>
37
+ config.defaultLang !== undefined &&
38
+ lang !== undefined &&
39
+ lang !== config.defaultLang
40
+ ? `/${lang}`
41
+ : "";
42
+
43
+ /** Absolute URL of the blog index in `lang`: `/blog`, `/fr/blog`. */
44
+ export function blogIndexUrl(lang: string | undefined, config: BlogSeoConfig): string {
45
+ return `${config.baseUrl}${langPrefix(lang, config)}${config.basePath}`;
46
+ }
47
+
48
+ /** Absolute URL of a post, prefixed by its language when that isn't the default. */
23
49
  export function postUrl(post: BlogPostPreview, config: BlogSeoConfig): string {
24
- return `${config.baseUrl}${config.basePath}/${post.slug}`;
50
+ return `${blogIndexUrl(post.lang, config)}/${post.slug}`;
51
+ }
52
+
53
+ export interface BlogPostAlternates {
54
+ /** The post's own address, or its `canonical` override. */
55
+ canonical: string;
56
+ /**
57
+ * hreflang → URL for every language version, plus `x-default` pointing at
58
+ * the default-language version when there is one. Empty for a post with no
59
+ * translation: a single-member cluster says nothing.
60
+ */
61
+ languages: Record<string, string>;
62
+ }
63
+
64
+ /**
65
+ * Canonical + hreflang alternates for a post, from `blog.translations(post)`.
66
+ * Spread into Next's `Metadata.alternates`. A post links only to versions that
67
+ * exist, so a French-only article never advertises an English URL.
68
+ */
69
+ export function blogPostAlternates(
70
+ post: BlogPostPreview,
71
+ translations: readonly BlogPostPreview[],
72
+ config: BlogSeoConfig,
73
+ ): BlogPostAlternates {
74
+ const canonical = toAbsoluteUrl(
75
+ post.canonical ?? postUrl(post, config),
76
+ config.baseUrl,
77
+ );
78
+ const versions = translations.filter((version) => version.lang !== undefined);
79
+ if (versions.length < 2) return { canonical, languages: {} };
80
+
81
+ const languages: Record<string, string> = {};
82
+ for (const version of versions) {
83
+ if (version.lang) languages[version.lang] = postUrl(version, config);
84
+ }
85
+ const fallback = versions.find((version) => version.lang === config.defaultLang);
86
+ if (fallback) languages["x-default"] = postUrl(fallback, config);
87
+ return { canonical, languages };
25
88
  }
26
89
 
27
90
  // JSON-LD consumers don't resolve relative URLs, so anything without a scheme
@@ -52,6 +115,7 @@ export function blogPostArticle(
52
115
  image: post.image ? toAbsoluteUrl(post.image, config.baseUrl) : undefined,
53
116
  keywords: post.tags.length ? post.tags : undefined,
54
117
  publisher: config.publisher,
118
+ ...(post.lang ? { extra: { inLanguage: post.lang } } : {}),
55
119
  ...overrides,
56
120
  });
57
121
  }
@@ -62,8 +126,8 @@ export function blogPostBreadcrumbs(
62
126
  config: BlogSeoConfig,
63
127
  ): WithContext<BreadcrumbListNode> {
64
128
  return breadcrumbList([
65
- { name: "Home", url: config.baseUrl },
66
- { name: config.blogName ?? "Blog", url: `${config.baseUrl}${config.basePath}` },
129
+ { name: "Home", url: `${config.baseUrl}${langPrefix(post.lang, config)}` },
130
+ { name: config.blogName ?? "Blog", url: blogIndexUrl(post.lang, config) },
67
131
  { name: post.title, url: postUrl(post, config) },
68
132
  ]);
69
133
  }
package/src/server.ts CHANGED
@@ -8,6 +8,7 @@ export {
8
8
  type Blog,
9
9
  type BlogConfig,
10
10
  type BlogSource,
11
+ type LangFilter,
11
12
  type RawPostFile,
12
13
  } from "./blog.js";
13
14
  export { fsSource } from "./sources/fs.js";
package/src/types.ts CHANGED
@@ -18,8 +18,17 @@ export interface BlogPostPreview {
18
18
  image?: string;
19
19
  draft: boolean;
20
20
  featured: boolean;
21
- /** Reserved for i18n'd blogs; not interpreted by the reader yet. */
21
+ /**
22
+ * The post's language: frontmatter `lang`, else `BlogConfig.defaultLang`.
23
+ * Undefined on a single-language blog that sets neither.
24
+ */
22
25
  lang?: string;
26
+ /**
27
+ * Shared by a post and its translations: frontmatter `translationKey`, else
28
+ * the slug. Always set by the reader; optional so hand-built previews
29
+ * (tests, fixtures) need not spell it out.
30
+ */
31
+ translationKey?: string;
23
32
  /** Reserved canonical-URL override for syndicated posts. */
24
33
  canonical?: string;
25
34
  format: PostFormat;