@rust-js/create 0.0.1 → 0.0.3

package/README.md

@@ -1,8 +1,8 @@
 # @rust-js/create
 
 ```bash
-bun create @rust-js my-app      # with Bun
-npm create @rust-js my-app      # with Node.js
+bun create @rust-js@latest my-app      # with Bun
+npm create @rust-js@latest my-app      # with Node.js
 ```
 
 makes `my-app`, a Vite and React app whose component is written in Rust

package/index.js

@@ -20,7 +20,7 @@ const at = args.indexOf("--local");
 const local = at >= 0 ? args.splice(at, 2)[1] : undefined;
 if (at >= 0 && !local) fail("--local needs a distribution, the directory `bun run pack:distribution` makes");
 const [directory, ...extra] = args;
-if (!directory || extra.length) fail("usage: bun create @rust-js <directory> [--local <distribution>]");
+if (!directory || extra.length) fail("usage: bun create @rust-js@latest <directory> [--local <distribution>]");
 
 // A distribution is for one host, and one compiler: this one's.
 const dist = local && resolve(local);
@@ -53,11 +53,6 @@ for (const field of ["dependencies", "devDependencies"]) {
     if (spec.startsWith("workspace:")) manifest[field][name] = dist ? archive(name) : self.version;
   }
 }
-// The app's own, so every package manager has it at node_modules/@rust-js/resources,
-// where its Cargo.toml has the crates the app uses.
-manifest.devDependencies["@rust-js/resources"] = dist ? archive("@rust-js/resources") : self.version;
-const cargo = join(app, "Cargo.toml");
-writeFileSync(cargo, readFileSync(cargo, "utf8").replaceAll('path = "../../', 'path = "node_modules/@rust-js/resources/'));
 // The compiler is the app's own, as the plugin finds it, from the app: a
 // release's or a distribution's. A distribution's `@rust-js/build` is the
 // app's too, and the plugin's, where a release's is the registry's.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rust-js/create",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "`bun create @rust-js my-app`: a Vite and React app written in Rust. See docs/decisions/0105-create.md.",
   "license": "MIT",

package/template/Cargo.toml

@@ -1,7 +1,7 @@
-# src/App.rs as a crate, for an editor's rust-analyzer and a `cargo check`,
-# which check it with a plain rustc (ADR 0114). rust-js's build of it is the
-# Vite plugin's. `bun create @rust-js` has the crates where the app installs
-# them, in @rust-js/resources.
+# The app's crate, src/App.rs, which the Vite plugin builds with Cargo, and
+# an editor's rust-analyzer checks (ADR 0114). Its crates are npm packages,
+# named by version, which rust-js-patch, the app's `postinstall`, tells
+# Cargo are in node_modules; rust-js's own example has them by path.
 [package]
 name = "app"
 version = "0.0.0"
@@ -12,9 +12,9 @@ publish = false
 path = "src/App.rs"
 
 [dependencies]
-js = { package = "rust-js-builtins", path = "../../builtins" }
-react = { package = "rust-js-react", path = "../../react" }
-webapi = { package = "rust-js-webapi", path = "../../webapi" }
+js = { package = "rust-js-builtins", version = "~0.0.1" }
+react = { package = "rust-js-react", version = "~0.0.3" }
+webapi = { package = "rust-js-webapi", version = "~0.0.2" }
 
 # rust-js compiles with `--cfg=rust_js` (ADR 0113): a `cfg` Cargo checks for,
 # here too, in what `js::import!` expands to.

package/template/README.md

@@ -38,10 +38,14 @@ version that compiled. The browser's source map points at `App.rs`.
   else { "text-sky-500" }`, not a string built from pieces.
 - `rustJs()` comes first in `vite.config.js`, before `tailwindcss()`, so that
   a save refreshes the page instead of reloading it.
-- **`Cargo.toml` is for your editor** and `cargo check`: rust-analyzer finds
-  `react`, `webapi` and `js` in `node_modules/@rust-js/resources`, once the
-  app is installed. It doesn't look inside `jsx!`, so a variable used only in
-  JSX shows as unused there.
+- **The app is a Cargo package**, `Cargo.toml`, which the Vite plugin builds
+  with Cargo, and your editor's rust-analyzer checks. Its crates, `react`,
+  `webapi` and `js`, are npm packages, `@rust-js/react` and the others, named
+  in `Cargo.toml` by version: `rust-js-patch`, the app's `postinstall`, tells
+  Cargo they're in `node_modules`, in `.cargo/config.toml`. A binding of another
+  library, `@rust-js-bindings/canvas-confetti`, is added the same way: its npm
+  package, and a line in `Cargo.toml`. rust-analyzer doesn't look inside
+  `jsx!`, so a variable used only in JSX shows as unused there.
 - **`Cargo.toml` also sets how the JS is laid out**, by oxfmt's options,
   `[package.metadata.rust-js.format]` with `printWidth = 120`, say, and can run
   your own tools on it, a formatter or a linter, in

package/template/_gitignore

@@ -27,7 +27,9 @@ dist-ssr
 # ReScript recommends for its JS. Its source map isn't.
 /src/App.jsx.map
 
-# What an editor's `cargo check` of Cargo.toml writes. Its crates are paths,
-# which a lockfile pins nothing of.
+# What Cargo writes, and the patch rust-js-patch writes, of what's
+# installed: its crates are npm packages, which the lockfile of the app's
+# package manager pins.
 /target
 /Cargo.lock
+/.cargo

package/template/package.json

@@ -7,14 +7,18 @@
     "dev": "vite",
     "build": "vite build",
     "lint": "oxlint",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "postinstall": "rust-js-patch"
   },
   "dependencies": {
     "@rust-js/runtime": "workspace:*",
     "@tailwindcss/vite": "^4.3.3",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "tailwindcss": "^4.3.3"
+    "tailwindcss": "^4.3.3",
+    "@rust-js/builtins": "0.0.1",
+    "@rust-js/webapi": "0.0.2",
+    "@rust-js/react": "0.0.3"
   },
   "devDependencies": {
     "@babel/core": "^7.29.7",
@@ -25,6 +29,7 @@
     "babel-plugin-react-compiler": "^1.0.0",
     "oxlint": "^1.81.0",
     "vite": "^8.3.0",
-    "@rust-js/vite-plugin": "workspace:*"
+    "@rust-js/vite-plugin": "workspace:*",
+    "@rust-js/build": "workspace:*"
   }
 }

package/template/src/App.css

@@ -7,6 +7,9 @@
   border: 2px solid transparent;
   transition: border-color 0.3s;
   margin-bottom: 24px;
+  /* A flex box ends its text, "Count is ", at its last letter, and the count
+     is a box of its own: one character, as its font is monospace. */
+  gap: 1ch;
 
   &:hover {
     border-color: var(--accent-border);

package/template/vite.config.js

@@ -7,9 +7,10 @@ import rustJs from '@rust-js/vite-plugin'
 // https://vite.dev/config/
 export default defineConfig({
   plugins: [
-    // rust-js compiles src/App.rs to src/App.jsx, which plugin-react serves
-    // with Fast Refresh, and React Compiler memoizes.
-    rustJs(),
+    // rust-js compiles the app's crate, src/App.rs, with Cargo (ADR 0101),
+    // to src/App.jsx, which plugin-react serves with Fast Refresh, and React
+    // Compiler memoizes.
+    rustJs({ cargo: { package: 'app' } }),
     react(),
     babel({ presets: [reactCompilerPreset()] }),
     tailwindcss(),