@use-voltra/android 2.2.0 → 2.3.0

package/build/typescript/commonjs/types.d.ts

@@ -24,8 +24,59 @@ export type PreloadImagesResult = {
     succeeded: string[];
     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;
+};
 //# sourceMappingURL=types.d.ts.map

package/build/typescript/commonjs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uFAAuF;IACvF,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpD,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,gDAAgD;IAChD,IAAI,CAAC,EAAE,sBAAsB,CAAA;CAC9B,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,sBAAsB,EAAE,GACxB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAAA;CAAE,CAAA;AAE7C,iEAAiE;AACjE,MAAM,MAAM,yBAAyB,GAAG;IACtC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,sBAAsB,CAAA;CAC9B,CAAA"}

package/build/typescript/commonjs/widgets/types.d.ts

@@ -18,9 +18,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;

package/build/typescript/commonjs/widgets/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,EAAE,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,EAAE,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}

package/build/typescript/module/index.d.ts

@@ -11,7 +11,7 @@ export type { VoltraAndroidBaseProps } from './jsx/baseProps.js';
 export type { VoltraAndroidStyleProp, VoltraAndroidTextStyle, VoltraAndroidTextStyleProp, VoltraAndroidViewStyle, } from './styles/types.js';
 export type { AndroidColorValue, AndroidDynamicColorRole, AndroidDynamicColorToken } from './dynamic-colors.js';
 export type { AndroidLiveUpdateJson, AndroidLiveUpdateVariants, AndroidLiveUpdateVariantsJson, StartAndroidLiveUpdateOptions, UpdateAndroidLiveUpdateOptions, UseAndroidLiveUpdateOptions, UseAndroidLiveUpdateResult, } from './live-update/types.js';
-export type { EventSubscription, PreloadImageFailure, PreloadImageOptions, PreloadImageSvgOptions, PreloadImageUrlOptions, PreloadImagesResult, VoltraElementJson, VoltraElementRef, VoltraNodeJson, VoltraPropValue, WidgetServerCredentials, } from './types.js';
+export type { EventSubscription, PreloadImageFailure, PreloadImageOptions, PreloadImageSvgOptions, PreloadImageUrlOptions, PreloadImagesResult, VoltraElementJson, VoltraElementRef, VoltraNodeJson, VoltraPropValue, WidgetServerCredentials, WidgetServerUpdateBody, WidgetServerUpdateOptions, WidgetServerUpdateSettings, WidgetServerUpdateSnapshot, } from './types.js';
 export type { AndroidWidgetSize, AndroidWidgetSizeVariant, AndroidWidgetVariants, UpdateAndroidWidgetOptions, WidgetInfo, } from './widgets/types.js';
 export type { AndroidOngoingNotificationActionPayload, AndroidOngoingNotificationActionProps, AndroidOngoingNotificationBigTextPayload, AndroidOngoingNotificationBigTextProps, AndroidOngoingNotificationCapabilities, AndroidOngoingNotificationCommonDisplayProps, AndroidOngoingNotificationContent, AndroidOngoingNotificationFallbackBehavior, AndroidOngoingNotificationInput, AndroidOngoingNotificationPayload, AndroidOngoingNotificationProgressPayload, AndroidOngoingNotificationProgressPoint, AndroidOngoingNotificationProgressProps, AndroidOngoingNotificationProgressSegment, AndroidOngoingNotificationStartResult, AndroidOngoingNotificationStatus, AndroidOngoingNotificationStopResult, AndroidOngoingNotificationUpdateResult, AndroidOngoingNotificationUpsertResult, StartAndroidOngoingNotificationOptions, UpdateAndroidOngoingNotificationOptions, UseAndroidOngoingNotificationOptions, UseAndroidOngoingNotificationResult, } from './ongoing-notification/types.js';
 export type { BoxProps } from './jsx/Box.js';
@@ -25,6 +25,6 @@ export type { LinearProgressIndicatorProps } from './jsx/LinearProgressIndicator
 export type { RowProps } from './jsx/Row.js';
 export type { SpacerProps } from './jsx/Spacer.js';
 export type { TextProps } from './jsx/Text.js';
