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,26 @@
+# Examples
+
+The projects in the directory are self-contained Perspective examples. However,
+they are designed to run within the Perspective source repository tree. This
+makes it easy for Perspective OSS developers to test changes and validate that
+our Examples continue to work, but it also means these examples will most not
+work without properly linking in the Perspective build environment.
+
+In order to _run_ a project in this directory as written:
+
+1. Install and build Perspective from source.
+2. Run the project with `pnpm run start $PROJECT_NAME` from the repository root
+   (_not_ the `/examples` directory).
+
+## VirtualServer Examples
+
+These examples demonstrate custom data source implementations using the VirtualServer API, which allows you to create backends that serve data from any source without loading it into Perspective's tables:
+
+- **[nodejs-virtual-server](nodejs-virtual-server/)** - Node.js example with in-memory data and WebSocket server
+- **[python-duckdb-virtual](python-duckdb-virtual/)** - Python example using DuckDB as a data source
+
+# Optional
+
+Generally, the changes necessary to make these examples run _without_ the
+Perspective source repository are minor path or metadata corrections. Your
+results may vary.