@zokugun/regexp 0.3.0

package/lib/esm/types.d.mts

@@ -0,0 +1,231 @@
+export declare enum TokenType {
+    ALTERNATE = "alternate",
+    ANY = "any",
+    BACK_REFERENCE = "back-reference",
+    BACKSPACE = "backspace",
+    BEGIN = "begin",
+    CAPTURE_GROUP = "capture-group",
+    CARRIAGE_RETURN = "carriage-return",
+    CHARSET = "charset",
+    CONTROL = "control",
+    DIGIT = "digit",
+    END = "end",
+    ESCAPE = "escape",
+    FORM_FEED = "form-feed",
+    HEX = "hex",
+    LINE_FEED = "line-feed",
+    LITERAL = "literal",
+    MATCH = "match",
+    MODIFIED_GROUP = "modified-group",
+    MODIFIER = "modifier",
+    NAMED_BACK_REFERENCE = "named-back-reference",
+    NAMED_GROUP = "named-group",
+    NEGATIVE_LOOKAHEAD = "negative-lookahead",
+    NEGATIVE_LOOKBEHIND = "negative-lookbehind",
+    NON_CAPTURE_GROUP = "non-capture-group",
+    NON_DIGIT = "non-digit",
+    NON_UNICODE_PROPERTY = "non-unicode-property",
+    NON_WHITE_SPACE = "non-white-space",
+    NON_WORD = "non-word",
+    NON_WORD_BOUNDARY = "non-word-boundary",
+    NUL = "nul",
+    OCTAL = "octal",
+    PATTERN = "pattern",
+    POSITIVE_LOOKAHEAD = "positive-lookahead",
+    POSITIVE_LOOKBEHIND = "positive-lookbehind",
+    QUANTIFIED = "quantified",
+    QUANTIFIER = "quantifier",
+    RANGE = "range",
+    TAB = "tab",
+    UNICODE = "unicode",
+    UNICODE_PROPERTY = "unicode-property",
+    UTF16 = "utf-16",
+    VERTICAL_TAB = "vertical-tab",
+    WHITE_SPACE = "white-space",
+    WORD = "word",
+    WORD_BOUNDARY = "word-boundary"
+}
+export declare enum Flavor {
+    ES2018 = "es2018"
+}
+export type Modifiers = {
+    positive: string[];
+    negative: string[];
+};
+export type BaseToken = {
+    type: TokenType;
+    body?: Token | Token[];
+};
+export type AlternateToken = BaseToken & {
+    type: TokenType.ALTERNATE;
+    body: Token[];
+};
+export type AnyToken = BaseToken & {
+    type: TokenType.ANY;
+};
+export type BackReferenceToken = BaseToken & {
+    type: TokenType.BACK_REFERENCE;
+    code: string;
+};
+export type BackspaceToken = BaseToken & {
+    type: TokenType.BACKSPACE;
+};
+export type BeginToken = BaseToken & {
+    type: TokenType.BEGIN;
+};
+export type CaptureGroupToken = BaseToken & {
+    type: TokenType.CAPTURE_GROUP;
+    body: Token;
+};
+export type CarriageReturnToken = BaseToken & {
+    type: TokenType.CARRIAGE_RETURN;
+};
+export type CharsetToken = BaseToken & {
+    type: TokenType.CHARSET;
+    body: Token[];
+    negated?: boolean;
+};
+export type ControlToken = BaseToken & {
+    type: TokenType.CONTROL;
+    code: string;
+};
+export type DigitToken = BaseToken & {
+    type: TokenType.DIGIT;
+};
+export type EndToken = BaseToken & {
+    type: TokenType.END;
+};
+export type EscapeToken = BaseToken & {
+    type: TokenType.ESCAPE;
+    code: string;
+};
+export type FormFeedToken = BaseToken & {
+    type: TokenType.FORM_FEED;
+};
+export type HexToken = BaseToken & {
+    type: TokenType.HEX;
+    code: string;
+};
+export type LineFeedToken = BaseToken & {
+    type: TokenType.LINE_FEED;
+};
+export type LiteralToken = BaseToken & {
+    type: TokenType.LITERAL;
+    text: string;
+};
+export type MatchToken = BaseToken & {
+    type: TokenType.MATCH;
+    body: Token[];
+};
+export type ModifiedGroupToken = BaseToken & {
+    type: TokenType.MODIFIED_GROUP;
+    modifiers: Modifiers;
+    body: Token;
+};
+export type ModifierToken = BaseToken & {
+    type: TokenType.MODIFIER;
+    positive: string[];
+    negative: string[];
+};
+export type NamedBackReferenceToken = BaseToken & {
+    type: TokenType.NAMED_BACK_REFERENCE;
+    name: string;
+};
+export type NamedGroupToken = BaseToken & {
+    type: TokenType.NAMED_GROUP;
+    name: string;
+    body: Token;
+};
+export type NegativeLookaheadToken = BaseToken & {
+    type: TokenType.NEGATIVE_LOOKAHEAD;
+    body: Token;
+};
+export type NegativeLookbehindToken = BaseToken & {
+    type: TokenType.NEGATIVE_LOOKBEHIND;
+    body: Token;
+};
+export type NonCaptureGroupToken = BaseToken & {
+    type: TokenType.NON_CAPTURE_GROUP;
+    body: Token;
+};
+export type NonDigitToken = BaseToken & {
+    type: TokenType.NON_DIGIT;
+};
+export type NonUnicodePropertyToken = BaseToken & {
+    type: TokenType.NON_UNICODE_PROPERTY;
+    property: string;
+};
+export type NonWhiteSpaceToken = BaseToken & {
+    type: TokenType.NON_WHITE_SPACE;
+};
+export type NonWordToken = BaseToken & {
+    type: TokenType.NON_WORD;
+};
+export type NonWordBoundaryToken = BaseToken & {
+    type: TokenType.NON_WORD_BOUNDARY;
+};
+export type NulToken = BaseToken & {
+    type: TokenType.NUL;
+};
+export type OctalToken = BaseToken & {
+    type: TokenType.OCTAL;
+    code: string;
+};
+export type PatternToken = BaseToken & {
+    type: TokenType.PATTERN;
+    body: Token;
+    modifiers?: Modifiers;
+};
+export type PositiveLookaheadToken = BaseToken & {
+    type: TokenType.POSITIVE_LOOKAHEAD;
+    body: Token;
+};
+export type PositiveLookbehindToken = BaseToken & {
+    type: TokenType.POSITIVE_LOOKBEHIND;
+    body: Token;
+};
+export type QuantifiedToken = BaseToken & {
+    type: TokenType.QUANTIFIED;
+    body: Token;
+    quantifier: QuantifierToken;
+};
+export type QuantifierToken = BaseToken & {
+    type: TokenType.QUANTIFIER;
+    min: number;
+    max: number;
+};
+export type RangeToken = BaseToken & {
+    type: TokenType.RANGE;
+    begin: Token;
+    end: Token;
+};
+export type TabToken = BaseToken & {
+    type: TokenType.TAB;
+};
+export type UnicodeToken = BaseToken & {
+    type: TokenType.UNICODE;
+    code: string;
+};
+export type UnicodePropertyToken = BaseToken & {
+    type: TokenType.UNICODE_PROPERTY;
+    property: string;
+};
+export type Utf16Token = BaseToken & {
+    type: TokenType.UTF16;
+    code: string;
+};
+export type VerticalTabToken = BaseToken & {
+    type: TokenType.VERTICAL_TAB;
+};
+export type WhiteSpaceToken = BaseToken & {
+    type: TokenType.WHITE_SPACE;
+};
+export type WordToken = BaseToken & {
+    type: TokenType.WORD;
+};
+export type WordBoundaryToken = BaseToken & {
+    type: TokenType.WORD_BOUNDARY;
+};
+export type Token = AlternateToken | AnyToken | BackReferenceToken | BackspaceToken | BeginToken | CaptureGroupToken | CarriageReturnToken | CharsetToken | ControlToken | DigitToken | EndToken | EscapeToken | FormFeedToken | HexToken | LineFeedToken | LiteralToken | MatchToken | ModifiedGroupToken | ModifierToken | NamedBackReferenceToken | NamedGroupToken | NegativeLookaheadToken | NegativeLookbehindToken | NonCaptureGroupToken | NonDigitToken | NonUnicodePropertyToken | NonWhiteSpaceToken | NonWordToken | NonWordBoundaryToken | NulToken | OctalToken | PatternToken | PositiveLookaheadToken | PositiveLookbehindToken | QuantifiedToken | QuantifierToken | RangeToken | TabToken | UnicodeToken | UnicodePropertyToken | Utf16Token | VerticalTabToken | WhiteSpaceToken | WordToken | WordBoundaryToken;
+export type Visitor = (token: Token) => void;
+export type Transformer = (token: Token, parent: Token | null, key: string | null, index: number | null) => void;

