docs-i18n 0.11.1 → 0.12.0

package/admin/dist/server/assets/{init-CJJUsPDL.js → init-SZW7wW3l.js}

@@ -11,7 +11,7 @@ function isCfWorkers() {
 async function initAdmin(config) {
 	_config = config;
 	if (!isCfWorkers()) {
-		const { initStatus } = await import("./status-B1AGLvHn.js");
+		const { initStatus } = await import("./status-BYF_y9fT.js");
 		const { setConfig } = await import("./job-manager-D9Ab9hgu.js");
 		initStatus(config);
 		setConfig(config);

package/admin/dist/server/assets/{jobs-DrEe9YOj.js → jobs-DVAdIxgN.js}

@@ -15,7 +15,7 @@ var fetchJobs_createServerFn_handler = createServerRpc({
 }, (opts) => fetchJobs.__executeServer(opts));
 var fetchJobs = createServerFn({ method: "GET" }).handler(fetchJobs_createServerFn_handler, async () => {
 	if (isCfWorkers()) return [];
-	const { ensureInit } = await import("./init-CJJUsPDL.js");
+	const { ensureInit } = await import("./init-SZW7wW3l.js");
 	await ensureInit();
 	return (await getJobManager()).list().map((j) => ({
 		...j,
@@ -29,7 +29,7 @@ var createJob_createServerFn_handler = createServerRpc({
 }, (opts) => createJob.__executeServer(opts));
 var createJob = createServerFn({ method: "POST" }).inputValidator((d) => d).handler(createJob_createServerFn_handler, async ({ data }) => {
 	if (isCfWorkers()) throw new Error("Job creation is not available on CF Workers");
-	const { ensureInit } = await import("./init-CJJUsPDL.js");
+	const { ensureInit } = await import("./init-SZW7wW3l.js");
 	await ensureInit();
 	if (!data.lang || !data.version) throw new Error("Missing lang or version");
 	return (await getJobManager()).start(data);

package/admin/dist/server/assets/{misc-BSoYldBT.js → misc-D0n9L-9D.js}

@@ -11,7 +11,7 @@ var fetchVersion_createServerFn_handler = createServerRpc({
 }, (opts) => fetchVersion.__executeServer(opts));
 var fetchVersion = createServerFn({ method: "GET" }).handler(fetchVersion_createServerFn_handler, async () => {
 	if (isCfWorkers()) return { version: "cf-workers" };
-	const { getPackageVersion } = await import("./dist-DBv71kqn.js").then((n) => n.n);
+	const { getPackageVersion } = await import("./dist-BnKtYOU0.js").then((n) => n.n);
 	return { version: getPackageVersion() };
 });
 var fetchLlmConfig_createServerFn_handler = createServerRpc({
@@ -25,14 +25,14 @@ var fetchLlmConfig = createServerFn({ method: "GET" }).handler(fetchLlmConfig_cr
 		provider: null,
 		hasApiKey: false
 	};
-	const { ensureInit, getConfig } = await import("./init-CJJUsPDL.js");
+	const { ensureInit, getConfig } = await import("./init-SZW7wW3l.js");
 	await ensureInit();
 	const llm = getConfig()?.llm;
 	let envVars = {};
 	try {
 		const { readFileSync, existsSync } = await import("node:fs");
 		const { resolve } = await import("node:path");
-		const { getProjectRoot } = await import("./init-CJJUsPDL.js");
+		const { getProjectRoot } = await import("./init-SZW7wW3l.js");
 		const envPath = resolve(getProjectRoot(), ".env");
 		if (existsSync(envPath)) {
 			const envContent = readFileSync(envPath, "utf-8");

package/admin/dist/server/assets/{router-Cxm33tn3.js → router-noqexgr0.js}

@@ -1,7 +1,7 @@
 import { i as __toESM } from "./chunk-CNvmzFzq.js";
 import { l as require_react, r as require_jsx_runtime, t as useRouter } from "./useRouter-BXJvr8to.js";
-import { N as escapeHtml, j as deepEqual, r as useStore, s as useHydrated } from "./__tanstack-start-server-fn-resolver-N1N5mZVv.js";
-import { A as skipToken, C as noop, D as resolveStaleTime, F as lazyRouteComponent, I as createFileRoute, L as createLazyFileRoute, N as focusManager, P as Subscribable, R as createRootRouteWithContext, S as matchQuery, _ as functionalUpdate, a as Mutation, g as ensureQueryFn, h as addToStart, l as onlineManager, m as addToEnd, p as addConsumeAwareSignal, r as QueryClientProvider, s as Query, t as Route$2, u as notifyManager, v as hashKey, w as partialMatchKey, x as matchMutation, y as hashQueryKeyByOptions } from "./routes-DtWFPDUc.js";
+import { N as escapeHtml, j as deepEqual, r as useStore, s as useHydrated } from "./__tanstack-start-server-fn-resolver-D1Ni2lpa.js";
+import { A as skipToken, C as noop, D as resolveStaleTime, F as lazyRouteComponent, I as createFileRoute, L as createLazyFileRoute, N as focusManager, P as Subscribable, R as createRootRouteWithContext, S as matchQuery, _ as functionalUpdate, a as Mutation, g as ensureQueryFn, h as addToStart, l as onlineManager, m as addToEnd, p as addConsumeAwareSignal, r as QueryClientProvider, s as Query, t as Route$2, u as notifyManager, v as hashKey, w as partialMatchKey, x as matchMutation, y as hashQueryKeyByOptions } from "./routes-CLdSUfb7.js";
 import { c as getAssetCrossOrigin, d as createNonReactiveMutableStore, f as createNonReactiveReadonlyStore, i as Outlet, l as resolveManifestAssetLink, u as RouterCore } from "../server.js";
 //#endregion
 //#region ../../node_modules/.bun/@tanstack+react-router@1.168.3+bf16f8eded5e12ee/node_modules/@tanstack/react-router/dist/esm/routerStores.js

package/admin/dist/server/assets/{routes-CxGhew8Z.js → routes-BG89QZ0_.js}

@@ -1,6 +1,6 @@
 import { i as __toESM } from "./chunk-CNvmzFzq.js";
 import { l as require_react, r as require_jsx_runtime } from "./useRouter-BXJvr8to.js";
-import { C as noop, D as resolveStaleTime, E as resolveEnabled, M as timeoutManager, N as focusManager, O as shallowEqualObjects, P as Subscribable, T as replaceData, b as isValidTimeout, c as fetchState, d as pendingThenable, f as environmentManager, i as useQueryClient, j as timeUntilStale, k as shouldThrowError, n as createSsrRpc, o as getDefaultState, t as Route, u as notifyManager, v as hashKey } from "./routes-DtWFPDUc.js";
+import { C as noop, D as resolveStaleTime, E as resolveEnabled, M as timeoutManager, N as focusManager, O as shallowEqualObjects, P as Subscribable, T as replaceData, b as isValidTimeout, c as fetchState, d as pendingThenable, f as environmentManager, i as useQueryClient, j as timeUntilStale, k as shouldThrowError, n as createSsrRpc, o as getDefaultState, t as Route, u as notifyManager, v as hashKey } from "./routes-CLdSUfb7.js";
 import { t as useNavigate } from "./useNavigate-0H08s_Q2.js";
 import { t as createServerFn } from "../server.js";
 import { t as authClient } from "./auth-client-CoUpyQIM.js";

package/admin/dist/server/assets/{routes-DtWFPDUc.js → routes-CLdSUfb7.js}

@@ -1,6 +1,6 @@
 import { i as __toESM } from "./chunk-CNvmzFzq.js";
 import { a as useForwardedRef, i as reactUse, l as require_react, o as useIntersectionObserver, r as require_jsx_runtime, t as useRouter } from "./useRouter-BXJvr8to.js";
-import { B as replaceEqualDeep$1, E as invariant, F as isDangerousProtocol, I as isModuleNotFoundError, P as functionalUpdate$1, a as matchContext, c as rootRouteId, f as exactPathTest, h as removeTrailingSlash, i as dummyMatchContext, j as deepEqual, m as joinPaths, n as require_react_dom, r as useStore, s as useHydrated, t as getServerFnById, v as trimPathLeft, y as trimPathRight } from "./__tanstack-start-server-fn-resolver-N1N5mZVv.js";
+import { B as replaceEqualDeep$1, E as invariant, F as isDangerousProtocol, I as isModuleNotFoundError, P as functionalUpdate$1, a as matchContext, c as rootRouteId, f as exactPathTest, h as removeTrailingSlash, i as dummyMatchContext, j as deepEqual, m as joinPaths, n as require_react_dom, r as useStore, s as useHydrated, t as getServerFnById, v as trimPathLeft, y as trimPathRight } from "./__tanstack-start-server-fn-resolver-D1Ni2lpa.js";
 import { t as useNavigate } from "./useNavigate-0H08s_Q2.js";
 import { n as TSS_SERVER_FUNCTION, p as redirect, t as createServerFn } from "../server.js";
 //#region ../../node_modules/.bun/@tanstack+router-core@1.168.3/node_modules/@tanstack/router-core/dist/esm/link.js
@@ -2113,7 +2113,7 @@ var getSession = createServerFn({ method: "GET" }).handler(createSsrRpc("539c27f
 */
 //#endregion
 //#region app/routes/index.tsx
-var $$splitComponentImporter = () => import("./routes-CxGhew8Z.js");
+var $$splitComponentImporter = () => import("./routes-BG89QZ0_.js");
 /**
 * Parse version keys into project/version structure.
 * Multi-project keys look like "query/v5", single-project keys look like "v5".

package/admin/dist/server/assets/{status-B1AGLvHn.js → status-BYF_y9fT.js}

@@ -1,4 +1,4 @@
-import { i as parseMdx, r as flattenSources, t as TranslationCache } from "./dist-DBv71kqn.js";
+import { i as parseMdx, r as flattenSources, t as TranslationCache } from "./dist-BnKtYOU0.js";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, resolve } from "node:path";
 //#region server/services/status.ts

package/admin/dist/server/assets/{status-D7PU72hm.js → status-C-jmHj1T.js}

@@ -1,7 +1,7 @@
 import { t as createServerFn } from "../server.js";
 import { t as createServerRpc } from "./createServerRpc-Cyyxq9HQ.js";
-import { getCache, getFileBlocks, getFileCoverage, getLangs, getOverview, getVersions, rescan } from "./status-B1AGLvHn.js";
-import { ensureInit } from "./init-CJJUsPDL.js";
+import { getCache, getFileBlocks, getFileCoverage, getLangs, getOverview, getVersions, rescan } from "./status-BYF_y9fT.js";
+import { ensureInit } from "./init-SZW7wW3l.js";
 //#region server/services/d1-status.ts
 /**
 * D1-backed status service for CF Workers deployment.

package/admin/dist/server/server.js

@@ -1,6 +1,6 @@
 import { i as __toESM, r as __require, t as __commonJSMin } from "./assets/chunk-CNvmzFzq.js";
 import { l as require_react, n as routerContext, r as require_jsx_runtime, t as useRouter } from "./assets/useRouter-BXJvr8to.js";
-import { A as decodePath, B as replaceEqualDeep, C as processRouteMasks, D as DEFAULT_PROTOCOL_ALLOWLIST, E as invariant, F as isDangerousProtocol, L as isPromise, M as encodePathLikeUrl, N as escapeHtml, O as arraysEqual, P as functionalUpdate, R as last, S as findSingleMatch, T as createLRUCache, _ as trimPath, a as matchContext, b as findFlatMatch, c as rootRouteId, d as compileDecodeCharMap, g as resolvePath, j as deepEqual, k as createControlledPromise, l as isNotFound, m as joinPaths, n as require_react_dom, o as ClientOnly, p as interpolatePath, r as useStore, t as getServerFnById, u as cleanPath, w as processRouteTree, x as findRouteMatch, y as trimPathRight, z as nullReplaceEqualDeep } from "./assets/__tanstack-start-server-fn-resolver-N1N5mZVv.js";
+import { A as decodePath, B as replaceEqualDeep, C as processRouteMasks, D as DEFAULT_PROTOCOL_ALLOWLIST, E as invariant, F as isDangerousProtocol, L as isPromise, M as encodePathLikeUrl, N as escapeHtml, O as arraysEqual, P as functionalUpdate, R as last, S as findSingleMatch, T as createLRUCache, _ as trimPath, a as matchContext, b as findFlatMatch, c as rootRouteId, d as compileDecodeCharMap, g as resolvePath, j as deepEqual, k as createControlledPromise, l as isNotFound, m as joinPaths, n as require_react_dom, o as ClientOnly, p as interpolatePath, r as useStore, t as getServerFnById, u as cleanPath, w as processRouteTree, x as findRouteMatch, y as trimPathRight, z as nullReplaceEqualDeep } from "./assets/__tanstack-start-server-fn-resolver-D1Ni2lpa.js";
 import { n as getAuth } from "./assets/auth.server-BLVDnTCZ.js";
 import { ReadableStream as ReadableStream$1 } from "node:stream/web";
 import { PassThrough, Readable } from "node:stream";
@@ -15001,7 +15001,7 @@ var NullProtoObj = /* @__PURE__ */ (() => {
 	return e.prototype = Object.create(null), Object.freeze(e.prototype), e;
 })();
 //#endregion
-//#region ../../node_modules/.bun/srvx@0.11.12/node_modules/srvx/dist/_chunks/_url.mjs
+//#region ../../node_modules/.bun/srvx@0.11.13/node_modules/srvx/dist/_chunks/_url.mjs
 function lazyInherit(target, source, sourceKey) {
 	for (const key of [...Object.getOwnPropertyNames(source), ...Object.getOwnPropertySymbols(source)]) {
 		if (key === "constructor") continue;
@@ -15056,7 +15056,8 @@ var FastURL = /* @__PURE__ */ (() => {
 		#searchParams;
 		#pos;
 		constructor(url) {
-			if (typeof url === "string") this.#href = url;
+			if (typeof url === "string") if (url[0] === "/") this.#href = url;
+			else this.#url = new NativeURL(url);
 			else if (_needsNormRE.test(url.pathname)) this.#url = new NativeURL(`${url.protocol || "http:"}//${url.host || "localhost"}${url.pathname}${url.search || ""}`);
 			else {
 				this.#protocol = url.protocol;
@@ -15144,7 +15145,7 @@ var FastURL = /* @__PURE__ */ (() => {
 	return FastURL;
 })();
 //#endregion
-//#region ../../node_modules/.bun/srvx@0.11.12/node_modules/srvx/dist/adapters/node.mjs
+//#region ../../node_modules/.bun/srvx@0.11.13/node_modules/srvx/dist/adapters/node.mjs
 /**
 * Fast Response for Node.js runtime
 *
@@ -16403,7 +16404,7 @@ var baseManifestPromise;
 */
 var cachedFinalManifestPromise;
 async function loadEntries() {
-	const routerEntry = await import("./assets/router-Cxm33tn3.js");
+	const routerEntry = await import("./assets/router-noqexgr0.js");
 	return {
 		startEntry: await import("./assets/start-BiybVoR2.js"),
 		routerEntry

package/dist/chunk-BHYFOPS6.js

@@ -0,0 +1,111 @@
+import {
+  flattenSources
+} from "./chunk-TRURQFP4.js";
+
+// src/plugins/runner.ts
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
+import matter from "gray-matter";
+function walkFiles(dir, extensions) {
+  const results = [];
+  if (!existsSync(dir)) return results;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...walkFiles(fullPath, extensions));
+    } else if (extensions.some((ext) => entry.name.endsWith(ext))) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+function runBeforeScan(plugins, config, opts) {
+  const beforeScanPlugins = plugins.filter((p) => p.beforeScan);
+  if (beforeScanPlugins.length === 0) return 0;
+  const sources = flattenSources(config);
+  const extensions = (config.include ?? ["**/*.mdx", "**/*.md"]).map(
+    (p) => p.replace("**/*", "")
+  );
+  let modifiedCount = 0;
+  for (const source of sources) {
+    if (opts?.project && source.project !== opts.project) continue;
+    if (opts?.version && source.version !== opts.version) continue;
+    const enDir = resolve(source.sourcePath);
+    if (!existsSync(enDir)) {
+      console.log(`  [SKIP] ${source.versionKey}: source dir not found`);
+      continue;
+    }
+    const files = walkFiles(enDir, extensions);
+    for (const filePath of files) {
+      const content = readFileSync(filePath, "utf-8");
+      let parsed;
+      try {
+        parsed = matter(content);
+      } catch {
+        continue;
+      }
+      const readFile = (refPath) => {
+        const fromDir = filePath.substring(0, filePath.lastIndexOf("/"));
+        const candidates = [
+          resolve(fromDir, refPath),
+          resolve(enDir, refPath),
+          resolve(process.cwd(), refPath)
+        ];
+        for (const candidate of candidates) {
+          if (existsSync(candidate)) {
+            return readFileSync(candidate, "utf-8");
+          }
+        }
+        return null;
+      };
+      let modified = content;
+      let wasModified = false;
+      for (const plugin of beforeScanPlugins) {
+        const result = plugin.beforeScan({
+          filePath,
+          content: modified,
+          frontmatter: parsed.data,
+          readFile,
+          project: source.project,
+          version: source.version
+        });
+        if (typeof result === "string") {
+          modified = result;
+          wasModified = true;
+          try {
+            parsed = matter(modified);
+          } catch {
+          }
+        }
+      }
+      if (wasModified) {
+        const relPath = filePath.slice(enDir.length + 1);
+        if (opts?.dryRun) {
+          console.log(`  [DRY-RUN] ${source.versionKey}/${relPath}`);
+        } else {
+          writeFileSync(filePath, modified, "utf-8");
+          console.log(`  [RESOLVED] ${source.versionKey}/${relPath}`);
+        }
+        modifiedCount++;
+      }
+    }
+  }
+  return modifiedCount;
+}
+function createShouldScanBody(plugins) {
+  const hooks = plugins.filter((p) => p.shouldScanBody);
+  if (hooks.length === 0) return void 0;
+  return (ctx) => {
+    for (const plugin of hooks) {
+      if (plugin.shouldScanBody(ctx) === false) {
+        return false;
+      }
+    }
+    return true;
+  };
+}
+
+export {
+  runBeforeScan,
+  createShouldScanBody
+};

package/dist/cli.js

@@ -144,6 +144,8 @@ Commands:
   translate    Translate content to target language(s)
   assemble     Assemble translated files from EN + cache
   rescan       Rescan source files and clean orphans
+  resolve      Run beforeScan plugins (e.g., resolve ref directives)
+  pipeline     Run full pipeline: sync \u2192 resolve \u2192 rescan \u2192 translate \u2192 upload \u2192 status
   status       Show translation coverage
   admin        Start admin dashboard
   site         Manage documentation site (dev, build, upload, deploy) [--custom]
@@ -159,6 +161,9 @@ Options:
   --max-tokens <n>      Max output tokens (default: 16384)
   --context-length <n>  Model context window (default: 32768)
   --dry-run             Preview without making changes
+  --skip-sync           Pipeline: skip sync step
+  --skip-translate      Pipeline: skip translate step
+  --skip-upload         Pipeline: skip upload step
   --port <n>            Admin dashboard port (default: 3456) / Site dev port (default: 3000)
 `);
     return;
@@ -176,7 +181,7 @@ Options:
         console.error("Error: --lang is required");
         process.exit(1);
       }
-      const { translate } = await import("./translate-A5X6MX4Y.js");
+      const { translate } = await import("./translate-AGUNMZMQ.js");
       await translate(config, {
         lang,
         project: getOpt("project") || void 0,
@@ -193,7 +198,7 @@ Options:
       break;
     }
     case "assemble": {
-      const { assembleAll } = await import("./assemble-CP2BRYQJ.js");
+      const { assembleAll } = await import("./assemble-S3MWVLBI.js");
       await assembleAll(config, {
         project: getOpt("project") || void 0,
         version: getOpt("version") || void 0,
@@ -202,15 +207,49 @@ Options:
       break;
     }
     case "rescan": {
-      const { rescan } = await import("./rescan-HXMWFAOC.js");
+      const { rescan } = await import("./rescan-7XDHUNH5.js");
+      const plugins = config.plugins ?? [];
+      const shouldScanBody = plugins.length > 0 ? (await import("./runner-KUGSO4CL.js")).createShouldScanBody(plugins) : void 0;
       await rescan(config, {
         project: getOpt("project") || void 0,
-        version: getOpt("version") || void 0
+        version: getOpt("version") || void 0,
+        shouldScanBody
+      });
+      break;
+    }
+    case "resolve": {
+      const resolvePlugins = config.plugins ?? [];
+      if (resolvePlugins.length === 0) {
+        console.log("No plugins configured. Nothing to resolve.");
+        break;
+      }
+      const { runBeforeScan } = await import("./runner-KUGSO4CL.js");
+      const modified = runBeforeScan(resolvePlugins, config, {
+        project: getOpt("project") || void 0,
+        version: getOpt("version") || void 0,
+        dryRun: hasFlag("dry-run")
+      });
+      console.log(`
+${modified} file(s) resolved`);
+      break;
+    }
+    case "pipeline": {
+      const { pipeline } = await import("./pipeline-3XGFR4QL.js");
+      await pipeline(config, {
+        skipSync: hasFlag("skip-sync"),
+        skipTranslate: hasFlag("skip-translate"),
+        skipUpload: hasFlag("skip-upload"),
+        dryRun: hasFlag("dry-run"),
+        project: getOpt("project") || void 0,
+        version: getOpt("version") || void 0,
+        lang: getOpt("lang") || void 0,
+        max: getOpt("max") ? Number(getOpt("max")) : void 0,
+        concurrency: getOpt("concurrency") ? Number(getOpt("concurrency")) : void 0
       });
       break;
     }
     case "status": {
-      const { status } = await import("./status-AGZDXOTZ.js");
+      const { status } = await import("./status-NX47XZIU.js");
       await status(config, { lang: getOpt("lang") || void 0 });
       break;
     }

package/dist/index.d.ts

@@ -2,10 +2,44 @@ import * as unified from 'unified';
 import * as mdast from 'mdast';
 import { Root } from 'hast';
 
+/**
+ * Plugin interface for docs-i18n.
+ *
+ * Plugins can hook into the scan pipeline to transform source files
+ * before they are parsed and to control which parts of a file are scanned.
+ */
+interface DocsI18nPlugin {
+    name: string;
+    /**
+     * Called before scanning a source file.
+     * Receives the file content and frontmatter, and can return modified content.
+     * If the plugin returns a string, the file content is replaced with that string.
+     * If undefined/void is returned, the file is left unchanged.
+     */
+    beforeScan?: (ctx: {
+        filePath: string;
+        content: string;
+        frontmatter: Record<string, any>;
+        readFile: (refPath: string) => string | null;
+        project: string;
+        version: string;
+    }) => string | undefined | void;
+    /**
+     * Called to determine whether a file's body should be scanned for translation nodes.
+     * If any plugin returns false, only frontmatter fields will be scanned.
+     * If all plugins return true (or don't implement this hook), the full body is scanned.
+     */
+    shouldScanBody?: (ctx: {
+        filePath: string;
+        frontmatter: Record<string, any>;
+    }) => boolean;
+}
+
 /**
  * docs-i18n configuration schema.
  * Each project provides a `docs-i18n.config.ts` file.
  */
+
 interface ProjectConfig {
     /** Map of version → source directory (relative to project root) */
     sources: Record<string, string>;
@@ -37,6 +71,15 @@ interface DocsI18nConfig {
         version: string;
         lang: string;
     }) => Promise<void>;
+    /** Shell command to run before pipeline (e.g., sync upstream content) */
+    syncScript?: string;
+    /** Plugins for the scan pipeline */
+    plugins?: DocsI18nPlugin[];
+    /** Cloudflare D1 database configuration for remote upload */
+    d1?: {
+        database: string;
+        accountId?: string;
+    };
 }
 declare function defineConfig(config: DocsI18nConfig): DocsI18nConfig;
 /** Load config from file */
@@ -296,4 +339,68 @@ declare function normalize(content: string): string;
  */
 declare function getPackageVersion(): string;
 
-export { type DocsI18nConfig, type Heading, type ProjectConfig, type RenderedMarkdown, TranslationCache, assemble, defineConfig, extractHeadings, extractTranslatableFields, flattenSources, getPackageVersion, loadConfig, normalize, parseMdx, processor, reconstructFrontmatter, renderMarkdown };
+/**
+ * Plugin execution engine.
+ *
+ * Provides functions to run plugin hooks across source files.
+ */
+
+/**
+ * Run beforeScan hooks for all plugins on all source files.
+ *
+ * Walks every source directory, reads each file, runs every plugin's
+ * beforeScan hook, and writes back modified content.
+ *
+ * Returns the number of files that were modified.
+ */
+declare function runBeforeScan(plugins: DocsI18nPlugin[], config: DocsI18nConfig, opts?: {
+    project?: string;
+    version?: string;
+    dryRun?: boolean;
+}): number;
+/**
+ * Create a shouldScanBody function that checks all plugins.
+ *
+ * Returns a function that takes a file path and frontmatter and returns
+ * false if any plugin says the body should not be scanned.
+ */
+declare function createShouldScanBody(plugins: DocsI18nPlugin[]): ((ctx: {
+    filePath: string;
+    frontmatter: Record<string, any>;
+}) => boolean) | undefined;
+
+/**
+ * TanStack ref resolver plugin.
+ *
+ * Resolves `ref` frontmatter directives in markdown files, following ref chains
+ * up to a maximum depth. Applies `replace{}` text substitutions and section
+ * replacements from the origin file's frontmatter.
+ *
+ * Ported from tanstack-i18n-docs/scripts/resolve-refs.ts
+ */
+
+/**
+ * Create the TanStack ref resolver plugin.
+ *
+ * This plugin resolves `ref` frontmatter directives by following ref chains
+ * and applying replace/section substitutions.
+ */
+declare function tanstackRefPlugin(): DocsI18nPlugin;
+
+/**
+ * Next.js source filter plugin.
+ *
+ * Files with a `source:` field in frontmatter reference external content
+ * that will be fetched at build time. Their body should not be scanned
+ * for translation since it's just a placeholder / empty.
+ */
+
+/**
+ * Create the Next.js source filter plugin.
+ *
+ * When a file has `source:` in its frontmatter, shouldScanBody returns false
+ * so only translatable frontmatter fields (title, description, etc.) are scanned.
+ */
+declare function nextjsSourcePlugin(): DocsI18nPlugin;
+
+export { type DocsI18nConfig, type DocsI18nPlugin, type Heading, type ProjectConfig, type RenderedMarkdown, TranslationCache, assemble, createShouldScanBody, defineConfig, extractHeadings, extractTranslatableFields, flattenSources, getPackageVersion, loadConfig, nextjsSourcePlugin, normalize, parseMdx, processor, reconstructFrontmatter, renderMarkdown, runBeforeScan, tanstackRefPlugin };