parser-combinators 1.1.2 → 1.2.0

package/{parsers → dist/parsers}/values.d.ts

@@ -1,28 +1,31 @@
-import { Parser } from '../types';
-/** Parses 0 or more spaces
- */
-export declare const spaces: Parser<string>;
-/** Parses 1 or more spaces
- */
-export declare const spacesPlus: Parser<string>;
-/** Parses 0 or more whitespace characters
- */
-export declare const wspaces: Parser<string | null>;
-/** Parses a boolean (true or false) and returns a string
- */
-export declare const bool: Parser<'true' | 'false'>;
-/** Parses a boolean (true or false) and returns a boolean
- */
-export declare const boolP: Parser<boolean>;
-/** Parses an integer and returns a string
- */
-export declare const int: Parser<string>;
-/** Parses an integer and returns a number
- */
-export declare const intP: Parser<number>;
-/** Parses a standard real number (X.X) and returns a string
- */
-export declare const real: Parser<`${number}.${number}`>;
-/** Parses a standard real number (X.X) and returns a number
- */
-export declare const realP: Parser<number>;
+import { Parser } from '../types';
+/** Parses 0 or more spaces
+ */
+export declare const spaces: Parser<string>;
+/** Parses 1 or more spaces
+ */
+export declare const spacesPlus: Parser<string>;
+/** Parses 0 or more whitespace characters
+ */
+export declare const wspaces: Parser<string | null>;
+/** Parses a boolean (true or false) and returns a string
+ */
+export declare const bool: Parser<'true' | 'false'>;
+/** Parses a boolean (true or false) and returns a boolean
+ */
+export declare const boolP: Parser<boolean>;
+/** Parses an integer and returns a string
+ */
+export declare const int: Parser<string>;
+/** Parses an integer and returns a number
+ */
+export declare const intP: Parser<number>;
+/** Parses a standard real number (X.X) and returns a string
+ */
+export declare const real: Parser<`${number}.${number}`>;
+/** Parses a standard real number (X.X) and returns a number
+ */
+export declare const realP: Parser<number>;
+/** Parses an end of text/file. Fails if the parser is not at the end.
+ */
+export declare const eof: Parser<void>;

package/{parsers → dist/parsers}/values.js

