@speclynx/apidom-reference 4.10.1 → 4.12.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 (133) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +215 -3
  3. package/dist/apidom-reference.browser.js +1515 -191
  4. package/dist/apidom-reference.browser.min.js +1 -1
  5. package/package.json +36 -31
  6. package/src/File.cjs +3 -1
  7. package/src/Reference.cjs +3 -1
  8. package/src/ReferenceSet.cjs +3 -1
  9. package/src/bundle/index.cjs +9 -1
  10. package/src/bundle/index.mjs +6 -0
  11. package/src/bundle/strategies/BundleStrategy.cjs +3 -1
  12. package/src/bundle/strategies/openapi-3-0/index.cjs +94 -0
  13. package/src/bundle/strategies/openapi-3-0/index.mjs +81 -0
  14. package/src/bundle/strategies/openapi-3-0/visitor.cjs +650 -0
  15. package/src/bundle/strategies/openapi-3-0/visitor.mjs +642 -0
  16. package/src/bundle/strategies/openapi-3-1/index.cjs +3 -1
  17. package/src/bundle/util.cjs +42 -0
  18. package/src/bundle/util.mjs +33 -0
  19. package/src/configuration/empty.cjs +9 -2
  20. package/src/configuration/saturated.cjs +19 -11
  21. package/src/configuration/saturated.mjs +2 -1
  22. package/src/dereference/index.cjs +3 -1
  23. package/src/dereference/strategies/DereferenceStrategy.cjs +3 -1
  24. package/src/dereference/strategies/apidom/index.cjs +9 -2
  25. package/src/dereference/strategies/apidom/selectors/element-id.cjs +9 -2
  26. package/src/dereference/strategies/apidom/visitor.cjs +3 -1
  27. package/src/dereference/strategies/arazzo-1/index.cjs +35 -8
  28. package/src/dereference/strategies/arazzo-1/index.mjs +1 -1
  29. package/src/dereference/strategies/arazzo-1/selectors/$anchor.cjs +46 -10
  30. package/src/dereference/strategies/arazzo-1/selectors/uri.cjs +22 -6
  31. package/src/dereference/strategies/arazzo-1/source-descriptions.cjs +3 -1
  32. package/src/dereference/strategies/arazzo-1/util.cjs +16 -4
  33. package/src/dereference/strategies/arazzo-1/visitor.cjs +4 -2
  34. package/src/dereference/strategies/arazzo-1/visitor.mjs +1 -1
  35. package/src/dereference/strategies/asyncapi-2/index.cjs +10 -3
  36. package/src/dereference/strategies/asyncapi-2/index.mjs +1 -1
  37. package/src/dereference/strategies/asyncapi-2/visitor.cjs +5 -3
  38. package/src/dereference/strategies/asyncapi-2/visitor.mjs +2 -2
  39. package/src/dereference/strategies/openapi-2/index.cjs +10 -3
  40. package/src/dereference/strategies/openapi-2/index.mjs +1 -1
  41. package/src/dereference/strategies/openapi-2/visitor.cjs +6 -4
  42. package/src/dereference/strategies/openapi-2/visitor.mjs +3 -3
  43. package/src/dereference/strategies/openapi-3-0/index.cjs +10 -3
  44. package/src/dereference/strategies/openapi-3-0/index.mjs +1 -1
  45. package/src/dereference/strategies/openapi-3-0/visitor.cjs +5 -3
  46. package/src/dereference/strategies/openapi-3-0/visitor.mjs +2 -2
  47. package/src/dereference/strategies/openapi-3-1/index.cjs +29 -7
  48. package/src/dereference/strategies/openapi-3-1/index.mjs +1 -1
  49. package/src/dereference/strategies/openapi-3-1/selectors/$anchor.cjs +22 -5
  50. package/src/dereference/strategies/openapi-3-1/selectors/uri.cjs +16 -4
  51. package/src/dereference/strategies/openapi-3-1/util.cjs +3 -1
  52. package/src/dereference/strategies/openapi-3-1/visitor.cjs +6 -4
  53. package/src/dereference/strategies/openapi-3-1/visitor.mjs +3 -3
  54. package/src/dereference/strategies/overlay-1/extends.cjs +3 -1
  55. package/src/dereference/strategies/overlay-1/index.cjs +9 -2
  56. package/src/dereference/util.cjs +3 -1
  57. package/src/errors/BundleError.cjs +4 -2
  58. package/src/errors/BundleError.mjs +2 -2
  59. package/src/errors/DereferenceError.cjs +3 -1
  60. package/src/errors/EvaluationElementIdError.cjs +3 -1
  61. package/src/errors/EvaluationJsonSchema$anchorError.cjs +3 -1
  62. package/src/errors/EvaluationJsonSchemaUriError.cjs +3 -1
  63. package/src/errors/InvalidJsonSchema$anchorError.cjs +3 -1
  64. package/src/errors/JsonSchema$anchorError.cjs +3 -1
  65. package/src/errors/JsonSchemaUriError.cjs +3 -1
  66. package/src/errors/MaximumBundleDepthError.cjs +3 -1
  67. package/src/errors/MaximumDereferenceDepthError.cjs +3 -1
  68. package/src/errors/MaximumResolveDepthError.cjs +3 -1
  69. package/src/errors/ParseError.cjs +3 -1
  70. package/src/errors/ParserError.cjs +3 -1
  71. package/src/errors/PluginError.cjs +3 -1
  72. package/src/errors/ResolveError.cjs +3 -1
  73. package/src/errors/ResolverError.cjs +3 -1
  74. package/src/errors/UnmatchedBundleStrategyError.cjs +3 -1
  75. package/src/errors/UnmatchedDereferenceStrategyError.cjs +3 -1
  76. package/src/errors/UnmatchedParserError.cjs +3 -1
  77. package/src/errors/UnmatchedResolveStrategyError.cjs +3 -1
  78. package/src/errors/UnmatchedResolverError.cjs +3 -1
  79. package/src/errors/UnresolvableReferenceError.cjs +8 -3
  80. package/src/errors/UnresolvableReferenceError.mjs +5 -2
  81. package/src/index.cjs +209 -36
  82. package/src/options/index.cjs +71 -2
  83. package/src/options/index.mjs +68 -1
  84. package/src/options/util.cjs +3 -1
  85. package/src/parse/index.cjs +3 -1
  86. package/src/parse/parsers/Parser.cjs +3 -1
  87. package/src/parse/parsers/apidom-json/index.cjs +3 -1
  88. package/src/parse/parsers/arazzo-json-1/index.cjs +9 -2
  89. package/src/parse/parsers/arazzo-json-1/source-descriptions.cjs +3 -1
  90. package/src/parse/parsers/arazzo-yaml-1/index.cjs +9 -2
  91. package/src/parse/parsers/arazzo-yaml-1/source-descriptions.cjs +3 -1
  92. package/src/parse/parsers/asyncapi-json-2/index.cjs +3 -1
  93. package/src/parse/parsers/asyncapi-yaml-2/index.cjs +3 -1
  94. package/src/parse/parsers/binary/index-browser.cjs +3 -1
  95. package/src/parse/parsers/binary/index-node.cjs +3 -1
  96. package/src/parse/parsers/json/index.cjs +3 -1
  97. package/src/parse/parsers/openapi-json-2/index.cjs +3 -1
  98. package/src/parse/parsers/openapi-json-3-0/index.cjs +3 -1
  99. package/src/parse/parsers/openapi-json-3-1/index.cjs +3 -1
  100. package/src/parse/parsers/openapi-yaml-2/index.cjs +3 -1
  101. package/src/parse/parsers/openapi-yaml-3-0/index.cjs +3 -1
  102. package/src/parse/parsers/openapi-yaml-3-1/index.cjs +3 -1
  103. package/src/parse/parsers/overlay-json-1/extends.cjs +3 -1
  104. package/src/parse/parsers/overlay-json-1/index.cjs +9 -2
  105. package/src/parse/parsers/overlay-yaml-1/extends.cjs +10 -4
  106. package/src/parse/parsers/overlay-yaml-1/index.cjs +9 -2
  107. package/src/parse/parsers/yaml-1-2/index.cjs +3 -1
  108. package/src/resolve/index.cjs +3 -1
  109. package/src/resolve/resolvers/HTTPResolver.cjs +3 -1
  110. package/src/resolve/resolvers/Resolver.cjs +3 -1
  111. package/src/resolve/resolvers/file/index-browser.cjs +3 -1
  112. package/src/resolve/resolvers/file/index-node.cjs +3 -1
  113. package/src/resolve/resolvers/http-axios/cache/MemoryCache.cjs +3 -1
  114. package/src/resolve/resolvers/http-axios/index.cjs +3 -1
  115. package/src/resolve/strategies/ResolveStrategy.cjs +3 -1
  116. package/src/resolve/strategies/apidom/index.cjs +3 -1
  117. package/src/resolve/strategies/arazzo-1/index.cjs +3 -1
  118. package/src/resolve/strategies/asyncapi-2/index.cjs +3 -1
  119. package/src/resolve/strategies/openapi-2/index.cjs +3 -1
  120. package/src/resolve/strategies/openapi-3-0/index.cjs +3 -1
  121. package/src/resolve/strategies/openapi-3-1/index.cjs +3 -1
  122. package/src/resolve/strategies/overlay-1/index.cjs +3 -1
  123. package/src/resolve/util.cjs +3 -1
  124. package/src/util/plugins.cjs +3 -1
  125. package/src/util/url.cjs +3 -1
  126. package/types/apidom-reference.d.ts +41 -2
  127. package/types/bundle/strategies/openapi-3-0/index.d.ts +31 -0
  128. package/types/bundle/strategies/openapi-3-0/visitor.d.ts +131 -0
  129. package/types/bundle/util.d.ts +22 -0
  130. package/types/errors/BundleError.d.ts +2 -2
  131. package/types/errors/UnresolvableReferenceError.d.ts +5 -2
  132. package/types/index.d.ts +1 -0
  133. package/types/options/index.d.ts +33 -1
