@use-voltra/ios 2.3.2 → 2.4.0

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

@@ -0,0 +1,290 @@
+export type { IosModifier } from './createIosModifier.js';
+export type ClipShape = 'rectangle' | 'roundedRectangle' | 'circle' | 'capsule' | 'ellipse';
+export type ClipShapeOptions = {
+    /** Corner radius for `roundedRectangle`. */
+    cornerRadius?: number;
+    /** Corner style for `roundedRectangle` and `capsule`. Defaults to `circular`. */
+    cornerStyle?: 'circular' | 'continuous';
+};
+export type RedactionReason = 'placeholder' | 'privacy' | 'invalidated';
+export type ContentTransition = 'identity' | 'opacity' | 'interpolate' | 'numericText' | 'symbolEffect';
+export type Transition = 'identity' | 'opacity' | 'scale' | 'slide' | 'push' | 'move';
+export type Edge = 'top' | 'bottom' | 'leading' | 'trailing';
+export type AnimationCurve = 'default' | 'linear' | 'easeIn' | 'easeOut' | 'easeInOut' | 'spring' | 'bouncy' | 'smooth' | 'snappy';
+export type DynamicTypeSize = 'xSmall' | 'small' | 'medium' | 'large' | 'xLarge' | 'xxLarge' | 'xxxLarge' | 'accessibility1' | 'accessibility2' | 'accessibility3' | 'accessibility4' | 'accessibility5';
+export type BlendMode = 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'colorDodge' | 'colorBurn' | 'softLight' | 'hardLight' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' | 'sourceAtop' | 'destinationOver' | 'destinationOut' | 'plusDarker' | 'plusLighter';
+export type SymbolEffect = 'pulse' | 'variableColor' | 'breathe' | 'rotate' | 'wiggle';
+/**
+ * Opens the URL in the app when the widget or Live Activity is tapped. Takes an absolute URL or a
+ * path, which gets the app's URL scheme like `deepLinkUrl`. Use it once per widget, or once per
+ * Live Activity presentation. It replaces Voltra's default widget link, but a `deepLinkUrl`
+ * configured for the widget or Live Activity takes precedence. A tap on the compact or minimal
+ * Dynamic Island ignores it: pass `deepLinkUrl` when starting the Live Activity instead.
+ *
+ * @since iOS 14.0
+ */
+export declare const widgetURL: (url: string) => import("./createIosModifier.js").IosModifier & Readonly<{
+    url: string;
+}>;
+/**
+ * Sets the widget's container background, which the system removes in contexts such as StandBy
+ * and tinted Home Screens. Use it on the widget's outermost component.
+ *
+ * @since iOS 17.0
+ */
+export declare const containerBackground: (color: string) => import("./createIosModifier.js").IosModifier & Readonly<{
+    color: string;
+}>;
+/**
+ * Adds the component to the accent group when the widget renders in accented mode.
+ *
+ * @since iOS 16.0
+ */
+export declare const widgetAccentable: (accentable?: boolean) => import("./createIosModifier.js").IosModifier & Readonly<{
+    accentable: boolean;
+}>;
+/**
+ * Redacts the view when the widget is shown on a locked device.
+ *
+ * @since iOS 15.0
+ */
+export declare const privacySensitive: (sensitive?: boolean) => import("./createIosModifier.js").IosModifier & Readonly<{
+    sensitive: boolean;
+}>;
+/**
+ * Renders the component redacted, for example as a placeholder.
+ *
+ * @since iOS 14.0
+ */
+export declare const redacted: (reason: RedactionReason) => import("./createIosModifier.js").IosModifier & Readonly<{
+    reason: RedactionReason;
+}>;
+/**
+ * Keeps the component visible inside a redacted container.
+ *
+ * @since iOS 14.0
+ */
+export declare const unredacted: () => import("./createIosModifier.js").IosModifier & Readonly<Record<string, unknown>>;
+/**
+ * Marks content that goes stale while an interactive widget performs an update.
+ *
+ * @since iOS 17.0
+ */
+export declare const invalidatableContent: (invalidatable?: boolean) => import("./createIosModifier.js").IosModifier & Readonly<{
+    invalidatable: boolean;
+}>;
+/**
+ * Tints the Live Activity's Lock Screen background. `null` uses the system default. It has no
+ * effect in the Dynamic Island or in widgets, and an `activityBackgroundTint` passed when starting
+ * or updating the Live Activity takes precedence.
+ *
+ * @since iOS 16.1
+ */
+export declare const activityBackgroundTint: (color: string | null) => import("./createIosModifier.js").IosModifier & Readonly<{
+    color: string | null;
+}>;
+/**
+ * Sets the color of the system action button shown next to the Live Activity. `null` uses the
+ * system default.
+ *
+ * @since iOS 16.1
+ */
+export declare const activitySystemActionForegroundColor: (color: string | null) => import("./createIosModifier.js").IosModifier & Readonly<{
+    color: string | null;
+}>;
+/**
+ * Animates changes to the content between updates: timeline entries, activity states, or renders
+ * of an in-app preview. Pair it with `animation` on the same component.
+ *
+ * @since iOS 16.0. `symbolEffect` requires iOS 17.0.
+ */
+export declare const contentTransition: (transition: ContentTransition, options?: {
+    countsDown?: boolean;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    transition: ContentTransition;
+    countsDown: boolean | undefined;
+}>;
+/**
+ * Animates the component in or out when it appears or disappears between two updates. It has no
+ * effect on a component that is present in both. The insertion is animated by the parent, so put
+ * `animation` with the value that toggles the component on a parent that stays, and give the
+ * siblings an `id` so SwiftUI can tell which one appeared.
+ *
+ * @since iOS 16.0
+ */
+export declare const transition: (transition: Transition, options?: {
+    edge?: Edge;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    transition: Transition;
+    edge: Edge | undefined;
+}>;
+/**
+ * Animates the component when `value` changes between updates. `duration` applies to `linear`,
+ * `easeIn`, `easeOut`, `easeInOut`, `bouncy`, `smooth` and `snappy`; `default` and `spring` use
+ * the system timing.
+ *
+ * @since iOS 13.0. `bouncy`, `smooth` and `snappy` require iOS 17.0.
+ */
+export declare const animation: (curve: AnimationCurve, options: {
+    value: string | number | boolean;
+    duration?: number;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    curve: AnimationCurve;
+    value: string | number | boolean;
+    duration: number | undefined;
+}>;
+/**
+ * Applies an indefinite SF Symbol effect to `Symbol` components inside. The system decides whether
+ * it animates: in-app previews play it, while widgets and Live Activities may show a still frame.
+ *
+ * @since iOS 17.0. `breathe`, `rotate` and `wiggle` require iOS 18.0.
+ */
+export declare const symbolEffect: (effect: SymbolEffect) => import("./createIosModifier.js").IosModifier & Readonly<{
+    effect: SymbolEffect;
+}>;
+/**
+ * Clips the finished component, background included, to a shape.
+ *
+ * @since iOS 13.0
+ */
+export declare const clipShape: (shape: ClipShape, options?: ClipShapeOptions) => import("./createIosModifier.js").IosModifier & Readonly<{
+    shape: ClipShape;
+    cornerRadius: number | undefined;
+    cornerStyle: "circular" | "continuous" | undefined;
+}>;
+/**
+ * Applies a Gaussian blur.
+ *
+ * @since iOS 13.0
+ */
+export declare const blur: (radius: number, options?: {
+    opaque?: boolean;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    radius: number;
+    opaque: boolean | undefined;
+}>;
+/** @since iOS 13.0 */
+export declare const grayscale: (amount: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    amount: number;
+}>;
+/** @since iOS 13.0 */
+export declare const saturation: (amount: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    amount: number;
+}>;
+/** @since iOS 13.0 */
+export declare const brightness: (amount: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    amount: number;
+}>;
+/** @since iOS 13.0 */
+export declare const contrast: (amount: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    amount: number;
+}>;
+/**
+ * Sets how the component composites with the content behind it.
+ *
+ * @since iOS 13.0
+ */
+export declare const blendMode: (mode: BlendMode) => import("./createIosModifier.js").IosModifier & Readonly<{
+    mode: BlendMode;
+}>;
+/**
+ * Rotates the rendered component around its center without changing its layout.
+ *
+ * @since iOS 13.0
+ */
+export declare const rotationEffect: (degrees: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    degrees: number;
+}>;
+/**
+ * Scales the rendered component around its center without changing its layout.
+ *
+ * @since iOS 13.0
+ */
+export declare const scaleEffect: (scale: number | {
+    x?: number;
+    y?: number;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    x: number | undefined;
+    y: number | undefined;
+}>;
+/**
+ * Moves the rendered component without changing its layout.
+ *
+ * @since iOS 13.0
+ */
+export declare const offset: (value: {
+    x?: number;
+    y?: number;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    x: number | undefined;
+    y: number | undefined;
+}>;
+/**
+ * Keeps the component at its ideal size on the given axes instead of letting the parent shrink it.
+ *
+ * @since iOS 13.0
+ */
+export declare const fixedSize: (axes?: {
+    horizontal?: boolean;
+    vertical?: boolean;
+}) => import("./createIosModifier.js").IosModifier & Readonly<{
+    horizontal: boolean | undefined;
+    vertical: boolean | undefined;
+}>;
+/**
+ * Gives the component a larger or smaller share of space in its stack.
+ *
+ * @since iOS 13.0
+ */
+export declare const layoutPriority: (priority: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    priority: number;
+}>;
+/**
+ * Sizes the component relative to its nearest container, such as the widget.
+ *
+ * @since iOS 17.0
+ */
+export declare const containerRelativeFrame: (axes: "horizontal" | "vertical" | "both") => import("./createIosModifier.js").IosModifier & Readonly<{
+    axes: "horizontal" | "vertical" | "both";
+}>;
+/**
+ * Uses a fixed Dynamic Type size for content inside the component, regardless of the system
+ * setting. Voltra `Text` uses fixed font sizes, so it does not change.
+ *
+ * @since iOS 15.0
+ */
+export declare const dynamicTypeSize: (size: DynamicTypeSize) => import("./createIosModifier.js").IosModifier & Readonly<{
+    size: DynamicTypeSize;
+}>;
+/**
+ * Lets text inside shrink down to this fraction of its font size to fit.
+ *
+ * @since iOS 13.0
+ */
+export declare const minimumScaleFactor: (factor: number) => import("./createIosModifier.js").IosModifier & Readonly<{
+    factor: number;
+}>;
+/**
+ * Sets where text inside is truncated when it does not fit.
+ *
+ * @since iOS 13.0
+ */
+export declare const truncationMode: (mode: "head" | "middle" | "tail") => import("./createIosModifier.js").IosModifier & Readonly<{
+    mode: "head" | "middle" | "tail";
+}>;
+/**
+ * Aligns the lines of multi-line text inside. A `Text` with `style.textAlign` or its own
+ * `multilineTextAlignment` prop keeps that value.
+ *
+ * @since iOS 13.0
+ */
+export declare const multilineTextAlignment: (alignment: "leading" | "center" | "trailing") => import("./createIosModifier.js").IosModifier & Readonly<{
+    alignment: "center" | "leading" | "trailing";
+}>;
+/**
+ * Uses fixed-width digits for text inside, so changing numbers do not shift.
+ *
+ * @since iOS 16.0
+ */
+export declare const monospacedDigit: () => import("./createIosModifier.js").IosModifier & Readonly<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modifiers/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-voltra/ios",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "Voltra for iOS",
   "main": "build/commonjs/index.js",
   "module": "build/module/index.js",
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@use-voltra/core": "^2.3.2"
+    "@use-voltra/core": "^2.4.0"
   },
   "keywords": [
     "react-native",

package/src/index.ts

@@ -43,5 +43,12 @@ export type {
 } from './types.js'
 export { renderWidgetToJson, renderWidgetToString } from './widgets/renderer.js'
 export type { ScheduledWidgetEntry, WidgetFamily, WidgetInfo, WidgetVariants } from './widgets/types.js'
-export { getFastRefreshHub, isAndroidEnv, isIosEnv, useUpdateOnHMR } from '@use-voltra/core'
-export type { FastRefreshHub, WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core'
+export {
+  getFastRefreshHub,
+  isAndroidEnv,
+  isIosEnv,
+  pickLocalizedValue,
+  resolveLocale,
+  useUpdateOnHMR,
+} from '@use-voltra/core'
+export type { FastRefreshHub, LocaleEnvironment, WidgetBuildEnvironment, WidgetEnvironment } from '@use-voltra/core'

package/src/jsx/baseProps.tsx

@@ -1,9 +1,17 @@
+import type { NativeModifiersProp } from '@use-voltra/core'
 import { ReactNode } from 'react'
 
+import type { IosModifier } from '../modifiers/createIosModifier.js'
 import type { VoltraStyleProp } from '../styles/index.js'
 
 export type VoltraBaseProps = {
   id?: string
   style?: VoltraStyleProp
+  /**
+   * SwiftUI modifiers from `Voltra.modifiers`, applied on top of the styled component in array
+   * order: the first entry is innermost. Falsy entries, such as `count && modifier` with `count = 0`,
+   * mean no modifier.
+   */
+  modifiers?: NativeModifiersProp<IosModifier>
   children?: ReactNode
 }

package/src/jsx/primitives.ts

@@ -27,3 +27,4 @@ export * from './Toggle.js'
 export * from './View.js'
 export * from './VStack.js'
 export * from './ZStack.js'
+export * as modifiers from '../modifiers/index.js'

package/src/live-activity/types.ts

@@ -12,7 +12,19 @@ import type { VoltraNodeJson } from '../types.js'
  */
 export type LiveActivityEnvironment = Pick<
   WidgetEnvironment,
-  'date' | 'colorScheme' | 'locale' | 'widgetRenderingMode' | 'build'
+  | 'date'
+  | 'colorScheme'
+  | 'locale'
+  | 'preferredLanguages'
+  | 'appLocale'
+  | 'layoutDirection'
+  | 'hourCycle'
+  | 'timeZone'
+  | 'measurementSystem'
+  | 'calendar'
+  | 'firstDayOfWeek'
+  | 'widgetRenderingMode'
+  | 'build'
 > & {
   /** Whether ActivityKit currently considers this activity stale. */
   isStale: boolean

package/src/modifiers/createIosModifier.ts

@@ -0,0 +1,20 @@
+declare const IOS_MODIFIER_BRAND: unique symbol
+
+/**
+ * A SwiftUI modifier descriptor produced by a `Voltra.modifiers` factory. The brand exists only
+ * in the type system, so an Android modifier cannot be passed to a `Voltra` component.
+ */
+export type IosModifier = {
+  readonly $type: string
+  readonly [IOS_MODIFIER_BRAND]: 'ios'
+}
+
+export const createIosModifier = <Params extends Record<string, unknown>>(
+  type: string,
+  params?: Params
+): IosModifier & Readonly<Params> =>
+  // Omitted options stay out of the descriptor instead of appearing as `undefined` keys.
+  Object.freeze({
+    ...Object.fromEntries(Object.entries(params ?? {}).filter(([, value]) => value !== undefined)),
+    $type: type,
+  }) as unknown as IosModifier & Readonly<Params>