@abraca/schema 2.3.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@abraca/schema",
+  "version": "2.3.0",
+  "description": "One declaration of doc-types — generates TypeScript, JSON Schema, Rust, MCP tool, and Markdown reference output.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/abracadabra-schema.cjs",
+  "module": "dist/abracadabra-schema.esm.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "source": {
+      "import": "./src/index.ts"
+    },
+    "default": {
+      "import": "./dist/abracadabra-schema.esm.js",
+      "require": "./dist/abracadabra-schema.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "peerDependencies": {
+    "yjs": "^13.6.8",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "yjs": "^13.6.8",
+    "zod": "^4.3.6",
+    "@abraca/plugin": "2.3.0"
+  },
+  "scripts": {
+    "test": "node --no-warnings --conditions=source --experimental-transform-types --test 'tests/*.test.ts'",
+    "schema:gen": "node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-ts.ts && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-json-schema.ts && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-plugin-manifest-json-schema.ts && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-rust.ts && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-swift.ts && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-md.ts",
+    "schema:gen:check": "node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-ts.ts --check && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-json-schema.ts --check && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-plugin-manifest-json-schema.ts --check && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-rust.ts --check && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-swift.ts --check && node --no-warnings --conditions=source --experimental-transform-types scripts/codegen-md.ts --check"
+  }
+}

package/src/crdt.ts

@@ -0,0 +1,63 @@
+/**
+ * CRDT primitive shims for the schema DSL.
+ *
+ * Y.Text / Y.Array / Y.Map cannot be expressed as plain JSON, so the
+ * markers below serve two roles:
+ *
+ *   1. **Type inference** — consumers writing `body: ytext()` get the
+ *      compile-time signal that the field is a `Y.Text` instance.
+ *   2. **Codegen markers** — generators (TS, Rust, JSON Schema, MCP)
+ *      read the `crdt: "ytext" | "yarray" | "ymap"` metadata to emit
+ *      the right output (e.g. JSON Schema gets `string` for ytext;
+ *      Rust codegen emits `yrs::TextRef`).
+ *
+ * Runtime validation against meta values is a no-op — meta is read as
+ * POJOs from a Y.Map, and CRDT-typed slots live in `body` / `children`,
+ * not in `meta`.
+ *
+ * yjs is a *peer* dep — the type-only import is erased at runtime.
+ */
+
+import type * as Y from "yjs";
+import { z } from "zod";
+
+export type CrdtKind = "ytext" | "yarray" | "ymap";
+
+export interface CrdtMeta {
+	readonly crdt: CrdtKind;
+	readonly element?: z.ZodType;
+}
+
+/** Y.Text marker. Reads as opaque CRDT — schema does not validate the contents. */
+export function ytext(): z.ZodType<Y.Text> {
+	return z
+		.custom<Y.Text>(() => true)
+		.meta({ crdt: "ytext" } satisfies CrdtMeta);
+}
+
+/** Y.Array<T> marker. Element schema is preserved in metadata for codegen. */
+export function yarray<T extends z.ZodType>(
+	element: T,
+): z.ZodType<Y.Array<z.infer<T>>> {
+	return z
+		.custom<Y.Array<z.infer<T>>>(() => true)
+		.meta({ crdt: "yarray", element } satisfies CrdtMeta);
+}
+
+/** Y.Map<T> marker. Value schema is preserved in metadata for codegen. */
+export function ymap<T extends z.ZodType>(
+	value: T,
+): z.ZodType<Y.Map<z.infer<T>>> {
+	return z
+		.custom<Y.Map<z.infer<T>>>(() => true)
+		.meta({ crdt: "ymap", element: value } satisfies CrdtMeta);
+}
+
+/** Inspect a Zod schema for a CRDT marker. Returns undefined for non-CRDT schemas. */
+export function crdtMetaOf(schema: z.ZodType): CrdtMeta | undefined {
+	const meta = schema.meta() as Partial<CrdtMeta> | undefined;
+	if (meta && typeof meta.crdt === "string") {
+		return meta as CrdtMeta;
+	}
+	return undefined;
+}

