Skip to content

docs: add typedoc support#1180

Open
markmichon wants to merge 6 commits intomainfrom
docs/typedoc-support
Open

docs: add typedoc support#1180
markmichon wants to merge 6 commits intomainfrom
docs/typedoc-support

Conversation

@markmichon
Copy link
Collaborator

Description

Adds support to get client officially into https://reference.sanity.io.

Past versions have been tacked together locally, leading to inconsistent results. This first step's goal is to avoid any configuration changes for the rest of the library's processes, while covering most of the exports mentioned in the readme and the Sanity docs. This PR does not add new annotations or address any internal-flagged items that should be public. Those will be addressed once this workflow is up and running.

Core parts:

  • Typedoc config
  • New workflow to build + publish to Sanity when a new release goes out.

What to review

  • Ensure the new upload-docs workflow makes sense with the repo's existing processes.

Testing

  • The docs:build command will output a JSON file to /docs. If it builds without errors, everything should be fine (warnings are okay).

@vercel
Copy link

vercel bot commented Jan 22, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Review Updated (UTC)
tsdocs-client Ignored Ignored Jan 27, 2026 6:13pm

Request Review

@socket-security
Copy link

socket-security bot commented Jan 22, 2026

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addednpm/​typedoc@​0.28.161001009894100
Addedgithub/​thollander/​actions-comment-pull-request@​24bffb9b452ba05a4f3f77933840a6a841d1b32b99100100100100
Addedgithub/​actions/​checkout@​de0fac2e4500dabe0009e67214ff5f5447ce83dd100100100100100

View full report

@socket-security
Copy link

socket-security bot commented Jan 22, 2026

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action Severity Alert  (click "▶" to expand/collapse)
Warn High
Obfuscated code: npm markdown-it is 91.0% likely obfuscated

Confidence: 0.91

Location: Package overview

From: package-lock.jsonnpm/typedoc@0.28.16npm/markdown-it@14.1.0

ℹ Read more on: This package | This alert | What is obfuscated code?

Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev.

Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code.

Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/markdown-it@14.1.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

@github-actions
Copy link
Contributor

github-actions bot commented Jan 22, 2026

Coverage Report

Status Category Percentage Covered / Total
🔵 Lines 88.29% 3945 / 4468
🔵 Statements 88.29% 3945 / 4468
🔵 Functions 86.02% 314 / 365
🔵 Branches 89.1% 1169 / 1312
File CoverageNo changed files found.
Generated in workflow #4055 for commit bc76a2f by the Vitest Coverage Report Action

@markmichon markmichon marked this pull request as ready for review January 26, 2026 18:10
@github-actions
Copy link
Contributor

📚 TypeDoc Generation Result

TypeDoc generated successfully!

  • File size: 2.7M
  • Total exports: 197
  • Artifact: sanity-typedoc-daaf6e038a89976ab71d3b17a381123880e1f806

The TypeDoc JSON file has been generated and validated. All documentation scripts completed successfully.

@github-actions
Copy link
Contributor

📚 TypeDoc Generation Result

TypeDoc generated successfully!

  • File size: 2.7M
  • Total exports: 201
  • Artifact: typedoc-c0e46923eb4845c7e062d89be5234946d553384a
  • HTML docs preview: Download artifact

The TypeDoc JSON file has been generated and validated. All documentation scripts completed successfully.

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