Skip to content

Publish readiness: RELEASING.md, npm bootstrap path, tex runtime docs - #8

Merged
macalinao merged 3 commits into
mainfrom
publish-ready
Nov 15, 2026
Merged

macalinao merged 3 commits into
mainfrom
publish-ready

Conversation

@macalinao

Copy link
Copy Markdown
Contributor

Makes every package publishable and documents the release pipeline. Nothing is published by this PR.

State

  • crates.io: all four crates are at 0.1.1. 0.1.0 was published with a token, and 0.1.1 went through trusted publishing from release-plz.yml, so the crates side already works.
  • npm: @talaagent/mxblocks-element and @talaagent/mxblocks-math are not published. The @talaagent scope is unclaimed. NPM_RELEASE is unset, so npm-release.yml is skipped for now.
  • KaTeX GHSA-238p-pmpm-9mq7 (patched in 0.18.2): main has katex 0.19.1, which came in through Bump the javascript-dependencies group with 4 updates #3.

Changes

  • RELEASING.md: the release flow for both registries and the one-time owner steps for npm (create the org, publish the first version, set up trusted publishers).
  • npm-release.yml: optional NPM_BOOTSTRAP_TOKEN environment secret, so the very first publish can run from CI with provenance. Leave it empty after that and OIDC is used.
  • mxblocks-tex: documents that the crate needs mxblocks-math (npm, or the Nix package) at runtime. It builds without it.
  • npm manifests: keywords added, and the Element package builds its bundle on prepack.

Local gate: fmt, clippy -D warnings, cargo test, cargo doc, cargo publish --workspace --dry-run, pnpm check (typecheck, test, build), pnpm artifacts, scripts/test-artifacts, npm publish --dry-run on both tarballs, privacy-check and actionlint all pass. gitleaks found nothing in the full history.

@macalinao
macalinao merged commit 523fcd9 into main Nov 15, 2026
6 checks passed
@github-actions github-actions Bot mentioned this pull request Nov 15, 2026
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