@equinor/fusion-framework-cli-plugin-ai-index 1.0.0

package/dist/esm/utils/markdown/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/markdown/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/markdown/types.ts"],"names":[],"mappings":""}

package/dist/esm/utils/package-resolver.js

@@ -0,0 +1,40 @@
+import { dirname } from 'node:path';
+import { readPackageUp } from 'read-package-up';
+/**
+ * Map of package base directories to package.json
+ */
+const packageMap = new Map();
+/**
+ * Resolves which package a file path belongs to.
+ * First checks the cache map, then uses read-package-up if no match found.
+ *
+ * @param filePath - Absolute or relative file path (e.g., '/path/to/packages/cli/src/index.ts')
+ * @returns Package.json if found, undefined otherwise
+ *
+ * @example
+ * ```ts
+ * const packageJson = await resolvePackage('/path/to/packages/cli/src/index.ts');
+ * ```
+ */
+export async function resolvePackage(filePath) {
+    // Check cache: iterate through known package directories
+    for (const packageRoot of packageMap.keys()) {
+        if (filePath.startsWith(packageRoot)) {
+            const packageJson = packageMap.get(packageRoot);
+            if (packageJson) {
+                return packageJson;
+            }
+        }
+    }
+    // Not in cache, resolve using read-package-up
+    // readPackageUp expects a directory path, not a file path
+    const dirPath = dirname(filePath);
+    const result = await readPackageUp({ cwd: dirPath, normalize: false });
+    if (result) {
+        // Cache using the package directory (where package.json is located)
+        const packageDir = dirname(result.path);
+        packageMap.set(packageDir, result.packageJson);
+    }
+    return result?.packageJson;
+}
+//# sourceMappingURL=package-resolver.js.map

package/dist/esm/utils/package-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.js","sourceRoot":"","sources":["../../../src/utils/package-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,yDAAyD;IACzD,KAAK,MAAM,WAAW,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAChD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,0DAA0D;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,IAAI,MAAM,EAAE,CAAC;QACX,oEAAoE;QACpE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,EAAE,WAAW,CAAC;AAC7B,CAAC"}

package/dist/esm/utils/ts-doc/constants.js

@@ -0,0 +1,13 @@
+import { SyntaxKind } from 'ts-morph';
+/**
+ * Supported TSDoc node kinds for top-level processing
+ */
+export const nodeKinds = [
+    SyntaxKind.FunctionDeclaration,
+    SyntaxKind.ClassDeclaration,
+    SyntaxKind.InterfaceDeclaration,
+    SyntaxKind.TypeAliasDeclaration,
+    SyntaxKind.VariableStatement,
+    SyntaxKind.EnumDeclaration,
+];
+//# sourceMappingURL=constants.js.map

package/dist/esm/utils/ts-doc/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,CAAC,mBAAmB;IAC9B,UAAU,CAAC,gBAAgB;IAC3B,UAAU,CAAC,oBAAoB;IAC/B,UAAU,CAAC,oBAAoB;IAC/B,UAAU,CAAC,iBAAiB;IAC5B,UAAU,CAAC,eAAe;CAC3B,CAAC"}

package/dist/esm/utils/ts-doc/extractors.js

