@ng-forge/dynamic-form-mcp 0.5.1

package/src/utils/ast-extractor.d.ts

@@ -0,0 +1,88 @@
+/**
+ * AST Extractor Utility
+ *
+ * Uses ts-morph for robust TypeScript parsing to extract FormConfig objects.
+ * Handles complex patterns that regex + new Function() cannot:
+ * - new Date() constructors
+ * - Function references and arrow functions
+ * - Regex literals
+ * - External variable references
+ * - Method calls like Math.floor()
+ */
+/**
+ * Placeholder date used when encountering `new Date()` expressions.
+ * Since dates are runtime values, we substitute a fixed ISO string for validation.
+ */
+export declare const DATE_PLACEHOLDER = "2024-01-01T00:00:00.000Z";
+/**
+ * Maximum length for source text before truncation in warnings.
+ * Keeps warning messages readable while preserving context.
+ */
+export declare const MAX_SOURCE_TEXT_LENGTH = 50;
+import { SourceFile, Node, ObjectLiteralExpression } from 'ts-morph';
+/**
+ * A candidate FormConfig object found in the source file.
+ */
+export interface FormConfigCandidate {
+    /** Variable or property name */
+    name: string;
+    /** Line number where the declaration starts */
+    startLine: number;
+    /** The AST node for the object literal */
+    objectLiteral: ObjectLiteralExpression;
+    /** How this candidate was detected */
+    matchReason: 'type-annotation' | 'satisfies' | 'as-cast' | 'structural';
+}
+/**
+ * Warning about a non-serializable value that was replaced with a placeholder.
+ */
+export interface ExtractionWarning {
+    /** Path to the property, e.g., "fields[0].props.maxDate" */
+    path: string;
+    /** Description of the issue */
+    issue: string;
+    /** Original source text */
+    originalText: string;
+    /** What was substituted */
+    placeholder: string | number | boolean | null;
+}
+/**
+ * Error that occurred during extraction.
+ */
+export interface ExtractionError {
+    /** Path to the property */
+    path: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Result of extracting an AST node to JSON.
+ */
+export interface ExtractionResult {
+    /** The extracted JSON-safe object */
+    value: unknown;
+    /** Non-fatal issues (runtime values replaced with placeholders) */
+    warnings: ExtractionWarning[];
+    /** Fatal issues (couldn't extract) */
+    errors: ExtractionError[];
+}
+/**
+ * Create a ts-morph Project and parse source code.
+ */
+export declare function createSourceFile(source: string, fileName?: string): SourceFile;
+/**
+ * Find all potential FormConfig objects in a source file.
+ *
+ * Uses multiple detection strategies (in order of precedence):
+ * 1. Type annotation: `const x: FormConfig = {...}` or `const x: SomeFormConfig = {...}`
+ * 2. Satisfies: `const x = {...} satisfies FormConfig` or `{...} as const satisfies SomeConfig`
+ * 3. As cast: `const x = {...} as FormConfig`
+ * 4. Structural: Any object with `fields` array containing form-like objects
+ */
+export declare function findFormConfigCandidates(sourceFile: SourceFile): FormConfigCandidate[];
+/**
+ * Extract an AST node to a JSON-safe object.
+ * Handles non-serializable values gracefully with placeholders and warnings.
+ */
+export declare function extractToJson(node: Node, path?: string): ExtractionResult;
+//# sourceMappingURL=ast-extractor.d.ts.map

package/src/utils/ast-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-extractor.d.ts","sourceRoot":"","sources":["../../../../../packages/dynamic-form-mcp/src/utils/ast-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,OAAO,EAEL,UAAU,EACV,IAAI,EACJ,uBAAuB,EAKxB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,aAAa,EAAE,uBAAuB,CAAC;IACvC,sCAAsC;IACtC,WAAW,EAAE,iBAAiB,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,sCAAsC;IACtC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,UAAU,CAGjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAuFtF;AAkHD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,SAAK,GAAG,gBAAgB,CAOrE"}