@datatechsolutions/tympan 0.3.0 → 0.3.1

package/src/groups/charts-geo.ts

@@ -0,0 +1,98 @@
+// Public exports of the "charts-geo" group (re-exported by src/index.ts).
+export { Chart, type ChartFace, type ChartFigure, type ChartForm, type ChartLayer, type ChartNote, type ChartProps, type ChartRecord } from '../components/chart/Chart'
+export {
+  ReportView,
+  validateReport,
+  type Report,
+  type ReportColumnType,
+  type ReportIssue,
+  type ReportKpi,
+  type ReportSection,
+  type ReportTable,
+  type ReportTone,
+  type ReportViewProps,
+} from '../components/report-view/ReportView'
+export {
+  LiveReportView,
+  initialRunView,
+  isTerminal as isTerminalRunStatus,
+  mergeReport,
+  phaseOf as runPhaseOf,
+  reduceRunEvent,
+  useRunEventStream,
+  type LiveReportViewProps,
+  type OpenRunStream,
+  type RunEvent,
+  type RunPhase,
+  type RunStep,
+  type RunStepState,
+  type RunStreamCallbacks,
+  type RunStreamOptions,
+  type RunStreamState,
+  type RunStreamStatus,
+  type RunView,
+} from '../components/live-report-view/LiveReportView'
+export {
+  RegionMap,
+  useRegionMapState,
+  type RegionGroup,
+  type RegionMapProps,
+  type RegionMapState,
+  type RegionMapStateOptions,
+  type RegionMapTotals,
+} from '../components/region-map/RegionMap'
+export {
+  checkToneUsage,
+  isToneName,
+  resolveTint,
+  tintStyle,
+  toneNames,
+  type TintReferences,
+  type ToneContext,
+  type ToneName,
+} from '../components/tone-tint/toneTint'
+export {
+  RegionThemeError,
+  RegionThemeProvider,
+  SUBDIVISION_KINDS,
+  createRegionThemeRegistry,
+  defaultRegionThemeRegistry,
+  deriveGeometry,
+  flagEmoji,
+  formatProfileAddress,
+  formatProfileMoney,
+  getCountryProfile,
+  getCountryView,
+  getFlagUrl,
+  getIdentityColours,
+  getIdentityTone,
+  getLabelPoint,
+  getMacroRegions,
+  getSubdivision,
+  isKnownSubdivision,
+  labelPointOf,
+  listCountryProfiles,
+  listSubdivisions,
+  registerCountryProfile,
+  registerRegionTheme,
+  unregisterCountryProfile,
+  unregisterRegionTheme,
+  useRegionThemeRegistry,
+  validateCountryProfile,
+  validateRegionThemeEntry,
+  type BoundaryCollection,
+  type BoundaryFeature,
+  type CountryProfile,
+  type DeriveOptions,
+  type IdentityColours,
+  type LonLat,
+  type RegionThemeEntry,
+  type RegionThemeRegistry,
+  type SourceCitation,
+  type Subdivision,
+  type SubdivisionKind,
+  type SubdivisionRecord,
+} from '../components/region-theme'
+// Country data modules: side-effect free, tree-shaken when unused.
+export { brazilRegionTheme, register as registerBrazilRegionTheme } from '../components/region-theme/data/br'
+export { brazilProfile as brazilCountryProfile, register as registerBrazilCountryProfile } from '../components/region-theme/data/br-profile'

package/src/groups/data-a.css

@@ -0,0 +1,13 @@
+/* Stylesheets of the "data-a" group (imported by src/styles.css). */
+@import '../components/section-panel/SectionPanel.css';
+@import '../components/list-panel/ListPanel.css';
+@import '../components/summary-row/SummaryRow.css';
+@import '../components/list-row/ListRow.css';
+@import '../components/count-badge/CountBadge.css';
+@import '../components/notification-center/NotificationCenter.css';
+@import '../components/profile-avatar/ProfileAvatar.css';
+@import '../components/copy-identifier/CopyIdentifier.css';
+@import '../components/history-list/HistoryList.css';
+@import '../components/grouped-disclosure-list/GroupedDisclosureList.css';
+@import '../components/recovery-code-list/RecoveryCodeList.css';
+@import '../components/markdown-view/MarkdownView.css';

