@select-org/post-components 1.0.1 → 2.1.0

package/dist/index.d.ts

@@ -47,9 +47,28 @@ interface PostCardProps {
         priority?: boolean;
         className?: string;
     }>;
+    /** Author's role in the group — drives the owner crown / admin shield badge. */
     isAdmin?: boolean;
+    /** Author's role in the group — drives the owner crown / admin shield badge. */
     isOwner?: boolean;
+    /**
+     * Whether the *viewer* is the post's author. Lets the author preview their own
+     * poll results before voting. Distinct from `isOwner` (which is the author's
+     * group role, for the badge) — pass it explicitly. When omitted, the author
+     * preview is simply off (the author sees results after voting, like anyone).
+     */
+    isPostOwner?: boolean;
     isPostPreview?: boolean;
+    isPrivate?: boolean;
+    membersCount?: number;
+    crossPostGroup?: {
+        name: string;
+        href?: string;
+    };
+    locale?: string;
+    translate?: (key: string, params?: {
+        count?: number;
+    }) => string;
     onPostPress?: () => void;
     onErasePress?: () => void;
     onCancelPost?: () => void;
@@ -65,7 +84,7 @@ interface PostCardProps {
         onSend: (emoji: string) => void;
     }) => React.ReactNode;
     onNavigate?: (href: string, isInternal: boolean) => void;
-    supportDeepviewDomain?: string;
+    supportDeepviewDomain?: string | string[];
     labels?: {
         cancelPost?: string;
         sending?: string;
@@ -100,8 +119,19 @@ interface PostHeaderProps {
     groupHref?: string;
     postedAt: string;
     postType: string;
+    isPrivate?: boolean;
+    membersCount?: number;
+    crossPostGroup?: {
+        name: string;
+        href?: string;
+    };
+    locale?: string;
+    translate?: (key: string, params?: {
+        count?: number;
+    }) => string;
     isFeatured?: boolean;
     isPostPreview?: boolean;
+    isPostDetail?: boolean;
     isAdmin?: boolean;
     isOwner?: boolean;
     onErasePress?: () => void;
@@ -135,7 +165,7 @@ interface Props$a {
     hideEmailDescription?: boolean;
     isEmailPost?: boolean;
     onNavigate?: (href: string, isInternal: boolean) => void;
-    supportDeepviewDomain?: string;
+    supportDeepviewDomain?: string | string[];
 }
 declare const PostBody: React.FC<Props$a>;
 
@@ -148,6 +178,17 @@ interface PostFooterProps {
     footerLinkHref?: string;
     isSnoozed?: boolean;
     onSnoozeToggle?: () => void;
+    /**
+     * Custom link renderer (e.g. Next.js `<Link>`) for the comment and footer
+     * links. Falls back to a native `<a>`. Passing this is important inside SPAs:
+     * a native `<a>` triggers a full-page reload, whereas the consumer's router
+     * link performs a soft client-side navigation.
+     */
+    linkComponent?: React.ComponentType<{
+        href: string;
+        children: React.ReactNode;
+        className?: string;
+    }>;
     renderReactionTrigger?: (props: {
         onOpen: () => void;
     }) => React.ReactNode;
@@ -173,6 +214,8 @@ interface Props$9 {
         className?: string;
     }>;
     mediaItemStatuses?: Record<string, MediaUploadStatus>;
+    onNavigate?: (href: string, isInternal: boolean) => void;
+    supportDeepviewDomain?: string | string[];
 }
 declare const PostItemsView: React.FC<Props$9>;
 
@@ -200,6 +243,8 @@ interface Props$6 {
     textItems: TextItemContent['items'];
     showFullText: boolean;
     isPostDetail: boolean;
+    onNavigate?: (href: string, isInternal: boolean) => void;
+    supportDeepviewDomain?: string | string[];
 }
 declare const PostTextItem: React.FC<Props$6>;
 
@@ -207,6 +252,17 @@ interface Props$5 {
     sections: SectionItem$1[];
     isPostDetail: boolean;
     onCardPress: () => void;
+    onNavigate?: (href: string, isInternal: boolean) => void;
+    supportDeepviewDomain?: string | string[];
+    imageComponent?: React.ComponentType<{
+        src: string;
+        alt: string;
+        fill?: boolean;
+        placeholder?: 'blur' | 'empty';
+        blurDataURL?: string;
+        priority?: boolean;
+        className?: string;
+    }>;
 }
 declare const PostSectionsView: React.FC<Props$5>;
 
@@ -216,6 +272,15 @@ interface Props$4 {
         username: string;
         url: string;
     };
+    imageComponent?: React.ComponentType<{
+        src: string;
+        alt: string;
+        fill?: boolean;
+        placeholder?: 'blur' | 'empty';
+        blurDataURL?: string;
+        priority?: boolean;
+        className?: string;
+    }>;
 }
 declare const PostSectionSourceInfoView: React.FC<Props$4>;
 
@@ -235,7 +300,7 @@ interface PostLinkItemProps {
     }>;
     onCloseClick?: () => void;
     type?: 'preview' | 'display';
-    supportDeepviewDomain?: string;
+    supportDeepviewDomain?: string | string[];
 }
 declare const PostLinkItem: React.FC<PostLinkItemProps>;
 
