docs: declare table fields with @Field and @Relation decorators in examples

docs/1.introduction.md

@@ -45,6 +45,7 @@ import {
 } from "@antelopejs/interface-data-api/metadata";
 import {
   BasicDataModel,
+  Field,
   Index,
   Model,
   RegisterTable,
@@ -55,12 +56,17 @@ import {
 @RegisterTable("users")
 class User extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
   @Index()
+  @Field("string")
   declare email: string;
 
+  @Field("string")
   declare name: string;
+
+  @Field("string")
   declare password: string;
 }
 

docs/10.joined.md

@@ -13,25 +13,34 @@ Apply `@Joined` to a field that should be populated from a remote table. The loc
 ```typescript
 import { Joined } from "@antelopejs/interface-data-api/metadata";
 import {
+  Field,
   Index,
   RegisterTable,
+  Relation,
   Table,
 } from "@antelopejs/interface-database-decorators";
 
 @RegisterTable("users")
 class User extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
   declare name: string;
 }
 
 @RegisterTable("orders")
 class Order extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
+  @Relation({ to: () => User })
   declare userId: string;
+
+  @Field("number")
   declare total: number;
 }
 

docs/11.computed.md

@@ -15,15 +15,21 @@ import { Computed } from "@antelopejs/interface-data-api/metadata";
 
 @RegisterTable("groups")
 class Group extends Table {
+  @Field("string")
   declare _id: string;
+
+  @Field("string")
   declare name: string;
 }
 
 @RegisterTable("devices")
 class Device extends Table {
+  @Field("string")
   declare _id: string;
 
   @Index()
+  @Field("string")
+  @Relation({ to: () => Group })
   declare group_id: string;
 }
 

docs/2.data-controllers.md

@@ -23,6 +23,7 @@ import {
 } from "@antelopejs/interface-data-api/metadata";
 import {
   BasicDataModel,
+  Field,
   Index,
   Model,
   RegisterTable,
@@ -33,9 +34,13 @@ import {
 @RegisterTable("users")
 class User extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
   declare email: string;
+
+  @Field("number")
   declare age: number;
 }
 

docs/7.foreign-keys.md

@@ -11,26 +11,37 @@ Apply `@Foreign` to a field that stores a foreign key value. The decorator repla
 ```typescript
 import { Foreign } from "@antelopejs/interface-data-api/metadata";
 import {
+  Field,
   Index,
   RegisterTable,
+  Relation,
   Table,
 } from "@antelopejs/interface-database-decorators";
 
 @RegisterTable("users")
 class User extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
   declare name: string;
+
+  @Field("string")
   declare email: string;
 }
 
 @RegisterTable("orders")
 class Order extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
+  @Relation({ to: () => User })
   declare userId: string;
+
+  @Field("number")
   declare total: number;
 }
 
@@ -111,21 +122,30 @@ declare userId: User;
 
 When a field stores an array of foreign key IDs, set the `multi` parameter to `true`. The API resolves each ID and returns an array of full records.
 
+The table-level `@Relation({ many: true })` is declarative metadata recording that the field holds multiple target keys; API-side resolution is controlled solely by the `multi` parameter of `@Foreign`.
+
 ```typescript
 @RegisterTable("carts")
 class Cart extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field(["string"])
+  @Relation({ to: () => CartItem, many: true })
   declare items: string[]; // Array of CartItem IDs
 }
 
 @RegisterTable("cart_items")
 class CartItem extends Table {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
+  @Field("string")
   declare name: string;
+
+  @Field("number")
   declare price: number;
 }
 

docs/9.modifiers.md

@@ -44,6 +44,7 @@ import {
 } from "@antelopejs/interface-data-api/metadata";
 import {
   BasicDataModel,
+  Field,
   Index,
   Localized,
   LocalizationModifier,
@@ -55,12 +56,15 @@ import {
 @RegisterTable("content")
 class Content extends Table.with(LocalizationModifier) {
   @Index({ primary: true })
+  @Field("string")
   declare _id: string;
 
   @Localized()
+  @Field("string")
   declare title: string;
 
   @Localized()
+  @Field("string")
   declare description: string;
 }