package/lib/esm/types.mjs

@@ -0,0 +1,52 @@
+export var TokenType;
+(function (TokenType) {
+    TokenType["ALTERNATE"] = "alternate";
+    TokenType["ANY"] = "any";
+    TokenType["BACK_REFERENCE"] = "back-reference";
+    TokenType["BACKSPACE"] = "backspace";
+    TokenType["BEGIN"] = "begin";
+    TokenType["CAPTURE_GROUP"] = "capture-group";
+    TokenType["CARRIAGE_RETURN"] = "carriage-return";
+    TokenType["CHARSET"] = "charset";
+    TokenType["CONTROL"] = "control";
+    TokenType["DIGIT"] = "digit";
+    TokenType["END"] = "end";
+    TokenType["ESCAPE"] = "escape";
+    TokenType["FORM_FEED"] = "form-feed";
+    TokenType["HEX"] = "hex";
+    TokenType["LINE_FEED"] = "line-feed";
+    TokenType["LITERAL"] = "literal";
+    TokenType["MATCH"] = "match";
+    TokenType["MODIFIED_GROUP"] = "modified-group";
+    TokenType["MODIFIER"] = "modifier";
+    TokenType["NAMED_BACK_REFERENCE"] = "named-back-reference";
+    TokenType["NAMED_GROUP"] = "named-group";
+    TokenType["NEGATIVE_LOOKAHEAD"] = "negative-lookahead";
+    TokenType["NEGATIVE_LOOKBEHIND"] = "negative-lookbehind";
+    TokenType["NON_CAPTURE_GROUP"] = "non-capture-group";
+    TokenType["NON_DIGIT"] = "non-digit";
+    TokenType["NON_UNICODE_PROPERTY"] = "non-unicode-property";
+    TokenType["NON_WHITE_SPACE"] = "non-white-space";
+    TokenType["NON_WORD"] = "non-word";
+    TokenType["NON_WORD_BOUNDARY"] = "non-word-boundary";
+    TokenType["NUL"] = "nul";
+    TokenType["OCTAL"] = "octal";
+    TokenType["PATTERN"] = "pattern";
+    TokenType["POSITIVE_LOOKAHEAD"] = "positive-lookahead";
+    TokenType["POSITIVE_LOOKBEHIND"] = "positive-lookbehind";
+    TokenType["QUANTIFIED"] = "quantified";
+    TokenType["QUANTIFIER"] = "quantifier";
+    TokenType["RANGE"] = "range";
+    TokenType["TAB"] = "tab";
+    TokenType["UNICODE"] = "unicode";
+    TokenType["UNICODE_PROPERTY"] = "unicode-property";
+    TokenType["UTF16"] = "utf-16";
+    TokenType["VERTICAL_TAB"] = "vertical-tab";
+    TokenType["WHITE_SPACE"] = "white-space";
+    TokenType["WORD"] = "word";
+    TokenType["WORD_BOUNDARY"] = "word-boundary";
+})(TokenType || (TokenType = {}));
+export var Flavor;
+(function (Flavor) {
+    Flavor["ES2018"] = "es2018";
+})(Flavor || (Flavor = {}));