@@ -0,0 +1,175 @@
+import { SyntaxKind, Node, } from 'ts-morph';
+import { generateChunkId } from '../generate-chunk-id.js';
+import { nodeKinds } from './constants.js';
+/**
+ * Creates a TypescriptDocument from the given parameters.
+ * @param sourceFile - The source file containing the node.
+ * @param pageContent - The content of the document.
+ * @param tsKind - The TypeScript node kind name.
+ * @param tsName - The name of the TypeScript node.
+ * @param options - Optional parsing configuration.
+ * @param sourceOverride - Optional source path override (for cases where source needs transformation).
+ * @returns A TypeScript document with metadata.
+ */
+const createTypescriptDocument = (sourceFile, pageContent, tsKind, tsName, options) => {
+    const source = sourceFile.getFilePath().replace(/^\/+/, '');
+    return {
+        id: generateChunkId(source),
+        pageContent,
+        metadata: {
+            source,
+            ...(options?.projectRoot && { rootPath: options.projectRoot }),
+            attributes: {
+                type: 'tsdoc',
+                ts_kind: tsKind,
+                ts_name: tsName,
+            },
+        },
+    };
+};
+/**
+ * Extracts a TSDoc document from a class node, including TSDoc, constructor, and public member signatures.
+ * @param classNode - The ClassDeclaration node to process.
+ * @param sourceFile - The source file containing the node.
+ * @param options - Optional parsing configuration.
+ * @returns A TypeScript document with TSDoc and class interface, or null if no TSDoc is found.
+ */
+export const extractDocumentFromClassNode = (classNode, sourceFile, _options) => {
+    // Find TSDoc comment (/** ... */)
+    const docCommentRange = classNode
+        .getLeadingCommentRanges()
+        .find((range) => range.getText().startsWith('/**'));
+    if (!docCommentRange) {
+        return null;
+    }
+    const docComment = docCommentRange.getText();
+    const className = classNode.getName() || 'AnonymousClass';
+    // Start with class TSDoc and declaration (without body)
+    const classSignature = `${classNode.getText({ includeJsDocComments: false }).split('{')[0].trim()} {`;
+    let pageContent = `${docComment}\n${classSignature}`;
+    // Add constructor with TSDoc if present
+    const constructorNode = classNode.getConstructors()[0]; // Get the first constructor (if any)
+    if (constructorNode) {
+        const constructorDocCommentRange = constructorNode
+            .getLeadingCommentRanges()
+            .find((range) => range.getText().startsWith('/**'));
+        if (constructorDocCommentRange) {
+            const constructorDocComment = constructorDocCommentRange.getText();
+            const constructorSignature = constructorNode
+                .getText({ includeJsDocComments: false })
+                .split('{')[0]
+                .trim();
+            pageContent += `\n  ${constructorDocComment}\n  ${constructorSignature}`;
+        }
+    }
+    // Add public methods and properties with TSDoc
+    const publicMembers = [
+        ...classNode.getMethods().filter((m) => m.hasModifier(SyntaxKind.PublicKeyword)),
+        ...classNode.getProperties().filter((p) => p.hasModifier(SyntaxKind.PublicKeyword)),
+    ];
+    publicMembers.forEach((member) => {
+        const memberDocCommentRange = member
+            .getLeadingCommentRanges()
+            .find((range) => range.getText().startsWith('/**'));
+        if (memberDocCommentRange) {
+            const memberDocComment = memberDocCommentRange.getText();
+            let memberSignature = '';
+            if (member.getKind() === SyntaxKind.MethodDeclaration) {
+                memberSignature = member
+                    .getText({ includeJsDocComments: false })
+                    .split('{')[0]
+                    .trim();
+            }
+            else if (member.getKind() === SyntaxKind.PropertyDeclaration) {
+                memberSignature = member
+                    .getText({ includeJsDocComments: false })
+                    .trim();
+            }
+            pageContent += `\n  ${memberDocComment}\n  ${memberSignature}`;
+        }
+    });
+    pageContent += '\n}';
+    return createTypescriptDocument(sourceFile, pageContent, classNode.getKindName(), className, _options);
+};
+/**
+ * Extracts a TSDoc document from a single node.
+ * @param node - The TypeScript node to process.
+ * @param sourceFile - The source file containing the node.
+ * @param options - Optional parsing configuration.
+ * @param nodeOptions - Optional node-specific configuration (e.g., skipKindCheck for VariableStatement).
+ * @returns A TypeScript document with TSDoc metadata, or null if no TSDoc is found.
+ */
+export const extractDocumentFromNode = (node, sourceFile, options, nodeOptions) => {
+    const kind = node.getKind();
+    // Skip if not in our target kinds unless skipKindCheck is true
+    if (!nodeOptions?.skipKindCheck && !nodeKinds.includes(kind)) {
+        return null;
+    }
+    // Handle ClassDeclaration separately
+    if (kind === SyntaxKind.ClassDeclaration) {
+        return extractDocumentFromClassNode(node, sourceFile, options);
+    }
+    // Handle VariableStatement (e.g., `export const bundleApp = ...`)
+    if (kind === SyntaxKind.VariableStatement) {
+        const declaration = node
+            .getDeclarations()
+            .find((d) => d.getKind() === SyntaxKind.VariableDeclaration);
+        if (!declaration) {
+            return null;
+        }
+        const initializer = declaration.getInitializer();
+        if (!initializer ||
+            !(initializer.getKind() === SyntaxKind.ArrowFunction ||
+                initializer.getKind() === SyntaxKind.FunctionExpression)) {
+            return null;
+        }
+        // Get the TSDoc comment from the VariableStatement
+        const docCommentRange = node
+            .getLeadingCommentRanges()
+            .find((range) => range.getText().startsWith('/**'));
+        if (!docCommentRange) {
+            return null;
+        }
+        const nodeName = declaration.getName() || 'missing_name_of_node';
+        const docComment = docCommentRange.getText();
+        // Only include the TSDoc comment for functions/lambdas
+        return createTypescriptDocument(sourceFile, docComment, initializer.getKindName(), nodeName, options);
+    }
+    // Get name if node has one
+    const nodeName = Node.hasName(node) ? node.getName() : 'missing_name_of_node';
+    // Find TSDoc comment (/** ... */)
+    const docCommentRange = node
+        .getLeadingCommentRanges()
+        .find((range) => range.getText().startsWith('/**'));
+    if (!docCommentRange) {
+        return null;
+    }
+    const docComment = docCommentRange.getText();
+    let pageContent = docComment;
+    // For interfaces and type aliases, include the full code
+    if (kind === SyntaxKind.InterfaceDeclaration || kind === SyntaxKind.TypeAliasDeclaration) {
+        pageContent = `${docComment}\n${node.getText()}`;
+    }
+    // For other nodes (e.g., FunctionDeclaration), include only TSDoc
+    else if (kind !== SyntaxKind.FunctionDeclaration) {
+        return null; // Skip unsupported kinds
+    }
+    return createTypescriptDocument(sourceFile, pageContent, node.getKindName(), nodeName, options);
+};
+/**
+ * Processes a TypeScript source file to extract TSDoc documents.
+ * @param sourceFile - The source file to process.
+ * @param options - Optional parsing configuration.
+ * @returns An array of TypeScript documents with TSDoc metadata.
+ */
+export const processSourceFile = (sourceFile, options) => {
+    const documents = [];
+    sourceFile.forEachDescendant((node) => {
+        const document = extractDocumentFromNode(node, sourceFile, options);
+        if (document) {
+            documents.push(document);
+        }
+    });
+    return documents;
+};
+//# sourceMappingURL=extractors.js.map