@@ -1,36 +1,48 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.realP = exports.real = exports.intP = exports.int = exports.boolP = exports.bool = exports.wspaces = exports.spacesPlus = exports.spaces = void 0;
-const map_1 = require("./map");
-const opt_1 = require("./opt");
-const regex_1 = require("./regex");
-const seq_1 = require("./seq");
-const str_1 = require("./str");
-const utilities_1 = require("./utilities");
-/** Parses 0 or more spaces
- */
-exports.spaces = (0, regex_1.regex)(/ */, 'spaces');
-/** Parses 1 or more spaces
- */
-exports.spacesPlus = (0, regex_1.regex)(/ +/, 'spaces');
-/** Parses 0 or more whitespace characters
- */
-exports.wspaces = (0, opt_1.opt)((0, regex_1.regex)(/(?:\s|\t|\n|\r)+/, 'whitespace characters'));
-/** Parses a boolean (true or false) and returns a string
- */
-exports.bool = (0, regex_1.regex)(/true|false/, 'boolean');
-/** Parses a boolean (true or false) and returns a boolean
- */
-exports.boolP = (0, map_1.map)(exports.bool, val => val === 'true');
-/** Parses an integer and returns a string
- */
-exports.int = (0, regex_1.regex)(/\d+/, 'integer');
-/** Parses an integer and returns a number
- */
-exports.intP = (0, map_1.map)(exports.int, seq => parseInt(seq, 10));
-/** Parses a standard real number (X.X) and returns a string
- */
-exports.real = (0, utilities_1.expect)((0, map_1.map)((0, seq_1.seq)(exports.int, (0, str_1.str)('.'), exports.int), ([intPart, , decimalPart]) => `${intPart}.${decimalPart}`), 'real');
-/** Parses a standard real number (X.X) and returns a number
- */
-exports.realP = (0, map_1.map)(exports.real, (seq) => parseFloat(seq));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eof = exports.realP = exports.real = exports.intP = exports.int = exports.boolP = exports.bool = exports.wspaces = exports.spacesPlus = exports.spaces = void 0;
+const types_1 = require("../types");
+const map_1 = require("./map");
+const opt_1 = require("./opt");
+const regex_1 = require("./regex");
+const seq_1 = require("./seq");
+const str_1 = require("./str");
+const utilities_1 = require("./utilities");
+/** Parses 0 or more spaces
+ */
+exports.spaces = (0, regex_1.regex)(/ */, 'spaces');
+/** Parses 1 or more spaces
+ */
+exports.spacesPlus = (0, regex_1.regex)(/ +/, 'spaces');
+/** Parses 0 or more whitespace characters
+ */
+exports.wspaces = (0, opt_1.opt)((0, regex_1.regex)(/(?:\s|\t|\n|\r)+/, 'whitespace characters'));
+/** Parses a boolean (true or false) and returns a string
+ */
+exports.bool = (0, regex_1.regex)(/true|false/, 'boolean');
+/** Parses a boolean (true or false) and returns a boolean
+ */
+exports.boolP = (0, map_1.map)(exports.bool, val => val === 'true');
+/** Parses an integer and returns a string
+ */
+exports.int = (0, regex_1.regex)(/\d+/, 'integer');
+/** Parses an integer and returns a number
+ */
+exports.intP = (0, map_1.map)(exports.int, seq => parseInt(seq, 10));
+/** Parses a standard real number (X.X) and returns a string
+ */
+exports.real = (0, utilities_1.expect)((0, map_1.map)((0, seq_1.seq)(exports.int, (0, str_1.str)('.'), exports.int), ([intPart, , decimalPart]) => `${intPart}.${decimalPart}`), 'real');
+/** Parses a standard real number (X.X) and returns a number
+ */
+exports.realP = (0, map_1.map)(exports.real, (seq) => parseFloat(seq));
+/** Parses an end of text/file. Fails if the parser is not at the end.
+ */
+const eof = (ctx) => {
+    if (ctx.index === ctx.text.length) {
+        return (0, types_1.success)(ctx, void 0);
+    }
+    else {
+        return (0, types_1.failure)(ctx, "End Of File", ["EOF"]);
+    }
+};
+exports.eof = eof;

package/{types.d.ts → dist/types.d.ts}

@@ -1,33 +1,40 @@
-export declare type Parser<T> = (ctx: Context) => Result<T>;
-export declare type Context = Readonly<{
-    text: string;
-    path: string;
-    index: number;
-}>;
-export declare type Result<T> = Success<T> | Failure;
-export declare type Success<T> = Readonly<{
-    success: true;
-    value: T;
-    ctx: Context;
-}>;
-export declare type Failure = Readonly<{
-    success: false;
-    expected: string;
-    ctx: Context;
-    history: string[];
-}>;
-export declare function isFailure(input: unknown): input is Failure;
-export declare function success<T>(ctx: Context, value: T): Success<T>;
-export declare function failure(ctx: Context, expected: string, history: string[]): Failure;
-export declare function result<T>(value: T): Parser<T>;
-export declare function fail<T>(reason: string): Parser<T>;
-export declare class ParseError extends Error {
-    readonly index: number;
-    readonly history: string[];
-    readonly line: string;
-    readonly column: number;
-    readonly row: number;
-    constructor(message: string, input: string, index: number, history: string[]);
-    private getInputData;
-    getPrettyErrorMessage(): string;
-}
+export type Parser<T> = (ctx: Context) => Result<T>;
+export type Context = Readonly<{
+    text: string;
+    path: string;
+    index: number;
+}>;
+export type Result<T> = Success<T> | Failure;
+export type Success<T> = Readonly<{
+    success: true;
+    value: T;
+    ctx: Context;
+}>;
+export type Failure = Readonly<{
+    success: false;
+    expected: string;
+    ctx: Context;
+    history: string[];
+}>;
+export type TokenRange = {
+    start: number;
+    end: number;
+};
+export type Token<T> = TokenRange & {
+    value: T;
+};
+export declare function isFailure(input: unknown): input is Failure;
+export declare function success<T>(ctx: Context, value: T): Success<T>;
+export declare function failure(ctx: Context, expected: string, history: string[]): Failure;
+export declare function result<T>(value: T): Parser<T>;
+export declare function fail<T>(reason: string): Parser<T>;
+export declare class ParseError extends Error {
+    readonly index: number;
+    readonly history: string[];
+    readonly line: string;
+    readonly column: number;
+    readonly row: number;
+    constructor(message: string, input: string, index: number, history: string[]);
+    private getInputData;
+    getPrettyErrorMessage(): string;
+}

