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

package/dist/src/components/PyDoc.js

@@ -1,131 +1,189 @@
-import { memo as _$memo, createComponent as _$createComponent, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { For, Indent, List, Prose, Show, childrenArray } from "@alloy-js/core";
-import { Atom } from "./index.js";
-function GoogleStyleDocParamType(props) {
-  return [_$createComponent(Show, {
-    get when() {
-      return Boolean(props.type);
-    },
-    get children() {
-      return [" (", _$memo(() => props.type), _$createComponent(Show, {
-        get when() {
-          return props.optional;
-        },
-        children: ", optional"
-      }), ")"];
-    }
-  })];
+import { Atom } from "./Atom.js";
+/**
+ * A component that creates a FunctionDoc block for functions.
+ */
+export function FunctionDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleFunctionDoc, rest);
+    default:
+      return undefined;
+  }
 }
-function GoogleStyleDocParamName(props) {
-  return [_$memo(() => props.name)];
+/**
+ * A component that creates a ClassDoc block for classes.
+ */
+export function ClassDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleClassDoc, rest);
+    default:
+      return undefined;
+  }
 }
-function GoogleStyleDocParamDescription(props) {
-  return _$createComponent(Show, {
-    get when() {
-      return Boolean(props.children);
-    },
-    get children() {
-      return [": ", _$createIntrinsic("align", {
-        width: 4,
-        get children() {
-          return [_$createComponent(Prose, {
-            get children() {
-              return props.children;
-            }
-          }), _$createComponent(Show, {
-            get when() {
-              return Boolean(props.defaultValue);
-            },
-            get children() {
-              return [" ", "Defaults to ", _$createComponent(Atom, {
-                get jsValue() {
-                  return props.defaultValue;
-                }
-              }), "."];
-            }
-          })];
-        }
-      })];
-    }
-  });
+/**
+ * A component that creates a ModuleDoc block for module-level documentation.
+ */
+export function ModuleDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleModuleDoc, rest);
+    default:
+      return undefined;
+  }
 }
 /**
- * Create a GoogleStyleDoc parameter.
+ * A component that creates a PropertyDoc block for `@property` decorated methods.
  */
-export function GoogleStyleDocParam(props) {
-  return [_$createComponent(GoogleStyleDocParamName, {
-    get name() {
-      return props.name;
-    }
-  }), _$createComponent(GoogleStyleDocParamType, {
-    get type() {
-      return props.type;
-    },
-    get optional() {
-      return props.optional;
-    }
-  }), _$createComponent(GoogleStyleDocParamDescription, {
-    get children() {
-      return props.children;
-    },
-    get defaultValue() {
-      return props.defaultValue;
-    }
-  })];
+export function PropertyDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStylePropertyDoc, rest);
+    default:
+      return undefined;
+  }
 }
 /**
- * A component that creates a GoogleStyleDoc block for parameters.
+ * A component that creates a GeneratorDoc block for generator functions.
  */
