@plurnk/plurnk-mimetypes-text-lua 0.1.0

package/dist/generated/LuaParserVisitor.js

@@ -0,0 +1,167 @@
+import { AbstractParseTreeVisitor } from "antlr4ng";
+/**
+ * This interface defines a complete generic visitor for a parse tree produced
+ * by `LuaParser`.
+ *
+ * @param <Result> The return type of the visit operation. Use `void` for
+ * operations with no return type.
+ */
+export class LuaParserVisitor extends AbstractParseTreeVisitor {
+    /**
+     * Visit a parse tree produced by `LuaParser.start_`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitStart_;
+    /**
+     * Visit a parse tree produced by `LuaParser.chunk`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitChunk;
+    /**
+     * Visit a parse tree produced by `LuaParser.block`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitBlock;
+    /**
+     * Visit a parse tree produced by `LuaParser.stat`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitStat;
+    /**
+     * Visit a parse tree produced by `LuaParser.attnamelist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitAttnamelist;
+    /**
+     * Visit a parse tree produced by `LuaParser.attrib`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitAttrib;
+    /**
+     * Visit a parse tree produced by `LuaParser.retstat`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitRetstat;
+    /**
+     * Visit a parse tree produced by `LuaParser.label`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitLabel;
+    /**
+     * Visit a parse tree produced by `LuaParser.funcname`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFuncname;
+    /**
+     * Visit a parse tree produced by `LuaParser.varlist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitVarlist;
+    /**
+     * Visit a parse tree produced by `LuaParser.namelist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitNamelist;
+    /**
+     * Visit a parse tree produced by `LuaParser.explist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitExplist;
+    /**
+     * Visit a parse tree produced by `LuaParser.exp`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitExp;
+    /**
+     * Visit a parse tree produced by `LuaParser.var`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitVar;
+    /**
+     * Visit a parse tree produced by `LuaParser.prefixexp`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitPrefixexp;
+    /**
+     * Visit a parse tree produced by `LuaParser.functioncall`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFunctioncall;
+    /**
+     * Visit a parse tree produced by `LuaParser.args`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitArgs;
+    /**
+     * Visit a parse tree produced by `LuaParser.functiondef`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFunctiondef;
+    /**
+     * Visit a parse tree produced by `LuaParser.funcbody`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFuncbody;
+    /**
+     * Visit a parse tree produced by `LuaParser.parlist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitParlist;
+    /**
+     * Visit a parse tree produced by `LuaParser.tableconstructor`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitTableconstructor;
+    /**
+     * Visit a parse tree produced by `LuaParser.fieldlist`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFieldlist;
+    /**
+     * Visit a parse tree produced by `LuaParser.field`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitField;
+    /**
+     * Visit a parse tree produced by `LuaParser.fieldsep`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitFieldsep;
+    /**
+     * Visit a parse tree produced by `LuaParser.number`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitNumber;
+    /**
+     * Visit a parse tree produced by `LuaParser.string`.
+     * @param ctx the parse tree
+     * @return the visitor result
+     */
+    visitString;
+}
+//# sourceMappingURL=LuaParserVisitor.js.map

package/dist/generated/LuaParserVisitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LuaParserVisitor.js","sourceRoot":"","sources":["../../src/generated/LuaParserVisitor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AA+BpD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAyB,SAAQ,wBAAgC;IAC1E;;;;OAIG;IACH,WAAW,CAAkC;IAC7C;;;;OAIG;IACH,UAAU,CAAiC;IAC3C;;;;OAIG;IACH,UAAU,CAAiC;IAC3C;;;;OAIG;IACH,SAAS,CAAgC;IACzC;;;;OAIG;IACH,gBAAgB,CAAuC;IACvD;;;;OAIG;IACH,WAAW,CAAkC;IAC7C;;;;OAIG;IACH,YAAY,CAAmC;IAC/C;;;;OAIG;IACH,UAAU,CAAiC;IAC3C;;;;OAIG;IACH,aAAa,CAAoC;IACjD;;;;OAIG;IACH,YAAY,CAAmC;IAC/C;;;;OAIG;IACH,aAAa,CAAoC;IACjD;;;;OAIG;IACH,YAAY,CAAmC;IAC/C;;;;OAIG;IACH,QAAQ,CAA+B;IACvC;;;;OAIG;IACH,QAAQ,CAA+B;IACvC;;;;OAIG;IACH,cAAc,CAAqC;IACnD;;;;OAIG;IACH,iBAAiB,CAAwC;IACzD;;;;OAIG;IACH,SAAS,CAAgC;IACzC;;;;OAIG;IACH,gBAAgB,CAAuC;IACvD;;;;OAIG;IACH,aAAa,CAAoC;IACjD;;;;OAIG;IACH,YAAY,CAAmC;IAC/C;;;;OAIG;IACH,qBAAqB,CAA4C;IACjE;;;;OAIG;IACH,cAAc,CAAqC;IACnD;;;;OAIG;IACH,UAAU,CAAiC;IAC3C;;;;OAIG;IACH,aAAa,CAAoC;IACjD;;;;OAIG;IACH,WAAW,CAAkC;IAC7C;;;;OAIG;IACH,WAAW,CAAkC;CAChD"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as TextLua } from "./TextLua.ts";
+export { default } from "./TextLua.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as TextLua } from "./TextLua.js";
+export { default } from "./TextLua.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/grammar/LuaLexer.g4