package/src/groups/data-a.ts

@@ -0,0 +1,14 @@
+// Public exports of the "data-a" group (re-exported by src/index.ts).
+export * from '../components/section-panel/SectionPanel'
+export * from '../components/list-panel/ListPanel'
+export * from '../components/list-row/ListRow'
+export * from '../components/summary-row/SummaryRow'
+export * from '../components/count-badge/CountBadge'
+export * from '../components/notification-center/NotificationCenter'
+export * from '../components/profile-avatar/ProfileAvatar'
+export * from '../components/copy-identifier/CopyIdentifier'
+export * from '../components/history-list/HistoryList'
+export * from '../components/grouped-disclosure-list/GroupedDisclosureList'
+export * from '../components/recovery-code-list/RecoveryCodeList'
+export * from '../components/markdown-view/MarkdownView'
+export type { PluralNoun } from '../internal/messages/data-a'

package/src/groups/data-b.css

@@ -0,0 +1,11 @@
+/* Stylesheets of the "data-b" group (imported by src/styles.css). */
+@import '../components/agent-output-card/AgentOutputCard.css';
+@import '../components/contact-card/ContactCard.css';
+@import '../components/delta-indicator/DeltaIndicator.css';
+@import '../components/insight-card/InsightCard.css';
+@import '../components/metric-tile/MetricTile.css';
+@import '../components/profile-summary/ProfileSummary.css';
+@import '../components/record-card/RecordCard.css';
+@import '../components/stat-tile/StatTile.css';
+@import '../components/ticker-card/TickerCard.css';
+@import '../components/tweened-number/TweenedNumber.css';

package/src/groups/data-b.ts

@@ -0,0 +1,11 @@
+// Public exports of the "data-b" group (re-exported by src/index.ts).
+export * from '../components/agent-output-card/AgentOutputCard'
+export * from '../components/contact-card/ContactCard'
+export * from '../components/delta-indicator/DeltaIndicator'
+export * from '../components/insight-card/InsightCard'
+export * from '../components/metric-tile/MetricTile'
+export * from '../components/profile-summary/ProfileSummary'
+export * from '../components/record-card/RecordCard'
+export * from '../components/stat-tile/StatTile'
+export * from '../components/ticker-card/TickerCard'
+export * from '../components/tweened-number/TweenedNumber'

package/src/groups/forms-a.css

@@ -0,0 +1,17 @@
+/* Stylesheets of the "forms-a" group (imported by src/styles.css). */
+@import '../internal/forms-a/shared.css';
+@import '../internal/forms-a/SearchInput.css';
+@import '../components/theme-switcher/ThemeSwitcher.css';
+@import '../components/state-switch/StateSwitch.css';
+@import '../components/one-time-code-field/OneTimeCodeField.css';
+@import '../components/password-strength/PasswordStrength.css';
+@import '../components/search-bar/SearchBar.css';
+@import '../components/filter-field/FilterField.css';
+@import '../components/filter-chips/FilterChips.css';
+@import '../components/filter-tile/FilterTile.css';
+@import '../components/choice-card/ChoiceCard.css';
+@import '../components/choice-tile/ChoiceTile.css';
+@import '../components/choice-grid/ChoiceGrid.css';
+@import '../components/chip-group/ChipGroup.css';
+@import '../components/flag-set-picker/FlagSetPicker.css';
+@import '../components/theme-palette/ThemePalette.css';

package/src/groups/forms-a.ts

