kafkas · kafkas · May 23, 2026 · May 23, 2026 · May 23, 2026
diff --git a/.changeset/modern-parrots-search.md b/.changeset/modern-parrots-search.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.18.0
+
+### Minor Changes
+
+- 96a90bb: Add Firestore `document-reference` schema support, including optional target-model narrowing in generated TypeScript and Zod types, schema validation for referenced models, and integration coverage across TypeScript, Zod, Python, and Swift.
+
 ## 0.17.0
 
 ### Minor Changes

diff --git a/docs/schema/definition.mdx b/docs/schema/definition.mdx
@@ -53,7 +53,7 @@ Example values:
 ### Example
 
 ```yaml user.yml
-# yaml-language-server: $schema=https://schema.typesync.org/v0.16.json
+# yaml-language-server: $schema=https://schema.typesync.org/v0.18.json
 
 User:
   model: document
@@ -89,7 +89,7 @@ An alias model is used for convenience purposes to define reusable type aliases.
 ### Example
 
 ```yaml user.yml
-# yaml-language-server: $schema=https://schema.typesync.org/v0.16.json
+# yaml-language-server: $schema=https://schema.typesync.org/v0.18.json
 
 UserRole:
   model: alias
@@ -113,7 +113,7 @@ UserRole:
     of each definition file.
 
     ```yaml
-    # yaml-language-server: $schema=https://schema.typesync.org/v0.16.json
+    # yaml-language-server: $schema=https://schema.typesync.org/v0.18.json
     ```
 
     This indicates to your IDE that the file is not just any YAML file but a part of a Typesync definition by linking it to the relevant JSON Schema.. This will allow your IDE to provide Intellisense/autocomplete for definition fields.
@@ -133,7 +133,7 @@ UserRole:
 
       ```json
       {
-        "$schema": "https://schema.typesync.org/v0.16.json"
+        "$schema": "https://schema.typesync.org/v0.18.json"
         // ...
       }
       ```

diff --git a/docs/snippets/example-definition-graph.mdx b/docs/snippets/example-definition-graph.mdx
@@ -1,5 +1,5 @@
 ```yaml models.yml
-# yaml-language-server: $schema=https://schema.typesync.org/v0.16.json
+# yaml-language-server: $schema=https://schema.typesync.org/v0.18.json
 
 Author:
   model: document

diff --git a/docs/snippets/example-definition.mdx b/docs/snippets/example-definition.mdx
@@ -1,5 +1,5 @@
 ```yaml models.yml
-# yaml-language-server: $schema=https://schema.typesync.org/v0.16.json
+# yaml-language-server: $schema=https://schema.typesync.org/v0.18.json
 
 UserRole:
   model: alias

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "typesync-cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Schema-first Firestore tooling for types, validation, and visualization",
   "keywords": [
     "typesync",

diff --git a/public/v0.18.json b/public/v0.18.json