[{"_1":2,"_167":-5,"_168":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_141":142},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_87":-5,"_88":89,"_134":-5,"_135":11,"_136":17,"_137":11,"_138":-5,"_139":140},"canonicalUrl","https://hub.docker.com/r/iraa/scjson/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","iraa","reponame","scjson","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_38":30,"_27":28,"_57":58,"_59":44,"_60":61,"_62":63,"_64":65,"_66":-5,"_67":61,"_68":69,"_70":11,"_71":28,"_72":73,"_78":11,"_79":80,"_84":28,"_85":86},"categories",[37],{"_38":39,"_40":41},"name","Languages & frameworks","slug","languages-and-frameworks","content_types",[44],"image","date_registered","2025-07-17T01:34:05.764162Z","description","scjson: C#, go, java, javascript / typescript, lua, python, ruby, rust, and swift ","is_private","last_updated","2025-07-21T01:27:02.050729Z","last_modified","2025-07-17T01:52:58.896957Z","media_types",[56],"application/vnd.docker.container.image.v1+json","pull_count",23288,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# scjson\n\n> A JSON-based serialization of SCXML (State Chart XML) for modern tooling, interoperability, and education.\n\n---\n\n## Overview\n\n`scjson` is a structured, schema-based representation of [SCXML](https://www.w3.org/TR/scxml/), the W3C standard for state machine modeling. This format preserves the semantics and hierarchy of SCXML while making it more accessible to modern tools, languages, and interfaces.\n\nWhy JSON?\n\n- Easier to parse in JavaScript, Python, Rust, etc.\n- Fits naturally with REST APIs, editors, and static validation\n- Can be round-tripped to and from standard SCXML\n- Works with compact formats like MessagePack or Protobuf when needed\n\n---\n\n## Goals\n\n- 💡 **Interoperability**: Serve as a bridge between SCXML and modern application ecosystems\n- 📦 **Portability**: Enable translation to binary formats (MessagePack, Protobuf, etc.)\n- 📚 **Pedagogy**: Make it easier to teach and learn state machines with cleaner syntax and visual tools\n- 🔁 **Round-trip Fidelity**: Support conversion back to valid SCXML without semantic loss\n\n---\n\n## Schema\n\nThe canonical `scjson.schema.json` file is located in [`/schema`](./schema). \nIt is generated from Pydantic models and used to validate all `*.scjson` documents.\n\n---\n\n## Directory Structure\n\nEach language implementation lives in its own directory, as a standalone module or library root:\n\n/schema/ → JSON Schema definition of scjson\n/examples/ → SCXML and scjson sample pairs\n/tutorial/ → Git submodule: Zhornyak SCXML tutorial\n/python/ → Python reference implementation (CLI + library)\n/js/ → JavaScript CLI and library\n/ruby/ → Ruby CLI and gem\n/go/ → Go command line utility\n/rust/ → Rust command line utility\n/swift/ → Swift command line tool\n/java/ → Java command line tool\n/lua/ → Lua scripts\n/csharp/ → C# command line tool\n\n\nEach directory is designed to be independently usable as a library or CLI tool.\n\n---\n\n## Converters\n\n| Language | Status | Path | Notes |\n|-----------|--------|------|-------|\n| Python | ✅ Stable | [`/py`](./py) | Reference CLI |\n| JavaScript| ✅ Beta | [`/js`](./js) | Node CLI |\n| Ruby | ✅ Beta | [`/ruby`](./ruby) | Gem CLI |\n| Go | ✅ Beta | [`/go`](./go) | Go binary |\n| Rust | ✅ Beta | [`/rust`](./rust) | Cargo crate |\n| Swift | ✅ Beta | [`/swift`](./swift) | Swift package |\n| Java | ✅ Beta | [`/java`](./java) | Maven CLI |\n| Lua | ✅ Basic | [`/lua`](./lua) | Lua scripts |\n| C# | ✅ Beta | [`/csharp`](./csharp) | .NET CLI |\n---## Examples & Test Suite\n\nThis repo includes a curated set of canonical SCXML examples and their equivalent `scjson` forms in [`/examples`](./examples). These are used for:\n\n- Functional validation (SCXML ↔ scjson ↔ SCXML)\n- Teaching state machine concepts via visual tools\n- Demonstrating usage in editors, UI libraries, and low-code platforms\n\nThese examples are derived from and/or adapted from:\n\n### 📚 Included Tutorial (as Git Submodule)\n\nWe include **Alex Zhornyak’s SCXML Editor Tutorial** as a Git submodule under [`/tutorial`](./tutorial). \nThis provides a rich set of canonical SCXML test cases and diagrams.\n\n> Attribution is provided for educational purposes. No endorsement is implied. \n> Source: [https://alexzhornyak.github.io/ScxmlEditor-Tutorial/](https://alexzhornyak.github.io/ScxmlEditor-Tutorial/)\n\n---\n\n### 🛠️ Submodule Setup\n\nIf you cloned this repo and `/tutorial` is empty, run:\n\n```bash\ngit submodule init\ngit submodule update\nOr clone with submodules in one step:\n\ngit clone --recurse-submodules https://github.com/your-org/scjson.git\n```\n\nThis ensures you get the complete tutorial content alongside the examples and converters.\n\n---\n\n## Converters\nAll converters share the same schema and test suite to ensure compatibility.\n\n---\n\n## Getting Started\n\n```bash\n# Convert from SCXML to scjson\nscjson convert --from scxml path/to/file.scxml --to scjson path/to/file.scjson\n\n# Validate a scjson file\nscjson validate path/to/file.scjson\n```\n\n### Java Module\n\nThe Java implementation uses Maven. If your environment requires an HTTP/HTTPS\nproxy, create `~/.m2/settings.xml` with proxy settings before building:\n\n```xml\n\n \n \n internal-proxy\n true\n http\n proxy\n 8080\n localhost|127.0.0.1\n \n \n internal-proxy-https\n true\n https\n proxy\n 8080\n localhost|127.0.0.1\n \n \n\n```\n\nBuild the module with:\n\n```bash\ncd java && mvn clean install -DskipTests -B && cd ..\n```\n\n### Package Repostory Availability\npypi: [https://pypi.org/project/scjson/]\n```bash\npip install scjson\n```\n\n\n\nFor a full example of installing toolchains and dependencies across languages see [`codex/startup.sh`](codex/startup.sh).\n\n### Python Module\n```bash\ncd py\npip install -r requirements.txt\npytest -q\n```\n\n### JavaScript Module\n```bash\ncd js\nnpm ci\nnpm test --silent\n```\n\n### Ruby Module\n```bash\ncd ruby\ngem install bundler\nbundle install\nbundle exec rspec\n```\n\n### Go Module\n```bash\ncd go\ngo test ./...\ngo build\n```\n\n### Rust Module\n```bash\ncd rust\ncargo test\n```\n\n### Swift Module\n```bash\ncd swift\nswift test\n```\n\n### C# Module\n```bash\ncd csharp\ndotnet test -v minimal\n```\n\n### Lua Module\n```bash\ncd lua\nluarocks install luaexpat --deps-mode=one\nluarocks install dkjson --deps-mode=one\nluarocks install busted --deps-mode=one\nbusted tests\n```\n","has_starred","hub_user","immutable_tags_settings",{"_74":11,"_75":76},"enabled","rules",[77],".*","is_automated","permissions",{"_81":17,"_82":11,"_83":11},"read","write","admin","user","storage_size",7812398984,"orgData","recentTags",[90,128],{"_91":44,"_92":93,"_94":95,"_96":97,"_98":99,"_100":101,"_50":117,"_118":93,"_119":28,"_120":56,"_38":121,"_122":123,"_124":108,"_125":117,"_126":65,"_127":17},"content_type","creator",15212956,"digest","sha256:e2834ee7a99ca25b7843b2e40284c9ba01fd8d1d6962a88286f1076a1e683b22","full_size",3928158862,"id",938698567,"images",[102],{"_103":104,"_94":95,"_105":106,"_107":108,"_109":110,"_111":112,"_113":106,"_114":-5,"_115":97,"_62":65,"_116":-5},"architecture","amd64","features","","last_pulled","2026-09-07T09:48:24.989520446Z","last_pushed","2025-07-21T01:27:00.350164419Z","os","linux","os_features","os_version","size","variant","2025-07-21T01:27:00.97345Z","last_updater","last_updater_username","media_type","latest","repository",28043357,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_91":44,"_92":93,"_94":95,"_96":97,"_98":129,"_100":130,"_50":132,"_118":93,"_119":28,"_120":56,"_38":133,"_122":123,"_124":108,"_125":132,"_126":65,"_127":17},938698566,[131],{"_103":104,"_94":95,"_105":106,"_107":108,"_109":110,"_111":112,"_113":106,"_114":-5,"_115":97,"_62":65,"_116":-5},"2025-07-21T01:27:00.96614Z","0.2.0","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":143,"_151":152,"_139":165,"_166":11},{"_35":144,"_42":146,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":147,"_38":30,"_27":28,"_57":58,"_59":44,"_60":61,"_62":63,"_64":65,"_66":-5,"_67":61,"_68":69,"_70":11,"_71":28,"_72":148,"_78":11,"_79":150,"_84":28,"_85":86},[145],{"_38":39,"_40":41},[44],[56],{"_74":11,"_75":149},[77],{"_81":17,"_82":11,"_83":11},"tags",{"_153":154,"_155":-5,"_156":-5,"_157":158},"count",2,"next","previous","results",[159,162],{"_91":44,"_92":93,"_94":95,"_96":97,"_98":99,"_100":160,"_50":117,"_118":93,"_119":28,"_120":56,"_38":121,"_122":123,"_124":108,"_125":117,"_126":65,"_127":17},[161],{"_103":104,"_94":95,"_105":106,"_107":108,"_109":110,"_111":112,"_113":106,"_114":-5,"_115":97,"_62":65,"_116":-5},{"_91":44,"_92":93,"_94":95,"_96":97,"_98":129,"_100":163,"_50":132,"_118":93,"_119":28,"_120":56,"_38":133,"_122":123,"_124":108,"_125":132,"_126":65,"_127":17},[164],{"_103":104,"_94":95,"_105":106,"_107":108,"_109":110,"_111":112,"_113":106,"_114":-5,"_115":97,"_62":65,"_116":-5},[],"canDeleteTags","actionData","errors"]

iraa/scjson

Tags for iraa/scjson