@riebeckite/plugin-l10n 0.0.17 → 0.0.19

package/README.md

@@ -17,16 +17,9 @@ export default defineConfig({
 
 ## Locale detection
 
-Use `README_ja.md`-style filenames with an underscore as the recommended form, matching this repository's convention. The plugin also accepts `README.en.md`, `README-en.md`, and configured BCP 47-style tags such as `README.en-US.md` and `README.zh-CN.md`.
+Use `README.ja.md`-style filenames with a dot as the recommended form, matching this repository's convention. The plugin also accepts `README-ja.md`, `README_ja.md`, and configured BCP 47-style tags such as `README.en-US.md` and `README.zh-CN.md`.
 
-Directory detection is also supported:
-
-```text
-content/en/README.md
-content/ja/README.md
-```
-
-Only directories matching configured `languages` are treated as locales. Frontmatter works anywhere:
+Directory detection is not supported. Only filename suffixes and frontmatter are used to infer a language. Frontmatter works anywhere:
 
 ```md
 ---
@@ -35,7 +28,7 @@ translation: getting-started
 ---
 ```
 
-Conventions may be mixed. Built-in precedence is **frontmatter > filename > directory > default language**. Conflicts emit `L10N_LANGUAGE_CONFLICT`; use `strict: true` to fail the build instead. A duplicate `translation + lang` emits `L10N_DUPLICATE_TRANSLATION` (and also fails in strict mode).
+Conventions may be mixed. Built-in precedence is **frontmatter > custom detector > filename > default language**. Conflicts emit `L10N_LANGUAGE_CONFLICT`; use `strict: true` to fail the build instead. A duplicate `translation + lang` emits `L10N_DUPLICATE_TRANSLATION` (and also fails in strict mode).
 
 `translation` is independent of locale and filename. Use it to group files with unrelated paths or names:
 
@@ -73,7 +66,7 @@ Themes can override the default component through its `.l10n-switcher` CSS class
 
 ## Custom detector
 
-For another convention, provide `detect`. Its language is considered after frontmatter and before filename/directory; its `translationId` is explicit.
+For another convention, provide `detect`. Its language is considered after frontmatter and before filename; its `translationId` is explicit.
 
 ```ts
 l10n({
@@ -92,5 +85,5 @@ Each translated entry receives one `<link rel="alternate" hreflang="…">` per e
 
 ## See also
 
-- [Plugin guide](../../../docs/en/docs/reference/plugin-api.md)
+- [Plugin guide](../../../docs/docs/reference/plugin-api.en.md)
 

package/README_ja.md

@@ -14,7 +14,7 @@ l10n({ defaultLang: "ja", languages: ["ja", "en", "zh-CN"] });
 
 ## ロケール検出と翻訳グループ
 
-ファイル名はこのリポジトリの慣例に合わせ、アンダースコアの `README_ja.md` 形式を推奨します。`README.ja.md`、`README-ja.md`、`README.en.md`、`README.en-US.md`、`README.zh-CN.md` も利用できます。設定済みの言語名に一致する先頭ディレクトリ（`en/README.md`）も検出します。
+ファイル名はこのリポジトリの慣例に合わせ、ドットの `README.ja.md` 形式を推奨します。`README-ja.md`、`README_ja.md`、`README.en-US.md`、`README.zh-CN.md` も利用できます。ディレクトリ名による検出は行いません。
 
 frontmatter も利用できます。
 
@@ -25,7 +25,7 @@ translation: getting-started
 ---
 ```
 
-組み合わせた場合の組み込み規則の優先順位は **frontmatter > ファイル名 > ディレクトリ > 既定言語** です。矛盾は `L10N_LANGUAGE_CONFLICT`、同一 `translation + lang` の重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
+組み合わせた場合の組み込み規則の優先順位は **frontmatter > 独自検出 > ファイル名 > 既定言語** です。矛盾は `L10N_LANGUAGE_CONFLICT`、同一 `translation + lang` の重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
 
 `translation` はロケール検出とは別です。異なるパス・ファイル名でも明示的な ID でグループ化できます。翻訳がない言語のページを複製・生成することはありません。
 
@@ -69,8 +69,8 @@ l10n({
 });
 ```
 
-独自検出の言語は frontmatter より弱く、ファイル名・ディレクトリより強く扱われます。`translationId` は明示的な翻訳グループ ID です。
+独自検出の言語は frontmatter より弱く、ファイル名より強く扱われます。`translationId` は明示的な翻訳グループ ID です。
 
 ## 関連リンク
 
-- [プラグイン API](../../../docs/ja/docs/reference/plugin-api.md)
+- [プラグイン API](../../../docs/docs/reference/plugin-api.md)

package/dist/index.js

@@ -1,6 +1,7 @@
 // src/l10n.ts
 import {
   appendContentBodySlot,
+  attachErrorPath,
   createStyleAsset,
   definePlugin
 } from "@riebeckite/core";
@@ -232,16 +233,11 @@ function detectContents(entries, options) {
       entry.path,
       options.languageByLowercase
     );
-    const directoryLanguage = detectDirectoryLanguage(
-      entry.path,
-      options.languageByLowercase
-    );
     const detectorContext = {
       path: entry.path,
       slug: entry.slug,
       frontmatter,
-      filenameLanguage,
-      directoryLanguage
+      filenameLanguage
     };
     const custom = options.detect?.(detectorContext);
     const frontmatterLanguage = configuredLanguage(
@@ -251,8 +247,7 @@ function detectContents(entries, options) {
     const signals = compactSignals({
       custom: configuredLanguage(custom?.lang, options.languageByLowercase),
       frontmatter: frontmatterLanguage,
-      filename: filenameLanguage,
-      directory: directoryLanguage
+      filename: filenameLanguage
     });
     addUnknownLanguageDiagnostic(
       diagnostics,
@@ -271,8 +266,8 @@ function detectContents(entries, options) {
     if (new Set(Object.values(signals)).size > 1) {
       diagnostics.push(conflictDiagnostic(entry, signals, options.strict));
     }
-    const lang = signals.frontmatter ?? signals.custom ?? signals.filename ?? signals.directory ?? options.defaultLang;
-    const translationId = readTranslationId(custom?.translationId ?? frontmatter.translation) ?? deriveTranslationId(entry.path, filenameLanguage, directoryLanguage);
+    const lang = signals.frontmatter ?? signals.custom ?? signals.filename ?? options.defaultLang;
+    const translationId = readTranslationId(custom?.translationId ?? frontmatter.translation) ?? deriveTranslationId(entry.path, filenameLanguage);
     const content = {
       path: entry.path,
       slug: entry.slug,
@@ -298,7 +293,12 @@ function parseFrontmatter(entry) {
     /^(?:\uFEFF)?---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/
   );
   if (!match) return {};
-  const value = parse(match[1] ?? "");
+  let value;
+  try {
+    value = parse(match[1] ?? "");
+  } catch (error) {
+    throw attachErrorPath(error, entry.path);
+  }
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new Error(`Invalid frontmatter object: ${entry.path}`);
   }
@@ -312,10 +312,6 @@ function detectFilenameLanguage(path, languages) {
   }
   return void 0;
 }
-function detectDirectoryLanguage(path, languages) {
-  const first = path.split("/")[0]?.toLowerCase();
-  return first ? languages.get(first) : void 0;
-}
 function configuredLanguage(value, languages) {
   if (typeof value !== "string" || !value.trim()) return void 0;
   try {
@@ -324,9 +320,8 @@ function configuredLanguage(value, languages) {
     return void 0;
   }
 }
-function deriveTranslationId(path, filenameLanguage, directoryLanguage) {
+function deriveTranslationId(path, filenameLanguage) {
   const parts = path.replace(/\.md$/i, "").split("/");
-  if (directoryLanguage) parts.shift();
   const last = parts.pop() ?? "";
   const language = filenameLanguage?.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   parts.push(
@@ -368,13 +363,6 @@ function removeLocalePathSegments(permalink, content) {
     const suffix = new RegExp(`([._-])${escapeRegExp(filenameLanguage)}$`, "i");
     result = result.replace(suffix, "");
   }
-  const directoryLanguage = content.signals.directory;
-  if (directoryLanguage) {
-    result = result.replace(
-      new RegExp(`^/${escapeRegExp(directoryLanguage)}(?=/|$)`, "i"),
-      ""
-    );
-  }
   return result || "/";
 }
 function prefixLanguage(permalink, language) {
@@ -458,10 +446,10 @@ function conflictDiagnostic(entry, signals, strict) {
     slug: entry.slug,
     message: `Conflicting localization metadata (${Object.entries(signals).map(([source, language]) => `${source}: ${language}`).join(
       ", "
-    )}); resolved to ${signals.frontmatter ?? signals.custom ?? signals.filename ?? signals.directory}.`,
+    )}); resolved to ${signals.frontmatter ?? signals.custom ?? signals.filename}.`,
     meta: {
       detected: signals,
-      resolved: signals.frontmatter ?? signals.custom ?? signals.filename ?? signals.directory
+      resolved: signals.frontmatter ?? signals.custom ?? signals.filename
     }
   };
 }

package/dist/src/l10n.d.ts

@@ -6,7 +6,6 @@ export type L10nContent = {
 };
 export type L10nDetectorContext = L10nContent & {
     readonly filenameLanguage: string | undefined;
-    readonly directoryLanguage: string | undefined;
 };
 /** A detector may provide a language and/or an explicit translation identity. */
 export type L10nDetectorResult = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-l10n",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,11 +16,11 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@riebeckite/core": "0.0.17"
+    "@riebeckite/core": "0.0.19"
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/plugin-obsidian-markdown": "0.0.17"
+    "@riebeckite/plugin-obsidian-markdown": "0.0.19"
   },
   "publishConfig": {
     "access": "public"