@atlaskit/smart-card 44.5.0 → 44.5.2

package/dist/types-ts4.5/state/hooks/use-social-proof/index.d.ts

@@ -0,0 +1,13 @@
+export interface SocialProof {
+    connectedPct: number | undefined;
+    isEnabled: boolean;
+    /** True while fetching personalization (only when `isEnabled`). */
+    isLoading: boolean;
+}
+/**
+ * Fetches provider usage percentage from the TAP Delivery personalization service when the
+ * killswitch allows it. Callers decide separately (e.g. via Statsig experiment) whether to
+ * surface that data in the UI.
+ */
+declare const useSocialProof: (traitName: string, extensionKey?: string, isKillswitchOn?: boolean) => SocialProof;
+export default useSocialProof;

package/dist/types-ts4.5/state/services/current-site-cloud-id/index.d.ts

@@ -0,0 +1,46 @@
+export declare const CURRENT_SITE_CLOUD_ID_STORAGE_ITEM_KEY: string;
+/** Keys written by this service in localStorage when using {@link smartCardStorage}. */
+export declare const CURRENT_SITE_CLOUD_ID_LOCAL_STORAGE_KEY: string;
+export declare class CurrentSiteCloudIdService {
+    /**
+     * Holds the shared tenant_info work: one in-flight fetch, then (on success) a settled promise for the session cloud
+     * id so later callers never trigger another `tenant_info` in the same page lifetime (until {@link clearCache}).
+     */
+    private tenantInfoInflightPromise;
+    private readStoredCloudId;
+    private writeStoredCloudId;
+    private ensureTenantInfoInflightStarted;
+    /**
+     * Returns the currently cached cloud id synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedCloudIdAndRefresh(): string | undefined;
+    /** Writes tenant cloud id for tests or callers that intentionally warm storage before edge resolves. */
+    persistStoredCloudId(cloudId: string): void;
+    /**
+     * When local storage already has a tenant cloud id, it is returned immediately; a background tenant_info refresh
+     * is still kicked off unless one is already in flight.
+     *
+     * Without storage, this awaits the deduped in-flight tenant_info (first concurrent caller chooses the URL;
+     * all share one promise regardless of subsequent `baseUriWithNoTrailingSlash`).
+     *
+     * On network success with no cloud id, or on failure: falls back via {@link readStoredCloudId}.
+     */
+    get(baseUriWithNoTrailingSlash?: string): Promise<string | undefined>;
+    /** Clears the session pin so the next {@link get} may run `tenant_info` again (e.g. tests). */
+    clearCache(): void;
+}
+export declare const currentSiteCloudIdService: CurrentSiteCloudIdService;
+/**
+ * Resolves the current site cloud id through the module-level {@link currentSiteCloudIdService}.
+ * Returns a stored cloud id immediately when one exists; otherwise waits for the shared
+ * `tenant_info` request and persists the result for subsequent cached reads.
+ */
+export declare const getCurrentSiteCloudId: (baseUriWithNoTrailingSlash?: string) => Promise<string | undefined>;
+/**
+ * Reads the current site cloud id from browser storage (the `site-cloud-id:v1` row) via the
+ * module-level {@link currentSiteCloudIdService} singleton, without awaiting network work.
+ * Calling this also starts the shared `tenant_info` refresh in the background when one is not
+ * already running, so a later call can observe a refreshed value when available.
+ */
+export declare function getCachedCurrentSiteCloudIdAndRefresh(): string | undefined;