@@ -0,0 +1,15 @@
+// Public exports of the "forms-a" group (re-exported by src/index.ts).
+export * from '../components/theme-switcher/ThemeSwitcher'
+export * from '../components/state-switch/StateSwitch'
+export * from '../components/one-time-code-field/OneTimeCodeField'
+export * from '../components/password-strength/PasswordStrength'
+export * from '../components/search-bar/SearchBar'
+export * from '../components/filter-field/FilterField'
+export * from '../components/filter-chips/FilterChips'
+export * from '../components/filter-tile/FilterTile'
+export * from '../components/choice-card/ChoiceCard'
+export * from '../components/choice-tile/ChoiceTile'
+export * from '../components/choice-grid/ChoiceGrid'
+export * from '../components/chip-group/ChipGroup'
+export * from '../components/flag-set-picker/FlagSetPicker'
+export * from '../components/theme-palette/ThemePalette'

package/src/groups/forms-b.css

@@ -0,0 +1,14 @@
+/* Stylesheets of the "forms-b" group (imported by src/styles.css). */
+@import '../internal/forms-b/forms-b.css';
+@import '../components/category-tabs/CategoryTabs.css';
+@import '../components/currency-field/CurrencyField.css';
+@import '../components/date-field/DateField.css';
+@import '../components/form-actions/FormActions.css';
+@import '../components/form-layout/FormLayout.css';
+@import '../components/image-picker/ImagePicker.css';
+@import '../components/locale-picker/LocalePicker.css';
+@import '../components/month-field/MonthField.css';
+@import '../components/schema-request-form/SchemaRequestForm.css';
+@import '../components/tag-field/TagField.css';
+@import '../components/time-field/TimeField.css';
+@import '../components/wheel-picker/WheelPicker.css';

package/src/groups/forms-b.ts

@@ -0,0 +1,13 @@
+// Public exports of the "forms-b" group (re-exported by src/index.ts).
+export * from '../components/category-tabs/CategoryTabs'
+export * from '../components/currency-field/CurrencyField'
+export * from '../components/date-field/DateField'
+export * from '../components/form-actions/FormActions'
+export * from '../components/form-layout/FormLayout'
+export * from '../components/image-picker/ImagePicker'
+export * from '../components/locale-picker/LocalePicker'
+export * from '../components/month-field/MonthField'
+export * from '../components/schema-request-form/SchemaRequestForm'
+export * from '../components/tag-field/TagField'
+export * from '../components/time-field/TimeField'
+export * from '../components/wheel-picker/WheelPicker'

package/src/groups/overlays-nav.css

@@ -0,0 +1,15 @@
+/* Stylesheets of the "overlays-nav" group (imported by src/styles.css). */
+@import '../components/app-launcher-grid/AppLauncherGrid.css';
+@import '../components/app-navigation/AppNavigation.css';
+@import '../components/command-palette/CommandPalette.css';
+@import '../components/compact-confirm/CompactConfirm.css';
+@import '../components/details-popover/DetailsPopover.css';
+@import '../components/floating-action-button/FloatingActionButton.css';
+@import '../components/long-press-menu/LongPressMenu.css';
+@import '../components/navigation-flyout/NavigationFlyout.css';
+@import '../components/page-dots/PageDots.css';
+@import '../components/sectioned-modal/SectionedModal.css';
+@import '../components/settings-dialog/SettingsDialog.css';
+@import '../components/step-list/StepList.css';
+@import '../components/toolbar-trigger/ToolbarTrigger.css';
+@import '../components/wizard-page/WizardPage.css';

package/src/groups/overlays-nav.ts

