@maadb/core 0.0.1 → 0.7.10-rc.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/registry/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Registry Types — re-exported from core types for module-local use
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,oEAAoE;AACpE,+EAA+E"}

package/dist/scanner.d.ts

@@ -0,0 +1,57 @@
+export interface FileScanResult {
+    filePath: string;
+    sizeBytes: number;
+    lineCount: number;
+    frontmatter: Record<string, unknown> | null;
+    frontmatterFields: string[];
+    headings: Array<{
+        level: number;
+        text: string;
+        line: number;
+    }>;
+    blockCount: number;
+    annotations: Array<{
+        type: string;
+        value: string;
+        label: string;
+    }>;
+    valueCalls: string[];
+    detectedPatterns: {
+        dates: string[];
+        emails: string[];
+        amounts: string[];
+        urls: string[];
+    };
+}
+export interface CorpusScanResult {
+    directory: string;
+    totalFiles: number;
+    totalLines: number;
+    files: Array<{
+        path: string;
+        lineCount: number;
+        hasFrontmatter: boolean;
+        frontmatterFields: string[];
+    }>;
+    frontmatterFieldFrequency: Record<string, number>;
+    headingPatterns: Array<{
+        text: string;
+        level: number;
+        occurrences: number;
+    }>;
+    likelyDocumentFamilies: Array<{
+        name: string;
+        fileCount: number;
+        sharedFields: string[];
+        sharedHeadings: string[];
+        sampleFiles: string[];
+    }>;
+    entitySummary: Array<{
+        type: string;
+        value: string;
+        occurrences: number;
+    }>;
+}
+export declare function scanFile(filePath: string): Promise<FileScanResult>;
+export declare function scanDirectory(dirPath: string): Promise<CorpusScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE;QAChB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAID,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACxG,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,sBAAsB,EAAE,KAAK,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAID,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDxE;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwE9E"}

package/dist/scanner.js

