statable 3.1.0__py3-none-any.whl

statable-3.1.0.dist-info/METADATA

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: statable
+Version: 3.1.0
+Summary: MISRA C:2012-aware state machine design and C code generation for embedded systems
+Author: Hideki Akashi
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/akashi-hideki/StaTable
+Project-URL: Repository, https://github.com/akashi-hideki/StaTable
+Project-URL: Issues, https://github.com/akashi-hideki/StaTable/issues
+Keywords: state machine,MISRA,embedded,code generation,C
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Embedded Systems
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: gui
+Requires-Dist: PySide6>=6.0; extra == "gui"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pycparser; extra == "dev"
+
+# StaTable
+
+**MISRA C:2012-aware state machine design and C code generation for embedded systems.**
+
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/akashi-hideki/StaTable/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
+[![Tests](https://img.shields.io/badge/Tests-1479%20PASS-green.svg)](https://github.com/akashi-hideki/StaTable)
+[![MISRA](https://img.shields.io/badge/MISRA-C%3A2012-orange.svg)](https://www.misra.org.uk/)
+
+StaTable is a Python-based tool for designing state machines and
+generating **MISRA C:2012-compliant C code** for embedded systems.
+It provides a CLI, a Python SDK, and a PySide6 GUI.
+
+---
+
+## Features
+
+- **MISRA C:2012-aware C code generation** — validated with `cppcheck` + official MISRA addon
+- **Multi-layer state machines** — Driver / Middleware / Application with priority execution
+- **State actions (Entry / Exit / Do)** — table-driven dispatch with user-code markers
+- **35 validation rules** across 11 categories with AI-assisted diagnostics
+- **Marker-based user code preservation** — regenerate without losing your custom code
+- **CLI + SDK + GUI** — integrate into any workflow
+- **Pure Python** — easy to install and extend
+- **i18n**: English and Simplified Chinese (简体中文)
+
+---
+
+## Installation
+
+**SDK + CLI only:**
+
+```
+pip install statable
+```
+
+**With GUI (PySide6):**
+
+```
+pip install "statable[gui]"
+```
+
+**Development:**
+
+```
+pip install "statable[dev]"
+```
+
+---
+
+## Quick Start
+
+### CLI
+
+```
+statable-cli version
+statable-cli generate --xml design.xml --out generated/ --format json
+statable-cli validate --xml design.xml --format json --exit-on-error
+```
+
+### Python SDK
+
+```
+from statable import State, Event, Transition, StateMachine, StateType, EventKind
+from statable.global_defs import GlobalDefinitions
+from codegen import CCodeGenerator, CodeGenerationConfig
+
+sm = StateMachine()
+sm.add_state(State(name="Idle", type=StateType.INITIAL))
+sm.add_state(State(name="Running"))
+sm.add_event(Event(name="START", kind=EventKind.SIGNAL))
+sm.set_initial("Idle")
+sm.add_transition(Transition(source="Idle", event="START", target="Running"))
+
+cfg = CodeGenerationConfig()
+gen = CCodeGenerator(config=cfg)
+files = gen.generate_all_layers([("Application", sm)], GlobalDefinitions())
+gen.save_generated_code(files, "generated/")
+```
+
+### GUI
+
+```
+python -m statable
+```
+
+Menu: **Language / 语言** → switch between **English** and **简体中文**.
+
+---
+
+## Requirements
+
+- Python 3.10 or later
+- PySide6 >= 6.0 (for GUI)
+- pycparser (optional, for advanced parsing)
+
+---
+
+## Links
+
+- **Homepage**: https://github.com/akashi-hideki/StaTable
+- **Documentation**: https://github.com/akashi-hideki/StaTable/blob/main/README.md
+- **Issues**: https://github.com/akashi-hideki/StaTable/issues
+- **Chinese README**: https://github.com/akashi-hideki/StaTable/blob/main/README_zh-CN.md
+
+---
+
+## License
+
+Apache License 2.0 — free for commercial and personal use.
+
+See [LICENSE](https://github.com/akashi-hideki/StaTable/blob/main/LICENSE) for details.
+
+---
+
+## Acknowledgments
+
+- [PySide6](https://www.qt.io/qt-for-python) — Qt 6 for Python
+- [cppcheck](https://cppcheck.sourceforge.io/) — static analysis
+- All contributors and users
+
+---
+
+If StaTable helps you, please consider giving it a ⭐ on GitHub.

statable-3.1.0.dist-info/RECORD

@@ -0,0 +1,117 @@
+codegen/__init__.py,sha256=v-CDFixuTpGGJ_vVSDQ99PluIaeXpWrqpKraYp-6zIM,1013
+codegen/c_code_generator.py,sha256=ivBce808B7QsxymPI9PhMmgh1vIRMA5dvZVxl-r1V_o,70764
+codegen/code_merger.py,sha256=WZOsOq3e0W4wB4lRo8Hd0yOTIxscARj9UWOkOoRB7cE,13761
+codegen/code_templates.py,sha256=JoWSOSn-9G-72qHbp3fI7fYnZUUlxzhkvi3rOn4D4Qg,20513
+codegen/config.py,sha256=Eux0T-SNVhxXaeca8oi9YTo_2huiVOPfWTDm1o-KgN8,5934
+codegen/enum_generator.py,sha256=7-0np-RX5XfXf3V3RvwbX_rk-2F56J7mAZ6KXE4wdpI,13045
+codegen/event_queue_generator.py,sha256=7fe1BRH-IShuLHL6N4sbm9aBivPS-NCOjlGXeDvvAD4,11746
+codegen/interrupt_generator.py,sha256=xebAzMZ9s7GP7cAvDPuFC70chFSHQog56qBifqLfj9o,13973
+codegen/naming_convention.py,sha256=Agl46ZVlAnadCZSZJi9zpenpJMO0iYfg1xVf_ywrZqY,5226
+codegen/osal_generator.py,sha256=rQIkPZrmic6igXV366v-3rWS9qvlufDNHEn1rL1TWTo,10788
+codegen/role_function_generator.py,sha256=PNwHZxmZfS4doQW7kEMR2IVAxnSdzXHHAx52Scqqlk4,48443
+codegen/sample_data.py,sha256=V0aDFbMRP4BV6cz8Irei-zmhzMJyVqfFvjAviDHzYZE,10465
+codegen/state_actions_generator.py,sha256=OkFOKKHfdwhabF-0_dDY6pQB3F91FjYPEu8980iE-04,15915
+codegen/struct_generator.py,sha256=xlj9myaP-lL6sxKqqfaJxBVG-fLWmA7g6FJKeNU_rNY,30175
+codegen/timer_generator.py,sha256=iOEBwV7vzsSUn8qerbR1rF8qlTzMVOACJbaVrvl1x6Q,11126
+codegen/transition_generator.py,sha256=-Zxle1KVVWVDTtlhxvSlXfWv3ZTzSXFArXdLSgpXI6E,36866
+codegen/type_mapper.py,sha256=gobT9_g6RGeThUd1ScgPpxr4RTb0QdwfdMHm03zr6Zg,2251
+codegen/variable_generator.py,sha256=Xeo9WTdFthfV7IJiBu1h2Z8YxXHdCP24n55PenCZ0ls,16441
+codegen/validate/__init__.py,sha256=s_9FZL3CAwkUKh74BOKmMWXwZPVk45niyl0v5xRT674,1023
+codegen/validate/change_actions.py,sha256=zTvMM2g3x8CUNWpn4fMWuIcTWnnFdxLQMixuZlR9F9I,3068
+codegen/validate/change_applier.py,sha256=bscgXnw3pyxSgr_7vViZ_R1L_P93_5YLNafe_3ny2Ag,17942
+codegen/validate/clipboard_manager.py,sha256=FsgrmfLdR4AED6RSawBw2IOc7fNRL7iJKliwnz-wBVg,1266
+codegen/validate/logger.py,sha256=2kS6hZBX9DX6A7sRgajWzmsCcFEHcoQqIERMyiXGx40,1610
+codegen/validate/models.py,sha256=r2HBsWhcA9h3ikDT25_QVlvMmNGrpv4KACoz08gTskg,5692
+codegen/validate/prompt_generator.py,sha256=_LeUOTtl280boNJmn1YnSmQk1aiSdR1dYMiuMzwEhe8,29766
+codegen/validate/response_parser.py,sha256=YLgPk-77q38LCYVVgqvi5SBxueNUippMgq69VEzFg-Y,5530
+codegen/validate/response_validator.py,sha256=mOuXnONmz4UiO6zdcK0_owRUw1xqftGcSymThc_MvAU,10615
+codegen/validate/validation_dialog.py,sha256=lcwgALR6UxgS0Am6dPBKHUNx6ebejQhJQtsOVkOs4fU,12472
+codegen/validate/validator.py,sha256=I8ZBxScKunw6NGvv9Ub58jJg_L_VmyBaY4PXMyy8nOo,3523
+codegen/validate/data/__init__.py,sha256=NNcxmXtoDcYAnnEctBQRrAaRv2-JXXCwsVqDbebYxnY,649
+codegen/validate/data/action_definitions.py,sha256=Wq6fb5eAmfZ1VtcCwQAicJ10NkzSDYC2LVRkz5Op6k8,9297
+codegen/validate/data/keywords.py,sha256=iCuASfoDxiS-JC6U3AeHKs10SKJNasuE118AUJm979o,1675
+codegen/validate/data/prompt_templates.py,sha256=gF-sxi8cwIVE7isodFaFUY1Ubf99q1_YeWOJe6u1c9Q,5075
+codegen/validate/data/validation_rules.py,sha256=c1g_vb3yhyowhMJuuGaE32DTlPINMeMXHyZ9AN2Gwgc,8183
+codegen/validate/items/__init__.py,sha256=fg4f0XktvE-SZl6syTZjJpHE1CEcqin09n4Y1q-ygG8,969
+codegen/validate/items/base_validator.py,sha256=CwBi0HgfvAohmKM-NHwL3ShN4-0Nm29Xhvf2bxvBYjc,668
+codegen/validate/items/cell_validator.py,sha256=SjYMKN5WX76FogYNnZLmtuvR1t8CtahKbL3O1EV16T4,12188
+codegen/validate/items/custom_type_validator.py,sha256=nirVv9PY69xPj5zosScWjuMgqPMj1mjIdt6Ycg7rE0w,2731
+codegen/validate/items/event_validator.py,sha256=9VH2FXJzqq8Gr69_93lkAfgIxbRVOtgXHhg-ujWUPP0,2889
+codegen/validate/items/flag_validator.py,sha256=OkyzVt7F0J06eVD3hd-PE6c3tkgbPCnPgCVuAGXrv2U,2711
+codegen/validate/items/interrupt_validator.py,sha256=dltTuTSrswgoBq9uxOI5m0ubXmdKaTBegJphmgfNLok,2887
+codegen/validate/items/queue_validator.py,sha256=vhtEVicjyIYukocPHPGoD_Mz4jsIfd9i8rG9CjE4uFI,2760
+codegen/validate/items/role_function_validator.py,sha256=l0lzR0u9Ec-Kb__I-aWQ5j7eYrWAxfmAGPMTuYh8baQ,6963
+codegen/validate/items/state_validator.py,sha256=9ifWpZmT4lxpCur8b95dp7tVBun09Oq8PHyozhAnNAs,3374
+codegen/validate/items/timer_validator.py,sha256=JwYUQvr5HMfjISPBy3-RtbLLh3iGxZLyd4O_9Da1eG8,4946
+codegen/validate/items/transition_validator.py,sha256=AyZeQcS9E34LGbPK1WitAsdvPisOCae6ztad7e0Q6Pw,4339
+codegen/validate/items/variable_validator.py,sha256=JPfCpBJ7LXMLBoOWf9XHOnFjCsFbIXcZaqFGEd7mbCU,4954
+statable/__init__.py,sha256=TUkKfQQvXJQxcvZXTPDQx6rH80oA-safo6iOpAwYMK0,1495
+statable/__main__.py,sha256=cK2t2nNiNgnhMq5k6-ck1uoR1044QGHKz0PbAYQdSMA,1337
+statable/cli.py,sha256=w_3PowggeRHhOvjnk4Ik8FCSCKPO4xy_JSfmVQw-N3o,7279
+statable/global_defs.py,sha256=bZa1w6NnzlEZNdY4JPjgxAN400lYKIzBupOc1AF-jsk,8084
+statable/mermaid_gen.py,sha256=Vciuj9bG1V4x2PhjPr7WeOmTeGgpiaskWOXLcog13to,4746
+statable/model.py,sha256=8PTDipauu2XsW3yNzb7Hoks1cz2Sp0gS1sLuBqFOAbc,15902
+statable/parser.py,sha256=Li6xj49nDENA-OaorTMhVkxQkw6j0ldpq-MyS-ch0tc,2070
+statable/sample_data.py,sha256=kIcSR6_D21ozV7pusutaTq87I5qbJInZKqqHjiB79_g,15773
+statable/state_machine.py,sha256=0zk4jiiFhGYXuSWR4IJEl_e-AlnWEyhx6lQDd2DtK8U,5115
+statable/xml_io.py,sha256=gNSX_WJBmJF-5BQbYp7dfL6LbJGVIEKHmAb8xswHeEU,48684
+statable/shared/__init__.py,sha256=DId1TM2DHfGFFWwpAjN6RaOKf0ssg2Io0yRaBqR8AEo,717
+statable/shared/condition_library.py,sha256=1urybzlFN2IZ8JqwISjnm-6G9P2lgn4vb8qlM7gNaVI,1971
+statable/shared/literal_library.py,sha256=pw9gYTuSrds-g_p3v1ahIa6fLD1_RifHfwMPQMKTq-M,1962
+statable/shared/role_function_library.py,sha256=sg4zD73e3WmWUhq50dyi_EyxHb9-dY2tH4or3h3VZZ0,5272
+statable_gui/__init__.py,sha256=X2WCo34qvm9HyNciQKvWI3q3t5bs7zBFkeV_THQZNPI,703
+statable_gui/action_edit_dialog.py,sha256=DcK1b8qqb6cdScZs0Ut9wtS716zd5eg0R4qV-lw3ufg,9061
+statable_gui/code_generation_dialog.py,sha256=Ps-sXMudxfSolFgeEkYMy6xhmAd5V20b9gmLlKuryXE,17633
+statable_gui/code_generation_settings_dialog.py,sha256=f44LFGx0-HTo5psKqY59hqnX-HRbroh3g5eZLyNJQtc,22161
+statable_gui/common_widgets.py,sha256=lnsSr_rhfpAjSyzl2WuKhH200XRa-2LhJ8lqmtz72bk,21474
+statable_gui/condition_builder_dialog.py,sha256=cTnyp9T62XS4Y6lV3t0t6wV8JqByx1jcIDaxUIoQ3yQ,20429
+statable_gui/condition_edit_dialog.py,sha256=SCAtav-HpmMoy3cqcfDmw1e1lhELYObi0jaZeZ6a-4U,5005
+statable_gui/condition_template_dialog.py,sha256=ivG46siYbz6ndmjX9SVAN2byFmnWke5fe7Y-8vTjcUM,2022
+statable_gui/config.py,sha256=kYnNCJJjzAnDw2Lvv5OX-oYc_ocbC2pa0Gnh8OcN-vw,556
+statable_gui/dialogs.py,sha256=Dt7qA3-Npm-dvW3dveqoxJOCqm3NosprpfuH5Qznx1w,17745
+statable_gui/event_definition_dialog.py,sha256=BkUpekdJ8ysChEhrYDoBHgIS3_XdJOF_s2PcLyaKPDE,26715
+statable_gui/event_delivery_settings_dialog.py,sha256=hapP6fr14W-383DghWpoyf3Dg_WIvNesyOr69eOSsgM,8114
+statable_gui/event_queue_dialog.py,sha256=hM740pthIu4d-Z8H-toZj-hUMZW0X96g35P6I9Ie8A4,10578
+statable_gui/global_defs.py,sha256=vFPQyiY5L5-DaEVupfjTqlw3fr22KTncpJSmECDdQ2o,4951
+statable_gui/global_defs_dialog.py,sha256=JSUE9MP-s3Y6aio6-DNy7nA5EN9jdVR3sdi91NyG6Iw,35377
+statable_gui/interrupt_handler_edit_dialog.py,sha256=nSxSOvfAESYPg3Tt5m99jtxjz4_aDyDnK4LTazKCF5c,34790
+statable_gui/layer_settings_dialog.py,sha256=Zk2pjOUl3KH6R4r4U6T5o4_t3dtllva7DlFblSn-1LY,6056
+statable_gui/literal_definition_dialog.py,sha256=YWQJ8bUYvx6PH18Z7X0cgm_6uNB7IqJscHcIExUENSg,2118
+statable_gui/logger.py,sha256=qB1DmAr6estvJL4qEhT4etoHXrjc8BjFQqcgqVvxVEA,2767
+statable_gui/main_window.py,sha256=PVsLlGL_ZIVB3FsxSERk6Bdp069-8sFrlYyRQxhIcwo,54238
+statable_gui/matrix_table.py,sha256=Dt10xV6M15t-XZJNNrvRD9zaCFSkp9f1tbAi8JUjSss,17047
+statable_gui/preference_keys.py,sha256=F4lCh4gHRsZelpc-y33mDO982KI3dpNk7-1sQq4Flzs,921
+statable_gui/preferences.py,sha256=N7iy6SDfQ49C2kVSmY-QBFC-MlBGK0MXcqDvAeWG9tI,2935
+statable_gui/role_function_dialog.py,sha256=JkqSOolnhAaqzz6NYwnq3KN5JvJlhMx5HMdlr6zGmSM,9264
+statable_gui/sample_data.py,sha256=yj3IQxYBiuAwFA3ycr1AuMMb4FzCKnkS8C8Xfd4iMlc,245
+statable_gui/state_actions_dialog.py,sha256=He7zjgtmDjkTcIFW6XHIuL-fKKq8scUo-ElFH-3xgt8,15496
+statable_gui/symbol_picker.py,sha256=LOWEWykxH0viujEgf0xlpAfj6xpsdbXnxJr3XHwB_Zo,7229
+statable_gui/traceball.py,sha256=uYZ0PLt1lj6yua_JwdKU0CCsyU2xcaENRq6haW4FhCU,1180
+statable_gui/validation_dialog.py,sha256=ByN75eqOgn5ZmKfypDBGslR5Pl53JAS5UHrNtPL_-Po,11100
+statable_gui/widgets.py,sha256=bYt2UvXJyb3jLfypc_RKBHA9fO5PT7zIS0uhawxTwAs,52321
+statable_gui/i18n/__init__.py,sha256=toNNJHsox5axjPAXU_fA84fZ26bw09Qel39_vFeXYUA,3414
+statable_gui/libcntrl/__init__.py,sha256=bc9tlD4c_CAEGSwxoDbSgLRi1n_gczqYnW9QtqDwkmc,546
+statable_gui/libcntrl/condition_library.py,sha256=dONTfLiB8-DnxrGlUFhaSkYT0T-1UdCfOLFOMMFye_o,401
+statable_gui/libcntrl/literal_library.py,sha256=OgiZfV5wazJxIh4oly5I3LnBZhkoUyX1nwF3ms80cvk,393
+statable_gui/libcntrl/literal_management_dialog.py,sha256=e-VkhWU2MKnTaBhRaZFj_LVs6BxRMJAsMyoGRUMiiSY,6674
+statable_gui/libcntrl/role_function_edit_dialog.py,sha256=lU4SuZr4fiVv_M4XiV5Z_jOolNCn0s0Qzl_Qvqtt_4Q,5556
+statable_gui/libcntrl/role_function_library.py,sha256=00PHBVN7h0eUP5lpgxTB8KgJ-p9ZzZuIb2vRRuqIZ7s,405
+statable_gui/transition_editor_direct/__init__.py,sha256=pwPq5qyQI9_AQkUZZvn59fCbTtgN8MhTFcxWEk38TZ8,330
+statable_gui/transition_editor_direct/actions_tab.py,sha256=IRRrAUYvyFbWikBj2PO9zztnlQiHb4ZonKWV_JoCHNU,34372
+statable_gui/transition_editor_direct/code_widget.py,sha256=ZNr3H-0PgasklItclf7TGoYOgI1kdSXK2U2BmFt0kzM,12796
+statable_gui/transition_editor_direct/coverage_analyzer.py,sha256=QMBE5sS_LoROx6oWJSQGRu-GRMoPh6HTxDRAV8g5xmQ,6019
+statable_gui/transition_editor_direct/dialog.py,sha256=wXwjySg67BMGl-5yHvUspb3PFr7uaBphNT9zCxS31K4,13444
+statable_gui/transition_editor_direct/draft.py,sha256=DLUuZf9nHQH_CeDaBaZiHkCIVeYU34D_EXCiHMBVnW8,9159
+statable_gui/transition_editor_direct/edit_dialogs.py,sha256=6aOAa4cOHdeppv3jodfcK1DLm7Rvy0ak4kMrd3EqjRI,6163
+statable_gui/transition_editor_direct/overview_tab.py,sha256=w26RL1DUaXrF_ZDHixj5N3VaKhT3hDRtZ2moqQqr10s,5844
+statable_gui/transition_editor_direct/palette_widget.py,sha256=w6Potl_2-hxDfLeDfbZ6DQ6eY1wrPGtuk3Hvhfh-HGc,9505
+statable_gui/transition_editor_direct/relations_edit_dialog.py,sha256=hczBpUVE2n4BWfwHr3FBA8NXY1aA2tp5e_ffZ5NZ2rY,6001
+statable_gui/transition_editor_direct/relations_tab.py,sha256=WYU93qprG8UdHtWTpsrs8tMr9glkJPpKMFMyj0BhEB0,8965
+statable_gui/transition_editor_direct/system_global_dialog.py,sha256=YQ_Z46G7pDCkLVyOWX9viBnjk83g6D11skdUUc8_ZYM,1706
+statable_gui/transition_editor_direct/transition_actions_dialog.py,sha256=mY2avGuRSg9_Vo3_S06MZyTSpZSrLebL_U05La8VGHM,4273
+statable_gui/transition_editor_direct/transitions_tab.py,sha256=zhCba9PjVILwHqhouyTTanpNJrzpTNRC4w_o6xLtOSg,24459
+statable-3.1.0.dist-info/METADATA,sha256=DIRUEJXm_OqF1QCAqxiKoWWxhosbgHtw5WUhiRRw9KM,4684
+statable-3.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+statable-3.1.0.dist-info/entry_points.txt,sha256=fxjnfPG_VOU2Zh3FnNQt7A5o0uSYUhCdjB_alIBqYZY,51
+statable-3.1.0.dist-info/top_level.txt,sha256=zbXm27ELYZVhvhikBmmsoQ8oOzbMg0L-ys6Y9PBh_VI,30
+statable-3.1.0.dist-info/RECORD,,

statable-3.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

statable-3.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+statable-cli = statable.cli:main

statable-3.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+codegen
+statable
+statable_gui

statable_gui/__init__.py

@@ -0,0 +1,23 @@
+# statable_gui package
+"""\nStaTable GUI layer\n\n[v1.5 added]\n  - Keep re-exports minimal\n  - Qt-heavy modules (main_window etc.) should be\n    explicitly imported\n"""
+
+# Settings / environment
+from .config import WINDOW_WIDTH, WINDOW_HEIGHT
+
+# Logger (lightweight)
+try:
+    from .logger import StaTableLogger
+except ImportError:
+    StaTableLogger = None
+
+__all__ = [
+    'WINDOW_WIDTH',
+    'WINDOW_HEIGHT',
+    'StaTableLogger',
+]
+
+# Note:
+#   MainWindow / StateMachineTab etc. are not re-exported.
+#   Loading before creating the PySide6 QApplication causes errors, so
+#   On the caller side, use `from statable_gui.main_window import MainWindow` to
+#Explicitly import it.

statable_gui/action_edit_dialog.py

@@ -0,0 +1,214 @@
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QFont
+from PySide6.QtWidgets import (
+    QDialog, QVBoxLayout, QHBoxLayout, QTextEdit, QComboBox,
+    QPushButton, QLabel, QDialogButtonBox, QMessageBox,
+    QSplitter, QWidget, QMenu
+)
+
+from .role_function_dialog import RoleFunctionDialog
+from .global_defs import GlobalDefinitions
+from .global_defs_dialog import VariableEditDialog, FlagEditDialog
+from .common_widgets import TitleEditWidget
+from .symbol_picker import SymbolPickerWidget
+from .logger import StaTableLogger
+
+
+class ActionEditDialog(QDialog):
+    """Dialog to edit the action of a transition (H3: qualified_name insertion support)"""
+
+    def __init__(self, parent=None, action_text="", title="",
+                 role_functions=None, global_defs=None):
+        super().__init__(parent)
+        self.setWindowTitle(self.tr("ActionEdit"))
+        self.setMinimumSize(900, 650)
+        self.role_functions = role_functions if role_functions is not None else {}
+        self.global_defs = global_defs if global_defs else GlobalDefinitions()
+
+        StaTableLogger.debug(
+            f"ActionEditDialog.__init__: action_text_len={len(action_text)}, "
+            f"title='{title}', roles={len(self.role_functions)}, "
+            f"vars={len(self.global_defs.variables)}, "
+            f"flags={len(self.global_defs.flags)}"
+        )
+
+        main_layout = QVBoxLayout(self)
+
+        self.title_widget = TitleEditWidget(self, title=title)
+        main_layout.addWidget(self.title_widget)
+
+        role_bar = QHBoxLayout()
+        role_bar.addWidget(QLabel(self.tr("Role function:")))
+        self.role_combo = QComboBox()
+        self.refresh_role_combo()
+        role_bar.addWidget(self.role_combo)
+        insert_role_btn = QPushButton(self.tr("Insert"))
+        insert_role_btn.clicked.connect(self.insert_role_function)
+        role_bar.addWidget(insert_role_btn)
+        new_role_btn = QPushButton(self.tr("New role function..."))
+        new_role_btn.clicked.connect(self.add_new_role_function)
+        role_bar.addWidget(new_role_btn)
+        main_layout.addLayout(role_bar)
+
+        self.signature_label = QLabel(self.tr(""))
+        self.signature_label.setFont(QFont("Consolas", 9))
+        self.signature_label.setStyleSheet("color: #555;")
+        main_layout.addWidget(self.signature_label)
+
+        splitter = QSplitter(Qt.Horizontal)
+        main_layout.addWidget(splitter)
+
+        self.symbol_picker = SymbolPickerWidget(
+            global_defs=self.global_defs,
+            role_functions=self.role_functions
+        )
+        self.symbol_picker.insert_requested.connect(self.insert_symbol)
+        splitter.addWidget(self.symbol_picker)
+
+        right_widget = QWidget()
+        right_layout = QVBoxLayout(right_widget)
+        right_layout.addWidget(QLabel(self.tr("Action code:")))
+        self.action_edit = QTextEdit()
+        self.action_edit.setAcceptRichText(False)
+        self.action_edit.setPlainText(action_text)
+        self.action_edit.setFont(QFont("Consolas", 10))
+        self.action_edit.setContextMenuPolicy(Qt.CustomContextMenu)
+        self.action_edit.customContextMenuRequested.connect(self.show_action_context_menu)
+        right_layout.addWidget(self.action_edit, stretch=1)
+        splitter.addWidget(right_widget)
+
+        buttons = QDialogButtonBox(QDialogButtonBox.Ok | QDialogButtonBox.Cancel)
+        buttons.accepted.connect(self._on_accept)
+        buttons.rejected.connect(self.reject)
+        main_layout.addWidget(buttons)
+
+        self.update_signature_label()
+        StaTableLogger.debug("ActionEditDialog.__init__ completed")
+
+    def refresh_role_combo(self):
+        self.role_combo.clear()
+        for name in self.role_functions.keys():
+            self.role_combo.addItem(name)
+        try:
+            self.role_combo.currentTextChanged.disconnect(self.update_signature_label)
+        except (RuntimeError, TypeError):
+            pass
+        self.role_combo.currentTextChanged.connect(self.update_signature_label)
+        StaTableLogger.debug(f"refresh_role_combo: {len(self.role_functions)} roles")
+
+    def update_signature_label(self):
+        func_name = self.role_combo.currentText()
+        if func_name:
+            rf = self.role_functions.get(func_name)
+            if rf:
+                # Prefer displaying qualified_name
+                display = getattr(rf, 'qualified_name', rf.name)
+                arg1 = getattr(rf, 'arg1_type', '') or ''
+                arg1n = getattr(rf, 'arg1_name', '') or ''
+                arg2 = getattr(rf, 'arg2_type', '') or ''
+                arg2n = getattr(rf, 'arg2_name', '') or ''
+                ret = getattr(rf, 'return_type', 'void') or 'void'
+                sig = f"{ret} {display}({arg1} {arg1n}, {arg2} {arg2n})"
+                self.signature_label.setText(sig)
+                return
+        self.signature_label.setText(self.tr(""))
+
+    # change: use qualified_name
+    def insert_role_function(self):
+        """\n        Insert a role function into the action field\n\n        - With namespace: \"Driver.Init\" reference form (no arguments)\n        - Without namespace: preserve legacy form \"Sensor_Init(arg1, arg2);\"\n        """
+        func_name = self.role_combo.currentText()
+        StaTableLogger.debug(f"insert_role_function: '{func_name}'")
+        if not func_name:
+            return
+        rf = self.role_functions.get(func_name)
+        if not rf:
+            return
+
+        qualified = getattr(rf, 'qualified_name', func_name)
+
+        if '.' in qualified:
+            # Namespace.Name form: insert reference only
+            call = qualified
+        else:
+            # Legacy form: preserve call with args
+            arg1 = getattr(rf, 'arg1_name', '') or ''
+            arg2 = getattr(rf, 'arg2_name', '') or ''
+            call = f"{qualified}({arg1}, {arg2});"
+
+        self.action_edit.insertPlainText(call + "\n")
+
+    def add_new_role_function(self):
+        StaTableLogger.debug("add_new_role_function called")
+        dlg = RoleFunctionDialog(self)
+        if dlg.exec() == QDialog.Accepted:
+            rf = dlg.get_role_function()
+            if rf.name in self.role_functions:
+                QMessageBox.warning(
+                self,
+                self.tr("Warning"),
+                self.tr("A role function with the same name already exists."),
+            )
+                return
+            self.role_functions[rf.name] = rf
+            self.refresh_role_combo()
+            self.update_signature_label()
+
+    def insert_symbol(self, text: str):
+        self.action_edit.insertPlainText(text)
+
+    def show_action_context_menu(self, pos):
+        selected_text = self.action_edit.textCursor().selectedText().strip()
+        if not selected_text:
+            return
+        menu = QMenu(self)
+        add_var_action = menu.addAction(
+            self.tr("'{0}' as global variable").format(selected_text)
+        )
+        add_flag_action = menu.addAction(
+            self.tr("'{0}' as event flag").format(selected_text)
+        )
+        chosen = menu.exec(self.action_edit.viewport().mapToGlobal(pos))
+        if chosen == add_var_action:
+            self.register_selected_as_variable(selected_text)
+        elif chosen == add_flag_action:
+            self.register_selected_as_flag(selected_text)
+
+    def register_selected_as_variable(self, name: str):
+        dlg = VariableEditDialog(self, groups=self.global_defs.variable_groups())
+        dlg.name_edit.setText(name)
+        if dlg.exec() == QDialog.Accepted:
+            var = dlg.get_variable()
+            if not var.name:
+                return
+            if any(v.name == var.name for v in self.global_defs.variables):
+                return
+            self.global_defs.variables.append(var)
+            self.symbol_picker.refresh_list()
+
+    def register_selected_as_flag(self, name: str):
+        dlg = FlagEditDialog(self, groups=self.global_defs.flag_groups())
+        dlg.name_edit.setText(name)
+        if dlg.exec() == QDialog.Accepted:
+            flag = dlg.get_flag()
+            if not flag.name:
+                return
+            if any(f.name == flag.name for f in self.global_defs.flags):
+                return
+            self.global_defs.flags.append(flag)
+            self.symbol_picker.refresh_list()
+
+    def _on_accept(self):
+        action_text = self.action_edit.toPlainText().strip()
+        if action_text:
+            first_line = action_text.split('\n')[0].strip()
+            auto_title = first_line[:20] + ("..." if len(first_line) > 20 else "")
+        else:
+            auto_title = self.tr("(untitled action)")
+        self.title_widget.ensure_title(auto_title)
+        self.accept()
+
+    def get_action_text(self) -> str:
+        return self.action_edit.toPlainText().strip()
+
+    def get_title(self) -> str:
+        return self.title_widget.get_title()