@appsent-co/react-native-watchos 0.1.0

package/src/modifiers/containerBackground.ts

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+import { createModifier } from './createModifier';
+
+/// Which container the background applies to.
+export type ContainerBackgroundPlacement = 'navigation' | 'tabView' | 'widget';
+
+export interface ContainerBackgroundParams {
+  /// A shape style for the background — a color (`'red'`, `'#RRGGBB'`),
+  /// a semantic level (`'primary'`, …), `'tint'`, or a material
+  /// (`'regularMaterial'`, …). Ignored when `content` is provided.
+  style?: string;
+  /// An arbitrary view to use as the background instead of a `style`.
+  /// Takes precedence over `style` when both are set.
+  content?: ReactNode;
+  /// The container to attach the background to. Defaults to
+  /// `'navigation'`.
+  container?: ContainerBackgroundPlacement;
+}
+
+/// SwiftUI `.containerBackground(_:for:)` / `.containerBackground(for:){…}`.
+/// Sets the background of an enclosing container (the navigation stack by
+/// default). Requires watchOS 10+; on older systems the view is returned
+/// unchanged.
+export function containerBackground(
+  params: ContainerBackgroundParams
+): ReturnType<typeof createModifier>;
+export function containerBackground(
+  style: string,
+  container?: ContainerBackgroundPlacement
+): ReturnType<typeof createModifier>;
+export function containerBackground(
+  a: ContainerBackgroundParams | string,
+  container?: ContainerBackgroundPlacement
+) {
+  if (typeof a === 'string') {
+    return createModifier('containerBackground', { style: a, container });
+  }
+  return createModifier('containerBackground', a);
+}

package/src/modifiers/containerGrid.ts

@@ -0,0 +1,40 @@
+// "Container / grid" modifiers — re-exports the factories this unit adds.
+export {
+  containerShape,
+  type ContainerShapeName,
+  type ContainerShapeParams,
+} from './containerShape';
+export {
+  containerRelativeFrame,
+  type ContainerRelativeFrameAxes,
+  type ContainerRelativeFrameAlignment,
+  type ContainerRelativeFrameParams,
+} from './containerRelativeFrame';
+export {
+  containerValue,
+  type ContainerValueParams,
+} from './containerValue';
+export {
+  containerBackground,
+  type ContainerBackgroundPlacement,
+  type ContainerBackgroundParams,
+} from './containerBackground';
+export {
+  gridCellAnchor,
+  type GridCellAnchor,
+  type GridCellAnchorParams,
+} from './gridCellAnchor';
+export {
+  gridCellColumns,
+  type GridCellColumnsParams,
+} from './gridCellColumns';
+export {
+  gridCellUnsizedAxes,
+  type GridCellUnsizedAxesValue,
+  type GridCellUnsizedAxesParams,
+} from './gridCellUnsizedAxes';
+export {
+  gridColumnAlignment,
+  type GridColumnAlignmentGuide,
+  type GridColumnAlignmentParams,
+} from './gridColumnAlignment';

package/src/modifiers/containerRelativeFrame.ts

@@ -0,0 +1,32 @@
+import { createModifier } from './createModifier';
+
+/// Axes the relative frame should expand along.
+export type ContainerRelativeFrameAxes = 'horizontal' | 'vertical' | 'both';
+
+/// Where to position the view within the container-relative frame.
+export type ContainerRelativeFrameAlignment =
+  | 'leading'
+  | 'trailing'
+  | 'center'
+  | 'top'
+  | 'bottom'
+  | 'topLeading'
+  | 'topTrailing'
+  | 'bottomLeading'
+  | 'bottomTrailing';
+
+export interface ContainerRelativeFrameParams {
+  /// Which axes to size relative to the nearest container. Defaults to
+  /// `'both'`.
+  axes?: ContainerRelativeFrameAxes;
+  /// Alignment of the content inside the resulting frame. Defaults to
+  /// `'center'`.
+  alignment?: ContainerRelativeFrameAlignment;
+}
+
+/// SwiftUI `.containerRelativeFrame(_:alignment:)`. Sizes the view relative
+/// to the nearest container (scroll view, navigation root, …). Requires
+/// watchOS 10+; on older systems the view is returned unchanged.
+export function containerRelativeFrame(params: ContainerRelativeFrameParams = {}) {
+  return createModifier('containerRelativeFrame', params);
+}

package/src/modifiers/containerShape.ts

