@typespec/emitter-framework 0.15.0-dev.3 → 0.15.0-dev.4

package/dist/src/python/components/class-declaration/class-method.test.js

@@ -0,0 +1,298 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { Tester } from "#test/test-host.js";
+import { getProgram } from "#test/utils.js";
+import * as py from "@alloy-js/python";
+import { t } from "@typespec/compiler/testing";
+import { describe, expect, it } from "vitest";
+import { ClassDeclaration } from "../../../../src/python/components/class-declaration/class-declaration.js";
+import { Method } from "../../../../src/python/components/class-declaration/class-method.js";
+import { getOutput } from "../../test-utils.js";
+describe("interface methods with a `type` prop", () => {
+  it("creates a class method from an interface method", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          async: true,
+          type: getName
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        async def get_name(self, id: str) -> str:
+          pass
+
+
+    `);
+  });
+  it("creates a class method that is a classmethod", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          async: true,
+          type: getName,
+          methodType: "class"
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        @classmethod
+        async def get_name(cls, id: str) -> str:
+          pass
+
+
+    `);
+  });
+  it("creates a class method that is a staticmethod", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          async: true,
+          type: getName,
+          methodType: "static"
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        @staticmethod
+        async def get_name(id: str) -> str:
+          pass
+
+
+    `);
+  });
+  it("creates an async class method from an asyncinterface method", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          async: true,
+          type: getName
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        async def get_name(self, id: str) -> str:
+          pass
+
+
+    `);
+  });
+  it("can append extra keyword-only parameters", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          parameters: [{
+            name: "foo",
+            type: "string"
+          }]
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name(self, id: str, *, foo: str) -> str:
+          pass
+
+
+      `);
+  });
+  it("can add extra keyword-only parameters", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          parameters: [{
+            name: "foo",
+            type: "string"
+          }]
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name(self, id: str, *, foo: str) -> str:
+          pass
+
+
+      `);
+  });
+  it("can replace parameters with raw params provided", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          replaceParameters: true,
+          parameters: [{
+            name: "foo",
+            type: "string"
+          }, {
+            name: "bar",
+            type: "number"
+          }]
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name(self, *, foo: str, bar: float) -> str:
+          pass
+
+
+      `);
+  });
+  it("can replace parameters with params having defaults (requires * marker)", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          replaceParameters: true,
+          get parameters() {
+            return [{
+              name: "foo",
+              type: "string",
+              default: _$createComponent(py.Atom, {
+                jsValue: "default"
+              })
+            }, {
+              name: "bar",
+              type: "number",
+              default: _$createComponent(py.Atom, {
+                jsValue: 42
+              })
+            }];
+          }
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name(self, *, foo: str = "default", bar: float = 42) -> str:
+          pass
+
+
+      `);
+  });
+  it("can override return type in a class method", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          returnType: "ASpecialString"
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name(self, id: str) -> ASpecialString:
+          pass
+
+
+      `);
+  });
+  it("can override method name in a class method", async () => {
+    const {
+      program,
+      getName
+    } = await Tester.compile(t.code`
+      @test op ${t.op("getName")}(id: string): string;
+    `);
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          type: getName,
+          name: "get_name_custom"
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def get_name_custom(self, id: str) -> str:
+          pass
+
+
+      `);
+  });
+});
+describe("interface methods without a `type` prop", () => {
+  it("renders a plain interface method from a class method without a `type` prop", async () => {
+    const program = await getProgram("");
+    expect(getOutput(program, [_$createComponent(ClassDeclaration, {
+      name: "basicInterface",
+      get children() {
+        return _$createComponent(Method, {
+          name: "plainMethod",
+          parameters: [{
+            name: "param1",
+            type: "string"
+          }],
+          returnType: "number"
+        });
+      }
+    })])).toRenderTo(`
+      class BasicInterface:
+        def plain_method(self, param1: string) -> number:
+          pass
+
+
+      `);
+  });
+});
+//# sourceMappingURL=class-method.test.js.map

package/dist/src/python/components/class-declaration/class-method.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Tester","getProgram","py","t","describe","expect","it","ClassDeclaration","Method","getOutput","program","getName","compile","code","op","_$createComponent","name","children","async","type","toRenderTo","methodType","parameters","replaceParameters","default","Atom","jsValue","returnType"],"sources":["../../../../../src/python/components/class-declaration/class-method.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/python/components/class-declaration/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./class-bases.js";
+export * from "./class-body.js";
+export * from "./class-declaration.js";
+export * from "./class-member.js";
+export * from "./class-method.js";
+export * from "./primitive-initializer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/python/components/class-declaration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/python/components/class-declaration/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC"}

