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

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

@@ -0,0 +1,287 @@
+import { createComponent as _$createComponent, memo as _$memo, mergeProps as _$mergeProps, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+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 { MethodDeclarationBase } from "./MethodBase.js";
+const setterTag = Symbol();
+const deleterTag = Symbol();
+
+/** Context to provide property type information within a PropertyDeclaration */
+const PropertyContext = createContext();
+
+/**
+ * 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 function PropertyDeclaration(props) {
+  const nonEmptyOrNotImplemented = children => {
+    if (children && childrenArray(() => children).length > 0) {
+      return children;
+    } else {
+      return [code`raise NotImplementedError`];
+    }
+  };
+  const children = childrenArray(() => props.children);
+  const setterComponent = findKeyedChild(children, PropertyDeclaration.Setter.tag) ?? undefined;
+  const deleterComponent = findKeyedChild(children, PropertyDeclaration.Deleter.tag) ?? undefined;
+  const setterChildren = nonEmptyOrNotImplemented(setterComponent?.props?.children);
+  const deleterChildren = nonEmptyOrNotImplemented(deleterComponent?.props?.children);
+  const unkeyedChildren = nonEmptyOrNotImplemented(findUnkeyedChildren(children));
+  const sym = createMethodSymbol(props.name, {
+    refkeys: props.refkey
+  });
+  return [_$createComponent(DeclarationContext.Provider, {
+    value: sym,
+    get children() {
+      return _$createComponent(PropertyContext.Provider, {
+        get value() {
+          return props.type;
+        },
+        get children() {
+          return _$createComponent(List, {
+            hardline: true,
+            enderPunctuation: true,
+            get children() {
+              return [_$createComponent(PropertyMethodDeclaration, {
+                get abstract() {
+                  return props.abstract;
+                },
+                get doc() {
+                  return props.doc;
+                },
+                children: unkeyedChildren
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 120,
+                columnNumber: 13
+              }), _$createComponent(Show, {
+                get when() {
+                  return Boolean(setterComponent);
+                },
+                get children() {
+                  return _$createComponent(PropertyDeclaration.Setter, _$mergeProps(() => setterComponent?.props, {
+                    get type() {
+                      return setterComponent?.props?.type ?? props.type;
+                    },
+                    get abstract() {
+                      return setterComponent?.props?.abstract ?? props.abstract;
+                    },
+                    children: setterChildren
+                  }), {
+                    fileName: import.meta.url,
+                    lineNumber: 127,
+                    columnNumber: 15
+                  });
+                }
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 126,
+                columnNumber: 13
+              }), _$createComponent(Show, {
+                get when() {
+                  return Boolean(deleterComponent);
+                },
+                get children() {
+                  return _$createComponent(PropertyDeclaration.Deleter, _$mergeProps(() => deleterComponent?.props, {
+                    get abstract() {
+                      return deleterComponent?.props?.abstract ?? props.abstract;
+                    },
+                    children: deleterChildren
+                  }), {
+                    fileName: import.meta.url,
+                    lineNumber: 136,
+                    columnNumber: 15
+                  });
+                }
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 135,
+                columnNumber: 13
+              })];
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 119,
+            columnNumber: 11
+          });
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 118,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 117,
+    columnNumber: 7
+  })];
+}
+function PropertyMethodDeclaration(props) {
+  const propertySymbol = useContext(DeclarationContext);
+  const propertyType = useContext(PropertyContext);
+  return [code`@property`, _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 162,
+    columnNumber: 7
+  }), _$createComponent(MethodDeclarationBase, _$mergeProps(props, {
+    get name() {
+      return propertySymbol.name;
+    },
+    functionType: "instance",
+    returnType: propertyType,
+    sym: propertySymbol,
+    get children() {
+      return props.children;
+    }
+  }), {
+    fileName: import.meta.url,
+    lineNumber: 163,
+    columnNumber: 7
+  })];
+}
+function PropertyMethodBase(props) {
+  const propertySymbol = useContext(DeclarationContext);
+  const {
+    decoratorType,
+    parameters,
+    children,
+    ...restProps
+  } = props;
+  return [_$memo(() => code`@${propertySymbol.name}.${decoratorType}`), _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 189,
+    columnNumber: 7
+  }), _$createComponent(MethodDeclarationBase, _$mergeProps(restProps, {
+    get name() {
+      return propertySymbol.name;
+    },
+    functionType: "instance",
+    parameters: parameters,
+    get returnType() {
+      return _$createComponent(Atom, {
+        jsValue: null
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 195,
+        columnNumber: 21
+      });
+    },
+    sym: propertySymbol,
+    children: children
+  }), {
+    fileName: import.meta.url,
+    lineNumber: 190,
+    columnNumber: 7
+  })];
+}
+
+/**
+ * Adds a setter to a `PropertyDeclaration`.
+ *
+ * @example
+ * ```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>
+ * ```
+ * Generates:
+ * ```python
+ * @value.setter
+ * def value(self, value: int) -> None:
+ *     self._value = value
+ * ```
+ */
+PropertyDeclaration.Setter = taggedComponent(setterTag, function PropertySetter(props) {
+  return _$createComponent(PropertyMethodBase, _$mergeProps({
+    decoratorType: "setter",
+    get parameters() {
+      return [{
+        name: "value",
+        type: props.type
+      }];
+    }
+  }, props), {
+    fileName: import.meta.url,
+    lineNumber: 229,
+    columnNumber: 7
+  });
+});
+
+/**
+ * Adds a deleter to a `PropertyDeclaration`.
+ *
+ * @example
+ * ```tsx
+ * <py.PropertyDeclaration name="value" type={{ children: "int" }}>
+ *   return self._value
+ *   <py.PropertyDeclaration.Deleter>
+ *     del self._value
+ *   </py.PropertyDeclaration.Deleter>
+ * </py.PropertyDeclaration>
+ * ```
+ * Generates:
+ * ```python
+ * @value.deleter
+ * def value(self) -> None:
+ *     del self._value
+ * ```
+ */
+PropertyDeclaration.Deleter = taggedComponent(deleterTag, function PropertyDeleter(props) {
+  return _$createComponent(PropertyMethodBase, _$mergeProps({
+    decoratorType: "deleter"
+  }, props), {
+    fileName: import.meta.url,
+    lineNumber: 262,
+    columnNumber: 12
+  });
+});
+//# sourceMappingURL=PropertyDeclaration.js.map

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

@@ -0,0 +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","fileName","import","meta","url","lineNumber","columnNumber","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":[]}