omgbase-properties

The omgbase document properties — Rust implementation.

A document's properties are the typed, indexed rows the engine derives from three sources — the YAML frontmatter fence, inline key:: value fields in the body, and engine-computed $-intrinsics ($title, $tags) — and stores in the properties table so that filters, projections and docs_read see one uniform surface. This crate is a pure library: a block tree (with ids) in, property rows and the two read shapes out. No SQLite; omgbase-store calls it inside the commit transaction.

use omgbase_format::{BlockKind, parse_markdown};
use omgbase_properties::{DocBlock, Source, doc_properties, merged};

let tree = parse_markdown("---\nlayer: canon\n---\n\n# Title\n\nelement:: fire\n");
let (frontmatter, body) = match tree.children.first() {
    Some(b) if b.kind == BlockKind::Frontmatter => (Some(b), &tree.children[1..]),
    _ => (None, &tree.children[..]),
};
let ids: Vec<String> = (0..DocBlock::count(body)).map(|i| format!("b_{i}")).collect();
let blocks = DocBlock::from_blocks(body, &ids);

let rows = doc_properties("d_0", frontmatter, &blocks);
assert_eq!(rows.len(), 3);
assert!(rows.iter().any(|r| r.source == Source::Inline && r.key == "element" && r.block_id.as_deref() == Some("b_1")));
assert_eq!(merged(&rows)["$title"], "Title");

The reference is the TypeScript engine @omgbase/core (core/store/properties.ts, the inline/computed parts of core/ingest.ts, format/markdown.ts). Both conform to the language-neutral specification and fixtures at spec/properties in the same repository; omgbase_properties::SPEC_VERSION reports the spec version this crate implements and the crate version tracks it as <major>.<minor>.<patch>.

YAML

Frontmatter is YAML 1.2 with the core schema, as the yaml npm package (v2) reads it. The crate uses saphyr-parser for the document structure and resolves every plain scalar itself (spec §4): yes/no are strings, 012 is twelve, 1_000 is a string, timestamps are strings, .inf/.nan are the non-finite floats. Duplicate keys, tab indentation, more than one document, a non-mapping document or any syntax error yield no rows.

Inline fields

A block is scanned over its own text (own_text: the raw with every direct child's span blanked, spec §3.2 — so a field belongs to the innermost block that contains it) with code masked (mask_code). Two forms: bracketed [key:: value] / (key:: value) anywhere in prose, and the line form — a key at the start of a line, optionally after a list marker and a task checkbox (- job:: x, - [ ] due:: friday; line_field), the value to the end of the line. DocBlock carries the block's byte span for this.

Conformance

tests/spec.rs runs every case under spec/properties/cases (skipped when the crate is built outside the monorepo). While the port runs behind the fixtures, tests/spec-passing.txt names the cases that must pass; promote with PROPERTIES_SPEC_UPDATE=1 cargo test -p omgbase-properties --test spec.

License

MIT