react-native-platform-components 0.9.0 → 1.0.0

package/android/src/main/java/com/platformcomponents/PCDatePickerView.kt

@@ -465,7 +465,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
       addView(picker)
     }
 
-    val dlg = AlertDialog.Builder(act)
+    val dlg = AlertDialog.Builder(PCThemeSupport.appCompatDialogContext(act, "DatePicker"))
       .setTitle(androidDialogTitle ?: "")
       .setView(container)
       .setPositiveButton(androidPositiveTitle ?: "OK") { _, _ ->
@@ -513,7 +513,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
       }
     }
 
-    val dlg = AlertDialog.Builder(act)
+    val dlg = AlertDialog.Builder(PCThemeSupport.appCompatDialogContext(act, "DatePicker"))
       .setTitle(androidDialogTitle ?: "")
       .setView(picker)
       .setPositiveButton(androidPositiveTitle ?: "OK") { _, _ ->
@@ -580,7 +580,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
       addView(picker)
     }
 
-    val dlg = AlertDialog.Builder(act)
+    val dlg = AlertDialog.Builder(PCThemeSupport.appCompatDialogContext(act, "DatePicker"))
       .setTitle(androidDialogTitle ?: "")
       .setView(container)
       .setPositiveButton(androidPositiveTitle ?: "Next") { _, _ ->
@@ -617,6 +617,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
 
     val builder = MaterialDatePicker.Builder.datePicker()
       .setSelection(ts)
+      .setTheme(m3CalendarTheme(act))
 
     androidDialogTitle?.let { builder.setTitleText(it) }
     androidPositiveTitle?.let { builder.setPositiveButtonText(it) }
@@ -660,6 +661,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
 
     val is24 = android.text.format.DateFormat.is24HourFormat(act)
     val builder = MaterialTimePicker.Builder()
+      .setTheme(m3TimePickerTheme(act))
       .setTimeFormat(if (is24) TimeFormat.CLOCK_24H else TimeFormat.CLOCK_12H)
       .setHour(cal.get(Calendar.HOUR_OF_DAY))
       .setMinute(cal.get(Calendar.MINUTE))
@@ -698,6 +700,7 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
 
     val builder = MaterialDatePicker.Builder.datePicker()
       .setSelection(ts)
+      .setTheme(m3CalendarTheme(act))
 
     androidDialogTitle?.let { builder.setTitleText(it) }
     androidPositiveTitle?.let { builder.setPositiveButtonText(it) }
@@ -733,6 +736,17 @@ class PCDatePickerView(context: Context) : FrameLayout(context), ReactScrollView
     picker.show(act.supportFragmentManager, "PCDatePicker_M3_DATE_THEN_TIME")
   }
 
