Skip to content

v3.5.0 with api barrel#51

Merged
magmacomputing merged 5 commits into
mainfrom
feature/v3.4.1
Jun 28, 2026
Merged

v3.5.0 with api barrel#51
magmacomputing merged 5 commits into
mainfrom
feature/v3.4.1

Conversation

@magmacomputing

@magmacomputing magmacomputing commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Summary by CodeRabbit

  • New Features

    • Added a new public plugin-api entry point for Tempo’s plugin capabilities.
  • Documentation

    • Updated installation and advanced CDN/browser guidance (including Smart vs Static CDN trade-offs).
    • Refreshed Temporal support notes for modern browsers and updated Node.js guidance.
    • Simplified chained localization/format modifier examples and linked to more detailed guidance.
    • Updated plugin and term docs wording for consistency.
  • Chores

    • Bumped the release version to 3.5.0 across package metadata and documentation.

@coderabbitai

coderabbitai Bot commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@magmacomputing, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 48 minutes and 24 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b5a8bd0d-b277-4535-8c18-1ba85dbc06e4

📥 Commits

Reviewing files that changed from the base of the PR and between 626dcc7 and 9774a2e.

📒 Files selected for processing (3)
  • packages/library/package.json
  • packages/tempo/doc/installation.md
  • packages/tempo/template/index.sample.html
📝 Walkthrough

Walkthrough

Bumps package versions to 3.5.0, adds a new ./plugin-api subpath export with a barrel module, and updates Tempo installation, plugin, cookbook, README, and browser template documentation.

Changes

v3.5.0 Release

Layer / File(s) Summary
plugin-api barrel module and package export
packages/tempo/src/plugin-api.index.ts, packages/tempo/package.json
New plugin-api.index.ts re-exports core, library, plugin, support, and term APIs; ./plugin-api subpath added to the exports map.
Version bumps and release scripts
packages/tempo/src/tempo.version.ts, packages/tempo/package.json, package.json, packages/library/package.json, bin/version-bump.mjs, bin/version-sync.mjs
TEMPO_VERSION and package manifests were bumped to 3.5.0, and root version scripts were split into standalone bump/sync Node scripts.
Documentation and template updates
packages/tempo/doc/installation.md, packages/tempo/README.md, packages/tempo/doc/tempo.cookbook.md, packages/tempo/doc/tempo.plugin.md, packages/tempo/doc/tempo.term.md, packages/tempo/template/index.sample.html
Installation guidance, plugin examples, cookbook wording, README link target, and the browser import-map template were updated to match the new plugin API and Temporal notes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

  • magmacomputing/magma#40: Modifies the same Tempo installation/browser documentation and import-map guidance files.
  • magmacomputing/magma#41: Directly changes packages/tempo/src/tempo.version.ts, the same version constant updated here.

Poem

🐇 Hop, hop, the release is bright,
Plugin paths and versions feel just right.
Temporal tips now point the way,
Docs and import maps join the play.
3.5.0—a tidy springtime leap!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is concise and accurately highlights the main changes: the v3.5.0 release and the new API barrel export.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/v3.4.1

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
packages/tempo/doc/installation.md (2)

164-191: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Document the new ./plugin-api subpath export in the granular ESM section.

The new plugin-api barrel (introduced in this release) explicitly simplifies static CDN importmaps by consolidating core, library, plugin, support, and term APIs into a single importable path. Given that this section describes the complex granular importmap required for static CDNs, it should mention that @magmacomputing/tempo/plugin-api is available as a simpler alternative. Add an entry like:

"`@magmacomputing/tempo/plugin-api`": "https://cdn.jsdelivr.net/npm/@magmacomputing/tempo@3/dist/plugin-api.index.js"

