hive-react-kit 0.9.3 → 0.9.5

package/README.md

@@ -10,6 +10,7 @@ A comprehensive React component library for building Hive blockchain application
 - 🎯 **TypeScript Support** - Full TypeScript support with type definitions
 - 🚀 **Tree Shaking** - Optimized bundle size with tree shaking support
 - 🎭 **Customizable** - Easy to customize and extend
+- 🌐 **Content i18n** - Wrap once, every Hive post body / comment / feed preview translates to the user's language. See [docs/i18n.md](docs/i18n.md)
 
 ## Installation
 
@@ -415,6 +416,45 @@ See [docs/HiveContributionsLanding.md](docs/HiveContributionsLanding.md) for ful
 | 3Speak | https://3speak.tv/ |
 | HiveFestFacts | https://hivefestfacts.sagarkothari88.one/ |
 
+### Content Translation (i18n)
+
+Wrap your app once with `<HiveLanguageProvider>` and every Hive content body / title / comment / feed preview rendered by the kit translates to the chosen language. Free MyMemory-backed translator by default, fully overridable for DeepL / Google / your own backend.
+
+```tsx
+import { HiveLanguageProvider } from 'hive-react-kit';
+
+<HiveLanguageProvider language="es">
+  <App />
+</HiveLanguageProvider>
+```
+
+**Auto-translates:** post bodies (`HiveDetailPost`, `InlineCommentItem`, `CommentTile`, `UserChannel`), feed-card titles + previews (`UserDetailProfile`), poll questions / previews / choice labels (`PollListItem`).
+
+**Available exports:**
+
+| Export | Purpose |
+|--------|---------|
+| `HiveLanguageProvider` | Wrap app once with `language="es"` (or any code MyMemory accepts). `language="en"` is no-op |
+| `useHiveLanguage()` | Read current `{ language, translateHtml }` from context |
+| `useTranslatedHtml(html)` | Hook returning `{ html, loading }` for translated rendered HTML |
+| `useTranslatedText(text)` | Hook returning `{ text, loading }` for translated plain strings |
+| `<TranslatedBody>` | `forwardRef`-aware drop-in for `<div … dangerouslySetInnerHTML>` |
+| `<TranslatedText>` | Inline wrapper for plain strings inside `.map()` loops |
+| `translateHtml`, `translateText` | Low-level helpers (rarely needed) |
+
+**Custom translator** — pass `translateHtml` to override the bundled MyMemory implementation:
+
+```tsx
+<HiveLanguageProvider
+  language={language}
+  translateHtml={async (html, target) => callDeepL(html, target)}
+>
+  <App />
+</HiveLanguageProvider>
+```
+
+See [docs/i18n.md](docs/i18n.md) for the full provider API, hook signatures, custom-translator integration, caching layers, failure modes, and behaviour with code blocks / embeds.
+
 ### Feed Components
 
 - **PostFeedList** - Display a list of posts with sorting, filtering, and interaction capabilities

package/dist/components/HiveDetailPost.d.ts

@@ -28,6 +28,18 @@ export interface HiveDetailPostProps {
      * Typically wired to a user setting.
      */
     defaultReward?: import('../utils/commentOptions').RewardOption;
+    /**
+     * Initial percent (1–100) for the post's upvote slider AND every comment
+     * composer's "upvote-on-publish" / comment-upvote slider on this page.
+     * Default 100. Typically wired to a user setting.
+     */
+    defaultVotePercent?: number;
+    /**
+     * Slider precision (0.25, 0.5, or 1) used by every vote slider on this
+     * page — the post upvote action, comment upvote actions, and the
+     * upvote-on-publish slider in the comment composer. Default 0.25.
+     */
+    voteWeightStep?: number;
     /**
      * Override the Hive content renderer's link-generating functions so the
      * rendered `<a>` URLs route into your app instead of an external Hive
@@ -88,5 +100,5 @@ export interface HiveDetailPostProps {
     /** Called when user clicks "View parent post" — navigate to the parent post. */
     onNavigateToPost?: (author: string, permlink: string) => void;
 }
