@maadb/core 0.0.1 → 0.7.10-rc.3

package/dist/parser/frontmatter.js

@@ -0,0 +1,33 @@
+// ============================================================================
+// Frontmatter Parser
+// Extracts YAML frontmatter from a markdown file using gray-matter.
+// ============================================================================
+import { parseMatter } from './matter.js';
+import { ok, singleErr } from '../errors.js';
+export function parseFrontmatter(raw, filePath) {
+    try {
+        const parsed = parseMatter(raw);
+        if (typeof parsed.data !== 'object' || parsed.data === null || Array.isArray(parsed.data)) {
+            return singleErr('PARSE_ERROR', 'Frontmatter must be a YAML mapping', { file: filePath, line: 1, col: 1 });
+        }
+        const frontmatter = parsed.data;
+        // Calculate bodyStartLine: count lines in the raw content up to where the body begins
+        // gray-matter.matter gives us the raw frontmatter string between the --- delimiters
+        let bodyStartLine = 1;
+        if (parsed.matter && parsed.matter.length > 0) {
+            // Opening --- (line 1) + frontmatter lines + closing ---
+            const fmLines = parsed.matter.split('\n').length;
+            bodyStartLine = fmLines + 2; // +1 for opening ---, +1 for closing ---
+        }
+        return ok({
+            frontmatter,
+            body: parsed.content,
+            bodyStartLine,
+        });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : 'Unknown parse error';
+        return singleErr('PARSE_ERROR', `Failed to parse frontmatter: ${message}`, { file: filePath, line: 1, col: 1 });
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/parser/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAqB;AACrB,oEAAoE;AACpE,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,SAAS,EAAe,MAAM,cAAc,CAAC;AAS1D,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,QAAkB;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1F,OAAO,SAAS,CAAC,aAAa,EAAE,oCAAoC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAA+B,CAAC;QAE3D,sFAAsF;QACtF,oFAAoF;QACpF,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,yDAAyD;YACzD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACjD,aAAa,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,yCAAyC;QACxE,CAAC;QAED,OAAO,EAAE,CAAC;YACR,WAAW;YACX,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACvE,OAAO,SAAS,CAAC,aAAa,EAAE,gCAAgC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;AACH,CAAC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,11 @@
+import { type Result } from '../errors.js';
+import { type FilePath, type ParsedDocument, type Primitive } from '../types.js';
+export { parseFrontmatter } from './frontmatter.js';
+export { parseBlocks } from './blocks.js';
+export { findVerbatimZones, isInVerbatimZone } from './verbatim.js';
+export { extractValueCalls } from './tags.js';
+export { extractAnnotations } from './annotations.js';
+export { validateYamlProfile } from './yaml-profile.js';
+export declare function parseDocument(path: FilePath, subtypeMap: Record<string, Primitive>): Promise<Result<ParsedDocument>>;
+export declare function parseDocumentFromContent(raw: string, path: FilePath, subtypeMap: Record<string, Primitive>): Result<ParsedDocument>;
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAQzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAUjC;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,MAAM,CAAC,cAAc,CAAC,CAwBxB"}

package/dist/parser/index.js

@@ -0,0 +1,54 @@
+// ============================================================================
+// Document Parser — Public API
+// Composes frontmatter, blocks, verbatim zones, value calls, and annotations
+// into a single ParsedDocument.
+// ============================================================================
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { ok, singleErr } from '../errors.js';
+import { parseFrontmatter } from './frontmatter.js';
+import { parseBlocks } from './blocks.js';
+import { findVerbatimZones } from './verbatim.js';
+import { extractValueCalls } from './tags.js';
+import { extractAnnotations } from './annotations.js';
+import { validateYamlProfile } from './yaml-profile.js';
+export { parseFrontmatter } from './frontmatter.js';
+export { parseBlocks } from './blocks.js';
+export { findVerbatimZones, isInVerbatimZone } from './verbatim.js';
+export { extractValueCalls } from './tags.js';
+export { extractAnnotations } from './annotations.js';
+export { validateYamlProfile } from './yaml-profile.js';
+export async function parseDocument(path, subtypeMap) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : 'Unknown read error';
+        return singleErr('FILE_READ_ERROR', `Failed to read file: ${message}`, { file: path, line: 0, col: 0 });
+    }
+    return parseDocumentFromContent(raw, path, subtypeMap);
+}
+export function parseDocumentFromContent(raw, path, subtypeMap) {
+    const hash = createHash('sha256').update(raw).digest('hex');
+    const fm = parseFrontmatter(raw, path);
+    if (!fm.ok)
+        return fm;
+    const profileResult = validateYamlProfile(fm.value.frontmatter, path);
+    if (!profileResult.ok)
+        return profileResult;
+    const { frontmatter, body, bodyStartLine } = fm.value;
+    const verbatimZones = findVerbatimZones(body, bodyStartLine);
+    const blocks = parseBlocks(body, bodyStartLine);
+    const valueCalls = extractValueCalls(body, bodyStartLine, path, verbatimZones);
+    const annotations = extractAnnotations(body, bodyStartLine, path, subtypeMap, verbatimZones);
+    return ok({
+        filePath: path,
+        fileHash: hash,
+        frontmatter,
+        blocks,
+        valueCalls,
+        annotations,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"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"}

package/dist/parser/matter.d.ts

@@ -0,0 +1,3 @@
+import matter from 'gray-matter';
+export declare function parseMatter(raw: string): matter.GrayMatterFile<string>;
+//# sourceMappingURL=matter.d.ts.map

package/dist/parser/matter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matter.d.ts","sourceRoot":"","sources":["../../src/parser/matter.ts"],"names":[],"mappings":"AAkBA,OAAO,MAAM,MAAM,aAAa,CAAC;AAcjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAEtE"}

package/dist/parser/matter.js

@@ -0,0 +1,32 @@
+// ============================================================================
+// gray-matter wrapper with a string-preserving YAML engine.
+//
+// Why: js-yaml's DEFAULT_SCHEMA resolves `!!timestamp` scalars into JS Date
+// objects. Downstream code (writer/serializer, indexer, extractor, reads,
+// writes) then normalizes Dates via `.toISOString().slice(0, 10)`, silently
+// truncating any finer-than-day precision on round-trip. That is a hard
+// blocker for 0.6.7 schema precision contracts — see
+// docs/specs/0.6.7-schema-precision.md §"Round-trip precision preservation".
+//
+// Fix: use yaml.CORE_SCHEMA (null/bool/int/float/str/seq/map, NO timestamp).
+// Datetime-looking scalars stay as literal strings end-to-end.
+//
+// Every matter(...) call in the codebase goes through parseMatter() so we
+// cannot regress this invariant by adding a new caller that forgets the
+// engine option.
+// ============================================================================
+import matter from 'gray-matter';
+import yaml from 'js-yaml';
+const stringPreservingYamlEngine = {
+    // yaml.load returns `unknown` (could be primitive / null on malformed YAML),
+    // but gray-matter's engine type demands `object`. Cast is safe: downstream
+    // code in parser/frontmatter.ts already validates that `.data` is a plain
+    // object and rejects other shapes.
+    parse: (raw) => yaml.load(raw, { schema: yaml.CORE_SCHEMA }),
+    stringify: (obj) => yaml.dump(obj),
+};
+const MATTER_OPTIONS = { engines: { yaml: stringPreservingYamlEngine } };
+export function parseMatter(raw) {
+    return matter(raw, MATTER_OPTIONS);
+}
+//# sourceMappingURL=matter.js.map

package/dist/parser/matter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matter.js","sourceRoot":"","sources":["../../src/parser/matter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,wEAAwE;AACxE,qDAAqD;AACrD,6EAA6E;AAC7E,EAAE;AACF,6EAA6E;AAC7E,+DAA+D;AAC/D,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,iBAAiB;AACjB,+EAA+E;AAE/E,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,MAAM,0BAA0B,GAAG;IACjC,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,mCAAmC;IACnC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAW;IAC9E,SAAS,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;CAC3C,CAAC;AAEF,MAAM,cAAc,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAW,CAAC;AAElF,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACrC,CAAC"}

package/dist/parser/tags.d.ts

@@ -0,0 +1,3 @@
+import type { FilePath, ValueCall, VerbatimZone } from '../types.js';
+export declare function extractValueCalls(body: string, bodyStartLine: number, filePath: FilePath, verbatimZones: VerbatimZone[]): ValueCall[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/parser/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/parser/tags.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKrE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,YAAY,EAAE,GAC5B,SAAS,EAAE,CA4Bb"}

package/dist/parser/tags.js

@@ -0,0 +1,32 @@
+// ============================================================================
+// Value Call Extractor
+// Extracts {{field}} references from markdown body.
+// Skips matches inside verbatim zones (code blocks, code spans).
+// ============================================================================
+import { isInVerbatimZone } from './verbatim.js';
+const VALUE_CALL_REGEX = /\{\{([a-zA-Z_][a-zA-Z0-9_.]*)\}\}/g;
+export function extractValueCalls(body, bodyStartLine, filePath, verbatimZones) {
+    const calls = [];
+    const lines = body.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const absoluteLine = bodyStartLine + i;
+        let match;
+        VALUE_CALL_REGEX.lastIndex = 0;
+        while ((match = VALUE_CALL_REGEX.exec(line)) !== null) {
+            const col = match.index;
+            if (isInVerbatimZone(absoluteLine, col, verbatimZones))
+                continue;
+            calls.push({
+                field: match[1],
+                location: {
+                    file: filePath,
+                    line: absoluteLine,
+                    col,
+                },
+            });
+        }
+    }
+    return calls;
+}
+//# sourceMappingURL=tags.js.map

package/dist/parser/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/parser/tags.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uBAAuB;AACvB,oDAAoD;AACpD,iEAAiE;AACjE,+EAA+E;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;AAE9D,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,aAAqB,EACrB,QAAkB,EAClB,aAA6B;IAE7B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,YAAY,GAAG,aAAa,GAAG,CAAC,CAAC;QAEvC,IAAI,KAA6B,CAAC;QAClC,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC;QAE/B,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;YAExB,IAAI,gBAAgB,CAAC,YAAY,EAAE,GAAG,EAAE,aAAa,CAAC;gBAAE,SAAS;YAEjE,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE;gBAChB,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,YAAY;oBAClB,GAAG;iBACJ;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/parser/verbatim.d.ts

@@ -0,0 +1,4 @@
+import type { VerbatimZone } from '../types.js';
+export declare function findVerbatimZones(body: string, bodyStartLine: number): VerbatimZone[];
+export declare function isInVerbatimZone(line: number, col: number, zones: VerbatimZone[]): boolean;
+//# sourceMappingURL=verbatim.d.ts.map

package/dist/parser/verbatim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbatim.d.ts","sourceRoot":"","sources":["../../src/parser/verbatim.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,EAAE,CAsDrF;AAkDD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EAAE,GACpB,OAAO,CAmBT"}

package/dist/parser/verbatim.js

@@ -0,0 +1,121 @@
+// ============================================================================
+// Verbatim Zone Detection
+// Identifies fenced code blocks, indented code blocks, and inline code spans
+// where MAAD custom syntax ({{...}}, [[...]]) must NOT be parsed.
+// ============================================================================
+const FENCE_OPEN_REGEX = /^(\s*(`{3,}|~{3,}))/;
+export function findVerbatimZones(body, bodyStartLine) {
+    const zones = [];
+    const lines = body.split('\n');
+    let inFence = false;
+    let fenceChar = '';
+    let fenceLen = 0;
+    let fenceStart = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const absoluteLine = bodyStartLine + i;
+        // Fenced code blocks
+        const fenceMatch = FENCE_OPEN_REGEX.exec(line);
+        if (fenceMatch) {
+            const fence = fenceMatch[2];
+            if (!inFence) {
+                inFence = true;
+                fenceChar = fence[0];
+                fenceLen = fence.length;
+                fenceStart = absoluteLine;
+                continue;
+            }
+            // Check if this is a closing fence
+            const trimmed = line.trimStart();
+            if (trimmed[0] === fenceChar && !inFenceHasExtra(trimmed, fenceChar, fenceLen)) {
+                zones.push({
+                    startLine: fenceStart,
+                    endLine: absoluteLine,
+                    inline: false,
+                });
+                inFence = false;
+                continue;
+            }
+        }
+        if (inFence)
+            continue;
+        // Inline code spans — find ` pairs within the line
+        findInlineCodeSpans(line, absoluteLine, zones);
+    }
+    // If we're still in a fence at EOF, close it
+    if (inFence) {
+        zones.push({
+            startLine: fenceStart,
+            endLine: bodyStartLine + lines.length - 1,
+            inline: false,
+        });
+    }
+    return zones;
+}
+function inFenceHasExtra(trimmed, char, minLen) {
+    // A closing fence is: same char repeated >= fenceLen, optionally followed by whitespace only
+    let count = 0;
+    for (const c of trimmed) {
+        if (c === char)
+            count++;
+        else
+            break;
+    }
+    if (count < minLen)
+        return true; // not enough chars, not a closer
+    // Check remainder is whitespace only
+    const remainder = trimmed.slice(count).trim();
+    return remainder.length > 0;
+}
+function findInlineCodeSpans(line, absoluteLine, zones) {
+    let i = 0;
+    while (i < line.length) {
+        if (line[i] === '`') {
+            // Count opening backticks
+            let openLen = 0;
+            const openStart = i;
+            while (i < line.length && line[i] === '`') {
+                openLen++;
+                i++;
+            }
+            // Find matching closing backticks
+            const closeTarget = '`'.repeat(openLen);
+            const closeIndex = line.indexOf(closeTarget, i);
+            if (closeIndex !== -1) {
+                zones.push({
+                    startLine: absoluteLine,
+                    endLine: absoluteLine,
+                    startCol: openStart,
+                    endCol: closeIndex + openLen,
+                    inline: true,
+                });
+                i = closeIndex + openLen;
+            }
+        }
+        else {
+            i++;
+        }
+    }
+}
+export function isInVerbatimZone(line, col, zones) {
+    for (const zone of zones) {
+        if (zone.inline) {
+            // Inline code span: same line, check column range
+            if (line === zone.startLine &&
+                zone.startCol !== undefined &&
+                zone.endCol !== undefined &&
+                col >= zone.startCol &&
+                col < zone.endCol) {
+                return true;
+            }
+        }
+        else {
+            // Block zone: check line range
+            if (line >= zone.startLine && line <= zone.endLine) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=verbatim.js.map

package/dist/parser/verbatim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbatim.js","sourceRoot":"","sources":["../../src/parser/verbatim.ts"],"names":[],"mappings":"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"}

package/dist/parser/yaml-profile.d.ts

@@ -0,0 +1,4 @@
+import { type Result } from '../errors.js';
+import type { FilePath } from '../types.js';
+export declare function validateYamlProfile(frontmatter: Record<string, unknown>, filePath: FilePath): Result<Record<string, unknown>>;
+//# sourceMappingURL=yaml-profile.d.ts.map

package/dist/parser/yaml-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-profile.d.ts","sourceRoot":"","sources":["../../src/parser/yaml-profile.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,MAAM,EAAkB,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBjC"}

package/dist/parser/yaml-profile.js

@@ -0,0 +1,73 @@
+// ============================================================================
+// MAAD YAML Profile Validator
+// Enforces the constrained YAML subset: no anchors, no aliases, no deep
+// nesting, no complex keys. Runs after gray-matter parse, before schema.
+// ============================================================================
+import { ok, maadError } from '../errors.js';
+const MAX_DEPTH = 2;
+export function validateYamlProfile(frontmatter, filePath) {
+    const errors = [];
+    const loc = { file: filePath, line: 1, col: 1 };
+    for (const [key, value] of Object.entries(frontmatter)) {
+        // Keys must be plain strings
+        if (typeof key !== 'string') {
+            errors.push(maadError('YAML_PROFILE_VIOLATION', `Key must be a string, got ${typeof key}`, loc));
+            continue;
+        }
+        // Check for anchor/alias artifacts — gray-matter resolves these but we detect
+        // circular references or shared references that indicate alias usage
+        // (In practice, gray-matter silently resolves them, so we check value depth/shape)
+        // Validate value depth and types
+        const depthErrors = validateValue(key, value, 0, filePath);
+        errors.push(...depthErrors);
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return ok(frontmatter);
+}
+function validateValue(path, value, depth, filePath) {
+    const errors = [];
+    const loc = { file: filePath, line: 1, col: 1 };
+    if (value === null || value === undefined)
+        return errors;
+    if (typeof value === 'string')
+        return errors;
+    if (typeof value === 'number')
+        return errors;
+    if (typeof value === 'boolean')
+        return errors;
+    if (value instanceof Date)
+        return errors; // gray-matter may parse dates
+    if (Array.isArray(value)) {
+        if (depth >= MAX_DEPTH) {
+            errors.push(maadError('YAML_PROFILE_VIOLATION', `"${path}": array at depth ${depth} exceeds max nesting depth of ${MAX_DEPTH}`, loc));
+            return errors;
+        }
+        for (let i = 0; i < value.length; i++) {
+            const item = value[i];
+            // Recurse into array items at depth + 1
+            errors.push(...validateValue(`${path}[${i}]`, item, depth + 1, filePath));
+        }
+        return errors;
+    }
+    if (typeof value === 'object') {
+        if (depth >= MAX_DEPTH) {
+            errors.push(maadError('YAML_PROFILE_VIOLATION', `"${path}": object at depth ${depth} exceeds max nesting depth of ${MAX_DEPTH}`, loc));
+            return errors;
+        }
+        const obj = value;
+        for (const [key, childValue] of Object.entries(obj)) {
+            if (typeof key !== 'string') {
+                errors.push(maadError('YAML_PROFILE_VIOLATION', `"${path}": non-string key "${String(key)}" not allowed`, loc));
+                continue;
+            }
+            errors.push(...validateValue(`${path}.${key}`, childValue, depth + 1, filePath));
+        }
+        return errors;
+    }
+    // Unknown type
+    errors.push(maadError('YAML_PROFILE_VIOLATION', `"${path}": unsupported value type ${typeof value}`, loc));
+    return errors;
+}
+//# sourceMappingURL=yaml-profile.js.map

package/dist/parser/yaml-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-profile.js","sourceRoot":"","sources":["../../src/parser/yaml-profile.ts"],"names":[],"mappings":"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"}

package/dist/registry/index.d.ts

@@ -0,0 +1,2 @@
+export { loadRegistry } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,2 @@
+export { loadRegistry } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/registry/loader.d.ts

@@ -0,0 +1,4 @@
+import { type Result } from '../errors.js';
+import { type Registry } from '../types.js';
+export declare function loadRegistry(projectRoot: string): Promise<Result<Registry>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AASA,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAML,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAKrB,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAmJjF"}

package/dist/registry/loader.js

@@ -0,0 +1,147 @@
+// ============================================================================
+// Registry Loader
+// Reads and validates _registry/object_types.yaml
+// ============================================================================
+import { readFile } from 'node:fs/promises';
+import { existsSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { parseMatter } from '../parser/matter.js';
+import { ok, err, singleErr, maadError } from '../errors.js';
+import { isContainedIn } from '../engine/pathguard.js';
+import { docType, schemaRef, PRIMITIVES, DEFAULT_SUBTYPE_MAP, buildSubtypeMap, } from '../types.js';
+const VALID_NAME_REGEX = /^[a-z][a-z0-9_]*$/;
+const VALID_PREFIX_REGEX = /^[a-z0-9]{2,5}$/;
+export async function loadRegistry(projectRoot) {
+    const registryPath = path.join(projectRoot, '_registry', 'object_types.yaml');
+    if (!existsSync(registryPath)) {
+        return singleErr('REGISTRY_NOT_FOUND', `Registry file not found: ${registryPath}`);
+    }
+    let raw;
+    try {
+        raw = await readFile(registryPath, 'utf-8');
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : 'Unknown read error';
+        return singleErr('FILE_READ_ERROR', `Failed to read registry: ${message}`);
+    }
+    let data;
+    try {
+        // gray-matter can parse bare YAML files (no frontmatter delimiters needed)
+        // but we need to handle both cases
+        if (raw.trimStart().startsWith('---')) {
+            const parsed = parseMatter(raw);
+            data = parsed.data;
+        }
+        else {
+            // Parse as bare YAML — wrap in frontmatter delimiters for gray-matter
+            const parsed = parseMatter(`---\n${raw}\n---`);
+            data = parsed.data;
+        }
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : 'Unknown parse error';
+        return singleErr('PARSE_ERROR', `Failed to parse registry YAML: ${message}`);
+    }
+    const errors = [];
+    const types = new Map();
+    const seenPrefixes = new Map();
+    // Parse types
+    const typesRaw = data['types'];
+    if (typesRaw === undefined || typesRaw === null || typeof typesRaw !== 'object') {
+        return singleErr('REGISTRY_INVALID', 'Registry must contain a "types" mapping');
+    }
+    for (const [name, def] of Object.entries(typesRaw)) {
+        if (typeof def !== 'object' || def === null) {
+            errors.push(maadError('REGISTRY_INVALID', `Type "${name}" must be a mapping`));
+            continue;
+        }
+        const typeDef = def;
+        // Validate name
+        if (!VALID_NAME_REGEX.test(name)) {
+            errors.push(maadError('REGISTRY_INVALID', `Type name "${name}" must be lowercase alphanumeric with underscores, starting with a letter`));
+        }
+        // Validate path
+        const typePath = typeDef['path'];
+        if (typeof typePath !== 'string' || typePath.length === 0) {
+            errors.push(maadError('REGISTRY_INVALID', `Type "${name}" must have a "path" string`));
+            continue;
+        }
+        const resolvedPath = path.join(projectRoot, typePath);
+        if (!isContainedIn(resolvedPath, projectRoot)) {
+            errors.push(maadError('REGISTRY_INVALID', `Type "${name}" path escapes project root: ${typePath}`));
+            continue;
+        }
+        if (!existsSync(resolvedPath)) {
+            mkdirSync(resolvedPath, { recursive: true });
+        }
+        // Validate id_prefix
+        const idPrefix = typeDef['id_prefix'];
+        if (typeof idPrefix !== 'string' || !VALID_PREFIX_REGEX.test(idPrefix)) {
+            errors.push(maadError('REGISTRY_INVALID', `Type "${name}" id_prefix must be 2-5 lowercase alphanumeric characters, got: ${String(idPrefix)}`));
+            continue;
+        }
+        // Check for duplicate prefixes
+        const existingType = seenPrefixes.get(idPrefix);
+        if (existingType !== undefined) {
+            errors.push(maadError('DUPLICATE_PREFIX', `Type "${name}" has duplicate id_prefix "${idPrefix}" (also used by "${existingType}")`));
+        }
+        seenPrefixes.set(idPrefix, name);
+        // Validate schema ref
+        const schemaValue = typeDef['schema'];
+        if (typeof schemaValue !== 'string' || schemaValue.length === 0) {
+            errors.push(maadError('REGISTRY_INVALID', `Type "${name}" must have a "schema" string`));
+            continue;
+        }
+        const schemaFilePath = path.join(projectRoot, '_schema', `${schemaValue}.yaml`);
+        if (!existsSync(schemaFilePath)) {
+            errors.push(maadError('SCHEMA_NOT_FOUND', `Type "${name}" references schema "${schemaValue}" but file not found: ${schemaFilePath}`));
+        }
+        // Optional template
+        const template = typeof typeDef['template'] === 'string' ? typeDef['template'] : null;
+        if (template !== null) {
+            const templatePath = path.join(projectRoot, template);
+            if (!isContainedIn(templatePath, projectRoot)) {
+                errors.push(maadError('REGISTRY_INVALID', `Type "${name}" template escapes project root: ${template}`));
+            }
+            else if (!existsSync(templatePath)) {
+                errors.push(maadError('FILE_NOT_FOUND', `Type "${name}" references template "${template}" but file not found`));
+            }
+        }
+        types.set(name, {
+            name: docType(name),
+            path: typePath,
+            idPrefix: idPrefix,
+            schemaRef: schemaRef(schemaValue),
+            template,
+        });
+    }
+    // Parse extraction config
+    let extraction = { subtypes: {} };
+    const extractionRaw = data['extraction'];
+    if (extractionRaw !== undefined && typeof extractionRaw === 'object' && extractionRaw !== null) {
+        const extDef = extractionRaw;
+        const subtypesRaw = extDef['subtypes'];
+        if (subtypesRaw !== undefined && typeof subtypesRaw === 'object' && subtypesRaw !== null) {
+            const subtypes = {};
+            for (const [subtype, primitive] of Object.entries(subtypesRaw)) {
+                if (typeof primitive === 'string' && PRIMITIVES.includes(primitive)) {
+                    subtypes[subtype] = primitive;
+                }
+                else {
+                    errors.push(maadError('REGISTRY_INVALID', `Extraction subtype "${subtype}" maps to invalid primitive "${String(primitive)}". Valid: ${PRIMITIVES.join(', ')}`));
+                }
+            }
+            extraction = { subtypes };
+        }
+    }
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    const subtypeMap = buildSubtypeMap(DEFAULT_SUBTYPE_MAP, extraction.subtypes);
+    return ok({
+        types: types,
+        extraction,
+        subtypeMap,
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"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"}

package/dist/registry/types.d.ts

@@ -0,0 +1,2 @@
+export type { Registry, RegistryType, ExtractionConfig, DocType, SchemaRef, FilePath, Primitive, } from '../types.js';
+//# sourceMappingURL=types.d.ts.map