@reekon-tools/react-native-pdf-canvas 0.1.0 → 0.2.0

package/android/src/androidTest/java/tools/reekon/pdfcanvas/PdfCanvasDeviceTimingTest.java

@@ -1,251 +0,0 @@
-package tools.reekon.pdfcanvas;
-
-import android.content.Context;
-import android.util.Log;
-
-import androidx.test.ext.junit.runners.AndroidJUnit4;
-import androidx.test.platform.app.InstrumentationRegistry;
-
-import org.junit.Test;
-import org.junit.runner.RunWith;
-
-import java.io.File;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.Arrays;
-
-/**
- * MEASUREMENT, NOT VERIFICATION. Nothing here asserts a wall time — a timing
- * assertion fails on a loaded machine and tells nobody anything. These tests
- * exist so a physical-device run PRINTS the numbers every timing constant in
- * `src/policy.ts` is currently a placeholder for.
- *
- * <h3>Why this is separate from {@code PdfCanvasRasterizerTest.reportsTimings}</h3>
- *
- * That test reports BEST OF 3 at a 512 px tile. Both halves are now wrong for the
- * decision they feed:
- *
- *   - {@code minEpochIntervalMs} wants a p95, not a best. A best-of-3 is a FLOOR;
- *     it is the number that makes a cadence constant look achievable and then
- *     misses one frame in twenty on a warm phone.
- *   - The planner's {@code maxPieceDimension} now defaults to 1024, so 512 is no
- *     longer the size that gets rendered. A 1024 tile is 4x the destination area,
- *     and spike S1 measured cost as tracking DESTINATION AREA — so the 512 number
- *     cannot simply be scaled by eye.
- *
- * <h3>The one number that matters</h3>
- *
- * p95 of {@code PdfRenderer.render} for a 1024 px tile, on real hardware, on a
- * real drawing. Everything in the cadence is downstream of it. Note that this
- * measures the NATIVE render only — no bridge, no base64, no Skia ingest — which
- * is exactly what makes it useful: subtract it from the app probe's round-trip
- * p95 and the remainder is the transport tax.
- */
-@RunWith(AndroidJUnit4.class)
-public class PdfCanvasDeviceTimingTest {
-
-  private static final String TAG = "PDFCANVAS";
-
-  /** Enough samples that the 95th percentile is a real observation, not the max. */
-  private static final int SAMPLES = 20;
-
-  /**
-   * Where to drop a real customer PDF. The test app's own external files dir,
-   * because it is the one location adb's shell can write to AND an app UID can
-   * read at every level from 24 to 36 — {@code /data/local/tmp} is mode 0771
-   * shell:shell, so an app cannot traverse it.
-   */
-  private static final String REAL_PDF = "customer.pdf";
-
-  private static Context ctx() {
-    return InstrumentationRegistry.getInstrumentation().getTargetContext();
-  }
-
-  private static RasterRequest white(
-      int page, float x, float y, float w, float h, float scale) {
-    return new RasterRequest(
-        page, x, y, w, h, scale, false, RasterRequest.BACKGROUND_WHITE);
-  }
-
-  /* ================================================================ *
-   * Synthetic sheet — comparable across devices
-   * ================================================================ */
-
-  /**
-   * The piece sizes the planner can actually ask for, on the sheet size this
-   * package exists for.
-   *
-   * 1024 is the current {@code maxPieceDimension} default, 512 is the candidate
-   * the audit named as the next step down, and 2048 is what the plan degenerates
-   * to if the memory cap is ever raised to the hardware ceiling. Reading all
-   * three in one run is what makes the constant a choice rather than a guess.
-   */
-  @Test
-  public void tilePercentilesOnSyntheticArchD() throws Exception {
-    File arch =
-        TestPdfs.pattern(ctx(), "timing-archd.pdf", TestPdfs.ARCH_D_W, TestPdfs.ARCH_D_H);
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(arch, null, 1);
-    try {
-      for (int px : new int[] {512, 1024, 2048}) {
-        // scale 2 is a mid-zoom detail raster: the audit's ARCH-D phone case is
-        // scale 3 at fit, and a detail epoch is requested at the display scale.
-        float scale = 2f;
-        float side = px / scale;
-        report("synthetic archD " + px + "px@" + scale + "x", r, side, scale);
-      }
-      // The base layer, now tiled: one 1024 piece of a fit-scale base.
-      report("synthetic archD base-piece 1024px@0.677x", r, 1024f / 0.677f, 0.677f);
-    } finally {
-      r.close();
-    }
-  }
-
-  /* ================================================================ *
-   * Real drawing — the number that is actually true
-   * ================================================================ */
-
-  /**
-   * The synthetic pattern is vector rectangles and lines. A real drawing carries
-   * embedded fonts, CCITT or DCT images, transparency groups and annotations, and
-   * PDFium's cost is dominated by exactly those. Every timing in this file taken
-   * from {@code TestPdfs.pattern} is therefore an OPTIMISTIC bound, and the gap
-   * is not a small constant.
-   *
-   * Skips loudly rather than failing when no file has been pushed: a missing
-   * fixture is a setup step, not a defect, and a red test would train people to
-   * ignore it.
-   */
-  @Test
-  public void tilePercentilesOnARealDrawing() throws Exception {
-    File dir = ctx().getExternalFilesDir(null);
-    File pdf = dir == null ? null : new File(dir, REAL_PDF);
-    if (pdf == null || !pdf.isFile()) {
-      Log.w(
-          TAG,
-          "SKIP tilePercentilesOnARealDrawing — no "
-              + REAL_PDF
-              + ". Push one and re-run:\n"
-              + "  adb -s <serial> shell mkdir -p /sdcard/Android/data/"
-              + ctx().getPackageName()
-              + "/files\n"
-              + "  adb -s <serial> push your-drawing.pdf /sdcard/Android/data/"
-              + ctx().getPackageName()
-              + "/files/"
-              + REAL_PDF);
-      return;
-    }
-
-    long openStart = System.nanoTime();
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(pdf, null, 1);
-    long openMs = (System.nanoTime() - openStart) / 1_000_000L;
-    try {
-      PageGeometry g = r.pageGeometry(0);
-      Log.i(
-          TAG,
-          "real pdf: "
-              + pdf.length()
-              + " bytes, "
-              + r.pageCount()
-              + " pages, page0 "
-              + g.widthPoints
-              + "x"
-              + g.heightPoints
-              + "pt, open+geometry="
-              + openMs
-              + "ms, rotationSupport="
-              + PdfCanvasRasterizer.rotationSupport(ctx().getCacheDir()));
-
-      for (int px : new int[] {512, 1024, 2048}) {
-        float scale = 2f;
-        report("real " + px + "px@" + scale + "x", r, px / scale, scale);
-      }
-      // Fit-scale base piece, sized from the real page rather than ARCH-D.
-      float fit = 1170f / g.widthPoints;
-      report("real base-piece 1024px@fit(" + fit + ")", r, 1024f / fit, fit);
-    } finally {
-      r.close();
-    }
-  }
-
-  /* ================================================================ *
-   * Harness
-   * ================================================================ */
-
-  /**
-   * Walks the tile across the page between samples.
-   *
-   * Rendering the SAME rect twenty times measures whatever PDFium cached the
-   * first time — page parse, decoded image objects, rasterised glyphs — and on a
-   * real drawing that is most of the cost. Walking it means each sample pays for
-   * content it has not seen, which is what panning actually does.
-   */
-  private static void report(String label, PdfCanvasRasterizer r, float side, float scale)
-      throws PdfRasterException {
-    PageGeometry g = r.pageGeometry(0);
-    float maxX = Math.max(0f, g.widthPoints - side);
-    float maxY = Math.max(0f, g.heightPoints - side);
-    long[] ms = new long[SAMPLES];
-    int pxW = 0;
-    int pxH = 0;
-
-    for (int i = 0; i < SAMPLES; i++) {
-      float x = maxX == 0f ? 0f : (maxX * i) / (SAMPLES - 1);
-      float y = maxY == 0f ? 0f : (maxY * ((i * 7) % SAMPLES)) / (SAMPLES - 1);
-      RasterRequest request = white(0, x, y, side, side, scale);
-      long t0 = System.nanoTime();
-      RasterPixels pixels = r.render(request, null);
-      ms[i] = (System.nanoTime() - t0) / 1_000_000L;
-      pxW = pixels.width;
-      pxH = pixels.height;
-    }
-
-    long[] sorted = ms.clone();
-    Arrays.sort(sorted);
-    Log.i(
-        TAG,
-        "TIMING "
-            + label
-            + " dest="
-            + pxW
-            + "x"
-            + pxH
-            + " n="
-            + SAMPLES
-            + " min="
-            + sorted[0]
-            + " p50="
-            + percentile(sorted, 50)
-            + " p95="
-            + percentile(sorted, 95)
-            + " max="
-            + sorted[SAMPLES - 1]
-            + "ms  raw="
-            + Arrays.toString(ms));
-  }
-
-  /** Nearest-rank percentile. No interpolation: these are integer milliseconds. */
-  private static long percentile(long[] sorted, int p) {
-    int rank = (int) Math.ceil((p / 100.0) * sorted.length) - 1;
-    return sorted[Math.max(0, Math.min(sorted.length - 1, rank))];
-  }
-
-  /* ================================================================ *
-   * Unused-but-kept helper
-   * ================================================================ */
-
-  /** Kept so a fixture can be staged from an APK asset instead of adb, if that
-   * ever becomes the more convenient route. */
-  @SuppressWarnings("unused")
-  private static File copyAsset(String assetName, File into) throws IOException {
-    try (InputStream in = ctx().getAssets().open(assetName);
-        FileOutputStream out = new FileOutputStream(into)) {
-      byte[] buffer = new byte[64 * 1024];
-      int n;
-      while ((n = in.read(buffer)) > 0) {
-        out.write(buffer, 0, n);
-      }
-    }
-    return into;
-  }
-}

