starlight-seo 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-10-05
+
+### Fixed
+
+- `site.about` given as one object (`{ name, url, sameAs }`) was read as a per-language map and reduced to its name; `url`, `sameAs` and `type` now reach the JSON-LD graph.
+
 ## [0.2.1] - 2026-10-05
 
 ### Changed
@@ -39,6 +45,7 @@ All notable changes to this project are documented here. The format follows [Kee
 - Build audit with 14 rules that fails the build on errors.
 - Per-language values for every text option.
 
+[0.2.2]: https://github.com/kaktaknet/starlight-seo/releases/tag/v0.2.2
 [0.2.1]: https://github.com/kaktaknet/starlight-seo/releases/tag/v0.2.1
 [0.2.0]: https://github.com/kaktaknet/starlight-seo/releases/tag/v0.2.0
 [0.1.0]: https://github.com/kaktaknet/starlight-seo/releases/tag/v0.1.0

package/README.md

@@ -39,11 +39,12 @@
 The sidebar still says **Git**. The `<h1>` still says **Git**.
 
 <details>
-<summary><b>For AI agents: the whole repository in fourteen lines</b></summary>
+<summary><b>For AI agents: the whole repository in fifteen lines</b></summary>
 
 ```text
 package      starlight-seo (ESM, plain JavaScript + hand-written .d.ts, zero dependencies)
 versions     built for Starlight 0.42.x + Astro 7.x (tested 0.42.5 / 7.3.5); floor Starlight 0.32, Astro 5, Node 20
+npm          https://www.npmjs.com/package/starlight-seo
 install      pnpm add starlight-seo -> plugins: [starlightSeo()] -> docsSchema({ extend: seoSchema() })
 entry        index.js       default export starlightSeo(options) -> Starlight plugin
 schema       schema.js      seoSchema() -> pass to docsSchema({ extend })

package/README.ru.md

@@ -39,11 +39,12 @@
 В меню по-прежнему **Git**. В `<h1>` по-прежнему **Git**.
 
 <details>
-<summary><b>Для ИИ-агентов: весь репозиторий в четырнадцати строках</b></summary>
+<summary><b>Для ИИ-агентов: весь репозиторий в пятнадцати строках</b></summary>
 
 ```text
 package      starlight-seo (ESM, plain JavaScript + hand-written .d.ts, zero dependencies)
 versions     built for Starlight 0.42.x + Astro 7.x (tested 0.42.5 / 7.3.5); floor Starlight 0.32, Astro 5, Node 20
+npm          https://www.npmjs.com/package/starlight-seo
 install      pnpm add starlight-seo -> plugins: [starlightSeo()] -> docsSchema({ extend: seoSchema() })
 entry        index.js       default export starlightSeo(options) -> Starlight plugin
 schema       schema.js      seoSchema() -> pass to docsSchema({ extend })

package/lib/page.js

@@ -1,7 +1,7 @@
 import { breadcrumbs } from './breadcrumbs.js'
 import { isArticle } from './graph.js'
 import { resolveTitle } from './title.js'
-import { fill, firstMatch, pick } from './text.js'
+import { fill, firstMatch, pick, pickThing } from './text.js'
 
 const slugOf = (path) => path.replace(/^\/+|\/+$/g, '') || 'index'
 
@@ -55,7 +55,7 @@ export function resolvePage(options, input) {
     modified: seo.modified ?? input.lastUpdated,
     section: seo.section ?? rule?.section,
     keywords: seo.keywords,
-    about: seo.about ?? pick(options.site.about, lang, locale),
+    about: seo.about ?? pickThing(options.site.about, lang, locale),
     breadcrumbs: breadcrumbs({
       sidebar: input.sidebar,
       home,
@@ -69,7 +69,7 @@ export function resolvePage(options, input) {
       name: siteName,
       alternateName: pick(options.site.alternateName, lang, locale),
       description: pick(options.site.description, lang, locale),
-      about: pick(options.site.about, lang, locale),
+      about: pickThing(options.site.about, lang, locale),
     },
   }
 }

package/lib/text.js

@@ -11,6 +11,14 @@ export const pick = (value, lang, locale) => {
   return Object.values(value)[0]
 }
 
+const THING_KEYS = ['name', 'url', 'sameAs', 'type', '@id', '@type']
+
+export const pickThing = (value, lang, locale) => {
+  if (Array.isArray(value)) return value
+  if (value && typeof value === 'object' && THING_KEYS.some((key) => key in value)) return value
+  return pick(value, lang, locale)
+}
+
 export const fill = (template, values) =>
   String(template).replace(/\{(\w+)\}/g, (whole, key) => (key in values ? String(values[key]) : whole))
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-seo",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Starlight plugin for search-ready titles, connected JSON-LD, complete Open Graph tags and a build-time SEO audit.",
   "license": "MIT",
   "author": "kaktak.net",