@cwygoda/service-catalog-core 0.17.1

package/dist/adapters/parsers/bpmn-steps.js

@@ -0,0 +1,124 @@
+function collectFromNodes(nodes, out) {
+    if (!nodes)
+        return;
+    for (const node of nodes) {
+        if (node.type === 'task' && node.id) {
+            out.tasks.set(node.id, node);
+        }
+        if (node.type === 'subprocess' && node.elements) {
+            collectFromNodes(node.elements, out);
+        }
+    }
+}
+function collectFromDocument(doc) {
+    const out = { tasks: new Map(), flows: [] };
+    for (const process of doc.processes) {
+        collectFromNodes(process.elements, out);
+        if (process.sequenceFlows)
+            out.flows.push(...process.sequenceFlows);
+        if (process.pools) {
+            for (const pool of process.pools) {
+                collectFromNodes(pool.elements, out);
+                if (pool.sequenceFlows)
+                    out.flows.push(...pool.sequenceFlows);
+                if (pool.lanes) {
+                    for (const lane of pool.lanes) {
+                        collectFromNodes(lane.elements, out);
+                        if (lane.sequenceFlows)
+                            out.flows.push(...lane.sequenceFlows);
+                    }
+                }
+            }
+        }
+    }
+    return out;
+}
+/** Extract steps from BPMN AST — tasks ordered by sequence flow topology */
+export function extractSteps(doc) {
+    const { tasks, flows } = collectFromDocument(doc);
+    if (tasks.size === 0)
+        return [];
+    // Build adjacency: nodeId → list of target nodeIds
+    const adj = new Map();
+    const inDegree = new Map();
+    for (const id of tasks.keys()) {
+        inDegree.set(id, 0);
+    }
+    for (const flow of flows) {
+        const targets = adj.get(flow.from);
+        if (targets) {
+            targets.push(flow.to);
+        }
+        else {
+            adj.set(flow.from, [flow.to]);
+        }
+    }
+    // Resolve transitive edges through non-task nodes (events, gateways)
+    // so we get direct task→task ordering.
+    const taskAdj = new Map();
+    for (const id of tasks.keys()) {
+        taskAdj.set(id, new Set());
+    }
+    // BFS from each task to find reachable next tasks
+    for (const taskId of tasks.keys()) {
+        const visited = new Set();
+        const bfsQueue = [taskId];
+        visited.add(taskId);
+        const neighbors = taskAdj.get(taskId) ?? new Set();
+        while (bfsQueue.length > 0) {
+            const current = bfsQueue.shift() ?? '';
+            const targets = adj.get(current) ?? [];
+            for (const target of targets) {
+                if (visited.has(target))
+                    continue;
+                visited.add(target);
+                if (tasks.has(target)) {
+                    neighbors.add(target);
+                }
+                else {
+                    bfsQueue.push(target);
+                }
+            }
+        }
+    }
+    // Compute in-degree for topological sort over tasks only
+    for (const [, targets] of taskAdj) {
+        for (const target of targets) {
+            inDegree.set(target, (inDegree.get(target) ?? 0) + 1);
+        }
+    }
+    // Kahn's algorithm
+    const topoQueue = [];
+    for (const [id, deg] of inDegree) {
+        if (deg === 0)
+            topoQueue.push(id);
+    }
+    const ordered = [];
+    while (topoQueue.length > 0) {
+        const id = topoQueue.shift() ?? '';
+        ordered.push(id);
+        for (const target of taskAdj.get(id) ?? []) {
+            const newDeg = (inDegree.get(target) ?? 1) - 1;
+            inDegree.set(target, newDeg);
+            if (newDeg === 0)
+                topoQueue.push(target);
+        }
+    }
+    // Any tasks not reached by topo sort (disconnected) — append at end
+    const orderedSet = new Set(ordered);
+    for (const id of tasks.keys()) {
+        if (!orderedSet.has(id))
+            ordered.push(id);
+    }
+    return ordered.map((id, i) => {
+        const task = tasks.get(id);
+        const step = {
+            sequence: i + 1,
+            action: task?.name ?? id,
+        };
+        if (task?.service)
+            step.service = task.service;
+        return step;
+    });
+}
+//# sourceMappingURL=bpmn-steps.js.map

package/dist/adapters/parsers/bpmn-steps.js.map

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

package/dist/adapters/parsers/bpmn-steps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bpmn-steps.test.d.ts.map

