@alloy-js/python 0.2.0-dev.3 → 0.2.0-dev.4

package/dist/src/components/EnumMember.js

@@ -3,7 +3,7 @@ import { Show } from "@alloy-js/core";
 import { enumModule } from "../builtins/python.js";
 import { createPythonSymbol } from "../symbol-creation.js";
 import { Atom } from "./Atom.js";
-import { SimpleInlineComment } from "./index.js";
+import { SimpleInlineMemberComment } from "./PyDoc.js";
 /**
  * A Python enum member.
  *
@@ -38,7 +38,7 @@ export function EnumMember(props) {
         return props.doc !== undefined;
       },
       get children() {
-        return _$createComponent(SimpleInlineComment, {
+        return _$createComponent(SimpleInlineMemberComment, {
           get children() {
             return props.doc;
           }
@@ -56,7 +56,7 @@ export function EnumMember(props) {
       return props.doc !== undefined;
     },
     get children() {
-      return _$createComponent(SimpleInlineComment, {
+      return _$createComponent(SimpleInlineMemberComment, {
         get children() {
           return props.doc;
         }

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

@@ -1 +1 @@
-{"version":3,"names":["Show","enumModule","createPythonSymbol","Atom","SimpleInlineComment","EnumMember","props","autoReference","auto","undefined","value","sym","name","refkeys","refkey","valueCode","jsValue","_$createComponent","functional","_$memo","when","children","doc"],"sources":["../../../src/components/EnumMember.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAAoCA,IAAI,QAAQ,gBAAgB;AAChE,SAASC,UAAU,QAAQ,uBAAuB;AAClD,SAASC,kBAAkB,QAAQ,uBAAuB;AAE1D,SAASC,IAAI;AACb,SAASC,mBAAmB,QAAQ,YAAY;AAwChD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,KAAsB,EAAE;EACjD,MAAMC,aAAa,GAAGD,KAAK,CAACE,IAAI,KAAK,IAAI,GAAGP,UAAU,CAAC,GAAG,CAAC,CAACO,IAAI,GAAGC,SAAS;EAC5E,MAAMC,KAAK,GAAGJ,KAAK,CAACE,IAAI,KAAK,IAAI,IAAMD,aAAa,UAASD,KAAK,CAACI,KAAK;EACxE,MAAMC,GAAuB,GAAGT,kBAAkB,CAChDI,KAAK,CAACM,IAAI,EACV;IACEC,OAAO,EAAEP,KAAK,CAACQ;EACjB,CAAC,EACD,aACF,CAAC;EACD,MAAMC,SAAS,GACbT,KAAK,CAACU,OAAO,KAAKP,SAAS,GAAAQ,iBAAA,CAAId,IAAI;IAAA,IAACa,OAAOA,CAAA;MAAA,OAAEV,KAAK,CAACU,OAAO;IAAA;EAAA,KAAON,KAAK;EAExE,IAAIJ,KAAK,CAACY,UAAU,EAAE;IACpB,aAAAC,MAAA,OAEMR,GAAG,CAACC,IAAI,QAAAK,iBAAA,CAAGjB,IAAI;MAACoB,IAAI,EAAEL,SAAS,KAAKN,SAAS;MAAA,IAAAY,SAAA;QAAA,eAAMN,SAAS;MAAA;IAAA,IAAAE,iBAAA,CAC7DjB,IAAI;MAAA,IAACoB,IAAIA,CAAA;QAAA,OAAEd,KAAK,CAACgB,GAAG,KAAKb,SAAS;MAAA;MAAA,IAAAY,SAAA;QAAA,OAAAJ,iBAAA,CAChCb,mBAAmB;UAAA,IAAAiB,SAAA;YAAA,OAAEf,KAAK,CAACgB,GAAG;UAAA;QAAA;MAAA;IAAA;EAIvC;EACA,QAAAH,MAAA,OAEKR,GAAG,CAACC,IAAI,GAAAK,iBAAA,CACRjB,IAAI;IAACoB,IAAI,EAAEL,SAAS,KAAKN,SAAS;IAAA,IAAAY,SAAA;MAAA,eAAMN,SAAS;IAAA;EAAA,IAAAE,iBAAA,CACjDjB,IAAI;IAAA,IAACoB,IAAIA,CAAA;MAAA,OAAEd,KAAK,CAACgB,GAAG,KAAKb,SAAS;IAAA;IAAA,IAAAY,SAAA;MAAA,OAAAJ,iBAAA,CAChCb,mBAAmB;QAAA,IAAAiB,SAAA;UAAA,OAAEf,KAAK,CAACgB,GAAG;QAAA;MAAA;IAAA;EAAA;AAIvC","ignoreList":[]}
+{"version":3,"names":["Show","enumModule","createPythonSymbol","Atom","SimpleInlineMemberComment","EnumMember","props","autoReference","auto","undefined","value","sym","name","refkeys","refkey","valueCode","jsValue","_$createComponent","functional","_$memo","when","children","doc"],"sources":["../../../src/components/EnumMember.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAAoCA,IAAI,QAAQ,gBAAgB;AAChE,SAASC,UAAU,QAAQ,uBAAuB;AAClD,SAASC,kBAAkB,QAAQ,uBAAuB;AAE1D,SAASC,IAAI;AACb,SAASC,yBAAyB;AAwClC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,KAAsB,EAAE;EACjD,MAAMC,aAAa,GAAGD,KAAK,CAACE,IAAI,KAAK,IAAI,GAAGP,UAAU,CAAC,GAAG,CAAC,CAACO,IAAI,GAAGC,SAAS;EAC5E,MAAMC,KAAK,GAAGJ,KAAK,CAACE,IAAI,KAAK,IAAI,IAAMD,aAAa,UAASD,KAAK,CAACI,KAAK;EACxE,MAAMC,GAAuB,GAAGT,kBAAkB,CAChDI,KAAK,CAACM,IAAI,EACV;IACEC,OAAO,EAAEP,KAAK,CAACQ;EACjB,CAAC,EACD,aACF,CAAC;EACD,MAAMC,SAAS,GACbT,KAAK,CAACU,OAAO,KAAKP,SAAS,GAAAQ,iBAAA,CAAId,IAAI;IAAA,IAACa,OAAOA,CAAA;MAAA,OAAEV,KAAK,CAACU,OAAO;IAAA;EAAA,KAAON,KAAK;EAExE,IAAIJ,KAAK,CAACY,UAAU,EAAE;IACpB,aAAAC,MAAA,OAEMR,GAAG,CAACC,IAAI,QAAAK,iBAAA,CAAGjB,IAAI;MAACoB,IAAI,EAAEL,SAAS,KAAKN,SAAS;MAAA,IAAAY,SAAA;QAAA,eAAMN,SAAS;MAAA;IAAA,IAAAE,iBAAA,CAC7DjB,IAAI;MAAA,IAACoB,IAAIA,CAAA;QAAA,OAAEd,KAAK,CAACgB,GAAG,KAAKb,SAAS;MAAA;MAAA,IAAAY,SAAA;QAAA,OAAAJ,iBAAA,CAChCb,yBAAyB;UAAA,IAAAiB,SAAA;YAAA,OAAEf,KAAK,CAACgB,GAAG;UAAA;QAAA;MAAA;IAAA;EAI7C;EACA,QAAAH,MAAA,OAEKR,GAAG,CAACC,IAAI,GAAAK,iBAAA,CACRjB,IAAI;IAACoB,IAAI,EAAEL,SAAS,KAAKN,SAAS;IAAA,IAAAY,SAAA;MAAA,eAAMN,SAAS;IAAA;EAAA,IAAAE,iBAAA,CACjDjB,IAAI;IAAA,IAACoB,IAAIA,CAAA;MAAA,OAAEd,KAAK,CAACgB,GAAG,KAAKb,SAAS;IAAA;IAAA,IAAAY,SAAA;MAAA,OAAAJ,iBAAA,CAChCb,yBAAyB;QAAA,IAAAiB,SAAA;UAAA,OAAEf,KAAK,CAACgB,GAAG;QAAA;MAAA;IAAA;EAAA;AAI7C","ignoreList":[]}

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

@@ -0,0 +1,48 @@
+import { PythonOutputSymbol } from "../index.js";
+import { CallSignatureProps } from "./CallSignature.jsx";
+import { BaseDeclarationProps } from "./Declaration.js";
+/**
+ * Shared base interface for function-like components.
+ *
+ * @remarks
+ * This interface is consumed by public components like `FunctionDeclaration`,
+ * `MethodDeclaration`, and property method helpers. It combines declaration
+ * metadata with call signature shape.
+ */
+export interface CommonFunctionProps extends BaseDeclarationProps, CallSignatureProps {
+    /** Indicates that the function is async. */
+    async?: boolean;
+}
+/**
+ * Props for `BaseFunctionDeclaration`.
+ *
+ * @remarks
+ * This low-level component powers function/method-like declarations by
+ * handling symbol creation, parameter injection for instance/class methods,
+ * and common rendering concerns. Intended primarily for internal reuse.
+ */
+export interface BaseFunctionDeclarationProps extends CommonFunctionProps {
+    /** Indicates the type of function. */
+    functionType?: "instance" | "class" | "static";
+    /** Pre-created symbol to render. Must be provided by caller. */
+    sym: PythonOutputSymbol;
+}
+/**
+ * Base function declaration that handles instance/class/static parameter injection
+ * and symbol creation. Exported for internal reuse by method-like components.
+ *
+ * @example
+ * ```tsx
+ * // Not typically used directly. Prefer higher-level components.
+ * <BaseFunctionDeclaration name="helper" parameters={[{ name: "x" }]}>
+ *   return x
+ * </BaseFunctionDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * def helper(x):
+ *     return x
+ * ```
+ */
+export declare function BaseFunctionDeclaration(props: BaseFunctionDeclarationProps): import("@alloy-js/core").Children;
+//# sourceMappingURL=FunctionBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionBase.d.ts","sourceRoot":"","sources":["../../../src/components/FunctionBase.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAiB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAe,MAAM,kBAAkB,CAAC;AAIrE;;;;;;;GAOG;AACH,MAAM,WAAW,mBACf,SAAQ,oBAAoB,EAC1B,kBAAkB;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,sCAAsC;IACtC,YAAY,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/C,gEAAgE;IAChE,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,qCAgC1E"}