@@ -0,0 +1,16 @@
+// Public exports of the "overlays-nav" group (re-exported by src/index.ts).
+export * from '../components/app-launcher-grid/AppLauncherGrid'
+export * from '../components/app-navigation/AppNavigation'
+export * from '../components/command-palette/CommandPalette'
+export * from '../components/compact-confirm/CompactConfirm'
+export * from '../components/confirm-service/ConfirmService'
+export * from '../components/details-popover/DetailsPopover'
+export * from '../components/floating-action-button/FloatingActionButton'
+export * from '../components/long-press-menu/LongPressMenu'
+export * from '../components/navigation-flyout/NavigationFlyout'
+export * from '../components/page-dots/PageDots'
+export * from '../components/sectioned-modal/SectionedModal'
+export * from '../components/settings-dialog/SettingsDialog'
+export * from '../components/step-list/StepList'
+export * from '../components/toolbar-trigger/ToolbarTrigger'
+export * from '../components/wizard-page/WizardPage'

package/src/groups/platform.css

@@ -0,0 +1,7 @@
+/* Stylesheets of the "platform" group (imported by src/styles.css). */
+@import '../components/swipe-row/SwipeRow.css';
+@import '../components/pull-to-refresh/PullToRefresh.css';
+@import '../components/edge-swipe-back/EdgeSwipeBack.css';
+@import '../components/safe-area-inset/SafeAreaInset.css';
+@import '../components/glass-check-toggle/GlassCheckToggle.css';
+@import '../components/cascade-grid/CascadeGrid.css';

package/src/groups/platform.ts

@@ -0,0 +1,101 @@
+// Public exports of the "platform" group (re-exported by src/index.ts).
+
+// Utilities
+export {
+  duration as motionDuration,
+  ease as motionEase,
+  motionPresets,
+  getPreset,
+  prefersReducedMotion,
+  resolveTransition,
+  DecorativeMotion,
+  useDecorativeMotion,
+  DECORATIVE_MOTION_DEFAULT,
+  type DurationStep,
+  type EaseStep,
+  type MotionPreset,
+  type MotionPresetName,
+  type MotionTransition,
+} from '../utilities/motion-foundation/motion'
+export { playHaptic, cancelHaptic, hapticsSupported, useHaptics, HapticsPreference, type HapticPattern, type HapticsApi } from '../utilities/haptics/haptics'
+export {
+  animateChange,
+  canAnimateChanges,
+  useAnimatedChange,
+  CHANGE_STYLE_ATTRIBUTE,
+  type ChangeRun,
+  type ChangeStyle,
+  type AnimateOptions,
+} from '../utilities/view-transition/animatedChange'
+export {
+  RoutingProvider,
+  useRouteHost,
+  useRouting,
+  useCurrentPath,
+  useRouteAnchor,
+  useVisitKey,
+  PlainAnchor,
+  type RouteHost,
+  type RouteMoves,
+  type AnchorComponent,
+  type AnchorProps,
+} from '../utilities/router-adapter/Routing'
+export {
+  I18nAdapterProvider,
+  createI18nValue,
+  createFormatter,
+  useTranslations,
+  useLocale,
+  useFormatter,
+  type I18nAdapterValue,
+  type TranslateFn,
+  type MessageTree,
+  type LocaleFormatter,
+} from '../utilities/i18n-adapter/I18nAdapter'
+export { formatMessage, type MessageParams } from '../utilities/i18n-adapter/icu'
+export { useEntityListLoader, type ListLoaderOptions, type ListLoaderResult } from '../utilities/entity-list-loader/useEntityListLoader'
+export {
+  formatMoney,
+  formatPercent,
+  formatDateTime,
+  formatAddress,
+  registerCountry,
+  getCountry,
+  listCountries,
+  toneForStatus,
+  useFormatters,
+  DEFAULT_PLACEHOLDER,
+  type CountryConfig,
+  type DateInput,
+  type StatusTone as SemanticStatusTone,
+} from '../utilities/formatters/formatters'
+export {
+  ApiError,
+  HttpResponseError,
+  ProblemError,
+  isApiError,
+  statusOf,
+  codeOf,
+  isKnownRunEvent,
+  createRunEventConsumer,
+  runStatusFromContract,
+  nodeStatusFromContract,
+  eventTypeFromContract,
+  KNOWN_RUN_EVENT_TYPES,
+  type SerializedApiError,
+  type ProblemDocument,
+  type NodeStatus,
+  type RunStatus,
+  type VariableValue,
+  type ExecutionEvent,
+  type KnownRunEventType,
+  type RunEventHandlers,
+} from '../utilities/api-error-model/apiErrors'
+
+// Components
+export * from '../components/swipe-row/SwipeRow'
+export * from '../components/pull-to-refresh/PullToRefresh'
+export * from '../components/edge-swipe-back/EdgeSwipeBack'
+export * from '../components/safe-area-inset/SafeAreaInset'
+export * from '../components/glass-check-toggle/GlassCheckToggle'
+export * from '../components/cascade-grid/CascadeGrid'