@@ -1,6 +1,9 @@
1
- import DereferenceError from "./DereferenceError.mjs";
1
+ import ResolveError from "./ResolveError.mjs";
2
2
  /**
3
+ * Thrown when a reference cannot be resolved. Resolution is shared by the
4
+ * dereference and bundle components, so this error lives under `ResolveError`.
5
+ *
3
6
  * @public
4
7
  */
5
- class UnresolvableReferenceError extends DereferenceError {}
8
+ class UnresolvableReferenceError extends ResolveError {}
6
9
  export default UnresolvableReferenceError;
package/src/index.cjs CHANGED
@@ -2,83 +2,256 @@
2
2
 
3
3
  var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
4
4
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
5
- exports.__esModule = true;
6
- exports.url = exports.resolveApiDOM = exports.resolve = exports.readFile = exports.parse = exports.options = exports.mergeOptions = exports.dereferenceApiDOM = exports.dereference = exports.bundle = exports.UnresolvableReferenceError = exports.UnmatchedResolverError = exports.UnmatchedResolveStrategyError = exports.UnmatchedParserError = exports.UnmatchedDereferenceStrategyError = exports.UnmatchedBundleStrategyError = exports.ResolverError = exports.Resolver = exports.ResolveStrategy = exports.ResolveError = exports.Reference = exports.PluginError = exports.ParserError = exports.Parser = exports.ParseError = exports.MaximumResolveDepthError = exports.MaximumDereferenceDepthError = exports.MaximumBundleDepthError = exports.JsonSchemaURIError = exports.JsonSchema$anchorError = exports.InvalidJsonSchema$anchorError = exports.HTTPResolver = exports.EvaluationJsonSchemaUriError = exports.EvaluationJsonSchema$anchorError = exports.EvaluationElementIdError = exports.DereferenceStrategy = exports.DereferenceError = exports.DereferenceAncestorLineage = exports.BundleStrategy = exports.BundleError = void 0;
5
+ Object.defineProperty(exports, "__esModule", {
6
+ value: true
7
+ });
8
+ Object.defineProperty(exports, "BundleError", {
9
+ enumerable: true,
10
+ get: function () {
11
+ return _BundleError.default;
12
+ }
13
+ });
14
+ Object.defineProperty(exports, "BundleStrategy", {
15
+ enumerable: true,
16
+ get: function () {
17
+ return _BundleStrategy.default;
18
+ }
19
+ });
20
+ Object.defineProperty(exports, "DereferenceAncestorLineage", {
21
+ enumerable: true,
22
+ get: function () {
23
+ return _util3.AncestorLineage;
24
+ }
25
+ });
26
+ Object.defineProperty(exports, "DereferenceError", {
27
+ enumerable: true,
28
+ get: function () {
29
+ return _DereferenceError.default;
30
+ }
31
+ });
32
+ Object.defineProperty(exports, "DereferenceStrategy", {
33
+ enumerable: true,
34
+ get: function () {
35
+ return _DereferenceStrategy.default;
36
+ }
37
+ });
38
+ Object.defineProperty(exports, "EvaluationElementIdError", {
39
+ enumerable: true,
40
+ get: function () {
41
+ return _EvaluationElementIdError.default;
42
+ }
43
+ });
44
+ Object.defineProperty(exports, "EvaluationJsonSchema$anchorError", {
45
+ enumerable: true,
46
+ get: function () {
47
+ return _EvaluationJsonSchema$anchorError.default;
48
+ }
49
+ });
50
+ Object.defineProperty(exports, "EvaluationJsonSchemaUriError", {
51
+ enumerable: true,
52
+ get: function () {
53
+ return _EvaluationJsonSchemaUriError.default;
54
+ }
55
+ });
56
+ Object.defineProperty(exports, "File", {
57
+ enumerable: true,
58
+ get: function () {
59
+ return _File.default;
60
+ }
61
+ });
62
+ Object.defineProperty(exports, "HTTPResolver", {
63
+ enumerable: true,
64
+ get: function () {
65
+ return _HTTPResolver.default;
66
+ }
67
+ });
68
+ Object.defineProperty(exports, "InvalidJsonSchema$anchorError", {
69
+ enumerable: true,
70
+ get: function () {
71
+ return _InvalidJsonSchema$anchorError.default;
72
+ }
73
+ });
74
+ Object.defineProperty(exports, "JsonSchema$anchorError", {
75
+ enumerable: true,
76
+ get: function () {
77
+ return _JsonSchema$anchorError.default;
78
+ }
79
+ });
80
+ Object.defineProperty(exports, "JsonSchemaURIError", {
81
+ enumerable: true,
82
+ get: function () {
83
+ return _JsonSchemaUriError.default;
84
+ }
85
+ });
86
+ Object.defineProperty(exports, "MaximumBundleDepthError", {
87
+ enumerable: true,
88
+ get: function () {
89
+ return _MaximumBundleDepthError.default;
90
+ }
91
+ });
92
+ Object.defineProperty(exports, "MaximumDereferenceDepthError", {
93
+ enumerable: true,
94
+ get: function () {
95
+ return _MaximumDereferenceDepthError.default;
96
+ }
97
+ });
98
+ Object.defineProperty(exports, "MaximumResolveDepthError", {
99
+ enumerable: true,
100
+ get: function () {
101
+ return _MaximumResolveDepthError.default;
102
+ }
103
+ });
104
+ Object.defineProperty(exports, "ParseError", {
105
+ enumerable: true,
106
+ get: function () {
107
+ return _ParseError.default;
108
+ }
109
+ });
110
+ Object.defineProperty(exports, "Parser", {
111
+ enumerable: true,
112
+ get: function () {
113
+ return _Parser.default;
114
+ }
115
+ });
116
+ Object.defineProperty(exports, "ParserError", {
117
+ enumerable: true,
118
+ get: function () {
119
+ return _ParserError.default;
120
+ }
121
+ });
122
+ Object.defineProperty(exports, "PluginError", {
123
+ enumerable: true,
124
+ get: function () {
125
+ return _PluginError.default;
126
+ }
127
+ });
128
+ Object.defineProperty(exports, "Reference", {
129
+ enumerable: true,
130
+ get: function () {
131
+ return _Reference.default;
132
+ }
133
+ });
134
+ Object.defineProperty(exports, "ReferenceSet", {
135
+ enumerable: true,
136
+ get: function () {
137
+ return _ReferenceSet.default;
138
+ }
139
+ });
140
+ Object.defineProperty(exports, "ResolveError", {
141
+ enumerable: true,
142
+ get: function () {
143
+ return _ResolveError.default;
144
+ }
145
+ });
146
+ Object.defineProperty(exports, "ResolveStrategy", {
147
+ enumerable: true,
148
+ get: function () {
149
+ return _ResolveStrategy.default;
150
+ }
151
+ });
152
+ Object.defineProperty(exports, "Resolver", {
153
+ enumerable: true,
154
+ get: function () {
155
+ return _Resolver.default;
156
+ }
157
+ });
158
+ Object.defineProperty(exports, "ResolverError", {
159
+ enumerable: true,
160
+ get: function () {
161
+ return _ResolverError.default;
162
+ }
163
+ });
164
+ Object.defineProperty(exports, "UnmatchedBundleStrategyError", {
165
+ enumerable: true,
166
+ get: function () {
167
+ return _UnmatchedBundleStrategyError.default;
168
+ }
169
+ });
170
+ Object.defineProperty(exports, "UnmatchedDereferenceStrategyError", {
171
+ enumerable: true,
172
+ get: function () {
173
+ return _UnmatchedDereferenceStrategyError.default;
174
+ }
175
+ });
176
+ Object.defineProperty(exports, "UnmatchedParserError", {
177
+ enumerable: true,
178
+ get: function () {
179
+ return _UnmatchedParserError.default;
180
+ }
181
+ });
182
+ Object.defineProperty(exports, "UnmatchedResolveStrategyError", {
183
+ enumerable: true,
184
+ get: function () {
185
+ return _UnmatchedResolveStrategyError.default;
186
+ }
187
+ });
188
+ Object.defineProperty(exports, "UnmatchedResolverError", {
189
+ enumerable: true,
190
+ get: function () {
191
+ return _UnmatchedResolverError.default;
192
+ }
193
+ });
194
+ Object.defineProperty(exports, "UnresolvableReferenceError", {
195
+ enumerable: true,
196
+ get: function () {
197
+ return _UnresolvableReferenceError.default;
198
+ }
199
+ });
200
+ exports.dereferenceApiDOM = exports.dereference = exports.bundle = void 0;
201
+ Object.defineProperty(exports, "mergeOptions", {
202
+ enumerable: true,
203
+ get: function () {
204
+ return _util.merge;
205
+ }
206
+ });
207
+ Object.defineProperty(exports, "options", {
208
+ enumerable: true,
209
+ get: function () {
210
+ return _index.default;
211
+ }
212
+ });
213
+ exports.url = exports.resolveApiDOM = exports.resolve = exports.readFile = exports.parse = void 0;
7
214
  var _File = _interopRequireDefault(require("./File.cjs"));
