Forward teaser.dismissible through FloatBubble/useFloatBubble

[LEVI-RIVKIN]

Problem

1.15.0 added the teaser.dismissible option (the × button that lets a visitor dismiss the float teaser without opening the chat). The core @perspective-ai/sdk renders and honors it, but the React wrapper never forwards it, so teaser={{ dismissible: false }} has no effect when using @perspective-ai/sdk-react — the × button always renders.

The cause is in useFloatBubble, which stabilizes the teaser prop on its primitive fields (to avoid remounting the bubble on every parent render) and only carried three of them:

// before — dismissible silently dropped
{ enabled: teaserEnabled, delay: teaserDelay, sound: teaserSound }

dismissible was never destructured, so it never reached createFloatBubble.

This surfaced downstream in the demos site, where &teaser.dismissible=false on the float/chat page had no effect despite the param being parsed and passed correctly.

Fix

• packages/sdk-react/src/hooks/useFloatBubble.ts — destructure teaser?.dismissible, add it to the stabilized teaser object, and include it in the useMemo dependency array.
• packages/sdk-react/src/hooks/useFloatBubble.test.ts — new test asserting all four teaser fields (enabled, delay, sound, dismissible) are forwarded to createFloatBubble.

Audit of the other teaser surfaces

Confirmed the React hook was the only surface dropping the field. Every other path already forwards dismissible and is test-covered:

Surface	Status	Coverage
Vanilla config — createFloatBubble({ teaser })	✅ correct (core resolveTeaserConfig spreads all fields)	float.test.ts
CDN data-attribute — data-perspective-teaser-dismissible	✅ correct (parser reads all four attrs)	browser.test.ts
React — <FloatBubble> / useFloatBubble	⚠️ was broken → fixed here	new test

• packages/sdk/src/types.ts — the only remaining inaccuracy was the EmbedConfig.teaser JSDoc, which listed enabled/delay/sound but not dismissible; corrected so the documented API matches.

Changeset

• .changeset/float-teaser-dismissible-react.md — patch bump for both @perspective-ai/sdk-react and @perspective-ai/sdk (the packages are fixed-linked).

Verification

• Core @perspective-ai/sdk — pnpm typecheck clean, 455 tests pass.
• @perspective-ai/sdk-react — pnpm typecheck clean, 91 tests pass (including the new one).
• pnpm build succeeds and dismissible now appears in the compiled dist/index.js.
• Pre-commit/pre-push hooks (lint, format, test, typecheck across all packages) pass.

🤖 Generated with Claude Code

[github-actions]

📦 Snapshot Release

Published snapshot packages for this PR:

pnpm add @perspective-ai/sdk@1.15.1-pr-74-20260713201345
pnpm add @perspective-ai/sdk-react@1.15.1-pr-74-20260713201345

Or use the npm tag (always points to the latest snapshot from this PR):

pnpm add @perspective-ai/sdk@pr-74
pnpm add @perspective-ai/sdk-react@pr-74

[Copilot]

Pull request overview

This PR fixes the React wrapper (@perspective-ai/sdk-react) not forwarding the core SDK’s teaser.dismissible option, ensuring teaser={{ dismissible: false }} correctly hides the float teaser × dismiss button when using useFloatBubble / FloatBubble.

Changes:

• Forward teaser.dismissible through useFloatBubble by stabilizing it alongside the other teaser primitive fields and adding it to the memo dependencies.
• Add a hook test verifying all teaser fields (enabled, delay, sound, dismissible) are passed to createFloatBubble.
• Add a changeset to publish a patch release of @perspective-ai/sdk-react.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
packages/sdk-react/src/hooks/useFloatBubble.ts	Adds teaser.dismissible to the stabilized teaser config passed into createFloatBubble.
packages/sdk-react/src/hooks/useFloatBubble.test.ts	Adds a regression test asserting dismissible is forwarded to the core SDK.
.changeset/float-teaser-dismissible-react.md	Declares a patch bump and documents the forwarding fix.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.