@ptolemy2002/rgx 8.1.0 → 8.2.0

package/README.md

@@ -17,6 +17,7 @@ Because there is so much to document, it has been broken up into multiple files.
   - [escapeRegex](./docs/util/escapeRegex.md) - The `escapeRegex` function, which escapes special regex characters in a given string and assures you that the result is valid Regex.
   - [regexMatchAtPosition](./docs/util/regexMatchAtPosition.md) - The `regexMatchAtPosition` function and related functions, which attempt to match a given regular expression at a specific position in a string.
   - [regexWithFlags](./docs/util/regexWithFlags.md) - The `regexWithFlags` function, which creates a new regular expression with the same source as a given regular expression but with different flags.
+  - [createRGXClassGuardFunction](./docs/util/createRGXClassGuardFunction.md) - The `createRGXClassGuardFunction` and `createAssertRGXClassGuardFunction` utilities for creating type guard and assertion functions for class instances.
 - `class` - A directory containing documentation for all classes in the library.
   - [collection](./docs/class/collection.md) - The `RGXTokenCollection` class, which is a collection of tokens.
   - [RGXError](./docs/class/RGXError.md) - Details on all custom error classes and the base `RGXError` class.

package/dist/class/group.js

@@ -4,6 +4,7 @@ exports.rgxGroup = exports.RGXGroupToken = void 0;
 const collection_1 = require("../collection");
 const base_1 = require("./base");
 const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 const typeGuards_1 = require("../typeGuards");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
 class RGXGroupToken extends base_1.RGXClassToken {
@@ -60,6 +61,6 @@ class RGXGroupToken extends base_1.RGXClassToken {
     }
 }
 exports.RGXGroupToken = RGXGroupToken;
-RGXGroupToken.check = (0, internal_1.createClassGuardFunction)(RGXGroupToken);
-RGXGroupToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXGroupToken);
+RGXGroupToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXGroupToken);
+RGXGroupToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXGroupToken);
 exports.rgxGroup = (0, internal_1.createConstructFunction)(RGXGroupToken);

package/dist/class/lookahead.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rgxLookahead = exports.RGXLookaheadToken = void 0;
 const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 const lookaround_1 = require("./lookaround");
 const lookbehind_1 = require("./lookbehind");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
@@ -27,6 +28,6 @@ class RGXLookaheadToken extends lookaround_1.RGXLookaroundToken {
     }
 }
 exports.RGXLookaheadToken = RGXLookaheadToken;
-RGXLookaheadToken.check = (0, internal_1.createClassGuardFunction)(RGXLookaheadToken);
-RGXLookaheadToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXLookaheadToken);
+RGXLookaheadToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXLookaheadToken);
+RGXLookaheadToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXLookaheadToken);
 exports.rgxLookahead = (0, internal_1.createConstructFunction)(RGXLookaheadToken);

package/dist/class/lookbehind.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rgxLookbehind = exports.RGXLookbehindToken = void 0;
 const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 const lookahead_1 = require("./lookahead");
 const lookaround_1 = require("./lookaround");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
@@ -27,6 +28,6 @@ class RGXLookbehindToken extends lookaround_1.RGXLookaroundToken {
     }
 }
 exports.RGXLookbehindToken = RGXLookbehindToken;
-RGXLookbehindToken.check = (0, internal_1.createClassGuardFunction)(RGXLookbehindToken);
-RGXLookbehindToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXLookbehindToken);
+RGXLookbehindToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXLookbehindToken);
+RGXLookbehindToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXLookbehindToken);
 exports.rgxLookbehind = (0, internal_1.createConstructFunction)(RGXLookbehindToken);

package/dist/class/repeat.js

@@ -7,6 +7,7 @@ const typeGuards_1 = require("../typeGuards");
 const errors_1 = require("../errors");
 const resolve_1 = require("../resolve");
 const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
 const clone_1 = require("../clone");
 class RGXRepeatToken extends base_1.RGXClassToken {
@@ -98,6 +99,6 @@ class RGXRepeatToken extends base_1.RGXClassToken {
     }
 }
 exports.RGXRepeatToken = RGXRepeatToken;
