feat(ai): add F0AiProcessingOverlay

[warcos-fact]

Description

Adds F0AiProcessingOverlay, a floating "applying changes" affordance for the F0AiChat family: while active, it blurs and locks (pointer-events-none) the wrapped panel/canvas and floats a centered pill (the One icon + a status label) over it, signalling that the surface is being regenerated and shouldn't be edited. It lifts the existing survey form-builder pattern into a reusable component so any surface paired with the chat can use it.

Extracted from the co-creation patterns PR (#4307) so it can be reviewed on its own.

Implementation details

• feat: add F0AiProcessingOverlay (active, label, className, children) under sds/ai, exported from sds/ai/exports.ts
• feat: add ai.applyingChanges ("Applying changes") default translation used as the pill's fallback label

Visual behaviour is covered by the component's usage in the co-creation stories.

Breaking changes

None in practice. The api_breaking bot flags the new ai.applyingChanges translation key because TranslationsType requires every key, so a consumer who hand-authors a complete translation object from scratch would need to add it. This is intentional and the standard cost of any translatable string:

• The component, its props, and exports are purely additive.
• The idiomatic pattern ({ ...defaultTranslations, ...overrides }) auto-inherits the new English default, so the vast majority of consumers are unaffected.
• Affected consumers fix it with a single line; the check is non-blocking, hence feat(ai): rather than feat!:.

[github-actions]

✅ No New Circular Dependencies

No new circular dependencies detected. Current count: 0

[github-actions]

🔍 Visual review for your branch is published 🔍

Here are the links to:

• the Visual Review Page

• the latest build on chromatic

• the full storybook

[github-actions]

📦 Alpha Package Version Published

Use pnpm i github:factorialco/f0#npm/alpha-pr-4533 to install the package

Use pnpm i github:factorialco/f0#f73f68bcd9377d2aa86a5cd65a1543b132daf1dd to install this specific commit

[github-actions]

⚠️ Breaking public API changes (1)

These public exports were renamed/removed, or had a property/parameter removed, retyped, or newly required compared to main — that breaks consumers. Adding new exports or new optional props is always safe and is not flagged. If a breaking change is intentional, note it in the PR description and use a feat!:/BREAKING CHANGE commit so the release is a major bump.

Comparing f0, experimental and ai against main. Adding components, types, or optional props is safe. This check is non-blocking.

🌐 Translations

• ➕ Translation keys were added: ai.applyingChanges

  The translations dictionary is embedded in many public exports (buildTranslations, defaultTranslations, i18n props, …), so its changes are summarized here once instead of being flagged on every export. Consumers maintaining full translation objects must update them.

➕ Additive changes (safe) — 4

• f0: F0AiProcessingOverlay, F0AiProcessingOverlayProps
• ai: F0AiProcessingOverlay, F0AiProcessingOverlayProps

[github-actions]

Coverage Report for packages/react

Status	Category	Percentage	Covered / Total
🔵	Lines	57.14%	17901 / 31327
🔵	Statements	56.31%	18658 / 33133
🔵	Functions	49.52%	4109 / 8297
🔵	Branches	50.02%	12747 / 25481

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
packages/react/src/lib/providers/i18n/i18n-provider-defaults.ts	100%	100%	100%	100%
packages/react/src/sds/ai/exports.ts	100%	100%	100%	100%
packages/react/src/sds/ai/F0AiProcessingOverlay/F0AiProcessingOverlay.tsx	100%	79.16%	100%	100%
packages/react/src/sds/ai/F0AiProcessingOverlay/index.ts	100%	100%	100%	100%

Generated in workflow #15028 for commit d0149dd by the Vitest Coverage Report Action

[developerdanx]

💪