react-native-alpha-video-gpu 0.0.0-stage → 1.0.1

package/react-native/src/index.d.ts

@@ -0,0 +1,95 @@
+import type { ViewStyle } from 'react-native';
+import type React from 'react';
+
+// Re-export native component types
+export * from './AlphaVideoGpuViewNativeComponent';
+
+// Source type for the wrapper component (see SourceType for the URI forms, headers and dataSource)
+export type AlphaVideoGpuSource = import('./AlphaVideoGpuViewNativeComponent').SourceType;
+
+/**
+ * Where a URL's or data source's bytes are kept between plays, read back by range: 'disk' (the
+ * cache folder; the browser's storage on web), 'memory' (for the app's lifetime) or 'none'. 'auto',
+ * the default, is 'disk' for URLs and 'none' for a data source, whose caching is its own.
+ */
+export type AlphaVideoGpuStorage = 'auto' | 'disk' | 'memory' | 'none';
+
+/** Web only: reads the file by offset (an app's own fetcher or cache); the smallest is `{ size, read }`. */
+export interface AlphaVideoGpuByteSource {
+  open?(signal?: AbortSignal): Promise<{ size: number; etag?: string; lastModified?: string }>;
+  readonly size?: number;
+  read(offset: number, length: number, signal?: AbortSignal): Promise<Uint8Array>;
+  close?(): void;
+}
+
+// Props for the main AlphaVideoGpuView wrapper component (index.js)
+export interface AlphaVideoGpuViewProps {
+  /** Source object, or a bare URI string (legacy). On web also a Blob or a byte source */
+  source?: AlphaVideoGpuSource | string | Blob | AlphaVideoGpuByteSource | null;
+  /** Start playing automatically (default: true) */
+  autoPlay?: boolean;
+  /** Loop the animation (default: true) */
+  loop?: boolean;
+  /** Playback speed multiplier (default: 1.0) */
+  playbackSpeed?: number;
+  /** What the store keeps the source under, instead of its URL (same as `source.cacheKey`) */
+  cacheKey?: string;
+  /** Where a URL's or data source's bytes are kept between plays. Default: 'auto' */
+  storage?: AlphaVideoGpuStorage;
+  /** The store's cap in bytes, over every clip, least recently played out first. Default: 512 MB */
+  maxStorageBytes?: number;
+  /** Pause playback */
+  paused?: boolean;
+  /** View style */
+  style?: ViewStyle;
+  /** Locates the view in end-to-end tests */
+  testID?: string;
+  // Every event has this shape on Android, iOS and web
+  /** Callback when player state changes */
+  onStateChange?: (event: { nativeEvent: { state: string } }) => void;
+  /** Callback after a seek, and for every frame played with `enableFrameEvents` */
+  onFrameUpdate?: (event: { nativeEvent: { frame: number; totalFrames: number } }) => void;
+  /** Callback when playback finishes */
+  onFinished?: (event: { nativeEvent: {} }) => void;
+  /**
+   * Callback on error. `code` tells apart the errors an app may handle: on the web
+   * 'ASTC_UNSUPPORTED' or 'WEBGL_UNSUPPORTED', on iOS and Android 'NO_SOURCE_MODULE' (a data
+   * source without the range-source add-on)
+   */
+  onError?: (event: { nativeEvent: { error: string; code?: 'ASTC_UNSUPPORTED' | 'WEBGL_UNSUPPORTED' | 'NO_SOURCE_MODULE' | '' } }) => void;
+  /** Callback when loaded */
+  onLoad?: (event: { nativeEvent: { width: number; height: number; frameCount: number; frameRate: number; duration: number } }) => void;
+  
+  // Streaming parameters
+  /** Frames decoded ahead of the shown one, all streaming keeps (in the GPU ring with 'vram', in RAM with 'ram') */
+  streamingPrefetchAhead?: number;
+  /** Where frames are kept: 'vram' (default) or 'ram' */
+  memoryStrategy?: 'vram' | 'ram';
+  /** Stream texture-array files instead of loading every frame. Default: true */
+  stream?: boolean;
+  /** Send onFrameUpdate for every frame played; seeks always send it. Default: false */
+  enableFrameEvents?: boolean;
+  /** Log info traces. Warnings and errors always log. Default: false */
+  verbose?: boolean;
+}
+
+/**
+ * Seeks show the frame (clamped to the clip) and keep playing, or stay paused. They are ignored
+ * until `onLoad`. With `stream`, a seek outside the buffered frames decodes the file again from
+ * the start (or onwards from the decoder, for a seek ahead of it).
+ */
+export interface AlphaVideoGpuViewRef {
+  /** Plays from the shown frame, or from the start once a clip that doesn't loop has finished. */
+  play: () => void;
+  pause: () => void;
+  /** Pauses on the first frame. */
+  stop: () => void;
+  seekToFrame: (frame: number) => void;
+  /** Seeks to the frame showing at that time, in seconds. */
+  seekToTime: (seconds: number) => void;
+}
+
+// The actual component is defined in index.js, but we declare the type here
+export declare const AlphaVideoGpuView: React.MemoExoticComponent<
+  React.ForwardRefExoticComponent<AlphaVideoGpuViewProps & React.RefAttributes<AlphaVideoGpuViewRef>>
+>;

