Design system
Documentation experienceDS-07

Home / Components / Map Preview

Approved

Map Preview

Provide the governed NexWell Map Preview contract for product patterns interfaces.

Purpose

Provide the governed NexWell Map Preview contract for product patterns interfaces.

Issue #123 is implementation authority; additive to and does not replace the Issue #121 Doctor Card, Healthcare Center Card, or Pricing Plan Card, which remain approved and unchanged. Owner-provided mobile screenshots are composition, hierarchy, and interaction references, not pixel-dimension or mobile-chrome constraints — each variant is itself responsive across desktop, tablet, and mobile Web. Consumers own data fetching, routing policy, supplied status meaning, business rules, geolocation, distance calculation, and commercial semantics; the Design System never fabricates rating, distance, hours, address, or map facts. Map Preview is a provider-neutral render slot and info/attribution surface built on the existing governed Popover and Sheet primitives; the Design System does not choose, render, or lock a map provider. Internal codes and unresolved facts are excluded.

When to use

Use Map Preview only for its documented product patterns purpose.

When not to use

Do not repurpose Map Preview as an unrelated interaction or bypass its tokens.

Anatomy

  1. trigger or container
  2. content
  3. state indicator

Specifications, variants, sizes, and states

Specifications

  • Exact dimensions, padding, gaps, icon sizes, radius, and typography: source-verification-required.
  • Implementation behavior is inspectable below; it is not evidence of founder approval.

Variants and sizes

info control closed · info/attribution panel open

source-verification-required: no governed component-specific size matrix is available

States

normal · info control closed · info/attribution panel open · loading · no-location · unavailable · keyboard focus · RTL · high contrast

Measurements and typography

Every field is represented. A status is not a value: unresolved evidence cannot be converted into an implementation number.

Height / widthsource-verification-requiredNo approved exact value may be inferred.
Paddingsource-verification-requiredNo approved exact value may be inferred.
Gapsource-verification-requiredNo approved exact value may be inferred.
Radius / bordersource-verification-requiredNo approved exact value may be inferred.
Icon sizesource-verification-requiredNo approved exact value may be inferred.
Font / size / weight / line height / trackingsource-verification-requiredNo approved exact value may be inferred.

State matrix

Actual implementation states are listed below. Requested universal states not supported by the component API remain explicitly unclaimed.

Defaultnot-applicable-or-source-verification-required
Hovernot-applicable-or-source-verification-required
FocusImplemented / inspect preview
Active / pressednot-applicable-or-source-verification-required
Disablednot-applicable-or-source-verification-required
LoadingImplemented / inspect preview
Errornot-applicable-or-source-verification-required
Successnot-applicable-or-source-verification-required
Readonlynot-applicable-or-source-verification-required
Emptynot-applicable-or-source-verification-required

React and TypeScript API

Public properties

approved-current Generated from the package registry; controls expose only the supported subset listed here.

staterendermarkerLabelattributioninfoLabeltriggerLabelloadingLabelnoLocationLabelunavailableLabel
import { MapPreview } from "@nexwellaifactory/components";
// state
// render
// markerLabel
// attribution
// infoLabel
// triggerLabel
// loadingLabel
// noLocationLabel
// unavailableLabel

export function Example() {
  return <MapPreview />;
}

Open stable isolated canvas

Usage and content

Do

Use Map Preview with a clear accessible name and evidence-backed behavior.

Don’t

Do not repurpose Map Preview as an unrelated interaction or bypass its tokens.

Content rules

  • Use concise, task-specific labels.
  • Do not communicate state through color alone.
  • Allow localized text to wrap without hiding critical actions.

Accessibility, keyboard, responsive, and RTL

Accessibility

  • Programmatic name
  • Programmatic state
  • Logical focus order
  • No color-only meaning

Keyboard

  • Native behavior where available
  • Arrow-key composite navigation where required
  • Escape dismissal and focus restoration for overlays

Responsive and RTL

Reflows, scrolls, or becomes a bounded overlay without hiding critical actions.

Logical properties; arrow meaning follows spatial direction.

Actual package output

Interactive example

Preview width changes the bounded canvas; use the RTL control below to inspect logical layout.

Token mapping and source evidence

Traceable implementation

Uber-derived structural evidence, adapted through approved NexWell decisions.

semantic colorfoundation spacingfoundation shapefoundation motion

docs/source-audit/component-evidence-matrix.csv :: map-preview

Missing fields in the source remain documented source absence, not requirements invented by the implementation.

Evidence completeness

0 associated local source records. Statuses below come directly from the DS-13 Checkpoint 1 component evidence matrix.

Cross-platform implementation

React / TypeScript: current package API is shown above.

Flutter: source-verification-required — no canonical Flutter API or implementation mapping exists, and this web portal does not infer one.

AI agents: consume approved records only; preserve proposed and unresolved statuses and import the public component instead of recreating it.