8
- exports.File = _File.default;
9
215
  var _ReferenceSet = _interopRequireDefault(require("./ReferenceSet.cjs"));
10
- exports.ReferenceSet = _ReferenceSet.default;
11
216
  var url = _interopRequireWildcard(require("./util/url.cjs"));
12
217
  exports.url = url;
13
218
  var _index = _interopRequireDefault(require("./options/index.cjs"));
14
- exports.options = _index.default;
15
219
  var _util = require("./options/util.cjs");
16
- exports.mergeOptions = _util.merge;
17
220
  var _index2 = _interopRequireDefault(require("./parse/index.cjs"));
18
221
  var _index3 = _interopRequireWildcard(require("./resolve/index.cjs"));
19
222
  var _util2 = require("./resolve/util.cjs");
20
223
  var _index4 = _interopRequireWildcard(require("./dereference/index.cjs"));
21
224
  var _index5 = _interopRequireDefault(require("./bundle/index.cjs"));
22
225
  var _Parser = _interopRequireDefault(require("./parse/parsers/Parser.cjs"));
23
- exports.Parser = _Parser.default;
24
226
  var _Resolver = _interopRequireDefault(require("./resolve/resolvers/Resolver.cjs"));
25
- exports.Resolver = _Resolver.default;
26
227
  var _HTTPResolver = _interopRequireDefault(require("./resolve/resolvers/HTTPResolver.cjs"));