@@ -286,7 +351,7 @@ interface AutoLinkProps {
     text: string;
     mentionData?: MentionData[];
     onNavigate?: (href: string, isInternal: boolean) => void;
-    supportDeepviewDomain?: string;
+    supportDeepviewDomain?: string | string[];
     phone?: any;
     email?: any;
     stripPrefix?: boolean;
@@ -299,6 +364,25 @@ declare const AutoLink: {
     truncate: (text: string, { truncate: len, truncateChars, truncateLocation }?: TruncateOptions) => string;
 };
 
+interface PostTypeHintContext {
+    isInGroup?: boolean;
+    isOwner?: boolean;
+    isPrivate?: boolean;
+    membersCount?: number;
+    /** Mirrors the web client's `isMetaDesc` branch (SEO/meta-description copy). */
+    isMetaDesc?: boolean;
+}
+interface PostTypeHint {
+    key: string;
+    params?: {
+        count?: number;
+    };
+}
+declare function getPostTypeHint(postType: string, ctx?: PostTypeHintContext): PostTypeHint;
+declare const POST_TYPE_HINT_DEFAULTS: Record<string, (p?: {
+    count?: number;
+}) => string>;
+
 interface ReactionModalProps {
     isOpen: boolean;
     close: () => void;
@@ -318,4 +402,4 @@ interface Props {
 }
 declare const EraseConfirmModal: React.FC<Props>;
 
-export { AutoLink, EmbedContent, EraseConfirmModal, ItemData, LinkItemMetaData, MediaUploadStatus, MediaUploadStatusOverlay, MentionData, PollItemData, PollResult, PostBody, PostCard, type PostCardProps, PostEmail, PostEmbedView, PostFooter, PostHeader, type PostHeaderProps, PostItemsView, PostLinkItem, PostMediaLayoutCore, PostPollView, PostSectionSourceInfoView, PostSectionsSummaryView, PostSectionsView, PostTextItem, PostUploadStrip, PrimaryContent, ReactionModal, ResolvedTextContent, SectionItem, TextItemContent, TipTapDocument };
+export { AutoLink, EmbedContent, EraseConfirmModal, ItemData, LinkItemMetaData, MediaUploadStatus, MediaUploadStatusOverlay, MentionData, POST_TYPE_HINT_DEFAULTS, PollItemData, PollResult, PostBody, PostCard, type PostCardProps, PostEmail, PostEmbedView, PostFooter, PostHeader, type PostHeaderProps, PostItemsView, PostLinkItem, PostMediaLayoutCore, PostPollView, PostSectionSourceInfoView, PostSectionsSummaryView, PostSectionsView, PostTextItem, type PostTypeHint, type PostTypeHintContext, PostUploadStrip, PrimaryContent, ReactionModal, ResolvedTextContent, SectionItem, TextItemContent, TipTapDocument, getPostTypeHint };