@apify/docusaurus-plugin-typedoc-api 5.0.0 → 5.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/lib/components/SourceLink.d.ts +1 -1
  2. package/lib/components/SourceLink.d.ts.map +1 -1
  3. package/lib/components/SourceLink.js +15 -3
  4. package/lib/components/SourceLink.js.map +1 -1
  5. package/lib/plugin/python/transformation.d.ts +12 -2
  6. package/lib/plugin/python/transformation.d.ts.map +1 -1
  7. package/lib/plugin/python/transformation.js +89 -14
  8. package/lib/plugin/python/transformation.js.map +1 -1
  9. package/lib/plugin/python/types.d.ts +2 -7
  10. package/lib/plugin/python/types.d.ts.map +1 -1
  11. package/package.json +6 -1
  12. package/python-scripts/docspec-gen/google_docstring_processor.py +54 -20
  13. package/src/components/SourceLink.tsx +29 -13
  14. package/src/plugin/python/transformation.ts +89 -15
  15. package/src/plugin/python/types.ts +3 -4
package/lib/components/SourceLink.d.ts CHANGED
@@ -5,6 +5,6 @@ export interface SourceLinkProps {
5
5
  }
6
6
  export declare function resolveGithubUrl(source: JSONOutput.SourceReference & {
7
7
  gitRevision?: string;
8
- }, siteConfig: DocusaurusConfig, gitRefName: string): string;
8
+ }, siteConfig: DocusaurusConfig, gitRefName: string): string | undefined;
9
9
  export declare function SourceLink({ sources }: SourceLinkProps): import("react/jsx-runtime").JSX.Element;
10
10
  //# sourceMappingURL=SourceLink.d.ts.map
