Build an integration with Roam Research

This commit is contained in:
James Babcock committed 2026-08-03 15:21:52 -07:00
1 parent 63f515b8a6
commit 4022f06d49
12 files changed
+1575

No files matched your search

+70
View File
@@ -0,0 +1,70 @@
/**
* Source-agnostic document tree for rendering structured text (outlines,
* todo lists, notes) on the glasses. Integrations (Roam, and later markdown /
* Notion / Obsidian) map their native formats into this structure; the
* DocumentView in document-view.ts renders it with a selection and scroll
* position. Deliberately much smaller than HTML: block nodes nest to give
* indent levels, and inline spans cover only the formatting the glasses can
* usefully draw (links, inline code).
*/
export type DocInline =
| { kind: "text"; text: string }
| {
kind: "link";
text: string;
/** Page title or URL the link points at. */
target: string;
/** True for web URLs (not followable on the glasses); false for in-graph pages. */
external?: boolean;
}
| { kind: "code"; text: string };
export type DocNodeKind = "text" | "todo" | "heading" | "code";
export type DocNode = {
/** Stable id from the source (e.g. the Roam block uid); keys selection and edits. */
id: string;
kind: DocNodeKind;
/** Todo nodes: whether the item is checked off. */
checked?: boolean;
/** Heading nodes: 1 (largest) to 3. */
level?: number;
/** Draw a bullet marker (outline/list item). Ignored for todo nodes. */
bullet?: boolean;
/** Inline content for text/todo/heading nodes. */
inlines: DocInline[];
/** Code nodes: preformatted text, possibly multi-line. */
codeText?: string;
children: DocNode[];
};
export type DocumentRoot = {
title: string;
nodes: DocNode[];
};
/** The node's text with inline markup dropped (for matching and tool output). */
export function docNodePlainText(node: DocNode): string {
if (node.kind === "code") return node.codeText ?? "";
return node.inlines.map((inline) => inline.text).join("");
}
/** The node's first in-graph page link, if any (the click-to-follow target). */
export function docNodePageLink(node: DocNode): string | null {
for (const inline of node.inlines) {
if (inline.kind === "link" && !inline.external) return inline.target;
}
return null;
}
/** Depth-first flatten of a node tree. */
export function flattenDocNodes(nodes: readonly DocNode[]): DocNode[] {
const out: DocNode[] = [];
const visit = (node: DocNode): void => {
out.push(node);
for (const child of node.children) visit(child);
};
for (const node of nodes) visit(node);
return out;
}