@overkill-dev/engine 0.0.79 → 0.0.81

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 (238) hide show
  1. package/assertion-protocol/assertion-evaluation.d.ts +13 -0
  2. package/assertion-protocol/assertion-evaluation.d.ts.map +1 -0
  3. package/assertion-protocol/assertions/boolean.d.ts +7 -0
  4. package/assertion-protocol/assertions/boolean.d.ts.map +1 -1
  5. package/assertion-protocol/assertions/collection.d.ts +9 -0
  6. package/assertion-protocol/assertions/collection.d.ts.map +1 -1
  7. package/assertion-protocol/assertions/equality.d.ts +11 -0
  8. package/assertion-protocol/assertions/equality.d.ts.map +1 -1
  9. package/assertion-protocol/assertions/fail.d.ts +5 -0
  10. package/assertion-protocol/assertions/fail.d.ts.map +1 -1
  11. package/assertion-protocol/assertions/numeric.d.ts +13 -0
  12. package/assertion-protocol/assertions/numeric.d.ts.map +1 -1
  13. package/assertion-protocol/assertions/partial.d.ts +9 -0
  14. package/assertion-protocol/assertions/partial.d.ts.map +1 -1
  15. package/assertion-protocol/assertions/presence.d.ts +11 -0
  16. package/assertion-protocol/assertions/presence.d.ts.map +1 -1
  17. package/assertion-protocol/assertions/string.d.ts +13 -0
  18. package/assertion-protocol/assertions/string.d.ts.map +1 -1
  19. package/assertion-protocol/assertions/type-shape.d.ts +19 -0
  20. package/assertion-protocol/assertions/type-shape.d.ts.map +1 -1
  21. package/assertion-protocol/partial-matching.js +52 -2
  22. package/assertion-protocol/partial-matching.js.map +1 -1
  23. package/assertion-protocol/source-location-forwarding.d.ts +1 -0
  24. package/assertion-protocol/source-location-forwarding.d.ts.map +1 -1
  25. package/assertion-protocol/source-location.js +1 -1
  26. package/assertion-protocol/source-location.js.map +1 -1
  27. package/assertion-protocol/thrown-matcher.d.ts +2 -1
  28. package/assertion-protocol/thrown-matcher.d.ts.map +1 -1
  29. package/canonical-identity.d.ts +1 -0
  30. package/canonical-identity.d.ts.map +1 -1
  31. package/canonical-identity.js +27 -11
  32. package/canonical-identity.js.map +1 -1
  33. package/compare/comparison-result.d.ts +14 -0
  34. package/compare/comparison-result.d.ts.map +1 -1
  35. package/compare/serialized-value-shape.js +2 -5
  36. package/compare/serialized-value-shape.js.map +1 -1
  37. package/compare/value-classification.d.ts +23 -0
  38. package/compare/value-classification.d.ts.map +1 -1
  39. package/engine/assertion-recorder.d.ts +24 -1
  40. package/engine/assertion-recorder.d.ts.map +1 -1
  41. package/engine/async-leak-diagnostics.d.ts +28 -0
  42. package/engine/async-leak-diagnostics.d.ts.map +1 -0
  43. package/engine/benchmark-attempt.d.ts.map +1 -1
  44. package/engine/benchmark-attempt.js +3 -2
  45. package/engine/benchmark-attempt.js.map +1 -1
  46. package/engine/benchmark-node.d.ts +9 -8
  47. package/engine/benchmark-node.d.ts.map +1 -1
  48. package/engine/benchmark-node.js.map +1 -1
  49. package/engine/body-reference-participants.js +72 -0
  50. package/engine/body-reference-participants.js.map +1 -0
  51. package/engine/body-reference-plan.d.ts +15 -0
  52. package/engine/body-reference-plan.d.ts.map +1 -0
  53. package/engine/body-reference-plan.js +242 -0
  54. package/engine/body-reference-plan.js.map +1 -0
  55. package/engine/body-reference.d.ts +16 -0
  56. package/engine/body-reference.d.ts.map +1 -0
  57. package/engine/body-reference.js +30 -0
  58. package/engine/body-reference.js.map +1 -0
  59. package/engine/case-body-execution.js +6 -1
  60. package/engine/case-body-execution.js.map +1 -1
  61. package/engine/case-body.js +11 -5
  62. package/engine/case-body.js.map +1 -1
  63. package/engine/case-execution.d.ts +1 -1
  64. package/engine/case-execution.d.ts.map +1 -1
  65. package/engine/case-execution.js +8 -2
  66. package/engine/case-execution.js.map +1 -1
  67. package/engine/case-interruption.js.map +1 -1
  68. package/engine/case-policy.js +9 -3
  69. package/engine/case-policy.js.map +1 -1
  70. package/engine/debug-checkpoints.js +43 -0
  71. package/engine/debug-checkpoints.js.map +1 -0
  72. package/engine/execution-async-leak-policy.d.ts +34 -0
  73. package/engine/execution-async-leak-policy.d.ts.map +1 -1
  74. package/engine/execution-error-ownership.d.ts +47 -0
  75. package/engine/execution-error-ownership.d.ts.map +1 -1
  76. package/engine/execution-error-ownership.js.map +1 -1
  77. package/engine/execution-global-error-observer.d.ts.map +1 -1
  78. package/engine/execution-global-error-observer.js +2 -1
  79. package/engine/execution-global-error-observer.js.map +1 -1
  80. package/engine/execution-observation.d.ts +0 -4
  81. package/engine/execution-observation.d.ts.map +1 -1
  82. package/engine/execution-observation.js +10 -46
  83. package/engine/execution-observation.js.map +1 -1
  84. package/engine/execution-options.d.ts +2 -0
  85. package/engine/execution-options.d.ts.map +1 -1
  86. package/engine/execution-preparation.d.ts +18 -2
  87. package/engine/execution-preparation.d.ts.map +1 -1
  88. package/engine/execution-supervision-state.d.ts +3 -0
  89. package/engine/execution-supervision-state.d.ts.map +1 -0
  90. package/engine/execution-supervision-state.js +2 -1
  91. package/engine/execution-supervision-state.js.map +1 -1
  92. package/engine/execution-supervision.d.ts +2 -0
  93. package/engine/execution-supervision.d.ts.map +1 -1
  94. package/engine/execution.d.ts.map +1 -1
  95. package/engine/execution.js +8 -3
  96. package/engine/execution.js.map +1 -1
  97. package/engine/family-lifetime.d.ts +2 -0
  98. package/engine/family-lifetime.d.ts.map +1 -1
  99. package/engine/family-run.d.ts.map +1 -1
  100. package/engine/family-run.js +14 -9
  101. package/engine/family-run.js.map +1 -1
  102. package/engine/native-resource-observation.js +1 -1
  103. package/engine/native-resource-observation.js.map +1 -1
  104. package/engine/plan-collection-policy.d.ts +11 -4
  105. package/engine/plan-collection-policy.d.ts.map +1 -1
  106. package/engine/plan-collection-policy.js +12 -1
  107. package/engine/plan-collection-policy.js.map +1 -1
  108. package/engine/property-inconclusive.d.ts +1 -0
  109. package/engine/property-inconclusive.d.ts.map +1 -1
  110. package/engine/property-plan.d.ts +6 -1
  111. package/engine/property-plan.d.ts.map +1 -1
  112. package/engine/property-plan.js +13 -5
  113. package/engine/property-plan.js.map +1 -1
  114. package/engine/property-trial.d.ts +15 -0
  115. package/engine/property-trial.d.ts.map +1 -1
  116. package/engine/reporter-delivery-preparation.d.ts +18 -1
  117. package/engine/reporter-delivery-preparation.d.ts.map +1 -1
  118. package/engine/reporter-dispatcher.js +1 -1
  119. package/engine/reporter-dispatcher.js.map +1 -1
  120. package/engine/reporter-managed-output.js +3 -3
  121. package/engine/reporter-managed-output.js.map +1 -1
  122. package/engine/reporter-output-scope.js +1 -1
  123. package/engine/reporter-output-scope.js.map +1 -1
  124. package/engine/reporting-context.js +4 -4
  125. package/engine/reporting-context.js.map +1 -1
  126. package/engine/resource-owner-observation.js +1 -1
  127. package/engine/resource-owner-observation.js.map +1 -1
  128. package/engine/run-result.d.ts +5 -0
  129. package/engine/run-result.d.ts.map +1 -1
  130. package/engine/run-result.js +1 -4
  131. package/engine/run-result.js.map +1 -1
  132. package/engine/standard-engine.d.ts +1 -0
  133. package/engine/standard-engine.d.ts.map +1 -1
  134. package/engine/test-body-resource-attachment.d.ts +3 -1
  135. package/engine/test-body-resource-attachment.d.ts.map +1 -1
  136. package/engine/test-body-resource-attachment.js +10 -2
  137. package/engine/test-body-resource-attachment.js.map +1 -1
  138. package/engine/test-body.d.ts +13 -2
  139. package/engine/test-body.d.ts.map +1 -1
  140. package/engine/test-body.js +43 -9
  141. package/engine/test-body.js.map +1 -1
  142. package/engine/test-data.js +5 -5
  143. package/engine/test-data.js.map +1 -1
  144. package/engine/test-debug-context.js +11 -30
  145. package/engine/test-debug-context.js.map +1 -1
  146. package/engine/test-debug-recording.js +1 -2
  147. package/engine/test-debug-recording.js.map +1 -1
  148. package/engine/test-debug.d.ts +2 -2
  149. package/engine/test-family.d.ts +4 -10
  150. package/engine/test-family.d.ts.map +1 -1
  151. package/engine/test-family.js +2 -46
  152. package/engine/test-family.js.map +1 -1
  153. package/engine/test-node.d.ts +21 -15
  154. package/engine/test-node.d.ts.map +1 -1
  155. package/engine/test-node.js +16 -6
  156. package/engine/test-node.js.map +1 -1
  157. package/engine/test-plan.d.ts.map +1 -1
  158. package/engine/test-plan.js +6 -6
  159. package/engine/test-plan.js.map +1 -1
  160. package/engine/workload-input.js +1 -1
  161. package/engine/workload-input.js.map +1 -1
  162. package/engine/workload-test-case.d.ts +2 -0
  163. package/engine/workload-test-case.d.ts.map +1 -1
  164. package/engine/workload-test-case.js +4 -4
  165. package/engine/workload-test-case.js.map +1 -1
  166. package/execution-ownership.d.ts +33 -0
  167. package/execution-ownership.d.ts.map +1 -0
  168. package/execution-ownership.js +45 -0
  169. package/execution-ownership.js.map +1 -0
  170. package/implementation-assignment.d.ts +11 -0
  171. package/implementation-assignment.d.ts.map +1 -0
  172. package/implementation-assignment.js +97 -0
  173. package/implementation-assignment.js.map +1 -0
  174. package/implementation-build-preparation.js +19 -0
  175. package/implementation-build-preparation.js.map +1 -0
  176. package/implementation-build.d.ts +41 -0
  177. package/implementation-build.d.ts.map +1 -0
  178. package/implementation-build.js +22 -0
  179. package/implementation-build.js.map +1 -0
  180. package/implementation-catalog.d.ts +39 -0
  181. package/implementation-catalog.d.ts.map +1 -0
  182. package/implementation-catalog.js +183 -0
  183. package/implementation-catalog.js.map +1 -0
  184. package/implementation-fingerprint.js +6 -0
  185. package/implementation-fingerprint.js.map +1 -0
  186. package/implementation-graph.d.ts +4 -0
  187. package/implementation-graph.d.ts.map +1 -0
  188. package/implementation-graph.js +135 -0
  189. package/implementation-graph.js.map +1 -0
  190. package/implementation-load-error.js +12 -0
  191. package/implementation-load-error.js.map +1 -0
  192. package/implementation-participant.d.ts +18 -0
  193. package/implementation-participant.d.ts.map +1 -0
  194. package/implementation-participant.js +30 -0
  195. package/implementation-participant.js.map +1 -0
  196. package/implementation-preload.js +16 -0
  197. package/implementation-preload.js.map +1 -0
  198. package/implementation-preparation.d.ts +19 -0
  199. package/implementation-preparation.d.ts.map +1 -0
  200. package/implementation-preparation.js +37 -0
  201. package/implementation-preparation.js.map +1 -0
  202. package/implementation-reference.d.ts +39 -0
  203. package/implementation-reference.d.ts.map +1 -0
  204. package/implementation-reference.js +57 -0
  205. package/implementation-reference.js.map +1 -0
  206. package/implementation-source-map.d.ts +6 -0
  207. package/implementation-source-map.d.ts.map +1 -0
  208. package/implementation-source-map.js +72 -0
  209. package/implementation-source-map.js.map +1 -0
  210. package/implementation-source.d.ts +5 -0
  211. package/implementation-source.d.ts.map +1 -0
  212. package/implementation-source.js +93 -0
  213. package/implementation-source.js.map +1 -0
  214. package/module-loading-scope.d.ts +22 -0
  215. package/module-loading-scope.d.ts.map +1 -1
  216. package/module-loading-scope.js +278 -0
  217. package/module-loading-scope.js.map +1 -1
  218. package/package.json +56 -2
  219. package/packages/engine/engine.entry-point.d.ts +11 -16
  220. package/packages/engine/engine.entry-point.d.ts.map +1 -1
  221. package/packages/engine/engine.entry-point.js +5 -34
  222. package/packages/engine/engine.entry-point.js.map +1 -1
  223. package/portable-value.d.ts +6 -0
  224. package/portable-value.d.ts.map +1 -0
  225. package/portable-value.js +56 -0
  226. package/portable-value.js.map +1 -0
  227. package/readme.md +62 -0
  228. package/resource-check-cancellation.d.ts +6 -0
  229. package/resource-check-cancellation.d.ts.map +1 -0
  230. package/resource-check-cancellation.js +63 -0
  231. package/resource-check-cancellation.js.map +1 -0
  232. package/software-bill-of-materials.cyclonedx.json +56 -5
  233. package/source-map-data.d.ts +26 -0
  234. package/source-map-data.d.ts.map +1 -0
  235. package/source-map-data.js +62 -0
  236. package/source-map-data.js.map +1 -0
  237. package/engine/case-interruption.d.ts +0 -8
  238. package/engine/case-interruption.d.ts.map +0 -1