package/{types.js → dist/types.js}

@@ -1,47 +1,47 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ParseError = exports.fail = exports.result = exports.failure = exports.success = exports.isFailure = void 0;
-function isFailure(input) {
-    return !input.success;
-}
-exports.isFailure = isFailure;
-function success(ctx, value) {
-    return { success: true, value, ctx };
-}
-exports.success = success;
-function failure(ctx, expected, history) {
-    return { success: false, expected, ctx, history };
-}
-exports.failure = failure;
-function result(value) {
-    return (ctx) => success(ctx, value);
-}
-exports.result = result;
-function fail(reason) {
-    return (ctx) => failure(ctx, reason, [reason]);
-}
-exports.fail = fail;
-class ParseError extends Error {
-    constructor(message, input, index, history) {
-        super(message);
-        this.index = index;
-        this.history = history;
-        [this.line, this.column, this.row] = this.getInputData(input, index);
-    }
-    getInputData(input, index) {
-        const lines = input.split('\n');
-        let row = 0;
-        while (index > 0) {
-            if (lines[row].length > index) {
-                return [lines[row], index + 1, row + 1];
-            }
-            index -= lines[row].length + 1;
-            row += 1;
-        }
-        return [lines[row], index + 1, row + 1];
-    }
-    getPrettyErrorMessage() {
-        return `${this.message} (line ${this.row}, col ${this.column})\n${this.line}\n${(this.column ? ' '.repeat(this.column - 1) : '') + '^'}`;
-    }
-}
-exports.ParseError = ParseError;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseError = void 0;
+exports.isFailure = isFailure;
+exports.success = success;
+exports.failure = failure;
+exports.result = result;
+exports.fail = fail;
+function isFailure(input) {
+    return !input.success;
+}
+function success(ctx, value) {
+    return { success: true, value, ctx };
+}
+function failure(ctx, expected, history) {
+    return { success: false, expected, ctx, history };
+}
+function result(value) {
+    return (ctx) => success(ctx, value);
+}
+function fail(reason) {
+    return (ctx) => failure(ctx, reason, [reason]);
+}
+class ParseError extends Error {
+    constructor(message, input, index, history) {
+        super(message);
+        this.index = index;
+        this.history = history;
+        [this.line, this.column, this.row] = this.getInputData(input, index);
+    }
+    getInputData(input, index) {
+        const lines = input.split('\n');
+        let row = 0;
+        while (index > 0) {
+            if (lines[row].length > index) {
+                return [lines[row], index + 1, row + 1];
+            }
+            index -= lines[row].length + 1;
+            row += 1;
+        }
+        return [lines[row], index + 1, row + 1];
+    }
+    getPrettyErrorMessage() {
+        return `${this.message} (line ${this.row}, col ${this.column}):\n${this.line}\n${(this.column > 0 ? '-'.repeat(this.column - 1) : '') + '^'}`;
+    }
+}
+exports.ParseError = ParseError;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "parser-combinators",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "license": "ISC",
   "maintainers": [
     "Micha_i"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/michalusio/Parser.git"
+    "url": "git+https://github.com/michalusio/Parser.git"
   },
   "bugs": {
     "url": "https://github.com/michalusio/Parser/issues"
@@ -16,33 +16,31 @@
   "description": "A library of parser combinators, with which you can create your own parsers. The library will be continuously improved in time.",
   "scripts": {
     "build": "tsc",
-    "publishing:prepare": "copy package.json dist && copy README.md dist",
-    "publishing:patch": "npm version patch && npm run publishing:prepare",
-    "publishing:minor": "npm version minor && npm run publishing:prepare",
-    "publishing:major": "npm version major && npm run publishing:prepare",
     "start": "tsc && node .",
     "lint": "eslint . --ext .ts",
-    "test:unit": "cross-env TS_NODE_PROJECT=tsconfig.spec.json mocha",
-    "test": "nyc -e '.ts' --r html -r lcov -r text npm run test:unit",
-    "test:report": "nyc report --reporter=json > coverage/coverage.json && codecov"
+    "test:mutate": "stryker run",
+    "test:unit": "mocha",
+    "test": "nyc -e '.ts' --r html -r lcov -r text npm run test:unit"
   },
   "author": "Micha_i <isalski.michal@gmail.com> (https://github.com/michalusio)",
-  "main": "./parser.js",
-  "types": "./parser.d.ts",
-  "dependencies": {},
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
   "devDependencies": {
-    "@types/mocha": "^9.0.0",
-    "@types/node": "^16.7.6",
-    "@typescript-eslint/eslint-plugin": "^4.14.2",
-    "@typescript-eslint/parser": "^4.14.2",
-    "codecov": "^3.8.3",
-    "cross-env": "^7.0.3",
-    "eslint": "^7.15.0",
-    "istanbul": "1.1.0-alpha.1",
-    "mocha": "^9.1.0",
-    "nyc": "^15.1.0",
-    "ts-node": "^10.2.1",
-    "typescript": "^4.2.4"
+    "@stryker-mutator/core": "^9.4.0",
+    "@stryker-mutator/mocha-runner": "^9.4.0",
+    "@stryker-mutator/typescript-checker": "^9.4.0",
+    "@types/mocha": "10.0.10",
+    "@types/node": "25.0.6",
+    "cross-env": "10.1.0",
+    "eslint": "9.39.2",
+    "mocha": "11.7.5",
+    "nyc": "17.1.0",
+    "ts-node": "10.9.2",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.52.0"
   },
   "keywords": [
     "parser",

package/parsers/any.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.any = void 0;
-const types_1 = require("../types");
-function any(...parsers) {
-    return (ctx) => {
-        const expected = [];
-        for (const parser of parsers) {
-            const res = parser(ctx);
-            if ((0, types_1.isFailure)(res)) {
-                expected.push(res);
-            }
-            else
-                return res;
-        }
-        const longest = expected.reduce((a, b) => a.ctx.index > b.ctx.index ? a : b);
-        return (0, types_1.failure)(longest.ctx, longest.expected, ['any', ...longest.history]);
-    };
-}
-exports.any = any;

package/parsers/str.d.ts

@@ -1,5 +0,0 @@
-import { Parser } from '../types';
-/** Parses a string and returns it as a result of the parse.
- * @returns A parser parsing a given string.
- */
-export declare function str<T extends string>(match: T): Parser<T>;

package/parsers/str.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.str = void 0;
-const types_1 = require("../types");
-/** Parses a string and returns it as a result of the parse.
- * @returns A parser parsing a given string.
- */
-function str(match) {
-    return (ctx) => {
-        if (ctx.text.startsWith(match, ctx.index)) {
-            return (0, types_1.success)({ ...ctx, index: ctx.index + match.length }, match);
-        }
-        else {
-            return (0, types_1.failure)(ctx, match, [match]);
-        }
-    };
-}
-exports.str = str;

package/parsers/utilities.d.ts

@@ -1,9 +0,0 @@
-import { Parser } from '../types';
-/** Allows to make a condition on the result of the parsing function.
- * @returns A parser returning the same but also performing a given check on the result.
- */
-export declare function ref<T>(parser: Parser<T>, check: ((p: T) => boolean), expected: string): Parser<T>;
-/** Changes the expected value for when the parser fails.
- * @returns A parser returning the same but with a different expected value.
- */
-export declare function expect<T>(parser: Parser<T>, expected: string): Parser<T>;

package/parsers/utilities.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.expect = exports.ref = void 0;
-const types_1 = require("../types");
-/** Allows to make a condition on the result of the parsing function.
- * @returns A parser returning the same but also performing a given check on the result.
- */
-function ref(parser, check, expected) {
-    return (ctx) => {
-        const res = parser(ctx);
-        if (!(0, types_1.isFailure)(res) && !check(res.value)) {
-            return (0, types_1.failure)(res.ctx, expected, [`ref: ${expected}`]);
-        }
-        return res;
-    };
-}
-exports.ref = ref;
-/** Changes the expected value for when the parser fails.
- * @returns A parser returning the same but with a different expected value.
- */
-function expect(parser, expected) {
-    return (ctx) => {
-        const res = parser(ctx);
-        if ((0, types_1.isFailure)(res)) {
-            return (0, types_1.failure)(res.ctx, expected, [expected, ...res.history]);
-        }
-        return res;
-    };
-}
-exports.expect = expect;