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

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

@@ -0,0 +1,1478 @@
+import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { For, Indent, List, Prose, Show, childrenArray, computed, isKeyedChild } from "@alloy-js/core";
+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, {
+        fileName: import.meta.url,
+        lineNumber: 39,
+        columnNumber: 14
+      });
+    default:
+      return undefined;
+  }
+}
+/**
+ * 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, {
+        fileName: import.meta.url,
+        lineNumber: 67,
+        columnNumber: 14
+      });
+    default:
+      return undefined;
+  }
+}
+/**
+ * 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, {
+        fileName: import.meta.url,
+        lineNumber: 94,
+        columnNumber: 14
+      });
+    default:
+      return undefined;
+  }
+}
+/**
+ * A component that creates a PropertyDoc block for `@property` decorated methods.
+ */
+export function PropertyDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStylePropertyDoc, rest, {
+        fileName: import.meta.url,
+        lineNumber: 121,
+        columnNumber: 14
+      });
+    default:
+      return undefined;
+  }
+}
+/**
+ * A component that creates a GeneratorDoc block for generator functions.
+ */
+export function GeneratorDoc(props) {
+  const {
+    style = "google",
+    ...rest
+  } = props;
+  switch (style) {
+    case "google":
+      return _$createComponent(GoogleStyleGeneratorDoc, rest, {
+        fileName: import.meta.url,
+        lineNumber: 150,
+        columnNumber: 14
+      });
+    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, {
+        fileName: import.meta.url,
+        lineNumber: 178,
+        columnNumber: 14
+      });
+    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, {
+        fileName: import.meta.url,
+        lineNumber: 202,
+        columnNumber: 14
+      });
+    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, {
+          fileName: import.meta.url,
+          lineNumber: 233,
+          columnNumber: 14
+        });
+      }
+    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", {}, {
+    fileName: import.meta.url,
+    lineNumber: 253,
+    columnNumber: 7
+  }), _$createComponent(List, {
+    doubleHardline: true,
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 254,
+    columnNumber: 7
+  }), _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 255,
+    columnNumber: 7
+  }), '"""', _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 257,
+    columnNumber: 7
+  })];
+}
+/**
+ * An inline documentation component for attribute docstrings.
+ * Unlike PyDoc, this doesn't add a trailing line break after the closing quotes,
+ * which is appropriate for documenting consecutive attributes like enum members.
+ */
+export function InlineDoc(props) {
+  return [_$createIntrinsic("hardline", {}, {
+    fileName: import.meta.url,
+    lineNumber: 274,
+    columnNumber: 7
+  }), '"""', _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 276,
+    columnNumber: 7
+  }), _$memo(() => props.children, false, "props.children"), _$createIntrinsic("hbr", {}, {
+    fileName: import.meta.url,
+    lineNumber: 278,
+    columnNumber: 7
+  }), '"""'];
+}
+/**
+ * Create a PyDoc example, which is prepended by \>\>.
+ */
+export function PyDocExample(props) {
+  const lines = computed(() => {
+    const kids = childrenArray(() => props.children, {
+      preserveFragments: true
+    });
+    const out = [];
+    const isBr = node => {
+      if (node == null) return false;
+      const keyed = isKeyedChild(node);
+      const tag = keyed ? node.tag : node?.tag;
+      const kind = node?.kind;
+      // Consider only <br /> as a line splitter (not rendered as content).
+      return tag === "br" || kind === "br";
+    };
+
+    // Handles a single string child: split on newlines to produce lines.
+    const splitAndTrim = s => s.split(/\r?\n/).map(x => x.trim()).filter(x => x.length > 0);
+    if (kids.length === 1 && typeof kids[0] === "string") {
+      return splitAndTrim(kids[0]);
+    }
+
+    // Handles mixed children: each child becomes a line, string children
+    // may include embedded newlines, and <br /> acts as a line split.
+    for (const child of kids) {
+      if (child == null || isBr(child)) continue;
+      if (typeof child === "string") {
+        // String children: split on newlines to produce lines.
+        for (const seg of splitAndTrim(child)) out.push(seg);
+      } else {
+        // Non-string child (component/fragment) are preserved as their own doctest line.
+        out.push(child);
+      }
+    }
+    return out;
+  });
+  return [_$createComponent(For, {
+    get each() {
+      return lines.value;
+    },
+    children: line => [">> ", line]
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 335,
+    columnNumber: 7
+  })];
+}
+export function SimpleCommentBlock(props) {
+  const children = childrenArray(() => props.children);
+  let content;
+  if (children.length === 1 && typeof children[0] === "string") {
+    const raw = children[0];
+    if (raw.includes("\n") || raw.includes("\\n")) {
+      const parts = raw.split(/\r?\n|\\n/);
+      content = [_$memo(() => parts.map((p, i) => [_$createComponent(Prose, {
+        children: p
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 362,
+        columnNumber: 15
+      }), _$memo(() => _$memo(() => i < parts.length - 1)() && _$createIntrinsic("hbr", {}, {
+        fileName: import.meta.url,
+        lineNumber: 363,
+        columnNumber: 40
+      }), false, "_$memo(\u2026)(\u2026) && \u2026")]), false, "parts.map(\u2026)")];
+    } else {
+      content = _$createComponent(Prose, {
+        get children() {
+          return props.children;
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 369,
+        columnNumber: 17
+      });
+    }
+  } else {
+    content = _$createComponent(Prose, {
+      get children() {
+        return props.children;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 372,
+      columnNumber: 15
+    });
+  }
+  return ["# ", _$createIntrinsic("align", {
+    string: "# ",
+    children: content
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 377,
+    columnNumber: 9
+  })];
+}
+export function SimpleInlineComment(props) {
+  return ["  ", "# ", _$createComponent(Prose, {
+    get children() {
+      return props.children;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 389,
+    columnNumber: 15
+  })];
+}
+/**
+ * A component that creates a GoogleStyleFunctionDoc block for functions.
+ */
+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 = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 408,
+      columnNumber: 19
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 411,
+      columnNumber: 19
+    }));
+  }
+  if (props.returns) {
+    children.push(_$createComponent(GoogleStyleDocReturn, {
+      get message() {
+        return props.returns;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 414,
+      columnNumber: 19
+    }));
+  }
+  if (props.yields) {
+    children.push(_$createComponent(GoogleStyleDocYields, {
+      get message() {
+        return props.yields;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 417,
+      columnNumber: 19
+    }));
+  }
+  if (props.raises?.length) {
+    children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
+      message: param
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 421,
+      columnNumber: 36
+    })));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 425,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 428,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 431,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 434,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 437,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 439,
+    columnNumber: 10
+  });
+}
+/**
+ * A component that creates a GoogleStyleClassDoc block for classes.
+ */
+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 = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 452,
+      columnNumber: 19
+    }));
+  }
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 455,
+      columnNumber: 19
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 458,
+      columnNumber: 19
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 461,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 464,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 467,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 470,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 473,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 475,
+    columnNumber: 10
+  });
+}
+/**
+ * A component that creates a GoogleStyleModuleDoc block for modules.
+ */
+function GoogleStyleModuleDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 486,
+      columnNumber: 19
+    }));
+  }
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 489,
+      columnNumber: 19
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 492,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 495,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 498,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 501,
+      columnNumber: 19
+    }));
+  }
+  if (props.todo?.length) {
+    children.push(_$createComponent(GoogleStyleDocTodo, {
+      get items() {
+        return props.todo;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 504,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 506,
+    columnNumber: 10
+  });
+}
+/**
+ * A component that creates a GoogleStylePropertyDoc block for properties.
+ */
+function GoogleStylePropertyDoc(props) {
+  const children = [];
+  if (props.description !== undefined) {
+    children.push(_$createComponent(List, {
+      doubleHardline: true,
+      get children() {
+        return props.description;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 517,
+      columnNumber: 19
+    }));
+  }
+  if (props.returns) {
+    children.push(_$createComponent(GoogleStyleDocReturn, {
+      get message() {
+        return props.returns;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 520,
+      columnNumber: 19
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 523,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 526,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 529,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 532,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 535,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 537,
+    columnNumber: 10
+  });
+}
+/**
+ * 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;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 549,
+      columnNumber: 19
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 552,
+      columnNumber: 19
+    }));
+  }
+  if (props.yields) {
+    children.push(_$createComponent(GoogleStyleDocYields, {
+      get message() {
+        return props.yields;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 555,
+      columnNumber: 19
+    }));
+  }
+  if (props.raises?.length) {
+    children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
+      message: param
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 559,
+      columnNumber: 36
+    })));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 563,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 566,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 569,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 572,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 575,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 577,
+    columnNumber: 10
+  });
+}
+/**
+ * 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;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 589,
+      columnNumber: 19
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 592,
+      columnNumber: 19
+    }));
+  }
+  if (props.attributes?.length) {
+    children.push(_$createComponent(GoogleStyleDocAttributes, {
+      get attributes() {
+        return props.attributes;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 595,
+      columnNumber: 19
+    }));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 598,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 601,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 604,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 607,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 610,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 612,
+    columnNumber: 10
+  });
+}
+/**
+ * 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 props.children;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 623,
+    columnNumber: 5
+  });
+}
+/**
+ * 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;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 637,
+      columnNumber: 19
+    }));
+  }
+  if (props.parameters?.length) {
+    children.push(_$createComponent(GoogleStyleDocParams, {
+      get parameters() {
+        return props.parameters;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 640,
+      columnNumber: 19
+    }));
+  }
+  if (props.returns) {
+    children.push(_$createComponent(GoogleStyleDocReturn, {
+      get message() {
+        return props.returns;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 643,
+      columnNumber: 19
+    }));
+  }
+  if (props.raises?.length) {
+    children.push(props.raises.map(param => _$createComponent(GoogleStyleDocRaises, {
+      message: param
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 647,
+      columnNumber: 36
+    })));
+  }
+  if (props.examples?.length) {
+    children.push(_$createComponent(GoogleStyleDocExamples, {
+      get items() {
+        return props.examples;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 651,
+      columnNumber: 19
+    }));
+  }
+  if (props.seeAlso?.length) {
+    children.push(_$createComponent(GoogleStyleDocSeeAlso, {
+      get items() {
+        return props.seeAlso;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 654,
+      columnNumber: 19
+    }));
+  }
+  if (props.warning) {
+    children.push(_$createComponent(GoogleStyleDocWarning, {
+      get message() {
+        return props.warning;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 657,
+      columnNumber: 19
+    }));
+  }
+  if (props.deprecated) {
+    children.push(_$createComponent(GoogleStyleDocDeprecated, {
+      get message() {
+        return props.deprecated;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 660,
+      columnNumber: 19
+    }));
+  }
+  if (props.overrides) {
+    children.push(_$createComponent(GoogleStyleDocOverrides, {
+      get parentClass() {
+        return props.overrides;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 663,
+      columnNumber: 19
+    }));
+  }
+  if (props.note) {
+    children.push(_$createComponent(GoogleStyleDocNote, {
+      get message() {
+        return props.note;
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 666,
+      columnNumber: 19
+    }));
+  }
+  return _$createComponent(PyDoc, {
+    children: children
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 668,
+    columnNumber: 10
+  });
+}
+/**
+ * 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 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;
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 692,
+            columnNumber: 13
+          }));
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 690,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 689,
+    columnNumber: 7
+  })];
+}
+/**
+ * Create a GoogleStyleDoc parameter.
+ */
+function GoogleStyleDocParam(props) {
+  return [_$createComponent(GoogleStyleDocParamName, {
+    get name() {
+      return props.name;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 719,
+    columnNumber: 7
+  }), _$createComponent(GoogleStyleDocParamType, {
+    get type() {
+      return props.type;
+    },
+    get ["default"]() {
+      return Boolean(props.default);
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 720,
+    columnNumber: 7
+  }), _$createComponent(GoogleStyleDocParamDescription, {
+    get children() {
+      return props.children;
+    },
+    get ["default"]() {
+      return props.default;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 724,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for parameters.
+ */
+function GoogleStyleDocReturn(props) {
+  return ["Returns:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 743,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for exceptions.
+ */
+function GoogleStyleDocRaises(props) {
+  return ["Raises:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 759,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for generator yields.
+ */
+function GoogleStyleDocYields(props) {
+  return ["Yields:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 775,
+    columnNumber: 7
+  })];
+}
+/**
+ * Create a GoogleStyleDoc attribute entry.
+ */
+function GoogleStyleDocAttribute(props) {
+  return [_$createComponent(GoogleStyleDocParamName, {
+    get name() {
+      return props.name;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 792,
+    columnNumber: 7
+  }), _$createComponent(GoogleStyleDocParamType, {
+    get type() {
+      return props.type;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 793,
+    columnNumber: 7
+  }), _$createComponent(GoogleStyleDocParamDescription, {
+    get children() {
+      return props.children;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 794,
+    columnNumber: 7
+  })];
+}
+/**
+ * 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;
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 813,
+            columnNumber: 13
+          }));
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 811,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 810,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for notes.
+ */
+function GoogleStyleDocNote(props) {
+  return ["Note:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 834,
+    columnNumber: 7
+  })];
+}
+/**
+ * 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]);
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 851,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 850,
+    columnNumber: 7
+  })];
+}
+/**
+ * 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);
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 873,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 872,
+    columnNumber: 7
+  })];
+}
+/**
+ * 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]);
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 891,
+        columnNumber: 9
+      });
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 890,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for warnings.
+ */
+function GoogleStyleDocWarning(props) {
+  return ["Warning:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 912,
+    columnNumber: 7
+  })];
+}
+/**
+ * A component that creates a GoogleStyleDoc block for deprecation notices.
+ */
+function GoogleStyleDocDeprecated(props) {
+  return ["Deprecated:", _$createComponent(Indent, {
+    get children() {
+      return props.message;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 928,
+    columnNumber: 7
+  })];
+}
+/**
+ * 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;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 945,
+    columnNumber: 7
+  })];
+}
+function GoogleStyleDocParamType(props) {
+  return [_$createComponent(Show, {
+    get when() {
+      return Boolean(props.type);
+    },
+    get children() {
+      return [" (", _$memo(() => props.type, false, "props.type"), _$createComponent(Show, {
+        get when() {
+          return props.default;
+        },
+        children: ", optional"
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 961,
+        columnNumber: 9
+      }), ")"];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 958,
+    columnNumber: 7
+  })];
+}
+function GoogleStyleDocParamName(props) {
+  return [_$memo(() => props.name, false, "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, false, "props.children"), _$createComponent(Show, {
+                get when() {
+                  return Boolean(props.default);
+                },
+                get children() {
+                  return [_$createIntrinsic("br", {}, {
+                    fileName: import.meta.url,
+                    lineNumber: 991,
+                    columnNumber: 13
+                  }), "Defaults to ", _$createComponent(Atom, {
+                    get jsValue() {
+                      return props.default;
+                    }
+                  }, {
+                    fileName: import.meta.url,
+                    lineNumber: 992,
+                    columnNumber: 25
+                  }), "."];
+                }
+              }, {
+                fileName: import.meta.url,
+                lineNumber: 990,
+                columnNumber: 11
+              })];
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 988,
+            columnNumber: 9
+          });
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 987,
+        columnNumber: 7
+      })];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 985,
+    columnNumber: 5
+  });
+}
+//# sourceMappingURL=PyDoc.js.map