chore: prepare release 0.1.0

Author: ramsey

CHANGELOG.md

@@ -5,11 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## 0.1.0-alpha.1 - 2023-05-01
+## 0.1.0 - 2023-05-07
 
 ### Added
 
-- Set up initial repository structure and files.
+- Support parsing Lexicon schemas as of commit-ish [aabbf43](https://github.com/bluesky-social/atproto/blob/aabbf43a7f86b37cefbba614d408534b59f59525/packages/lexicon/src/types.ts) of [@atproto/lexicon](https://www.npmjs.com/package/@atproto/lexicon).
+  - There is a known issue when attempting to resolve references that use fragment identifiers that assume a reference to a value within the same document (i.e., they use `#something` instead of `com.example.method#something`). This library cannot yet resolve these references.
 
 ### Changed
 

README.md

@@ -16,6 +16,11 @@
 
 ## About
 
+socialweb/atproto-lexicon parses [Lexicon schemas][] for the [AT Protocol][].
+
+The current version is compliant with [@atproto/lexicon][] at commit-ish
+[aabbf43][].
+
 This project adheres to a [code of conduct](CODE_OF_CONDUCT.md).
 By participating in this project and its community, you are expected to
 uphold this code.
@@ -30,7 +35,7 @@ composer require socialweb/atproto-lexicon
 
 ## Usage
 
-``` php
+```php
 use SocialWeb\Atproto\Lexicon\Nsid\Nsid;
 use SocialWeb\Atproto\Lexicon\Parser\DefaultParserFactory;
 use SocialWeb\Atproto\Lexicon\Parser\DefaultSchemaRepository;
@@ -48,6 +53,32 @@ $schemaContents = file_get_contents((string) $schemaFile);
 $document = $parser->parse((string) $schemaContents);
 ```
 
+### Resolving References
+
+Using this library, you may resolve references in Lexicon schemas.
+
+For example:
+
+```php
+foreach ($document->defs as $defId => $def) {
+    if ($def instanceof LexRef) {
+        $resolved = $def->resolve();
+    }
+
+    if ($def instanceof LexRefUnion) {
+        foreach ($def->getLexRefs() as $ref) {
+            $resolved = $ref->resolve();
+        }
+    }
+
+    if ($def instanceof LexString) {
+        foreach ($def->getLexRefsForKnownValues() as $ref) {
+            $resolved = $ref->resolve();
+        }
+    }
+}
+```
+
 ## Contributing
 
 Contributions are welcome! To contribute, please familiarize yourself with
@@ -67,3 +98,9 @@ under the terms of the GNU Lesser General Public License (LGPL-3.0-or-later)
 as published by the Free Software Foundation. Please see
 [COPYING.LESSER](COPYING.LESSER), [COPYING](COPYING), and [NOTICE](NOTICE)
 for more information.
+
+
+[lexicon schemas]: https://atproto.com/guides/lexicon
+[at protocol]: https://atproto.com
+[@atproto/lexicon]: https://www.npmjs.com/package/@atproto/lexicon
+[aabbf43]: https://github.com/bluesky-social/atproto/blob/aabbf43a7f86b37cefbba614d408534b59f59525/packages/lexicon/src/types.ts