flode 0.64.0__tar.gz → 0.70.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. {flode-0.64.0 → flode-0.70.1}/CHANGELOG.md +219 -0
  2. {flode-0.64.0/flode.egg-info → flode-0.70.1}/PKG-INFO +1 -1
  3. {flode-0.64.0 → flode-0.70.1}/flode/__init__.py +11 -1
  4. {flode-0.64.0 → flode-0.70.1}/flode/blocks/__init__.py +3 -1
  5. {flode-0.64.0 → flode-0.70.1}/flode/blocks/pythonfunc.py +4 -0
  6. {flode-0.64.0 → flode-0.70.1}/flode/blocks/pythonfunc_source.py +10 -0
  7. {flode-0.64.0 → flode-0.70.1}/flode/blocks/sinks.py +313 -0
  8. {flode-0.64.0 → flode-0.70.1}/flode/core/block.py +111 -8
  9. flode-0.70.1/flode/core/block_metadata.py +192 -0
  10. {flode-0.64.0 → flode-0.70.1}/flode/core/decorator.py +343 -22
  11. {flode-0.64.0 → flode-0.70.1}/flode/core/persistence.py +347 -34
  12. {flode-0.64.0 → flode-0.70.1}/flode/core/signals.py +151 -26
  13. {flode-0.64.0 → flode-0.70.1}/flode/core/simulator.py +141 -19
  14. {flode-0.64.0 → flode-0.70.1}/flode/exceptions.py +54 -0
  15. {flode-0.64.0 → flode-0.70.1}/flode/libraries/__init__.py +3 -1
  16. {flode-0.64.0 → flode-0.70.1}/flode/server/app.py +23 -2
  17. flode-0.70.1/flode/server/block_catalog.py +350 -0
  18. {flode-0.64.0 → flode-0.70.1}/flode/server/cli.py +131 -1
  19. {flode-0.64.0 → flode-0.70.1}/flode/server/config.py +51 -5
  20. {flode-0.64.0 → flode-0.70.1}/flode/server/errors.py +97 -0
  21. {flode-0.64.0 → flode-0.70.1}/flode/server/registry.py +238 -15
  22. {flode-0.64.0 → flode-0.70.1}/flode/server/registry_translations.py +20 -0
  23. flode-0.70.1/flode/server/routes/blocks.py +1109 -0
  24. {flode-0.64.0 → flode-0.70.1}/flode/server/routes/files.py +116 -0
  25. {flode-0.64.0 → flode-0.70.1}/flode/server/routes/simulations.py +129 -2
  26. flode-0.70.1/flode/server/run_log.py +99 -0
  27. {flode-0.64.0 → flode-0.70.1}/flode/server/runtime.py +169 -15
  28. {flode-0.64.0 → flode-0.70.1}/flode/server/settings.py +21 -0
  29. flode-0.70.1/flode/server/static/.app-version +1 -0
  30. flode-0.70.1/flode/server/static/assets/index-1dKrZedf.css +1 -0
  31. flode-0.70.1/flode/server/static/assets/index-9JkdaAnH.js +106 -0
  32. flode-0.70.1/flode/server/static/assets/index-9JkdaAnH.js.map +1 -0
  33. {flode-0.64.0 → flode-0.70.1}/flode/server/static/index.html +2 -2
  34. {flode-0.64.0 → flode-0.70.1}/flode/subsystems/subsystem.py +23 -1
  35. flode-0.70.1/flode/userblocks/__init__.py +164 -0
  36. flode-0.70.1/flode/userblocks/_config.py +205 -0
  37. flode-0.70.1/flode/userblocks/_docmeta.py +555 -0
  38. flode-0.70.1/flode/userblocks/_finder.py +210 -0
  39. flode-0.70.1/flode/userblocks/_loader.py +1244 -0
  40. flode-0.70.1/flode/userblocks/_model.py +228 -0
  41. flode-0.70.1/flode/userblocks/_param_rows.py +616 -0
  42. flode-0.70.1/flode/userblocks/_param_search.py +311 -0
  43. {flode-0.64.0 → flode-0.70.1/flode.egg-info}/PKG-INFO +1 -1
  44. {flode-0.64.0 → flode-0.70.1}/flode.egg-info/SOURCES.txt +14 -3
  45. {flode-0.64.0 → flode-0.70.1}/pyproject.toml +1 -1
  46. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_14_to_0_15.py +30 -6
  47. flode-0.64.0/flode/server/routes/blocks.py +0 -447
  48. flode-0.64.0/flode/server/static/.app-version +0 -1
  49. flode-0.64.0/flode/server/static/assets/index-B85mUsTb.js +0 -100
  50. flode-0.64.0/flode/server/static/assets/index-B85mUsTb.js.map +0 -1
  51. flode-0.64.0/flode/server/static/assets/index-BnL2nNOe.css +0 -1
  52. {flode-0.64.0 → flode-0.70.1}/LICENSE +0 -0
  53. {flode-0.64.0 → flode-0.70.1}/MANIFEST.in +0 -0
  54. {flode-0.64.0 → flode-0.70.1}/README.md +0 -0
  55. {flode-0.64.0 → flode-0.70.1}/flode/analysis/__init__.py +0 -0
  56. {flode-0.64.0 → flode-0.70.1}/flode/analysis/frequency_response.py +0 -0
  57. {flode-0.64.0 → flode-0.70.1}/flode/analysis/linearize.py +0 -0
  58. {flode-0.64.0 → flode-0.70.1}/flode/analysis/stability.py +0 -0
  59. {flode-0.64.0 → flode-0.70.1}/flode/blocks/_elementwise.py +0 -0
  60. {flode-0.64.0 → flode-0.70.1}/flode/blocks/_lti_utils.py +0 -0
  61. {flode-0.64.0 → flode-0.70.1}/flode/blocks/_vector_state.py +0 -0
  62. {flode-0.64.0 → flode-0.70.1}/flode/blocks/cast.py +0 -0
  63. {flode-0.64.0 → flode-0.70.1}/flode/blocks/continuous.py +0 -0
  64. {flode-0.64.0 → flode-0.70.1}/flode/blocks/discontinuities.py +0 -0
  65. {flode-0.64.0 → flode-0.70.1}/flode/blocks/discrete.py +0 -0
  66. {flode-0.64.0 → flode-0.70.1}/flode/blocks/logic.py +0 -0
  67. {flode-0.64.0 → flode-0.70.1}/flode/blocks/lookup.py +0 -0
  68. {flode-0.64.0 → flode-0.70.1}/flode/blocks/mathops.py +0 -0
  69. {flode-0.64.0 → flode-0.70.1}/flode/blocks/pythonfunc_rewrite.py +0 -0
  70. {flode-0.64.0 → flode-0.70.1}/flode/blocks/random_source.py +0 -0
  71. {flode-0.64.0 → flode-0.70.1}/flode/blocks/rounding.py +0 -0
  72. {flode-0.64.0 → flode-0.70.1}/flode/blocks/routing.py +0 -0
  73. {flode-0.64.0 → flode-0.70.1}/flode/blocks/sources.py +0 -0
  74. {flode-0.64.0 → flode-0.70.1}/flode/blocks/transport_delay.py +0 -0
  75. {flode-0.64.0 → flode-0.70.1}/flode/blocks/userfunc.py +0 -0
  76. {flode-0.64.0 → flode-0.70.1}/flode/core/__init__.py +0 -0
  77. {flode-0.64.0 → flode-0.70.1}/flode/core/dtypes.py +0 -0
  78. {flode-0.64.0 → flode-0.70.1}/flode/core/identifiers.py +0 -0
  79. {flode-0.64.0 → flode-0.70.1}/flode/libraries/_loader.py +0 -0
  80. {flode-0.64.0 → flode-0.70.1}/flode/libraries/std.flwlib.json +0 -0
  81. {flode-0.64.0 → flode-0.70.1}/flode/server/__init__.py +0 -0
  82. {flode-0.64.0 → flode-0.70.1}/flode/server/library_registry.py +0 -0
  83. {flode-0.64.0 → flode-0.70.1}/flode/server/migrations/__init__.py +0 -0
  84. {flode-0.64.0 → flode-0.70.1}/flode/server/routes/__init__.py +0 -0
  85. {flode-0.64.0 → flode-0.70.1}/flode/server/routes/libraries.py +0 -0
  86. {flode-0.64.0 → flode-0.70.1}/flode/server/routes/models.py +0 -0
  87. {flode-0.64.0 → flode-0.70.1}/flode/server/security/__init__.py +0 -0
  88. {flode-0.64.0 → flode-0.70.1}/flode/server/security/origin.py +0 -0
  89. {flode-0.64.0 → flode-0.70.1}/flode/server/security/paths.py +0 -0
  90. {flode-0.64.0 → flode-0.70.1}/flode/server/static/favicon.ico +0 -0
  91. {flode-0.64.0 → flode-0.70.1}/flode/server/static/favicon.svg +0 -0
  92. {flode-0.64.0 → flode-0.70.1}/flode/subsystems/__init__.py +0 -0
  93. {flode-0.64.0 → flode-0.70.1}/flode/subsystems/_mask.py +0 -0
  94. {flode-0.64.0 → flode-0.70.1}/flode/subsystems/control_blocks.py +0 -0
  95. {flode-0.64.0 → flode-0.70.1}/flode/subsystems/ports.py +0 -0
  96. {flode-0.64.0 → flode-0.70.1}/flode.egg-info/dependency_links.txt +0 -0
  97. {flode-0.64.0 → flode-0.70.1}/flode.egg-info/entry_points.txt +0 -0
  98. {flode-0.64.0 → flode-0.70.1}/flode.egg-info/requires.txt +0 -0
  99. {flode-0.64.0 → flode-0.70.1}/flode.egg-info/top_level.txt +0 -0
  100. {flode-0.64.0 → flode-0.70.1}/setup.cfg +0 -0
  101. {flode-0.64.0 → flode-0.70.1}/tests/test_adr0014_edge_cases.py +0 -0
  102. {flode-0.64.0 → flode-0.70.1}/tests/test_block_id.py +0 -0
  103. {flode-0.64.0 → flode-0.70.1}/tests/test_console_scripts.py +0 -0
  104. {flode-0.64.0 → flode-0.70.1}/tests/test_discrete_block_semantics.py +0 -0
  105. {flode-0.64.0 → flode-0.70.1}/tests/test_discrete_scheduler.py +0 -0
  106. {flode-0.64.0 → flode-0.70.1}/tests/test_discrete_timing_semantics.py +0 -0
  107. {flode-0.64.0 → flode-0.70.1}/tests/test_discrete_timing_semantics_vector.py +0 -0
  108. {flode-0.64.0 → flode-0.70.1}/tests/test_error_paths.py +0 -0
  109. {flode-0.64.0 → flode-0.70.1}/tests/test_multirate_block_semantics.py +0 -0
  110. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_10_to_0_11.py +0 -0
  111. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_11_to_0_12.py +0 -0
  112. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_12_to_0_13.py +0 -0
  113. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_13_to_0_14.py +0 -0
  114. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_7_to_0_8.py +0 -0
  115. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_8_to_0_9.py +0 -0
  116. {flode-0.64.0 → flode-0.70.1}/tests/test_persistence_migration_0_9_to_0_10.py +0 -0
  117. {flode-0.64.0 → flode-0.70.1}/tests/test_phase0_regression.py +0 -0
  118. {flode-0.64.0 → flode-0.70.1}/tests/test_rate_transition.py +0 -0
  119. {flode-0.64.0 → flode-0.70.1}/tests/test_version_consistency.py +0 -0
