@hymarkx/parser 0.0.2

package/dist/index.js

@@ -0,0 +1,100 @@
+import { createDiagnostic } from '@hymarkx/ast';
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { gfmAutolinkLiteralFromMarkdown } from 'mdast-util-gfm-autolink-literal';
+import { gfmStrikethroughFromMarkdown } from 'mdast-util-gfm-strikethrough';
+import { gfmTableFromMarkdown } from 'mdast-util-gfm-table';
+import { gfmTaskListItemFromMarkdown } from 'mdast-util-gfm-task-list-item';
+import { gfmAutolinkLiteral } from 'micromark-extension-gfm-autolink-literal';
+import { gfmStrikethrough } from 'micromark-extension-gfm-strikethrough';
+import { gfmTable } from 'micromark-extension-gfm-table';
+import { gfmTaskListItem } from 'micromark-extension-gfm-task-list-item';
+import { directiveFromMarkdown, directiveTokenizer } from './directives.js';
+import { frontmatterFromMarkdown, frontmatterTokenizer } from './frontmatter.js';
+import { fromMdast } from './from-mdast.js';
+import { interpolationFromMarkdown, interpolationTokenizer } from './interpolation.js';
+import { ParserInternalError } from './internal-error.js';
+import { SourcePositions } from './positions.js';
+import { HMX_VERSION } from './version.js';
+const gfmExtensions = [gfmAutolinkLiteral(), gfmStrikethrough(), gfmTable(), gfmTaskListItem()];
+const directiveExtension = directiveTokenizer();
+const frontmatterExtension = frontmatterTokenizer();
+const interpolationExtension = interpolationTokenizer();
+const gfmMdastExtensions = [
+    gfmAutolinkLiteralFromMarkdown(),
+    gfmStrikethroughFromMarkdown(),
+    gfmTableFromMarkdown(),
+    gfmTaskListItemFromMarkdown(),
+];
+function normalizeSource(source) {
+    const withoutBom = source.charCodeAt(0) === 0xfeff ? source.slice(1) : source;
+    return withoutBom.replace(/\r\n?/g, '\n');
+}
+function failureDiagnostic(error, from, positions) {
+    // Deep nesting overflows the stack inside mdast-util-gfm-autolink-literal, whose tree
+    // transform is recursive. Our own converter is iterative and handles these documents,
+    // so the limit is upstream's, not ours — but it is still a limit, and a user is owed an
+    // explanation rather than a RangeError. Tracked as P2 in BACKLOG.md.
+    if (error instanceof RangeError) {
+        return createDiagnostic({
+            code: 'HMX1002',
+            severity: 'error',
+            message: 'Document is nested too deeply for the Markdown engine to process.',
+            span: positions.span,
+            expected: 'fewer levels of nested block quotes, lists, or other containers',
+        });
+    }
+    const span = error instanceof ParserInternalError ? error.diagnostic.span : positions.span;
+    const detail = error instanceof Error ? error.message : String(error);
+    return createDiagnostic({
+        code: 'HMX5001',
+        severity: 'error',
+        message: `Parser failure in ${from}: ${detail}`,
+        span,
+    });
+}
+/**
+ * Parses CommonMark plus optional granular GFM extensions into the HMX AST.
+ *
+ * This function returns diagnostics instead of throwing for every string input.
+ */
+export function parse(source, options = {}) {
+    const normalizedSource = normalizeSource(source);
+    const positions = new SourcePositions(normalizedSource);
+    const from = options.from ?? '<anonymous>';
+    const diagnostics = [];
+    try {
+        const mdastRoot = fromMarkdown(normalizedSource, {
+            extensions: [
+                ...(options.frontmatter === false ? [] : [frontmatterExtension]),
+                directiveExtension,
+                interpolationExtension,
+                ...(options.gfm === false ? [] : gfmExtensions),
+            ],
+            mdastExtensions: [
+                ...(options.frontmatter === false ? [] : [frontmatterFromMarkdown(positions)]),
+                directiveFromMarkdown(diagnostics, positions),
+                interpolationFromMarkdown(diagnostics, positions),
+                ...(options.gfm === false ? [] : gfmMdastExtensions),
+            ],
+        });
+        return {
+            root: fromMdast(mdastRoot, normalizedSource),
+            diagnostics,
+            source: normalizedSource,
+        };
+    }
+    catch (error) {
+        return {
+            root: {
+                type: 'root',
+                hmxVersion: HMX_VERSION,
+                children: [],
+                position: positions.span,
+            },
+            diagnostics: [failureDiagnostic(error, from, positions)],
+            source: normalizedSource,
+        };
+    }
+}
+export { HMX_VERSION };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/internal-error.d.ts