27
- exports.HTTPResolver = _HTTPResolver.default;
28
228
  var _ResolveStrategy = _interopRequireDefault(require("./resolve/strategies/ResolveStrategy.cjs"));
29
- exports.ResolveStrategy = _ResolveStrategy.default;
30
229
  var _DereferenceStrategy = _interopRequireDefault(require("./dereference/strategies/DereferenceStrategy.cjs"));
31
- exports.DereferenceStrategy = _DereferenceStrategy.default;
32
230
  var _util3 = require("./dereference/util.cjs");
33
- exports.DereferenceAncestorLineage = _util3.AncestorLineage;
34
231
  var _BundleStrategy = _interopRequireDefault(require("./bundle/strategies/BundleStrategy.cjs"));
35
- exports.BundleStrategy = _BundleStrategy.default;
36
232
  var _Reference = _interopRequireDefault(require("./Reference.cjs"));
37
- exports.Reference = _Reference.default;
38
233
  var _BundleError = _interopRequireDefault(require("./errors/BundleError.cjs"));
39
- exports.BundleError = _BundleError.default;
40
234
  var _MaximumBundleDepthError = _interopRequireDefault(require("./errors/MaximumBundleDepthError.cjs"));
41
- exports.MaximumBundleDepthError = _MaximumBundleDepthError.default;
42
235
  var _UnmatchedBundleStrategyError = _interopRequireDefault(require("./errors/UnmatchedBundleStrategyError.cjs"));