package/dist/adapters/parsers/bpmn-steps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn-steps.test.d.ts","sourceRoot":"","sources":["../../../src/adapters/parsers/bpmn-steps.test.ts"],"names":[],"mappings":""}

package/dist/adapters/parsers/bpmn-steps.test.js

@@ -0,0 +1,112 @@
+import { describe, it, expect } from 'vitest';
+import { parse } from '@cwygoda/bpmn-txt';
+import { extractSteps } from './bpmn-steps.js';
+function stepsFrom(bpmnTxt) {
+    const { document } = parse(bpmnTxt);
+    if (!document)
+        throw new Error('Parse failed');
+    return extractSteps(document);
+}
+describe('extractSteps', () => {
+    it('linear process → steps in order', () => {
+        const steps = stepsFrom(`
+process: linear
+  start: s
+    -> a
+  task: a
+    name: "First"
+    service: svc-a
+    -> b
+  task: b
+    name: "Second"
+    -> c
+  task: c
+    name: "Third"
+    service: svc-c
+    -> e
+  end: e
+`);
+        expect(steps).toEqual([
+            { sequence: 1, action: 'First', service: 'svc-a' },
+            { sequence: 2, action: 'Second' },
+            { sequence: 3, action: 'Third', service: 'svc-c' },
+        ]);
+    });
+    it('process with pools → steps across all pools', () => {
+        const steps = stepsFrom(`
+process: pooled
+  pool: customer
+    lane: web
+      start: s
+        -> browse
+      task: browse
+        name: "Browse"
+        -> finish
+  pool: backend
+    task: process-order
+      name: "Process Order"
+      -> done
+    end: done
+  end: finish
+`);
+        expect(steps).toHaveLength(2);
+        const actions = steps.map((s) => s.action);
+        expect(actions).toContain('Browse');
+        expect(actions).toContain('Process Order');
+    });
+    it('process with gateways → tasks from both branches', () => {
+        const steps = stepsFrom(`
+process: gw
+  start: s
+    -> g1
+  gateway: g1
+    type: exclusive
+    -> a
+    -> b
+  task: a
+    name: "Branch A"
+    -> g2
+  task: b
+    name: "Branch B"
+    -> g2
+  gateway: g2
+    type: exclusive
+    -> c
+  task: c
+    name: "After Merge"
+    -> e
+  end: e
+`);
+        expect(steps).toHaveLength(3);
+        // a and b both before c
+        const cStep = steps.find((s) => s.action === 'After Merge');
+        const aStep = steps.find((s) => s.action === 'Branch A');
+        const bStep = steps.find((s) => s.action === 'Branch B');
+        expect(cStep).toBeDefined();
+        expect(aStep).toBeDefined();
+        expect(bStep).toBeDefined();
+        expect(aStep?.sequence).toBeLessThan(cStep?.sequence ?? 0);
+        expect(bStep?.sequence).toBeLessThan(cStep?.sequence ?? 0);
+    });
+    it('process with no tasks → empty steps', () => {
+        const steps = stepsFrom(`
+process: empty
+  start: s
+    -> e
+  end: e
+`);
+        expect(steps).toEqual([]);
+    });
+    it('tasks without name → uses id as action', () => {
+        const steps = stepsFrom(`
+process: noname
+  start: s
+    -> do-thing
+  task: do-thing
+    -> e
+  end: e
+`);
+        expect(steps).toEqual([{ sequence: 1, action: 'do-thing' }]);
+    });
+});
+//# sourceMappingURL=bpmn-steps.test.js.map

package/dist/adapters/parsers/bpmn-steps.test.js.map

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

package/dist/adapters/parsers/bpmn-txt.parser.d.ts

@@ -0,0 +1,21 @@
+import { type ParseError, type LintResult, type LinterConfig } from '@cwygoda/bpmn-txt';
+import type { BpmnLintLevel } from '../../schemas/catalog-config.schema.js';
+export interface BpmnTxtParseResult {
+    xml: string;
+    lintResults: LintResult[];
+}
+export declare class BpmnTxtParseError extends Error {
+    readonly filePath: string;
+    readonly errors: ParseError[];
+    constructor(message: string, filePath: string, errors: ParseError[]);
+    toString(): string;
+}
+export declare class BpmnLintError extends Error {
+    readonly filePath: string;
+    readonly results: LintResult[];
+    constructor(message: string, filePath: string, results: LintResult[]);
+    toString(): string;
+}
+export declare function detectBpmnTxtContent(content: string): boolean;
+export declare function parseBpmnTxt(content: string, filePath: string, lintLevel?: BpmnLintLevel, lintConfig?: LinterConfig): Promise<BpmnTxtParseResult>;
+//# sourceMappingURL=bpmn-txt.parser.d.ts.map

