@formspec/cli 0.1.0-alpha.3

package/dist/analyzer/class-analyzer.js

@@ -0,0 +1,151 @@
+/**
+ * Class analyzer for extracting fields, types, and decorators.
+ *
+ * Analyzes a TypeScript class declaration to extract:
+ * - Field names and TypeScript types
+ * - Decorator metadata (Label, Min, Max, etc.)
+ * - Field optionality
+ */
+import * as ts from "typescript";
+import { extractDecorators } from "./decorator-extractor.js";
+/**
+ * Analyzes a class declaration to extract fields and methods.
+ *
+ * @param classDecl - The class declaration to analyze
+ * @param checker - TypeScript type checker
+ * @returns Analysis result with fields and methods
+ */
+export function analyzeClass(classDecl, checker) {
+    const name = classDecl.name?.text ?? "AnonymousClass";
+    const fields = [];
+    const instanceMethods = [];
+    const staticMethods = [];
+    for (const member of classDecl.members) {
+        if (ts.isPropertyDeclaration(member)) {
+            const fieldInfo = analyzeField(member, checker);
+            if (fieldInfo) {
+                fields.push(fieldInfo);
+            }
+        }
+        else if (ts.isMethodDeclaration(member)) {
+            const methodInfo = analyzeMethod(member, checker);
+            if (methodInfo) {
+                const isStatic = member.modifiers?.some((m) => m.kind === ts.SyntaxKind.StaticKeyword);
+                if (isStatic) {
+                    staticMethods.push(methodInfo);
+                }
+                else {
+                    instanceMethods.push(methodInfo);
+                }
+            }
+        }
+    }
+    return {
+        name,
+        fields,
+        instanceMethods,
+        staticMethods,
+    };
+}
+/**
+ * Analyzes a property declaration to extract field info.
+ */
+function analyzeField(prop, checker) {
+    // Skip computed property names
+    if (!ts.isIdentifier(prop.name)) {
+        return null;
+    }
+    const name = prop.name.text;
+    const typeNode = prop.type;
+    const type = checker.getTypeAtLocation(prop);
+    const optional = prop.questionToken !== undefined;
+    const decorators = extractDecorators(prop);
+    return {
+        name,
+        typeNode,
+        type,
+        optional,
+        decorators,
+    };
+}
+/**
+ * Analyzes a method declaration to extract method info.
+ */
+function analyzeMethod(method, checker) {
+    // Skip computed method names
+    if (!ts.isIdentifier(method.name)) {
+        return null;
+    }
+    const name = method.name.text;
+    const parameters = [];
+    for (const param of method.parameters) {
+        if (ts.isIdentifier(param.name)) {
+            const paramInfo = analyzeParameter(param, checker);
+            parameters.push(paramInfo);
+        }
+    }
+    const returnTypeNode = method.type;
+    const signature = checker.getSignatureFromDeclaration(method);
+    const returnType = signature
+        ? checker.getReturnTypeOfSignature(signature)
+        : checker.getTypeAtLocation(method);
+    return {
+        name,
+        parameters,
+        returnTypeNode,
+        returnType,
+    };
+}
+/**
+ * Analyzes a parameter declaration.
+ */
+function analyzeParameter(param, checker) {
+    const name = ts.isIdentifier(param.name) ? param.name.text : "param";
+    const typeNode = param.type;
+    const type = checker.getTypeAtLocation(param);
+    const formSpecExportName = detectFormSpecReference(typeNode);
+    // Parameter is optional if it has a question token or a default value
+    const optional = param.questionToken !== undefined || param.initializer !== undefined;
+    return {
+        name,
+        typeNode,
+        type,
+        formSpecExportName,
+        optional,
+    };
+}
+/**
+ * Detects if a type node is InferSchema<typeof X> or InferFormSchema<typeof X> and extracts X.
+ *
+ * @param typeNode - The type node to check
+ * @returns The export name X, or null if not a FormSpec inference pattern
+ */
+function detectFormSpecReference(typeNode) {
+    if (!typeNode)
+        return null;
+    // Looking for: InferSchema<typeof X> or InferFormSchema<typeof X>
+    if (!ts.isTypeReferenceNode(typeNode))
+        return null;
+    // Get the type name - could be Identifier or QualifiedName
+    const typeName = ts.isIdentifier(typeNode.typeName)
+        ? typeNode.typeName.text
+        : ts.isQualifiedName(typeNode.typeName)
+            ? typeNode.typeName.right.text
+            : null;
+    // Support both InferSchema (for elements) and InferFormSchema (for FormSpec)
+    if (typeName !== "InferSchema" && typeName !== "InferFormSchema")
+        return null;
+    const typeArg = typeNode.typeArguments?.[0];
+    if (!typeArg || !ts.isTypeQueryNode(typeArg))
+        return null;
+    // typeArg.exprName is the identifier (e.g., "ActivateParams")
+    if (ts.isIdentifier(typeArg.exprName)) {
+        return typeArg.exprName.text;
+    }
+    // Could be qualified name like Namespace.ActivateParams
+    if (ts.isQualifiedName(typeArg.exprName)) {
+        return typeArg.exprName.right.text;
+    }
+    return null;
+}
+//# sourceMappingURL=class-analyzer.js.map