package/dist/types-ts4.5/state/services/personalization/index.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderPctMap } from './types';
+/**
+ * Logical key shape: `@atlaskit/smart-card:<feature>:<schema-version>:<scope>` (see smart-card
+ * storage conventions). {@link StorageClient} narrows the localStorage key to
+ * `<clientKey>_<itemKey>` with `clientKey === '@atlaskit/smart-card'` and
+ * `itemKey === 'pct-map:v1:<cloudId>:<traitName>'` (scope segments URI-encoded).
+ */
+export declare const PERSONALIZATION_STORAGE_SCOPE: string;
+export declare const PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX: string;
+/**
+ * Service for fetching site-level traits from the TAP Delivery personalization API.
+ */
+export declare class PersonalizationService {
+    private cache;
+    /**
+     * Returns the currently cached provider percentage map synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;
+    getProviderPctMap(traitName: string): Promise<ProviderPctMap | undefined>;
+    private readStoredProviderPctMap;
+    private writeStoredProviderPctMap;
+    private normalizeProviderPctMap;
+    private parseTraitValue;
+    clearCache(): void;
+    private clearStoredProviderPctMaps;
+}
+export declare const personalizationService: PersonalizationService;
+/**
+ * Resolves the provider percentage map for a TAP Delivery trait through the module-level
+ * {@link personalizationService}. Work is deduped per trait name for the page lifetime, and a
+ * successful response is persisted by cloud id and trait name for later cached reads.
+ */
+export declare const getProviderPctMap: (traitName: string) => Promise<ProviderPctMap | undefined>;
+/**
+ * Reads the provider percentage map for a trait from browser storage via the module-level
+ * {@link personalizationService} singleton, without awaiting network work.
+ * Calling this also starts the trait-scoped shared refresh in the background, so a later call can
+ * use a refreshed value when it becomes available.
+ */
+export declare function getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;

package/dist/types-ts4.5/state/services/personalization/types.d.ts

@@ -0,0 +1,10 @@
+export type PersonalizationTrait = {
+    name: string;
+    value: string | boolean | number;
+};
+/**
+ * Map of extensionKey to connected users percentage.
+ * Keys are extensionKeys directly (e.g. 'google-object-provider').
+ * Values are integers 0-100.
+ */
+export type ProviderPctMap = Record<string, number>;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-chapter-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiChapterIcon: {
+interface AiChapterIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiChapterIcon: AiChapterIconFunction;
 export default AiChapterIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-edit-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiEditIcon: {
+interface AiEditIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiEditIcon: AiEditIconFunction;
 export default AiEditIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-search-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiSearchIcon: {
+interface AiSearchIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiSearchIcon: AiSearchIconFunction;
 export default AiSearchIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/rovo-hex-logo.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-declare const RovoHexLogo: {
-    ({ width, height, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;
+interface RovoHexLogoFunction {
+    (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const RovoHexLogo: RovoHexLogoFunction;
 export default RovoHexLogo;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/smart-card",
-	"version": "44.5.0",
+	"version": "44.5.2",
 	"description": "Smart card component",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -85,7 +85,7 @@
 		"@atlaskit/textfield": "^8.3.0",
 		"@atlaskit/theme": "^23.2.0",
 		"@atlaskit/tile": "^1.1.0",
-		"@atlaskit/tmp-editor-statsig": "^74.1.0",
+		"@atlaskit/tmp-editor-statsig": "^74.5.0",
 		"@atlaskit/tokens": "^13.0.0",
 		"@atlaskit/tooltip": "^21.2.0",
 		"@atlaskit/ufo": "^0.4.0",

package/smart-card.docs.tsx

@@ -38,22 +38,26 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Card (basic)',
-				description: 'Inline, block, and embed appearances shown side by side. Requires staging login to resolve links.',
+				description:
+					'Inline, block, and embed appearances shown side by side. Requires staging login to resolve links.',
 				source: path.resolve(packagePath, './examples/content/card.tsx'),
 			},
 			{
 				name: 'Card (appearance: block)',
-				description: 'Block appearance — card-style preview with detailed view of the linked material. In the editor this is referred to as the "Card".',
+				description:
+					'Block appearance — card-style preview with detailed view of the linked material. In the editor this is referred to as the "Card".',
 				source: path.resolve(packagePath, './examples/content/block-card.tsx'),
 			},
 			{
 				name: 'Card (appearance: inline)',
-				description: 'Inline appearance — link in text like a hyperlink. Use showHoverPreview for hover preview on inline Smart Links.',
+				description:
+					'Inline appearance — link in text like a hyperlink. Use showHoverPreview for hover preview on inline Smart Links.',
 				source: path.resolve(packagePath, './examples/content/inline-card.tsx'),
 			},
 			{
 				name: 'Card (appearance: embed)',
-				description: 'Embed appearance — linked content rendered in place. Requires a resolvable embed URL; not all links support embed.',
+				description:
+					'Embed appearance — linked content rendered in place. Requires a resolvable embed URL; not all links support embed.',
 				source: path.resolve(packagePath, './examples/content/embed-card.tsx'),
 			},
 		],
@@ -84,7 +88,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Hover card',
-				description: 'HoverCard wrapping a trigger element; shows Smart Link preview on hover. Requires staging login to resolve.',
+				description:
+					'HoverCard wrapping a trigger element; shows Smart Link preview on hover. Requires staging login to resolve.',
 				source: path.resolve(packagePath, './examples/content/hover-card.tsx'),
 			},
 		],
@@ -114,7 +119,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Link URL',
-				description: 'Link safety: when link text looks like a URL but destination differs (warning) vs when text matches or is plain (no warning).',
+				description:
+					'Link safety: when link text looks like a URL but destination differs (warning) vs when text matches or is plain (no warning).',
 				source: path.resolve(packagePath, './examples/content/link-url.tsx'),
 			},
 		],
@@ -139,12 +145,21 @@ const documentation: ComponentStructuredContentSource[] = [
 			'Use a logical structure (e.g. heading hierarchy) so the card is navigable by assistive tech.',
 			'Ensure all interactive elements inside blocks (links, buttons, actions) are focusable and have accessible names.',
 		],
-		keywords: ['smart-card', 'flexible', 'flexible card', 'flexible ui', 'blocks', 'elements', 'composable'],
+		keywords: [
+			'smart-card',
+			'flexible',
+			'flexible card',
+			'flexible ui',
+			'blocks',
+			'elements',
+			'composable',
+		],
 		categories: ['linking', 'data-display'],
 		examples: [
 			{
 				name: 'Flexible UI card',
-				description: 'Custom block layout with TitleBlock, PreviewBlock, MetadataBlock, SnippetBlock, and FooterBlock composed inside Card.',
+				description:
+					'Custom block layout with TitleBlock, PreviewBlock, MetadataBlock, SnippetBlock, and FooterBlock composed inside Card.',
 				source: path.resolve(packagePath, './examples/content/flexible-ui-card.tsx'),
 			},
 		],
@@ -174,7 +189,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Title block default',
-				description: 'TitleBlock with default props; title and icon come from the resolved link data.',
+				description:
+					'TitleBlock with default props; title and icon come from the resolved link data.',
 				source: path.resolve(packagePath, './examples/content/title-block-default.tsx'),
 			},
 		],
@@ -204,7 +220,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Metadata block primary',
-				description: 'MetadataBlock with a primary row showing CollaboratorGroup and ModifiedOn elements.',
+				description:
+					'MetadataBlock with a primary row showing CollaboratorGroup and ModifiedOn elements.',
 				source: path.resolve(packagePath, './examples/content/metadata-block-primary.tsx'),
 			},
 		],