package/lib/esm/visit.d.mts

@@ -0,0 +1,2 @@
+import { type Token, type TokenType, type Visitor } from './types.mjs';
+export declare function visit(tokens: Token | Token[] | undefined, callback?: Visitor | Partial<Record<TokenType, Visitor>>): void;

package/lib/esm/visit.mjs

@@ -0,0 +1,32 @@
+export function visit(tokens, callback) {
+    if (typeof callback === 'function') {
+        visitFunc(tokens, callback);
+    }
+    else if (callback) {
+        visitMap(tokens, callback);
+    }
+}
+function visitFunc(tokens, callback) {
+    if (Array.isArray(tokens)) {
+        for (const token of tokens) {
+            callback(token);
+            if ('body' in token && token.body) {
+                visitFunc(token.body, callback);
+            }
+        }
+    }
+    else if (tokens) {
+        callback(tokens);
+        if ('body' in tokens && tokens.body) {
+            visitFunc(tokens.body, callback);
+        }
+    }
+}
+function visitMap(tokens, callbackMap) {
+    visitFunc(tokens, (token) => {
+        const fn = callbackMap[token.type];
+        if (fn) {
+            fn(token);
+        }
+    });
+}

package/package.json

@@ -0,0 +1,115 @@
+{
+	"name": "@zokugun/regexp",
+	"description": "RegExp parser/formatter/visitor/transformer",
+	"version": "0.3.0",
+	"author": {
+		"name": "Baptiste Augrain",
+		"email": "daiyam@zokugun.org"
+	},
+	"license": "MIT",
+	"homepage": "https://github.com/zokugun/node-regexp",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/zokugun/node-regexp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/zokugun/node-regexp/discussions/categories/issue-triage"
+	},
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./lib/esm/index.mjs",
+			"require": "./lib/cjs/index.cjs"
+		}
+	},
+	"main": "lib/cjs/index.cjs",
+	"module": "lib/esm/index.mjs",
+	"typesVersions": {
+		"*": {
+			".": [
+				"./lib/cjs/index.d.cts"
+			]
+		}
+	},
+	"scripts": {
+		"audit:fix": "npm audit fix --min-release-age=0",
+		"build": "npm run clean && npm run build:lib",
+		"build:lib": "tsc-leda generate",
+		"build:package": "tsc-leda update-package && npm run lint:package",
+		"build:peg": "node scripts/compile.js",
+		"ci:lint": "zizmor .",
+		"ci:lint:fix": "zizmor . --fix=all",
+		"clean": "rimraf .src .test lib",
+		"compile:src": "tsc -p src",
+		"compile:test": "tsc -p test",
+		"lint": "xo",
+		"lint:all": "npm audit && npm run lint:package && npm run ci:lint && npm run lint",
+		"lint:fix": "xo --fix",
+		"lint:package": "fixpack || true",
+		"prepack": "npm run build",
+		"prepare": "husky; npm run lint:package",
+		"release": "release-it",
+		"test": "vitest run --reporter tree",
+		"test:coverage": "vitest run --reporter tree --coverage --coverage.reporter text",
+		"test:ui": "vitest --ui --coverage",
+		"test:watch": "vitest",
+		"update:artifacts": "artifact update",
+		"update:ci": "PINACT_MIN_AGE=7 pinact run --update",
+		"update:deps": "taze --all",
+		"watch:build": "tsc-watch -p src --onSuccess 'npm run build'",
+		"watch:src": "tsc-watch -p src",
+		"watch:test": "tsc-watch -p test"
+	},
+	"dependencies": {
+		"@zokugun/is-it-type": "^0.8.1"
+	},
+	"devDependencies": {
+		"@commitlint/cli": "20.5.3",
+		"@commitlint/config-conventional": "20.5.3",
+		"@types/node": "20.19.39",
+		"@vitest/coverage-v8": "4.1.5",
+		"@vitest/ui": "4.1.5",
+		"@zokugun/fs-extra-plus": "0.5.0",
+		"@zokugun/tsc-leda": "0.4.2",
+		"@zokugun/xtry": "0.11.6",
+		"fixpack": "4.0.0",
+		"husky": "9.1.7",
+		"lint-staged": "16.4.0",
+		"pegjs": "0.10.0",
+		"release-it": "20.0.1",
+		"rimraf": "6.1.3",
+		"taze": "19.14.1",
+		"tsc-watch": "7.2.0",
+		"typescript": "5.9.3",
+		"vitest": "4.1.5",
+		"xo": "0.60.0",
+		"yaml": "2.9.0"
+	},
+	"overrides": {
+		"ajv": {
+			"fast-uri": "3.1.2"
+		},
+		"@inquirer/core": {
+			"mute-stream": "3.0.0"
+		}
+	},
+	"keywords": [
+		"ast",
+		"es2018",
+		"formatter",
+		"parse",
+		"parser",
+		"pcre",
+		"pcre2",
+		"regex",
+		"regexp",
+		"regular expression",
+		"stringify",
+		"transform",
+		"transformer",
+		"translate",
+		"translator",
+		"visit",
+		"visitor"
+	]
+}