@riebeckite/plugin-l10n 0.0.27 → 0.0.28

package/README.md

@@ -47,6 +47,12 @@ No fallback pages are generated. `getLocalization(manifest, slug)` returns `avai
 
 `l10n(...)` publishes the built-in, styled LanguageSwitcher in the standard article layout. A standard Site consumer renders that, so no l10n-specific article integration is needed. It is omitted when a page has fewer than two real translations.
 
+## CSS hooks
+
+The LanguageSwitcher uses `rr-l10n-switcher`,
+`rr-l10n-switcher__label`, `rr-l10n-switcher__list`, and
+`rr-l10n-switcher__link`. Default CSS targets these hooks.
+
 ## Custom detector
 
 For another convention, provide `detect`. Its language is considered after frontmatter and before filename; its `translationId` is explicit.
@@ -62,7 +68,7 @@ l10n({
 
 ## Links and SEO
 
-Before the existing Content Graph is built, WikiLink graph targets are switched to the source note's language when that translation exists; otherwise their original target remains. The rendered article rewrites both Obsidian WikiLinks (after `@riebeckite/plugin-obsidian-markdown` resolves them) and Markdown links to an existing translation in the current page's language, preserving query strings and fragments. When no translation exists, the original/default target remains linked. External, fragment-only, unknown, asset, and other non-content URLs remain unchanged. The Content Graph and rendered links use the same resolution policy; no second graph is created.
+Before the existing Content Graph is built, WikiLink graph targets are switched to the source note's language when that translation exists; otherwise their original target remains. The rendered article rewrites both Obsidian WikiLinks (after `@riebeckite/plugin-obsidian-markdown` resolves them) and Markdown links to an existing translation in the current page's language, preserving query strings and fragments. When no translation exists, the original/default target remains linked. External, fragment-only, unknown, asset, and other non-content URLs remain unchanged. Link dependency tracking uses the same parsed Markdown URLs as rendering, including HTML character references. The Content Graph and rendered links use the same resolution policy; no second graph is created.
 
 Each translated entry receives one `<link rel="alternate" hreflang="…">` per existing translation through Core's `headTags` extension point. The site shell remains responsible for rendering those tags and for selecting `<html lang>` for a request.
 

package/README_ja.md

@@ -46,7 +46,12 @@ English/getting-started.md lang: en, translation: getting-started
 
 `l10n(...)` は標準記事レイアウトへ組み込みの言語切替 UI を登録します。標準 Site consumer がこの UI を描画するため、l10n 専用の記事レイアウト実装は不要です。実在する翻訳が 2 つ未満のページには表示されません。
 
-各ページには Core の `headTags` 拡張を通じ、実在する翻訳だけを対象に `hreflang` の alternate link を追加します。サイトシェルはこれらのタグの描画と、リクエストに応じた `<html lang>` の選択を担当します。WikiLink の Content Graph は同言語の翻訳を優先し、なければ元のリンク先を使います。本文では Obsidian WikiLink を `@riebeckite/plugin-obsidian-markdown` が解決した後、WikiLink と Markdown の内部リンクを同じ規則で処理します。現在のページと同じ言語の翻訳があればその URL に切り替え、なければ original/default のリンク先を維持します。クエリ文字列とフラグメントは維持し、外部 URL、フラグメントのみのリンク、不明な URL、asset などコンテンツ以外の URL は変更しません。Content Graph と本文リンクは同じ解決ポリシーを使います。
+## CSS Hook
+
+言語切替 UI には `rr-l10n-switcher`、`rr-l10n-switcher__label`、
+`rr-l10n-switcher__list`、`rr-l10n-switcher__link` を使用します。default CSS はこれらの Hook を対象にします。
+
+各ページには Core の `headTags` 拡張を通じ、実在する翻訳だけを対象に `hreflang` の alternate link を追加します。サイトシェルはこれらのタグの描画と、リクエストに応じた `<html lang>` の選択を担当します。WikiLink の Content Graph は同言語の翻訳を優先し、なければ元のリンク先を使います。本文では Obsidian WikiLink を `@riebeckite/plugin-obsidian-markdown` が解決した後、WikiLink と Markdown の内部リンクを同じ規則で処理します。現在のページと同じ言語の翻訳があればその URL に切り替え、なければ original/default のリンク先を維持します。クエリ文字列とフラグメントは維持し、外部 URL、フラグメントのみのリンク、不明な URL、asset などコンテンツ以外の URL は変更しません。リンク依存関係の追跡でも描画と同じ解析済み Markdown URL を使用するため、HTML 文字参照も同じように扱います。Content Graph と本文リンクは同じ解決ポリシーを使います。
 
 ## 独自検出
 

package/dist/components/language-switcher.js

@@ -5,7 +5,10 @@ import { useArticleContext, useSiteContext } from "@riebeckite/ui";
 import {
   attachErrorPath,
   createStyleAsset,
-  definePlugin
+  definePlugin,
+  escapeRegExp,
+  extractContentLinks,
+  extractMarkdownLinkUrls
 } from "@riebeckite/core";
 import { parse } from "yaml";
 var TRANSLATION_METADATA_KEY = "l10n.translationId";
@@ -58,15 +61,15 @@ var LanguageSwitcher = ((props) => {
   const article = useArticleContext();
   const localization = props.localization ?? (site && article?.entry ? getLocalization(site.view, article.entry.slug) : null);
   if (!localization || localization.availableLanguages.length < 2) return null;
-  return /* @__PURE__ */ jsxs("nav", { class: "l10n-switcher", "aria-label": "Language", children: [
-    /* @__PURE__ */ jsx("span", { class: "l10n-switcher__label", children: "Language" }),
-    /* @__PURE__ */ jsx("ul", { class: "l10n-switcher__list", children: localization.availableLanguages.map((lang) => {
+  return /* @__PURE__ */ jsxs("nav", { class: "rr-l10n-switcher", "aria-label": "Language", children: [
+    /* @__PURE__ */ jsx("span", { class: "rr-l10n-switcher__label", children: "Language" }),
+    /* @__PURE__ */ jsx("ul", { class: "rr-l10n-switcher__list", children: localization.availableLanguages.map((lang) => {
       const href = localization.translations[lang];
       if (!href) return null;
       return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
         "a",
         {
-          class: "l10n-switcher__link",
+          class: "rr-l10n-switcher__link",
           href,
           hreflang: lang,
           lang,

package/dist/index.js

@@ -5,7 +5,10 @@ import { useArticleContext, useSiteContext } from "@riebeckite/ui";
 import {
   attachErrorPath,
   createStyleAsset,
-  definePlugin
+  definePlugin,
+  escapeRegExp,
+  extractContentLinks,
+  extractMarkdownLinkUrls
 } from "@riebeckite/core";
 import { parse } from "yaml";
 var TRANSLATION_METADATA_KEY = "l10n.translationId";
@@ -15,15 +18,15 @@ function l10n(options) {
   return definePlugin({
     name: "l10n",
     processedContentCache: {
-      version: "l10n-global-content-locations-v1",
-      dependencyMode: "global"
+      version: "l10n-content-locations-v2",
+      dependencyMode: "tracked",
+      contentDependencyFingerprint: ({ slug }) => state.signatures.get(slug)
     },
     provides: ["content.localization"],
-    contentOutputDependencies: [{ type: "global" }],
     options,
     assets: [createStyleAsset("l10n", "@riebeckite/plugin-l10n/style.css")],
     validateOptions: () => validateOptions(options).map((message) => ({ path: "l10n", message })),
-    extendContentLocations: ({ entries, locations }) => {
+    extendContentLocations: ({ entries, locations, contentIndex }) => {
       state = {
         ...detectContents(entries, resolved),
         locations,
@@ -38,10 +41,16 @@ function l10n(options) {
           withLocalization(location, content, resolved)
         );
       }
+      const slugsByPermalink = new Map(
+        [...locations].map(([slug, location]) => [location.permalink, slug])
+      );
       state = {
         ...state,
-        slugsByPermalink: new Map(
-          [...locations].map(([slug, location]) => [location.permalink, slug])
+        slugsByPermalink,
+        signatures: computeLocalizationSignatures(
+          { ...state, slugsByPermalink },
+          entries,
+          contentIndex
         )
       };
     },
@@ -273,7 +282,8 @@ function detectContents(entries, options) {
     diagnostics,
     conflictedGroups,
     locations: null,
-    slugsByPermalink: /* @__PURE__ */ new Map()
+    slugsByPermalink: /* @__PURE__ */ new Map(),
+    signatures: /* @__PURE__ */ new Map()
   };
 }
 function parseFrontmatter(entry) {
@@ -357,9 +367,6 @@ function prefixLanguage(permalink, language) {
   const suffix = permalink === "/" ? "" : permalink;
   return `/${language}${suffix}`;
 }
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function findTranslation(state, translationId, lang) {
   const key = `${translationId}\0${lang}`;
   if (state.conflictedGroups.has(key)) return null;
@@ -370,6 +377,100 @@ function resolveLocalizedTarget(state, source, targetSlug) {
   if (!target) return null;
   return findTranslation(state, target.translationId, source.lang) ?? target;
 }
+var PUBLICATION_KEYS = [
+  "visibility",
+  "publishAt",
+  "publish",
+  "private",
+  "draft"
+];
+function signalValue(value) {
+  if (value === void 0 || value === null) return "";
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "boolean") return value ? "true" : "false";
+  return String(value);
+}
+function publicationSignal(frontmatter) {
+  return PUBLICATION_KEYS.map((key) => signalValue(frontmatter[key])).join(
+    "
"
+  );
+}
+function groupMemberToken(state, member) {
+  return [
+    member.lang,
+    member.slug,
+    state.locations?.get(member.slug)?.permalink ?? "",
+    publicationSignal(member.frontmatter)
+  ].join("
");
+}
+function localizedResolutionToken(state, source, targetSlug) {
+  const target = resolveLocalizedTarget(state, source, targetSlug);
+  if (!target) return "";
+  return `${target.slug}
${state.locations?.get(target.slug)?.permalink ?? ""}`;
+}
+function referencedPermalinks(markdown, slugsByPermalink) {
+  if (slugsByPermalink.size === 0) return [];
+  const found = /* @__PURE__ */ new Set();
+  for (const url of extractMarkdownLinkUrls(markdown)) {
+    const { permalink } = splitLinkUrl(url);
+    if (slugsByPermalink.has(permalink)) found.add(permalink);
+  }
+  return [...found].sort();
+}
+function computeLocalizationSignatures(state, entries, contentIndex) {
+  const markdownBySlug = new Map(
+    entries.map((entry) => [entry.slug, entry.markdown])
+  );
+  const membersByTranslation = /* @__PURE__ */ new Map();
+  for (const member of state.contents.values()) {
+    const members = membersByTranslation.get(member.translationId) ?? [];
+    members.push(groupMemberToken(state, member));
+    membersByTranslation.set(member.translationId, members);
+  }
+  for (const members of membersByTranslation.values()) members.sort();
+  const collectParts = (content, trail) => {
+    const members = membersByTranslation.get(content.translationId) ?? [];
+    const parts = [
+      `own:${content.lang}
${content.translationId}`,
+      ...members.map((member) => `group:${member}`)
+    ];
+    const markdown = markdownBySlug.get(content.slug) ?? "";
+    const links = extractContentLinks(markdown, contentIndex);
+    for (const link of links) {
+      if (link.kind === "image" || link.kind === "attachment") continue;
+      parts.push(
+        `wiki:${link.raw.toLowerCase()}=${link.slug ? localizedResolutionToken(state, content, link.slug) : ""}`
+      );
+    }
+    for (const permalink of referencedPermalinks(
+      markdown,
+      state.slugsByPermalink
+    )) {
+      const targetSlug = state.slugsByPermalink.get(permalink);
+      parts.push(
+        `url:${permalink}=${targetSlug ? localizedResolutionToken(state, content, targetSlug) : ""}`
+      );
+    }
+    if (trail.size < 3) {
+      for (const link of links) {
+        if (!link.embed || !link.slug || trail.has(link.slug)) continue;
+        const embedded = state.contents.get(link.slug);
+        if (!embedded) continue;
+        parts.push(
+          ...collectParts(embedded, /* @__PURE__ */ new Set([...trail, embedded.slug]))
+        );
+      }
+    }
+    return parts;
+  };
+  const signatures = /* @__PURE__ */ new Map();
+  for (const content of state.contents.values()) {
+    const parts = collectParts(content, /* @__PURE__ */ new Set());
+    parts.sort();
+    signatures.set(content.slug, parts.join("\n"));
+  }
+  return signatures;
+}
 function addLocalizationHeadTags(manifest, state) {
   const translationsById = collectDiscoverableTranslations(manifest);
   for (const entry of manifest.discoverableEntries) {
@@ -486,7 +587,8 @@ function emptyState() {
     diagnostics: [],
     conflictedGroups: /* @__PURE__ */ new Set(),
     locations: null,
-    slugsByPermalink: /* @__PURE__ */ new Map()
+    slugsByPermalink: /* @__PURE__ */ new Map(),
+    signatures: /* @__PURE__ */ new Map()
   };
 }
 
@@ -497,15 +599,15 @@ var LanguageSwitcher = ((props) => {
   const article = useArticleContext();
   const localization = props.localization ?? (site && article?.entry ? getLocalization(site.view, article.entry.slug) : null);
   if (!localization || localization.availableLanguages.length < 2) return null;
-  return /* @__PURE__ */ jsxs("nav", { class: "l10n-switcher", "aria-label": "Language", children: [
-    /* @__PURE__ */ jsx("span", { class: "l10n-switcher__label", children: "Language" }),
-    /* @__PURE__ */ jsx("ul", { class: "l10n-switcher__list", children: localization.availableLanguages.map((lang) => {
+  return /* @__PURE__ */ jsxs("nav", { class: "rr-l10n-switcher", "aria-label": "Language", children: [
+    /* @__PURE__ */ jsx("span", { class: "rr-l10n-switcher__label", children: "Language" }),
+    /* @__PURE__ */ jsx("ul", { class: "rr-l10n-switcher__list", children: localization.availableLanguages.map((lang) => {
       const href = localization.translations[lang];
       if (!href) return null;
       return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
         "a",
         {
-          class: "l10n-switcher__link",
+          class: "rr-l10n-switcher__link",
           href,
           hreflang: lang,
           lang,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-l10n",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,12 +23,12 @@
   "dependencies": {
     "hono": "^4.12.25",
     "yaml": "^2.9.0",
-    "@riebeckite/core": "0.0.27",
-    "@riebeckite/ui": "0.0.27"
+    "@riebeckite/core": "0.0.28",
+    "@riebeckite/ui": "0.0.28"
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/plugin-obsidian-markdown": "0.0.27"
+    "@riebeckite/plugin-obsidian-markdown": "0.0.28"
   },
   "publishConfig": {
     "access": "public"

package/style.css

@@ -1,4 +1,4 @@
-.l10n-switcher {
+.rr-l10n-switcher {
   display: flex;
   flex-wrap: wrap;
   align-items: baseline;
@@ -7,7 +7,7 @@
   font-size: 0.8125rem;
 }
 
-.l10n-switcher__label {
+.rr-l10n-switcher__label {
   font-size: 0.6875rem;
   font-weight: 700;
   letter-spacing: 0.12em;
@@ -18,7 +18,7 @@
   text-transform: uppercase;
 }
 
-.l10n-switcher__list {
+.rr-l10n-switcher__list {
   display: flex;
   flex-wrap: wrap;
   gap: 0.75rem;
@@ -27,19 +27,19 @@
   list-style: none;
 }
 
-.l10n-switcher__link {
+.rr-l10n-switcher__link {
   color: inherit;
   text-decoration: none;
   text-underline-offset: 0.2em;
 }
 
-.l10n-switcher__link:hover,
-.l10n-switcher__link:focus-visible {
+.rr-l10n-switcher__link:hover,
+.rr-l10n-switcher__link:focus-visible {
   color: var(--rb-color-accent, currentColor);
   text-decoration: underline;
 }
 
-.l10n-switcher__link[aria-current="page"] {
+.rr-l10n-switcher__link[aria-current="page"] {
   font-weight: 700;
   text-decoration: underline;
 }