package/react-native/src/index.js

@@ -0,0 +1,162 @@
+import React, { forwardRef, useImperativeHandle, useMemo, useRef } from 'react';
+import { View, StyleSheet, Platform } from 'react-native';
+
+// Platform-specific imports
+let NativeAlphaVideoGpuView;
+let NativeCommands;
+let WebAlphaVideoGpuView;
+
+if (Platform.OS === 'web') {
+  // Resolves to AlphaVideoGpuView.web.tsx; native bundles get the empty AlphaVideoGpuView.js
+  WebAlphaVideoGpuView = require('./AlphaVideoGpuView').default;
+} else {
+  // Codegen spec: a Fabric component on the new architecture, a view manager on the old one
+  const nativeComponent = require('./AlphaVideoGpuViewNativeComponent');
+  NativeAlphaVideoGpuView = nativeComponent.default;
+  NativeCommands = nativeComponent.Commands;
+}
+
+/**
+ * AlphaVideoGpuView - React Native component for GPU-accelerated alpha video playback
+ * 
+ * Features:
+ * - GPU texture compression (ASTC) for efficient transparent video
+ * - GPU-accelerated playback (Metal on iOS, OpenGL ES on Android, WebGL on Web)
+ * - Low CPU/battery usage compared to traditional video codecs
+ * - Sources: https:// (read by range, and stored), file:// or absolute paths, asset://, on Android
+ *   content:// and res/raw, and with source.dataSource anything a registered native data source reads
+ * - Works on iOS, Android, and Web (React Native Web)
+ * 
+ * @param {Object} props - Component props
+ * @param {Object|string} props.source - Source object {uri, cacheKey, headers, dataSource}, or a bare URI string (legacy)
+ * @param {boolean} [props.autoPlay=true] - Start playing automatically
+ * @param {boolean} [props.loop=true] - Loop the animation
+ * @param {number} [props.playbackSpeed=1.0] - Playback speed multiplier
+ * @param {string} [props.cacheKey] - What the store keeps the source under, instead of its URL
+ * @param {string} [props.storage='auto'] - 'auto', 'disk', 'memory' or 'none': where a URL's or data source's bytes are kept
+ * @param {number} [props.maxStorageBytes] - The store's cap in bytes (default 512 MB)
+ * @param {Function} [props.onStateChange] - Callback when player state changes
+ * @param {Function} [props.onFrameUpdate] - Callback on each frame update
+ * @param {Function} [props.onFinished] - Callback when playback finishes
+ * @param {Function} [props.onError] - Callback on error
+ * @param {Object} [props.style] - View style
+ *
+ * The ref has play(), pause(), stop(), seekToFrame(frame) and seekToTime(seconds).
+ */
+export const AlphaVideoGpuView = React.memo(forwardRef(({
+  source,
+  autoPlay = true,
+  loop = true,
+  playbackSpeed = 1.0,
+  cacheKey,
+  style,
+  onStateChange,
+  onFrameUpdate,
+  onFinished,
+  onError,
+  ...otherProps
+}, ref) => {
+  const viewRef = useRef(null);
+
+  useImperativeHandle(ref, () => {
+    if (Platform.OS === 'web') {
+      const call = (name, args) => viewRef.current?.[name]?.(...args);
+      return {
+        play: () => call('play', []),
+        pause: () => call('pause', []),
+        stop: () => call('stop', []),
+        seekToFrame: frame => call('seekToFrame', [frame]),
+        seekToTime: seconds => call('seekToTime', [seconds]),
+      };
+    }
+    const send = (name, ...args) => {
+      if (viewRef.current) NativeCommands[name](viewRef.current, ...args);
+    };
+    return {
+      play: () => send('play'),
+      pause: () => send('pause'),
+      stop: () => send('stop'),
+      seekToFrame: frame => send('seekToFrame', frame),
+      seekToTime: seconds => send('seekToTime', seconds),
+    };
+  }, []);
+  // Normalize source to object format for consistency
+  const normalizedSource = useMemo(() => {
+    if (!source) return null;
+    
+    // If source is already an object, use it as-is
+    if (typeof source === 'object') {
+      return source;
+    }
+    
+    // Legacy string support - convert to object
+    return { uri: source };
+  }, [source]);
+
+  // A key passed as a prop or inside `source` both count; the prop wins.
+  const effectiveCacheKey = cacheKey != null ? cacheKey : normalizedSource?.cacheKey;
+
+  // Codegen has no string maps, so headers go to native as [name, value, ...]. Keyed by value,
+  // so that a source object made inline on each render isn't a new source.
+  const { uri, headers, dataSource } = normalizedSource ?? {};
+  const headersKey = headers ? JSON.stringify(headers) : '';
+  const nativeSource = useMemo(
+    () => ({
+      uri,
+      cacheKey: normalizedSource?.cacheKey,
+      headers: headers ? [].concat(...Object.entries(headers)) : undefined,
+      dataSource,
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [uri, normalizedSource?.cacheKey, headersKey, dataSource],
+  );
+
+  if (!source) {
+    return <View style={style} />;
+  }
+
+  // Web implementation
+  if (Platform.OS === 'web') {
+    return (
+      <WebAlphaVideoGpuView
+        ref={viewRef}
+        source={normalizedSource}
+        cacheKey={effectiveCacheKey}
+        autoPlay={autoPlay}
+        loop={loop}
+        playbackSpeed={playbackSpeed}
+        style={style}
+        onStateChange={onStateChange}
+        onFrameUpdate={onFrameUpdate}
+        onFinished={onFinished}
+        onError={onError}
+        {...otherProps}
+      />
+    );
+  }
+
+  return (
+    <NativeAlphaVideoGpuView
+      ref={viewRef}
+      source={nativeSource}
+      autoPlay={autoPlay}
+      loop={loop}
+      playbackSpeed={playbackSpeed}
+      cacheKey={effectiveCacheKey}
+      style={[styles.container, style]}
+      onStateChange={onStateChange}
+      onFrameUpdate={onFrameUpdate}
+      onFinished={onFinished}
+      onError={onError}
+      {...otherProps}
+    />
+  );
+}));
+
+AlphaVideoGpuView.displayName = 'AlphaVideoGpuView';
+
+const styles = StyleSheet.create({
+  container: {
+    // Note: backgroundColor not supported on GLSurfaceView
+  },
+});

package/react-native-alpha-video-gpu.podspec

@@ -0,0 +1,37 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'react-native-alpha-video-gpu'
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.homepage     = package['homepage']
+  s.license      = package['license']
+  s.authors      = package['author']
+
+  s.platforms    = { :ios => '13.0' }
+  s.source       = { :git => package['repository']['url'], :tag => "v#{s.version}" }
+
+  # The iOS library (ios/Sources/AlphaVideoGPU, also the Swift package and the alpha-video-gpu
+  # pod) and the React Native view. AlphaVideoGpuView.mm compiles the ASTC decoder and zstd by
+  # #include. The range-source add-on is react-native-range-source, which the player finds at runtime.
+  s.source_files        = 'ios/Sources/AlphaVideoGPU/**/*.{h,mm}', 'third_party/range-source/include/*.h',
+                          'react-native/ios/**/*.{h,mm}'
+  s.public_header_files = 'ios/Sources/AlphaVideoGPU/include/AlphaVideoGPU.h'
+  s.preserve_paths      = 'ios/Sources/AlphaVideoGPU/astc_decomp.cpp', 'third_party/zstd/**/*'
+  s.frameworks          = 'Metal', 'MetalKit'
+  s.libraries           = 'c++'
+  s.pod_target_xcconfig = {
+    'CLANG_CXX_LANGUAGE_STANDARD' => 'c++17',
+    'HEADER_SEARCH_PATHS' => '"$(PODS_TARGET_SRCROOT)/third_party" "$(PODS_TARGET_SRCROOT)/third_party/range-source/include"'
+  }
+
+  # React Native's helper: the Fabric and codegen dependencies, and RCT_NEW_ARCH_ENABLED on the
+  # new architecture. It reads pod_target_xcconfig, so it comes after it.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency 'React-Core'
+  end
+end

package/react-native.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        sourceDir: './react-native/android',
+        packageImportPath: 'import dev.mediacache.alphavideo.gpu.reactnative.AlphaVideoGpuPackage;',
+        packageInstance: 'new AlphaVideoGpuPackage()',
+      },
+      ios: {},
+    },
+  },
+};

