@alloy-js/python 0.5.0-dev.1 → 0.5.0-dev.2

package/docs/api/components/SourceFile.md

@@ -13,7 +13,11 @@ A Python source file component that represents a Python file in the source direc
     futureImports={Children[]}
     header={Children}
     headerComment="string"
+    insertFinalNewLine
     path="string"
+    printWidth={number}
+    tabWidth={number}
+    useTabs
   >
     {children}
   </SourceFile>
@@ -30,20 +34,28 @@ A Python source file component that represents a Python file in the source direc
     futureImports: Children[],
     header: Children,
     headerComment: string,
+    insertFinalNewLine: boolean,
     path: string,
+    printWidth: number,
+    tabWidth: number,
+    useTabs: boolean,
   }).children(children)
   ```
 
 ## Props
 
-|               |                                                       |                                                                                                                                                       |
-| ------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| children      | optional [Children](../../../core/types/children/)    | Content to add to the file, such as function definitions, class definitions, and variable declarations.                                               |
-| doc           | optional [Children](../../../core/types/children/)    | Documentation for this module, which will be rendered as a module-level docstring.                                                                    |
-| futureImports | optional [Children](../../../core/types/children/)\[] | **future** imports to render after the docstring but before regular imports.                                                                          |
-| header        | optional [Children](../../../core/types/children/)    | Content to render at the very top of the file, before everything else. Use this for shebang lines, encoding declarations, or license headers.         |
-| headerComment | optional string                                       | Comment to add at the top of the file, rendered as a Python comment block. This is a convenience prop for adding copyright notices or other comments. |
-| path          | string                                                | The path to the file relative to the source directory.                                                                                                |
+|                    |                                                       |                                                                                                                                                       |
+| ------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| children           | optional [Children](../../../core/types/children/)    | Content to add to the file, such as function definitions, class definitions, and variable declarations.                                               |
+| doc                | optional [Children](../../../core/types/children/)    | Documentation for this module, which will be rendered as a module-level docstring.                                                                    |
+| futureImports      | optional [Children](../../../core/types/children/)\[] | **future** imports to render after the docstring but before regular imports.                                                                          |
+| header             | optional [Children](../../../core/types/children/)    | Content to render at the very top of the file, before everything else. Use this for shebang lines, encoding declarations, or license headers.         |
+| headerComment      | optional string                                       | Comment to add at the top of the file, rendered as a Python comment block. This is a convenience prop for adding copyright notices or other comments. |
+| insertFinalNewLine | optional boolean                                      | If files should end with a final new line.                                                                                                            |
+| path               | string                                                | The path to the file relative to the source directory.                                                                                                |
+| printWidth         | optional number                                       | The number of characters the printer will wrap on. Defaults to 100 characters.                                                                        |
+| tabWidth           | optional number                                       | The number of spaces to use for indentation. Defaults to 2 spaces.                                                                                    |
+| useTabs            | optional boolean                                      | Whether to use tabs instead of spaces for indentation. Defaults to false.                                                                             |
 
 ## Examples
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/python",
-  "version": "0.5.0-dev.1",
+  "version": "0.5.0-dev.2",
   "description": "Python bindings for Alloy",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@alloy-js/core": "~0.23.1 || >= 0.24.0-dev.6",
+    "@alloy-js/core": "~0.23.1 || >= 0.24.0-dev.7",
     "change-case": "^5.4.4",
     "pathe": "^2.0.3"
   },

package/src/components/SourceFile.tsx

@@ -7,6 +7,7 @@ import {
   createScope,
   isComponentCreator,
   List,
+  PrintTreeOptions,
   Scope,
   Show,
   SourceDirectoryContext,
@@ -78,7 +79,7 @@ export function useSourceFile() {
   return useContext(PythonSourceFileContext)!;
 }
 
-export interface SourceFileProps {
+export interface SourceFileProps extends PrintTreeOptions {
   /**
    * The path to the file relative to the source directory.
    */
@@ -200,6 +201,10 @@ export function SourceFile(props: SourceFileProps) {
       filetype="py"
       reference={Reference}
       header={props.header}
+      tabWidth={props.tabWidth ?? 4}
+      printWidth={props.printWidth}
+      useTabs={props.useTabs}
+      insertFinalNewLine={props.insertFinalNewLine}
     >
       {/* Extra blank line after header when followed by doc/futureImports/children (not headerComment) */}
       <Show

package/temp/api.json

@@ -11117,7 +11117,16 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface SourceFileProps "
+              "text": "export interface SourceFileProps extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PrintTreeOptions",
+              "canonicalReference": "@alloy-js/core!PrintTreeOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
             }
           ],
           "fileUrlPath": "src/components/SourceFile.tsx",
@@ -11296,7 +11305,12 @@
               }
             }
           ],
-          "extendsTokenRanges": []
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
         },
         {
           "kind": "Function",