Add dismiss button to float teaser bubble

[LEVI-RIVKIN]

Summary

Customers reported that the float teaser bubble could only be closed by engaging with the agent (clicking the launcher to open the chat). This adds an × dismiss button so users can close the teaser without opening the chat.

• Adds an × button to the teaser bubble (top-right corner, aria-label="Dismiss message", with a :focus-visible outline matching the other close controls). Clicking it stops propagation so it never opens the chat.
• Dismissing removes the teaser and the notification dot, and cancels any pending welcome-sequence timers.
• A dismissal persists in sessionStorage (keyed by host + researchId), so page navigations within the session don't bring the teaser — or its chime — back. A new browser session shows it again.
• Guards the welcome-sequence state machine so a later update() (e.g. async API config arriving) cannot re-arm a teaser the user already dismissed.

Configuration

Dismissible by default. Opt out via any of the existing config paths:

• teaser: { dismissible: false } (programmatic / React prop)
• data-perspective-teaser-dismissible="false" (declarative)
• API embedSettings.teaser.dismissible (dashboard, takes precedence)

Changes

• float.ts — dismiss button, dismissTeaser(), and the dismissed-state gate in the welcome sequence
• state.ts — get/setPersistedTeaserDismissed session-storage helpers (mirrors the existing open-state persistence)
• styles.ts — themed button styles (hover + focus-visible) reusing the existing --perspective-teaser-* / --perspective-close-* variables (light + dark)
• types.ts, constants.ts, browser.ts — dismissible on TeaserConfig and the new data attribute
• READMEs (both packages) + a minor-version changeset

Testing

• 455 unit tests pass (6 new): dismiss removes the teaser + dot without opening the chat (incl. aria-label), re-arm prevention after a config update, cross-mount session persistence (incl. chime suppression), per-researchId scoping, the dismissible: false opt-out, and data-perspective-teaser-dismissible parsing.
• Verified end-to-end in Chromium (Playwright): 11/11 checks across light/dark themes and the opt-out, confirming the teaser dismisses without opening the chat and stays dismissed across a reload.

🤖 Generated with Claude Code

[github-actions]

📦 Snapshot Release

Published snapshot packages for this PR:

pnpm add @perspective-ai/sdk@1.15.0-pr-72-20260713153600
pnpm add @perspective-ai/sdk-react@1.15.0-pr-72-20260713153600

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

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

[Copilot]

Pull request overview

This PR adds a user-facing dismiss (“×”) control to the float welcome teaser so users can close the teaser (and notification dot) without opening the chat, with the dismissal persisted for the current browser session to prevent re-arming on navigation or later config updates.

Changes:

• Adds teaser dismiss UX + session-persisted dismissed gating in the float welcome-sequence.
• Introduces teaser.dismissible configuration across programmatic config, data attributes, and API-merged settings.
• Updates styling, tests, and documentation (SDK + React SDK) and ships a minor-version changeset.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/sdk/src/types.ts	Extends TeaserConfig with dismissible option.
packages/sdk/src/styles.ts	Adds CSS for the teaser dismiss button.
packages/sdk/src/state.ts	Adds sessionStorage helpers for persisted teaser dismissal state.
packages/sdk/src/float.ts	Implements dismiss button behavior, persistence, and welcome-sequence gating.
packages/sdk/src/float.test.ts	Adds unit tests covering dismiss behavior, persistence, scoping, and opt-out.
packages/sdk/src/constants.ts	Adds data attribute + storage key constants for teaser dismissibility/dismissal.
packages/sdk/src/browser.ts	Parses data-perspective-teaser-dismissible="false" into config.
packages/sdk/src/browser.test.ts	Adds test for the new data attribute parsing.
packages/sdk/README.md	Documents dismiss behavior and new config/data attribute.
packages/sdk-react/README.md	Documents React usage of teaser.dismissible.
.changeset/float-teaser-dismiss.md	Declares minor releases and summarizes the feature.

---

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