@avocadostudio-ai/shared 0.2.3 → 0.3.1

package/dist/schemas.d.ts

@@ -20,6 +20,23 @@ export type PageMeta = {
 };
 export type PageDoc = {
     id: string;
+    /**
+     * The page's identity, as a path beginning with `"/"`. The home page is
+     * `"/"` — not `""`.
+     *
+     * This is a convention, not a validated format, and it was discoverable
+     * only from `buildSlug([])`'s body and the demo seed data. An integration
+     * that projects bare paths (`""`, `"events"`) mostly appears to work,
+     * because every non-empty slug resolves by string equality — and then the
+     * home page alone answers 400 with "session and slug are required", which
+     * reads as a missing query parameter rather than a malformed slug, and
+     * lands in the editor as the site's own 404 page inside the iframe.
+     *
+     * Build it with `buildSlug(segments)` rather than by hand. Where the URL a
+     * visitor uses differs from this identity — a locale prefix, a basePath, a
+     * CMS that owns its routing — put the URL in `meta.path` and leave the slug
+     * as the identity.
+     */
     slug: string;
     title: string;
     updatedAt: string;

package/dist/schemas.js

@@ -24,7 +24,7 @@ export const pageMetaSchema = z.object({
      *
      * Avocado has always treated the slug as the URL, which holds only while a
      * site's routing is Avocado's. It is not for anything with a locale prefix,
-     * a basePath, or a CMS that owns its own routes: Paintball Arena Bern keeps
+     * a basePath, or a CMS that owns its own routes: a field-level-i18n CMS keeps
      * one editable page per (document x language), so `/de/events` is a page
      * identity, while the site serves German at the root and answers 404 for
      * that path. An agent given the slug and told to open it goes to a 404 and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avocadostudio-ai/shared",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,7 +19,7 @@
   ],
   "dependencies": {
     "zod": "^4.3.6",
-    "@avocadostudio-ai/richtext": "0.2.3"
+    "@avocadostudio-ai/richtext": "^0.3.1"
   },
   "devDependencies": {
     "tsx": "^4.21.0",
@@ -37,7 +37,7 @@
     "visual-editing"
   ],
   "license": "Apache-2.0",
-  "homepage": "https://github.com/avocadostudio-ai/avocado/tree/main/packages/shared#readme",
+  "homepage": "https://docs.avocadostudio.dev",
   "bugs": {
     "url": "https://github.com/avocadostudio-ai/avocado/issues"
   },