lens-content-processor 0.1.0

package/dist/parser/frontmatter.test.js

@@ -0,0 +1,54 @@
+// src/parser/frontmatter.test.ts
+import { describe, it, expect } from 'vitest';
+import { parseFrontmatter } from './frontmatter';
+describe('parseFrontmatter', () => {
+    it('extracts frontmatter fields', () => {
+        const content = `---
+slug: my-module
+title: My Module Title
+---
+
+# Content here`;
+        const result = parseFrontmatter(content);
+        expect(result.frontmatter).toEqual({
+            slug: 'my-module',
+            title: 'My Module Title',
+        });
+        expect(result.body).toBe('\n# Content here');
+        expect(result.bodyStartLine).toBe(5);
+    });
+    it('returns error for missing frontmatter', () => {
+        const content = '# No frontmatter here';
+        const result = parseFrontmatter(content);
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toBe('Missing frontmatter');
+        expect(result.error?.line).toBe(1);
+    });
+    it('returns error for unclosed frontmatter', () => {
+        const content = `---
+slug: broken
+title: Never Closed`;
+        const result = parseFrontmatter(content);
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('Unclosed frontmatter');
+    });
+    it('includes file path in error when provided', () => {
+        const content = '# No frontmatter here';
+        const result = parseFrontmatter(content, 'modules/test.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.file).toBe('modules/test.md');
+    });
+    it('handles invalid YAML syntax', () => {
+        const content = `---
+slug: test
+title: [invalid yaml
+---
+
+# Content`;
+        const result = parseFrontmatter(content);
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('Invalid YAML');
+        expect(result.error?.line).toBe(2);
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

package/dist/parser/frontmatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.test.js","sourceRoot":"","sources":["../../src/parser/frontmatter.test.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG;;;;;eAKL,CAAC;QAEZ,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YACjC,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,iBAAiB;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,uBAAuB,CAAC;QAExC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG;;oBAEA,CAAC;QAEjB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG,uBAAuB,CAAC;QAExC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG;;;;;UAKV,CAAC;QAEP,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/parser/learning-outcome.d.ts

@@ -0,0 +1,21 @@
+import type { ContentError } from '../index.js';
+export interface ParsedLensRef {
+    source: string;
+    resolvedPath: string;
+    optional: boolean;
+}
+export interface ParsedTestRef {
+    source: string;
+    resolvedPath: string;
+}
+export interface ParsedLearningOutcome {
+    id: string;
+    lenses: ParsedLensRef[];
+    test?: ParsedTestRef;
+    discussion?: string;
+}
+export interface LearningOutcomeParseResult {
+    learningOutcome: ParsedLearningOutcome | null;
+    errors: ContentError[];
+}
+export declare function parseLearningOutcome(content: string, file: string): LearningOutcomeParseResult;

package/dist/parser/learning-outcome.js

@@ -0,0 +1,116 @@
+import { parseFrontmatter } from './frontmatter.js';
+import { parseSections, LO_SECTION_TYPES } from './sections.js';
+import { parseWikilink, resolveWikilinkPath } from './wikilink.js';
+export function parseLearningOutcome(content, file) {
+    const errors = [];
+    // Step 1: Parse frontmatter and validate id field
+    const frontmatterResult = parseFrontmatter(content, file);
+    if (frontmatterResult.error) {
+        errors.push(frontmatterResult.error);
+        return { learningOutcome: null, errors };
+    }
+    const { frontmatter, body, bodyStartLine } = frontmatterResult;
+    // Validate required id field
+    if (!frontmatter.id) {
+        errors.push({
+            file,
+            line: 2,
+            message: 'Missing required field: id',
+            suggestion: "Add 'id: <uuid>' to frontmatter",
+            severity: 'error',
+        });
+        return { learningOutcome: null, errors };
+    }
+    // Step 2: Parse sections with H2 level and LO_SECTION_TYPES ('lens', 'test')
+    const sectionsResult = parseSections(body, 2, LO_SECTION_TYPES, file);
+    // Adjust line numbers to account for frontmatter
+    for (const error of sectionsResult.errors) {
+        if (error.line) {
+            error.line += bodyStartLine - 1;
+        }
+    }
+    errors.push(...sectionsResult.errors);
+    for (const section of sectionsResult.sections) {
+        section.line += bodyStartLine - 1;
+    }
+    // Step 3: Extract lens refs with source field and optional flag
+    const lenses = [];
+    let testRef;
+    for (const section of sectionsResult.sections) {
+        if (section.type === 'lens') {
+            const source = section.fields.source;
+            if (!source) {
+                errors.push({
+                    file,
+                    line: section.line,
+                    message: 'Lens section missing source:: field',
+                    suggestion: "Add 'source:: [[../Lenses/filename.md|Display]]' to the lens section",
+                    severity: 'error',
+                });
+                continue;
+            }
+            // Parse wikilink and resolve path
+            const wikilink = parseWikilink(source);
+            if (!wikilink) {
+                errors.push({
+                    file,
+                    line: section.line,
+                    message: `Invalid wikilink format in source:: field: ${source}`,
+                    suggestion: 'Use format [[../Lenses/filename.md|Display Text]]',
+                    severity: 'error',
+                });
+                continue;
+            }
+            const resolvedPath = resolveWikilinkPath(wikilink.path, file);
+            const optional = section.fields.optional === 'true';
+            lenses.push({
+                source,
+                resolvedPath,
+                optional,
+            });
+        }
+        else if (section.type === 'test') {
+            const source = section.fields.source;
+            // source:: is optional for test sections (tests not fully implemented yet)
+            if (!source) {
+                continue;
+            }
+            // Parse wikilink and resolve path
+            const wikilink = parseWikilink(source);
+            if (!wikilink) {
+                errors.push({
+                    file,
+                    line: section.line,
+                    message: `Invalid wikilink format in source:: field: ${source}`,
+                    suggestion: 'Use format [[../Tests/filename.md|Display Text]]',
+                    severity: 'error',
+                });
+                continue;
+            }
+            const resolvedPath = resolveWikilinkPath(wikilink.path, file);
+            testRef = {
+                source,
+                resolvedPath,
+            };
+        }
+    }
+    // Step 4: Validate at least one lens exists
+    if (lenses.length === 0) {
+        errors.push({
+            file,
+            line: bodyStartLine,
+            message: 'Learning Outcome must have at least one ## Lens: section',
+            suggestion: "Add a '## Lens: <title>' section with a source:: field",
+            severity: 'error',
+        });
+    }
+    // Return result even if there are errors (partial success)
+    const learningOutcome = {
+        id: frontmatter.id,
+        lenses,
+        test: testRef,
+        discussion: frontmatter.discussion,
+    };
+    return { learningOutcome, errors };
+}
+//# sourceMappingURL=learning-outcome.js.map

package/dist/parser/learning-outcome.js.map

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

package/dist/parser/learning-outcome.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parser/learning-outcome.test.js

@@ -0,0 +1,75 @@
+// src/parser/learning-outcome.test.ts
+import { describe, it, expect } from 'vitest';
+import { parseLearningOutcome } from './learning-outcome.js';
+describe('parseLearningOutcome', () => {
+    it('parses LO with multiple lenses', () => {
+        const content = `---
+id: 550e8400-e29b-41d4-a716-446655440001
+---
+
+## Lens: First Lens
+source:: [[../Lenses/lens1.md|Lens 1]]
+
+## Lens: Second Lens
+source:: [[../Lenses/lens2.md|Lens 2]]
+optional:: true
+
+## Test: Knowledge Check
+source:: [[../Tests/test1.md|Test]]
+`;
+        const result = parseLearningOutcome(content, 'Learning Outcomes/lo1.md');
+        expect(result.learningOutcome?.id).toBe('550e8400-e29b-41d4-a716-446655440001');
+        expect(result.learningOutcome?.lenses).toHaveLength(2);
+        expect(result.learningOutcome?.lenses[0].source).toBe('[[../Lenses/lens1.md|Lens 1]]');
+        expect(result.learningOutcome?.lenses[0].resolvedPath).toBe('Lenses/lens1.md');
+        expect(result.learningOutcome?.lenses[0].optional).toBe(false);
+        expect(result.learningOutcome?.lenses[1].source).toBe('[[../Lenses/lens2.md|Lens 2]]');
+        expect(result.learningOutcome?.lenses[1].resolvedPath).toBe('Lenses/lens2.md');
+        expect(result.learningOutcome?.lenses[1].optional).toBe(true);
+        expect(result.learningOutcome?.test?.source).toContain('test1.md');
+        expect(result.learningOutcome?.test?.resolvedPath).toBe('Tests/test1.md');
+        expect(result.errors).toHaveLength(0);
+    });
+    it('requires id in frontmatter', () => {
+        const content = `---
+title: Missing ID
+---
+
+## Lens: Test
+source:: [[../Lenses/lens1.md|Lens]]
+`;
+        const result = parseLearningOutcome(content, 'Learning Outcomes/bad.md');
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0].message).toContain('id');
+    });
+    it('requires at least one lens', () => {
+        const content = `---
+id: 550e8400-e29b-41d4-a716-446655440001
+---
+
+No lenses here.
+`;
+        const result = parseLearningOutcome(content, 'Learning Outcomes/empty.md');
+        expect(result.errors.some(e => e.message.includes('Lens'))).toBe(true);
+    });
+    it('allows test section without source:: field (tests not implemented yet)', () => {
+        const content = `---
+id: 550e8400-e29b-41d4-a716-446655440001
+---
+
+## Lens: Main Content
+source:: [[../Lenses/lens1.md|Lens 1]]
+
+## Test: Knowledge Check
+`;
+        const result = parseLearningOutcome(content, 'Learning Outcomes/lo1.md');
+        // Should NOT produce an error for missing source:: in test section
+        expect(result.errors).toHaveLength(0);
+        // The LO should be parsed successfully
+        expect(result.learningOutcome?.id).toBe('550e8400-e29b-41d4-a716-446655440001');
+        expect(result.learningOutcome?.lenses).toHaveLength(1);
+        // Test should be undefined since no source was provided
+        expect(result.learningOutcome?.test).toBeUndefined();
+    });
+});
+//# sourceMappingURL=learning-outcome.test.js.map

package/dist/parser/learning-outcome.test.js.map

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

package/dist/parser/lens.d.ts

@@ -0,0 +1,51 @@
+import type { ContentError } from '../index.js';
+export interface ParsedTextSegment {
+    type: 'text';
+    content: string;
+    optional?: boolean;
+}
+export interface ParsedChatSegment {
+    type: 'chat';
+    title?: string;
+    instructions?: string;
+    hidePreviousContentFromUser?: boolean;
+    hidePreviousContentFromTutor?: boolean;
+    optional?: boolean;
+}
+export interface ParsedArticleExcerptSegment {
+    type: 'article-excerpt';
+    fromAnchor?: string;
+    toAnchor?: string;
+    optional?: boolean;
+}
+export interface ParsedVideoExcerptSegment {
+    type: 'video-excerpt';
+    fromTimeStr: string;
+    toTimeStr: string;
+    optional?: boolean;
+}
+export type ParsedLensSegment = ParsedTextSegment | ParsedChatSegment | ParsedArticleExcerptSegment | ParsedVideoExcerptSegment;
+export interface ParsedLensSection {
+    type: string;
+    title: string;
+    source?: string;
+    resolvedPath?: string;
+    segments: ParsedLensSegment[];
+    line: number;
+}
+export interface ParsedLens {
+    id: string;
+    sections: ParsedLensSection[];
+}
+export interface LensParseResult {
+    lens: ParsedLens | null;
+    errors: ContentError[];
+}
+/**
+ * Parse a lens file into structured lens data.
+ *
+ * Lens files use:
+ * - H3 (`###`) for sections: Text, Article, Video
+ * - H4 (`####`) for segments: Text, Chat, Article-excerpt, Video-excerpt
+ */
+export declare function parseLens(content: string, file: string): LensParseResult;

package/dist/parser/lens.js

@@ -0,0 +1,328 @@
+import { parseFrontmatter } from './frontmatter.js';
+import { parseSections, LENS_SECTION_TYPES, LENS_OUTPUT_TYPE } from './sections.js';
+import { validateSegmentFields } from '../validator/segment-fields.js';
+import { validateFieldValues } from '../validator/field-values.js';
+// Valid segment types for lens H4 headers
+const LENS_SEGMENT_TYPES = new Set(['text', 'chat', 'article-excerpt', 'video-excerpt']);
+// H4 segment header pattern: #### <type> or #### <type>: <title>
+const SEGMENT_HEADER_PATTERN = /^####\s+(\S+)(?::\s*(.*))?$/i;
+// Field pattern: fieldname:: value
+const FIELD_PATTERN = /^(\w+)::\s*(.*)$/;
+/**
+ * Parse H4 segments from a section body.
+ * Segments are defined by `#### <type>` headers within a section.
+ */
+function parseSegments(sectionBody, bodyStartLine, file) {
+    const lines = sectionBody.split('\n');
+    const segments = [];
+    const errors = [];
+    let currentSegment = null;
+    let currentFieldLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = bodyStartLine + i;
+        const headerMatch = line.match(SEGMENT_HEADER_PATTERN);
+        if (headerMatch) {
+            // Save previous segment
+            if (currentSegment) {
+                parseFieldsIntoSegment(currentSegment, currentFieldLines);
+                segments.push(currentSegment);
+            }
+            const rawType = headerMatch[1].trim();
+            const normalizedType = rawType.toLowerCase();
+            const title = headerMatch[2]?.trim() || undefined;
+            if (!LENS_SEGMENT_TYPES.has(normalizedType)) {
+                errors.push({
+                    file,
+                    line: lineNum,
+                    message: `Unknown segment type: ${rawType}`,
+                    suggestion: `Valid types: ${[...LENS_SEGMENT_TYPES].join(', ')}`,
+                    severity: 'error',
+                });
+            }
+            currentSegment = {
+                type: normalizedType,
+                title,
+                fields: {},
+                line: lineNum,
+            };
+            currentFieldLines = [];
+        }
+        else if (currentSegment) {
+            currentFieldLines.push(line);
+        }
+    }
+    // Don't forget last segment
+    if (currentSegment) {
+        parseFieldsIntoSegment(currentSegment, currentFieldLines);
+        segments.push(currentSegment);
+    }
+    return { segments, errors };
+}
+/**
+ * Parse fields from lines into a segment, handling multiline values.
+ * A field continues until the next field or the end of the lines.
+ */
+function parseFieldsIntoSegment(segment, lines) {
+    let currentField = null;
+    let currentValue = [];
+    for (const line of lines) {
+        const match = line.match(FIELD_PATTERN);
+        if (match) {
+            // Save previous field if any
+            if (currentField) {
+                segment.fields[currentField] = currentValue.join('\n').trim();
+            }
+            currentField = match[1];
+            const inlineValue = match[2].trim();
+            currentValue = inlineValue ? [inlineValue] : [];
+        }
+        else if (currentField) {
+            // Continue multiline value
+            currentValue.push(line);
+        }
+    }
+    // Save final field
+    if (currentField) {
+        segment.fields[currentField] = currentValue.join('\n').trim();
+    }
+}
+/**
+ * Convert a raw segment to a typed ParsedLensSegment.
+ */
+function convertSegment(raw, sectionType, file) {
+    const errors = [];
+    switch (raw.type) {
+        case 'text': {
+            const hasContentField = 'content' in raw.fields;
+            const content = raw.fields.content;
+            if (!hasContentField) {
+                // Field completely missing - error
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Text segment missing content:: field',
+                    suggestion: "Add 'content:: Your text here' to the text segment",
+                    severity: 'error',
+                });
+                return { segment: null, errors };
+            }
+            if (!content || content.trim() === '') {
+                // Field present but empty - warning
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Text segment has empty content:: field',
+                    suggestion: 'Add text content after content::',
+                    severity: 'warning',
+                });
+                // Still create the segment, just with empty content
+                const segment = {
+                    type: 'text',
+                    content: '',
+                    optional: raw.fields.optional === 'true' ? true : undefined,
+                };
+                return { segment, errors };
+            }
+            const segment = {
+                type: 'text',
+                content,
+                optional: raw.fields.optional === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
+        case 'chat': {
+            const segment = {
+                type: 'chat',
+                title: raw.title,
+                instructions: raw.fields.instructions,
+                hidePreviousContentFromUser: raw.fields.hidePreviousContentFromUser === 'true' ? true : undefined,
+                hidePreviousContentFromTutor: raw.fields.hidePreviousContentFromTutor === 'true' ? true : undefined,
+                optional: raw.fields.optional === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
+        case 'article-excerpt': {
+            const fromField = raw.fields.from;
+            const toField = raw.fields.to;
+            // Both from:: and to:: are optional for article-excerpt:
+            // - Only from:: → extract from anchor to end of article
+            // - Only to:: → extract from start to anchor
+            // - Neither → extract entire article
+            // Strip quotes from anchor text if present
+            const fromAnchor = fromField ? stripQuotes(fromField) : undefined;
+            const toAnchor = toField ? stripQuotes(toField) : undefined;
+            const segment = {
+                type: 'article-excerpt',
+                fromAnchor,
+                toAnchor,
+                optional: raw.fields.optional === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
+        case 'video-excerpt': {
+            const fromField = raw.fields.from;
+            const toField = raw.fields.to;
+            // to:: is required, from:: defaults to "0:00"
+            if (!toField) {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Video-excerpt segment missing to:: field',
+                    suggestion: "Add 'to:: M:SS' or 'to:: H:MM:SS' to the segment",
+                    severity: 'error',
+                });
+                return { segment: null, errors };
+            }
+            const segment = {
+                type: 'video-excerpt',
+                fromTimeStr: fromField || '0:00', // Default to start of video
+                toTimeStr: toField,
+                optional: raw.fields.optional === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
+        default:
+            // Unknown segment type - error already reported during parseSegments
+            return { segment: null, errors };
+    }
+}
+/**
+ * Strip surrounding quotes from a string if present.
+ */
+function stripQuotes(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+/**
+ * Check if a segment is empty (has no meaningful fields).
+ * Returns a warning if the segment is empty.
+ *
+ * Note: article-excerpt with no fields is valid (means entire article).
+ */
+function checkEmptySegment(raw, file) {
+    // A segment is empty if it has no fields at all
+    const fieldCount = Object.keys(raw.fields).length;
+    // article-excerpt with no fields is valid - means "include entire article"
+    if (raw.type === 'article-excerpt' && fieldCount === 0) {
+        return null;
+    }
+    if (fieldCount === 0) {
+        return {
+            file,
+            line: raw.line,
+            message: `Empty ${raw.type} segment has no fields`,
+            suggestion: `Add required fields to the ${raw.type} segment`,
+            severity: 'warning',
+        };
+    }
+    return null;
+}
+/**
+ * Parse a lens file into structured lens data.
+ *
+ * Lens files use:
+ * - H3 (`###`) for sections: Text, Article, Video
+ * - H4 (`####`) for segments: Text, Chat, Article-excerpt, Video-excerpt
+ */
+export function parseLens(content, file) {
+    const errors = [];
+    // Step 1: Parse frontmatter and validate id field
+    const frontmatterResult = parseFrontmatter(content, file);
+    if (frontmatterResult.error) {
+        errors.push(frontmatterResult.error);
+        return { lens: null, errors };
+    }
+    const { frontmatter, body, bodyStartLine } = frontmatterResult;
+    // Validate required id field
+    if (!frontmatter.id) {
+        errors.push({
+            file,
+            line: 2,
+            message: 'Missing required field: id',
+            suggestion: "Add 'id: <uuid>' to frontmatter",
+            severity: 'error',
+        });
+        return { lens: null, errors };
+    }
+    // Step 2: Parse H3 sections (Text, Article, Video)
+    const sectionsResult = parseSections(body, 3, LENS_SECTION_TYPES, file);
+    // Adjust line numbers to account for frontmatter
+    for (const error of sectionsResult.errors) {
+        if (error.line) {
+            error.line += bodyStartLine - 1;
+        }
+    }
+    errors.push(...sectionsResult.errors);
+    for (const section of sectionsResult.sections) {
+        section.line += bodyStartLine - 1;
+    }
+    // Step 3: Convert raw sections to ParsedLensSections with segments
+    const parsedSections = [];
+    for (const rawSection of sectionsResult.sections) {
+        // Map section type: 'article' -> 'lens-article', 'video' -> 'lens-video'
+        const outputType = LENS_OUTPUT_TYPE[rawSection.type] ?? rawSection.type;
+        // For article/video sections, source field is required
+        const needsSource = outputType === 'lens-article' || outputType === 'lens-video';
+        const source = rawSection.fields.source;
+        if (needsSource && !source) {
+            errors.push({
+                file,
+                line: rawSection.line,
+                message: `${rawSection.rawType} section missing source:: field`,
+                suggestion: `Add 'source:: [[../path/to/file.md|Display]]' to the ${rawSection.rawType.toLowerCase()} section`,
+                severity: 'error',
+            });
+        }
+        // Parse H4 segments within this section
+        const { segments: rawSegments, errors: segmentErrors } = parseSegments(rawSection.body, rawSection.line + 1, // Segments start after the section header
+        file);
+        errors.push(...segmentErrors);
+        // Convert raw segments to typed segments
+        const segments = [];
+        for (const rawSeg of rawSegments) {
+            // Check for empty segments
+            const emptyWarning = checkEmptySegment(rawSeg, file);
+            if (emptyWarning) {
+                errors.push(emptyWarning);
+            }
+            // Validate that fields are appropriate for this segment type
+            const fieldWarnings = validateSegmentFields(rawSeg.type, rawSeg.fields, file, rawSeg.line);
+            errors.push(...fieldWarnings);
+            // Validate field values (e.g., boolean fields should have 'true' or 'false')
+            const valueWarnings = validateFieldValues(rawSeg.fields, file, rawSeg.line);
+            errors.push(...valueWarnings);
+            const { segment, errors: conversionErrors } = convertSegment(rawSeg, outputType, file);
+            errors.push(...conversionErrors);
+            if (segment) {
+                segments.push(segment);
+            }
+        }
+        // Warn if section has no segments
+        if (segments.length === 0) {
+            errors.push({
+                file,
+                line: rawSection.line,
+                message: `${rawSection.rawType} section has no segments`,
+                suggestion: `Add at least one segment (#### Text, #### Chat, etc.) to the ${rawSection.rawType.toLowerCase()} section`,
+                severity: 'warning',
+            });
+        }
+        const parsedSection = {
+            type: outputType,
+            title: rawSection.title,
+            source: source,
+            segments,
+            line: rawSection.line,
+        };
+        parsedSections.push(parsedSection);
+    }
+    const lens = {
+        id: frontmatter.id,
+        sections: parsedSections,
+    };
+    return { lens, errors };
+}
+//# sourceMappingURL=lens.js.map