-export function GoogleStyleDocParams(props) {
-  const parameters = normalizeParametersForDoc(props.parameters);
-  return ["Args:", _$createComponent(Indent, {
+export function GeneratorDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleGeneratorDoc, rest);
+    default:
+      return undefined;
+  }
+}
+/**
+ * A component that creates an ExceptionDoc block for custom exception classes.
+ */
+export function ExceptionDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleExceptionDoc, rest);
+    default:
+      return undefined;
+  }
+}
+/**
+ * A component that creates documentation for a single attribute.
+ * This can be used for both inline and block attribute documentation.
+ */
+export function AttributeDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleAttributeDoc, rest);
+    default:
+      return undefined;
+  }
+}
+/**
+ * A component that creates a MethodDoc block for class methods.
+ * Automatically adds a note about not including 'self' parameter if no custom note is provided.
+ */
+export function MethodDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      {
+        return _$createComponent(GoogleStyleMethodDoc, rest);
+      }
+    default:
+      return undefined;
+  }
+}
+/**
+ * A PyDoc comment. The children of this component are joined with two hard
+ * linebreaks. This is useful for creating PyDoc comments with multiple paragraphs.
+ */
+export function PyDoc(props) {
+  const children = childrenArray(() => props.children);
+  return ['"""', _$createIntrinsic("hbr", {}), _$createComponent(List, {
+    doubleHardline: true,
+    children: children
+  }), _$createIntrinsic("hbr", {}), '"""', _$createIntrinsic("hbr", {})];
+}
+/**
+ * Create a PyDoc example, which is prepended by \>\>.
+ */
+export function PyDocExample(props) {
+  const children = childrenArray(() => props.children);
+  let lines = [];
+  if (children.length === 1 && typeof children[0] === "string") {
+    // Split, trim each line, and filter out empty lines
+    lines = children[0].split(/\r?\n/).map(line => line.trim()).filter(line => line.length > 0);
+  } else {
+    // For non-string children, filter out empty/whitespace-only strings
+    lines = children.map(child => typeof child === "string" ? child : "").map(line => line.trim()).filter(line => line.length > 0);
+  }
+  return [_$createComponent(For, {
+    each: lines,
+    children: line => [">> ", line]
+  })];
+}
+export function SimpleCommentBlock(props) {
+  return ["#", " ", _$createIntrinsic("align", {
+    string: "# ",
     get children() {
-      return _$createComponent(List, {
-        doubleHardline: true,
+      return _$createComponent(Prose, {
         get children() {
-          return parameters.map(param => _$createComponent(GoogleStyleDocParam, {
-            get name() {
-              return param.name;
-            },
-            get type() {
-              return param.type;
-            },
-            get optional() {
-              return param.optional;
-            },
-            get children() {
-              return param.doc;
-            }
-          }));
+          return props.children;
         }
       });
     }
   })];
 }
-/**
- * A component that creates a GoogleStyleDoc block for parameters.
- */
-export function GoogleStyleDocReturn(props) {
-  return ["Returns:", _$createComponent(Indent, {
+export function SimpleInlineComment(props) {
+  return ["  ", "# ", _$createComponent(Prose, {
     get children() {
-      return props.message;
+      return props.children;
     }
   })];
 }
-/**
- * A component that creates a GoogleStyleDoc block for parameters.
- */
-export function GoogleStyleDocRaises(props) {
-  return ["Raises:", _$createComponent(Indent, {
+export function SimpleInlineMemberComment(props) {
+  return ["  ", "#: ", _$createComponent(Prose, {
     get children() {
-      return props.message;
+      return props.children;
     }
   })];
 }
 /**
- * A component that creates a GoogleStyleFunctionDoc block for parameters.
+ * A component that creates a GoogleStyleFunctionDoc block for functions.
  */
-export function GoogleStyleFunctionDoc(props) {
+function GoogleStyleFunctionDoc(props) {
   // We are creating a list instead of relying on <Show> because otherwise
   // <List> would render spaces between the elements even if <Show> evaluates to false.
   const children = [];
@@ -133,75 +191,79 @@ export function GoogleStyleFunctionDoc(props) {
     children.push(_$createComponent(List, {
       doubleHardline: true,
       get children() {
-        return props.description.map(param => param);
+        return props.description;
       }
     }));
   }
-  if (props.parameters !== undefined && props.parameters.length > 0) {
+  if (props.parameters?.length) {
     children.push(_$createComponent(GoogleStyleDocParams, {
       get parameters() {
         return props.parameters;
       }
     }));
   }
-  if (props.returns !== undefined) {
+  if (props.returns) {
     children.push(_$createComponent(GoogleStyleDocReturn, {
       get message() {
         return props.returns;
       }
     }));
   }
-  if (props.raises !== undefined && props.raises.length > 0) {
+  if (props.yields) {
+    children.push(_$createComponent(GoogleStyleDocYields, {
+      get message() {
+        return props.yields;
+      }
+    }));
+  }
+  if (props.raises?.length) {
     children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
       message: param
     })));
   }
-  return _$createComponent(PyDoc, {
-    children: children
-  });
-}
-/**
- * A component that creates a FunctionDoc block for parameters.
- */
-export function FunctionDoc(props) {
-  const style = props.style ?? "google";
-  if (style === "google") {
-    return _$createComponent(GoogleStyleFunctionDoc, {
-      get description() {
-        return props.description;
-      },
-      get parameters() {
-        return props.parameters;
-      },
-      get returns() {
-        return props.returns;
-      },
-      get raises() {
-        return props.raises;
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
       }
-    });
+    }));
   }
-}
-/**
- * A component that creates a ClassDoc block for parameters.
- */
-export function ClassDoc(props) {
-  const style = props.style ?? "google";
-  if (style === "google") {
-    return _$createComponent(GoogleStyleClassDoc, {
-      get description() {
-        return props.description;
-      },
-      get parameters() {
-        return props.parameters;
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
       }
-    });
+    }));
   }
+  return _$createComponent(PyDoc, {
+    children: children
+  });
 }
 /**
- * A component that creates a GoogleStyleClassDoc block for parameters.
+ * A component that creates a GoogleStyleClassDoc block for classes.
  */
-export function GoogleStyleClassDoc(props) {
+function GoogleStyleClassDoc(props) {
   // We are creating a list instead of relying on <Show> because otherwise
   // <List> would render spaces between the elements even if <Show> evaluates to false.
   const children = [];
@@ -209,73 +271,675 @@ export function GoogleStyleClassDoc(props) {
     children.push(_$createComponent(List, {
       doubleHardline: true,
       get children() {
-        return props.description.map(param => param);
+        return props.description;
+      }
+    }));
+  }
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
       }
     }));
   }
-  if (props.parameters !== undefined && props.parameters.length > 0) {
+  if (props.parameters?.length) {
     children.push(_$createComponent(GoogleStyleDocParams, {
       get parameters() {
         return props.parameters;
       }
     }));
   }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }));
