Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor: Change StateDB to class based architecture. #6185

Open
wants to merge 3 commits into
base: develop
Choose a base branch
from

Conversation

saurabhg772244
Copy link
Collaborator

📑 Summary

  • Refactors the existing stateDb implementation from a functional approach to a class-based architecture to improve code organization, maintainability, and extensibility.
  • Return a new DB object when diagramObject.db is called.
  • Introduces new StateDB class to encapsulate database operations and state
  • Migrates existing functions to class methods
  • Maintains existing API interface for backwards compatibility
  • Following functions still uses common DB:
    • getConfig
    • getAccTitle
    • setAccTitle
    • getAccDescription
    • setAccDescription
    • getDiagramTitle
    • setDiagramTitle
  • Reason why above functions still uses common DB: Refactor: Change flowDB to class based architecture. #6161 (comment)

📏 Design Decisions

  • The stateDb module previously relied on functions and global variables. Consequently, each call to mermaid.parse or mermaid.render resulted in changes to global variables.
  • This behavior caused issues when rendering multiple diagrams using the same Mermaid API, as the database object (DB) for the diagrams would get mixed up.
  • To address this, stateDb was refactored into a class-based structure. This change ensures that each diagramObject.db call creates a new instance of the database (DB), preventing conflicts between diagrams.
  • Arrow Functions are used instead of class Fields as it is required by flow.jison

📋 Tasks

Make sure you

  • 📖 have read the contribution guidelines
  • 💻 have added necessary unit/e2e tests.
  • 📓 have added documentation. Make sure MERMAID_RELEASE_VERSION is used for all new features.
  • 🦋 If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

Copy link

changeset-bot bot commented Jan 14, 2025

🦋 Changeset detected

Latest commit: ef9bb53

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
mermaid Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions github-actions bot added the Type: Other Not an enhancement or a bug label Jan 14, 2025
Copy link

netlify bot commented Jan 14, 2025

Deploy Preview for mermaid-js ready!

Name Link
🔨 Latest commit ef9bb53
🔍 Latest deploy log https://app.netlify.com/sites/mermaid-js/deploys/67865498d4881d00082d05ca
😎 Deploy Preview https://deploy-preview-6185--mermaid-js.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link

pkg-pr-new bot commented Jan 14, 2025

Open in Stackblitz

npm i https://pkg.pr.new/mermaid-js/mermaid@6185
npm i https://pkg.pr.new/mermaid-js/mermaid/@mermaid-js/layout-elk@6185
npm i https://pkg.pr.new/mermaid-js/mermaid/@mermaid-js/mermaid-zenuml@6185
npm i https://pkg.pr.new/mermaid-js/mermaid/@mermaid-js/parser@6185

commit: ef9bb53

Copy link

codecov bot commented Jan 14, 2025

Codecov Report

Attention: Patch coverage is 0% with 576 lines in your changes missing coverage. Please review.

Project coverage is 4.48%. Comparing base (bc2cc61) to head (ef9bb53).

Files with missing lines Patch % Lines
packages/mermaid/src/diagrams/state/stateDb.js 0.00% 566 Missing ⚠️
...ages/mermaid/src/diagrams/state/stateDiagram-v2.ts 0.00% 4 Missing ⚠️
...ackages/mermaid/src/diagrams/state/stateDiagram.ts 0.00% 4 Missing ⚠️
packages/mermaid/src/diagrams/state/shapes.js 0.00% 2 Missing ⚠️
Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##           develop   #6185   +/-   ##
=======================================
  Coverage     4.47%   4.48%           
=======================================
  Files          383     382    -1     
  Lines        54142   54129   -13     
  Branches       596     621   +25     
=======================================
  Hits          2425    2425           
+ Misses       51717   51704   -13     
Flag Coverage Δ
unit 4.48% <0.00%> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
packages/mermaid/src/diagrams/state/shapes.js 0.00% <0.00%> (ø)
...ages/mermaid/src/diagrams/state/stateDiagram-v2.ts 0.00% <0.00%> (ø)
...ackages/mermaid/src/diagrams/state/stateDiagram.ts 0.00% <0.00%> (ø)
packages/mermaid/src/diagrams/state/stateDb.js 0.00% <0.00%> (ø)

... and 1 file with indirect coverage changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Other Not an enhancement or a bug
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant