@alloy-js/python 0.4.0-dev.3 → 0.4.0-dev.5

package/dist/dev/src/components/DataclassDeclaration.js

@@ -0,0 +1,177 @@
+import { memo as _$memo, createComponent as _$createComponent, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { For, Show } from "@alloy-js/core";
+import { snakeCase } from "change-case";
+import { dataclassesModule } from "../builtins/python.js";
+import { usePythonScope } from "../symbols/scopes.js";
+import { Atom } from "./Atom.js";
+import { ClassDeclaration } from "./ClassDeclaration.js";
+import { StatementList } from "./StatementList.js";
+
+/**
+ * Validate decorator-only rules that do not depend on class members.
+ */
+function validateDataclassDecoratorArgs(kwargs) {
+  if (kwargs.weakrefSlot === true && kwargs.slots !== true) {
+    throw new Error("weakref_slot=True requires slots=True in @dataclass decorator");
+  }
+  if (kwargs.order === true && kwargs.eq === false) {
+    throw new Error("order=True requires eq=True in @dataclass decorator");
+  }
+}
+
+/**
+ * Validate symbol-level conflicts. Must be called from within a member scope
+ * (inside the class body) so member symbols are available.
+ */
+function validateDataclassMemberConflicts(kwargs) {
+  const scope = usePythonScope();
+  const owner = scope.ownerSymbol;
+  if (!owner) return;
+  const hasMemberNamed = name => {
+    const instanceNames = owner.instanceMembers?.symbolNames;
+    const staticNames = owner.staticMembers?.symbolNames;
+    return Boolean(instanceNames?.has(name) || staticNames?.has(name));
+  };
+  if (kwargs.order === true) {
+    for (const m of ["__lt__", "__le__", "__gt__", "__ge__"]) {
+      if (hasMemberNamed(m)) {
+        throw new TypeError(`Cannot specify order=True when the class already defines ${m}()`);
+      }
+    }
+  }
+  if (kwargs.unsafeHash === true && hasMemberNamed("__hash__")) {
+    throw new TypeError("Cannot specify unsafe_hash=True when the class already defines __hash__()");
+  }
+  if (kwargs.frozen === true) {
+    if (hasMemberNamed("__setattr__")) {
+      throw new TypeError("Cannot specify frozen=True when the class already defines __setattr__()");
+    }
+    if (hasMemberNamed("__delattr__")) {
+      throw new TypeError("Cannot specify frozen=True when the class already defines __delattr__()");
+    }
+  }
+  if (kwargs.slots === true && hasMemberNamed("__slots__")) {
+    throw new TypeError("Cannot specify slots=True when the class already defines __slots__()");
+  }
+
+  // Enforce at most one KW_ONLY sentinel as a symbol
+  let kwOnlyCount = 0;
+  for (const sym of owner.instanceMembers) {
+    if (sym.originalName === "_") kwOnlyCount++;
+  }
+  if (kwOnlyCount > 1) {
+    throw new Error("Only one KW_ONLY sentinel is allowed per dataclass body");
+  }
+}
+
+/**
+ * Allowed keyword arguments for the Python `@dataclass(...)` decorator.
+ * Single source of truth: runtime keys and compile-time type are derived here.
+ */
+export const dataclassDecoratorKeys = ["init", "repr", "eq", "order", "unsafeHash", "frozen", "matchArgs", "kwOnly", "slots", "weakrefSlot"];
+export const dataclassDecoratorKeySet = new Set(dataclassDecoratorKeys);
+/**
+ * Renders a Python dataclass.
+ *
+ * Example:
+ * ```tsx
+ * <py.DataclassDeclaration name="User" kwOnly>
+ *   <py.VariableDeclaration instanceVariable omitNone name="id" type="int" />
+ *   <py.VariableDeclaration instanceVariable name={namekey("_", { ignoreNamePolicy: true })} type={dataclassesModule["."].KW_ONLY} omitNone />
+ *   <py.VariableDeclaration
+ *     instanceVariable
+ *     name="name"
+ *     type="str"
+ *     initializer={"Anonymous"}
+ *   />
+ * </py.DataclassDeclaration>
+ * ```
+ * Will render as:
+ * ```py
+ * from dataclasses import dataclass
+ * from dataclasses import KW_ONLY
+ *
+ * @dataclass(kw_only=True)
+ * class User:
+ *     id: int
+ *     _: KW_ONLY
+ *     name: str = "Anonymous"
+ * ```
+ */
+export function DataclassDeclaration(props) {
+  // Collect flags from props in the order they appear (preserves emission order)
+  const decoratorEntries = [];
+  const kwargs = {};
+  for (const key of Object.keys(props)) {
+    // Only include known flags; skip undefined values
+    if (dataclassDecoratorKeySet.has(key)) {
+      const value = props[key];
+      if (value !== undefined) {
+        kwargs[key] = value;
+        decoratorEntries.push([snakeCase(key), value]);
+      }
+    }
+  }
+  const hasDecoratorArgs = decoratorEntries.length > 0;
+  if (hasDecoratorArgs) {
+    validateDataclassDecoratorArgs(kwargs);
+  }
+  return ["@", _$memo(() => dataclassesModule["."].dataclass, false, "dataclassesModule[.].dataclass"), _$createComponent(Show, {
+    when: hasDecoratorArgs,
+    get children() {
+      return ["(", _$createComponent(For, {
+        each: decoratorEntries,
+        comma: true,
+        space: true,
+        children: ([k, v]) => [k, "=", _$createComponent(Atom, {
+          jsValue: v
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 172,
+          columnNumber: 19
+        })]
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 169,
+        columnNumber: 9
+      }), ")"];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 167,
+    columnNumber: 7
+  }), _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 178,
+    columnNumber: 7
+  }), _$createComponent(ClassDeclaration, {
+    get name() {
+      return props.name;
+    },
+    get bases() {
+      return props.bases;
+    },
+    get doc() {
+      return props.doc;
+    },
+    get refkey() {
+      return props.refkey;
+    },
+    get children() {
+      return [_$createComponent(StatementList, {
+        get children() {
+          return props.children;
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 185,
+        columnNumber: 9
+      }), _$memo(() => validateDataclassMemberConflicts(kwargs), false, "validateDataclassMemberConflicts(\u2026)")];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 179,
+    columnNumber: 7
+  })];
+}
+//# sourceMappingURL=DataclassDeclaration.js.map

package/dist/dev/src/components/DataclassDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["For","Show","snakeCase","dataclassesModule","usePythonScope","Atom","ClassDeclaration","StatementList","validateDataclassDecoratorArgs","kwargs","weakrefSlot","slots","Error","order","eq","validateDataclassMemberConflicts","scope","owner","ownerSymbol","hasMemberNamed","name","instanceNames","instanceMembers","symbolNames","staticNames","staticMembers","Boolean","has","m","TypeError","unsafeHash","frozen","kwOnlyCount","sym","originalName","dataclassDecoratorKeys","dataclassDecoratorKeySet","Set","DataclassDeclaration","props","decoratorEntries","key","Object","keys","value","undefined","push","hasDecoratorArgs","length","_$memo","dataclass","_$createComponent","when","children","each","comma","space","k","v","jsValue","fileName","import","meta","url","lineNumber","columnNumber","_$createIntrinsic","bases","doc","refkey"],"sources":["../../../../src/components/DataclassDeclaration.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/components/Declaration.js

@@ -0,0 +1,31 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { Declaration as CoreDeclaration } from "@alloy-js/core";
+import { createPythonSymbol } from "../symbol-creation.js";
+/**
+ * A Python declaration, which can be a class, function, variable, etc.
+ *
+ * @remarks
+ * This component is used to create a declaration with a symbol that can be
+ * referenced in the code.
+ */
+export function Declaration(props) {
+  let sym;
+  if (props.symbol) {
+    sym = props.symbol;
+  } else {
+    sym = createPythonSymbol(props.name, {
+      refkeys: props.refkey
+    }, props.nameKind);
+  }
+  return _$createComponent(CoreDeclaration, {
+    symbol: sym,
+    get children() {
+      return props.children;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 70,
+    columnNumber: 10
+  });
+}
+//# sourceMappingURL=Declaration.js.map

package/dist/dev/src/components/Declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Declaration","CoreDeclaration","createPythonSymbol","props","sym","symbol","name","refkeys","refkey","nameKind","_$createComponent","children","fileName","import","meta","url","lineNumber","columnNumber"],"sources":["../../../../src/components/Declaration.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAEEA,WAAW,IAAIC,eAAe,QAGzB,gBAAgB;AAEvB,SAASC,kBAAkB,QAAQ,uBAAuB;AAwC1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASF,WAAWA,CAACG,KAAuB,EAAE;EACnD,IAAIC,GAAuB;EAE3B,IAAID,KAAK,CAACE,MAAM,EAAE;IAChBD,GAAG,GAAGD,KAAK,CAACE,MAAM;EACpB,CAAC,MAAM;IACLD,GAAG,GAAGF,kBAAkB,CACtBC,KAAK,CAACG,IAAI,EACV;MACEC,OAAO,EAAEJ,KAAK,CAACK;IACjB,CAAC,EACDL,KAAK,CAACM,QACR,CAAC;EACH;EAEA,OAAAC,iBAAA,CAAQT,eAAe;IAACI,MAAM,EAAED,GAAG;IAAA,IAAAO,SAAA;MAAA,OAAGR,KAAK,CAACQ,QAAQ;IAAA;EAAA;IAAAC,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA;AACtD","ignoreList":[]}

package/dist/dev/src/components/DunderMethodDeclaration.js

@@ -0,0 +1,33 @@
+import { mergeProps as _$mergeProps, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { isNamekey, namekey } from "@alloy-js/core";
+import { MethodDeclaration } from "./MethodDeclaration.js";
+
+/**
+ * A Python dunder method declaration.
+ *
+ * @example
+ * ```tsx
+ * <py.DunderMethodDeclaration name="__repr__" returnType="str">
+ *   return f"<MyType>"
+ * </py.DunderMethodDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * def __repr__(self) -> str:
+ *     return f"<MyType>"
+ * ```
+ */
+
+export function DunderMethodDeclaration(props) {
+  const finalName = isNamekey(props.name) ? props.name : namekey(props.name, {
+    ignoreNamePolicy: true
+  });
+  return _$createComponent(MethodDeclaration, _$mergeProps(props, {
+    name: finalName
+  }), {
+    fileName: import.meta.url,
+    lineNumber: 29,
+    columnNumber: 10
+  });
+}
+//# sourceMappingURL=DunderMethodDeclaration.js.map

package/dist/dev/src/components/DunderMethodDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isNamekey","namekey","MethodDeclaration","DunderMethodDeclaration","props","finalName","name","ignoreNamePolicy","_$createComponent","_$mergeProps","fileName","import","meta","url","lineNumber","columnNumber"],"sources":["../../../../src/components/DunderMethodDeclaration.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,SAAS,EAAEC,OAAO,QAAQ,gBAAgB;AAEnD,SAASC,iBAAiB,QAAQ,wBAAwB;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,OAAO,SAASC,uBAAuBA,CAACC,KAAmC,EAAE;EAC3E,MAAMC,SAAS,GACbL,SAAS,CAACI,KAAK,CAACE,IAAI,CAAC,GACnBF,KAAK,CAACE,IAAI,GACVL,OAAO,CAACG,KAAK,CAACE,IAAI,EAAY;IAAEC,gBAAgB,EAAE;EAAK,CAAC,CAAC;EAC7D,OAAAC,iBAAA,CAAQN,iBAAiB,EAAAO,YAAA,CAAKL,KAAK;IAAEE,IAAI,EAAED;EAAS;IAAAK,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA;AACtD","ignoreList":[]}

package/dist/dev/src/components/EnumDeclaration.js

@@ -0,0 +1,259 @@
+import { createComponent as _$createComponent, memo as _$memo, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Declaration as CoreDeclaration, For, Show } from "@alloy-js/core";
+import { enumModule } from "../builtins/python.js";
+import { createPythonSymbol } from "../symbol-creation.js";
+import { EnumMember } from "./EnumMember.js";
+import { MemberScope } from "./MemberScope.js";
+import { PythonBlock } from "./PythonBlock.js";
+/**
+ * Create a Python enum using the functional syntax.
+ *
+ * This generates enums using the `Enum('Name', [...])` or `Enum('Name', {...})` syntax.
+ * The format depends on whether enum members have explicit values:
+ * - Members without values: `Enum('Direction', ['NORTH', 'SOUTH', 'EAST', 'WEST'])`
+ * - Members with values: `Enum('Direction', {'NORTH': 1, 'SOUTH': 2, 'EAST': 3, 'WEST': 4})`
+ *
+ * @example
+ * ```tsx
+ * <FunctionalEnumDeclaration
+ *   name="Direction"
+ *   members={[
+ *     { name: "NORTH" },
+ *     { name: "SOUTH" },
+ *     { name: "EAST" },
+ *     { name: "WEST" }
+ *   ]}
+ * />
+ * ```
+ * renders to:
+ * ```python
+ * Direction = Enum('Direction', ['NORTH', 'SOUTH', 'EAST', 'WEST'])
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <FunctionalEnumDeclaration
+ *   name="Status"
+ *   members={[
+ *     { name: "PENDING", value: 1 },
+ *     { name: "ACTIVE", value: 2 },
+ *     { name: "INACTIVE", value: 3 }
+ *   ]}
+ * />
+ * ```
+ * renders to:
+ * ```python
+ * Status = Enum('Status', {'PENDING': 1, 'ACTIVE': 2, 'INACTIVE': 3})
+ * ```
+ */
+export function FunctionalEnumDeclaration(props) {
+  const sym = createPythonSymbol(props.name, {
+    refkeys: props.refkey
+  }, "enum");
+  const members = props.members ?? [];
+  let opener, ender;
+  if (members.length && members.every(m => m.value === undefined)) {
+    // List of names: Enum('Direction', ['NORTH', ...])
+    opener = "[";
+    ender = "]";
+  } else {
+    // List of name-value pairs: Enum('Direction', {'NORTH': 1, ...})
+    opener = "{";
+    ender = "}";
+  }
+  const memberExpr = [opener, _$createComponent(For, {
+    each: members,
+    joiner: ", ",
+    children: m => _$createComponent(EnumMember, {
+      get name() {
+        return m.name;
+      },
+      get value() {
+        return m.value;
+      },
+      functional: true
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 96,
+      columnNumber: 17
+    })
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 95,
+    columnNumber: 7
+  }), ender];
+  return [_$createComponent(CoreDeclaration, {
+    symbol: sym,
+    get children() {
+      return [_$memo(() => sym.name, false, "sym.name"), " = ", _$memo(() => enumModule["."].Enum, false, "enumModule[.].Enum"), "('", _$memo(() => sym.name, false, "sym.name"), "',", " ", _$createComponent(MemberScope, {
+        ownerSymbol: sym,
+        children: memberExpr
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 105,
+        columnNumber: 9
+      }), ")"];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 103,
+    columnNumber: 7
+  })];
+}
+/**
+ * Create a Python enum using the class-based syntax.
+ *
+ * This generates enums using the `class Name(Enum):` syntax with member definitions
+ * inside the class body. Supports various member value styles including auto-generated
+ * values, explicit values, and custom base types.
+ *
+ * @example
+ * ```tsx
+ * <ClassEnumDeclaration
+ *   name="Direction"
+ *   members={[
+ *     { name: "NORTH" },
+ *     { name: "SOUTH" },
+ *     { name: "EAST" },
+ *     { name: "WEST" }
+ *   ]}
+ * />
+ * ```
+ * renders to:
+ * ```python
+ * class Direction(Enum):
+ *     NORTH = "NORTH"
+ *     SOUTH = "SOUTH"
+ *     EAST = "EAST"
+ *     WEST = "WEST"
+ * ```
+ *
+ * @example
+ * With explicit values:
+ * ```tsx
+ * <ClassEnumDeclaration
+ *   name="Status"
+ *   members={[
+ *     { name: "PENDING", value: 1 },
+ *     { name: "ACTIVE", value: 2 },
+ *     { name: "INACTIVE", value: 3 }
+ *   ]}
+ * />
+ * ```
+ * renders to:
+ * ```python
+ * class Status(Enum):
+ *     PENDING = 1
+ *     ACTIVE = 2
+ *     INACTIVE = 3
+ * ```
+ *
+ * @example
+ * With auto() values:
+ * ```tsx
+ * <ClassEnumDeclaration
+ *   name="Color"
+ *   style="auto"
+ *   members={[
+ *     { name: "RED" },
+ *     { name: "GREEN" },
+ *     { name: "BLUE" }
+ *   ]}
+ * />
+ * ```
+ * renders to:
+ * ```python
+ * class Color(Enum):
+ *     RED = auto()
+ *     GREEN = auto()
+ *     BLUE = auto()
+ * ```
+ */
+export function ClassEnumDeclaration(props) {
+  const baseType = props.baseType || "Enum";
+  const sym = createPythonSymbol(props.name, {
+    refkeys: props.refkey
+  }, "enum");
+  let memberList = (props.members ?? []).map(m => m.value === undefined ? {
+    ...m,
+    auto: false
+  } : m);
+  if (props.auto) {
+    memberList = memberList.map(m => m.value === undefined ? {
+      name: m.name,
+      auto: true
+    } : m);
+  }
+  return _$createComponent(CoreDeclaration, {
+    symbol: sym,
+    get children() {
+      return ["class ", _$memo(() => sym.name, false, "sym.name"), "(", _$memo(() => enumModule["."][baseType], false, "enumModule[.][baseType]"), ")", _$createComponent(MemberScope, {
+        ownerSymbol: sym,
+        get children() {
+          return _$createComponent(PythonBlock, {
+            opener: ":",
+            get children() {
+              return [_$createComponent(Show, {
+                get when() {
+                  return Boolean(props.doc);
+                },
+                get children() {
+                  return [_$memo(() => props.doc, false, "props.doc"), _$createIntrinsic("hbr", {}, {
+                    fileName: import.meta.url,
+                    lineNumber: 211,
+                    columnNumber: 13
+                  })];
+                }
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 209,
+                columnNumber: 11
+              }), _$createComponent(For, {
+                each: memberList,
+                hardline: true,
+                children: member => _$createComponent(EnumMember, {
+                  get name() {
+                    return member.name;
+                  },
+                  get value() {
+                    return member.value;
+                  },
+                  get jsValue() {
+                    return member.jsValue;
+                  },
+                  get auto() {
+                    return member.auto;
+                  },
+                  get doc() {
+                    return member.doc;
+                  }
+                }, {
+                  fileName: import.meta.url,
+                  lineNumber: 215,
+                  columnNumber: 15
+                })
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 213,
+                columnNumber: 11
+              }), _$memo(() => props.children, false, "props.children")];
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 208,
+            columnNumber: 9
+          });
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 207,
+        columnNumber: 7
+      })];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 205,
+    columnNumber: 5
+  });
+}
+//# sourceMappingURL=EnumDeclaration.js.map

package/dist/dev/src/components/EnumDeclaration.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Declaration","CoreDeclaration","For","Show","enumModule","createPythonSymbol","EnumMember","MemberScope","PythonBlock","FunctionalEnumDeclaration","props","sym","name","refkeys","refkey","members","opener","ender","length","every","m","value","undefined","memberExpr","_$createComponent","each","joiner","children","functional","fileName","import","meta","url","lineNumber","columnNumber","symbol","_$memo","Enum","ownerSymbol","ClassEnumDeclaration","baseType","memberList","map","auto","when","Boolean","doc","_$createIntrinsic","hardline","member","jsValue"],"sources":["../../../../src/components/EnumDeclaration.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,95 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { Show } from "@alloy-js/core";
+import { enumModule } from "../builtins/python.js";
+import { createPythonSymbol } from "../symbol-creation.js";
+import { Atom } from "./Atom.js";
+import { InlineDoc } from "./PyDoc.js";
+/**
+ * A Python enum member.
+ *
+ * @example
+ * ```tsx
+ * <EnumMember name="NORTH" />
+ * ```
+ * This will generate:
+ * ```python
+ * NORTH
+ * ```
+ */
+export function EnumMember(props) {
+  const autoReference = props.auto === true ? enumModule["."].auto : undefined;
+  const value = props.auto === true ? [autoReference, "()"] : props.value;
+  const sym = createPythonSymbol(props.name, {
+    refkeys: props.refkey
+  }, "enum-member");
+  const valueCode = props.jsValue !== undefined ? _$createComponent(Atom, {
+    get jsValue() {
+      return props.jsValue;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 69,
+    columnNumber: 35
+  }) : value;
+  if (props.functional) {
+    return ["'", _$memo(() => sym.name, false, "sym.name"), "'", _$createComponent(Show, {
+      when: valueCode !== undefined,
+      get children() {
+        return [" : ", valueCode];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 74,
+      columnNumber: 21
+    }), _$createComponent(Show, {
+      get when() {
+        return props.doc !== undefined;
+      },
+      get children() {
+        return _$createComponent(InlineDoc, {
+          get children() {
+            return props.doc;
+          }
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 76,
+          columnNumber: 11
+        });
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 75,
+      columnNumber: 9
+    })];
+  }
+  return [_$memo(() => sym.name, false, "sym.name"), _$createComponent(Show, {
+    when: valueCode !== undefined,
+    get children() {
+      return [" = ", valueCode];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 84,
+    columnNumber: 7
+  }), _$createComponent(Show, {
+    get when() {
+      return props.doc !== undefined;
+    },
+    get children() {
+      return _$createComponent(InlineDoc, {
+        get children() {
+          return props.doc;
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 86,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 85,
+    columnNumber: 7
+  })];
+}
+//# sourceMappingURL=EnumMember.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Show","enumModule","createPythonSymbol","Atom","InlineDoc","EnumMember","props","autoReference","auto","undefined","value","sym","name","refkeys","refkey","valueCode","jsValue","_$createComponent","fileName","import","meta","url","lineNumber","columnNumber","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,SAAS;AAwClB;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;IAAAE,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA,KAAOb,KAAK;EAExE,IAAIJ,KAAK,CAACkB,UAAU,EAAE;IACpB,aAAAC,MAAA,OAEMd,GAAG,CAACC,IAAI,2BAAAK,iBAAA,CAAGjB,IAAI;MAAC0B,IAAI,EAAEX,SAAS,KAAKN,SAAS;MAAA,IAAAkB,SAAA;QAAA,eAAMZ,SAAS;MAAA;IAAA;MAAAG,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;MAAAC,UAAA;MAAAC,YAAA;IAAA,IAAAN,iBAAA,CAC7DjB,IAAI;MAAA,IAAC0B,IAAIA,CAAA;QAAA,OAAEpB,KAAK,CAACsB,GAAG,KAAKnB,SAAS;MAAA;MAAA,IAAAkB,SAAA;QAAA,OAAAV,iBAAA,CAChCb,SAAS;UAAA,IAAAuB,SAAA;YAAA,OAAErB,KAAK,CAACsB,GAAG;UAAA;QAAA;UAAAV,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;UAAAC,UAAA;UAAAC,YAAA;QAAA;MAAA;IAAA;MAAAL,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;MAAAC,UAAA;MAAAC,YAAA;IAAA;EAI7B;EACA,QAAAE,MAAA,OAEKd,GAAG,CAACC,IAAI,sBAAAK,iBAAA,CACRjB,IAAI;IAAC0B,IAAI,EAAEX,SAAS,KAAKN,SAAS;IAAA,IAAAkB,SAAA;MAAA,eAAMZ,SAAS;IAAA;EAAA;IAAAG,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA,IAAAN,iBAAA,CACjDjB,IAAI;IAAA,IAAC0B,IAAIA,CAAA;MAAA,OAAEpB,KAAK,CAACsB,GAAG,KAAKnB,SAAS;IAAA;IAAA,IAAAkB,SAAA;MAAA,OAAAV,iBAAA,CAChCb,SAAS;QAAA,IAAAuB,SAAA;UAAA,OAAErB,KAAK,CAACsB,GAAG;QAAA;MAAA;QAAAV,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;QAAAC,UAAA;QAAAC,YAAA;MAAA;IAAA;EAAA;IAAAL,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA;AAI7B","ignoreList":[]}