linera-web: improve package.jsons (#4512)

## Motivation

The package metadata currently points to `linera-web`.

Also, `npm publish --public` doesn't work for new packages, and could be
missed by mistake.

## Proposal

Add some stub documentation here in `linera-protocol`, and update the
`package.json`s to point to it.

Also, add the public publish option to the config.

## Test Plan

Published it.

## Release Plan

- These changes should be backported to the latest `devnet` branch
- These changes should be backported to the latest `testnet` branch

## Links

- [reviewer
checklist](https://github.com/linera-io/linera-protocol/blob/main/CONTRIBUTING.md#reviewer-checklist)

Author: Twey

linera-web/README.md

@@ -0,0 +1,27 @@
+<!-- cargo-rdme start -->
+
+# `linera-web`
+
+This module defines the JavaScript bindings to the client API.
+
+It is compiled to Wasm, with a JavaScript wrapper to inject its imports, and published on
+NPM as `@linera/client`.
+
+There is a supplementary package `@linera/signer`, contained within the `signer`
+subdirectory, that defines signer implementations for different transaction-signing
+policies, including in-memory keys and signing using an existing MetaMask wallet.
+
+<!-- cargo-rdme end -->
+
+## Building
+
+Make sure your `cargo` invokes a nightly `rustc`. Then, you can build
+the package with `pnpm build` and publish it with `pnpm publish`.
+
+## Contributing
+
+See the [CONTRIBUTING](../CONTRIBUTING.md) file for how to help out.
+
+## License
+
+This project is available under the terms of the [Apache 2.0 license](../LICENSE).

linera-web/clippy.toml

@@ -0,0 +1 @@
+doc-valid-idents = ["MetaMask", ".."]

linera-web/package.json

@@ -2,6 +2,9 @@
   "name": "@linera/client",
   "version": "0.16.0",
   "description": "Web client for the Linera blockchain",
+  "publishConfig": {
+    "access": "public"
+  },
   "main": "dist/linera_web.js",
   "types": "dist/linera_web.d.ts",
   "files": [
@@ -22,12 +25,12 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/linera-io/linera-web.git"
+    "url": "git+https://github.com/linera-io/linera-protocol.git"
   },
   "bugs": {
-    "url": "https://github.com/linera-io/linera-web/issues"
+    "url": "https://github.com/linera-io/linera-protocol/issues"
   },
-  "homepage": "https://github.com/linera-io/linera-web#readme",
+  "homepage": "https://github.com/linera-io/linera-protocol/tree/main/linera-web#readme",
   "devDependencies": {
     "prettier": "3.5.3",
     "typedoc": "^0.28.5",

linera-web/signer/package.json

@@ -2,6 +2,9 @@
   "name": "@linera/signer",
   "version": "0.1.0",
   "description": "Implementations of Signer interface for the Linera blockchain",
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],

linera-web/src/lib.rs

@@ -2,8 +2,17 @@
 // SPDX-License-Identifier: Apache-2.0
 
 /*!
-This module defines the client API for the Web extension.
- */
+# `linera-web`
+
+This module defines the JavaScript bindings to the client API.
+
+It is compiled to Wasm, with a JavaScript wrapper to inject its imports, and published on
+NPM as `@linera/client`.
+
+There is a supplementary package `@linera/signer`, contained within the `signer`
+subdirectory, that defines signer implementations for different transaction-signing
+policies, including in-memory keys and signing using an existing MetaMask wallet.
+*/
 
 // We sometimes need functions in this module to be async in order to
 // ensure the generated code will return a `Promise`.