update

public/openapi.yaml

@@ -1198,6 +1198,7 @@ paths:
                   data:
                     type: array
                     items: { $ref: "#/components/schemas/User" }
+                  links: { $ref: "#/components/schemas/PaginationLinks" }
                   meta: { $ref: "#/components/schemas/PaginationMeta" }
         "403": { $ref: "#/components/responses/Forbidden" }
 
@@ -2075,8 +2076,16 @@ components:
         deleted_at: { type: string, format: date-time, nullable: true }
         category: { $ref: "#/components/schemas/Category" }
         author: { $ref: "#/components/schemas/User" }
+        featured_image_alt:
+          type: string
+          nullable: true
+          description: |
+            What the image shows, resolved into the language above — unlike
+            `PageWrite`'s field of the same name, which carries every
+            language at once.
         translations:
           type: object
+          nullable: true
           description: Present only when `?with=translations` was passed.
           additionalProperties:
             type: object
@@ -2128,6 +2137,13 @@ components:
         pages_count: { type: integer }
         created_at: { type: string, format: date-time }
         updated_at: { type: string, format: date-time }
+        translations:
+          type: object
+          nullable: true
+          description: Present only when `?with=translations` was passed.
+          additionalProperties:
+            type: object
+            additionalProperties: { type: string }
 
     CategoryWrite:
       type: object
@@ -2160,6 +2176,7 @@ components:
         permissions:
           type: array
           items: { type: string }
+          nullable: true
           description: Effective local permissions. Returned by `/v1/me` only.
         remote_roles:
           type: array
@@ -2221,18 +2238,45 @@ components:
 
     PaginationMeta:
       type: object
+      description: |
+        Laravel's own paginator shape, sent as-is — nothing on this side
+        trims it down, so this describes exactly what `->paginate()` sends
+        rather than a curated subset of it.
       properties:
         current_page: { type: integer }
+        from: { type: integer, nullable: true, description: Null on an empty page. }
         last_page: { type: integer }
+        links:
+          type: array
+          description: One entry per page number shown by a "1 2 3 … 9" control, plus prev/next.
+          items:
+            type: object
+            properties:
+              url: { type: string, nullable: true }
+              label: { type: string, description: "Already translated — e.g. «Anterior», not «Previous»." }
+              page: { type: integer, nullable: true }
+              active: { type: boolean }
+        path: { type: string }
         per_page: { type: integer }
+        to: { type: integer, nullable: true, description: Null on an empty page. }
         total: { type: integer }
 
+    PaginationLinks:
+      type: object
+      description: The four addresses a client actually navigates with, ready to use verbatim.
+      properties:
+        first: { type: string }
+        last: { type: string }
+        prev: { type: string, nullable: true }
+        next: { type: string, nullable: true }
+
     PageCollection:
       type: object
       properties:
         data:
           type: array
           items: { $ref: "#/components/schemas/Page" }
+        links: { $ref: "#/components/schemas/PaginationLinks" }
         meta: { $ref: "#/components/schemas/PaginationMeta" }
 
     CategoryCollection:
@@ -2241,4 +2285,5 @@ components:
         data:
           type: array
           items: { $ref: "#/components/schemas/Category" }
+        links: { $ref: "#/components/schemas/PaginationLinks" }
         meta: { $ref: "#/components/schemas/PaginationMeta" }