hive-react-kit 0.10.0 → 0.10.2

package/dist/components/BlogPostList.d.ts

@@ -52,6 +52,10 @@ export interface BlogPostListProps {
     allowLandscapeVideos?: boolean;
     /** Default reward routing for inline comment composers. */
     defaultReward?: RewardOption;
+    /** Collapse the per-card secondary actions (reblog · share · tip ·
+     *  flag) into a single 3-dot kebab menu. Forwarded to
+     *  `<PostActionButton/>`. */
+    actionsAsMenu?: boolean;
 }
 export declare const BlogPostList: FC<BlogPostListProps>;
 export default BlogPostList;

package/dist/components/HiveDetailPost.d.ts

@@ -10,7 +10,7 @@ export interface HiveDetailPostProps {
      * `voteWeight` is non-null when the composer's upvote-on-publish toggle is enabled
      * (1–100, step 0.25) — consumer should broadcast vote+comment atomically.
      */
-    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null) => void | boolean | Promise<void | boolean>;
+    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null, beneficiaries?: import('../utils/beneficiaries').Beneficiary[]) => void | boolean | Promise<void | boolean>;
     /**
      * Show the upvote-on-publish toggle in the post's comment composer. Default false (opt-in).
      * Auto-hidden internally when the current user has already voted the post.
@@ -28,6 +28,18 @@ export interface HiveDetailPostProps {
      * Typically wired to a user setting.
      */
     defaultReward?: import('../utils/commentOptions').RewardOption;
+    /**
+     * Beneficiaries pre-populated into every comment composer on this detail
+     * page (top-level reply + nested sub-comment replies). Typically wired to
+     * the user's app-wide default beneficiaries setting.
+     */
+    defaultBeneficiaries?: import('../utils/beneficiaries').Beneficiary[];
+    /**
+     * Suggested beneficiary chips shown inside every comment composer's editor
+     * on this detail page — typically the user's previously-used beneficiary
+     * presets pulled from local history.
+     */
+    beneficiaryFavorites?: import('../utils/beneficiaries').Beneficiary[];
     /**
      * Initial percent (1–100) for the post's upvote slider AND every comment
      * composer's "upvote-on-publish" / comment-upvote slider on this page.
@@ -107,5 +119,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, defaultVotePercent, voteWeightStep, allowLandscapeVideos, 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, defaultBeneficiaries, beneficiaryFavorites, defaultVotePercent, voteWeightStep, allowLandscapeVideos, renderOptions, }: HiveDetailPostProps): import("react/jsx-runtime").JSX.Element;
 export default HiveDetailPost;

package/dist/components/UpvoteListModal.d.ts

@@ -5,7 +5,13 @@ interface UpvoteListModalProps {
     currentUser?: string;
     token?: string;
     onClickUpvoteButton?: (currentUser?: string, token?: string) => void;
+    /** URL for the small Hive icon shown next to each voter's reward
+     *  amount. Consumers usually pass a local asset (e.g. the bundled
+     *  hivesuite hive_logo.png) so the icon stays sharp on retina and
+     *  works offline; falls back to the official Hive logo from
+     *  hive.io otherwise. */
+    hiveIconUrl?: string;
 }
 export declare function formatTimeAgo(date: string | Date): string;
-declare const UpvoteListModal: ({ author, permlink, onClose, currentUser, token, onClickUpvoteButton }: UpvoteListModalProps) => import("react/jsx-runtime").JSX.Element;
+declare const UpvoteListModal: ({ author, permlink, onClose, currentUser, token, onClickUpvoteButton, hiveIconUrl, }: UpvoteListModalProps) => import("react/jsx-runtime").JSX.Element;
 export default UpvoteListModal;

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

@@ -0,0 +1,17 @@
+export interface MoreActionsMenuProps {
+    /** Show the Reblog item. */
+    onReblog?: () => void;
+    /** Show the Share item. */
+    onShare?: () => void;
+    /** Show the Tip item. */
+    onTip?: () => void;
+    /** Show the Flag item. */
+    onReport?: () => void;
+    /** Tailwind classes for the trigger button (defaults match the kit's
+     *  inline action buttons). */
+    buttonClassName?: string;
+    /** aria-label for the trigger. */
+    ariaLabel?: string;
+}
+export declare function MoreActionsMenu({ onReblog, onShare, onTip, onReport, buttonClassName, ariaLabel, }: MoreActionsMenuProps): import("react/jsx-runtime").JSX.Element;
+export default MoreActionsMenu;

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