package/dist/esm/utils/ts-doc/extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/extractors.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,IAAI,GAKL,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,wBAAwB,GAAG,CAC/B,UAA6B,EAC7B,WAAmB,EACnB,MAAc,EACd,MAAc,EACd,OAA2B,EACP,EAAE;IACtB,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO;QACL,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC;QAC3B,WAAW;QACX,QAAQ,EAAE;YACR,MAAM;YACN,GAAG,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9D,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,MAAM;aAChB;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,SAA2B,EAC3B,UAA6B,EAC7B,QAA4B,EACD,EAAE;IAC7B,kCAAkC;IAClC,MAAM,eAAe,GAAG,SAAS;SAC9B,uBAAuB,EAAE;SACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,gBAAgB,CAAC;IAE1D,wDAAwD;IACxD,MAAM,cAAc,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;IACtG,IAAI,WAAW,GAAG,GAAG,UAAU,KAAK,cAAc,EAAE,CAAC;IAErD,wCAAwC;IACxC,MAAM,eAAe,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,qCAAqC;IAC7F,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,0BAA0B,GAAG,eAAe;aAC/C,uBAAuB,EAAE;aACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,0BAA0B,EAAE,CAAC;YAC/B,MAAM,qBAAqB,GAAG,0BAA0B,CAAC,OAAO,EAAE,CAAC;YACnE,MAAM,oBAAoB,GAAG,eAAe;iBACzC,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;iBACxC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBACb,IAAI,EAAE,CAAC;YACV,WAAW,IAAI,OAAO,qBAAqB,OAAO,oBAAoB,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,aAAa,GAAG;QACpB,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAChF,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;KACpF,CAAC;IAEF,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/B,MAAM,qBAAqB,GAAG,MAAM;aACjC,uBAAuB,EAAE;aACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,qBAAqB,EAAE,CAAC;YAC1B,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,OAAO,EAAE,CAAC;YACzD,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,iBAAiB,EAAE,CAAC;gBACtD,eAAe,GAAI,MAA4B;qBAC5C,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;qBACxC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;qBACb,IAAI,EAAE,CAAC;YACZ,CAAC;iBAAM,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,mBAAmB,EAAE,CAAC;gBAC/D,eAAe,GAAI,MAA8B;qBAC9C,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;qBACxC,IAAI,EAAE,CAAC;YACZ,CAAC;YACD,WAAW,IAAI,OAAO,gBAAgB,OAAO,eAAe,EAAE,CAAC;QACjE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,WAAW,IAAI,KAAK,CAAC;IAErB,OAAO,wBAAwB,CAC7B,UAAU,EACV,WAAW,EACX,SAAS,CAAC,WAAW,EAAE,EACvB,SAAS,EACT,QAAQ,CACT,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAU,EACV,UAA6B,EAC7B,OAA2B,EAC3B,WAAyC,EACd,EAAE;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAE5B,+DAA+D;IAC/D,IAAI,CAAC,WAAW,EAAE,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI,KAAK,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACzC,OAAO,4BAA4B,CAAC,IAAwB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED,kEAAkE;IAClE,IAAI,IAAI,KAAK,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAI,IAA0B;aAC5C,eAAe,EAAE;aACjB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAE/D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;QACjD,IACE,CAAC,WAAW;YACZ,CAAC,CACC,WAAW,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,aAAa;gBAClD,WAAW,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,kBAAkB,CACxD,EACD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mDAAmD;QACnD,MAAM,eAAe,GAAG,IAAI;aACzB,uBAAuB,EAAE;aACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,sBAAsB,CAAC;QACjE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;QAE7C,uDAAuD;QACvD,OAAO,wBAAwB,CAC7B,UAAU,EACV,UAAU,EACV,WAAW,CAAC,WAAW,EAAE,EACzB,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAE9E,kCAAkC;IAClC,MAAM,eAAe,GAAG,IAAI;SACzB,uBAAuB,EAAE;SACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IAC7C,IAAI,WAAW,GAAG,UAAU,CAAC;IAE7B,yDAAyD;IACzD,IAAI,IAAI,KAAK,UAAU,CAAC,oBAAoB,IAAI,IAAI,KAAK,UAAU,CAAC,oBAAoB,EAAE,CAAC;QACzF,WAAW,GAAG,GAAG,UAAU,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnD,CAAC;IACD,kEAAkE;SAC7D,IAAI,IAAI,KAAK,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,CAAC,yBAAyB;IACxC,CAAC;IAED,OAAO,wBAAwB,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClG,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,UAA6B,EAC7B,OAA2B,EACL,EAAE;IACxB,MAAM,SAAS,GAAyB,EAAE,CAAC;IAE3C,UAAU,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACpE,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/utils/ts-doc/index.js

