@pallasoft/ps-mobile-components 1.2.0 → 1.4.0

package/dist/interfaces/ps-mobile-theme.d.ts

@@ -6,8 +6,12 @@ export interface PsMobileTheme {
     chart: string[];
     danger: string;
     dangerSoft: string;
+    dangerText: string;
     fonts: PsMobileFonts;
     hasHaptics: boolean;
+    info: string;
+    infoSoft: string;
+    infoText: string;
     isDark: boolean;
     isReduceMotion: boolean;
     ink: string;
@@ -15,17 +19,45 @@ export interface PsMobileTheme {
     muted: string;
     overlay: string;
     primary: string;
+    primary100: string;
+    primary200: string;
+    primary300: string;
+    primary400: string;
+    primary50: string;
+    primary500: string;
+    primary600: string;
+    primary700: string;
+    primary800: string;
+    primary900: string;
     primaryContrast: string;
+    primaryPressed: string;
     primarySoft: string;
+    primarySoftStrong: string;
+    primaryText: string;
     secondary: string;
+    secondary100: string;
+    secondary200: string;
+    secondary300: string;
+    secondary400: string;
+    secondary50: string;
+    secondary500: string;
+    secondary600: string;
+    secondary700: string;
+    secondary800: string;
+    secondary900: string;
     secondaryContrast: string;
+    secondaryPressed: string;
     secondarySoft: string;
+    secondarySoftStrong: string;
+    secondaryText: string;
     skeletonBase: string;
     skeletonSweep: string;
     success: string;
     successSoft: string;
+    successText: string;
     surface: string;
     warning: string;
     warningSoft: string;
+    warningText: string;
     white: string;
 }

package/dist/interfaces/ps-quick-action-native.d.ts

@@ -0,0 +1,14 @@
+export interface PsQuickActionNativeItem {
+    icon: string;
+    id: string;
+    subtitle?: string;
+    title: string;
+}
+export interface PsQuickActionNativeSubscription {
+    remove: () => void;
+}
+export interface PsQuickActionNative {
+    addListener: (listener: (action: PsQuickActionNativeItem) => void) => PsQuickActionNativeSubscription;
+    initial?: PsQuickActionNativeItem;
+    setItems: (items: PsQuickActionNativeItem[]) => Promise<void>;
+}

package/dist/interfaces/ps-quick-action-native.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-quick-action.d.ts

@@ -0,0 +1,7 @@
+export interface PsQuickAction {
+    androidIcon: string;
+    id: string;
+    iosSymbol: string;
+    subtitle?: string;
+    title: string;
+}

package/dist/interfaces/ps-quick-action.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-scanned-file.d.ts

@@ -1,5 +1,2 @@
-export interface PsScannedFile {
-    name: string;
-    type: string;
-    uri: string;
-}
+import type { PsDeviceFile } from './ps-device-file';
+export type PsScannedFile = PsDeviceFile;

package/dist/interfaces/ps-sheet-leading-kind.d.ts

@@ -0,0 +1 @@
+export type PsSheetLeadingKind = 'back' | 'close';

package/dist/interfaces/ps-sheet-leading-kind.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-sheet-page.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export interface PsSheetPage {
+    backLabel: string;
+    children: ReactNode;
+    id: string;
+    onBack: () => void;
+    title: string;
+}

package/dist/interfaces/ps-sheet-page.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-stack-screen-options.d.ts

@@ -0,0 +1,2 @@
+import type { NativeStackNavigationOptions } from 'expo-router/build/react-navigation/native-stack/index';
+export type PsStackScreenOptions = NativeStackNavigationOptions;

package/dist/interfaces/ps-stack-screen-options.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-switcher-item.d.ts

@@ -0,0 +1,11 @@
+export interface PsSwitcherItem {
+    badge?: string;
+    id: string;
+    initials: string;
+    searchText: string;
+    status?: string;
+    statusTone?: 'muted' | 'warning';
+    subtitle?: string;
+    title: string;
+    value?: string;
+}

package/dist/interfaces/ps-switcher-item.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-tab-bar-context-data.d.ts

@@ -0,0 +1,5 @@
+export interface PsTabBarContextData {
+    hasTabBar: boolean;
+    isHidden: boolean;
+    setIsHidden: (isHidden: boolean) => void;
+}

package/dist/interfaces/ps-tab-bar-context-data.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-tab-bar-icon-colors.d.ts

@@ -0,0 +1,4 @@
+export interface PsTabBarIconColors {
+    default: string;
+    selected: string;
+}

package/dist/interfaces/ps-tab-bar-icon-colors.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-tab-bar-label-style.d.ts

@@ -0,0 +1,5 @@
+export interface PsTabBarLabelStyle {
+    color: string;
+    fontFamily: string;
+    fontSize: number;
+}

package/dist/interfaces/ps-tab-bar-label-style.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-tab-bar-label-styles.d.ts

@@ -0,0 +1,5 @@
+import type { PsTabBarLabelStyle } from './ps-tab-bar-label-style';
+export interface PsTabBarLabelStyles {
+    default: PsTabBarLabelStyle;
+    selected: PsTabBarLabelStyle;
+}

package/dist/interfaces/ps-tab-bar-label-styles.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-tab-bar-style.d.ts

@@ -0,0 +1,12 @@
+import type { PsTabBarIconColors } from './ps-tab-bar-icon-colors';
+import type { PsTabBarLabelStyles } from './ps-tab-bar-label-styles';
+export interface PsTabBarStyle {
+    backgroundColor?: string;
+    badgeBackgroundColor?: string;
+    badgeTextColor?: string;
+    iconColor?: PsTabBarIconColors;
+    indicatorColor?: string;
+    labelStyle?: PsTabBarLabelStyles;
+    rippleColor?: string;
+    tintColor: string;
+}

package/dist/interfaces/ps-tab-bar-style.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-waterfall-datum.d.ts

@@ -0,0 +1,6 @@
+export interface PsWaterfallDatum {
+    id?: string;
+    isTotal?: boolean;
+    label: string;
+    value: number;
+}

package/dist/interfaces/ps-waterfall-datum.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ps-waterfall-step.d.ts

@@ -0,0 +1,7 @@
+export interface PsWaterfallStep {
+    end: number;
+    isTotal: boolean;
+    label: string;
+    start: number;
+    value: number;
+}

package/dist/interfaces/ps-waterfall-step.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-app-lock-options.d.ts

@@ -0,0 +1,6 @@
+import type { PsAppLockPrompt } from './ps-app-lock-prompt';
+export interface UsePsAppLockOptions {
+    graceSeconds?: number;
+    isEnabled: boolean;
+    prompt: PsAppLockPrompt;
+}

package/dist/interfaces/use-ps-app-lock-options.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-app-lock-result.d.ts

@@ -0,0 +1,7 @@
+export interface UsePsAppLockResult {
+    isCovered: boolean;
+    isLocked: boolean;
+    isUnlocking: boolean;
+    lock: () => void;
+    unlock: () => Promise<boolean>;
+}

package/dist/interfaces/use-ps-app-lock-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-barcode-scanner-result.d.ts

@@ -0,0 +1,6 @@
+export interface UsePsBarcodeScannerResult {
+    close: () => void;
+    isAvailable: boolean;
+    isOpen: boolean;
+    open: () => void;
+}

package/dist/interfaces/use-ps-barcode-scanner-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-document-open-result.d.ts

@@ -0,0 +1,5 @@
+export interface UsePsDocumentOpenResult {
+    hasFailed: boolean;
+    isOpening: boolean;
+    open: () => Promise<void>;
+}

package/dist/interfaces/use-ps-document-open-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-document-pdf-cover-result.d.ts

@@ -0,0 +1,7 @@
+import type { PsDocumentLoadStatus } from '../constants/ps-document-load-status';
+import type { PsDocumentPageImage } from './ps-document-page-image';
+export interface UsePsDocumentPdfCoverResult {
+    cover: PsDocumentPageImage | null;
+    retry: () => void;
+    status: PsDocumentLoadStatus;
+}

package/dist/interfaces/use-ps-document-pdf-cover-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-document-pdf-pages-result.d.ts

@@ -0,0 +1,5 @@
+import type { PsDocumentPdfState } from './ps-document-pdf-state';
+export interface UsePsDocumentPdfPagesResult {
+    retry: () => void;
+    states: Record<string, PsDocumentPdfState>;
+}

package/dist/interfaces/use-ps-document-pdf-pages-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-document-text-result.d.ts

@@ -0,0 +1,5 @@
+import type { PsDocumentLoadStatus } from '../constants/ps-document-load-status';
+export interface UsePsDocumentTextResult {
+    status: PsDocumentLoadStatus;
+    text: string | null;
+}

package/dist/interfaces/use-ps-document-text-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-file-upload-result.d.ts

@@ -0,0 +1,8 @@
+import type { PsCaptureSource } from '../constants/ps-capture-source';
+import type { PsCaptureLabels } from './ps-capture-labels';
+import type { PsMenuItem } from './ps-menu-item';
+export interface UsePsFileUploadResult {
+    isUploading: boolean;
+    items: (labels: PsCaptureLabels, onPicked?: (source: PsCaptureSource) => void) => PsMenuItem[];
+    pick: (source: PsCaptureSource) => Promise<void>;
+}

package/dist/interfaces/use-ps-file-upload-result.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/use-ps-quick-actions-options.d.ts

@@ -0,0 +1,5 @@
+import type { PsQuickAction } from './ps-quick-action';
+export interface UsePsQuickActionsOptions {
+    items: PsQuickAction[];
+    onSelect: (id: string) => void;
+}

package/dist/interfaces/use-ps-quick-actions-options.js

@@ -0,0 +1 @@
+export {};

package/dist/services/ps-action-menu-service.d.ts

@@ -1,4 +1,5 @@
 import type { SFSymbol } from 'sf-symbols-typescript';
+import type { PsActionMenuHeader } from '../interfaces/ps-action-menu-header';
 import type { PsActionMenuSection } from '../interfaces/ps-action-menu-section';
 import type { PsMenuItem } from '../interfaces/ps-menu-item';
 export declare class PsActionMenuService {
@@ -6,5 +7,8 @@ export declare class PsActionMenuService {
     static consistent(sections: PsActionMenuSection[]): PsActionMenuSection[];
     static flatten(sections: PsActionMenuSection[]): PsMenuItem[];
     static expand(item: PsMenuItem): PsMenuItem[];
+    static hasAvatar(item: PsMenuItem): boolean;
+    static monogram(item: PsMenuItem): SFSymbol | undefined;
+    static headerSymbol(header: PsActionMenuHeader): SFSymbol;
     static symbol(item: PsMenuItem): SFSymbol | undefined;
 }

package/dist/services/ps-action-menu-service.js

@@ -7,7 +7,7 @@ export class PsActionMenuService {
     }
     static consistent(sections) {
         const items = sections.flatMap((section) => section.items);
-        const hasAll = items.every((item) => item.iconKey !== undefined || item.isChecked === true);
+        const hasAll = items.every((item) => item.iconKey !== undefined || item.isChecked === true || PsActionMenuService.hasAvatar(item));
         if (hasAll)
             return sections;
         return sections.map((section) => ({
@@ -26,9 +26,32 @@ export class PsActionMenuService {
             ...item.children.flatMap((child) => this.expand(child)),
         ];
     }
+    static hasAvatar(item) {
+        return item.imageUri !== undefined || item.monogram !== undefined;
+    }
+    static monogram(item) {
+        if (item.monogram === undefined)
+            return undefined;
+        const monograms = PsSfSymbolConfig.monograms;
+        return monograms[item.monogram.trim().normalize('NFD').charAt(0).toLowerCase()];
+    }
+    static headerSymbol(header) {
+        const monogram = header.initials === undefined
+            ? undefined
+            : PsActionMenuService.monogram({
+                id: 'header',
+                label: header.title,
+                monogram: header.initials,
+                onSelect: () => undefined,
+            });
+        return monogram === undefined ? PsSfSymbolConfig.headerSymbol : monogram;
+    }
     static symbol(item) {
-        if (item.isChecked)
+        if (item.isChecked && !PsActionMenuService.hasAvatar(item))
             return PsSfSymbolConfig.checkedSymbol;
+        const monogram = PsActionMenuService.monogram(item);
+        if (monogram !== undefined)
+            return monogram;
         if (item.iconKey === undefined)
             return undefined;
         const symbols = PsSfSymbolConfig.symbols;

package/dist/services/ps-app-lock-grace-service.d.ts

@@ -0,0 +1,6 @@
+export declare class PsAppLockGraceService {
+    static isExpired(backgroundedAt: number | null, now: number, graceSeconds: number): boolean;
+    static isActive(state: string): boolean;
+    static isHidden(state: string): boolean;
+    static isBackground(state: string): boolean;
+}

package/dist/services/ps-app-lock-grace-service.js

@@ -0,0 +1,17 @@
+import { PsAppLockConfig } from '../constants/ps-app-lock-config';
+export class PsAppLockGraceService {
+    static isExpired(backgroundedAt, now, graceSeconds) {
+        if (backgroundedAt === null)
+            return false;
+        return now - backgroundedAt >= graceSeconds;
+    }
+    static isActive(state) {
+        return state === PsAppLockConfig.activeState;
+    }
+    static isHidden(state) {
+        return state === PsAppLockConfig.inactiveState || state === PsAppLockConfig.backgroundState;
+    }
+    static isBackground(state) {
+        return state === PsAppLockConfig.backgroundState;
+    }
+}

package/dist/services/ps-app-lock-service.d.ts

@@ -0,0 +1,10 @@
+import { PsBiometryKind } from '../constants/ps-biometry-kind';
+export declare class PsAppLockService {
+    private static busyCount;
+    static isAvailable(): Promise<boolean>;
+    static biometryKind(): Promise<PsBiometryKind>;
+    static kindOf(types: number[], level: number, platform: string): PsBiometryKind;
+    static authenticate(prompt: string, cancelLabel: string): Promise<boolean>;
+    static isBusy(): boolean;
+    private static load;
+}

package/dist/services/ps-app-lock-service.js

@@ -0,0 +1,84 @@
+import { requireOptionalNativeModule } from 'expo';
+import { Platform } from 'react-native';
+import { PsAppLockConfig } from '../constants/ps-app-lock-config';
+import { PsAuthenticationTypeCode, PsSecurityLevelCode, } from '../constants/ps-app-lock-native-codes';
+import { PsBiometryKind } from '../constants/ps-biometry-kind';
+export class PsAppLockService {
+    static async isAvailable() {
+        const native = PsAppLockService.load();
+        if (native === null)
+            return false;
+        try {
+            return (await native.getEnrolledLevelAsync()) > PsSecurityLevelCode.none;
+        }
+        catch {
+            return false;
+        }
+    }
+    static async biometryKind() {
+        const native = PsAppLockService.load();
+        if (native === null)
+            return PsBiometryKind.passcode;
+        try {
+            const [types, level] = await Promise.all([
+                native.supportedAuthenticationTypesAsync(),
+                native.getEnrolledLevelAsync(),
+            ]);
+            return PsAppLockService.kindOf(types, level, Platform.OS);
+        }
+        catch {
+            return PsBiometryKind.passcode;
+        }
+    }
+    static kindOf(types, level, platform) {
+        if (level < PsSecurityLevelCode.biometricWeak)
+            return PsBiometryKind.passcode;
+        const has = (code) => types.includes(code);
+        const face = has(PsAuthenticationTypeCode.face);
+        const fingerprint = has(PsAuthenticationTypeCode.fingerprint);
+        if (platform === PsAppLockConfig.iosPlatform && face)
+            return PsBiometryKind.face;
+        if (fingerprint)
+            return PsBiometryKind.fingerprint;
+        if (face)
+            return PsBiometryKind.face;
+        if (has(PsAuthenticationTypeCode.iris))
+            return PsBiometryKind.iris;
+        return PsBiometryKind.passcode;
+    }
+    static async authenticate(prompt, cancelLabel) {
+        const native = PsAppLockService.load();
+        if (native === null)
+            return false;
+        PsAppLockService.busyCount += 1;
+        try {
+            const result = await native.authenticateAsync({
+                cancelLabel,
+                disableDeviceFallback: false,
+                promptMessage: prompt,
+            });
+            return result.success;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            PsAppLockService.busyCount -= 1;
+        }
+    }
+    static isBusy() {
+        return PsAppLockService.busyCount > 0;
+    }
+    static load() {
+        try {
+            if (requireOptionalNativeModule(PsAppLockConfig.nativeModuleName) === null)
+                return null;
+            const loaded = require('expo-local-authentication');
+            return typeof loaded.authenticateAsync === 'function' ? loaded : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+PsAppLockService.busyCount = 0;

package/dist/services/ps-badge-tone-service.js

@@ -4,13 +4,13 @@ export class PsBadgeToneService {
     static resolve(tone, theme) {
         switch (tone) {
             case 'danger':
-                return { background: theme.dangerSoft, foreground: theme.danger };
+                return { background: theme.dangerSoft, foreground: theme.dangerText };
             case 'primary':
                 return { background: theme.primarySoft, foreground: theme.ink };
             case 'success':
-                return { background: theme.successSoft, foreground: theme.success };
+                return { background: theme.successSoft, foreground: theme.successText };
             case 'warning':
-                return { background: theme.warningSoft, foreground: theme.warning };
+                return { background: theme.warningSoft, foreground: theme.warningText };
             default:
                 return {
                     background: PsMobileColorService.withAlpha(theme.ink, PsMobileControlConfig.neutralAlpha),

package/dist/services/ps-barcode-scanner-service.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentType } from 'react';
+import type { PsBarcodeFrameSize } from '../interfaces/ps-barcode-frame-size';
+import type { PsBarcodeLastRead } from '../interfaces/ps-barcode-last-read';
+import type { PsBarcodeScannerCameraProps } from '../interfaces/ps-barcode-scanner-native';
+export declare class PsBarcodeScannerService {
+    static isAvailable(): boolean;
+    static camera(): ComponentType<PsBarcodeScannerCameraProps> | null;
+    static requestPermission(): Promise<boolean>;
+    static normalise(data: string): string;
+    static accept(previous: PsBarcodeLastRead | null, data: string, now: number): boolean;
+    static types(barcodeTypes?: string[]): string[];
+    static frameSize(width: number): PsBarcodeFrameSize;
+    private static load;
+}

package/dist/services/ps-barcode-scanner-service.js

@@ -0,0 +1,53 @@
+import { PsBarcodeScannerConfig } from '../constants/ps-barcode-scanner-config';
+export class PsBarcodeScannerService {
+    static isAvailable() {
+        return PsBarcodeScannerService.load() !== null;
+    }
+    static camera() {
+        const native = PsBarcodeScannerService.load();
+        return native === null ? null : native.CameraView;
+    }
+    static async requestPermission() {
+        const native = PsBarcodeScannerService.load();
+        if (native === null)
+            return false;
+        try {
+            const response = await native.Camera.requestCameraPermissionsAsync();
+            return response.granted;
+        }
+        catch {
+            return false;
+        }
+    }
+    static normalise(data) {
+        return data.trim();
+    }
+    static accept(previous, data, now) {
+        if (data === '')
+            return false;
+        if (previous === null)
+            return true;
+        return previous.data !== data || now - previous.at >= PsBarcodeScannerConfig.cooldownMs;
+    }
+    static types(barcodeTypes) {
+        return barcodeTypes === undefined || barcodeTypes.length === 0
+            ? PsBarcodeScannerConfig.barcodeTypes
+            : barcodeTypes;
+    }
+    static frameSize(width) {
+        const frameWidth = Math.round(width * PsBarcodeScannerConfig.frameWidthFraction);
+        return {
+            height: Math.round(frameWidth * PsBarcodeScannerConfig.frameAspectRatio),
+            width: frameWidth,
+        };
+    }
+    static load() {
+        try {
+            const loaded = require('expo-camera');
+            return typeof loaded.CameraView === 'function' ? loaded : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}

package/dist/services/ps-button-style-service.d.ts

@@ -1,6 +1,8 @@
+import { PsRippleKind } from '../constants/ps-ripple-kind';
 import type { PsButtonStyleData } from '../interfaces/ps-button-style-data';
 import type { PsMobileTheme } from '../interfaces/ps-mobile-theme';
 export type PsButtonVariant = 'danger' | 'ghost' | 'primary' | 'secondary' | 'surface';
 export declare class PsButtonStyleService {
+    static rippleKind(variant: PsButtonVariant): PsRippleKind;
     static resolve(variant: PsButtonVariant, theme: PsMobileTheme): PsButtonStyleData;
 }

package/dist/services/ps-button-style-service.js

@@ -1,6 +1,18 @@
 import { PsMobileControlConfig } from '../constants/ps-mobile-control-config';
+import { PsRippleKind } from '../constants/ps-ripple-kind';
 import { PsMobileColorService } from './ps-mobile-color-service';
+import { PsStateService } from './ps-state-service';
 export class PsButtonStyleService {
+    static rippleKind(variant) {
+        switch (variant) {
+            case 'primary':
+                return PsRippleKind.OnPrimary;
+            case 'danger':
+                return PsRippleKind.OnDanger;
+            default:
+                return PsRippleKind.Surface;
+        }
+    }
     static resolve(variant, theme) {
         const hover = PsMobileColorService.withAlpha(theme.primary, PsMobileControlConfig.pressedBorderAlpha);
         switch (variant) {
@@ -9,8 +21,8 @@ export class PsButtonStyleService {
                     background: theme.primary,
                     border: theme.primary,
                     foreground: theme.primaryContrast,
-                    pressedBackground: theme.primary,
-                    pressedBorder: theme.primary,
+                    pressedBackground: theme.primaryPressed,
+                    pressedBorder: theme.primaryPressed,
                 };
             case 'danger':
                 return {
@@ -25,7 +37,7 @@ export class PsButtonStyleService {
                     background: theme.surface,
                     border: theme.line,
                     foreground: theme.ink,
-                    pressedBackground: PsMobileColorService.withAlpha(theme.ink, PsMobileControlConfig.pressedAlpha),
+                    pressedBackground: PsStateService.pressedFill(theme, theme.surface),
                     pressedBorder: hover,
                 };
         }