43
- exports.UnmatchedBundleStrategyError = _UnmatchedBundleStrategyError.default;
44
236
  var _DereferenceError = _interopRequireDefault(require("./errors/DereferenceError.cjs"));
45
- exports.DereferenceError = _DereferenceError.default;
46
237
  var _UnresolvableReferenceError = _interopRequireDefault(require("./errors/UnresolvableReferenceError.cjs"));
47
- exports.UnresolvableReferenceError = _UnresolvableReferenceError.default;
48
238
  var _EvaluationElementIdError = _interopRequireDefault(require("./errors/EvaluationElementIdError.cjs"));
49
- exports.EvaluationElementIdError = _EvaluationElementIdError.default;
50
239
  var _EvaluationJsonSchema$anchorError = _interopRequireDefault(require("./errors/EvaluationJsonSchema$anchorError.cjs"));
51
- exports.EvaluationJsonSchema$anchorError = _EvaluationJsonSchema$anchorError.default;
52
240
  var _EvaluationJsonSchemaUriError = _interopRequireDefault(require("./errors/EvaluationJsonSchemaUriError.cjs"));
53
- exports.EvaluationJsonSchemaUriError = _EvaluationJsonSchemaUriError.default;
54
241
  var _InvalidJsonSchema$anchorError = _interopRequireDefault(require("./errors/InvalidJsonSchema$anchorError.cjs"));
