@ox-content/napi 0.13.0 → 0.14.0

package/index.d.ts

@@ -7,6 +7,14 @@
  */
 export declare function buildSearchIndex(documents: Array<JsSearchDocument>): string
 
+/**
+ * Runs i18n checks on dictionaries against used translation keys.
+ *
+ * `dict_dir` is the path to the i18n directory with locale subdirectories.
+ * `used_keys` is a list of translation keys found in source code.
+ */
+export declare function checkI18n(dictDir: string, usedKeys: Array<string>): I18NCheckResult
+
 /**
  * Extracts searchable content from Markdown source.
  *
@@ -14,6 +22,13 @@ export declare function buildSearchIndex(documents: Array<JsSearchDocument>): st
  */
 export declare function extractSearchContent(source: string, id: string, url: string, options?: JsParserOptions | undefined | null): JsSearchDocument
 
+/**
+ * Extracts translation keys from a TypeScript/JavaScript source string.
+ *
+ * Finds calls like `t('key')` and `$t('key')`.
+ */
+export declare function extractTranslationKeys(source: string, filePath: string, functionNames?: Array<string> | undefined | null): Array<I18NKeyUsage>
+
 /**
  * Generates an OG image as SVG.
  *
@@ -25,6 +40,52 @@ export declare function generateOgImageSvg(data: JsOgImageData, config?: JsOgIma
 /** Generates SSG HTML page with navigation and search. */
 export declare function generateSsgHtml(pageData: JsSsgPageData, navGroups: Array<JsSsgNavGroup>, config: JsSsgConfig): string
 
+/** Result of i18n checking. */
+export interface I18NCheckResult {
+  /** All diagnostics. */
+  diagnostics: Array<I18NDiagnostic>
+  /** Number of errors. */
+  errorCount: number
+  /** Number of warnings. */
+  warningCount: number
+}
+
+/** A single i18n diagnostic. */
+export interface I18NDiagnostic {
+  /** Severity: "error", "warning", or "info". */
+  severity: string
+  /** Diagnostic message. */
+  message: string
+  /** Related translation key, if any. */
+  key?: string
+  /** Related locale, if any. */
+  locale?: string
+}
+
+/** A translation key usage found in source code. */
+export interface I18NKeyUsage {
+  /** The translation key. */
+  key: string
+  /** Source file path. */
+  filePath: string
+  /** Line number. */
+  line: number
+  /** Column number. */
+  column: number
+  /** End column number. */
+  endColumn: number
+}
+
+/** Result of loading dictionaries. */
+export interface I18NLoadResult {
+  /** Number of locales loaded. */
+  localeCount: number
+  /** All locale tags. */
+  locales: Array<string>
+  /** Errors encountered during loading. */
+  errors: Array<string>
+}
+
 /** Entry page configuration. */
 export interface JsEntryPageConfig {
   /** Hero section. */
@@ -83,6 +144,16 @@ export interface JsHeroImage {
   height?: number
 }
 
+/** Locale information for the locale switcher. */
+export interface JsLocaleInfo {
+  /** BCP 47 locale tag. */
+  code: string
+  /** Display name. */
+  name: string
+  /** Text direction. */
+  dir: string
+}
+
 /** OG image configuration for JavaScript. */
 export interface JsOgImageConfig {
   /** Image width in pixels. */
@@ -191,6 +262,10 @@ export interface JsSsgConfig {
   ogImage?: string
   /** Theme configuration. */
   theme?: JsThemeConfig
+  /** Current locale for this page. */
+  locale?: string
+  /** Available locales for locale switcher. */
+  availableLocales?: Array<JsLocaleInfo>
 }
 
 /** Navigation group for SSG. */
@@ -355,6 +430,22 @@ export interface JsTransformOptions {
   sourcePath?: string
 }
 
+/**
+ * Loads dictionaries from the given directory.
+ *
+ * The directory should contain locale subdirectories (e.g., `en/`, `ja/`)
+ * with JSON or YAML translation files.
+ */
+export declare function loadDictionaries(dir: string): I18NLoadResult
+
+/**
+ * Loads dictionaries from the given directory and returns a flat key-value map per locale.
+ *
+ * Each locale maps to a flat `{ "namespace.key": "value" }` structure.
+ * Supports both JSON and YAML dictionary files.
+ */
+export declare function loadDictionariesFlat(dir: string): Record<string, Record<string, string>>
+
 /** Mermaid transform result. */
 export interface MermaidTransformResult {
   /** The transformed HTML with mermaid code blocks replaced by rendered SVGs. */
@@ -363,6 +454,16 @@ export interface MermaidTransformResult {
   errors: Array<string>
 }
 
+/** Result of MF2 validation. */
+export interface Mf2ValidateResult {
+  /** Whether the message is valid. */
+  valid: boolean
+  /** Validation errors. */
+  errors: Array<string>
+  /** AST as JSON (if parsing succeeded). */
+  astJson?: string
+}
+
 /**
  * Parses Markdown source into an AST.
  *
@@ -444,5 +545,12 @@ export interface TransformResult {
   errors: Array<string>
 }
 
+/**
+ * Validates an MF2 message string.
+ *
+ * Returns parsing and semantic validation results.
+ */
+export declare function validateMf2(message: string): Mf2ValidateResult
+
 /** Returns the version of ox_content_napi. */
 export declare function version(): string

package/index.js

@@ -82,3 +82,8 @@ module.exports.searchIndex = binding.searchIndex
 module.exports.extractSearchContent = binding.extractSearchContent
 module.exports.generateSsgHtml = binding.generateSsgHtml
 module.exports.transformMermaid = binding.transformMermaid
+module.exports.loadDictionaries = binding.loadDictionaries
+module.exports.loadDictionariesFlat = binding.loadDictionariesFlat
+module.exports.validateMf2 = binding.validateMf2
+module.exports.checkI18n = binding.checkI18n
+module.exports.extractTranslationKeys = binding.extractTranslationKeys

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/napi",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Node.js bindings for Ox Content - High-performance Markdown parser",
   "main": "index.js",
   "types": "index.d.ts",
@@ -45,10 +45,10 @@
   "author": "ubugeeei",
   "license": "MIT",
   "optionalDependencies": {
-    "@ox-content/binding-darwin-x64": "0.13.0",
-    "@ox-content/binding-darwin-arm64": "0.13.0",
-    "@ox-content/binding-linux-x64-gnu": "0.13.0",
-    "@ox-content/binding-linux-arm64-gnu": "0.13.0",
-    "@ox-content/binding-win32-x64-msvc": "0.13.0"
+    "@ox-content/binding-darwin-x64": "0.14.0",
+    "@ox-content/binding-darwin-arm64": "0.14.0",
+    "@ox-content/binding-linux-x64-gnu": "0.14.0",
+    "@ox-content/binding-linux-arm64-gnu": "0.14.0",
+    "@ox-content/binding-win32-x64-msvc": "0.14.0"
   }
 }