@use-voltra/android 2.1.1 → 2.3.0

package/src/jsx/props/AndroidArcProgressIndicator.ts

@@ -0,0 +1,24 @@
+// 🤖 AUTO-GENERATED from data/components.json
+// DO NOT EDIT MANUALLY - Changes will be overwritten
+// Schema version: 1.0.0
+
+import type { VoltraBaseProps } from '../baseProps'
+
+export type AndroidArcProgressIndicatorProps = VoltraBaseProps & {
+  /** Fill fraction from 0 to 1, clamped */
+  progress?: number
+  /** Stroke color of the filled arc */
+  color?: string
+  /** Stroke color of the unfilled arc; transparent hides the track */
+  trackColor?: string
+  /** Stroke width in dp of both arcs */
+  strokeWidth?: number
+  /** Angle in degrees where the arc begins; 0 is 3 o'clock, positive is clockwise */
+  startAngle?: number
+  /** Total angular length of the track in degrees; 360 makes a closed ring */
+  sweepAngle?: number
+  /** End shape of both arcs */
+  lineCap?: 'round' | 'butt'
+  /** Sweep gradient colors along the filled arc, from startAngle; overrides color */
+  gradientColors?: string
+}

package/src/jsx/props/AndroidChart.ts

@@ -11,6 +11,8 @@ export type AndroidChartProps = VoltraBaseProps & {
   xAxisVisibility?: 'automatic' | 'visible' | 'hidden'
   /** Show or hide the y-axis */
   yAxisVisibility?: 'automatic' | 'visible' | 'hidden'
+  /** Pin the y-axis lower and/or upper bound */
+  yScale?: Record<string, any>
   /** Show or hide the chart legend */
   legendVisibility?: 'automatic' | 'visible' | 'hidden'
   /** Map of series name to color string */

package/src/payload/component-ids.ts

@@ -29,6 +29,7 @@ export const ANDROID_COMPONENT_NAME_TO_ID: Record<string, number> = {
   AndroidText: 18,
   AndroidTitleBar: 19,
   AndroidChart: 20,
+  AndroidArcProgressIndicator: 21,
 }
 
 /**
@@ -56,6 +57,7 @@ export const ANDROID_COMPONENT_ID_TO_NAME: Record<number, string> = {
   18: 'AndroidText',
   19: 'AndroidTitleBar',
   20: 'AndroidChart',
+  21: 'AndroidArcProgressIndicator',
 }
 
 /**

package/src/types.ts

@@ -32,7 +32,66 @@ export type PreloadImagesResult = {
   failed: PreloadImageFailure[]
 }
 
+/**
+ * @deprecated Use `setWidgetServerUpdate` with an `Authorization` header instead. These are
+ * stored in the same place and keep the same replace-the-whole-set semantics.
+ */
 export type WidgetServerCredentials = {
   token: string
   headers?: Record<string, string>
 }
+
+/**
+ * Runtime overrides for a widget's `serverUpdate` settings — the twin of the `serverUpdate` key
+ * in app.json, which supplies the defaults.
+ *
+ * Every field is optional and replaces the app.json value when set. `headers` and `query` merge
+ * per key across layers; everything else takes the value from the most specific layer that sets
+ * it. Passing settings without a `widgetId` sets them for every server-driven widget.
+ */
+export type WidgetServerUpdateSettings = {
+  /** Endpoint to fetch from. Must be https, or http to a local dev host in a debug build. */
+  url?: string
+  /** How often to fetch, in minutes. Clamped to at least 15 and at most 24 hours. */
+  intervalMinutes?: number
+  /** Set false to stop fetching and drive the widget from the app instead. Defaults to true. */
+  enabled?: boolean
+  /** HTTP method. Defaults to GET. A body is dropped on GET and HEAD, with a warning. */
+  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+  /** Extra query parameters. Voltra's own keys are reserved and rejected. */
+  query?: Record<string, string>
+  /** Extra request headers, for example `Authorization`. */
+  headers?: Record<string, string>
+  /** Request body, sent as `application/json`. */
+  body?: WidgetServerUpdateBody
+}
+
+/** A JSON value, as accepted for a server-update request body. */
+export type WidgetServerUpdateBody =
+  | string
+  | number
+  | boolean
+  | null
+  | WidgetServerUpdateBody[]
+  | { [key: string]: WidgetServerUpdateBody }
+
+/** Options selecting which widget a settings call applies to. */
+export type WidgetServerUpdateOptions = {
+  /** Widget id to scope the settings to. Omit to set them for every server-driven widget. */
+  widgetId?: string
+}
+
+/**
+ * Fully resolved settings for one widget: every layer flattened and app.json's defaults applied,
+ * exactly what it would fetch with right now.
+ */
+export type WidgetServerUpdateSnapshot = {
+  /** Absent when the widget is server-driven but has no URL yet. */
+  url?: string
+  intervalMinutes: number
+  enabled: boolean
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+  query: Record<string, string>
+  headers: Record<string, string>
+  body?: WidgetServerUpdateBody
+}

package/src/widgets/types.ts

@@ -21,9 +21,23 @@ export type AndroidWidgetSizeVariant = {
  * Information about an active widget instance on Android
  */
 export type WidgetInfo = {
-  /** The name (ID) of the widget as defined in the config plugin */
+  /** The Voltra widget id, as defined in the config plugin (e.g. `"weather"`) */
+  widgetType: string
+  /**
+   * The Android instance id of this placement. Every placed widget has its own, so the same
+   * widget placed twice appears twice with different `appWidgetId`s. Pass it to the per-instance
+   * configuration APIs to give one placement its own values.
+   */
+  appWidgetId: number
+  /**
+   * @deprecated Renamed to `widgetType`, which says what this field holds. Same value.
+   */
   name: string
-  /** The unique ID for this widget instance (required for updates) */
+  /**
+   * @deprecated Renamed to `appWidgetId`, which says what this field holds — it is the Android
+   * instance id, not the Voltra widget id that `widgetId` names everywhere else in this package.
+   * Same value.
+   */
   widgetId: number
   /** The class name of the provider (e.g., ".WeatherWidget") */
   providerClassName: string