package/dist/src/python/components/class-declaration/index.js

@@ -0,0 +1,7 @@
+export * from "./class-bases.js";
+export * from "./class-body.js";
+export * from "./class-declaration.js";
+export * from "./class-member.js";
+export * from "./class-method.js";
+export * from "./primitive-initializer.js";
+//# sourceMappingURL=index.js.map

package/dist/src/python/components/class-declaration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../../../src/python/components/class-declaration/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,kBAAkB;AAChC,cAAc,iBAAiB;AAC/B,cAAc,wBAAwB;AACtC,cAAc,mBAAmB;AACjC,cAAc,mBAAmB;AACjC,cAAc,4BAA4B","ignoreList":[]}

package/dist/src/python/components/class-declaration/primitive-initializer.d.ts

@@ -0,0 +1,22 @@
+import { type Children } from "@alloy-js/core";
+import type { Type, Value } from "@typespec/compiler";
+export interface PrimitiveInitializerProps {
+    /**
+     * The default value to convert to a Python initializer expression.
+     */
+    defaultValue: Value;
+    /**
+     * The property type, used to determine float vs int formatting.
+     */
+    propertyType: Type;
+}
+/**
+ * Renders a Python primitive initializer from a TypeSpec default value.
+ *
+ * Handles StringValue, BooleanValue, NullValue, NumericValue, and ArrayValue.
+ * For numeric values, uses the propertyType to determine whether to render as float.
+ *
+ * @returns The Python initializer expression, or undefined if not supported.
+ */
+export declare function PrimitiveInitializer(props: PrimitiveInitializerProps): Children | undefined;
+//# sourceMappingURL=primitive-initializer.d.ts.map

package/dist/src/python/components/class-declaration/primitive-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-initializer.d.ts","sourceRoot":"","sources":["../../../../../src/python/components/class-declaration/primitive-initializer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAItD,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC;IACpB;;OAEG;IACH,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,QAAQ,GAAG,SAAS,CAoC3F"}

package/dist/src/python/components/class-declaration/primitive-initializer.js

@@ -0,0 +1,67 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import * as py from "@alloy-js/python";
+import { useTsp } from "../../../core/context/tsp-context.js";
+import { Atom } from "../atom/atom.js";
+/**
+ * Renders a Python primitive initializer from a TypeSpec default value.
+ *
+ * Handles StringValue, BooleanValue, NullValue, NumericValue, and ArrayValue.
+ * For numeric values, uses the propertyType to determine whether to render as float.
+ *
+ * @returns The Python initializer expression, or undefined if not supported.
+ */
+export function PrimitiveInitializer(props) {
+  const {
+    $
+  } = useTsp();
+  const {
+    defaultValue,
+    propertyType
+  } = props;
+  if (!defaultValue) return undefined;
+  const valueKind = defaultValue.valueKind ?? defaultValue.kind;
+  switch (valueKind) {
+    case "StringValue":
+    case "BooleanValue":
+    case "NullValue":
+      return _$createComponent(py.Atom, {
+        get jsValue() {
+          return defaultValue.value;
+        }
+      });
+    case "NumericValue":
+      {
+        // The Atom component converts NumericValue via asNumber(), which normalizes 100.0 to 100.
+        // Atom also has no access to the field type (float vs int), so it can't decide when to keep a trailing .0.
+        // Here we do have the propertyType so, for float/decimal fields, we render a raw value and append ".0"
+        // when needed. For non-float fields, default to a plain numeric Atom.
+
+        // Unwrap potential numeric wrapper shape and preserve float formatting
+        let raw = defaultValue.value;
+        // Example: value is { value: "100", isInteger: true }
+        if (raw && typeof raw === "object" && "value" in raw) raw = raw.value;
+
+        // Float-like property types (including custom subtypes) should render with float hint
+        if ($.scalar.extendsFloat(propertyType) || $.scalar.extendsDecimal(propertyType)) {
+          return _$createComponent(Atom, {
+            value: defaultValue,
+            float: true
+          });
+        }
+
+        // Otherwise output as a number atom
+        return _$createComponent(py.Atom, {
+          get jsValue() {
+            return Number(raw);
+          }
+        });
+      }
+    case "ArrayValue":
+      return _$createComponent(Atom, {
+        value: defaultValue
+      });
+    default:
+      return undefined;
+  }
+}
+//# sourceMappingURL=primitive-initializer.js.map

