Skip to content

docs(stdlib): regenerate API reference - #73

Merged
Frotty merged 3 commits into
masterfrom
auto/stdlib-docgen
Oct 7, 2026
Merged

Frotty merged 3 commits into
masterfrom
auto/stdlib-docgen

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 17, 2026 •

Copy link
Copy Markdown
Contributor

Regenerates the stdlib API reference from the updated WurstStdlib2 sources, including ability rawcode links, constructor documentation, and public asset constants.

The package index previously serialized the entire API tree, duplicating declarations already rendered in reference pages. With class constants included, that grew to 28.7 MB / 919,335 lines. Limit the index to package metadata, summaries, tags, imports, and source links: 106 KB / 2,372 lines. The generator change is included so later regenerations keep the same format.

Constant anchors preserve case so distinct animation classes such as MurlocFlesheater_med and MurlocFleshEater_Med have distinct link targets. Ability rawcode references use the same anchors.

Validation: all 5 Deno tests pass, including failing-before/passing-after regressions for the index and anchor collision; full generation covers 168 packages. The index fix alone leaves reference pages unchanged; the anchor fix updates anchors and links. All 35,571 constant anchors are unique within their pages, and all 1,581 ability-ID reference links resolve. The remaining page additions are actual API entries previously absent from the docs.

@github-actions
github-actions Bot force-pushed the auto/stdlib-docgen branch 2 times, most recently from 4f170c2 to 2569092 Compare September 7, 2026 12:15
@github-actions
github-actions Bot force-pushed the auto/stdlib-docgen branch from e9dbd11 to 4c2e8d4 Compare October 5, 2026 14:21
@github-actions
github-actions Bot force-pushed the auto/stdlib-docgen branch from 4c2e8d4 to d2f8240 Compare October 7, 2026 13:02
@Frotty

Frotty commented Oct 7, 2026

Copy link
Copy Markdown
Member

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-07T13:24:37.978885Z 304521f Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

💡 Codex Review

https://github.com/wurstscript/wurstscript.github.io/blob/2f6f8aed11e8433d469fc25a4980f1b8479dbe0c/_doc/stdlib/ref/_wurst/UnitAnimations.md#L22521
P2 Badge Generate collision-free constant anchors

For classes that differ only by capitalization, constantAnchor() lowercases both names, so this anchor for MurlocFleshEater_Med.stand2 duplicates the anchor already emitted for MurlocFlesheater_med.stand2 at line 3641. A fragment URL ending in #murlocflesheater_med-stand2 therefore resolves to the first class, making the newly documented second constant unaddressable; preserve case or otherwise disambiguate anchors.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@Frotty

Frotty commented Oct 7, 2026

Copy link
Copy Markdown
Member

Addressed the constant-anchor finding in the latest commit: anchors now preserve case. The new collision regression failed before the fix and all 5 tests pass after it. Full regeneration has 35,571 unique constant anchors and all 1,581 rawcode reference links resolve. @codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Swish!

Reviewed commit: 304521f3b0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@Frotty
Frotty merged commit 03ea215 into master Oct 7, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant