@ankhorage/paradox 0.0.8 → 0.0.9

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.0.9
+
+### Patch Changes
+
+- 8904673: Handle exports and type members without declaration nodes defensively during analysis.
+
 ## 0.0.8
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # @ankhorage/paradox
 
-![license: MIT](./paradox/badges/license.svg) ![npm: v0.0.7](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![docs: paradox](./paradox/badges/docs.svg)
+![license: MIT](./paradox/badges/license.svg) ![npm: v0.0.8](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![docs: paradox](./paradox/badges/docs.svg)
 
 Deterministic documentation generator for TypeScript packages.
 

package/dist/analyze/exports.js

@@ -14,7 +14,10 @@ export function analyzeExports(project, options) {
         const exported = sourceFile.getExportSymbols();
         for (const symbol of exported) {
             const resolved = resolveExportSymbol(symbol);
-            const [decl] = resolved.getDeclarations();
+            const decl = getFirstDeclaration(resolved.getDeclarations());
+            if (decl === null) {
+                continue;
+            }
             const rawComment = getParadoxComment(decl);
             const parsed = rawComment
                 ? parseParadoxComment(rawComment)
@@ -67,6 +70,10 @@ function getEntryPointSourceFiles(project, options) {
     })
         .filter((sourceFile) => sourceFile != null);
 }
+function getFirstDeclaration(declarations) {
+    const [declaration = null] = declarations;
+    return declaration;
+}
 function inferKind(node) {
     if ('getParameters' in node)
         return 'function';

package/dist/analyze/utils/getExportMetadata.js

@@ -63,24 +63,42 @@ function getSignature(declaration, params, returns) {
 function getMembers(node) {
     if (getCallableNode(node) !== null)
         return [];
-    return node
-        .getType()
-        .getProperties()
-        .map((property) => {
-        const [declaration] = property.getDeclarations();
+    if (Node.isInterfaceDeclaration(node)) {
+        return getMembersFromProperties(node.getType().getProperties());
+    }
+    if (Node.isTypeAliasDeclaration(node)) {
+        const typeNode = node.getTypeNode();
+        if (!typeNode || !Node.isTypeLiteral(typeNode))
+            return [];
+        return getMembersFromProperties(node.getType().getProperties());
+    }
+    return [];
+}
+function getMembersFromProperties(properties) {
+    return properties.flatMap((property) => {
+        const declaration = getFirstDeclaration(property.getDeclarations());
+        if (declaration === null) {
+            return [];
+        }
         const rawComment = getParadoxComment(declaration);
         const parsed = rawComment
             ? parseParadoxComment(rawComment)
             : { description: null, isConfig: false, params: {}, returns: null };
-        return {
-            name: property.getName(),
-            kind: isMemberMethodDeclaration(declaration) ? 'method' : 'property',
-            type: property.getTypeAtLocation(declaration).getText(declaration),
-            required: !property.isOptional(),
-            description: parsed.description,
-        };
+        return [
+            {
+                name: property.getName(),
+                kind: isMemberMethodDeclaration(declaration) ? 'method' : 'property',
+                type: property.getTypeAtLocation(declaration).getText(declaration),
+                required: !property.isOptional(),
+                description: parsed.description,
+            },
+        ];
     });
 }
+function getFirstDeclaration(declarations) {
+    const [declaration = null] = declarations;
+    return declaration;
+}
 function getCallableDeclarations(symbol, node) {
     const declarations = symbol
         .getDeclarations()

package/dist/analyze/utils/getParadoxComment.d.ts

@@ -2,4 +2,4 @@ import type { Node } from 'ts-morph';
 /***
  * Reads the nearest Paradox doc comment attached to a declaration.
  */
-export declare function getParadoxComment(node: Node): string | null;
+export declare function getParadoxComment(node: Node | undefined): string | null;

package/dist/analyze/utils/getParadoxComment.js

@@ -2,6 +2,8 @@
  * Reads the nearest Paradox doc comment attached to a declaration.
  */
 export function getParadoxComment(node) {
+    if (!node)
+        return null;
     const sourceFile = node.getSourceFile();
     const text = sourceFile.getFullText();
     const nodeStart = node.getStart(false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/paradox",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Deterministic documentation generator for TypeScript packages.",
   "license": "MIT",
   "publishConfig": {