@@ -19,8 +19,10 @@ export interface PostActionButtonProps {
     /** Called when user submits a comment. Frontend handles signing/broadcast.
      *  Return `false` to indicate the operation was cancelled — the composer text will be preserved.
      *  `voteWeight` is non-null when the composer's upvote-on-publish toggle is enabled
-     *  (1–100, step 0.25) — consumer should broadcast vote+comment atomically. */
-    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null) => void | boolean | Promise<void | boolean>;
+     *  (1–100, step 0.25) — consumer should broadcast vote+comment atomically.
+     *  `beneficiaries` is the post-lock beneficiary list selected in the composer
+     *  (already includes threespeakfund 10% on video posts). */
+    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null, beneficiaries?: import('../../utils/beneficiaries').Beneficiary[]) => void | boolean | Promise<void | boolean>;
     /** Show the upvote-on-publish toggle in the comment composer.
      *  Auto-hidden when the current user has already voted this post. */
     showVoteButton?: boolean;
@@ -28,6 +30,10 @@ export interface PostActionButtonProps {
     parentTags?: string[];
     /** Default reward routing seeded into the comment composer. */
     defaultReward?: import('../../utils/commentOptions').RewardOption;
+    /** Beneficiaries pre-populated into the comment composer. */
+    defaultBeneficiaries?: import('../../utils/beneficiaries').Beneficiary[];
+    /** Suggested beneficiary chips shown inside the composer's editor. */
+    beneficiaryFavorites?: import('../../utils/beneficiaries').Beneficiary[];
     /** 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
@@ -76,6 +82,11 @@ export interface PostActionButtonProps {
      *  Used to lazy-fetch the reply body the first time the user hovers
      *  the comment icon, so the tooltip can show what they wrote. */
     myReplyKey?: string;
+    /** Collapse the secondary actions (reblog · share · tip · report)
+     *  into a single 3-dot kebab popover. Upvote / comment counters and
+     *  the payout chip stay inline. Useful in dense card layouts (videos,
+     *  polls, community detail) where there isn't room for four icons. */
+    actionsAsMenu?: 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, onClickCommentIcon, onClickCommentCount, hasCommented, myReplyKey, showVoteButton, parentTags, defaultReward, defaultVotePercent, voteWeightStep, allowLandscapeVideos, }: 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, onClickCommentIcon, onClickCommentCount, hasCommented, myReplyKey, showVoteButton, parentTags, defaultReward, defaultBeneficiaries, beneficiaryFavorites, defaultVotePercent, voteWeightStep, allowLandscapeVideos, actionsAsMenu, }: PostActionButtonProps): import("react/jsx-runtime").JSX.Element;
 export default PostActionButton;

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

@@ -1 +1,2 @@
 export { PostActionButton, type PostActionButtonProps } from "./PostActionButton";