package/src/generated/calendar.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (calendar).
+ *
+ * Source: ../types/calendar.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { CalendarMeta } from "../types/calendar.ts";
+
+export type DocTypeName = "calendar";
+
+export type DocMetaMap = {
+	"calendar": z.infer<typeof CalendarMeta>;
+};
+
+export type DocBodyMap = {
+	"calendar": never;
+};
+
+export type DocChildrenMap = {
+	"calendar": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/chart.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (chart).
+ *
+ * Source: ../types/chart.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { ChartMeta } from "../types/chart.ts";
+
+export type DocTypeName = "chart";
+
+export type DocMetaMap = {
+	"chart": z.infer<typeof ChartMeta>;
+};
+
+export type DocBodyMap = {
+	"chart": never;
+};
+
+export type DocChildrenMap = {
+	"chart": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/checklist.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (checklist).
+ *
+ * Source: ../types/checklist.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { ChecklistMeta } from "../types/checklist.ts";
+
+export type DocTypeName = "checklist";
+
+export type DocMetaMap = {
+	"checklist": z.infer<typeof ChecklistMeta>;
+};
+
+export type DocBodyMap = {
+	"checklist": never;
+};
+
+export type DocChildrenMap = {
+	"checklist": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/dashboard.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (dashboard).
+ *
+ * Source: ../types/dashboard.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { DashboardMeta } from "../types/dashboard.ts";
+
+export type DocTypeName = "dashboard";
+
+export type DocMetaMap = {
+	"dashboard": z.infer<typeof DashboardMeta>;
+};
+
+export type DocBodyMap = {
+	"dashboard": never;
+};
+
+export type DocChildrenMap = {
+	"dashboard": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/doc.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (doc).
+ *
+ * Source: ../types/doc.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { DocMeta } from "../types/doc.ts";
+
+export type DocTypeName = "doc";
+
+export type DocMetaMap = {
+	"doc": z.infer<typeof DocMeta>;
+};
+
+export type DocBodyMap = {
+	"doc": Y.Text;
+};
+
+export type DocChildrenMap = {
+	"doc": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/gallery.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (gallery).
+ *
+ * Source: ../types/gallery.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { GalleryMeta } from "../types/gallery.ts";
+
+export type DocTypeName = "gallery";
+
+export type DocMetaMap = {
+	"gallery": z.infer<typeof GalleryMeta>;
+};
+
+export type DocBodyMap = {
+	"gallery": never;
+};
+
+export type DocChildrenMap = {
+	"gallery": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/graph.ts

@@ -0,0 +1,35 @@
+/**
+ * AUTO-GENERATED by @abraca/schema (graph).
+ *
+ * Source: ../types/graph.ts
+ * Run `pnpm schema:gen` to regenerate. Do not edit by hand —
+ * CI verifies that this file matches the generator output.
+ */
+
+import type * as Y from "yjs";
+import type { z } from "zod";
+import type { GraphMeta } from "../types/graph.ts";
+
+export type DocTypeName = "graph";
+
+export type DocMetaMap = {
+	"graph": z.infer<typeof GraphMeta>;
+};
+
+export type DocBodyMap = {
+	"graph": never;
+};
+
+export type DocChildrenMap = {
+	"graph": never;
+};
+
+export interface DocOf<N extends DocTypeName> {
+	readonly id: string;
+	readonly type: N;
+	readonly meta: DocMetaMap[N];
+	readonly body: DocBodyMap[N];
+	readonly children: ReadonlyArray<DocOf<DocChildrenMap[N]>>;
+}
+
+export type Doc = { [N in DocTypeName]: DocOf<N> }[DocTypeName];

package/src/generated/json-schema/calendar.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://abraca.dev/schema/registry/v1.json",
+  "schemaVersion": 1,
+  "label": "calendar",
+  "types": {
+    "calendar": {
+      "version": 1,
+      "meta": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "type": "object",
+        "properties": {
+          "color": {
+            "type": "string",
+            "pattern": "^#[0-9a-fA-F]{6}$"
+          },
+          "icon": {
+            "type": "string"
+          },
+          "datetimeStart": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "datetimeEnd": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "allDay": {
+            "type": "boolean"
+          },
+          "dateStart": {
+            "type": "string",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+          },
+          "dateEnd": {
+            "type": "string",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+          },
+          "timeStart": {
+            "type": "string",
+            "pattern": "^[0-2]\\d:[0-5]\\d$"
+          },
+          "timeEnd": {
+            "type": "string",
+            "pattern": "^[0-2]\\d:[0-5]\\d$"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "checked": {
+            "type": "boolean"
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 4
+          },
+          "status": {
+            "type": "string"
+          },
+          "rating": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 5
+          },
+          "url": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "number": {
+            "type": "number"
+          },
+          "unit": {
+            "type": "string"
+          },
+          "subtitle": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          },
+          "taskProgress": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 100
+          },
+          "assignedTo": {
+            "type": "string"
+          },
+          "coverUploadId": {
+            "type": "string"
+          },
+          "coverDocId": {
+            "type": "string"
+          },
+          "coverMimeType": {
+            "type": "string"
+          },
+          "__schemaVersion": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9007199254740991
+          },
+          "calendarWeekStart": {
+            "type": "string",
+            "enum": [
+              "sun",
+              "mon"
+            ]
+          },
+          "calendarView": {
+            "type": "string",
+            "enum": [
+              "month",
+              "week",
+              "day"
+            ]
+          },
+          "calendarShowWeekNumbers": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "body": "none",
+      "children": []
+    }
+  }
+}

package/src/generated/json-schema/chart.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "https://abraca.dev/schema/registry/v1.json",
+  "schemaVersion": 1,
+  "label": "chart",
+  "types": {
+    "chart": {
+      "version": 1,
+      "meta": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "type": "object",
+        "properties": {
+          "color": {
+            "type": "string",
+            "pattern": "^#[0-9a-fA-F]{6}$"
+          },
+          "icon": {
+            "type": "string"
+          },
+          "datetimeStart": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "datetimeEnd": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "allDay": {
+            "type": "boolean"
+          },
+          "dateStart": {
+            "type": "string",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+          },
+          "dateEnd": {
+            "type": "string",
+            "format": "date",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+          },
+          "timeStart": {
+            "type": "string",
+            "pattern": "^[0-2]\\d:[0-5]\\d$"
+          },
+          "timeEnd": {
+            "type": "string",
+            "pattern": "^[0-2]\\d:[0-5]\\d$"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "checked": {
+            "type": "boolean"
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 4
+          },
+          "status": {
+            "type": "string"
+          },
+          "rating": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 5
+          },
+          "url": {
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          },
+          "number": {
+            "type": "number"
+          },
+          "unit": {
+            "type": "string"
+          },
+          "subtitle": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          },
+          "taskProgress": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 100
+          },
+          "assignedTo": {
+            "type": "string"
+          },
+          "coverUploadId": {
+            "type": "string"
+          },
+          "coverDocId": {
+            "type": "string"
+          },
+          "coverMimeType": {
+            "type": "string"
+          },
+          "__schemaVersion": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9007199254740991
+          },
+          "chartType": {
+            "type": "string",
+            "enum": [
+              "bar",
+              "stacked bar",
+              "line",
+              "donut",
+              "treemap"
+            ]
+          },
+          "chartMetric": {
+            "type": "string",
+            "enum": [
+              "value",
+              "type",
+              "tag",
+              "status",
+              "priority",
+              "activity",
+              "completion"
+            ]
+          },
+          "chartColorScheme": {
+            "type": "string",
+            "enum": [
+              "default",
+              "warm",
+              "cool",
+              "mono"
+            ]
+          },
+          "chartLimit": {
+            "type": "integer",
+            "minimum": 3,
+            "maximum": 30
+          },
+          "chartShowLegend": {
+            "type": "boolean"
+          },
+          "chartShowValues": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "body": "none",
+      "children": []
+    }
+  }
+}