@sccharts-lab/trace 0.0.0-stage → 0.1.0

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 (60) hide show
  1. package/LICENSE +277 -0
  2. package/README.md +233 -2
  3. package/dist/comparison-report.d.ts +15 -0
  4. package/dist/comparison-report.js +258 -0
  5. package/dist/comparison-report.js.map +1 -0
  6. package/dist/csv.d.ts +13 -0
  7. package/dist/csv.js +188 -0
  8. package/dist/csv.js.map +1 -0
  9. package/dist/data-pool.d.ts +2 -0
  10. package/dist/data-pool.js +26 -0
  11. package/dist/data-pool.js.map +1 -0
  12. package/dist/engine-replay.d.ts +78 -0
  13. package/dist/engine-replay.js +115 -0
  14. package/dist/engine-replay.js.map +1 -0
  15. package/dist/engine-sequence.d.ts +26 -0
  16. package/dist/engine-sequence.js +132 -0
  17. package/dist/engine-sequence.js.map +1 -0
  18. package/dist/engine.d.ts +51 -0
  19. package/dist/engine.js +210 -0
  20. package/dist/engine.js.map +1 -0
  21. package/dist/helper.d.ts +10 -0
  22. package/dist/helper.js +26 -0
  23. package/dist/helper.js.map +1 -0
  24. package/dist/index.d.ts +18 -0
  25. package/dist/index.js +18 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/input-value.d.ts +2 -0
  28. package/dist/input-value.js +38 -0
  29. package/dist/input-value.js.map +1 -0
  30. package/dist/json.d.ts +8 -0
  31. package/dist/json.js +122 -0
  32. package/dist/json.js.map +1 -0
  33. package/dist/ktrace.d.ts +11 -0
  34. package/dist/ktrace.js +266 -0
  35. package/dist/ktrace.js.map +1 -0
  36. package/dist/protocol.d.ts +25 -0
  37. package/dist/protocol.js +18 -0
  38. package/dist/protocol.js.map +1 -0
  39. package/dist/trace-compare.d.ts +77 -0
  40. package/dist/trace-compare.js +156 -0
  41. package/dist/trace-compare.js.map +1 -0
  42. package/dist/trace-file.d.ts +6 -0
  43. package/dist/trace-file.js +65 -0
  44. package/dist/trace-file.js.map +1 -0
  45. package/dist/trace-record.d.ts +71 -0
  46. package/dist/trace-record.js +181 -0
  47. package/dist/trace-record.js.map +1 -0
  48. package/dist/trace-rename.d.ts +40 -0
  49. package/dist/trace-rename.js +112 -0
  50. package/dist/trace-rename.js.map +1 -0
  51. package/dist/trace-replay.d.ts +72 -0
  52. package/dist/trace-replay.js +169 -0
  53. package/dist/trace-replay.js.map +1 -0
  54. package/dist/trace-timing.d.ts +55 -0
  55. package/dist/trace-timing.js +122 -0
  56. package/dist/trace-timing.js.map +1 -0
  57. package/dist/xml.d.ts +8 -0
  58. package/dist/xml.js +179 -0
  59. package/dist/xml.js.map +1 -0
  60. package/package.json +70 -3