package/dist/adapters/parsers/bpmn-txt.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn-txt.parser.d.ts","sourceRoot":"","sources":["../../../src/adapters/parsers/bpmn-txt.parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAGxB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,UAAU,EAAE;gBAFpC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAAE;IAM7B,QAAQ,IAAI,MAAM;CAM5B;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGpB,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,UAAU,EAAE;gBAFrC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EAAE;IAM9B,QAAQ,IAAI,MAAM;CAM5B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAsB,EACjC,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAsB7B"}

package/dist/adapters/parsers/bpmn-txt.parser.js

@@ -0,0 +1,56 @@
+import { parse, toBpmnXmlAsync, lint, } from '@cwygoda/bpmn-txt';
+export class BpmnTxtParseError extends Error {
+    filePath;
+    errors;
+    constructor(message, filePath, errors) {
+        super(message);
+        this.filePath = filePath;
+        this.errors = errors;
+        this.name = 'BpmnTxtParseError';
+    }
+    toString() {
+        const errorDetails = this.errors
+            .map((e) => `  Line ${String(e.line)}:${String(e.column)}: ${e.message}`)
+            .join('\n');
+        return `${this.name}: ${this.message} at ${this.filePath}\n${errorDetails}`;
+    }
+}
+export class BpmnLintError extends Error {
+    filePath;
+    results;
+    constructor(message, filePath, results) {
+        super(message);
+        this.filePath = filePath;
+        this.results = results;
+        this.name = 'BpmnLintError';
+    }
+    toString() {
+        const errorDetails = this.results
+            .map((r) => `  [${r.category}] ${r.id}: ${r.message} (${r.rule})`)
+            .join('\n');
+        return `${this.name}: ${this.message} at ${this.filePath}\n${errorDetails}`;
+    }
+}
+export function detectBpmnTxtContent(content) {
+    const trimmed = content.trim();
+    return trimmed.startsWith('process:') || trimmed.startsWith('collaboration:');
+}
+export async function parseBpmnTxt(content, filePath, lintLevel = 'warn', lintConfig) {
+    const result = parse(content);
+    if (result.errors.length > 0 || !result.document) {
+        throw new BpmnTxtParseError('Failed to parse bpmn-txt', filePath, result.errors);
+    }
+    const xml = await toBpmnXmlAsync(result.document, { includeDiagram: true });
+    let lintResults = [];
+    if (lintLevel !== 'off') {
+        lintResults = await lint(xml, lintConfig);
+        if (lintLevel === 'error') {
+            const errors = lintResults.filter((r) => r.category === 'error');
+            if (errors.length > 0) {
+                throw new BpmnLintError('BPMN lint errors found', filePath, errors);
+            }
+        }
+    }
+    return { xml, lintResults };
+}
+//# sourceMappingURL=bpmn-txt.parser.js.map

package/dist/adapters/parsers/bpmn-txt.parser.js.map

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

package/dist/adapters/parsers/bpmn-txt.parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bpmn-txt.parser.test.d.ts.map

package/dist/adapters/parsers/bpmn-txt.parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn-txt.parser.test.d.ts","sourceRoot":"","sources":["../../../src/adapters/parsers/bpmn-txt.parser.test.ts"],"names":[],"mappings":""}

