@webority/mobile-ui 0.0.39 → 0.2.0

package/lib/typescript/module/index.d.ts

@@ -1,15 +1,15 @@
 export * from './components/index.js';
-export type { AppIconProps, AppIconSize, CuratedIconName, IconName, IconVariant, SlotIcon, SlotIconRef, SlotIconState, SlotNode } from './components/AppIcon/index.js';
-export { APP_ICON_SIZES, AppIcon, CURATED_ICON_NAMES, defaultIcons, ICON_NAMES, renderSlotIcon } from './components/AppIcon/index.js';
-export type { FieldArrayApi, FieldInputProps, FieldRules, FieldState, FocusableNode, FormApi, FormCompletion, FormConfig, FormErrors, FormTouched, FormValidateFn, FormValues, SubmitHelpers, UseFormCompletionOptions, ValidateOn, ValidationResult, ValidationRule, ValidationSchema } from './form/index.js';
-export { deletePath, Form, getPath, isFieldFilled, rules, setPath, useField, useFieldArray, useForm, useFormCompletion, useFormContext, useOptionalFormContext } from './form/index.js';
+export type { AppIconName, AppIconProps, AppIconSize, CuratedIconName, IconName, IconsaxShadowedName, IconVariant, SlotIcon, SlotIconRef, SlotIconState, SlotNode } from './components/AppIcon/index.js';
+export { APP_ICON_SIZES, AppIcon, CURATED_ICON_NAMES, defaultIcons, ICON_NAMES, ICONSAX_SUFFIX, renderSlotIcon } from './components/AppIcon/index.js';
+export type { FieldArrayApi, FieldInputProps, FieldRules, FieldState, FocusableNode, FormApi, FormCompletion, FormConfig, FormErrors, FormTouched, FormValidateFn, FormValues, HookFieldProps, HookFormFieldProps, SubmitHelpers, UseFormCompletionOptions, ValidateOn, ValidationResult, ValidationRule, ValidationSchema } from './form/index.js';
+export { deletePath, Form, getPath, HookFormField, isFieldFilled, rules, setPath, useField, useFieldArray, useForm, useFormCompletion, useFormContext, useHookFormField, useOptionalFormContext } from './form/index.js';
 export type { PressAnimationPreset, UseControllableStateOptions, UsePressAnimationOptions, UsePressAnimationResult, UseToggleResult } from './hooks/index.js';
 export { FLICK_TOLERANCE, PRESS_ANIMATION_PRESETS, useControllableState, useDebounce, useFlickGuard, usePressAnimation, useReducedMotion, useToggle } from './hooks/index.js';
 export type { InitUIOptions } from './initUI.js';
 export { initUI } from './initUI.js';
 export type { NetworkStatusBannerProps } from './network/index.js';
 export { NetworkStatusBanner } from './network/index.js';
-export type { ColorMode, ColorPalette, ColorSchemePreference, DeepPartial, IconRegistry, IconRenderer, MotionScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, ThemeProviderProps, TypographyScale } from './theme/index.js';
+export type { ColorMode, ColorPalette, ColorSchemePreference, DeepPartial, IconRegistry, IconRenderer, MotionScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, TextVariantSpec, Theme, ThemeOverrides, ThemeProviderProps, TypographyScale } from './theme/index.js';
 export { darkTheme, getColorMode, getTheme, lightTheme, mergeTheme, resetTheme, setColorMode, setTheme, subscribeTheme, ThemeProvider, useTheme, useThemeMode } from './theme/index.js';
 export type { BreakpointKey, FeedbackIntent, HapticType, ResponsiveScales, ScreenInfo, SpacingToken, SquirclePathParams } from './utils/index.js';
 export { Breakpoints, configureFeedback, feedback, hapticForIntent, isFeedbackEnabled, isScreenSize, isTablet, Margin, Padding, Responsive, ScreenDimensions, Spacing, SQUIRCLE_MIN_RADIUS, SQUIRCLE_SMOOTHING, setHapticImplementation, shadowStyle, smoothCorners, squircleApplies, squircleHostRadius, squirclePath, triggerHaptic, useScreenDimensions, warnUnknownProps } from './utils/index.js';