+export { MoreActionsMenu, type MoreActionsMenuProps } from "./MoreActionsMenu";

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import { type RewardOption } from '../../utils/commentOptions';
+import { type Beneficiary } from '../../utils/beneficiaries';
 import { type PostingSignMessageFn } from '../../services/hiveImageUpload';
 export interface PostComposerProps {
     onSubmit: (body: string) => void | boolean | Promise<void | boolean>;
@@ -61,6 +62,28 @@ export interface PostComposerProps {
     onRewardChange?: (reward: RewardOption) => void;
     /** Hide the reward routing toolbar button. */
     hideReward?: boolean;
+    /**
+     * Beneficiary list (controlled). When provided, the composer mirrors this
+     * list and emits changes through `onBeneficiariesChange`. The
+     * `threespeakfund` 10% lock is applied automatically while the body
+     * contains a 3Speak video URL or the embedded video uploader has produced
+     * one — there is no need for the consumer to inject it.
+     */
+    beneficiaries?: Beneficiary[];
+    /**
+     * Initial beneficiary list when uncontrolled. Useful for pre-populating the
+     * composer from a user's saved defaults.
+     */
+    defaultBeneficiaries?: Beneficiary[];
+    /** Called whenever the beneficiary list changes (after the 3Speak video lock is applied). */
+    onBeneficiariesChange?: (beneficiaries: Beneficiary[]) => void;
+    /**
+     * Suggested beneficiary chips shown inside the editor modal — typically the
+     * user's previously-used presets pulled from app settings.
+     */
+    beneficiaryFavorites?: Beneficiary[];
+    /** Hide the beneficiary toolbar button. */
+    hideBeneficiaries?: boolean;
     /**
      * Show the "upvote on publish" toggle in the toolbar (default false — opt-in).
      * Set this to `!alreadyVoted` so the button hides once the user has voted on the parent.
@@ -122,8 +145,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, voteWeightStep, allowLandscapeVideos, 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, beneficiaries, defaultBeneficiaries, onBeneficiariesChange, beneficiaryFavorites, hideBeneficiaries, showVoteButton, defaultVoteEnabled, defaultVotePercent, voteWeightStep, allowLandscapeVideos, 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, voteWeightStep, allowLandscapeVideos, 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, beneficiaries, defaultBeneficiaries, onBeneficiariesChange, beneficiaryFavorites, hideBeneficiaries, showVoteButton, defaultVoteEnabled, defaultVotePercent, voteWeightStep, allowLandscapeVideos, 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

@@ -1,4 +1,5 @@
 import { Discussion } from '@/types/comment';
+import type { Beneficiary } from '../../utils/beneficiaries';
 interface CommentsModalProps {
     author: string;
     permlink: string;
@@ -12,14 +13,20 @@ interface CommentsModalProps {
     /** When provided, used instead of apiService.handleComment (e.g. for aioha wallet).
      *  Return `false` to indicate the operation was cancelled — the composer text will be preserved.
      *  `voteWeight` is non-null when the composer's upvote-on-publish toggle is enabled
-     *  (value in 1–100, step 0.25); consumer should broadcast vote+comment atomically. */
-    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null) => Promise<void | boolean>;
+     *  (value in 1–100, step 0.25); consumer should broadcast vote+comment atomically.
+     *  `beneficiaries` is the post-lock beneficiary list selected in the composer
+     *  (already includes threespeakfund 10% on video posts). */
+    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null, beneficiaries?: Beneficiary[]) => Promise<void | boolean>;
     /** Show the upvote-on-publish toggle in the composer (the parent decides — usually `!alreadyVoted`). */
     showVoteButton?: boolean;
     /** Locked default tags for the top-level composer (typically the parent post's tags, app tag first). */
     parentTags?: string[];
     /** Default reward routing seeded into the composer. */
     defaultReward?: import('../../utils/commentOptions').RewardOption;
+    /** Beneficiaries pre-populated into the comment composer (typically the user's app-wide defaults). */
+    defaultBeneficiaries?: Beneficiary[];
+    /** Suggested beneficiary chips in the composer's editor (typically previously-used presets). */
+    beneficiaryFavorites?: Beneficiary[];
     /** Ecency image hosting token — enables image upload in comment composer */
     ecencyToken?: string;
     /** 3Speak API key — enables audio/video upload in comment composer */
@@ -37,5 +44,5 @@ interface CommentsModalProps {
     /** Allow landscape videos in the comment composer. Default false. */
     allowLandscapeVideos?: boolean;
 }
-declare const CommentsModal: ({ author, permlink, onClose, currentUser, token, onClickCommentUpvote, onClickCommentReply, onClickUpvoteButton, onSubmitComment, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, showVoteButton, parentTags, defaultReward, defaultVotePercent, voteWeightStep, allowLandscapeVideos }: 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, defaultBeneficiaries, beneficiaryFavorites, defaultVotePercent, voteWeightStep, allowLandscapeVideos }: CommentsModalProps) => import("react/jsx-runtime").JSX.Element;
 export default CommentsModal;

package/dist/components/community/CommunityDetail.d.ts

@@ -25,8 +25,12 @@ export interface CommunityDetailProps {
     voteWeightStep?: number;
     allowLandscapeVideos?: boolean;
     defaultReward?: RewardOption;
+    /** Collapse the per-post secondary actions (reblog · share · tip ·
+     *  flag) into a single 3-dot kebab menu inside the embedded
+     *  `<BlogPostList/>`. */
+    actionsAsMenu?: boolean;
     onShare?: () => void;
     onRss?: () => void;
 }
