Feature/loose ends

[magmacomputing]

Summary by CodeRabbit

• New Features

  • Added Mutation & Math documentation covering immutable, chainable date adjustments.
  • Expanded documentation for layouts, registries, plugins, and ecosystem resources.

• Bug Fixes

  • Formatting now consistently returns strings, preserving leading zeros in numeric-looking values.
  • Corrected the installation badge’s display color.

• Documentation

  • Improved ticker interval guidance, navigation, and Quick Start examples.
  • Updated documentation structure and release information for version 3.9.3.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 7acce914-fa88-4cce-805c-21c872e5a9d0

📥 Commits

Reviewing files that changed from the base of the PR and between ffaba0c and 3f2e438.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (22)

• package.json
• packages/library/package.json
• packages/plugins/ticker/doc/index.md
• packages/tempo/.vitepress/config.ts
• packages/tempo/.vitepress/theme/components/CatalogList.vue
• packages/tempo/CHANGELOG.md
• packages/tempo/README.md
• packages/tempo/doc/2-core-concepts/tempo.mutate.md
• packages/tempo/doc/3-extending-tempo/tempo.layout.md
• packages/tempo/doc/3-extending-tempo/tempo.registry.md
• packages/tempo/package.json
• packages/tempo/src/module/module.format.ts
• packages/tempo/src/support/support.enum.ts
• packages/tempo/src/support/support.index.ts
• packages/tempo/src/tempo.class.ts
• packages/tempo/src/tempo.type.ts
• packages/tempo/src/tempo.version.ts
• packages/tempo/test/discrete/format.test.ts
• packages/tempo/test/discrete/standalone.test.ts
• packages/tempo/test/engine/pattern.default.test.ts
• packages/tempo/test/engine/pattern.weekday.test.ts
• packages/tempo/test/instance/instance.format.test.ts

💤 Files with no reviewable changes (1)

• packages/tempo/src/support/support.index.ts

---

📝 Walkthrough

Walkthrough

Tempo 3.9.3 makes formatting APIs string-only, removes numeric and bigint format typing, preserves zero-padded output, adds mutation, layout, and registry documentation, reorganizes documentation navigation, updates examples, and synchronizes release metadata.

Changes

Tempo 3.9.3 release

Layer / File(s)	Summary
String-only formatting contract packages/tempo/src/module/module.format.ts, packages/tempo/src/support/*, packages/tempo/src/tempo.class.ts, packages/tempo/src/tempo.type.ts	Formatting runtime results and public format-related types now resolve to strings, with numeric and bigint coercion paths and exports removed.
String formatting test expectations packages/tempo/test/discrete/*, packages/tempo/test/engine/*, packages/tempo/test/instance/*	Tests now expect string outputs and preserve leading zeroes for numeric-looking patterns.
Documentation and navigation updates packages/tempo/doc/*, packages/plugins/ticker/doc/index.md, packages/tempo/README.md, packages/tempo/.vitepress/config.ts	Mutation, layout, and registry guides were added or reorganized; ticker and README examples, ecosystem content, and sidebar navigation were updated.
Release metadata and UI corrections package.json, packages/library/package.json, packages/tempo/package.json, packages/tempo/src/tempo.version.ts, packages/tempo/CHANGELOG.md, packages/tempo/.vitepress/theme/components/CatalogList.vue	Package and library versions were bumped to 3.9.3, the canonical version and changelog were updated, and the catalog badge color was corrected.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• magmacomputing/magma#19: Introduces numeric coercion that this PR removes from formatting.
• magmacomputing/magma#43: Changes the same formatter numeric-output handling path.
• magmacomputing/magma#44: Overlaps with the formatter typings and runtime logic in module.format.ts.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check	❓ Inconclusive	The title is too vague and does not describe the main changes, which are version bumps, formatting type changes, and documentation updates.	Replace it with a concise, specific summary of the primary change, such as the formatting type simplification and docs updates.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
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 docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/loose-ends

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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