@@ -0,0 +1,3 @@
+// Re-export parser functions
+export { isTypescriptFile, parseTsDocSync, parseTsDocFromFileSync } from './parser.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/ts-doc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/index.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/utils/ts-doc/parser.js

@@ -0,0 +1,37 @@
+import { assert } from 'node:console';
+import { readFileSync } from 'node:fs';
+import { Project } from 'ts-morph';
+import { processSourceFile } from './extractors.js';
+/**
+ * Checks if a file is a TypeScript or TSX file based on its extension.
+ * @param filePath - The path to the file.
+ * @returns True if the file ends with .ts or .tsx, false otherwise.
+ */
+export const isTypescriptFile = (filePath) => {
+    return filePath.endsWith('.ts') || filePath.endsWith('.tsx');
+};
+/**
+ * Parses TSDoc from a string of TypeScript code.
+ * @param content - The TypeScript code content.
+ * @param options - Optional parsing configuration.
+ * @returns An array of TypeScript documents with TSDoc metadata.
+ */
+export const parseTsDocSync = (content, options) => {
+    const project = new Project({ useInMemoryFileSystem: true });
+    const sourceFile = project.createSourceFile('temp.ts', content);
+    return processSourceFile(sourceFile, options);
+};
+/**
+ * Parses TSDoc from a TypeScript file by path.
+ * @param file - The source file object.
+ * @param options - Optional parsing configuration.
+ * @returns An array of TypeScript documents with TSDoc metadata.
+ * @throws If the file is not a TypeScript file.
+ */
+export const parseTsDocFromFileSync = (file, options) => {
+    assert(isTypescriptFile(file.path), `File ${file.path} is not a TypeScript file`);
+    const project = new Project({ useInMemoryFileSystem: true });
+    const sourceFile = project.createSourceFile(file.relativePath ?? file.path, readFileSync(file.path, 'utf8'));
+    return processSourceFile(sourceFile, options);
+};
+//# sourceMappingURL=parser.js.map

package/dist/esm/utils/ts-doc/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAInC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAW,EAAE;IAC5D,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAe,EACf,OAA2B,EACL,EAAE;IACxB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAgB,EAChB,OAA2B,EACL,EAAE;IACxB,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,IAAI,CAAC,IAAI,2BAA2B,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CACzC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,EAC9B,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAChC,CAAC;IACF,OAAO,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC,CAAC"}

package/dist/esm/utils/ts-doc/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/ts-doc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/ts-doc/types.ts"],"names":[],"mappings":""}

package/dist/esm/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":""}

package/dist/esm/version.js

@@ -0,0 +1,3 @@
+// Generated by genversion.
+export const version = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}