From 497760f1970094aa7e5200a3aa89d066fc786402 Mon Sep 17 00:00:00 2001
From: SiRanWeb <kirillg.web@gmail.com>
Date: Sat, 26 Nov 2022 14:47:12 +0300
Subject: [PATCH] finish readme

---
 README.md    | 26 +++++++++++++++-----------
 package.json |  2 +-
 2 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 4b02a42..2027709 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,12 @@ Extendable ActivityPub JS/TS models with official docs
 
 ## Docs
 
-Installation:
+Install with npm:
 ```
-# with npm
 npm i activitypub-models
-# with yarn
+```
+Install with yarn:
+```
 yarn add activitypub-models
 ```
 
@@ -72,17 +73,19 @@ const customNote = CustomNote.create({
 });
 ```
 
-Creating own models with JavaScript:
-```javascript
-import { NoteFields, APBase, ASModelType } from 'activitypub-models';
+You also can create models with plain JS, but you will lose types. Can be fixed with .d.ts and jsdoc:
+```typescript
+// CustomNote.d.ts
+import { APBase, NoteFields, WithContext } from "activitypub-models";
+export interface CustomNotesFields extends NoteFields {
+    myField: string | string[];
+}
+export type CustomNoteType = APBase<CustomNotesFields> & CustomNotesFields & WithContext;
 
-/**
- * @typedef {Object} CustomNoteFields
- * @property {string | string[]} myField
- */
+// CustomNote.js
+import {APBase, ASModelType} from "activitypub-models";
 
 class CustomNote extends APBase {
-    /** @param {NoteFields & CustomNoteFields} fields */
     static create(fields) {
         return APBase._create({
             type: ASModelType.Note,
@@ -91,6 +94,7 @@ class CustomNote extends APBase {
     }
 }
 
+/** @type {CustomNoteType} */
 const customNote = CustomNote.create({
     myField: 'I am a new field!'
 });
diff --git a/package.json b/package.json
index 347d97c..891e322 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "activitypub-models",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "ActivityPub Models JS/TS implementation",
   "main": "./dist/index.js",
   "type": "module",