package/lib/components/SourceLink.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"SourceLink.d.ts","sourceRoot":"","sources":["../../src/components/SourceLink.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,eAAe,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAExJ;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAY,EAAE,EAAE,eAAe,2CAuB3D"}
1
+ {"version":3,"file":"SourceLink.d.ts","sourceRoot":"","sources":["../../src/components/SourceLink.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,eAAe,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUpK;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAY,EAAE,EAAE,eAAe,2CA+B3D"}
package/lib/components/SourceLink.js CHANGED
@@ -6,8 +6,14 @@ function replaceWithSrc(url) {
6
6
  return url.replace(/\/(dts|dist|lib|build|es|esm|cjs|mjs)\//, '/src/');
7
7
  }
8
8
  export function resolveGithubUrl(source, siteConfig, gitRefName) {
9
- var _a, _b;
10
- return (_a = source.url) !== null && _a !== void 0 ? _a : `https://${siteConfig.githubHost}${siteConfig.githubPort ? `:${siteConfig.githubPort}` : ''}/${siteConfig.organizationName}/${siteConfig.projectName}/blob/${(_b = source.gitRevision) !== null && _b !== void 0 ? _b : gitRefName}/${replaceWithSrc(source.fileName)}#L${source.line}`;
9
+ var _a;
10
+ if (source.url) {
11
+ return source.url;
12
+ }
13
+ if (!siteConfig.githubHost || !siteConfig.organizationName || !siteConfig.projectName) {
14
+ return undefined;
15
+ }
16
+ return `https://${siteConfig.githubHost}${siteConfig.githubPort ? `:${siteConfig.githubPort}` : ''}/${siteConfig.organizationName}/${siteConfig.projectName}/blob/${(_a = source.gitRevision) !== null && _a !== void 0 ? _a : gitRefName}/${replaceWithSrc(source.fileName)}#L${source.line}`;
11
17
  }
12
18
  export function SourceLink({ sources = [] }) {
13
19
  const { siteConfig } = useDocusaurusContext();
@@ -15,6 +21,12 @@ export function SourceLink({ sources = [] }) {
15
21
  if (sources.length === 0) {
16
22
  return null;
17
23
  }
18
- return (_jsx(_Fragment, { children: sources.map((source) => (_jsx("a", { className: "tsd-anchor", href: resolveGithubUrl(source, siteConfig, gitRefName), rel: "noreferrer", target: "_blank", children: _jsx("i", { className: "codicon codicon-file-code" }) }, source.fileName))) }));
24
+ return (_jsx(_Fragment, { children: sources.map((source) => {
25
+ const url = resolveGithubUrl(source, siteConfig, gitRefName);
26
+ if (!url) {
27
+ return null;
28
+ }
29
+ return (_jsx("a", { className: "tsd-anchor", href: url, rel: "noreferrer", target: "_blank", children: _jsx("i", { className: "codicon codicon-file-code" }) }, source.fileName));
30
+ }) }));
19
31
  }
20
32
  //# sourceMappingURL=SourceLink.js.map
package/lib/components/SourceLink.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"SourceLink.js","sourceRoot":"","sources":["../../src/components/SourceLink.tsx"],"names":[],"mappings":";AAEA,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,SAAS,cAAc,CAAC,GAAW;IAClC,8BAA8B;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,yCAAyC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAMD,MAAM,UAAU,gBAAgB,CAAC,MAA6D,EAAE,UAA4B,EAAE,UAAkB;;IAC/I,OAAO,MAAA,MAAM,CAAC,GAAG,mCAAI,WAAW,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,gBAAgB,IAAI,UAAU,CAAC,WAAW,SAAS,MAAA,MAAM,CAAC,WAAW,mCAAI,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;AACzQ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAE,OAAO,GAAG,EAAE,EAAmB;IAC3D,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,CACN,4BACE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,YAEC,SAAS,EAAC,YAAY,EACtB,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,UAAmB,EAAE,UAAU,CAAC,EAC/D,GAAG,EAAC,YAAY,EAChB,MAAM,EAAC,QAAQ,YAEf,YAAG,SAAS,EAAC,2BAA2B,GAAG,IANtC,MAAM,CAAC,QAAQ,CAOjB,CACJ,CAAC,GACA,CACH,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"SourceLink.js","sourceRoot":"","sources":["../../src/components/SourceLink.tsx"],"names":[],"mappings":";AAEA,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,SAAS,cAAc,CAAC,GAAW;IAClC,8BAA8B;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,yCAAyC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAMD,MAAM,UAAU,gBAAgB,CAAC,MAA6D,EAAE,UAA4B,EAAE,UAAkB;;IAC/I,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,GAAG,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACvF,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,WAAW,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,gBAAgB,IAAI,UAAU,CAAC,WAAW,SAAS,MAAA,MAAM,CAAC,WAAW,mCAAI,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;AAC3P,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAE,OAAO,GAAG,EAAE,EAAmB;IAC3D,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,CACN,4BACE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAmB,EAAE,UAAU,CAAC,CAAC;YAEtE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YACb,CAAC;YAED,OAAO,CACN,YAEC,SAAS,EAAC,YAAY,EACtB,IAAI,EAAE,GAAG,EACT,GAAG,EAAC,YAAY,EAChB,MAAM,EAAC,QAAQ,YAEf,YAAG,SAAS,EAAC,2BAA2B,GAAG,IANtC,MAAM,CAAC,QAAQ,CAOjB,CACJ,CAAC;QACH,CAAC,CAAC,GACA,CACH,CAAC;AACH,CAAC"}
package/lib/plugin/python/transformation.d.ts CHANGED
@@ -28,6 +28,12 @@ export declare class SymbolIdTracker {
28
28
  private generateOID;
29
29
  }
30
30
  export declare class DocspecTransformer {
31
+ /**
32
+ * Maps Google-style docstring section names to Docusaurus admonition types.
33
+ * Only sections that semantically match admonition purposes are included.
34
+ * Sections like Raises, Yields, Attributes are technical documentation, not admonitions.
35
+ */
36
+ private static readonly SECTION_TO_ADMONITION;
31
37
  private pythonTypeResolver;
32
38
  private inheritanceGraph;
33
39
  private symbolIdTracker;
@@ -63,12 +69,16 @@ export declare class DocspecTransformer {
63
69
  */
64
70
  private walkAndTransform;
65
71
  private getGitHubUrls;
72
+ /**
73
+ * Converts a docstring section to Docusaurus admonition markdown format.
74
+ */
75
+ private sectionToAdmonition;
66
76
  /**
67
77
  * If possible, parses the `.docstring` property of the passed object. If the docstring is a stringified JSON object,
68
78
  * it extracts the `args` and `returns` sections and adds them to the returned object.
69
79
  *
70
- * TODO
71
- * This structure is created in the `google` docstring format, which is a JSON object with the following structure:
80
+ * The docstring format is a JSON object with a `content` array that contains interleaved text strings
81
+ * and section objects, preserving the original order from the docstring.
72
82
  */
73
83
  private parseDocstring;
74
84
  /**
package/lib/plugin/python/transformation.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"transformation.d.ts","sourceRoot":"","sources":["../../../src/plugin/python/transformation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEX,aAAa,EACb,GAAG,EAEH,aAAa,EAEb,MAAM,SAAS,CAAC;AAkBjB,UAAU,yBAAyB;IAClC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAe;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAEpF,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;OAGG;IACH,QAAQ,IAAI,GAAG;IAIf,eAAe,CAAC,MAAM,EAAE,aAAa;IAWrC,mBAAmB;IAInB,WAAW,CAAC,IAAI,EAAE,MAAM;IAIxB,cAAc,CAAC,EAAE,EAAE,MAAM;IAIzB,OAAO,CAAE,WAAW;CAMpB;AAED,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,eAAe,CAAyB;IAEhD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA0B;IAE9C,OAAO,CAAC,QAAQ,CAAsD;gBAE1D,EAAE,eAAe,EAAE,WAAW,EAAE,EAAE,yBAAyB;IAQvE,SAAS,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,aAAa;IA2CzD,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IA8BpB;;;;;OAKG;IAEH,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,mBAAmB;IA2D3B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA4JxB,OAAO,CAAC,aAAa;IAMrB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,cAAc;CA6BtB"}
1
+ {"version":3,"file":"transformation.d.ts","sourceRoot":"","sources":["../../../src/plugin/python/transformation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEX,aAAa,EACb,GAAG,EAEH,aAAa,EAEb,MAAM,SAAS,CAAC;AAkBjB,UAAU,yBAAyB;IAClC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAe;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAEpF,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;OAGG;IACH,QAAQ,IAAI,GAAG;IAIf,eAAe,CAAC,MAAM,EAAE,aAAa;IAWrC,mBAAmB;IAInB,WAAW,CAAC,IAAI,EAAE,MAAM;IAIxB,cAAc,CAAC,EAAE,EAAE,MAAM;IAIzB,OAAO,CAAE,WAAW;CAMpB;AAED,qBAAa,kBAAkB;IAC9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAM3C;IAEF,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,eAAe,CAAyB;IAEhD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA0B;IAE9C,OAAO,CAAC,QAAQ,CAAsD;gBAE1D,EAAE,eAAe,EAAE,WAAW,EAAE,EAAE,yBAAyB;IAQvE,SAAS,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,aAAa;IA2CzD,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IA8BpB;;;;;OAKG;IAEH,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,mBAAmB;IA2D3B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA4JxB,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA+DtB;;OAEG;IACH,OAAO,CAAC,cAAc;CA6BtB"}
package/lib/plugin/python/transformation.js CHANGED
@@ -315,33 +315,96 @@ export class DocspecTransformer {
315
315
  const filePathInRepo = docspecMember.location.filename.replace(REPO_ROOT_PLACEHOLDER, '');
316
316
  return { filePathInRepo };
317
317
  }
318
+ /**
319
+ * Converts a docstring section to Docusaurus admonition markdown format.
320
+ */
321
+ sectionToAdmonition(sectionName, content) {
322
+ const admonitionType = DocspecTransformer.SECTION_TO_ADMONITION[sectionName];
323
+ if (!admonitionType) {
324
+ return '';
325
+ }
326
+ const contentText = content
327
+ .map((item) => {
328
+ if (typeof item === 'string') {
329
+ return item;
330
+ }
331
+ if (typeof item === 'object' && item !== null && 'desc' in item) {
332
+ const obj = item;
333
+ return obj.param ? `**${obj.param}**: ${obj.desc}` : obj.desc;
334
+ }
335
+ return '';
336
+ })
337
+ .filter(Boolean)
338
+ .join('\n');
339
+ if (!contentText) {
340
+ return '';
341
+ }
342
+ return `:::${admonitionType} ${sectionName}\n${contentText}\n:::`;
343
+ }
318
344
  /**
319
345
  * If possible, parses the `.docstring` property of the passed object. If the docstring is a stringified JSON object,
320
346
  * it extracts the `args` and `returns` sections and adds them to the returned object.
321
347
  *
322
- * TODO
323
- * This structure is created in the `google` docstring format, which is a JSON object with the following structure:
348
+ * The docstring format is a JSON object with a `content` array that contains interleaved text strings
349
+ * and section objects, preserving the original order from the docstring.
324
350
  */
325
351
  parseDocstring(docspecMember) {
326
- var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
352
+ var _a, _b, _c, _d, _e, _f, _g;
327
353
  const docstring = { text: (_b = (_a = docspecMember.docstring) === null || _a === void 0 ? void 0 : _a.content) !== null && _b !== void 0 ? _b : '' };
328
354
  try {
329
355
  const parsedDocstring = JSON.parse(docstring.text);
330
- docstring.text = parsedDocstring.text;
331
- const parsedArguments = ((_e = (_d = (_c = parsedDocstring.sections) === null || _c === void 0 ? void 0 : _c.find((section) => Object.keys(section)[0] === 'Arguments')) === null || _d === void 0 ? void 0 : _d.Arguments) !== null && _e !== void 0 ? _e : []);
332
- docstring.args =
333
- (_f = parsedArguments === null || parsedArguments === void 0 ? void 0 : parsedArguments.reduce((acc, arg) => {
334
- acc[arg.param] = arg.desc;
335
- return acc;
336
- }, {})) !== null && _f !== void 0 ? _f : {};
337
- const returnTypes = (_j = (_h = (_g = docstring.sections) === null || _g === void 0 ? void 0 : _g.find((section) => Object.keys(section)[0] === 'Returns')) === null || _h === void 0 ? void 0 : _h.Returns) !== null && _j !== void 0 ? _j : [];
338
- docstring.returns = returnTypes.join('\n');
356
+ // Build the text output by processing content items in order
357
+ const textParts = [];
358
+ for (const item of (_c = parsedDocstring.content) !== null && _c !== void 0 ? _c : []) {
359
+ if (typeof item === 'string') {
360
+ // Regular text content
361
+ textParts.push(item);
362
+ }
363
+ else {
364
+ // Section object
365
+ const sectionName = Object.keys(item)[0];
366
+ const sectionContent = item[sectionName];
367
+ if (sectionName === 'Arguments') {
368
+ // Extract arguments for parameter documentation
369
+ const parsedArguments = sectionContent;
370
+ docstring.args =
371
+ (_d = parsedArguments === null || parsedArguments === void 0 ? void 0 : parsedArguments.reduce((acc, arg) => {
372
+ acc[arg.param] = arg.desc;
373
+ return acc;
374
+ }, {})) !== null && _d !== void 0 ? _d : {};
375
+ }
376
+ else if (sectionName === 'Returns') {
377
+ // Extract return type documentation
378
+ docstring.returns = sectionContent
379
+ .map((returnsItem) => {
380
+ if (typeof returnsItem === 'string') {
381
+ return returnsItem;
382
+ }
383
+ if (typeof returnsItem === 'object' && returnsItem !== null && 'param' in returnsItem && 'desc' in returnsItem) {
384
+ const obj = returnsItem;
385
+ return `${obj.param}: ${obj.desc}`;
386
+ }
387
+ return '';
388
+ })
389
+ .filter(Boolean)
390
+ .join('\n');
391
+ }
392
+ else {
393
+ // Convert other sections to admonitions inline
394
+ const admonition = this.sectionToAdmonition(sectionName, sectionContent);
395
+ if (admonition) {
396
+ textParts.push(admonition);
397
+ }
398
+ }
399
+ }
400
+ }
401
+ docstring.text = textParts.join('\n\n');
339
402
  }
340
- catch (_o) {
403
+ catch (_h) {
341
404
  // Do nothing
342
405
  }
343
406
  if (!docstring.text) {
344
- docstring.text = (_m = (_l = (_k = this.getContext()) === null || _k === void 0 ? void 0 : _k.args) === null || _l === void 0 ? void 0 : _l[docspecMember.name]) !== null && _m !== void 0 ? _m : '';
407
+ docstring.text = (_g = (_f = (_e = this.getContext()) === null || _e === void 0 ? void 0 : _e.args) === null || _f === void 0 ? void 0 : _f[docspecMember.name]) !== null && _g !== void 0 ? _g : '';
345
408
  }
346
409
  return docstring;
347
410
  }
@@ -369,4 +432,16 @@ export class DocspecTransformer {
369
432
  return { typedocKind, typedocType };
370
433
  }
371
434
  }
435
+ /**
436
+ * Maps Google-style docstring section names to Docusaurus admonition types.
437
+ * Only sections that semantically match admonition purposes are included.
438
+ * Sections like Raises, Yields, Attributes are technical documentation, not admonitions.
439
+ */
440
+ DocspecTransformer.SECTION_TO_ADMONITION = {
441
+ Danger: 'danger',
442
+ Info: 'info',
443
+ Note: 'note',
444
+ Tip: 'tip',
445
+ Warning: 'warning',
446
+ };
372
447
  //# sourceMappingURL=transformation.js.map
package/lib/plugin/python/transformation.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"transformation.js","sourceRoot":"","sources":["../../../src/plugin/python/transformation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transformation.js","sourceRoot":"","sources":["../../../src/plugin/python/transformation.ts"],"names":[],"mappings":"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"}
package/lib/plugin/python/types.d.ts CHANGED
@@ -90,14 +90,9 @@ export interface TypeDocDocstring {
90
90
  args?: Record<string, string>;
91
91
  sections?: Record<string, any[]>[];
92
92
  }
93
+ export type DocspecDocstringContentItem = Record<string, any[]> | string;
93
94
  export interface DocspecDocstring {
94
- text: string;
95
- returns?: string;
96
- args?: {
97
- param: string;
98
- desc: string;
99
- }[];
100
- sections?: Record<string, any[]>[];
95
+ content: DocspecDocstringContentItem[];
101
96
  }
102
97
  export type TypeDocType = {
103
98
  [key: string]: any;
package/lib/plugin/python/types.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/python/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/python/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,EAAE,EAAE,GAAG,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,EAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACb,CAAC;IACF,UAAU,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,CAAC,EAAE;QACT,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC1C,SAAS,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,GAAG,EAAE,CAAA;SAAE,EAAE,CAAC;KAC9C,CAAC;IACF,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,aAAa,CAAC;IACjC,QAAQ,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,aAAa,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,EAAE,CAAC;CACxF;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,WAAW,GACtB;IACE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IACJ,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC;CACV,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC"}
package/package.json CHANGED
@@ -1,7 +1,10 @@
1
1
  {
2
2
  "name": "@apify/docusaurus-plugin-typedoc-api",
3
- "version": "5.0.0",
3
+ "version": "5.1.1",
4
4
  "description": "Docusaurus plugin that provides source code API documentation powered by TypeDoc.",
5
+ "workspaces": [
6
+ "playground/website"
7
+ ],
5
8
  "keywords": [
6
9
  "docusaurus",
7
10
  "plugin",
@@ -46,7 +49,9 @@
46
49
  "typescript": "^5.0.0"
47
50
  },
48
51
  "dependencies": {
52
+ "@docusaurus/theme-common": "^3.9.2",
49
53
  "@vscode/codicons": "^0.0.35",
54
+ "cheerio": "^1.2.0",
50
55
  "html-entities": "2.3.2",
51
56
  "marked": "^9.1.6",
52
57
  "marked-smartypants": "^1.1.5",
package/python-scripts/docspec-gen/google_docstring_processor.py CHANGED
@@ -95,8 +95,6 @@ class ApifyGoogleProcessor(Processor):
95
95
  "Keyword Args:": "Arguments",
96
96
  "Keyword Arguments:": "Arguments",
97
97
  "Methods:": "Methods",
98
- "Note:": "Notes",
99
- "Notes:": "Notes",
100
98
  "Other Parameters:": "Arguments",
101
99
  "Parameters:": "Arguments",
102
100
  "Return:": "Returns",
@@ -105,8 +103,11 @@ class ApifyGoogleProcessor(Processor):
105
103
  "References:": "References",
106
104
  "See Also:": "See Also",
107
105
  "Todo:": "Todo",
108
- "Warning:": "Warnings",
109
- "Warnings:": "Warnings",
106
+ "Note:": "Note",
107
+ "Tip:": "Tip",
108
+ "Info:": "Info",
109
+ "Warning:": "Warning",
110
+ "Danger:": "Danger",
110
111
  "Warns:": "Warns",
111
112
  "Yield:": "Yields",
112
113
  "Yields:": "Yields",
@@ -128,69 +129,102 @@ class ApifyGoogleProcessor(Processor):
128
129
  if not node.docstring:
129
130
  return
130
131
 
131
- lines = []
132
- sections = []
133
- current_lines: t.List[str] = []
132
+ content = [] # Interleaved list of text strings and section dicts
133
+ current_text_lines: t.List[str] = []
134
+ current_section_lines: t.List[str] = []
134
135
  in_codeblock = False
135
136
  keyword = None
137
+ keyword_indent = None
136
138
  multiline_argument_offset = -1
137
139
  state = { 'param_indent': None }
138
140
 
141
+ def _commit_text():
142
+ """Commit accumulated text lines to content."""
143
+ if current_text_lines:
144
+ text = "\n".join(current_text_lines)
145
+ if text.strip():
146
+ content.append(text)
147
+ current_text_lines.clear()
148
+
149
+ def _commit_section():
150
+ """Commit accumulated section to content."""
151
+ nonlocal keyword, keyword_indent
152
+ if keyword:
153
+ content.append({keyword: list(current_section_lines)})
154
+ current_section_lines.clear()
155
+ keyword = None
156
+ keyword_indent = None
157
+
139
158
  def _commit():
159
+ nonlocal keyword, keyword_indent
140
160
  if keyword:
141
- sections.append({keyword: list(current_lines)})
161
+ _commit_section()
142
162
  else:
143
- lines.extend(current_lines)
144
- current_lines.clear()
163
+ _commit_text()
145
164
 
146
165
  def is_continuation(line: str) -> bool:
147
166
  if state.get('param_indent') is None:
148
167
  state['param_indent'] = self.get_indent_size(line)
149
168
  return False
150
-
169
+
151
170
  return self.get_indent_size(line) > state.get('param_indent')
152
171
 
153
172
  for line in node.docstring.content.split("\n"):
154
173
  multiline_argument_offset += 1
155
174
  if line.lstrip().startswith("```"):
156
175
  in_codeblock = not in_codeblock
157
- current_lines.append(line)
176
+ if keyword:
177
+ current_section_lines.append(line)
178
+ else:
179
+ current_text_lines.append(line)
158
180
  if not in_codeblock:
159
181
  _commit()
160
182
  continue
161
183
 
162
184
  if in_codeblock:
163
- current_lines.append(line)
185
+ if keyword:
186
+ current_section_lines.append(line)
187
+ else:
188
+ current_text_lines.append(line)
164
189
  continue
165
190
 
166
191
  stripped = line.strip()
192
+ line_indent = self.get_indent_size(line)
193
+
167
194
  if stripped in self._keywords_map:
168
195
  _commit()
169
196
  keyword = self._keywords_map[stripped]
197
+ keyword_indent = line_indent
198
+ continue
199
+
200
+ # Check if we've exited the current section (line at same or less indent than keyword)
201
+ if keyword is not None and stripped and line_indent <= keyword_indent:
202
+ _commit()
203
+ # Process this line as regular text
204
+ current_text_lines.append(stripped)
170
205
  continue
171
206
 
172
207
  if keyword is None:
173
- lines.append(stripped)
208
+ current_text_lines.append(stripped)
174
209
  continue
175
210
 
176
211
  for param_re in self._param_res:
177
212
  param_match = param_re.match(stripped)
178
213
  if param_match and not is_continuation(line):
179
- current_lines.append(param_match.groupdict())
214
+ current_section_lines.append(param_match.groupdict())
180
215
  multiline_argument_offset = 0
181
216
  break
182
217
 
183
218
  if not param_match:
184
219
  if multiline_argument_offset == 1:
185
- current_lines[-1]["desc"] += "\n" + stripped
220
+ current_section_lines[-1]["desc"] += "\n" + stripped
186
221
  multiline_argument_offset = 0
187
222
  else:
188
- current_lines.append(stripped)
223
+ current_section_lines.append(stripped)
189
224
 
190
225
  _commit()
191
226
  node.docstring.content = json.dumps({
192
- "text": "\n".join(lines),
193
- "sections": sections,
227
+ "content": content,
194
228
  }, indent=None)
195
-
229
+
196
230
 
package/src/components/SourceLink.tsx CHANGED
@@ -12,8 +12,16 @@ export interface SourceLinkProps {
12
12
  sources?: JSONOutput.SourceReference[];
13
13
  }
14
14
 
15
- export function resolveGithubUrl(source: JSONOutput.SourceReference & { gitRevision?: string }, siteConfig: DocusaurusConfig, gitRefName: string): string {
16
- return source.url ?? `https://${siteConfig.githubHost}${siteConfig.githubPort ? `:${siteConfig.githubPort}` : ''}/${siteConfig.organizationName}/${siteConfig.projectName}/blob/${source.gitRevision ?? gitRefName}/${replaceWithSrc(source.fileName)}#L${source.line}`;
15
+ export function resolveGithubUrl(source: JSONOutput.SourceReference & { gitRevision?: string }, siteConfig: DocusaurusConfig, gitRefName: string): string | undefined {
16
+ if (source.url) {
17
+ return source.url;
18
+ }
19
+
20
+ if (!siteConfig.githubHost || !siteConfig.organizationName || !siteConfig.projectName) {
21
+ return undefined;
22
+ }
23
+
24
+ return `https://${siteConfig.githubHost}${siteConfig.githubPort ? `:${siteConfig.githubPort}` : ''}/${siteConfig.organizationName}/${siteConfig.projectName}/blob/${source.gitRevision ?? gitRefName}/${replaceWithSrc(source.fileName)}#L${source.line}`;
17
25
  }
18
26
 
19
27
  export function SourceLink({ sources = [] }: SourceLinkProps) {
@@ -26,17 +34,25 @@ export function SourceLink({ sources = [] }: SourceLinkProps) {
26
34
 
27
35
  return (
28
36
  <>
29
- {sources.map((source) => (
30
- <a
31
- key={source.fileName}
32
- className="tsd-anchor"
33
- href={resolveGithubUrl(source, siteConfig as never, gitRefName)}
34
- rel="noreferrer"
35
- target="_blank"
36
- >
37
- <i className="codicon codicon-file-code" />
38
- </a>
39
- ))}
37
+ {sources.map((source) => {
38
+ const url = resolveGithubUrl(source, siteConfig as never, gitRefName);
39
+
40
+ if (!url) {
41
+ return null;
42
+ }
43
+
44
+ return (
45
+ <a
46
+ key={source.fileName}
47
+ className="tsd-anchor"
48
+ href={url}
49
+ rel="noreferrer"
50
+ target="_blank"
51
+ >
52
+ <i className="codicon codicon-file-code" />
53
+ </a>
54
+ );
55
+ })}
40
56
  </>
41
57
  );
42
58
  }
package/src/plugin/python/transformation.ts CHANGED
@@ -86,6 +86,19 @@ export class SymbolIdTracker {
86
86
  };
87
87
 
88
88
  export class DocspecTransformer {
89
+ /**
90
+ * Maps Google-style docstring section names to Docusaurus admonition types.
91
+ * Only sections that semantically match admonition purposes are included.
92
+ * Sections like Raises, Yields, Attributes are technical documentation, not admonitions.
93
+ */
94
+ private static readonly SECTION_TO_ADMONITION: Record<string, string> = {
95
+ Danger: 'danger',
96
+ Info: 'info',
97
+ Note: 'note',
98
+ Tip: 'tip',
99
+ Warning: 'warning',
100
+ };
101
+
89
102
  private pythonTypeResolver: PythonTypeResolver;
90
103
 
91
104
  private inheritanceGraph: InheritanceGraph;
@@ -444,12 +457,42 @@ export class DocspecTransformer {
444
457
  return { filePathInRepo };
445
458
  }
446
459
 
460
+ /**
461
+ * Converts a docstring section to Docusaurus admonition markdown format.
462
+ */
463
+ private sectionToAdmonition(sectionName: string, content: unknown[]): string {
464
+ const admonitionType = DocspecTransformer.SECTION_TO_ADMONITION[sectionName];
465
+ if (!admonitionType) {
466
+ return '';
467
+ }
468
+
469
+ const contentText = content
470
+ .map((item) => {
471
+ if (typeof item === 'string') {
472
+ return item;
473
+ }
474
+ if (typeof item === 'object' && item !== null && 'desc' in item) {
475
+ const obj = item as { param?: string; desc: string };
476
+ return obj.param ? `**${obj.param}**: ${obj.desc}` : obj.desc;
477
+ }
478
+ return '';
479
+ })
480
+ .filter(Boolean)
481
+ .join('\n');
482
+
483
+ if (!contentText) {
484
+ return '';
485
+ }
486
+
487
+ return `:::${admonitionType} ${sectionName}\n${contentText}\n:::`;
488
+ }
489
+
447
490
  /**
448
491
  * If possible, parses the `.docstring` property of the passed object. If the docstring is a stringified JSON object,
449
492
  * it extracts the `args` and `returns` sections and adds them to the returned object.
450
493
  *
451
- * TODO
452
- * This structure is created in the `google` docstring format, which is a JSON object with the following structure:
494
+ * The docstring format is a JSON object with a `content` array that contains interleaved text strings
495
+ * and section objects, preserving the original order from the docstring.
453
496
  */
454
497
  private parseDocstring(docspecMember: DocspecObject): TypeDocDocstring {
455
498
  const docstring: TypeDocDocstring = { text: docspecMember.docstring?.content ?? '' };
@@ -457,21 +500,52 @@ export class DocspecTransformer {
457
500
  try {
458
501
  const parsedDocstring = JSON.parse(docstring.text) as DocspecDocstring;
459
502
 
460
- docstring.text = parsedDocstring.text;
461
- const parsedArguments = (parsedDocstring.sections?.find(
462
- (section) => Object.keys(section)[0] === 'Arguments',
463
- )?.Arguments ?? []) as DocspecDocstring['args'];
503
+ // Build the text output by processing content items in order
504
+ const textParts: string[] = [];
464
505
 
465
- docstring.args =
466
- parsedArguments?.reduce<Record<string, string>>((acc, arg) => {
467
- acc[arg.param] = arg.desc;
468
- return acc;
469
- }, {}) ?? {};
470
-
471
- const returnTypes =
472
- docstring.sections?.find((section) => Object.keys(section)[0] === 'Returns')?.Returns ?? [];
506
+ for (const item of parsedDocstring.content ?? []) {
507
+ if (typeof item === 'string') {
508
+ // Regular text content
509
+ textParts.push(item);
510
+ } else {
511
+ // Section object
512
+ const sectionName = Object.keys(item)[0];
513
+ const sectionContent = item[sectionName] as unknown[];
514
+
515
+ if (sectionName === 'Arguments') {
516
+ // Extract arguments for parameter documentation
517
+ const parsedArguments = sectionContent as { param: string; desc: string }[];
518
+ docstring.args =
519
+ parsedArguments?.reduce<Record<string, string>>((acc, arg) => {
520
+ acc[arg.param] = arg.desc;
521
+ return acc;
522
+ }, {}) ?? {};
523
+ } else if (sectionName === 'Returns') {
524
+ // Extract return type documentation
525
+ docstring.returns = sectionContent
526
+ .map((returnsItem) => {
527
+ if (typeof returnsItem === 'string') {
528
+ return returnsItem;
529
+ }
530
+ if (typeof returnsItem === 'object' && returnsItem !== null && 'param' in returnsItem && 'desc' in returnsItem) {
531
+ const obj = returnsItem as { param: string; desc: string };
532
+ return `${obj.param}: ${obj.desc}`;
533
+ }
534
+ return '';
535
+ })
536
+ .filter(Boolean)
537
+ .join('\n');
538
+ } else {
539
+ // Convert other sections to admonitions inline
540
+ const admonition = this.sectionToAdmonition(sectionName, sectionContent);
541
+ if (admonition) {
542
+ textParts.push(admonition);
543
+ }
544
+ }
545
+ }
546
+ }
473
547
 
474
- docstring.returns = returnTypes.join('\n');
548
+ docstring.text = textParts.join('\n\n');
475
549
  } catch {
476
550
  // Do nothing
477
551
  }
package/src/plugin/python/types.ts CHANGED
@@ -71,11 +71,10 @@ export interface TypeDocDocstring {
71
71
  sections?: Record<string, any[]>[];
72
72
  }
73
73
 
74
+ export type DocspecDocstringContentItem = Record<string, any[]> | string;
75
+
74
76
  export interface DocspecDocstring {
75
- text: string;
76
- returns?: string;
77
- args?: { param: string; desc: string }[];
78
- sections?: Record<string, any[]>[];
77
+ content: DocspecDocstringContentItem[];
79
78
  }
80
79
 
81
80
  export type TypeDocType =