@maadb/core 0.0.1 → 0.7.9

package/dist/engine.js

@@ -0,0 +1,6 @@
+// ============================================================================
+// Re-export from engine/ directory for backwards compatibility.
+// All code lives in src/engine/*.ts — this file is a passthrough.
+// ============================================================================
+export { MaadEngine } from './engine/index.js';
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gEAAgE;AAChE,kEAAkE;AAClE,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAqB,MAAM,mBAAmB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+import type { SourceLocation } from './types.js';
+export type ErrorCode = 'FILE_NOT_FOUND' | 'FILE_READ_ERROR' | 'PARSE_ERROR' | 'YAML_PROFILE_VIOLATION' | 'REGISTRY_INVALID' | 'REGISTRY_NOT_FOUND' | 'SCHEMA_NOT_FOUND' | 'SCHEMA_INVALID' | 'VALIDATION_FAILED' | 'REF_NOT_FOUND' | 'DUPLICATE_DOC_ID' | 'DUPLICATE_PREFIX' | 'VERSION_CONFLICT' | 'GIT_ERROR' | 'GIT_NOT_INITIALIZED' | 'BACKEND_ERROR' | 'UNKNOWN_TYPE' | 'INVALID_DOC_ID' | 'WRITE_ERROR' | 'DELETE_ERROR' | 'READ_ONLY' | 'PATH_OUTSIDE_PROJECT' | 'INVALID_FIELDS' | 'FRONTMATTER_GUARD' | 'INSTANCE_CONFIG_INVALID' | 'INSTANCE_CONFIG_NOT_FOUND' | 'PROJECT_UNKNOWN' | 'PROJECT_REQUIRED' | 'PROJECT_NOT_WHITELISTED' | 'SESSION_UNBOUND' | 'SESSION_ALREADY_BOUND' | 'INSUFFICIENT_ROLE' | 'ROLE_UPGRADE_DENIED' | 'WRITE_TIMEOUT' | 'SHUTTING_DOWN' | 'RATE_LIMITED' | 'REQUEST_TIMEOUT' | 'MISSING_OPERATION_KIND' | 'PIN_PROJECT_INVALID' | 'PIN_PROJECT_NOT_FOUND' | 'PIN_ON_EXISTING_SESSION' | 'SESSION_PINNED' | 'INSTANCE_RELOAD_IN_PROGRESS' | 'INSTANCE_RELOAD_FAILED' | 'INSTANCE_MUTATION_UNSUPPORTED' | 'INSTANCE_RELOAD_SYNTHETIC' | 'SESSION_CANCELLED' | 'TOKENS_FILE_MISSING' | 'TOKENS_FILE_INVALID' | 'TOKENS_FILE_EMPTY' | 'TOKEN_UNKNOWN' | 'TOKEN_REVOKED' | 'TOKEN_EXPIRED' | 'TOKEN_MALFORMED' | 'TOKEN_PROJECT_FORBIDDEN' | 'TOKEN_PROJECT_UNKNOWN' | 'TOKEN_ROLE_ABOVE_GLOBAL' | 'TOKEN_IDENTITY_REQUIRED' | 'TOKEN_NOT_FOUND' | 'LEGACY_BEARER_REMOVED' | 'RESPONSE_TOO_LARGE' | 'CURSOR_INVALID' | 'SCHEMA_REF_CHAIN_INVALID' | 'FILTER_BETWEEN_INVALID' | 'FILTER_EMPTY_ARRAY' | 'FILTER_OP_INVALID' | 'BULK_LIMIT_EXCEEDED';
+export interface MaadError {
+    code: ErrorCode;
+    message: string;
+    location?: SourceLocation | undefined;
+    details?: Record<string, unknown> | undefined;
+}
+export type Result<T, E = MaadError[]> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    errors: E;
+};
+export declare function ok<T>(value: T): Result<T>;
+export declare function err<T>(errors: MaadError[]): Result<T>;
+export declare function singleErr<T>(code: ErrorCode, message: string, location?: SourceLocation, details?: Record<string, unknown>): Result<T>;
+export declare function maadError(code: ErrorCode, message: string, location?: SourceLocation, details?: Record<string, unknown>): MaadError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,wBAAwB,GACxB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,WAAW,GACX,sBAAsB,GACtB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,2BAA2B,GAC3B,iBAAiB,GACjB,kBAAkB,GAClB,yBAAyB,GACzB,iBAAiB,GACjB,uBAAuB,GACvB,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,GACf,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,wBAAwB,GACxB,qBAAqB,GACrB,uBAAuB,GACvB,yBAAyB,GACzB,gBAAgB,GAChB,6BAA6B,GAC7B,wBAAwB,GACxB,+BAA+B,GAC/B,2BAA2B,GAC3B,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,iBAAiB,GACjB,uBAAuB,GAEvB,oBAAoB,GACpB,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,oBAAoB,GACpB,mBAAmB,GAEnB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,IACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7B,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEzC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAErD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEtI;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEnI"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+// ============================================================================
+// MAAD Error Types and Result Pattern
+// The engine never throws. Every stage returns Result<T, MaadError[]>.
+// ============================================================================
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(errors) {
+    return { ok: false, errors };
+}
+export function singleErr(code, message, location, details) {
+    return { ok: false, errors: [{ code, message, location, details }] };
+}
+export function maadError(code, message, location, details) {
+    return { code, message, location, details };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,sCAAsC;AACtC,uEAAuE;AACvE,+EAA+E;AAsF/E,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,MAAmB;IACxC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,IAAe,EAAE,OAAe,EAAE,QAAyB,EAAE,OAAiC;IACzH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,OAAe,EAAE,QAAyB,EAAE,OAAiC;IACtH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/extractor/fields.d.ts

@@ -0,0 +1,3 @@
+import type { BoundDocument, SchemaDefinition, ExtractedObject } from '../types.js';
+export declare function extractFields(bound: BoundDocument, schema: SchemaDefinition): ExtractedObject[];
+//# sourceMappingURL=fields.d.ts.map

package/dist/extractor/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/extractor/fields.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EAGhB,MAAM,aAAa,CAAC;AAoBrB,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,GACvB,eAAe,EAAE,CAmCnB"}

package/dist/extractor/fields.js

@@ -0,0 +1,58 @@
+// ============================================================================
+// Field Extractor
+// Extracts indexed frontmatter fields as ExtractedObject entries.
+// ============================================================================
+import { normalize } from './normalizers.js';
+const FIELD_TYPE_TO_PRIMITIVE = {
+    date: 'date',
+    amount: 'amount',
+    number: 'quantity',
+};
+const EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+const PHONE_REGEX = /^[+]?[\d\s().-]{7,}$/;
+const URL_REGEX = /^https?:\/\//;
+function detectContactPrimitive(value) {
+    if (EMAIL_REGEX.test(value))
+        return 'contact';
+    if (PHONE_REGEX.test(value))
+        return 'contact';
+    if (URL_REGEX.test(value))
+        return 'contact';
+    return null;
+}
+export function extractFields(bound, schema) {
+    const objects = [];
+    for (const [name, field] of Object.entries(bound.validatedFields)) {
+        if (!field.indexed)
+            continue;
+        if (field.value === undefined || field.value === null)
+            continue;
+        let primitive = FIELD_TYPE_TO_PRIMITIVE[field.fieldType] ?? 'entity';
+        // Detect contact-like string values (email, phone, URL)
+        if (primitive === 'entity' && field.fieldType === 'string') {
+            const contactPrimitive = detectContactPrimitive(String(field.value));
+            if (contactPrimitive)
+                primitive = contactPrimitive;
+        }
+        // Defensive: with the string-preserving YAML engine (parser/matter.ts)
+        // Dates are rare here, but a caller may still pass `new Date(...)`
+        // directly. Preserve full ISO precision — never slice.
+        const valueStr = field.value instanceof Date
+            ? field.value.toISOString()
+            : String(field.value);
+        const normalizedValue = normalize(primitive, valueStr);
+        objects.push({
+            primitive,
+            subtype: name,
+            value: valueStr,
+            normalizedValue,
+            label: valueStr,
+            role: field.role,
+            docId: bound.docId,
+            location: { file: bound.parsed.filePath, line: 1, col: 0 },
+            blockId: null,
+        });
+    }
+    return objects;
+}
+//# sourceMappingURL=fields.js.map

package/dist/extractor/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/extractor/fields.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,kEAAkE;AAClE,+EAA+E;AAS/E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,uBAAuB,GAA0C;IACrE,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,MAAM,WAAW,GAAG,kDAAkD,CAAC;AACvE,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAC3C,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC,SAAS,sBAAsB,CAAC,KAAa;IAC3C,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAoB,EACpB,MAAwB;IAExB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,SAAS;QAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;YAAE,SAAS;QAEhE,IAAI,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC;QACrE,wDAAwD;QACxD,IAAI,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,IAAI,gBAAgB;gBAAE,SAAS,GAAG,gBAAgB,CAAC;QACrD,CAAC;QACD,uEAAuE;QACvE,mEAAmE;QACnE,uDAAuD;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,YAAY,IAAI;YAC1C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;YAC3B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,eAAe,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEvD,OAAO,CAAC,IAAI,CAAC;YACX,SAAS;YACT,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,QAAQ;YACf,eAAe;YACf,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YAC1D,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/extractor/index.d.ts

@@ -0,0 +1,7 @@
+import type { BoundDocument, SchemaDefinition, ExtractionResult, Registry } from '../types.js';
+export { normalize } from './normalizers.js';
+export { extractFields } from './fields.js';
+export { extractAnnotationObjects } from './objects.js';
+export { extractRelationships } from './relationships.js';
+export declare function extract(bound: BoundDocument, schema: SchemaDefinition, registry: Registry): ExtractionResult;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACT,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,wBAAgB,OAAO,CACrB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,QAAQ,GACjB,gBAAgB,CAUlB"}

package/dist/extractor/index.js

@@ -0,0 +1,22 @@
+// ============================================================================
+// Extractor — Public API
+// Combines field extraction, annotation object extraction, and relationships.
+// ============================================================================
+import { extractFields } from './fields.js';
+import { extractAnnotationObjects } from './objects.js';
+import { extractRelationships } from './relationships.js';
+export { normalize } from './normalizers.js';
+export { extractFields } from './fields.js';
+export { extractAnnotationObjects } from './objects.js';
+export { extractRelationships } from './relationships.js';
+export function extract(bound, schema, registry) {
+    const fieldObjects = extractFields(bound, schema);
+    const annotationObjects = extractAnnotationObjects(bound, bound.parsed.annotations);
+    const relationships = extractRelationships(bound, schema, bound.parsed.annotations, registry);
+    return {
+        document: bound,
+        objects: [...fieldObjects, ...annotationObjects],
+        relationships,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/extractor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,yBAAyB;AACzB,8EAA8E;AAC9E,+EAA+E;AAQ/E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,UAAU,OAAO,CACrB,KAAoB,EACpB,MAAwB,EACxB,QAAkB;IAElB,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE9F,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,iBAAiB,CAAC;QAChD,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/extractor/normalizers.d.ts

@@ -0,0 +1,22 @@
+import type { Primitive } from '../types.js';
+export declare function normalizeString(value: string): string;
+export declare function normalizeDate(value: string): string | null;
+export declare function normalizeDuration(value: string): string | null;
+export declare function normalizeAmount(value: string): {
+    amount: number;
+    currency: string;
+} | null;
+export declare function normalizeMeasure(value: string): {
+    value: number;
+    unit: string;
+} | null;
+export declare function normalizeQuantity(value: string): number | null;
+export declare function normalizePercentage(value: string): number | null;
+export declare function normalizeContact(value: string, subtype?: string | undefined): string;
+export declare function normalizeMedia(value: string): {
+    path: string;
+    mediaType: string;
+} | null;
+export type NormalizedValue = string | number | Record<string, unknown> | null;
+export declare function normalize(primitive: Primitive, value: string, subtype?: string | undefined): NormalizedValue;
+//# sourceMappingURL=normalizers.d.ts.map

package/dist/extractor/normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../src/extractor/normalizers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAeD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6C1D;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmC9D;AAeD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB1F;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetF;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBhE;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoBpF;AA0BD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQxF;AAID,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAE/E,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAC3B,eAAe,CAcjB"}

package/dist/extractor/normalizers.js

@@ -0,0 +1,250 @@
+// ============================================================================
+// Normalizers
+// One normalizer per primitive. Each returns a typed result or null.
+// ============================================================================
+// --- Entity, Location, Identifier ------------------------------------------
+export function normalizeString(value) {
+    return value.trim().replace(/\s+/g, ' ');
+}
+// --- Date ------------------------------------------------------------------
+const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}/;
+const MONTH_NAMES = {
+    january: '01', february: '02', march: '03', april: '04',
+    may: '05', june: '06', july: '07', august: '08',
+    september: '09', october: '10', november: '11', december: '12',
+    jan: '01', feb: '02', mar: '03', apr: '04',
+    jun: '06', jul: '07', aug: '08',
+    sep: '09', oct: '10', nov: '11', dec: '12',
+};
+export function normalizeDate(value) {
+    const trimmed = value.trim();
+    // Already ISO
+    if (ISO_DATE_REGEX.test(trimmed))
+        return trimmed;
+    // "March 28, 2026" or "Mar 28, 2026"
+    const longMatch = /^([a-zA-Z]+)\s+(\d{1,2}),?\s+(\d{4})$/.exec(trimmed);
+    if (longMatch) {
+        const month = MONTH_NAMES[longMatch[1].toLowerCase()];
+        if (month) {
+            const day = longMatch[2].padStart(2, '0');
+            return `${longMatch[3]}-${month}-${day}`;
+        }
+    }
+    // "28 March 2026"
+    const euroMatch = /^(\d{1,2})\s+([a-zA-Z]+)\s+(\d{4})$/.exec(trimmed);
+    if (euroMatch) {
+        const month = MONTH_NAMES[euroMatch[2].toLowerCase()];
+        if (month) {
+            const day = euroMatch[1].padStart(2, '0');
+            return `${euroMatch[3]}-${month}-${day}`;
+        }
+    }
+    // "M-DD-YY" or "MM-DD-YY" (US short)
+    const shortMatch = /^(\d{1,2})[-/](\d{1,2})[-/](\d{2})$/.exec(trimmed);
+    if (shortMatch) {
+        const month = shortMatch[1].padStart(2, '0');
+        const day = shortMatch[2].padStart(2, '0');
+        const yearShort = parseInt(shortMatch[3], 10);
+        const year = yearShort >= 0 && yearShort <= 49 ? 2000 + yearShort : 1900 + yearShort;
+        return `${year}-${month}-${day}`;
+    }
+    // "MM/DD/YYYY"
+    const usMatch = /^(\d{1,2})[-/](\d{1,2})[-/](\d{4})$/.exec(trimmed);
+    if (usMatch) {
+        const month = usMatch[1].padStart(2, '0');
+        const day = usMatch[2].padStart(2, '0');
+        return `${usMatch[3]}-${month}-${day}`;
+    }
+    return null;
+}
+// --- Duration --------------------------------------------------------------
+const DURATION_UNITS = {
+    second: 'S', seconds: 'S', sec: 'S', secs: 'S', s: 'S',
+    minute: 'M', minutes: 'M', min: 'M', mins: 'M',
+    hour: 'H', hours: 'H', hr: 'H', hrs: 'H', h: 'H',
+    day: 'D', days: 'D', d: 'D',
+    week: 'W', weeks: 'W', wk: 'W', wks: 'W', w: 'W',
+    month: 'M_DATE', months: 'M_DATE', mo: 'M_DATE',
+    year: 'Y', years: 'Y', yr: 'Y', yrs: 'Y', y: 'Y',
+};
+const DATE_UNITS = new Set(['Y', 'M_DATE', 'W', 'D']);
+export function normalizeDuration(value) {
+    const trimmed = value.trim().toLowerCase();
+    // Already ISO 8601 duration
+    if (/^P[\dTHMSWY.]+$/i.test(trimmed))
+        return trimmed.toUpperCase();
+    // Parse "3 hours", "2 weeks", "1 hour 30 minutes"
+    const parts = [...trimmed.matchAll(/(\d+(?:\.\d+)?)\s*([a-z]+)/g)];
+    if (parts.length === 0)
+        return null;
+    let datePart = '';
+    let timePart = '';
+    for (const part of parts) {
+        const num = part[1];
+        const unitStr = part[2];
+        const unit = DURATION_UNITS[unitStr];
+        if (!unit)
+            return null;
+        if (unit === 'M_DATE') {
+            datePart += `${num}M`;
+        }
+        else if (DATE_UNITS.has(unit)) {
+            datePart += `${num}${unit}`;
+        }
+        else {
+            timePart += `${num}${unit}`;
+        }
+    }
+    if (datePart === '' && timePart === '')
+        return null;
+    let result = 'P';
+    if (datePart)
+        result += datePart;
+    if (timePart)
+        result += `T${timePart}`;
+    return result;
+}
+// --- Amount ----------------------------------------------------------------
+const CURRENCY_SYMBOLS = {
+    '$': 'USD',
+    '€': 'EUR',
+    '£': 'GBP',
+    '¥': 'JPY',
+    '₹': 'INR',
+    '₩': 'KRW',
+    'C$': 'CAD',
+    'A$': 'AUD',
+};
+export function normalizeAmount(value) {
+    const trimmed = value.trim();
+    // "100.00 USD"
+    const explicitMatch = /^([\d,]+(?:\.\d+)?)\s+([A-Z]{3})$/.exec(trimmed);
+    if (explicitMatch) {
+        const amount = parseFloat(explicitMatch[1].replace(/,/g, ''));
+        if (isNaN(amount))
+            return null;
+        return { amount, currency: explicitMatch[2] };
+    }
+    // "$100" or "€50.00"
+    for (const [symbol, currency] of Object.entries(CURRENCY_SYMBOLS)) {
+        if (trimmed.startsWith(symbol)) {
+            const numStr = trimmed.slice(symbol.length).replace(/,/g, '').trim();
+            const amount = parseFloat(numStr);
+            if (!isNaN(amount))
+                return { amount, currency };
+        }
+    }
+    return null;
+}
+// --- Measure ---------------------------------------------------------------
+export function normalizeMeasure(value) {
+    const trimmed = value.trim();
+    // "500mg", "6 feet", "98.6°F", "1200 sqft"
+    // Unit must start with a non-digit character
+    const match = /^([\d,]+(?:\.\d+)?)\s*([^\d\s].*)$/.exec(trimmed);
+    if (!match)
+        return null;
+    const num = parseFloat(match[1].replace(/,/g, ''));
+    if (isNaN(num))
+        return null;
+    const unit = match[2].trim();
+    if (unit.length === 0)
+        return null;
+    return { value: num, unit };
+}
+// --- Quantity --------------------------------------------------------------
+export function normalizeQuantity(value) {
+    const trimmed = value.trim().replace(/,/g, '');
+    const num = parseFloat(trimmed);
+    return isNaN(num) ? null : num;
+}
+// --- Percentage ------------------------------------------------------------
+export function normalizePercentage(value) {
+    const trimmed = value.trim().toLowerCase();
+    // "15%" or "15 %"
+    const pctMatch = /^([\d.]+)\s*%$/.exec(trimmed);
+    if (pctMatch) {
+        const num = parseFloat(pctMatch[1]);
+        return isNaN(num) ? null : num / 100;
+    }
+    // "85 percent"
+    const wordMatch = /^([\d.]+)\s*percent$/.exec(trimmed);
+    if (wordMatch) {
+        const num = parseFloat(wordMatch[1]);
+        return isNaN(num) ? null : num / 100;
+    }
+    // Already decimal "0.15"
+    const num = parseFloat(trimmed);
+    if (!isNaN(num) && num >= 0 && num <= 1)
+        return num;
+    return null;
+}
+// --- Contact ---------------------------------------------------------------
+export function normalizeContact(value, subtype) {
+    const trimmed = value.trim();
+    const detectedType = subtype ?? detectContactType(trimmed);
+    switch (detectedType) {
+        case 'email':
+            return trimmed.toLowerCase();
+        case 'phone':
+            // Best-effort: strip non-digit except leading +
+            return trimmed.startsWith('+')
+                ? '+' + trimmed.slice(1).replace(/\D/g, '')
+                : trimmed.replace(/\D/g, '');
+        case 'url':
+            // Ensure protocol
+            if (!/^https?:\/\//i.test(trimmed))
+                return `https://${trimmed}`;
+            return trimmed;
+        default:
+            return trimmed;
+    }
+}
+function detectContactType(value) {
+    if (value.includes('@') && value.includes('.'))
+        return 'email';
+    if (/^(\+?\d[\d\s\-().]{6,})$/.test(value))
+        return 'phone';
+    if (/^(https?:\/\/|www\.)/i.test(value))
+        return 'url';
+    return 'unknown';
+}
+// --- Media -----------------------------------------------------------------
+const MEDIA_EXTENSIONS = {
+    // image
+    jpg: 'image', jpeg: 'image', png: 'image', gif: 'image', webp: 'image',
+    svg: 'image', bmp: 'image', tiff: 'image', ico: 'image',
+    // video
+    mp4: 'video', mov: 'video', avi: 'video', mkv: 'video', webm: 'video', wmv: 'video',
+    // audio
+    mp3: 'audio', wav: 'audio', ogg: 'audio', flac: 'audio', aac: 'audio', m4a: 'audio',
+    // document
+    pdf: 'document', doc: 'document', docx: 'document', xls: 'document',
+    xlsx: 'document', ppt: 'document', pptx: 'document', txt: 'document', csv: 'document',
+    // diagram
+    drawio: 'diagram', mermaid: 'diagram', puml: 'diagram',
+};
+export function normalizeMedia(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return null;
+    const ext = trimmed.split('.').pop()?.toLowerCase();
+    const mediaType = (ext && MEDIA_EXTENSIONS[ext]) ?? 'unknown';
+    return { path: trimmed, mediaType };
+}
+export function normalize(primitive, value, subtype) {
+    switch (primitive) {
+        case 'entity': return normalizeString(value);
+        case 'date': return normalizeDate(value);
+        case 'duration': return normalizeDuration(value);
+        case 'amount': return normalizeAmount(value);
+        case 'measure': return normalizeMeasure(value);
+        case 'quantity': return normalizeQuantity(value);
+        case 'percentage': return normalizePercentage(value);
+        case 'location': return normalizeString(value);
+        case 'identifier': return normalizeString(value);
+        case 'contact': return normalizeContact(value, subtype);
+        case 'media': return normalizeMedia(value);
+    }
+}
+//# sourceMappingURL=normalizers.js.map

package/dist/extractor/normalizers.js.map

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

package/dist/extractor/objects.d.ts

@@ -0,0 +1,3 @@
+import type { BoundDocument, InlineAnnotation, ExtractedObject } from '../types.js';
+export declare function extractAnnotationObjects(bound: BoundDocument, annotations: InlineAnnotation[]): ExtractedObject[];
+//# sourceMappingURL=objects.d.ts.map

package/dist/extractor/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/extractor/objects.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EAGhB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,gBAAgB,EAAE,GAC9B,eAAe,EAAE,CAmBnB"}

package/dist/extractor/objects.js

@@ -0,0 +1,33 @@
+// ============================================================================
+// Object Extractor
+// Converts inline annotations into ExtractedObject entries.
+// Maps each annotation to the block it falls within.
+// ============================================================================
+import { normalize } from './normalizers.js';
+export function extractAnnotationObjects(bound, annotations) {
+    const blocks = bound.parsed.blocks;
+    return annotations.map((ann) => {
+        const blockMatch = findContainingBlock(ann.location.line, blocks);
+        const normalizedValue = normalize(ann.primitive, ann.value, ann.rawType);
+        return {
+            primitive: ann.primitive,
+            subtype: ann.rawType,
+            value: ann.value,
+            normalizedValue,
+            label: ann.label,
+            role: null,
+            docId: bound.docId,
+            location: ann.location,
+            blockId: blockMatch,
+        };
+    });
+}
+function findContainingBlock(line, blocks) {
+    for (const block of blocks) {
+        if (line >= block.startLine && line <= block.endLine) {
+            return block.id;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=objects.js.map

package/dist/extractor/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/extractor/objects.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mBAAmB;AACnB,4DAA4D;AAC5D,qDAAqD;AACrD,+EAA+E;AAS/E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CACtC,KAAoB,EACpB,WAA+B;IAE/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAEnC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAmB,EAAE;QAC9C,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAEzE,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,eAAe;YACf,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,MAAqB;IAC9D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/extractor/relationships.d.ts

@@ -0,0 +1,3 @@
+import { type BoundDocument, type SchemaDefinition, type InlineAnnotation, type Relationship, type Registry } from '../types.js';
+export declare function extractRelationships(bound: BoundDocument, schema: SchemaDefinition, annotations: InlineAnnotation[], registry: Registry): Relationship[];
+//# sourceMappingURL=relationships.d.ts.map

package/dist/extractor/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/extractor/relationships.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,gBAAgB,EAAE,EAC/B,QAAQ,EAAE,QAAQ,GACjB,YAAY,EAAE,CAwDhB"}

package/dist/extractor/relationships.js

@@ -0,0 +1,58 @@
+// ============================================================================
+// Relationship Builder
+// Creates edges between documents from ref fields and inline mentions.
+// ============================================================================
+import { docId as toDocId, } from '../types.js';
+export function extractRelationships(bound, schema, annotations, registry) {
+    const relationships = [];
+    // 1. Scalar ref fields in frontmatter
+    for (const [fieldName, fieldDef] of schema.fields) {
+        if (fieldDef.type === 'ref') {
+            const value = bound.parsed.frontmatter[fieldName];
+            if (typeof value === 'string') {
+                relationships.push({
+                    sourceDocId: bound.docId,
+                    targetDocId: toDocId(value),
+                    field: fieldName,
+                    relationType: 'ref',
+                });
+            }
+        }
+        // 1b. List-of-ref fields
+        if (fieldDef.type === 'list' && fieldDef.itemType === 'ref') {
+            const value = bound.parsed.frontmatter[fieldName];
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (typeof item === 'string') {
+                        relationships.push({
+                            sourceDocId: bound.docId,
+                            targetDocId: toDocId(item),
+                            field: fieldName,
+                            relationType: 'ref',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // 2. Inline mentions that look like doc_ids
+    // Collect all known prefixes from registry
+    const prefixes = new Set();
+    for (const [, regType] of registry.types) {
+        prefixes.add(regType.idPrefix + '-');
+    }
+    for (const ann of annotations) {
+        // Check if the annotation value starts with any known doc_id prefix
+        const matchesPrefix = [...prefixes].some(p => ann.value.startsWith(p));
+        if (matchesPrefix) {
+            relationships.push({
+                sourceDocId: bound.docId,
+                targetDocId: toDocId(ann.value),
+                field: ann.rawType,
+                relationType: 'mention',
+            });
+        }
+    }
+    return relationships;
+}
+//# sourceMappingURL=relationships.js.map

package/dist/extractor/relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../src/extractor/relationships.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uBAAuB;AACvB,uEAAuE;AACvE,+EAA+E;AAE/E,OAAO,EACL,KAAK,IAAI,OAAO,GAMjB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,oBAAoB,CAClC,KAAoB,EACpB,MAAwB,EACxB,WAA+B,EAC/B,QAAkB;IAElB,MAAM,aAAa,GAAmB,EAAE,CAAC;IAEzC,sCAAsC;IACtC,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,aAAa,CAAC,IAAI,CAAC;oBACjB,WAAW,EAAE,KAAK,CAAC,KAAK;oBACxB,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC;oBAC3B,KAAK,EAAE,SAAS;oBAChB,YAAY,EAAE,KAAK;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,aAAa,CAAC,IAAI,CAAC;4BACjB,WAAW,EAAE,KAAK,CAAC,KAAK;4BACxB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC;4BAC1B,KAAK,EAAE,SAAS;4BAChB,YAAY,EAAE,KAAK;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACzC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,oEAAoE;QACpE,MAAM,aAAa,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC;gBACjB,WAAW,EAAE,KAAK,CAAC,KAAK;gBACxB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAC/B,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,YAAY,EAAE,SAAS;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}