55
- exports.InvalidJsonSchema$anchorError = _InvalidJsonSchema$anchorError.default;
56
242
  var _JsonSchema$anchorError = _interopRequireDefault(require("./errors/JsonSchema$anchorError.cjs"));
57
- exports.JsonSchema$anchorError = _JsonSchema$anchorError.default;
58
243
  var _JsonSchemaUriError = _interopRequireDefault(require("./errors/JsonSchemaUriError.cjs"));
59
- exports.JsonSchemaURIError = _JsonSchemaUriError.default;
60
244
  var _MaximumDereferenceDepthError = _interopRequireDefault(require("./errors/MaximumDereferenceDepthError.cjs"));
61
- exports.MaximumDereferenceDepthError = _MaximumDereferenceDepthError.default;
62
245
  var _MaximumResolveDepthError = _interopRequireDefault(require("./errors/MaximumResolveDepthError.cjs"));
63
- exports.MaximumResolveDepthError = _MaximumResolveDepthError.default;
64
246
  var _ParseError = _interopRequireDefault(require("./errors/ParseError.cjs"));
65
- exports.ParseError = _ParseError.default;
66
247
  var _ParserError = _interopRequireDefault(require("./errors/ParserError.cjs"));
67
- exports.ParserError = _ParserError.default;
68
248
  var _PluginError = _interopRequireDefault(require("./errors/PluginError.cjs"));
69
- exports.PluginError = _PluginError.default;
70
249
  var _ResolveError = _interopRequireDefault(require("./errors/ResolveError.cjs"));
71
- exports.ResolveError = _ResolveError.default;
72
250
  var _ResolverError = _interopRequireDefault(require("./errors/ResolverError.cjs"));
73
- exports.ResolverError = _ResolverError.default;
74
251
  var _UnmatchedDereferenceStrategyError = _interopRequireDefault(require("./errors/UnmatchedDereferenceStrategyError.cjs"));
75
- exports.UnmatchedDereferenceStrategyError = _UnmatchedDereferenceStrategyError.default;
76
252
  var _UnmatchedResolveStrategyError = _interopRequireDefault(require("./errors/UnmatchedResolveStrategyError.cjs"));
77
- exports.UnmatchedResolveStrategyError = _UnmatchedResolveStrategyError.default;
78
253
  var _UnmatchedResolverError = _interopRequireDefault(require("./errors/UnmatchedResolverError.cjs"));
79
- exports.UnmatchedResolverError = _UnmatchedResolverError.default;
80
254
  var _UnmatchedParserError = _interopRequireDefault(require("./errors/UnmatchedParserError.cjs"));
81
- exports.UnmatchedParserError = _UnmatchedParserError.default;
82
255
  /**
83
256
  * @public
84
257
  */
@@ -1,6 +1,8 @@
1
1
  "use strict";
2
2
 
3
- exports.__esModule = true;
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
4
6
  exports.default = void 0;
5
7
  var _ramda = require("ramda");
6
8
  /**
@@ -15,6 +17,24 @@ var _ramda = require("ramda");
15
17
  * @public
16
18
  */
17
19
 
20
+ /**
21
+ * Context passed to a custom component-name resolver.
22
+ *
23
+ * @public
24
+ */
25
+
26
+ /**
27
+ * @public
28
+ */
29
+
30
+ /**
31
+ * @public
32
+ */
33
+
34
+ /**
35
+ * @public
36
+ */
37
+
18
38
  /**
19
39
  * @public
20
40
  */
