@santi020k/lumen 3.0.0 → 4.0.0

package/native-components.json

@@ -452,6 +452,61 @@
         "compose": "LumenScatterChart"
       }
     },
+    {
+      "id": "waterfall-chart",
+      "tier": "shared",
+      "contract": "Signed deltas and explicit total resets with connecting balances; invalid steps fail closed",
+      "accessibility": "Provides labeled axes, a factual summary, and an expandable readable data list",
+      "symbols": {
+        "reactNative": "LumenWaterfallChart",
+        "swiftUI": "LumenWaterfallChart",
+        "compose": "LumenWaterfallChart"
+      }
+    },
+    {
+      "id": "bullet-chart",
+      "tier": "shared",
+      "contract": "Actual-versus-target comparison with optional ordered ranges and a domain that includes zero",
+      "accessibility": "Keeps actual, target, and range boundaries readable with an expandable exact data list; distinguishes missing from zero",
+      "symbols": {
+        "reactNative": "LumenBulletChart",
+        "swiftUI": "LumenBulletChart",
+        "compose": "LumenBulletChart"
+      }
+    },
+    {
+      "id": "lollipop-chart",
+      "tier": "shared",
+      "contract": "Rank categories using a dot and a zero-based stem. Uses a shared zero-inclusive domain and preserves missing measurements.",
+      "accessibility": "Provides visible category values and an expandable exact data list. Outlined and filled dots distinguish paired measurements.",
+      "symbols": {
+        "reactNative": "LumenLollipopChart",
+        "swiftUI": "LumenLollipopChart",
+        "compose": "LumenLollipopChart"
+      }
+    },
+    {
+      "id": "dumbbell-chart",
+      "tier": "shared",
+      "contract": "Compare two measurements per category with connected dots. Uses a shared zero-inclusive domain and preserves missing measurements.",
+      "accessibility": "Provides visible category values and an expandable exact data list. Outlined and filled dots distinguish paired measurements.",
+      "symbols": {
+        "reactNative": "LumenDumbbellChart",
+        "swiftUI": "LumenDumbbellChart",
+        "compose": "LumenDumbbellChart"
+      }
+    },
+    {
+      "id": "histogram",
+      "tier": "shared",
+      "contract": "Explicit numeric bins preserve widths and gaps; unequal widths require count-per-unit density",
+      "accessibility": "Provides labeled axes, a factual summary, and an expandable readable data list",
+      "symbols": {
+        "reactNative": "LumenHistogram",
+        "swiftUI": "LumenHistogram",
+        "compose": "LumenHistogram"
+      }
+    },
     {
       "id": "heatmap",
       "tier": "shared",
@@ -726,13 +781,422 @@
         "swiftUI": "LumenWatchListRow",
         "compose": "LumenWearListRow"
       }