-export declare function HiveDetailPost({ author, permlink, currentUser, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onShare, onTip, onReport, onShareComment, onTipComment, onReportComment, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, reportedAuthors, reportedPosts, hiveIconUrl, backgroundColor, onBack, onUserClick, onNavigateToPost, onVotePoll, showVoteButton, processBody, defaultReward, renderOptions, }: HiveDetailPostProps): import("react/jsx-runtime").JSX.Element;
+export declare function HiveDetailPost({ author, permlink, currentUser, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onShare, onTip, onReport, onShareComment, onTipComment, onReportComment, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, reportedAuthors, reportedPosts, hiveIconUrl, backgroundColor, onBack, onUserClick, onNavigateToPost, onVotePoll, showVoteButton, processBody, defaultReward, defaultVotePercent, voteWeightStep, renderOptions, }: HiveDetailPostProps): import("react/jsx-runtime").JSX.Element;
 export default HiveDetailPost;

package/dist/components/TranslatedBody.d.ts

@@ -0,0 +1,20 @@
+import React from "react";
+export interface TranslatedBodyProps {
+    /** Rendered post / comment body HTML (output of `createHiveRenderer`). */
+    html: string;
+    className?: string;
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+}
+/**
+ * Drop-in replacement for
+ *   `<div className="…" onClick={…} dangerouslySetInnerHTML={{ __html: html }} />`
+ * that translates the body into the language supplied by the nearest
+ * `<HiveLanguageProvider>`. Forwards refs to the inner div so existing
+ * click-delegation / image-fallback logic continues to attach correctly.
+ *
+ * While translation is in flight the original HTML is shown and the
+ * `data-translating="true"` attribute is set on the div so consumers
+ * can apply a CSS-only loading style if they want.
+ */
+export declare const TranslatedBody: React.ForwardRefExoticComponent<TranslatedBodyProps & React.RefAttributes<HTMLDivElement>>;
+export default TranslatedBody;

package/dist/components/TranslatedText.d.ts

@@ -0,0 +1,26 @@
+import React from "react";
+export interface TranslatedTextProps {
+    /** Plain-text source string (post title, snippet, caption, etc.). */
+    text: string | null | undefined;
+    /**
+     * Optional fallback rendered when both translated and source text are
+     * empty — typically the calling component already conditionally renders
+     * this wrapper, so it's rarely needed.
+     */
+    fallback?: React.ReactNode;
+}
+/**
+ * Drop-in inline wrapper for translating a plain string into the language
+ * supplied by the nearest `<HiveLanguageProvider>`. Useful inside loops /
+ * `.map()` render functions where calling `useTranslatedText` directly
+ * would break the rules of hooks.
+ *
+ * ```tsx
+ * <h2><TranslatedText text={item.title} /></h2>
+ * ```
+ *
+ * Returns the original synchronously while the translation is in flight,
+ * so titles never flash empty. No-op for English.
+ */
+export declare const TranslatedText: React.FC<TranslatedTextProps>;
+export default TranslatedText;

package/dist/components/VoteSlider.d.ts