package/lib/typescript/module/network/NetworkStatusBanner.d.ts

@@ -9,6 +9,12 @@ export interface NetworkStatusBannerProps {
     style?: ViewStyle;
     /** Hide the banner entirely (useful for screens that handle offline themselves). */
     disabled?: boolean;
+    /**
+     * Pad the banner clear of the status bar (top) or the home indicator
+     * (bottom) with the safe-area inset of its edge. Default true; turn it off
+     * when the banner sits below a header that already clears the inset.
+     */
+    safeArea?: boolean;
 }
 /**
  * A subtle animated banner that slides in when the device goes offline.

package/lib/typescript/module/theme/ThemeContext.d.ts

@@ -3,7 +3,15 @@ import type { ColorMode, Theme, ThemeOverrides } from './types.js';
 export type ColorSchemePreference = 'light' | 'dark' | 'system';
 export interface ThemeProviderProps {
     children: React.ReactNode;
+    /** The preference before a saved one is read (or when nothing is saved). Default `'system'`. */
     initialPreference?: ColorSchemePreference;
+    /**
+     * Storage key under which the provider remembers the light / dark / system
+     * choice across launches, through mobile-core `Storage`. It reads the saved
+     * choice on mount and writes every change made with `setPreference` or
+     * `toggleColorMode`. Without a key nothing is read or written.
+     */
+    persistKey?: string;
     lightOverrides?: ThemeOverrides;
     darkOverrides?: ThemeOverrides;
 }

package/lib/typescript/module/theme/index.d.ts

@@ -29,5 +29,5 @@ export { ThemeProvider, useTheme, useThemeMode } from './ThemeContext.js';
 export type { FontWeightKey } from './textStyle.js';
 export { fontFor } from './textStyle.js';
 export { darkTheme, lightTheme } from './tokens.js';
-export type { ColorMode, ColorPalette, DeepPartial, GradientDefinition, GradientScale, IconRegistry, IconRenderer, MotionScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, TypographyScale } from './types.js';
+export type { ColorMode, ColorPalette, DeepPartial, GradientDefinition, GradientScale, IconRegistry, IconRenderer, MotionScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, TextVariantSpec, Theme, ThemeOverrides, TypographyScale } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/theme/types.d.ts