-RGXRepeatToken.check = (0, internal_1.createClassGuardFunction)(RGXRepeatToken);
-RGXRepeatToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXRepeatToken);
+RGXRepeatToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXRepeatToken);
+RGXRepeatToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXRepeatToken);
 exports.rgxRepeat = (0, internal_1.createConstructFunction)(RGXRepeatToken);

package/dist/class/subpattern.js

@@ -5,6 +5,7 @@ const base_1 = require("./base");
 const typeGuards_1 = require("../typeGuards");
 const errors_1 = require("../errors");
 const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 class RGXSubpatternToken extends base_1.RGXClassToken {
     get pattern() {
         return this._pattern;
@@ -38,6 +39,6 @@ class RGXSubpatternToken extends base_1.RGXClassToken {
     }
 }
 exports.RGXSubpatternToken = RGXSubpatternToken;
-RGXSubpatternToken.check = (0, internal_1.createClassGuardFunction)(RGXSubpatternToken);
-RGXSubpatternToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXSubpatternToken);
+RGXSubpatternToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXSubpatternToken);
+RGXSubpatternToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXSubpatternToken);
 exports.rgxSubpattern = (0, internal_1.createConstructFunction)(RGXSubpatternToken);

package/dist/class/union.js

@@ -7,6 +7,7 @@ const internal_1 = require("../internal");
 const collection_1 = require("../collection");
 const base_1 = require("./base");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