@@ -0,0 +1,122 @@
+// $antlr-format alignTrailingComments true, columnLimit 150, maxEmptyLinesToKeep 1, reflowComments false, useTab false
+// $antlr-format allowShortRulesOnASingleLine true, allowShortBlocksOnASingleLine true, minEmptyLines 0, alignSemicolons ownLine
+// $antlr-format alignColons trailing, singleLineOverrulesHangingColon true, alignLexerCommands true, alignLabels true, alignTrailers true
+
+lexer grammar LuaLexer;
+
+options {
+    superClass = LuaLexerBase;
+}
+
+// Insert here @header for lexer.
+
+SEMI : ';';
+EQ   : '=';
+
+BREAK    : 'break';
+GOTO     : 'goto';
+DO       : 'do';
+END      : 'end';
+WHILE    : 'while';
+REPEAT   : 'repeat';
+UNTIL    : 'until';
+IF       : 'if';
+THEN     : 'then';
+ELSEIF   : 'elseif';
+ELSE     : 'else';
+FOR      : 'for';
+COMMA    : ',';
+IN       : 'in';
+FUNCTION : 'function';
+LOCAL    : 'local';
+LT       : '<';
+GT       : '>';
+RETURN   : 'return';
+CC       : '::';
+NIL      : 'nil';
+FALSE    : 'false';
+TRUE     : 'true';
+DOT      : '.';
+SQUIG    : '~';
+MINUS    : '-';
+POUND    : '#';
+OP       : '(';
+CP       : ')';
+NOT      : 'not';
+LL       : '<<';
+GG       : '>>';
+AMP      : '&';
+SS       : '//';
+PER      : '%';
+COL      : ':';
+LE       : '<=';
+GE       : '>=';
+AND      : 'and';
+OR       : 'or';
+PLUS     : '+';
+STAR     : '*';
+OCU      : '{';
+CCU      : '}';
+OB       : '[';
+CB       : ']';
+EE       : '==';
+DD       : '..';
+PIPE     : '|';
+CARET    : '^';
+SLASH    : '/';
+DDD      : '...';
+SQEQ     : '~=';
+
+NAME: [a-zA-Z_][a-zA-Z_0-9]*;
+
+NORMALSTRING: '"' ( EscapeSequence | ~('\\' | '"'))* '"';
+
+CHARSTRING: '\'' ( EscapeSequence | ~('\'' | '\\'))* '\'';
+
+LONGSTRING: '[' NESTED_STR ']';
+
+fragment NESTED_STR: '=' NESTED_STR '=' | '[' .*? ']';
+
+INT: Digit+;
+
+HEX: '0' [xX] HexDigit+;
+
+FLOAT: Digit+ '.' Digit* ExponentPart? | '.' Digit+ ExponentPart? | Digit+ ExponentPart;
+
+HEX_FLOAT:
+    '0' [xX] HexDigit+ '.' HexDigit* HexExponentPart?
+    | '0' [xX] '.' HexDigit+ HexExponentPart?
+    | '0' [xX] HexDigit+ HexExponentPart
+;
+
+fragment ExponentPart: [eE] [+-]? Digit+;
+
+fragment HexExponentPart: [pP] [+-]? Digit+;
+
+fragment EscapeSequence:
+    '\\' [abfnrtvz"'|$#\\] // World of Warcraft Lua additionally escapes |$# 
+    | '\\' '\r'? '\n'
+    | DecimalEscape
+    | HexEscape
+    | UtfEscape
+;
+
+fragment DecimalEscape: '\\' Digit | '\\' Digit Digit | '\\' [0-2] Digit Digit;
+
+fragment HexEscape: '\\' 'x' HexDigit HexDigit;
+
+fragment UtfEscape: '\\' 'u{' HexDigit+ '}';
+
+fragment Digit: [0-9];
+
+fragment HexDigit: [0-9a-fA-F];
+
+fragment SingleLineInputCharacter: ~[\r\n\u0085\u2028\u2029];
+
+COMMENT: '--' { this.HandleComment(); } -> channel(HIDDEN);
+
+WS: [ \t\u000C\r]+ -> channel(HIDDEN);
+
+NL: [\n] -> channel(2);
+
+SHEBANG: '#' { this.IsLine1Col0() }? '!'? SingleLineInputCharacter* -> channel(HIDDEN);

package/grammar/LuaParser.g4

@@ -0,0 +1,178 @@
+/*
+
+MIT license
+
+Author: Ken Domino, October 2023
+
+Based on previous work of: Kazunori Sakamoto, Alexander Alexeev
+
+*/
+
+// $antlr-format alignTrailingComments true, columnLimit 150, minEmptyLines 1, maxEmptyLinesToKeep 1, reflowComments false, useTab false
+// $antlr-format allowShortRulesOnASingleLine false, allowShortBlocksOnASingleLine true, alignSemicolons hanging, alignColons hanging
+
+parser grammar LuaParser;
+
+options {
+    tokenVocab = LuaLexer;
+    superClass = LuaParserBase;
+}
+
+// Insert here @header for parser.
+
+start_
+    : chunk EOF
+    ;
+
+chunk
+    : block
+    ;
+
+block
+    : stat* retstat?
+    ;
+
+stat
+    : ';'
+    | varlist '=' explist
+    | functioncall
+    | label
+    | 'break'
+    | 'goto' NAME
+    | 'do' block 'end'
+    | 'while' exp 'do' block 'end'
+    | 'repeat' block 'until' exp
+    | 'if' exp 'then' block ('elseif' exp 'then' block)* ('else' block)? 'end'
+    | 'for' NAME '=' exp ',' exp (',' exp)? 'do' block 'end'
+    | 'for' namelist 'in' explist 'do' block 'end'
+    | 'function' funcname funcbody
+    | 'local' 'function' NAME funcbody
+    | 'local' attnamelist ('=' explist)?
+    ;
+
+attnamelist
+    : NAME attrib (',' NAME attrib)*
+    ;
+
+attrib
+    : ('<' NAME '>')?
+    ;
+
+retstat
+    : 'return' explist? ';'?
+    ;
+
+label
+    : '::' NAME '::'
+    ;
+
+funcname
+    : NAME ('.' NAME)* (':' NAME)?
+    ;
+
+varlist
+    : var (',' var)*
+    ;
+
+namelist
+    : NAME (',' NAME)*
+    ;
+
+explist
+    : exp (',' exp)*
+    ;
+
+exp
+    : 'nil'
+    | 'false'
+    | 'true'
+    | number
+    | string
+    | '...'
+    | functiondef
+    | prefixexp
+    | tableconstructor
+    | <assoc = right> exp ('^') exp
+    | ('not' | '#' | '-' | '~') exp
+    | exp ('*' | '/' | '%' | '//') exp
+    | exp ('+' | '-') exp
+    | <assoc = right> exp ('..') exp
+    | exp ('<' | '>' | '<=' | '>=' | '~=' | '==') exp
+    | exp ('and') exp
+    | exp ('or') exp
+    | exp ('&' | '|' | '~' | '<<' | '>>') exp
+    ;
+
+// var ::=  Name | prefixexp '[' exp ']' | prefixexp '.' Name 
+var
+    : NAME
+    | prefixexp ('[' exp ']' | '.' NAME)
+    ;
+
+// prefixexp ::= var | functioncall | '(' exp ')'
+prefixexp
+    : { this.IsFunctionCall() }? NAME ( '[' exp ']' | '.' NAME )*
+    | functioncall ( '[' exp ']' | '.' NAME )*
+    | '(' exp ')' ( '[' exp ']' | '.' NAME )*
+    ;
+
+// functioncall ::=  prefixexp args | prefixexp ':' Name args;
+functioncall
+    :  ( ( NAME | '(' exp ')' ) ( '[' exp ']' | '.' NAME )* ( args | ':' NAME args ) ) ( ( '[' exp ']' | '.' NAME )* ( args | ':' NAME args ) )*
+    ;
+
+args
+    : '(' explist? ')'
+    | tableconstructor
+    | string
+    ;
+
+functiondef
+    : 'function' funcbody
+    ;
+
+funcbody
+    : '(' parlist ')' block 'end'
+    ;
+
+/* lparser.c says "is 'parlist' not empty?"
+ * That code does so by checking la(1) == ')'.
+ * This means that parlist can derive empty.
+ */
+parlist
+    : namelist (',' '...')?
+    | '...'
+    |
+    ;
+
+tableconstructor
+    : '{' fieldlist? '}'
+    ;
+
+fieldlist
+    : field (fieldsep field)* fieldsep?
+    ;
+
+field
+    : '[' exp ']' '=' exp
+    | NAME '=' exp
+    | exp
+    ;
+
+fieldsep
+    : ','
+    | ';'
+    ;
+
+number
+    : INT
+    | HEX
+    | FLOAT
+    | HEX_FLOAT
+    ;
+
+string
+    : NORMALSTRING
+    | CHARSTRING
+    | LONGSTRING
+    ;

package/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-text-lua",
+    "version": "0.1.0",
+    "description": "text/x-lua mimetype handler for plurnk-service. ANTLR-backed extraction via grammars-v4.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "handlers": [
+            {
+                "name": "text/x-lua",
+                "glyph": "\ud83c\udf19",
+                "extensions": [
+                    ".lua"
+                ]
+            }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "grammar/**/*",
+        "README.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:grammar": "plurnk-mimetypes-compile",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:grammar && npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-mimetypes": "0.7.4",
+        "antlr4ng": "^3.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "antlr-ng": "^1.0.10",
+        "typescript": "^6.0.3"
+    }
+}