@@ -0,0 +1,258 @@
1
+ /*
2
+ * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient
3
+ *
4
+ * http://rtsys.informatik.uni-kiel.de/kieler
5
+ *
6
+ * Copyright 2026 by
7
+ * + Kiel University
8
+ * + Department of Computer Science
9
+ * + Real-Time and Embedded Systems Group
10
+ *
11
+ * This program and the accompanying materials are made available under the
12
+ * terms of the Eclipse Public License 2.0 which is available at
13
+ * http://www.eclipse.org/legal/epl-2.0.
14
+ *
15
+ * SPDX-License-Identifier: EPL-2.0
16
+ */
17
+ import { formatTraceValue, sameTraceValue } from "./trace-record.js";
18
+ import { valueOf } from "./trace-compare.js";
19
+ // A comparison of traces as a Markdown report and as a CSV of every value change.
20
+ function cell(text) {
21
+ return text.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
22
+ }
23
+ function code(value) {
24
+ const text = formatTraceValue(value);
25
+ return text === '' ? '-' : `\`${text.replace(/`/g, "'")}\``;
26
+ }
27
+ function seconds(time) {
28
+ return `${Number(time.toFixed(6))} s`;
29
+ }
30
+ function signed(value, unit = '') {
31
+ const rounded = Number(value.toFixed(6));
32
+ return `${rounded >= 0 ? '+' : ''}${rounded}${unit}`;
33
+ }
34
+ function plural(count, word) {
35
+ return `${count} ${word}${count === 1 ? '' : 's'}`;
36
+ }
37
+ /** Where a difference is: "tick 5", or "3.3 s". */
38
+ function place(alignment, at) {
39
+ return alignment === 'time' ? seconds(at) : `tick ${at}`;
40
+ }
41
+ /** When a change happened, in the terms that matter for the alignment. */
42
+ function when(alignment, change) {
43
+ if (change.time === undefined)
44
+ return `tick ${change.tick}`;
45
+ return alignment === 'time'
46
+ ? `${seconds(change.time)} (tick ${change.tick})`
47
+ : `tick ${change.tick} (${seconds(change.time)})`;
48
+ }
49
+ /** The values of a variable at a tick or moment, one per trace, as "a / b". */
50
+ function valuesAt(comparison, variable, at) {
51
+ return variable.changes
52
+ .map((changes, index) => {
53
+ const beyond = comparison.alignment === 'tick' && comparison.traces[index].ticks < at;
54
+ return code(beyond ? undefined : valueOf(changes, comparison.alignment, at));
55
+ })
56
+ .join(' / ');
57
+ }
58
+ /**
59
+ * The comparison as Markdown, for the editor's preview: what was compared, a summary per
60
+ * variable, every change of the variables that differ, and the first ticks (or moments) that differ.
61
+ */
62
+ export function comparisonMarkdown(comparison, options = {}) {
63
+ const { traces, variables, alignment } = comparison;
64
+ const maxRows = options.maxRows ?? 200;
65
+ const labels = traces.map((trace) => trace.label);
66
+ const byTime = alignment === 'time';
67
+ const lines = ['# Trace comparison', '', ...(options.preamble ?? [])];
68
+ if (options.preamble?.length)
69
+ lines.push('');
70
+ lines.push('| | Trace | Model | Ticks | Simulated time |', '|---|---|---|---|---|');
71
+ traces.forEach((trace, index) => lines.push(`| ${index === 0 ? 'Reference' : index + 1} | ${cell(trace.label)} | ${cell(trace.model ?? '-')} | ${trace.ticks} | ${trace.duration === undefined ? '-' : seconds(trace.duration)} |`));
72
+ lines.push('');
73
+ if (byTime) {
74
+ lines.push('The traces tick at different moments, so they are compared in time: at every moment one of ' +
75
+ `them ticks, up to ${seconds(comparison.until ?? 0)}, each holds the value of its last tick.`, '');
76
+ }
77
+ else if (new Set(traces.map((trace) => trace.ticks)).size > 1) {
78
+ lines.push(`The traces have different lengths, so ticks are compared up to tick ${Math.min(...traces.map((trace) => trace.ticks))}. Value changes are compared over the whole of each trace.`, '');
79
+ }
80
+ const inputs = variables.filter((variable) => variable.role === 'input');
81
+ const differentInputs = inputs.filter((variable) => variable.differing.length > 0);
82
+ if (inputs.length > 0) {
83
+ lines.push(differentInputs.length === 0
84
+ ? `**Inputs:** the same in every trace (${inputs
85
+ .map((variable) => `\`${variable.name}\``)
86
+ .join(', ')}).`
87
+ : `**Inputs differ:** ${differentInputs
88
+ .map((variable) => `\`${variable.name}\` from ${place(alignment, variable.differing[0])}`)
89
+ .join(', ')}. Differences in the outputs may come from the inputs.`, '');
90
+ }
91
+ lines.push('## Summary', '');
92
+ if (variables.length === 0) {
93
+ lines.push('The traces have no variables in common.', '');
94
+ }
95
+ else {
96
+ lines.push(`| Variable | Role | ${byTime ? 'Differs for' : 'Ticks that differ'} | First difference | Value changes | Same order | Largest shift |`, '|---|---|---|---|---|---|---|');
97
+ variables.forEach((variable) => {
98
+ const first = variable.differing[0];
99
+ const firstText = first === undefined ? '-' : `${place(alignment, first)}: ${valuesAt(comparison, variable, first)}`;
100
+ const extent = byTime
101
+ ? `${seconds(variable.differingFor ?? 0)} of ${seconds(comparison.until ?? 0)}`
102
+ : `${variable.differing.length} of ${variable.compared}`;
103
+ let shift = byTime ? seconds(variable.worstTimeShift ?? 0) : plural(variable.worstTickShift, 'tick');
104
+ if (!byTime && variable.worstTimeShift !== undefined)
105
+ shift += ` (${seconds(variable.worstTimeShift)})`;
106
+ lines.push(`| \`${variable.name}\` | ${variable.role ?? '-'} | ${extent} | ${cell(firstText)} | ${variable.changes
107
+ .map((changes) => changes.length)
108
+ .join(' / ')} | ${variable.sameSequence ? 'yes' : '**no**'} | ${shift} |`);
109
+ });
110
+ lines.push('', '*Value changes* counts the first tick and every tick where the value is new. *Same order*: every ' +
111
+ 'trace goes through the same values in the same order, whenever it does so. *Largest shift*: the ' +
112
+ 'furthest apart the n-th change of a trace and of the reference are.', '');
113
+ }
114
+ if (comparison.partial.length > 0) {
115
+ lines.push(`**Not in every trace:** ${comparison.partial
116
+ .map((entry) => `\`${entry.name}\` (${entry.labels.map(cell).join(', ')})`)
117
+ .join(', ')}.`, '');
118
+ }
119
+ const { printed } = comparison;
120
+ if (printed) {
121
+ const shift = byTime
122
+ ? seconds(printed.worstTimeShift ?? 0)
123
+ : `${plural(printed.worstTickShift, 'tick')}${printed.worstTimeShift === undefined ? '' : ` (${seconds(printed.worstTimeShift)})`}`;
124
+ lines.push(`**Printed:** ${printed.lines.map((entries) => entries.length).join(' / ')} lines; ${printed.sameSequence ? 'the same text in the same order' : '**not the same text in the same order**'}; largest shift ${shift}.`, '');
125
+ }
126
+ // Outputs always: their changes are the run's timeline. Other variables when they differ or move.
127
+ const changed = variables.filter((variable) => variable.role === 'output' ||
128
+ (variable.role !== 'input' &&
129
+ (variable.differing.length > 0 ||
130
+ !variable.sameSequence ||
131
+ (byTime ? (variable.worstTimeShift ?? 0) > 0 : variable.worstTickShift > 0))));
132
+ if (changed.length > 0)
133
+ lines.push('## Value changes', '');
134
+ changed.forEach((variable) => {
135
+ lines.push(`### \`${variable.name}\``, '');
136
+ lines.push(`| # | ${labels.map(cell).join(' | ')} | Shift |`, `|---|${labels.map(() => '---|').join('')}---|`);
137
+ const rows = Math.max(...variable.changes.map((changes) => changes.length));
138
+ for (let index = 0; index < Math.min(rows, maxRows); index++) {
139
+ const reference = variable.changes[0][index];
140
+ const entries = variable.changes.map((changes) => changes[index]);
141
+ const shifts = entries.slice(1).map((entry) => {
142
+ if (!entry || !reference)
143
+ return '-';
144
+ const ticks = signed(entry.tick - reference.tick);
145
+ if (entry.time === undefined || reference.time === undefined)
146
+ return ticks;
147
+ const time = signed(entry.time - reference.time, ' s');
148
+ return byTime ? time : `${ticks} (${time})`;
149
+ });
150
+ const differs = entries.some((entry) => !entry || !reference || !sameTraceValue(entry.value, reference.value));
151
+ lines.push(`| ${index + 1}${differs ? ' ≠' : ''} | ${entries
152
+ .map((entry) => (entry ? `${code(entry.value)} at ${when(alignment, entry)}` : '-'))
153
+ .map(cell)
154
+ .join(' | ')} | ${shifts.join(', ')} |`);
155
+ }
156
+ if (rows > maxRows)
157
+ lines.push('', `${rows - maxRows} more changes are in the CSV of this comparison.`);
158
+ lines.push('');
159
+ });
160
+ if (printed) {
161
+ lines.push('## Printed', '');
162
+ lines.push(`| # | ${labels.map(cell).join(' | ')} | Shift |`, `|---|${labels.map(() => '---|').join('')}---|`);
163
+ const rows = Math.max(...printed.lines.map((each) => each.length));
164
+ for (let index = 0; index < Math.min(rows, maxRows); index++) {
165
+ const reference = printed.lines[0][index];
166
+ const entries = printed.lines.map((each) => each[index]);
167
+ const shifts = entries.slice(1).map((entry) => {
168
+ if (!entry || !reference)
169
+ return '-';
170
+ const ticks = signed(entry.tick - reference.tick);
171
+ if (entry.time === undefined || reference.time === undefined)
172
+ return ticks;
173
+ const time = signed(entry.time - reference.time, ' s');
174
+ return byTime ? time : `${ticks} (${time})`;
175
+ });
176
+ const differs = entries.some((entry) => !entry || !reference || entry.text !== reference.text);
177
+ lines.push(`| ${index + 1}${differs ? ' ≠' : ''} | ${entries
178
+ .map((entry) => entry ? `${code(entry.text)} at ${when(alignment, { ...entry, value: entry.text })}` : '-')
179
+ .map(cell)
180
+ .join(' | ')} | ${shifts.join(', ')} |`);
181
+ }
182
+ if (rows > maxRows)
183
+ lines.push('', `${rows - maxRows} more lines are in the CSV of this comparison.`);
184
+ lines.push('');
185
+ }
186
+ const differing = Array.from(new Set(variables.flatMap((variable) => variable.differing))).sort((a, b) => a - b);
187
+ if (differing.length > 0) {
188
+ const columns = variables.filter((variable) => variable.differing.length > 0);
189
+ lines.push(byTime ? '## Moments that differ' : '## Ticks that differ', '');
190
+ lines.push(`Values are shown as ${labels.map(cell).join(' / ')}.`, '', `| ${byTime ? 'Time' : 'Tick'} | ${columns.map((variable) => `\`${variable.name}\``).join(' | ')} |`, `|---|${columns.map(() => '---|').join('')}`);
191
+ differing
192
+ .slice(0, maxRows)
193
+ .forEach((at) => lines.push(`| ${byTime ? seconds(at) : at} | ${columns
194
+ .map((variable) => variable.differing.includes(at) ? cell(valuesAt(comparison, variable, at)) : '')
195
+ .join(' | ')} |`));
196
+ if (differing.length > maxRows) {
197
+ lines.push('', `${differing.length - maxRows} more ${byTime ? 'moments' : 'ticks'} differ.`);
198
+ }
199
+ lines.push('');
200
+ }
201
+ else if (variables.length > 0) {
202
+ lines.push(byTime
203
+ ? 'Every variable the traces share has the same value at every moment compared.'
204
+ : 'Every variable the traces share has the same value at every tick they share.', '');
205
+ }
206
+ return `${lines.join('\n')}\n`;
207
+ }
208
+ function csvCell(text) {
209
+ return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
210
+ }
211
+ /**
212
+ * Every change of every shared variable, aligned by its position: one row per n-th change, with
213
+ * each trace's tick, time and value. The table behind "Value changes", for further analysis.
214
+ * Printed lines follow as rows of their own, the n-th line of each trace in one row.
215
+ */
216
+ export function comparisonCsv(comparison) {
217
+ const timed = comparison.variables.some((variable) => variable.worstTimeShift !== undefined);
218
+ const header = ['variable', 'role', 'change'];
219
+ comparison.traces.forEach(({ label }) => {
220
+ header.push(`${label} tick`);
221
+ if (timed)
222
+ header.push(`${label} time`);
223
+ header.push(`${label} value`);
224
+ });
225
+ const rows = [header];
226
+ comparison.variables.forEach((variable) => {
227
+ const count = Math.max(...variable.changes.map((changes) => changes.length));
228
+ for (let index = 0; index < count; index++) {
229
+ const row = [variable.name, variable.role ?? '', String(index + 1)];
230
+ variable.changes.forEach((changes) => {
231
+ const change = changes[index];
232
+ row.push(change ? String(change.tick) : '');
233
+ if (timed)
234
+ row.push(change?.time === undefined ? '' : String(change.time));
235
+ row.push(change ? formatTraceValue(change.value) : '');
236
+ });
237
+ rows.push(row);
238
+ }
239
+ });
240
+ const { printed } = comparison;
241
+ if (printed) {
242
+ const count = Math.max(...printed.lines.map((entries) => entries.length));
243
+ for (let index = 0; index < count; index++) {
244
+ // The role column marks these rows; no variable is called "(printed)".
245
+ const row = ['(printed)', 'printed', String(index + 1)];
246
+ printed.lines.forEach((entries) => {
247
+ const entry = entries[index];
248
+ row.push(entry ? String(entry.tick) : '');
249
+ if (timed)
250
+ row.push(entry?.time === undefined ? '' : String(entry.time));
251
+ row.push(entry ? entry.text : '');
252
+ });
253
+ rows.push(row);
254
+ }
255
+ }
256
+ return `${rows.map((row) => row.map(csvCell).join(',')).join('\n')}\n`;
257
+ }
258
+ //# sourceMappingURL=comparison-report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comparison-report.js","sourceRoot":"","sources":["../src/comparison-report.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient\n *\n * http://rtsys.informatik.uni-kiel.de/kieler\n *\n * Copyright 2026 by\n * + Kiel University\n * + Department of Computer Science\n * + Real-Time and Embedded Systems Group\n *\n * This program and the accompanying materials are made available under the\n * terms of the Eclipse Public License 2.0 which is available at\n * http://www.eclipse.org/legal/epl-2.0.\n *\n * SPDX-License-Identifier: EPL-2.0\n */\n\nimport { formatTraceValue, sameTraceValue } from './trace-record'\nimport { valueOf } from './trace-compare'\nimport type { Alignment, TraceComparison, ValueChange, VariableComparison } from './trace-compare'\n\n// A comparison of traces as a Markdown report and as a CSV of every value change.\n\nfunction cell(text: string): string {\n return text.replace(/\\|/g, '\\\\|').replace(/\\r?\\n/g, ' ')\n}\n\nfunction code(value: unknown): string {\n const text = formatTraceValue(value)\n return text === '' ? '-' : `\\`${text.replace(/`/g, \"'\")}\\``\n}\n\nfunction seconds(time: number): string {\n return `${Number(time.toFixed(6))} s`\n}\n\nfunction signed(value: number, unit = ''): string {\n const rounded = Number(value.toFixed(6))\n return `${rounded >= 0 ? '+' : ''}${rounded}${unit}`\n}\n\nfunction plural(count: number, word: string): string {\n return `${count} ${word}${count === 1 ? '' : 's'}`\n}\n\n/** Where a difference is: \"tick 5\", or \"3.3 s\". */\nfunction place(alignment: Alignment, at: number): string {\n return alignment === 'time' ? seconds(at) : `tick ${at}`\n}\n\n/** When a change happened, in the terms that matter for the alignment. */\nfunction when(alignment: Alignment, change: ValueChange): string {\n if (change.time === undefined) return `tick ${change.tick}`\n return alignment === 'time'\n ? `${seconds(change.time)} (tick ${change.tick})`\n : `tick ${change.tick} (${seconds(change.time)})`\n}\n\n/** The values of a variable at a tick or moment, one per trace, as \"a / b\". */\nfunction valuesAt(comparison: TraceComparison, variable: VariableComparison, at: number): string {\n return variable.changes\n .map((changes, index) => {\n const beyond = comparison.alignment === 'tick' && comparison.traces[index].ticks < at\n return code(beyond ? undefined : valueOf(changes, comparison.alignment, at))\n })\n .join(' / ')\n}\n\n/**\n * The comparison as Markdown, for the editor's preview: what was compared, a summary per\n * variable, every change of the variables that differ, and the first ticks (or moments) that differ.\n */\nexport function comparisonMarkdown(\n comparison: TraceComparison,\n options: { maxRows?: number; preamble?: string[] } = {}\n): string {\n const { traces, variables, alignment } = comparison\n const maxRows = options.maxRows ?? 200\n const labels = traces.map((trace) => trace.label)\n const byTime = alignment === 'time'\n const lines: string[] = ['# Trace comparison', '', ...(options.preamble ?? [])]\n if (options.preamble?.length) lines.push('')\n lines.push('| | Trace | Model | Ticks | Simulated time |', '|---|---|---|---|---|')\n traces.forEach((trace, index) =>\n lines.push(\n `| ${index === 0 ? 'Reference' : index + 1} | ${cell(trace.label)} | ${cell(trace.model ?? '-')} | ${\n trace.ticks\n } | ${trace.duration === undefined ? '-' : seconds(trace.duration)} |`\n )\n )\n lines.push('')\n if (byTime) {\n lines.push(\n 'The traces tick at different moments, so they are compared in time: at every moment one of ' +\n `them ticks, up to ${seconds(comparison.until ?? 0)}, each holds the value of its last tick.`,\n ''\n )\n } else if (new Set(traces.map((trace) => trace.ticks)).size > 1) {\n lines.push(\n `The traces have different lengths, so ticks are compared up to tick ${Math.min(\n ...traces.map((trace) => trace.ticks)\n )}. Value changes are compared over the whole of each trace.`,\n ''\n )\n }\n\n const inputs = variables.filter((variable) => variable.role === 'input')\n const differentInputs = inputs.filter((variable) => variable.differing.length > 0)\n if (inputs.length > 0) {\n lines.push(\n differentInputs.length === 0\n ? `**Inputs:** the same in every trace (${inputs\n .map((variable) => `\\`${variable.name}\\``)\n .join(', ')}).`\n : `**Inputs differ:** ${differentInputs\n .map((variable) => `\\`${variable.name}\\` from ${place(alignment, variable.differing[0])}`)\n .join(', ')}. Differences in the outputs may come from the inputs.`,\n ''\n )\n }\n\n lines.push('## Summary', '')\n if (variables.length === 0) {\n lines.push('The traces have no variables in common.', '')\n } else {\n lines.push(\n `| Variable | Role | ${\n byTime ? 'Differs for' : 'Ticks that differ'\n } | First difference | Value changes | Same order | Largest shift |`,\n '|---|---|---|---|---|---|---|'\n )\n variables.forEach((variable) => {\n const first = variable.differing[0]\n const firstText =\n first === undefined ? '-' : `${place(alignment, first)}: ${valuesAt(comparison, variable, first)}`\n const extent = byTime\n ? `${seconds(variable.differingFor ?? 0)} of ${seconds(comparison.until ?? 0)}`\n : `${variable.differing.length} of ${variable.compared}`\n let shift = byTime ? seconds(variable.worstTimeShift ?? 0) : plural(variable.worstTickShift, 'tick')\n if (!byTime && variable.worstTimeShift !== undefined) shift += ` (${seconds(variable.worstTimeShift)})`\n lines.push(\n `| \\`${variable.name}\\` | ${variable.role ?? '-'} | ${extent} | ${cell(firstText)} | ${variable.changes\n .map((changes) => changes.length)\n .join(' / ')} | ${variable.sameSequence ? 'yes' : '**no**'} | ${shift} |`\n )\n })\n lines.push(\n '',\n '*Value changes* counts the first tick and every tick where the value is new. *Same order*: every ' +\n 'trace goes through the same values in the same order, whenever it does so. *Largest shift*: the ' +\n 'furthest apart the n-th change of a trace and of the reference are.',\n ''\n )\n }\n if (comparison.partial.length > 0) {\n lines.push(\n `**Not in every trace:** ${comparison.partial\n .map((entry) => `\\`${entry.name}\\` (${entry.labels.map(cell).join(', ')})`)\n .join(', ')}.`,\n ''\n )\n }\n\n const { printed } = comparison\n if (printed) {\n const shift = byTime\n ? seconds(printed.worstTimeShift ?? 0)\n : `${plural(printed.worstTickShift, 'tick')}${\n printed.worstTimeShift === undefined ? '' : ` (${seconds(printed.worstTimeShift)})`\n }`\n lines.push(\n `**Printed:** ${printed.lines.map((entries) => entries.length).join(' / ')} lines; ${\n printed.sameSequence ? 'the same text in the same order' : '**not the same text in the same order**'\n }; largest shift ${shift}.`,\n ''\n )\n }\n\n // Outputs always: their changes are the run's timeline. Other variables when they differ or move.\n const changed = variables.filter(\n (variable) =>\n variable.role === 'output' ||\n (variable.role !== 'input' &&\n (variable.differing.length > 0 ||\n !variable.sameSequence ||\n (byTime ? (variable.worstTimeShift ?? 0) > 0 : variable.worstTickShift > 0)))\n )\n if (changed.length > 0) lines.push('## Value changes', '')\n changed.forEach((variable) => {\n lines.push(`### \\`${variable.name}\\``, '')\n lines.push(`| # | ${labels.map(cell).join(' | ')} | Shift |`, `|---|${labels.map(() => '---|').join('')}---|`)\n const rows = Math.max(...variable.changes.map((changes) => changes.length))\n for (let index = 0; index < Math.min(rows, maxRows); index++) {\n const reference = variable.changes[0][index]\n const entries = variable.changes.map((changes) => changes[index])\n const shifts = entries.slice(1).map((entry) => {\n if (!entry || !reference) return '-'\n const ticks = signed(entry.tick - reference.tick)\n if (entry.time === undefined || reference.time === undefined) return ticks\n const time = signed(entry.time - reference.time, ' s')\n return byTime ? time : `${ticks} (${time})`\n })\n const differs = entries.some(\n (entry) => !entry || !reference || !sameTraceValue(entry.value, reference.value)\n )\n lines.push(\n `| ${index + 1}${differs ? ' ≠' : ''} | ${entries\n .map((entry) => (entry ? `${code(entry.value)} at ${when(alignment, entry)}` : '-'))\n .map(cell)\n .join(' | ')} | ${shifts.join(', ')} |`\n )\n }\n if (rows > maxRows) lines.push('', `${rows - maxRows} more changes are in the CSV of this comparison.`)\n lines.push('')\n })\n\n if (printed) {\n lines.push('## Printed', '')\n lines.push(`| # | ${labels.map(cell).join(' | ')} | Shift |`, `|---|${labels.map(() => '---|').join('')}---|`)\n const rows = Math.max(...printed.lines.map((each) => each.length))\n for (let index = 0; index < Math.min(rows, maxRows); index++) {\n const reference = printed.lines[0][index]\n const entries = printed.lines.map((each) => each[index])\n const shifts = entries.slice(1).map((entry) => {\n if (!entry || !reference) return '-'\n const ticks = signed(entry.tick - reference.tick)\n if (entry.time === undefined || reference.time === undefined) return ticks\n const time = signed(entry.time - reference.time, ' s')\n return byTime ? time : `${ticks} (${time})`\n })\n const differs = entries.some((entry) => !entry || !reference || entry.text !== reference.text)\n lines.push(\n `| ${index + 1}${differs ? ' ≠' : ''} | ${entries\n .map((entry) =>\n entry ? `${code(entry.text)} at ${when(alignment, { ...entry, value: entry.text })}` : '-'\n )\n .map(cell)\n .join(' | ')} | ${shifts.join(', ')} |`\n )\n }\n if (rows > maxRows) lines.push('', `${rows - maxRows} more lines are in the CSV of this comparison.`)\n lines.push('')\n }\n\n const differing = Array.from(new Set(variables.flatMap((variable) => variable.differing))).sort((a, b) => a - b)\n if (differing.length > 0) {\n const columns = variables.filter((variable) => variable.differing.length > 0)\n lines.push(byTime ? '## Moments that differ' : '## Ticks that differ', '')\n lines.push(\n `Values are shown as ${labels.map(cell).join(' / ')}.`,\n '',\n `| ${byTime ? 'Time' : 'Tick'} | ${columns.map((variable) => `\\`${variable.name}\\``).join(' | ')} |`,\n `|---|${columns.map(() => '---|').join('')}`\n )\n differing\n .slice(0, maxRows)\n .forEach((at) =>\n lines.push(\n `| ${byTime ? seconds(at) : at} | ${columns\n .map((variable) =>\n variable.differing.includes(at) ? cell(valuesAt(comparison, variable, at)) : ''\n )\n .join(' | ')} |`\n )\n )\n if (differing.length > maxRows) {\n lines.push('', `${differing.length - maxRows} more ${byTime ? 'moments' : 'ticks'} differ.`)\n }\n lines.push('')\n } else if (variables.length > 0) {\n lines.push(\n byTime\n ? 'Every variable the traces share has the same value at every moment compared.'\n : 'Every variable the traces share has the same value at every tick they share.',\n ''\n )\n }\n return `${lines.join('\\n')}\\n`\n}\n\nfunction csvCell(text: string): string {\n return /[\",\\r\\n]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n}\n\n/**\n * Every change of every shared variable, aligned by its position: one row per n-th change, with\n * each trace's tick, time and value. The table behind \"Value changes\", for further analysis.\n * Printed lines follow as rows of their own, the n-th line of each trace in one row.\n */\nexport function comparisonCsv(comparison: TraceComparison): string {\n const timed = comparison.variables.some((variable) => variable.worstTimeShift !== undefined)\n const header = ['variable', 'role', 'change']\n comparison.traces.forEach(({ label }) => {\n header.push(`${label} tick`)\n if (timed) header.push(`${label} time`)\n header.push(`${label} value`)\n })\n const rows = [header]\n comparison.variables.forEach((variable) => {\n const count = Math.max(...variable.changes.map((changes) => changes.length))\n for (let index = 0; index < count; index++) {\n const row = [variable.name, variable.role ?? '', String(index + 1)]\n variable.changes.forEach((changes) => {\n const change = changes[index]\n row.push(change ? String(change.tick) : '')\n if (timed) row.push(change?.time === undefined ? '' : String(change.time))\n row.push(change ? formatTraceValue(change.value) : '')\n })\n rows.push(row)\n }\n })\n const { printed } = comparison\n if (printed) {\n const count = Math.max(...printed.lines.map((entries) => entries.length))\n for (let index = 0; index < count; index++) {\n // The role column marks these rows; no variable is called \"(printed)\".\n const row = ['(printed)', 'printed', String(index + 1)]\n printed.lines.forEach((entries) => {\n const entry = entries[index]\n row.push(entry ? String(entry.tick) : '')\n if (timed) row.push(entry?.time === undefined ? '' : String(entry.time))\n row.push(entry ? entry.text : '')\n })\n rows.push(row)\n }\n }\n return `${rows.map((row) => row.map(csvCell).join(',')).join('\\n')}\\n`\n}\n"]}
package/dist/csv.d.ts ADDED
@@ -0,0 +1,13 @@
1
+ import type { TraceRecord } from "./trace-record.js";
2
+ /**
3
+ * One row per tick: `tick`, `time` when the trace has a time delta, `printed` when the model
4
+ * printed something, then a column per variable. Booleans are true/false, arrays JSON, a tick's
5
+ * printed lines one cell with line breaks. pandas, R and spreadsheets read it as it is.
6
+ */
7
+ export declare function writeCsv(trace: TraceRecord): string;
8
+ /**
9
+ * Reads a CSV with a header row and one row per tick. `tick`, `time` and `printed` at the start
10
+ * are bookkeeping, not variables. Empty cells keep the value from the row before, so a
11
+ * hand-written input sequence only has to note the changes.
12
+ */
13
+ export declare function readCsv(text: string): TraceRecord;
package/dist/csv.js ADDED
@@ -0,0 +1,188 @@
1
+ /*
2
+ * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient
3
+ *
4
+ * http://rtsys.informatik.uni-kiel.de/kieler
5
+ *
6
+ * Copyright 2026 by
7
+ * + Kiel University
8
+ * + Department of Computer Science
9
+ * + Real-Time and Embedded Systems Group
10
+ *
11
+ * This program and the accompanying materials are made available under the
12
+ * terms of the Eclipse Public License 2.0 which is available at
13
+ * http://www.eclipse.org/legal/epl-2.0.
14
+ *
15
+ * SPDX-License-Identifier: EPL-2.0
16
+ */
17
+ import { isTimeDelta } from "./helper.js";
18
+ import { carryForward, decodeText, formatTraceValue, givenTimes, printedOf, TraceFileError, traceTimes, typeOfValue, VariableList, } from "./trace-record.js";
19
+ // CSV: a row per tick, for spreadsheets, pandas and R.
20
+ function csvCell(text) {
21
+ return /[",\r\n]|^\s|\s$/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
22
+ }
23
+ /** A cell's text, where an empty string is quoted: an empty cell means the value is unknown. */
24
+ function csvValue(text, emptyString) {
25
+ return text === '' && emptyString ? '""' : csvCell(text);
26
+ }
27
+ /**
28
+ * One row per tick: `tick`, `time` when the trace has a time delta, `printed` when the model
29
+ * printed something, then a column per variable. Booleans are true/false, arrays JSON, a tick's
30
+ * printed lines one cell with line breaks. pandas, R and spreadsheets read it as it is.
31
+ */
32
+ export function writeCsv(trace) {
33
+ const times = traceTimes(trace);
34
+ const names = trace.variables.map((variable) => variable.name);
35
+ const printed = printedOf(trace.printed);
36
+ // A variable named like a bookkeeping column still gets that column first, so it is read back as itself.
37
+ const timeColumn = !!times || names.includes('time');
38
+ const printedColumn = !!printed || names.includes('printed');
39
+ const header = ['tick', ...(timeColumn ? ['time'] : []), ...(printedColumn ? ['printed'] : []), ...names];
40
+ const rows = trace.ticks.map((tick, index) => {
41
+ const lines = printed?.[index] ?? [];
42
+ return [
43
+ String(index + 1),
44
+ ...(timeColumn ? [times ? String(times[index]) : ''] : []),
45
+ ...(printedColumn ? [csvValue(lines.join('\n'), lines.length > 0)] : []),
46
+ ...names.map((name) => csvValue(formatTraceValue(tick[name]), tick[name] === '')),
47
+ ].join(',');
48
+ });
49
+ return `${[header.map(csvCell).join(','), ...rows].join('\n')}\n`;
50
+ }
51
+ /**
52
+ * The rows of a CSV, blank lines included; `quoted` marks the cells that were, so `""` can be
53
+ * told from an empty cell.
54
+ */
55
+ function parseCsvRows(text) {
56
+ const rows = [];
57
+ let cells = [];
58
+ let quotes = [];
59
+ let cell = '';
60
+ let wasQuoted = false;
61
+ let quoted = false;
62
+ let line = 1;
63
+ let rowLine = 1;
64
+ let i = 0;
65
+ const endCell = () => {
66
+ cells.push(cell);
67
+ quotes.push(wasQuoted);
68
+ cell = '';
69
+ wasQuoted = false;
70
+ };
71
+ const endRow = () => {
72
+ endCell();
73
+ rows.push({ cells, quoted: quotes, line: rowLine });
74
+ cells = [];
75
+ quotes = [];
76
+ };
77
+ while (i < text.length) {
78
+ const ch = text[i];
79
+ if (quoted) {
80
+ if (ch === '"' && text[i + 1] === '"') {
81
+ cell += '"';
82
+ i++;
83
+ }
84
+ else if (ch === '"') {
85
+ quoted = false;
86
+ }
87
+ else {
88
+ if (ch === '\n')
89
+ line++;
90
+ cell += ch;
91
+ }
92
+ }
93
+ else if (ch === '"' && cell.trim() === '') {
94
+ quoted = true;
95
+ wasQuoted = true;
96
+ cell = '';
97
+ }
98
+ else if (ch === ',') {
99
+ endCell();
100
+ }
101
+ else if (ch === '\n' || ch === '\r') {
102
+ if (ch === '\r' && text[i + 1] === '\n')
103
+ i++;
104
+ endRow();
105
+ line++;
106
+ rowLine = line;
107
+ }
108
+ else {
109
+ cell += ch;
110
+ }
111
+ i++;
112
+ }
113
+ if (quoted)
114
+ throw new TraceFileError('A quoted cell is not closed.', rowLine);
115
+ if (cell !== '' || cells.length > 0)
116
+ endRow();
117
+ return rows;
118
+ }
119
+ /**
120
+ * Reads a CSV with a header row and one row per tick. `tick`, `time` and `printed` at the start
121
+ * are bookkeeping, not variables. Empty cells keep the value from the row before, so a
122
+ * hand-written input sequence only has to note the changes.
123
+ */
124
+ export function readCsv(text) {
125
+ const isBlank = (row) => row.cells.length === 1 && row.cells[0].trim() === '' && !row.quoted[0];
126
+ const all = parseCsvRows(text.replace(/^\uFEFF/, ''));
127
+ while (all.length > 0 && isBlank(all[all.length - 1]))
128
+ all.pop();
129
+ while (all.length > 0 && isBlank(all[0]))
130
+ all.shift();
131
+ // With one column a blank line is a row that changes nothing; with more, an empty row is
132
+ // written as commas, and a blank line is only spacing, as pandas reads it.
133
+ const rows = all[0]?.cells.length === 1 ? all : all.filter((row) => !isBlank(row));
134
+ if (rows.length === 0)
135
+ throw new TraceFileError('The file is empty.');
136
+ const header = rows[0].cells.map((cell) => cell.trim());
137
+ const hasDelta = header.some((name) => isTimeDelta({ id: name, categories: [] }));
138
+ const timeColumn = header.findIndex((name, index) => name === 'time' && index <= 1);
139
+ let next = timeColumn >= 0 ? timeColumn + 1 : Number(header[0] === 'tick');
140
+ const printedColumn = header[next] === 'printed' ? next++ : -1;
141
+ const skipped = header.map((name, index) => index < next && (name === 'tick' || name === 'time' || name === 'printed'));
142
+ const seen = new Set();
143
+ header.forEach((name, index) => {
144
+ if (!name)
145
+ throw new TraceFileError(`Column ${index + 1} has no name in the header row.`, rows[0].line);
146
+ if (skipped[index])
147
+ return;
148
+ if (seen.has(name))
149
+ throw new TraceFileError(`The header names ${name} twice.`, rows[0].line);
150
+ seen.add(name);
151
+ });
152
+ const list = new VariableList();
153
+ header.forEach((name, index) => {
154
+ if (!skipped[index])
155
+ list.add(name);
156
+ });
157
+ const ticks = rows.slice(1).map(({ cells, quoted, line }) => {
158
+ if (cells.length > header.length) {
159
+ throw new TraceFileError(`The row has ${cells.length} cells, the header ${header.length}.`, line);
160
+ }
161
+ const tick = {};
162
+ header.forEach((name, index) => {
163
+ const cell = cells[index];
164
+ if (skipped[index] || cell === undefined)
165
+ return;
166
+ if (quoted[index] && cell === '')
167
+ tick[name] = '';
168
+ else if (cell.trim() !== '')
169
+ tick[name] = decodeText(cell);
170
+ });
171
+ return tick;
172
+ });
173
+ ticks.forEach((tick) => Object.entries(tick).forEach(([name, value]) => list.add(name, undefined, typeOfValue(value))));
174
+ const times = timeColumn < 0 || hasDelta
175
+ ? undefined
176
+ : givenTimes(rows.slice(1).map(({ cells }) => {
177
+ const cell = cells[timeColumn]?.trim();
178
+ return cell ? Number(cell) : undefined;
179
+ }), list.variables, (index) => `Line ${rows[index + 1].line}: the row`);
180
+ const printed = printedColumn < 0
181
+ ? undefined
182
+ : printedOf(rows.slice(1).map(({ cells, quoted }) => {
183
+ const cell = cells[printedColumn] ?? '';
184
+ return cell === '' && !quoted[printedColumn] ? [] : cell.split(/\r?\n/);
185
+ }));
186
+ return { variables: list.variables, ticks: carryForward(ticks, list.variables), times, printed };
187
+ }
188
+ //# sourceMappingURL=csv.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"csv.js","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient\n *\n * http://rtsys.informatik.uni-kiel.de/kieler\n *\n * Copyright 2026 by\n * + Kiel University\n * + Department of Computer Science\n * + Real-Time and Embedded Systems Group\n *\n * This program and the accompanying materials are made available under the\n * terms of the Eclipse Public License 2.0 which is available at\n * http://www.eclipse.org/legal/epl-2.0.\n *\n * SPDX-License-Identifier: EPL-2.0\n */\n\nimport { isTimeDelta } from './helper'\nimport {\n carryForward,\n decodeText,\n formatTraceValue,\n givenTimes,\n printedOf,\n TraceFileError,\n traceTimes,\n typeOfValue,\n VariableList,\n} from './trace-record'\nimport type { TraceRecord } from './trace-record'\n\n// CSV: a row per tick, for spreadsheets, pandas and R.\n\nfunction csvCell(text: string): string {\n return /[\",\\r\\n]|^\\s|\\s$/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n}\n\n/** A cell's text, where an empty string is quoted: an empty cell means the value is unknown. */\nfunction csvValue(text: string, emptyString: boolean): string {\n return text === '' && emptyString ? '\"\"' : csvCell(text)\n}\n\n/**\n * One row per tick: `tick`, `time` when the trace has a time delta, `printed` when the model\n * printed something, then a column per variable. Booleans are true/false, arrays JSON, a tick's\n * printed lines one cell with line breaks. pandas, R and spreadsheets read it as it is.\n */\nexport function writeCsv(trace: TraceRecord): string {\n const times = traceTimes(trace)\n const names = trace.variables.map((variable) => variable.name)\n const printed = printedOf(trace.printed)\n // A variable named like a bookkeeping column still gets that column first, so it is read back as itself.\n const timeColumn = !!times || names.includes('time')\n const printedColumn = !!printed || names.includes('printed')\n const header = ['tick', ...(timeColumn ? ['time'] : []), ...(printedColumn ? ['printed'] : []), ...names]\n const rows = trace.ticks.map((tick, index) => {\n const lines = printed?.[index] ?? []\n return [\n String(index + 1),\n ...(timeColumn ? [times ? String(times[index]) : ''] : []),\n ...(printedColumn ? [csvValue(lines.join('\\n'), lines.length > 0)] : []),\n ...names.map((name) => csvValue(formatTraceValue(tick[name]), tick[name] === '')),\n ].join(',')\n })\n return `${[header.map(csvCell).join(','), ...rows].join('\\n')}\\n`\n}\n\n/**\n * The rows of a CSV, blank lines included; `quoted` marks the cells that were, so `\"\"` can be\n * told from an empty cell.\n */\nfunction parseCsvRows(text: string): { cells: string[]; quoted: boolean[]; line: number }[] {\n const rows: { cells: string[]; quoted: boolean[]; line: number }[] = []\n let cells: string[] = []\n let quotes: boolean[] = []\n let cell = ''\n let wasQuoted = false\n let quoted = false\n let line = 1\n let rowLine = 1\n let i = 0\n const endCell = () => {\n cells.push(cell)\n quotes.push(wasQuoted)\n cell = ''\n wasQuoted = false\n }\n const endRow = () => {\n endCell()\n rows.push({ cells, quoted: quotes, line: rowLine })\n cells = []\n quotes = []\n }\n while (i < text.length) {\n const ch = text[i]\n if (quoted) {\n if (ch === '\"' && text[i + 1] === '\"') {\n cell += '\"'\n i++\n } else if (ch === '\"') {\n quoted = false\n } else {\n if (ch === '\\n') line++\n cell += ch\n }\n } else if (ch === '\"' && cell.trim() === '') {\n quoted = true\n wasQuoted = true\n cell = ''\n } else if (ch === ',') {\n endCell()\n } else if (ch === '\\n' || ch === '\\r') {\n if (ch === '\\r' && text[i + 1] === '\\n') i++\n endRow()\n line++\n rowLine = line\n } else {\n cell += ch\n }\n i++\n }\n if (quoted) throw new TraceFileError('A quoted cell is not closed.', rowLine)\n if (cell !== '' || cells.length > 0) endRow()\n return rows\n}\n\n/**\n * Reads a CSV with a header row and one row per tick. `tick`, `time` and `printed` at the start\n * are bookkeeping, not variables. Empty cells keep the value from the row before, so a\n * hand-written input sequence only has to note the changes.\n */\nexport function readCsv(text: string): TraceRecord {\n const isBlank = (row: { cells: string[]; quoted: boolean[] }) =>\n row.cells.length === 1 && row.cells[0].trim() === '' && !row.quoted[0]\n const all = parseCsvRows(text.replace(/^\\uFEFF/, ''))\n while (all.length > 0 && isBlank(all[all.length - 1])) all.pop()\n while (all.length > 0 && isBlank(all[0])) all.shift()\n // With one column a blank line is a row that changes nothing; with more, an empty row is\n // written as commas, and a blank line is only spacing, as pandas reads it.\n const rows = all[0]?.cells.length === 1 ? all : all.filter((row) => !isBlank(row))\n if (rows.length === 0) throw new TraceFileError('The file is empty.')\n const header = rows[0].cells.map((cell) => cell.trim())\n const hasDelta = header.some((name) => isTimeDelta({ id: name, categories: [] }))\n const timeColumn = header.findIndex((name, index) => name === 'time' && index <= 1)\n let next = timeColumn >= 0 ? timeColumn + 1 : Number(header[0] === 'tick')\n const printedColumn = header[next] === 'printed' ? next++ : -1\n const skipped = header.map(\n (name, index) => index < next && (name === 'tick' || name === 'time' || name === 'printed')\n )\n const seen = new Set<string>()\n header.forEach((name, index) => {\n if (!name) throw new TraceFileError(`Column ${index + 1} has no name in the header row.`, rows[0].line)\n if (skipped[index]) return\n if (seen.has(name)) throw new TraceFileError(`The header names ${name} twice.`, rows[0].line)\n seen.add(name)\n })\n const list = new VariableList()\n header.forEach((name, index) => {\n if (!skipped[index]) list.add(name)\n })\n const ticks = rows.slice(1).map(({ cells, quoted, line }) => {\n if (cells.length > header.length) {\n throw new TraceFileError(`The row has ${cells.length} cells, the header ${header.length}.`, line)\n }\n const tick: Record<string, unknown> = {}\n header.forEach((name, index) => {\n const cell = cells[index]\n if (skipped[index] || cell === undefined) return\n if (quoted[index] && cell === '') tick[name] = ''\n else if (cell.trim() !== '') tick[name] = decodeText(cell)\n })\n return tick\n })\n ticks.forEach((tick) =>\n Object.entries(tick).forEach(([name, value]) => list.add(name, undefined, typeOfValue(value)))\n )\n const times =\n timeColumn < 0 || hasDelta\n ? undefined\n : givenTimes(\n rows.slice(1).map(({ cells }) => {\n const cell = cells[timeColumn]?.trim()\n return cell ? Number(cell) : undefined\n }),\n list.variables,\n (index) => `Line ${rows[index + 1].line}: the row`\n )\n const printed =\n printedColumn < 0\n ? undefined\n : printedOf(\n rows.slice(1).map(({ cells, quoted }) => {\n const cell = cells[printedColumn] ?? ''\n return cell === '' && !quoted[printedColumn] ? [] : cell.split(/\\r?\\n/)\n })\n )\n return { variables: list.variables, ticks: carryForward(ticks, list.variables), times, printed }\n}\n"]}
@@ -0,0 +1,2 @@
1
+ /** Give unset strings an editable value without sending a default to the running model. */
2
+ export declare function inputValue(value: unknown, type?: string): unknown;
@@ -0,0 +1,26 @@
1
+ /*
2
+ * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient
3
+ *
4
+ * http://rtsys.informatik.uni-kiel.de/kieler
5
+ *
6
+ * Copyright 2026 by
7
+ * + Kiel University
8
+ * + Department of Computer Science
9
+ * + Real-Time and Embedded Systems Group
10
+ *
11
+ * This program and the accompanying materials are made available under the
12
+ * terms of the Eclipse Public License 2.0 which is available at
13
+ * http://www.eclipse.org/legal/epl-2.0.
14
+ *
15
+ * SPDX-License-Identifier: EPL-2.0
16
+ */
17
+ // The part of keith-vscode's simulation/data-pool.ts that replaying uses.
18
+ /** Give unset strings an editable value without sending a default to the running model. */
19
+ export function inputValue(value, type) {
20
+ if (type !== 'string')
21
+ return value;
22
+ if (Array.isArray(value))
23
+ return value.map((entry) => inputValue(entry, type));
24
+ return value ?? '';
25
+ }
26
+ //# sourceMappingURL=data-pool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-pool.js","sourceRoot":"","sources":["../src/data-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,0EAA0E;AAE1E,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,IAAa;IACpD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;IAC9E,OAAO,KAAK,IAAI,EAAE,CAAA;AACtB,CAAC","sourcesContent":["/*\n * KIELER - Kiel Integrated Environment for Layout Eclipse RichClient\n *\n * http://rtsys.informatik.uni-kiel.de/kieler\n *\n * Copyright 2026 by\n * + Kiel University\n * + Department of Computer Science\n * + Real-Time and Embedded Systems Group\n *\n * This program and the accompanying materials are made available under the\n * terms of the Eclipse Public License 2.0 which is available at\n * http://www.eclipse.org/legal/epl-2.0.\n *\n * SPDX-License-Identifier: EPL-2.0\n */\n\n// The part of keith-vscode's simulation/data-pool.ts that replaying uses.\n\n/** Give unset strings an editable value without sending a default to the running model. */\nexport function inputValue(value: unknown, type?: string): unknown {\n if (type !== 'string') return value\n if (Array.isArray(value)) return value.map((entry) => inputValue(entry, type))\n return value ?? ''\n}\n"]}