craft-native 0.0.395 → 0.0.408

package/dist/api/mobile.d.ts

@@ -558,10 +558,42 @@ export interface LocationOptions {
 export interface RecordingStartOptions {
     recordingId?: string;
 }
+/**
+ * How hard a route recording works the GPS. `'saver'` is for a long effort (an
+ * ultra): fixes come at least 5 m apart rather than every second, and while
+ * the pace holds steady iOS asks for ten-metre accuracy instead of the best it
+ * can do, going back to the best at once when the pace or the signal changes.
+ * Fixes stay under 30 s apart at any speed that counts as moving, so distance
+ * and moving time come out as they would at full rate. Android asks for the
+ * same spacing and batches delivery.
+ *
+ * `'auto'` saves power only while the device wants it: iOS Low Power Mode or
+ * Android Battery Saver is on, or the battery is under 20% and not charging.
+ * The host re-checks whenever the platform reports a change, so a recording
+ * moves between `'saver'` and `'default'` by itself. Read which one it is using
+ * from `effectivePowerMode` on the recording's state.
+ */
+export type LocationRecordingPowerMode = 'default' | 'saver' | 'auto';
+/** What a recording is actually using right now: `'auto'` resolves to one of these. */
+export type LocationRecordingEffectivePowerMode = 'default' | 'saver';
+export interface LocationRecordingPowerOptions {
+    powerMode?: LocationRecordingPowerMode;
+}
+/**
+ * Change the power mode of the recording that is running, fenced to its ID
+ * like pause, resume and stop.
+ */
+export interface LocationRecordingPowerModeOptions extends RecordingOwnershipOptions {
+    powerMode: LocationRecordingPowerMode;
+}
 /** Fence a recording operation to the ID returned by start or explicit recovery. */
 export interface RecordingOwnershipOptions {
     expectedId: string;
 }
+/** Reading a route back: `since` (epoch ms) asks only for the fixes recorded after it. */
+export interface LocationRecordingReadOptions extends RecordingOwnershipOptions {
+    since?: number;
+}
 /** Secure IDs supplied by the platform, including WebView-free mobile hosts. */
 export declare const crypto: {
     randomUUID(): Promise<string>;
@@ -584,6 +616,10 @@ export interface LocationRecordingState {
     paused: boolean;
     startedAt: number | null;
     sampleCount?: number;
+    /** The mode asked for (`'default'` on a host that predates power modes). */
+    powerMode?: LocationRecordingPowerMode;
+    /** The mode in use now. `'default'` once the recording has stopped. */
+    effectivePowerMode?: LocationRecordingEffectivePowerMode;
 }
 export interface LocationRecordingResult extends LocationRecordingState {
     locations: Location[];
@@ -609,6 +645,8 @@ export interface LocationRecordingResult extends LocationRecordingState {
 export declare const location: {
     supportsRecordingOwnership: () => boolean;
     supportsRecordingIntentIdentity: () => boolean;
+    /** `setRecordingPowerMode()` and `powerMode: 'auto'` work on this host. */
+    supportsRecordingPowerMode: () => boolean;
     /**
      * Get current position.
      *
@@ -630,13 +668,32 @@ export declare const location: {
      * @param watchId - Watch ID returned from watchPosition
      */
     clearWatch(watchId: number): void;
-    startRecording(options?: LocationOptions & RecordingStartOptions): Promise<LocationRecordingState>;
+    startRecording(options?: LocationOptions & RecordingStartOptions & LocationRecordingPowerOptions): Promise<LocationRecordingState>;
+    /**
+     * Change how hard the running recording works the GPS, for example to
+     * `'saver'` while the screen shows nothing but a countdown and back to
+     * `'default'` afterwards, or to `'auto'` to follow the device's own power
+     * saving. Resolves with the recording's state, which reports the mode asked
+     * for (`powerMode`) and the one in use (`effectivePowerMode`).
+     *
+     * Rejects with `NO_ACTIVE_RECORDING` when nothing is recording,
+     * `RECORDING_CONFLICT` when `expectedId` is not the recording that is
+     * running, `INVALID_ARGUMENT` for an unknown mode, and
+     * `RECORDING_POWER_MODE_UNSUPPORTED` on a host built before this existed
+     * (check `supportsRecordingPowerMode()`).
+     */
+    setRecordingPowerMode(options: LocationRecordingPowerModeOptions): Promise<LocationRecordingState>;
     pauseRecording(options?: RecordingOwnershipOptions): Promise<LocationRecordingState>;
     resumeRecording(options?: RecordingOwnershipOptions): Promise<LocationRecordingState>;
     stopRecording(options?: RecordingOwnershipOptions): Promise<LocationRecordingResult>;
     getRecordingState(options?: RecordingOwnershipOptions): Promise<LocationRecordingState>;
     acknowledgeRecording(options: RecordingOwnershipOptions): Promise<boolean>;
-    readRecording(options?: RecordingOwnershipOptions): Promise<Location[]>;
+    /**
+     * The recording's fixes. With `since`, iOS reads only the fixes after it
+     * from the end of the track; a host that does not know `since` answers with
+     * every fix, so a caller skips those it already has.
+     */
+    readRecording(options?: LocationRecordingReadOptions): Promise<Location[]>;
 };
 /**
  * Share options.

package/dist/cli.js

@@ -3047,7 +3047,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.395";
+var version = "0.0.408";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/components/index.d.ts

@@ -55,10 +55,14 @@ export interface FlexStyle {
     /** Column gap */
     columnGap?: number;
 }
+/** Hit targeting at an authored native component boundary. */
+export type PointerEvents = 'auto' | 'none' | 'box-none' | 'box-only';
 /**
  * Layout style properties.
  */
 export interface LayoutStyle {
+    /** Native pointer policy; a non-null prop overrides this style value. */
+    pointerEvents?: PointerEvents | null;
     /** Width */
     width?: number | string;
     /** Height */
@@ -281,7 +285,13 @@ export type TextStyle = ViewStyle & TextStyleProps;
 /**
  * Image-specific style properties.
  */
+/** Explicit CSS-facing native image sizing. Legacy resizeMode remains unchanged. */
+export type ImageObjectFit = 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
 export interface ImageStyleProps {
+    /** Explicit fit; null clears the style value. */
+    objectFit?: ImageObjectFit | null;
+    /** One/two alignment keywords or percentages; defaults to center. */
+    objectPosition?: string | null;
     /** Resize mode */
     resizeMode?: 'cover' | 'contain' | 'stretch' | 'center';
     /** Tint color */
@@ -297,6 +307,8 @@ export type StyleValue<T> = T | StyleValue<T>[] | null | false | undefined;
  * Base props for all components.
  */
 export interface BaseProps {
+    /** Native hit targeting. Null clears the override and falls back to style. */
+    pointerEvents?: PointerEvents | null;
     /** Unique identifier */
     id?: string;
     /** Test ID for testing */
@@ -422,6 +434,10 @@ export interface ImageErrorEvent {
  * Image component props.
  */
 export interface ImageProps extends BaseProps {
+    /** Non-null props override style; removing both restores legacy resizeMode. */
+    objectFit?: ImageObjectFit | null;
+    /** One/two alignment keywords or percentages, e.g. "right top" or "25% 75%". */
+    objectPosition?: string | null;
     /** Image source */
     source: ImageSource;
     /** Style object or array */

package/dist/index.cjs

@@ -375,7 +375,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.395";
+var version = "0.0.408";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -5491,6 +5491,7 @@ var secureStorage = {
     Object.keys(localStorage).filter((k) => k.startsWith("secure_")).forEach((k) => localStorage.removeItem(k));
   }
 };
+var RECORDING_POWER_MODES = ["default", "saver", "auto"];
 function storageHost(method) {
   const host = getCraftRoot()?.storage;
   if (typeof host?.[method] !== "function")
@@ -5554,6 +5555,23 @@ function recordingIntentSupported(namespace) {
   const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
   return advertised && recordingOwnershipSupported(namespace) && typeof root?.[namespace]?.startRecording === "function";
 }
+function recordingPowerModeSupported() {
+  const root = getCraftRoot();
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes("locationRecordingPowerMode") : caps?.locationRecordingPowerMode === true;
+  return advertised && recordingOwnershipSupported("location") && typeof root?.location?.setRecordingPowerMode === "function";
+}
+function validatePowerMode(value) {
+  if (typeof value !== "string" || !RECORDING_POWER_MODES.includes(value))
+    throw Object.assign(new Error("powerMode must be 'default', 'saver' or 'auto'"), { code: "INVALID_ARGUMENT" });
+  return value;
+}
+function validateRecordingPowerStart(options) {
+  if (!Object.prototype.hasOwnProperty.call(options, "powerMode") || options.powerMode === undefined)
+    return;
+  if (validatePowerMode(options.powerMode) === "auto" && getCraftRoot() && !recordingPowerModeSupported())
+    throw Object.assign(new Error("This app build cannot start a recording in powerMode 'auto'"), { code: "RECORDING_POWER_MODE_UNSUPPORTED" });
+}
 function validateRecordingStart(namespace, options) {
   if (!Object.prototype.hasOwnProperty.call(options, "recordingId"))
     return;
@@ -5584,10 +5602,20 @@ var webLocationRecording = {
   startedAt: null,
   locations: []
 };
+var webLocationPowerMode = "default";
+function webLocationRecordingState() {
+  return {
+    ...webLocationRecording,
+    sampleCount: webLocationRecording.locations.length,
+    powerMode: webLocationPowerMode,
+    effectivePowerMode: webLocationRecording.active && webLocationPowerMode === "saver" ? "saver" : "default"
+  };
+}
 var webLocationRecordingWatchId = null;
 var location = {
   supportsRecordingOwnership: () => recordingOwnershipSupported("location"),
   supportsRecordingIntentIdentity: () => recordingIntentSupported("location"),
+  supportsRecordingPowerMode: () => recordingPowerModeSupported(),
   async getCurrentPosition(options = {}) {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location) {
@@ -5637,6 +5665,7 @@ var location = {
   },
   async startRecording(options = {}) {
     validateRecordingStart("location", options);
+    validateRecordingPowerStart(options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.startRecording)
       return verifyRecordingStart(options, await craft.location.startRecording(options));
@@ -5651,11 +5680,27 @@ var location = {
       startedAt: Date.now(),
       locations: []
     };
+    webLocationPowerMode = options.powerMode ?? "default";
     webLocationRecordingWatchId = location.watchPosition((position) => {
       if (!webLocationRecording.paused)
         webLocationRecording.locations.push(position);
     }, options);
-    return { ...webLocationRecording, sampleCount: 0 };
+    return webLocationRecordingState();
+  },
+  async setRecordingPowerMode(options) {
+    if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+      throw Object.assign(new Error("setRecordingPowerMode needs expectedId"), { code: "INVALID_ARGUMENT" });
+    validateRecordingOwnership("location", options);
+    const powerMode = validatePowerMode(options.powerMode);
+    if (getCraftRoot() && !recordingPowerModeSupported())
+      throw Object.assign(new Error("This app build cannot change the recording power mode"), { code: "RECORDING_POWER_MODE_UNSUPPORTED" });
+    const craft = getCraftMobile();
+    if (typeof window !== "undefined" && craft?.location?.setRecordingPowerMode)
+      return craft.location.setRecordingPowerMode({ expectedId: options.expectedId, powerMode });
+    if (!webLocationRecording.active)
+      throw Object.assign(new Error("No active location recording"), { code: "NO_ACTIVE_RECORDING" });
+    webLocationPowerMode = powerMode;
+    return webLocationRecordingState();
   },
   async pauseRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5663,7 +5708,7 @@ var location = {
     if (typeof window !== "undefined" && craft?.location?.pauseRecording)
       return craft.location.pauseRecording(options);
     webLocationRecording.paused = true;
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async resumeRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5671,7 +5716,7 @@ var location = {
     if (typeof window !== "undefined" && craft?.location?.resumeRecording)
       return craft.location.resumeRecording(options);
     webLocationRecording.paused = false;
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async stopRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5684,14 +5729,14 @@ var location = {
     }
     webLocationRecording.active = false;
     webLocationRecording.paused = false;
-    return { ...webLocationRecording, locations: [...webLocationRecording.locations] };
+    return { ...webLocationRecordingState(), locations: [...webLocationRecording.locations] };
   },
   async getRecordingState(options) {
     validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.getRecordingState)
       return craft.location.getRecordingState(options);
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async acknowledgeRecording(options) {
     if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
@@ -5703,6 +5748,7 @@ var location = {
     if (webLocationRecording.active)
       throw Object.assign(new Error("The recording is still active"), { code: "RECORDING_ALREADY_ACTIVE" });
     webLocationRecording = { id: null, active: false, paused: false, startedAt: null, locations: [] };
+    webLocationPowerMode = "default";
     return true;
   },
   async readRecording(options) {
@@ -5710,7 +5756,8 @@ var location = {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.readRecording)
       return craft.location.readRecording(options);
-    return [...webLocationRecording.locations];
+    const since = options?.since;
+    return typeof since === "number" && Number.isFinite(since) ? webLocationRecording.locations.filter((location) => location.timestamp > since) : [...webLocationRecording.locations];
   }
 };
 var share = {

package/dist/index.d.cts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineOverlay, MapMarkerOverlay, MapPolylineProps, MapPolygonProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageObjectFit, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineOverlay, MapMarkerOverlay, MapPolylineProps, MapPolygonProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineOverlay, MapMarkerOverlay, MapPolylineProps, MapPolygonProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageObjectFit, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineOverlay, MapMarkerOverlay, MapPolylineProps, MapPolygonProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.js

@@ -117,7 +117,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.395";
+var version = "0.0.408";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -5247,6 +5247,7 @@ var secureStorage = {
     Object.keys(localStorage).filter((k) => k.startsWith("secure_")).forEach((k) => localStorage.removeItem(k));
   }
 };
+var RECORDING_POWER_MODES = ["default", "saver", "auto"];
 function storageHost(method) {
   const host = getCraftRoot()?.storage;
   if (typeof host?.[method] !== "function")
@@ -5310,6 +5311,23 @@ function recordingIntentSupported(namespace) {
   const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
   return advertised && recordingOwnershipSupported(namespace) && typeof root?.[namespace]?.startRecording === "function";
 }
+function recordingPowerModeSupported() {
+  const root = getCraftRoot();
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes("locationRecordingPowerMode") : caps?.locationRecordingPowerMode === true;
+  return advertised && recordingOwnershipSupported("location") && typeof root?.location?.setRecordingPowerMode === "function";
+}
+function validatePowerMode(value) {
+  if (typeof value !== "string" || !RECORDING_POWER_MODES.includes(value))
+    throw Object.assign(new Error("powerMode must be 'default', 'saver' or 'auto'"), { code: "INVALID_ARGUMENT" });
+  return value;
+}
+function validateRecordingPowerStart(options) {
+  if (!Object.prototype.hasOwnProperty.call(options, "powerMode") || options.powerMode === undefined)
+    return;
+  if (validatePowerMode(options.powerMode) === "auto" && getCraftRoot() && !recordingPowerModeSupported())
+    throw Object.assign(new Error("This app build cannot start a recording in powerMode 'auto'"), { code: "RECORDING_POWER_MODE_UNSUPPORTED" });
+}
 function validateRecordingStart(namespace, options) {
   if (!Object.prototype.hasOwnProperty.call(options, "recordingId"))
     return;
@@ -5340,10 +5358,20 @@ var webLocationRecording = {
   startedAt: null,
   locations: []
 };
+var webLocationPowerMode = "default";
+function webLocationRecordingState() {
+  return {
+    ...webLocationRecording,
+    sampleCount: webLocationRecording.locations.length,
+    powerMode: webLocationPowerMode,
+    effectivePowerMode: webLocationRecording.active && webLocationPowerMode === "saver" ? "saver" : "default"
+  };
+}
 var webLocationRecordingWatchId = null;
 var location = {
   supportsRecordingOwnership: () => recordingOwnershipSupported("location"),
   supportsRecordingIntentIdentity: () => recordingIntentSupported("location"),
+  supportsRecordingPowerMode: () => recordingPowerModeSupported(),
   async getCurrentPosition(options = {}) {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location) {
@@ -5393,6 +5421,7 @@ var location = {
   },
   async startRecording(options = {}) {
     validateRecordingStart("location", options);
+    validateRecordingPowerStart(options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.startRecording)
       return verifyRecordingStart(options, await craft.location.startRecording(options));
@@ -5407,11 +5436,27 @@ var location = {
       startedAt: Date.now(),
       locations: []
     };
+    webLocationPowerMode = options.powerMode ?? "default";
     webLocationRecordingWatchId = location.watchPosition((position) => {
       if (!webLocationRecording.paused)
         webLocationRecording.locations.push(position);
     }, options);
-    return { ...webLocationRecording, sampleCount: 0 };
+    return webLocationRecordingState();
+  },
+  async setRecordingPowerMode(options) {
+    if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+      throw Object.assign(new Error("setRecordingPowerMode needs expectedId"), { code: "INVALID_ARGUMENT" });
+    validateRecordingOwnership("location", options);
+    const powerMode = validatePowerMode(options.powerMode);
+    if (getCraftRoot() && !recordingPowerModeSupported())
+      throw Object.assign(new Error("This app build cannot change the recording power mode"), { code: "RECORDING_POWER_MODE_UNSUPPORTED" });
+    const craft = getCraftMobile();
+    if (typeof window !== "undefined" && craft?.location?.setRecordingPowerMode)
+      return craft.location.setRecordingPowerMode({ expectedId: options.expectedId, powerMode });
+    if (!webLocationRecording.active)
+      throw Object.assign(new Error("No active location recording"), { code: "NO_ACTIVE_RECORDING" });
+    webLocationPowerMode = powerMode;
+    return webLocationRecordingState();
   },
   async pauseRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5419,7 +5464,7 @@ var location = {
     if (typeof window !== "undefined" && craft?.location?.pauseRecording)
       return craft.location.pauseRecording(options);
     webLocationRecording.paused = true;
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async resumeRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5427,7 +5472,7 @@ var location = {
     if (typeof window !== "undefined" && craft?.location?.resumeRecording)
       return craft.location.resumeRecording(options);
     webLocationRecording.paused = false;
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async stopRecording(options) {
     validateRecordingOwnership("location", options);
@@ -5440,14 +5485,14 @@ var location = {
     }
     webLocationRecording.active = false;
     webLocationRecording.paused = false;
-    return { ...webLocationRecording, locations: [...webLocationRecording.locations] };
+    return { ...webLocationRecordingState(), locations: [...webLocationRecording.locations] };
   },
   async getRecordingState(options) {
     validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.getRecordingState)
       return craft.location.getRecordingState(options);
-    return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
+    return webLocationRecordingState();
   },
   async acknowledgeRecording(options) {
     if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
@@ -5459,6 +5504,7 @@ var location = {
     if (webLocationRecording.active)
       throw Object.assign(new Error("The recording is still active"), { code: "RECORDING_ALREADY_ACTIVE" });
     webLocationRecording = { id: null, active: false, paused: false, startedAt: null, locations: [] };
+    webLocationPowerMode = "default";
     return true;
   },
   async readRecording(options) {
@@ -5466,7 +5512,8 @@ var location = {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.readRecording)
       return craft.location.readRecording(options);
-    return [...webLocationRecording.locations];
+    const since = options?.since;
+    return typeof since === "number" && Number.isFinite(since) ? webLocationRecording.locations.filter((location) => location.timestamp > since) : [...webLocationRecording.locations];
   }
 };
 var share = {

package/dist/ios/src/index.d.ts

@@ -46,6 +46,13 @@ export interface CraftConfig {
     backgroundColor?: string;
     /** Default tint for native controls and selected tabs, as #RRGGBB. */
     tintColor?: string;
+    /**
+     * CSS font stack for the native chrome's labels (tab bar, bar buttons); the
+     * first family packaged in `nativeFonts` wins, a generic one keeps the system face.
+     */
+    fontFamily?: string;
+    /** CSS font stack for navigation titles; `fontFamily` when unset. */
+    headingFontFamily?: string;
     /** The launch and webview background while the phone is in Dark Mode. */
     backgroundColorDark?: string;
     /** Edge-swipe back and forward through the page's history, pushState entries included. */