package/src/groups/shell.css

@@ -0,0 +1,10 @@
+/* Stylesheets of the "shell" group (imported by src/styles.css). */
+@import '../components/app-frame/AppFrameRail.css';
+@import '../components/floating-action-bar/FloatingActionBar.css';
+@import '../components/evidence-panel/EvidencePanel.css';
+@import '../components/resizable-split/ResizableSplit.css';
+@import '../components/stat-strip/StatStrip.css';
+@import '../components/stage-strip/StageStrip.css';
+@import '../components/attention-list/AttentionList.css';
+@import '../components/activity-feed/ActivityFeed.css';
+@import '../components/phase-bar/PhaseBar.css';

package/src/groups/shell.ts

@@ -0,0 +1,10 @@
+// Public exports of the "shell" group: the research shell (wave 4).
+export * from '../components/activity-feed/ActivityFeed'
+export * from '../components/app-frame/RailNav'
+export * from '../components/attention-list/AttentionList'
+export * from '../components/evidence-panel/EvidencePanel'
+export * from '../components/floating-action-bar/FloatingActionBar'
+export * from '../components/phase-bar/PhaseBar'
+export * from '../components/resizable-split/ResizableSplit'
+export * from '../components/stage-strip/StageStrip'
+export * from '../components/stat-strip/StatStrip'

package/src/groups/showcase.css

@@ -0,0 +1,8 @@
+/* Stylesheets of the "showcase" group (imported by src/styles.css). */
+@import '../components/showcase-heading/ShowcaseHeading.css';
+@import '../components/reveal-number/RevealNumber.css';
+@import '../components/showcase-backdrop/ShowcaseBackdrop.css';
+@import '../components/feature-showcase-card/FeatureShowcaseCard.css';
+@import '../components/ruled-grid/RuledGrid.css';
+@import '../components/highlight-stat/HighlightStat.css';
+@import '../components/feature-tile/FeatureTile.css';

package/src/groups/showcase.ts

@@ -0,0 +1,9 @@
+// Public exports of the "showcase" group (re-exported by src/index.ts):
+// wave-4 pieces for public pages (login, public project page).
+export * from '../components/showcase-heading/ShowcaseHeading'
+export * from '../components/reveal-number/RevealNumber'
+export * from '../components/showcase-backdrop/ShowcaseBackdrop'
+export * from '../components/feature-showcase-card/FeatureShowcaseCard'
+export * from '../components/ruled-grid/RuledGrid'
+export * from '../components/highlight-stat/HighlightStat'
+export * from '../components/feature-tile/FeatureTile'

package/src/index.ts