package/dist/analyzer/class-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-analyzer.js","sourceRoot":"","sources":["../../src/analyzer/class-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAsB,MAAM,0BAA0B,CAAC;AA8DjF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,SAA8B,EAC9B,OAAuB;IAEvB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,gBAAgB,CAAC;IACtD,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,eAAe,GAAiB,EAAE,CAAC;IACzC,MAAM,aAAa,GAAiB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAC9C,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM;QACN,eAAe;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,IAA4B,EAC5B,OAAuB;IAEvB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAClD,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3C,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,MAA4B,EAC5B,OAAuB;IAEvB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACnD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC;QAC7C,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,IAAI;QACJ,UAAU;QACV,cAAc;QACd,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,KAA8B,EAC9B,OAAuB;IAEvB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC7D,sEAAsE;IACtE,MAAM,QAAQ,GACZ,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC;IAEvE,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,kBAAkB;QAClB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,QAAiC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI;QACxB,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACrC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;YAC9B,CAAC,CAAC,IAAI,CAAC;IAEX,6EAA6E;IAC7E,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAE9E,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1D,8DAA8D;IAC9D,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,IAAI,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/decorator-extractor.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Decorator extractor for parsing decorator AST nodes.
+ *
+ * Extracts decorator names and arguments from class field decorators,
+ * supporting the FormSpec decorator DSL (@Label, @Min, @Max, etc.).
+ */
+import * as ts from "typescript";
+/**
+ * Extracted decorator information.
+ */
+export interface DecoratorInfo {
+    /** Decorator name (e.g., "Label", "Min") */
+    name: string;
+    /** Decorator arguments as literal values */
+    args: DecoratorArg[];
+    /** Raw AST node for the decorator */
+    node: ts.Decorator;
+}
+/**
+ * A decorator argument value.
+ * Can be a primitive, array, or object literal.
+ */
+export type DecoratorArg = string | number | boolean | null | DecoratorArg[] | {
+    [key: string]: DecoratorArg;
+};
+/**
+ * Extracts decorators from a class member (property or method).
+ *
+ * @param member - The class member to extract decorators from
+ * @returns Array of extracted decorator info
+ */
+export declare function extractDecorators(member: ts.PropertyDeclaration | ts.MethodDeclaration): DecoratorInfo[];
+/**
+ * Known FormSpec decorators and their expected argument types.
+ */
+export declare const FORMSPEC_DECORATORS: {
+    readonly Label: {
+        readonly argTypes: readonly ["string"];
+    };
+    readonly Placeholder: {
+        readonly argTypes: readonly ["string"];
+    };
+    readonly Description: {
+        readonly argTypes: readonly ["string"];
+    };
+    readonly Min: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly Max: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly Step: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly MinItems: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly MaxItems: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly MinLength: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly MaxLength: {
+        readonly argTypes: readonly ["number"];
+    };
+    readonly Pattern: {
+        readonly argTypes: readonly ["string"];
+    };
+    readonly EnumOptions: {
+        readonly argTypes: readonly ["array"];
+    };
+    readonly ShowWhen: {
+        readonly argTypes: readonly ["object"];
+    };
+    readonly Group: {
+        readonly argTypes: readonly ["string"];
+    };
+    readonly Boolean: {
+        readonly argTypes: readonly [];
+    };
+};
+/**
+ * Checks if a decorator name is a known FormSpec decorator.
+ */
+export declare function isFormSpecDecorator(name: string): boolean;
+//# sourceMappingURL=decorator-extractor.d.ts.map