@@ -0,0 +1,35 @@
+import { createModifier } from './createModifier';
+
+/// Named shape used to clip a container's background / content shape.
+export type ContainerShapeName =
+  | 'rectangle'
+  | 'circle'
+  | 'capsule'
+  | 'roundedRectangle';
+
+export interface ContainerShapeParams {
+  /// Which built-in shape to use as the container shape.
+  shape: ContainerShapeName;
+  /// Corner radius — only used when `shape` is `'roundedRectangle'`.
+  cornerRadius?: number;
+}
+
+/// SwiftUI `.containerShape(_:)`. Sets the preferred shape for the
+/// container so descendant content (e.g. `.containerBackground`,
+/// `.buttonBorderShape(.containerRelative)`) can adopt it.
+export function containerShape(
+  params: ContainerShapeParams
+): ReturnType<typeof createModifier>;
+export function containerShape(
+  shape: ContainerShapeName,
+  cornerRadius?: number
+): ReturnType<typeof createModifier>;
+export function containerShape(
+  a: ContainerShapeParams | ContainerShapeName,
+  cornerRadius?: number
+) {
+  if (typeof a === 'string') {
+    return createModifier('containerShape', { shape: a, cornerRadius });
+  }
+  return createModifier('containerShape', a);
+}

package/src/modifiers/containerValue.ts

@@ -0,0 +1,22 @@
+import { createModifier } from './createModifier';
+
+export interface ContainerValueParams {
+  /// The container-values key to set. Only keys the native side knows how
+  /// to resolve take effect.
+  key: string;
+  /// The value to associate with `key`.
+  value?: unknown;
+}
+
+/// SwiftUI `.containerValue(_:_:)` (watchOS 11+). This sets a value for a
+/// `ContainerValues` key path so a custom container can read it back.
+///
+/// LIMITATION: `ContainerValues` keys are defined by a Swift
+/// `@Entry`/`EnvironmentKey`-style declaration and addressed by static
+/// key path — there is no general way to look one up from a runtime string
+/// across the bridge. The native side therefore implements this as a no-op
+/// (the view is returned unchanged). Kept for API completeness so JS that
+/// references it still type-checks.
+export function containerValue(params: ContainerValueParams) {
+  return createModifier('containerValue', params);
+}

package/src/modifiers/contentMargins.ts

@@ -0,0 +1,36 @@
+import { createModifier } from './createModifier';
+
+/// Edge name(s) the margin applies to. A single edge, one of the grouping
+/// keywords, or an array of edge names — parsed natively via the shared
+/// edge parser. Defaults to `all`.
+export type ContentMarginEdge =
+  | 'top'
+  | 'bottom'
+  | 'leading'
+  | 'trailing'
+  | 'horizontal'
+  | 'vertical'
+  | 'all';
+
+export interface ContentMarginsParams {
+  /// Edges to inset. Defaults to `all`.
+  edges?: ContentMarginEdge | ContentMarginEdge[];
+  /// Margin length in points.
+  length: number;
+}
+
+/// SwiftUI `.contentMargins(_:_:for:)`. Adds margins around the content of
+/// a scrollable view (applied for the `.scrollContent` placement). Gated
+/// to watchOS 10+ natively; a no-op on older systems.
+export function contentMargins(
+  length: number
+): ReturnType<typeof createModifier>;
+export function contentMargins(
+  params: ContentMarginsParams
+): ReturnType<typeof createModifier>;
+export function contentMargins(a: number | ContentMarginsParams) {
+  if (typeof a === 'number') {
+    return createModifier('contentMargins', { edges: 'all', length: a });
+  }
+  return createModifier('contentMargins', { edges: 'all', ...a });
+}

package/src/modifiers/contentShape.ts

@@ -0,0 +1,27 @@
+import { createModifier } from './createModifier';
+
+export type ContentShapeKind =
+  | 'rectangle'
+  | 'circle'
+  | 'capsule'
+  | 'roundedRectangle';
+
+export interface ContentShapeParams {
+  /// The shape used for hit testing (and interaction/preview shaping).
+  /// Defaults to `'rectangle'`.
+  shape?: ContentShapeKind;
+  /// Corner radius in points, used only when `shape` is `'roundedRectangle'`.
+  cornerRadius?: number;
+}
+
+/// SwiftUI `.contentShape(_:)`. Defines the hit-testing area of the view
+/// using a simple shape. Useful to make an entire (partly transparent)
+/// region tappable, or to clip the touchable area to a circle/capsule.
+export function contentShape(
+  shape?: ContentShapeKind | ContentShapeParams
+) {
+  if (typeof shape === 'string') {
+    return createModifier('contentShape', { shape });
+  }
+  return createModifier('contentShape', shape ?? {});
+}