@@ -170,6 +190,13 @@ const defaultOptions = {
170
190
  * your own implementation, or remove any bundle strategy by removing it from the list.
171
191
  */
172
192
  strategies: [],
193
+ /**
194
+ * Determines strategy specific options. The key is the name of the strategy
195
+ * (e.g. `openapi-3-0`) and the value is an object of options specific to
196
+ * that strategy. Strategy specific options take precedence over the
197
+ * top-level bundle options.
198
+ */
199
+ strategyOpts: {},
173
200
  /**
174
201
  * This option accepts an instance of pre-computed ReferenceSet.
175
202
  * If provided it will speed up the bundling significantly as the external
@@ -188,7 +215,49 @@ const defaultOptions = {
188
215
  * The bundling should throw MaximumBundleDepthError if bundling depth
189
216
  * is exceeded by this option.
190
217
  */
191
- maxDepth: +Infinity
218
+ maxDepth: +Infinity,
219
+ /**
220
+ * Determines whether the bundling process will be immutable.
221
+ * By default, the bundling process is immutable, which means that the original
222
+ * ApiDOM (and any pre-computed refSet) is not mutated and a deep clone is bundled.
223
+ *
224
+ * true - the bundling process is immutable (deep cloning of ApiDOM is involved)
225
+ * false - the bundling process is mutable (no deep cloning, faster, mutates input)
226
+ */
227
+ immutable: true,
228
+ /**
229
+ * Determines how hoisted components are named.
230
+ *
231
+ * `basename` (default) - derive the name from the referenced JSON Pointer
232
+ * (its last token), falling back to the referenced file's basename.
233
+ * `title` - derive Schema Object names from their `title` field, falling
234
+ * back to `basename` when no usable title is present.
235
+ * A custom resolver function - receives the referenced element and reference
236
+ * context and returns the base name; collision suffixing is still applied.
237
+ */
238
+ componentNamesStrategy: 'basename',
239
+ /**
240
+ * Determines how a component rename forced by a name collision with
241
+ * different content is reported.
242
+ *
243
+ * `warn` (default) - append a warning annotation to the parse result.
244
+ * `off` - rename silently.
245
+ * `error` - throw a BundleError instead of renaming.
246
+ */
247
+ onComponentNameCollision: 'warn',
248
+ /**
249
+ * Determines how the bundling process behaves when a reference cannot be
250
+ * resolved.
251
+ *
252
+ * Unlike dereferencing, a swallowed reference is left in place — so the
253
+ * bundled document may still contain unresolved external references.
254
+ *
255
+ * false - fail fast, throw on first error (default)
256
+ * true - skip unresolvable references silently, continue bundling
257
+ * (error) => void - callback invoked for each error; if the callback
258
+ * itself throws, bundling stops with that error
259
+ */
260
+ continueOnError: false
192
261
  }
193
262
  };
194
263
  var _default = exports.default = defaultOptions;
@@ -1,5 +1,23 @@
1
1
  import { identity } from 'ramda';
2
2
 
3
+ /**
4
+ * @public
5
+ */
6
+
7
+ /**
8
+ * @public
9
+ */
10
+
11
+ /**
12
+ * @public
13
+ */
14
+
15
+ /**
16
+ * Context passed to a custom component-name resolver.
17
+ *
18
+ * @public
19
+ */
20
+
3
21
  /**
4
22
  * @public
5
23
  */
@@ -167,6 +185,13 @@ const defaultOptions = {
167
185
  * your own implementation, or remove any bundle strategy by removing it from the list.
168
186
  */
169
187
  strategies: [],
188
+ /**
189
+ * Determines strategy specific options. The key is the name of the strategy
190
+ * (e.g. `openapi-3-0`) and the value is an object of options specific to
191
+ * that strategy. Strategy specific options take precedence over the
192
+ * top-level bundle options.
193
+ */
194
+ strategyOpts: {},
170
195
  /**
171
196
  * This option accepts an instance of pre-computed ReferenceSet.
172
197
  * If provided it will speed up the bundling significantly as the external
@@ -185,7 +210,49 @@ const defaultOptions = {
185
210
  * The bundling should throw MaximumBundleDepthError if bundling depth
186
211
  * is exceeded by this option.
187
212
  */
188
- maxDepth: +Infinity
213
+ maxDepth: +Infinity,
214
+ /**
215
+ * Determines whether the bundling process will be immutable.
216
+ * By default, the bundling process is immutable, which means that the original
217
+ * ApiDOM (and any pre-computed refSet) is not mutated and a deep clone is bundled.
218
+ *
219
+ * true - the bundling process is immutable (deep cloning of ApiDOM is involved)
220
+ * false - the bundling process is mutable (no deep cloning, faster, mutates input)
221
+ */
222
+ immutable: true,
223
+ /**
224
+ * Determines how hoisted components are named.
225
+ *
226
+ * `basename` (default) - derive the name from the referenced JSON Pointer
227
+ * (its last token), falling back to the referenced file's basename.
228
+ * `title` - derive Schema Object names from their `title` field, falling
229
+ * back to `basename` when no usable title is present.
230
+ * A custom resolver function - receives the referenced element and reference
231
+ * context and returns the base name; collision suffixing is still applied.
232
+ */
233
+ componentNamesStrategy: 'basename',
234
+ /**
235
+ * Determines how a component rename forced by a name collision with
236
+ * different content is reported.
237
+ *
238
+ * `warn` (default) - append a warning annotation to the parse result.
239
+ * `off` - rename silently.
240
+ * `error` - throw a BundleError instead of renaming.
241
+ */
242
+ onComponentNameCollision: 'warn',
243
+ /**
244
+ * Determines how the bundling process behaves when a reference cannot be
245
+ * resolved.
246
+ *
247
+ * Unlike dereferencing, a swallowed reference is left in place — so the
248
+ * bundled document may still contain unresolved external references.
249
+ *
250
+ * false - fail fast, throw on first error (default)
251
+ * true - skip unresolvable references silently, continue bundling
252
+ * (error) => void - callback invoked for each error; if the callback
253
+ * itself throws, bundling stops with that error
254
+ */
255
+ continueOnError: false
189
256
  }