package/dist/src/components/FunctionBase.js

@@ -0,0 +1,91 @@
+import { createComponent as _$createComponent, mergeProps as _$mergeProps, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { Name, Show } from "@alloy-js/core";
+import { getCallSignatureProps } from "../utils.js";
+import { CallSignature } from "./CallSignature.js";
+import { Declaration } from "./Declaration.js";
+import { LexicalScope } from "./LexicalScope.js";
+import { PythonBlock } from "./PythonBlock.js";
+
+/**
+ * Shared base interface for function-like components.
+ *
+ * @remarks
+ * This interface is consumed by public components like `FunctionDeclaration`,
+ * `MethodDeclaration`, and property method helpers. It combines declaration
+ * metadata with call signature shape.
+ */
+
+/**
+ * Props for `BaseFunctionDeclaration`.
+ *
+ * @remarks
+ * This low-level component powers function/method-like declarations by
+ * handling symbol creation, parameter injection for instance/class methods,
+ * and common rendering concerns. Intended primarily for internal reuse.
+ */
+
+/**
+ * Base function declaration that handles instance/class/static parameter injection
+ * and symbol creation. Exported for internal reuse by method-like components.
+ *
+ * @example
+ * ```tsx
+ * // Not typically used directly. Prefer higher-level components.
+ * <BaseFunctionDeclaration name="helper" parameters={[{ name: "x" }]}>
+ *   return x
+ * </BaseFunctionDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * def helper(x):
+ *     return x
+ * ```
+ */
+export function BaseFunctionDeclaration(props) {
+  const asyncKwd = props.async ? "async " : "";
+  let parameters;
+  switch (props.functionType) {
+    case "instance":
+      parameters = [{
+        name: "self"
+      }, ...(props.parameters || [])];
+      break;
+    case "class":
+      parameters = [{
+        name: "cls"
+      }, ...(props.parameters || [])];
+      break;
+    default:
+      parameters = props.parameters;
+  }
+  const sym = props.sym;
+  return [_$createComponent(Declaration, _$mergeProps(props, {
+    nameKind: "function",
+    symbol: sym,
+    get children() {
+      return [asyncKwd, "def ", _$createComponent(Name, {}), _$createComponent(LexicalScope, {
+        get name() {
+          return sym.name;
+        },
+        get children() {
+          return [_$createComponent(CallSignature, _$mergeProps(() => getCallSignatureProps(props, {}), {
+            parameters: parameters
+          })), _$createComponent(PythonBlock, {
+            opener: ":",
+            get children() {
+              return [_$createComponent(Show, {
+                get when() {
+                  return Boolean(props.doc);
+                },
+                get children() {
+                  return props.doc;
+                }
+              }), _$memo(() => props.children ?? "pass")];
+            }
+          })];
+        }
+      })];
+    }
+  }))];
+}
+//# sourceMappingURL=FunctionBase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Name","Show","getCallSignatureProps","CallSignature","Declaration","LexicalScope","PythonBlock","BaseFunctionDeclaration","props","asyncKwd","async","parameters","functionType","name","sym","_$createComponent","_$mergeProps","nameKind","symbol","children","opener","when","Boolean","doc","_$memo"],"sources":["../../../src/components/FunctionBase.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,IAAI,EAAEC,IAAI,QAAQ,gBAAgB;AAE3C,SAASC,qBAAqB,QAAQ,aAAa;AACnD,SAASC,aAAa;AACtB,SAA+BC,WAAW,QAAQ,kBAAkB;AACpE,SAASC,YAAY;AACrB,SAASC,WAAW;;AAEpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,KAAmC,EAAE;EAC3E,MAAMC,QAAQ,GAAGD,KAAK,CAACE,KAAK,GAAG,QAAQ,GAAG,EAAE;EAC5C,IAAIC,UAAU;EACd,QAAQH,KAAK,CAACI,YAAY;IACxB,KAAK,UAAU;MACbD,UAAU,GAAG,CAAC;QAAEE,IAAI,EAAE;MAAO,CAAC,EAAE,IAAIL,KAAK,CAACG,UAAU,IAAI,EAAE,CAAC,CAAC;MAC5D;IACF,KAAK,OAAO;MACVA,UAAU,GAAG,CAAC;QAAEE,IAAI,EAAE;MAAM,CAAC,EAAE,IAAIL,KAAK,CAACG,UAAU,IAAI,EAAE,CAAC,CAAC;MAC3D;IACF;MACEA,UAAU,GAAGH,KAAK,CAACG,UAAU;EACjC;EACA,MAAMG,GAAuB,GAAGN,KAAK,CAACM,GAAG;EAEzC,QAAAC,iBAAA,CAEKX,WAAW,EAAAY,YAAA,CAAKR,KAAK;IAAES,QAAQ;IAAYC,MAAM,EAAEJ,GAAG;IAAA,IAAAK,SAAA;MAAA,QACpDV,QAAQ,UAAAM,iBAAA,CAAMf,IAAI,OAAAe,iBAAA,CAClBV,YAAY;QAAA,IAACQ,IAAIA,CAAA;UAAA,OAAEC,GAAG,CAACD,IAAI;QAAA;QAAA,IAAAM,SAAA;UAAA,QAAAJ,iBAAA,CACzBZ,aAAa,EAAAa,YAAA,OACRd,qBAAqB,CAACM,KAAK,EAAE,CAAC,CAAC,CAAC;YACpCG,UAAU,EAAEA;UAAU,KAAAI,iBAAA,CAEvBT,WAAW;YAACc,MAAM;YAAA,IAAAD,SAAA;cAAA,QAAAJ,iBAAA,CAChBd,IAAI;gBAAA,IAACoB,IAAIA,CAAA;kBAAA,OAAEC,OAAO,CAACd,KAAK,CAACe,GAAG,CAAC;gBAAA;gBAAA,IAAAJ,SAAA;kBAAA,OAAGX,KAAK,CAACe,GAAG;gBAAA;cAAA,IAAAC,MAAA,OACzChB,KAAK,CAACW,QAAQ,IAAI,MAAM;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAMrC","ignoreList":[]}

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

@@ -1,7 +1,5 @@
-import { CallSignatureProps } from "./CallSignature.jsx";
-import { BaseDeclarationProps } from "./Declaration.js";
-export interface FunctionDeclarationProps extends BaseDeclarationProps, CallSignatureProps {
-    async?: boolean;
+import type { CommonFunctionProps } from "./FunctionBase.js";
+export interface FunctionDeclarationProps extends CommonFunctionProps {
 }
 /**
  * A Python function declaration.
@@ -9,41 +7,23 @@ export interface FunctionDeclarationProps extends BaseDeclarationProps, CallSign
  * @example
  * ```tsx
  * <FunctionDeclaration
- *  name="my_function"
- *  returnType="int"
- *  parameters=[{name: "a", type: "int"},{name: "b", type: "str"}]>
+ *   name="my_function"
+ *   returnType="int"
+ *   parameters={[{ name: "a", type: { children: "int" } }, { name: "b", type: { children: "str" } }]}
+ * >
  *   return a + b
  * </FunctionDeclaration>
  * ```
  * This will generate:
  * ```python
  * def my_function(a: int, b: str) -> int:
- *   return a + b
- * ```
- */
-export declare function FunctionDeclaration(props: FunctionDeclarationProps): import("@alloy-js/core").Children;
-export interface InitFunctionDeclarationProps extends Omit<FunctionDeclarationProps, "name" | "instanceFunction" | "classFunction"> {
-}
-/**
- * A Python `__init__` function declaration.
- *
- * @example
- * ```tsx
- * <InitFunctionDeclaration>
- *   self.attribute = "value"
- * </InitFunctionDeclaration>
- * ```
- * This will generate:
- * ```python
- * def __init__(self: MyClass) -> None:
- *     self.attribute = "value"
+ *     return a + b
  * ```
  *
  * @remarks
- *
- * This is a convenience component that sets the name to `__init__`, marks it as
- * an instance function, and forces the name to be `__init__` without applying
- * the name policy.
+ * This component creates a Python function declaration with optional type annotations,
+ * parameters, and return types. It supports async functions and automatically
+ * handles symbol creation and emission.
  */
-export declare function InitFunctionDeclaration(props: InitFunctionDeclarationProps): import("@alloy-js/core").Children;
+export declare function FunctionDeclaration(props: FunctionDeclarationProps): import("@alloy-js/core/jsx-runtime").Children;
 //# sourceMappingURL=FunctionDeclaration.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FunctionDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/FunctionDeclaration.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAe,MAAM,kBAAkB,CAAC;AAIrE,MAAM,WAAW,wBACf,SAAQ,oBAAoB,EAC1B,kBAAkB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,qCA8BlE;AAED,MAAM,WAAW,4BACf,SAAQ,IAAI,CACV,wBAAwB,EACxB,MAAM,GAAG,kBAAkB,GAAG,eAAe,CAC9C;CAAG;AAEN;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,qCAS1E"}
+{"version":3,"file":"FunctionDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/FunctionDeclaration.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;CAAG;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,iDAGlE"}

package/dist/src/components/FunctionDeclaration.js

@@ -1,98 +1,41 @@
-import { createComponent as _$createComponent, mergeProps as _$mergeProps, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import { emitSymbol, Name, namekey, Show } from "@alloy-js/core";
-import { createPythonSymbol } from "../symbol-creation.js";
-import { getCallSignatureProps } from "../utils.js";
-import { CallSignature } from "./CallSignature.js";
-import { Declaration } from "./Declaration.js";
-import { PythonBlock } from "./PythonBlock.js";
-import { LexicalScope } from "./index.js";
+import { mergeProps as _$mergeProps, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createFunctionSymbol } from "../symbols/factories.js";
+import { BaseFunctionDeclaration } from "./FunctionBase.js";
+
+// Types are sourced from FunctionBase to avoid duplicate exports
+
+// Clean public interface extending common properties
+
 /**
  * A Python function declaration.
  *
  * @example
  * ```tsx
  * <FunctionDeclaration
- *  name="my_function"
- *  returnType="int"
- *  parameters=[{name: "a", type: "int"},{name: "b", type: "str"}]>
+ *   name="my_function"
+ *   returnType="int"
+ *   parameters={[{ name: "a", type: { children: "int" } }, { name: "b", type: { children: "str" } }]}
+ * >
  *   return a + b
  * </FunctionDeclaration>
  * ```
  * This will generate:
  * ```python
  * def my_function(a: int, b: str) -> int:
- *   return a + b
- * ```
- */
-export function FunctionDeclaration(props) {
-  const asyncKwd = props.async ? "async " : "";
-  const callSignatureProps = getCallSignatureProps(props, {});
-  const sym = createPythonSymbol(props.name, {
-    instance: props.instanceFunction,
-    refkeys: props.refkey
-  }, "function");
-  emitSymbol(sym);
-  return [_$createComponent(Declaration, _$mergeProps(props, {
-    nameKind: "function",
-    symbol: sym,
-    get children() {
-      return [asyncKwd, "def ", _$createComponent(Name, {}), _$createComponent(LexicalScope, {
-        get name() {
-          return sym.name;
-        },
-        get children() {
-          return [_$createComponent(CallSignature, _$mergeProps(callSignatureProps, {
-            get returnType() {
-              return props.returnType;
-            }
-          })), _$createComponent(PythonBlock, {
-            opener: ":",
-            get children() {
-              return [_$createComponent(Show, {
-                get when() {
-                  return Boolean(props.doc);
-                },
-                get children() {
-                  return props.doc;
-                }
-              }), _$memo(() => props.children ?? "pass")];
-            }
-          })];
-        }
-      })];
-    }
-  }))];
-}
-/**
- * A Python `__init__` function declaration.
- *
- * @example
- * ```tsx
- * <InitFunctionDeclaration>
- *   self.attribute = "value"
- * </InitFunctionDeclaration>
- * ```
- * This will generate:
- * ```python
- * def __init__(self: MyClass) -> None:
- *     self.attribute = "value"
+ *     return a + b
  * ```
  *
  * @remarks
- *
- * This is a convenience component that sets the name to `__init__`, marks it as
- * an instance function, and forces the name to be `__init__` without applying
- * the name policy.
+ * This component creates a Python function declaration with optional type annotations,
+ * parameters, and return types. It supports async functions and automatically
+ * handles symbol creation and emission.
  */
-export function InitFunctionDeclaration(props) {
-  return _$createComponent(FunctionDeclaration, _$mergeProps(props, {
-    get name() {
-      return namekey("__init__", {
-        ignoreNamePolicy: true
-      });
-    },
-    instanceFunction: true,
-    classFunction: false
+export function FunctionDeclaration(props) {
+  const sym = createFunctionSymbol(props.name, {
+    refkeys: props.refkey
+  });
+  return _$createComponent(BaseFunctionDeclaration, _$mergeProps(props, {
+    sym: sym
   }));
 }
 //# sourceMappingURL=FunctionDeclaration.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["emitSymbol","Name","namekey","Show","createPythonSymbol","getCallSignatureProps","CallSignature","Declaration","PythonBlock","LexicalScope","FunctionDeclaration","props","asyncKwd","async","callSignatureProps","sym","name","instance","instanceFunction","refkeys","refkey","_$createComponent","_$mergeProps","nameKind","symbol","children","returnType","opener","when","Boolean","doc","_$memo","InitFunctionDeclaration","ignoreNamePolicy","classFunction"],"sources":["../../../src/components/FunctionDeclaration.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,UAAU,EAAEC,IAAI,EAAEC,OAAO,EAAEC,IAAI,QAAQ,gBAAgB;AAChE,SAASC,kBAAkB,QAAQ,uBAAuB;AAC1D,SAASC,qBAAqB,QAAQ,aAAa;AACnD,SAASC,aAAa;AACtB,SAA+BC,WAAW,QAAQ,kBAAkB;AACpE,SAASC,WAAW;AACpB,SAASC,YAAY,QAAQ,YAAY;AAQzC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAACC,KAA+B,EAAE;EACnE,MAAMC,QAAQ,GAAGD,KAAK,CAACE,KAAK,GAAG,QAAQ,GAAG,EAAE;EAC5C,MAAMC,kBAAkB,GAAGT,qBAAqB,CAACM,KAAK,EAAE,CAAC,CAAC,CAAC;EAC3D,MAAMI,GAAG,GAAGX,kBAAkB,CAC5BO,KAAK,CAACK,IAAI,EACV;IACEC,QAAQ,EAAEN,KAAK,CAACO,gBAAgB;IAChCC,OAAO,EAAER,KAAK,CAACS;EACjB,CAAC,EACD,UACF,CAAC;EACDpB,UAAU,CAACe,GAAG,CAAC;EAEf,QAAAM,iBAAA,CAEKd,WAAW,EAAAe,YAAA,CAAKX,KAAK;IAAEY,QAAQ;IAAYC,MAAM,EAAET,GAAG;IAAA,IAAAU,SAAA;MAAA,QACpDb,QAAQ,UAAAS,iBAAA,CAAMpB,IAAI,OAAAoB,iBAAA,CAClBZ,YAAY;QAAA,IAACO,IAAIA,CAAA;UAAA,OAAED,GAAG,CAACC,IAAI;QAAA;QAAA,IAAAS,SAAA;UAAA,QAAAJ,iBAAA,CACzBf,aAAa,EAAAgB,YAAA,CACRR,kBAAkB;YAAA,IACtBY,UAAUA,CAAA;cAAA,OAAEf,KAAK,CAACe,UAAU;YAAA;UAAA,KAAAL,iBAAA,CAE7Bb,WAAW;YAACmB,MAAM;YAAA,IAAAF,SAAA;cAAA,QAAAJ,iBAAA,CAChBlB,IAAI;gBAAA,IAACyB,IAAIA,CAAA;kBAAA,OAAEC,OAAO,CAAClB,KAAK,CAACmB,GAAG,CAAC;gBAAA;gBAAA,IAAAL,SAAA;kBAAA,OAAGd,KAAK,CAACmB,GAAG;gBAAA;cAAA,IAAAC,MAAA,OACzCpB,KAAK,CAACc,QAAQ,IAAI,MAAM;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAMrC;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,uBAAuBA,CAACrB,KAAmC,EAAE;EAC3E,OAAAU,iBAAA,CACGX,mBAAmB,EAAAY,YAAA,CACdX,KAAK;IAAA,IACTK,IAAIA,CAAA;MAAA,OAAEd,OAAO,CAAC,UAAU,EAAE;QAAE+B,gBAAgB,EAAE;MAAK,CAAC,CAAC;IAAA;IACrDf,gBAAgB,EAAE,IAAI;IACtBgB,aAAa,EAAE;EAAK;AAG1B","ignoreList":[]}
+{"version":3,"names":["createFunctionSymbol","BaseFunctionDeclaration","FunctionDeclaration","props","sym","name","refkeys","refkey","_$createComponent","_$mergeProps"],"sources":["../../../src/components/FunctionDeclaration.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,oBAAoB,QAAQ,yBAAyB;AAE9D,SAASC,uBAAuB,QAAQ,mBAAmB;;AAE3D;;AAEA;;AAGA;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,SAASC,mBAAmBA,CAACC,KAA+B,EAAE;EACnE,MAAMC,GAAG,GAAGJ,oBAAoB,CAACG,KAAK,CAACE,IAAI,EAAE;IAAEC,OAAO,EAAEH,KAAK,CAACI;EAAO,CAAC,CAAC;EACvE,OAAAC,iBAAA,CAAQP,uBAAuB,EAAAQ,YAAA,CAAKN,KAAK;IAAEC,GAAG,EAAEA;EAAG;AACrD","ignoreList":[]}

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

@@ -0,0 +1,29 @@
+import { BaseFunctionDeclarationProps, CommonFunctionProps } from "./FunctionBase.js";
+/**
+ * Shared base props for all method-like declarations.
+ */
+export interface MethodDeclarationBaseProps extends CommonFunctionProps {
+    /** Indicates that the method is abstract. */
+    abstract?: boolean;
+}
+/**
+ * Internal base for method-like components.
+ *
+ * @remarks
+ * Applies `@abstractmethod` when requested and delegates to
+ * `BaseFunctionDeclaration` for the function/method body.
+ *
+ * @example
+ * ```tsx
+ * <MethodDeclarationBase name="do_work" functionType="instance">
+ *   return 1
+ * </MethodDeclarationBase>
+ * ```
+ * Generates:
+ * ```python
+ * def do_work(self):
+ *     return 1
+ * ```
+ */
+export declare function MethodDeclarationBase(props: MethodDeclarationBaseProps & Pick<BaseFunctionDeclarationProps, "functionType" | "sym">): import("@alloy-js/core/jsx-runtime").Children;
+//# sourceMappingURL=MethodBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MethodBase.d.ts","sourceRoot":"","sources":["../../../src/components/MethodBase.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,4BAA4B,EAC5B,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAC/B,IAAI,CAAC,4BAA4B,EAAE,cAAc,GAAG,KAAK,CAAC,iDAgB7D"}

package/dist/src/components/MethodBase.js

@@ -0,0 +1,32 @@
+import { memo as _$memo, createIntrinsic as _$createIntrinsic, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { abcModule } from "../builtins/python.js";
+import { BaseFunctionDeclaration } from "./FunctionBase.js";
+
+/**
+ * Shared base props for all method-like declarations.
+ */
+
+/**
+ * Internal base for method-like components.
+ *
+ * @remarks
+ * Applies `@abstractmethod` when requested and delegates to
+ * `BaseFunctionDeclaration` for the function/method body.
+ *
+ * @example
+ * ```tsx
+ * <MethodDeclarationBase name="do_work" functionType="instance">
+ *   return 1
+ * </MethodDeclarationBase>
+ * ```
+ * Generates:
+ * ```python
+ * def do_work(self):
+ *     return 1
+ * ```
+ */
+export function MethodDeclarationBase(props) {
+  const abstractMethod = props.abstract ? ["@", _$memo(() => abcModule["."].abstractmethod), _$createIntrinsic("hbr", {})] : undefined;
+  return [abstractMethod, _$createComponent(BaseFunctionDeclaration, props)];
+}
+//# sourceMappingURL=MethodBase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["abcModule","BaseFunctionDeclaration","MethodDeclarationBase","props","abstractMethod","abstract","_$memo","abstractmethod","_$createIntrinsic","undefined","_$createComponent"],"sources":["../../../src/components/MethodBase.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,SAAS,QAAQ,uBAAuB;AACjD,SACEC,uBAAuB,QAGlB,mBAAmB;;AAE1B;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CACnCC,KAC4D,EAC5D;EACA,MAAMC,cAAc,GAClBD,KAAK,CAACE,QAAQ,SAAAC,MAAA,OAERN,SAAS,CAAC,GAAG,CAAC,CAACO,cAAc,GAAAC,iBAAA,eAGjCC,SAAS;EAEb,QAEKL,cAAc,EAAAM,iBAAA,CACdT,uBAAuB,EAAKE,KAAK;AAGxC","ignoreList":[]}

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

@@ -0,0 +1,22 @@
+import type { MethodDeclarationBaseProps } from "./MethodBase.js";
+/**
+ * A Python instance method declaration component.
+ *
+ * @example
+ * ```tsx
+ * <py.MethodDeclaration name="do_work" parameters={[{ name: "value", type: "int" }]}>
+ *   return value * 2
+ * </py.MethodDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * def do_work(self, value: int) -> None:
+ *     return value * 2
+ * ```
+ *
+ * @remarks
+ * Automatically injects the `self` parameter for instance methods and enforces
+ * that the declaration appears within a class body.
+ */
+export declare function MethodDeclaration(props: MethodDeclarationBaseProps): import("@alloy-js/core/jsx-runtime").Children;
+//# sourceMappingURL=MethodDeclaration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MethodDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/MethodDeclaration.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGlE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,iDAGlE"}

package/dist/src/components/MethodDeclaration.js

@@ -0,0 +1,34 @@
+import { mergeProps as _$mergeProps, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createMethodSymbol } from "../symbols/factories.js";
+import { MethodDeclarationBase } from "./MethodBase.js";
+
+/**
+ * A Python instance method declaration component.
+ *
+ * @example
+ * ```tsx
+ * <py.MethodDeclaration name="do_work" parameters={[{ name: "value", type: "int" }]}>
+ *   return value * 2
+ * </py.MethodDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * def do_work(self, value: int) -> None:
+ *     return value * 2
+ * ```
+ *
+ * @remarks
+ * Automatically injects the `self` parameter for instance methods and enforces
+ * that the declaration appears within a class body.
+ */
+export function MethodDeclaration(props) {
+  const sym = createMethodSymbol(props.name, {
+    refkeys: props.refkey
+  });
+  return _$createComponent(MethodDeclarationBase, _$mergeProps({
+    functionType: "instance"
+  }, props, {
+    sym: sym
+  }));
+}
+//# sourceMappingURL=MethodDeclaration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["createMethodSymbol","MethodDeclarationBase","MethodDeclaration","props","sym","name","refkeys","refkey","_$createComponent","_$mergeProps","functionType"],"sources":["../../../src/components/MethodDeclaration.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,kBAAkB,QAAQ,yBAAyB;AAE5D,SAASC,qBAAqB,QAAQ,iBAAiB;;AAEvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,KAAiC,EAAE;EACnE,MAAMC,GAAG,GAAGJ,kBAAkB,CAACG,KAAK,CAACE,IAAI,EAAE;IAAEC,OAAO,EAAEH,KAAK,CAACI;EAAO,CAAC,CAAC;EACrE,OAAAC,iBAAA,CAAQP,qBAAqB,EAAAQ,YAAA;IAACC,YAAY;EAAA,GAAgBP,KAAK;IAAEC,GAAG,EAAEA;EAAG;AAC3E","ignoreList":[]}

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

@@ -0,0 +1,71 @@
+import { Children, Refkey } from "@alloy-js/core";
+import { CommonFunctionProps } from "./FunctionBase.js";
+/**
+ * Declares a Python property with optional getter, setter, and deleter methods.
+ *
+ * @example
+ * ```tsx
+ * <py.PropertyDeclaration name="name" type={{ children: "str" }}>
+ *   return self._name
+ * </py.PropertyDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * @property
+ * def name(self) -> str:
+ *     return self._name
+ * ```
+ *
+ * @example Setter and deleter
+ * ```tsx
+ * <py.PropertyDeclaration name="value" type={{ children: "int" }}>
+ *   return self._value
+ *   <py.PropertyDeclaration.Setter type={{ children: "int" }}>
+ *     self._value = value
+ *   </py.PropertyDeclaration.Setter>
+ *   <py.PropertyDeclaration.Deleter>
+ *     del self._value
+ *   </py.PropertyDeclaration.Deleter>
+ * </py.PropertyDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * @property
+ * def value(self) -> int:
+ *     return self._value
+ *
+ * @value.setter
+ * def value(self, value: int) -> None:
+ *     self._value = value
+ *
+ * @value.deleter
+ * def value(self) -> None:
+ *     del self._value
+ * ```
+ *
+ * @remarks
+ * The property must be declared within a class. The getter method is
+ * automatically generated using the `@property` decorator. Use the nested
+ * `Setter` and `Deleter` components to add mutators.
+ */
+export interface PropertyDeclarationProps {
+    name: string;
+    type?: Children;
+    children?: Children;
+    refkey?: Refkey;
+    abstract?: boolean;
+    doc?: Children;
+}
+export declare function PropertyDeclaration(props: PropertyDeclarationProps): Children;
+export declare namespace PropertyDeclaration {
+    var Setter: import("@alloy-js/core").Component<PropertyMethodDeclarationProps & {
+        type?: Children;
+    }> & Required<Pick<import("@alloy-js/core").Component<PropertyMethodDeclarationProps & {
+        type?: Children;
+    }>, "tag">>;
+    var Deleter: import("@alloy-js/core").Component<Omit<PropertyMethodDeclarationProps, "returnType">> & Required<Pick<import("@alloy-js/core").Component<Omit<PropertyMethodDeclarationProps, "returnType">>, "tag">>;
+}
+export interface PropertyMethodDeclarationProps extends Omit<CommonFunctionProps, "name"> {
+    abstract?: boolean;
+}
+//# sourceMappingURL=PropertyDeclaration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/PropertyDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAGR,MAAM,EASP,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,YA+DlE;yBA/De,mBAAmB;;eA6IkB,QAAQ;;eAAR,QAAQ;;;;AA5E7D,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}