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

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/docs/api/components/index.md

@@ -33,14 +33,12 @@
 - [PyDoc](PyDoc.md) — A PyDoc comment.
 - [PyDocExample](PyDocExample.md) — Create a PyDoc example, which is prepended by >>.
 - [PythonBlock](PythonBlock.md) — A Python block component that can be used to render a block of Python code.
-- [Reference](Reference.md) — A Python reference to a symbol, such as a variable, function, or class.
 - [SimpleCommentBlock](SimpleCommentBlock.md) — import { SimpleCommentBlock } from "@alloy-js/python";
 - [SimpleInlineComment](SimpleInlineComment.md) — import { SimpleInlineComment } from "@alloy-js/python";
 - [SourceFile](SourceFile.md) — A Python source file component that represents a Python file in the source directory.
 - [StatementList](StatementList.md) — A Python statement list, which is a list of statements that can be rendered in a Python source file.
 - [StaticMethodDeclaration](StaticMethodDeclaration.md) — A Python static method declaration component.
 - [TypeArguments](TypeArguments.md) — Render Python-style type arguments, e.g.
-- [TypeRefContext](TypeRefContext.md) — Set the current context of reference to be type reference.
 - [TypeReference](TypeReference.md) — A type reference like Foo\[T, P] or int.
 - [UnionTypeExpression](UnionTypeExpression.md) — import { UnionTypeExpression } from "@alloy-js/python";
 - [useSourceFile](useSourceFile.md) — import { useSourceFile } from "@alloy-js/python";

package/docs/api/functions/isTypeRefContext.md

@@ -14,4 +14,4 @@ function isTypeRefContext(): boolean;
 
 ## Returns
 
-boolean ‘true’ if in a type context, ‘false’ if in a value context.
+boolean’true’ if in a type context, ‘false’ if in a value context.

package/docs/api/index.md

@@ -1,7 +1,7 @@
 # @alloy-js/python API Reference
 
-- [components](components/index.md) (45 items)
+- [components](components/index.md) (43 items)
 - [contexts](contexts/index.md) (1 items)
 - [functions](functions/index.md) (11 items)
-- [types](types/index.md) (30 items)
+- [types](types/index.md) (32 items)
 - [variables](variables/index.md) (9 items)

package/docs/api/types/ReferenceProps.md

@@ -0,0 +1,7 @@
+# ReferenceProps
+
+## Members
+
+|        |                                       |   |
+| ------ | ------------------------------------- | - |
+| refkey | [Refkey](../../../core/types/refkey/) |   |

package/docs/api/types/TypeRefContextProps.md

@@ -0,0 +1,7 @@
+# TypeRefContextProps
+
+## Members
+
+|          |                                           |          |
+| -------- | ----------------------------------------- | -------- |
+| children | [Children](../../../core/types/children/) | Children |

package/docs/api/types/index.md

@@ -28,5 +28,7 @@
 - [PythonOutputScope](PythonOutputScope.md) — type PythonOutputScope = PythonLexicalScope | PythonModuleScope | PythonMemberScope;
 - [PythonOutputSymbol](PythonOutputSymbol.md) — Represents an ‘exported’ symbol from a .py file.
 - [PythonOutputSymbolOptions](PythonOutputSymbolOptions.md) — Extends [OutputSymbolOptions](../../../core/types/outputsymboloptions/)
+- [ReferenceProps](ReferenceProps.md)
 - [RefOptions](RefOptions.md)
 - [SubscriptionProps](SubscriptionProps.md)