and explain when to use it versus the full granular map.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/tempo/doc/installation.md` around lines 164 - 191, The Granular ESM
documentation is missing the new `@magmacomputing/tempo/plugin-api` subpath
export, which should be presented as the simpler static-CDN option. Update the
installation.md “Granular ESM (Advanced Plugin Architecture)” section to add the
plugin-api importmap entry alongside the existing core/library/plugin mappings,
and clarify that plugin-api can replace the full granular map when consumers
want a single barrel for core, library, plugin, support, and term APIs. Use the
existing importmap example in this section and the
`@magmacomputing/tempo/plugin-api` symbol to place the change.

177-177: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Update version pins in granular ESM importmap to match current release.

The granular ESM example still references @3.2.1 (line 177) and @3.2.0 (lines 178-184) but this release bumps to 3.5.0. These stale version pins will mislead users and may cause compatibility issues with the new plugin-api subpath. Update to @3 or @3.5.1 for consistency with the release.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/tempo/doc/installation.md` at line 177, The granular ESM importmap
in the installation docs still has stale Tempo version pins that don’t match the
current release. Update the imports in the importmap example to use the new
3.5.x-compatible versioning (or a major pin like `@3`) across all referenced
entries, including the main tempo import and the plugin-api subpath, so the
example stays consistent with the release and avoids misleading users.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/tempo/doc/installation.md`:
- Line 9: The installation doc currently overstates native Temporal support by
claiming Node.js 26+; update the wording in the installation section to reflect
the correct Node.js minimum for unflagged native Temporal support and avoid
implying a non-existent release. Check the surrounding Temporal support
statement in the doc text, verify the current Node.js version claim, and revise
the sentence so it distinguishes between flagged support and true native
availability.

---

Outside diff comments:
In `@packages/tempo/doc/installation.md`:
- Around line 164-191: The Granular ESM documentation is missing the new
`@magmacomputing/tempo/plugin-api` subpath export, which should be presented as
the simpler static-CDN option. Update the installation.md “Granular ESM
(Advanced Plugin Architecture)” section to add the plugin-api importmap entry
alongside the existing core/library/plugin mappings, and clarify that plugin-api
can replace the full granular map when consumers want a single barrel for core,
library, plugin, support, and term APIs. Use the existing importmap example in
this section and the `@magmacomputing/tempo/plugin-api` symbol to place the
change.
- Line 177: The granular ESM importmap in the installation docs still has stale
Tempo version pins that don’t match the current release. Update the imports in
the importmap example to use the new 3.5.x-compatible versioning (or a major pin
like `@3`) across all referenced entries, including the main tempo import and the
plugin-api subpath, so the example stays consistent with the release and avoids
misleading users.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 433f93d3-bb5f-418a-959f-45f2cfe59ca7

📥 Commits

Reviewing files that changed from the base of the PR and between c893961 and bc621c3.

📒 Files selected for processing (8)
  • package.json
  • packages/library/package.json
  • packages/tempo/README.md
  • packages/tempo/doc/installation.md
  • packages/tempo/doc/tempo.cookbook.md
  • packages/tempo/package.json
  • packages/tempo/src/plugin-api.index.ts
  • packages/tempo/src/tempo.version.ts

Comment thread packages/tempo/doc/installation.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/tempo/doc/installation.md (1)

46-46: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Remove incorrect Node.js 26 version claim.

Line 46 states "Node.js 26.0.0 or later" as if this version exists. This should be reworded to avoid specifying a non-existent version, consistent with the correction needed at lines 9-14.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/tempo/doc/installation.md` at line 46, The installation docs in the
Temporal section should not claim support for a non-existent Node.js 26.0.0
release; update the sentence to use a valid, non-specific future/current wording
instead. Reword the affected text in the documentation so it stays consistent
with the earlier Node.js version guidance and does not mention a specific
nonexistent version.
🧹 Nitpick comments (1)
packages/tempo/template/index.sample.html (1)

19-19: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Pin the @js-temporal/polyfill CDN URL to an exact release. @0 follows the latest 0.x publish, so this template can change behavior without any repo update.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/tempo/template/index.sample.html` at line 19, The template is using
a floating CDN reference for `@js-temporal/polyfill`, which can change behavior
without a repo update. Update the import map entry in the sample HTML template
to point to a specific released version instead of `@0`, keeping the existing
`@js-temporal/polyfill` symbol and only changing the CDN URL to an exact pinned
release.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/tempo/doc/installation.md`:
- Around line 9-14: The installation guidance in `Tempo` still makes a
speculative claim about native unflagged `Temporal` support in Node.js 26, so
update the text in the documentation snippet to use accurate non-committal
wording like “a future Node.js release” or remove the version number entirely.
Keep the rest of the `Temporal` support explanation and the
`@js-temporal/polyfill` warning intact, and ensure the revised wording matches
the current `Temporal` support status without naming an unreleased Node.js
version.

---

Outside diff comments:
In `@packages/tempo/doc/installation.md`:
- Line 46: The installation docs in the Temporal section should not claim
support for a non-existent Node.js 26.0.0 release; update the sentence to use a
valid, non-specific future/current wording instead. Reword the affected text in
the documentation so it stays consistent with the earlier Node.js version
guidance and does not mention a specific nonexistent version.

---

Nitpick comments:
In `@packages/tempo/template/index.sample.html`:
- Line 19: The template is using a floating CDN reference for
`@js-temporal/polyfill`, which can change behavior without a repo update. Update
the import map entry in the sample HTML template to point to a specific released
version instead of `@0`, keeping the existing `@js-temporal/polyfill` symbol and
only changing the CDN URL to an exact pinned release.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d2dd3155-408a-4dbf-9dab-9d5e662d5fd9

📥 Commits

Reviewing files that changed from the base of the PR and between bc621c3 and 626dcc7.

📒 Files selected for processing (7)
  • bin/version-bump.mjs
  • bin/version-sync.mjs
  • package.json
  • packages/tempo/doc/installation.md
  • packages/tempo/doc/tempo.plugin.md
  • packages/tempo/doc/tempo.term.md
  • packages/tempo/template/index.sample.html
✅ Files skipped from review due to trivial changes (3)
  • bin/version-sync.mjs
  • packages/tempo/doc/tempo.term.md
  • packages/tempo/doc/tempo.plugin.md

Comment thread packages/tempo/doc/installation.md Outdated
@magmacomputing magmacomputing merged commit 586ea1e into main Jun 28, 2026
2 checks passed
@magmacomputing magmacomputing deleted the feature/v3.4.1 branch June 28, 2026 02:43
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