@@ -0,0 +1,223 @@
+// ============================================================================
+// Scanner
+// Structural analysis of raw markdown files — no registry, no schema needed.
+// Two modes: single file (detailed) and directory (corpus-level patterns).
+// ============================================================================
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parseMatter } from './parser/matter.js';
+import { parseBlocks } from './parser/blocks.js';
+import { extractAnnotations } from './parser/annotations.js';
+import { extractValueCalls } from './parser/tags.js';
+import { findVerbatimZones } from './parser/verbatim.js';
+import { DEFAULT_SUBTYPE_MAP } from './types.js';
+// --- File scan ---------------------------------------------------------------
+export async function scanFile(filePath) {
+    const raw = await readFile(filePath, 'utf-8');
+    const lines = raw.split('\n');
+    const stats = await import('node:fs').then(fs => fs.statSync(filePath));
+    // Parse frontmatter (tolerant — no validation)
+    let frontmatter = null;
+    let body = raw;
+    let bodyStartLine = 1;
+    try {
+        const parsed = parseMatter(raw);
+        if (parsed.data && typeof parsed.data === 'object' && !Array.isArray(parsed.data)) {
+            frontmatter = parsed.data;
+            body = parsed.content;
+            if (parsed.matter && parsed.matter.length > 0) {
+                bodyStartLine = parsed.matter.split('\n').length + 2;
+            }
+        }
+    }
+    catch {
+        // No valid frontmatter — treat entire file as body
+    }
+    const frontmatterFields = frontmatter ? Object.keys(frontmatter) : [];
+    // Parse blocks (headings + structure)
+    const blocks = parseBlocks(body, bodyStartLine);
+    const headings = blocks
+        .filter(b => b.heading !== '')
+        .map(b => ({ level: b.level, text: b.heading, line: b.startLine }));
+    // Extract annotations using default subtype map
+    const verbatimZones = findVerbatimZones(body, bodyStartLine);
+    const annotations = extractAnnotations(body, bodyStartLine, filePath, DEFAULT_SUBTYPE_MAP, verbatimZones);
+    const valueCalls = extractValueCalls(body, bodyStartLine, filePath, verbatimZones);
+    // Detect common patterns in raw text via regex
+    const detectedPatterns = detectPatterns(raw);
+    return {
+        filePath,
+        sizeBytes: stats.size,
+        lineCount: lines.length,
+        frontmatter,
+        frontmatterFields,
+        headings,
+        blockCount: blocks.length,
+        annotations: annotations.map(a => ({ type: a.rawType, value: a.value, label: a.label })),
+        valueCalls: valueCalls.map(v => v.field),
+        detectedPatterns,
+    };
+}
+// --- Corpus scan -------------------------------------------------------------
+export async function scanDirectory(dirPath) {
+    const files = await collectAllMarkdown(dirPath);
+    const scanResults = [];
+    for (const file of files) {
+        try {
+            scanResults.push(await scanFile(file));
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // Aggregate frontmatter field frequency
+    const fieldFreq = {};
+    for (const scan of scanResults) {
+        for (const field of scan.frontmatterFields) {
+            fieldFreq[field] = (fieldFreq[field] ?? 0) + 1;
+        }
+    }
+    // Aggregate heading patterns
+    const headingMap = new Map();
+    for (const scan of scanResults) {
+        for (const h of scan.headings) {
+            const key = `${h.level}:${h.text}`;
+            const existing = headingMap.get(key);
+            if (existing) {
+                existing.count++;
+            }
+            else {
+                headingMap.set(key, { level: h.level, count: 1 });
+            }
+        }
+    }
+    const headingPatterns = [...headingMap.entries()]
+        .map(([key, val]) => ({ text: key.split(':').slice(1).join(':'), level: val.level, occurrences: val.count }))
+        .filter(h => h.occurrences > 1)
+        .sort((a, b) => b.occurrences - a.occurrences);
+    // Aggregate entities
+    const entityMap = new Map();
+    for (const scan of scanResults) {
+        for (const ann of scan.annotations) {
+            const key = `${ann.type}:${ann.value}`;
+            entityMap.set(key, (entityMap.get(key) ?? 0) + 1);
+        }
+    }
+    const entitySummary = [...entityMap.entries()]
+        .map(([key, count]) => {
+        const [type, ...valueParts] = key.split(':');
+        return { type: type, value: valueParts.join(':'), occurrences: count };
+    })
+        .sort((a, b) => b.occurrences - a.occurrences)
+        .slice(0, 30);
+    // Detect document families by clustering on shared frontmatter fields
+    const families = detectFamilies(scanResults, dirPath);
+    return {
+        directory: dirPath,
+        totalFiles: scanResults.length,
+        totalLines: scanResults.reduce((sum, s) => sum + s.lineCount, 0),
+        files: scanResults.map(s => ({
+            path: path.relative(dirPath, s.filePath),
+            lineCount: s.lineCount,
+            hasFrontmatter: s.frontmatter !== null,
+            frontmatterFields: s.frontmatterFields,
+        })),
+        frontmatterFieldFrequency: fieldFreq,
+        headingPatterns,
+        likelyDocumentFamilies: families,
+        entitySummary,
+    };
+}
+// --- Pattern detection -------------------------------------------------------
+const DATE_REGEX = /\b\d{4}-\d{2}-\d{2}\b/g;
+const EMAIL_REGEX = /\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/g;
+const AMOUNT_REGEX = /\b\d[\d,.]*\s*(?:USD|EUR|GBP|CAD|AUD|\$|dollars?)\b/gi;
+const URL_REGEX = /https?:\/\/[^\s)>\]]+/g;
+function detectPatterns(raw) {
+    const dedupe = (matches) => [...new Set(matches ?? [])];
+    return {
+        dates: dedupe(raw.match(DATE_REGEX)).slice(0, 10),
+        emails: dedupe(raw.match(EMAIL_REGEX)).slice(0, 10),
+        amounts: dedupe(raw.match(AMOUNT_REGEX)).slice(0, 10),
+        urls: dedupe(raw.match(URL_REGEX)).slice(0, 10),
+    };
+}
+// --- Family detection --------------------------------------------------------
+function detectFamilies(scans, rootDir) {
+    // Strategy: group files by their frontmatter field signature + heading signature
+    const groups = new Map();
+    for (const scan of scans) {
+        // Fingerprint on frontmatter fields only — headings may vary within a family
+        const fieldSig = scan.frontmatterFields.filter(f => f !== 'doc_id' && f !== 'doc_type' && f !== 'schema').sort().join(',');
+        const fingerprint = fieldSig;
+        const group = groups.get(fingerprint);
+        if (group) {
+            group.push(scan);
+        }
+        else {
+            groups.set(fingerprint, [scan]);
+        }
+    }
+    // Convert groups to families (only groups with 2+ files)
+    const families = [];
+    let familyIndex = 0;
+    for (const [, members] of groups) {
+        if (members.length < 2)
+            continue;
+        familyIndex++;
+        // Determine shared fields and headings
+        const sharedFields = members[0].frontmatterFields.filter(f => f !== 'doc_id' && f !== 'doc_type' && f !== 'schema' &&
+            members.every(m => m.frontmatterFields.includes(f)));
+        const sharedHeadings = members[0].headings
+            .filter(h => members.every(m => m.headings.some(mh => mh.text === h.text && mh.level === h.level)))
+            .map(h => h.text);
+        // Try to name the family from doc_type or directory
+        const docTypes = members
+            .map(m => m.frontmatter?.['doc_type'])
+            .filter((t) => typeof t === 'string');
+        const uniqueDocTypes = [...new Set(docTypes)];
+        let name;
+        if (uniqueDocTypes.length === 1) {
+            name = uniqueDocTypes[0];
+        }
+        else {
+            // Use the most common parent directory
+            const dirs = members.map(m => path.dirname(path.relative(rootDir, m.filePath)));
+            const dirCounts = new Map();
+            for (const d of dirs)
+                dirCounts.set(d, (dirCounts.get(d) ?? 0) + 1);
+            const topDir = [...dirCounts.entries()].sort((a, b) => b[1] - a[1])[0];
+            name = topDir ? topDir[0] : `family-${familyIndex}`;
+        }
+        families.push({
+            name,
+            fileCount: members.length,
+            sharedFields,
+            sharedHeadings,
+            sampleFiles: members.slice(0, 3).map(m => path.relative(rootDir, m.filePath)),
+        });
+    }
+    return families.sort((a, b) => b.fileCount - a.fileCount);
+}
+// --- File collection ---------------------------------------------------------
+async function collectAllMarkdown(dirPath) {
+    const files = [];
+    const { readdir } = await import('node:fs/promises');
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.name.startsWith('_') || entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await walk(dirPath);
+    return files.sort();
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+export { loadSchemas } from './loader.js';
+export { validateFrontmatter } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,3 @@
+export { loadSchemas } from './loader.js';
+export { validateFrontmatter } from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/schema/loader.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/schema/loader.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,MAAM,EAAkB,MAAM,cAAc,CAAC;AAE/E,OAAO,EAGL,KAAK,QAAQ,EAOb,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAuFvG"}

package/dist/schema/loader.js

@@ -0,0 +1,303 @@
+// ============================================================================
+// Schema Loader
+// Reads and validates _schema/*.yaml files referenced by the registry.
+// ============================================================================
+import { readFile, stat } from 'node:fs/promises';
+import { statSync } from 'node:fs';
+import path from 'node:path';
+import { parseMatter } from '../parser/matter.js';
+import { ok, err, maadError } from '../errors.js';
+import { isPrecision, comparePrecision } from './precision.js';
+import { docType, } from '../types.js';
+const VALID_FIELD_TYPES = ['string', 'number', 'date', 'enum', 'ref', 'boolean', 'list', 'amount'];
+export async function loadSchemas(projectRoot, registry) {
+    const errors = [];
+    const schemas = new Map();
+    const typeToSchema = new Map();
+    // 0.7.7 (fup-2026-202) — capture mtime+size per file for staleness checks.
+    // Includes the registry file too, so registry edits (new/removed types,
+    // path/schemaRef remap) trigger reload alongside per-schema edits.
+    const cachedFiles = new Map();
+    const registryPath = path.join(projectRoot, '_registry', 'object_types.yaml');
+    try {
+        const st = await stat(registryPath);
+        cachedFiles.set(registryPath, { mtimeMs: st.mtimeMs, size: st.size });
+    }
+    catch {
+        // Empty / missing registry — leave out of cache; isStale will pick up
+        // the file when it appears via stat throwing on a cached entry that
+        // doesn't exist. For an absent registry the schemas map is empty anyway.
+    }
+    for (const [, regType] of registry.types) {
+        const schemaFile = path.join(projectRoot, '_schema', `${regType.schemaRef}.yaml`);
+        let raw;
+        try {
+            raw = await readFile(schemaFile, 'utf-8');
+            const st = await stat(schemaFile);
+            cachedFiles.set(schemaFile, { mtimeMs: st.mtimeMs, size: st.size });
+        }
+        catch (e) {
+            errors.push(maadError('SCHEMA_NOT_FOUND', `Schema file not found for type "${regType.name}": ${schemaFile}`));
+            continue;
+        }
+        let data;
+        try {
+            if (raw.trimStart().startsWith('---')) {
+                data = parseMatter(raw).data;
+            }
+            else {
+                data = parseMatter(`---\n${raw}\n---`).data;
+            }
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : 'Unknown parse error';
+            errors.push(maadError('PARSE_ERROR', `Failed to parse schema "${regType.schemaRef}": ${message}`));
+            continue;
+        }
+        const result = parseSchemaDefinition(data, regType.schemaRef, registry);
+        if (!result.ok) {
+            errors.push(...result.errors);
+            continue;
+        }
+        schemas.set(regType.schemaRef, result.value);
+        typeToSchema.set(result.value.type, regType.schemaRef);
+    }
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    const store = {
+        schemas,
+        cachedFiles,
+        getSchema(ref) {
+            return schemas.get(ref);
+        },
+        getSchemaForType(type) {
+            const ref = typeToSchema.get(type);
+            if (ref === undefined)
+                return undefined;
+            return schemas.get(ref);
+        },
+        isStale() {
+            // Sync stat — called on every write entry so latency matters; for the
+            // typical project (5-20 schemas) this is microseconds. Any disagreement
+            // with cached mtime/size is treated as stale; an absent file (cached
+            // but stat throws ENOENT) is also stale.
+            for (const [absPath, cached] of cachedFiles) {
+                try {
+                    const st = statSync(absPath);
+                    if (st.mtimeMs !== cached.mtimeMs || st.size !== cached.size)
+                        return true;
+                }
+                catch {
+                    return true;
+                }
+            }
+            return false;
+        },
+    };
+    return ok(store);
+}
+function parseSchemaDefinition(data, ref, registry) {
+    const errors = [];
+    // Type
+    const typeName = data['type'];
+    if (typeof typeName !== 'string') {
+        errors.push(maadError('SCHEMA_INVALID', `Schema "${ref}" must have a "type" string`));
+        return err(errors);
+    }
+    // Version
+    const version = data['version'];
+    const versionNum = typeof version === 'number' ? version : parseVersionFromRef(ref);
+    // Required fields
+    const requiredRaw = data['required'];
+    const required = [];
+    if (Array.isArray(requiredRaw)) {
+        for (const r of requiredRaw) {
+            if (typeof r === 'string')
+                required.push(r);
+        }
+    }
+    // Fields
+    const fieldsRaw = data['fields'];
+    const fields = new Map();
+    if (fieldsRaw !== undefined && typeof fieldsRaw === 'object' && fieldsRaw !== null) {
+        for (const [fieldName, fieldDef] of Object.entries(fieldsRaw)) {
+            if (typeof fieldDef !== 'object' || fieldDef === null) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${ref}" field "${fieldName}" must be a mapping`));
+                continue;
+            }
+            const fd = fieldDef;
+            const fieldResult = parseFieldDefinition(fieldName, fd, ref, registry);
+            if (!fieldResult.ok) {
+                errors.push(...fieldResult.errors);
+                continue;
+            }
+            fields.set(fieldName, fieldResult.value);
+        }
+    }
+    // Validate required fields exist in fields map
+    for (const req of required) {
+        if (req === 'doc_id' || req === 'doc_type' || req === 'schema')
+            continue;
+        if (!fields.has(req)) {
+            errors.push(maadError('SCHEMA_INVALID', `Schema "${ref}" lists "${req}" as required but it is not defined in fields`));
+        }
+    }
+    // Template
+    let template = null;
+    const templateRaw = data['template'];
+    if (templateRaw !== undefined && typeof templateRaw === 'object' && templateRaw !== null) {
+        const tpl = templateRaw;
+        const headingsRaw = tpl['headings'];
+        if (Array.isArray(headingsRaw)) {
+            template = [];
+            for (const h of headingsRaw) {
+                if (typeof h === 'object' && h !== null) {
+                    const hDef = h;
+                    template.push({
+                        level: typeof hDef['level'] === 'number' ? hDef['level'] : 1,
+                        text: typeof hDef['text'] === 'string' ? hDef['text'] : '',
+                        id: typeof hDef['id'] === 'string' ? hDef['id'] : null,
+                    });
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    return ok({
+        type: docType(typeName),
+        version: versionNum,
+        required,
+        fields,
+        template,
+    });
+}
+function parseFieldDefinition(name, fd, schemaRef, registry) {
+    const errors = [];
+    const typeStr = fd['type'];
+    if (typeof typeStr !== 'string' || !VALID_FIELD_TYPES.includes(typeStr)) {
+        errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has invalid type "${String(typeStr)}". Valid: ${VALID_FIELD_TYPES.join(', ')}`));
+        return err(errors);
+    }
+    const fieldType = typeStr;
+    const index = fd['index'] === true;
+    const role = typeof fd['role'] === 'string' ? fd['role'] : null;
+    const format = typeof fd['format'] === 'string' ? fd['format'] : (fieldType === 'date' ? 'YYYY-MM-DD' : null);
+    // Ref target validation — applies to ref fields AND list fields with item_type: ref
+    let target = null;
+    const needsTarget = fieldType === 'ref' || (fieldType === 'list' && fd['item_type'] === 'ref');
+    if (needsTarget) {
+        const targetStr = fd['target'];
+        if (typeof targetStr !== 'string') {
+            errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has ref target but no "target" type specified`));
+        }
+        else {
+            if (!registry.types.has(docType(targetStr))) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" references unknown type "${targetStr}"`));
+            }
+            target = docType(targetStr);
+        }
+    }
+    // Enum values
+    let values = null;
+    if (fieldType === 'enum') {
+        const valuesRaw = fd['values'];
+        if (!Array.isArray(valuesRaw) || valuesRaw.length === 0) {
+            errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" is an enum but has no "values" array`));
+        }
+        else {
+            values = valuesRaw.map(String);
+        }
+    }
+    // List item type
+    let itemType = null;
+    if (fieldType === 'list') {
+        const itemTypeStr = fd['item_type'];
+        if (typeof itemTypeStr === 'string' && VALID_FIELD_TYPES.includes(itemTypeStr)) {
+            itemType = itemTypeStr;
+        }
+        // item_type is optional for lists — default to string items
+    }
+    const defaultValue = fd['default'] ?? null;
+    // --- 0.6.7 schema precision hints (only meaningful on date fields) -----
+    let storePrecision = null;
+    let onCoarser = null;
+    let displayPrecision = null;
+    if (fieldType === 'date') {
+        const spRaw = fd['store_precision'];
+        if (spRaw !== undefined) {
+            if (!isPrecision(spRaw)) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has invalid store_precision "${String(spRaw)}". ` +
+                    `Valid: year, month, day, hour, minute, second, millisecond`));
+            }
+            else {
+                storePrecision = spRaw;
+            }
+        }
+        const ocRaw = fd['on_coarser'];
+        if (ocRaw !== undefined) {
+            if (ocRaw !== 'warn' && ocRaw !== 'error') {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has invalid on_coarser "${String(ocRaw)}". ` +
+                    `Valid: warn, error`));
+            }
+            else {
+                onCoarser = ocRaw;
+            }
+        }
+        else if (storePrecision !== null) {
+            // Default to warn when store_precision is declared — the non-breaking
+            // rollout target. Callers who want strict behavior must opt in.
+            onCoarser = 'warn';
+        }
+        const dpRaw = fd['display_precision'];
+        if (dpRaw !== undefined) {
+            if (!isPrecision(dpRaw)) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has invalid display_precision "${String(dpRaw)}". ` +
+                    `Valid: year, month, day, hour, minute, second, millisecond`));
+            }
+            else {
+                displayPrecision = dpRaw;
+            }
+        }
+        // display_precision must be coarser-or-equal to store_precision (i.e.
+        // display no finer than storage). Inverted is nonsense — render finer
+        // than what's actually captured.
+        if (storePrecision !== null && displayPrecision !== null) {
+            if (comparePrecision(displayPrecision, storePrecision) > 0) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" has display_precision "${displayPrecision}" finer than ` +
+                    `store_precision "${storePrecision}". display must be coarser-or-equal to store.`));
+            }
+        }
+    }
+    else {
+        // Non-date fields must not declare precision keys.
+        for (const k of ['store_precision', 'on_coarser', 'display_precision']) {
+            if (fd[k] !== undefined) {
+                errors.push(maadError('SCHEMA_INVALID', `Schema "${schemaRef}" field "${name}" of type "${fieldType}" cannot declare "${k}" — only valid on date fields`));
+            }
+        }
+    }
+    if (errors.length > 0)
+        return err(errors);
+    return ok({
+        name,
+        type: fieldType,
+        index,
+        role,
+        format,
+        target,
+        values,
+        defaultValue,
+        itemType,
+        storePrecision,
+        onCoarser,
+        displayPrecision,
+    });
+}
+function parseVersionFromRef(ref) {
+    const match = /\.v(\d+)$/.exec(ref);
+    return match ? parseInt(match[1], 10) : 1;
+}
+//# sourceMappingURL=loader.js.map