Reduce private API descriptions from generated documents

Author: kateinoigakukun

packages/npm-packages/ruby-head-wasm-wasi/README.md

@@ -134,18 +134,15 @@ jnode.setRNode(rnode);
   - [wrap](#wrap)
     - [Parameters](#parameters-4)
     - [Examples](#examples-2)
-- [JsValueTransport](#jsvaluetransport)
 - [RbValue](#rbvalue)
-  - [Parameters](#parameters-5)
   - [call](#call)
-    - [Parameters](#parameters-6)
+    - [Parameters](#parameters-5)
     - [Examples](#examples-3)
   - [toPrimitive](#toprimitive)
-    - [Parameters](#parameters-7)
+    - [Parameters](#parameters-6)
   - [toString](#tostring)
   - [toJS](#tojs)
 - [RbError](#rberror)
-  - [Parameters](#parameters-8)
 
 ### RubyVM
 
@@ -237,37 +234,10 @@ hash.call("store", vm.eval(`"key1"`), vm.wrap(new Object()));
 
 Returns **any** the RbValue object representing the given JS value
 
-### JsValueTransport
-
-Export a JS value held by the Ruby VM to the JS environment.
-This is implemented in a dirty way since wit cannot reference resources
-defined in other interfaces.
-In our case, we can't express `function(v: rb-abi-value) -> js-abi-value`
-because `rb-js-abi-host.wit`, that defines `js-abi-value`, is implemented
-by embedder side (JS) but `rb-abi-guest.wit`, that defines `rb-abi-value`
-is implemented by guest side (Wasm).
-
-This class is a helper to export by:
-
-1.  Call `function __export_to_js(v: rb-abi-value)` defined in guest from embedder side.
-2.  Call `function takeJsValue(v: js-abi-value)` defined in embedder from guest side with
-    underlying JS value of given `rb-abi-value`.
-3.  Then `takeJsValue` implementation escapes the given JS value to the `_takenJsValues`
-    stored in embedder side.
-4.  Finally, embedder side can take `_takenJsValues`.
-
-Note that `exportJsValue` is not reentrant.
-
 ### RbValue
 
 A RbValue is an object that represents a value in Ruby
 
-#### Parameters
-
-- `inner`
-- `vm`
-- `privateObject`
-
 #### call
 
 Call a given method with given arguments
@@ -291,7 +261,7 @@ console.log(ary.call("sample").toString());
 
 ##### Parameters
 
-- `hint`
+- `hint` Preferred type of the result primitive value. `"number"`, `"string"`, or `"default"`.
 
 #### toString
 
@@ -310,10 +280,6 @@ Returns null if the value is not convertible to a JavaScript object.
 
 Error class thrown by Ruby execution
 
-#### Parameters
-
-- `message`
-
 ## Building the package from source
 
 The instructions for building a Ruby targeting WebAssembly are available [here](https://github.com/ruby/ruby.wasm#building-from-source).

packages/npm-packages/ruby-wasm-wasi/src/index.ts

@@ -243,6 +243,8 @@ export class RubyVM {
  * 4. Finally, embedder side can take `_takenJsValues`.
  *
  * Note that `exportJsValue` is not reentrant.
+ *
+ * @private
  */
 class JsValueTransport {
   private _takenJsValue: JsAbiValue = null;
@@ -271,6 +273,10 @@ class JsValueTransport {
  * A RbValue is an object that represents a value in Ruby
  */
 export class RbValue {
+
+  /**
+   * @hideconstructor
+   */
   constructor(
     private inner: RbAbi.RbAbiValue,
     private vm: RubyVM,
@@ -300,6 +306,7 @@ export class RbValue {
 
   /**
    * @see {@link https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive}
+   * @param hint Preferred type of the result primitive value. `"number"`, `"string"`, or `"default"`.
    */
   [Symbol.toPrimitive](hint: string) {
     if (hint === "string" || hint === "default") {
@@ -454,6 +461,9 @@ const evalRbCode = (vm: RubyVM, privateObject: RubyVMPrivate, code: string) => {
  * Error class thrown by Ruby execution
  */
 export class RbError extends Error {
+  /**
+   * @hideconstructor
+   */
   constructor(message: string) {
     super(message);
   }