zkit-ui 1.0.0

package/dist/services/ImagePreviewService/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * @file ImagePreviewService
+ *
+ * A full-screen image preview primitive plus a global imperative service.
+ * The declarative component owns the controlled/uncontrolled state model;
+ * the service only schedules one preview instance through ImagePreviewProvider.
+ */
+import * as React from 'react';
+import { Modal, type StyleProp, type ViewProps, type ViewStyle } from 'react-native';
+import { type ImageErrorEventData, type ImageLoadEventData, type ImageProps, type ImageSource, type ImageStyle } from 'expo-image';
+export type ImagePreviewSource = NonNullable<ImageProps['source']>;
+export type ImagePreviewImageDescriptor = ImageSource & {
+    id?: string;
+    source?: ImagePreviewSource;
+    alt?: string;
+    accessibilityLabel?: string;
+};
+export type ImagePreviewImage = ImagePreviewSource | ImagePreviewImageDescriptor;
+export type ImagePreviewTapBehavior = 'toggleChrome' | 'close' | 'none';
+export type ImagePreviewCloseReason = 'api' | 'back' | 'closeButton' | 'empty' | 'replace' | 'swipeDown' | 'tap' | 'unmount';
+export type ImagePreviewChangeReason = 'api' | 'controlled' | 'swipe';
+export type ImagePreviewOpenChangeReason = 'api' | ImagePreviewCloseReason;
+export type ImagePreviewResolvedImage = {
+    key: string;
+    source: ImagePreviewSource;
+    uri?: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+    accessibilityLabel?: string;
+    raw: ImagePreviewImage;
+};
+export type ImagePreviewOpenChangeMeta = {
+    reason: ImagePreviewOpenChangeReason;
+    value: number;
+    image: ImagePreviewResolvedImage | null;
+    total: number;
+};
+export type ImagePreviewChangeMeta = {
+    reason: ImagePreviewChangeReason;
+    previousValue: number;
+    value: number;
+    image: ImagePreviewResolvedImage | null;
+    total: number;
+};
+export type ImagePreviewResult = {
+    reason: ImagePreviewCloseReason;
+    value: number;
+    image: ImagePreviewResolvedImage | null;
+    total: number;
+};
+export type ImagePreviewPrefetchCachePolicy = 'disk' | 'memory' | 'memory-disk';
+export type ImagePreviewInteractions = {
+    tapBehavior?: ImagePreviewTapBehavior;
+    pinchToZoom?: boolean;
+    doubleTapToZoom?: boolean;
+    swipeToChange?: boolean;
+    swipeDownToClose?: boolean;
+    backToClose?: boolean;
+};
+export type ImagePreviewColors = {
+    backdrop?: string;
+    controlBackground?: string;
+    controlForeground?: string;
+    counterBackground?: string;
+    counterText?: string;
+    errorBackground?: string;
+    errorText?: string;
+    loading?: string;
+};
+export type ImagePreviewLabels = {
+    preview: string;
+    close: string;
+    loadFailed: string;
+    counter: (current: number, total: number) => string;
+    image: (current: number, total: number) => string;
+};
+export type ImagePreviewImageProps = Omit<ImageProps, 'accessibilityLabel' | 'alt' | 'children' | 'contentFit' | 'onError' | 'onLoad' | 'onLoadStart' | 'recyclingKey' | 'source' | 'style'>;
+export type ImagePreviewRenderContext = {
+    open: boolean;
+    value: number;
+    image: ImagePreviewResolvedImage | null;
+    total: number;
+    close: (reason?: ImagePreviewCloseReason) => void;
+    setValue: (value: number) => void;
+};
+export type ImagePreviewRef = {
+    close: (reason?: ImagePreviewCloseReason) => void;
+    setValue: (value: number) => void;
+    getValue: () => number;
+};
+export type ImagePreviewProps = {
+    images: readonly ImagePreviewImage[];
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean, meta: ImagePreviewOpenChangeMeta) => void;
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number, meta: ImagePreviewChangeMeta) => void;
+    onClose?: (result: ImagePreviewResult) => void;
+    disabled?: boolean;
+    dismissible?: boolean;
+    interactions?: ImagePreviewInteractions;
+    closeButton?: boolean;
+    counter?: boolean;
+    renderAhead?: number;
+    prefetch?: boolean | 'adjacent' | 'all';
+    prefetchCachePolicy?: ImagePreviewPrefetchCachePolicy;
+    contentFit?: NonNullable<ImageProps['contentFit']>;
+    imageProps?: ImagePreviewImageProps;
+    imageStyle?: StyleProp<ImageStyle>;
+    rootStyle?: StyleProp<ViewStyle>;
+    colors?: ImagePreviewColors;
+    labels?: Partial<ImagePreviewLabels>;
+    modalProps?: Omit<React.ComponentProps<typeof Modal>, 'children' | 'onRequestClose' | 'transparent' | 'visible'>;
+    renderHeader?: (context: ImagePreviewRenderContext) => React.ReactNode;
+    renderFooter?: (context: ImagePreviewRenderContext) => React.ReactNode;
+    renderOverlay?: (context: ImagePreviewRenderContext) => React.ReactNode;
+    onImageLoad?: (event: ImageLoadEventData, meta: {
+        value: number;
+        image: ImagePreviewResolvedImage;
+    }) => void;
+    onImageError?: (event: ImageErrorEventData, meta: {
+        value: number;
+        image: ImagePreviewResolvedImage;
+    }) => void;
+    testID?: ViewProps['testID'];
+    accessibilityLabel?: ViewProps['accessibilityLabel'];
+};
+export type ImagePreviewOpenOptions = Omit<ImagePreviewProps, 'defaultOpen' | 'defaultValue' | 'onClose' | 'open' | 'value'> & {
+    index?: number;
+    onClose?: (result: ImagePreviewResult) => void;
+};
+export type ImagePreviewServiceHandle = {
+    id: number;
+    result: Promise<ImagePreviewResult>;
+    close: (reason?: ImagePreviewCloseReason) => void;
+    setValue: (value: number) => void;
+    getSnapshot: () => ImagePreviewServiceSnapshot;
+};
+export type ImagePreviewServiceSnapshot = {
+    open: boolean;
+    value: number;
+    image: ImagePreviewResolvedImage | null;
+    total: number;
+};
+type ImagePreviewServiceRequest = ImagePreviewOpenOptions & {
+    id: number;
+    index: number;
+    result: Promise<ImagePreviewResult>;
+    resolve: (result: ImagePreviewResult) => void;
+    settled: boolean;
+};
+type ImagePreviewServiceController = {
+    open: (request: ImagePreviewServiceRequest) => void;
+    close: (reason: ImagePreviewCloseReason) => void;
+    setValue: (value: number) => void;
+    getSnapshot: () => ImagePreviewServiceSnapshot;
+};
+declare class ImagePreviewServiceClass {
+    private controller;
+    private currentRequest;
+    private requestId;
+    _bind(controller: ImagePreviewServiceController | null): void;
+    open(options: ImagePreviewOpenOptions): ImagePreviewServiceHandle;
+    close(reason?: ImagePreviewCloseReason): void;
+    setValue(value: number): void;
+    getSnapshot(): ImagePreviewServiceSnapshot;
+    _complete(id: number, result: ImagePreviewResult): void;
+    _dispose(id: number): void;
+    private finishRequest;
+}
+export declare const imagePreview: ImagePreviewServiceClass;
+export declare const ImagePreview: React.NamedExoticComponent<ImagePreviewProps & React.RefAttributes<ImagePreviewRef>>;
+export declare function ImagePreviewProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/services/ImagePreviewService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/ImagePreviewService/index.tsx"],"names":[],"mappings":"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"}