@postrun/react 2.8.0 → 2.10.0

package/dist/index.d.cts

@@ -1631,29 +1631,31 @@ declare function useTikTokCreatorInfo(connectionId: string | null): _tanstack_re
 /** The identity fields our `Connection` stores — the SDK-driven base every
  * preview author derives from (so the field names + nullability match the API). */
 type ConnectionIdentity = Pick<Connection, 'username' | 'avatar_url'>;
-/** The author identity rendered in an X preview header. */
-interface XPreviewAuthor {
-    /** Display name, e.g. "Acme Studio". */
+/**
+ * The author identity rendered in an X preview header. `username` (the `@handle`)
+ * and `avatar_url` are DERIVED from the SDK `Connection`; `name` (the display
+ * name) and `verified` are presentation extras our API doesn't store.
+ */
+type XPreviewAuthor = ConnectionIdentity & {
+    /** Display name, e.g. "Acme Studio". NOT on Connection — caller-supplied. */
     name: string;
-    /** Handle WITHOUT the leading `@`, e.g. "acmestudio". */
-    handle: string;
-    /** Avatar image URL. Omit for a neutral placeholder. */
-    avatarUrl?: string;
-    /** Show the verified badge. Default false. */
+    /** Show the verified badge. NOT on Connection — caller-supplied. */
     verified?: boolean;
-}
-/** The author identity rendered in a LinkedIn preview header. LinkedIn shows a
- * name + a one-line headline (role/tagline), not an `@handle`. */
-interface LinkedInPreviewAuthor {
-    /** Display name, e.g. "Acme Studio". */
+};
+/**
+ * The author identity rendered in a LinkedIn preview header. LinkedIn shows a
+ * display `name` + a one-line `headline`. `username`/`avatar_url` are DERIVED
+ * from the SDK `Connection`; `name`/`headline`/`verified` are presentation extras
+ * our API doesn't store (LinkedIn's `username` is also documented as NULL today).
+ */
+type LinkedInPreviewAuthor = ConnectionIdentity & {
+    /** Display name, e.g. "Acme Studio". NOT on Connection — caller-supplied. */
     name: string;
-    /** One-line headline under the name, e.g. "Founder & CEO at Acme". */
+    /** One-line headline under the name. NOT on Connection — caller-supplied. */
     headline?: string;
-    /** Avatar image URL. Omit for a neutral placeholder. */
-    avatarUrl?: string;
-    /** Show the verified badge. Default false. */
+    /** Show the verified badge. NOT on Connection — caller-supplied. */
     verified?: boolean;
-}
+};
 /**
  * The author identity rendered in an Instagram preview header. Instagram shows
  * the `username` (no separate display name) + an optional verified badge.
@@ -1744,7 +1746,7 @@ interface XPostPreviewProps {
  * preview. Fully customizable: restyle via `className`/`style` (CSS variables)
  * or swap internals via `components`; theme light/dark/auto.
  */
-declare function XPostPreviewImpl({ variant, author, media, quotedTweet, replyToHandle, theme, showActions, className, style, components, }: XPostPreviewProps): react.JSX.Element;
+declare function XPostPreviewImpl({ variant, author, media, quotedTweet, replyToHandle, theme, showActions, className, style, components: componentsProp, }: XPostPreviewProps): react.JSX.Element;
 /** Memoized: re-renders only when its props change (the resolved-media hook
  * already absorbs unstable media arrays). */
 declare const XPostPreview: react.MemoExoticComponent<typeof XPostPreviewImpl>;
