@ng-native/expo 0.15.0 → 0.16.0

package/dist/expo-ui-components.d.ts

@@ -42,12 +42,14 @@ export interface UiModifier {
  */
 export declare class UiHost {
     protected readonly nativeView: true;
+    protected readonly android: boolean;
     readonly matchContents: import("@angular/core").InputSignal<boolean | {
         readonly vertical?: boolean;
         readonly horizontal?: boolean;
     } | undefined>;
     protected readonly matchVertical: Signal<boolean | undefined>;
     protected readonly matchHorizontal: Signal<boolean | undefined>;
+    /** The safe area SwiftUI's host ignores, iOS only: Compose's host has no such prop. */
     readonly ignoreSafeArea: import("@angular/core").InputSignal<"all" | "keyboard" | "container" | undefined>;
     readonly useViewportSizeMeasurement: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiHost, never>;
@@ -56,11 +58,14 @@ export declare class UiHost {
 /** A SwiftUI `Menu`. Its trigger is the `label` or a `<ui-slot name="label">`; its items are children. */
 export declare class UiMenu {
     protected readonly nativeView: true;
+    protected readonly android: boolean;
     readonly label: import("@angular/core").InputSignal<string | undefined>;
     /** An SF Symbol name. */
     readonly systemImage: import("@angular/core").InputSignal<string | undefined>;
+    /** What VoiceOver reads for the menu's trigger: SwiftUI's `accessibilityLabel` modifier. */
     readonly accessibilityLabel: import("@angular/core").InputSignal<string | undefined>;
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
+    protected readonly resolvedModifiers: Signal<readonly UiModifier[] | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiMenu, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiMenu, "ui-menu", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "systemImage": { "alias": "systemImage"; "required": false; "isSignal": true; }; "accessibilityLabel": { "alias": "accessibilityLabel"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
@@ -75,6 +80,7 @@ export declare class UiMenu {
  * and no height.
  */
 export declare class UiViewHost {
+    protected readonly android: boolean;
     protected readonly nativeView: true;
     readonly matchContents: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     /**
@@ -82,6 +88,7 @@ export declare class UiViewHost {
      * delivers its touches: it then takes them itself, and is measured from itself.
      */
     readonly layoutRoot: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    /** Compose's modifiers for the view host, Android only: SwiftUI's view host takes none. */
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiViewHost, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiViewHost, "ui-view-host", never, { "matchContents": { "alias": "matchContents"; "required": false; "isSignal": true; }; "layoutRoot": { "alias": "layoutRoot"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -115,7 +122,8 @@ export declare class UiButton {
     readonly role: import("@angular/core").InputSignal<"default" | "cancel" | "destructive" | "close" | undefined>;
     /**
      * In a home-screen widget's or a Live Activity's layout, what a tap on it hands the app: see
-     * `@ng-native/expo/widget` and `@ng-native/expo/live-activity`.
+     * `@ng-native/expo/widget` and `@ng-native/expo/live-activity`. The layout's build reads it, so
+     * an app's own button is not sent it: `@expo/ui`'s button there has no target.
      */
     readonly target: import("@angular/core").InputSignal<string | undefined>;
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
@@ -139,6 +147,7 @@ export declare class UiSlot {
     protected readonly nativeView: true;
     protected readonly android: boolean;
     readonly name: import("@angular/core").InputSignal<string>;
+    /** What the slot tells its SwiftUI parent about itself, iOS only. */
     readonly extraProps: import("@angular/core").InputSignal<Readonly<Record<string, unknown>> | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiSlot, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiSlot, "ui-slot", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "extraProps": { "alias": "extraProps"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -213,12 +222,22 @@ export declare class UiVStack {
  */
 export declare class UiImage {
     protected readonly nativeView: true;
+    /** Compose's image is another control, which takes a `source`: none of these are its. */
+    protected readonly android: boolean;
     readonly systemName: import("@angular/core").InputSignal<string | undefined>;
     readonly assetName: import("@angular/core").InputSignal<string | undefined>;
     readonly uiImage: import("@angular/core").InputSignal<string | undefined>;
+    /**
+     * A symbol's size in points, as a `font` modifier of that size, which does not scale with
+     * Dynamic Type. A `font` modifier in `modifiers` wins over it. Without either, the symbol is
+     * SwiftUI's default size, where `@expo/ui`'s own `Image` and a widget layout draw it at 24.
+     */
     readonly size: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
+    /** A symbol's colour, as a `foregroundStyle` modifier. */
     readonly color: import("@angular/core").InputSignal<string | undefined>;
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
+    /** SwiftUI's image reads neither `size` nor `color`: `@expo/ui`'s `Image` makes them modifiers. */
+    protected readonly resolvedModifiers: Signal<readonly UiModifier[] | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiImage, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiImage, "ui-image", never, { "systemName": { "alias": "systemName"; "required": false; "isSignal": true; }; "assetName": { "alias": "assetName"; "required": false; "isSignal": true; }; "uiImage": { "alias": "uiImage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -299,7 +318,16 @@ export declare class UiDatePicker {
     protected readonly resolvedSelection: Signal<string | undefined>;
     /** SwiftUI takes a list of what to show, and Compose one word for it. */
     protected readonly resolvedComponents: Signal<"date" | "hourAndMinute" | readonly ("date" | "hourAndMinute")[] | "dateAndTime" | undefined>;
-    protected readonly initialDate: Signal<number | null | undefined>;
+    protected readonly initialDate: Signal<number | null>;
+    /** Compose takes `range` as `selectableDates`, each end in milliseconds. */
+    protected readonly selectableDates: Signal<{
+        start: number | null;
+        end: number | null;
+    } | undefined>;
+    /**
+     * SwiftUI's picker reads `disabled` and `accessibilityLabel` as modifiers, and Compose's reads
+     * `accessibilityLabel` as the `semantics` modifier's `contentDescription`.
+     */
     protected readonly resolvedModifiers: Signal<readonly UiModifier[] | undefined>;
     /**
      * SwiftUI's picker cannot be empty: it shows today, and reports that as a change the moment it
@@ -397,6 +425,8 @@ export declare class UiPicker {
     /** Each option's `tag`, one array per value, so a pass hands native the same objects. */
     protected readonly tags: Signal<Map<string | number, readonly UiModifier[]>>;
     protected readonly android: boolean;
+    /** SwiftUI's picker view draws nothing without a label, and a segmented one never shows it. */
+    protected readonly shownLabel: Signal<string>;
     /** Whether Android's dropdown is open. */
     protected readonly open: import("@angular/core").WritableSignal<boolean>;
     /**
@@ -488,17 +518,25 @@ export declare class UiColorPicker {
     static ɵfac: i0.ɵɵFactoryDeclaration<UiColorPicker, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiColorPicker, "ui-color-picker", never, { "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "supportsOpacity": { "alias": "supportsOpacity"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
-/** A SwiftUI `Gauge`: `value` between `min` and `max`, drawn as `type` says. */
+/**
+ * A SwiftUI `Gauge`: `value` between `min` and `max`, drawn as `type` says, with its labels drawn as
+ * text in the slots SwiftUI reads them from, as `@expo/ui`'s `Gauge` draws them.
+ */
 export declare class UiGauge {
     protected readonly nativeView: true;
     readonly value: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
     readonly min: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
     readonly max: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
+    /**
+     * How it is drawn, as the `gaugeStyle` modifier: `'automatic'`, `'circular'`,
+     * `'circularCapacity'`, `'linear'` or `'linearCapacity'`.
+     */
     readonly type: import("@angular/core").InputSignal<string | undefined>;
     readonly currentValueLabel: import("@angular/core").InputSignal<string | undefined>;
     readonly minimumValueLabel: import("@angular/core").InputSignal<string | undefined>;
     readonly maximumValueLabel: import("@angular/core").InputSignal<string | undefined>;
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
+    protected readonly resolvedModifiers: Signal<readonly UiModifier[] | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiGauge, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiGauge, "ui-gauge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "currentValueLabel": { "alias": "currentValueLabel"; "required": false; "isSignal": true; }; "minimumValueLabel": { "alias": "minimumValueLabel"; "required": false; "isSignal": true; }; "maximumValueLabel": { "alias": "maximumValueLabel"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
@@ -698,8 +736,14 @@ export declare class UiLabel {
     readonly title: import("@angular/core").InputSignal<string | undefined>;
     /** An SF Symbol name. */
     readonly systemImage: import("@angular/core").InputSignal<string | undefined>;
+    /**
+     * The colour of the symbol alone, drawn as the label's icon in that colour, since SwiftUI's
+     * label takes no colour. The `foregroundStyle` modifier colours the title too.
+     */
     readonly color: import("@angular/core").InputSignal<string | undefined>;
     readonly modifiers: import("@angular/core").InputSignal<readonly UiModifier[] | undefined>;
+    /** The icon's colour, when there is a symbol to draw in it. */
+    protected readonly iconColor: Signal<UiModifier | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiLabel, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiLabel, "ui-label", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "systemImage": { "alias": "systemImage"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "modifiers": { "alias": "modifiers"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }