@openwebf/react-cupertino-ui 0.3.25 → 0.3.27

package/dist/index.d.mts

@@ -1,6 +1,139 @@
 import React from 'react';
 import { WebFElementWithMethods } from '@openwebf/react-core-ui';
 
+interface FlutterCupertinoInputProps {
+    /**
+     * Current text value of the input.
+     */
+    val?: string;
+    /**
+     * Placeholder text shown when the field is empty.
+     */
+    placeholder?: string;
+    /**
+     * Input type / keyboard type.
+     * Supported values:
+     * - 'text' (default)
+     * - 'password'
+     * - 'number'
+     * - 'tel'
+     * - 'email'
+     * - 'url'
+     */
+    type?: string;
+    /**
+     * Whether the field is disabled (non-editable and dimmed).
+     * Default: false.
+     */
+    disabled?: boolean;
+    /**
+     * Whether the field should autofocus when inserted.
+     * Default: false.
+     */
+    autofocus?: boolean;
+    /**
+     * Whether to show a clear button while editing.
+     * When true, a clear icon appears while text is non-empty.
+     * Default: false.
+     */
+    clearable?: boolean;
+    /**
+     * Maximum number of characters allowed.
+     * When set, input is truncated to this length.
+     */
+    maxlength?: number;
+    /**
+     * Whether the field is read-only (focusable but not editable).
+     * Default: false.
+     */
+    readonly?: boolean;
+    /**
+     * Fired whenever the text changes.
+     * detail = current value.
+     */
+    onInput?: (event: CustomEvent<string>) => void;
+    /**
+     * Fired when the user submits the field (e.g., presses the done/enter key).
+     * detail = current value.
+     */
+    onSubmit?: (event: CustomEvent<string>) => void;
+    /**
+     * Fired when the field gains focus.
+     */
+    onFocus?: (event: CustomEvent<void>) => void;
+    /**
+     * Fired when the field loses focus.
+     */
+    onBlur?: (event: CustomEvent<void>) => void;
+    /**
+     * Fired when the text is cleared via clear button or clear().
+     */
+    onClear?: (event: CustomEvent<void>) => void;
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+/**
+ * Element interface with methods accessible via ref
+ * @example
+ * ```tsx
+ * const ref = useRef<FlutterCupertinoInputElement>(null);
+ * // Call methods on the element
+ * ref.current?.finishRefresh('success');
+ * ```
+ */
+interface FlutterCupertinoInputElement extends WebFElementWithMethods<{
+    /**
+     * Programmatically focus the input.
+     */
+    focus(): void;
+    /**
+     * Programmatically blur (unfocus) the input.
+     */
+    blur(): void;
+    /**
+     * Clear the current value. Triggers the `clear` event.
+     */
+    clear(): void;
+}> {
+}
+/**
+ * Properties for <flutter-cupertino-input>.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<FlutterCupertinoInputElement>(null);
+ *
+ * <FlutterCupertinoInput
+ *   ref={ref}
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoInput>
+ *
+ * // Call methods on the element
+ * ref.current?.finishRefresh('success');
+ * ```
+ */
+declare const FlutterCupertinoInput: React.ForwardRefExoticComponent<FlutterCupertinoInputProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoInputElement>>;
+
 interface FlutterCupertinoTabBarProps {
     /**
      * Zero-based active item index.
@@ -2488,6 +2621,103 @@ declare const FlutterCupertinoIcon: React.ForwardRefExoticComponent<FlutterCuper
     children?: React.ReactNode;
 } & React.RefAttributes<FlutterCupertinoIconElement>>;
 
+interface FlutterCupertinoFormSectionProps {
+    /**
+     * Whether this section uses the "insetGrouped" style.
+     * When true, the section has insets and rounded corners similar to
+     * `CupertinoFormSection.insetGrouped`.
+     * Default: false.
+     */
+    insetGrouped?: boolean;
+    /**
+     * Clip behavior applied to the section's background and children.
+     * Accepts Flutter `Clip` values as strings, e.g.:
+     * - 'none'
+     * - 'hardEdge'
+     * - 'antiAlias'
+     * - 'antiAliasWithSaveLayer'
+     *
+     * Default: 'hardEdge'.
+     */
+    clipBehavior?: string;
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+interface FlutterCupertinoFormSectionElement extends WebFElementWithMethods<{}> {
+}
+/**
+ * Properties for <flutter-cupertino-form-section>.
+Wraps `CupertinoFormSection` with optional inset grouped styling.
+ *
+ * @example
+ * ```tsx
+ *
+ * <FlutterCupertinoFormSection
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoFormSection>
+ * ```
+ */
+declare const FlutterCupertinoFormSection: React.ForwardRefExoticComponent<FlutterCupertinoFormSectionProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoFormSectionElement>>;
+interface FlutterCupertinoFormRowProps {
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+interface FlutterCupertinoFormRowElement extends WebFElementWithMethods<{}> {
+}
+/**
+ * Properties for <flutter-cupertino-form-row>.
+Individual row inside a `CupertinoFormSection`.
+ *
+ * @example
+ * ```tsx
+ *
+ * <FlutterCupertinoFormRow
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoFormRow>
+ * ```
+ */
+declare const FlutterCupertinoFormRow: React.ForwardRefExoticComponent<FlutterCupertinoFormRowProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoFormRowElement>>;
+
 /**
  * Properties for <flutter-cupertino-context-menu>.
  * Wraps Flutter's CupertinoContextMenu.
@@ -3032,4 +3262,4 @@ declare const FlutterCupertinoActionSheet: React.ForwardRefExoticComponent<Flutt
     children?: React.ReactNode;
 } & React.RefAttributes<FlutterCupertinoActionSheetElement>>;
 
-export { CupertinoColors, CupertinoIcons, FlutterCupertinoActionSheet, type FlutterCupertinoActionSheetElement, FlutterCupertinoAlert, type FlutterCupertinoAlertElement, FlutterCupertinoButton, type FlutterCupertinoButtonElement, FlutterCupertinoCheckbox, type FlutterCupertinoCheckboxElement, FlutterCupertinoContextMenu, type FlutterCupertinoContextMenuElement, FlutterCupertinoIcon, type FlutterCupertinoIconElement, FlutterCupertinoListSection, type FlutterCupertinoListSectionElement, FlutterCupertinoListSectionFooter, type FlutterCupertinoListSectionFooterElement, FlutterCupertinoListSectionHeader, type FlutterCupertinoListSectionHeaderElement, FlutterCupertinoListTile, FlutterCupertinoListTileAdditionalInfo, type FlutterCupertinoListTileAdditionalInfoElement, type FlutterCupertinoListTileElement, FlutterCupertinoListTileLeading, type FlutterCupertinoListTileLeadingElement, FlutterCupertinoListTileSubtitle, type FlutterCupertinoListTileSubtitleElement, FlutterCupertinoListTileTrailing, type FlutterCupertinoListTileTrailingElement, FlutterCupertinoModalPopup, type FlutterCupertinoModalPopupElement, FlutterCupertinoRadio, type FlutterCupertinoRadioElement, FlutterCupertinoSlider, type FlutterCupertinoSliderElement, FlutterCupertinoSlidingSegmentedControl, type FlutterCupertinoSlidingSegmentedControlElement, FlutterCupertinoSlidingSegmentedControlItem, type FlutterCupertinoSlidingSegmentedControlItemElement, FlutterCupertinoSwitch, type FlutterCupertinoSwitchElement, FlutterCupertinoTabBar, type FlutterCupertinoTabBarElement, FlutterCupertinoTabBarItem, type FlutterCupertinoTabBarItemElement, FlutterCupertinoTabScaffold, type FlutterCupertinoTabScaffoldElement, FlutterCupertinoTabScaffoldTab, type FlutterCupertinoTabScaffoldTabElement, FlutterCupertinoTabView, type FlutterCupertinoTabViewElement };
+export { CupertinoColors, CupertinoIcons, FlutterCupertinoActionSheet, type FlutterCupertinoActionSheetElement, FlutterCupertinoAlert, type FlutterCupertinoAlertElement, FlutterCupertinoButton, type FlutterCupertinoButtonElement, FlutterCupertinoCheckbox, type FlutterCupertinoCheckboxElement, FlutterCupertinoContextMenu, type FlutterCupertinoContextMenuElement, FlutterCupertinoFormRow, type FlutterCupertinoFormRowElement, FlutterCupertinoFormSection, type FlutterCupertinoFormSectionElement, FlutterCupertinoIcon, type FlutterCupertinoIconElement, FlutterCupertinoInput, type FlutterCupertinoInputElement, FlutterCupertinoListSection, type FlutterCupertinoListSectionElement, FlutterCupertinoListSectionFooter, type FlutterCupertinoListSectionFooterElement, FlutterCupertinoListSectionHeader, type FlutterCupertinoListSectionHeaderElement, FlutterCupertinoListTile, FlutterCupertinoListTileAdditionalInfo, type FlutterCupertinoListTileAdditionalInfoElement, type FlutterCupertinoListTileElement, FlutterCupertinoListTileLeading, type FlutterCupertinoListTileLeadingElement, FlutterCupertinoListTileSubtitle, type FlutterCupertinoListTileSubtitleElement, FlutterCupertinoListTileTrailing, type FlutterCupertinoListTileTrailingElement, FlutterCupertinoModalPopup, type FlutterCupertinoModalPopupElement, FlutterCupertinoRadio, type FlutterCupertinoRadioElement, FlutterCupertinoSlider, type FlutterCupertinoSliderElement, FlutterCupertinoSlidingSegmentedControl, type FlutterCupertinoSlidingSegmentedControlElement, FlutterCupertinoSlidingSegmentedControlItem, type FlutterCupertinoSlidingSegmentedControlItemElement, FlutterCupertinoSwitch, type FlutterCupertinoSwitchElement, FlutterCupertinoTabBar, type FlutterCupertinoTabBarElement, FlutterCupertinoTabBarItem, type FlutterCupertinoTabBarItemElement, FlutterCupertinoTabScaffold, type FlutterCupertinoTabScaffoldElement, FlutterCupertinoTabScaffoldTab, type FlutterCupertinoTabScaffoldTabElement, FlutterCupertinoTabView, type FlutterCupertinoTabViewElement };

package/dist/index.d.ts

@@ -1,6 +1,139 @@
 import React from 'react';
 import { WebFElementWithMethods } from '@openwebf/react-core-ui';
 
+interface FlutterCupertinoInputProps {
+    /**
+     * Current text value of the input.
+     */
+    val?: string;
+    /**
+     * Placeholder text shown when the field is empty.
+     */
+    placeholder?: string;
+    /**
+     * Input type / keyboard type.
+     * Supported values:
+     * - 'text' (default)
+     * - 'password'
+     * - 'number'
+     * - 'tel'
+     * - 'email'
+     * - 'url'
+     */
+    type?: string;
+    /**
+     * Whether the field is disabled (non-editable and dimmed).
+     * Default: false.
+     */
+    disabled?: boolean;
+    /**
+     * Whether the field should autofocus when inserted.
+     * Default: false.
+     */
+    autofocus?: boolean;
+    /**
+     * Whether to show a clear button while editing.
+     * When true, a clear icon appears while text is non-empty.
+     * Default: false.
+     */
+    clearable?: boolean;
+    /**
+     * Maximum number of characters allowed.
+     * When set, input is truncated to this length.
+     */
+    maxlength?: number;
+    /**
+     * Whether the field is read-only (focusable but not editable).
+     * Default: false.
+     */
+    readonly?: boolean;
+    /**
+     * Fired whenever the text changes.
+     * detail = current value.
+     */
+    onInput?: (event: CustomEvent<string>) => void;
+    /**
+     * Fired when the user submits the field (e.g., presses the done/enter key).
+     * detail = current value.
+     */
+    onSubmit?: (event: CustomEvent<string>) => void;
+    /**
+     * Fired when the field gains focus.
+     */
+    onFocus?: (event: CustomEvent<void>) => void;
+    /**
+     * Fired when the field loses focus.
+     */
+    onBlur?: (event: CustomEvent<void>) => void;
+    /**
+     * Fired when the text is cleared via clear button or clear().
+     */
+    onClear?: (event: CustomEvent<void>) => void;
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+/**
+ * Element interface with methods accessible via ref
+ * @example
+ * ```tsx
+ * const ref = useRef<FlutterCupertinoInputElement>(null);
+ * // Call methods on the element
+ * ref.current?.finishRefresh('success');
+ * ```
+ */
+interface FlutterCupertinoInputElement extends WebFElementWithMethods<{
+    /**
+     * Programmatically focus the input.
+     */
+    focus(): void;
+    /**
+     * Programmatically blur (unfocus) the input.
+     */
+    blur(): void;
+    /**
+     * Clear the current value. Triggers the `clear` event.
+     */
+    clear(): void;
+}> {
+}
+/**
+ * Properties for <flutter-cupertino-input>.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<FlutterCupertinoInputElement>(null);
+ *
+ * <FlutterCupertinoInput
+ *   ref={ref}
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoInput>
+ *
+ * // Call methods on the element
+ * ref.current?.finishRefresh('success');
+ * ```
+ */
+declare const FlutterCupertinoInput: React.ForwardRefExoticComponent<FlutterCupertinoInputProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoInputElement>>;
+
 interface FlutterCupertinoTabBarProps {
     /**
      * Zero-based active item index.
@@ -2488,6 +2621,103 @@ declare const FlutterCupertinoIcon: React.ForwardRefExoticComponent<FlutterCuper
     children?: React.ReactNode;
 } & React.RefAttributes<FlutterCupertinoIconElement>>;
 
+interface FlutterCupertinoFormSectionProps {
+    /**
+     * Whether this section uses the "insetGrouped" style.
+     * When true, the section has insets and rounded corners similar to
+     * `CupertinoFormSection.insetGrouped`.
+     * Default: false.
+     */
+    insetGrouped?: boolean;
+    /**
+     * Clip behavior applied to the section's background and children.
+     * Accepts Flutter `Clip` values as strings, e.g.:
+     * - 'none'
+     * - 'hardEdge'
+     * - 'antiAlias'
+     * - 'antiAliasWithSaveLayer'
+     *
+     * Default: 'hardEdge'.
+     */
+    clipBehavior?: string;
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+interface FlutterCupertinoFormSectionElement extends WebFElementWithMethods<{}> {
+}
+/**
+ * Properties for <flutter-cupertino-form-section>.
+Wraps `CupertinoFormSection` with optional inset grouped styling.
+ *
+ * @example
+ * ```tsx
+ *
+ * <FlutterCupertinoFormSection
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoFormSection>
+ * ```
+ */
+declare const FlutterCupertinoFormSection: React.ForwardRefExoticComponent<FlutterCupertinoFormSectionProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoFormSectionElement>>;
+interface FlutterCupertinoFormRowProps {
+    /**
+     * HTML id attribute
+     */
+    id?: string;
+    /**
+     * Additional CSS styles
+     */
+    style?: React.CSSProperties;
+    /**
+     * Children elements
+     */
+    children?: React.ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+interface FlutterCupertinoFormRowElement extends WebFElementWithMethods<{}> {
+}
+/**
+ * Properties for <flutter-cupertino-form-row>.
+Individual row inside a `CupertinoFormSection`.
+ *
+ * @example
+ * ```tsx
+ *
+ * <FlutterCupertinoFormRow
+ *   // Add props here
+ * >
+ *   Content
+ * </FlutterCupertinoFormRow>
+ * ```
+ */
+declare const FlutterCupertinoFormRow: React.ForwardRefExoticComponent<FlutterCupertinoFormRowProps & {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+} & React.RefAttributes<FlutterCupertinoFormRowElement>>;
+
 /**
  * Properties for <flutter-cupertino-context-menu>.
  * Wraps Flutter's CupertinoContextMenu.
@@ -3032,4 +3262,4 @@ declare const FlutterCupertinoActionSheet: React.ForwardRefExoticComponent<Flutt
     children?: React.ReactNode;
 } & React.RefAttributes<FlutterCupertinoActionSheetElement>>;
 
-export { CupertinoColors, CupertinoIcons, FlutterCupertinoActionSheet, type FlutterCupertinoActionSheetElement, FlutterCupertinoAlert, type FlutterCupertinoAlertElement, FlutterCupertinoButton, type FlutterCupertinoButtonElement, FlutterCupertinoCheckbox, type FlutterCupertinoCheckboxElement, FlutterCupertinoContextMenu, type FlutterCupertinoContextMenuElement, FlutterCupertinoIcon, type FlutterCupertinoIconElement, FlutterCupertinoListSection, type FlutterCupertinoListSectionElement, FlutterCupertinoListSectionFooter, type FlutterCupertinoListSectionFooterElement, FlutterCupertinoListSectionHeader, type FlutterCupertinoListSectionHeaderElement, FlutterCupertinoListTile, FlutterCupertinoListTileAdditionalInfo, type FlutterCupertinoListTileAdditionalInfoElement, type FlutterCupertinoListTileElement, FlutterCupertinoListTileLeading, type FlutterCupertinoListTileLeadingElement, FlutterCupertinoListTileSubtitle, type FlutterCupertinoListTileSubtitleElement, FlutterCupertinoListTileTrailing, type FlutterCupertinoListTileTrailingElement, FlutterCupertinoModalPopup, type FlutterCupertinoModalPopupElement, FlutterCupertinoRadio, type FlutterCupertinoRadioElement, FlutterCupertinoSlider, type FlutterCupertinoSliderElement, FlutterCupertinoSlidingSegmentedControl, type FlutterCupertinoSlidingSegmentedControlElement, FlutterCupertinoSlidingSegmentedControlItem, type FlutterCupertinoSlidingSegmentedControlItemElement, FlutterCupertinoSwitch, type FlutterCupertinoSwitchElement, FlutterCupertinoTabBar, type FlutterCupertinoTabBarElement, FlutterCupertinoTabBarItem, type FlutterCupertinoTabBarItemElement, FlutterCupertinoTabScaffold, type FlutterCupertinoTabScaffoldElement, FlutterCupertinoTabScaffoldTab, type FlutterCupertinoTabScaffoldTabElement, FlutterCupertinoTabView, type FlutterCupertinoTabViewElement };
+export { CupertinoColors, CupertinoIcons, FlutterCupertinoActionSheet, type FlutterCupertinoActionSheetElement, FlutterCupertinoAlert, type FlutterCupertinoAlertElement, FlutterCupertinoButton, type FlutterCupertinoButtonElement, FlutterCupertinoCheckbox, type FlutterCupertinoCheckboxElement, FlutterCupertinoContextMenu, type FlutterCupertinoContextMenuElement, FlutterCupertinoFormRow, type FlutterCupertinoFormRowElement, FlutterCupertinoFormSection, type FlutterCupertinoFormSectionElement, FlutterCupertinoIcon, type FlutterCupertinoIconElement, FlutterCupertinoInput, type FlutterCupertinoInputElement, FlutterCupertinoListSection, type FlutterCupertinoListSectionElement, FlutterCupertinoListSectionFooter, type FlutterCupertinoListSectionFooterElement, FlutterCupertinoListSectionHeader, type FlutterCupertinoListSectionHeaderElement, FlutterCupertinoListTile, FlutterCupertinoListTileAdditionalInfo, type FlutterCupertinoListTileAdditionalInfoElement, type FlutterCupertinoListTileElement, FlutterCupertinoListTileLeading, type FlutterCupertinoListTileLeadingElement, FlutterCupertinoListTileSubtitle, type FlutterCupertinoListTileSubtitleElement, FlutterCupertinoListTileTrailing, type FlutterCupertinoListTileTrailingElement, FlutterCupertinoModalPopup, type FlutterCupertinoModalPopupElement, FlutterCupertinoRadio, type FlutterCupertinoRadioElement, FlutterCupertinoSlider, type FlutterCupertinoSliderElement, FlutterCupertinoSlidingSegmentedControl, type FlutterCupertinoSlidingSegmentedControlElement, FlutterCupertinoSlidingSegmentedControlItem, type FlutterCupertinoSlidingSegmentedControlItemElement, FlutterCupertinoSwitch, type FlutterCupertinoSwitchElement, FlutterCupertinoTabBar, type FlutterCupertinoTabBarElement, FlutterCupertinoTabBarItem, type FlutterCupertinoTabBarItemElement, FlutterCupertinoTabScaffold, type FlutterCupertinoTabScaffoldElement, FlutterCupertinoTabScaffoldTab, type FlutterCupertinoTabScaffoldTabElement, FlutterCupertinoTabView, type FlutterCupertinoTabViewElement };