@@ -0,0 +1,37 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { withRunnerInfrastructure } from "./execution-ownership.js";
3
+ import { preloadImplementation } from "./implementation-preload.js";
4
+ import { implementationFacts, readImplementationExport } from "./implementation-reference.js";
5
+ import { snapshotPortableValue } from "./portable-value.js";
6
+ export async function prepareImplementation(request) {
7
+ request.signal.throwIfAborted();
8
+ const facts = implementationFacts(request.reference, request.context);
9
+ const { prepareImplementationGraph } = await import("./implementation-graph.js");
10
+ const graph = await prepareImplementationGraph([facts]);
11
+ request.signal.throwIfAborted();
12
+ return Object.freeze({ facts, graph });
13
+ }
14
+ export async function withPreparedImplementation(request, use) {
15
+ request.signal.throwIfAborted();
16
+ const input = snapshotPortableValue(request.reference.parseInput(request.reference.input, request.context));
17
+ const facts = implementationFacts(request.reference, request.context);
18
+ if (!isDeepStrictEqual(facts, request.prepared.facts) || !isDeepStrictEqual(input, facts.input)) {
19
+ throw new TypeError('Implementation inputs changed; prepare and collect a new run.');
20
+ }
21
+ const { verifyImplementationGraph, withImplementationGraph } = await withRunnerInfrastructure(async function graph() {
22
+ return await import("./implementation-graph.js");
23
+ });
24
+ await verifyImplementationGraph(request.prepared.graph, [facts]);
25
+ request.signal.throwIfAborted();
26
+ return await withImplementationGraph(request.prepared.graph, async function admit(load) {
27
+ const loaded = await withRunnerInfrastructure(async function preload() {
28
+ return await preloadImplementation(async function loadEntry() {
29
+ return await load(facts.module.moduleUrl);
30
+ }, request.signal);
31
+ });
32
+ const implementation = readImplementationExport(loaded.namespace, facts, request.parseImplementation);
33
+ request.signal.throwIfAborted();
34
+ return await use(implementation, input);
35
+ });
36
+ }
37
+ //# sourceMappingURL=implementation-preparation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-preparation.js","sourceRoot":"","sources":["../../../source/implementation-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EACH,mBAAmB,EACnB,wBAAwB,EAI3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAsB,MAAM,qBAAqB,CAAC;AAchF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,OAAyC;IAEzC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,CAAE,KAAK,CAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC5C,OAAuD,EACvD,GAAsE;IAEtE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,GAAG,MAAM,wBAAwB,CACzF,KAAK,UAAU,KAAK;QAChB,OAAO,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACrD,CAAC,CACJ,CAAC;IACF,MAAM,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAE,KAAK,CAAE,CAAC,CAAC;IACnE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,UAAU,KAAK,CAAC,IAAI;QAClF,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,KAAK,UAAU,OAAO;YAChE,OAAO,MAAM,qBAAqB,CAAC,KAAK,UAAU,SAAS;gBACvD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,MAAM,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,39 @@
1
+ import type { Except } from 'type-fest';
2
+ import { z } from 'zod/v4';
3
+ import { type PortableValue } from './portable-value.ts';
4
+ export type ModuleReference = {
5
+ readonly moduleUrl: string;
6
+ readonly exportName: string;
7
+ };
8
+ export type ImplementationRealm = 'browser' | 'host';
9
+ export type ImplementationInputContext = {
10
+ readonly projectRoot: string;
11
+ };
12
+ export type ImplementationReference<Input extends PortableValue> = {
13
+ readonly kind: 'implementation-reference';
14
+ readonly module: ModuleReference;
15
+ readonly realm: ImplementationRealm;
16
+ readonly version: string;
17
+ readonly input: PortableValue;
18
+ readonly parseInput: (input: unknown, context: ImplementationInputContext) => Input;
19
+ readonly dynamicModules: readonly ModuleReference[];
20
+ };
21
+ export type ImplementationExport<Implementation> = {
22
+ readonly version: string;
23
+ readonly implementation: Implementation;
24
+ };
25
+ export type ImplementationFacts = {
26
+ readonly module: ModuleReference;
27
+ readonly realm: ImplementationRealm;
28
+ readonly version: string;
29
+ readonly input: PortableValue;
30
+ readonly dynamicModules: readonly ModuleReference[];
31
+ };
32
+ export declare const moduleReferenceSchema: z.ZodObject<{
33
+ moduleUrl: z.ZodURL;
34
+ exportName: z.ZodString;
35
+ }, z.core.$strict>;
36
+ export declare function defineImplementationReference<Input extends PortableValue>(reference: Except<ImplementationReference<Input>, 'kind'>): ImplementationReference<Input>;
37
+ export declare function implementationFacts<Input extends PortableValue>(reference: ImplementationReference<Input>, context: ImplementationInputContext): ImplementationFacts;
38
+ export declare function readImplementationExport<Implementation>(namespace: unknown, facts: ImplementationFacts, parseImplementation: (input: unknown) => Implementation): Implementation;
39
+ //# sourceMappingURL=implementation-reference.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-reference.d.ts","sourceRoot":"","sources":["../../../source/implementation-reference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,0BAA0B,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC;AAC3E,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,aAAa,IAAI;IAC/D,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,0BAA0B,KAAK,KAAK,CAAC;IACpF,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;CACvD,CAAC;AACF,MAAM,MAAM,oBAAoB,CAAC,cAAc,IAAI;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CAC3C,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;CACvD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;kBAGhC,CAAC;AAWH,wBAAgB,6BAA6B,CAAC,KAAK,SAAS,aAAa,EACrE,SAAS,EAAE,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAC1D,uBAAuB,CAAC,KAAK,CAAC,CAchC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,aAAa,EAC3D,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC,EACzC,OAAO,EAAE,0BAA0B,GACpC,mBAAmB,CAWrB;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EACnD,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,mBAAmB,EAC1B,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,GACxD,cAAc,CAYhB"}
@@ -0,0 +1,57 @@
1
+ import { isAbsolute } from 'node:path';
2
+ import { z } from 'zod/v4';
3
+ import { snapshotPortableValue } from "./portable-value.js";
4
+ export const moduleReferenceSchema = z.strictObject({
5
+ moduleUrl: z.url(),
6
+ exportName: z.string().min(1)
7
+ });
8
+ const referenceMetadataSchema = z.object({
9
+ kind: z.literal('implementation-reference'),
10
+ module: moduleReferenceSchema,
11
+ realm: z.enum(['host', 'browser']),
12
+ version: z.string().refine(function nonblank(value) {
13
+ return value.trim().length > 0;
14
+ }),
15
+ dynamicModules: z.array(moduleReferenceSchema)
16
+ });
17
+ export function defineImplementationReference(reference) {
18
+ const metadata = referenceMetadataSchema.parse({ ...reference, kind: 'implementation-reference' });
19
+ if (typeof reference.parseInput !== 'function') {
20
+ throw new TypeError('Implementation inputs require a synchronous parser.');
21
+ }
22
+ return Object.freeze({
23
+ ...metadata,
24
+ module: Object.freeze(metadata.module),
25
+ dynamicModules: Object.freeze(metadata.dynamicModules.map(function freezeModule(module) {
26
+ return Object.freeze(module);
27
+ })),
28
+ input: snapshotPortableValue(reference.input),
29
+ parseInput: reference.parseInput
30
+ });
31
+ }
32
+ export function implementationFacts(reference, context) {
33
+ if (!isAbsolute(context.projectRoot)) {
34
+ throw new TypeError('Implementation preparation requires an absolute project root.');
35
+ }
36
+ return Object.freeze({
37
+ module: reference.module,
38
+ realm: reference.realm,
39
+ version: reference.version,
40
+ input: snapshotPortableValue(reference.parseInput(reference.input, context)),
41
+ dynamicModules: reference.dynamicModules
42
+ });
43
+ }
44
+ export function readImplementationExport(namespace, facts, parseImplementation) {
45
+ const exports = z.record(z.string(), z.unknown()).parse(namespace);
46
+ if (!Object.hasOwn(exports, facts.module.exportName)) {
47
+ throw new TypeError(`Missing implementation export: ${facts.module.exportName}`);
48
+ }
49
+ const exported = z
50
+ .strictObject({ version: z.string(), implementation: z.unknown() })
51
+ .parse(exports[facts.module.exportName]);
52
+ if (exported.version !== facts.version) {
53
+ throw new TypeError('Implementation version changed; prepare and collect a new run.');
54
+ }
55
+ return parseImplementation(exported.implementation);
56
+ }
57
+ //# sourceMappingURL=implementation-reference.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-reference.js","sourceRoot":"","sources":["../../../source/implementation-reference.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export type ImplementationSourceMap = {
2
+ readonly url: string;
3
+ readonly source: string;
4
+ };
5
+ export {};
6
+ //# sourceMappingURL=implementation-source-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-source-map.d.ts","sourceRoot":"","sources":["../../../source/implementation-source-map.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,uBAAuB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}
@@ -0,0 +1,72 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { fileURLToPath } from 'node:url';
3
+ import convertSourceMap from 'convert-source-map';
4
+ import { AnyMap } from '@jridgewell/trace-mapping';
5
+ import ts from 'typescript';
6
+ import { normalizedSourceMap, sourceMapDataSchema, validateSourceMapMappings } from "./source-map-data.js";
7
+ function sourceMapComment(comment) {
8
+ const [, singleLine, multiLine] = convertSourceMap.mapFileCommentRegex.exec(comment) ?? [];
9
+ return singleLine ?? multiLine ?? null;
10
+ }
11
+ function sourceMapComments(source, url) {
12
+ const file = ts.createSourceFile(url, source, ts.ScriptTarget.Latest, true);
13
+ const comments = new Map();
14
+ function collect(range) {
15
+ const reference = sourceMapComment(source.slice(range.pos, range.end));
16
+ if (reference !== null) {
17
+ comments.set(range.pos, { reference, start: range.pos, end: range.end });
18
+ }
19
+ }
20
+ function visit(node) {
21
+ const leading = ts.getLeadingCommentRanges(source, node.pos) ?? [];
22
+ const trailing = ts.getTrailingCommentRanges(source, node.end) ?? [];
23
+ leading.forEach(collect);
24
+ trailing.forEach(collect);
25
+ node.getChildren(file).forEach(visit);
26
+ }
27
+ visit(file);
28
+ return Array.from(comments.values()).toSorted(function byPosition(left, right) {
29
+ return left.start - right.start;
30
+ });
31
+ }
32
+ function inlineSourceMap(url) {
33
+ const separator = url.href.indexOf(',');
34
+ const header = url.href.slice(0, separator);
35
+ const payload = url.href.slice(separator + 1);
36
+ return header.endsWith(';base64') ? Buffer.from(payload, 'base64').toString('utf8') : decodeURIComponent(payload);
37
+ }
38
+ function preservedWhitespace(comment) {
39
+ return comment.replaceAll(/[^\r\n\u{2028}\u{2029}]/gu, function preserveColumns(character) {
40
+ return ' '.repeat(character.length);
41
+ });
42
+ }
43
+ function immutableMapSource(source, comments, data) {
44
+ let delivered = '';
45
+ let offset = 0;
46
+ for (const comment of comments) {
47
+ delivered += source.slice(offset, comment.start) +
48
+ preservedWhitespace(source.slice(comment.start, comment.end));
49
+ offset = comment.end;
50
+ }
51
+ const encoded = Buffer.from(data).toString('base64');
52
+ return `${delivered}${source.slice(offset)}\n//# sourceMappingURL=data:application/json;base64,${encoded}\n`;
53
+ }
54
+ export async function deliverImplementationSource(source, url) {
55
+ const comments = sourceMapComments(source, url);
56
+ const last = comments.at(-1);
57
+ if (last === undefined) {
58
+ return { source, sourceMap: null };
59
+ }
60
+ const resolved = new URL(last.reference, url);
61
+ const content = resolved.protocol === 'data:'
62
+ ? inlineSourceMap(resolved)
63
+ : await readFile(fileURLToPath(resolved), 'utf8');
64
+ const base = resolved.protocol === 'data:' ? url : resolved.href;
65
+ const map = new AnyMap(sourceMapDataSchema.parse(JSON.parse(content)), base);
66
+ validateSourceMapMappings(map, false);
67
+ return {
68
+ source: immutableMapSource(source, comments, JSON.stringify(normalizedSourceMap(map, map.sourcesContent ?? []))),
69
+ sourceMap: Object.freeze({ url: resolved.href, source: content })
70
+ };
71
+ }
72
+ //# sourceMappingURL=implementation-source-map.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-source-map.js","sourceRoot":"","sources":["../../../source/implementation-source-map.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export type ImplementationPackage = {
2
+ readonly url: string;
3
+ readonly source: string;
4
+ };
5
+ //# sourceMappingURL=implementation-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-source.d.ts","sourceRoot":"","sources":["../../../source/implementation-source.ts"],"names":[],"mappings":"MAOM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}
@@ -0,0 +1,93 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { dirname, extname, join } from 'node:path';
3
+ import { fileURLToPath, pathToFileURL } from 'node:url';
4
+ import { z } from 'zod/v4';
5
+ import ts from 'typescript';
6
+ function executableImport(node) {
7
+ if (ts.isExportDeclaration(node)) {
8
+ return !node.isTypeOnly;
9
+ }
10
+ if (!ts.isImportDeclaration(node)) {
11
+ return false;
12
+ }
13
+ return node.importClause?.phaseModifier !== ts.SyntaxKind.TypeKeyword;
14
+ }
15
+ function declaredImport(node) {
16
+ if (!ts.isImportDeclaration(node) && !ts.isExportDeclaration(node)) {
17
+ return null;
18
+ }
19
+ const specifier = node.moduleSpecifier;
20
+ return executableImport(node) && specifier !== undefined && ts.isStringLiteral(specifier) ? specifier.text : null;
21
+ }
22
+ function dynamicImport(node) {
23
+ if (!ts.isCallExpression(node) || node.expression.kind !== ts.SyntaxKind.ImportKeyword) {
24
+ return null;
25
+ }
26
+ const specifier = node.arguments[0];
27
+ return specifier !== undefined && ts.isStringLiteralLike(specifier) ? specifier.text : null;
28
+ }
29
+ export function implementationImports(source, url) {
30
+ const file = ts.createSourceFile(url, source, ts.ScriptTarget.Latest, true);
31
+ const imports = new Set();
32
+ function visit(node) {
33
+ const specifier = declaredImport(node) ?? dynamicImport(node);
34
+ if (specifier !== null) {
35
+ imports.add(specifier);
36
+ }
37
+ ts.forEachChild(node, visit);
38
+ }
39
+ visit(file);
40
+ return Array.from(imports).toSorted(function bySpecifier(left, right) {
41
+ return left.localeCompare(right, 'en');
42
+ });
43
+ }
44
+ async function packageSource(directory) {
45
+ const file = join(directory, 'package.json');
46
+ try {
47
+ return { url: pathToFileURL(file).href, source: await readFile(file, 'utf8') };
48
+ }
49
+ catch (error) {
50
+ if (z.object({ code: z.literal('ENOENT') }).safeParse(error).success) {
51
+ return null;
52
+ }
53
+ throw error;
54
+ }
55
+ }
56
+ function* packageDirectories(url) {
57
+ let directory = dirname(fileURLToPath(url));
58
+ yield directory;
59
+ while (directory !== dirname(directory)) {
60
+ directory = dirname(directory);
61
+ yield directory;
62
+ }
63
+ }
64
+ export async function implementationPackages(url) {
65
+ const packages = await Promise.all(Array.from(packageDirectories(url), packageSource));
66
+ return packages.filter(function foundPackage(metadata) {
67
+ return metadata !== null;
68
+ });
69
+ }
70
+ const fixedFormats = new Map([
71
+ ['.json', 'json'],
72
+ ['.mts', 'module-typescript'],
73
+ ['.mjs', 'module']
74
+ ]);
75
+ function hasModulePackage(packages) {
76
+ const nearest = packages[0];
77
+ if (nearest === undefined) {
78
+ return false;
79
+ }
80
+ return z.object({ type: z.string().default('commonjs') }).parse(JSON.parse(nearest.source)).type === 'module';
81
+ }
82
+ export function implementationFormat(url, packages) {
83
+ const extension = extname(fileURLToPath(url));
84
+ const fixed = fixedFormats.get(extension);
85
+ if (fixed !== undefined) {
86
+ return fixed;
87
+ }
88
+ if (!hasModulePackage(packages) || !['.ts', '.js'].includes(extension)) {
89
+ throw new TypeError(`Unsupported portable implementation format: ${url}`);
90
+ }
91
+ return extension === '.ts' ? 'module-typescript' : 'module';
92
+ }
93
+ //# sourceMappingURL=implementation-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implementation-source.js","sourceRoot":"","sources":["../../../source/implementation-source.ts"],"names":[],"mappings":"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"}
@@ -5,4 +5,26 @@ export type ModuleLoadingHooks = {
5
5
  }>(specifier: string, parentURL: string | undefined, nextResolve: () => Result) => Result;