package/dist/analyzer/decorator-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-extractor.d.ts","sourceRoot":"","sources":["../../src/analyzer/decorator-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,qCAAqC;IACrC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,iBAAiB,GACpD,aAAa,EAAE,CAkBjB;AAuJD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BtB,CAAC;AAEX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/analyzer/decorator-extractor.js

@@ -0,0 +1,193 @@
+/**
+ * Decorator extractor for parsing decorator AST nodes.
+ *
+ * Extracts decorator names and arguments from class field decorators,
+ * supporting the FormSpec decorator DSL (@Label, @Min, @Max, etc.).
+ */
+import * as ts from "typescript";
+/**
+ * Extracts decorators from a class member (property or method).
+ *
+ * @param member - The class member to extract decorators from
+ * @returns Array of extracted decorator info
+ */
+export function extractDecorators(member) {
+    const decorators = [];
+    // TC39 decorators are in the modifiers array
+    const modifiers = ts.canHaveDecorators(member)
+        ? ts.getDecorators(member)
+        : undefined;
+    if (!modifiers)
+        return decorators;
+    for (const decorator of modifiers) {
+        const info = parseDecorator(decorator);
+        if (info) {
+            decorators.push(info);
+        }
+    }
+    return decorators;
+}
+/**
+ * Parses a single decorator node.
+ */
+function parseDecorator(decorator) {
+    const expr = decorator.expression;
+    // Simple decorator: @Decorator
+    if (ts.isIdentifier(expr)) {
+        return {
+            name: expr.text,
+            args: [],
+            node: decorator,
+        };
+    }
+    // Call expression: @Decorator(args)
+    if (ts.isCallExpression(expr)) {
+        const callee = expr.expression;
+        // Get decorator name
+        let name = null;
+        if (ts.isIdentifier(callee)) {
+            name = callee.text;
+        }
+        else if (ts.isPropertyAccessExpression(callee)) {
+            // For namespaced decorators like @formspec.Label()
+            name = callee.name.text;
+        }
+        if (!name)
+            return null;
+        // Extract arguments
+        const args = expr.arguments.map(extractArgValue);
+        return {
+            name,
+            args,
+            node: decorator,
+        };
+    }
+    return null;
+}
+/**
+ * Extracts the value from an expression node.
+ * Supports literals, arrays, and object literals.
+ */
+function extractArgValue(node) {
+    // String literal
+    if (ts.isStringLiteral(node)) {
+        return node.text;
+    }
+    // Numeric literal
+    if (ts.isNumericLiteral(node)) {
+        return Number(node.text);
+    }
+    // Boolean literals (true/false are identifiers in TS AST)
+    if (node.kind === ts.SyntaxKind.TrueKeyword) {
+        return true;
+    }
+    if (node.kind === ts.SyntaxKind.FalseKeyword) {
+        return false;
+    }
+    // Null literal
+    if (node.kind === ts.SyntaxKind.NullKeyword) {
+        return null;
+    }
+    // Prefix unary expression (for negative numbers)
+    if (ts.isPrefixUnaryExpression(node)) {
+        if (node.operator === ts.SyntaxKind.MinusToken &&
+            ts.isNumericLiteral(node.operand)) {
+            return -Number(node.operand.text);
+        }
+        if (node.operator === ts.SyntaxKind.PlusToken &&
+            ts.isNumericLiteral(node.operand)) {
+            return Number(node.operand.text);
+        }
+    }
+    // Array literal
+    if (ts.isArrayLiteralExpression(node)) {
+        return node.elements.map((el) => {
+            if (ts.isSpreadElement(el)) {
+                // Can't evaluate spread at compile time
+                return null;
+            }
+            return extractArgValue(el);
+        });
+    }
+    // Object literal
+    if (ts.isObjectLiteralExpression(node)) {
+        const obj = {};
+        for (const prop of node.properties) {
+            if (ts.isPropertyAssignment(prop)) {
+                const key = getPropertyName(prop.name);
+                if (key) {
+                    obj[key] = extractArgValue(prop.initializer);
+                }
+            }
+            else if (ts.isShorthandPropertyAssignment(prop)) {
+                // { foo } shorthand - we can't resolve the value
+                const key = prop.name.text;
+                obj[key] = null;
+            }
+        }
+        return obj;
+    }
+    // Template literal (simple case)
+    if (ts.isNoSubstitutionTemplateLiteral(node)) {
+        return node.text;
+    }
+    // Identifier - could be an enum member or constant
+    // We return null since we can't resolve it statically
+    if (ts.isIdentifier(node)) {
+        // Return the identifier name for potential later resolution
+        return `__identifier:${node.text}`;
+    }
+    // For other expressions, return null
+    return null;
+}
+/**
+ * Gets the property name from a property name node.
+ */
+function getPropertyName(name) {
+    if (ts.isIdentifier(name)) {
+        return name.text;
+    }
+    if (ts.isStringLiteral(name)) {
+        return name.text;
+    }
+    if (ts.isNumericLiteral(name)) {
+        return name.text;
+    }
+    // Computed property names can't be resolved statically
+    return null;
+}
+/**
+ * Known FormSpec decorators and their expected argument types.
+ */
+export const FORMSPEC_DECORATORS = {
+    // Metadata decorators
+    Label: { argTypes: ["string"] },
+    Placeholder: { argTypes: ["string"] },
+    Description: { argTypes: ["string"] },
+    // Numeric constraints
+    Min: { argTypes: ["number"] },
+    Max: { argTypes: ["number"] },
+    Step: { argTypes: ["number"] },
+    // Array constraints
+    MinItems: { argTypes: ["number"] },
+    MaxItems: { argTypes: ["number"] },
+    // String constraints
+    MinLength: { argTypes: ["number"] },
+    MaxLength: { argTypes: ["number"] },
+    Pattern: { argTypes: ["string"] },
+    // Enum options
+    EnumOptions: { argTypes: ["array"] },
+    // Conditional display
+    ShowWhen: { argTypes: ["object"] },
+    // Grouping
+    Group: { argTypes: ["string"] },
+    // Type hints (may be removed once CLI handles type inference)
+    Boolean: { argTypes: [] },
+};
+/**
+ * Checks if a decorator name is a known FormSpec decorator.
+ */
+export function isFormSpecDecorator(name) {
+    return name in FORMSPEC_DECORATORS;
+}
+//# sourceMappingURL=decorator-extractor.js.map