package/android/src/androidTest/java/tools/reekon/pdfcanvas/PdfCanvasFailureTest.java

@@ -1,221 +0,0 @@
-package tools.reekon.pdfcanvas;
-
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertNotEquals;
-import static org.junit.Assert.assertTrue;
-import static org.junit.Assert.fail;
-
-import android.content.Context;
-import android.util.Log;
-
-import androidx.test.ext.junit.runners.AndroidJUnit4;
-import androidx.test.platform.app.InstrumentationRegistry;
-
-import org.junit.Test;
-import org.junit.runner.RunWith;
-
-import java.io.File;
-
-/**
- * Failure modes.
- *
- * The requirement is DISTINGUISHABILITY, not merely "does not crash". A backend
- * that maps every bad input to {@code backend-failure} passes a
- * "throws something" test and is useless to the UI above it, which has to tell a
- * user "that file is encrypted" apart from "that file did not download". So each
- * test asserts a SPECIFIC code, and {@link #openFailuresAreDistinguishable}
- * asserts they are not all the same code — the check that actually fails if
- * someone collapses the mapping later.
- */
-@RunWith(AndroidJUnit4.class)
-public class PdfCanvasFailureTest {
-
-  private static final String TAG = "PDFCANVAS";
-
-  private static Context ctx() {
-    return InstrumentationRegistry.getInstrumentation().getTargetContext();
-  }
-
-  private static PdfErrorCode codeFromOpeningFile(File file, String password) {
-    try {
-      PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(file, password, 1);
-      r.close();
-      return null;
-    } catch (PdfRasterException e) {
-      Log.i(TAG, "open(" + file.getName() + ") -> " + e.code().wire() + ": " + e.getMessage());
-      return e.code();
-    }
-  }
-
-  /** CATCHES: a missing file reported as "corrupt", which sends a user hunting a good file. */
-  @Test
-  public void missingFileIsNotFound() {
-    assertEquals(
-        PdfErrorCode.NOT_FOUND, codeFromOpeningFile(TestPdfs.missing(ctx(), "gone.pdf"), null));
-  }
-
-  /**
-   * CATCHES: a native crash on garbage input, and a garbage file reported as
-   * "not found". PDFium REBUILDS a broken xref rather than giving up, so the
-   * fixture has no %PDF header and no recoverable objects at all — a file with
-   * merely a bad trailer would open fine and this branch would never be reached.
-   */
-  @Test
-  public void nonPdfIsCorrupt() throws Exception {
-    assertEquals(
-        PdfErrorCode.CORRUPT, codeFromOpeningFile(TestPdfs.notAPdf(ctx(), "notes.txt"), null));
-  }
-
-  /** CATCHES: a zero-byte download reported as "not a PDF" instead of a truncated file. */
-  @Test
-  public void emptyFileIsCorrupt() throws Exception {
-    assertEquals(
-        PdfErrorCode.CORRUPT, codeFromOpeningFile(TestPdfs.empty(ctx(), "empty.pdf"), null));
-  }
-
-  /**
-   * CATCHES: an encrypted document reported as corrupt — the single most
-   * misleading mapping available here, because the UI's correct response is a
-   * password prompt and "corrupt" sends the user to re-download a perfectly good
-   * file.
-   *
-   * The fixture has a NON-EMPTY user password. An empty one would open cleanly
-   * on every viewer and this test would be asserting nothing.
-   */
-  @Test
-  public void encryptedDocumentRequiresAPassword() throws Exception {
-    File pdf = TestPdfs.encrypted(ctx(), "locked.pdf");
-    assertEquals(PdfErrorCode.PASSWORD_REQUIRED, codeFromOpeningFile(pdf, null));
-  }
-
-  /**
-   * CATCHES: silently ignoring a supplied password.
-   *
-   * {@code PdfRenderer} has no way to accept one below API 35 — {@code LoadParams}
-   * is where that landed, and this module compiles against SDK 34. Accepting the
-   * argument and dropping it would turn "wrong password" into "corrupt file" for
-   * every encrypted document, so it is refused loudly instead.
-   */
-  @Test
-  public void supplyingAPasswordIsUnsupportedNotIgnored() throws Exception {
-    File pdf = TestPdfs.pattern(ctx(), "pw-letter.pdf", TestPdfs.LETTER_W, TestPdfs.LETTER_H);
-    assertEquals(PdfErrorCode.UNSUPPORTED, codeFromOpeningFile(pdf, "hunter2"));
-  }
-
-  /** The check that fails if the mapping is ever collapsed to one code. */
-  @Test
-  public void openFailuresAreDistinguishable() throws Exception {
-    PdfErrorCode missing = codeFromOpeningFile(TestPdfs.missing(ctx(), "gone2.pdf"), null);
-    PdfErrorCode garbage = codeFromOpeningFile(TestPdfs.notAPdf(ctx(), "notes2.txt"), null);
-    PdfErrorCode locked = codeFromOpeningFile(TestPdfs.encrypted(ctx(), "locked2.pdf"), null);
-
-    assertNotEquals(missing, garbage);
-    assertNotEquals(garbage, locked);
-    assertNotEquals(missing, locked);
-  }
-
-  /** CATCHES: an out-of-range page index reaching PdfRenderer and crashing natively. */
-  @Test
-  public void outOfRangePageIsNotFound() throws Exception {
-    File pdf = TestPdfs.pattern(ctx(), "range-letter.pdf", TestPdfs.LETTER_W, TestPdfs.LETTER_H);
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(pdf, null, 1);
-    try {
-      assertEquals(1, r.pageCount());
-      for (int page : new int[] {-1, 1, 99}) {
-        try {
-          r.pageGeometry(page);
-          fail("pageGeometry(" + page + ") should have thrown");
-        } catch (PdfRasterException e) {
-          assertEquals(PdfErrorCode.NOT_FOUND, e.code());
-        }
-        try {
-          r.render(
-              new RasterRequest(
-                  page, 0f, 0f, 100f, 100f, 1f, false, RasterRequest.BACKGROUND_WHITE),
-              null);
-          fail("render(page=" + page + ") should have thrown");
-        } catch (PdfRasterException e) {
-          assertEquals(PdfErrorCode.NOT_FOUND, e.code());
-        }
-      }
-    } finally {
-      r.close();
-    }
-  }
-
-  /**
-   * CATCHES: use-after-close reaching native code. A closed {@code PdfRenderer}
-   * whose {@code openPage} is called is a native crash, not an exception, so
-   * this is the difference between an error a promise can reject with and a dead
-   * process.
-   */
-  @Test
-  public void renderAfterCloseFailsInsteadOfCrashing() throws Exception {
-    File pdf = TestPdfs.pattern(ctx(), "closed-letter.pdf", TestPdfs.LETTER_W, TestPdfs.LETTER_H);
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(pdf, null, 1);
-    r.close();
-    // Idempotent: a double close must not throw either, because close() is
-    // driven by a React unmount and can genuinely arrive twice.
-    r.close();
-    try {
-      r.render(
-          new RasterRequest(0, 0f, 0f, 100f, 100f, 1f, false, RasterRequest.BACKGROUND_WHITE),
-          null);
-      fail("render after close should have thrown");
-    } catch (PdfRasterException e) {
-      assertEquals(PdfErrorCode.BACKEND_FAILURE, e.code());
-    }
-  }
-
-  /**
-   * CATCHES: an absurd raster reaching {@code Bitmap.createBitmap} and killing
-   * the process with an {@code OutOfMemoryError} that carries no raster key and
-   * cannot be turned into a diagnostic.
-   */
-  @Test
-  public void absurdRasterIsRefusedRatherThanAllocated() throws Exception {
-    File pdf = TestPdfs.pattern(ctx(), "oom-letter.pdf", TestPdfs.LETTER_W, TestPdfs.LETTER_H);
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(pdf, null, 1);
-    try {
-      r.render(
-          new RasterRequest(
-              0, 0f, 0f, TestPdfs.LETTER_W, TestPdfs.LETTER_H, 40f, false,
-              RasterRequest.BACKGROUND_WHITE),
-          null);
-      fail("a 24480x31680 raster should have been refused");
-    } catch (PdfRasterException e) {
-      assertEquals(PdfErrorCode.OUT_OF_MEMORY, e.code());
-      assertTrue(e.getMessage(), e.getMessage().contains("Refused"));
-    } finally {
-      r.close();
-    }
-  }
-
-  /** CATCHES: a degenerate request producing a zero-size bitmap, which throws natively. */
-  @Test
-  public void degenerateRequestsAreRejected() throws Exception {
-    File pdf = TestPdfs.pattern(ctx(), "degenerate.pdf", TestPdfs.LETTER_W, TestPdfs.LETTER_H);
-    PdfCanvasRasterizer r = PdfCanvasRasterizer.openFile(pdf, null, 1);
-    try {
-      float[][] bad = {
-        {0f, 100f, 1f}, // zero width
-        {100f, 0f, 1f}, // zero height
-        {100f, 100f, 0f}, // zero scale
-        {100f, 100f, -1f}, // negative scale
-      };
-      for (float[] b : bad) {
-        try {
-          r.render(
-              new RasterRequest(
-                  0, 0f, 0f, b[0], b[1], b[2], false, RasterRequest.BACKGROUND_WHITE),
-              null);
-          fail("expected rejection for " + b[0] + "x" + b[1] + " @" + b[2]);
-        } catch (PdfRasterException e) {
-          assertEquals(PdfErrorCode.BACKEND_FAILURE, e.code());
-        }
-      }
-    } finally {
-      r.close();
-    }
-  }
-}