6
6
  };
7
7
  export declare function withModuleLoadingScope<Value>(hooks: ModuleLoadingHooks, operation: () => Promise<Value>): Promise<Value>;
8
+ export type DeliveredModule = {
9
+ readonly url: string;
10
+ readonly format: 'json' | 'module' | 'module-typescript';
11
+ readonly source: string;
12
+ readonly dependencies: Readonly<Record<string, string>>;
13
+ };
14
+ export declare function resolveModuleUrl(specifier: string, parentURL: string): string;
15
+ type ModuleDelivery = {
16
+ readonly build: string;
17
+ readonly modules: readonly DeliveredModule[];
18
+ readonly builtins: readonly string[];
19
+ };
20
+ type ModuleNamespace = {
21
+ readonly namespace: unknown;
22
+ };
23
+ type DeliveryLoader = {
24
+ readonly load: (url: string) => Promise<ModuleNamespace>;
25
+ readonly pending: () => boolean;
26
+ };
27
+ export declare function withModuleDelivery<Value>(delivery: ModuleDelivery, operation: (load: DeliveryLoader['load']) => Promise<Value>): Promise<Value>;
28
+ export declare function isDeliveredModuleImport(value: unknown): boolean;
29
+ export {};
8
30
  //# sourceMappingURL=module-loading-scope.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"module-loading-scope.d.ts","sourceRoot":"","sources":["../../../source/module-loading-scope.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,MAAM,KAAK,MAAM,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KAAE,EACvD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,MAAM,KACxB,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAC9C,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC,CAkBhB"}
1
+ {"version":3,"file":"module-loading-scope.d.ts","sourceRoot":"","sources":["../../../source/module-loading-scope.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,MAAM,KAAK,MAAM,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KAAE,EACvD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,MAAM,KACxB,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAC9C,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC,CAkBhB;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAc7E;AAED,KAAK,cAAc,GAAG;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AA0NF,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAAE,CAAC;AACxD,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CAAE,CAAC;AAkDrH,wBAAsB,kBAAkB,CAAC,KAAK,EAC1C,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,GAC5D,OAAO,CAAC,KAAK,CAAC,CAShB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO/D"}