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

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

@@ -1,3 +1,4 @@
+import { type Children } from "@alloy-js/core";
 import { PythonOutputSymbol } from "../index.js";
 import { CallSignatureProps } from "./CallSignature.jsx";
 import { BaseDeclarationProps } from "./Declaration.js";
@@ -12,6 +13,35 @@ import { BaseDeclarationProps } from "./Declaration.js";
 export interface CommonFunctionProps extends BaseDeclarationProps, CallSignatureProps {
     /** Indicates that the function is async. */
     async?: boolean;
+    /**
+     * Decorators rendered above `def`, in source order — `decorators[0]` is
+     * topmost. By Python's bottom-up application order, the topmost entry is
+     * the **outermost** decorator (applied last) and wraps the result of every
+     * decorator below it.
+     *
+     * Each entry should produce a complete decorator line (typically starting
+     * with `@`). Falsy entries (other than `0`) are skipped, so conditional
+     * decorators can be provided inline when needed.
+     *
+     * When used through wrappers that emit an intrinsic decorator
+     * (`ClassMethodDeclaration` → `@classmethod`,
+     * `StaticMethodDeclaration` → `@staticmethod`,
+     * `PropertyDeclaration` → `@property`), these decorators are rendered
+     * **above** the intrinsic line — the correct position for Pydantic's
+     * `@field_validator` / `@model_validator` and other wrappers that must
+     * see the underlying function, not a descriptor.
+     *
+     * When used on plain `MethodDeclaration` / `FunctionDeclaration`, these
+     * decorators are rendered above `@abstractmethod` (if `abstract` is set)
+     * and above `def`.
+     *
+     * Do **not** pass intrinsic decorators here — i.e. `@classmethod`,
+     * `@staticmethod`, `@property`, or `@abstractmethod`. Those are emitted by
+     * the matching component (`ClassMethodDeclaration`, `StaticMethodDeclaration`,
+     * `PropertyDeclaration`, or the `abstract` flag) and would otherwise be
+     * stacked twice in the output, producing invalid Python.
+     */
+    decorators?: Children[];
 }
 /**
  * Props for `BaseFunctionDeclaration`.
@@ -44,5 +74,5 @@ export interface BaseFunctionDeclarationProps extends CommonFunctionProps {
  *     return x
  * ```
  */
-export declare function BaseFunctionDeclaration(props: BaseFunctionDeclarationProps): import("@alloy-js/core").Children;
+export declare function BaseFunctionDeclaration(props: BaseFunctionDeclarationProps): Children;
 //# sourceMappingURL=FunctionBase.d.ts.map

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

