@santi020k/lumen 1.6.0 → 1.7.0

package/native-components.json

@@ -0,0 +1,861 @@
+{
+  "schemaVersion": 5,
+  "adapters": {
+    "reactNative": {
+      "package": "@santi020k/lumen-react-native",
+      "sourceDirectory": "packages/react-native/src",
+      "publicEntrypoints": [
+        "index.ts",
+        "datetime.ts"
+      ]
+    },
+    "swiftUI": {
+      "package": "LumenUI",
+      "sourceDirectory": "packages/swift/Sources/LumenUI",
+      "additionalSourceDirectories": [
+        "packages/swift-widget/Sources/LumenWidgetUI"
+      ]
+    },
+    "compose": {
+      "package": "com.santi020k:lumen-compose",
+      "sourceDirectory": "packages/compose/src/main/kotlin/com/santi020k/lumen",
+      "additionalSourceDirectories": [
+        "packages/compose/wear/src/main/kotlin/com/santi020k/lumen/wear"
+      ],
+      "toolchain": {
+        "androidGradlePlugin": "9.3.1",
+        "compileSdk": 37,
+        "gradle": "9.7.1",
+        "instrumentationApi": 35,
+        "jdk": 21,
+        "kotlin": "2.4.10",
+        "minSdk": 23
+      }
+    }
+  },
+  "components": [
+    {
+      "id": "theme",
+      "tier": "universal",
+      "contract": "Light and dark semantic foundations",
+      "accessibility": "Preserves platform environment preferences",
+      "symbols": {
+        "reactNative": "LumenProvider",
+        "swiftUI": "LumenTheme",
+        "compose": "LumenTheme"
+      }
+    },
+    {
+      "id": "text",
+      "tier": "universal",
+      "contract": "Body, caption, label, and title roles",
+      "accessibility": "Preserves native text scaling",
+      "symbols": {
+        "reactNative": "LumenText",
+        "swiftUI": "LumenText",
+        "compose": "LumenText"
+      }
+    },
+    {
+      "id": "icon",
+      "tier": "universal",
+      "contract": "Complete shared Lucide and namespaced brand artwork with native escape hatches at small, medium, and large sizes",
+      "accessibility": "Decorative unless explicitly labeled",
+      "symbols": {
+        "reactNative": "LumenIcon",
+        "swiftUI": "LumenIcon",
+        "compose": "LumenIcon"
+      }
+    },
+    {
+      "id": "icon-button",
+      "tier": "universal",
+      "contract": "Shared intent and native touch target",
+      "accessibility": "Requires an action label",
+      "symbols": {
+        "reactNative": "LumenIconButton",
+        "swiftUI": "LumenIconButton",
+        "compose": "LumenIconButton"
+      }
+    },
+    {
+      "id": "surface",
+      "tier": "universal",
+      "contract": "Semantic tone, padding, and radius",
+      "accessibility": "Does not add redundant semantics",
+      "symbols": {
+        "reactNative": "LumenSurface",
+        "swiftUI": "LumenSurface",
+        "compose": "LumenSurface"
+      }
+    },
+    {
+      "id": "button",
+      "tier": "universal",
+      "contract": "Intent, size, loading, and disabled states",
+      "accessibility": "Exposes native button and state semantics",
+      "symbols": {
+        "reactNative": "LumenButton",
+        "swiftUI": "LumenButton",
+        "compose": "LumenButton"
+      }
+    },
+    {
+      "id": "text-field",
+      "tier": "universal",
+      "contract": "Native text entry with error and disabled states",
+      "accessibility": "Exposes invalid and supporting error state",
+      "symbols": {
+        "reactNative": "LumenTextField",
+        "swiftUI": "LumenTextField",
+        "compose": "LumenTextField"
+      }
+    },
+    {
+      "id": "textarea",
+      "tier": "shared",
+      "contract": "Multiline native text entry with supporting and error states",
+      "accessibility": "Preserves native multiline editing and exposes its visible label and error context",
+      "symbols": {
+        "reactNative": "LumenTextarea",
+        "swiftUI": "LumenTextarea",
+        "compose": "LumenTextarea"
+      }
+    },
+    {
+      "id": "field-group",
+      "tier": "shared",
+      "contract": "Label, description, required state, control content, and validation message",
+      "accessibility": "Keeps child control semantics independent while presenting readable field context",
+      "symbols": {
+        "reactNative": "LumenFieldGroup",
+        "swiftUI": "LumenFieldGroup",
+        "compose": "LumenFieldGroup"
+      }
+    },
+    {
+      "id": "toggle",
+      "tier": "shared",
+      "contract": "Native switch behavior with visible label and disabled state",
+      "accessibility": "Exposes native switch state and a readable label",
+      "symbols": {
+        "reactNative": "LumenToggle",
+        "swiftUI": "LumenToggle",
+        "compose": "LumenToggle"
+      }
+    },
+    {
+      "id": "settings-row",
+      "tier": "shared",
+      "contract": "Title, supporting text, optional graphic, and trailing control",
+      "accessibility": "Contains the native control without merging its interaction",
+      "symbols": {
+        "reactNative": "LumenSettingsRow",
+        "swiftUI": "LumenSettingsRow",
+        "compose": "LumenSettingsRow"
+      }
+    },
+    {
+      "id": "search-field",
+      "tier": "shared",
+      "contract": "Native search input with semantic surface and clear action",
+      "accessibility": "Labels the input and clear action while preserving native editing",
+      "symbols": {
+        "reactNative": "LumenSearchField",
+        "swiftUI": "LumenSearchField",
+        "compose": "LumenSearchField"
+      }
+    },
+    {
+      "id": "date-field",
+      "tier": "shared",
+      "contract": "Native date selection with controlled values, bounds, supporting text, and validation messaging",
+      "accessibility": "Keeps validation context on the actionable control and dismisses adapter-owned selection UI when disabled",
+      "symbols": {
+        "reactNative": "LumenDateField",
+        "swiftUI": "LumenDateField",
+        "compose": "LumenDateField"
+      }
+    },
+    {
+      "id": "date-range-field",
+      "tier": "shared",
+      "contract": "Inclusive native start and end date selection with bounds and coordinated range validation",
+      "accessibility": "Labels the range and native date controls while preventing an end date before the start date",
+      "symbols": {
+        "reactNative": "LumenDateRangeField",
+        "swiftUI": "LumenDateRangeField",
+        "compose": "LumenDateRangeField"
+      }
+    },
+    {
+      "id": "phone-input",
+      "tier": "shared",
+      "contract": "Searchable localized country selection with calling codes, as-you-type formatting, metadata-backed validation, and E.164 output",
+      "accessibility": "Names the country selector and phone editor, exposes validation on the editor, and dismisses country selection when disabled",
+      "symbols": {
+        "reactNative": "LumenPhoneInput",
+        "swiftUI": "LumenPhoneInput",
+        "compose": "LumenPhoneInput"
+      }
+    },
+    {
+      "id": "checkbox",
+      "tier": "shared",
+      "contract": "Controlled Boolean selection with visible label and optional supporting text",
+      "accessibility": "Exposes native checkbox state, disabled state, and a readable label",
+      "symbols": {
+        "reactNative": "LumenCheckbox",
+        "swiftUI": "LumenCheckbox",
+        "compose": "LumenCheckbox"
+      }
+    },
+    {
+      "id": "radio-group",
+      "tier": "shared",
+      "contract": "Single selection from labeled options with optional supporting text",
+      "accessibility": "Exposes a named native radio group and selected or disabled option states",
+      "symbols": {
+        "reactNative": "LumenRadioGroup",
+        "swiftUI": "LumenRadioGroup",
+        "compose": "LumenRadioGroup"
+      }
+    },
+    {
+      "id": "segmented-control",
+      "tier": "shared",
+      "contract": "Compact single selection from a small set of peer options",
+      "accessibility": "Exposes a named single-selection group and selected or disabled segment states",
+      "symbols": {
+        "reactNative": "LumenSegmentedControl",
+        "swiftUI": "LumenSegmentedControl",
+        "compose": "LumenSegmentedControl"
+      }
+    },
+    {
+      "id": "tabs",
+      "tier": "shared",
+      "contract": "Controlled tab selection with a named tab list and active native content panel",
+      "accessibility": "Exposes selected and disabled tab states and names the active panel",
+      "symbols": {
+        "reactNative": "LumenTabs",
+        "swiftUI": "LumenTabs",
+        "compose": "LumenTabs"
+      }
+    },
+    {
+      "id": "chip",
+      "tier": "shared",
+      "contract": "Compact display, selection, and removal with semantic selected and disabled states",
+      "accessibility": "Separates selection and removal actions while exposing selected and disabled state",
+      "symbols": {
+        "reactNative": "LumenChip",
+        "swiftUI": "LumenChip",
+        "compose": "LumenChip"
+      }
+    },
+    {
+      "id": "button-group",
+      "tier": "shared",
+      "contract": "Horizontal or vertical layout for a small set of related actions",
+      "accessibility": "Contains native buttons without merging their independent action names",
+      "symbols": {
+        "reactNative": "LumenButtonGroup",
+        "swiftUI": "LumenButtonGroup",
+        "compose": "LumenButtonGroup"
+      }
+    },
+    {
+      "id": "badge",
+      "tier": "universal",
+      "contract": "Neutral and semantic status tones",
+      "accessibility": "Retains its text content",
+      "symbols": {
+        "reactNative": "LumenBadge",
+        "swiftUI": "LumenBadge",
+        "compose": "LumenBadge"
+      }
+    },
+    {
+      "id": "divider",
+      "tier": "universal",
+      "contract": "One-unit semantic separator",
+      "accessibility": "Hidden as decorative structure",
+      "symbols": {
+        "reactNative": "LumenDivider",
+        "swiftUI": "LumenDivider",
+        "compose": "LumenDivider"
+      }
+    },
+    {
+      "id": "spinner",
+      "tier": "universal",
+      "contract": "Brand-colored indeterminate activity",
+      "accessibility": "Exposes a loading label",
+      "symbols": {
+        "reactNative": "LumenSpinner",
+        "swiftUI": "LumenSpinner",
+        "compose": "LumenSpinner"
+      }
+    },
+    {
+      "id": "card",
+      "tier": "shared",
+      "contract": "Neutral or semantic container with optional native action",
+      "accessibility": "Interactive form exposes native button semantics",
+      "symbols": {
+        "reactNative": "LumenCard",
+        "swiftUI": "LumenCard",
+        "compose": "LumenCard"
+      }
+    },
+    {
+      "id": "alert",
+      "tier": "shared",
+      "contract": "Default, destructive, success, and warning variants",
+      "accessibility": "Does not announce automatically",
+      "symbols": {
+        "reactNative": "LumenAlert",
+        "swiftUI": "LumenAlert",
+        "compose": "LumenAlert"
+      }
+    },
+    {
+      "id": "toast",
+      "tier": "shared",
+      "contract": "App-controlled transient feedback with semantic tone, optional action, and dismissal",
+      "accessibility": "Announces concise status while preserving independent action and dismissal controls",
+      "symbols": {
+        "reactNative": "LumenToast",
+        "swiftUI": "LumenToast",
+        "compose": "LumenToast"
+      }
+    },
+    {
+      "id": "progress",
+      "tier": "shared",
+      "contract": "Determinate normalized value and maximum",
+      "accessibility": "Exposes native progress range semantics",
+      "symbols": {
+        "reactNative": "LumenProgress",
+        "swiftUI": "LumenProgress",
+        "compose": "LumenProgress"
+      }
+    },
+    {
+      "id": "skeleton",
+      "tier": "shared",
+      "contract": "Text, rectangle, and circle loading placeholders with normalized dimensions",
+      "accessibility": "Decorative by default or exposes a labeled indeterminate loading state",
+      "symbols": {
+        "reactNative": "LumenSkeleton",
+        "swiftUI": "LumenSkeleton",
+        "compose": "LumenSkeleton"
+      }
+    },
+    {
+      "id": "graphic",
+      "tier": "shared",
+      "contract": "Token-aware glow, grid, and orbit presets around application-provided artwork",
+      "accessibility": "Decorative by default or exposed as one labeled image",
+      "symbols": {
+        "reactNative": "LumenGraphic",
+        "swiftUI": "LumenGraphic",
+        "compose": "LumenGraphic"
+      }
+    },
+    {
+      "id": "backdrop",
+      "tier": "shared",
+      "contract": "Ambient aurora, dots, grid, and rays behind application content with semantic tones and intensity",
+      "accessibility": "The decorative layer stays hidden while child content preserves its native semantics",
+      "symbols": {
+        "reactNative": "LumenBackdrop",
+        "swiftUI": "LumenBackdrop",
+        "compose": "LumenBackdrop"
+      }
+    },
+    {
+      "id": "illustration",
+      "tier": "shared",
+      "contract": "Built-in empty, success, error, and offline scenes with shared semantic colors and sizes",
+      "accessibility": "Decorative by default or exposed as one labeled image",
+      "symbols": {
+        "reactNative": "LumenIllustration",
+        "swiftUI": "LumenIllustration",
+        "compose": "LumenIllustration"
+      }
+    },
+    {
+      "id": "image",
+      "tier": "shared",
+      "contract": "Native image source or content with shared contain and cover fitting, aspect ratio, radius, and labeling",
+      "accessibility": "Decorative by default or exposed as one labeled image",
+      "symbols": {
+        "reactNative": "LumenImage",
+        "swiftUI": "LumenImage",
+        "compose": "LumenImage"
+      }
+    },
+    {
+      "id": "sparkline",
+      "tier": "shared",
+      "contract": "Compact tokenized trend line with optional area fill",
+      "accessibility": "Presents one concise image label without exposing decorative marks",
+      "symbols": {
+        "reactNative": "LumenSparkline",
+        "swiftUI": "LumenSparkline",
+        "compose": "LumenSparkline"
+      }
+    },
+    {
+      "id": "line-chart",
+      "tier": "shared",
+      "contract": "Multi-series categorical, numeric, or temporal line and area visualization",
+      "accessibility": "Provides a factual summary and navigable fallback data while decorative marks remain hidden",
+      "symbols": {
+        "reactNative": "LumenLineChart",
+        "swiftUI": "LumenLineChart",
+        "compose": "LumenLineChart"
+      }
+    },
+    {
+      "id": "bar-chart",
+      "tier": "shared",
+      "contract": "Grouped or stacked categorical magnitude comparison",
+      "accessibility": "Provides a factual summary and navigable fallback data while decorative marks remain hidden",
+      "symbols": {
+        "reactNative": "LumenBarChart",
+        "swiftUI": "LumenBarChart",
+        "compose": "LumenBarChart"
+      }
+    },
+    {
+      "id": "pie-chart",
+      "tier": "shared",
+      "contract": "Small positive part-to-whole breakdown as a pie or donut",
+      "accessibility": "Provides a factual summary and navigable fallback data while decorative marks remain hidden",
+      "symbols": {
+        "reactNative": "LumenPieChart",
+        "swiftUI": "LumenPieChart",
+        "compose": "LumenPieChart"
+      }
+    },
+    {
+      "id": "scatter-chart",
+      "tier": "shared",
+      "contract": "Numeric scatter and bubble relationships with tokenized series tones",
+      "accessibility": "Provides a factual summary and readable fallback data while decorative marks remain hidden",
+      "symbols": {
+        "reactNative": "LumenScatterChart",
+        "swiftUI": "LumenScatterChart",
+        "compose": "LumenScatterChart"
+      }
+    },
+    {
+      "id": "heatmap",
+      "tier": "shared",
+      "contract": "Two-dimensional matrix encoded with a canonical sequential color scale",
+      "accessibility": "Presents a concise summary while applications retain labels for every cell",
+      "symbols": {
+        "reactNative": "LumenHeatmap",
+        "swiftUI": "LumenHeatmap",
+        "compose": "LumenHeatmap"
+      }
+    },
+    {
+      "id": "range-chart",
+      "tier": "shared",
+      "contract": "Ordered low-to-high intervals rendered as a tokenized range band",
+      "accessibility": "Presents a concise summary while applications retain low and high values",
+      "symbols": {
+        "reactNative": "LumenRangeChart",
+        "swiftUI": "LumenRangeChart",
+        "compose": "LumenRangeChart"
+      }
+    },
+    {
+      "id": "combo-chart",
+      "tier": "shared",
+      "contract": "Mixed bar, line, and area series on one shared value domain",
+      "accessibility": "Provides a factual summary and readable fallback data while decorative marks remain hidden",
+      "symbols": {
+        "reactNative": "LumenComboChart",
+        "swiftUI": "LumenComboChart",
+        "compose": "LumenComboChart"
+      }
+    },
+    {
+      "id": "disclosure",
+      "tier": "shared",
+      "contract": "Controlled progressive disclosure with title, supporting text, and native content",
+      "accessibility": "The trigger exposes expanded and disabled state while collapsed content leaves the tree",
+      "symbols": {
+        "reactNative": "LumenDisclosure",
+        "swiftUI": "LumenDisclosure",
+        "compose": "LumenDisclosure"
+      }
+    },
+    {
+      "id": "avatar",
+      "tier": "shared",
+      "contract": "Native image, fallback, label, and shared sizes",
+      "accessibility": "Decorative unless identity is labeled",
+      "symbols": {
+        "reactNative": "LumenAvatar",
+        "swiftUI": "LumenAvatar",
+        "compose": "LumenAvatar"
+      }
+    },
+    {
+      "id": "empty-state",
+      "tier": "shared",
+      "contract": "Title, supporting copy, optional graphic, and recovery actions",
+      "accessibility": "Retains readable content and native action order",
+      "symbols": {
+        "reactNative": "LumenEmptyState",
+        "swiftUI": "LumenEmptyState",
+        "compose": "LumenEmptyState"
+      }
+    },
+    {
+      "id": "error-state",
+      "tier": "shared",
+      "contract": "Error or offline context with layouts, safe reference, and recovery actions",
+      "accessibility": "Preserves heading and action order with platform-native announcement ownership",
+      "symbols": {
+        "reactNative": "LumenErrorState",
+        "swiftUI": "LumenErrorState",
+        "compose": "LumenErrorState"
+      }
+    },
+    {
+      "id": "list-row",
+      "tier": "shared",
+      "contract": "Leading identity, flexible content, and trailing actions",
+      "accessibility": "Contains child controls without collapsing their semantics",
+      "symbols": {
+        "reactNative": "LumenListRow",
+        "swiftUI": "LumenListRow",
+        "compose": "LumenListRow"
+      }
+    },
+    {
+      "id": "banner",
+      "tier": "shared",
+      "contract": "Semantic notice with optional actions and dismissal",
+      "accessibility": "Does not announce automatically and labels dismissal",
+      "symbols": {
+        "reactNative": "LumenBanner",
+        "swiftUI": "LumenBanner",
+        "compose": "LumenBanner"
+      }
+    },
+    {
+      "id": "stat",
+      "tier": "shared",
+      "contract": "Compact semantic metric with label, value, and detail",
+      "accessibility": "Combines the metric into one readable element",
+      "symbols": {
+        "reactNative": "LumenStat",
+        "swiftUI": "LumenStat",
+        "compose": "LumenStat"
+      }
+    },
+    {
+      "id": "section-header",
+      "tier": "shared",
+      "contract": "Section identity, optional count, and trailing actions",
+      "accessibility": "Preserves action semantics and readable heading content",
+      "symbols": {
+        "reactNative": "LumenSectionHeader",
+        "swiftUI": "LumenSectionHeader",
+        "compose": "LumenSectionHeader"
+      }
+    },
+    {
+      "id": "status-bar",
+      "tier": "shared",
+      "contract": "Compact semantic status with optional trailing content",
+      "accessibility": "Status meaning remains present in text, not color alone",
+      "symbols": {
+        "reactNative": "LumenStatusBar",
+        "swiftUI": "LumenStatusBar",
+        "compose": "LumenStatusBar"
+      }
+    },
+    {
+      "id": "picker",
+      "tier": "shared",
+      "contract": "Native single-value selection using platform-appropriate menu or picker presentation, disabled when no options are available",
+      "accessibility": "Preserves native selection behavior, reports the selected value, and dismisses adapter-owned selection UI when disabled",
+      "symbols": {
+        "reactNative": "LumenPicker",
+        "swiftUI": "LumenPicker",
+        "compose": "LumenPicker"
+      }
+    },
+    {
+      "id": "slider",
+      "tier": "shared",
+      "contract": "Continuous or stepped range input with visible formatted value context",
+      "accessibility": "Preserves native adjustable semantics and reports the formatted current value",
+      "symbols": {
+        "reactNative": "LumenSlider",
+        "swiftUI": "LumenSlider",
+        "compose": "LumenSlider"
+      }
+    },
+    {
+      "id": "gauge",
+      "tier": "shared",
+      "contract": "Clamped circular metric with a formatted accessible value",
+      "accessibility": "Exposes a label, normalized range, and formatted current value",
+      "symbols": {
+        "reactNative": "LumenGauge",
+        "swiftUI": "LumenGauge",
+        "compose": "LumenGauge"
+      }
+    },
+    {
+      "id": "alert-dialog",
+      "tier": "shared",
+      "contract": "Controlled confirmation with cancel, confirm, destructive, disabled, and loading states",
+      "accessibility": "Uses native modal focus, alert semantics, and independently named actions",
+      "symbols": {
+        "reactNative": "LumenAlertDialog",
+        "swiftUI": "lumenAlertDialog",
+        "compose": "LumenAlertDialog"
+      }
+    },
+    {
+      "id": "sheet",
+      "tier": "shared",
+      "contract": "Controlled supplemental surface with optional heading, description, actions, and native dismissal",
+      "accessibility": "Uses native modal focus containment and preserves application content semantics",
+      "symbols": {
+        "reactNative": "LumenSheet",
+        "swiftUI": "lumenSheet",
+        "compose": "LumenSheet"
+      }
+    },
+    {
+      "id": "menu",
+      "tier": "shared",
+      "contract": "Anchored action menu with labeled disabled and destructive item states",
+      "accessibility": "Exposes native menu roles, expanded state, and independently named actions",
+      "symbols": {
+        "reactNative": "LumenMenu",
+        "swiftUI": "LumenMenu",
+        "compose": "LumenMenu"
+      }
+    },
+    {
+      "id": "share-button",
+      "tier": "shared",
+      "contract": "Token-aware button that presents the operating system share surface for application-owned content",
+      "accessibility": "Retains native button semantics and delegates destination selection to the operating system",
+      "symbols": {
+        "reactNative": "LumenShareButton",
+        "swiftUI": "LumenShareButton",
+        "compose": "LumenShareButton"
+      }
+    },
+    {
+      "id": "navigation-bar",
+      "tier": "shared",
+      "contract": "Controlled selection from peer app destinations with re-selection callbacks and optional dot, text, or count badges",
+      "accessibility": "Names the destination group and exposes selected, disabled, and badge status without relying on color alone",
+      "symbols": {
+        "reactNative": "LumenNavigationBar",
+        "swiftUI": "LumenNavigationBar",
+        "compose": "LumenNavigationBar"
+      }
+    },
+    {
+      "id": "wearable-action",
+      "tier": "shared",
+      "formFactor": "wearable",
+      "contract": "At-a-glance round primary action with semantic intent, disabled state, and wearable sizing",
+      "accessibility": "Requires a concise action label and preserves native button semantics",
+      "symbols": {
+        "swiftUI": "LumenWatchActionButton",
+        "compose": "LumenWearActionButton"
+      }
+    },
+    {
+      "id": "wearable-progress",
+      "tier": "shared",
+      "formFactor": "wearable",
+      "contract": "Clamped circular progress surrounding app-owned wearable content",
+      "accessibility": "Exposes a normalized progress range without duplicating inner content",
+      "symbols": {
+        "swiftUI": "LumenWatchProgressRing",
+        "compose": "LumenWearProgressRing"
+      }
+    },
+    {
+      "id": "wearable-status",
+      "tier": "shared",
+      "formFactor": "wearable",
+      "contract": "Compact text-first wearable status using semantic tone",
+      "accessibility": "Keeps status meaning in text rather than color alone",
+      "symbols": {
+        "swiftUI": "LumenWatchStatus",
+        "compose": "LumenWearStatus"
+      }
+    },
+    {
+      "id": "wearable-metric",
+      "tier": "shared",
+      "formFactor": "wearable",
+      "contract": "At-a-glance wearable label, value, and optional detail",
+      "accessibility": "Presents the metric as one concise readable unit",
+      "symbols": {
+        "swiftUI": "LumenWatchMetric",
+        "compose": "LumenWearMetric"
+      }
+    },
+    {
+      "id": "wearable-list-row",
+      "tier": "shared",
+      "formFactor": "wearable",
+      "contract": "Compact wearable row with flexible leading, content, and trailing slots",
+      "accessibility": "Preserves child action semantics and readable traversal order",
+      "symbols": {
+        "swiftUI": "LumenWatchListRow",
+        "compose": "LumenWearListRow"
+      }
+    }
+  ],
+  "platformComponents": [
+    {
+      "id": "shortcut-recorder",
+      "adapter": "swiftUI",
+      "platforms": ["macOS"],
+      "contract": "Keyboard shortcut capture, validation, clear, and cancel states",
+      "accessibility": "Displays the current shortcut and exposes labeled controls",
+      "symbol": "LumenShortcutRecorder"
+    },
+    {
+      "id": "symbol-picker",
+      "adapter": "swiftUI",
+      "platforms": ["macOS"],
+      "contract": "Searchable and categorized SF Symbols selection",
+      "accessibility": "Labels every symbol and exposes selected state",
+      "symbol": "LumenSymbolPicker"
+    },
+    {
+      "id": "link",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "tab-bar-minimization",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "tab-accessory",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "refresh-control",
+      "adapter": "reactNative",
+      "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"
+    },
+    {
+      "id": "collapsible-navigation-bar",
+      "adapter": "reactNative",
+      "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"
+    },
+    {
+      "id": "navigation-accessory",
+      "adapter": "reactNative",
+      "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"
+    },
+    {
+      "id": "navigation-bar-scroll-behavior",
+      "adapter": "compose",
+      "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"
+    },
+    {
+      "id": "navigation-bar-accessory",
+      "adapter": "compose",
+      "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"
+    },
+    {
+      "id": "adaptive-navigation-scaffold",
+      "adapter": "compose",
+      "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"
+    },
+    {
+      "id": "floating-action-button",
+      "adapter": "compose",
+      "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"
+    },
+    {
+      "id": "widget-text",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "widget-icon",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "widget-badge",
+      "adapter": "swiftUI",
+      "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"
+    },
+    {
+      "id": "widget-compact-stat",
+      "adapter": "swiftUI",
+      "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"
+    }
+  ]
+}