@abraca/schema 2.3.0 → 2.5.0

package/README.md

@@ -0,0 +1,30 @@
+# @abraca/schema
+
+The canonical page-type schema spec for Abracadabra. One Zod declaration per doc-type generates TypeScript, a JSON-Schema bundle, Rust, Swift, and Markdown — so every language validates the same shapes. **Zero runtime dependencies.**
+
+## Documentation
+
+Full, code-derived documentation lives in [`docs/`](docs/) — the registry model, the
+universal meta object, all 16 page types, the query DSL, CRDT markers, the plugin
+manifest validator, and the codegen pipeline. It is the source of truth (more
+authoritative than any prose page-type guide).
+
+## At a glance
+
+```ts
+import { defineSchema, Kanban, Doc } from "@abraca/schema";
+const schema = defineSchema({ types: [Kanban, Doc] });
+schema.validateMeta("kanban", meta);   // {ok:true} for unknown types (Rule 4)
+```
+
+- **16 page types** — doc, prose, kanban, gallery, table, outline, checklist, graph, timeline, calendar, map, dashboard, chart, sheets, slides, overview.
+- **Additive / opt-in** — no aggregate schema; compose the subset you need; unknown types are never rejected, known types are closed (`additionalProperties:false`).
+- **`query.ts`** is the wire contract the Rust server's query engine mirrors.
+
+::
+
+> The generated **JSON-Schema bundle** (`registry/v1.json`) is the real cross-language contract — consumed by the Rust `SchemaValidationExtension` and MCP tool schemas. Never hand-edit `src/generated/**`; run `pnpm schema:gen` (CI verifies). `yjs`/`zod` are peer deps.
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -945,8 +945,8 @@ declare const GalleryMeta: z.ZodObject<{
   gallerySortBy: z.ZodOptional<z.ZodEnum<{
     date: "date";
     rating: "rating";
-    manual: "manual";
     name: "name";
+    manual: "manual";
   }>>;
 }, z.core.$strict>;
 declare const Gallery: DocType<"gallery", z.ZodObject<{
@@ -994,8 +994,8 @@ declare const Gallery: DocType<"gallery", z.ZodObject<{
   gallerySortBy: z.ZodOptional<z.ZodEnum<{
     date: "date";
     rating: "rating";
-    manual: "manual";
     name: "name";
+    manual: "manual";
   }>>;
 }, z.core.$strict>, undefined>;
 declare const gallerySchema: SchemaRegistry<{
@@ -1031,7 +1031,7 @@ declare const gallerySchema: SchemaRegistry<{
     galleryAspect?: "square" | "4:3" | "3:2" | "16:9" | "free" | undefined;
     galleryCardStyle?: "default" | "compact" | "detailed" | undefined;
     galleryShowLabels?: boolean | undefined;
-    gallerySortBy?: "date" | "rating" | "manual" | "name" | undefined;
+    gallerySortBy?: "date" | "rating" | "name" | "manual" | undefined;
   };
 }>;
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/schema",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "One declaration of doc-types — generates TypeScript, JSON Schema, Rust, MCP tool, and Markdown reference output.",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,7 @@
   "devDependencies": {
     "yjs": "^13.6.8",
     "zod": "^4.3.6",
-    "@abraca/plugin": "2.3.0"
+    "@abraca/plugin": "2.5.0"
   },
   "scripts": {
     "test": "node --no-warnings --conditions=source --experimental-transform-types --test 'tests/*.test.ts'",