@@ -1 +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,qCAiC1E"}
+{"version":3,"file":"FunctionBase.d.ts","sourceRoot":"","sources":["../../../src/components/FunctionBase.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAiB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAe,MAAM,kBAAkB,CAAC;AAKrE;;;;;;;GAOG;AACH,MAAM,WAAW,mBACf,SAAQ,oBAAoB,EAC1B,kBAAkB;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB;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,YAkC1E"}

package/dist/src/components/FunctionBase.js

@@ -3,6 +3,7 @@ import { createContentSlot, Name, Show } from "@alloy-js/core";
 import { getCallSignatureProps } from "../utils.js";
 import { CallSignature } from "./CallSignature.js";
 import { Declaration } from "./Declaration.js";
+import { DecoratorList } from "./DecoratorList.js";
 import { LexicalScope } from "./LexicalScope.js";
 import { PythonBlock } from "./PythonBlock.js";
 
@@ -42,6 +43,11 @@ import { PythonBlock } from "./PythonBlock.js";
  * ```
  */
 export function BaseFunctionDeclaration(props) {
+  const {
+    decorators,
+    sym,
+    ...declarationProps
+  } = props;
   const asyncKwd = props.async ? "async " : "";
   let parameters;
   switch (props.functionType) {
@@ -58,9 +64,10 @@ export function BaseFunctionDeclaration(props) {
     default:
       parameters = props.parameters;
   }
-  const sym = props.sym;
   const ContentSlot = createContentSlot();
-  return [_$createComponent(Declaration, _$mergeProps(props, {
+  return [_$createComponent(DecoratorList, {
+    decorators: decorators
+  }), _$createComponent(Declaration, _$mergeProps(declarationProps, {
     nameKind: "function",
     symbol: sym,
     get children() {

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

@@ -1 +1 @@
-{"version":3,"names":["createContentSlot","Name","Show","getCallSignatureProps","CallSignature","Declaration","LexicalScope","PythonBlock","BaseFunctionDeclaration","props","asyncKwd","async","parameters","functionType","name","sym","ContentSlot","_$createComponent","_$mergeProps","nameKind","symbol","children","opener","when","Boolean","doc","WhenEmpty"],"sources":["../../../src/components/FunctionBase.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,iBAAiB,EAAEC,IAAI,EAAEC,IAAI,QAAQ,gBAAgB;AAE9D,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;EACzC,MAAMC,WAAW,GAAGhB,iBAAiB,CAAC,CAAC;EACvC,QAAAiB,iBAAA,CAEKZ,WAAW,EAAAa,YAAA,CAAKT,KAAK;IAAEU,QAAQ;IAAYC,MAAM,EAAEL,GAAG;IAAA,IAAAM,SAAA;MAAA,QACpDX,QAAQ,UAAAO,iBAAA,CAAMhB,IAAI,OAAAgB,iBAAA,CAClBX,YAAY;QAAA,IAACQ,IAAIA,CAAA;UAAA,OAAEC,GAAG,CAACD,IAAI;QAAA;QAAA,IAAAO,SAAA;UAAA,QAAAJ,iBAAA,CACzBb,aAAa,EAAAc,YAAA,OACRf,qBAAqB,CAACM,KAAK,EAAE,CAAC,CAAC,CAAC;YACpCG,UAAU,EAAEA;UAAU,KAAAK,iBAAA,CAEvBV,WAAW;YAACe,MAAM;YAAA,IAAAD,SAAA;cAAA,QAAAJ,iBAAA,CAChBf,IAAI;gBAAA,IAACqB,IAAIA,CAAA;kBAAA,OAAEC,OAAO,CAACf,KAAK,CAACgB,GAAG,CAAC;gBAAA;gBAAA,IAAAJ,SAAA;kBAAA,OAAGZ,KAAK,CAACgB,GAAG;gBAAA;cAAA,IAAAR,iBAAA,CACzCD,WAAW,CAACU,SAAS;gBAAAL,QAAA;cAAA,IAAAJ,iBAAA,CACrBD,WAAW;gBAAA,IAAAK,SAAA;kBAAA,OAAEZ,KAAK,CAACY,QAAQ;gBAAA;cAAA;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAMxC","ignoreList":[]}
+{"version":3,"names":["createContentSlot","Name","Show","getCallSignatureProps","CallSignature","Declaration","DecoratorList","LexicalScope","PythonBlock","BaseFunctionDeclaration","props","decorators","sym","declarationProps","asyncKwd","async","parameters","functionType","name","ContentSlot","_$createComponent","_$mergeProps","nameKind","symbol","children","opener","when","Boolean","doc","WhenEmpty"],"sources":["../../../src/components/FunctionBase.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,iBAAiB,EAAEC,IAAI,EAAEC,IAAI,QAAuB,gBAAgB;AAE7E,SAASC,qBAAqB,QAAQ,aAAa;AACnD,SAASC,aAAa;AACtB,SAA+BC,WAAW,QAAQ,kBAAkB;AACpE,SAASC,aAAa;AACtB,SAASC,YAAY;AACrB,SAASC,WAAW;;AAEpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqCA;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,MAAM;IAAEC,UAAU;IAAEC,GAAG;IAAE,GAAGC;EAAiB,CAAC,GAAGH,KAAK;EACtD,MAAMI,QAAQ,GAAGJ,KAAK,CAACK,KAAK,GAAG,QAAQ,GAAG,EAAE;EAC5C,IAAIC,UAAU;EACd,QAAQN,KAAK,CAACO,YAAY;IACxB,KAAK,UAAU;MACbD,UAAU,GAAG,CAAC;QAAEE,IAAI,EAAE;MAAO,CAAC,EAAE,IAAIR,KAAK,CAACM,UAAU,IAAI,EAAE,CAAC,CAAC;MAC5D;IACF,KAAK,OAAO;MACVA,UAAU,GAAG,CAAC;QAAEE,IAAI,EAAE;MAAM,CAAC,EAAE,IAAIR,KAAK,CAACM,UAAU,IAAI,EAAE,CAAC,CAAC;MAC3D;IACF;MACEA,UAAU,GAAGN,KAAK,CAACM,UAAU;EACjC;EACA,MAAMG,WAAW,GAAGnB,iBAAiB,CAAC,CAAC;EACvC,QAAAoB,iBAAA,CAEKd,aAAa;IAACK,UAAU,EAAEA;EAAU,IAAAS,iBAAA,CACpCf,WAAW,EAAAgB,YAAA,CAAKR,gBAAgB;IAAES,QAAQ;IAAYC,MAAM,EAAEX,GAAG;IAAA,IAAAY,SAAA;MAAA,QAC/DV,QAAQ,UAAAM,iBAAA,CAAMnB,IAAI,OAAAmB,iBAAA,CAClBb,YAAY;QAAA,IAACW,IAAIA,CAAA;UAAA,OAAEN,GAAG,CAACM,IAAI;QAAA;QAAA,IAAAM,SAAA;UAAA,QAAAJ,iBAAA,CACzBhB,aAAa,EAAAiB,YAAA,OACRlB,qBAAqB,CAACO,KAAK,EAAE,CAAC,CAAC,CAAC;YACpCM,UAAU,EAAEA;UAAU,KAAAI,iBAAA,CAEvBZ,WAAW;YAACiB,MAAM;YAAA,IAAAD,SAAA;cAAA,QAAAJ,iBAAA,CAChBlB,IAAI;gBAAA,IAACwB,IAAIA,CAAA;kBAAA,OAAEC,OAAO,CAACjB,KAAK,CAACkB,GAAG,CAAC;gBAAA;gBAAA,IAAAJ,SAAA;kBAAA,OAAGd,KAAK,CAACkB,GAAG;gBAAA;cAAA,IAAAR,iBAAA,CACzCD,WAAW,CAACU,SAAS;gBAAAL,QAAA;cAAA,IAAAJ,iBAAA,CACrBD,WAAW;gBAAA,IAAAK,SAAA;kBAAA,OAAEd,KAAK,CAACc,QAAQ;gBAAA;cAAA;YAAA;UAAA;QAAA;MAAA;IAAA;EAAA;AAMxC","ignoreList":[]}

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

@@ -16,7 +16,7 @@ export interface FutureStatementProps {
  *
  * @example
  * ```tsx
- * <SourceFile path="models.py" futureImports={<FutureStatement feature="annotations" />}>
+ * <SourceFile path="models.py" futureImports={[<FutureStatement feature="annotations" />]}>
  *   <ClassDeclaration name="User">
  *     <PropertyDeclaration name="manager" type="User" />
  *   </ClassDeclaration>

package/dist/src/components/FutureStatement.js

@@ -10,7 +10,7 @@ import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
  *
  * @example
  * ```tsx
- * <SourceFile path="models.py" futureImports={<FutureStatement feature="annotations" />}>
+ * <SourceFile path="models.py" futureImports={[<FutureStatement feature="annotations" />]}>
  *   <ClassDeclaration name="User">
  *     <PropertyDeclaration name="manager" type="User" />
  *   </ClassDeclaration>

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

@@ -1 +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"}
+{"version":3,"file":"MethodBase.d.ts","sourceRoot":"","sources":["../../../src/components/MethodBase.tsx"],"names":[],"mappings":"AAEA,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,iDAmB7D"}

package/dist/src/components/MethodBase.js

@@ -1,5 +1,6 @@
 import { memo as _$memo, createIntrinsic as _$createIntrinsic, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
 import { abcModule } from "../builtins/python.js";
+import { DecoratorList } from "./DecoratorList.js";
 import { BaseFunctionDeclaration } from "./FunctionBase.js";
 
 /**
@@ -26,7 +27,14 @@ import { BaseFunctionDeclaration } from "./FunctionBase.js";
  * ```
  */
 export function MethodDeclarationBase(props) {
-  const abstractMethod = props.abstract ? ["@", _$memo(() => abcModule["."].abstractmethod), _$createIntrinsic("hbr", {})] : undefined;
-  return [abstractMethod, _$createComponent(BaseFunctionDeclaration, props)];
+  const {
+    decorators,
+    abstract,
+    ...rest
+  } = props;
+  const abstractMethod = abstract ? ["@", _$memo(() => abcModule["."].abstractmethod), _$createIntrinsic("hbr", {})] : undefined;
+  return [_$createComponent(DecoratorList, {
+    decorators: decorators
+  }), abstractMethod, _$createComponent(BaseFunctionDeclaration, rest)];
 }
 //# sourceMappingURL=MethodBase.js.map

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

@@ -1 +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":[]}
+{"version":3,"names":["abcModule","DecoratorList","BaseFunctionDeclaration","MethodDeclarationBase","props","decorators","abstract","rest","abstractMethod","_$memo","abstractmethod","_$createIntrinsic","undefined","_$createComponent"],"sources":["../../../src/components/MethodBase.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,SAAS,QAAQ,uBAAuB;AACjD,SAASC,aAAa;AACtB,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,MAAM;IAAEC,UAAU;IAAEC,QAAQ;IAAE,GAAGC;EAAK,CAAC,GAAGH,KAAK;EAE/C,MAAMI,cAAc,GAClBF,QAAQ,SAAAG,MAAA,OAEFT,SAAS,CAAC,GAAG,CAAC,CAACU,cAAc,GAAAC,iBAAA,eAGjCC,SAAS;EAEb,QAAAC,iBAAA,CAEKZ,aAAa;IAACI,UAAU,EAAEA;EAAU,IACpCG,cAAc,EAAAK,iBAAA,CACdX,uBAAuB,EAAKK,IAAI;AAGvC","ignoreList":[]}

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

@@ -47,6 +47,29 @@ import { CommonFunctionProps } from "./FunctionBase.js";
  * 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.
+ *
+ * Use **`decorators`** for decorators that must appear **above** the intrinsic
+ * `@property` (for example Pydantic `@computed_field`, `@typing.final`,
+ * `@typing.override`). The first array entry is rendered topmost, matching
+ * Python source order.
+ *
+ * @example Pydantic computed field
+ * ```tsx
+ * <py.PropertyDeclaration
+ *   name="area"
+ *   type="float"
+ *   decorators={[code`@${pydanticModule["."].computed_field}`]}
+ * >
+ *   return self.width ** 2
+ * </py.PropertyDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * @computed_field
+ * @property
+ * def area(self) -> float:
+ *     return self.width ** 2
+ * ```
  */
 export interface PropertyDeclarationProps {
     name: string;
@@ -55,6 +78,12 @@ export interface PropertyDeclarationProps {
     refkey?: Refkey;
     abstract?: boolean;
     doc?: Children;
+    /**
+     * Decorators rendered above the intrinsic `@property` line, in source order
+     * (`decorators[0]` is topmost / applied last). Use for decorators that wrap
+     * the resulting property, e.g. Pydantic's `@computed_field`.
+     */
+    decorators?: Children[];
 }
 export declare function PropertyDeclaration(props: PropertyDeclarationProps): Children;
 export declare namespace PropertyDeclaration {

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

@@ -1 +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"}
+{"version":3,"file":"PropertyDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/PropertyDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAGR,MAAM,EASP,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;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;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,YAgElE;yBAhEe,mBAAmB;;eAuJkB,QAAQ;;eAAR,QAAQ;;;;AArF7D,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/src/components/PropertyDeclaration.js

@@ -2,6 +2,7 @@ import { createComponent as _$createComponent, memo as _$memo, mergeProps as _$m
 import { DeclarationContext, List, Show, childrenArray, code, createContext, findKeyedChild, findUnkeyedChildren, taggedComponent, useContext } from "@alloy-js/core";
 import { createMethodSymbol } from "../symbols/factories.js";
 import { Atom } from "./Atom.js";
+import { DecoratorList } from "./DecoratorList.js";
 import { MethodDeclarationBase } from "./MethodBase.js";
 const setterTag = Symbol();
 const deleterTag = Symbol();
@@ -56,6 +57,29 @@ const PropertyContext = createContext();
  * 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.
+ *
+ * Use **`decorators`** for decorators that must appear **above** the intrinsic
+ * `@property` (for example Pydantic `@computed_field`, `@typing.final`,
+ * `@typing.override`). The first array entry is rendered topmost, matching
+ * Python source order.
+ *
+ * @example Pydantic computed field
+ * ```tsx
+ * <py.PropertyDeclaration
+ *   name="area"
+ *   type="float"
+ *   decorators={[code`@${pydanticModule["."].computed_field}`]}
+ * >
+ *   return self.width ** 2
+ * </py.PropertyDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * @computed_field
+ * @property
+ * def area(self) -> float:
+ *     return self.width ** 2
+ * ```
  */
 
 export function PropertyDeclaration(props) {
@@ -94,6 +118,9 @@ export function PropertyDeclaration(props) {
                 get doc() {
                   return props.doc;
                 },
+                get decorators() {
+                  return props.decorators;
+                },
                 children: unkeyedChildren
               }), _$createComponent(Show, {
                 get when() {
@@ -133,7 +160,13 @@ export function PropertyDeclaration(props) {
 function PropertyMethodDeclaration(props) {
   const propertySymbol = useContext(DeclarationContext);
   const propertyType = useContext(PropertyContext);
-  return [code`@property`, _$createIntrinsic("hbr", {}), _$createComponent(MethodDeclarationBase, _$mergeProps(props, {
+  const {
+    decorators,
+    ...rest
+  } = props;
+  return [_$createComponent(DecoratorList, {
+    decorators: decorators
+  }), code`@property`, _$createIntrinsic("hbr", {}), _$createComponent(MethodDeclarationBase, _$mergeProps(rest, {
     get name() {
       return propertySymbol.name;
     },
@@ -187,6 +220,13 @@ function PropertyMethodBase(props) {
  * def value(self, value: int) -> None:
  *     self._value = value
  * ```
+ *
+ * @remarks
+ * The intrinsic `@<name>.setter` decorator is always rendered topmost (it must
+ * remain the outermost decorator). Any `decorators` passed to this component
+ * are rendered **between** `@<name>.setter` and `def`, which is the correct
+ * position for wrappers that should decorate the underlying function before
+ * `setter` re-binds it to the property (e.g. `@deprecated`, `@abstractmethod`).
  */
 PropertyDeclaration.Setter = taggedComponent(setterTag, function PropertySetter(props) {
   return _$createComponent(PropertyMethodBase, _$mergeProps({
@@ -218,6 +258,13 @@ PropertyDeclaration.Setter = taggedComponent(setterTag, function PropertySetter(
  * def value(self) -> None:
  *     del self._value
  * ```
+ *
+ * @remarks
+ * The intrinsic `@<name>.deleter` decorator is always rendered topmost (it
+ * must remain the outermost decorator). Any `decorators` passed to this
+ * component are rendered **between** `@<name>.deleter` and `def`, which is
+ * the correct position for wrappers that should decorate the underlying
+ * function before `deleter` re-binds it to the property.
  */
 PropertyDeclaration.Deleter = taggedComponent(deleterTag, function PropertyDeleter(props) {
   return _$createComponent(PropertyMethodBase, _$mergeProps({

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

@@ -1 +1 @@
-{"version":3,"names":["DeclarationContext","List","Show","childrenArray","code","createContext","findKeyedChild","findUnkeyedChildren","taggedComponent","useContext","createMethodSymbol","Atom","MethodDeclarationBase","setterTag","Symbol","deleterTag","PropertyContext","PropertyDeclaration","props","nonEmptyOrNotImplemented","children","length","setterComponent","Setter","tag","undefined","deleterComponent","Deleter","setterChildren","deleterChildren","unkeyedChildren","sym","name","refkeys","refkey","_$createComponent","Provider","value","type","hardline","enderPunctuation","PropertyMethodDeclaration","abstract","doc","when","Boolean","_$mergeProps","propertySymbol","propertyType","_$createIntrinsic","functionType","returnType","PropertyMethodBase","decoratorType","parameters","restProps","_$memo","jsValue","PropertySetter","PropertyDeleter"],"sources":["../../../src/components/PropertyDeclaration.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["DeclarationContext","List","Show","childrenArray","code","createContext","findKeyedChild","findUnkeyedChildren","taggedComponent","useContext","createMethodSymbol","Atom","DecoratorList","MethodDeclarationBase","setterTag","Symbol","deleterTag","PropertyContext","PropertyDeclaration","props","nonEmptyOrNotImplemented","children","length","setterComponent","Setter","tag","undefined","deleterComponent","Deleter","setterChildren","deleterChildren","unkeyedChildren","sym","name","refkeys","refkey","_$createComponent","Provider","value","type","hardline","enderPunctuation","PropertyMethodDeclaration","abstract","doc","decorators","when","Boolean","_$mergeProps","propertySymbol","propertyType","rest","_$createIntrinsic","functionType","returnType","PropertyMethodBase","decoratorType","parameters","restProps","_$memo","jsValue","PropertySetter","PropertyDeleter"],"sources":["../../../src/components/PropertyDeclaration.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,120 @@
+import { type Children } from "@alloy-js/core";
+import type { ClassDeclarationProps } from "./ClassDeclaration.js";
+/**
+ * Keyword-style options for Pydantic v2 `ConfigDict`, using camelCase prop names
+ * that map to snake_case Python arguments (for example `validateAssignment` →
+ * `validate_assignment`).
+ */
+export interface PydanticModelConfigDictProps {
+    /** Resolve field aliases from a configured alias generator. */
+    aliasGenerator?: string;
+    /** Allow non-pydantic/arbitrary Python types in field annotations. */
+    arbitraryTypesAllowed?: boolean;
+    /** Coerce numeric input values to strings for `str` fields. */
+    coerceNumbersToStr?: boolean;
+    /** Behavior for unknown input keys: allow, forbid, or ignore. */
+    extra?: "allow" | "forbid" | "ignore";
+    /** Populate models from object attributes (ORM-style) instead of mapping keys. */
+    fromAttributes?: boolean;
+    /** Make models immutable (`frozen=True`). */
+    frozen?: boolean;
+    /** Hide input values in validation error messages. */
+    hideInputInErrors?: boolean;
+    /** Include JSON schema extras via a plain JSON-serializable object. */
+    jsonSchemaExtra?: Record<string, unknown>;
+    /** Use aliases in error locations instead of field names. */
+    locByAlias?: boolean;
+    /** Allow population by field name even when aliases are defined. */
+    populateByName?: boolean;
+    /** Re-validate model/dataclass instances on assignment boundaries. */
+    revalidateInstances?: "always" | "never" | "subclass-instances";
+    /** JSON serialization format for bytes values. */
+    serJsonBytes?: "utf8" | "base64" | "hex";
+    /** JSON serialization behavior for Infinity/NaN values. */
+    serJsonInfNan?: "null" | "constants" | "strings";
+    /** Upper-bound for constrained string lengths at model level. */
+    strMaxLength?: number;
+    /** Lower-bound for constrained string lengths at model level. */
+    strMinLength?: number;
+    /** Strip leading/trailing whitespace from all `str` fields. */
+    strStripWhitespace?: boolean;
+    /** Convert all `str` values to lowercase. */
+    strToLower?: boolean;
+    /** Convert all `str` values to uppercase. */
+    strToUpper?: boolean;
+    /** Enable strict validation globally for the model. */
+    strict?: boolean;
+    /** Use enum `.value` instead of enum instances during serialization. */
+    useEnumValues?: boolean;
+    /** JSON validation format for bytes values. */
+    valJsonBytes?: "utf8" | "base64" | "hex";
+    /** Re-validate when attributes are assigned after model creation. */
+    validateAssignment?: boolean;
+    /** Validate default values in addition to provided input values. */
+    validateDefault?: boolean;
+    /** Validate return values for call validators. */
+    validateReturn?: boolean;
+}
+export interface PydanticClassDeclarationProps extends ClassDeclarationProps, PydanticModelConfigDictProps {
+    /**
+     * Canonical structured config object for `ConfigDict(...)`. Values here are
+     * merged with top-level config props.
+     *
+     * Top-level config props take precedence over `modelConfig` when the same key
+     * is provided in both places.
+     */
+    modelConfig?: PydanticModelConfigDictProps;
+    /**
+     * Emits `model_config = <expression>` verbatim (use for arbitrary `ConfigDict`
+     * kwargs or dynamic config). Takes precedence over both `modelConfig` and
+     * top-level config props.
+     *
+     * @example
+     * A typical value emits `ConfigDict(frozen=True, extra="forbid")`.
+     */
+    modelConfigExpression?: Children;
+}
+/**
+ * Renders a Python class that subclasses Pydantic's `BaseModel`:
+ * `class Name(BaseModel): ...`.
+ *
+ * When `bases` is omitted, the class extends `pydanticModule["."].BaseModel`.
+ * Pass `bases` to inherit from another generated class (or to combine bases explicitly).
+ *
+ * Optional `modelConfig={{...}}` and top-level config props (for example
+ * `frozen`, `strict`, `extra`) emit `model_config = ConfigDict(...)` for common
+ * Pydantic v2 model settings (see {@link PydanticModelConfigDictProps}).
+ * When both are used, top-level props override `modelConfig` keys.
+ *
+ * Fields are ordinary class body declarations; use `pydanticModule["."].Field` in
+ * initializers when you need `Field(...)`.
+ *
+ * @example
+ * ```tsx
+ * import { pydanticModule } from "@alloy-js/python";
+ * import * as py from "@alloy-js/python";
+ *
+ * <py.PydanticClassDeclaration name="User" frozen>
+ *   <py.VariableDeclaration instanceVariable omitNone name="id" type="int" />
+ *   <py.VariableDeclaration
+ *     instanceVariable
+ *     name="name"
+ *     type="str"
+ *     initializer={"Field(default=\"anonymous\")"}
+ *   />
+ * </py.PydanticClassDeclaration>
+ * ```
+ *
+ * ```py
+ * from pydantic import BaseModel
+ * from pydantic import ConfigDict
+ * from pydantic import Field
+ *
+ * class User(BaseModel):
+ *     model_config = ConfigDict(frozen=True)
+ *     id: int
+ *     name: str = Field(default="anonymous")
+ * ```
+ */
+export declare function PydanticClassDeclaration(props: PydanticClassDeclarationProps): Children;
+//# sourceMappingURL=PydanticClassDeclaration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PydanticClassDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/PydanticClassDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,oBAAoB,CAAC;IAChE,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACzC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACzC,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA6BD,MAAM,WAAW,6BACf,SAAQ,qBAAqB,EAC3B,4BAA4B;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,QAAQ,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,YA6D5E"}

package/dist/src/components/PydanticClassDeclaration.js

@@ -0,0 +1,116 @@
+import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { For, List, childrenArray, splitProps } from "@alloy-js/core";
+import { snakeCase } from "change-case";
+import { pydanticModule } from "../builtins/python.js";
+import { Atom } from "./Atom.js";
+import { ClassDeclaration } from "./ClassDeclaration.js";
+
+/**
+ * Keyword-style options for Pydantic v2 `ConfigDict`, using camelCase prop names
+ * that map to snake_case Python arguments (for example `validateAssignment` →
+ * `validate_assignment`).
+ */
+
+const PydanticModelConfigKeys = ["aliasGenerator", "arbitraryTypesAllowed", "coerceNumbersToStr", "frozen", "extra", "fromAttributes", "hideInputInErrors", "jsonSchemaExtra", "locByAlias", "populateByName", "revalidateInstances", "serJsonBytes", "serJsonInfNan", "strMinLength", "strMaxLength", "strStripWhitespace", "strToLower", "strToUpper", "strict", "useEnumValues", "valJsonBytes", "validateAssignment", "validateDefault", "validateReturn"];
+/**
+ * Renders a Python class that subclasses Pydantic's `BaseModel`:
+ * `class Name(BaseModel): ...`.
+ *
+ * When `bases` is omitted, the class extends `pydanticModule["."].BaseModel`.
+ * Pass `bases` to inherit from another generated class (or to combine bases explicitly).
+ *
+ * Optional `modelConfig={{...}}` and top-level config props (for example
+ * `frozen`, `strict`, `extra`) emit `model_config = ConfigDict(...)` for common
+ * Pydantic v2 model settings (see {@link PydanticModelConfigDictProps}).
+ * When both are used, top-level props override `modelConfig` keys.
+ *
+ * Fields are ordinary class body declarations; use `pydanticModule["."].Field` in
+ * initializers when you need `Field(...)`.
+ *
+ * @example
+ * ```tsx
+ * import { pydanticModule } from "@alloy-js/python";
+ * import * as py from "@alloy-js/python";
+ *
+ * <py.PydanticClassDeclaration name="User" frozen>
+ *   <py.VariableDeclaration instanceVariable omitNone name="id" type="int" />
+ *   <py.VariableDeclaration
+ *     instanceVariable
+ *     name="name"
+ *     type="str"
+ *     initializer={"Field(default=\"anonymous\")"}
+ *   />
+ * </py.PydanticClassDeclaration>
+ * ```
+ *
+ * ```py
+ * from pydantic import BaseModel
+ * from pydantic import ConfigDict
+ * from pydantic import Field
+ *
+ * class User(BaseModel):
+ *     model_config = ConfigDict(frozen=True)
+ *     id: int
+ *     name: str = Field(default="anonymous")
+ * ```
+ */
+export function PydanticClassDeclaration(props) {
+  const [modelConfigProps, bodyProps, rest] = splitProps(props, PydanticModelConfigKeys, ["modelConfig", "modelConfigExpression", "children"]);
+  const bases = rest.bases ?? [pydanticModule["."].BaseModel];
+  const {
+    modelConfig,
+    modelConfigExpression,
+    children
+  } = bodyProps;
+  const configEntries = [];
+  if (modelConfigExpression === undefined) {
+    for (const key of PydanticModelConfigKeys) {
+      const value = modelConfigProps[key] ?? modelConfig?.[key];
+      if (value === undefined) continue;
+      configEntries.push([snakeCase(key), value]);
+    }
+  }
+  const hasStructuredModelConfig = modelConfigExpression === undefined && configEntries.length > 0;
+  const hasExpressionModelConfig = modelConfigExpression !== undefined;
+  const bodyItems = [];
+  if (hasExpressionModelConfig) {
+    bodyItems.push(["model_config = ", modelConfigExpression]);
+  } else if (hasStructuredModelConfig) {
+    bodyItems.push(["model_config = ", _$memo(() => pydanticModule["."].ConfigDict), "(", _$createComponent(For, {
+      each: configEntries,
+      comma: true,
+      space: true,
+      children: ([k, v]) => [k, "=", _$createComponent(Atom, {
+        jsValue: v
+      })]
+    }), ")"]);
+  }
+  bodyItems.push(...childrenArray(() => children));
+  return _$createComponent(ClassDeclaration, {
+    get name() {
+      return rest.name;
+    },
+    bases: bases,
+    get doc() {
+      return rest.doc;
+    },
+    get refkey() {
+      return rest.refkey;
+    },
+    get decorators() {
+      return rest.decorators;
+    },
+    get children() {
+      return _$createComponent(List, {
+        hardline: true,
+        get children() {
+          return _$createComponent(For, {
+            each: bodyItems,
+            children: item => item
+          });
+        }
+      });
+    }
+  });
+}
+//# sourceMappingURL=PydanticClassDeclaration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["For","List","childrenArray","splitProps","snakeCase","pydanticModule","Atom","ClassDeclaration","PydanticModelConfigKeys","PydanticClassDeclaration","props","modelConfigProps","bodyProps","rest","bases","BaseModel","modelConfig","modelConfigExpression","children","configEntries","undefined","key","value","push","hasStructuredModelConfig","length","hasExpressionModelConfig","bodyItems","_$memo","ConfigDict","_$createComponent","each","comma","space","k","v","jsValue","name","doc","refkey","decorators","hardline","item"],"sources":["../../../src/components/PydanticClassDeclaration.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -14,6 +14,9 @@ import type { CommonFunctionProps } from "./FunctionBase.js";
  * def identity(value: int) -> None:
  *     return value
  * ```
+ *
+ * @remarks
+ * Use **`decorators`** for decorators that must appear above `@staticmethod`.
  */
 export interface StaticMethodDeclarationProps extends CommonFunctionProps {
     abstract?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"StaticMethodDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/StaticMethodDeclaration.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,iDAS1E"}
+{"version":3,"file":"StaticMethodDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/StaticMethodDeclaration.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,iDAW1E"}

package/dist/src/components/StaticMethodDeclaration.js

@@ -1,5 +1,6 @@
-import { createIntrinsic as _$createIntrinsic, mergeProps as _$mergeProps, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, mergeProps as _$mergeProps } from "@alloy-js/core/jsx-runtime";
 import { createMethodSymbol } from "../symbols/factories.js";
+import { DecoratorList } from "./DecoratorList.js";
 import { MethodDeclarationBase } from "./MethodBase.js";
 
 /**
@@ -17,15 +18,24 @@ import { MethodDeclarationBase } from "./MethodBase.js";
  * def identity(value: int) -> None:
  *     return value
  * ```
+ *
+ * @remarks
+ * Use **`decorators`** for decorators that must appear above `@staticmethod`.
  */
 
 export function StaticMethodDeclaration(props) {
   const sym = createMethodSymbol(props.name, {
     refkeys: props.refkey
   });
-  return ["@staticmethod", _$createIntrinsic("hbr", {}), _$createComponent(MethodDeclarationBase, _$mergeProps({
+  const {
+    decorators,
+    ...rest
+  } = props;
+  return [_$createComponent(DecoratorList, {
+    decorators: decorators
+  }), "@staticmethod", _$createIntrinsic("hbr", {}), _$createComponent(MethodDeclarationBase, _$mergeProps({
     functionType: "static"
-  }, props, {
+  }, rest, {
     sym: sym
   }))];
 }