@maadb/core 0.0.1 → 0.7.10-rc.3

package/dist/types.d.ts

@@ -0,0 +1,309 @@
+type Brand<T, B extends string> = T & {
+    readonly __brand: B;
+};
+export type DocId = Brand<string, 'DocId'>;
+export type DocType = Brand<string, 'DocType'>;
+export type SchemaRef = Brand<string, 'SchemaRef'>;
+export type FilePath = Brand<string, 'FilePath'>;
+export type BlockId = Brand<string, 'BlockId'>;
+export type CommitSha = Brand<string, 'CommitSha'>;
+export declare function docId(raw: string): DocId;
+export declare function docType(raw: string): DocType;
+export declare function schemaRef(raw: string): SchemaRef;
+export declare function filePath(raw: string): FilePath;
+export declare function blockId(raw: string): BlockId;
+export declare function commitSha(raw: string): CommitSha;
+export declare const PRIMITIVES: readonly ["entity", "date", "duration", "amount", "measure", "quantity", "percentage", "location", "identifier", "contact", "media"];
+export type Primitive = typeof PRIMITIVES[number];
+export declare const DEFAULT_SUBTYPE_MAP: Record<string, Primitive>;
+export declare function buildSubtypeMap(defaults: Record<string, Primitive>, projectExtensions?: Record<string, string>): Record<string, Primitive>;
+export declare function resolvePrimitive(subtype: string, map: Record<string, Primitive>): Primitive;
+export interface SourceLocation {
+    file: FilePath;
+    line: number;
+    col: number;
+}
+export interface ParsedDocument {
+    filePath: FilePath;
+    fileHash: string;
+    frontmatter: Record<string, unknown>;
+    blocks: ParsedBlock[];
+    valueCalls: ValueCall[];
+    annotations: InlineAnnotation[];
+}
+export interface ParsedBlock {
+    id: BlockId | null;
+    heading: string;
+    level: number;
+    startLine: number;
+    endLine: number;
+}
+export interface ValueCall {
+    field: string;
+    location: SourceLocation;
+}
+export interface InlineAnnotation {
+    rawType: string;
+    primitive: Primitive;
+    value: string;
+    label: string;
+    location: SourceLocation;
+}
+export type FieldType = 'string' | 'number' | 'date' | 'enum' | 'ref' | 'boolean' | 'list' | 'amount';
+export interface FieldDefinition {
+    name: string;
+    type: FieldType;
+    index: boolean;
+    role: string | null;
+    format: string | null;
+    target: DocType | null;
+    values: string[] | null;
+    defaultValue: unknown;
+    itemType: FieldType | null;
+    storePrecision: import('./schema/precision.js').Precision | null;
+    onCoarser: 'warn' | 'error' | null;
+    displayPrecision: import('./schema/precision.js').Precision | null;
+}
+export interface TemplateHeading {
+    level: number;
+    text: string;
+    id: string | null;
+}
+export interface SchemaDefinition {
+    type: DocType;
+    version: number;
+    required: string[];
+    fields: Map<string, FieldDefinition>;
+    template: TemplateHeading[] | null;
+}
+export interface RegistryType {
+    name: DocType;
+    path: string;
+    idPrefix: string;
+    schemaRef: SchemaRef;
+    template: string | null;
+}
+export interface ExtractionConfig {
+    subtypes: Record<string, Primitive>;
+}
+export interface Registry {
+    types: Map<DocType, RegistryType>;
+    extraction: ExtractionConfig;
+    subtypeMap: Record<string, Primitive>;
+}
+export interface SchemaStore {
+    schemas: Map<SchemaRef, SchemaDefinition>;
+    getSchema(ref: SchemaRef): SchemaDefinition | undefined;
+    getSchemaForType(type: DocType): SchemaDefinition | undefined;
+    /**
+     * 0.7.7 (fup-2026-202) — per-file mtime + size captured at load time.
+     * Keyed by absolute path. Used by `isStale()` to detect cross-process
+     * schema edits; if any cached file's on-disk mtime/size has drifted, a
+     * concurrent process edited the schema and our in-memory copy is stale.
+     */
+    cachedFiles: Map<string, {
+        mtimeMs: number;
+        size: number;
+    }>;
+    /**
+     * 0.7.7 — Returns true when any cached schema file's on-disk
+     * mtime/size differs from what was captured at load time, OR a cached
+     * file no longer exists. Cheap (one fstat per cached file). Triggered
+     * from the engine write-mutex entry so every write sees fresh schemas.
+     */
+    isStale(): boolean;
+}
+export interface BoundDocument {
+    parsed: ParsedDocument;
+    docId: DocId;
+    docType: DocType;
+    schemaRef: SchemaRef;
+    validatedFields: Record<string, ValidatedField>;
+    validationResult: ValidationResult;
+}
+export interface ValidatedField {
+    name: string;
+    value: unknown;
+    fieldType: FieldType;
+    role: string | null;
+    indexed: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    location: SourceLocation | null;
+}
+/**
+ * Non-fatal signal emitted by the validator. Never blocks the write.
+ * Surfaces in response `_meta.warnings[]` and in the ops log so agents can
+ * self-correct and operators can see patterns.
+ *
+ * First use case is PRECISION_COARSER_THAN_DECLARED (0.6.7 Phase 4), but
+ * the channel is reusable for future soft-validations — deprecated fields,
+ * length hints, cross-field invariants, schema-evolution notices.
+ */
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    code: string;
+    location: SourceLocation | null;
+}
+export interface ExtractionResult {
+    document: BoundDocument;
+    objects: ExtractedObject[];
+    relationships: Relationship[];
+}
+export interface ExtractedObject {
+    primitive: Primitive;
+    subtype: string;
+    value: string;
+    normalizedValue: string | number | Record<string, unknown> | null;
+    label: string;
+    role: string | null;
+    docId: DocId;
+    location: SourceLocation;
+    blockId: BlockId | null;
+}
+export interface Relationship {
+    sourceDocId: DocId;
+    targetDocId: DocId;
+    field: string;
+    relationType: 'ref' | 'mention';
+}
+export interface DocumentRecord {
+    docId: DocId;
+    docType: DocType;
+    schemaRef: SchemaRef;
+    filePath: FilePath;
+    fileHash: string;
+    version: number;
+    deleted: boolean;
+    indexedAt: string;
+    updatedAt: string;
+}
+export type FilterCondition = {
+    op: 'eq';
+    value: unknown;
+} | {
+    op: 'neq';
+    value: unknown;
+} | {
+    op: 'gt' | 'gte' | 'lt' | 'lte';
+    value: number | string;
+} | {
+    op: 'in';
+    value: unknown[];
+} | {
+    op: 'contains';
+    value: string;
+} | {
+    op: 'between';
+    value: [number | string, number | string];
+};
+/**
+ * 0.7.1 R2 — filter input accepts composite forms:
+ *   - scalar (shorthand eq): "value", 42
+ *   - single FilterCondition: { op: "eq", value: "x" }
+ *   - array-of-ops: [{op, value}, {op, value}, ...] — AND semantics
+ *   - between shortcut: { op: "between", value: [lo, hi] }
+ * Normalized to Record<string, FilterCondition[]> at engine layer before
+ * reaching the backend. All atomic conditions in the array combine with AND.
+ */
+export type FilterInput = FilterCondition | FilterCondition[] | string | number | unknown;
+export interface DocumentQuery {
+    docType?: DocType;
+    filters?: Record<string, FilterInput>;
+    fields?: string[];
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+export interface ObjectQuery {
+    primitive?: Primitive;
+    subtype?: string;
+    value?: string;
+    contains?: string;
+    range?: {
+        gte?: string;
+        gt?: string;
+        lte?: string;
+        lt?: string;
+    };
+    docId?: DocId;
+    limit?: number;
+    offset?: number;
+}
+export interface DocumentMatch {
+    docId: DocId;
+    docType: DocType;
+    filePath: FilePath;
+    fields?: Record<string, string>;
+}
+export interface ObjectMatch {
+    primitive: Primitive;
+    subtype: string;
+    value: string;
+    normalizedValue: string | number | null;
+    label: string;
+    docId: DocId;
+    sourceLine: number;
+    blockId: BlockId | null;
+}
+export interface BackendStats {
+    totalDocuments: number;
+    totalObjects: number;
+    totalRelationships: number;
+    lastIndexedAt: string | null;
+    documentCountByType: Record<string, number>;
+}
+export interface ParsedCommit {
+    action: string;
+    docId: DocId;
+    docType: DocType;
+    detail: string;
+    summary: string;
+    sha: CommitSha;
+    author: string;
+    timestamp: string;
+}
+export interface AuditEntry {
+    docId: DocId;
+    docType: DocType;
+    actions: number;
+    lastAction: string;
+    lastSummary: string;
+    lastAuthor: string;
+    lastTimestamp: string;
+}
+export interface DiffResult {
+    docId: DocId;
+    from: CommitSha;
+    to: CommitSha;
+    frontmatterChanges: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+    bodyDiff: string;
+}
+export interface SnapshotResult {
+    docId: DocId;
+    commit: CommitSha;
+    timestamp: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export interface VerbatimZone {
+    startLine: number;
+    endLine: number;
+    startCol?: number | undefined;
+    endCol?: number | undefined;
+    inline: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,111 @@
+// ============================================================================
+// MAAD Core Types
+// Every type, branded ID, IR, and constant used across the engine.
+// ============================================================================
+export function docId(raw) {
+    return raw;
+}
+export function docType(raw) {
+    return raw;
+}
+export function schemaRef(raw) {
+    return raw;
+}
+export function filePath(raw) {
+    return raw;
+}
+export function blockId(raw) {
+    return raw;
+}
+export function commitSha(raw) {
+    return raw;
+}
+// --- Extraction Primitives -------------------------------------------------
+export const PRIMITIVES = [
+    'entity',
+    'date',
+    'duration',
+    'amount',
+    'measure',
+    'quantity',
+    'percentage',
+    'location',
+    'identifier',
+    'contact',
+    'media',
+];
+export const DEFAULT_SUBTYPE_MAP = {
+    // primitives self-map (so [[date:...]] resolves to 'date', not 'entity')
+    entity: 'entity',
+    date: 'date',
+    duration: 'duration',
+    amount: 'amount',
+    measure: 'measure',
+    quantity: 'quantity',
+    percentage: 'percentage',
+    location: 'location',
+    identifier: 'identifier',
+    contact: 'contact',
+    media: 'media',
+    // entity
+    person: 'entity',
+    org: 'entity',
+    team: 'entity',
+    product: 'entity',
+    event: 'entity',
+    role: 'entity',
+    // date
+    datetime: 'date',
+    // duration
+    timespan: 'duration',
+    // amount
+    currency: 'amount',
+    price: 'amount',
+    // measure
+    weight: 'measure',
+    height: 'measure',
+    distance: 'measure',
+    temperature: 'measure',
+    dosage: 'measure',
+    area: 'measure',
+    // quantity
+    count: 'quantity',
+    // percentage
+    rate: 'percentage',
+    ratio: 'percentage',
+    // location
+    address: 'location',
+    place: 'location',
+    coordinates: 'location',
+    // identifier
+    case_number: 'identifier',
+    invoice: 'identifier',
+    license: 'identifier',
+    reference: 'identifier',
+    code: 'identifier',
+    // contact
+    email: 'contact',
+    phone: 'contact',
+    url: 'contact',
+    // media
+    image: 'media',
+    video: 'media',
+    audio: 'media',
+    document: 'media',
+    diagram: 'media',
+};
+export function buildSubtypeMap(defaults, projectExtensions) {
+    const map = { ...defaults };
+    if (projectExtensions) {
+        for (const [subtype, primitive] of Object.entries(projectExtensions)) {
+            if (PRIMITIVES.includes(primitive)) {
+                map[subtype] = primitive;
+            }
+        }
+    }
+    return map;
+}
+export function resolvePrimitive(subtype, map) {
+    return map[subtype] ?? 'entity';
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/writer/index.d.ts

@@ -0,0 +1,7 @@
+import type { SchemaDefinition } from '../types.js';
+export { serializeFrontmatter, serializeField } from './serializer.js';
+export { generateTemplateBody } from './template.js';
+export declare function generateDocument(frontmatter: Record<string, unknown>, schema: SchemaDefinition, body?: string | undefined): string;
+export declare function extractBody(rawContent: string): string;
+export declare function appendToBody(existingContent: string, additional: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/writer/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAaR;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQhF"}

package/dist/writer/index.js

@@ -0,0 +1,32 @@
+// ============================================================================
+// Document Writer — Public API
+// Generates, updates, and serializes markdown documents deterministically.
+// ============================================================================
+import { serializeFrontmatter } from './serializer.js';
+import { generateTemplateBody } from './template.js';
+export { serializeFrontmatter, serializeField } from './serializer.js';
+export { generateTemplateBody } from './template.js';
+export function generateDocument(frontmatter, schema, body) {
+    const fm = serializeFrontmatter(frontmatter, schema);
+    // If no body provided, generate from template (if schema defines one)
+    const resolvedBody = body ?? generateTemplateBody(schema, frontmatter);
+    const parts = [fm, ''];
+    if (resolvedBody.length > 0) {
+        parts.push(resolvedBody);
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+export function extractBody(rawContent) {
+    const match = /^---\n[\s\S]*?\n---\n?([\s\S]*)$/.exec(rawContent);
+    return match ? match[1].trim() : rawContent.trim();
+}
+export function appendToBody(existingContent, additional) {
+    const fmMatch = /^(---\n[\s\S]*?\n---\n?)([\s\S]*)$/.exec(existingContent);
+    if (!fmMatch)
+        return existingContent + '\n\n' + additional;
+    const fmPart = fmMatch[1];
+    const bodyPart = fmMatch[2].trimEnd();
+    return fmPart + bodyPart + '\n\n' + additional + '\n';
+}
+//# sourceMappingURL=index.js.map

package/dist/writer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/writer/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+BAA+B;AAC/B,2EAA2E;AAC3E,+EAA+E;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,UAAU,gBAAgB,CAC9B,WAAoC,EACpC,MAAwB,EACxB,IAAyB;IAEzB,MAAM,EAAE,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAErD,sEAAsE;IACtE,MAAM,YAAY,GAAG,IAAI,IAAI,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,UAAkB;IACtE,MAAM,OAAO,GAAG,oCAAoC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;IAE3D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,CAAC;IAEvC,OAAO,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AACxD,CAAC"}

package/dist/writer/serializer.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaDefinition } from '../types.js';
+export declare function serializeFrontmatter(frontmatter: Record<string, unknown>, schema: SchemaDefinition): string;
+export declare function serializeField(key: string, value: unknown): string;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/writer/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/writer/serializer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiBpD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAsCR;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAiDlE"}

package/dist/writer/serializer.js

@@ -0,0 +1,103 @@
+// ============================================================================
+// YAML Serializer
+// Serializes frontmatter to YAML with deterministic field ordering.
+// ============================================================================
+import yaml from 'js-yaml';
+// Coercion-roundtrip guard. Any string whose unquoted YAML form would parse
+// back as a non-string under our CORE_SCHEMA loader must be quoted, or string
+// fields silently corrupt on read. The static keyword/numeric checks below
+// catch the common cases; this guard is the catch-all that future-proofs us
+// against any implicit-tag scalar we forgot to enumerate (leading-zero ints,
+// sci-notation lookalikes like `1e38892`, hex/octal literals, etc.).
+function wouldCoerceFromString(candidate) {
+    try {
+        const parsed = yaml.load(candidate, { schema: yaml.CORE_SCHEMA });
+        return parsed !== candidate;
+    }
+    catch {
+        return true;
+    }
+}
+export function serializeFrontmatter(frontmatter, schema) {
+    const lines = ['---'];
+    const written = new Set();
+    // Core keys first: doc_id, doc_type, schema
+    const coreKeys = ['doc_id', 'doc_type', 'schema'];
+    for (const key of coreKeys) {
+        if (key in frontmatter) {
+            lines.push(serializeField(key, frontmatter[key]));
+            written.add(key);
+        }
+    }
+    // Required fields next (in schema order)
+    for (const key of schema.required) {
+        if (!written.has(key) && key in frontmatter) {
+            lines.push(serializeField(key, frontmatter[key]));
+            written.add(key);
+        }
+    }
+    // Remaining fields (in schema field order, then any extras)
+    for (const [key] of schema.fields) {
+        if (!written.has(key) && key in frontmatter) {
+            lines.push(serializeField(key, frontmatter[key]));
+            written.add(key);
+        }
+    }
+    // Any fields not in schema (user extras)
+    for (const key of Object.keys(frontmatter)) {
+        if (!written.has(key)) {
+            lines.push(serializeField(key, frontmatter[key]));
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+export function serializeField(key, value) {
+    if (value === null || value === undefined)
+        return `${key}: null`;
+    if (typeof value === 'boolean')
+        return `${key}: ${value}`;
+    if (typeof value === 'number')
+        return `${key}: ${value}`;
+    if (Array.isArray(value)) {
+        const items = value.map(v => {
+            const s = String(v);
+            // Quote items that contain commas or brackets
+            if (s.includes(',') || s.includes('[') || s.includes(']'))
+                return `"${s.replace(/"/g, '\\"')}"`;
+            return s;
+        });
+        return `${key}: [${items.join(', ')}]`;
+    }
+    if (value instanceof Date) {
+        // Full ISO millisecond precision. Never slice — precision on round-trip
+        // is contract-critical for 0.6.7 schema precision hints. Quoted so the
+        // emitted YAML parses as a literal string under any schema (including
+        // default js-yaml outside our pipeline), never as a !!timestamp.
+        return `${key}: "${value.toISOString()}"`;
+    }
+    const str = String(value);
+    // Quote strings that contain YAML-special characters
+    if (str.includes(':') ||
+        str.includes('#') ||
+        str.includes('"') ||
+        str.includes("'") ||
+        str.startsWith('{') ||
+        str.startsWith('[') ||
+        str.startsWith('*') ||
+        str.startsWith('&') ||
+        str.startsWith('!') ||
+        str.startsWith('%') ||
+        str.startsWith('@') ||
+        str.startsWith('`') ||
+        str === '' ||
+        str === 'true' || str === 'false' ||
+        str === 'null' || str === 'yes' || str === 'no' ||
+        /^\d/.test(str) && /[^\d.eE+-]/.test(str) || // looks numeric but isn't
+        wouldCoerceFromString(str) // catch-all: any implicit-tag coercion forces quotes
+    ) {
+        return `${key}: "${str.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return `${key}: ${str}`;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/writer/serializer.js.map

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

package/dist/writer/template.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaDefinition } from '../types.js';
+export declare function generateTemplateBody(schema: SchemaDefinition, fields: Record<string, unknown>): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/writer/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/writer/template.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAErE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAeR"}

package/dist/writer/template.js

@@ -0,0 +1,27 @@
+// ============================================================================
+// Template Generator
+// Generates markdown body structure from schema-defined template headings.
+// Resolves {{field}} references in heading text.
+// ============================================================================
+export function generateTemplateBody(schema, fields) {
+    if (!schema.template || schema.template.length === 0)
+        return '';
+    const sections = [];
+    for (const heading of schema.template) {
+        const prefix = '#'.repeat(heading.level);
+        const text = resolveFieldRefs(heading.text, fields);
+        const anchor = heading.id ? ` {#${heading.id}}` : '';
+        sections.push(`${prefix} ${text}${anchor}`);
+        sections.push(''); // blank line after heading
+    }
+    return sections.join('\n').trimEnd();
+}
+function resolveFieldRefs(text, fields) {
+    return text.replace(/\{\{([a-zA-Z_][a-zA-Z0-9_.]*)\}\}/g, (_, key) => {
+        const value = fields[key];
+        if (value === undefined || value === null)
+            return key;
+        return String(value);
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/writer/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/writer/template.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAqB;AACrB,2EAA2E;AAC3E,iDAAiD;AACjD,+EAA+E;AAI/E,MAAM,UAAU,oBAAoB,CAClC,MAAwB,EACxB,MAA+B;IAE/B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAChD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAA+B;IACrE,OAAO,IAAI,CAAC,OAAO,CAAC,oCAAoC,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;QACtD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}