@niscorp/nova 0.5.2 → 0.6.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 (180) hide show
  1. package/ACTION_DOCS.md +17 -10
  2. package/ADAPTER.md +22 -2
  3. package/CHANGELOG.md +116 -0
  4. package/DESIGN.md +36 -17
  5. package/I18N_DOCS.md +8 -3
  6. package/LAYOUT_DOCS.md +16 -4
  7. package/REACT_DOCS.md +3 -3
  8. package/README.md +22 -7
  9. package/SHELL_DOCS.md +10 -6
  10. package/dist/adapters/dom/components/index.cjs +46 -63
  11. package/dist/adapters/dom/components/index.cjs.map +1 -1
  12. package/dist/adapters/dom/components/index.d.cts +2 -2
  13. package/dist/adapters/dom/components/index.d.ts +2 -2
  14. package/dist/adapters/dom/components/index.js +11 -28
  15. package/dist/adapters/dom/components/index.js.map +1 -1
  16. package/dist/adapters/dom/index.cjs +10 -9
  17. package/dist/adapters/dom/index.d.cts +2 -2
  18. package/dist/adapters/dom/index.d.ts +2 -2
  19. package/dist/adapters/dom/index.js +8 -7
  20. package/dist/adapters/dom/server.cjs +9 -8
  21. package/dist/adapters/dom/server.cjs.map +1 -1
  22. package/dist/adapters/dom/server.d.cts +2 -2
  23. package/dist/adapters/dom/server.d.ts +2 -2
  24. package/dist/adapters/dom/server.js +8 -7
  25. package/dist/adapters/dom/server.js.map +1 -1
  26. package/dist/adapters/ink/index.js +49 -6
  27. package/dist/adapters/ink/index.js.map +1 -1
  28. package/dist/adapters/react/components/index.cjs +28 -27
  29. package/dist/adapters/react/components/index.d.cts +4 -4
  30. package/dist/adapters/react/components/index.d.ts +4 -4
  31. package/dist/adapters/react/components/index.js +9 -8
  32. package/dist/adapters/react/index.cjs +31 -30
  33. package/dist/adapters/react/index.d.cts +4 -4
  34. package/dist/adapters/react/index.d.ts +4 -4
  35. package/dist/adapters/react/index.js +9 -8
  36. package/dist/adapters/tty/components/index.cjs +35 -40
  37. package/dist/adapters/tty/components/index.cjs.map +1 -1
  38. package/dist/adapters/tty/components/index.d.cts +3 -2
  39. package/dist/adapters/tty/components/index.d.ts +3 -2
  40. package/dist/adapters/tty/components/index.js +6 -22
  41. package/dist/adapters/tty/components/index.js.map +1 -1
  42. package/dist/adapters/tty/index.cjs +11 -10
  43. package/dist/adapters/tty/index.cjs.map +1 -1
  44. package/dist/adapters/tty/index.d.cts +2 -2
  45. package/dist/adapters/tty/index.d.ts +2 -2
  46. package/dist/adapters/tty/index.js +9 -8
  47. package/dist/adapters/tty/index.js.map +1 -1
  48. package/dist/adapters/vue/components/index.cjs +28 -27
  49. package/dist/adapters/vue/components/index.d.cts +15 -12
  50. package/dist/adapters/vue/components/index.d.ts +15 -12
  51. package/dist/adapters/vue/components/index.js +9 -8
  52. package/dist/adapters/vue/index.cjs +37 -36
  53. package/dist/adapters/vue/index.cjs.map +1 -1
  54. package/dist/adapters/vue/index.d.cts +4 -4
  55. package/dist/adapters/vue/index.d.ts +4 -4
  56. package/dist/adapters/vue/index.js +10 -9
  57. package/dist/adapters/vue/index.js.map +1 -1
  58. package/dist/agent/index.d.cts +2 -2
  59. package/dist/agent/index.d.ts +2 -2
  60. package/dist/{chunk-57PZEPIK.js → chunk-2USXK2G4.js} +30 -9
  61. package/dist/chunk-2USXK2G4.js.map +1 -0
  62. package/dist/{chunk-RVU6YEHO.cjs → chunk-3TBQ2KGZ.cjs} +12 -12
  63. package/dist/chunk-3TBQ2KGZ.cjs.map +1 -0
  64. package/dist/{chunk-ZR54IVVS.cjs → chunk-67LZ6PTU.cjs} +21 -21
  65. package/dist/chunk-67LZ6PTU.cjs.map +1 -0
  66. package/dist/{chunk-QTJ4ZQRM.cjs → chunk-7BRC4PL4.cjs} +4 -3
  67. package/dist/chunk-7BRC4PL4.cjs.map +1 -0
  68. package/dist/{chunk-M2ZZUSH3.js → chunk-AXRTJAXB.js} +8 -8
  69. package/dist/chunk-AXRTJAXB.js.map +1 -0
  70. package/dist/chunk-BA77UJOE.cjs +21 -0
  71. package/dist/chunk-BA77UJOE.cjs.map +1 -0
  72. package/dist/{chunk-OY7SCFTJ.js → chunk-BRJ333QF.js} +138 -70
  73. package/dist/chunk-BRJ333QF.js.map +1 -0
  74. package/dist/{chunk-5T26T2EJ.cjs → chunk-F2DZ4JMO.cjs} +34 -14
  75. package/dist/chunk-F2DZ4JMO.cjs.map +1 -0
  76. package/dist/{chunk-A4GK3PLP.js → chunk-F2OEWTK6.js} +5 -5
  77. package/dist/chunk-F2OEWTK6.js.map +1 -0
  78. package/dist/chunk-GAWBA53C.js +20 -0
  79. package/dist/chunk-GAWBA53C.js.map +1 -0
  80. package/dist/{chunk-UIWTFU3M.cjs → chunk-J4HGCXLB.cjs} +49 -28
  81. package/dist/chunk-J4HGCXLB.cjs.map +1 -0
  82. package/dist/chunk-JAVBIVKK.js +27 -0
  83. package/dist/chunk-JAVBIVKK.js.map +1 -0
  84. package/dist/{chunk-VDB7VHFS.cjs → chunk-L63PCZNQ.cjs} +75 -60
  85. package/dist/chunk-L63PCZNQ.cjs.map +1 -0
  86. package/dist/{chunk-ITSVPZS5.cjs → chunk-LFKF2PMZ.cjs} +53 -29
  87. package/dist/chunk-LFKF2PMZ.cjs.map +1 -0
  88. package/dist/chunk-LMCCIFCH.js +15 -0
  89. package/dist/chunk-LMCCIFCH.js.map +1 -0
  90. package/dist/{chunk-E2PXYR3H.js → chunk-OT5M3N76.js} +43 -28
  91. package/dist/chunk-OT5M3N76.js.map +1 -0
  92. package/dist/{chunk-OWA5Z3WT.cjs → chunk-OWUKAB6M.cjs} +212 -144
  93. package/dist/chunk-OWUKAB6M.cjs.map +1 -0
  94. package/dist/{chunk-BML7HQPE.cjs → chunk-P6J3V26J.cjs} +7 -7
  95. package/dist/{chunk-BML7HQPE.cjs.map → chunk-P6J3V26J.cjs.map} +1 -1
  96. package/dist/{chunk-C63CBYD5.js → chunk-QERVED37.js} +4 -3
  97. package/dist/chunk-QERVED37.js.map +1 -0
  98. package/dist/{chunk-3XZODV7S.cjs → chunk-SB3MKJH2.cjs} +10 -7
  99. package/dist/chunk-SB3MKJH2.cjs.map +1 -0
  100. package/dist/{chunk-T33VE5XQ.js → chunk-SVL6SPO6.js} +28 -8
  101. package/dist/chunk-SVL6SPO6.js.map +1 -0
  102. package/dist/chunk-SYKWLQJZ.cjs +22 -0
  103. package/dist/chunk-SYKWLQJZ.cjs.map +1 -0
  104. package/dist/{chunk-G4OQ4PEO.js → chunk-WDTSKRH5.js} +19 -10
  105. package/dist/chunk-WDTSKRH5.js.map +1 -0
  106. package/dist/{chunk-CQZH3L3W.cjs → chunk-XBTAEOKJ.cjs} +51 -40
  107. package/dist/chunk-XBTAEOKJ.cjs.map +1 -0
  108. package/dist/{chunk-LAVCNLL3.js → chunk-Y4EE5XF3.js} +33 -9
  109. package/dist/chunk-Y4EE5XF3.js.map +1 -0
  110. package/dist/chunk-Y6DTXVKS.cjs +32 -0
  111. package/dist/chunk-Y6DTXVKS.cjs.map +1 -0
  112. package/dist/{chunk-GY3KNTNK.js → chunk-Y6UT7WA3.js} +3 -3
  113. package/dist/{chunk-GY3KNTNK.js.map → chunk-Y6UT7WA3.js.map} +1 -1
  114. package/dist/{chunk-6VHOMWNF.js → chunk-YMXFBHWZ.js} +8 -5
  115. package/dist/chunk-YMXFBHWZ.js.map +1 -0
  116. package/dist/devtools/index.cjs +8 -8
  117. package/dist/devtools/index.d.cts +2 -2
  118. package/dist/devtools/index.d.ts +2 -2
  119. package/dist/devtools/index.js +5 -5
  120. package/dist/document/index.cjs +4 -3
  121. package/dist/document/index.d.cts +4 -4
  122. package/dist/document/index.d.ts +4 -4
  123. package/dist/document/index.js +2 -1
  124. package/dist/examples/index.cjs +4 -4
  125. package/dist/examples/index.d.cts +2 -2
  126. package/dist/examples/index.d.ts +2 -2
  127. package/dist/examples/index.js +3 -3
  128. package/dist/{head-zznJvVEE.d.cts → head-HDTpptl2.d.cts} +2 -2
  129. package/dist/{head-CVjtToF8.d.ts → head-R4Jx_OVM.d.ts} +2 -2
  130. package/dist/i18n/index.cjs +13 -13
  131. package/dist/i18n/index.d.cts +2 -2
  132. package/dist/i18n/index.d.ts +2 -2
  133. package/dist/i18n/index.js +3 -3
  134. package/dist/index.cjs +69 -69
  135. package/dist/index.d.cts +6 -6
  136. package/dist/index.d.ts +6 -6
  137. package/dist/index.js +6 -6
  138. package/dist/migrations/index.cjs +4 -4
  139. package/dist/migrations/index.js +2 -2
  140. package/dist/{palette-CCxWSi3C.d.cts → palette-BTn4IRXK.d.cts} +1 -1
  141. package/dist/{palette-BZujb2rm.d.ts → palette-BmDclrlr.d.ts} +1 -1
  142. package/dist/{primitive-props-Cl5jiC8g.d.ts → primitive-props-BI8aHvma.d.cts} +1 -0
  143. package/dist/{primitive-props-Cl5jiC8g.d.cts → primitive-props-BI8aHvma.d.ts} +1 -0
  144. package/dist/reflect/index.cjs +23 -23
  145. package/dist/reflect/index.d.cts +2 -2
  146. package/dist/reflect/index.d.ts +2 -2
  147. package/dist/reflect/index.js +5 -5
  148. package/dist/{types-CJC8mnzl.d.ts → types-B5-GtEik.d.ts} +2 -0
  149. package/dist/{types-DOm2MKDk.d.ts → types-BEbjstbo.d.ts} +2 -1
  150. package/dist/{types-DzB3TAQj.d.cts → types-BLESXdu0.d.cts} +1 -1
  151. package/dist/{types-CWOom_fv.d.cts → types-C8OoE1EM.d.cts} +2 -1
  152. package/dist/{types-pbBIUNxw.d.ts → types-CbKiEDDH.d.ts} +1 -1
  153. package/dist/{types-D0x56Ya-.d.cts → types-CmIg-D2q.d.cts} +1 -1
  154. package/dist/{types-LXw2RJfH.d.ts → types-Lld1eifz.d.ts} +1 -1
  155. package/dist/{types-CR56luN7.d.cts → types-Wze4IlEM.d.cts} +2 -0
  156. package/package.json +7 -7
  157. package/dist/chunk-3XZODV7S.cjs.map +0 -1
  158. package/dist/chunk-57PZEPIK.js.map +0 -1
  159. package/dist/chunk-5T26T2EJ.cjs.map +0 -1
  160. package/dist/chunk-6VHOMWNF.js.map +0 -1
  161. package/dist/chunk-A4GK3PLP.js.map +0 -1
  162. package/dist/chunk-C63CBYD5.js.map +0 -1
  163. package/dist/chunk-CQZH3L3W.cjs.map +0 -1
  164. package/dist/chunk-E2PXYR3H.js.map +0 -1
  165. package/dist/chunk-G4OQ4PEO.js.map +0 -1
  166. package/dist/chunk-GQVJ5UAS.js +0 -8
  167. package/dist/chunk-GQVJ5UAS.js.map +0 -1
  168. package/dist/chunk-ITGR7P2B.cjs +0 -12
  169. package/dist/chunk-ITGR7P2B.cjs.map +0 -1
  170. package/dist/chunk-ITSVPZS5.cjs.map +0 -1
  171. package/dist/chunk-LAVCNLL3.js.map +0 -1
  172. package/dist/chunk-M2ZZUSH3.js.map +0 -1
  173. package/dist/chunk-OWA5Z3WT.cjs.map +0 -1
  174. package/dist/chunk-OY7SCFTJ.js.map +0 -1
  175. package/dist/chunk-QTJ4ZQRM.cjs.map +0 -1
  176. package/dist/chunk-RVU6YEHO.cjs.map +0 -1
  177. package/dist/chunk-T33VE5XQ.js.map +0 -1
  178. package/dist/chunk-UIWTFU3M.cjs.map +0 -1
  179. package/dist/chunk-VDB7VHFS.cjs.map +0 -1
  180. package/dist/chunk-ZR54IVVS.cjs.map +0 -1