package/dist/adapters/parsers/bpmn-txt.parser.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from 'vitest';
+import { detectBpmnTxtContent, parseBpmnTxt, BpmnTxtParseError } from './bpmn-txt.parser.js';
+describe('bpmn-txt.parser', () => {
+    describe('detectBpmnTxtContent', () => {
+        it('detects process: prefix', () => {
+            expect(detectBpmnTxtContent('process: my-process\n')).toBe(true);
+        });
+        it('detects collaboration: prefix', () => {
+            expect(detectBpmnTxtContent('collaboration: my-collab\n')).toBe(true);
+        });
+        it('handles whitespace before content', () => {
+            expect(detectBpmnTxtContent('  \n  process: test\n')).toBe(true);
+        });
+        it('returns false for XML content', () => {
+            expect(detectBpmnTxtContent('<?xml version="1.0"?>\n<bpmn:definitions')).toBe(false);
+        });
+        it('returns false for file paths', () => {
+            expect(detectBpmnTxtContent('/bpmn/checkout.bpmn')).toBe(false);
+        });
+        it('returns false for empty content', () => {
+            expect(detectBpmnTxtContent('')).toBe(false);
+        });
+    });
+    describe('parseBpmnTxt', () => {
+        it('parses valid bpmn-txt to XML', async () => {
+            const input = `process: test
+  start: begin
+    -> finish
+  end: finish
+`;
+            const result = await parseBpmnTxt(input, 'test.bpmn.txt', 'off');
+            expect(result.xml).toContain('<?xml');
+            expect(result.xml).toContain('bpmn:definitions');
+            expect(result.xml).toContain('bpmn:startEvent');
+            expect(result.xml).toContain('bpmn:endEvent');
+        });
+        it('returns lint results when linting enabled', async () => {
+            const input = `process: test
+  task: lonely-task
+    name: "No connections"
+`;
+            const result = await parseBpmnTxt(input, 'test.bpmn.txt', 'warn');
+            expect(result.lintResults.length).toBeGreaterThan(0);
+        });
+        it('skips linting when lint level is off', async () => {
+            const input = `process: test
+  task: lonely-task
+`;
+            const result = await parseBpmnTxt(input, 'test.bpmn.txt', 'off');
+            expect(result.lintResults).toHaveLength(0);
+        });
+        it('throws BpmnTxtParseError for invalid syntax', async () => {
+            const input = `invalid syntax here`;
+            await expect(parseBpmnTxt(input, 'bad.bpmn.txt', 'off')).rejects.toThrow(BpmnTxtParseError);
+        });
+        it('includes file path in parse error', async () => {
+            const input = `process: test
+  invalid-keyword: foo
+`;
+            try {
+                await parseBpmnTxt(input, 'my-file.bpmn.txt', 'off');
+                expect.fail('Should have thrown');
+            }
+            catch (e) {
+                expect(e).toBeInstanceOf(BpmnTxtParseError);
+                expect(e.filePath).toBe('my-file.bpmn.txt');
+            }
+        });
+    });
+});
+//# sourceMappingURL=bpmn-txt.parser.test.js.map

package/dist/adapters/parsers/bpmn-txt.parser.test.js.map

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

package/dist/adapters/parsers/markdown.parser.d.ts

@@ -0,0 +1,22 @@
+import type { UseCase, Participant, Step, DocLink, ServiceRef } from '../../domain/use-case.js';
+export interface ParsedUseCaseMarkdown {
+    frontmatter: {
+        id: string;
+        name: string;
+        domain?: string;
+        participants?: Participant[];
+    };
+    bpmnBlocks: string[];
+    content: string;
+    description: string;
+}
+/** Parse use-case.md — pure string parsing, no I/O */
+export declare function parseUseCaseMarkdown(raw: string): ParsedUseCaseMarkdown;
+/** Convert parsed markdown to UseCase domain object */
+export declare function markdownToUseCase(parsed: ParsedUseCaseMarkdown, options?: {
+    bpmnXml?: string;
+    docLinks?: DocLink[];
+    serviceRefs?: ServiceRef[];
+    steps?: Step[];
+}): UseCase;
+//# sourceMappingURL=markdown.parser.d.ts.map

package/dist/adapters/parsers/markdown.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.parser.d.ts","sourceRoot":"","sources":["../../../src/adapters/parsers/markdown.parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAIhG,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA4BvE;AAcD,uDAAuD;AACvD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB,GACA,OAAO,CAyCT"}

package/dist/adapters/parsers/markdown.parser.js