@@ -5,6 +5,225 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [Unreleased]
9
+
10
+ ## [0.70.1] - 2026-11-19
11
+
12
+ ### Fixed
13
+
14
+ - キャンバスを描き直すたびに (ブロックを選ぶだけでも)、全部の配線が 1 フレーム消えて作り直されていた。
15
+ 形が変わっていないブロックは前回測った寸法を引き継ぐ (形・ポート数・反転・Enable / Trigger の
16
+ 有無が変わったとき、表示するスコープやファイルが変わったときは今までどおり測り直す)
17
+ - 空いている場所をダブルクリックしてもクイック挿入が開かず、画面が拡大していた。キャンバスの
18
+ ダブルクリックでは拡大しないようにした (拡大はホイール・ズームボタン・ツールバーで行う)
19
+ - 引数でポート数が変わるユーザーブロックを含むモデルを開いた直後に実行すると、ポートの数が届く前の
20
+ 既定のポート数と比べて「ブロックに無いポートへの配線があります」と誤って止まっていた (配線の赤表示・
21
+ Inspector の警告も同じ)。実行はポートの解決を待ってから (最大 5 秒) 実行前チェックをし、解決前は
22
+ 超過と断定しない。実行の開始処理中に実行を押しても 2 本目は始めない。待つ間に別のファイルへ
23
+ 切り替えたら実行しない
24
+
25
+ ## [0.70.0] - 2026-11-19 — 信号名 (ADR-0087)
26
+
27
+ ### Added
28
+
29
+ - 信号名: 配線をダブルクリックすると、その場で信号に名前を付けられる (Enter / 欄の外で確定、Esc で
30
+ 取り消し、空にすると名前を消す)。名前は出力ポートに付くので、分岐した配線はすべて同じ名前になり、
31
+ 名前は出力ポートを出た直後に 1 か所だけ表示する。自由な文字で 64 文字まで (改行・制御文字は不可)
32
+ - Scope の凡例・画像コピーの凡例・Scope 設定の信号行に、信号名 → 接続元ポートの名前 (ユーザーブロック /
33
+ Python 関数ブロック / Subsystem の出力ポート) → `scope[i]` の順で名前を出す。ベクトルは `名前[k]`、
34
+ Mux を通った信号は Mux の入力の名前をたどる。名前を変えると実行し直さなくても凡例が変わる
35
+ - 保存形式: スコープごと (最上位と Subsystem の `params`) に任意キー `signal_names`
36
+ (`{"<接続元 id>:<出力番号>": 名前}`) を足した。名前が無いモデルの保存内容は変わらず、
37
+ schema_version も 0.15 のまま。信号名は GUI だけの情報で、Python 側 (`Simulator`) は読み飛ばす
38
+ - その出力ポートから出る配線が全部無くなると、信号名も消える (Undo で戻る)。ブロック名の変更・
39
+ 行の付け替え・Outport の削除・コピー貼り付けでは名前が付いて移る
40
+
41
+ ### Compatibility
42
+
43
+ - 0.69.0 以前の flode では、Subsystem の中に信号名 (または手動の分岐点) があるファイルは実行できない
44
+ (開く・編集・保存はできる)。最上位だけに信号名があるファイルは実行できる
45
+
46
+ ### Fixed
47
+
48
+ - Subsystem の中に手動の分岐点を置いたモデルが、実行も信号の形の解決もできなかった
49
+ (`Subsystem._from_dict` が `branch_waypoints` を未知の引数として拒否していた)。
50
+ GUI だけが使うスコープのキーは、ブロックを作る前に全スコープから取り除くようにした
51
+ - Scope の凡例がグラフの枠の外にはみ出して見えなかった。凡例をプロット領域の外 (同じ枠内) に置き、
52
+ 設定ダイアログの「凡例: 上 / 下 / 右」が効くようにした。凡例の上のホイールはズームではなく凡例の
53
+ スクロールになる
54
+
55
+ ## [0.69.0] - 2026-11-18 — ユーザーブロックの行リスト引数を表 + 編集ダイアログで編集する (ADR-0086)
56
+
57
+ ### Added
58
+
59
+ - ユーザーブロックの `list[str]` の引数を、表と編集ダイアログで編集できるようにした (試験的、ADR-0086)。
60
+ `Block` サブクラスが `block_param_rows = {"引数名": "classmethod 名"}` を宣言すると、Inspector のその引数は
61
+ JSON の入力欄の代わりに全幅の表 (列はブロックが決める、誤りのある行は赤字) になり、追加 / 編集 / 削除 /
62
+ ↑ / ↓ / テキストで編集… ができる。編集ダイアログの項目 (テキスト / 選択 / 検索して複数選ぶ) と、項目から
63
+ 1 行を作る処理はブロックが提供する (`action` = `describe` / `form` / `compose` / `search` で呼ばれる)。
64
+ 要求は `POST /api/v1/blocks/param-rows` (同時実行は引数の値の検索と合わせて 2 本まで)。
65
+ registry の `params_spec[]` には宣言した引数だけ `row_editor: true` が載り、その引数では「探す…」を出さない
66
+ - 表の行が入出力ポートに対応するブロック (`describe` が `ports` を返し、`block_dynamic_ports = True`) では、
67
+ 行の追加・削除・並べ替えで配線が行に付いて移る (削除した行の配線は外れる、分岐点も移る)。1 操作 = 1 Undo
68
+
69
+ ### Fixed
70
+
71
+ - `update_v` だけ (または `advance_v` だけ) を書いた離散ブロックにベクトル・画像の入力をつなぐと、
72
+ 「scalar state API only」の `BlockSpecError` で実行できなかった。スカラー版 (`advance` / `update` /
73
+ `derivative`) を上書きしていなければ、既定の `_v` 版は入力を変換せずに既定の結果を返すようにした
74
+ - 出力はスカラー版で書き、状態の更新を `update_v` / `advance_v` / `derivative_v` だけで書いたブロックを
75
+ 全スカラーのモデルで実行すると、更新が呼ばれず状態が初期値のまま進まなかった (例外にならない)。
76
+ スカラー版の既定は、対になる `_v` 版が上書きされていればそれを呼ぶようにした
77
+
78
+ ## [0.68.0] - 2026-11-17 — ユーザーブロックの引数を検索して選ぶ (ADR-0085)
79
+
80
+ ### Added
81
+
82
+ - ユーザーブロックの引数の値を検索で選べるようにした (試験的、ADR-0085)。`Block` サブクラスが
83
+ `block_param_search = {"引数名": "classmethod 名"}` で `list[str]` の引数に検索関数を宣言すると、
84
+ Inspector のその行に「探す…」が出て、ブロックが返す表から行を複数選んで引数の末尾に追加できる。
85
+ 検索は `POST /api/v1/blocks/search-param-values` (同時実行は 2 本まで、超えると 409)。
86
+ registry の `params_spec[]` には宣言した引数だけ `searchable: true` が載る。宣言の誤りはブロックを
87
+ 落とさず、読み込みエラー欄の注記 (`severity: "info"`) になる。`@block` は非対応 (class 形で書くとエラー)
88
+ - 読み込みエラーが注記 (`severity: "info"`) だけのファイルは、ファイルの状態を `"ok"` にする
89
+
90
+ ### Fixed
91
+
92
+ - パレットから読み込んだユーザーブロック (クラス形式の `Block` サブクラス) と `@block` の出力 dtype が入力の
93
+ dtype を受け継いでいた。比較ブロックの bool 出力をつなぐと、ユーザーブロックが返した数値まで bool に
94
+ cast されていた。ユーザーブロックの境界は float64 (入力は float64 に揃えて渡し、出力も float64) になる。
95
+ `@block` はパレットに載っているかに関係なく、クラス形式はパレット (ワークスペース `blocks/` / config の
96
+ `dirs` / `modules`) から読み込んだものが対象。スクリプト内で定義したクラス形式の `Block` サブクラスは従来どおり。
97
+ GUI の信号の型表示では、ユーザーブロックの出力は「—」(未解決) になる
98
+ - WebSocket の実行ストリームへ最初に接続したのが実行の終了後で、まだ配信待ちのメッセージが残っていると、
99
+ 再接続とみなして完了メッセージだけを返していた (ログ・Scope のデータ・画像などを取りこぼす)。
100
+ 完了メッセージの再送 (ADR-0056 §B-4) は、前の接続が完了メッセージを受け取った後の再接続でだけ行う
101
+ - `flode` のコンソールに、開いているモデルの外部変更の確認 (5 秒ごと) が
102
+ `GET /api/v1/files/content?... 304 Not Modified` として出続けていた。変化なし (304) の確認はアクセスログに
103
+ 出さない。ほかのリクエスト (読み込み・保存・エラーなど) はこれまでどおり出る
104
+ - `output_v` だけを実装したブロック (`output` は持たない) を、ポートがすべてスカラーのまま使い、モデルの
105
+ 信号もすべてスカラーだと、実行が `NotImplementedError: <ブロック名>.output not implemented` で失敗していた。
106
+ このようなブロックがあるモデルは、ベクトルの信号があるときと同じ経路で実行する
107
+
108
+ ## [0.67.0] - 2026-11-14 — 引数に追従するポート・後片付け・音声出力・実行ログ (ADR-0083)
109
+
110
+ ### Added
111
+
112
+ - **ユーザーブロックのポートが引数に追従する**: `Block` サブクラスに `block_dynamic_ports = True` を宣言すると、
113
+ Inspector で引数を変えるたびにブロックを作り直してポート数・shape・ポート名 (インスタンス属性
114
+ `input_names` / `output_names`) を描き直し、無くなったポートへの配線を外す。REST
115
+ `POST /api/v1/blocks/resolve-port-shapes` の応答に `input_names` / `output_names` を追加し、ユーザーコードの
116
+ 例外は 400 にした。registry のメタデータに `dynamic_ports: true` (宣言したときだけ)
117
+ - **`Block.close()`**: 実行の終わり (完了・停止・失敗のどれでも) に呼ばれる後片付けの hook。既定は何もしない。
118
+ Subsystem は内側のブロックへ伝える。1 つが例外を出しても残りは閉じる (例外はログに残す)
119
+ - **音声出力ブロック `AudioOutput`** (シンク)。shape `(N,)` / `(N, 2)` の音声の塊を、Web GUI のブラウザから
120
+ 鳴らす (引数 `sample_rate` / `scale`)。上流のサンプル時刻にだけ記録する。実時間同期の実行でだけ WebSocket
121
+ `audio_chunk` (int16 PCM) で配信する。ブロック面に音量計と消音チェック
122
+ - **実行ログ**: 実行中にユーザーブロック (`flode_ws.*`、INFO 以上) と flode 本体 (WARNING 以上) が標準
123
+ `logging` で出したメッセージを、シミュレーション時刻つきで GUI の「ログ」タブに一覧表示する (1 回の実行で
124
+ 最大 1000 件)。WebSocket に `log`、`GET /results` に `logs` / `logs_dropped` を追加
125
+ - Inspector: 型注釈が `int` の引数は整数だけを受け付け、`list[str]` の引数は既定値が空リストでも文字列の
126
+ リストとして編集できる
127
+
128
+ ## [0.66.0] - 2026-11-14 — 画像表示ブロックと実時間同期 (ADR-0082)
129
+
130
+ ### Added
131
+
132
+ - **画像表示ブロック `ImageDisplay`** (シンク、SPEC-0034)。shape `(H, W)` (グレー) / `(H, W, 3)` (RGB) の
133
+ 配列信号を、実行中にブロック面へ画像としてライブ表示する (ブロックはリサイズ可、既定 160×120)。値 `0..vmax`
134
+ (既定 255) を黒〜白に写し、範囲外はクリップ。保持するのは最新 1 コマだけ (Python からは `latest_frame` /
135
+ `frame_time` / `frame_count` / `plot()`)。それ以外の shape と 1920×1080 画素を超える画像は実行前にエラー
136
+ - **実時間同期**: `Simulator(realtime=True)` / モデル設定ダイアログの「実時間に同期」。シミュレーション時刻
137
+ 1 秒を壁時計 1 秒に合わせて進める。計算が遅れたときは遅れたまま進み、早送りで取り戻さない。待ち中でも
138
+ 停止ボタンは即座に効く。保存ファイルには有効なときだけ `simulator.realtime: true` を書く (schema version は
139
+ 据え置き、既存モデルの保存内容は変わらない)
140
+ - WebSocket に `image_frame` メッセージ (ブロックごと最大 30 fps、大きな画像は 8 MiB/s 以内に間引く、終了・停止・失敗時に最後のコマを必ず送る)、
141
+ `GET /api/v1/simulations/{id}/results` に `images` (各画像表示ブロックの最後のコマ) を追加
142
+ - ユーザーブロックの引数の説明 (`param_descriptions` / `block_param_descriptions`) を `display_name` と同じく
143
+ `{"ja": ..., "en": ...}` で書けるようにした。Inspector が表示言語のものを出す (従来の文字列はそのまま)。
144
+ REST `params_spec[]` に `description_i18n` (言語別に書かれたときだけ) を追加
145
+
146
+ ## [0.65.0] - 2026-11-14 — Python で書いたブロックを左ペインに出して使う (ADR-0081)
147
+
148
+ ### Added
149
+
150
+ - **Python で書いたブロックをパレットで使える** (SPEC-0033)。ワークスペースの `blocks/` に `.py` を置くと、
151
+ 起動時に読み込まれて左ペインの「ワークスペース」セクションに出て、組み込みブロックと同じようにモデルに
152
+ 置いて使える。書き方は `@block` 関数形・`@block` クラス形・`Block` サブクラスのどれでもよい。状態あり・
153
+ 多入出力・入力なし (信号源)・出力なし (書き出し・通信) のブロックに対応する。説明書: `docs/user_blocks.rst`
154
+ - **再読み込み**: `.py` を直したら左ペインの「再読み込み」で反映する (サーバの再起動は不要)。結果
155
+ (追加・削除・変更) をトーストで知らせる。読み込みエラーはファイル・ブロック単位で隔離し、左ペイン下部の
156
+ 欄に「ファイル:行・種別・メッセージ」と読み込んだファイルの一覧を出す
157
+ - `@block` の新しい引数: `category` (セクション内のサブ見出し) / `display_name` / `description`
158
+ (文字列、または `{"ja": ..., "en": ...}`) / `choices` (Inspector の選択肢) / `param_descriptions`。
159
+ docstring の 1 行目と `Args:` も説明として読む。`@block class` に `block_hidden = True` でパレットに出さない
160
+ - `@block(outputs=0)` または戻り値注釈 `-> None` で出力なしのブロックを書ける。計算の刻み 1 回につき最大 1 回
161
+ (離散なら自分の周期で) 呼ばれ、ソルバの中間段では呼ばれない (状態を持つ出力なしブロックは `Block` を継承する。
162
+ Subsystem の中に置いた出力なしブロックは呼ばれないので、実行開始時に警告する)
163
+ - キャンバス: ユーザーブロックは表示名と入出力のポート名つきの矩形で描く。`.py` が無い・読めないブロックは
164
+ 「Unknown block」の代わりの箱で、値と配線を保ったまま保存でき、実行前チェックで止めて理由を出す。
165
+ `.py` から引数を消すと警告し、その値は保存時・実行時に取り除く (再読み込みの直後と実際に取り除いたときに
166
+ 知らせる)。ポートが減って合わなくなった配線は自動では消さずエラー表示する
167
+ - `config.toml` の `[blocks]` 節: `dirs` (名前付きフォルダ) / `modules` (インストール済みパッケージ。変更は
168
+ 再起動で反映) / `allow_non_loopback`。起動フラグ `--allow-user-blocks`
169
+ - Python API: `flode.load_blocks(workspace, *, dirs, modules, use_config, strict)` / `flode.unload_blocks()`
170
+ - REST: `GET /api/v1/blocks` が `blocks.v3` (追加のみ: 各ブロックの `source` / `input_names` / `output_names`、
171
+ 本文の `sources` / `load_errors` / `user_blocks`)、`POST /api/v1/blocks/reload` (本文 `{}` 固定)
172
+
173
+ ### Changed
174
+
175
+ - **読み込み = その `.py` のコードを実行すること**。手元 (loopback) で起動したときは自動で読み、`--host 0.0.0.0`
176
+ など LAN に公開するときは `--allow-user-blocks` (または `allow_non_loopback = true`) が無い限り読まない。
177
+ LAN 公開時は再読み込みと、ファイル操作 API による `blocks/` (とワークスペース内の `dirs` / `modules`) の変更を
178
+ 拒否し、読み込みエラーのメッセージに絶対パスを出さない。`--workspace` を指定せずに起動したフォルダの
179
+ `blocks/` も読む (ホームディレクトリとドライブ直下は除く)
180
+ - 型を解決できないブロックを含むモデルを `POST /simulations` / `POST /models/resolve-dtypes` に送ると、汎用の
181
+ `start_validation` ではなく `unknown_block_type` (欠けている型を Subsystem の中まで列挙、上限あり) を返す
182
+ - `create_app` を直接使う場合、新しい `Settings.loopback_bind` の既定が `False` のため、ユーザーブロックを
183
+ 読まず、ファイル操作 API による `blocks/` の変更を拒否する (CLI で手元起動する場合は従来どおり)
184
+ - `@block` 生成クラスは `port_shapes_*` をブロック entry に書き出さない (形状は宣言から復元する)
185
+ - クラス形の `@block` で、フィールド名に `block_category` / `block_display_name` / `block_description` /
186
+ `block_choices` / `block_param_descriptions` / `block_input_names` / `block_output_names` と注釈付きの
187
+ `block_hidden` を使うと `BlockSpecError` になる (メタデータ用に予約。他の `block_*` は従来どおり使える)
188
+ - `PythonFunction` ブロックのコードが出力 0 本 (`outputs=0` / `-> None`) だと、分かりやすいエラーで拒否する
189
+ - GUI: File Browser の右クリックメニューを共通のポップアップメニュー部品に載せ替えた。組み込みのカテゴリ一覧に
190
+ 無いカテゴリのブロックを、左ペインで無言で隠さず `uncategorized` の直前に出す
191
+
192
+ ### Fixed
193
+
194
+ - **モジュールに書いた `@block` ブロックを使ったモデルが、保存後に読み込めなかった**。関数形 (`def scaled` →
195
+ 型名 `Scaled`) と小文字名のクラス形は型名を解決できず、`port_shapes_*` を宣言したブロックは保存した
196
+ `port_shapes_*` を受け取れなかった
197
+ - 非スカラーの port shape を宣言した `PythonFunction` を含むモデルが、Python API で保存すると読み込めなかった
198
+ - マスク付き `Subsystem` の内側の入れ子 `Subsystem` で、マスクの placeholder (`"$Kp"`) が保存時に具象値へ
199
+ 展開され、マスク値の変更が届かなくなっていた
200
+ - ブロック型の解決が、`flode` 配下の `__init__.py` を持たないディレクトリにあるモジュールを import しえた
201
+ - 離散 `sample_time` の `@block` でベクトル入力を宣言すると、実行時に `BlockSpecError` になっていた
202
+ - GUI: registry が後から届いたとき、Inspector で entry に無い引数の数値入力が空のままだった
203
+
204
+ ### 既知の制約
205
+
206
+ - `.py` を直して再読み込みしても、すでに取り除かれた引数の値は戻らない (直すのは保存より前に)
207
+ - 関数形の `@block` は `input_names=` / `output_names=` を書かない限りポート名が出ない
208
+ - 引数付きの `@block(...)` は、利用者のコードを mypy の strict モードで検査すると型エラーになる
209
+
210
+ ## [0.64.1] - 2026-09-21 — Subsystem 内部の Goto を外側の From で受けるベクトル信号の修正
211
+
212
+ ### Fixed
213
+
214
+ - **`Subsystem` 内部の `Goto` を外側の `From` が参照すると shape が `()` に落ちていた**
215
+ (v0.62.0 から、ADR-0079 D-n の既知制限)。build は通るのに実行時に From の `output_v` の
216
+ shape 不一致で `BlockSpecError` になっていた。信号面解決器が上流ブロックの所属スコープを
217
+ 同一性で判定し (現スコープ → Subsystem 内部 → 上位スコープ)、内部スコープの解決結果から
218
+ shape / dtype を引くようにした。ネスト 2 段、外側に内部と同名 id のブロックがある場合も正しい
219
+ - schema 0.14 → 0.15 migration の挿入 ID (`<id>__in_mux` 等) が同一 base で 1000 件超の
220
+ 衝突時に 64 code point を超えていた (実運用では起きない極端な入力)。連番の桁数に応じて
221
+ base を切り詰め直す
222
+ - テスト `test_save_load_bytes_unchanged` が `metadata.created_at` の秒境界で flaky だった
223
+ (時計を固定、製品コードは不変)
224
+ - テスト: 0.14 → 0.15 migration の基準 npz との突合を bit 一致から極小許容誤差の allclose に
225
+ 緩和 (v0.64.0 リリース直後の ac5de9e。CI の ubuntu では BLAS 差で最終ビットが変わる)
226
+
8
227
  ## [0.64.0] - 2026-09-21 — StateSpace 系のベクトルポート統一とソース系のベクトル値 (ADR-0079 Stage 3)