@@ -1,8 +1,8 @@
1
- import { ACTION_SLOT_NAME, isHeadNode, CANVAS_SLOT_NAME } from './chunk-C63CBYD5.js';
2
- import { mountInputKeys, createLayoutStore, composeAction, renderLayoutFromStore, resolve, createScopeChain, isMutationStep } from './chunk-E2PXYR3H.js';
3
- import { UnknownFragmentError, ActionDefinitionSchema, DefinitionValidationError, ActionFragmentSchema, StepSchema, UnknownActionError, NovaError, ErrorCodes, applyMutations, ShellDisposedError, LifecycleError, UnknownFunctionError, setPath } from './chunk-G4OQ4PEO.js';
4
- import { isArray, isObject, hasKey } from './chunk-GQVJ5UAS.js';
1
+ import { ACTION_SLOT_NAME, isHeadNode, CANVAS_SLOT_NAME } from './chunk-QERVED37.js';
2
+ import { mountInputKeys, createLayoutStore, composeAction, renderLayoutFromStore, resolve, createScopeChain, isMutationStep } from './chunk-OT5M3N76.js';
3
+ import { UnknownFragmentError, ActionDefinitionSchema, DefinitionValidationError, ActionFragmentSchema, StepSchema, reportWithoutThrowing, toHandlerFailed, UnknownActionError, NovaError, ErrorCodes, applyMutations, ShellDisposedError, LifecycleError, UnknownFunctionError, setPath } from './chunk-WDTSKRH5.js';
5
4
  import { createComponentRegistry } from './chunk-SVWDKXSH.js';
