react-native-ensys-camera-x 1.0.7

package/src/jest-globals.d.ts

@@ -0,0 +1,9 @@
+declare const describe: (name: string, fn: () => void) => void;
+declare const it: (name: string, fn: () => void | Promise<void>) => void;
+declare const test: typeof it;
+declare const expect: any;
+declare const jest: any;
+declare const beforeEach: (fn: () => void | Promise<void>) => void;
+declare const afterEach: (fn: () => void | Promise<void>) => void;
+declare const beforeAll: (fn: () => void | Promise<void>) => void;
+declare const afterAll: (fn: () => void | Promise<void>) => void;

package/src/library/MediaLibrary.tsx

@@ -0,0 +1,141 @@
+/**
+ * CameraMediaLibrary — the batteries-included media library screen.
+ *
+ * This is the drop-in entry point: ONE element renders the whole shell the
+ * example app renders — the category pills, the swipeable category pager, the
+ * Plus/Cross FAB, the full-screen viewer with its scrubber and counter, the
+ * document/audio preview cards, the record-audio screen, the SQLCipher-backed
+ * library and upload progress:
+ *
+ * ```tsx
+ * export default function App() {
+ *   return (
+ *     <CameraMediaLibrary
+ *       locale={myApp.language}          // any BCP-47 tag the host already uses
+ *       bundles={MY_TRANSLATIONS}        // the host's existing translation data
+ *       uploadUrl="https://api.example.com/upload"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * It wraps {@link MediaLibraryScreen} in the plugin's three providers —
+ * `CameraThemeProvider`, `CameraIconProvider`, `CameraLocalizationProvider` —
+ * so a host needs no provider boilerplate of its own. Hosts that already mount
+ * those providers (because they use other plugin surfaces too) should render
+ * `<MediaLibraryScreen />` directly instead and skip the duplication.
+ *
+ * Defaults are the shipped design: omitting `theme` keeps the plugin's palette,
+ * omitting `icons` uses {@link libraryIconRegistry} (the shell's hand-authored
+ * outline set), and omitting `locale`/`bundles` renders English.
+ *
+ * The props are an alternative to `configureCameraPlugin`, not an addition to
+ * it. Configure language and icons through either one — a bare
+ * `<CameraMediaLibrary />` inherits whatever `configureCameraPlugin` set, and
+ * localization props passed here take over from it (they replace the plugin's
+ * localization config rather than merging into it).
+ */
+import { useMemo, type FC } from 'react';
+import {
+  CameraLocalizationProvider,
+  type CameraLocalizationProviderProps,
+} from '../localization';
+import { CameraThemeProvider } from '../theme';
+import { CameraIconProvider, type CameraIconRegistryConfig } from '../icons';
+import type { CameraThemeInput } from '../types';
+import { libraryIconRegistry } from './libraryIconRegistry';
+import {
+  MediaLibraryScreen,
+  type MediaLibraryScreenProps,
+} from './MediaLibraryScreen';
+
+export interface CameraMediaLibraryProps
+  extends MediaLibraryScreenProps,
+    Omit<CameraLocalizationProviderProps, 'children'> {
+  /**
+   * Colors/sizing for the plugin — the native camera screens AND this shell's
+   * plugin-linked palette tokens. Omit to keep the shipped look.
+   */
+  theme?: CameraThemeInput;
+  /**
+   * Icon overrides. The shell's own outline set is the base registry, so
+   * `{ overrides: { camera: { component: MyCameraIcon } } }` replaces one icon
+   * and leaves the rest alone. Passing `{ registry }` replaces the set wholesale.
+   */
+  icons?: CameraIconRegistryConfig;
+}
+
+export const CameraMediaLibrary: FC<CameraMediaLibraryProps> = ({
+  theme,
+  icons,
+  // ── Localization (forwarded to CameraLocalizationProvider) ──
+  locale,
+  version,
+  translate,
+  translations,
+  bundles,
+  fallbackLocale,
+  isRtl,
+  languageProvider,
+  // ── Everything else belongs to the screen itself ──
+  ...screenProps
+}) => {
+  // The shell's icons are the DEFAULT registry, not a replacement of the host's:
+  // a caller passing only `overrides` still gets the outline set underneath.
+  // Per-icon `customIcons` registered through `configureCameraPlugin` also
+  // survive — they resolve as global overrides, which outrank any registry.
+  const iconConfig = useMemo<CameraIconRegistryConfig>(
+    () => ({ registry: libraryIconRegistry, ...icons }),
+    [icons]
+  );
+
+  // Mount the localization provider ONLY when the host actually passes
+  // localization props. `CameraLocalizationProvider` applies its props with the
+  // REPLACE semantics of `setCameraLocalization`, so mounting it with every
+  // field undefined would clear a language and bundles the host had already
+  // registered through `configureCameraPlugin({ language, translations })` —
+  // the setup path the README teaches. Left unmounted, the shell still reads
+  // that same global store, because `useCameraLocalization` subscribes to it
+  // directly rather than to this context. Both integration styles therefore
+  // work; what must not happen is one silently erasing the other.
+  //
+  // A `languageProvider` bound globally is safe either way: the provider is the
+  // one field the REPLACE deliberately leaves alone, so automatic language
+  // synchronization keeps working even when this shell owns localization.
+  const ownsLocalization =
+    locale !== undefined ||
+    version !== undefined ||
+    translate !== undefined ||
+    translations !== undefined ||
+    bundles !== undefined ||
+    fallbackLocale !== undefined ||
+    isRtl !== undefined ||
+    languageProvider !== undefined;
+
+  const screen = <MediaLibraryScreen {...screenProps} />;
+
+  return (
+    <CameraThemeProvider theme={theme}>
+      <CameraIconProvider config={iconConfig}>
+        {ownsLocalization ? (
+          <CameraLocalizationProvider
+            locale={locale}
+            version={version}
+            translate={translate}
+            translations={translations}
+            bundles={bundles}
+            fallbackLocale={fallbackLocale}
+            isRtl={isRtl}
+            languageProvider={languageProvider}
+          >
+            {screen}
+          </CameraLocalizationProvider>
+        ) : (
+          screen
+        )}
+      </CameraIconProvider>
+    </CameraThemeProvider>
+  );
+};
+
+CameraMediaLibrary.displayName = 'CameraMediaLibrary';