190
257
  };
191
258
  export default defaultOptions;
@@ -1,6 +1,8 @@
1
1
  "use strict";
2
2
 
3
- exports.__esModule = true;
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
4
6
  exports.merge = void 0;
5
7
  var _ramda = require("ramda");
6
8
  var _ramdaAdjunct = require("ramda-adjunct");
@@ -2,7 +2,9 @@
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
4
  var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
5
- exports.__esModule = true;
5
+ Object.defineProperty(exports, "__esModule", {
6
+ value: true
7
+ });
6
8
  exports.default = void 0;
7
9
  var _ramda = require("ramda");
8
10
  var url = _interopRequireWildcard(require("../util/url.cjs"));
@@ -1,6 +1,8 @@
1
1
  "use strict";
2
2
 
3
- exports.__esModule = true;
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
4
6
  exports.default = void 0;
5
7
  /**
6
8
  * @public
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _apidomDatamodel = require("@speclynx/apidom-datamodel");
7
9
  var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
@@ -1,14 +1,21 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
8
+ Object.defineProperty(exports, "parseSourceDescriptions", {
9
+ enumerable: true,
10
+ get: function () {
11
+ return _sourceDescriptions.parseSourceDescriptions;
12
+ }
13
+ });
6
14
  var _ramda = require("ramda");
7
15
  var _apidomParserAdapterArazzoJson = require("@speclynx/apidom-parser-adapter-arazzo-json-1");
8
16
  var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
9
17
  var _Parser = _interopRequireDefault(require("../Parser.cjs"));
10
18
  var _sourceDescriptions = require("./source-descriptions.cjs");
11
- exports.parseSourceDescriptions = _sourceDescriptions.parseSourceDescriptions;
12
19
  /**
13
20
  * @public
14
21
  */
@@ -2,7 +2,9 @@
2
2
 
3
3
  var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
4
4
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
5
- exports.__esModule = true;
5
+ Object.defineProperty(exports, "__esModule", {
6
+ value: true
7
+ });
6
8
  exports.parseSourceDescriptions = parseSourceDescriptions;
7
9
  var _apidomDatamodel = require("@speclynx/apidom-datamodel");
8
10
  var _apidomNsArazzo = require("@speclynx/apidom-ns-arazzo-1");
@@ -1,14 +1,21 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
8
+ Object.defineProperty(exports, "parseSourceDescriptions", {
9
+ enumerable: true,
10
+ get: function () {
11
+ return _sourceDescriptions.parseSourceDescriptions;
12
+ }
13
+ });
6
14
  var _ramda = require("ramda");
7
15
  var _apidomParserAdapterArazzoYaml = require("@speclynx/apidom-parser-adapter-arazzo-yaml-1");
8
16
  var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
9
17
  var _Parser = _interopRequireDefault(require("../Parser.cjs"));
10
18
  var _sourceDescriptions = require("./source-descriptions.cjs");
11
- exports.parseSourceDescriptions = _sourceDescriptions.parseSourceDescriptions;
12
19
  /**
13
20
  * @public
14
21
  */
@@ -1,6 +1,8 @@
1
1
  "use strict";
2
2
 
3
- exports.__esModule = true;
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
4
6
  exports.parseSourceDescriptions = void 0;
5
7
  var _sourceDescriptions = require("../arazzo-json-1/source-descriptions.cjs");
6
8
  /**
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _ramda = require("ramda");
7
9
  var _apidomParserAdapterAsyncapiJson = require("@speclynx/apidom-parser-adapter-asyncapi-json-2");
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _ramda = require("ramda");
7
9
  var _apidomParserAdapterAsyncapiYaml = require("@speclynx/apidom-parser-adapter-asyncapi-yaml-2");
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _apidomDatamodel = require("@speclynx/apidom-datamodel");
7
9
  var _ParserError = _interopRequireDefault(require("../../../errors/ParserError.cjs"));
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _nodeBuffer = require("node:buffer");
7
9
  var _apidomDatamodel = require("@speclynx/apidom-datamodel");
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
2
 
3
3
  var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
4
- exports.__esModule = true;
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
5
7
  exports.default = void 0;
6
8
  var _ramda = require("ramda");
7
9
  var _apidomParserAdapterJson = require("@speclynx/apidom-parser-adapter-json");