package/dist/src/python/components/class-declaration/primitive-initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["py","useTsp","Atom","PrimitiveInitializer","props","$","defaultValue","propertyType","undefined","valueKind","kind","_$createComponent","jsValue","value","raw","scalar","extendsFloat","extendsDecimal","float","Number"],"sources":["../../../../../src/python/components/class-declaration/primitive-initializer.tsx"],"sourcesContent":[null],"mappings":";AACA,OAAO,KAAKA,EAAE,MAAM,kBAAkB;AAEtC,SAASC,MAAM,QAAQ,sCAAsC;AAC7D,SAASC,IAAI,QAAQ,iBAAiB;AAatC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACC,KAAgC,EAAwB;EAC3F,MAAM;IAAEC;EAAE,CAAC,GAAGJ,MAAM,CAAC,CAAC;EACtB,MAAM;IAAEK,YAAY;IAAEC;EAAa,CAAC,GAAGH,KAAK;EAE5C,IAAI,CAACE,YAAY,EAAE,OAAOE,SAAS;EAEnC,MAAMC,SAAS,GAAIH,YAAY,CAASG,SAAS,IAAKH,YAAY,CAASI,IAAI;EAC/E,QAAQD,SAAS;IACf,KAAK,aAAa;IAClB,KAAK,cAAc;IACnB,KAAK,WAAW;MACd,OAAAE,iBAAA,CAAQX,EAAE,CAACE,IAAI;QAAA,IAACU,OAAOA,CAAA;UAAA,OAAGN,YAAY,CAASO,KAAK;QAAA;MAAA;IACtD,KAAK,cAAc;MAAE;QACnB;QACA;QACA;QACA;;QAEA;QACA,IAAIC,GAAQ,GAAIR,YAAY,CAASO,KAAK;QAC1C;QACA,IAAIC,GAAG,IAAI,OAAOA,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAIA,GAAG,EAAEA,GAAG,GAAGA,GAAG,CAACD,KAAK;;QAErE;QACA,IAAIR,CAAC,CAACU,MAAM,CAACC,YAAY,CAACT,YAAY,CAAC,IAAIF,CAAC,CAACU,MAAM,CAACE,cAAc,CAACV,YAAY,CAAC,EAAE;UAChF,OAAAI,iBAAA,CAAQT,IAAI;YAACW,KAAK,EAAEP,YAAY;YAAEY,KAAK;UAAA;QACzC;;QAEA;QACA,OAAAP,iBAAA,CAAQX,EAAE,CAACE,IAAI;UAAA,IAACU,OAAOA,CAAA;YAAA,OAAEO,MAAM,CAACL,GAAG,CAAC;UAAA;QAAA;MACtC;IACA,KAAK,YAAY;MACf,OAAAH,iBAAA,CAAQT,IAAI;QAACW,KAAK,EAAEP;MAAY;IAClC;MACE,OAAOE,SAAS;EACpB;AACF","ignoreList":[]}

package/dist/src/python/components/doc-element/doc-element.d.ts

@@ -0,0 +1,46 @@
+import { type Children, type Component } from "@alloy-js/core";
+import type { Type } from "@typespec/compiler";
+export interface DocElementProps {
+    /**
+     * The TypeSpec type to get documentation from.
+     * If provided and no `doc` override is given, documentation will be
+     * fetched via `$.type.getDoc(type)`.
+     */
+    type?: Type;
+    /**
+     * Optional documentation override. If provided, this takes precedence
+     * over documentation from the `type` prop.
+     *
+     * Accepts:
+     * - string - split into lines and render as a multi-line docstring
+     * - string[] | Children[] - rendered as separate paragraphs
+     * - Children (e.g., an explicit Doc component) - returned as-is
+     */
+    doc?: string | string[] | Children | Children[];
+    /**
+     * The Python doc component to use for rendering (ClassDoc, FunctionDoc, MethodDoc, etc.)
+     */
+    component: Component<{
+        description: Children[];
+    }>;
+}
+/**
+ * Renders documentation for a Python declaration.
+ *
+ * This component handles fetching documentation from TypeSpec types and
+ * normalizing various doc formats into the appropriate Python doc component.
+ *
+ * @example
+ * ```tsx
+ * // With a TypeSpec type (fetches doc automatically)
+ * <DocElement type={model} component={py.ClassDoc} />
+ *
+ * // With an explicit doc override
+ * <DocElement doc="My custom documentation" component={py.FunctionDoc} />
+ *
+ * // With both (doc takes precedence)
+ * <DocElement type={model} doc={props.doc} component={py.ClassDoc} />
+ * ```
+ */
+export declare function DocElement(props: DocElementProps): Children;
+//# sourceMappingURL=doc-element.d.ts.map