+- [TypeRefContextProps](TypeRefContextProps.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/python",
-  "version": "0.5.0-dev.1",
+  "version": "0.5.0",
   "description": "Python bindings for Alloy",
   "repository": {
     "type": "git",
@@ -20,18 +20,19 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@alloy-js/core": "~0.23.1 || >= 0.24.0-dev.6",
     "change-case": "^5.4.4",
-    "pathe": "^2.0.3"
+    "pathe": "^2.0.3",
+    "@alloy-js/core": "~0.24.0"
   },
   "devDependencies": {
-    "@alloy-js/cli": "~0.23.0 || >= 0.24.0-dev.1",
-    "@alloy-js/rollup-plugin": "~0.1.1 || >= 0.1.2-dev.2",
-    "@microsoft/api-extractor": "~7.52.8",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "concurrently": "^9.2.0",
-    "typescript": "^5.8.3",
-    "vitest": "3.2.4"
+    "@microsoft/api-extractor": "~7.58.8",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^25.9.2",
+    "concurrently": "^10.0.3",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.8",
+    "@alloy-js/rollup-plugin": "~0.1.2",
+    "@alloy-js/cli": "~0.24.0"
   },
   "type": "module",
   "scripts": {

package/src/components/CallSignature.tsx

@@ -92,8 +92,10 @@ function parameter(param: DeclaredParameterDescriptor) {
   );
 }
 
-interface DeclaredParameterDescriptor
-  extends Omit<ParameterDescriptor, "name"> {
+interface DeclaredParameterDescriptor extends Omit<
+  ParameterDescriptor,
+  "name"
+> {
   symbol: PythonOutputSymbol;
   TypeSlot?: SymbolSlot;
 }

package/src/components/ConstructorDeclaration.tsx

@@ -18,8 +18,10 @@ import { MethodDeclarationBase } from "./MethodBase.js";
  *     pass
  * ```
  */
-export interface ConstructorDeclarationProps
-  extends Omit<CommonFunctionProps, "name"> {
+export interface ConstructorDeclarationProps extends Omit<
+  CommonFunctionProps,
+  "name"
+> {
   abstract?: boolean;
 }
 

package/src/components/DataclassDeclaration.tsx

@@ -109,8 +109,7 @@ export type DataclassDecoratorKwargs = Partial<
 >;
 
 export interface DataclassDeclarationProps
-  extends ClassDeclarationProps,
-    DataclassDecoratorKwargs {}
+  extends ClassDeclarationProps, DataclassDecoratorKwargs {}
 
 /**
  * Renders a Python dataclass.

package/src/components/FunctionBase.tsx

@@ -16,8 +16,7 @@ import { PythonBlock } from "./PythonBlock.jsx";
  * metadata with call signature shape.
  */
 export interface CommonFunctionProps
-  extends BaseDeclarationProps,
-    CallSignatureProps {
+  extends BaseDeclarationProps, CallSignatureProps {
   /** Indicates that the function is async. */
   async?: boolean;
   /**

package/src/components/PropertyDeclaration.tsx

@@ -178,8 +178,10 @@ export function PropertyDeclaration(props: PropertyDeclarationProps) {
   );
 }
 
-export interface PropertyMethodDeclarationProps
-  extends Omit<CommonFunctionProps, "name"> {
+export interface PropertyMethodDeclarationProps extends Omit<
+  CommonFunctionProps,
+  "name"
+> {
   abstract?: boolean;
 }
 
@@ -206,8 +208,10 @@ function PropertyMethodDeclaration(props: PropertyMethodDeclarationProps) {
   );
 }
 
-interface PropertyMethodBaseProps
-  extends Omit<PropertyMethodDeclarationProps, "name"> {
+interface PropertyMethodBaseProps extends Omit<
+  PropertyMethodDeclarationProps,
+  "name"
+> {
   decoratorType: "setter" | "deleter";
   parameters?: (ParameterDescriptor | string)[];
 }

package/src/components/PyDoc.tsx

@@ -537,8 +537,10 @@ function GoogleStylePropertyDoc(props: GoogleStylePropertyDocProps) {
   return <PyDoc>{children}</PyDoc>;
 }
 
-interface GoogleStyleGeneratorDocProps
-  extends Omit<GeneratorDocProps, "style"> {}
+interface GoogleStyleGeneratorDocProps extends Omit<
+  GeneratorDocProps,
+  "style"
+> {}
 
 /**
  * A component that creates a GoogleStyleGeneratorDoc block for generators.
@@ -577,8 +579,10 @@ function GoogleStyleGeneratorDoc(props: GoogleStyleGeneratorDocProps) {
   return <PyDoc>{children}</PyDoc>;
 }
 
-interface GoogleStyleExceptionDocProps
-  extends Omit<ExceptionDocProps, "style"> {}
+interface GoogleStyleExceptionDocProps extends Omit<
+  ExceptionDocProps,
+  "style"
+> {}
 
 /**
  * A component that creates a GoogleStyleExceptionDoc block for exceptions.
@@ -612,8 +616,10 @@ function GoogleStyleExceptionDoc(props: GoogleStyleExceptionDocProps) {
   return <PyDoc>{children}</PyDoc>;
 }
 
-interface GoogleStyleAttributeDocProps
-  extends Omit<AttributeDocProps, "style"> {}
+interface GoogleStyleAttributeDocProps extends Omit<
+  AttributeDocProps,
+  "style"
+> {}
 
 /**
  * A component that creates a GoogleStyleAttributeDoc block for attributes.

package/src/components/PydanticClassDeclaration.tsx

@@ -95,8 +95,7 @@ const PydanticModelConfigKeys = [
 ] as const satisfies readonly (keyof PydanticModelConfigDictProps)[];
 
 export interface PydanticClassDeclarationProps
-  extends ClassDeclarationProps,
-    PydanticModelConfigDictProps {
+  extends ClassDeclarationProps, PydanticModelConfigDictProps {
   /**
    * Canonical structured config object for `ConfigDict(...)`. Values here are
    * merged with top-level config props.

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/src/symbols/python-output-symbol.ts

@@ -16,8 +16,7 @@ export interface PythonOutputSymbolOptions extends OutputSymbolOptions {
   typeOnly?: boolean;
 }
 
-export interface CreatePythonSymbolFunctionOptions
-  extends PythonOutputSymbolOptions {
+export interface CreatePythonSymbolFunctionOptions extends PythonOutputSymbolOptions {
   name: string;
 }