@@ -1893,20 +1895,25 @@ declare function InstagramPostPreviewImpl({ variant, author, media, theme, class
 /** Memoized: the resolved-media hook absorbs unstable media arrays. */
 declare const InstagramPostPreview: react.MemoExoticComponent<typeof InstagramPostPreviewImpl>;
 
-/**
- * An Instagram Reel preview — the 9:16 vertical card: full-bleed video, the
- * username/verified + caption overlaid bottom-left, an audio row ("♪ <audio>"),
- * and the right action rail (like/comment/share/save/more — no fabricated
- * counts). Always dark, like the real Reels surface.
- */
-declare function ReelPreview({ author, body, media, audioName, className, style, }: {
+interface ReelPreviewProps {
     author: InstagramPreviewAuthor;
     body: string;
     media: readonly ResolvedMedia[];
+    /** Media is referenced but its pixels aren't resolved yet (still processing). */
+    pending?: boolean;
+    /** The reel's audio label (`settings.audio_name`); defaults to "Original audio". */
     audioName?: string;
     className?: string;
     style?: CSSProperties;
-}): react.JSX.Element;
+}
+/**
+ * An Instagram Reel preview — the 9:16 vertical card: full-bleed video, the
+ * username/verified + caption overlaid bottom-left, an audio row ("♪ <audio>"),
+ * and the right action rail (like/comment/share/save/more — no fabricated
+ * counts). Always dark, like the real Reels surface. The caption uses the shared
+ * `ExpandableText` fold so the full text is readable (no silent truncation).
+ */
+declare function ReelPreview({ author, body, media, pending, audioName, className, style, }: ReelPreviewProps): react.JSX.Element;
 
 /**
  * Public props for the TikTok post preview — a faithful render of how a post will
@@ -2041,4 +2048,4 @@ declare function Declaration({ brandedContent }: {
     brandedContent: boolean;
 }): react.JSX.Element;
 
-export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, ReelPreview, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, UploadError, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };
+export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionIdentity, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, ReelPreview, type ReelPreviewProps, type ResolvedMedia, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, UploadError, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };

package/dist/index.d.ts

@@ -1631,29 +1631,31 @@ declare function useTikTokCreatorInfo(connectionId: string | null): _tanstack_re
 /** The identity fields our `Connection` stores — the SDK-driven base every
  * preview author derives from (so the field names + nullability match the API). */
 type ConnectionIdentity = Pick<Connection, 'username' | 'avatar_url'>;
-/** The author identity rendered in an X preview header. */
-interface XPreviewAuthor {
-    /** Display name, e.g. "Acme Studio". */
+/**
+ * The author identity rendered in an X preview header. `username` (the `@handle`)
+ * and `avatar_url` are DERIVED from the SDK `Connection`; `name` (the display
+ * name) and `verified` are presentation extras our API doesn't store.
+ */
+type XPreviewAuthor = ConnectionIdentity & {
+    /** Display name, e.g. "Acme Studio". NOT on Connection — caller-supplied. */
     name: string;
-    /** Handle WITHOUT the leading `@`, e.g. "acmestudio". */
-    handle: string;
-    /** Avatar image URL. Omit for a neutral placeholder. */
-    avatarUrl?: string;
-    /** Show the verified badge. Default false. */
+    /** Show the verified badge. NOT on Connection — caller-supplied. */
     verified?: boolean;
-}
-/** The author identity rendered in a LinkedIn preview header. LinkedIn shows a
- * name + a one-line headline (role/tagline), not an `@handle`. */
-interface LinkedInPreviewAuthor {
-    /** Display name, e.g. "Acme Studio". */
+};
+/**
+ * The author identity rendered in a LinkedIn preview header. LinkedIn shows a
+ * display `name` + a one-line `headline`. `username`/`avatar_url` are DERIVED
+ * from the SDK `Connection`; `name`/`headline`/`verified` are presentation extras
+ * our API doesn't store (LinkedIn's `username` is also documented as NULL today).
+ */
+type LinkedInPreviewAuthor = ConnectionIdentity & {
+    /** Display name, e.g. "Acme Studio". NOT on Connection — caller-supplied. */
     name: string;
-    /** One-line headline under the name, e.g. "Founder & CEO at Acme". */
+    /** One-line headline under the name. NOT on Connection — caller-supplied. */
     headline?: string;
-    /** Avatar image URL. Omit for a neutral placeholder. */
-    avatarUrl?: string;
-    /** Show the verified badge. Default false. */
+    /** Show the verified badge. NOT on Connection — caller-supplied. */
     verified?: boolean;
-}
+};
 /**
  * The author identity rendered in an Instagram preview header. Instagram shows
  * the `username` (no separate display name) + an optional verified badge.
@@ -1744,7 +1746,7 @@ interface XPostPreviewProps {
  * preview. Fully customizable: restyle via `className`/`style` (CSS variables)
  * or swap internals via `components`; theme light/dark/auto.
  */
-declare function XPostPreviewImpl({ variant, author, media, quotedTweet, replyToHandle, theme, showActions, className, style, components, }: XPostPreviewProps): react.JSX.Element;
+declare function XPostPreviewImpl({ variant, author, media, quotedTweet, replyToHandle, theme, showActions, className, style, components: componentsProp, }: XPostPreviewProps): react.JSX.Element;
 /** Memoized: re-renders only when its props change (the resolved-media hook
  * already absorbs unstable media arrays). */
 declare const XPostPreview: react.MemoExoticComponent<typeof XPostPreviewImpl>;
@@ -1893,20 +1895,25 @@ declare function InstagramPostPreviewImpl({ variant, author, media, theme, class
 /** Memoized: the resolved-media hook absorbs unstable media arrays. */
 declare const InstagramPostPreview: react.MemoExoticComponent<typeof InstagramPostPreviewImpl>;
 
-/**
- * An Instagram Reel preview — the 9:16 vertical card: full-bleed video, the
- * username/verified + caption overlaid bottom-left, an audio row ("♪ <audio>"),
- * and the right action rail (like/comment/share/save/more — no fabricated
- * counts). Always dark, like the real Reels surface.
- */
-declare function ReelPreview({ author, body, media, audioName, className, style, }: {
+interface ReelPreviewProps {
     author: InstagramPreviewAuthor;
     body: string;
     media: readonly ResolvedMedia[];
+    /** Media is referenced but its pixels aren't resolved yet (still processing). */
+    pending?: boolean;
+    /** The reel's audio label (`settings.audio_name`); defaults to "Original audio". */
     audioName?: string;
     className?: string;
     style?: CSSProperties;
-}): react.JSX.Element;
+}
+/**
+ * An Instagram Reel preview — the 9:16 vertical card: full-bleed video, the
+ * username/verified + caption overlaid bottom-left, an audio row ("♪ <audio>"),
+ * and the right action rail (like/comment/share/save/more — no fabricated
+ * counts). Always dark, like the real Reels surface. The caption uses the shared
+ * `ExpandableText` fold so the full text is readable (no silent truncation).
+ */
+declare function ReelPreview({ author, body, media, pending, audioName, className, style, }: ReelPreviewProps): react.JSX.Element;
 
 /**
  * Public props for the TikTok post preview — a faithful render of how a post will
@@ -2041,4 +2048,4 @@ declare function Declaration({ brandedContent }: {
     brandedContent: boolean;
 }): react.JSX.Element;
 
-export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, ReelPreview, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, UploadError, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };
+export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionIdentity, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, ReelPreview, type ReelPreviewProps, type ResolvedMedia, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, UploadError, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };