tool_kit.dart 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418
  1. import 'package:flutter/material.dart';
  2. import 'package:flutter/services.dart';
  3. import 'package:flutter_math_fork/flutter_math.dart';
  4. import 'package:provider/provider.dart';
  5. import '../symja.dart';
  6. /// 工具页的公共外壳。
  7. ///
  8. /// 十五个工具原先各写各的:各自的 Scaffold、各自拼字符串、各自显示一个
  9. /// `Text`。这套外壳把**输入 → 计算 → 输出**固定下来,好处有三个:
  10. /// 1. 计算全部走 [Symja],Dart 只负责排版和取输入(绘图除外,见 [ToolChart]);
  11. /// 2. 每条输出**单独成块、点一下就复制**,不再是一大坨拼在一起的文本;
  12. /// 3. 重置按钮和错误提示不用每个工具再写一遍。
  13. ///
  14. /// 刻意不用「抽象基类 + 子类」那套写法:工具之间的差异只有"有哪些输入框"和
  15. /// "算什么表达式"两件事,交给两个参数就够了,继承反而要每个工具建一个类。
  16. class ToolScaffold extends StatefulWidget {
  17. const ToolScaffold({
  18. super.key,
  19. required this.title,
  20. required this.fields,
  21. required this.compute,
  22. this.intro,
  23. this.autoRun = false,
  24. });
  25. final String title;
  26. /// 打开就自动算一次。绘图和二分法这类**输入框里已经有默认值**的工具用得上:
  27. /// 一进来就该看到图/解,而不是先按一下按钮。
  28. final bool autoRun;
  29. /// 输入框。顺序即显示顺序。
  30. ///
  31. /// 由**页面**持有(建在 State 里,别建在 build 里,否则主题一变控制器就被换掉、
  32. /// 用户打的字会丢)。外壳不 dispose 它们:对称变换那种一个页面里换几组输入框的
  33. /// 工具,控制器要跨模式活着。
  34. final List<ToolField> fields;
  35. /// 工具自己的说明(公式长什么样、参数什么含义),显示在输入框上方。
  36. final Widget? intro;
  37. /// 计算。自己从 [fields] 里取文本、拼 Symja 表达式、调 [SymjaSession.compute]。
  38. ///
  39. /// 返回若干条输出:文字的可点复制,图表的不复制(图没什么可复制的)。
  40. final Future<List<ToolOutput>> Function(SymjaSession) compute;
  41. @override
  42. State<ToolScaffold> createState() => _ToolScaffoldState();
  43. }
  44. class _ToolScaffoldState extends State<ToolScaffold> {
  45. final List<ToolOutput> _outputs = [];
  46. String? _error;
  47. bool _busy = false;
  48. /// 换了一组输入框(对称变换那种切模式的情况)就把上一次的结果清掉 ——
  49. /// 留着上一模式的答案是误导。
  50. @override
  51. void didUpdateWidget(ToolScaffold old) {
  52. super.didUpdateWidget(old);
  53. if (!identical(old.fields, widget.fields)) {
  54. _outputs.clear();
  55. _error = null;
  56. }
  57. }
  58. @override
  59. void initState() {
  60. super.initState();
  61. if (widget.autoRun) {
  62. WidgetsBinding.instance.addPostFrameCallback((_) {
  63. if (mounted) _run();
  64. });
  65. }
  66. }
  67. Future<void> _run() async {
  68. final session = context.read<SymjaSession>();
  69. setState(() {
  70. _busy = true;
  71. _error = null;
  72. _outputs.clear();
  73. });
  74. try {
  75. final out = await widget.compute(session);
  76. if (!mounted) return;
  77. setState(() => _outputs.addAll(out));
  78. } on SymjaException catch (e) {
  79. if (mounted) setState(() => _error = '$e');
  80. } catch (e) {
  81. // 输入格式不对(少填了、写了非数字)在这里兜住,别把异常弹到 framework
  82. if (mounted) setState(() => _error = '$e');
  83. } finally {
  84. if (mounted) setState(() => _busy = false);
  85. }
  86. }
  87. void _reset() {
  88. for (final f in widget.fields) {
  89. f.controller.clear();
  90. }
  91. setState(() {
  92. _outputs.clear();
  93. _error = null;
  94. });
  95. }
  96. /// 计算中:给个可见的反馈,复杂表达式可能要算好几秒。
  97. Widget _busyStrip(ColorScheme scheme) => Padding(
  98. padding: const EdgeInsets.symmetric(vertical: 10),
  99. child: Row(
  100. children: [
  101. const SizedBox(
  102. width: 14,
  103. height: 14,
  104. child: CircularProgressIndicator(strokeWidth: 2),
  105. ),
  106. const SizedBox(width: 10),
  107. Text('计算中…', style: TextStyle(color: scheme.outline)),
  108. ],
  109. ),
  110. );
  111. @override
  112. Widget build(BuildContext context) {
  113. final scheme = Theme.of(context).colorScheme;
  114. return Scaffold(
  115. appBar: AppBar(title: Text(widget.title)),
  116. body: ListView(
  117. padding: const EdgeInsets.fromLTRB(16, 8, 16, 24),
  118. children: [
  119. if (widget.intro != null) ...[
  120. widget.intro!,
  121. const SizedBox(height: 12),
  122. ],
  123. for (final f in widget.fields) f.build(context),
  124. const SizedBox(height: 12),
  125. Row(
  126. children: [
  127. Expanded(
  128. child: FilledButton.icon(
  129. onPressed: _busy ? null : _run,
  130. icon: const Icon(Icons.calculate_outlined),
  131. label: const Text('计算'),
  132. ),
  133. ),
  134. const SizedBox(width: 12),
  135. OutlinedButton.icon(
  136. onPressed: _busy ? null : _reset,
  137. icon: const Icon(Icons.refresh),
  138. label: const Text('重置'),
  139. ),
  140. ],
  141. ),
  142. if (_busy) _busyStrip(scheme),
  143. if (_error != null)
  144. Padding(
  145. padding: const EdgeInsets.only(top: 16),
  146. child: Card(
  147. color: scheme.errorContainer,
  148. child: Padding(
  149. padding: const EdgeInsets.all(14),
  150. child: Row(
  151. crossAxisAlignment: CrossAxisAlignment.start,
  152. children: [
  153. Icon(Icons.error_outline,
  154. size: 20, color: scheme.onErrorContainer),
  155. const SizedBox(width: 10),
  156. Expanded(
  157. child: Text(
  158. _error!,
  159. style: TextStyle(color: scheme.onErrorContainer),
  160. ),
  161. ),
  162. ],
  163. ),
  164. ),
  165. ),
  166. ),
  167. for (final o in _outputs)
  168. Padding(
  169. padding: const EdgeInsets.only(top: 12),
  170. child: _OutputCard(output: o),
  171. ),
  172. ],
  173. ),
  174. );
  175. }
  176. }
  177. /// 一个输入框。label 同时是发送给 Symja 时的变量含义提示。
  178. class ToolField {
  179. ToolField(
  180. this.label, {
  181. String? hint,
  182. this.keyboard = const TextInputType.numberWithOptions(
  183. signed: true,
  184. decimal: true,
  185. ),
  186. }) : hint = hint ?? '输入分数如 1/2,或多个值用空格分隔',
  187. controller = TextEditingController();
  188. final String label;
  189. final String hint;
  190. final TextInputType keyboard;
  191. final TextEditingController controller;
  192. String get text => controller.text.trim();
  193. /// 这一栏里填了几个值。用来做"三组数据个数要一样"这类检查 ——
  194. /// 数个数是记账,不是计算,留在 Dart 侧。
  195. int get count => _tokens.length;
  196. List<String> get _tokens =>
  197. text.split(RegExp(r'[\s,,]+')).where((s) => s.isNotEmpty).toList();
  198. /// 空格/逗号分隔的多个值 → Symja 的列表 `{1, 2, 3}`。
  199. ///
  200. /// 工具页允许用户直接写 `1/2` 这样的分数和 `Pi` 这样的常量 —— 它们交给 Symja
  201. /// 解析,Dart 侧不做数字转换(转换反而会把 `1/2` 变成 0.5 这种近似值)。
  202. String get list => '{${_tokens.join(', ')}}';
  203. Widget build(BuildContext context) => Padding(
  204. padding: const EdgeInsets.symmetric(vertical: 6),
  205. child: TextField(
  206. controller: controller,
  207. keyboardType: keyboard,
  208. decoration: InputDecoration(
  209. labelText: label,
  210. hintText: hint,
  211. border: const OutlineInputBorder(),
  212. isDense: true,
  213. ),
  214. ),
  215. );
  216. }
  217. /// 一条输出。[ToolText] 可点复制,[ToolChart] 不行 —— 图没有可复制的文本形态。
  218. sealed class ToolOutput {
  219. const ToolOutput(this.label);
  220. final String label;
  221. }
  222. /// 一条文字输出。[tex] 不为空时渲染成数学排版,点复制复制的仍是纯文本。
  223. class ToolText extends ToolOutput {
  224. const ToolText(super.label, this.text, {this.tex});
  225. final String text;
  226. final String? tex;
  227. }
  228. /// 一条图表输出。**图表不参与复制**(任务里明确要求的)。
  229. class ToolChart extends ToolOutput {
  230. const ToolChart(super.label, this.chart);
  231. final Widget chart;
  232. }
  233. class _OutputCard extends StatelessWidget {
  234. const _OutputCard({required this.output});
  235. final ToolOutput output;
  236. Future<void> _copy(BuildContext context, String text) async {
  237. await Clipboard.setData(ClipboardData(text: text));
  238. if (!context.mounted) return;
  239. ScaffoldMessenger.of(context)
  240. ..clearSnackBars()
  241. ..showSnackBar(
  242. SnackBar(
  243. content: Text('已复制:${text.length > 30 ? '${text.substring(0, 30)}…' : text}'),
  244. duration: const Duration(milliseconds: 1200),
  245. ),
  246. );
  247. }
  248. @override
  249. Widget build(BuildContext context) {
  250. final scheme = Theme.of(context).colorScheme;
  251. final o = output;
  252. if (o is ToolChart) {
  253. return Card(
  254. child: Padding(
  255. padding: const EdgeInsets.all(12),
  256. child: Column(
  257. crossAxisAlignment: CrossAxisAlignment.start,
  258. children: [
  259. Text(o.label, style: Theme.of(context).textTheme.labelLarge),
  260. const SizedBox(height: 8),
  261. o.chart,
  262. ],
  263. ),
  264. ),
  265. );
  266. }
  267. final t = o as ToolText;
  268. return Card(
  269. clipBehavior: Clip.antiAlias,
  270. child: InkWell(
  271. onTap: () => _copy(context, t.text),
  272. child: Padding(
  273. padding: const EdgeInsets.all(14),
  274. child: Row(
  275. crossAxisAlignment: CrossAxisAlignment.center,
  276. children: [
  277. Expanded(
  278. child: Column(
  279. crossAxisAlignment: CrossAxisAlignment.start,
  280. children: [
  281. Text(
  282. t.label,
  283. style: TextStyle(fontSize: 12, color: scheme.outline),
  284. ),
  285. const SizedBox(height: 6),
  286. // 有 TeX 就用数学排版显示;太长或没生成就退回纯文本
  287. if (t.tex != null)
  288. Math.tex(
  289. t.tex!,
  290. mathStyle: MathStyle.text,
  291. textStyle: TextStyle(
  292. fontSize: 20,
  293. color: scheme.onSurface,
  294. ),
  295. onErrorFallback: (_) => _plain(t.text),
  296. )
  297. else
  298. _plain(t.text),
  299. ],
  300. ),
  301. ),
  302. const SizedBox(width: 8),
  303. Icon(Icons.copy_outlined, size: 18, color: scheme.outline),
  304. ],
  305. ),
  306. ),
  307. ),
  308. );
  309. }
  310. /// 纯文本渲染。刻意用 `Text` 而不是 `SelectableText` —— 后者会把点击吃掉拿去
  311. /// 做选区,整张卡片的"点一下复制"就时灵时不灵了。
  312. Widget _plain(String text) => Text(
  313. text,
  314. style: const TextStyle(fontFamily: 'monospace', fontSize: 16),
  315. );
  316. }
  317. /// 精确值 + 近似值两行输出。
  318. ///
  319. /// 工具页原先在 Dart 里既给分数又给小数(`1/3 (≈0.3333)`)。现在精确值由 Symja
  320. /// 原样给出,近似值再问一次 `N[...]`。**两者相等时只留一行** —— 否则每个整数
  321. /// 结果都会多出一条一模一样的"≈"。
  322. Future<List<ToolOutput>> exactAndApprox(
  323. SymjaSession session,
  324. String label,
  325. String expr,
  326. ) async {
  327. final exact = await session.compute(expr, applyMode: false);
  328. final approx = await session.compute('N[$expr, 10]', applyMode: false);
  329. final same = approx.text == exact.text;
  330. return [
  331. ToolText(label, exact.text, tex: exact.tex),
  332. if (!same) ToolText('$label(近似)', approx.text, tex: approx.tex),
  333. ];
  334. }
  335. /// 纯数值输出:只给近似值(用户要的本来就是个数,不是分数)。
  336. Future<ToolOutput> numeric(
  337. SymjaSession session,
  338. String label,
  339. String expr,
  340. ) async {
  341. final r = await session.compute('N[$expr, 12]', applyMode: false);
  342. return ToolText(label, r.text, tex: null);
  343. }
  344. /// 把 Symja 输出的列表文本拆成嵌套的字符串列表。
  345. ///
  346. /// 工具要拿到"一条条"结果(比如每个 k 的概率、每对卷积取值)才能分开显示,
  347. /// 而通道里回来的是 `{{0, 1/6}, {1, 1/3}}` 这样一个字符串。刻意**不**做数字解析:
  348. /// 拆出来的还是 Symja 的原文(`1/6` 就是 `1/6`),要算数再交回给 Symja。
  349. List<Object> parseSymjaList(String s) {
  350. final t = s.trim();
  351. if (!t.startsWith('{') || !t.endsWith('}')) return [t];
  352. final out = <Object>[];
  353. final buf = StringBuffer();
  354. var depth = 0;
  355. for (var i = 1; i < t.length - 1; i++) {
  356. final c = t[i];
  357. if (c == '{' || c == '[' || c == '(') depth++;
  358. if (c == '}' || c == ']' || c == ')') depth--;
  359. if (c == ',' && depth == 0) {
  360. out.add(_item(buf.toString()));
  361. buf.clear();
  362. continue;
  363. }
  364. buf.write(c);
  365. }
  366. if (buf.isNotEmpty) out.add(_item(buf.toString()));
  367. return out;
  368. }
  369. Object _item(String raw) {
  370. final t = raw.trim();
  371. return t.startsWith('{') ? parseSymjaList(t) : t;
  372. }
  373. /// 取出列表里的数字(Symja 的近似值带一个 `` ` `` 精度标记,要去掉)。
  374. ///
  375. /// 只给**画图**用 —— 图表要的是 double,而"精确值"那条路始终走 Symja 原文。
  376. double? asNumber(Object? item) {
  377. if (item is! String) return null;
  378. return double.tryParse(item.replaceAll('`', '').trim());
  379. }