package/src/modifiers/contextMenu.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+
+import { createModifier } from './createModifier';
+
+export interface ContextMenuParams {
+  /// The menu items, rendered as the context menu's content (typically a set
+  /// of `Button`s). Hoisted into a content slot by `useModifiers`.
+  content: ReactNode;
+}
+
+/// SwiftUI `.contextMenu { … }`. Attaches a long-press context menu whose
+/// body is `content`.
+///
+/// ```tsx
+/// <Text modifiers={[contextMenu({ content: <Button title="Delete" .../> })]} />
+/// ```
+export function contextMenu(content: ReactNode): ReturnType<typeof createModifier>;
+export function contextMenu(
+  params: ContextMenuParams
+): ReturnType<typeof createModifier>;
+export function contextMenu(a: ContextMenuParams | ReactNode) {
+  if (a != null && typeof a === 'object' && 'content' in a) {
+    return createModifier('contextMenu', { content: (a as ContextMenuParams).content });
+  }
+  return createModifier('contextMenu', { content: a as ReactNode });
+}

package/src/modifiers/contrast.ts

@@ -0,0 +1,8 @@
+import { createModifier } from './createModifier';
+
+/// SwiftUI `.contrast(_:)`. Multiplies the view's color contrast by
+/// `value`. `1` is unchanged, `0` is solid gray, values `> 1` increase
+/// contrast, and negative values invert colors.
+export function contrast(value: number) {
+  return createModifier('contrast', { value });
+}

package/src/modifiers/controlSize.ts

@@ -0,0 +1,15 @@
+import { createModifier } from './createModifier';
+
+export type ControlSize =
+  | 'mini'
+  | 'small'
+  | 'regular'
+  | 'large'
+  | 'extraLarge';
+
+/// SwiftUI `.controlSize(_:)`. Scales controls (buttons, toggles, …) within
+/// the view to the given size. `'extraLarge'` requires watchOS 10+ and
+/// falls back to `'large'` on older systems.
+export function controlSize(style: ControlSize = 'regular') {
+  return createModifier('controlSize', { style });
+}

package/src/modifiers/controlsPolish.ts

@@ -0,0 +1,23 @@
+// "Button & label polish" modifiers — button border/sizing/repeat behavior,
+// menu order/dismiss behavior, and control-label visibility/spacing helpers.
+export {
+  buttonBorderShape,
+  type ButtonBorderShapeValue,
+} from './buttonBorderShape';
+export {
+  buttonRepeatBehavior,
+  type ButtonRepeatBehaviorValue,
+} from './buttonRepeatBehavior';
+export { buttonSizing, type ButtonSizingValue } from './buttonSizing';
+export {
+  menuActionDismissBehavior,
+  type MenuActionDismissBehaviorValue,
+} from './menuActionDismissBehavior';
+export { menuOrder, type MenuOrderValue } from './menuOrder';
+export { labelsHidden } from './labelsHidden';
+export {
+  labelsVisibility,
+  type LabelsVisibilityValue,
+} from './labelsVisibility';
+export { labelIconToTitleSpacing } from './labelIconToTitleSpacing';
+export { labelReservedIconWidth } from './labelReservedIconWidth';

package/src/modifiers/coordinateSpace.ts

@@ -0,0 +1,21 @@
+import { createModifier } from './createModifier';
+
+export interface CoordinateSpaceParams {
+  /// Name identifying this coordinate space. A descendant `GeometryReader`
+  /// (or other geometry reader) can resolve coordinates relative to it by
+  /// the same name.
+  name: string;
+}
+
+/// SwiftUI `.coordinateSpace(.named(_:))`. Tags the view with a named
+/// coordinate space so descendants can express geometry relative to it.
+///
+/// ```tsx
+/// <VStack modifiers={[coordinateSpace('scroll')]}>…</VStack>
+/// ```
+export function coordinateSpace(params: CoordinateSpaceParams): ReturnType<typeof createModifier>;
+export function coordinateSpace(name: string): ReturnType<typeof createModifier>;
+export function coordinateSpace(a: CoordinateSpaceParams | string) {
+  if (typeof a === 'string') return createModifier('coordinateSpace', { name: a });
+  return createModifier('coordinateSpace', a);
+}

package/src/modifiers/cornerRadius.ts

