chore: import upstream snapshot with attribution

rust/metadata/Cargo.toml

@@ -0,0 +1,45 @@
+#  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+#  ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+#  ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+#  ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+#  ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+#  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+#  ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+#  ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+#  ┃ This file is part of the Perspective library, distributed under the terms ┃
+#  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+#  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+[package]
+name = "metadata"
+description = "A CLI utility for generating Perspective project metadata like TypeScript definitions."
+edition = "2024"
+publish = false
+
+[[bin]]
+name = "perspective_metadata"
+path = "main.rs"
+bench = false
+
+[dependencies.cargo-bundle-licenses]
+version = "4.2.0"
+artifact = ["bin"]
+
+[dependencies.ts-rs]
+version = "11.0.1"
+features = ["serde-json-impl", "no-serde-warnings"]
+
+[dependencies.perspective-server]
+path = "../perspective-server"
+features = ["external-cpp", "disable-cpp"]
+
+[dependencies.perspective-client]
+features = ["generate-proto", "omit_metadata", "protobuf-src"]
+path = "../perspective-client"
+
+[dependencies.perspective-js]
+path = "../perspective-js"
+features = ["external-cpp"]
+
+[dependencies.perspective-viewer]
+path = "../perspective-viewer"

rust/metadata/build.mjs

@@ -0,0 +1,27 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+import { execSync } from "child_process";
+
+const INHERIT = {
+    stdio: "inherit",
+    stderr: "inherit",
+};
+
+function get_host() {
+    return /host\: (.+?)$/gm.exec(execSync(`rustc -vV`).toString())[1];
+}
+
+execSync(
+    `PSP_ROOT_DIR=../.. TS_RS_IMPORT_EXTENSION=js cargo run --target=${get_host()}`,
+    INHERIT,
+);

rust/metadata/main.rs

@@ -0,0 +1,109 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+#![recursion_limit = "1024"]
+
+//! This module generates metadata for other crates:
+//!
+//! - `perspective-client`
+//!     - Add `protobuf-src` dependency
+//!     - Generate `proto.rs` protobuf client bindings.
+//! - `perspective-js`
+//!     - TypeScript types
+//!     - Recurisvely set external proto on `perspective-client`
+//! - `perspective-server`
+//!     - Copy `cpp` and `cmake` to local root
+//!
+//! The `metadata` binary must be run for these assets to be updated in
+//! your local dev tree!
+
+use std::error::Error;
+use std::fmt::Write;
+use std::fs;
+
+use perspective_client::config::*;
+use perspective_client::{
+    ColumnWindow, DeleteOptions, JoinOptions, OnUpdateData, OnUpdateOptions, SystemInfo,
+    TableInitOptions, UpdateOptions, ViewWindow,
+};
+use perspective_js::TypedArrayWindow;
+use perspective_viewer::config::{PluginStaticConfig, ViewerConfig, ViewerConfigUpdate};
+use ts_rs::TS;
+
+pub fn generate_type_bindings_viewer() -> Result<(), Box<dyn Error>> {
+    let path = std::env::current_dir()?.join("../perspective-viewer/src/ts/ts-rs");
+    ViewerConfigUpdate::export_all_to(&path)?;
+    ViewerConfig::<String>::export_all_to(&path)?;
+    PluginStaticConfig::export_all_to(&path)?;
+    OnUpdateData::export_all_to(&path)?;
+    Ok(())
+}
+
+fn generate_exprtk_docs() -> Result<(), Box<dyn Error>> {
+    let mut txt = "<br/>\n\n# Perspective ExprTK Extensions\n\n".to_string();
+    for rec in perspective_client::config::COMPLETIONS {
+        writeln!(
+            txt,
+            "- `{}` {}",
+            rec.insert_text,
+            rec.documentation.replace("\n", " "),
+        )?;
+    }
+
+    fs::create_dir_all("../perspective-client/docs/")?;
+    fs::write("../perspective-client/docs/expression_gen.md", txt)?;
+    Ok(())
+}
+
+#[doc(hidden)]
+pub fn generate_type_bindings_js() -> Result<(), Box<dyn Error>> {
+    let path = std::env::current_dir()?.join("../perspective-js/src/ts/ts-rs");
+    ColumnType::export_all_to(&path)?;
+    ColumnWindow::export_all_to(&path)?;
+    DeleteOptions::export_all_to(&path)?;
+    JoinOptions::export_all_to(&path)?;
+    OnUpdateData::export_all_to(&path)?;
+    OnUpdateOptions::export_all_to(&path)?;
+    SystemInfo::<f64>::export_all_to(&path)?;
+    TableInitOptions::export_all_to(&path)?;
+    TypedArrayWindow::export_all_to(&path)?;
+    UpdateOptions::export_all_to(&path)?;
+    ViewConfig::export_all_to(&path)?;
+    ViewConfigUpdate::export_all_to(&path)?;
+    ViewWindow::export_all_to(&path)?;
+    ViewWindow::export_all_to(&path)?;
+    Ok(())
+}
+
+#[doc(hidden)]
+pub fn generate_python_cargo_licenses() -> Result<(), Box<dyn Error>> {
+    use std::fs::File;
+    use std::process::{Command, Stdio};
+    let python_dir = std::env::current_dir()?.join("../perspective-python");
+    let bundler = env!("CARGO_BIN_FILE_CARGO_BUNDLE_LICENSES_cargo-bundle-licenses");
+    let license_file = File::create(python_dir.join("LICENSE_THIRDPARTY_cargo.yml"))?;
+    Command::new(bundler)
+        .arg("--format=yaml")
+        .current_dir(python_dir)
+        .stdout(Stdio::from(license_file))
+        .spawn()?
+        .wait()?;
+    Ok(())
+}
+
+fn main() -> Result<(), Box<dyn Error>> {
+    generate_type_bindings_js()?;
+    generate_type_bindings_viewer()?;
+    generate_exprtk_docs()?;
+    generate_python_cargo_licenses()?;
+    Ok(())
+}

rust/metadata/package.json

@@ -0,0 +1,18 @@
+{
+    "name": "@perspective-dev/metadata",
+    "version": "4.5.2",
+    "description": "Benchmark utility based on perspective",
+    "private": true,
+    "files": [
+        "src/**/*"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/perspective-dev/perspective/packages/metadata"
+    },
+    "scripts": {
+        "build": "node build.mjs"
+    },
+    "author": "",
+    "license": "Apache-2.0"
+}