+  }
   return _$createComponent(PyDoc, {
     children: children
   });
 }
 /**
- * Create a PyDoc example, which is prepended by \>\>.
+ * A component that creates a GoogleStyleModuleDoc block for modules.
  */
-export function PyDocExample(props) {
-  const children = childrenArray(() => props.children);
-  let lines = [];
-  if (children.length === 1 && typeof children[0] === "string") {
-    // Split, trim each line, and filter out empty lines
-    lines = children[0].split(/\r?\n/).map(line => line.trim()).filter(line => line.length > 0);
-  } else {
-    // For non-string children, filter out empty/whitespace-only strings
-    lines = children.map(child => typeof child === "string" ? child : "").map(line => line.trim()).filter(line => line.length > 0);
+function GoogleStyleModuleDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }));
   }
-  return [_$createComponent(For, {
-    each: lines,
-    children: line => [">> ", line]
-  })];
-}
-function normalizeParametersForDoc(parameters) {
-  if (parameters.some(p => typeof p === "string")) {
-    return [];
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
+      }
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.todo?.length) {
+    children.push(_$createComponent(GoogleStyleDocTodo, {
+      get items() {
+        return props.todo;
+      }
+    }));
   }
-  return parameters;
+  return _$createComponent(PyDoc, {
+    children: children
+  });
 }
 /**
- * A PyDoc comment. The children of this component are joined with two hard
- * linebreaks. This is useful for creating PyDoc comments with multiple paragraphs.
+ * A component that creates a GoogleStylePropertyDoc block for properties.
  */