-declare const CommunityDetail: ({ communityId, currentUser, onBack, onUserClick, onPostClick, onCommentClick, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onTip, onSharePost, onReportPost, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, defaultVotePercent, voteWeightStep, allowLandscapeVideos, defaultReward, onShare, onRss, }: CommunityDetailProps) => import("react/jsx-runtime").JSX.Element;
+declare const CommunityDetail: ({ communityId, currentUser, onBack, onUserClick, onPostClick, onCommentClick, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onTip, onSharePost, onReportPost, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, defaultVotePercent, voteWeightStep, allowLandscapeVideos, defaultReward, actionsAsMenu, onShare, onRss, }: CommunityDetailProps) => import("react/jsx-runtime").JSX.Element;
 export default CommunityDetail;

package/dist/components/composer/BeneficiariesEditor.d.ts

@@ -0,0 +1,49 @@
+/**
+ * BeneficiariesEditor — modal that lets the user attach a list of Hive accounts
+ * that will automatically receive a portion of the rewards on the post being
+ * composed.
+ *
+ * Rules enforced by the UI:
+ * - Each beneficiary's percent is in [1, 100].
+ * - The total of all beneficiaries (including the locked threespeakfund row,
+ *   if shown) is capped at 100%.
+ * - When `hasVideo` is true, the `threespeakfund` 10% row is auto-injected,
+ *   not removable, and the remaining user-controlled allocation is capped at
+ *   100 - 10 = 90%.
+ * - The user can pick from `favorites` (typically previously-used beneficiary
+ *   sets pulled from app settings/history) — clicking a favorite chip fills
+ *   the staging row.
+ *
+ * The component is purely presentational: it owns its working copy of the
+ * list while open and emits the final list via `onSave`.
+ */
+import React from 'react';
+import { type Beneficiary } from '../../utils/beneficiaries';
+export interface BeneficiariesEditorProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSave: (beneficiaries: Beneficiary[]) => void;
+    /** Initial list. Defaults are pre-populated when the editor opens. */
+    initialBeneficiaries?: Beneficiary[];
+    /**
+     * When true, the `threespeakfund` 10% row is added automatically and cannot
+     * be removed; user beneficiaries are capped at 90% in total.
+     */
+    hasVideo?: boolean;
+    /**
+     * Suggested chips (favourites / previously-used presets). Each entry is one
+     * beneficiary the user may want to add quickly. Click adds it at its weight
+     * (capped to remaining allocation).
+     */
+    favorites?: Beneficiary[];
+    /** Title shown in the header. */
+    title?: string;
+    /** Hint shown under the header. */
+    description?: string;
+    /** Save button label. */
+    saveLabel?: string;
+    /** Cancel button label. */
+    cancelLabel?: string;
+}
+declare const BeneficiariesEditor: React.FC<BeneficiariesEditorProps>;
+export default BeneficiariesEditor;

package/dist/components/composer/ParentPostComposer.d.ts