@@ -0,0 +1,65 @@
+// @datatechsolutions/tympan (FSL-1.1-ALv2). Import the stylesheet once: import '@datatechsolutions/tympan/styles.css'
+
+// Foundations
+export { TympanProvider, useMessages, type TympanProviderProps, type RouterNavigateOptions } from './internal/provider'
+export { catalogueForLocale, defaultMessages, messagesEs, messagesPtBR, mergeMessages, shippedCatalogues, type Messages, type MessageOverrides, type ProofStateKey } from './internal/messages'
+export { compileIcuMessages, pseudoLocalize, pseudoString, type IcuCatalogue } from './internal/icuCatalogue'
+export { ThemeProvider, useTheme, themeInitScript, type ThemeProviderProps, type ThemeState, type ThemeMode, type ThemeDensity } from './internal/theme'
+export { ThemeScope, type ThemeScopeProps } from './internal/ThemeScope'
+export { VisuallyHidden } from './internal/VisuallyHidden'
+export { variants, type VariantConfig } from './internal/variants'
+export { breakpoints, useMediaQuery, useReducedMotion } from './internal/media'
+export { requestHaptic, type HapticStrength } from './internal/haptics'
+export type { IconComponent } from './internal/types'
+
+// Components (wave 1 + design direction §2.11)
+export * from './components/action-menu/ActionMenu'
+export * from './components/actor-chip/ActorChip'
+export * from './components/app-frame/AppFrame'
+export * from './components/avatar/Avatar'
+export * from './components/breadcrumbs/Breadcrumbs'
+export * from './components/button/Button'
+export * from './components/checkbox/Checkbox'
+export * from './components/data-table/DataTable'
+export * from './components/drawer/Drawer'
+export * from './components/empty-state/EmptyState'
+export * from './components/error-state/ErrorState'
+export * from './components/field/Field'
+export * from './components/heading/Heading'
+export * from './components/inline-notice/InlineNotice'
+export * from './components/link/Link'
+export * from './components/listbox-select/ListboxSelect'
+export * from './components/modal-dialog/ModalDialog'
+export * from './components/native-select/NativeSelect'
+export * from './components/page-header/PageHeader'
+export * from './components/pagination/Pagination'
+export * from './components/popover/Popover'
+export * from './components/progress-bar/ProgressBar'
+export * from './components/proof-badge/ProofBadge'
+export * from './components/section-heading/SectionHeading'
+export * from './components/segmented-control/SegmentedControl'
+export * from './components/separator/Separator'
+export * from './components/skeleton/Skeleton'
+export * from './components/skip-link/SkipLink'
+export * from './components/spinner/Spinner'
+export * from './components/status-pill/StatusPill'
+export * from './components/surface/Surface'
+export * from './components/switch/Switch'
+export * from './components/tabs/Tabs'
+export * from './components/tag/Tag'
+export * from './components/text-area/TextArea'
+export * from './components/text-field/TextField'
+export * from './components/text/Text'
+export * from './components/toast/Toast'
+
+// Wave 2 and wave 4 (one barrel per group)
+export * from './groups/forms-a'
+export * from './groups/forms-b'
+export * from './groups/overlays-nav'
+export * from './groups/data-a'
+export * from './groups/data-b'
+export * from './groups/charts-geo'
+export * from './groups/auth-brand'
+export * from './groups/platform'
+export * from './groups/showcase'
+export * from './groups/shell'

package/src/internal/ThemeScope.tsx

@@ -0,0 +1,28 @@
+import type { HTMLAttributes, ReactNode } from 'react'
+import { cx } from './cx'
+
+export interface ThemeScopeProps extends HTMLAttributes<HTMLDivElement> {
+  /** Token theme; `tympan` is the default when omitted. */
+  theme?: string
+  /** Colour mode; follows the operating system when omitted or `system`. */
+  mode?: 'system' | 'light' | 'dark'
+  /** Alias of `mode`. */
+  scheme?: 'light' | 'dark'
+  density?: 'compact' | 'default' | 'comfortable'
+  children?: ReactNode
+}
+
+/** Applies a theme, mode and density to a subtree through the data attributes read by the token stylesheet. */
+export function ThemeScope({ theme, mode, scheme, density, className, children, ...rest }: ThemeScopeProps) {
+  return (
+    <div
+      {...rest}
+      className={cx('ty-theme-scope', className)}
+      data-ty-theme={theme}
+      data-ty-mode={mode ?? scheme}
+      data-ty-density={density}
+    >
+      {children}
+    </div>
+  )
+}