9
228
 
10
229
  ### Changed (BREAKING: `StateSpace` 系のポートが変わります)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: flode
3
- Version: 0.64.0
3
+ Version: 0.70.1
4
4
  Summary: Block-diagram dynamic system simulator
5
5
  Author: aramoto99
6
6
  License-Expression: MIT
@@ -7,7 +7,7 @@
7
7
  # ADR-0044) は docked split と並存。Phase 6c (Workspace
8
8
  # convergence) Stage 1 として ADR-0040 §Amendments §(1) で位置付け、Stage 2 /
9
9
  # 3 (= activity bar + Launcher、drag-to-split-tab) は後続 ADR で順次着手。
10
- __version__ = "0.64.0"
10
+ __version__ = "0.70.1"
11
11
 
12
12
  from .analysis import (
13
13
  BodeResponse,
@@ -26,6 +26,9 @@ from .core.decorator import block
26
26
  from .core.simulator import Simulator
27
27
  from .exceptions import (
28
28
  AlgebraicLoopError,
29
+ BlockLoadError,
30
+ BlockReloadInProgressError,
31
+ BlockSourceConfigError,
29
32
  BlockSpecError,
30
33
  FlodeError,
31
34
  LibraryEntryNotFoundError,
@@ -48,10 +51,15 @@ from .libraries import (
48
51
  validate_library,
49
52
  )
50
53
  from .subsystems import Enable, Inport, Outport, Subsystem, Trigger
54
+ from .userblocks import BlockLoadReport, load_blocks, unload_blocks
51
55
 
52
56
  __all__ = [
53
57
  "AlgebraicLoopError",
54
58
  "Block",
59
+ "BlockLoadError",
60
+ "BlockLoadReport",
61
+ "BlockReloadInProgressError",
62
+ "BlockSourceConfigError",
55
63
  "BlockSpecError",
56
64
  "BodeResponse",
57
65
  "Enable",
@@ -83,8 +91,10 @@ __all__ = [
83
91
  "export_subsystem_to_library",
84
92
  "is_stable",
85
93
  "linearize",
94
+ "load_blocks",
86
95
  "load_library",
87
96
  "nyquist",
88
97
  "root_locus",
98
+ "unload_blocks",
89
99
  "validate_library",
90
100
  ]
@@ -46,7 +46,7 @@ from .pythonfunc import PythonFunction
46
46
  from .random_source import RandomSource
47
47
  from .rounding import Rounding
48
48
  from .routing import Demux, From, Goto, Merge, MultiportSwitch, Mux, Switch
49
- from .sinks import Display, Scope, Terminator, XYGraph
49
+ from .sinks import AudioOutput, Display, ImageDisplay, Scope, Terminator, XYGraph
50
50
  from .sources import Clock, Constant, PulseGenerator, Ramp, Sine, Step
51
51
  from .transport_delay import TransportDelay
52
52
  from .userfunc import Fcn
@@ -54,6 +54,7 @@ from .userfunc import Fcn
54
54
  __all__ = [
55
55
  "Abs",
56
56
  "Add",
57
+ "AudioOutput",
57
58
  "Cast",
58
59
  "Clock",
59
60
  "CompareToConstant",
@@ -72,6 +73,7 @@ __all__ = [
72
73
  "From",
73
74
  "Gain",
74
75
  "Goto",
76
+ "ImageDisplay",
75
77
  "Integrator",
76
78
  "InterpolationUsingPrelookup",
77
79
  "LogicalOperator",
@@ -370,6 +370,10 @@ class PythonFunction(Block):
370
370
  # ADR-0079 §(3): SM-A の output と SM-T の output_v を内包インスタンスへ委譲する
371
371
  _skip_dual_api_check = True
372
372
 
373
+ # port shape の SSOT は ``code`` (静的解析で ``__init__`` 時に再導出される)。
374
+ # entry に ``port_shapes_*`` を出力すると ``__init__`` が受け取れず load に失敗する。
375
+ _serialize_port_shapes = False
376
+
373
377
  def __init__(
374
378
  self,
375
379
  code: str = DEFAULT_CODE,
@@ -190,6 +190,16 @@ def analyze_source(code: str, *, block_id: str | None = None) -> SourceSpec:
190
190
  ) from e
191
191
 
192
192
  structure = cls._flode_structure # type: ignore[attr-defined]
193
+ if structure.n_outputs == 0:
194
+ # ADR-0081 X-3: ``@block`` は sink (出力 0 本) を書けるが、PythonFunction は
195
+ # 出力 1 本以上のまま (sink の記録経路・状態の規則を PythonFunction へ広げない)
196
+ raise PythonFunctionSourceError(
197
+ "PythonFunction: a block without outputs (outputs=0 or `-> None`) is not "
198
+ "supported; a PythonFunction needs at least one output. Write a sink as an "
199
+ "@block in a Python module instead.",
200
+ lineno=func_def.lineno,
201
+ block_id=block_id,
202
+ )
193
203
  params_spec: tuple[tuple[str, Any, Any, bool], ...] = cls._flode_params_spec # type: ignore[attr-defined]
194
204
  return SourceSpec(
195
205
  func_name=func_def.name,