@@ -54,11 +54,15 @@ export interface ColorPalette {
     onWarning: string;
     onError: string;
     onInfo: string;
+    /** Ink on a scrim (`background.overlay`), which is dark in both schemes. */
+    onOverlay: string;
     text: {
         primary: string;
         secondary: string;
         tertiary: string;
         inverse: string;
+        /** Emphasis ink for labels and lead-in lines that sit above body text. */
+        strong: string;
         disabled: string;
         link: string;
     };
@@ -782,8 +786,16 @@ export interface AppBarTokens {
     collapseTranslateDistance?: number;
     /** Margin between title and subtitle. */
     subtitleMarginTop?: number;
-    /** Width/height of each action button (square). */
+    /** Width/height of each action button (square). Library default: 44. */
     actionButtonSize?: number;
+    /** Size of the glyph inside an action button; also the built-in back arrow. Drives `gutter`'s optical inset. Library default: 24. */
+    iconSize?: number;
+    /** Thickness of the bottom divider. Library default: the platform hairline. */
+    dividerWidth?: number;
+    /** Diameter of the unread dot on an action. Library default: 8. */
+    dotSize?: number;
+    /** Top/right inset of the unread dot. Library default: 10. */
+    dotOffset?: number;
     /** Top/right inset of the right-action badge bubble. */
     badgeOffset?: number;
     /** Min-width of the right-action badge bubble. */
@@ -1085,6 +1097,24 @@ export interface IconRegistry {
     /** Trailing "goes somewhere" chevron on ListItem. Default `chevron-right`. */
     chevronRight?: IconRenderer;
 }
+/**
+ * An app's own text style, registered under a name in `theme.textVariants` and
+ * used as `<Text variant="cardTitle">`. Sizes, line heights and letter spacing
+ * take a typography token or a raw number.
+ */
+export interface TextVariantSpec {
+    size: keyof TypographyScale['fontSize'] | number;
+    weight?: keyof TypographyScale['fontWeight'];
+    /** Pixels, or a `typography.lineHeight` token (a multiple of the size). Omitted: the font's own metrics decide. */
+    lineHeight?: number | keyof TypographyScale['lineHeight'];
+    /** A text role, semantic tone or raw colour. Defaults to `primary`. */
+    color?: string;
+    uppercase?: boolean;
+    /** Pixels, or a `typography.letterSpacing` token. */
+    letterSpacing?: number | keyof TypographyScale['letterSpacing'];
+    italic?: boolean;
+    fontVariant?: TextStyle['fontVariant'];
+}
 export interface Theme {
     mode: ColorMode;
     colors: ColorPalette;
@@ -1103,6 +1133,15 @@ export interface Theme {
      * accept a `GradientDefinition` literal directly.
      */
     gradients: GradientScale;
+    /** The app's own `Text` variants, by name. A built-in variant name always wins. */
+    textVariants?: Record<string, TextVariantSpec>;
+    /**
+     * Upper bound on how far system font scaling grows any `Text`, as
+     * `maxFontSizeMultiplier`. Unset leaves React Native's default (no cap).
+     * A `maxFontSizeMultiplier` on the `Text` itself wins. Set it through
+     * ThemeProvider `lightOverrides` and `darkOverrides`.
+     */
+    maxFontSizeMultiplier?: number;
 }
 export type DeepPartial<T> = T extends object ? {
     [K in keyof T]?: DeepPartial<T[K]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-ui",
-  "version": "0.0.39",
+  "version": "0.2.0",
   "description": "Beautiful, animated, accessible React Native components, theme and form engine for Webority projects.",
   "keywords": [
     "react-native",
@@ -42,6 +42,10 @@
     "ios",
     "android",
     "RNMobileUiPdfRasterizer.podspec",
+    "!android/build",
+    "!android/.gradle",
+    "!android/.cxx",
+    "!ios/build",
     "!**/__tests__",
     "!**/*.test.*",
     "!**/*.spec.*",
@@ -56,7 +60,7 @@
     }
   },
   "scripts": {
-    "build": "bob build",
+    "build": "bob build && node ../../scripts/minify-lib.mjs",
     "clean": "rimraf lib",
     "lint": "biome lint ./src",
     "lint:fix": "biome lint --write ./src",
@@ -64,13 +68,16 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@webority/mobile-core": ">=0.0.27 <0.1.0",
+    "@webority/mobile-core": ">=0.2.0 <0.3.0",
     "expo": ">=57.0.0",
     "expo-file-system": ">=57.0.0",
     "expo-haptics": ">=57.0.0",
+    "expo-image": ">=57.0.0",
     "react": "^19.1.0",
+    "react-hook-form": "^7.55.0",
     "react-native": ">=0.81.0",
     "react-native-gesture-handler": "^2.21.0 || ^3.0.0",
+    "react-native-keyboard-controller": ">=1.21.9",
     "react-native-reanimated": "^4.0.0",
     "react-native-safe-area-context": ">=5.4.0",
     "react-native-svg": ">=15.0.0",
@@ -88,13 +95,15 @@
       [
         "commonjs",
         {
-          "esm": true
+          "esm": true,
+          "sourceMaps": false
         }
       ],
       [
         "module",
         {
-          "esm": true
+          "esm": true,
+          "sourceMaps": false
         }
       ],
       [