+const utils_1 = require("../utils");
 class RGXClassUnionToken extends base_1.RGXClassToken {
     constructor(tokens = []) {
         super();
@@ -52,8 +53,8 @@ class RGXClassUnionToken extends base_1.RGXClassToken {
     }
 }
 exports.RGXClassUnionToken = RGXClassUnionToken;
-RGXClassUnionToken.check = (0, internal_1.createClassGuardFunction)(RGXClassUnionToken);
-RGXClassUnionToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXClassUnionToken);
+RGXClassUnionToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXClassUnionToken);
+RGXClassUnionToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXClassUnionToken);
 function expandRgxUnionTokens(...tokens) {
     const result = new collection_1.RGXTokenCollection();
     for (const token of tokens) {

package/dist/class/wrapper.js

@@ -6,6 +6,7 @@ const typeGuards_1 = require("../typeGuards");
 const internal_1 = require("../internal");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
 const clone_1 = require("../clone");
+const utils_1 = require("../utils");
 class RGXClassWrapperToken extends base_1.RGXClassToken {
     constructor(token) {
         super();
@@ -33,6 +34,6 @@ class RGXClassWrapperToken extends base_1.RGXClassToken {
     }
 }
 exports.RGXClassWrapperToken = RGXClassWrapperToken;
-RGXClassWrapperToken.check = (0, internal_1.createClassGuardFunction)(RGXClassWrapperToken);
-RGXClassWrapperToken.assert = (0, internal_1.createAssertClassGuardFunction)(RGXClassWrapperToken);
+RGXClassWrapperToken.check = (0, utils_1.createRGXClassGuardFunction)(RGXClassWrapperToken);
+RGXClassWrapperToken.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXClassWrapperToken);
 exports.rgxClassWrapper = (0, internal_1.createConstructFunction)(RGXClassWrapperToken);

package/dist/collection.js

@@ -5,6 +5,7 @@ const resolve_1 = require("./resolve");
 const concat_1 = require("./concat");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
 const internal_1 = require("./internal");
+const utils_1 = require("./utils");
 class RGXTokenCollection {
     constructor(tokens = [], mode = 'concat') {
         this.tokens = [];
@@ -167,6 +168,6 @@ class RGXTokenCollection {
     }
 }
 exports.RGXTokenCollection = RGXTokenCollection;
-RGXTokenCollection.check = (0, internal_1.createClassGuardFunction)(RGXTokenCollection);
-RGXTokenCollection.assert = (0, internal_1.createAssertClassGuardFunction)(RGXTokenCollection);
+RGXTokenCollection.check = (0, utils_1.createRGXClassGuardFunction)(RGXTokenCollection);
+RGXTokenCollection.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXTokenCollection);
 exports.rgxTokenCollection = (0, internal_1.createConstructFunction)(RGXTokenCollection);

package/dist/errors/base.d.ts

@@ -1,4 +1,4 @@
-export type RGXErrorCode = 'UNKNOWN' | 'INVALID_RGX_TOKEN' | 'INVALID_REGEX_STRING' | 'INVALID_REGEX_FLAGS' | 'INVALID_VANILLA_REGEX_FLAGS' | 'NOT_IMPLEMENTED' | 'NOT_SUPPORTED' | 'INVALID_IDENTIFIER' | 'OUT_OF_BOUNDS' | 'INVALID_FLAG_TRANSFORMER_KEY' | 'FLAG_TRANSFORMER_CONFLICT' | 'CONSTANT_CONFLICT' | 'INVALID_CONSTANT_KEY' | 'INSERTION_REJECTED' | 'REGEX_NOT_MATCHED_AT_POSITION' | 'PART_VALIDATION_FAILED' | 'INVALID_LEXER_MODE' | 'LEXEME_NOT_MATCHED_AT_POSITION' | 'INVALID_RGX_LEXER';
+export type RGXErrorCode = 'UNKNOWN' | 'INVALID_RGX_TOKEN' | 'INVALID_REGEX_STRING' | 'INVALID_REGEX_FLAGS' | 'INVALID_VANILLA_REGEX_FLAGS' | 'NOT_IMPLEMENTED' | 'NOT_SUPPORTED' | 'INVALID_IDENTIFIER' | 'OUT_OF_BOUNDS' | 'INVALID_FLAG_TRANSFORMER_KEY' | 'FLAG_TRANSFORMER_CONFLICT' | 'CONSTANT_CONFLICT' | 'INVALID_CONSTANT_KEY' | 'INSERTION_REJECTED' | 'REGEX_NOT_MATCHED_AT_POSITION' | 'PART_VALIDATION_FAILED' | 'INVALID_LEXER_MODE' | 'LEXEME_NOT_MATCHED_AT_POSITION' | 'INVALID_RGX_LEXER' | 'INVALID_RGX_WALKER' | 'INVALID_RGX_PART';
 export declare class RGXError extends Error {
     _message: string;
     code: RGXErrorCode;

package/dist/errors/index.d.ts

@@ -17,3 +17,5 @@ export * from './partValidationFailed';
 export * from './invalidLexerMode';
 export * from './lexemeNotMatchedAtPosition';
 export * from './invalidLexer';
+export * from './invalidWalker';
+export * from './invalidPart';

package/dist/errors/index.js

@@ -33,3 +33,5 @@ __exportStar(require("./partValidationFailed"), exports);
 __exportStar(require("./invalidLexerMode"), exports);
 __exportStar(require("./lexemeNotMatchedAtPosition"), exports);
 __exportStar(require("./invalidLexer"), exports);
+__exportStar(require("./invalidWalker"), exports);
+__exportStar(require("./invalidPart"), exports);

package/dist/errors/invalidPart.d.ts

@@ -0,0 +1,7 @@
+import { RGXError } from "./";
+export declare class RGXInvalidPartError extends RGXError {
+    constructorName: string;
+    got: unknown;
+    constructor(message: string, got: unknown, constructorName?: string);
+    calcMessage(message: string): string;
+}

package/dist/errors/invalidPart.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RGXInvalidPartError = void 0;
+const errors_1 = require("./");
+const class_1 = require("../class");
+class RGXInvalidPartError extends errors_1.RGXError {
+    constructor(message, got, constructorName = "RGXPart") {
+        super(message, 'INVALID_RGX_PART');
+        this.name = 'RGXInvalidPartError';
+        this.got = got;
+        this.constructorName = constructorName;
+    }
+    calcMessage(message) {
+        const gotString = class_1.RGXClassToken.check(this.got) ? `instance of ${this.got.constructor.name}` : JSON.stringify(this.got);
+        return `${message}; Expected: [instance of ${this.constructorName}]; Got: [${gotString}]`;
+    }
+}
+exports.RGXInvalidPartError = RGXInvalidPartError;

package/dist/errors/invalidWalker.d.ts

@@ -0,0 +1,7 @@
+import { RGXError } from "./";
+export declare class RGXInvalidWalkerError extends RGXError {
+    constructorName: string;
+    got: unknown;
+    constructor(message: string, got: unknown, constructorName?: string);
+    calcMessage(message: string): string;
+}

package/dist/errors/invalidWalker.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RGXInvalidWalkerError = void 0;
+const errors_1 = require("./");
+const class_1 = require("../class");
+class RGXInvalidWalkerError extends errors_1.RGXError {
+    constructor(message, got, constructorName = "RGXWalker") {
+        super(message, 'INVALID_RGX_WALKER');
+        this.name = 'RGXInvalidWalkerError';
+        this.got = got;
+        this.constructorName = constructorName;
+    }
+    calcMessage(message) {
+        const gotString = class_1.RGXClassToken.check(this.got) ? `instance of ${this.got.constructor.name}` : JSON.stringify(this.got);
+        return `${message}; Expected: [instance of ${this.constructorName}]; Got: [${gotString}]`;
+    }
+}
+exports.RGXInvalidWalkerError = RGXInvalidWalkerError;

package/dist/internal/index.d.ts

@@ -1,5 +1,4 @@
 export * from "./createConstructFunction";
-export * from "./createClassGuardFunction";
 export * from "./taggedTemplateToArray";
 export * from "./isConstructor";
 export * from "./getProxy";

package/dist/internal/index.js

@@ -15,7 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./createConstructFunction"), exports);
-__exportStar(require("./createClassGuardFunction"), exports);
 __exportStar(require("./taggedTemplateToArray"), exports);
 __exportStar(require("./isConstructor"), exports);
 __exportStar(require("./getProxy"), exports);

package/dist/lexer/base.js

@@ -6,7 +6,7 @@ const resolve_1 = require("../resolve");
 const errors_1 = require("../errors");
 const walker_1 = require("../walker");
 const utils_1 = require("../utils");
-const internal_1 = require("../internal");
+const utils_2 = require("../utils");
 const constants_1 = require("../constants");
 function rgxLexemeLocationFromIndex(source, index) {
     (0, errors_1.assertInRange)(index, { min: 0, max: source.length }, "index is outside the bounds of the source string");
@@ -192,7 +192,7 @@ class RGXLexer {
     }
 }
 exports.RGXLexer = RGXLexer;
-RGXLexer.check = (0, internal_1.createClassGuardFunction)(RGXLexer);
-RGXLexer.assert = (0, internal_1.createAssertClassGuardFunction)(RGXLexer, (value, c) => new errors_1.RGXInvalidLexerError("Invalid Lexer", value, c.name));
+RGXLexer.check = (0, utils_2.createRGXClassGuardFunction)(RGXLexer);
+RGXLexer.assert = (0, utils_2.createAssertRGXClassGuardFunction)(RGXLexer, (value, c) => new errors_1.RGXInvalidLexerError("Invalid Lexer", value, c.name));
 const rgxLexer = (...args) => new RGXLexer(...args);
 exports.rgxLexer = rgxLexer;

package/dist/utils/createRGXClassGuardFunction.d.ts

@@ -0,0 +1,3 @@
+import { RGXError } from "../errors";
+export declare function createRGXClassGuardFunction<T extends new (...args: unknown[]) => unknown>(constructor: T): (value: unknown) => value is InstanceType<T>;
+export declare function createAssertRGXClassGuardFunction<T extends new (...args: unknown[]) => unknown>(constructor: T, constructError?: (value: unknown, constructor: T) => RGXError): (value: unknown) => asserts value is InstanceType<T>;

package/dist/utils/createRGXClassGuardFunction.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRGXClassGuardFunction = createRGXClassGuardFunction;
+exports.createAssertRGXClassGuardFunction = createAssertRGXClassGuardFunction;
+const errors_1 = require("../errors");
+function createRGXClassGuardFunction(constructor) {
+    return (value) => value instanceof constructor;
+}
+function createAssertRGXClassGuardFunction(constructor, constructError = (value, constructor) => new errors_1.RGXInvalidTokenError("Invalid token type", { type: "custom", values: [`instance of ${constructor.name}`] }, value)) {
+    return (value) => {
+        if (!(value instanceof constructor)) {
+            throw constructError(value, constructor);
+        }
+    };
+}

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./regexMatchAtPosition";
 export * from "./regexWithFlags";
 export * from "./normalizeRegexFlags";
+export * from "./createRGXClassGuardFunction";

package/dist/utils/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./regexMatchAtPosition"), exports);
 __exportStar(require("./regexWithFlags"), exports);
 __exportStar(require("./normalizeRegexFlags"), exports);
+__exportStar(require("./createRGXClassGuardFunction"), exports);

package/dist/walker/base.js

@@ -10,7 +10,7 @@ const resolve_1 = require("../resolve");
 const utils_1 = require("../utils");
 const typeGuards_1 = require("../typeGuards");
 const class_1 = require("../class");
-const internal_1 = require("../internal");
+const utils_2 = require("../utils");
 function createBranchGroups(tokens) {
     if ((tokens instanceof collection_1.RGXTokenCollection && tokens.mode === "union") ||
         class_1.RGXClassUnionToken.check(tokens))
@@ -214,8 +214,8 @@ class RGXWalker {
     }
 }
 exports.RGXWalker = RGXWalker;
-RGXWalker.check = (0, internal_1.createClassGuardFunction)(RGXWalker);
-RGXWalker.assert = (0, internal_1.createAssertClassGuardFunction)(RGXWalker);
+RGXWalker.check = (0, utils_2.createRGXClassGuardFunction)(RGXWalker);
+RGXWalker.assert = (0, utils_2.createAssertRGXClassGuardFunction)(RGXWalker, (value, constructor) => new errors_1.RGXInvalidWalkerError("Invalid Walker", value, constructor.name));
 function rgxWalker(...args) {
     return new RGXWalker(...args);
 }

package/dist/walker/part.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RGXPart = void 0;
 exports.rgxPart = rgxPart;
-const internal_1 = require("../internal");
+const utils_1 = require("../utils");
 const clone_1 = require("../clone");
 const immutability_utils_1 = require("@ptolemy2002/immutability-utils");
 const errors_1 = require("../errors");
@@ -40,8 +40,8 @@ class RGXPart {
     }
 }
 exports.RGXPart = RGXPart;
-RGXPart.check = (0, internal_1.createClassGuardFunction)(RGXPart);
-RGXPart.assert = (0, internal_1.createAssertClassGuardFunction)(RGXPart);
+RGXPart.check = (0, utils_1.createRGXClassGuardFunction)(RGXPart);
+RGXPart.assert = (0, utils_1.createAssertRGXClassGuardFunction)(RGXPart, (value, constructor) => new errors_1.RGXInvalidPartError("Invalid Part", value, constructor.name));
 function rgxPart(...args) {
     return new RGXPart(...args);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ptolemy2002/rgx",
-    "version": "8.1.0",
+    "version": "8.2.0",
     "private": false,
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/dist/internal/createClassGuardFunction.d.ts

@@ -1,3 +0,0 @@
-import { RGXError } from "../errors";
-export declare function createClassGuardFunction<T extends new (...args: unknown[]) => unknown>(constructor: T): (value: unknown) => value is InstanceType<T>;
-export declare function createAssertClassGuardFunction<T extends new (...args: unknown[]) => unknown>(constructor: T, constructError?: (value: unknown, constructor: T) => RGXError): (value: unknown) => asserts value is InstanceType<T>;

package/dist/internal/createClassGuardFunction.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClassGuardFunction = createClassGuardFunction;
-exports.createAssertClassGuardFunction = createAssertClassGuardFunction;
-const errors_1 = require("../errors");
-function createClassGuardFunction(constructor) {
-    return (value) => value instanceof constructor;
-}
-function createAssertClassGuardFunction(constructor, constructError = (value, constructor) => new errors_1.RGXInvalidTokenError("Invalid token type", { type: "custom", values: [`instance of ${constructor.name}`] }, value)) {
-    return (value) => {
-        if (!(value instanceof constructor)) {
-            throw constructError(value, constructor);
-        }
-    };
-}