@@ -0,0 +1,7 @@
+import type { Diagnostic } from '@hymarkx/ast';
+/** Internal parser failure carrying the diagnostic returned by the public API. */
+export declare class ParserInternalError extends Error {
+    readonly diagnostic: Diagnostic;
+    constructor(diagnostic: Diagnostic);
+}
+//# sourceMappingURL=internal-error.d.ts.map

package/dist/internal-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error.d.ts","sourceRoot":"","sources":["../src/internal-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,kFAAkF;AAClF,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAE/B,YAAY,UAAU,EAAE,UAAU,EAIjC;CACF"}

package/dist/internal-error.js

@@ -0,0 +1,10 @@
+/** Internal parser failure carrying the diagnostic returned by the public API. */
+export class ParserInternalError extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.name = 'ParserInternalError';
+        this.diagnostic = diagnostic;
+    }
+}
+//# sourceMappingURL=internal-error.js.map

package/dist/internal-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error.js","sourceRoot":"","sources":["../src/internal-error.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,UAAU,CAAY;IAE/B,YAAY,UAAsB;QAChC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}

package/dist/interpolation.d.ts

@@ -0,0 +1,19 @@
+import type { Diagnostic } from '@hymarkx/ast';
+import type { Extension } from 'mdast-util-from-markdown';
+import type { Construct } from 'micromark-util-types';
+import { SourcePositions } from './positions.js';
+declare module 'micromark-util-types' {
+    interface TokenTypeMap {
+        hmxInterpolation: 'hmxInterpolation';
+        hmxInterpolationMarker: 'hmxInterpolationMarker';
+        hmxInterpolationUnterminated: 'hmxInterpolationUnterminated';
+        hmxInterpolationValue: 'hmxInterpolationValue';
+    }
+}
+/** Creates the text-only interpolation tokenizer. */
+export declare function interpolationTokenizer(): {
+    readonly text: Readonly<Record<123, Construct>>;
+};
+/** Creates mdast handlers for raw interpolation nodes and unterminated recovery. */
+export declare function interpolationFromMarkdown(diagnostics: Diagnostic[], positions: SourcePositions): Extension;
+//# sourceMappingURL=interpolation.d.ts.map

package/dist/interpolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../src/interpolation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EAAkB,SAAS,EAAiB,MAAM,0BAA0B,CAAA;AACxF,OAAO,KAAK,EAAQ,SAAS,EAAS,MAAM,sBAAsB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,YAAY;QACpB,gBAAgB,EAAE,kBAAkB,CAAA;QACpC,sBAAsB,EAAE,wBAAwB,CAAA;QAChD,4BAA4B,EAAE,8BAA8B,CAAA;QAC5D,qBAAqB,EAAE,uBAAuB,CAAA;KAC/C;CACF;AA+HD,qDAAqD;AACrD,wBAAgB,sBAAsB,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;CAAE,CAE5F;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,UAAU,EAAE,EACzB,SAAS,EAAE,eAAe,GACzB,SAAS,CAgDX"}

package/dist/interpolation.js