@@ -0,0 +1,16 @@
+import { createModifier } from './createModifier';
+
+export interface CornerRadiusParams {
+  /// Corner radius in points.
+  radius: number;
+}
+
+/// SwiftUI `.cornerRadius(_:)`. Clips the view to a rounded rectangle of the
+/// given corner radius. Deprecated in newer SDKs in favor of
+/// `.clipShape(RoundedRectangle(...))`, but still available on watchOS 9+.
+export function cornerRadius(
+  params: CornerRadiusParams | number
+): ReturnType<typeof createModifier> {
+  if (typeof params === 'number') return createModifier('cornerRadius', { radius: params });
+  return createModifier('cornerRadius', params);
+}

package/src/modifiers/createModifier.ts

@@ -0,0 +1,13 @@
+import type { ViewModifier } from '../types';
+
+/// Build a serializable modifier descriptor. Modifier factories in this
+/// directory (`padding`, `background`, …) are one-liners that wrap this.
+///
+/// The `$type` discriminator is appended *after* params so a stray
+/// `$type` key in params can't clobber it.
+export function createModifier<P extends object>(
+  $type: string,
+  params?: P
+): ViewModifier {
+  return { ...(params ?? {}), $type } as ViewModifier;
+}

package/src/modifiers/datePickerStyle.ts

@@ -0,0 +1,10 @@
+import { createModifier } from './createModifier';
+
+export type DatePickerStyle = 'automatic' | 'wheel';
+
+/// SwiftUI `.datePickerStyle(_:)`. Sets the visual style applied to
+/// `DatePicker`s within the view. `'automatic'` defers to the platform
+/// default.
+export function datePickerStyle(style: DatePickerStyle = 'automatic') {
+  return createModifier('datePickerStyle', { style });
+}

package/src/modifiers/defaultAppStorage.ts

@@ -0,0 +1,22 @@
+import { createModifier } from './createModifier';
+
+export interface DefaultAppStorageParams {
+  /// The `UserDefaults` suite name backing descendant `@AppStorage`
+  /// values. When omitted (or the suite can't be opened), the standard
+  /// user defaults are used.
+  suiteName?: string;
+}
+
+/// SwiftUI `.defaultAppStorage(_:)`. Sets the `UserDefaults` store that
+/// descendant `@AppStorage` properties read from and write to.
+export function defaultAppStorage(
+  params?: DefaultAppStorageParams
+): ReturnType<typeof createModifier>;
+export function defaultAppStorage(
+  suiteName: string
+): ReturnType<typeof createModifier>;
+export function defaultAppStorage(a?: DefaultAppStorageParams | string) {
+  if (typeof a === 'string')
+    return createModifier('defaultAppStorage', { suiteName: a });
+  return createModifier('defaultAppStorage', a);
+}

package/src/modifiers/defaultScrollAnchor.ts

@@ -0,0 +1,26 @@
+import { createModifier } from './createModifier';
+import type { UnitPoint } from '../components/LinearGradient';
+
+export interface DefaultScrollAnchorParams {
+  /// A named `UnitPoint` ('top' | 'center' | 'bottom' | …) or an explicit
+  /// `{ x, y }` in unit space.
+  anchor: UnitPoint;
+}
+
+/// SwiftUI `.defaultScrollAnchor(_:)`. Sets the initial anchor the scroll
+/// view aligns to (and re-aligns to when content size changes). Gated to
+/// watchOS 10+ natively; a no-op on older systems.
+export function defaultScrollAnchor(
+  anchor: UnitPoint
+): ReturnType<typeof createModifier>;
+export function defaultScrollAnchor(
+  params: DefaultScrollAnchorParams
+): ReturnType<typeof createModifier>;
+export function defaultScrollAnchor(
+  a: UnitPoint | DefaultScrollAnchorParams
+) {
+  if (typeof a === 'string' || ('x' in a && 'y' in a)) {
+    return createModifier('defaultScrollAnchor', { anchor: a });
+  }
+  return createModifier('defaultScrollAnchor', a);
+}

package/src/modifiers/deleteDisabled.ts

@@ -0,0 +1,7 @@
+import { createModifier } from './createModifier';
+
+/// SwiftUI `.deleteDisabled(_:)`. Prevents a row in an editable `List` /
+/// `ForEach` from being deleted via swipe-to-delete or edit mode.
+export function deleteDisabled(value: boolean = true) {
+  return createModifier('deleteDisabled', { value });
+}