package/third_party/licenses/Apache-2.0.txt

@@ -0,0 +1,208 @@
+Apache License
+
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION,
+AND DISTRIBUTION
+
+   1. Definitions.
+
+      
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution
+as defined by Sections 1 through 9 of this document.
+
+      
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+      
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct
+or indirect, to cause the direction or management of such entity, whether
+by contract or otherwise, or (ii) ownership of fifty percent (50%) or more
+of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+      
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions
+granted by this License.
+
+      
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+      
+
+"Object" form shall mean any form resulting from mechanical transformation
+or translation of a Source form, including but not limited to compiled object
+code, generated documentation, and conversions to other media types.
+
+      
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that
+is included in or attached to the work (an example is provided in the Appendix
+below).
+
+      
+
+"Derivative Works" shall mean any work, whether in Source or Object form,
+that is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative
+Works shall not include works that remain separable from, or merely link (or
+bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+      
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative
+Works thereof, that is intentionally submitted to Licensor for inclusion in
+the Work by the copyright owner or by an individual or Legal Entity authorized
+to submit on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication
+sent to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor
+for the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+      
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently incorporated
+within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable copyright license to reproduce, prepare
+Derivative Works of, publicly display, publicly perform, sublicense, and distribute
+the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable (except as stated in this section) patent
+license to make, have made, use, offer to sell, sell, import, and otherwise
+transfer the Work, where such license applies only to those patent claims
+licensable by such Contributor that are necessarily infringed by their Contribution(s)
+alone or by combination of their Contribution(s) with the Work to which such
+Contribution(s) was submitted. If You institute patent litigation against
+any entity (including a cross-claim or counterclaim in a lawsuit) alleging
+that the Work or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses granted to You
+under this License for that Work shall terminate as of the date such litigation
+is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and
+in Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy
+of this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You distribute,
+all copyright, patent, trademark, and attribution notices from the Source
+form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution,
+then any Derivative Works that You distribute must include a readable copy
+of the attribution notices contained within such NOTICE file, excluding those
+notices that do not pertain to any part of the Derivative Works, in at least
+one of the following places: within a NOTICE text file distributed as part
+of the Derivative Works; within the Source form or documentation, if provided
+along with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works
+that You distribute, alongside or as an addendum to the NOTICE text from the
+Work, provided that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction,
+or distribution of Your modifications, or for any such Derivative Works as
+a whole, provided Your use, reproduction, and distribution of the Work otherwise
+complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without
+any additional terms or conditions. Notwithstanding the above, nothing herein
+shall supersede or modify the terms of any separate license agreement you
+may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to
+in writing, Licensor provides the Work (and each Contributor provides its
+Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied, including, without limitation, any warranties
+or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR
+A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness
+of using or redistributing the Work and assume any risks associated with Your
+exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether
+in tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to
+in writing, shall any Contributor be liable to You for damages, including
+any direct, indirect, special, incidental, or consequential damages of any
+character arising as a result of this License or out of the use or inability
+to use the Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all other commercial
+damages or losses), even if such Contributor has been advised of the possibility
+of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work
+or Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such obligations,
+You may act only on Your own behalf and on Your sole responsibility, not on
+behalf of any other Contributor, and only if You agree to indemnify, defend,
+and hold each Contributor harmless for any liability incurred by, or claims
+asserted against, such Contributor by reason of your accepting any such warranty
+or additional liability. END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate
+notice, with the fields enclosed by brackets "[]" replaced with your own identifying
+information. (Don't include the brackets!) The text should be enclosed in
+the appropriate comment syntax for the file format. We also recommend that
+a file or class name and description of purpose be included on the same "printed
+page" as the copyright notice for easier identification within third-party
+archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+
+you may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+
+distributed under the License is distributed on an "AS IS" BASIS,
+
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+See the License for the specific language governing permissions and
+
+limitations under the License.

package/third_party/range-source/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Kasprowicz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/third_party/range-source/README.md

@@ -0,0 +1,10 @@
+# range-source (native)
+
+`include/` is `native/include` from [range-source](https://github.com/MediaCacheDev/range-source), unmodified, at commit `5c5dd0929ddbfbb51730b41d9dfd1a468d35e58e`. MIT, by the same author as this repository.
+
+- `include/range_source.h` is the add-on's C interface, a table of functions, with a C++ wrapper over it. The player finds the add-on at runtime and reads URLs and data sources through it.
+- `include/range_source_download.h` is the basic input, for when the add-on isn't there: a URL downloaded whole into a temporary file, read as it arrives.
+
+Each player puts the C++ wrappers in a namespace of its own (`RANGE_SOURCE_CLIENT_NAMESPACE`), so another player's copy in the same app can't clash.
+
+To update, run `scripts/vendor_range_source.sh` against a newer checkout. Its tests live in that repository (`native/test`).