@playcanvas/attribute-parser 1.0.2 → 1.0.3

package/package.json

@@ -5,7 +5,7 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "version": "1.0.2",
+  "version": "1.0.3",
   "dependencies": {
     "@microsoft/tsdoc": "^0.15.0",
     "@typescript/vfs": "^1.6.0",

package/src/index.js

@@ -32,14 +32,20 @@ export class JSDocParser {
      */
     _errors = [];
 
-    async init(basePath = '') {
+    /**
+     * Initializes the JSDocParser with the standard library files
+     * 
+     * @param {string} libPath - The path to standard library files
+     * @returns {Promise<JSDocParser>} - The initialized JSDocParser
+     */
+    async init(libPath = '') {
         if (this._env) {
-            return;
+            return this;
         }
 
         let fsMap;
-        if (basePath) {
-            fsMap = await createDefaultMapFromCDN({ target: ts.ScriptTarget.ES2022 }, basePath, ts);
+        if (libPath) {
+            fsMap = await createDefaultMapFromCDN({ target: ts.ScriptTarget.ES2022 }, libPath, ts);
         } else {
             fsMap = await createDefaultMapFromNodeModules(COMPILER_OPTIONS, ts);
         }
@@ -47,6 +53,8 @@ export class JSDocParser {
         // Set up the virtual file system and environment
         const system = createSystem(fsMap);
         this._env = createVirtualTypeScriptEnvironment(system, Array.from(fsMap.keys()), ts, COMPILER_OPTIONS);
+
+        return this;
     }
 
     /**

package/src/parsers/script-parser.js

@@ -190,6 +190,11 @@ const mapAttributesToOutput = (attribute) => {
     // set the default value
     if (attribute.value !== undefined) attribute.default = attribute.value;
 
+    // Curve Attributes specifically should not expose a default value if it's an empty array
+    if (attribute.type === 'curve' && Array.isArray(attribute.value) && attribute.value.length === 0) {
+        delete attribute.default;
+    }
+
     // remove typeName from the output
     delete attribute.typeName;
     delete attribute.value;

package/test/tests/valid/curve.test.js

@@ -27,7 +27,7 @@ describe('VALID: Curve attribute', function () {
         expect(data[0].example.attributes.a.name).to.equal('a');
         expect(data[0].example.attributes.a.type).to.equal('curve');
         expect(data[0].example.attributes.a.array).to.equal(false);
-        expect(data[0].example.attributes.a.default).to.eql([]);
+        expect(data[0].example.attributes.a.default).to.not.exist;
     });
 
     it('b: should be a curve attribute with a default value', function () {
@@ -43,7 +43,7 @@ describe('VALID: Curve attribute', function () {
         expect(data[0].example.attributes.c.name).to.equal('c');
         expect(data[0].example.attributes.c.type).to.equal('curve');
         expect(data[0].example.attributes.c.array).to.equal(false);
-        expect(data[0].example.attributes.c.default).to.eql([]);
+        expect(data[0].example.attributes.a.default).to.not.exist;
         expect(data[0].example.attributes.c.color).to.equal('r');
     });
 
@@ -52,7 +52,7 @@ describe('VALID: Curve attribute', function () {
         expect(data[0].example.attributes.d.name).to.equal('d');
         expect(data[0].example.attributes.d.type).to.equal('curve');
         expect(data[0].example.attributes.d.array).to.equal(false);
-        expect(data[0].example.attributes.d.default).to.eql([]);
+        expect(data[0].example.attributes.a.default).to.not.exist;
         expect(data[0].example.attributes.d.color).to.equal('rgb');
         expect(data[0].example.attributes.d.curves).to.deep.equal(['x', 'y', 'z']);
     });
@@ -63,7 +63,7 @@ describe('VALID: Curve attribute', function () {
         expect(data[0].example.attributes.e.type).to.equal('curve');
         expect(data[0].example.attributes.e.array).to.equal(true);
         expect(data[0].example.attributes.e.size).to.equal(2);
-        expect(data[0].example.attributes.e.default).equal(null);
+        expect(data[0].example.attributes.e.default).to.not.exist;
     });
 
     it('f: should be a curve attribute in an unsual format', function () {