chore: fmt (#63)

load1n9 · web-flow · commit a3d719e52fb5 · 2024-09-11T10:21:48.000-04:00
* chore: fmt

* chore: bump version
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -32,8 +32,8 @@ jobs:
           rustc --version
           cargo --version
           cargo build --release -p netsaur
-          deno run -Ar jsr:@deno/wasmbuild@0.17.1 -p netsaur --out src/backends/wasm/lib
-          deno run -Ar jsr:@deno/wasmbuild@0.17.1 -p netsaur-tokenizers --out tokenizers/lib
+          deno run -Ar jsr:@deno/wasmbuild@0.17.2 -p netsaur --out src/backends/wasm/lib
+          deno run -Ar jsr:@deno/wasmbuild@0.17.2 -p netsaur-tokenizers --out tokenizers/lib
       - name: Release
         uses: softprops/action-gh-release@master
         env:
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,5 +1,5 @@
 [workspace]
-package.version = "0.4.0"
+package.version = "0.4.1"
 members = ["crates/*"]
 resolver = "2"
 
diff --git a/deno.jsonc b/deno.jsonc
@@ -1,6 +1,6 @@
 {
   "name": "@denosaurs/netsaur",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "exports": {
     ".": "./mod.ts",
     "./web": "./web.ts",
diff --git a/deno.lock b/deno.lock
diff --git a/packages/core/src/backends/cpu/mod.ts b/packages/core/src/backends/cpu/mod.ts
@@ -15,7 +15,7 @@ const options: FetchOptions = {
   name: "netsaur",
   url: new URL(import.meta.url).protocol !== "file:"
     ? new URL(
-      "https://github.com/denosaurs/netsaur/releases/download/0.4.0/",
+      "https://github.com/denosaurs/netsaur/releases/download/0.4.1/",
       import.meta.url,
     )
     : "./target/release/",
diff --git a/packages/core/src/backends/gpu/mod.ts b/packages/core/src/backends/gpu/mod.ts
@@ -15,7 +15,7 @@ const options: FetchOptions = {
   name: "netsaur_gpu",
   url: new URL(import.meta.url).protocol !== "file:"
     ? new URL(
-      "https://github.com/denosaurs/netsaur/releases/download/0.3.2-patch/",
+      "https://github.com/denosaurs/netsaur/releases/download/0.4.1/",
       import.meta.url,
     )
     : "./target/release/",
diff --git a/packages/core/src/backends/wasm/lib/netsaur.generated.js b/packages/core/src/backends/wasm/lib/netsaur.generated.js
@@ -217,7 +217,7 @@ const imports = {
     __wbindgen_object_drop_ref: function (arg0) {
       takeObject(arg0);
     },
-    __wbg_log_023d7669e382bddf: function (arg0, arg1) {
+    __wbg_log_6f7dfa87fad40a57: function (arg0, arg1) {
       console.log(getStringFromWasm0(arg0, arg1));
     },
     __wbindgen_number_new: function (arg0) {
diff --git a/packages/core/src/backends/wasm/lib/netsaur_bg.wasm b/packages/core/src/backends/wasm/lib/netsaur_bg.wasm
diff --git a/packages/core/src/backends/wasm/mod.ts b/packages/core/src/backends/wasm/mod.ts
@@ -22,7 +22,7 @@ export class WASMInstance {
     await instantiate({
       url: new URL(import.meta.url).protocol !== "file:"
         ? new URL(
-          "https://github.com/denosaurs/netsaur/releases/download/0.3.2-patch/netsaur_bg.wasm",
+          "https://github.com/denosaurs/netsaur/releases/download/0.4.1/netsaur_bg.wasm",
           import.meta.url,
         )
         : undefined,
diff --git a/packages/core/src/backends/wasm/utils.ts b/packages/core/src/backends/wasm/utils.ts
@@ -3,19 +3,19 @@ import type { Rank, Shape } from "../../core/api/shape.ts";
 /**
  * Train Options Interface.
  */
-export type TrainOptions = {
+export interface TrainOptions {
   datasets: number;
   inputShape: Shape<Rank>;
   outputShape: Shape<Rank>;
   epochs: number;
   batches: number;
   rate: number;
-};
+}
 
 /**
  * Predict Options Interface.
  */
-export type PredictOptions = {
+export interface PredictOptions {
   inputShape: Shape<Rank>;
   outputShape: Shape<Rank>;
-};
+}
diff --git a/packages/core/src/core/api/layer.ts b/packages/core/src/core/api/layer.ts
@@ -21,7 +21,7 @@ export type Layer =
 /**
  * The configuration for a dense layer.
  */
-export type DenseLayerConfig = {
+export interface DenseLayerConfig {
   /**
    * The type of initialization to use.
    */
@@ -46,7 +46,7 @@ export type DenseLayerConfig = {
 /**
  * The configuration for a dropout layer.
  */
-export type DropoutLayerConfig = {
+export interface DropoutLayerConfig {
   /**
    * probability of dropping out a value.
    */
@@ -61,7 +61,7 @@ export type DropoutLayerConfig = {
 /**
  * The configuration for an activation layer.
  */
-export type ActivationLayerConfig = {
+export interface ActivationLayerConfig {
   /**
    * The activation function to use.
    */
@@ -71,7 +71,7 @@ export type ActivationLayerConfig = {
 /**
  * The configuration for a convolutional layer.
  */
-export type Conv2DLayerConfig = {
+export interface Conv2DLayerConfig {
   /**
    * The type of initialization to use.
    */
@@ -111,7 +111,7 @@ export type Conv2DLayerConfig = {
 /**
  * The configuration for a convolutional transpose layer.
  */
-export type ConvTranspose2DLayerConfig = {
+export interface ConvTranspose2DLayerConfig {
   /**
    * The type of initialization to use.
    */
@@ -158,7 +158,7 @@ export enum PoolMode {
 /**
  * The configuration for a pooling layer.
  */
-export type Pool2DLayerConfig = {
+export interface Pool2DLayerConfig {
   /**
    * The optional strides to use.
    */
@@ -173,7 +173,7 @@ export type Pool2DLayerConfig = {
 /**
  * The configuration for a flatten layer.
  */
-export type FlattenLayerConfig = {
+export interface FlattenLayerConfig {
   /**
    * The size of the layer.
    */
@@ -183,7 +183,7 @@ export type FlattenLayerConfig = {
 /**
  * The configuration for a batch normalization layer.
  */
-export type BatchNormLayerConfig = {
+export interface BatchNormLayerConfig {
   /**
    * The momentum to use for the batch normalization.
    * Defaults to 0.99.
diff --git a/packages/core/src/core/api/optimizer.ts b/packages/core/src/core/api/optimizer.ts
@@ -6,16 +6,16 @@ export type Optimizer =
   | { type: OptimizerType.Nadam; config: AdamOptimizerConfig }
   | { type: OptimizerType.RMSProp; config: RMSPropOptimizerConfig };
 
-export type AdamOptimizerConfig = {
+export interface AdamOptimizerConfig {
   beta1?: number;
   beta2?: number;
   epsilon?: number;
-};
+}
 
-export type RMSPropOptimizerConfig = {
+export interface RMSPropOptimizerConfig {
   decayRate?: number;
   epsilon?: number;
-};
+}
 
 export function SGDOptimizer(): Optimizer {
   return { type: OptimizerType.SGD };
diff --git a/packages/core/src/core/api/scheduler.ts b/packages/core/src/core/api/scheduler.ts
@@ -8,15 +8,15 @@ export type Scheduler =
   }
   | { type: SchedulerType.OneCycle; config: OneCycleSchedulerConfig };
 
-export type DecaySchedulerConfig = {
+export interface DecaySchedulerConfig {
   rate?: number;
   step_size?: number;
-};
+}
 
-export type OneCycleSchedulerConfig = {
+export interface OneCycleSchedulerConfig {
   max_rate?: number;
   step_size?: number;
-};
+}
 
 export function NoScheduler(): Scheduler {
   return { type: SchedulerType.None };
diff --git a/packages/core/src/core/engine.ts b/packages/core/src/core/engine.ts
@@ -15,6 +15,12 @@ export interface BackendInstance {
 export interface BackendLoader {
   /**
    * Whether the backend is supported.
+   * 
+   * ```ts
+   * import { WASM } from "https://deno.land/x/netsaur/mod.ts";
+   * 
+   * console.log(WASM.isSupported());
+   * ```
    */
   isSupported(): boolean;
 
diff --git a/packages/core/src/core/mod.ts b/packages/core/src/core/mod.ts
@@ -17,11 +17,13 @@ import { SGDOptimizer } from "./api/optimizer.ts";
  */
 export class Sequential implements NeuralNetwork {
   backend!: Backend;
+  config: NetworkConfig;
 
   /**
    * Create a Sequential Neural Network.
    */
-  constructor(public config: NetworkConfig) {
+  constructor(config: NetworkConfig) {
+    this.config = config;
     this.config.cost = this.config.cost || Cost.MSE;
     this.config.optimizer = this.config.optimizer || SGDOptimizer();
     this.config.scheduler = this.config.scheduler || {
diff --git a/packages/core/src/core/tensor/tensor.ts b/packages/core/src/core/tensor/tensor.ts
@@ -16,7 +16,7 @@ import type {
 } from "../api/shape.ts";
 import { inferShape, length } from "./util.ts";
 
-export type TensorLike<R extends Rank> = {
+export interface TensorLike<R extends Rank> {
   shape: Shape<R>;
   data: Float32Array;
 };
@@ -35,13 +35,20 @@ export class Tensor<R extends Rank> {
 
   /**
    * Creates an empty tensor.
+   * ```ts
+   * Tensor.zeros([2, 2]);
+   * ```
    */
   static zeroes<R extends Rank>(shape: Shape<R>): Tensor<R> {
     return new Tensor(new Float32Array(length(shape)), shape);
   }
 
   /**
    * Serialise a tensor into JSON.
+   * 
+   * ```ts
+   * tensor([1, 2, 3, 4], [2, 2]).toJSON();
+   * ```
    */
   toJSON(): { data: number[]; shape: Shape<R> } {
     const data = new Array(this.data.length).fill(1);
diff --git a/packages/core/src/core/types.ts b/packages/core/src/core/types.ts
@@ -12,6 +12,10 @@ export interface Backend {
    * The train method is a function that trains a neural network using a set of training data.
    * It takes in an array of DataSet objects, the number of epochs to train for, and the learning rate.
    * The method modifies the weights and biases of the network to minimize the cost function and improve its accuracy on the training data.
+   *
+   * ```ts
+   * net.train(datasets, 100, 10, 0.01);
+   * ```
    */
   train(
     datasets: DataSet[],
@@ -24,6 +28,11 @@ export interface Backend {
    * The predict method is a function that takes in a Tensor object
    * representing the input to the neural network and returns a Promise that resolves to a Tensor object representing the output of the network.
    * This method is used to make predictions on new data after the network has been trained.
+   *
+   * ```ts
+   * const input = new Tensor([1, 2, 3, 4]);
+   * const output = await net.predict(input);
+   * ```
    */
   predict(
     input: Tensor<Rank>,
@@ -34,20 +43,28 @@ export interface Backend {
   /**
    * The save method is a function that saves the network to a Uint8Array.
    * This method is used to save the network after it has been trained.
+   *
+   * ```ts
+   * const buffer = net.save();
+   * ```
    */
   save(): Uint8Array;
 
   /**
    * The saveFile method is a function that takes in a string representing the path to a file and saves the network to that file.
    * This method is used to save the network after it has been trained.
+   *
+   * ```ts
+   * net.saveFile("model.bin");
+   * ```
    */
   saveFile(path: string): void;
 }
 
 /**
  * NetworkConfig represents the configuration of a neural network.
  */
-export type NetworkConfig = {
+export interface NetworkConfig {
   /**
    * Input size of the neural network.
    */
@@ -87,7 +104,7 @@ export type NetworkConfig = {
    * Number of disappointing iterations to allow before early stopping
    */
   patience?: number;
-};
+}
 
 /**
  * Activation functions are used to transform the output of a layer into a new output.
@@ -195,10 +212,10 @@ export enum SchedulerType {
 /**
  * DataSet is a container for training data.
  */
-export type DataSet = {
+export interface DataSet {
   inputs: Tensor<Rank>;
   outputs: Tensor<Rank>;
-};
+}
 
 export enum LayerType {
   Activation = "activation",
diff --git a/packages/tokenizers/lib/netsaur_tokenizers_bg.wasm b/packages/tokenizers/lib/netsaur_tokenizers_bg.wasm
diff --git a/packages/tokenizers/mod.ts b/packages/tokenizers/mod.ts
@@ -16,7 +16,7 @@ export async function init(): Promise<void> {
   await instantiate({
     url: new URL(import.meta.url).protocol !== "file:"
       ? new URL(
-        "https://github.com/denosaurs/netsaur/releases/download/0.3.2-patch/netsaur_tokenizers_bg.wasm",
+        "https://github.com/denosaurs/netsaur/releases/download/0.4.1/netsaur_tokenizers_bg.wasm",
         import.meta.url,
       )
       : undefined,
diff --git a/packages/visualizer/mod.ts b/packages/visualizer/mod.ts
diff --git a/utils/buildtools.ts b/utils/buildtools.ts

-Original file line number
+Diff line change
           rustc --version
           cargo --version
           cargo build --release -p netsaur
 -          deno run -Ar jsr:@deno/[email protected].1 -p netsaur --out src/backends/wasm/lib
 -          deno run -Ar jsr:@deno/[email protected].1 -p netsaur-tokenizers --out tokenizers/lib
 +          deno run -Ar jsr:@deno/[email protected].2 -p netsaur --out src/backends/wasm/lib
 +          deno run -Ar jsr:@deno/[email protected].2 -p netsaur-tokenizers --out tokenizers/lib
       - name: Release
         uses: softprops/action-gh-release@master
         env:
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@denosaurs/netsaur",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"exports": {`
`5`	`5`	`".": "./mod.ts",`
`6`	`6`	`"./web": "./web.ts",`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ const options: FetchOptions = {`
`15`	`15`	`name: "netsaur",`
`16`	`16`	`url: new URL(import.meta.url).protocol !== "file:"`
`17`	`17`	`? new URL(`
`18`		`- "https://github.com/denosaurs/netsaur/releases/download/0.4.0/",`
	`18`	`+ "https://github.com/denosaurs/netsaur/releases/download/0.4.1/",`
`19`	`19`	`import.meta.url,`
`20`	`20`	`)`
`21`	`21`	`: "./target/release/",`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@ export class WASMInstance {`
`22`	`22`	`await instantiate({`
`23`	`23`	`url: new URL(import.meta.url).protocol !== "file:"`
`24`	`24`	`? new URL(`
`25`		`- "https://github.com/denosaurs/netsaur/releases/download/0.3.2-patch/netsaur_bg.wasm",`
	`25`	`+ "https://github.com/denosaurs/netsaur/releases/download/0.4.1/netsaur_bg.wasm",`
`26`	`26`	`import.meta.url,`
`27`	`27`	`)`
`28`	`28`	`: undefined,`