-export { isAndroidEnv, isIosEnv } from '@use-voltra/core';
-export type { WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core';
+export { getFastRefreshHub, isAndroidEnv, isIosEnv } from '@use-voltra/core';
+export type { FastRefreshHub, WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core';
 //# sourceMappingURL=index.d.ts.map

package/build/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACjF,OAAO,EAAE,uCAAuC,EAAE,MAAM,oCAAoC,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAA;AAIvH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAGhE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC/G,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,GACX,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,uCAAuC,EACvC,qCAAqC,EACrC,wCAAwC,EACxC,sCAAsC,EACtC,sCAAsC,EACtC,4CAA4C,EAC5C,iCAAiC,EACjC,0CAA0C,EAC1C,+BAA+B,EAC/B,iCAAiC,EACjC,yCAAyC,EACzC,uCAAuC,EACvC,uCAAuC,EACvC,yCAAyC,EACzC,qCAAqC,EACrC,gCAAgC,EAChC,oCAAoC,EACpC,sCAAsC,EACtC,sCAAsC,EACtC,sCAAsC,EACtC,uCAAuC,EACvC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,iCAAiC,CAAA;AAGxC,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAA;AACxF,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACtE,YAAY,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AACpF,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/build/typescript/module/jsx/ArcProgressIndicator.d.ts

@@ -0,0 +1,7 @@
+import type { AndroidArcProgressIndicatorProps as GeneratedArcProgressIndicatorProps } from './props/AndroidArcProgressIndicator.js';
+export type ArcProgressIndicatorProps = Omit<GeneratedArcProgressIndicatorProps, 'gradientColors'> & {
+    /** Sweep gradient colors along the filled arc, from `startAngle`. Overrides `color`. */
+    gradientColors?: string[];
+};
+export declare const ArcProgressIndicator: import("./createVoltraComponent.js").VoltraComponent<ArcProgressIndicatorProps>;
+//# sourceMappingURL=ArcProgressIndicator.d.ts.map

package/build/typescript/module/jsx/ArcProgressIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcProgressIndicator.d.ts","sourceRoot":"","sources":["../../../../src/jsx/ArcProgressIndicator.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gCAAgC,IAAI,kCAAkC,EAAE,MAAM,wCAAwC,CAAA;AAEpI,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,kCAAkC,EAAE,gBAAgB,CAAC,GAAG;IACnG,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,oBAAoB,iFAgB/B,CAAA"}

package/build/typescript/module/jsx/Chart.d.ts

@@ -1,4 +1,5 @@
 import type { VoltraAndroidBaseProps } from './baseProps.js';
+import type { YScale } from './chart-types.js';
 export type AndroidChartProps = VoltraAndroidBaseProps & {
     xAxisVisibility?: 'automatic' | 'visible' | 'hidden';
     yAxisVisibility?: 'automatic' | 'visible' | 'hidden';
@@ -11,6 +12,7 @@ export type AndroidChartProps = VoltraAndroidBaseProps & {
     legendVisibility?: 'automatic' | 'visible' | 'hidden';
     foregroundStyleScale?: Record<string, string>;
     chartScrollableAxes?: 'horizontal' | 'vertical';
+    yScale?: YScale;
 };
 export declare const Chart: import("./createVoltraComponent.js").VoltraComponent<AndroidChartProps>;
 //# sourceMappingURL=Chart.d.ts.map

package/build/typescript/module/jsx/Chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chart.d.ts","sourceRoot":"","sources":["../../../../src/jsx/Chart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAa5D,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG;IACvD,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,cAAc,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtC,cAAc,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtC,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,mBAAmB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CAChD,CAAA;AA4ED,eAAO,MAAM,KAAK,yEAuBhB,CAAA"}
+{"version":3,"file":"Chart.d.ts","sourceRoot":"","sources":["../../../../src/jsx/Chart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAI5D,OAAO,KAAK,EAAmC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAS/E,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG;IACvD,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,cAAc,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtC,cAAc,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtC,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,mBAAmB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAmFD,eAAO,MAAM,KAAK,yEA2BhB,CAAA"}

package/build/typescript/module/jsx/chart-types.d.ts

@@ -7,4 +7,8 @@ export type SectorDataPoint = {
     value: number;
     category: string;
 };
+export type YScale = {
+    min?: number;
+    max?: number;
+};
 //# sourceMappingURL=chart-types.d.ts.map

package/build/typescript/module/jsx/chart-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-types.d.ts","sourceRoot":"","sources":["../../../../src/jsx/chart-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/E,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA"}
+{"version":3,"file":"chart-types.d.ts","sourceRoot":"","sources":["../../../../src/jsx/chart-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/E,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AACjE,MAAM,MAAM,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/build/typescript/module/jsx/primitives.d.ts

@@ -1,3 +1,4 @@
+export * from './ArcProgressIndicator.js';
 export * from './AreaMark.js';
 export * from './BarMark.js';
 export * from './Box.js';

package/build/typescript/module/jsx/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../src/jsx/primitives.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../src/jsx/primitives.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA"}

package/build/typescript/module/jsx/props/AndroidArcProgressIndicator.d.ts

@@ -0,0 +1,20 @@
+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;
+};
+//# sourceMappingURL=AndroidArcProgressIndicator.d.ts.map

package/build/typescript/module/jsx/props/AndroidArcProgressIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AndroidArcProgressIndicator.d.ts","sourceRoot":"","sources":["../../../../../src/jsx/props/AndroidArcProgressIndicator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD,MAAM,MAAM,gCAAgC,GAAG,eAAe,GAAG;IAC/D,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA"}

package/build/typescript/module/jsx/props/AndroidChart.d.ts

@@ -6,6 +6,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/build/typescript/module/jsx/props/AndroidChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AndroidChart.d.ts","sourceRoot":"","sources":["../../../../../src/jsx/props/AndroidChart.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,8BAA8B;IAC9B,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACrD,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1C,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CAChD,CAAA"}
+{"version":3,"file":"AndroidChart.d.ts","sourceRoot":"","sources":["../../../../../src/jsx/props/AndroidChart.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,8BAA8B;IAC9B,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACpD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IACrD,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1C,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CAChD,CAAA"}

package/build/typescript/module/payload/component-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-ids.d.ts","sourceRoot":"","sources":["../../../../src/payload/component-ids.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB/D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB/D,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ1D"}
+{"version":3,"file":"component-ids.d.ts","sourceRoot":"","sources":["../../../../src/payload/component-ids.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuB/D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuB/D,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ1D"}

package/build/typescript/module/types.d.ts

@@ -24,8 +24,59 @@ export type PreloadImagesResult = {
     succeeded: string[];
     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;
+};
 //# sourceMappingURL=types.d.ts.map

package/build/typescript/module/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uFAAuF;IACvF,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpD,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,gDAAgD;IAChD,IAAI,CAAC,EAAE,sBAAsB,CAAA;CAC9B,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,sBAAsB,EAAE,GACxB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAAA;CAAE,CAAA;AAE7C,iEAAiE;AACjE,MAAM,MAAM,yBAAyB,GAAG;IACtC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,sBAAsB,CAAA;CAC9B,CAAA"}

package/build/typescript/module/widgets/types.d.ts

@@ -18,9 +18,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;

package/build/typescript/module/widgets/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,EAAE,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/widgets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,EAAE,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-voltra/android",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Voltra for Android",
   "main": "build/commonjs/index.js",
   "module": "build/module/index.js",
@@ -50,7 +50,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@use-voltra/core": "^2.2.0"
+    "@use-voltra/core": "^2.3.0"
   },
   "keywords": [
     "react-native",

package/src/index.ts

@@ -48,6 +48,10 @@ export type {
   VoltraNodeJson,
   VoltraPropValue,
   WidgetServerCredentials,
+  WidgetServerUpdateBody,
+  WidgetServerUpdateOptions,
+  WidgetServerUpdateSettings,
+  WidgetServerUpdateSnapshot,
 } from './types.js'
 export type {
   AndroidWidgetSize,
@@ -95,5 +99,5 @@ export type { LinearProgressIndicatorProps } from './jsx/LinearProgressIndicator
 export type { RowProps } from './jsx/Row.js'
 export type { SpacerProps } from './jsx/Spacer.js'
 export type { TextProps } from './jsx/Text.js'
-export { isAndroidEnv, isIosEnv } from '@use-voltra/core'
-export type { WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core'
+export { getFastRefreshHub, isAndroidEnv, isIosEnv } from '@use-voltra/core'
+export type { FastRefreshHub, WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core'

package/src/jsx/ArcProgressIndicator.tsx

@@ -0,0 +1,25 @@
+import { createVoltraComponent } from './createVoltraComponent.js'
+import type { AndroidArcProgressIndicatorProps as GeneratedArcProgressIndicatorProps } from './props/AndroidArcProgressIndicator.js'
+
+export type ArcProgressIndicatorProps = Omit<GeneratedArcProgressIndicatorProps, 'gradientColors'> & {
+  /** Sweep gradient colors along the filled arc, from `startAngle`. Overrides `color`. */
+  gradientColors?: string[]
+}
+
+export const ArcProgressIndicator = createVoltraComponent<ArcProgressIndicatorProps>('AndroidArcProgressIndicator', {
+  toJSON: ({ gradientColors, ...rest }) => {
+    const result: Record<string, unknown> = { ...rest }
+    if (gradientColors != null) {
+      result.gradientColors = JSON.stringify(gradientColors)
+    }
+    return result
+  },
+  validate: ({ children }) => {
+    // The arc itself occupies one of the ten child slots a Glance Box allows.
+    if (children.length > 9) {
+      console.warn(
+        `ArcProgressIndicator supports at most 9 direct children in Jetpack Glance, got ${children.length}. The arc itself takes the tenth slot, so extra children will be truncated.`
+      )
+    }
+  },
+})

package/src/jsx/Chart.tsx

@@ -4,7 +4,7 @@ import type { VoltraAndroidBaseProps } from './baseProps.js'
 import type { AreaMarkProps } from './AreaMark.js'
 import type { BarMarkProps } from './BarMark.js'
 import { VOLTRA_MARK_TAG } from './BarMark.js'
-import type { ChartDataPoint, SectorDataPoint } from './chart-types.js'
+import type { ChartDataPoint, SectorDataPoint, YScale } from './chart-types.js'
 import { createVoltraComponent } from './createVoltraComponent.js'
 import type { LineMarkProps } from './LineMark.js'
 import type { PointMarkProps } from './PointMark.js'
@@ -21,6 +21,7 @@ export type AndroidChartProps = VoltraAndroidBaseProps & {
   legendVisibility?: 'automatic' | 'visible' | 'hidden'
   foregroundStyleScale?: Record<string, string>
   chartScrollableAxes?: 'horizontal' | 'vertical'
+  yScale?: YScale
 }
 
 // ---- wire encoding helpers (same as iOS Chart) ----
@@ -34,6 +35,13 @@ const encodeDataPoints = (data: ChartDataPoint[]): CompactDataPoint[] =>
 
 const encodeSectorPoints = (data: SectorDataPoint[]): CompactSectorPoint[] => data.map((pt) => [pt.value, pt.category])
 
+const encodeYScale = (scale: YScale): Record<string, unknown> => {
+  const encoded: Record<string, unknown> = {}
+  if (scale.min != null) encoded.mn = scale.min
+  if (scale.max != null) encoded.mx = scale.max
+  return encoded
+}
+
 const encodeBarMark = (props: BarMarkProps): MarkWire => {
   const p: Record<string, unknown> = {}
   if (props.color != null) p.c = props.color
@@ -98,7 +106,7 @@ const ENCODERS: Record<string, (props: any) => MarkWire> = {
 // ---- component ----
 
 export const Chart = createVoltraComponent<AndroidChartProps>('AndroidChart', {
-  toJSON: ({ children, foregroundStyleScale, xAxisGridStyle, yAxisGridStyle, ...rest }) => {
+  toJSON: ({ children, foregroundStyleScale, xAxisGridStyle, yAxisGridStyle, yScale, ...rest }) => {
     const marks: MarkWire[] = []
 
     React.Children.forEach(children, (child) => {
@@ -117,6 +125,10 @@ export const Chart = createVoltraComponent<AndroidChartProps>('AndroidChart', {
     }
     if (xAxisGridStyle?.visible === false) result.xAxisGridVisible = false
     if (yAxisGridStyle?.visible === false) result.yAxisGridVisible = false
+    if (yScale != null) {
+      const encoded = encodeYScale(yScale)
+      if (Object.keys(encoded).length > 0) result.yScale = JSON.stringify(encoded)
+    }
 
     return result
   },

package/src/jsx/chart-types.ts

@@ -1,2 +1,3 @@
 export type ChartDataPoint = { x: string | number; y: number; series?: string }
 export type SectorDataPoint = { value: number; category: string }
+export type YScale = { min?: number; max?: number }

package/src/jsx/primitives.ts

@@ -1,3 +1,4 @@
+export * from './ArcProgressIndicator.js'
 export * from './AreaMark.js'
 export * from './BarMark.js'
 export * from './Box.js'

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