5
+ import { ownEntry, isArray, isObject, hasKey } from './chunk-LMCCIFCH.js';
6
6
  import { z } from 'zod';
7
7
  import { exceedsDepth, depthRefusal } from '@niscorp/strata';
8
8
 
@@ -63,14 +63,15 @@ var typeMatches = (matcher, type) => {
63
63
  if (typeof matcher === "string") return matcher === type;
64
64
  return matcher.test(type);
65
65
  };
66
- var createChildBus = (parent) => {
66
+ var createChildBus = (parent, config) => {
67
67
  const subscriptions = [];
68
68
  const emit = (event) => {
69
69
  for (const sub of subscriptions.slice()) {
70
70
  if (!typeMatches(sub.matcher, event.type)) continue;
71
71
  try {
72
72
  sub.handler(event);
73
- } catch {
73
+ } catch (err) {
74
+ config.onHandlerError?.(err);
74
75
  }
75
76
  }
76
77
  if (parent !== void 0) parent.emit(event);
@@ -94,11 +95,11 @@ var createChildBus = (parent) => {
94
95
  emit,
95
96
  on,
96
97
  once,
97
- scoped: () => createChildBus(bus)
98
+ scoped: () => createChildBus(bus, config)
98
99
  };
99
100
  return bus;
100
101
  };
101
- var createEventBus = () => createChildBus(void 0);
102
+ var createEventBus = (config = {}) => createChildBus(void 0, config);
102
103
  var MessageEnvelopeSchema = z.object({
103
104
  channel: z.string().describe("Channel name the message is published on."),
104
105
  from: z.string().optional().describe("Optional sender identifier."),
@@ -107,7 +108,7 @@ var MessageEnvelopeSchema = z.object({
107
108
  }).strict().describe("A message envelope passed through the message bus.");
108
109
 
109
110
  // src/shared/message-bus/message-bus.ts
110
- var createMessageBus = () => {
111
+ var createMessageBus = (config = {}) => {
111
112
  const handlers = /* @__PURE__ */ new Map();
112
113
  const dispatch = (channel, payload, from, cause) => {
113
114
  const list = handlers.get(channel);
@@ -115,7 +116,8 @@ var createMessageBus = () => {
115
116
  for (const handler of list.slice()) {
116
117
  try {
117
118
  handler(payload, from, cause);
118
- } catch {
119
+ } catch (err) {
120
+ config.onHandlerError?.(err);
119
121
  }
120
122
  }
121
123
  };
@@ -274,7 +276,7 @@ var createNavigationHandler = (ops) => {
274
276
  };
275
277
 
276
278
  // src/shared/data-store/data-store.ts
277
- var createDataStore = (initial) => {
279
+ var createDataStore = (initial, config = {}) => {
278
280
  let current = { ...initial };
279
281
  const subscribers = [];
280
282
  const get = () => current;
@@ -283,7 +285,8 @@ var createDataStore = (initial) => {
283
285
  for (const handler of subscribers.slice()) {
284
286
  try {
285
287
  handler(current);
286
- } catch {
288
+ } catch (err) {
289
+ config.onHandlerError?.(err);
287
290
  }
288
291
  }
289
292
  };
@@ -318,12 +321,20 @@ var resolveHeaders = (headers, chain) => {
318
321
  var defaultFetch = () => {
319
322
  throw new Error("No fetch implementation provided to action runtime");
320
323
  };
324
+ var cloneOf = (response) => {
325
+ try {
326
+ return response.clone?.();
327
+ } catch {
328
+ return void 0;
329
+ }
330
+ };
321
331
  var tryParseJson = async (response) => {
332
+ const copy = cloneOf(response);
322
333
  try {
323
334
  return await response.json();
324
335
  } catch {
325
336
  try {
326
- return await response.text();
337
+ return await (copy ?? response).text();
327
338
  } catch {
328
339
  return void 0;
329
340
  }
@@ -431,7 +442,7 @@ var callFunctionEndpoint = async (endpoint, { data, signal, functions }) => {
431
442
  if (signal === void 0) {
432
443
  throw new Error("callEndpoint: function variant requires an AbortSignal");
433
444
  }
434
- const handler = functions?.[endpoint.fn];
445
+ const handler = ownEntry(functions, endpoint.fn);
435
446
  if (handler === void 0) {
436
447
  throw new Error(`callEndpoint: function "${endpoint.fn}" is not registered`);
437
448
  }
@@ -515,6 +526,10 @@ var nextTask = (task) => {
515
526
  var now = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
516
527
  var noopOnError = (_error) => {
517
528
  };
529
+ var resolveIndex = (template, chain, extras) => {
530
+ const index = Number(resolve(template, chain, extras));
531
+ return Number.isInteger(index) ? index : String(index);
532
+ };
518
533
  var resolveMutationValues = (list, chain, extras) => {
519
534
  return list.map((m) => {
520
535
  if ("set" in m && "value" in m) {
@@ -524,18 +539,27 @@ var resolveMutationValues = (list, chain, extras) => {
524
539
  return { ...m, value: resolve(m.value, chain, extras) };
525
540
  }
526
541
  if ("removeAt" in m && typeof m.index === "string") {
527
- return { ...m, index: Number(resolve(m.index, chain, extras)) };
542
+ return { ...m, index: resolveIndex(m.index, chain, extras) };
528
543
  }
529
544
  if ("move" in m) {
530
545
  return {
531
546
  ...m,
532
- from: typeof m.from === "string" ? Number(resolve(m.from, chain, extras)) : m.from,
533
- to: typeof m.to === "string" ? Number(resolve(m.to, chain, extras)) : m.to
547
+ from: typeof m.from === "string" ? resolveIndex(m.from, chain, extras) : m.from,
548
+ to: typeof m.to === "string" ? resolveIndex(m.to, chain, extras) : m.to
534
549
  };
535
550
  }
536
551
  return m;
537
552
  });
538
553
  };
554
+ var reportTemplatedNegativeRemoveAt = (written, resolved, onError) => {
555
+ written.forEach((m, at) => {
556
+ const r = resolved[at];
557
+ if (!("removeAt" in m) || typeof m.index !== "string" || r === void 0 || !("removeAt" in r)) return;
558
+ if (typeof r.index !== "number" || r.index >= 0) return;
559
+ const message = `removeAt: index ${m.index} resolved to ${r.index}, which counts from the end (-1 removes the last element)`;
560
+ reportWithoutThrowing(onError, new NovaError(ErrorCodes.mutation, message, { path: m.removeAt, index: r.index, template: m.index }));
561
+ });
562
+ };
539
563
  var writeTarget = (dataStore, target, value) => {
540
564
  if (target === void 0) return;
541
565
  dataStore.update((curr) => {
@@ -556,9 +580,10 @@ var raiseUnknown = async (message, onError, ctx, strictError) => {
556
580
  throw new LifecycleError(message, { hook: ctx.lifecycleHook });
557
581
  }
558
582
  if (ctx.strict && strictError !== void 0) throw strictError;
583
+ if (ctx.strict) reportWithoutThrowing(ctx.onError, new NovaError(ErrorCodes.endpointFailed, message, {}));
559
584
  };
560
585
  var runCall = async (callName, onSuccess, onError, ctx) => {
561
- const raw = ctx.endpoints[callName];
586
+ const raw = ownEntry(ctx.endpoints, callName);
562
587
  if (raw === void 0) {
563
588
  await raiseUnknown(`unknown endpoint: ${callName}`, onError, ctx);
564
589
  return;
@@ -568,7 +593,7 @@ var runCall = async (callName, onSuccess, onError, ctx) => {
568
593
  const chain = createScopeChain(ctx.dataStore.get());
569
594
  const fn = String(resolve(raw.fn, chain, ctx.extras) ?? "");
570
595
  endpoint = { ...raw, fn };
571
- if (ctx.functions[fn] === void 0) {
596
+ if (ownEntry(ctx.functions, fn) === void 0) {
572
597
  await raiseUnknown(`unknown function: ${fn}`, onError, ctx, new UnknownFunctionError(fn));
573
598
  return;
574
599
  }
@@ -606,7 +631,8 @@ var runCall = async (callName, onSuccess, onError, ctx) => {
606
631
  if (onSuccess) await executeSteps(onSuccess, ctx);
607
632
  return;
608
633
  }
609
- writeTarget(ctx.dataStore, endpoint.errorTarget, result.error);
634
+ const isSuperseded = ticket !== void 0 && ctx.calls !== void 0 && ctx.calls.isSuperseded(callName, ticket);
635
+ if (!isSuperseded) writeTarget(ctx.dataStore, endpoint.errorTarget, result.error);
610
636
  if (onError) {
611
637
  const errorExtras = { ...ctx.extras, "@error": result.error };
612
638
  await executeSteps(onError, { ...ctx, extras: errorExtras });
@@ -617,6 +643,9 @@ var runCall = async (callName, onSuccess, onError, ctx) => {
617
643
  hook: ctx.lifecycleHook
618
644
  });
619
645
  }
646
+ if (ctx.strict && endpoint.errorTarget === void 0) {
647
+ reportWithoutThrowing(ctx.onError, new NovaError(ErrorCodes.endpointFailed, `endpoint '${callName}' failed: ${result.error.message}`, { endpoint: callName, status: result.error.status }));
648
+ }
620
649
  };
621
650
  var navigate = (effect, ctx) => {
622
651
  const { onNavigate } = ctx;
@@ -669,6 +698,7 @@ var executeSteps = async (steps, ctx) => {
669
698
  buffer = [];
670
699
  const chain = createScopeChain(ctx.dataStore.get());
671
700
  const resolved = resolveMutationValues(list, chain, ctx.extras);
701
+ reportTemplatedNegativeRemoveAt(list, resolved, ctx.onError);
672
702
  ctx.dataStore.update(
673
703
  (curr) => applyMutations(curr, resolved, { ...ctx.initial === void 0 ? {} : { initial: ctx.initial }, strict: ctx.strict })
674
704
  );
@@ -785,7 +815,7 @@ var runLifecycleHook = async (hook, definition, buildContext) => {
785
815
  var walk = (node, out) => {
786
816
  if (node.type === "component") {
787
817
  if (node.model !== void 0) {
788
- out.push({ ref: node.model.ref, path: node.model.path });
818
+ out.push({ ref: node.model.ref, path: node.model.path, ...node.ref === void 0 ? {} : { fieldRef: node.ref } });
789
819
  }
790
820
  for (const child of node.children) walk(child, out);
791
821
  return;
@@ -858,7 +888,7 @@ var eventOrigin = (event) => {
858
888
  const candidate = event["origin"];
859
889
  return typeof candidate === "string" ? candidate : void 0;
860
890
  };
861
- var attachTriggers = (triggers, eventBus, messageBus, buildContext, ownInstanceId) => {
891
+ var attachTriggers = (triggers, eventBus, messageBus, buildContext, ownInstanceId, fieldRefOf = (ref) => ref) => {
862
892
  const unsubscribes = [];
863
893
  for (const trigger of triggers) {
864
894
  if (trigger.event !== void 0) {
@@ -868,9 +898,11 @@ var attachTriggers = (triggers, eventBus, messageBus, buildContext, ownInstanceI
868
898
  const off = eventBus.on(triggerType, (event) => {
869
899
  const origin = eventOrigin(event);
870
900
  if (origin !== void 0 && origin !== ownInstanceId) return;
871
- if (expectedRef !== void 0 && eventRef(event) !== expectedRef) return;
901
+ const ref = eventRef(event);
902
+ const fieldRef = ref === void 0 ? void 0 : fieldRefOf(ref);
903
+ if (expectedRef !== void 0 && fieldRef !== expectedRef) return;
872
904
  if (expectedKey !== void 0 && eventKey(event) !== expectedKey) return;
873
- fireTrigger(trigger, buildContext, event, rootCause());
905
+ fireTrigger(trigger, buildContext, fieldRef === ref ? event : { ...event, ref: fieldRef }, rootCause());
874
906
  });
875
907
  unsubscribes.push(off);
876
908
  continue;
@@ -894,10 +926,13 @@ var createActionRuntime = (config) => {
894
926
  const definition = config.definition;
895
927
  const initialData = buildInitialData(definition, config.input);
896
928
  const initialSnapshot = structuredClone(initialData);
897
- const dataStore = createDataStore(initialData);
898
- const abortController = new AbortController();
899
929
  const strict = config.strict ?? false;
900
930
  const onError = config.onError ?? noopOnError;
931
+ const onHandlerError = (err) => {
932
+ if (strict) reportWithoutThrowing(onError, toHandlerFailed(err));
933
+ };
934
+ const dataStore = createDataStore(initialData, { onHandlerError });
935
+ const abortController = new AbortController();
901
936
  const instanceIdFn = config.instanceIdFn ?? defaultInstanceIdFactory;
902
937
  const instance = {
903
938
  id: config.instanceId ?? instanceIdFn(),
@@ -910,6 +945,7 @@ var createActionRuntime = (config) => {
910
945
  let triggerHandle;
911
946
  let modelWriteOff;
912
947
  const modelPaths = /* @__PURE__ */ new Map();
948
+ const fieldRefs = /* @__PURE__ */ new Map();
913
949
  dataStore.subscribe((next) => {
914
950
  instance.data = next;
915
951
  });
@@ -943,7 +979,8 @@ var createActionRuntime = (config) => {
943
979
  }
944
980
  entry.stop?.();
945
981
  entry.stop = stop;
946
- }
982
+ },
983
+ isSuperseded: (endpoint, ticket) => ticket < entryOf(endpoint).landed
947
984
  };
948
985
  const stopFollowing = () => {
949
986
  for (const entry of ledger.values()) {
@@ -1010,7 +1047,8 @@ var createActionRuntime = (config) => {
1010
1047
  for (const handler of statusSubscribers.slice()) {
1011
1048
  try {
1012
1049
  handler(next);
1013
- } catch {
1050
+ } catch (err) {
1051
+ onHandlerError(err);
1014
1052
  }
1015
1053
  }
1016
1054
  };
@@ -1030,7 +1068,7 @@ var createActionRuntime = (config) => {
1030
1068
  if (triggerHandle !== void 0) return;
1031
1069
  const triggers = definition.triggers;
1032
1070
  if (triggers === void 0 || triggers.length === 0) return;
1033
- triggerHandle = attachTriggers(triggers, config.eventBus, config.messageBus, buildContext, instance.id);
1071
+ triggerHandle = attachTriggers(triggers, config.eventBus, config.messageBus, buildContext, instance.id, (ref) => fieldRefs.get(ref) ?? ref);
1034
1072
  };
1035
1073
  const detach = () => {
1036
1074
  if (modelWriteOff !== void 0) {
@@ -1083,7 +1121,9 @@ var createActionRuntime = (config) => {
1083
1121
  }
1084
1122
  if (instance.status === "initializing") setStatus("active");
1085
1123
  };
1124
+ let moves = 0;
1086
1125
  const unmount = async () => {
1126
+ moves += 1;
1087
1127
  abortController.abort();
1088
1128
  stopFollowing();
1089
1129
  detach();
@@ -1097,17 +1137,26 @@ var createActionRuntime = (config) => {
1097
1137
  setStatus("unmounted");
1098
1138
  };
1099
1139
  const suspend = async () => {
1140
+ moves += 1;
1141
+ const mine = moves;
1100
1142
  await runLifecycleHook("suspend", definition, buildContext);
1101
- setStatus("suspended");
1143
+ if (moves === mine) setStatus("suspended");
1102
1144
  };
1103
1145
  const resume = async () => {
1146
+ moves += 1;
1104
1147
  setStatus("active");
1105
1148
  await runLifecycleHook("mount", definition, buildContext);
1106
1149
  await runLifecycleHook("resume", definition, buildContext);
1107
1150
  };
1108
1151
  const reconcileModelBindings = (nodes) => {
1109
1152
  modelPaths.clear();
1110
- for (const b of collectModelBindings(nodes)) modelPaths.set(b.ref, b.path);
1153
+ fieldRefs.clear();
1154
+ for (const b of collectModelBindings(nodes)) {
1155
+ modelPaths.set(b.ref, b.path);
1156
+ if (b.fieldRef === void 0 || b.fieldRef === b.ref) continue;
1157
+ modelPaths.set(b.fieldRef, b.path);
1158
+ fieldRefs.set(b.ref, b.fieldRef);
1159
+ }
1111
1160
  };
1112
1161
  const render = () => {
1113
1162
  const language = config.i18n?.();
@@ -1201,6 +1250,22 @@ var refuseSharedId = (id) => {
1201
1250
  failures: [{ id, issues: [{ code: "custom", path: [], message: "an id names an action or a fragment, never both", input: void 0 }] }]
1202
1251
  });
1203
1252
  };
1253
+ var misfiledDefinitions = (definitions) => {
1254
+ const failures = Object.entries(definitions).filter(([key, def]) => def.id !== key).map(([key, def]) => ({
1255
+ id: key,
1256
+ issues: [{ code: "custom", path: ["id"], message: `keyed "${key}" but its id is "${def.id}": key the map by the id`, input: def.id }]
1257
+ }));
1258
+ if (failures.length === 0) return void 0;
1259
+ return new DefinitionValidationError(`${failures.length} definition(s) keyed by something other than their id`, { failures });
1260
+ };
1261
+ var getEndpointsWithBody = (definitions) => {
1262
+ const failures = Object.entries(definitions).flatMap(([key, def]) => {
1263
+ const issues = Object.entries(def.endpoints ?? {}).filter(([, endpoint]) => "method" in endpoint && endpoint.method === "GET" && endpoint.request !== void 0).map(([name]) => ({ code: "custom", path: ["endpoints", name, "request"], message: `endpoint "${name}" is a GET with a request body: fetch sends no body with a GET, so every call fails`, input: void 0 }));
1264
+ return issues.length === 0 ? [] : [{ id: key, issues }];
1265
+ });
1266
+ if (failures.length === 0) return void 0;
1267
+ return new DefinitionValidationError(`${failures.length} definition(s) with a GET endpoint that has a request body`, { failures });
1268
+ };
1204
1269
  var snapshotCanvas = (canvas) => {
1205
1270
  const stack = canvas.stack.slice();
1206
1271
  return {
@@ -1393,14 +1458,15 @@ var createRuntimeRegistry = () => {
1393
1458
  };
1394
1459
 
1395
1460
  // src/shell/telemetry.ts
1396
- var safeCall = (fn, arg) => {
1397
- if (fn === void 0) return;
1398
- try {
1399
- fn(arg);
1400
- } catch {
1401
- }
1402
- };
1403
- var createTelemetry = (config) => {
1461
+ var createTelemetry = (config, { onHandlerError } = {}) => {
1462
+ const safeCall = (fn, arg) => {
1463
+ if (fn === void 0) return;
1464
+ try {
1465
+ fn(arg);
1466
+ } catch (err) {
1467
+ onHandlerError?.(err);
1468
+ }
1469
+ };
1404
1470
  const stateSubscribers = [];
1405
1471
  const dataSubscribers = [];
1406
1472
  const endpointSubscribers = [];
@@ -1453,13 +1519,19 @@ var createShell = (config) => {
1453
1519
  validateFragments(config.fragments ?? {});
1454
1520
  const shared = Object.keys(config.fragments ?? {}).find((fragmentId) => Object.hasOwn(config.actions, fragmentId));
1455
1521
  if (shared !== void 0) refuseSharedId(shared);
1522
+ const misfiled = misfiledDefinitions({ ...config.actions, ...config.fragments });
1523
+ if (misfiled !== void 0) config.onError?.(misfiled);
1524
+ const bodiedGets = getEndpointsWithBody({ ...config.actions, ...config.fragments });
1525
+ if (bodiedGets !== void 0) config.onError?.(bodiedGets);
1456
1526
  const id = (config.shellIdFn ?? defaultShellIdFactory)();
1457
1527
  const instanceIdFn = config.instanceIdFn ?? createIdFactory("act");
1458
1528
  const strict = config.strict ?? false;
1459
- const eventBus = config.eventBus ?? createEventBus();
1460
- const messageBus = config.messageBus ?? createMessageBus();
1529
+ const reportTo = config.onError;
1530
+ const handlerErrors = strict && reportTo !== void 0 ? { onHandlerError: (err) => reportWithoutThrowing(reportTo, toHandlerFailed(err)) } : {};
1531
+ const eventBus = config.eventBus ?? createEventBus(handlerErrors);
1532
+ const messageBus = config.messageBus ?? createMessageBus(handlerErrors);
1461
1533
  const registry = createRuntimeRegistry();
1462
- const telemetry = createTelemetry(config.telemetry);
1534
+ const telemetry = createTelemetry(config.telemetry, handlerErrors);
1463
1535
  const componentRegistry = config.registry ?? createComponentRegistry();
1464
1536
  if (config.components !== void 0) componentRegistry.registerAll(config.components);
1465
1537
  const layoutStore = config.layoutStore ?? createLayoutStore();
@@ -1498,7 +1570,7 @@ var createShell = (config) => {
1498
1570
  });
1499
1571
  const reconcilerOf = (cfg) => {
1500
1572
  if (cfg.reconcile === void 0) return void 0;
1501
- const named = config.reconcilers !== void 0 && Object.hasOwn(config.reconcilers, cfg.reconcile) ? config.reconcilers[cfg.reconcile] : void 0;
1573
+ const named = ownEntry(config.reconcilers, cfg.reconcile);
1502
1574
  if (named !== void 0) return named;
1503
1575
  const message = `canvas "${cfg.id}" names the reconciler "${cfg.reconcile}", which the shell was not given`;
1504
1576
  throw new DefinitionValidationError(message, { failures: [{ id: cfg.id, issues: [{ code: "custom", path: ["reconcile"], message, input: cfg.reconcile }] }] });
@@ -1517,13 +1589,13 @@ var createShell = (config) => {
1517
1589
  for (const cfg of config.canvases) holdCanvas(cfg);
1518
1590
  const canvasOrder = config.canvases.map((cfg) => cfg.id);
1519
1591
  let canvasLayout = config.canvasLayout;
1520
- const definitions = { ...config.actions, ...config.fragments };
1592
+ const definitions = new Map([...Object.entries(config.actions), ...Object.entries(config.fragments ?? {})]);
1521
1593
  const actionOf = (actionId) => {
1522
- const held = definitions[actionId];
1594
+ const held = definitions.get(actionId);
1523
1595
  return held === void 0 || isFragment(held) ? void 0 : held;
1524
1596
  };
1525
1597
  const fragmentOf = (fragmentId) => {
1526
- const held = definitions[fragmentId];
1598
+ const held = definitions.get(fragmentId);
1527
1599
  return held !== void 0 && isFragment(held) ? held : void 0;
1528
1600
  };
1529
1601
  let phrases = config.phrases;
@@ -1571,15 +1643,17 @@ var createShell = (config) => {
1571
1643
  } else {
1572
1644
  validateActions({ [definition.id]: definition });
1573
1645
  }
1574
- const held = Object.hasOwn(definitions, definition.id) ? definitions[definition.id] : void 0;
1646
+ const held = definitions.get(definition.id);
1575
1647
  if (held !== void 0 && isFragment(held) !== isFragment(definition)) refuseSharedId(definition.id);
1576
- definitions[definition.id] = definition;
1648
+ definitions.set(definition.id, definition);
1649
+ const bodiedGets2 = getEndpointsWithBody({ [definition.id]: definition });
1650
+ if (bodiedGets2 !== void 0) config.onError?.(bodiedGets2);
1577
1651
  };
1578
1652
  const removeAction = (actionId) => {
1579
1653
  guard();
1580
- const held = definitions[actionId];
1654
+ const held = definitions.get(actionId);
1581
1655
  if (held === void 0) return;
1582
- delete definitions[actionId];
1656
+ definitions.delete(actionId);
1583
1657
  if (isFragment(held)) return;
1584
1658
  journal.forgetAction(actionId);
1585
1659
  let changed = false;
@@ -1690,13 +1764,21 @@ var createShell = (config) => {
1690
1764
  onEndpoint: (event) => telemetry.fireEndpoint(event),
1691
1765
  onChain: chains.hold
1692
1766
  });
1693
- const spawn = (canvasId, definition, input) => {
1694
- const runtime = buildRuntime(canvasId, definition, input);
1767
+ const spawn = (canvas, actionId, definition, input, fragmentIds, options) => {
1768
+ const runtime = buildRuntime(canvas.id, definition, input);
1695
1769
  const instId = runtime.instance.id;
1696
1770
  registry.register(runtime, (data) => {
1697
1771
  if (disposed) return;
1698
1772
  telemetry.fireDataChange({ instanceId: instId, canvasId: runtime.instance.canvasId, data });
1699
1773
  });
1774
+ canvas.pushInstance(runtime.instance);
1775
+ births.set(instId, {
1776
+ action: actionId,
1777
+ ...input === void 0 ? {} : { input },
1778
+ ...fragmentIds === void 0 ? {} : { with: fragmentIds }
1779
+ });
1780
+ if (options?.origin !== void 0) origins.set(instId, options.origin);
1781
+ if (options?.key !== void 0) keys.set(instId, options.key);
1700
1782
  runtime.mount(input).catch(handleLifecycleRejection);
1701
1783
  return runtime;
1702
1784
  };
@@ -1706,15 +1788,7 @@ var createShell = (config) => {
1706
1788
  const canvas = getCanvas(canvasId);
1707
1789
  const definition = resolveDefinition(actionId, fragmentIds);
1708
1790
  if (!listCanvases.has(canvasId)) ops.suspendTop(canvas);
1709
- const runtime = spawn(canvasId, definition, input);
1710
- canvas.pushInstance(runtime.instance);
1711
- births.set(runtime.instance.id, {
1712
- action: actionId,
1713
- ...input === void 0 ? {} : { input },
1714
- ...fragmentIds === void 0 ? {} : { with: fragmentIds }
1715
- });
1716
- if (options?.origin !== void 0) origins.set(runtime.instance.id, options.origin);
1717
- if (options?.key !== void 0) keys.set(runtime.instance.id, options.key);
1791
+ const runtime = spawn(canvas, actionId, definition, input, fragmentIds, options);
1718
1792
  fireState();
1719
1793
  return runtime.instance.id;
1720
1794
  };
@@ -1790,13 +1864,7 @@ var createShell = (config) => {
1790
1864
  const definition = resolveDefinition(actionId, fragmentIds);
1791
1865
  const old = canvas.popInstance();
1792
1866
  if (old !== void 0) ops.unmountInstance(old.id);
1793
- const runtime = spawn(canvasId, definition, input);
1794
- canvas.pushInstance(runtime.instance);
1795
- births.set(runtime.instance.id, {
1796
- action: actionId,
1797
- ...input === void 0 ? {} : { input },
1798
- ...fragmentIds === void 0 ? {} : { with: fragmentIds }
1799
- });
1867
+ const runtime = spawn(canvas, actionId, definition, input, fragmentIds);
1800
1868
  fireState();
1801
1869
  return runtime.instance.id;
1802
1870
  };
@@ -2116,5 +2184,5 @@ var shellSettled = (shell, options = {}) => shellQuietWithin(shell, () => isMoun
2116
2184
  var shellIdle = (shell, options = {}) => shellQuietWithin(shell, () => isMounting(shell) || chainsInFlight(shell) > 0, options);
2117
2185
 
2118
2186
  export { DEFAULT_HISTORY_DEPTH, DEFAULT_SETTLE_WAIT_MS, MessageEnvelopeSchema, NovaEventSchema, canvasTreeOf, createIdFactory, createShell, hasVisibleContent, navigatedChannel, reconcileCanvas, scopeDispatch, shellIdle, shellSettled, shellView };
2119
- //# sourceMappingURL=chunk-OY7SCFTJ.js.map
2120
- //# sourceMappingURL=chunk-OY7SCFTJ.js.map
2187
+ //# sourceMappingURL=chunk-BRJ333QF.js.map
2188
+ //# sourceMappingURL=chunk-BRJ333QF.js.map