@aiready/core 0.24.3 → 0.24.4

package/dist/index.js

@@ -666,13 +666,65 @@ var python_parser_exports = {};
 __export(python_parser_exports, {
   PythonParser: () => PythonParser
 });
-var PythonParser;
+var PYTHON_CONSTANTS, PythonParser;
 var init_python_parser = __esm({
   "src/parsers/python-parser.ts"() {
     "use strict";
     init_language();
     init_metadata_utils();
     init_base_parser();
+    PYTHON_CONSTANTS = {
+      NODES: {
+        IMPORT_STATEMENT: "import_statement",
+        IMPORT_FROM_STATEMENT: "import_from_statement",
+        DOTTED_NAME: "dotted_name",
+        ALIASED_IMPORT: "aliased_import",
+        WILDCARD_IMPORT: "wildcard_import",
+        FUNCTION_DEFINITION: "function_definition",
+        CLASS_DEFINITION: "class_definition",
+        EXPRESSION_STATEMENT: "expression_statement",
+        ASSIGNMENT: "assignment",
+        IDENTIFIER: "identifier",
+        TYPED_PARAMETER: "typed_parameter",
+        DEFAULT_PARAMETER: "default_parameter"
+      },
+      FIELDS: {
+        NAME: "name",
+        MODULE_NAME: "module_name",
+        LEFT: "left",
+        PARAMETERS: "parameters"
+      },
+      SPECIAL: {
+        WILDCARD: "*",
+        DUNDER_ALL: "__all__",
+        DUNDER_VERSION: "__version__",
+        DUNDER_AUTHOR: "__author__",
+        DUNDER_INIT: "__init__",
+        DUNDER_STR: "__str__",
+        DUNDER_REPR: "__repr__",
+        DUNDER_NAME: "__name__",
+        DUNDER_MAIN: "__main__",
+        DUNDER_FILE: "__file__",
+        DUNDER_DOC: "__doc__",
+        DUNDER_DICT: "__dict__",
+        DUNDER_CLASS: "__class__",
+        DUNDER_MODULE: "__module__",
+        DUNDER_BASES: "__bases__",
+        MAIN_VAL: "__main__"
+      },
+      BUILTINS: {
+        PRINT: "print(",
+        INPUT: "input(",
+        OPEN: "open("
+      },
+      TYPES: {
+        FUNCTION: "function",
+        CLASS: "class",
+        VARIABLE: "variable",
+        CONST: "const",
+        DOCSTRING: "docstring"
+      }
+    };
     PythonParser = class extends BaseLanguageParser {
       constructor() {
         super(...arguments);
@@ -684,28 +736,25 @@ var init_python_parser = __esm({
       }
       /**
        * Analyze metadata for a Python node (purity, side effects).
-       *
-       * @param node - Tree-sitter node to analyze.
-       * @param code - Source code for context.
-       * @returns Partial ExportInfo containing discovered metadata.
        */
       analyzeMetadata(node, code) {
         return analyzeNodeMetadata(node, code, {
-          sideEffectSignatures: ["print(", "input(", "open("]
+          sideEffectSignatures: [
+            PYTHON_CONSTANTS.BUILTINS.PRINT,
+            PYTHON_CONSTANTS.BUILTINS.INPUT,
+            PYTHON_CONSTANTS.BUILTINS.OPEN
+          ]
         });
       }
       /**
        * Extract import information using AST walk.
-       *
-       * @param rootNode - Root node of the Python AST.
-       * @returns Array of discovered FileImport objects.
        */
       extractImportsAST(rootNode) {
         const imports = [];
         const processImportNode = (node) => {
-          if (node.type === "import_statement") {
+          if (node.type === PYTHON_CONSTANTS.NODES.IMPORT_STATEMENT) {
             for (const child of node.children) {
-              if (child.type === "dotted_name") {
+              if (child.type === PYTHON_CONSTANTS.NODES.DOTTED_NAME) {
                 const source = child.text;
                 imports.push({
                   source,
@@ -721,8 +770,8 @@ var init_python_parser = __esm({
                     }
                   }
                 });
-              } else if (child.type === "aliased_import") {
-                const nameNode = child.childForFieldName("name");
+              } else if (child.type === PYTHON_CONSTANTS.NODES.ALIASED_IMPORT) {
+                const nameNode = child.childForFieldName(PYTHON_CONSTANTS.FIELDS.NAME);
                 if (nameNode) {
                   const source = nameNode.text;
                   imports.push({
@@ -742,19 +791,19 @@ var init_python_parser = __esm({
                 }
               }
             }
-          } else if (node.type === "import_from_statement") {
-            const moduleNameNode = node.childForFieldName("module_name");
+          } else if (node.type === PYTHON_CONSTANTS.NODES.IMPORT_FROM_STATEMENT) {
+            const moduleNameNode = node.childForFieldName(PYTHON_CONSTANTS.FIELDS.MODULE_NAME);
             if (moduleNameNode) {
               const source = moduleNameNode.text;
               const specifiers = [];
               for (const child of node.children) {
-                if (child.type === "dotted_name" && child !== moduleNameNode) {
+                if (child.type === PYTHON_CONSTANTS.NODES.DOTTED_NAME && child !== moduleNameNode) {
                   specifiers.push(child.text);
-                } else if (child.type === "aliased_import") {
-                  const nameNode = child.childForFieldName("name");
+                } else if (child.type === PYTHON_CONSTANTS.NODES.ALIASED_IMPORT) {
+                  const nameNode = child.childForFieldName(PYTHON_CONSTANTS.FIELDS.NAME);
                   if (nameNode) specifiers.push(nameNode.text);
-                } else if (child.type === "wildcard_import") {
-                  specifiers.push("*");
+                } else if (child.type === PYTHON_CONSTANTS.NODES.WILDCARD_IMPORT) {
+                  specifiers.push(PYTHON_CONSTANTS.SPECIAL.WILDCARD);
                 }
               }
               if (specifiers.length > 0) {
@@ -783,16 +832,12 @@ var init_python_parser = __esm({
       }
       /**
        * Extract export information using AST walk.
-       *
-       * @param rootNode - Root node of the Python AST.
-       * @param code - Source code for documentation extraction.
-       * @returns Array of discovered ExportInfo objects.
        */
       extractExportsAST(rootNode, code) {
         const exports2 = [];
         for (const node of rootNode.children) {
-          if (node.type === "function_definition") {
-            const nameNode = node.childForFieldName("name");
+          if (node.type === PYTHON_CONSTANTS.NODES.FUNCTION_DEFINITION) {
+            const nameNode = node.childForFieldName(PYTHON_CONSTANTS.FIELDS.NAME);
             if (nameNode) {
               const name = nameNode.text;
               const isPrivate = name.startsWith("_") && !name.startsWith("__");
@@ -800,7 +845,7 @@ var init_python_parser = __esm({
                 const metadata = this.analyzeMetadata(node, code);
                 exports2.push({
                   name,
-                  type: "function",
+                  type: PYTHON_CONSTANTS.TYPES.FUNCTION,
                   loc: {
                     start: {
                       line: node.startPosition.row + 1,
@@ -816,13 +861,13 @@ var init_python_parser = __esm({
                 });
               }
             }
-          } else if (node.type === "class_definition") {
-            const nameNode = node.childForFieldName("name");
+          } else if (node.type === PYTHON_CONSTANTS.NODES.CLASS_DEFINITION) {
+            const nameNode = node.childForFieldName(PYTHON_CONSTANTS.FIELDS.NAME);
             if (nameNode) {
               const metadata = this.analyzeMetadata(node, code);
               exports2.push({
                 name: nameNode.text,
-                type: "class",
+                type: PYTHON_CONSTANTS.TYPES.CLASS,
                 loc: {
                   start: {
                     line: node.startPosition.row + 1,
@@ -836,18 +881,18 @@ var init_python_parser = __esm({
                 ...metadata
               });
             }
-          } else if (node.type === "expression_statement") {
+          } else if (node.type === PYTHON_CONSTANTS.NODES.EXPRESSION_STATEMENT) {
             const assignment = node.firstChild;
-            if (assignment && assignment.type === "assignment") {
-              const left = assignment.childForFieldName("left");
-              if (left && left.type === "identifier") {
+            if (assignment && assignment.type === PYTHON_CONSTANTS.NODES.ASSIGNMENT) {
+              const left = assignment.childForFieldName(PYTHON_CONSTANTS.FIELDS.LEFT);
+              if (left && left.type === PYTHON_CONSTANTS.NODES.IDENTIFIER) {
                 const name = left.text;
-                const isInternal = name === "__all__" || name === "__version__" || name === "__author__";
+                const isInternal = name === PYTHON_CONSTANTS.SPECIAL.DUNDER_ALL || name === PYTHON_CONSTANTS.SPECIAL.DUNDER_VERSION || name === PYTHON_CONSTANTS.SPECIAL.DUNDER_AUTHOR;
                 const isPrivate = name.startsWith("_") && !name.startsWith("__");
                 if (!isInternal && !isPrivate) {
                   exports2.push({
                     name,
-                    type: name === name.toUpperCase() ? "const" : "variable",
+                    type: name === name.toUpperCase() ? PYTHON_CONSTANTS.TYPES.CONST : PYTHON_CONSTANTS.TYPES.VARIABLE,
                     loc: {
                       start: {
                         line: node.startPosition.row + 1,
@@ -868,18 +913,15 @@ var init_python_parser = __esm({
       }
       /**
        * Extract parameter names from a function definition node.
-       *
-       * @param node - Function definition node.
-       * @returns Array of parameter name strings.
        */
       extractParameters(node) {
-        const paramsNode = node.childForFieldName("parameters");
+        const paramsNode = node.childForFieldName(PYTHON_CONSTANTS.FIELDS.PARAMETERS);
         if (!paramsNode) return [];
         return paramsNode.children.filter(
-          (c) => c.type === "identifier" || c.type === "typed_parameter" || c.type === "default_parameter"
+          (c) => c.type === PYTHON_CONSTANTS.NODES.IDENTIFIER || c.type === PYTHON_CONSTANTS.NODES.TYPED_PARAMETER || c.type === PYTHON_CONSTANTS.NODES.DEFAULT_PARAMETER
         ).map((c) => {
-          if (c.type === "identifier") return c.text;
-          if (c.type === "typed_parameter" || c.type === "default_parameter") {
+          if (c.type === PYTHON_CONSTANTS.NODES.IDENTIFIER) return c.text;
+          if (c.type === PYTHON_CONSTANTS.NODES.TYPED_PARAMETER || c.type === PYTHON_CONSTANTS.NODES.DEFAULT_PARAMETER) {
             return c.firstChild?.text || "unknown";
           }
           return "unknown";
@@ -887,10 +929,6 @@ var init_python_parser = __esm({
       }
       /**
        * Fallback regex-based parsing when tree-sitter is unavailable.
-       *
-       * @param code - Source code content.
-       * @param filePath - Path to the file being parsed.
-       * @returns Consolidated ParseResult.
        */
       parseRegex(code, filePath) {
         try {
@@ -905,9 +943,7 @@ var init_python_parser = __esm({
             ]
           };
         } catch (error) {
-          const wrapper = new Error(
-            `Failed to parse Python file ${filePath}: ${error.message}`
-          );
+          const wrapper = new Error(`Failed to parse Python file ${filePath}: ${error.message}`);
           wrapper.cause = error;
           throw wrapper;
         }
@@ -919,20 +955,20 @@ var init_python_parser = __esm({
           classPattern: /^[A-Z][a-zA-Z0-9]*$/,
           constantPattern: /^[A-Z][A-Z0-9_]*$/,
           exceptions: [
-            "__init__",
-            "__str__",
-            "__repr__",
-            "__name__",
-            "__main__",
-            "__file__",
-            "__doc__",
-            "__all__",
-            "__version__",
-            "__author__",
-            "__dict__",
-            "__class__",
-            "__module__",
-            "__bases__"
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_INIT,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_STR,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_REPR,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_NAME,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_MAIN,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_FILE,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_DOC,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_ALL,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_VERSION,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_AUTHOR,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_DICT,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_CLASS,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_MODULE,
+            PYTHON_CONSTANTS.SPECIAL.DUNDER_BASES
           ]
         };
       }
@@ -966,10 +1002,10 @@ var init_python_parser = __esm({
           if (fromMatch) {
             const module2 = fromMatch[1];
             const importsStr = fromMatch[2];
-            if (importsStr.trim() === "*") {
+            if (importsStr.trim() === PYTHON_CONSTANTS.SPECIAL.WILDCARD) {
               imports.push({
                 source: module2,
-                specifiers: ["*"],
+                specifiers: [PYTHON_CONSTANTS.SPECIAL.WILDCARD],
                 loc: {
                   start: { line: idx + 1, column: 0 },
                   end: { line: idx + 1, column: line.length }
@@ -1003,7 +1039,7 @@ var init_python_parser = __esm({
           if (classMatch) {
             exports2.push({
               name: classMatch[1],
-              type: "class",
+              type: PYTHON_CONSTANTS.TYPES.CLASS,
               visibility: "public",
               isPure: true,
               hasSideEffects: false,
@@ -1029,14 +1065,14 @@ var init_python_parser = __esm({
               if (nextLine.trim() && !nextLine.trim().startsWith('"""') && !nextLine.trim().startsWith("'''"))
                 break;
             }
-            const isImpure = name.toLowerCase().includes("impure") || line.includes("print(") || idx + 1 < lines.length && lines[idx + 1].includes("print(");
+            const isImpure = name.toLowerCase().includes("impure") || line.includes(PYTHON_CONSTANTS.BUILTINS.PRINT) || idx + 1 < lines.length && lines[idx + 1].includes(PYTHON_CONSTANTS.BUILTINS.PRINT);
             exports2.push({
               name,
-              type: "function",
+              type: PYTHON_CONSTANTS.TYPES.FUNCTION,
               visibility: "public",
               isPure: !isImpure,
               hasSideEffects: isImpure,
-              documentation: docContent ? { content: docContent, type: "docstring" } : void 0,
+              documentation: docContent ? { content: docContent, type: PYTHON_CONSTANTS.TYPES.DOCSTRING } : void 0,
               loc: {
                 start: { line: idx + 1, column: 0 },
                 end: { line: idx + 1, column: line.length }

package/dist/index.mjs

@@ -58,7 +58,7 @@ import {
 } from "./chunk-UTCRW3N7.mjs";
 import {
   PythonParser
-} from "./chunk-SM6INS52.mjs";
+} from "./chunk-AZRUQG5T.mjs";
 import {
   JavaParser
 } from "./chunk-SWZOT67M.mjs";
@@ -912,7 +912,7 @@ var ParserFactory = class _ParserFactory {
       return new TypeScriptParser2();
     });
     this.registerLazyParser("python" /* Python */, async () => {
-      const { PythonParser: PythonParser2 } = await import("./python-parser-SJ3LFZFJ.mjs");
+      const { PythonParser: PythonParser2 } = await import("./python-parser-UFLCDT6L.mjs");
       return new PythonParser2();
     });
     this.registerLazyParser("java" /* Java */, async () => {

package/dist/python-parser-7QISP7LK.mjs

@@ -0,0 +1,8 @@
+import {
+  PythonParser
+} from "./chunk-WH4ZGRVF.mjs";
+import "./chunk-2N7ISIKE.mjs";
+import "./chunk-U3IY2CFC.mjs";
+export {
+  PythonParser
+};

package/dist/python-parser-PDCO35VN.mjs

@@ -0,0 +1,8 @@
+import {
+  PythonParser
+} from "./chunk-MPWWAAHQ.mjs";
+import "./chunk-2N7ISIKE.mjs";
+import "./chunk-U3IY2CFC.mjs";
+export {
+  PythonParser
+};

package/dist/python-parser-QAAL56MC.mjs

@@ -0,0 +1,8 @@
+import {
+  PythonParser
+} from "./chunk-XQSEJ7WN.mjs";
+import "./chunk-2N7ISIKE.mjs";
+import "./chunk-U3IY2CFC.mjs";
+export {
+  PythonParser
+};

package/dist/python-parser-R7HLPNZK.mjs

@@ -0,0 +1,8 @@
+import {
+  PythonParser
+} from "./chunk-LEITCMH3.mjs";
+import "./chunk-2N7ISIKE.mjs";
+import "./chunk-U3IY2CFC.mjs";
+export {
+  PythonParser
+};

package/dist/python-parser-UFLCDT6L.mjs

@@ -0,0 +1,8 @@
+import {
+  PythonParser
+} from "./chunk-AZRUQG5T.mjs";
+import "./chunk-2N7ISIKE.mjs";
+import "./chunk-U3IY2CFC.mjs";
+export {
+  PythonParser
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.24.3",
+  "version": "0.24.4",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",