@speclynx/apidom-parser-adapter-yaml-1-2 1.12.2 → 2.1.0

package/src/tree-sitter/syntactic-analysis/index.cjs

@@ -0,0 +1,39 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _index = _interopRequireDefault(require("./ast/schemas/json/index.cjs"));
+var _ReferenceManager = _interopRequireDefault(require("./ast/anchors-aliases/ReferenceManager.cjs"));
+var _CstTransformer = _interopRequireDefault(require("./CstTransformer.cjs"));
+var _YamlAstTransformer = require("./YamlAstTransformer.cjs");
+/**
+ * @public
+ */
+
+/**
+ * This version of syntactic analysis does following transformations:
+ *   `TreeSitter CST -> YAML AST -> ApiDOM`
+ * Two traversals passes are needed to get from CST to ApiDOM.
+ * @public
+ */
+const analyze = (cst, {
+  sourceMap = false
+} = {}) => {
+  const cursor = cst.walk();
+  const schema = new _index.default();
+  const referenceManager = new _ReferenceManager.default();
+
+  // Pass 1: CST -> YAML AST (direct cursor-based transformation)
+  const yamlAst = (0, _CstTransformer.default)(cursor, {
+    schema,
+    sourceMap,
+    referenceManager
+  });
+
+  // Pass 2: YAML AST -> ApiDOM (direct transformation)
+  return (0, _YamlAstTransformer.transformYamlAstToApiDOM)(yamlAst, {
+    sourceMap
+  });
+};
+var _default = exports.default = analyze;

package/src/tree-sitter/syntactic-analysis/index.mjs

@@ -0,0 +1,33 @@
+import JsonSchema from "./ast/schemas/json/index.mjs";
+import YamlReferenceManager from "./ast/anchors-aliases/ReferenceManager.mjs";
+import transformCstToYamlAst from "./CstTransformer.mjs";
+import { transformYamlAstToApiDOM } from "./YamlAstTransformer.mjs";
+/**
+ * @public
+ */
+/**
+ * This version of syntactic analysis does following transformations:
+ *   `TreeSitter CST -> YAML AST -> ApiDOM`
+ * Two traversals passes are needed to get from CST to ApiDOM.
+ * @public
+ */
+const analyze = (cst, {
+  sourceMap = false
+} = {}) => {
+  const cursor = cst.walk();
+  const schema = new JsonSchema();
+  const referenceManager = new YamlReferenceManager();
+
+  // Pass 1: CST -> YAML AST (direct cursor-based transformation)
+  const yamlAst = transformCstToYamlAst(cursor, {
+    schema,
+    sourceMap,
+    referenceManager
+  });
+
+  // Pass 2: YAML AST -> ApiDOM (direct transformation)
+  return transformYamlAstToApiDOM(yamlAst, {
+    sourceMap
+  });
+};
+export default analyze;

