@alloy-js/python 0.3.0-dev.4 → 0.3.0-dev.6

package/dist/src/components/CallSignature.d.ts

@@ -1,7 +1,8 @@
 import { Children } from "@alloy-js/core";
 import { ParameterDescriptor } from "../parameter-descriptor.js";
+export type ParameterMarker = "*" | "/";
 export interface CallSignatureParametersProps {
-    readonly parameters?: (ParameterDescriptor | string)[];
+    readonly parameters?: (ParameterDescriptor | ParameterMarker | string)[];
     readonly args?: boolean;
     readonly kwargs?: boolean;
 }
@@ -21,10 +22,11 @@ export interface CallSignatureParametersProps {
 export declare function CallSignatureParameters(props: CallSignatureParametersProps): Children;
 export interface CallSignatureProps {
     /**
-     * The parameters to the call signature. Can be an array of strings (for parameters
-     * which don't have a type or a default value) or {@link ParameterDescriptor}s.
+     * The parameters to the call signature. Can be an array of strings (for simple
+     * parameter names), {@link ParameterDescriptor}s, or special markers ("*" for
+     * keyword-only, "/" for positional-only).
      */
-    parameters?: (ParameterDescriptor | string)[];
+    parameters?: (ParameterDescriptor | ParameterMarker | string)[];
     /**
      * The type parameters of the call signature, e.g. for a generic function.
      * This is only supported in Python 3.12+.

package/dist/src/components/CallSignature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CallSignature.d.ts","sourceRoot":"","sources":["../../../src/components/CallSignature.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAMT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAKpC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,YA4B1E;AAuDD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC;IAE9C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AACD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,YAuBtD"}
+{"version":3,"file":"CallSignature.d.ts","sourceRoot":"","sources":["../../../src/components/CallSignature.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAMT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAKpC,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,CAAC;AAQxC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,mBAAmB,GAAG,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,YA0B1E;AAqDD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,mBAAmB,GAAG,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;IAEhE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AACD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,YAuBtD"}

package/dist/src/components/CallSignature.js

@@ -3,6 +3,9 @@ import { computed, createSymbolSlot, For, Show } from "@alloy-js/core";
 import { isParameterDescriptor } from "../parameter-descriptor.js";
 import { createPythonSymbol } from "../symbol-creation.js";
 import { Atom } from "./Atom.js";
+function isParameterMarker(param) {
+  return typeof param === "string" && (param === "*" || param === "/");
+}
 /**
  * A call signature parameters declaration, which can be used to define the
  * parameters of a function or other callables.
@@ -17,12 +20,9 @@ import { Atom } from "./Atom.js";
  * ```
  */
 export function CallSignatureParameters(props) {
-  const parameters = normalizeAndDeclareParameters(props.parameters ?? []);
   const parameterList = computed(() => {
-    const params = [];
-    // Add regular parameters
-    parameters.forEach(param => {
-      params.push(parameter(param));
+    const params = (props.parameters ?? []).map(p => {
+      return isParameterMarker(p) ? p : parameter(normalizeAndDeclareParameter(p));
     });
 
     // Add *args if specified
@@ -83,27 +83,24 @@ function parameter(param) {
     }
   });
 }
-function normalizeAndDeclareParameters(parameters) {
-  return parameters.map(param => {
-    if (isParameterDescriptor(param)) {
-      const TypeSlot = createSymbolSlot();
-      const symbol = createPythonSymbol(param.name, {
-        refkeys: param.refkey,
-        type: TypeSlot.firstSymbol
-      }, "parameter");
-      return {
-        ...param,
-        symbol,
-        TypeSlot
-      };
-    } else {
-      const symbol = createPythonSymbol(param, {}, "parameter");
-      return {
-        refkeys: symbol.refkeys,
-        symbol
-      };
-    }
-  });
+function normalizeAndDeclareParameter(param) {
+  if (isParameterDescriptor(param)) {
+    const TypeSlot = createSymbolSlot();
+    const symbol = createPythonSymbol(param.name, {
+      refkeys: param.refkey,
+      type: TypeSlot.firstSymbol
+    }, "parameter");
+    return {
+      ...param,
+      symbol,
+      TypeSlot
+    };
+  } else {
+    const symbol = createPythonSymbol(param, {}, "parameter");
+    return {
+      symbol
+    };
+  }
 }
 /**
  * A Python call signature, e.g. the part after the `def` keyword and the name in a

package/dist/src/components/CallSignature.js.map

@@ -1 +1 @@
-{"version":3,"names":["computed","createSymbolSlot","For","Show","isParameterDescriptor","createPythonSymbol","Atom","CallSignatureParameters","props","parameters","normalizeAndDeclareParameters","parameterList","params","forEach","param","push","parameter","args","kwargs","_$createComponent","each","comma","space","children","TypeSlot","_$createIntrinsic","_$memo","symbol","name","when","type","default","undefined","jsValue","map","refkeys","refkey","firstSymbol","CallSignature","sParams","typeParams","typeParameters","join","sReturnType","returnType"],"sources":["../../../src/components/CallSignature.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAEEA,QAAQ,EACRC,gBAAgB,EAChBC,GAAG,EACHC,IAAI,QAEC,gBAAgB;AACvB,SACEC,qBAAqB,QAEhB,4BAA4B;AACnC,SAASC,kBAAkB,QAAQ,uBAAuB;AAE1D,SAASC,IAAI;AAQb;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,KAAmC,EAAE;EAC3E,MAAMC,UAAU,GAAGC,6BAA6B,CAACF,KAAK,CAACC,UAAU,IAAI,EAAE,CAAC;EAExE,MAAME,aAAa,GAAGX,QAAQ,CAAC,MAAM;IACnC,MAAMY,MAAM,GAAG,EAAE;IACjB;IACAH,UAAU,CAACI,OAAO,CAAEC,KAAK,IAAK;MAC5BF,MAAM,CAACG,IAAI,CAACC,SAAS,CAACF,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC;;IAEF;IACA,IAAIN,KAAK,CAACS,IAAI,EAAE;MACdL,MAAM,CAACG,IAAI,CAAC,OAAO,CAAC;IACtB;;IAEA;IACA,IAAIP,KAAK,CAACU,MAAM,EAAE;MAChBN,MAAM,CAACG,IAAI,CAAC,UAAU,CAAC;IACzB;IAEA,OAAOH,MAAM;EACf,CAAC,CAAC;EAEF,OAAAO,iBAAA,CACGjB,GAAG;IAACkB,IAAI,EAAET,aAAa;IAAEU,KAAK;IAACC,KAAK;IAAAC,QAAA,EACjCT,KAAK,IAAKA;EAAK;AAGvB;AAEA,SAASE,SAASA,CAACF,KAAkC,EAAE;EACrD,MAAMU,QAAQ,GAAGV,KAAK,CAACU,QAAS,CAAC,CAAC;EAClC,OAAAC,iBAAA;IAAA,IAAAF,SAAA;MAAA,QAAAG,MAAA,OAEKZ,KAAK,CAACa,MAAM,CAACC,IAAI,GAAAT,iBAAA,CACjBhB,IAAI;QAAA,IAAC0B,IAAIA,CAAA;UAAA,OAAE,CAAC,CAACf,KAAK,CAACgB,IAAI;QAAA;QAAA,IAAAP,SAAA;UAAA,cAAAJ,iBAAA,CACnBK,QAAQ;YAAA,IAAAD,SAAA;cAAA,OAAET,KAAK,CAACgB,IAAI;YAAA;UAAA;QAAA;MAAA,IAAAX,iBAAA,CAExBhB,IAAI;QAAA,IAAC0B,IAAIA,CAAA;UAAA,OAAEf,KAAK,CAACiB,OAAO,KAAKC,SAAS;QAAA;QAAA,IAAAT,SAAA;UAAA,QAAAJ,iBAAA,CACpChB,IAAI;YAAA,IAAC0B,IAAIA,CAAA;cAAA,OAAE,CAACf,KAAK,CAACgB,IAAI;YAAA;YAAAP,QAAA;UAAA,IAAAJ,iBAAA,CACtBhB,IAAI;YAAA,IAAC0B,IAAIA,CAAA;cAAA,OAAE,CAAC,CAACf,KAAK,CAACgB,IAAI;YAAA;YAAAP,QAAA;UAAA,KAAAJ,iBAAA,CAErBb,IAAI;YAAA,IAAC2B,OAAOA,CAAA;cAAA,OAAEnB,KAAK,CAACiB,OAAO;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAKtC;AAQA,SAASrB,6BAA6BA,CACpCD,UAA4C,EACb;EAC/B,OAAOA,UAAU,CAACyB,GAAG,CAAEpB,KAAK,IAAK;IAC/B,IAAIV,qBAAqB,CAACU,KAAK,CAAC,EAAE;MAChC,MAAMU,QAAQ,GAAGvB,gBAAgB,CAAC,CAAC;MAEnC,MAAM0B,MAAM,GAAGtB,kBAAkB,CAC/BS,KAAK,CAACc,IAAI,EACV;QACEO,OAAO,EAAErB,KAAK,CAACsB,MAAM;QACrBN,IAAI,EAAEN,QAAQ,CAACa;MACjB,CAAC,EACD,WACF,CAAC;MAED,OAAO;QACL,GAAGvB,KAAK;QACRa,MAAM;QACNH;MACF,CAAC;IACH,CAAC,MAAM;MACL,MAAMG,MAAM,GAAGtB,kBAAkB,CAACS,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC;MACzD,OAAO;QAAEqB,OAAO,EAAER,MAAM,CAACQ,OAAO;QAAER;MAAO,CAAC;IAC5C;EACF,CAAC,CAAC;AACJ;AA8BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASW,aAAaA,CAAC9B,KAAyB,EAAE;EACvD,MAAM+B,OAAO,GAAApB,iBAAA,CACVZ,uBAAuB;IAAA,IACtBE,UAAUA,CAAA;MAAA,OAAED,KAAK,CAACC,UAAU;IAAA;IAAA,IAC5BQ,IAAIA,CAAA;MAAA,OAAET,KAAK,CAACS,IAAI;IAAA;IAAA,IAChBC,MAAMA,CAAA;MAAA,OAAEV,KAAK,CAACU,MAAM;IAAA;EAAA,EAEvB;EACD,MAAMsB,UAAU,GACdhC,KAAK,CAACiC,cAAc,GAAG,IAAIjC,KAAK,CAACiC,cAAc,CAACC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;EACpE,MAAMC,WAAW,GACfnC,KAAK,CAACoC,UAAU,IAEX,MAAM,EAAAlB,MAAA,OACNlB,KAAK,CAACoC,UAAU,KAEnBZ,SAAS;EAEb,QAEKQ,UAAU,OAAGD,OAAO,OAAGI,WAAW;AAGzC","ignoreList":[]}
+{"version":3,"names":["computed","createSymbolSlot","For","Show","isParameterDescriptor","createPythonSymbol","Atom","isParameterMarker","param","CallSignatureParameters","props","parameterList","params","parameters","map","p","parameter","normalizeAndDeclareParameter","args","push","kwargs","_$createComponent","each","comma","space","children","TypeSlot","_$createIntrinsic","_$memo","symbol","name","when","type","default","undefined","jsValue","refkeys","refkey","firstSymbol","CallSignature","sParams","typeParams","typeParameters","join","sReturnType","returnType"],"sources":["../../../src/components/CallSignature.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/components/FutureStatement.d.ts

@@ -0,0 +1,35 @@
+import { type Children } from "@alloy-js/core";
+export interface FutureStatementProps {
+    /**
+     * The name of the feature to import from __future__.
+     */
+    feature: string;
+}
+/**
+ * A future statement that imports features from __future__.
+ *
+ * Future statements are directives to the compiler that a particular module
+ * should be compiled using syntax or semantics from a future Python release.
+ * They must appear near the top of the module, after the module docstring (if any).
+ *
+ * Use this in the `futureImports` prop of SourceFile to ensure proper placement.
+ *
+ * @example
+ * ```tsx
+ * <SourceFile path="models.py" futureImports={<FutureStatement feature="annotations" />}>
+ *   <ClassDeclaration name="User">
+ *     <PropertyDeclaration name="manager" type="User" />
+ *   </ClassDeclaration>
+ * </SourceFile>
+ * ```
+ * renders to
+ * ```py
+ * from __future__ import annotations
+ *
+ *
+ * class User:
+ *     manager: User
+ * ```
+ */
+export declare function FutureStatement(props: FutureStatementProps): Children;
+//# sourceMappingURL=FutureStatement.d.ts.map

package/dist/src/components/FutureStatement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FutureStatement.d.ts","sourceRoot":"","sources":["../../../src/components/FutureStatement.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,QAAQ,CAErE"}

package/dist/src/components/FutureStatement.js

@@ -0,0 +1,31 @@
+import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
+/**
+ * A future statement that imports features from __future__.
+ *
+ * Future statements are directives to the compiler that a particular module
+ * should be compiled using syntax or semantics from a future Python release.
+ * They must appear near the top of the module, after the module docstring (if any).
+ *
+ * Use this in the `futureImports` prop of SourceFile to ensure proper placement.
+ *
+ * @example
+ * ```tsx
+ * <SourceFile path="models.py" futureImports={<FutureStatement feature="annotations" />}>
+ *   <ClassDeclaration name="User">
+ *     <PropertyDeclaration name="manager" type="User" />
+ *   </ClassDeclaration>
+ * </SourceFile>
+ * ```
+ * renders to
+ * ```py
+ * from __future__ import annotations
+ *
+ *
+ * class User:
+ *     manager: User
+ * ```
+ */
+export function FutureStatement(props) {
+  return ["from __future__ import ", _$memo(() => props.feature)];
+}
+//# sourceMappingURL=FutureStatement.js.map

package/dist/src/components/FutureStatement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FutureStatement","props","_$memo","feature"],"sources":["../../../src/components/FutureStatement.tsx"],"sourcesContent":[null],"mappings":";AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,eAAeA,CAACC,KAA2B,EAAY;EACrE,mCAAAC,MAAA,OAAiCD,KAAK,CAACE,OAAO;AAChD","ignoreList":[]}

package/dist/src/components/SourceFile.d.ts

@@ -17,17 +17,23 @@ export interface SourceFileProps {
      */
     children?: Children;
     /**
-     * Header comment to add to the file, which will be rendered at the top of the file.
+     * Content to render at the very top of the file, before everything else.
+     * Use this for shebang lines, encoding declarations, or license headers.
      */
     header?: Children;
     /**
-     * Comment to add to the header, which will be rendered as a comment in the file.
+     * 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.
      */
     headerComment?: string;
     /**
      * Documentation for this module, which will be rendered as a module-level docstring.
      */
     doc?: Children;
+    /**
+     * __future__ imports to render after the docstring but before regular imports.
+     */
+    futureImports?: Children;
 }
 /**
  * A Python source file component that represents a Python file in the source directory.

package/dist/src/components/SourceFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAQhB,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,uBAAuB,CAC3B,CAAC;AAEpD,wBAAgB,aAAa,4BAE5B;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,YAgChD"}
+{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAShB,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AA+CxD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,uBAAuB,CAC3B,CAAC;AAEpD,wBAAgB,aAAa,4BAE5B;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,YAqGhD"}

package/dist/src/components/SourceFile.js

@@ -1,9 +1,45 @@
-import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import { SourceFile as CoreSourceFile, createNamedContext, List, Scope, Show, SourceDirectoryContext, useContext } from "@alloy-js/core";
+import { memo as _$memo, createIntrinsic as _$createIntrinsic, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { childrenArray, SourceFile as CoreSourceFile, createNamedContext, isComponentCreator, List, Scope, Show, SourceDirectoryContext, useContext } from "@alloy-js/core";
 import { join } from "pathe";
 import { PythonModuleScope } from "../symbols/index.js";
 import { ImportStatements } from "./ImportStatement.js";
+import { SimpleCommentBlock } from "./PyDoc.js";
 import { Reference } from "./Reference.js";
+
+// Non top-level definitions
+const NON_DEFINITION_NAMES = new Set(["VariableDeclaration", "MemberExpression", "FunctionCallExpression", "ClassInstantiation", "Reference"]);
+
+// Wrapper components that we should look inside to find the actual first child
+const WRAPPER_COMPONENT_NAMES = new Set(["StatementList"]);
+
+/**
+ * Checks if the first child is a top-level definition (function or class).
+ * PEP 8 requires 2 blank lines before top-level function and class definitions,
+ * but not before other statements like variable assignments.
+ *
+ * Returns true only if there are children and the first child is a definition.
+ */
+function firstChildIsDefinition(children) {
+  if (!children) return false;
+  const arr = childrenArray(() => children);
+  if (arr.length === 0) return false;
+  const first = arr[0];
+
+  // Non-component children (strings, numbers, refkeys, etc.) are not definitions
+  if (!isComponentCreator(first)) {
+    return false;
+  }
+  const name = first.component.name;
+  if (NON_DEFINITION_NAMES.has(name)) {
+    return false;
+  }
+  // Look inside wrapper components
+  if (WRAPPER_COMPONENT_NAMES.has(name) && first.props?.children) {
+    return firstChildIsDefinition(first.props.children);
+  }
+  // If we get here, it's likely a definition (FunctionDeclaration, ClassDeclaration, etc.)
+  return true;
+}
 export const PythonSourceFileContext = createNamedContext("@alloy-js/python SourceFile");
 export function useSourceFile() {
   return useContext(PythonSourceFileContext);
@@ -55,14 +91,84 @@ export function SourceFile(props) {
     scope: scope,
     module: path
   };
+
+  // Check if there are any children
+  const hasChildren = props.children !== undefined && childrenArray(() => props.children).length > 0;
+
+  // PEP 8 requires 2 blank lines before top-level function/class definitions
+  const needsExtraSpacing = firstChildIsDefinition(props.children);
+
+  // Check if there's any preamble content (header, doc, imports, etc.)
+  const hasPreamble = props.header !== undefined || props.headerComment !== undefined || props.doc !== undefined || props.futureImports !== undefined;
   return _$createComponent(CoreSourceFile, {
     get path() {
       return props.path;
     },
     filetype: "py",
     reference: Reference,
+    get header() {
+      return props.header;
+    },
     get children() {
       return [_$createComponent(Show, {
+        get when() {
+          return props.header !== undefined && props.headerComment === undefined && (props.doc !== undefined || props.futureImports !== undefined || hasChildren);
+        },
+        get children() {
+          return _$createIntrinsic("hbr", {});
+        }
+      }), _$createComponent(Show, {
+        get when() {
+          return props.headerComment !== undefined;
+        },
+        get children() {
+          return [_$createComponent(SimpleCommentBlock, {
+            get children() {
+              return props.headerComment;
+            }
+          }), _$createComponent(Show, {
+            get when() {
+              return props.doc !== undefined;
+            },
+            get children() {
+              return _$createIntrinsic("hbr", {});
+            }
+          }), _$createComponent(Show, {
+            get when() {
+              return props.doc === undefined && (props.futureImports !== undefined || hasChildren);
+            },
+            get children() {
+              return [_$createIntrinsic("hbr", {}), _$createIntrinsic("hbr", {})];
+            }
+          })];
+        }
+      }), _$createComponent(Show, {
+        get when() {
+          return props.doc !== undefined;
+        },
+        get children() {
+          return [_$memo(() => props.doc), _$createComponent(Show, {
+            get when() {
+              return props.futureImports !== undefined || hasChildren;
+            },
+            get children() {
+              return _$createIntrinsic("hbr", {});
+            }
+          })];
+        }
+      }), _$createComponent(Show, {
+        get when() {
+          return props.futureImports !== undefined;
+        },
+        get children() {
+          return [_$memo(() => props.futureImports), _$createComponent(Show, {
+            when: hasChildren,
+            get children() {
+              return [_$createIntrinsic("hbr", {}), _$createIntrinsic("hbr", {})];
+            }
+          })];
+        }
+      }), _$createComponent(Show, {
         get when() {
           return scope.importedModules.size > 0;
         },
@@ -71,14 +177,19 @@ export function SourceFile(props) {
             get records() {
               return scope.importedModules;
             }
-          }), _$createIntrinsic("hbr", {}), _$createIntrinsic("hbr", {})];
+          }), _$createComponent(Show, {
+            when: hasChildren,
+            get children() {
+              return [_$createIntrinsic("hbr", {}), _$createIntrinsic("hbr", {})];
+            }
+          })];
         }
       }), _$createComponent(Show, {
         get when() {
-          return props.doc !== undefined;
+          return needsExtraSpacing && (hasPreamble || scope.importedModules.size > 0);
         },
         get children() {
-          return [_$memo(() => props.doc), _$createIntrinsic("hbr", {}), _$createIntrinsic("hbr", {})];
+          return _$createIntrinsic("hbr", {});
         }
       }), _$createComponent(PythonSourceFileContext.Provider, {
         value: sfContext,
@@ -86,10 +197,15 @@ export function SourceFile(props) {
           return _$createComponent(Scope, {
             value: scope,
             get children() {
-              return _$createComponent(List, {
-                doubleHardline: true,
+              return _$createComponent(Show, {
+                when: hasChildren,
                 get children() {
-                  return props.children;
+                  return _$createComponent(List, {
+                    doubleHardline: true,
+                    get children() {
+                      return props.children;
+                    }
+                  });
                 }
               });
             }

package/dist/src/components/SourceFile.js.map

@@ -1 +1 @@
-{"version":3,"names":["SourceFile","CoreSourceFile","createNamedContext","List","Scope","Show","SourceDirectoryContext","useContext","join","PythonModuleScope","ImportStatements","Reference","PythonSourceFileContext","useSourceFile","props","directoryContext","currentDir","path","replace","scope","undefined","sfContext","module","_$createComponent","filetype","reference","children","when","importedModules","size","records","_$createIntrinsic","doc","_$memo","Provider","value","doubleHardline"],"sources":["../../../src/components/SourceFile.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAEEA,UAAU,IAAIC,cAAc,EAC5BC,kBAAkB,EAClBC,IAAI,EACJC,KAAK,EACLC,IAAI,EACJC,sBAAsB,EACtBC,UAAU,QAEL,gBAAgB;AACvB,SAASC,IAAI,QAAQ,OAAO;AAC5B,SAASC,iBAAiB,QAAQ,qBAAqB;AACvD,SAASC,gBAAgB,QAAQ,sBAAsB;AACvD,SAASC,SAAS,QAAQ,gBAAgB;AAQ1C,OAAO,MAAMC,uBAAkE,GAC7EV,kBAAkB,CAAC,6BAA6B,CAAC;AAEnD,OAAO,SAASW,aAAaA,CAAA,EAAG;EAC9B,OAAON,UAAU,CAACK,uBAAuB,CAAC;AAC5C;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASZ,UAAUA,CAACc,KAAsB,EAAE;EACjD,MAAMC,gBAAgB,GAAGR,UAAU,CAACD,sBAAsB,CAAE;EAC5D,MAAMU,UAAU,GAAGD,gBAAgB,CAACE,IAAI;EACxC;EACA,MAAMA,IAAY,GAAGT,IAAI,CAACQ,UAAU,EAAEF,KAAK,CAACG,IAAI,CAAC,CAC9CC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CACpBA,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;EACtB,MAAMC,KAAK,GAAG,IAAIV,iBAAiB,CAACQ,IAAI,EAAEG,SAAS,CAAC;EACpD,MAAMC,SAAkC,GAAG;IACzCF,KAAK,EAAEA,KAAK;IACZG,MAAM,EAAEL;EACV,CAAC;EAED,OAAAM,iBAAA,CACGtB,cAAc;IAAA,IAACgB,IAAIA,CAAA;MAAA,OAAEH,KAAK,CAACG,IAAI;IAAA;IAAEO,QAAQ;IAAMC,SAAS,EAAEd,SAAS;IAAA,IAAAe,SAAA;MAAA,QAAAH,iBAAA,CACjElB,IAAI;QAAA,IAACsB,IAAIA,CAAA;UAAA,OAAER,KAAK,CAACS,eAAe,CAACC,IAAI,GAAG,CAAC;QAAA;QAAA,IAAAH,SAAA;UAAA,QAAAH,iBAAA,CACvCb,gBAAgB;YAAA,IAACoB,OAAOA,CAAA;cAAA,OAAEX,KAAK,CAACS,eAAe;YAAA;UAAA,IAAAG,iBAAA,aAAAA,iBAAA;QAAA;MAAA,IAAAR,iBAAA,CAIjDlB,IAAI;QAAA,IAACsB,IAAIA,CAAA;UAAA,OAAEb,KAAK,CAACkB,GAAG,KAAKZ,SAAS;QAAA;QAAA,IAAAM,SAAA;UAAA,QAAAO,MAAA,OAChCnB,KAAK,CAACkB,GAAG,GAAAD,iBAAA,aAAAA,iBAAA;QAAA;MAAA,IAAAR,iBAAA,CAIXX,uBAAuB,CAACsB,QAAQ;QAACC,KAAK,EAAEd,SAAS;QAAA,IAAAK,SAAA;UAAA,OAAAH,iBAAA,CAC/CnB,KAAK;YAAC+B,KAAK,EAAEhB,KAAK;YAAA,IAAAO,SAAA;cAAA,OAAAH,iBAAA,CAChBpB,IAAI;gBAACiC,cAAc;gBAAA,IAAAV,SAAA;kBAAA,OAAEZ,KAAK,CAACY,QAAQ;gBAAA;cAAA;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAK9C","ignoreList":[]}
+{"version":3,"names":["childrenArray","SourceFile","CoreSourceFile","createNamedContext","isComponentCreator","List","Scope","Show","SourceDirectoryContext","useContext","join","PythonModuleScope","ImportStatements","SimpleCommentBlock","Reference","NON_DEFINITION_NAMES","Set","WRAPPER_COMPONENT_NAMES","firstChildIsDefinition","children","arr","length","first","name","component","has","props","PythonSourceFileContext","useSourceFile","directoryContext","currentDir","path","replace","scope","undefined","sfContext","module","hasChildren","needsExtraSpacing","hasPreamble","header","headerComment","doc","futureImports","_$createComponent","filetype","reference","when","_$createIntrinsic","_$memo","importedModules","size","records","Provider","value","doubleHardline"],"sources":["../../../src/components/SourceFile.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/components/index.d.ts

@@ -12,6 +12,7 @@ export * from "./EnumMember.js";
 export type { CommonFunctionProps } from "./FunctionBase.js";
 export * from "./FunctionCallExpression.js";
 export * from "./FunctionDeclaration.js";
+export * from "./FutureStatement.js";
 export * from "./ImportStatement.js";
 export * from "./LexicalScope.js";
 export * from "./MemberExpression.js";

package/dist/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/dist/src/components/index.js

@@ -11,6 +11,7 @@ export * from "./EnumDeclaration.js";
 export * from "./EnumMember.js";
 export * from "./FunctionCallExpression.js";
 export * from "./FunctionDeclaration.js";
+export * from "./FutureStatement.js";
 export * from "./ImportStatement.js";
 export * from "./LexicalScope.js";
 export * from "./MemberExpression.js";

package/dist/src/components/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/components/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,WAAW;AACzB,cAAc,oBAAoB;AAClC,cAAc,uBAAuB;AACrC,cAAc,yBAAyB;AACvC,cAAc,6BAA6B;AAC3C,cAAc,6BAA6B;AAC3C,cAAc,2BAA2B;AACzC,cAAc,kBAAkB;AAChC,cAAc,8BAA8B;AAC5C,cAAc,sBAAsB;AACpC,cAAc,iBAAiB;AAE/B,cAAc,6BAA6B;AAC3C,cAAc,0BAA0B;AACxC,cAAc,sBAAsB;AACpC,cAAc,mBAAmB;AACjC,cAAc,uBAAuB;AACrC;AAEA,cAAc,wBAAwB;AACtC,cAAc,0BAA0B;AACxC,cAAc,YAAY;AAC1B,cAAc,kBAAkB;AAChC,cAAc,gBAAgB;AAC9B,cAAc,iBAAiB;AAC/B,cAAc,oBAAoB;AAClC,cAAc,8BAA8B;AAC5C,cAAc,oBAAoB;AAClC,cAAc,oBAAoB;AAClC,cAAc,0BAA0B;AACxC,cAAc,0BAA0B;AAAC","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../src/components/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,WAAW;AACzB,cAAc,oBAAoB;AAClC,cAAc,uBAAuB;AACrC,cAAc,yBAAyB;AACvC,cAAc,6BAA6B;AAC3C,cAAc,6BAA6B;AAC3C,cAAc,2BAA2B;AACzC,cAAc,kBAAkB;AAChC,cAAc,8BAA8B;AAC5C,cAAc,sBAAsB;AACpC,cAAc,iBAAiB;AAE/B,cAAc,6BAA6B;AAC3C,cAAc,0BAA0B;AACxC,cAAc,sBAAsB;AACpC,cAAc,sBAAsB;AACpC,cAAc,mBAAmB;AACjC,cAAc,uBAAuB;AACrC;AAEA,cAAc,wBAAwB;AACtC,cAAc,0BAA0B;AACxC,cAAc,YAAY;AAC1B,cAAc,kBAAkB;AAChC,cAAc,gBAAgB;AAC9B,cAAc,iBAAiB;AAC/B,cAAc,oBAAoB;AAClC,cAAc,8BAA8B;AAC5C,cAAc,oBAAoB;AAClC,cAAc,oBAAoB;AAClC,cAAc,0BAA0B;AACxC,cAAc,0BAA0B;AAAC","ignoreList":[]}

package/dist/test/callsignatures.test.js

@@ -84,6 +84,41 @@ describe("Call Signature Parameters", () => {
       a: int = 5, b: str = "hello"
     `);
   });
+  it("renders keyword-only parameters with * marker", () => {
+    const result = toSourceText([_$createComponent(py.CallSignatureParameters, {
+      parameters: [{
+        name: "a",
+        type: "str"
+      }, "*", {
+        name: "b",
+        type: "int",
+        default: 10
+      }, {
+        name: "c",
+        type: "bool",
+        default: true
+      }]
+    })]);
+    expect(result).toRenderTo(d`
+      a: str, *, b: int = 10, c: bool = True
+    `);
+  });
+  it("renders only keyword-only parameters with * marker at start", () => {
+    const result = toSourceText([_$createComponent(py.CallSignatureParameters, {
+      parameters: ["*", {
+        name: "a",
+        type: "str",
+        default: "hello"
+      }, {
+        name: "b",
+        type: "int",
+        default: 42
+      }]
+    })]);
+    expect(result).toRenderTo(d`
+      *, a: str = "hello", b: int = 42
+    `);
+  });
 });
 describe("Call Signature", () => {
   it("renders a call signature with strings", () => {
@@ -251,5 +286,97 @@ describe("Call Signature - Parameter Descriptors", () => {
       [T, U](a: int, b: str = "default_value") -> int
     `);
   });
+  it("renders a call signature with keyword-only parameters using * marker", () => {
+    const result = toSourceText([_$createComponent(py.CallSignature, {
+      parameters: [{
+        name: "id",
+        type: "str"
+      }, "*", {
+        name: "locale",
+        type: "str",
+        default: "en-US"
+      }, {
+        name: "debug",
+        type: "bool",
+        default: false
+      }],
+      returnType: "str"
+    })]);
+    expect(result).toRenderTo(d`
+      (id: str, *, locale: str = "en-US", debug: bool = False) -> str
+    `);
+  });
+  it("renders a call signature with only keyword-only parameters", () => {
+    const result = toSourceText([_$createComponent(py.CallSignature, {
+      parameters: ["*", {
+        name: "name",
+        type: "str",
+        default: "alice"
+      }, {
+        name: "age",
+        type: "int",
+        default: 30
+      }],
+      returnType: "None"
+    })]);
+    expect(result).toRenderTo(d`
+      (*, name: str = "alice", age: int = 30) -> None
+    `);
+  });
+  it("renders a call signature with positional, keyword-only, and *args/**kwargs", () => {
+    const result = toSourceText([_$createComponent(py.CallSignature, {
+      parameters: [{
+        name: "a",
+        type: "int"
+      }, "*", {
+        name: "b",
+        type: "str",
+        default: "hello"
+      }],
+      args: true,
+      kwargs: true,
+      returnType: "None"
+    })]);
+    expect(result).toRenderTo(d`
+      (a: int, *, b: str = "hello", *args, **kwargs) -> None
+    `);
+  });
+  it("renders a call signature with positional-only parameters using / marker", () => {
+    const result = toSourceText([_$createComponent(py.CallSignature, {
+      parameters: [{
+        name: "a",
+        type: "int"
+      }, {
+        name: "b",
+        type: "str"
+      }, "/", {
+        name: "c",
+        type: "bool"
+      }],
+      returnType: "None"
+    })]);
+    expect(result).toRenderTo(d`
+      (a: int, b: str, /, c: bool) -> None
+    `);
+  });
+  it("renders a call signature with positional-only, regular, and keyword-only parameters", () => {
+    const result = toSourceText([_$createComponent(py.CallSignature, {
+      parameters: [{
+        name: "a",
+        type: "int"
+      }, "/", {
+        name: "b",
+        type: "str"
+      }, "*", {
+        name: "c",
+        type: "bool",
+        default: true
+      }],
+      returnType: "None"
+    })]);
+    expect(result).toRenderTo(d`
+      (a: int, /, b: str, *, c: bool = True) -> None
+    `);
+  });
 });
 //# sourceMappingURL=callsignatures.test.js.map