package/dist/src/python/components/doc-element/doc-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-element.d.ts","sourceRoot":"","sources":["../../../../../src/python/components/doc-element/doc-element.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAQ,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAEhD;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;QAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAmC3D"}

package/dist/src/python/components/doc-element/doc-element.js

@@ -0,0 +1,59 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { List } from "@alloy-js/core";
+import { useTsp } from "../../../core/context/tsp-context.js";
+/**
+ * Renders documentation for a Python declaration.
+ *
+ * This component handles fetching documentation from TypeSpec types and
+ * normalizing various doc formats into the appropriate Python doc component.
+ *
+ * @example
+ * ```tsx
+ * // With a TypeSpec type (fetches doc automatically)
+ * <DocElement type={model} component={py.ClassDoc} />
+ *
+ * // With an explicit doc override
+ * <DocElement doc="My custom documentation" component={py.FunctionDoc} />
+ *
+ * // With both (doc takes precedence)
+ * <DocElement type={model} doc={props.doc} component={py.ClassDoc} />
+ * ```
+ */
+export function DocElement(props) {
+  const {
+    $
+  } = useTsp();
+
+  // Resolve the documentation source: explicit doc takes precedence over type-derived doc
+  const source = props.doc ?? (props.type ? $.type.getDoc(props.type) : undefined);
+  if (!source) {
+    return undefined;
+  }
+  const DocComponent = props.component;
+
+  // Doc provided as an array (paragraphs/nodes) - preserve structure
+  if (Array.isArray(source)) {
+    return _$createComponent(DocComponent, {
+      description: source
+    });
+  }
+
+  // Doc provided as a string - preserve line breaks
+  if (typeof source === "string") {
+    const lines = source.split(/\r?\n/);
+    return _$createComponent(DocComponent, {
+      get description() {
+        return [_$createComponent(List, {
+          hardline: true,
+          get children() {
+            return lines.map(line => [line]);
+          }
+        })];
+      }
+    });
+  }
+
+  // Doc provided as JSX - pass through unchanged
+  return source;
+}
+//# sourceMappingURL=doc-element.js.map

package/dist/src/python/components/doc-element/doc-element.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["List","useTsp","DocElement","props","$","source","doc","type","getDoc","undefined","DocComponent","component","Array","isArray","_$createComponent","description","lines","split","hardline","children","map","line"],"sources":["../../../../../src/python/components/doc-element/doc-element.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAAwCA,IAAI,QAAQ,gBAAgB;AAEpE,SAASC,MAAM,QAAQ,sCAAsC;AA2B7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,KAAsB,EAAY;EAC3D,MAAM;IAAEC;EAAE,CAAC,GAAGH,MAAM,CAAC,CAAC;;EAEtB;EACA,MAAMI,MAAM,GAAGF,KAAK,CAACG,GAAG,KAAKH,KAAK,CAACI,IAAI,GAAGH,CAAC,CAACG,IAAI,CAACC,MAAM,CAACL,KAAK,CAACI,IAAI,CAAC,GAAGE,SAAS,CAAC;EAEhF,IAAI,CAACJ,MAAM,EAAE;IACX,OAAOI,SAAS;EAClB;EAEA,MAAMC,YAAY,GAAGP,KAAK,CAACQ,SAAS;;EAEpC;EACA,IAAIC,KAAK,CAACC,OAAO,CAACR,MAAM,CAAC,EAAE;IACzB,OAAAS,iBAAA,CAAQJ,YAAY;MAACK,WAAW,EAAEV;IAAM;EAC1C;;EAEA;EACA,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;IAC9B,MAAMW,KAAK,GAAGX,MAAM,CAACY,KAAK,CAAC,OAAO,CAAC;IACnC,OAAAH,iBAAA,CACGJ,YAAY;MAAA,IACXK,WAAWA,CAAA;QAAA,OAAE,CAAAD,iBAAA,CACVd,IAAI;UAACkB,QAAQ;UAAA,IAAAC,SAAA;YAAA,OACXH,KAAK,CAACI,GAAG,CAAEC,IAAI,KACXA,IAAI,CACR,CAAC;UAAA;QAAA,GAEL;MAAA;IAAA;EAGP;;EAEA;EACA,OAAOhB,MAAM;AACf","ignoreList":[]}