package/src/modifiers/digitalCrownAccessory.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+
+import { createModifier } from './createModifier';
+
+export interface DigitalCrownAccessoryParams {
+  /// View placed alongside the Digital Crown while the crown is in use
+  /// (e.g. a value readout). Hoisted into a hidden content slot.
+  content: ReactNode;
+}
+
+/// SwiftUI `.digitalCrownAccessory { … }` — shows an accessory view next to
+/// the Digital Crown during interaction. Available on watchOS 9 (the
+/// deployment floor).
+export function digitalCrownAccessory(
+  content: ReactNode
+): ReturnType<typeof createModifier>;
+export function digitalCrownAccessory(
+  params: DigitalCrownAccessoryParams
+): ReturnType<typeof createModifier>;
+export function digitalCrownAccessory(
+  arg: ReactNode | DigitalCrownAccessoryParams
+) {
+  if (arg != null && typeof arg === 'object' && 'content' in arg) {
+    return createModifier('digitalCrownAccessory', arg);
+  }
+  return createModifier('digitalCrownAccessory', { content: arg as ReactNode });
+}

package/src/modifiers/digitalCrownRotation.ts

@@ -0,0 +1,29 @@
+import { createModifier } from './createModifier';
+
+/// How responsive the bound value is to crown rotation. Maps to
+/// `DigitalCrownRotationalSensitivity`.
+export type DigitalCrownSensitivity = 'low' | 'medium' | 'high';
+
+export interface DigitalCrownRotationParams {
+  /// Current value (JS owns the source of truth). The native side mirrors
+  /// this into local `@State` for smooth crown tracking and converges on the
+  /// next snapshot.
+  value: number;
+  /// Fired as the crown rotates, with the new value. JS should store it and
+  /// feed it back via `value`.
+  handler: (value: number) => void;
+  /// Lower bound of the rotation range. Defaults to 0 when `through` is set.
+  from?: number;
+  /// Upper bound of the rotation range. Defaults to 1 when `from` is set.
+  through?: number;
+  /// Rotation sensitivity. Defaults to SwiftUI's `.high`.
+  sensitivity?: DigitalCrownSensitivity;
+}
+
+/// SwiftUI `.digitalCrownRotation(_:from:through:sensitivity:…)` — binds the
+/// Digital Crown to a numeric value. Available on watchOS 9 (the deployment
+/// floor). When `from`/`through` are omitted the plain
+/// `.digitalCrownRotation(_:)` binding overload is used.
+export function digitalCrownRotation(params: DigitalCrownRotationParams) {
+  return createModifier('digitalCrownRotation', params);
+}

package/src/modifiers/disabled.ts

@@ -0,0 +1,20 @@
+import { createModifier } from './createModifier';
+
+export interface DisabledParams {
+  /// Whether the view is disabled. Defaults to `true` so `disabled()`
+  /// reads naturally as "disable this view".
+  value?: boolean;
+}
+
+/// SwiftUI `.disabled(_:)`. Blocks user interaction with the view and its
+/// descendants when `value` is true.
+///
+/// ```tsx
+/// <Button modifiers={[disabled(isBusy)]} />
+/// ```
+export function disabled(value?: boolean): ReturnType<typeof createModifier>;
+export function disabled(params: DisabledParams): ReturnType<typeof createModifier>;
+export function disabled(a: boolean | DisabledParams = true) {
+  if (typeof a === 'boolean') return createModifier('disabled', { value: a });
+  return createModifier('disabled', { value: a.value ?? true });
+}

package/src/modifiers/drawingGroup.ts

@@ -0,0 +1,14 @@
+import { createModifier } from './createModifier';
+
+export interface DrawingGroupParams {
+  /// When `true`, the offscreen buffer renders in the extended linear
+  /// sRGB color space (higher fidelity for gradients). Default `false`.
+  opaque?: boolean;
+}
+
+/// SwiftUI `.drawingGroup(opaque:colorMode:)`. Flattens the view's
+/// descendants into a single offscreen Metal-rendered image. Useful for
+/// composing many layered effects efficiently.
+export function drawingGroup(params?: DrawingGroupParams) {
+  return createModifier('drawingGroup', { opaque: false, ...params });
+}

package/src/modifiers/dynamicTypeSize.ts