@@ -0,0 +1,134 @@
+/**
+ * ParentPostComposer — full-screen composer for top-level Hive posts (blogs /
+ * articles). Shares the same upload/picker infrastructure as PostComposer
+ * (image, audio, video, GIF, emoji, template, poll, beneficiaries) and
+ * always renders a side-by-side markdown preview on desktop / stacked
+ * preview on mobile. The preview is permanent — no toggle.
+ *
+ * The composer itself does not broadcast. It surfaces the user's choices via
+ * `onSubmit({ title, description, body, tags, reward, beneficiaries, poll })`
+ * and the consumer is responsible for assembling the Hive `comment` op.
+ */
+import React from 'react';
+import { type RewardOption } from '../../utils/commentOptions';
+import { type Beneficiary } from '../../utils/beneficiaries';
+import { type VideoUploadDetails } from './VideoUploader';
+import type { PollData } from './PollCreator';
+import { type PostingSignMessageFn } from '../../services/hiveImageUpload';
+export interface ParentPostSubmitPayload {
+    title: string;
+    description: string;
+    body: string;
+    tags: string[];
+    reward: RewardOption;
+    beneficiaries: Beneficiary[];
+    poll: PollData | null;
+    audioEmbedUrl: string | null;
+    videoEmbedUrl: string | null;
+    videoUploadUrl: string | null;
+    videoAspectRatio: string | null;
+    /**
+     * Full 3Speak upload metadata when the user attached a video — populated
+     * by the kit's `<VideoUploader>` after a successful TUS upload. Consumers
+     * publishing via 3Speak Studio's `/upload_info` + `/update_info` APIs
+     * (the "Save" flow) need every field. `null` when the post has no video.
+     */
+    videoUploadDetails: VideoUploadDetails | null;
+    /** Convenience flag — `true` whenever `videoUploadDetails` is non-null. */
+    hasVideo: boolean;
+    /**
+     * NSFW flag, surfaced by the composer's NSFW toggle. 3Speak's
+     * `/update_info` accepts `isNsfwContent`; consumers publishing as a Hive
+     * post can fold it into `json_metadata` if they want.
+     */
+    isNsfw: boolean;
+}
+export interface ParentPostComposerProps {
+    /**
+     * Called when the user clicks Publish. Receive everything the composer
+     * gathered. Return `false` to indicate the broadcast was cancelled — the
+     * composer will preserve its state. Throw to surface an error.
+     */
+    onSubmit: (payload: ParentPostSubmitPayload) => void | boolean | Promise<void | boolean>;
+    /** Called when the user clicks the back/close button. Typically `navigate(-1)` or close the modal. */
+    onCancel?: () => void;
+    /** Logged-in Hive username — shown in the author chip and used for media uploads. */
+    currentUser?: string;
+    /** Initial values (uncontrolled). */
+    initialTitle?: string;
+    initialDescription?: string;
+    initialBody?: string;
+    initialTags?: string[];
+    /** Locked tags shown with a lock icon — e.g. an app identifier. Prepended to the merged tag list. */
+    lockedTags?: string[];
+    /** Total tag cap including locked entries. Default 10. */
+    maxTags?: number;
+    /** Reward routing default + favorites for the beneficiary editor. */
+    defaultReward?: RewardOption;
+    defaultBeneficiaries?: Beneficiary[];
+    beneficiaryFavorites?: Beneficiary[];
+    /** Upload tokens — same plumbing the kit's PostComposer uses. */
+    ecencyToken?: string;
+    onSignMessage?: PostingSignMessageFn;
+    signingUsername?: string;
+    threeSpeakApiKey?: string;
+    giphyApiKey?: string;
+    templateToken?: string;
+    templateApiBaseUrl?: string;
+    /** Toolbar visibility flags — mirror PostComposer for consistency. */
+    hideAudio?: boolean;
+    hideVideo?: boolean;
+    hideGif?: boolean;
+    hideEmoji?: boolean;
+    hideTemplate?: boolean;
+    hidePoll?: boolean;
+    hideTags?: boolean;
+    hideReward?: boolean;
+    hideBeneficiaries?: boolean;
+    /** Allow landscape videos (default true on the parent post composer). */
+    allowLandscapeVideos?: boolean;
+    /**
+     * When set, the composer auto-saves its state to `localStorage[draftKey]`
+     * (debounced, ~500 ms after the last change) and rehydrates from it on
+     * mount. Cleared automatically after a successful submit (i.e. when
+     * `onSubmit` returns anything other than `false`). Pass a per-user key so
+     * accounts on a shared device don't trample each other's drafts —
+     * e.g. `hivesuite-blog-draft-${username}`.
+     */
+    draftKey?: string;
+    /**
+     * Async pre-flight gate run after a video file is picked & validated, but
+     * before the TUS upload starts. Use it to check that the logged-in user
+     * has granted `threespeak` posting authority (3Speak's API requires it)
+     * and surface a "Grant Permission" modal when missing. Resolve `true` to
+     * let the upload proceed, `false` to abort. Errors are surfaced as the
+     * upload error message.
+     */
+    beforeVideoUpload?: () => Promise<boolean>;
+    /**
+     * Forwarded to the embedded `<VideoUploader/>`. When true, the TUS upload
+     * goes to `https://video.3speak.tv/files/` with the v2 metadata
+     * (`upload_id`, `owner`, `filename`, `filetype`) and the resulting
+     * `uploadId` is surfaced via `ParentPostSubmitPayload.videoUploadDetails`.
+     * Consumers running the v2 publish flow (`/api/upload/finalize`) need
+     * this to be `true`.
+     */
+    useThreeSpeakV2?: boolean;
+    /** Submit button label (default "Publish"). */
+    submitLabel?: string;
+    /**
+     * Submit button label used when the post has a 3Speak video attached
+     * (default "Save"). 3Speak's flow registers the video via its Studio
+     * API rather than broadcasting a Hive `comment` op, so calling the
+     * action "Save" is more accurate than "Publish".
+     */
+    submitLabelWithVideo?: string;
+    /** Page title shown in the sticky header (default "Create post"). */
+    title?: string;
+    /** Hint shown when the wallet is awaiting approval during the broadcast. */
+    walletApprovalLabel?: string;
+    /** When true, the composer renders a blinking "approve in wallet" banner. */
+    awaitingWalletApproval?: boolean;
+}
+declare const ParentPostComposer: React.FC<ParentPostComposerProps>;
+export default ParentPostComposer;