+    },
+    {
+      "id": "time-field",
+      "tier": "shared",
+      "contract": "Controlled local wall-clock selection with optional inclusive same-day bounds and native keyboard or clock input",
+      "accessibility": "Names the field and selected time; cancellation preserves the host value and read-only or disabled fields cannot open selection",
+      "symbols": {
+        "reactNative": "LumenTimeField",
+        "swiftUI": "LumenTimeField",
+        "compose": "LumenTimeField"
+      }
+    },
+    {
+      "id": "autocomplete",
+      "tier": "shared",
+      "contract": "Controlled query and selected value with host-provided results, loading, empty, retry, and disabled option states",
+      "accessibility": "Preserves native editable dropdown focus and selection semantics; announces result status and keeps disabled results unavailable",
+      "symbols": {
+        "reactNative": "LumenAutocomplete",
+        "swiftUI": "LumenAutocomplete",
+        "compose": "LumenAutocomplete"
+      }
+    },
+    {
+      "id": "number-field",
+      "tier": "shared",
+      "contract": "Localized ungrouped decimal drafts with exact BigDecimal steps, inclusive bounds, validation, and read-only state",
+      "accessibility": "Labels the editable field and step actions, exposes validation context, and disables unavailable steps without discarding unfinished input",
+      "symbols": {
+        "reactNative": "LumenNumberField",
+        "swiftUI": "LumenNumberField",
+        "compose": "LumenNumberField"
+      }
+    },
+    {
+      "id": "password-field",
+      "tier": "shared",
+      "contract": "Masked password entry with transient visibility and native autofill hints",
+      "accessibility": "Maintains password semantics, labels visibility actions, and hides on blur or disabled state",
+      "symbols": {
+        "reactNative": "LumenPasswordField",
+        "swiftUI": "LumenPasswordField",
+        "compose": "LumenPasswordField"
+      }
+    },
+    {
+      "id": "input-otp",
+      "tier": "shared",
+      "contract": "Single native numeric one-time code entry with localized digits and paste normalization",
+      "accessibility": "Preserves native selection, paste, autofill, errors, and optional masked semantics",
+      "symbols": {
+        "reactNative": "LumenInputOTP",
+        "swiftUI": "LumenInputOTP",
+        "compose": "LumenInputOTP"
+      }
+    },
+    {
+      "id": "image-comparison",
+      "tier": "shared",
+      "contract": "Painter-based before and after comparison with a controlled visible fraction",
+      "accessibility": "Exposes a named native slider and localized percentage for keyboard and screen-reader adjustment",
+      "symbols": {
+        "reactNative": "LumenImageComparison",
+        "swiftUI": "LumenImageComparison",
+        "compose": "LumenImageComparison"
+      }
+    },
+    {
+      "id": "media-viewport",
+      "tier": "shared",
+      "contract": "Bounded controlled zoom, pan and fit with native gestures and visible actions",
+      "accessibility": "Named zoom state and localized actions remain operable without gestures",
+      "symbols": {
+        "reactNative": "LumenMediaViewport",
+        "swiftUI": "LumenMediaViewport",
+        "compose": "LumenMediaViewport"
+      }
+    },
+    {
+      "id": "media-thumbnail",
+      "tier": "shared",
+      "contract": "Host-controlled media selection with order and loading/error presentation",
+      "accessibility": "Named selected button with disabled and busy semantics",
+      "symbols": {
+        "reactNative": "LumenMediaThumbnail",
+        "swiftUI": "LumenMediaThumbnail",
+        "compose": "LumenMediaThumbnail"
+      }
+    },
+    {
+      "id": "media-filmstrip",
+      "tier": "shared",
+      "contract": "Ordered horizontally scrolling media collection with host-formatted selected count",
+      "accessibility": "Collection label and selection status; host supplies sibling reorder actions",
+      "symbols": {
+        "reactNative": "LumenMediaFilmstrip",
+        "swiftUI": "LumenMediaFilmstrip",
+        "compose": "LumenMediaFilmstrip"
+      }
+    },
+    {
+      "id": "calendar-heatmap",
+      "tier": "shared",
+      "contract": "Shows daily activity on a date-only calendar with explicit missing observations.",
+      "accessibility": "Provides exact values in an accessible expandable data list, localized formatting, and missing-value labels.",
+      "symbols": {
+        "reactNative": "LumenCalendarHeatmap",
+        "swiftUI": "LumenCalendarHeatmap",
+        "compose": "LumenCalendarHeatmap"
+      }
+    },
+    {
+      "id": "funnel-chart",
+      "tier": "shared",
+      "contract": "Compares ordered conversion stages without inferring conversion rates.",
+      "accessibility": "Provides exact values in an accessible expandable data list, localized formatting, and missing-value labels.",
+      "symbols": {
+        "reactNative": "LumenFunnelChart",
+        "swiftUI": "LumenFunnelChart",
+        "compose": "LumenFunnelChart"
+      }
+    },
+    {
+      "id": "box-plot",
+      "tier": "shared",
+      "contract": "Shows precomputed quartiles, whiskers, medians, and outliers on one numeric scale.",
+      "accessibility": "Provides exact values in an accessible expandable data list, localized formatting, and missing-value labels.",
+      "symbols": {
+        "reactNative": "LumenBoxPlot",
+        "swiftUI": "LumenBoxPlot",
+        "compose": "LumenBoxPlot"
+      }
+    },
+    {
+      "id": "range-slider",
+      "tier": "shared",
+      "contract": "Controlled bounded numeric interval with independently adjustable endpoints and native step conventions",
+      "accessibility": "Separately named and formatted lower and upper controls; read-only and disabled states prevent adjustment",
+      "symbols": {
+        "reactNative": "LumenRangeSlider",
+        "swiftUI": "LumenRangeSlider",
+        "compose": "LumenRangeSlider"
+      }
+    },
+    {
+      "id": "multi-select",
+      "tier": "shared",
+      "contract": "Controlled multiple selection with caller-owned search results, chips, validation, loading and retry",
+      "accessibility": "Named native checkbox options, dialog focus, retained selections and disabled or read-only behavior",
+      "symbols": {
+        "reactNative": "LumenMultiSelect",
+        "swiftUI": "LumenMultiSelect",
+        "compose": "LumenMultiSelect"
+      }
+    },
+    {
+      "id": "rating",
+      "tier": "shared",
+      "contract": "Controlled whole-star selection with zero for unrated and host-localized options",
+      "accessibility": "Native radio semantics, selected state, disabled and read-only interaction, and minimum touch targets",
+      "symbols": {
+        "reactNative": "LumenRating",
+        "swiftUI": "LumenRating",
+        "compose": "LumenRating"
+      }
+    },
+    {
+      "id": "stepper",
+      "tier": "shared",
+      "contract": "Host-owned ordered workflow with current, completed and upcoming step states",
+      "accessibility": "Localized state labels and readable vertical or horizontal layouts",
+      "symbols": {
+        "reactNative": "LumenStepper",
+        "swiftUI": "LumenStepper",
+        "compose": "LumenStepper"
+      }
+    },
+    {
+      "id": "timeline",
+      "tier": "shared",
+      "contract": "Chronological rich content with decorative markers and native child controls",
+      "accessibility": "Localized group label and preserved child control semantics",
+      "symbols": {
+        "reactNative": "LumenTimeline",
+        "swiftUI": "LumenTimeline",
+        "compose": "LumenTimeline"
+      }
+    },
+    {
+      "id": "breadcrumb",
+      "tier": "shared",
+      "contract": "Stable ancestor navigation with a noninteractive current destination",
+      "accessibility": "Localized navigation group and current destination, with disabled ancestors",
+      "symbols": {
+        "reactNative": "LumenBreadcrumb",
+        "swiftUI": "LumenBreadcrumb",
+        "compose": "LumenBreadcrumb"
+      }
+    },
+    {
+      "id": "table",
+      "tier": "shared",
+      "contract": "Stable host-formatted rows and columns in record or horizontal column layouts",
+      "accessibility": "Named records, readable native text scaling and explicit loading, error and empty states",
+      "symbols": {
+        "reactNative": "LumenTable",
+        "swiftUI": "LumenTable",
+        "compose": "LumenTable"
+      }
+    },
+    {
+      "id": "data-table",
+      "tier": "shared",
+      "contract": "Controlled sorting and selection; manual server order or explicit stable client sorting",
+      "accessibility": "Localized sort status and selection controls; disabled rows, read-only state and safe status recovery",
+      "symbols": {
+        "reactNative": "LumenDataTable",
+        "swiftUI": "LumenDataTable",
+        "compose": "LumenDataTable"
+      }
+    },
+    {
+      "id": "tree",
+      "tier": "shared",
+      "contract": "Controlled expansion and selection over a validated flat graph with stable sibling order and inherited disabled state",
+      "accessibility": "Localized disclosure and depth, native selection controls, bounded visual indentation and safe status states",
+      "symbols": {
+        "reactNative": "LumenTree",
+        "swiftUI": "LumenTree",
+        "compose": "LumenTree"
+      }
+    },
+    {
+      "id": "qr-code",
+      "tier": "shared",
+      "contract": "Offline UTF-8 QR encoding with correction levels, module quiet zones and safe capacity errors",
+      "accessibility": "Named image value, optional visible text and localized error recovery; scanner-safe contrast",
+      "symbols": {
+        "reactNative": "LumenQRCode",
+        "swiftUI": "LumenQRCode",
+        "compose": "LumenQRCode"
+      }
+    },
+    {
+      "id": "cascader",
+      "tier": "shared",
+      "contract": "Controlled leaf path selection with native branch drill-down over validated stable tree identities",
+      "accessibility": "Localized browse/back actions, selectable leaf controls and disabled/status semantics",
+      "symbols": {
+        "reactNative": "LumenCascader",
+        "swiftUI": "LumenCascader",
+        "compose": "LumenCascader"
+      }
+    },
+    {
+      "id": "calendar",
+      "tier": "shared",
+      "contract": "Controlled Gregorian visible month and selected civil date, bounded navigation and event indicators",
+      "accessibility": "Localized month/day/weekday labels, minimum touch targets, native selected state and explicit result states",
+      "symbols": {
+        "reactNative": "LumenCalendar",
+        "swiftUI": "LumenCalendar",
+        "compose": "LumenCalendar"
+      }
+    },
+    {
+      "id": "agenda",
+      "tier": "shared",
+      "contract": "Controlled civil-day agenda groups with chronological timed and all-day events and host event callbacks",
+      "accessibility": "Localized day, time and status announcements with native event actions",
+      "symbols": {
+        "reactNative": "LumenAgenda",
+        "swiftUI": "LumenAgenda",
+        "compose": "LumenAgenda"
+      }
+    },
+    {
+      "id": "kanban-board",
+      "tier": "shared",
+      "contract": "Controlled stable-ID columns and cards with bounded immutable moves, capacity guards and native dragging",
+      "accessibility": "Localized accessible move alternatives, named cards and safe loading/error/empty states",
+      "symbols": {
+        "reactNative": "LumenKanbanBoard",
+        "swiftUI": "LumenKanbanBoard",
+        "compose": "LumenKanbanBoard"
+      }
+    },
+    {
+      "id": "kanban-column",
+      "tier": "shared",
+      "contract": "Standalone controlled column with rich cards, capacity presentation and immutable card reorder requests",
+      "accessibility": "Native drag and localized accessible reorder actions with disabled and read-only guards",
+      "symbols": {
+        "reactNative": "LumenKanbanColumn",
+        "swiftUI": "LumenKanbanColumn",
+        "compose": "LumenKanbanColumn"
+      }
+    },
+    {
+      "id": "schedule",
+      "tier": "shared",
+      "contract": "Controlled civil-day time grid with all-day bands, collision-safe overlap lanes and host move requests",
+      "accessibility": "Localized event time and day names, accessible move controls and guarded native targets",
+      "symbols": {
+        "reactNative": "LumenSchedule",
+        "swiftUI": "LumenSchedule",
+        "compose": "LumenSchedule"
+      }
+    },
+    {
+      "id": "color-picker",
+      "tier": "shared",
+      "contract": "Controlled RGB/HSV and optional alpha editing with bounded linear color parsing and retained invalid drafts",
+      "accessibility": "Localized channel controls, palette choices and validation with native disabled/read-only guards",
+      "symbols": {
+        "reactNative": "LumenColorPicker",
+        "swiftUI": "LumenColorPicker",
+        "compose": "LumenColorPicker"
+      }
+    },
+    {
+      "id": "tree-select",
+      "tier": "shared",
+      "contract": "Controlled stable-ID hierarchical selection through a lazy disclosure panel over the validated Tree graph",
+      "accessibility": "Localized path and depth names, retained unknown values and inherited disabled ancestry",
+      "symbols": {
+        "reactNative": "LumenTreeSelect",
+        "swiftUI": "LumenTreeSelect",
+        "compose": "LumenTreeSelect"
+      }
+    },
+    {
+      "id": "transfer",
+      "tier": "shared",
+      "contract": "Controlled source/target membership and staged checks with atomic bidirectional moves preserving unavailable IDs",
+      "accessibility": "Localized checked/disabled rows, move counts and safe status guards with native controls",
+      "symbols": {
+        "reactNative": "LumenTransfer",
+        "swiftUI": "LumenTransfer",
+        "compose": "LumenTransfer"
+      }
+    },
+    {
+      "id": "carousel",
+      "tier": "shared",
+      "contract": "Controlled stable-ID slide paging through native scrolling, indicators and bounded previous/next requests",
+      "accessibility": "Localized slide positions, selected indicators and native status/disabled guards",
+      "symbols": {
+        "reactNative": "LumenCarousel",
+        "swiftUI": "LumenCarousel",
+        "compose": "LumenCarousel"
+      }
+    },
+    {
+      "id": "tooltip",
+      "tier": "shared",
+      "contract": "Native contextual help with explicit visibility or platform tooltip state and trigger/dismiss controls",
+      "accessibility": "Named host anchors, localized brief help, native focus/escape/Back dismissal and disabled guards",
+      "symbols": {
+        "reactNative": "LumenTooltip",
+        "swiftUI": "LumenTooltip",
+        "compose": "LumenTooltip"
+      }
+    },
+    {
+      "id": "command",
+      "tier": "shared",
+      "contract": "Controlled grouped command filtering, active identity and guarded host activation",
+      "accessibility": "Native search and keyboard navigation, localized command names and always-available dismissal",
+      "symbols": {
+        "reactNative": "LumenCommand",
+        "swiftUI": "LumenCommand",
+        "compose": "LumenCommand"
+      }
+    },
+    {
+      "id": "tree-grid",
+      "tier": "shared",
+      "contract": "Controlled hierarchical rows and cells over validated Tree graphs with stable column identities",
+      "accessibility": "Named disclosure and full depth, inherited disabled cells and phone record layouts",
+      "symbols": {
+        "reactNative": "LumenTreeGrid",
+        "swiftUI": "LumenTreeGrid",
+        "compose": "LumenTreeGrid"
+      }
+    },
+    {
+      "id": "tour",
+      "tier": "universal",
+      "contract": "Controlled native guided steps anchored to host-measured targets",
+      "accessibility": "Named modal guidance, guarded navigation and always usable dismissal",
+      "symbols": {
+        "reactNative": "LumenTour",
+        "swiftUI": "LumenTour",
+        "compose": "LumenTour"
+      }
+    },
+    {
+      "id": "mentions",
+      "tier": "universal",
+      "contract": "Controlled multiline mention text and UTF-16 selection with literal suggestions",
+      "accessibility": "Named input and guarded enabled suggestions with native composition preservation",
+      "symbols": {
+        "reactNative": "LumenMentions",
+        "swiftUI": "LumenMentions",
+        "compose": "LumenMentions"
+      }
     }
   ],
   "platformComponents": [
     {
       "id": "shortcut-recorder",
       "adapter": "swiftUI",
-      "platforms": ["macOS"],
+      "platforms": [
+        "macOS"
+      ],
       "contract": "Keyboard shortcut capture, validation, clear, and cancel states",
       "accessibility": "Displays the current shortcut and exposes labeled controls",
       "symbol": "LumenShortcutRecorder"
@@ -740,7 +1204,9 @@
     {
       "id": "symbol-picker",
       "adapter": "swiftUI",
-      "platforms": ["macOS"],
+      "platforms": [
+        "macOS"
+      ],
       "contract": "Searchable and categorized SF Symbols selection",
       "accessibility": "Labels every symbol and exposes selected state",
       "symbol": "LumenSymbolPicker"
@@ -748,7 +1214,11 @@
     {
       "id": "link",
       "adapter": "swiftUI",
-      "platforms": ["iOS", "macOS", "visionOS"],
+      "platforms": [
+        "iOS",
+        "macOS",
+        "visionOS"
+      ],
       "contract": "Token-aware URL action backed by SwiftUI native link opening",
       "accessibility": "Preserves the native link role, visible label, focus behavior, and disabled state",
       "symbol": "LumenLink"
@@ -756,7 +1226,9 @@
     {
       "id": "tab-bar-minimization",
       "adapter": "swiftUI",
-      "platforms": ["iOS"],
+      "platforms": [
+        "iOS"
+      ],
       "contract": "Availability-safe native tab-bar minimization with automatic, never, and scroll-direction policies",
       "accessibility": "Delegates motion, safe-area, focus, and reduced-motion behavior to the native SwiftUI tab bar",
       "symbol": "lumenTabBarMinimizeBehavior"
@@ -764,7 +1236,9 @@
     {
       "id": "tab-accessory",
       "adapter": "swiftUI",
-      "platforms": ["iOS"],
+      "platforms": [
+        "iOS"
+      ],
       "contract": "Adaptive expanded and compact content above or inline with a native tab bar",
       "accessibility": "Preserves the semantics of application-owned accessory content across native placements",
       "symbol": "LumenTabAccessory"
@@ -772,7 +1246,10 @@
     {
       "id": "refresh-control",
       "adapter": "reactNative",
-      "platforms": ["iOS", "Android"],
+      "platforms": [
+        "iOS",
+        "Android"
+      ],
       "contract": "Native pull-to-refresh state with semantic indicator colors",
       "accessibility": "Preserves native refresh gestures and exposes the application-provided loading label",
       "symbol": "LumenRefreshControl"
@@ -780,7 +1257,10 @@
     {
       "id": "collapsible-navigation-bar",
       "adapter": "reactNative",
-      "platforms": ["iOS", "Android"],
+      "platforms": [
+        "iOS",
+        "Android"
+      ],
       "contract": "Animated bottom navigation that hides after forward scroll travel and reveals on reverse travel or at the top",
       "accessibility": "Removes hidden destinations from interaction and the accessibility tree while preserving native list ownership",
       "symbol": "LumenCollapsibleNavigationBar"
@@ -788,7 +1268,10 @@
     {
       "id": "navigation-accessory",
       "adapter": "reactNative",
-      "platforms": ["iOS", "Android"],
+      "platforms": [
+        "iOS",
+        "Android"
+      ],
       "contract": "Compact status or action content above a React Native bottom navigation bar",
       "accessibility": "Preserves the semantics of application-owned accessory content and collapses with hidden navigation",
       "symbol": "LumenNavigationAccessory"
@@ -796,7 +1279,9 @@
     {
       "id": "navigation-bar-scroll-behavior",
       "adapter": "compose",
-      "platforms": ["Android"],
+      "platforms": [
+        "Android"
+      ],
       "contract": "Threshold-based nested-scroll visibility state for a Material navigation bar",
       "accessibility": "Stops exposing the navigation bar after its exit transition without consuming descendant scroll input",
       "symbol": "LumenNavigationBarScrollState"
@@ -804,7 +1289,9 @@
     {
       "id": "navigation-bar-accessory",
       "adapter": "compose",
-      "platforms": ["Android"],
+      "platforms": [
+        "Android"
+      ],
       "contract": "Compact token-aware content above Material bottom navigation coordinated with its scroll visibility",
       "accessibility": "Preserves application-owned child semantics and exits the layout with hidden navigation",
       "symbol": "LumenNavigationBarAccessory"
@@ -812,7 +1299,9 @@
     {
       "id": "adaptive-navigation-scaffold",
       "adapter": "compose",
-      "platforms": ["Android"],
+      "platforms": [
+        "Android"
+      ],
       "contract": "Material adaptive navigation that switches between bottom bar and rail from window size and device posture",
       "accessibility": "Uses Material navigation semantics while preserving application-owned destination content and routing",
       "symbol": "LumenAdaptiveNavigationScaffold"
@@ -820,7 +1309,9 @@
     {
       "id": "floating-action-button",
       "adapter": "compose",
-      "platforms": ["Android"],
+      "platforms": [
+        "Android"
+      ],
       "contract": "Material-native floating action with semantic intent, sizing, and optional hide or follow-navigation behavior",
       "accessibility": "Requires a readable icon action description and preserves native button semantics",
       "symbol": "LumenFloatingActionButton"
@@ -828,7 +1319,11 @@
     {
       "id": "widget-text",
       "adapter": "swiftUI",
-      "platforms": ["iOS", "macOS", "watchOS"],
+      "platforms": [
+        "iOS",
+        "macOS",
+        "watchOS"
+      ],
       "contract": "WidgetKit-safe semantic text with native Dynamic Type and rendering-mode adaptation",
       "accessibility": "Preserves localized or verbatim text and native text scaling",
       "symbol": "LumenWidgetText"
@@ -836,7 +1331,11 @@
     {
       "id": "widget-icon",
       "adapter": "swiftUI",
-      "platforms": ["iOS", "macOS", "watchOS"],
+      "platforms": [
+        "iOS",
+        "macOS",
+        "watchOS"
+      ],
       "contract": "WidgetKit-safe SF Symbol treatment with semantic tone and optional label",
       "accessibility": "Decorative by default and labeled when it conveys meaning",
       "symbol": "LumenWidgetIcon"
@@ -844,7 +1343,11 @@
     {
       "id": "widget-badge",
       "adapter": "swiftUI",
-      "platforms": ["iOS", "macOS", "watchOS"],
+      "platforms": [
+        "iOS",
+        "macOS",
+        "watchOS"
+      ],
       "contract": "Compact rendering-mode-aware status badge with optional symbol",
       "accessibility": "Combines the icon and text into one concise status value",
       "symbol": "LumenWidgetBadge"
@@ -852,10 +1355,54 @@
     {
       "id": "widget-compact-stat",
       "adapter": "swiftUI",
-      "platforms": ["iOS", "macOS", "watchOS"],
+      "platforms": [
+        "iOS",
+        "macOS",
+        "watchOS"
+      ],
       "contract": "Compact WidgetKit label and metric treatment with optional semantic icon",
       "accessibility": "Combines the label and value while preserving large-text scaling",
       "symbol": "LumenWidgetCompactStat"
+    },
+    {
+      "id": "pull-to-refresh",
+      "adapter": "compose",
+      "platforms": [
+        "Android"
+      ],
+      "contract": "Material refresh gesture with host-owned progress and request lifecycle around existing scrollable content",
+      "accessibility": "Adds a named refresh accessibility action, announces progress, and removes refresh actions while disabled or refreshing",
+      "symbol": "LumenPullToRefresh"
+    },
+    {
+      "id": "top-app-bar",
+      "adapter": "compose",
+      "platforms": [
+        "Android"
+      ],
+      "contract": "Material app bar with named navigation and actions plus pinned or collapsing scroll behavior",
+      "accessibility": "Heading semantics, native window insets, and application-owned navigation",
+      "symbol": "LumenTopAppBar"
+    },
+    {
+      "id": "swipe-actions",
+      "adapter": "compose",
+      "platforms": [
+        "Android"
+      ],
+      "contract": "Logical start and end list actions with transient gesture state and application-owned operations",
+      "accessibility": "RTL-aware gestures, named custom accessibility actions, visible keyboard buttons, and disabled states",
+      "symbol": "LumenSwipeActions"
+    },
+    {
+      "id": "adaptive-list-detail-scaffold",
+      "adapter": "compose",
+      "platforms": [
+        "Android"
+      ],
+      "contract": "Material full-window list/detail panes adapting to window size and separating hinges",
+      "accessibility": "Named panes, compact back action, and application-owned selection and system back handling",
+      "symbol": "LumenAdaptiveListDetailScaffold"
     }
   ]
 }