@@ -0,0 +1,24 @@
+import { createModifier } from './createModifier';
+
+/// SwiftUI `DynamicTypeSize` values, from `.xSmall` up through the five
+/// accessibility sizes.
+export type DynamicTypeSize =
+  | 'xSmall'
+  | 'small'
+  | 'medium'
+  | 'large'
+  | 'xLarge'
+  | 'xxLarge'
+  | 'xxxLarge'
+  | 'accessibility1'
+  | 'accessibility2'
+  | 'accessibility3'
+  | 'accessibility4'
+  | 'accessibility5';
+
+/// SwiftUI `.dynamicTypeSize(_:)`. Pins this view's subtree to a fixed
+/// Dynamic Type size rather than following the system text-size setting.
+/// Requires watchOS 9+ — a no-op on older systems.
+export function dynamicTypeSize(size: DynamicTypeSize) {
+  return createModifier('dynamicTypeSize', { size });
+}

package/src/modifiers/environment.modifier.ts

@@ -0,0 +1,38 @@
+import { createModifier } from './createModifier';
+
+/// Known environment keys this bridge can set. SwiftUI's
+/// `.environment(_:_:)` is generic over arbitrary `EnvironmentValues`
+/// key paths, which cannot be expressed over the JSON bridge — so only
+/// this hand-picked, value-bridgeable subset is supported. Unknown keys
+/// are a documented no-op on the native side.
+export type EnvironmentKey =
+  | 'locale'
+  | 'layoutDirection'
+  | 'lineSpacing'
+  | 'multilineTextAlignment';
+
+/// `.environment(\.layoutDirection, _)` values.
+export type EnvironmentLayoutDirection = 'leftToRight' | 'rightToLeft';
+
+/// `.environment(\.multilineTextAlignment, _)` values.
+export type EnvironmentTextAlignment = 'leading' | 'center' | 'trailing';
+
+export interface EnvironmentParams {
+  /// Which `EnvironmentValues` key to write. Only the keys in
+  /// `EnvironmentKey` are bridgeable; any other value is a no-op.
+  key: EnvironmentKey;
+  /// The value to write. Interpreted per `key`:
+  /// - `'locale'` → a BCP-47 / POSIX identifier string (e.g. `'fr_FR'`).
+  /// - `'layoutDirection'` → `'leftToRight'` | `'rightToLeft'`.
+  /// - `'lineSpacing'` → a number of points.
+  /// - `'multilineTextAlignment'` → `'leading'` | `'center'` | `'trailing'`.
+  value: string | number | EnvironmentLayoutDirection | EnvironmentTextAlignment;
+}
+
+/// SwiftUI `.environment(_:_:)`, restricted to a bridgeable subset of
+/// `EnvironmentValues` keys. Arbitrary key paths cannot cross the JSON
+/// bridge, so pass one of the known `key` strings; unknown keys are a
+/// no-op (the view is returned unchanged) — see `EnvironmentKey`.
+export function environment(params: EnvironmentParams) {
+  return createModifier('environment', params);
+}

package/src/modifiers/environment.ts

@@ -0,0 +1,17 @@
+// "Environment" modifiers barrel.
+export { help, type HelpParams } from './help';
+export {
+  environment,
+  type EnvironmentParams,
+  type EnvironmentKey,
+  type EnvironmentLayoutDirection,
+  type EnvironmentTextAlignment,
+} from './environment.modifier';
+export {
+  environmentObject,
+  type EnvironmentObjectParams,
+} from './environmentObject';
+export {
+  defaultAppStorage,
+  type DefaultAppStorageParams,
+} from './defaultAppStorage';

package/src/modifiers/environmentObject.ts

@@ -0,0 +1,21 @@
+import { createModifier } from './createModifier';
+
+export interface EnvironmentObjectParams {
+  /// Accepted for API symmetry only — see below. The object never
+  /// reaches SwiftUI.
+  object?: unknown;
+}
+
+/// SwiftUI `.environmentObject(_:)`.
+///
+/// UNSUPPORTED on this bridge: `.environmentObject` injects a reference-type
+/// `ObservableObject` into the SwiftUI environment so descendant views can
+/// `@EnvironmentObject` it. A plain JS value cannot be made into a Swift
+/// `ObservableObject` (it has no `objectWillChange` publisher and no native
+/// identity), and the native view tree has no JS-side observers to feed.
+/// Registered as a no-op so the factory exists and composes; the view is
+/// returned unchanged. Use the `modifiers` prop with concrete value
+/// modifiers (e.g. `environment`) for cross-cutting state instead.
+export function environmentObject(params?: EnvironmentObjectParams) {
+  return createModifier('environmentObject', params);
+}