package/dist/analyzer/decorator-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-extractor.js","sourceRoot":"","sources":["../../src/analyzer/decorator-extractor.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/program.d.ts

@@ -0,0 +1,37 @@
+/**
+ * TypeScript program setup for static analysis.
+ *
+ * Creates a TypeScript program with type checker from a source file,
+ * using the project's tsconfig.json for compiler options.
+ */
+import * as ts from "typescript";
+/**
+ * Result of creating a TypeScript program for analysis.
+ */
+export interface ProgramContext {
+    /** The TypeScript program */
+    program: ts.Program;
+    /** Type checker for resolving types */
+    checker: ts.TypeChecker;
+    /** The source file being analyzed */
+    sourceFile: ts.SourceFile;
+}
+/**
+ * Creates a TypeScript program for analyzing a source file.
+ *
+ * Looks for tsconfig.json in the file's directory or parent directories.
+ * Falls back to default compiler options if no config is found.
+ *
+ * @param filePath - Absolute path to the TypeScript source file
+ * @returns Program context with checker and source file
+ */
+export declare function createProgramContext(filePath: string): ProgramContext;
+/**
+ * Finds a class declaration by name in a source file.
+ *
+ * @param sourceFile - The source file to search
+ * @param className - Name of the class to find
+ * @returns The class declaration node, or null if not found
+ */
+export declare function findClassByName(sourceFile: ts.SourceFile, className: string): ts.ClassDeclaration | null;
+//# sourceMappingURL=program.d.ts.map

