python2ts 1.3.1 → 1.3.2

package/dist/{chunk-LNOL3BMB.js → chunk-RNRRQS6K.js}

@@ -809,7 +809,22 @@ function transformNode(node, ctx) {
 }
 function transformScript(node, ctx) {
   const children = getChildren(node);
-  const statements = children.filter((child) => child.name !== "Comment" || getNodeText(child, ctx.source).trim() !== "").map((child) => {
+  let moduleDocstring = "";
+  let startIndex = 0;
+  const filteredChildren = children.filter(
+    (child) => child.name !== "Comment" || getNodeText(child, ctx.source).trim() !== ""
+  );
+  if (filteredChildren.length > 1) {
+    const firstChild = filteredChildren[0];
+    if (firstChild && isDocstringNode(firstChild, ctx)) {
+      const content = extractDocstringContent(firstChild, ctx);
+      const parsed = parseDocstring(content);
+      const jsdoc = toJSDoc(parsed, "");
+      moduleDocstring = jsdoc.replace(" */", " * @module\n */");
+      startIndex = 1;
+    }
+  }
+  const statements = filteredChildren.slice(startIndex).map((child) => {
     const transformed = transformNode(child, ctx);
     if (transformed === "") {
       return "";
@@ -819,6 +834,9 @@ function transformScript(node, ctx) {
     }
     return transformed;
   }).filter((s) => s.trim() !== "");
+  if (moduleDocstring) {
+    return moduleDocstring + "\n" + statements.join("\n");
+  }
   return statements.join("\n");
 }
 function transformExpressionStatement(node, ctx) {
@@ -1302,9 +1320,26 @@ function transformCallExpression(node, ctx) {
     case "reversed":
       ctx.usesRuntime.add("reversed");
       return `reversed(${args})`;
-    case "isinstance":
+    case "isinstance": {
       ctx.usesRuntime.add("isinstance");
+      if (argList) {
+        const argChildren = getChildren(argList).filter(
+          (c) => c.name !== "(" && c.name !== ")" && c.name !== ","
+        );
+        if (argChildren.length >= 2) {
+          const firstArg = argChildren[0];
+          const secondArg = argChildren[1];
+          if (firstArg && secondArg?.name === "TupleExpression") {
+            const tupleChildren = getChildren(secondArg).filter(
+              (c) => c.name !== "(" && c.name !== ")" && c.name !== ","
+            );
+            const typesCodes = tupleChildren.map((el) => transformNode(el, ctx));
+            return `isinstance(${transformNode(firstArg, ctx)}, [${typesCodes.join(", ")}])`;
+          }
+        }
+      }
       return `isinstance(${args})`;
+    }
     case "type":
       ctx.usesRuntime.add("type");
       return `type(${args})`;
@@ -3673,8 +3708,10 @@ function transformDecoratedStatement(node, ctx) {
     const returnTypeStr = returnType ? `: ${returnType === "null" ? "void" : returnType}` : "";
     return `function ${funcName}(${params})${returnTypeStr}`;
   }
+  const indent = "  ".repeat(ctx.indentLevel);
+  const { jsdoc, skipFirstStatement } = body ? extractDocstringFromBody(body, ctx, indent) : { jsdoc: null, skipFirstStatement: false };
   ctx.insideFunctionBody++;
-  const bodyCode = body ? transformBody(body, ctx, false, paramNames) : "";
+  const bodyCode = body ? transformBody(body, ctx, skipFirstStatement, paramNames) : "";
   ctx.insideFunctionBody--;
   let funcExpr = `function ${funcName}(${params}) {
 ${bodyCode}
@@ -3688,7 +3725,9 @@ ${bodyCode}
       funcExpr = `${dec.name}(${funcExpr})`;
     }
   }
-  return `const ${funcName} = ${funcExpr}`;
+  const declaration = `const ${funcName} = ${funcExpr}`;
+  return jsdoc ? `${jsdoc}
+${declaration}` : declaration;
 }
 function transformDecoratedClass(classDef, decorators, ctx) {
   const dataclassDecorator = decorators.find(

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   transpileAsync
-} from "../chunk-LNOL3BMB.js";
+} from "../chunk-RNRRQS6K.js";
 
 // src/cli/index.ts
 import { parseArgs } from "util";

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   transpile,
   transpileAsync,
   walkTree
-} from "./chunk-LNOL3BMB.js";
+} from "./chunk-RNRRQS6K.js";
 export {
   debugTree,
   formatCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "python2ts",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "AST-based Python to TypeScript transpiler. Convert Python code to clean, idiomatic TypeScript with full type preservation.",
   "homepage": "https://sebastian-software.github.io/python2ts/",
   "repository": {
@@ -53,7 +53,7 @@
     "eslint": "^9.39.2",
     "prettier": "^3.8.0",
     "typescript-eslint": "^8.53.1",
-    "pythonlib": "2.0.1"
+    "pythonlib": "2.0.2"
   },
   "devDependencies": {
     "tsup": "^8.5.1",