package/dist/src/python/components/doc-element/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./doc-element.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/python/components/doc-element/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/python/components/doc-element/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/src/python/components/doc-element/index.js

@@ -0,0 +1,2 @@
+export * from "./doc-element.js";
+//# sourceMappingURL=index.js.map

package/dist/src/python/components/doc-element/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../../../src/python/components/doc-element/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,kBAAkB","ignoreList":[]}

package/dist/src/python/components/enum-declaration/enum-declaration.d.ts

@@ -0,0 +1,8 @@
+import * as py from "@alloy-js/python";
+import type { Enum, Union } from "@typespec/compiler";
+export interface EnumDeclarationProps extends Omit<py.BaseDeclarationProps, "name"> {
+    name?: string;
+    type: Union | Enum;
+}
+export declare function EnumDeclaration(props: EnumDeclarationProps): import("@alloy-js/core").Children;
+//# sourceMappingURL=enum-declaration.d.ts.map

package/dist/src/python/components/enum-declaration/enum-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-declaration.d.ts","sourceRoot":"","sources":["../../../../../src/python/components/enum-declaration/enum-declaration.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAA+B,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAKnF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;CACpB;AAyBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qCAwC1D"}

package/dist/src/python/components/enum-declaration/enum-declaration.js

@@ -0,0 +1,80 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { useTsp } from "#core/context/index.js";
+import { For, Prose } from "@alloy-js/core";
+import * as py from "@alloy-js/python";
+import { reportDiagnostic } from "../../../lib.js";
+import { declarationRefkeys, efRefkey } from "../../utils/refkey.js";
+import { EnumMember } from "./enum-member.js";
+// Determine the appropriate enum type based on the member values
+function determineEnumType(members) {
+  const allInteger = members.every(([, member]) => {
+    const value = member.value;
+    return typeof value === "number" && Number.isInteger(value);
+  });
+  const allString = members.every(([, member]) => {
+    const value = member.value;
+    return typeof value === "string";
+  });
+  if (allInteger) {
+    return "IntEnum";
+  } else if (allString) {
+    return "StrEnum";
+  } else {
+    return "Enum";
+  }
+}
+export function EnumDeclaration(props) {
+  const {
+    $
+  } = useTsp();
+  let type;
+  if ($.union.is(props.type)) {
+    if (!$.union.isValidEnum(props.type)) {
+      throw new Error("The provided union type cannot be represented as an enum");
+    }
+    type = $.enum.createFromUnion(props.type);
+  } else {
+    type = props.type;
+  }
+  if (!props.type.name) {
+    reportDiagnostic($.program, {
+      code: "type-declaration-missing-name",
+      target: props.type
+    });
+  }
+  const refkeys = declarationRefkeys(props.refkey, props.type);
+  const name = props.name ?? py.usePythonNamePolicy().getName(props.type.name, "enum");
+  const members = Array.from(type.members.entries());
+  const doc = props.doc ?? $.type.getDoc(type);
+  const docElement = doc ? _$createComponent(py.ClassDoc, {
+    get description() {
+      return [_$createComponent(Prose, {
+        children: doc
+      })];
+    }
+  }) : undefined;
+  const enumType = determineEnumType(members);
+  return _$createComponent(py.ClassEnumDeclaration, {
+    doc: docElement,
+    name: name,
+    refkey: refkeys,
+    baseType: enumType,
+    get children() {
+      return _$createComponent(For, {
+        each: members,
+        hardline: true,
+        children: ([key, value]) => {
+          const memberDoc = $.type.getDoc(value);
+          return _$createComponent(EnumMember, {
+            doc: memberDoc,
+            type: value,
+            get refkey() {
+              return _$memo(() => !!$.union.is(props.type))() ? efRefkey(props.type.variants.get(key)) : efRefkey(value);
+            }
+          });
+        }
+      });
+    }
+  });
+}
+//# sourceMappingURL=enum-declaration.js.map