@abraca/schema 2.3.0

package/src/types/slides.ts

@@ -0,0 +1,22 @@
+/**
+ * `slides` — two-axis presentation. Direct children are slides;
+ * grandchildren are sub-slides (both untyped); per-slide
+ * `slidesTransition` / `color` flow through the universal/untyped
+ * paths.
+ */
+
+import { z } from "zod";
+import { defineDocType, defineSchema } from "../index.ts";
+import { UniversalMeta } from "./universal.ts";
+
+export const SlidesMeta = UniversalMeta.extend({
+	slidesTheme: z.enum(["dark", "light"]).optional(),
+});
+
+export const Slides = defineDocType({
+	name: "slides",
+	version: 1,
+	meta: SlidesMeta,
+});
+
+export const slidesSchema = defineSchema({ types: [Slides] });

package/src/types/table.ts

@@ -0,0 +1,22 @@
+/**
+ * `table` — collaborative spreadsheet. Direct children are columns;
+ * grandchildren are positional cells (row N = Nth child of each
+ * column). Descendants are untyped.
+ */
+
+import { z } from "zod";
+import { defineDocType, defineSchema } from "../index.ts";
+import { UniversalMeta } from "./universal.ts";
+
+export const TableMeta = UniversalMeta.extend({
+	tableMode: z.enum(["hierarchy", "flat"]).optional(),
+	tableSortDir: z.enum(["asc", "desc"]).optional(),
+});
+
+export const Table = defineDocType({
+	name: "table",
+	version: 1,
+	meta: TableMeta,
+});
+
+export const tableSchema = defineSchema({ types: [Table] });

package/src/types/timeline.ts

@@ -0,0 +1,18 @@
+/**
+ * `timeline` — Gantt-style project timeline. Direct children are epics;
+ * grandchildren are tasks (both untyped). Per-bar `dateStart` /
+ * `dateEnd` / `taskProgress` / `color` use universal keys.
+ */
+
+import { defineDocType, defineSchema } from "../index.ts";
+import { UniversalMeta } from "./universal.ts";
+
+export const TimelineMeta = UniversalMeta;
+
+export const Timeline = defineDocType({
+	name: "timeline",
+	version: 1,
+	meta: TimelineMeta,
+});
+
+export const timelineSchema = defineSchema({ types: [Timeline] });

package/src/types/universal.ts

@@ -0,0 +1,59 @@
+/**
+ * Universal meta keys that may appear on any typed root.
+ *
+ * Mirrors the canonical list in `page-type-guidelines.md` §4.5 plus the
+ * three cross-cutting cover keys (`coverUploadId`/`coverDocId`/
+ * `coverMimeType`). Every key is optional. Per-type schemas merge this
+ * object via `UniversalMeta.extend({ ... })`.
+ *
+ * Descendant-only keys (cell formatting, geo, dashboard layout, spatial
+ * transforms, EXIF media metadata, etc.) are deliberately excluded —
+ * descendants are untyped and unvalidated by the registry, so those
+ * keys flow through the untyped meta path without per-type constraints.
+ */
+
+import { z } from "zod";
+
+const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/);
+const hhmm = z.string().regex(/^[0-2]\d:[0-5]\d$/);
+
+export const UniversalMeta = z.strictObject({
+	color: hexColor.optional(),
+	icon: z.string().optional(),
+	datetimeStart: z.iso.datetime().optional(),
+	datetimeEnd: z.iso.datetime().optional(),
+	allDay: z.boolean().optional(),
+	dateStart: z.iso.date().optional(),
+	dateEnd: z.iso.date().optional(),
+	timeStart: hhmm.optional(),
+	timeEnd: hhmm.optional(),
+	tags: z.array(z.string()).optional(),
+	checked: z.boolean().optional(),
+	priority: z.number().int().min(0).max(4).optional(),
+	status: z.string().optional(),
+	rating: z.number().min(0).max(5).optional(),
+	url: z.string().optional(),
+	email: z.string().optional(),
+	phone: z.string().optional(),
+	number: z.number().optional(),
+	unit: z.string().optional(),
+	subtitle: z.string().optional(),
+	note: z.string().optional(),
+	taskProgress: z.number().min(0).max(100).optional(),
+	/**
+	 * User id (UUID) the entry is assigned to. Indexed by the v2 query
+	 * layer (`doc_meta_index.assigned_to`) so "all cards assigned to me"
+	 * is a single indexed lookup. Server does not validate referential
+	 * integrity — it's just a tag.
+	 */
+	assignedTo: z.string().optional(),
+	coverUploadId: z.string().optional(),
+	coverDocId: z.string().optional(),
+	coverMimeType: z.string().optional(),
+	/**
+	 * Migration version. Read by `runMigrations` to determine which
+	 * forward-migrations to apply when projecting an old document.
+	 * Absent ⇒ assume version 1.
+	 */
+	__schemaVersion: z.number().int().min(1).optional(),
+});