package/src/yaml/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+
+exports.__esModule = true;
+exports.parse = exports.detect = void 0;
+var _yaml = require("yaml");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+/**
+ * @public
+ */
+const detect = async source => {
+  try {
+    (0, _yaml.parse)(source);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * @public
+ */
+exports.detect = detect;
+const parse = async source => {
+  const pojo = (0, _yaml.parse)(source);
+  const element = (0, _apidomDatamodel.refract)(pojo);
+  const parseResult = new _apidomDatamodel.ParseResultElement();
+  element.classes.push('result');
+  parseResult.push(element);
+  return parseResult;
+};
+exports.parse = parse;

package/src/yaml/index.mjs

@@ -0,0 +1,26 @@
+import { parse as parseYaml } from 'yaml';
+import { ParseResultElement, refract } from '@speclynx/apidom-datamodel';
+
+/**
+ * @public
+ */
+export const detect = async source => {
+  try {
+    parseYaml(source);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * @public
+ */
+export const parse = async source => {
+  const pojo = parseYaml(source);
+  const element = refract(pojo);
+  const parseResult = new ParseResultElement();
+  element.classes.push('result');
+  parseResult.push(element);
+  return parseResult;
+};

package/types/apidom-parser-adapter-yaml-1-2.d.ts

@@ -1,12 +1,19 @@
 import { MediaTypes } from '@speclynx/apidom-core';
-import { Namespace } from '@speclynx/apidom-core';
-import { ParseResultElement } from '@speclynx/apidom-core';
+import { Namespace } from '@speclynx/apidom-datamodel';
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
 import { Tree } from 'web-tree-sitter';
 
 /**
  * @public
  */
-export declare const detect: (source: string) => Promise<boolean>;
+export declare const detect: (source: string, { strict }?: DetectOptions) => Promise<boolean>;
+
+/**
+ * @public
+ */
+export declare interface DetectOptions {
+    strict?: boolean;
+}
 
 /**
  * Lexical Analysis of source string using WebTreeSitter.
@@ -43,6 +50,7 @@ export declare type ParseFunction = (source: string, options?: ParseFunctionOpti
  */
 export declare interface ParseFunctionOptions {
     sourceMap?: boolean;
+    strict?: boolean;
 }
 
 /**

package/src/syntactic-analysis/TreeCursorIterator.cjs

@@ -1,93 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
-exports.__esModule = true;
-exports.default = void 0;
-var _TreeCursorSyntaxNode = _interopRequireDefault(require("./TreeCursorSyntaxNode.cjs"));
-class TreeCursorIterator {
-  cursor;
-  constructor(cursor) {
-    this.cursor = cursor;
-  }
-  stream() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  yaml_directive() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  tag_directive() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  reserved_directive() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  document() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  block_node() {
-    return new _TreeCursorSyntaxNode.default(this.cursor).setFieldName(this.cursor);
-  }
-  flow_node() {
-    return new _TreeCursorSyntaxNode.default(this.cursor).setFieldName(this.cursor);
-  }
-  block_mapping() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  block_mapping_pair() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  flow_mapping() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  flow_pair() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  block_sequence() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  block_sequence_item() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  flow_sequence() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  plain_scalar() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  single_quote_scalar() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  double_quote_scalar() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  block_scalar() {
-    return new _TreeCursorSyntaxNode.default(this.cursor);
-  }
-  ERROR() {
-    return new _TreeCursorSyntaxNode.default(this.cursor).setHasError(this.cursor);
-  }
-  *[Symbol.iterator]() {
-    let node;
-    if (this.cursor.nodeType in this) {
-      // @ts-ignore
-      node = this[this.cursor.nodeType]();
-    } else {
-      node = new _TreeCursorSyntaxNode.default(this.cursor);
-    }
-    if (this.cursor.gotoFirstChild()) {
-      const [firstChild] = new TreeCursorIterator(this.cursor);
-      node.pushChildren(firstChild);
-      while (this.cursor.gotoNextSibling()) {
-        const firstChildSiblings = Array.from(new TreeCursorIterator(this.cursor));
-        node.pushChildren(...firstChildSiblings);
-      }
-      node.children.reduce((previousNode, currentNode) => {
-        currentNode.setPreviousSibling(previousNode);
-        return currentNode;
-      }, undefined);
-      this.cursor.gotoParent();
-    }
-    yield node;
-  }
-}
-var _default = exports.default = TreeCursorIterator;

package/src/syntactic-analysis/TreeCursorIterator.mjs

@@ -1,88 +0,0 @@
-import TreeCursorSyntaxNode from "./TreeCursorSyntaxNode.mjs";
-class TreeCursorIterator {
-  cursor;
-  constructor(cursor) {
-    this.cursor = cursor;
-  }
-  stream() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  yaml_directive() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  tag_directive() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  reserved_directive() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  document() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  block_node() {
-    return new TreeCursorSyntaxNode(this.cursor).setFieldName(this.cursor);
-  }
-  flow_node() {
-    return new TreeCursorSyntaxNode(this.cursor).setFieldName(this.cursor);
-  }
-  block_mapping() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  block_mapping_pair() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  flow_mapping() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  flow_pair() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  block_sequence() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  block_sequence_item() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  flow_sequence() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  plain_scalar() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  single_quote_scalar() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  double_quote_scalar() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  block_scalar() {
-    return new TreeCursorSyntaxNode(this.cursor);
-  }
-  ERROR() {
-    return new TreeCursorSyntaxNode(this.cursor).setHasError(this.cursor);
-  }
-  *[Symbol.iterator]() {
-    let node;
-    if (this.cursor.nodeType in this) {
-      // @ts-ignore
-      node = this[this.cursor.nodeType]();
-    } else {
-      node = new TreeCursorSyntaxNode(this.cursor);
-    }
-    if (this.cursor.gotoFirstChild()) {
-      const [firstChild] = new TreeCursorIterator(this.cursor);
-      node.pushChildren(firstChild);
-      while (this.cursor.gotoNextSibling()) {
-        const firstChildSiblings = Array.from(new TreeCursorIterator(this.cursor));
-        node.pushChildren(...firstChildSiblings);
-      }
-      node.children.reduce((previousNode, currentNode) => {
-        currentNode.setPreviousSibling(previousNode);
-        return currentNode;
-      }, undefined);
-      this.cursor.gotoParent();
-    }
-    yield node;
-  }
-}
-export default TreeCursorIterator;

package/src/syntactic-analysis/TreeCursorSyntaxNode.cjs

@@ -1,80 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-class TreeCursorSyntaxNode {
-  type;
-  startPosition;
-  endPosition;
-  startIndex;
-  endIndex;
-  text;
-  isNamed;
-  isMissing;
-  fieldName = null;
-  hasError = false;
-  children = [];
-  previousSibling;
-  constructor(cursor) {
-    this.type = cursor.nodeType;
-    this.startPosition = cursor.startPosition;
-    this.endPosition = cursor.endPosition;
-    this.startIndex = cursor.startIndex;
-    this.endIndex = cursor.endIndex;
-    this.text = cursor.nodeText;
-    this.isNamed = cursor.nodeIsNamed;
-    this.isMissing = cursor.nodeIsMissing;
-  }
-  get keyNode() {
-    if (this.type === 'flow_pair' || this.type === 'block_mapping_pair') {
-      return this.children.find(node => node.fieldName === 'key');
-    }
-    return undefined;
-  }
-  get valueNode() {
-    if (this.type === 'flow_pair' || this.type === 'block_mapping_pair') {
-      return this.children.find(node => node.fieldName === 'value');
-    }
-    return undefined;
-  }
-  get tag() {
-    let {
-      previousSibling
-    } = this;
-    while (typeof previousSibling !== 'undefined' && previousSibling.type !== 'tag') {
-      ({
-        previousSibling
-      } = previousSibling);
-    }
-    return previousSibling;
-  }
-  get anchor() {
-    let {
-      previousSibling
-    } = this;
-    while (typeof previousSibling !== 'undefined' && previousSibling.type !== 'anchor') {
-      ({
-        previousSibling
-      } = previousSibling);
-    }
-    return previousSibling;
-  }
-  get firstNamedChild() {
-    return this.children.find(node => node.isNamed);
-  }
-  setFieldName(cursor) {
-    this.fieldName = cursor.currentFieldName;
-    return this;
-  }
-  setHasError(cursor) {
-    this.hasError = cursor.currentNode.hasError;
-    return this;
-  }
-  setPreviousSibling(previousSibling) {
-    this.previousSibling = previousSibling;
-  }
-  pushChildren(...children) {
-    this.children.push(...children);
-  }
-}
-var _default = exports.default = TreeCursorSyntaxNode;

package/src/syntactic-analysis/TreeCursorSyntaxNode.mjs

@@ -1,76 +0,0 @@
-class TreeCursorSyntaxNode {
-  type;
-  startPosition;
-  endPosition;
-  startIndex;
-  endIndex;
-  text;
-  isNamed;
-  isMissing;
-  fieldName = null;
-  hasError = false;
-  children = [];
-  previousSibling;
-  constructor(cursor) {
-    this.type = cursor.nodeType;
-    this.startPosition = cursor.startPosition;
-    this.endPosition = cursor.endPosition;
-    this.startIndex = cursor.startIndex;
-    this.endIndex = cursor.endIndex;
-    this.text = cursor.nodeText;
-    this.isNamed = cursor.nodeIsNamed;
-    this.isMissing = cursor.nodeIsMissing;
-  }
-  get keyNode() {
-    if (this.type === 'flow_pair' || this.type === 'block_mapping_pair') {
-      return this.children.find(node => node.fieldName === 'key');
-    }
-    return undefined;
-  }
-  get valueNode() {
-    if (this.type === 'flow_pair' || this.type === 'block_mapping_pair') {
-      return this.children.find(node => node.fieldName === 'value');
-    }
-    return undefined;
-  }
-  get tag() {
-    let {
-      previousSibling
-    } = this;
-    while (typeof previousSibling !== 'undefined' && previousSibling.type !== 'tag') {
-      ({
-        previousSibling
-      } = previousSibling);
-    }
-    return previousSibling;
-  }
-  get anchor() {
-    let {
-      previousSibling
-    } = this;
-    while (typeof previousSibling !== 'undefined' && previousSibling.type !== 'anchor') {
-      ({
-        previousSibling
-      } = previousSibling);
-    }
-    return previousSibling;
-  }
-  get firstNamedChild() {
-    return this.children.find(node => node.isNamed);
-  }
-  setFieldName(cursor) {
-    this.fieldName = cursor.currentFieldName;
-    return this;
-  }
-  setHasError(cursor) {
-    this.hasError = cursor.currentNode.hasError;
-    return this;
-  }
-  setPreviousSibling(previousSibling) {
-    this.previousSibling = previousSibling;
-  }
-  pushChildren(...children) {
-    this.children.push(...children);
-  }
-}
-export default TreeCursorSyntaxNode;

package/src/syntactic-analysis/indirect/index.cjs

@@ -1,51 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
-var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomAst = require("@speclynx/apidom-ast");
-var _CstVisitor = _interopRequireWildcard(require("./visitors/CstVisitor.cjs"));
-var _YamlAstVisitor = _interopRequireWildcard(require("./visitors/YamlAstVisitor.cjs"));
-var _TreeCursorIterator = _interopRequireDefault(require("../TreeCursorIterator.cjs"));
-/**
- * @public
- */
-
-/**
- * This version of syntactic analysis does following transformations:
- *   `TreeSitter CST -> YAML AST -> ApiDOM`
- * Two traversals passes are needed to get from CST to ApiDOM.
- * @public
- */
-const analyze = (cst, {
-  sourceMap = false
-} = {}) => {
-  const cursor = cst.walk();
-  const iterator = new _TreeCursorIterator.default(cursor);
-  const [rootNode] = Array.from(iterator);
-  const cstVisitor = new _CstVisitor.default();
-  const astVisitor = new _YamlAstVisitor.default();
-  const schema = new _apidomAst.YamlJsonSchema();
-  const referenceManager = new _apidomAst.YamlReferenceManager();
-  const yamlAst = (0, _apidomAst.visit)(rootNode, cstVisitor, {
-    // @ts-ignore
-    keyMap: _CstVisitor.keyMap,
-    nodePredicate: _CstVisitor.isNode,
-    state: {
-      schema,
-      sourceMap,
-      referenceManager
-    }
-  });
-  return (0, _apidomAst.visit)(yamlAst.rootNode, astVisitor, {
-    // @ts-ignore
-    keyMap: _YamlAstVisitor.keyMap,
-    nodeTypeGetter: _YamlAstVisitor.getNodeType,
-    nodePredicate: _YamlAstVisitor.isNode,
-    state: {
-      sourceMap
-    }
-  });
-};
-var _default = exports.default = analyze;

package/src/syntactic-analysis/indirect/index.mjs

@@ -1,44 +0,0 @@
-import { visit, YamlJsonSchema as JsonSchema, YamlReferenceManager } from '@speclynx/apidom-ast';
-import CstVisitor, { keyMap as cstKeyMap, isNode as isCstNode } from "./visitors/CstVisitor.mjs";
-import YamlAstVisitor, { keyMap as astKeyMap, isNode as isAstNode, getNodeType as getAstNodeType } from "./visitors/YamlAstVisitor.mjs";
-import TreeCursorIterator from "../TreeCursorIterator.mjs";
-/**
- * @public
- */
-/**
- * This version of syntactic analysis does following transformations:
- *   `TreeSitter CST -> YAML AST -> ApiDOM`
- * Two traversals passes are needed to get from CST to ApiDOM.
- * @public
- */
-const analyze = (cst, {
-  sourceMap = false
-} = {}) => {
-  const cursor = cst.walk();
-  const iterator = new TreeCursorIterator(cursor);
-  const [rootNode] = Array.from(iterator);
-  const cstVisitor = new CstVisitor();
-  const astVisitor = new YamlAstVisitor();
-  const schema = new JsonSchema();
-  const referenceManager = new YamlReferenceManager();
-  const yamlAst = visit(rootNode, cstVisitor, {
-    // @ts-ignore
-    keyMap: cstKeyMap,
-    nodePredicate: isCstNode,
-    state: {
-      schema,
-      sourceMap,
-      referenceManager
-    }
-  });
-  return visit(yamlAst.rootNode, astVisitor, {
-    // @ts-ignore
-    keyMap: astKeyMap,
-    nodeTypeGetter: getAstNodeType,
-    nodePredicate: isAstNode,
-    state: {
-      sourceMap
-    }
-  });
-};
-export default analyze;