@@ -240,7 +257,8 @@ const documentation: ComponentStructuredContentSource[] = [
 	},
 	{
 		name: 'FooterBlock',
-		description: 'A block component for the Smart Link footer, typically showing actions (e.g. copy, open, follow).',
+		description:
+			'A block component for the Smart Link footer, typically showing actions (e.g. copy, open, follow).',
 		status: 'general-availability',
 		import: {
 			name: 'FooterBlock',
@@ -262,7 +280,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Footer block default',
-				description: 'FooterBlock with default actions (e.g. copy, open, follow) at the bottom of the card.',
+				description:
+					'FooterBlock with default actions (e.g. copy, open, follow) at the bottom of the card.',
 				source: path.resolve(packagePath, './examples/content/footer-block-default.tsx'),
 			},
 		],
@@ -291,7 +310,8 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'Analytics',
-				description: 'Card with AnalyticsListener capturing and displaying Smart Link analytics events (e.g. on click).',
+				description:
+					'Card with AnalyticsListener capturing and displaying Smart Link analytics events (e.g. on click).',
 				source: path.resolve(packagePath, './examples/content/analytics.tsx'),
 			},
 		],
@@ -320,12 +340,12 @@ const documentation: ComponentStructuredContentSource[] = [
 		examples: [
 			{
 				name: 'useSmartLinkActions',
-				description: 'useSmartLinkActions used to get actions for a URL and invoke one (e.g. Preview) from a custom button.',
+				description:
+					'useSmartLinkActions used to get actions for a URL and invoke one (e.g. Preview) from a custom button.',
 				source: path.resolve(packagePath, './examples/content/useSmartLinkActions.tsx'),
 			},
 		],
 	},
 ];
 
-
 export default documentation;