package/dist/components/composer/VideoUploader.d.ts

@@ -1,8 +1,48 @@
 import React from 'react';
 import { type PostingSignMessageFn } from '../../services/hiveImageUpload';
+/** Extra metadata about a completed 3Speak upload — surfaced for consumers
+ *  that want to drive the publish step themselves (whether through the
+ *  legacy `/upload_info` + `/update_info` pair or the v2 `/api/upload/finalize`
+ *  endpoint). */
+export interface VideoUploadDetails {
+    /** TUS filename — the trailing segment of the upload URL. Required by
+     *  3Speak's legacy `/upload_info` endpoint. Empty for v2 uploads where
+     *  the `uploadId` field below is the canonical identifier. */
+    filename: string;
+    /** The user's original file name (e.g. `IMG_1234.mp4`). */
+    originalFilename: string;
+    /** File size in bytes. */
+    fileSize: number;
+    /** Video duration in seconds (rounded). */
+    videoDuration: number;
+    /** Aspect ratio string (e.g. `"16/9"` or `"9/16"`). */
+    aspectRatio: string;
+    /** The 3Speak embed URL — `https://3speak.tv/embed?v=author/permlink`.
+     *  Empty when uploading via the v2 endpoint (the embed URL is only
+     *  knowable after the consumer runs `/api/upload/finalize`). */
+    embedUrl: string;
+    /** The TUS upload URL — `https://embed.3speak.tv/uploads/<filename>` or
+     *  `https://video.3speak.tv/files/<filename>` depending on mode. */
+    uploadUrl: string;
+    /** Local thumbnail blob (JPEG). The kit always keeps this around so
+     *  consumers can ship it to whichever thumbnail endpoint they use. */
+    thumbnailBlob: Blob | null;
+    /** Client-generated `upload_id` used by 3Speak's v2 finalize endpoint.
+     *  Empty when the upload used the legacy embed.3speak.tv endpoint. */
+    uploadId: string;
+    /** `true` when the upload used the v2 `video.3speak.tv/files/` endpoint. */
+    isV2: boolean;
+}
 export interface VideoUploaderProps {
     /** Called with embed URL, upload URL, aspect ratio, and optional local file for preview */
     onVideoUploaded: (videoEmbedUrl: string, uploadUrl: string, aspectRatio: string, localPreviewFile?: File) => void;
+    /**
+     * Called alongside `onVideoUploaded` with the full set of 3Speak-specific
+     * metadata. Consumers wiring the 3Speak Studio API (publish-via-3Speak)
+     * need every field to call `/upload_info` + `/update_info`. Existing
+     * snap composers don't need this path so the prop is optional.
+     */
+    onVideoUploadDetails?: (details: VideoUploadDetails) => void;
     /** Hive username for the upload */
     username?: string;
     /** Ecency image hosting token for thumbnail upload */
@@ -15,6 +55,62 @@ export interface VideoUploaderProps {
     /** When true, accept landscape videos too. Default false — only portrait
      *  (vertical) clips are accepted, matching the hSnaps Moments contract. */
     allowLandscape?: boolean;
+    /**
+     * When true, the upload panel renders as a floating bottom-right card
+     * instead of a full-screen backdrop modal. The rest of the page stays
+     * interactive so the user can keep editing the post body, tags, etc.
+     * while the upload runs in the background. Default `false` keeps the
+     * existing modal behaviour for snap composers.
+     */
+    inline?: boolean;
+    /**
+     * Open-state controller (controlled mode). When provided, the parent owns
+     * panel visibility — useful in inline mode where the parent surfaces a
+     * minimized progress bar elsewhere on screen and reopens the panel on
+     * demand. When omitted the component manages its own state.
+     */
+    isOpen?: boolean;
+    /**
+     * Called whenever the panel's open state should change — when the user
+     * picks a file (`true`) or clicks the X button (`false`). Pair with
+     * `isOpen` for full control.
+     */
+    onIsOpenChange?: (open: boolean) => void;
+    /**
+     * Called with the current TUS upload progress, or `null` when no upload
+     * is in flight (idle / success / error). Lets the parent render a
+     * minimized progress chip while the panel is hidden.
+     */
+    onUploadProgress?: (progress: {
+        percentage: number;
+        bytesUploaded: number;
+        bytesTotal: number;
+    } | null) => void;
+    /**
+     * Optional async gate run after a file is selected and validated, but
+     * before the TUS upload starts. The consumer can use this to check
+     * external preconditions — e.g. that the user has granted `threespeak`
+     * posting authority — and resolve `false` to abort the upload (after
+     * showing its own UI). Resolving `true` lets the upload proceed.
+     *
+     * If omitted the upload starts unconditionally (existing behaviour).
+     */
+    beforeUpload?: () => Promise<boolean>;
+    /**
+     * When true, route the TUS upload through 3Speak's v2 endpoint at
+     * `https://video.3speak.tv/files/` with TUS metadata
+     * `{ upload_id, owner, filename, filetype }`. The kit generates a
+     * client-side `upload_id` (format `<owner>_<unix-ms>_<hex>`) and
+     * surfaces it via `VideoUploadDetails.uploadId` so the consumer can
+     * call `/api/upload/finalize` to publish the video. The Ecency /
+     * Hive thumbnail upload + `setThumbnailOn3Speak` step is skipped
+     * because the v2 frontend posts thumbnails to
+     * `/api/upload/thumbnail/<videoId>` after finalize.
+     *
+     * Default false keeps the legacy `embed.3speak.tv/uploads` flow used
+     * by the snap composer.
+     */
+    useThreeSpeakV2?: boolean;
 }
 declare const VideoUploader: React.FC<VideoUploaderProps>;
 export default VideoUploader;

package/dist/components/composer/index.d.ts

@@ -3,7 +3,7 @@ export type { ImageUploaderProps } from './ImageUploader';
 export { default as AudioUploader } from './AudioUploader';
 export type { AudioUploaderProps } from './AudioUploader';
 export { default as VideoUploader } from './VideoUploader';
-export type { VideoUploaderProps } from './VideoUploader';
+export type { VideoUploaderProps, VideoUploadDetails } from './VideoUploader';
 export { default as GiphyPicker } from './GiphyPicker';
 export type { GiphyPickerProps } from './GiphyPicker';
 export { default as EmojiPicker } from './EmojiPicker';
@@ -12,3 +12,7 @@ export { default as TemplatePicker } from './TemplatePicker';
 export type { TemplatePickerProps } from './TemplatePicker';
 export { default as PollCreator } from './PollCreator';
 export type { PollCreatorProps, PollData } from './PollCreator';
+export { default as BeneficiariesEditor } from './BeneficiariesEditor';
+export type { BeneficiariesEditorProps } from './BeneficiariesEditor';
+export { default as ParentPostComposer } from './ParentPostComposer';
+export type { ParentPostComposerProps, ParentPostSubmitPayload } from './ParentPostComposer';

package/dist/components/feed/SnapsFeedCard.d.ts

@@ -51,6 +51,9 @@ export interface SnapsFeedCardProps {
      *  menu with Edit / Delete / Flag). Receives the post so the host can
      *  own edit/delete/flag state per card. */
     renderHeaderActions?: (post: Post) => ReactNode;
+    /** Collapse the per-card secondary actions (reblog · share · tip ·
+     *  flag) into a single 3-dot kebab menu inside the action bar. */
+    actionsAsMenu?: boolean;
 }
 declare const SnapsFeedCard: FC<SnapsFeedCardProps>;
 export default SnapsFeedCard;