+  /**
+   * Material pickers resolve their theme from the activity. When the app theme is
+   * not a Material theme they would throw, so hand them a full Material 3 dialog
+   * theme instead (0 = use the activity theme).
+   */
+  private fun m3CalendarTheme(act: FragmentActivity): Int =
+    PCThemeSupport.materialDialogThemeOverride(act, "DatePicker", R.style.PCMaterial3CalendarDialogTheme)
+
+  private fun m3TimePickerTheme(act: FragmentActivity): Int =
+    PCThemeSupport.materialDialogThemeOverride(act, "DatePicker", R.style.PCMaterial3TimePickerDialogTheme)
+
   private fun buildM3CalendarConstraints(): CalendarConstraints? {
     val min = minDateMs
     val max = maxDateMs

package/android/src/main/java/com/platformcomponents/PCSegmentedControlView.kt

@@ -190,7 +190,9 @@ class PCSegmentedControlView(context: Context) : FrameLayout(context), ReactScro
     rebuildGeneration += 1
     val generation = rebuildGeneration
 
-    val group = MaterialButtonToggleGroup(context).apply {
+    // Material widgets need a Material theme; fall back to Material 3 defaults instead of crashing.
+    val themedContext = PCThemeSupport.materialContext(context, "SegmentedControl")
+    val group = MaterialButtonToggleGroup(themedContext).apply {
       layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)
       isSingleSelection = true
       isSelectionRequired = selectionRequired
@@ -207,7 +209,7 @@ class PCSegmentedControlView(context: Context) : FrameLayout(context), ReactScro
       // without one keep their label. "auto" and "labeled" show icon + label.
       val iconOnly = labelVisibility == "unlabeled" && segment.hasIcon
 
-      val button = MaterialButton(context, null, com.google.android.material.R.attr.materialButtonOutlinedStyle).apply {
+      val button = MaterialButton(themedContext, null, com.google.android.material.R.attr.materialButtonOutlinedStyle).apply {
         id = View.generateViewId()
         text = if (iconOnly) "" else segment.label
         isAllCaps = false  // Preserve original text casing
@@ -311,7 +313,7 @@ class PCSegmentedControlView(context: Context) : FrameLayout(context), ReactScro
     if (segment.badge.isEmpty()) return
 
     val inset = (2 * resources.displayMetrics.density).toInt()
-    val badge = BadgeDrawable.create(context).apply {
+    val badge = BadgeDrawable.create(button.context).apply {
       text = segment.badge
       badgeGravity = BadgeDrawable.TOP_END
       badgeBackgroundColor?.let { backgroundColor = it }

package/android/src/main/java/com/platformcomponents/PCSelectionMenuView.kt

@@ -356,7 +356,8 @@ class PCSelectionMenuView(context: Context) : FrameLayout(context), ReactScrollV
     if (mode == MaterialMode.M3) {
       // M3 exposed dropdown menu - the standard Material 3 way
       // Must set box background mode BEFORE setting endIconMode to avoid IllegalStateException
-      val til = TextInputLayout(context).apply {
+      // Material widgets need a Material theme; fall back to Material 3 defaults instead of crashing.
+      val til = TextInputLayout(PCThemeSupport.materialContext(context, "SelectionMenu")).apply {
         layoutParams = FrameLayout.LayoutParams(
           FrameLayout.LayoutParams.WRAP_CONTENT,
           FrameLayout.LayoutParams.WRAP_CONTENT

package/android/src/main/java/com/platformcomponents/PCThemeSupport.kt

@@ -0,0 +1,94 @@
+package com.platformcomponents
+
+import android.content.Context
+import android.util.Log
+import android.util.TypedValue
+import android.view.ContextThemeWrapper
+import androidx.annotation.AttrRes
+import androidx.appcompat.R as AppCompatR
+import com.google.android.material.R as MaterialR
+
+/**
+ * Theme guards for the Material and AppCompat widgets this library creates.
+ *
+ * React Native and Expo templates ship an AppCompat app theme. Material widgets
+ * (MaterialButtonToggleGroup, TextInputLayout, MaterialDatePicker, ...) throw during
+ * inflation when the host theme is not a Material Components / Material 3 theme.
+ * Rather than crash the app, wrap the context in a Material 3 theme (widgets) or
+ * hand the picker dialogs a full Material 3 dialog theme, and warn once so the
+ * developer knows how to get their own colors applied.
+ */
+internal object PCThemeSupport {
+  private const val TAG = "PlatformComponents"
+
+  @Volatile private var warnedMaterial = false
+  @Volatile private var warnedAppCompat = false
+
+  /** True for Theme.MaterialComponents.* and Theme.Material3.* (and descendants). */
+  fun hasMaterialTheme(context: Context): Boolean =
+    resolves(context, MaterialR.attr.materialButtonOutlinedStyle) &&
+      resolves(context, MaterialR.attr.colorSurface)
+
+  /** True for Theme.AppCompat.* and descendants, which includes every Material theme. */
+  fun hasAppCompatTheme(context: Context): Boolean =
+    resolves(context, AppCompatR.attr.alertDialogTheme)
+
+  /**
+   * Context to build Material widgets from. The host context when its theme is a
+   * Material theme; otherwise a Theme.Material3.DayNight wrapper, so the widget
+   * renders with Material 3 defaults instead of throwing.
+   */
+  fun materialContext(context: Context, component: String): Context {
+    if (hasMaterialTheme(context)) return context
+    warnMaterial(component)
+    return ContextThemeWrapper(context, MaterialR.style.Theme_Material3_DayNight_NoActionBar)
+  }
+
+  /**
+   * Context to build AppCompat dialogs from. The host context when its theme is an
+   * AppCompat theme; otherwise a Theme.AppCompat.DayNight.Dialog.Alert wrapper.
+   */
+  fun appCompatDialogContext(context: Context, component: String): Context {
+    if (hasAppCompatTheme(context)) return context
+    warnAppCompat(component)
+    return ContextThemeWrapper(context, AppCompatR.style.Theme_AppCompat_DayNight_Dialog_Alert)
+  }
+
+  /**
+   * Theme override for MaterialDatePicker / MaterialTimePicker when the activity
+   * theme is not a Material theme. Returns 0 (no override) when it is.
+   */
+  fun materialDialogThemeOverride(context: Context, component: String, fallbackTheme: Int): Int {
+    if (hasMaterialTheme(context)) return 0
+    warnMaterial(component)
+    return fallbackTheme
+  }
+
+  private fun resolves(context: Context, @AttrRes attr: Int): Boolean =
+    context.theme.resolveAttribute(attr, TypedValue(), true)
+
+  private fun warnMaterial(component: String) {
+    if (warnedMaterial) return
+    warnedMaterial = true
+    Log.w(
+      TAG,
+      "$component: the app theme is not a Material 3 theme, so Material components " +
+        "fall back to Material 3 default colors. To use your app's colors, make " +
+        "AppTheme inherit from Theme.Material3.DayNight.NoActionBar in " +
+        "android/app/src/main/res/values/styles.xml (Expo: pass " +
+        "{ android: { theme: 'material3' } } to the react-native-platform-components " +
+        "config plugin). See the README section \"Android Theme Configuration\"."
+    )
+  }
+
+  private fun warnAppCompat(component: String) {
+    if (warnedAppCompat) return
+    warnedAppCompat = true
+    Log.w(
+      TAG,
+      "$component: the app theme is not an AppCompat theme, so system dialogs fall " +
+        "back to Theme.AppCompat.DayNight.Dialog.Alert. Make AppTheme inherit from " +
+        "Theme.AppCompat.* or Theme.Material3.* to style them with your theme."
+    )
+  }
+}

package/android/src/main/res/values/styles.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+  <!--
+    Fallback dialog themes for MaterialDatePicker / MaterialTimePicker when the host
+    app theme is not a Material theme (see PCThemeSupport). Each is a full
+    Theme.Material3 dialog theme plus the items from ThemeOverlay.Material3.MaterialCalendar
+    and ThemeOverlay.Material3.MaterialTimePicker (material 1.12.0), which the pickers
+    skip resolving when a theme override is supplied.
+  -->
+  <style name="PCMaterial3CalendarDialogTheme" parent="Theme.Material3.DayNight.Dialog">
+    <item name="buttonBarButtonStyle">@style/Widget.Material3.Button.TextButton.Dialog.Flush</item>
+    <item name="materialCalendarStyle">@style/Widget.Material3.MaterialCalendar</item>
+    <item name="materialCalendarHeaderLayout">@style/Widget.Material3.MaterialCalendar.HeaderLayout</item>
+    <item name="materialCalendarHeaderDivider">@style/Widget.Material3.MaterialCalendar.HeaderDivider</item>
+    <item name="materialCalendarHeaderTitle">@style/Widget.Material3.MaterialCalendar.HeaderTitle</item>
+    <item name="materialCalendarHeaderSelection">@style/Widget.Material3.MaterialCalendar.HeaderSelection</item>
+    <item name="materialCalendarHeaderCancelButton">@style/Widget.Material3.MaterialCalendar.HeaderCancelButton</item>
+    <item name="materialCalendarHeaderConfirmButton">@style/Widget.Material3.Button.TextButton</item>
+    <item name="materialCalendarHeaderToggleButton">@style/Widget.Material3.MaterialCalendar.HeaderToggleButton</item>
+    <item name="materialCalendarYearNavigationButton">@style/Widget.Material3.MaterialCalendar.YearNavigationButton</item>
+    <item name="materialCalendarMonthNavigationButton">@style/Widget.Material3.MaterialCalendar.MonthNavigationButton</item>
+    <item name="materialCalendarDayOfWeekLabel">@style/Widget.Material3.MaterialCalendar.DayOfWeekLabel</item>
+    <item name="materialCalendarDay">@style/Widget.Material3.MaterialCalendar.DayTextView</item>
+    <item name="materialCalendarMonth">@style/Widget.Material3.MaterialCalendar.MonthTextView</item>
+    <item name="buttonBarPositiveButtonStyle">@style/Widget.Material3.Button.TextButton.Dialog</item>
+    <item name="buttonBarNegativeButtonStyle">@style/Widget.Material3.Button.TextButton.Dialog</item>
+  </style>
+
+  <style name="PCMaterial3TimePickerDialogTheme" parent="Theme.Material3.DayNight.Dialog">
+    <item name="buttonBarButtonStyle">@style/Widget.Material3.Button.TextButton.Dialog.Flush</item>
+    <item name="chipStyle">@style/Widget.Material3.MaterialTimePicker.Display</item>
+    <item name="textInputStyle">@style/Widget.Material3.MaterialTimePicker.Display.TextInputLayout</item>
+    <item name="materialDisplayDividerStyle">@style/Widget.Material3.MaterialTimePicker.Display.Divider</item>
+    <item name="materialButtonOutlinedStyle">@style/Widget.Material3.MaterialTimePicker.Button</item>
+    <item name="materialClockStyle">@style/Widget.Material3.MaterialTimePicker.Clock</item>
+    <item name="materialTimePickerStyle">@style/Widget.Material3.MaterialTimePicker</item>
+    <item name="imageButtonStyle">@style/Widget.Material3.MaterialTimePicker.ImageButton</item>
+    <item name="materialTimePickerTitleStyle">@style/TextAppearance.Material3.MaterialTimePicker.Title</item>
+  </style>
+</resources>

package/lib/typescript/commonjs/docs/docusaurus.config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '@docusaurus/types';
+declare const config: Config;
+export default config;
+//# sourceMappingURL=docusaurus.config.d.ts.map

package/lib/typescript/commonjs/docs/docusaurus.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus.config.d.ts","sourceRoot":"","sources":["../../../../docs/docusaurus.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,QAAA,MAAM,MAAM,EAAE,MA+Eb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/typescript/commonjs/docs/sidebars.d.ts

@@ -0,0 +1,4 @@
+import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
+declare const sidebars: SidebarsConfig;
+export default sidebars;
+//# sourceMappingURL=sidebars.d.ts.map

package/lib/typescript/commonjs/docs/sidebars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebars.d.ts","sourceRoot":"","sources":["../../../../docs/sidebars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,QAAA,MAAM,QAAQ,EAAE,cAwBf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/lib/typescript/module/docs/docusaurus.config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '@docusaurus/types';
+declare const config: Config;
+export default config;
+//# sourceMappingURL=docusaurus.config.d.ts.map

package/lib/typescript/module/docs/docusaurus.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus.config.d.ts","sourceRoot":"","sources":["../../../../docs/docusaurus.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,QAAA,MAAM,MAAM,EAAE,MA+Eb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/typescript/module/docs/sidebars.d.ts

@@ -0,0 +1,4 @@
+import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
+declare const sidebars: SidebarsConfig;
+export default sidebars;
+//# sourceMappingURL=sidebars.d.ts.map

package/lib/typescript/module/docs/sidebars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebars.d.ts","sourceRoot":"","sources":["../../../../docs/sidebars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,QAAA,MAAM,QAAQ,EAAE,cAwBf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-platform-components",
-  "version": "0.9.0",
-  "description": "Native UI components for React Native: DatePicker, ContextMenu, SelectionMenu, SegmentedControl, LiquidGlass.",
+  "version": "1.0.0",
+  "description": "Native UI components for React Native that are native on Android too: DatePicker, ContextMenu, SelectionMenu, SegmentedControl (Material 3) and LiquidGlass (iOS 26). Fabric, typed, Expo config plugin.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
   "browser": "./lib/module/index.web.js",
@@ -57,6 +57,7 @@
   "scripts": {
     "example": "yarn workspace react-native-platform-components-example",
     "example-expo": "yarn workspace react-native-platform-components-example-expo",
+    "docs": "yarn workspace react-native-platform-components-docs",
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib plugin/build",
     "prepare": "bob build && yarn build:plugin",
     "typecheck": "tsc",
@@ -71,26 +72,42 @@
   },
   "keywords": [
     "react-native",
+    "expo",
+    "expo-config-plugin",
     "ios",
     "android",
+    "fabric",
+    "new-architecture",
+    "native-ui",
+    "ui-components",
     "datepicker",
     "date-picker",
     "time-picker",
-    "picker",
+    "datetimepicker",
+    "uidatepicker",
+    "material-date-picker",
     "menu",
-    "selection-menu",
     "context-menu",
+    "contextmenu",
+    "popup-menu",
+    "uicontextmenu",
+    "selection-menu",
     "dropdown",
-    "native",
-    "material-design",
-    "expo",
+    "picker",
     "segmented-control",
     "segmentedcontrol",
-    "tabs",
     "segmented-buttons",
     "segmentedbuttons",
+    "uisegmentedcontrol",
+    "tabs",
     "liquid-glass",
-    "liquidglass"
+    "liquidglass",
+    "glass-effect",
+    "uiglasseffect",
+    "material-design",
+    "material3",
+    "material-3",
+    "material-you"
   ],
   "repository": {
     "type": "git",
@@ -141,12 +158,13 @@
     "typescript": "~6.0.3"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
+    "react": ">=19.0.0",
+    "react-native": ">=0.81.0"
   },
   "workspaces": [
     "example",
-    "example-expo"
+    "example-expo",
+    "docs"
   ],
   "packageManager": "yarn@4.11.0",
   "react-native-builder-bob": {
@@ -218,7 +236,9 @@
       "@release-it/conventional-changelog": {
         "preset": {
           "name": "angular"
-        }
+        },
+        "infile": "CHANGELOG.md",
+        "header": "# Changelog"
       }
     }
   },
@@ -226,6 +246,7 @@
     "preset": "@react-native/jest-preset",
     "modulePathIgnorePatterns": [
       "<rootDir>/example/node_modules",
+      "<rootDir>/docs/",
       "<rootDir>/lib/"
     ],
     "testPathIgnorePatterns": [

package/plugin/build/index.cjs

@@ -1,26 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MATERIAL3_THEME_PARENT = void 0;
+exports.resolveMaterial3Parent = resolveMaterial3Parent;
+exports.applyMaterial3Theme = applyMaterial3Theme;
+const config_plugins_1 = require("@expo/config-plugins");
+exports.MATERIAL3_THEME_PARENT = 'Theme.Material3.DayNight.NoActionBar';
+/**
+ * `react-native-edge-to-edge` re-parents `AppTheme` onto its own themes. When we
+ * see one of those, switch to the matching Material 3 flavour instead of
+ * replacing it, so edge-to-edge keeps working.
+ */
+const EDGE_TO_EDGE_PREFIX = 'Theme.EdgeToEdge';
+const APP_THEME_NAME = 'AppTheme';
+function resolveMaterial3Parent(currentParent) {
+    if (!currentParent || !currentParent.startsWith(EDGE_TO_EDGE_PREFIX)) {
+        return exports.MATERIAL3_THEME_PARENT;
+    }
+    if (currentParent.includes('.Material3')) {
+        return currentParent;
+    }
+    const suffix = currentParent.slice(EDGE_TO_EDGE_PREFIX.length); // '' | '.Light'
+    return `${EDGE_TO_EDGE_PREFIX}.Material3${suffix}`;
+}
+/**
+ * Re-parents the app theme onto Material 3, keeping every existing `<item>`
+ * (`colorPrimary`, `android:editTextBackground`, status bar colors, ...).
+ * Idempotent: running prebuild again leaves the result unchanged.
+ */
+function applyMaterial3Theme(xml) {
+    const styles = xml.resources.style ?? [];
+    const appTheme = styles.find((style) => style.$.name === APP_THEME_NAME);
+    if (appTheme) {
+        appTheme.$.parent = resolveMaterial3Parent(appTheme.$.parent);
+    }
+    else {
+        styles.push({
+            $: { name: APP_THEME_NAME, parent: exports.MATERIAL3_THEME_PARENT },
+            item: [],
+        });
+    }
+    xml.resources.style = styles;
+    return xml;
+}
 /**
  * Expo config plugin for react-native-platform-components.
  *
- * This library requires no manual native configuration on either iOS or Android.
- * The native modules are automatically linked via Expo prebuild and React Native's
- * autolinking system.
- *
- * iOS:
- *   - Pod linkage works automatically via the standard podspec
- *   - No Info.plist, entitlements, or AppDelegate changes required
- *
- * Android:
- *   - Gradle linkage works automatically via autolinking
- *   - No AndroidManifest.xml, theme, or permission changes required
+ * Native linking needs no configuration on either platform: CocoaPods and
+ * Gradle autolinking pick the library up during `expo prebuild`.
  *
- * This plugin is provided for discoverability and to enable future configuration
- * options if needed. Running prebuild multiple times is idempotent.
+ * The plugin's job is the Android theme. Expo's generated `AppTheme` inherits
+ * from AppCompat, which is enough for ContextMenu, LiquidGlass and the
+ * `material: 'system'` modes, but Material 3 widgets look best under a
+ * Material 3 app theme. Pass `{ android: { theme: 'material3' } }` to have
+ * prebuild re-parent `AppTheme` accordingly.
  */
-const withPlatformComponents = (config) => {
-    // No-op plugin: react-native-platform-components requires no native configuration
-    // beyond standard autolinking which Expo prebuild handles automatically.
-    return config;
+const withPlatformComponents = (config, options) => {
+    const theme = options?.android?.theme ?? 'appcompat';
+    if (theme !== 'material3') {
+        return config;
+    }
+    return (0, config_plugins_1.withAndroidStyles)(config, (styleConfig) => {
+        styleConfig.modResults = applyMaterial3Theme(styleConfig.modResults);
+        return styleConfig;
+    });
 };
 exports.default = withPlatformComponents;

package/plugin/build/index.d.ts

@@ -1,22 +1,39 @@
-import type { ConfigPlugin } from '@expo/config-plugins';
+import { type AndroidConfig, type ConfigPlugin } from '@expo/config-plugins';
+type ResourceXML = AndroidConfig.Resources.ResourceXML;
 /**
- * Expo config plugin for react-native-platform-components.
- *
- * This library requires no manual native configuration on either iOS or Android.
- * The native modules are automatically linked via Expo prebuild and React Native's
- * autolinking system.
+ * Parent theme for the Android `AppTheme` style.
  *
- * iOS:
- *   - Pod linkage works automatically via the standard podspec
- *   - No Info.plist, entitlements, or AppDelegate changes required
+ * - `'material3'`: re-parent `AppTheme` onto `Theme.Material3.DayNight.NoActionBar`.
+ *   Required for `SegmentedControl` and for `DatePicker` / `SelectionMenu` in
+ *   `android={{ material: 'm3' }}` mode to pick up your app's Material colors.
+ * - `'appcompat'` (default): leave Expo's `Theme.AppCompat.DayNight.NoActionBar` as is.
+ */
+export type AndroidTheme = 'material3' | 'appcompat';
+export type PlatformComponentsPluginOptions = {
+    android?: {
+        theme?: AndroidTheme;
+    };
+};
+export declare const MATERIAL3_THEME_PARENT = "Theme.Material3.DayNight.NoActionBar";
+export declare function resolveMaterial3Parent(currentParent: string | undefined): string;
+/**
+ * Re-parents the app theme onto Material 3, keeping every existing `<item>`
+ * (`colorPrimary`, `android:editTextBackground`, status bar colors, ...).
+ * Idempotent: running prebuild again leaves the result unchanged.
+ */
+export declare function applyMaterial3Theme(xml: ResourceXML): ResourceXML;
+/**
+ * Expo config plugin for react-native-platform-components.
  *
- * Android:
- *   - Gradle linkage works automatically via autolinking
- *   - No AndroidManifest.xml, theme, or permission changes required
+ * Native linking needs no configuration on either platform: CocoaPods and
+ * Gradle autolinking pick the library up during `expo prebuild`.
  *
- * This plugin is provided for discoverability and to enable future configuration
- * options if needed. Running prebuild multiple times is idempotent.
+ * The plugin's job is the Android theme. Expo's generated `AppTheme` inherits
+ * from AppCompat, which is enough for ContextMenu, LiquidGlass and the
+ * `material: 'system'` modes, but Material 3 widgets look best under a
+ * Material 3 app theme. Pass `{ android: { theme: 'material3' } }` to have
+ * prebuild re-parent `AppTheme` accordingly.
  */
-declare const withPlatformComponents: ConfigPlugin;
+declare const withPlatformComponents: ConfigPlugin<PlatformComponentsPluginOptions | void>;
 export default withPlatformComponents;
 //# sourceMappingURL=index.d.ts.map

package/plugin/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AAEH,QAAA,MAAM,sBAAsB,EAAE,YAI7B,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAErD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,sBAAsB,yCAAyC,CAAC;AAW7E,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAejE;AAED;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,sBAAsB,EAAE,YAAY,CACxC,+BAA+B,GAAG,IAAI,CAWvC,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/plugin/tsconfig.json

@@ -11,6 +11,11 @@
     "outDir": "build",
     "rootDir": "src"
   },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"]
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "src/__tests__"
+  ]
 }