package/src/internal/VisuallyHidden.tsx

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react'
+
+/** Text available to assistive technology but not drawn. */
+export function VisuallyHidden({ children, id }: { children: ReactNode; id?: string }) {
+  return (
+    <span className="ty-visually-hidden" id={id}>
+      {children}
+    </span>
+  )
+}

package/src/internal/cx.ts

@@ -0,0 +1,4 @@
+/** Joins class names, skipping falsy values. */
+export function cx(...parts: Array<string | false | null | undefined>): string {
+  return parts.filter(Boolean).join(' ')
+}

package/src/internal/data-a/announce.ts

@@ -0,0 +1,38 @@
+// One polite live region for the whole document. Components that need to
+// report a change (a counter went up, a list was cleared) write into it
+// instead of each owning its own live region.
+
+const REGION_ATTR = 'data-ty-polite-announcer'
+
+function region(): HTMLElement | null {
+  if (typeof document === 'undefined') return null
+  let node = document.querySelector<HTMLElement>(`[${REGION_ATTR}]`)
+  if (!node) {
+    node = document.createElement('div')
+    node.setAttribute(REGION_ATTR, '')
+    node.setAttribute('role', 'status')
+    node.setAttribute('aria-live', 'polite')
+    node.className = 'ty-visually-hidden'
+    document.body.appendChild(node)
+  }
+  return node
+}
+
+let generation = 0
+
+/** Sends `text` to the shared polite region. Repeating the same text re-announces it. */
+export function announcePolitely(text: string): void {
+  const node = region()
+  if (!node) return
+  const mine = ++generation
+  node.textContent = ''
+  // A fresh text node after clearing makes screen readers repeat identical messages.
+  queueMicrotask(() => {
+    if (mine === generation) node.textContent = text
+  })
+}
+
+/** Test helper: the text currently in the shared region. */
+export function politeAnnouncement(): string {
+  return region()?.textContent ?? ''
+}

package/src/internal/data-a/clipboard.ts

@@ -0,0 +1,11 @@
+// Clipboard write that never throws: resolves true when the platform accepted it.
+export async function writeClipboard(text: string): Promise<boolean> {
+  const api = typeof navigator === 'undefined' ? undefined : navigator.clipboard
+  if (!api || typeof api.writeText !== 'function') return false
+  try {
+    await api.writeText(text)
+    return true
+  } catch {
+    return false
+  }
+}

package/src/internal/data-b/signed.ts

@@ -0,0 +1,34 @@
+// Signed figures for change indicators: always a sign except for zero, and a
+// true minus sign (U+2212) so a negative change never reads as a hyphen.
+
+export type ChangeUnit = 'percent' | 'number'
+
+const MINUS = '−'
+
+const cache = new Map<string, Intl.NumberFormat>()
+
+function formatterFor(locale: string, unit: ChangeUnit): Intl.NumberFormat {
+  const key = `${locale}|${unit}`
+  let nf = cache.get(key)
+  if (!nf) {
+    nf =
+      unit === 'percent'
+        ? new Intl.NumberFormat(locale, { style: 'percent', signDisplay: 'exceptZero', minimumFractionDigits: 1, maximumFractionDigits: 1 })
+        : new Intl.NumberFormat(locale, { signDisplay: 'exceptZero', maximumFractionDigits: 2 })
+    cache.set(key, nf)
+  }
+  return nf
+}
+
+/** `12.34` percent points → "+12.3%"; `-3` number → "−3". */
+export function signedFigure(value: number, unit: ChangeUnit, locale: string): string {
+  const input = unit === 'percent' ? value / 100 : value
+  return formatterFor(locale, unit).format(input).replace(/-/g, MINUS)
+}
+
+/** Direction of a change: 1 up, -1 down, 0 flat. */
+export function directionOf(value: number): -1 | 0 | 1 {
+  if (value > 0) return 1
+  if (value < 0) return -1
+  return 0
+}