@@ -0,0 +1,85 @@
+import matter from 'gray-matter';
+import { TypeCompiler } from '@sinclair/typebox/compiler';
+import { UseCaseMarkdownFrontmatterSchema } from '../../schemas/use-case.schema.js';
+const FrontmatterCheck = TypeCompiler.Compile(UseCaseMarkdownFrontmatterSchema);
+const BPMN_FENCE_RE = /```bpmn\s*\n([\s\S]*?)```/g;
+/** Parse use-case.md — pure string parsing, no I/O */
+export function parseUseCaseMarkdown(raw) {
+    const { data, content: bodyWithBpmn } = matter(raw);
+    if (!FrontmatterCheck.Check(data)) {
+        const errors = [...FrontmatterCheck.Errors(data)];
+        const msg = errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+        throw new Error(`Invalid use-case.md frontmatter: ${msg}`);
+    }
+    // Extract bpmn fenced blocks
+    const bpmnBlocks = [];
+    let match;
+    while ((match = BPMN_FENCE_RE.exec(bodyWithBpmn)) !== null) {
+        if (match[1] !== undefined)
+            bpmnBlocks.push(match[1]);
+    }
+    // Strip bpmn blocks from content
+    const content = bodyWithBpmn.replace(BPMN_FENCE_RE, '').trim();
+    // Extract description: first paragraph or # Overview section
+    const description = extractDescription(content);
+    return {
+        frontmatter: data,
+        bpmnBlocks,
+        content,
+        description,
+    };
+}
+function extractDescription(content) {
+    // Try # Overview section first
+    const overviewMatch = /^#\s+Overview\s*\n([\s\S]*?)(?=\n#\s|\n$|$)/m.exec(content);
+    if (overviewMatch?.[1]) {
+        return overviewMatch[1].trim();
+    }
+    // Fallback: first paragraph (text before first blank line or heading)
+    const firstPara = /^([^\n#][^\n]*(?:\n(?![#\n])[^\n]*)*)/.exec(content);
+    return firstPara?.[1]?.trim() ?? '';
+}
+/** Convert parsed markdown to UseCase domain object */
+export function markdownToUseCase(parsed, options) {
+    const { frontmatter, content, description } = parsed;
+    // Derive participants from service refs
+    const derivedParticipants = [];
+    if (options?.serviceRefs) {
+        const seen = new Set();
+        for (const ref of options.serviceRefs) {
+            if (!seen.has(ref.serviceId)) {
+                seen.add(ref.serviceId);
+                derivedParticipants.push({
+                    service: ref.serviceId,
+                    role: 'bpmn-participant',
+                });
+            }
+        }
+    }
+    // Merge: frontmatter participants override derived ones
+    const overrides = frontmatter.participants ?? [];
+    const overrideServices = new Set(overrides.map((p) => p.service));
+    const participants = [
+        ...derivedParticipants.filter((p) => !overrideServices.has(p.service)),
+        ...overrides,
+    ];
+    const useCase = {
+        id: frontmatter.id,
+        name: frontmatter.name,
+        description,
+        participants,
+        steps: options?.steps ?? [],
+    };
+    if (frontmatter.domain)
+        useCase.domain = frontmatter.domain;
+    if (options?.bpmnXml)
+        useCase.bpmn = options.bpmnXml;
+    if (content)
+        useCase.content = content;
+    if (options?.docLinks?.length)
+        useCase.docLinks = options.docLinks;
+    if (options?.serviceRefs?.length)
+        useCase.serviceRefs = options.serviceRefs;
+    return useCase;
+}
+//# sourceMappingURL=markdown.parser.js.map

package/dist/adapters/parsers/markdown.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.parser.js","sourceRoot":"","sources":["../../../src/adapters/parsers/markdown.parser.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAGpF,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAchF,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAEnD,sDAAsD;AACtD,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAEpD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,6BAA6B;IAC7B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/D,6DAA6D;IAC7D,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,UAAU;QACV,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,+BAA+B;IAC/B,MAAM,aAAa,GAAG,8CAA8C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnF,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,sEAAsE;IACtE,MAAM,SAAS,GAAG,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxE,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAC/B,MAA6B,EAC7B,OAKC;IAED,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAErD,wCAAwC;IACxC,MAAM,mBAAmB,GAAkB,EAAE,CAAC;IAC9C,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxB,mBAAmB,CAAC,IAAI,CAAC;oBACvB,OAAO,EAAE,GAAG,CAAC,SAAS;oBACtB,IAAI,EAAE,kBAAkB;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC;IACjD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG;QACnB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtE,GAAG,SAAS;KACb,CAAC;IAEF,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,WAAW;QACX,YAAY;QACZ,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;KAC5B,CAAC;IAEF,IAAI,WAAW,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAC5D,IAAI,OAAO,EAAE,OAAO;QAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IACrD,IAAI,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IACvC,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM;QAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnE,IAAI,OAAO,EAAE,WAAW,EAAE,MAAM;QAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAE5E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/adapters/parsers/markdown.parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdown.parser.test.d.ts.map

package/dist/adapters/parsers/markdown.parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.parser.test.d.ts","sourceRoot":"","sources":["../../../src/adapters/parsers/markdown.parser.test.ts"],"names":[],"mappings":""}