@@ -0,0 +1,158 @@
+import { createDiagnostic } from '@hymarkx/ast';
+import { SourcePositions } from './positions.js';
+function isLineEnding(code) {
+    return code === -5 || code === -4 || code === -3;
+}
+function interpolationNode(context) {
+    for (let index = context.stack.length - 1; index >= 0; index -= 1) {
+        const node = context.stack[index];
+        if (node?.type === 'interpolation' || node?.type === 'text') {
+            return node;
+        }
+    }
+    throw new TypeError('Expected an open interpolation node');
+}
+const interpolationConstruct = {
+    tokenize(effects, ok, nok) {
+        let interpolationToken;
+        let braceDepth = 0;
+        let quote;
+        let escaped = false;
+        const finishUnterminated = (code) => {
+            if (interpolationToken === undefined) {
+                return nok(code);
+            }
+            interpolationToken.type = 'hmxInterpolationUnterminated';
+            effects.exit('hmxInterpolationUnterminated');
+            return ok(code);
+        };
+        const unterminated = (code) => {
+            effects.exit('hmxInterpolationValue');
+            return finishUnterminated(code);
+        };
+        const inside = (code) => {
+            if (code === null || isLineEnding(code)) {
+                return unterminated(code);
+            }
+            if (quote !== undefined) {
+                effects.consume(code);
+                if (escaped) {
+                    escaped = false;
+                }
+                else if (code === 92) {
+                    escaped = true;
+                }
+                else if (code === quote) {
+                    quote = undefined;
+                }
+                return inside;
+            }
+            if (code === 34 || code === 39) {
+                quote = code;
+                effects.consume(code);
+                return inside;
+            }
+            if (code === 123) {
+                braceDepth += 1;
+                effects.consume(code);
+                return inside;
+            }
+            if (code === 125 && braceDepth > 0) {
+                braceDepth -= 1;
+                effects.consume(code);
+                return inside;
+            }
+            if (code === 125) {
+                effects.exit('hmxInterpolationValue');
+                effects.enter('hmxInterpolationMarker');
+                effects.consume(code);
+                return close;
+            }
+            effects.consume(code);
+            return inside;
+        };
+        const close = (code) => {
+            if (code === 125) {
+                effects.consume(code);
+                effects.exit('hmxInterpolationMarker');
+                effects.exit('hmxInterpolation');
+                return ok;
+            }
+            if (code === null || isLineEnding(code)) {
+                effects.exit('hmxInterpolationMarker');
+                return finishUnterminated(code);
+            }
+            effects.exit('hmxInterpolationMarker');
+            effects.enter('hmxInterpolationValue');
+            return inside(code);
+        };
+        const secondOpening = (code) => {
+            if (code !== 123) {
+                return nok(code);
+            }
+            effects.consume(code);
+            effects.exit('hmxInterpolationMarker');
+            effects.enter('hmxInterpolationValue');
+            return inside;
+        };
+        return (code) => {
+            if (code !== 123) {
+                return nok(code);
+            }
+            interpolationToken = effects.enter('hmxInterpolation');
+            effects.enter('hmxInterpolationMarker');
+            effects.consume(code);
+            return secondOpening;
+        };
+    },
+};
+/** Creates the text-only interpolation tokenizer. */
+export function interpolationTokenizer() {
+    return { text: { 123: interpolationConstruct } };
+}
+/** Creates mdast handlers for raw interpolation nodes and unterminated recovery. */
+export function interpolationFromMarkdown(diagnostics, positions) {
+    const enterInterpolation = function (token) {
+        const openingSpan = {
+            start: positions.pointAt(token.start.offset),
+            end: positions.pointAt(Math.min(token.start.offset + 2, positions.source.length)),
+        };
+        const node = { type: 'interpolation', value: '', openingSpan };
+        this.enter(node, token);
+        this.buffer();
+    };
+    const exitUnterminated = function (token) {
+        const node = interpolationNode(this);
+        node.type = 'text';
+        diagnostics.push(createDiagnostic({
+            code: 'HMX1020',
+            severity: 'error',
+            message: 'Interpolation is not closed.',
+            span: node.openingSpan,
+            expected: 'a closing }} before the end of the line',
+        }));
+        this.resume();
+        node.value = positions.source.slice(token.start.offset, token.end.offset);
+        delete node.openingSpan;
+        this.exit(token);
+    };
+    const exitInterpolation = function (token) {
+        const node = interpolationNode(this);
+        this.resume();
+        const raw = positions.source.slice(token.start.offset, token.end.offset);
+        node.value = node.type === 'interpolation' ? raw.slice(2, -2).trim() : raw;
+        delete node.openingSpan;
+        this.exit(token);
+    };
+    return {
+        enter: {
+            hmxInterpolation: enterInterpolation,
+            hmxInterpolationUnterminated: enterInterpolation,
+        },
+        exit: {
+            hmxInterpolation: exitInterpolation,
+            hmxInterpolationUnterminated: exitUnterminated,
+        },
+    };
+}
+//# sourceMappingURL=interpolation.js.map

package/dist/interpolation.js.map

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

package/dist/positions.d.ts

@@ -0,0 +1,13 @@
+import type { Point, Span } from '@hymarkx/ast';
+/** Indexes normalized source using UTF-16 code units. */
+export declare class SourcePositions {
+    #private;
+    readonly source: string;
+    readonly span: Span;
+    constructor(source: string);
+    /** Returns a 1-based line/column point for a UTF-16 offset. */
+    pointAt(offset: number): Point;
+    /** Derives an offset when an upstream point omitted it. */
+    offsetAt(line: number, column: number): number;
+}
+//# sourceMappingURL=positions.d.ts.map

