feat: improve parse options & file.message and fileData type namings and export (#70)

* fix: remove options.warningMessage

* feat: add position and sourceId vfile message info

* feat: rename FileData into ParseFileData

* feat: rename FileData into StringifyFileData & use it in relottie

Author: Aidosmf

.changeset/lucky-needles-wink.md

@@ -0,0 +1,5 @@
+---
+"@lottiefiles/relottie-parse": patch
+---
+
+feat: do not duplicate log messages with the vfile.messages and remove the unnecessary "warningMessage" option

.changeset/many-mice-kiss.md

@@ -0,0 +1,5 @@
+---
+"@lottiefiles/relottie": patch
+---
+
+feat: FileData extends StringifyFileData type

.changeset/ninety-queens-compete.md

@@ -0,0 +1,6 @@
+---
+"@lottiefiles/relottie": patch
+"@lottiefiles/relottie-parse": patch
+---
+
+feat: rename export relottie-parse's FileData type into ParseFileData

.changeset/shaggy-islands-repair.md

@@ -0,0 +1,5 @@
+---
+"@lottiefiles/relottie-parse": patch
+---
+
+feat: add position and sourceId info when adding a vfile message

.changeset/tender-mirrors-cross.md

@@ -0,0 +1,5 @@
+---
+"@lottiefiles/relottie-stringify": patch
+---
+
+feat: rename export FileData type into StringifyFileData

packages/relottie-parse/playground.ts

@@ -9,7 +9,7 @@ import { readFileSync } from 'fs';
 import type { Root } from '@lottiefiles/last';
 import type { CompilerFunction, Plugin } from 'unified';
 import { unified } from 'unified';
-// import { reporter } from 'vfile-reporter';
+import { reporter } from 'vfile-reporter';
 
 import relottieParse from './src/index.js';
 
@@ -28,15 +28,15 @@ const path = `../../__fixtures__/features/${name}.json`;
 
 const lottieJsonFile = readFileSync(path, 'utf8');
 
-const processor = unified().use(relottieParse, { warningMessage: true }).use(emptyCompiler);
+const processor = unified().use(relottieParse).use(emptyCompiler);
 
 // const tree = processor.parse(lottieJsonFile);
 
 // writeFileSync(`${name}-tree.json`, JSON.stringify(tree, null, 2), 'utf8');
 
 const vfile = processor.processSync(lottieJsonFile);
 
-// console.log(reporter(vfile));
+console.log(reporter(vfile));
 
 console.log(vfile.data);
 

packages/relottie-parse/src/constants.ts

@@ -19,6 +19,10 @@ import type {
 
 const { number: NT, string: ST } = TITLES;
 
+export const fileConstants = {
+  sourceId: 'relottie-parse',
+} as const;
+
 export type ConstantNumMap = Map<number, string>;
 
 export const blendModeValues: ConstantNumMap = new Map<BlendMode.Value, string>([

packages/relottie-parse/src/index.ts

@@ -2,6 +2,7 @@
  * Copyright 2022 Design Barn Inc.
  */
 
-export { default, type Options, type FileData } from './unified-relottie-parse.js';
+export { default, type Options } from './unified-relottie-parse.js';
+export type { ParseFileData } from './parse.js';
 export { DEFAULT_OPTIONS } from './options.js';
 export { Stack } from './helpers.js';

packages/relottie-parse/src/options.ts

@@ -11,14 +11,9 @@ export interface ParseOptions {
    * Include 'valueType' prop into nodes (default, true)
    */
   valueType: boolean;
-  /**
-   * include 'warning' type messages into vfile.data (default, false)
-   */
-  warningMessage: boolean;
 }
 
 export const DEFAULT_OPTIONS: ParseOptions = {
   position: true,
   valueType: true,
-  warningMessage: false,
 } as const;

packages/relottie-parse/src/parse.ts

@@ -38,6 +38,7 @@ import type { PrimitiveParts } from '@lottiefiles/last-builder';
 import { is } from 'unist-util-is';
 import type { VFile, Data } from 'vfile';
 
+import { fileConstants } from './constants.js';
 import type { Dependent } from './entities.js';
 import { getMemberEntity, getNoKeyEntity } from './entities.js';
 import { Stack } from './helpers.js';
@@ -46,21 +47,13 @@ import type { ParseOptions } from './options.js';
 import type { SettingsOptions } from './unified-relottie-parse.js';
 
 export interface ParseFileData extends Data {
-  parse: {
-    messages?: VFile['messages'];
-  };
+  parse?: object;
 }
 
 export interface Info {
   hasExpressions: Root['hasExpressions'];
 }
 
-const addWarningMessage = (file: VFile, message: string, options: ParseOptions): void => {
-  if (options.warningMessage) {
-    file.message(message);
-  }
-};
-
 const createValueType = (node: Momoa.AstNode, options: ParseOptions): PrimitiveParts<PrimitiveValueType> => {
   if (!options.valueType || node.type === 'Array' || node.type === 'Object' || node.type === 'Document') {
     return {};
@@ -157,7 +150,6 @@ const getTitleFromMemberValue = (
   parentNodeTitle: ParentTitle,
   dependent: Dependent,
   file: VFile,
-  options: ParseOptions,
 ): AnyTitle | undefined => {
   const { key, parentTitle, type } = dependent;
 
@@ -178,7 +170,7 @@ const getTitleFromMemberValue = (
       if (!constTitle) {
         const message = `[${parentNodeTitle}] '${constantKey}' is missing in "dependent.parentTitle.values"`;
 
-        addWarningMessage(file, message, options);
+        file.message(message, node, fileConstants.sourceId);
       }
 
       const title = typeof constTitle === 'undefined' ? defaultConstTitle : constTitle;
@@ -198,7 +190,7 @@ const getTitleFromMemberValue = (
       if (type !== node.type) {
         const message = `${parentNodeTitle}'s '${key}' type is ${node.type} but has to be ${type}`;
 
-        addWarningMessage(file, message, options);
+        file.message(message, node, fileConstants.sourceId);
         break;
       }
 
@@ -213,7 +205,6 @@ const getDependentTitle = (
   members: Momoa.Member[],
   dependents: Dependent[],
   file: VFile,
-  options: ParseOptions,
 ): AnyTitle | undefined => {
   const memberKeyValue = members.reduce((acc, member) => {
     const key = member.name.value;
@@ -229,37 +220,27 @@ const getDependentTitle = (
 
     if (!node) continue;
 
-    const title = getTitleFromMemberValue(node, parentTitle, dependent, file, options);
+    const title = getTitleFromMemberValue(node, parentTitle, dependent, file);
 
     if (title) return title;
   }
 
   return undefined;
 };
 
-const getObjectNodeTitle = (
-  node: Momoa.Obj,
-  parentNodeTitle: ParentTitle,
-  file: VFile,
-  options: ParseOptions,
-): ObjectTitle => {
+const getObjectNodeTitle = (node: Momoa.Obj, parentNodeTitle: ParentTitle, file: VFile): ObjectTitle => {
   const entity = getNoKeyEntity(node, parentNodeTitle);
 
   const { defaultTitle, dependents } = entity;
 
   if (!dependents) return defaultTitle as ObjectTitle;
 
-  const title = getDependentTitle(parentNodeTitle, node.members, dependents, file, options);
+  const title = getDependentTitle(parentNodeTitle, node.members, dependents, file);
 
   return (title || defaultTitle) as ObjectTitle;
 };
 
-const getArrayNodeTitle = (
-  node: Momoa.Arr,
-  parentNodeTitle: ParentTitle,
-  file: VFile,
-  options: ParseOptions,
-): ArrayTitle => {
+const getArrayNodeTitle = (node: Momoa.Arr, parentNodeTitle: ParentTitle, file: VFile): ArrayTitle => {
   const entity = getNoKeyEntity(node, parentNodeTitle);
 
   const { defaultTitle, dependents } = entity;
@@ -268,7 +249,7 @@ const getArrayNodeTitle = (
 
   const members = getMembersFromArrNode(node);
 
-  const title = getDependentTitle(parentNodeTitle, members, dependents, file, options);
+  const title = getDependentTitle(parentNodeTitle, members, dependents, file);
 
   return (title || defaultTitle) as ArrayTitle;
 };
@@ -307,7 +288,7 @@ const traverseJsonEnter = (
           const element = stack.peek();
 
           assertNodeType<Element>(element, 'element', file);
-          const elementValueTitle = getObjectNodeTitle(node, element.title, file, options);
+          const elementValueTitle = getObjectNodeTitle(node, element.title, file);
 
           stack.push(objectNode(elementValueTitle, [], { ...position }));
           break;
@@ -316,7 +297,7 @@ const traverseJsonEnter = (
           const array = stack.peek();
 
           assertNodeType<ArrayNode>(array, 'array', file);
-          const objectTitle = getObjectNodeTitle(node, array.title, file, options);
+          const objectTitle = getObjectNodeTitle(node, array.title, file);
 
           stack.push(objectNode(objectTitle, [], { ...position }));
           break;
@@ -332,7 +313,7 @@ const traverseJsonEnter = (
           const collection = stack.peek();
 
           assertNodeType<Collection>(collection, 'collection', file);
-          const collectionValueTitle = getArrayNodeTitle(node, collection.title, file, options);
+          const collectionValueTitle = getArrayNodeTitle(node, collection.title, file);
 
           stack.push(arrayNode(collectionValueTitle, [], { ...position }));
           break;
@@ -341,7 +322,7 @@ const traverseJsonEnter = (
           const array = stack.peek();
 
           assertNodeType<ArrayNode>(array, 'array', file);
-          const arrayTitle = getArrayNodeTitle(node, array.title, file, options);
+          const arrayTitle = getArrayNodeTitle(node, array.title, file);
 
           stack.push(arrayNode(arrayTitle, [], { ...position }));
           break;
@@ -545,16 +526,6 @@ export function parse(document: string, file: VFile, settings: SettingsOptions =
     },
   });
 
-  const dataMessages = options.warningMessage && file.messages.length > 0 ? { messages: file.messages } : {};
-
-  const fileData: ParseFileData = {
-    parse: {
-      ...dataMessages,
-    },
-  };
-
-  Object.assign(file.data, fileData);
-
   const tree = stack.pop();
 
   if (is<Root>(tree, 'root')) {