-export function PyDoc(props) {
-  const children = childrenArray(() => props.children);
-  return ['"""', _$createIntrinsic("hbr", {}), _$createComponent(List, {
-    doubleHardline: true,
-    children: children
-  }), _$createIntrinsic("hbr", {}), '"""', _$createIntrinsic("hbr", {})];
+function GoogleStylePropertyDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }));
+  }
+  if (props.returns) {
+    children.push(_$createComponent(GoogleStyleDocReturn, {
+      get message() {
+        return props.returns;
+      }
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  });
 }
-export function SimpleCommentBlock(props) {
-  return ["#", " ", _$createIntrinsic("align", {
-    string: "# ",
+/**
+ * A component that creates a GoogleStyleGeneratorDoc block for generators.
+ */
+function GoogleStyleGeneratorDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }));
+  }
+  if (props.yields) {
+    children.push(_$createComponent(GoogleStyleDocYields, {
+      get message() {
+        return props.yields;
+      }
+    }));
+  }
+  if (props.raises?.length) {
+    children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
+      message: param
+    })));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  });
+}
+/**
+ * A component that creates a GoogleStyleExceptionDoc block for exceptions.
+ */
+function GoogleStyleExceptionDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }));
+  }
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
+      }
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  });
+}
+/**
+ * A component that creates a GoogleStyleAttributeDoc block for attributes.
+ */
+function GoogleStyleAttributeDoc(props) {
+  return _$createComponent(GoogleStyleDocAttribute, {
+    get name() {
+      return props.name;
+    },
+    get type() {
+      return props.type;
+    },
     get children() {
-      return _$createComponent(Prose, {
+      return props.children;
+    }
+  });
+}
+/**
+ * A component that creates a GoogleStyleMethodDoc block for methods.
+ */
+function GoogleStyleMethodDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }));
+  }
+  if (props.returns) {
+    children.push(_$createComponent(GoogleStyleDocReturn, {
+      get message() {
+        return props.returns;
+      }
+    }));
+  }
+  if (props.raises?.length) {
+    children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
+      message: param
+    })));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }));
+  }
+  if (props.overrides) {
+    children.push(_$createComponent(GoogleStyleDocOverrides, {
+      get parentClass() {
+        return props.overrides;
+      }
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  });
+}
+/**
+ * A component that creates a GoogleStyleDoc block for parameters.
+ */
+function GoogleStyleDocParams(props) {
+  const parameters = props.parameters;
+
+  // Don't render anything if there are no parameters
+  if (!parameters || parameters.length === 0) {
+    return null;
+  }
+  return ["Args:", _$createComponent(Indent, {
+    get children() {
+      return _$createComponent(List, {
+        doubleHardline: true,
         get children() {
-          return props.children;
+          return parameters.map(param => _$createComponent(GoogleStyleDocParam, {
+            get name() {
+              return param.name;
+            },
+            get type() {
+              return param.type;
+            },
+            get ["default"]() {
+              return param.default;
+            },
+            get children() {
+              return param.doc;
+            }
+          }));
         }
       });
     }
   })];
 }
-export function SimpleInlineComment(props) {
-  return ["  ", "# ", _$createComponent(Prose, {
+/**
+ * Create a GoogleStyleDoc parameter.
+ */
+function GoogleStyleDocParam(props) {
+  return [_$createComponent(GoogleStyleDocParamName, {
+    get name() {
+      return props.name;
+    }
+  }), _$createComponent(GoogleStyleDocParamType, {
+    get type() {
+      return props.type;
+    },
+    get ["default"]() {
+      return Boolean(props.default);
+    }
+  }), _$createComponent(GoogleStyleDocParamDescription, {
     get children() {
       return props.children;
+    },
+    get ["default"]() {
+      return props.default;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for parameters.
+ */
+function GoogleStyleDocReturn(props) {
+  return ["Returns:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for exceptions.
+ */
+function GoogleStyleDocRaises(props) {
+  return ["Raises:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for generator yields.
+ */
+function GoogleStyleDocYields(props) {
+  return ["Yields:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  })];
+}
+/**
+ * Create a GoogleStyleDoc attribute entry.
+ */
+function GoogleStyleDocAttribute(props) {
+  return [_$createComponent(GoogleStyleDocParamName, {
+    get name() {
+      return props.name;
+    }
+  }), _$createComponent(GoogleStyleDocParamType, {
+    get type() {
+      return props.type;
+    }
+  }), _$createComponent(GoogleStyleDocParamDescription, {
+    get children() {
+      return props.children;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for attributes.
+ */
+function GoogleStyleDocAttributes(props) {
+  return ["Attributes:", _$createComponent(Indent, {
+    get children() {
+      return _$createComponent(List, {
+        doubleHardline: true,
+        get children() {
+          return props.attributes.map(attr => _$createComponent(GoogleStyleDocAttribute, {
+            get name() {
+              return attr.name;
+            },
+            get type() {
+              return attr.type;
+            },
+            get children() {
+              return attr.children;
+            }
+          }));
+        }
+      });
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for notes.
+ */
+function GoogleStyleDocNote(props) {
+  return ["Note:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for todo items.
+ */
+function GoogleStyleDocTodo(props) {
+  return ["Todo:", _$createComponent(Indent, {
+    get children() {
+      return _$createComponent(List, {
+        hardline: true,
+        get children() {
+          return props.items.map(item => ["* ", item]);
+        }
+      });
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for examples.
+ */
+function GoogleStyleDocExamples(props) {
+  return ["Examples:", _$createComponent(Indent, {
+    get children() {
+      return _$createComponent(List, {
+        doubleHardline: true,
+        get children() {
+          return props.items.map(item => item);
+        }
+      });
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for see also references.
+ */
+function GoogleStyleDocSeeAlso(props) {
+  return ["See Also:", _$createComponent(Indent, {
+    get children() {
+      return _$createComponent(List, {
+        hardline: true,
+        get children() {
+          return props.items.map(item => [item]);
+        }
+      });
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for warnings.
+ */
+function GoogleStyleDocWarning(props) {
+  return ["Warning:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
     }
   })];
 }
+/**
+ * A component that creates a GoogleStyleDoc block for deprecation notices.
+ */
+function GoogleStyleDocDeprecated(props) {
+  return ["Deprecated:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for overridden methods.
+ * This indicates that the method overrides a parent class method.
+ */
+function GoogleStyleDocOverrides(props) {
+  return ["Overrides:", _$createComponent(Indent, {
+    get children() {
+      return props.parentClass;
+    }
+  })];
+}
+function GoogleStyleDocParamType(props) {
+  return [_$createComponent(Show, {
+    get when() {
+      return Boolean(props.type);
+    },
+    get children() {
+      return [" (", _$memo(() => props.type), _$createComponent(Show, {
+        get when() {
+          return props.default;
+        },
+        children: ", optional"
+      }), ")"];
+    }
+  })];
+}
+function GoogleStyleDocParamName(props) {
+  return [_$memo(() => props.name)];
+}
+function GoogleStyleDocParamDescription(props) {
+  return _$createComponent(Show, {
+    get when() {
+      return Boolean(props.children);
+    },
+    get children() {
+      return [": ", _$createIntrinsic("align", {
+        width: 4,
+        get children() {
+          return _$createComponent(Prose, {
+            get children() {
+              return [_$memo(() => props.children), _$createComponent(Show, {
+                get when() {
+                  return Boolean(props.default);
+                },
+                get children() {
+                  return [_$createIntrinsic("br", {}), "Defaults to ", _$createComponent(Atom, {
+                    get jsValue() {
+                      return props.default;
+                    }
+                  }), "."];
+                }
+              })];
+            }
+          });
+        }
+      })];
+    }
+  });
+}
 //# sourceMappingURL=PyDoc.js.map