docs: deprecate the internal TranslateTextOptions.__path option

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: hive-bot

CHANGELOG.md

@@ -68,6 +68,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   the DeepL API translates them as `en-US` and `pt-PT`. `TargetLanguageCode` now
   includes `en` and `pt`.
 
+### Deprecated
+- `TranslateTextOptions.__path` is deprecated. It is for internal use only
+  and will be removed in the next major version.
+
 ### Fixed
 - `downloadTranslationMemoryExport()` no longer hangs on Node 16 and 17 when the output file
   already exists. It now rejects with `EEXIST` before downloading anything, on every Node

src/types.ts

@@ -227,7 +227,10 @@ export interface TranslateTextOptions extends BaseRequestOptions {
      */
     customInstructions?: string[];
 
-    /** (internal only) Override path to send translate request to. */
+    /**
+     * (internal only) Override path to send translate request to.
+     * @deprecated For internal use only; will be removed in the next major version.
+     */
     __path?: string;
 }