feat: cargo init and configuration of the build targets

Signed-off-by: Enzo "raskyld" Nocera <[email protected]>

Author: raskyld

.gitignore

@@ -18,4 +18,8 @@ Cargo.lock
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+#.idea/
+
+# Added by cargo
+
+/target

Cargo.toml

@@ -0,0 +1,55 @@
+[package]
+name = "leptos-wasmcloud"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+leptos = "0.6.6"
+leptos_integration_utils = { version = "0.6.6", optional = true }
+leptos_meta = "0.6.6"
+leptos_router = "0.6.6"
+wasm-bindgen = { version = "0.2", optional = true }
+wit-bindgen = { version = "0.32.0", optional = true }
+
+[features]
+hydrate = [
+  "leptos/hydrate",
+  "leptos_meta/hydrate",
+  "leptos_router/hydrate",
+  "dep:wasm-bindgen",
+]
+ssr = [
+  "leptos/ssr",
+  "leptos_meta/ssr",
+  "leptos_router/ssr",
+  "dep:wit-bindgen",
+]
+
+[profile.wasm-release]
+inherits = "release"
+opt-level = 'z'
+lto = true
+codegen-units = 1
+panic = "abort"
+
+[package.metadata.leptos]
+# == Hydrate (client)
+lib-profile-release = "wasm-release"
+lib-features = ["hydrate"]
+lib-cargo-args = [
+    "-Zbuild-std=std,panic_abort,core,alloc",
+    "-Zbuild-std-features=panic_immediate_abort,wasi_ext",
+]
+
+# == SSR
+bin-profile-release = "wasm-release"
+# TODO: port to wasip2 as soon as cargo-component supports it
+bin-target-triple = "wasm32-wasip1"
+bin-features = ["ssr"]
+bin-cargo-args = [
+    "-Zbuild-std=std,panic_abort,core,alloc",
+    "-Zbuild-std-features=panic_immediate_abort,wasi_ext",
+]

README.md

@@ -66,9 +66,21 @@ when building your *full-stack* :tm: app with wasmCloud :sunglasses:
 [wasi-http-handler]: https://github.com/WebAssembly/wasi-http/blob/main/wit/handler.wit#L4
 [leptos-integrations]: https://github.com/leptos-rs/leptos/tree/main/integrations
 
+### Is Nightly Rust needed?
+
+As of Rust 1.82.0, IIUC, the two unstable features we may be interested in are:
+* `wasi_ext`: Some extensions to `std::fs` and `std::net`, but seems to be only
+  *nice-to-have*.
+* the cargo feature [`build-std`](https://github.com/rust-lang/cargo/blob/rust-1.82.0/src/cargo/core/features.rs#L1253),
+  to rebuild the stdlib with optimisation of the WebAssembly target. While it's more
+  of a *nice-to-have* for the `ssr`, it's kind of important for production build
+  of the `csr` as explained in [Leptos Docs][leptos-wasm-size].
+
+[leptos-wasm-size]: https://book.leptos.dev/deployment/binary_size.html
+
 ## Roadmap
 
 * [x] Start thinking about the overall architecture.
 * [ ] Get in touch with Leptos maintainers on their Discord to get tips.
 * [ ] Decide whether it should be in-tree Leptos code or a dedicated repo.
-* [ ] Start building (indeed)
+* [x] Start building (indeed)

rust-toolchain.toml

@@ -0,0 +1,4 @@
+[toolchain]
+chanel = ["nightly"]
+# TODO: port to wasip2 as soon as cargo-component supports it 
+targets = [ "wasm32-unknown-unknown", "wasm32-wasip1" ]

src/lib.rs

@@ -0,0 +1,3 @@
+fn main() {
+    println!("Hello, world!");
+}