package/dist/components/feed/SnapsFeedView.d.ts

@@ -72,6 +72,10 @@ export interface SnapsFeedViewProps {
     /** Optional render slot for a per-card right-side header action menu
      *  (Edit / Delete / Flag). Forwarded to every <SnapsFeedCard/>. */
     renderHeaderActions?: (post: import('@/types/post').Post) => ReactNode;
+    /** Collapse the per-card secondary actions (reblog · share · tip ·
+     *  flag) into a single 3-dot kebab menu. Forwarded to every
+     *  <SnapsFeedCard/>. */
+    actionsAsMenu?: boolean;
 }
-export declare function SnapsFeedView({ feeds, labels, avatars, defaultPrimary, currentUser, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onTip, onSharePost, onCommentClick, onClickCommentIcon, onClickCommentCount, onReportPost, onUserClick, onPostClick, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, defaultVotePercent, voteWeightStep, allowLandscapeVideos, defaultReward, toolbar, footer, renderHeaderActions, }: SnapsFeedViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function SnapsFeedView({ feeds, labels, avatars, defaultPrimary, currentUser, onUpvote, onSubmitComment, onClickCommentUpvote, onReblog, onTip, onSharePost, onCommentClick, onClickCommentIcon, onClickCommentCount, onReportPost, onUserClick, onPostClick, ecencyToken, threeSpeakApiKey, giphyApiKey, templateToken, templateApiBaseUrl, defaultVotePercent, voteWeightStep, allowLandscapeVideos, defaultReward, toolbar, footer, renderHeaderActions, actionsAsMenu, }: SnapsFeedViewProps): import("react/jsx-runtime").JSX.Element;
 export default SnapsFeedView;

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

@@ -1,11 +1,12 @@
 import { Discussion } from '@/types/comment';
 import type { RewardOption } from '../../utils/commentOptions';
+import type { Beneficiary } from '../../utils/beneficiaries';
 interface InlineCommentItemProps {
     comment: Discussion;
     allComments: Discussion[];
     onReply: (author: string, permlink: string) => void;
     onCancelReply: () => void;
-    onCommentSubmit: (parentAuthor: string, parentPermlink: string, body: string) => Promise<void | boolean>;
+    onCommentSubmit: (parentAuthor: string, parentPermlink: string, body: string, beneficiaries?: Beneficiary[]) => Promise<void | boolean>;
     /** "author/permlink" key of the comment currently being replied to (null = none) */
     activeReplyKey: string | null;
     currentUser?: string;
@@ -29,6 +30,10 @@ interface InlineCommentItemProps {
     onUserClick?: (username: string) => void;
     /** Default reward routing seeded into every reply composer. */
     defaultReward?: RewardOption;
+    /** Beneficiaries pre-populated into every reply composer. */
+    defaultBeneficiaries?: Beneficiary[];
+    /** Suggested beneficiary chips shown inside every reply composer's editor. */
+    beneficiaryFavorites?: Beneficiary[];
     /** Initial percent for the comment-upvote slider AND reply composer's
      *  upvote-on-publish slider. Default 100. */
     defaultVotePercent?: number;
@@ -44,5 +49,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, defaultVotePercent, voteWeightStep, allowLandscapeVideos, 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, defaultBeneficiaries, beneficiaryFavorites, defaultVotePercent, voteWeightStep, allowLandscapeVideos, renderOptions, }: InlineCommentItemProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,11 +1,13 @@
 import type { RewardOption } from '../../utils/commentOptions';
+import type { Beneficiary } from '../../utils/beneficiaries';
 interface InlineCommentSectionProps {
     author: string;
     permlink: string;
     currentUser?: string;
     token?: string;
-    /** `voteWeight` is non-null when the top-level composer's upvote-on-publish toggle is on (only fires for the post-reply composer). */
-    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null) => void | boolean | Promise<void | boolean>;
+    /** `voteWeight` is non-null when the top-level composer's upvote-on-publish toggle is on (only fires for the post-reply composer).
+     *  `beneficiaries` is the post-lock beneficiary list selected in the composer that triggered the submit. */
+    onSubmitComment?: (parentAuthor: string, parentPermlink: string, body: string, voteWeight?: number | null, beneficiaries?: Beneficiary[]) => void | boolean | Promise<void | boolean>;
     onClickCommentUpvote?: (author: string, permlink: string, percent: number) => void | Promise<void>;
     /** Show the upvote-on-publish toggle on the top-level composer. Auto-hidden when `alreadyVoted`. */
     showVoteButton?: boolean;
@@ -15,6 +17,10 @@ interface InlineCommentSectionProps {
     parentTags?: string[];
     /** Default reward routing seeded into every reply composer in this section. */
     defaultReward?: RewardOption;
+    /** Beneficiaries pre-populated into every reply composer in this section. */
+    defaultBeneficiaries?: Beneficiary[];
+    /** Suggested beneficiary chips shown inside every reply composer's editor. */
+    beneficiaryFavorites?: Beneficiary[];
     /** 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. */
@@ -49,5 +55,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, defaultVotePercent, voteWeightStep, allowLandscapeVideos, 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, defaultBeneficiaries, beneficiaryFavorites, defaultVotePercent, voteWeightStep, allowLandscapeVideos, renderOptions, }: InlineCommentSectionProps): import("react/jsx-runtime").JSX.Element;
 export {};