chore: import upstream snapshot with attribution

2026-07-13 12:25:07 +08:00
commit a26e856398
1681 changed files with 296950 additions and 0 deletions
@@ -0,0 +1,30 @@
+# `@perspective-dev/esbuild-plugin`
+
+Applications bundled with `esbuild` can make use of the
+`@perspective-dev/esbuild-plugin` module. A full example can be found in the
+repo under
+[`examples/esbuild-example`](https://github.com/perspective-dev/perspective/tree/master/examples/esbuild-example).
+
+```javascript
+const esbuild = require("esbuild");
+const { PerspectiveEsbuildPlugin } = require("@perspective-dev/esbuild-plugin");
+
+esbuild.build({
+    entryPoints: ["src/index.js"],
+    plugins: [PerspectiveEsbuildPlugin()],
+    format: "esm",
+    bundle: true,
+    loader: {
+        ".ttf": "file",
+        ".wasm": "file",
+    },
+});
+```
+
+When bundling via `esbuild`, you must also:
+
+- Use the `type="module"` attribute in your app's `<script>` tag, as this build
+  mode is only supported via ES modules.
+- Use the direct imports for the `esm` versions Perspective, specifically
+  `@perspective-dev/client/dist/esm/perspective.js` and
+  `@perspective-dev/viewer/dist/esm/perspective-viewer.js`