@speclynx/apidom-parser-adapter-yaml-1-2 6.1.0 → 6.1.1

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.1.1](https://github.com/speclynx/apidom/compare/v6.1.0...v6.1.1) (2026-10-29)
+
+### Bug Fixes
+
+- parse empty YAML values as null elements ([#712](https://github.com/speclynx/apidom/issues/712)) ([388e842](https://github.com/speclynx/apidom/commit/388e842f3156fc94f46724f507cbf0dd92acae06)), closes [#655](https://github.com/speclynx/apidom/issues/655) [#709](https://github.com/speclynx/apidom/issues/709) [#694](https://github.com/speclynx/apidom/issues/694)
+- serialize empty YAML mapping keys to the empty string ([#709](https://github.com/speclynx/apidom/issues/709)) ([3ecce30](https://github.com/speclynx/apidom/commit/3ecce3025b89e5bcdb1481525fe35a86685285f9)), closes [#655](https://github.com/speclynx/apidom/issues/655) [#694](https://github.com/speclynx/apidom/issues/694)
+
 # [6.1.0](https://github.com/speclynx/apidom/compare/v6.0.6...v6.1.0) (2026-10-17)
 
 ### Bug Fixes

package/dist/apidom-parser-adapter-yaml-1-2.browser.js

@@ -992,15 +992,19 @@ const transformCstToYamlAst = (cursor, ctx) => {
 __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5156);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(5162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(7601);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(1770);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(7071);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(4660);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(94);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(4823);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(5810);
-/* harmony import */ var _ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(1228);
-/* harmony import */ var _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(9276);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(5297);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8121);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(8252);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(7601);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(1770);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(7071);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(4660);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(94);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(4823);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(5810);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(9686);
+/* harmony import */ var _ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(1228);
+/* harmony import */ var _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(9276);
 
 
 
@@ -1014,7 +1018,7 @@ const maybeAddSourceMap = (node, element, ctx) => {
   if (!ctx.sourceMap) {
     return;
   }
-  _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"].transfer(node, element);
+  _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_11__["default"].transfer(node, element);
 };
 
 // find the first descendant matching a type path through the AST
@@ -1032,7 +1036,7 @@ const findFirst = (node, path) => {
 // detect indent from first nested block mapping (stream > document > mapping > keyValuePair > mapping)
 const detectIndent = node => {
   const nested = findFirst(node, ['document', 'mapping', 'keyValuePair', 'mapping']);
-  if (nested?.styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyleGroup.Block && typeof nested.startCharacter === 'number' && nested.startCharacter > 0) {
+  if (nested?.styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block && typeof nested.startCharacter === 'number' && nested.startCharacter > 0) {
     return nested.startCharacter;
   }
   return 2;
@@ -1164,7 +1168,7 @@ const buildYamlStyle = (node, ctx, extras) => {
   // an untagged node has the non-specific tag '?' when it's a plain scalar and '!' otherwise
   // (YAML 1.2 §6.9.1); an explicit '!' on any other node means the same as no tag
   const tag = node.tag?.explicitName;
-  if (tag !== undefined && tag !== (node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyle.Plain ? '?' : '!')) {
+  if (tag !== undefined && tag !== (node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain ? '?' : '!')) {
     yamlStyle.tag = tag;
   }
   // the anchor's name, without the & indicator
@@ -1278,17 +1282,17 @@ const collectStreamComments = node => {
     if (!root) comments.before.push(text);else if (comment.startLine === root.endLine) comments.inline.push(text);else comments.after.push(text);
   };
   for (const child of node.children) {
-    if ((0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__.isDocument)(child)) {
+    if ((0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__.isDocument)(child)) {
       if (root) break;
       // comments after an explicit document start (---) or before an explicit document end (...)
       // are the document's own children, around its root node
       const children = child.children || [];
-      const rootIndex = children.findIndex(c => !(0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__.isComment)(c));
+      const rootIndex = children.findIndex(c => !(0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__.isComment)(c));
       if (rootIndex === -1) break;
-      children.slice(0, rootIndex).filter(_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__.isComment).forEach(collect);
+      children.slice(0, rootIndex).filter(_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__.isComment).forEach(collect);
       root = children[rootIndex];
-      children.slice(rootIndex + 1).filter(_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__.isComment).forEach(collect);
-    } else if ((0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_9__.isComment)(child)) {
+      children.slice(rootIndex + 1).filter(_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__.isComment).forEach(collect);
+    } else if ((0,_ast_nodes_predicates_ts__WEBPACK_IMPORTED_MODULE_13__.isComment)(child)) {
       collect(child);
     }
   }
@@ -1301,7 +1305,7 @@ const transformStream = (node, ctx) => {
   if (ctx.style) {
     ctx.indent = detectIndent(node);
   }
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__["default"]();
 
   // Transform all children
   const children = transformChildren(node.children || [], ctx);
@@ -1361,7 +1365,7 @@ const transformDocument = (node, ctx) => {
   const shouldSkipVisitingMoreDocuments = ctx.processedDocumentCount >= 1;
   if (shouldWarnAboutMoreDocuments) {
     const message = 'Only first document within YAML stream will be used. Rest will be discarded.';
-    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"](message);
     element.classes.push('warning');
     maybeAddSourceMap(node, element, ctx);
     ctx.annotations.push(element);
@@ -1380,7 +1384,7 @@ const transformCollection = (element, node, ctx) => {
   const typedNode = node;
   const children = node.children || [];
   if (ctx.style) {
-    if (ctx.flowCollectionPadding === null && node.styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyleGroup.Flow) {
+    if (ctx.flowCollectionPadding === null && node.styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Flow) {
       ctx.flowCollectionPadding = detectFlowPadding(typedNode);
     }
     const comments = collectComments(children, typedNode.startCharacter);
@@ -1391,7 +1395,7 @@ const transformCollection = (element, node, ctx) => {
     element.style = buildYamlStyle(node, ctx, {
       comment: comments.trailing,
       // a single pair written directly in a flow sequence (e.g. [a: 1])
-      singlePair: node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyle.SinglePair || undefined
+      singlePair: node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.SinglePair || undefined
     });
     if (comments.outOfScope.length > 0) {
       ctx.promotedComments.push(...comments.outOfScope);
@@ -1404,14 +1408,14 @@ const transformCollection = (element, node, ctx) => {
 
 // Mapping: Transforms to ObjectElement
 const transformMapping = (node, ctx) => {
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__["default"]();
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
   transformCollection(element, node, ctx);
   return element;
 };
 
 // KeyValuePair: Transforms to MemberElement
 const transformKeyValuePair = (node, ctx) => {
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"]();
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"]();
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const {
     key,
@@ -1422,15 +1426,25 @@ const transformKeyValuePair = (node, ctx) => {
       styleGroup,
       startCharacter
     } = value;
-    if (styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyleGroup.Block) {
+    if (styleGroup === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyleGroup.Block) {
       ctx.indentSeq = startCharacter > node.startCharacter;
     }
   }
 
   // Transform key and value (these are dynamically defined properties)
-  const keyResult = transform(key, ctx);
+  let keyResult = transform(key, ctx);
   const valueResult = transform(value, ctx);
 
+  // an empty key is a null in YAML, but a JavaScript property name can't be null, so it's the empty
+  // string it's named by, marked as an empty key
+  if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isNullElement)(keyResult) && (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_4__.includesClasses)(keyResult, ['yaml-e-node'])) {
+    const emptyKey = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__["default"]('', keyResult.meta, keyResult.attributes);
+    emptyKey.classes.push('yaml-e-key');
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_11__["default"].transfer(keyResult, emptyKey);
+    _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_12__["default"].transfer(keyResult, emptyKey);
+    keyResult = emptyKey;
+  }
+
   // @ts-ignore
   element.content.key = keyResult;
   // @ts-ignore
@@ -1450,19 +1464,18 @@ const transformKeyValuePair = (node, ctx) => {
 
 // Sequence: Transforms to ArrayElement
 const transformSequence = (node, ctx) => {
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]();
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"]();
   transformCollection(element, node, ctx);
   return element;
 };
 
 // Scalar: Converts to Element via namespace
 const transformScalar = (node, ctx) => {
-  const element = ctx.namespace.toElement(node.content);
-
-  // Translate style information about empty nodes; an empty node (YAML 1.2 §7.2) is a null unless
-  // a tag other than the null tag makes it something else (e.g. !!str makes it an empty string)
+  // an empty node (YAML 1.2 §7.2) is a null unless a tag other than the null tag makes it
+  // something else (e.g. !!str makes it an empty string); its classes tell it from an explicit null
   const tag = node.tag?.explicitName;
-  const isEmptyNode = node.content === '' && node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_10__.YamlStyle.Plain && [undefined, '?', '!!null', '!<tag:yaml.org,2002:null>'].includes(tag);
+  const isEmptyNode = node.content === '' && node.style === _ast_nodes_YamlStyle_ts__WEBPACK_IMPORTED_MODULE_14__.YamlStyle.Plain && [undefined, '?', '!!null', '!<tag:yaml.org,2002:null>'].includes(tag);
+  const element = isEmptyNode ? new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]() : ctx.namespace.toElement(node.content);
   if (isEmptyNode) {
     element.classes.push('yaml-e-node');
     element.classes.push('yaml-e-scalar');
@@ -1490,7 +1503,7 @@ const transformComment = (node, ctx) => {
   // Only interested in stream comments before the first document
   if (isStreamComment) {
     // @ts-ignore
-    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_6__["default"](node.content);
+    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_9__["default"](node.content);
     maybeAddSourceMap(node, element, ctx);
     return element;
   }
@@ -1501,7 +1514,7 @@ const transformComment = (node, ctx) => {
 const transformLiteral = (node, ctx) => {
   if (node.isMissing) {
     const message = `(Missing ${node.value})`;
-    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+    const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"](message);
     element.classes.push('warning');
     maybeAddSourceMap(node, element, ctx);
     ctx.annotations.push(element);
@@ -1512,7 +1525,7 @@ const transformLiteral = (node, ctx) => {
 // Error as annotation (used by keyValuePair)
 const transformErrorAsAnnotation = (node, ctx) => {
   const message = node.isUnexpected ? '(Unexpected YAML syntax error)' : '(Error YAML syntax error)';
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"](message);
   element.classes.push('error');
   maybeAddSourceMap(node, element, ctx);
   ctx.annotations.push(element);
@@ -1521,7 +1534,7 @@ const transformErrorAsAnnotation = (node, ctx) => {
 // Error: Creates error annotation (adds to annotations array)
 const transformError = (node, ctx) => {
   const message = node.isUnexpected ? '(Unexpected YAML syntax error)' : '(Error YAML syntax error)';
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"](message);
   element.classes.push('error');
   maybeAddSourceMap(node, element, ctx);
   ctx.annotations.push(element);
@@ -1531,10 +1544,10 @@ const transformError = (node, ctx) => {
 // Error at root level: Creates ParseResultElement with error annotation
 const transformRootError = (node, ctx) => {
   const message = node.isUnexpected ? '(Unexpected YAML syntax error)' : '(Error YAML syntax error)';
-  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_5__["default"](message);
+  const element = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_8__["default"](message);
   element.classes.push('error');
   maybeAddSourceMap(node, element, ctx);
-  const parseResultElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
+  const parseResultElement = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__["default"]();
   parseResultElement.push(element);
   return parseResultElement;
 };
@@ -1561,7 +1574,7 @@ const transformYamlAstToApiDOM = (yamlAst, {
 
   // Handle empty parse result
   if (!rootNode) {
-    return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
+    return new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__["default"]();
   }
 
   // Handle root-level error (no valid stream, just an error node)
@@ -1571,12 +1584,12 @@ const transformYamlAstToApiDOM = (yamlAst, {
   const result = transform(rootNode, ctx);
 
   // Result should be a ParseResultElement from transformStream
-  if (result instanceof _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]) {
+  if (result instanceof _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__["default"]) {
     return result;
   }
 
   // Fallback: wrap in ParseResultElement
-  const parseResult = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_7__["default"]();
+  const parseResult = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_10__["default"]();
   if (result !== null) {
     if (Array.isArray(result)) {
       result.forEach(el => parseResult.push(el));
@@ -21324,9 +21337,6 @@ class ShallowCloneError extends _CloneError_mjs__WEBPACK_IMPORTED_MODULE_0__["de
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
-/* empty/unused harmony star reexport */
-/* empty/unused harmony star reexport */
-/* empty/unused harmony star reexport */
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(8138);
 /* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(8504);
 /* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(6663);
@@ -22613,11 +22623,10 @@ class CollectionElement extends _Element_mjs__WEBPACK_IMPORTED_MODULE_0__["defau
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
-/* empty/unused harmony star reexport */
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(3654);
 /* harmony import */ var _Metadata_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(1844);
-/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(6663);
-/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(8504);
+/* harmony import */ var _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(6663);
+/* harmony import */ var _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8504);
 
 
 
@@ -22787,13 +22796,13 @@ class Element {
     }
 
     // KeyValuePair
-    if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) {
+    if (value instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       this._content = value;
       return;
     }
 
     // ObjectSlice - extract elements array
-    if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_4__["default"]) {
+    if (value instanceof _ObjectSlice_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) {
       this._content = value.elements;
       return;
     }
@@ -22912,7 +22921,7 @@ class Element {
     if (Array.isArray(content)) {
       return content;
     }
-    if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) {
+    if (content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       const children = [];
       if (content.key) children.push(content.key);
       if (content.value) children.push(content.value);
@@ -22976,7 +22985,7 @@ class Element {
     if (_content instanceof Element) {
       return _content.toValue();
     }
-    if (_content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_3__["default"]) {
+    if (_content instanceof _KeyValuePair_mjs__WEBPACK_IMPORTED_MODULE_2__["default"]) {
       return _content.toValue();
     }
     if (Array.isArray(_content)) {