@@ -1,7 +1,9 @@
-export declare function VoteSlider({ author, permlink, defaultValue, onUpvote, onCancel, }: {
+export declare function VoteSlider({ author, permlink, defaultValue, step, onUpvote, onCancel, }: {
     author: string;
     permlink: string;
     defaultValue?: number;
+    /** Slider precision. Use 0.25, 0.5, or 1 (default 1). */
+    step?: number;
     onUpvote: (percent: number) => Promise<void> | void;
     onCancel: () => void;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/components/actionButtons/PostActionButton.d.ts

@@ -28,6 +28,11 @@ export interface PostActionButtonProps {
     parentTags?: string[];
     /** Default reward routing seeded into the comment composer. */
     defaultReward?: import('../../utils/commentOptions').RewardOption;
+    /** Initial percent for the upvote slider when opened (1–100). Default 100. */
+    defaultVotePercent?: number;
+    /** Slider precision used by both the post upvote slider AND the comment composer's
+     *  "upvote-on-publish" slider. Use 0.25, 0.5, or 1. Default 0.25 (back-compat). */
+    voteWeightStep?: number;
     /** Called when comment button is clicked (e.g. open comments). */
     onComments?: () => void;
     /** Called when reblog is clicked (when logged in). */
@@ -53,5 +58,5 @@ export interface PostActionButtonProps {
     /** When true, clicking the comment icon calls onComments instead of opening the CommentsModal popup */
     disableCommentsModal?: boolean;
 }
-export declare function PostActionButton({ author, permlink, currentUser: currentUserProp, hiveValue, hiveIconUrl, payoutTooltip, initialVotes, initialCommentsCount, onUpvote, onSubmitComment, onComments, onReblog, onShare, onTip, onReport, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, disableCommentsModal, showVoteButton, parentTags, defaultReward, }: PostActionButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function PostActionButton({ author, permlink, currentUser: currentUserProp, hiveValue, hiveIconUrl, payoutTooltip, initialVotes, initialCommentsCount, onUpvote, onSubmitComment, onComments, onReblog, onShare, onTip, onReport, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, disableCommentsModal, showVoteButton, parentTags, defaultReward, defaultVotePercent, voteWeightStep, }: PostActionButtonProps): import("react/jsx-runtime").JSX.Element;
 export default PostActionButton;

package/dist/components/comments/AddCommentInput.d.ts

@@ -68,8 +68,11 @@ export interface PostComposerProps {
     showVoteButton?: boolean;
     /** Initial toggle state for upvote-on-publish (default false). */
     defaultVoteEnabled?: boolean;
-    /** Initial slider percent (1–100, step 0.25, default 100). */
+    /** Initial slider percent (1–100, default 100). Snapped to `voteWeightStep`. */
     defaultVotePercent?: number;
+    /** Slider precision for the upvote-on-publish slider. Use 0.25, 0.5, or 1.
+     *  Default 0.25 (back-compat). */
+    voteWeightStep?: number;
     /**
      * Called whenever the upvote-on-publish toggle or percent changes.
      * `enabled=false` => consumer should post a plain comment.
@@ -115,8 +118,8 @@ export interface PostComposerProps {
 }
 /** @deprecated Use PostComposerProps instead */
 export type AddCommentInputProps = PostComposerProps;
-declare const PostComposer: ({ onSubmit, onCancel, currentUser, placeholder, parentAuthor, parentPermlink, ecencyToken, onSignMessage, signingUsername, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hideBold, hideItalic, hideLink, hideImage, hideAudio, hideVideo, hideEmoji, hideGif, hideCode, hideMention, hideTemplate, hidePreview, hidePoll, onPollChange, defaultTags, maxTags, onTagsChange, hideTags, reward, defaultReward, onRewardChange, hideReward, showVoteButton, defaultVoteEnabled, defaultVotePercent, onVoteChange, voteLabel, showCancel, submitLabel, title, defaultPreviewOn, value, onChange, disabled, hideSubmitArea, submitRef, hideUserHeader, bgColor, borderColor, disableAutoFocus, walletApprovalLabel, awaitingWalletApproval, }: PostComposerProps) => import("react/jsx-runtime").JSX.Element;
+declare const PostComposer: ({ onSubmit, onCancel, currentUser, placeholder, parentAuthor, parentPermlink, ecencyToken, onSignMessage, signingUsername, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hideBold, hideItalic, hideLink, hideImage, hideAudio, hideVideo, hideEmoji, hideGif, hideCode, hideMention, hideTemplate, hidePreview, hidePoll, onPollChange, defaultTags, maxTags, onTagsChange, hideTags, reward, defaultReward, onRewardChange, hideReward, showVoteButton, defaultVoteEnabled, defaultVotePercent, voteWeightStep, onVoteChange, voteLabel, showCancel, submitLabel, title, defaultPreviewOn, value, onChange, disabled, hideSubmitArea, submitRef, hideUserHeader, bgColor, borderColor, disableAutoFocus, walletApprovalLabel, awaitingWalletApproval, }: PostComposerProps) => import("react/jsx-runtime").JSX.Element;
 /** @deprecated Use PostComposer instead */
-declare const AddCommentInput: ({ onSubmit, onCancel, currentUser, placeholder, parentAuthor, parentPermlink, ecencyToken, onSignMessage, signingUsername, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hideBold, hideItalic, hideLink, hideImage, hideAudio, hideVideo, hideEmoji, hideGif, hideCode, hideMention, hideTemplate, hidePreview, hidePoll, onPollChange, defaultTags, maxTags, onTagsChange, hideTags, reward, defaultReward, onRewardChange, hideReward, showVoteButton, defaultVoteEnabled, defaultVotePercent, onVoteChange, voteLabel, showCancel, submitLabel, title, defaultPreviewOn, value, onChange, disabled, hideSubmitArea, submitRef, hideUserHeader, bgColor, borderColor, disableAutoFocus, walletApprovalLabel, awaitingWalletApproval, }: PostComposerProps) => import("react/jsx-runtime").JSX.Element;
+declare const AddCommentInput: ({ onSubmit, onCancel, currentUser, placeholder, parentAuthor, parentPermlink, ecencyToken, onSignMessage, signingUsername, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hideBold, hideItalic, hideLink, hideImage, hideAudio, hideVideo, hideEmoji, hideGif, hideCode, hideMention, hideTemplate, hidePreview, hidePoll, onPollChange, defaultTags, maxTags, onTagsChange, hideTags, reward, defaultReward, onRewardChange, hideReward, showVoteButton, defaultVoteEnabled, defaultVotePercent, voteWeightStep, onVoteChange, voteLabel, showCancel, submitLabel, title, defaultPreviewOn, value, onChange, disabled, hideSubmitArea, submitRef, hideUserHeader, bgColor, borderColor, disableAutoFocus, walletApprovalLabel, awaitingWalletApproval, }: PostComposerProps) => import("react/jsx-runtime").JSX.Element;
 export { PostComposer };
 export default AddCommentInput;

package/dist/components/comments/CommentsModal.d.ts

@@ -30,6 +30,10 @@ interface CommentsModalProps {
     templateToken?: string;
     /** Custom template API endpoint */
     templateApiBaseUrl?: string;
+    /** Initial percent for the composer's "upvote on publish" slider. Default 100. */
+    defaultVotePercent?: number;
+    /** Slider precision for the composer's "upvote on publish" slider (0.25, 0.5, or 1). Default 0.25. */
+    voteWeightStep?: number;
 }
-declare const CommentsModal: ({ author, permlink, onClose, currentUser, token, onClickCommentUpvote, onClickCommentReply, onClickUpvoteButton, onSubmitComment, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, showVoteButton, parentTags, defaultReward }: CommentsModalProps) => import("react/jsx-runtime").JSX.Element;
+declare const CommentsModal: ({ author, permlink, onClose, currentUser, token, onClickCommentUpvote, onClickCommentReply, onClickUpvoteButton, onSubmitComment, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, showVoteButton, parentTags, defaultReward, defaultVotePercent, voteWeightStep }: CommentsModalProps) => import("react/jsx-runtime").JSX.Element;
 export default CommentsModal;

package/dist/components/inlineComments/InlineCommentItem.d.ts

@@ -29,6 +29,11 @@ interface InlineCommentItemProps {
     onUserClick?: (username: string) => void;
     /** Default reward routing seeded into every reply composer. */
     defaultReward?: RewardOption;
+    /** Initial percent for the comment-upvote slider AND reply composer's
+     *  upvote-on-publish slider. Default 100. */
+    defaultVotePercent?: number;
+    /** Slider precision (0.25, 0.5, or 1) used by both sliders. Default 0.25. */
+    voteWeightStep?: number;
     /** Renderer URL overrides applied to the comment body. */
     renderOptions?: {
         userLinkUrlFn?: (username: string) => string;
@@ -37,5 +42,5 @@ interface InlineCommentItemProps {
         ipfsGateway?: string;
     };
 }
-export default function InlineCommentItem({ comment, allComments, onReply, onCancelReply, onCommentSubmit, activeReplyKey, currentUser, token, depth, onVotedRefresh, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hiveIconUrl, onShareComment, onTipComment, onReportComment, onNavigateToPost, onUserClick, defaultReward, renderOptions, }: InlineCommentItemProps): import("react/jsx-runtime").JSX.Element;
+export default function InlineCommentItem({ comment, allComments, onReply, onCancelReply, onCommentSubmit, activeReplyKey, currentUser, token, depth, onVotedRefresh, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, hiveIconUrl, onShareComment, onTipComment, onReportComment, onNavigateToPost, onUserClick, defaultReward, defaultVotePercent, voteWeightStep, renderOptions, }: InlineCommentItemProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/inlineComments/InlineCommentSection.d.ts

@@ -15,6 +15,10 @@ interface InlineCommentSectionProps {
     parentTags?: string[];
     /** Default reward routing seeded into every reply composer in this section. */
     defaultReward?: RewardOption;
+    /** Initial percent for the "upvote on publish" slider in every reply composer. Default 100. */
+    defaultVotePercent?: number;
+    /** Slider precision (0.25, 0.5, or 1) used by every reply composer. Default 0.25. */
+    voteWeightStep?: number;
     /** Renderer URL overrides applied to every comment body in this section. */
     renderOptions?: {
         userLinkUrlFn?: (username: string) => string;
@@ -43,5 +47,5 @@ interface InlineCommentSectionProps {
     /** Intercept intra-body Hive profile links in comment bodies. */
     onUserClick?: (username: string) => void;
 }
-export default function InlineCommentSection({ author, permlink, currentUser, token, onSubmitComment, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, reportedAuthors, reportedPosts, hiveIconUrl, onShareComment, onTipComment, onReportComment, onNavigateToPost, onUserClick, showVoteButton, alreadyVoted, parentTags, defaultReward, renderOptions, }: InlineCommentSectionProps): import("react/jsx-runtime").JSX.Element;
+export default function InlineCommentSection({ author, permlink, currentUser, token, onSubmitComment, onClickCommentUpvote, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, reportedAuthors, reportedPosts, hiveIconUrl, onShareComment, onTipComment, onReportComment, onNavigateToPost, onUserClick, showVoteButton, alreadyVoted, parentTags, defaultReward, defaultVotePercent, voteWeightStep, renderOptions, }: InlineCommentSectionProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/user/PollListItem.d.ts

@@ -32,6 +32,10 @@ export interface PollListItemProps {
     giphyApiKey?: string;
     templateToken?: string;
     templateApiBaseUrl?: string;
+    /** Initial percent (1–100) for the poll's upvote slider. Default 100. */
+    defaultVotePercent?: number;
+    /** Slider precision (0.25 / 0.5 / 1) used by the poll's upvote slider. Default 0.25. */
+    voteWeightStep?: number;
 }
 declare const PollListItem: React.FC<PollListItemProps>;
 export default PollListItem;

package/dist/components/user/UserDetailProfile.d.ts

@@ -66,6 +66,13 @@ export interface UserDetailProfileProps {
     onAddToFavourite?: (username: string) => void | Promise<void>;
     isFavourited?: boolean;
     favouriteCount?: number;
+    /** Initial percent (1–100) for every upvote slider on the profile page —
+     *  post upvotes, comment upvotes, and the upvote-on-publish slider in
+     *  inline comment composers. Default 100. Typically wired to a user setting. */
+    defaultVotePercent?: number;
+    /** Slider precision (0.25, 0.5, or 1) for every upvote slider on this page.
+     *  Default 0.25. */
+    voteWeightStep?: number;
 }
 type TabType = "blogs" | "posts" | "snaps" | "polls" | "comments" | "replies" | "activities" | "authorRewards" | "curationRewards" | "followers" | "following" | "wallet" | "votingPower" | "badges" | "witnessVotes" | "growth";
 declare const UserDetailProfile: React.FC<UserDetailProfileProps>;

package/dist/i18n/HiveLanguageContext.d.ts

@@ -0,0 +1,67 @@
+import React from "react";
+import { type KitMessageKey } from "./messages";
+export type TranslateHtmlFn = (html: string, target: string) => Promise<string>;
+/** Look up a UI label in the supplied dict, with English fallback. */
+export type KitTFn = (key: KitMessageKey, vars?: Record<string, string | number>) => string;
+export interface HiveLanguageContextValue {
+    /**
+     * Two-letter language code for translating user-generated content
+     * (post bodies, comments, activity bodies). `"en"` is the no-op default —
+     * content passes through unchanged.
+     */
+    language: string;
+    /**
+     * Custom translator. Defaults to a free MyMemory-backed implementation
+     * that ships with the kit. Override to plug in DeepL, Google Translate,
+     * or any other service — receives the rendered HTML and target language,
+     * returns translated HTML.
+     */
+    translateHtml: TranslateHtmlFn;
+    /**
+     * UI label translator. Resolves a key against the merged messages dict
+     * (consumer overrides → kit built-ins → English source-of-truth).
+     */
+    t: KitTFn;
+}
+export interface HiveLanguageProviderProps {
+    /** Two-letter language code, e.g. `"en"`, `"es"`. Defaults to `"en"`. */
+    language?: string;
+    /**
+     * Optional override translator for user-generated HTML. If omitted, the
+     * kit's default MyMemory-backed implementation is used.
+     */
+    translateHtml?: TranslateHtmlFn;
+    /**
+     * Optional UI label overrides keyed by language code. Merges on top of
+     * the kit's built-in `en` + `es` dicts:
+     *
+     * ```tsx
+     * messages={{
+     *   es: { "action.follow": "Seguir cuenta" },  // override one label
+     *   fr: { "action.follow": "Suivre" },         // add a new language
+     * }}
+     * ```
+     *
+     * Missing keys for a non-English language fall back to English.
+     */
+    messages?: Record<string, Record<string, string>>;
+    children: React.ReactNode;
+}
+/**
+ * Wrap your app once with this provider so every Hive content body
+ * rendered by the kit (`<HiveDetailPost>`, comments, snaps, profile feeds,
+ * activity bodies) translates to the chosen language.
+ *
+ * ```tsx
+ * <HiveLanguageProvider language={i18n.language}>
+ *   <App />
+ * </HiveLanguageProvider>
+ * ```
+ *
+ * When `language === "en"` (the default), the provider is a no-op.
+ */
+export declare const HiveLanguageProvider: React.FC<HiveLanguageProviderProps>;
+/** Read the current Hive language + translator + label resolver from context. */
+export declare function useHiveLanguage(): HiveLanguageContextValue;
+/** Convenience hook returning just the UI label resolver. */
+export declare function useKitT(): KitTFn;

package/dist/i18n/index.d.ts

@@ -0,0 +1,5 @@
+export { HiveLanguageProvider, useHiveLanguage, useKitT, type HiveLanguageProviderProps, type HiveLanguageContextValue, type TranslateHtmlFn, type KitTFn, } from "./HiveLanguageContext";
+export { useTranslatedHtml } from "./useTranslatedHtml";
+export { useTranslatedText } from "./useTranslatedText";
+export { translateHtml, translateText } from "./translateService";
+export { BUILTIN_MESSAGES, formatMessage, type KitMessageKey, type KitMessages, } from "./messages";

package/dist/i18n/messages.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Built-in UI label translations for hive-react-kit components.
+ *
+ * Keys follow the dotted convention `area.label`. Each language is a
+ * flat Record<string, string>. Consumers can extend or override specific
+ * keys via the `messages` prop on `<HiveLanguageProvider>`:
+ *
+ * ```tsx
+ * <HiveLanguageProvider
+ *   language="es"
+ *   messages={{ es: { "action.follow": "Suivre" } }}
+ * />
+ * ```
+ *
+ * Missing keys for a non-English language fall back to the English entry,
+ * which is the source of truth for every label.
+ */
+export type KitMessageKey = "tab.blogs" | "tab.posts" | "tab.snaps" | "tab.polls" | "tab.comments" | "tab.replies" | "tab.activities" | "tab.authorRewards" | "tab.curationRewards" | "tab.growth" | "tab.followers" | "tab.following" | "tab.wallet" | "tab.votingPower" | "tab.badges" | "tab.witnessVotes" | "meta.followers" | "meta.following" | "meta.posts" | "action.follow" | "action.unfollow" | "action.ignoreAuthor" | "action.reportUser" | "action.shareProfile" | "action.cancel" | "action.confirmIgnore" | "action.processing" | "modal.ignoreAuthorTitle" | "modal.ignoreAuthorBody" | "empty.noBlogs" | "empty.noPosts" | "empty.noSnaps" | "empty.noPolls" | "empty.noComments" | "empty.noReplies" | "empty.noFollowers" | "empty.notFollowing" | "empty.noBadges" | "empty.noWitnessVotes" | "empty.noPendingAuthor" | "empty.noPendingCuration" | "empty.curationHint" | "empty.votingPowerUnavailable" | "empty.userNotFound" | "status.active" | "status.ended" | "poll.selectAnOption" | "poll.selectUpTo" | "poll.changeYourVote" | "poll.selected" | "poll.submitVote" | "poll.submitVotes" | "poll.changeVote" | "poll.submitting" | "poll.voted" | "poll.voteChangesAllowed" | "poll.voter" | "poll.voters" | "poll.option" | "poll.options" | "poll.endsIn" | "common.translating" | "common.processing" | "common.fullyCharged" | "reward.pendingAuthor" | "reward.pendingCuration" | "reward.posts" | "reward.comments" | "reward.totalHbd" | "reward.totalHp" | "reward.avgEfficiency" | "reward.post" | "reward.comment" | "vp.upvotePower" | "vp.downvotePower" | "vp.resourceCredits";
+export type KitMessages = Partial<Record<KitMessageKey, string>>;
+export declare const BUILTIN_MESSAGES: Record<string, Record<string, string>>;
+/**
+ * Format helper — replaces `{key}` placeholders with the corresponding
+ * value from `vars`. Missing vars leave the placeholder intact.
+ */
+export declare function formatMessage(template: string, vars?: Record<string, string | number>): string;

package/dist/i18n/translateService.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MyMemory-backed translation service for translating Hive post / comment
+ * bodies (rendered HTML) into the user's selected app language.
+ *
+ * Free, no API key, soft daily quota. The kit ships this as the default
+ * translator — consumers can override by passing their own `translate`
+ * function to `<HiveLanguageProvider>` (e.g. DeepL, Google Translate, an
+ * authenticated MyMemory account).
+ *
+ * Heavy caching: in-memory map (session) + localStorage (cross-reload) +
+ * in-flight dedup so two views of the same body share one network call.
+ */
+/** Translate a single text string to `target` language. */
+export declare function translateText(text: string, target: string, source?: string): Promise<string>;
+/**
+ * Translate every visible text node in an HTML string to `target`. Skips
+ * text inside `<code>`, `<pre>`, `<script>`, `<style>`, `<noscript>`, and
+ * `<iframe>` so embeds and code samples render unchanged.
+ */
+export declare function translateHtml(html: string, target: string): Promise<string>;

package/dist/i18n/useTranslatedHtml.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translate a rendered Hive post / comment body (HTML) into the language
+ * supplied by the nearest `<HiveLanguageProvider>`. Returns the original
+ * HTML for English (the source language) and synchronously falls back to
+ * the original on translation errors so the UI never looks broken.
+ *
+ * The translation is async — `loading` is true while the API request is
+ * in flight on the very first render. Subsequent renders read from cache
+ * and resolve instantly.
+ */
+export declare function useTranslatedHtml(html: string): {
+    html: string;
+    loading: boolean;
+};

package/dist/i18n/useTranslatedText.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plain-text counterpart to `useTranslatedHtml`. Use for titles, captions,
+ * preview snippets, and any other short user-generated string that should
+ * follow the language set on `<HiveLanguageProvider>`.
+ *
+ * Returns the original synchronously while the translation API call is
+ * in flight, so titles never flash blank. Falls back to the original on
+ * error and bypasses the translator entirely for English.
+ */
+export declare function useTranslatedText(text: string | undefined | null): {
+    text: string;
+    loading: boolean;
+};