package/dist/analyzer/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/analyzer/program.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,uCAAuC;IACvC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,qCAAqC;IACrC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA6DrE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,MAAM,GAChB,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAgB5B"}

package/dist/analyzer/program.js

@@ -0,0 +1,89 @@
+/**
+ * TypeScript program setup for static analysis.
+ *
+ * Creates a TypeScript program with type checker from a source file,
+ * using the project's tsconfig.json for compiler options.
+ */
+import * as ts from "typescript";
+import * as path from "node:path";
+/**
+ * Creates a TypeScript program for analyzing a source file.
+ *
+ * Looks for tsconfig.json in the file's directory or parent directories.
+ * Falls back to default compiler options if no config is found.
+ *
+ * @param filePath - Absolute path to the TypeScript source file
+ * @returns Program context with checker and source file
+ */
+export function createProgramContext(filePath) {
+    const absolutePath = path.resolve(filePath);
+    const fileDir = path.dirname(absolutePath);
+    // Find tsconfig.json
+    const configPath = ts.findConfigFile(fileDir, ts.sys.fileExists, "tsconfig.json");
+    let compilerOptions;
+    let fileNames;
+    if (configPath) {
+        const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+        if (configFile.error) {
+            throw new Error(`Error reading tsconfig.json: ${ts.flattenDiagnosticMessageText(configFile.error.messageText, "\n")}`);
+        }
+        const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, path.dirname(configPath));
+        if (parsed.errors.length > 0) {
+            const errorMessages = parsed.errors
+                .map(e => ts.flattenDiagnosticMessageText(e.messageText, "\n"))
+                .join("\n");
+            throw new Error(`Error parsing tsconfig.json: ${errorMessages}`);
+        }
+        compilerOptions = parsed.options;
+        // Include the target file in the program
+        fileNames = parsed.fileNames.includes(absolutePath)
+            ? parsed.fileNames
+            : [...parsed.fileNames, absolutePath];
+    }
+    else {
+        // Fallback to default options
+        compilerOptions = {
+            target: ts.ScriptTarget.ES2022,
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            declaration: true,
+            experimentalDecorators: true, // Required for legacy TypeScript decorators
+        };
+        fileNames = [absolutePath];
+    }
+    const program = ts.createProgram(fileNames, compilerOptions);
+    const sourceFile = program.getSourceFile(absolutePath);
+    if (!sourceFile) {
+        throw new Error(`Could not find source file: ${absolutePath}`);
+    }
+    return {
+        program,
+        checker: program.getTypeChecker(),
+        sourceFile,
+    };
+}
+/**
+ * Finds a class declaration by name in a source file.
+ *
+ * @param sourceFile - The source file to search
+ * @param className - Name of the class to find
+ * @returns The class declaration node, or null if not found
+ */
+export function findClassByName(sourceFile, className) {
+    let result = null;
+    function visit(node) {
+        if (result)
+            return;
+        if (ts.isClassDeclaration(node) && node.name?.text === className) {
+            result = node;
+            return;
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return result;
+}
+//# sourceMappingURL=program.js.map

package/dist/analyzer/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/analyzer/program.ts"],"names":[],"mappings":"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"}