package/dist/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../src/positions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAE/C,yDAAyD;AACzD,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IAGnB,YAAY,MAAM,EAAE,MAAM,EAczB;IAED,+DAA+D;IAC/D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CA4B7B;IAED,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkB7C;CACF"}

package/dist/positions.js

@@ -0,0 +1,66 @@
+/** Indexes normalized source using UTF-16 code units. */
+export class SourcePositions {
+    source;
+    span;
+    #lineStarts;
+    constructor(source) {
+        this.source = source;
+        const lineStarts = [0];
+        for (let offset = 0; offset < source.length; offset += 1) {
+            if (source.charCodeAt(offset) === 10) {
+                lineStarts.push(offset + 1);
+            }
+        }
+        this.#lineStarts = lineStarts;
+        this.span = {
+            start: this.pointAt(0),
+            end: this.pointAt(source.length),
+        };
+    }
+    /** Returns a 1-based line/column point for a UTF-16 offset. */
+    pointAt(offset) {
+        if (!Number.isInteger(offset) || offset < 0 || offset > this.source.length) {
+            throw new RangeError(`Source offset is out of range: ${offset}`);
+        }
+        let low = 0;
+        let high = this.#lineStarts.length;
+        while (low < high) {
+            const middle = Math.floor((low + high) / 2);
+            const lineStart = this.#lineStarts[middle];
+            if (lineStart !== undefined && lineStart <= offset) {
+                low = middle + 1;
+            }
+            else {
+                high = middle;
+            }
+        }
+        const lineIndex = low - 1;
+        const lineStart = this.#lineStarts[lineIndex];
+        if (lineStart === undefined) {
+            throw new RangeError(`Could not locate source offset: ${offset}`);
+        }
+        return {
+            line: lineIndex + 1,
+            column: offset - lineStart + 1,
+            offset,
+        };
+    }
+    /** Derives an offset when an upstream point omitted it. */
+    offsetAt(line, column) {
+        if (!Number.isInteger(line) || line < 1 || !Number.isInteger(column) || column < 1) {
+            throw new RangeError(`Invalid source point: ${line}:${column}`);
+        }
+        const lineStart = this.#lineStarts[line - 1];
+        if (lineStart === undefined) {
+            throw new RangeError(`Source line is out of range: ${line}`);
+        }
+        const offset = lineStart + column - 1;
+        const nextLineStart = this.#lineStarts[line];
+        const maximum = nextLineStart === undefined ? this.source.length : nextLineStart - 1;
+        if (offset > maximum) {
+            throw new RangeError(`Source column is out of range: ${line}:${column}`);
+        }
+        return offset;
+    }
+}
+//# sourceMappingURL=positions.js.map

package/dist/positions.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** The HMX AST language version emitted by this parser. */
+export declare const HMX_VERSION = "0.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,WAAW,UAAU,CAAA"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** The HMX AST language version emitted by this parser. */
+export const HMX_VERSION = '0.0.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hymarkx/parser",
+  "version": "0.0.2",
+  "description": "Markdown parser producing the HyMarkX (HMX) syntax tree.",
+  "license": "MIT OR Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NAME0x0/HyMarkX.git",
+    "directory": "packages/parser"
+  },
+  "homepage": "https://github.com/NAME0x0/HyMarkX#readme",
+  "bugs": "https://github.com/NAME0x0/HyMarkX/issues",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "dependencies": {
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm-autolink-literal": "^2.0.1",
+    "mdast-util-gfm-strikethrough": "^2.0.0",
+    "mdast-util-gfm-table": "^2.0.0",
+    "mdast-util-gfm-task-list-item": "^2.0.0",
+    "micromark-extension-directive": "^4.0.0",
+    "micromark-extension-frontmatter": "^2.0.0",
+    "micromark-extension-gfm-autolink-literal": "^2.1.0",
+    "micromark-extension-gfm-strikethrough": "^2.1.0",
+    "micromark-extension-gfm-table": "^2.1.1",
+    "micromark-extension-gfm-task-list-item": "^2.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-factory-whitespace": "^2.0.1",
+    "micromark-util-decode-string": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-types": "^2.0.2",
+    "@hymarkx/ast": "0.0.2"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}